Fix package documentation by removing duplicate package comments from 70 files

pkg/cli/compile_batch_operations.go

@@ -1,4 +1,4 @@
-// Package cli provides batch operations for workflow compilation.
+// This file provides batch operations for workflow compilation.
 //
 // This file contains functions that perform batch operations on compiled workflows,
 // such as running linters, security scanners, and cleaning up orphaned files.
@@ -22,6 +22,7 @@
 //
 // These functions abstract batch operations, allowing the main compile
 // orchestrator to focus on coordination while these handle batch processing.
+
 package cli
 
 import (

pkg/cli/compile_campaign.go

@@ -1,4 +1,4 @@
-// Package cli provides campaign workflow compilation and validation.
+// This file provides campaign workflow compilation and validation.
 //
 // This file handles validation of campaign spec files and their referenced workflows.
 // Campaign workflows are special workflows that orchestrate multiple sub-workflows
@@ -24,6 +24,7 @@
 //   - Campaign spec files are syntactically valid
 //   - Referenced workflow files exist in the workflows directory
 //   - Campaign configuration is complete and correct
+
 package cli
 
 import (

pkg/cli/compile_compiler_setup.go

@@ -1,4 +1,4 @@
-// Package cli provides compiler initialization and configuration for workflow compilation.
+// This file provides compiler initialization and configuration for workflow compilation.
 //
 // This file contains functions that create and configure the workflow compiler
 // instance with various settings like validation, strict mode, trial mode, and
@@ -24,6 +24,7 @@
 //
 // These functions abstract compiler setup, allowing the main compile
 // orchestrator to focus on coordination while these handle configuration.
+
 package cli
 
 import (

pkg/cli/compile_helpers.go

@@ -1,4 +1,4 @@
-// Package cli provides helper functions for workflow compilation.
+// This file provides helper functions for workflow compilation.
 //
 // This file contains shared utilities used by the compile command to process workflow
 // files, manage compilation statistics, and handle campaign workflows. These helpers
@@ -31,6 +31,7 @@
 //
 // These functions abstract common compilation patterns, allowing the main compile
 // command to focus on CLI interaction while these helpers handle the mechanics.
+
 package cli
 
 import (

pkg/cli/compile_orchestration.go

@@ -1,4 +1,4 @@
-// Package cli provides main orchestration logic for workflow compilation.
+// This file provides main orchestration logic for workflow compilation.
 //
 // This file contains the primary compilation orchestration functions that coordinate
 // the compilation of specific files or all files in a directory.
@@ -18,6 +18,7 @@
 //   - compileAllFilesInDirectory() - Compile all workflows in a directory
 //
 // These functions handle the complete compilation pipeline for their respective scenarios.
+
 package cli
 
 import (

pkg/cli/compile_output_formatter.go

@@ -1,4 +1,4 @@
-// Package cli provides output formatting functions for workflow compilation.
+// This file provides output formatting functions for workflow compilation.
 //
 // This file contains functions that format and display compilation results,
 // including summaries, statistics tables, and validation outputs.
@@ -19,6 +19,7 @@
 //
 // These functions abstract output formatting, allowing the main compile
 // orchestrator to focus on coordination while these handle presentation.
+
 package cli
 
 import (

pkg/cli/compile_post_processing.go

@@ -1,4 +1,4 @@
-// Package cli provides post-processing operations for workflow compilation.
+// This file provides post-processing operations for workflow compilation.
 //
 // This file contains functions that perform post-compilation operations such as
 // generating Dependabot manifests, maintenance workflows, and validating campaigns.
@@ -25,6 +25,7 @@
 //
 // These functions abstract post-processing operations, allowing the main compile
 // orchestrator to focus on coordination while these handle generation and validation.
+
 package cli
 
 import (

pkg/cli/compile_workflow_processor.go

@@ -1,4 +1,4 @@
-// Package cli provides workflow file processing functions for compilation.
+// This file provides workflow file processing functions for compilation.
 //
 // This file contains functions that process individual workflow files and
 // campaign specs, handling both regular workflows and campaign orchestrators.
@@ -20,6 +20,7 @@
 //
 // These functions abstract per-file processing, allowing the main compile
 // orchestrator to focus on coordination while these handle file processing.
+
 package cli
 
 import (

pkg/cli/gateway_logs.go

@@ -1,4 +1,4 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (gateway_logs.go) contains functions for parsing and analyzing
 // MCP gateway logs from gateway.jsonl files.
 //
@@ -7,6 +7,7 @@
 //   - Extracting server and tool usage metrics
 //   - Aggregating gateway statistics
 //   - Rendering gateway metrics tables
+
 package cli
 
 import (

pkg/cli/logs_command.go

@@ -1,11 +1,12 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_command.go) contains the CLI command definition for the logs command.
 //
 // Key responsibilities:
 //   - Defining the Cobra command structure and flags for gh aw logs
 //   - Parsing command-line arguments and flags
 //   - Validating inputs (workflow names, dates, engine parameters)
 //   - Delegating execution to the orchestrator (DownloadWorkflowLogs)
+
 package cli
 
 import (

pkg/cli/logs_display.go

@@ -1,11 +1,12 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_display.go) contains functions for displaying workflow logs information
 // to the console, including summary tables and metrics.
 //
 // Key responsibilities:
 //   - Rendering workflow logs overview tables
 //   - Formatting metrics for display (duration, tokens, cost)
 //   - Aggregating totals across multiple runs
+
 package cli
 
 import (

pkg/cli/logs_download.go

@@ -1,4 +1,4 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_download.go) contains functions for downloading and extracting
 // GitHub Actions workflow artifacts and logs.
 //
@@ -7,6 +7,7 @@
 //   - Extracting and organizing zip archives
 //   - Flattening single-file artifact directories
 //   - Managing local file system operations
+
 package cli
 
 import (

pkg/cli/logs_github_api.go

@@ -1,11 +1,12 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_github_api.go) contains functions for interacting with the GitHub API
 // to fetch workflow runs, job statuses, and job details.
 //
 // Key responsibilities:
 //   - Listing workflow runs with pagination
 //   - Fetching job statuses and details for workflow runs
 //   - Handling GitHub CLI authentication and error responses
+
 package cli
 
 import (

pkg/cli/logs_metrics.go

@@ -1,4 +1,4 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_metrics.go) contains functions for extracting and analyzing
 // metrics from workflow execution logs.
 //
@@ -8,6 +8,7 @@
 //   - Detecting MCP (Model Context Protocol) server failures
 //   - Aggregating metrics across multiple log files
 //   - Processing structured output from agent execution
+
 package cli
 
 import (

pkg/cli/logs_orchestrator.go

@@ -1,4 +1,4 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_orchestrator.go) contains the main orchestration logic for downloading
 // and processing workflow logs from GitHub Actions.
 //
@@ -8,6 +8,7 @@
 //   - Concurrent downloading of artifacts from multiple runs
 //   - Applying filters (engine, firewall, staged, campaign, etc.)
 //   - Building and rendering output (console, JSON, tool graphs)
+
 package cli
 
 import (

pkg/cli/logs_parsing_core.go

@@ -1,11 +1,12 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_parsing_core.go) contains core log parsing functions
 // for locating and extracting engine configuration from workflow logs.
 //
 // Key responsibilities:
 //   - Parsing aw_info.json to extract engine configuration
 //   - Locating agent log files and output artifacts
 //   - Supporting multiple artifact layouts (before/after flattening)
+
 package cli
 
 import (

pkg/cli/logs_parsing_engines.go

@@ -1,11 +1,12 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_parsing_engines.go) contains engine-specific log parsing
 // functionality for various AI engines (Claude, Copilot, Codex, Custom).
 //
 // Key responsibilities:
 //   - Parsing log files using engine-specific parsers
 //   - Detecting and parsing GitHub Copilot agent logs
 //   - Falling back to generic parser when engine is unknown
+
 package cli
 
 import (

pkg/cli/logs_parsing_firewall.go

@@ -1,11 +1,12 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_parsing_firewall.go) contains functionality for parsing
 // and analyzing firewall logs from workflow runs.
 //
 // Key responsibilities:
 //   - Locating firewall logs in various directory structures
 //   - Running JavaScript firewall log parser
 //   - Generating markdown summaries of firewall activity
+
 package cli
 
 import (

pkg/cli/logs_parsing_javascript.go

@@ -1,11 +1,12 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_parsing_js.go) contains functionality for executing
 // JavaScript log parsers to generate markdown summaries.
 //
 // Key responsibilities:
 //   - Running JavaScript log parser scripts
 //   - Mocking GitHub Actions environment for parsers
 //   - Generating markdown log summaries
+
 package cli
 
 import (

pkg/cli/logs_utils.go

@@ -1,9 +1,10 @@
-// Package cli provides command-line interface functionality for gh-aw.
+// This file provides command-line interface functionality for gh-aw.
 // This file (logs_utils.go) contains utility functions used by the logs command.
 //
 // Key responsibilities:
 //   - Discovering agentic workflow names from .lock.yml files
 //   - Utility functions for slice operations
+
 package cli
 
 import (

pkg/cli/mcp_validation.go

@@ -1,5 +1,6 @@
-// Package cli contains MCP (Model Context Protocol) validation functions.
+// This file contains MCP (Model Context Protocol) validation functions.
 // This file consolidates validation logic for MCP server configurations.
+
 package cli
 
 import (

pkg/workflow/agent_validation.go

@@ -1,4 +1,4 @@
-// Package workflow provides agent file and feature support validation.
+// This file provides agent file and feature support validation.
 //
 // # Agent Validation
 //
@@ -40,6 +40,7 @@
 //
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (

pkg/workflow/bundler.go

@@ -1,4 +1,4 @@
-// Package workflow provides JavaScript bundling for agentic workflows.
+// This file provides JavaScript bundling for agentic workflows.
 //
 // # JavaScript Bundler with Runtime Mode Support
 //
@@ -40,6 +40,7 @@
 //
 // These validations prevent runtime errors when JavaScript is executed in environments
 // without a module system.
+
 package workflow
 
 import (

pkg/workflow/bundler_file_mode.go

@@ -1,4 +1,4 @@
-// Package workflow provides JavaScript bundling for agentic workflows.
+// This file provides JavaScript bundling for agentic workflows.
 //
 // # File Mode Bundler
 //
@@ -18,6 +18,7 @@
 //   - Maximizes reuse of helper modules within the same job
 //   - Makes debugging easier (files exist on disk during execution)
 //   - Reduces memory pressure from large bundled strings
+
 package workflow
 
 import (

pkg/workflow/bundler_runtime_validation.go

@@ -1,4 +1,4 @@
-// Package workflow provides JavaScript runtime mode validation for agentic workflows.
+// This file provides JavaScript runtime mode validation for agentic workflows.
 //
 // # Runtime Mode Validation
 //
@@ -37,6 +37,7 @@
 // For script content validation, see bundler_script_validation.go.
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (

pkg/workflow/bundler_safety_validation.go

@@ -1,4 +1,4 @@
-// Package workflow provides JavaScript bundler safety validation for agentic workflows.
+// This file provides JavaScript bundler safety validation for agentic workflows.
 //
 // # Bundle Safety Validation
 //
@@ -32,6 +32,7 @@
 // For script content validation, see bundler_script_validation.go.
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (

pkg/workflow/bundler_script_validation.go

@@ -1,4 +1,4 @@
-// Package workflow provides JavaScript script content validation for agentic workflows.
+// This file provides JavaScript script content validation for agentic workflows.
 //
 // # Script Content Validation
 //
@@ -36,6 +36,7 @@
 // For runtime mode validation, see bundler_runtime_validation.go.
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (

pkg/workflow/close_entity_helpers.go

@@ -1,4 +1,4 @@
-// Package workflow provides helper functions for closing GitHub entities.
+// This file provides helper functions for closing GitHub entities.
 //
 // This file contains shared utilities for building close entity jobs (issues,
 // pull requests, discussions). These helpers extract common patterns used across
@@ -47,6 +47,7 @@
 // For create/update operations, see:
 //   - create_*.go files for entity creation logic
 //   - update_entity_helpers.go for entity update logic
+
 package workflow
 
 import (

pkg/workflow/compiler_filters_validation.go

@@ -1,4 +1,4 @@
-// Package workflow provides validation for GitHub Actions event filter mutual exclusivity.
+// This file provides validation for GitHub Actions event filter mutual exclusivity.
 //
 // # Filter Validation
 //
@@ -29,6 +29,7 @@
 //
 // For general validation, see validation.go.
 // For detailed documentation, see specs/validation-architecture.md
+
 package workflow
 
 import (