[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6AD4Z1H70XEPART5JV1642G":3,"skill-same:01M6AD4Z1H70XEPART5JV1642G":83},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":23,"publishedAt":42,"linkOnly":43,"markdownContent":44,"markdownBody":45,"frontMatter":46,"refName":47,"commitSha":48,"skillDirectory":49,"forksCount":50,"repositoryHtmlUrl":51,"repositoryHomepageUrl":52,"ownerHtmlUrl":53,"ownerBlogUrl":54,"ownerDescription":55,"updatedAt":56,"install":57,"resources":70},"01M6AD4Z1H70XEPART5JV1642G","developer-release",null,"Release management, changeset workflow, firewall log parsing, breaking CLI change rules, and Go module summaries for gh-aw.","github\u002Fgh-aw","github","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F9919?v=4","01M6AC83DS133TPXFSP1DHNCC6","GitHub","01M6AD3VCZ4WKQSFSRTPN7N9DN",5636,"MIT","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fdeveloper-release\u002FSKILL.md",[18],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[24,25,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,41],"release","developer release","developer","gh","summaries","for","module","release management","log","management","Rules","changeset","cli","parsing","firewall","change","workflow","go","2026-11-10 10:12:30",false,"---\nname: developer-release\ndescription: Release management, changeset workflow, firewall log parsing, breaking CLI change rules, and Go module summaries for gh-aw.\n---\n\n\n# Release and CLI Stability\n\nUse this reference for release management procedures, understanding what constitutes a breaking CLI change, firewall log parsing, and Go module summaries.\n\n## Table of Contents\n\n- [Release Management](#release-management)\n- [Firewall Log Parsing](#firewall-log-parsing)\n- [Breaking CLI Rules](#breaking-cli-rules)\n- [Go Module Summaries](#go-module-summaries)\n\n## Release Management\n\nThe project uses a minimalistic changeset-based release system inspired by `@changesets\u002Fcli`.\n\n### Commands\n\n#### version (Preview Only)\n\nThe `version` command operates in preview mode and never modifies files:\n\n```bash\nnode scripts\u002Fchangeset.js version\n# Or\nmake version\n```\n\nThis command:\n- Reads all changeset files from `.changeset\u002F` directory\n- Determines the appropriate version bump (major > minor > patch)\n- Shows a preview of the CHANGELOG entry\n- Never modifies any files\n\n#### release [type] [--yes|-y]\n\nThe `release` command creates an actual release:\n\n```bash\nnode scripts\u002Fchangeset.js release\n# Or (recommended - runs tests first)\nmake release\n```\n\nThis command:\n- Checks prerequisites (clean tree, main branch)\n- Updates `CHANGELOG.md` with new version and changes\n- Deletes processed changeset files (if any exist)\n- Automatically commits the changes\n- Creates and pushes a git tag for the release\n\n**Flags:**\n- `--yes` or `-y`: Skip confirmation prompt\n\n### Release Workflow\n\n```mermaid\ngraph TD\n    A[Add changeset files] --> B[Preview with version command]\n    B --> C{Changes look good?}\n    C -->|No| D[Modify changesets]\n    D --> B\n    C -->|Yes| E[Run release command]\n    E --> F[Update CHANGELOG.md]\n    F --> G[Delete changeset files]\n    G --> H[Commit changes]\n    H --> I[Create git tag]\n    I --> J[Push tag to remote]\n```\n\n### Changeset File Format\n\nChangeset files are markdown files in `.changeset\u002F` directory with YAML frontmatter:\n\n```markdown\n\"gh-aw\": patch\n\nBrief description of the change\n```\n\n**Bump types:**\n- `patch` - Bug fixes and minor changes (0.0.x)\n- `minor` - New features, backward compatible (0.x.0)\n- `major` - Breaking changes (x.0.0)\n\n### Prerequisites for Release\n\nWhen running `release`, the script checks:\n\n1. **Clean working tree:** All changes must be committed or stashed\n2. **On main branch:** Must be on the `main` branch to create a release\n\n### Releasing Without Changesets\n\nFor maintenance releases with dependency updates:\n\n```bash\n# Defaults to patch release\nnode scripts\u002Fchangeset.js release\n\n# Or specify release type explicitly\nnode scripts\u002Fchangeset.js release minor\n\n# Skip confirmation\nnode scripts\u002Fchangeset.js release --yes\n```\n\nThe script will:\n- Default to patch release if no type specified\n- Add a generic \"Maintenance release\" entry to CHANGELOG.md\n- Commit the changes\n- Create a git tag\n- Push the tag to remote\n\n\n## Firewall Log Parsing\n\nThe firewall log parser provides analysis of network traffic logs from agentic workflow runs.\n\n### Log Format\n\nFirewall logs use space-separated format with 10 fields:\n\n```\ntimestamp client_ip:port domain dest_ip:port proto method status decision url user_agent\n```\n\n**Example:**\n```\n1761332530.474 172.30.0.20:35288 api.enterprise.githubcopilot.com:443 140.82.112.22:443 1.1 CONNECT 200 TCP_TUNNEL:HIER_DIRECT api.enterprise.githubcopilot.com:443 \"-\"\n```\n\n### Field Descriptions\n\n1. **timestamp** - Unix timestamp with decimal (e.g., \"1761332530.474\")\n2. **client_ip:port** - Client IP and port or \"-\"\n3. **domain** - Target domain:port or \"-\"\n4. **dest_ip:port** - Destination IP and port or \"-\"\n5. **proto** - Protocol version (e.g., \"1.1\") or \"-\"\n6. **method** - HTTP method (e.g., \"CONNECT\", \"GET\") or \"-\"\n7. **status** - HTTP status code (e.g., \"200\", \"403\") or \"0\"\n8. **decision** - Proxy decision (e.g., \"TCP_TUNNEL:HIER_DIRECT\") or \"-\"\n9. **url** - Request URL or \"-\"\n10. **user_agent** - User agent string (quoted) or \"-\"\n\n### Request Classification\n\n```mermaid\ngraph TD\n    A[Parse log line] --> B{Check status}\n    B -->|200, 206, 304| C[Allowed]\n    B -->|403, 407| D[Denied]\n    B -->|Other| E{Check decision}\n    E -->|Contains TCP_TUNNEL, TCP_HIT, TCP_MISS| C\n    E -->|Contains NONE_NONE, TCP_DENIED| D\n    E -->|Other| F[Denied by default]\n```\n\n**Allowed Indicators:**\n- Status codes: 200, 206, 304\n- Decisions containing: TCP_TUNNEL, TCP_HIT, TCP_MISS\n\n**Denied Indicators:**\n- Status codes: 403, 407\n- Decisions containing: NONE_NONE, TCP_DENIED\n\n**Default:** Denied (for safety when classification is ambiguous)\n\n### Output Examples\n\n#### Console Output\n\n```\n? Firewall Log Analysis\nTotal Requests   : 8\nAllowed Requests : 5\nDenied Requests  : 3\n\nAllowed Domains:\n  ✓ api.enterprise.githubcopilot.com:443 (1 requests)\n  ✓ api.github.com:443 (2 requests)\n\nBlocked Domains:\n  ✗ blocked-domain.example.com:443 (2 requests)\n```\n\n#### JSON Output\n\n```json\n{\n  \"firewall_log\": {\n    \"total_requests\": 8,\n    \"allowed_requests\": 5,\n    \"blocked_requests\": 3,\n    \"allowed_domains\": [\n      \"api.enterprise.githubcopilot.com:443\",\n      \"api.github.com:443\"\n    ],\n    \"blocked_domains\": [\n      \"blocked-domain.example.com:443\"\n    ],\n    \"requests_by_domain\": {\n      \"api.github.com:443\": {\n        \"allowed\": 2,\n        \"blocked\": 0\n      }\n    }\n  }\n}\n```\n\n### Integration Points\n\nThe `logs` and `audit` commands automatically:\n1. Search for firewall logs in run directories\n2. Parse all `.log` files in `firewall-logs\u002F` or `squid-logs\u002F` directories\n3. Aggregate statistics across all log files\n4. Include firewall analysis in console and JSON output\n5. Cache results in `run_summary.json`\n\n### Implementation\n\n**Files:**\n- `pkg\u002Fcli\u002Ffirewall_log.go` (396 lines) - Core parser implementation\n- `pkg\u002Fcli\u002Ffirewall_log_test.go` (437 lines) - Unit tests\n- `pkg\u002Fcli\u002Ffirewall_log_integration_test.go` (238 lines) - Integration tests\n\n**Testing:**\n```bash\n# Unit tests\nmake test-unit\n\n# Integration tests\ngo test .\u002Fpkg\u002Fcli -run TestFirewallLogIntegration\n```\n\n\n## Breaking CLI Rules\n\nThis section defines what constitutes a breaking change for the gh-aw CLI. These rules help maintainers and contributors evaluate changes during code review and ensure stability for users.\n\n### Overview\n\nBreaking changes require special attention during development and review because they can disrupt existing user workflows. This section provides clear criteria for identifying breaking changes and guidance on how to handle them.\n\n### Categories of Changes\n\n#### Breaking Changes (Major Version Bump)\n\nThe following changes are **always breaking** and require:\n- A `major` changeset type\n- Documentation in CHANGELOG.md with migration guidance\n- Review by maintainers\n\n**1. Command Removal or Renaming**\n\nBreaking:\n- Removing a command entirely (e.g., removing `gh aw logs`)\n- Renaming a command without an alias (e.g., `gh aw compile` → `gh aw build`)\n- Removing a subcommand (e.g., removing `gh aw mcp inspect`)\n\nExamples from past releases:\n- Removing `--no-instructions` flag from compile command (v0.17.0)\n\n**2. Flag Removal or Renaming**\n\nBreaking:\n- Removing a flag (e.g., removing `--strict` flag)\n- Changing a flag name without backward compatibility (e.g., `--output` → `--out`)\n- Changing a flag's short form (e.g., `-o` → `-f`)\n- Changing a required flag to have no default when it previously had one\n\nExamples from past releases:\n- Remove GITHUB_TOKEN fallback for Copilot operations (v0.24.0)\n\n**3. Output Format Changes**\n\nBreaking:\n- Changing the structure of JSON output (removing fields, renaming fields)\n- Changing the order of columns in table output that users might parse positionally\n- Changing exit codes for specific scenarios\n- Removing output fields that scripts may depend on\n\nExamples from past releases:\n- Update status command JSON output structure (v0.21.0): replaced `agent` with `engine_id`, removed `frontmatter` and `prompt` fields\n\n**4. Behavior Changes**\n\nBreaking:\n- Changing default values for flags (e.g., `strict: false` → `strict: true`)\n- Changing authentication requirements\n- Changing permission requirements\n- Changing the semantics of existing options\n\nExamples from past releases:\n- Change strict mode default from false to true (v0.31.0)\n- Remove per-tool Squid proxy - unify network filtering (v0.25.0)\n\n**5. Schema Changes**\n\nBreaking:\n- Removing fields from workflow frontmatter schema\n- Making optional fields required\n- Changing the type of a field (e.g., string → object)\n- Removing allowed values from enums\n\nExamples from past releases:\n- Remove \"defaults\" section from main JSON schema (v0.24.0)\n- Remove deprecated \"claude\" top-level field (v0.24.0)\n\n#### Non-Breaking Changes (Minor or Patch Version Bump)\n\nThe following changes are **not breaking** and typically require:\n- A `minor` changeset for new features\n- A `patch` changeset for bug fixes\n\n**1. Additions**\n\nNot Breaking:\n- Adding new commands\n- Adding new flags with reasonable defaults\n- Adding new fields to JSON output\n- Adding new optional fields to schema\n- Adding new allowed values to enums\n- Adding new exit codes for new scenarios\n\nExamples:\n- Add `--json` flag to status command (v0.20.0)\n- Add mcp-server command (v0.17.0)\n\n**2. Deprecations**\n\nNot Breaking (when handled correctly):\n- Deprecating commands (with warning, keeping functionality)\n- Deprecating flags (with warning, keeping functionality)\n- Deprecating schema fields (with warning, keeping functionality)\n\nRequirements for deprecation:\n- Print deprecation warning to stderr\n- Document the deprecation and migration path\n- Keep deprecated functionality working for at least one minor release\n- Schedule removal in a future major version\n\n**3. Bug Fixes**\n\nNot Breaking (when fixing unintended behavior):\n- Fixing incorrect output\n- Fixing incorrect exit codes\n- Fixing schema validation that was too permissive\n\nNote: Fixing a bug that users depend on may require a breaking change notice.\n\n**4. Performance Improvements**\n\nNot Breaking:\n- Faster execution\n- Reduced memory usage\n- Parallel processing optimizations\n\n**5. Documentation Changes**\n\nNot Breaking:\n- Improving help text\n- Adding examples\n- Clarifying error messages\n\n### Decision Tree: Is This Breaking?\n\n```mermaid\ngraph TD\n    A[CLI Change Proposed] --> B{Removing or renaming\u003Cbr\u002F>command\u002Fsubcommand\u002Fflag?}\n    B -->|Yes| BREAK1[BREAKING]\n    B -->|No| C{Modifying JSON output\u003Cbr\u002F>structure?}\n    C -->|Yes| BREAK2[BREAKING]\n    C -->|No| D{Altering default\u003Cbr\u002F>behavior?}\n    D -->|Yes| BREAK3[BREAKING]\n    D -->|No| E{Modifying exit codes\u003Cbr\u002F>for existing scenarios?}\n    E -->|Yes| BREAK4[BREAKING]\n    E -->|No| F{Removing schema fields\u003Cbr\u002F>or making optional required?}\n    F -->|Yes| BREAK5[BREAKING]\n    F -->|No| SAFE[NOT BREAKING]\n\n    BREAK1 --> REQ[Requires:\u003Cbr\u002F>- major changeset\u003Cbr\u002F>- Migration guide\u003Cbr\u002F>- Maintainer review]\n    BREAK2 --> REQ\n    BREAK3 --> REQ\n    BREAK4 --> REQ\n    BREAK5 --> REQ\n\n    SAFE --> ACT[Allowed:\u003Cbr\u002F>- minor for features\u003Cbr\u002F>- patch for fixes]\n```\n\n### Guidelines for Contributors\n\n**When Making CLI Changes:**\n\n1. Check the decision tree before implementing changes\n2. Document breaking changes clearly in the changeset\n3. Provide migration guidance for users affected by breaking changes\n4. Consider backward compatibility - can you add an alias instead of renaming?\n5. Use deprecation warnings for at least one minor release before removal\n\n**Changeset Format for Breaking Changes:**\n\n```markdown\n\"gh-aw\": major\n\nRemove deprecated `--old-flag` option\n\n**⚠️ Breaking Change**: The `--old-flag` option has been removed.\n\n**Migration guide:**\n- If you used `--old-flag value`, use `--new-flag value` instead\n- Scripts using this flag will need to be updated\n\n**Reason**: The option was deprecated in v0.X.0 and has been removed to simplify the CLI.\n```\n\n**Changeset Format for Non-Breaking Changes:**\n\nFor new features:\n```markdown\n\"gh-aw\": minor\n\nAdd --json flag to logs command for structured output\n```\n\nFor bug fixes:\n```markdown\n\"gh-aw\": patch\n\nFix incorrect exit code when workflow file not found\n```\n\n### Review Checklist for CLI Changes\n\nReviewers should verify:\n\n- [ ] Breaking change identified correctly - Does this change match any breaking change criteria?\n- [ ] Changeset type appropriate - Is it marked as major\u002Fminor\u002Fpatch correctly?\n- [ ] Migration guidance provided - For breaking changes, is there clear migration documentation?\n- [ ] Deprecation warning added - If deprecating, does it warn users?\n- [ ] Backward compatibility considered - Could this be done without breaking compatibility?\n- [ ] Tests updated - Do tests cover the changed behavior?\n- [ ] Help text updated - Is the CLI help accurate?\n\n### Exit Code Standards\n\nThe CLI uses standard exit codes:\n\n| Exit Code | Meaning | Breaking to Change |\n|-----------|---------|-------------------|\n| 0 | Success | No (adding is fine) |\n| 1 | General error | No (for new errors) |\n| 2 | Invalid usage | No (for new checks) |\n\nBreaking: Changing the exit code for an existing scenario (e.g., changing from 1 to 2 for a specific error type).\n\n### JSON Output Standards\n\nWhen adding or modifying JSON output:\n\n1. Never remove fields without a major version bump\n2. Never rename fields without a major version bump\n3. Never change field types without a major version bump\n4. Adding new fields is safe - parsers should ignore unknown fields\n5. Adding new enum values is safe - parsers should handle unknown values gracefully\n\n### Strict Mode and Security Changes\n\nSpecial consideration for strict mode changes:\n\n- Making strict mode validation refuse instead of warn is breaking (e.g., v0.30.0)\n- Changing strict mode defaults is breaking (e.g., v0.31.0)\n- Adding new strict mode validations is not breaking (strictness is opt-in initially)\n\n### References\n\n- **Changeset System**: See Release Management section for version management details\n- **CHANGELOG**: See `CHANGELOG.md` for examples of breaking changes\n- **Semantic Versioning**: https:\u002F\u002Fsemver.org\u002F\n\n\n## Go Module Summaries\n\nThe `scratchpad\u002Fmods\u002F` directory contains AI-generated summaries of Go module usage patterns in the gh-aw repository, created by the Go Fan workflow.\n\n### Purpose\n\nGo module summaries provide:\n- **Module overview** and version information\n- **Files and APIs** that use the module\n- **Research findings** from the module's GitHub repository\n- **Improvement opportunities** (quick wins, feature opportunities, best practices)\n- **References** to documentation and changelog\n\n### File Naming Convention\n\nModule summary files follow a consistent naming pattern where the Go module path has slashes replaced with dashes:\n\n| Module Path | File Name |\n|-------------|-----------|\n| `github.com\u002Fgoccy\u002Fgo-yaml` | `goccy-go-yaml.md` |\n| `github.com\u002Fspf13\u002Fcobra` | `spf13-cobra.md` |\n| `github.com\u002Fstretchr\u002Ftestify` | `stretchr-testify.md` |\n\n### Generation Process\n\nThe summaries are generated by the [Go Fan workflow](\u002F.github\u002Fworkflows\u002Fgo-fan.md):\n\n```mermaid\ngraph LR\n    A[Scheduled Trigger\u003Cbr\u002F>Weekdays 7 AM UTC] --> B[Load Cache Memory]\n    B --> C[Select Next Module\u003Cbr\u002F>Round-Robin]\n    C --> D[Analyze Module Usage]\n    D --> E[Research GitHub Repo]\n    E --> F[Generate Summary]\n    F --> G[Write to scratchpad\u002Fmods\u002F]\n    G --> H[Update Cache Memory]\n    H --> I[Commit & Push]\n```\n\n**Update Frequency**: Daily on weekdays (Monday-Friday) at 7 AM UTC\n\n**Round-Robin Selection**: The workflow uses cache-memory to track which module was analyzed last, ensuring each module gets updated in rotation.\n\n### Usage Guidelines\n\nWhen working with Go modules in the codebase:\n\n1. **Check existing summaries** in `scratchpad\u002Fmods\u002F` for module-specific patterns and best practices\n2. **Reference improvement opportunities** when upgrading or refactoring module usage\n3. **Consult API documentation links** provided in the summaries for authoritative reference\n4. **Update summaries manually** if significant changes are made to module usage patterns (the workflow will refresh on its next run)\n\n### Summary Contents\n\nEach module summary includes the following sections:\n\n- **Module Overview**: Version used and general purpose\n- **Usage Analysis**: Files and code locations using the module\n- **API Surface**: Functions, types, and methods utilized\n- **Research Findings**: Information from the module's repository (recent releases, documentation, best practices)\n- **Improvement Opportunities**: Suggestions for better module usage\n- **References**: Links to documentation, changelog, and GitHub repository\n\n\n**Last Updated:** 2025-12-01\n**Maintainers:** GitHub Next Team\n","# Release and CLI Stability\n\nUse this reference for release management procedures, understanding what constitutes a breaking CLI change, firewall log parsing, and Go module summaries.\n\n## Table of Contents\n\n- [Release Management](#release-management)\n- [Firewall Log Parsing](#firewall-log-parsing)\n- [Breaking CLI Rules](#breaking-cli-rules)\n- [Go Module Summaries](#go-module-summaries)\n\n## Release Management\n\nThe project uses a minimalistic changeset-based release system inspired by `@changesets\u002Fcli`.\n\n### Commands\n\n#### version (Preview Only)\n\nThe `version` command operates in preview mode and never modifies files:\n\n```bash\nnode scripts\u002Fchangeset.js version\n# Or\nmake version\n```\n\nThis command:\n- Reads all changeset files from `.changeset\u002F` directory\n- Determines the appropriate version bump (major > minor > patch)\n- Shows a preview of the CHANGELOG entry\n- Never modifies any files\n\n#### release [type] [--yes|-y]\n\nThe `release` command creates an actual release:\n\n```bash\nnode scripts\u002Fchangeset.js release\n# Or (recommended - runs tests first)\nmake release\n```\n\nThis command:\n- Checks prerequisites (clean tree, main branch)\n- Updates `CHANGELOG.md` with new version and changes\n- Deletes processed changeset files (if any exist)\n- Automatically commits the changes\n- Creates and pushes a git tag for the release\n\n**Flags:**\n- `--yes` or `-y`: Skip confirmation prompt\n\n### Release Workflow\n\n```mermaid\ngraph TD\n    A[Add changeset files] --> B[Preview with version command]\n    B --> C{Changes look good?}\n    C -->|No| D[Modify changesets]\n    D --> B\n    C -->|Yes| E[Run release command]\n    E --> F[Update CHANGELOG.md]\n    F --> G[Delete changeset files]\n    G --> H[Commit changes]\n    H --> I[Create git tag]\n    I --> J[Push tag to remote]\n```\n\n### Changeset File Format\n\nChangeset files are markdown files in `.changeset\u002F` directory with YAML frontmatter:\n\n```markdown\n\"gh-aw\": patch\n\nBrief description of the change\n```\n\n**Bump types:**\n- `patch` - Bug fixes and minor changes (0.0.x)\n- `minor` - New features, backward compatible (0.x.0)\n- `major` - Breaking changes (x.0.0)\n\n### Prerequisites for Release\n\nWhen running `release`, the script checks:\n\n1. **Clean working tree:** All changes must be committed or stashed\n2. **On main branch:** Must be on the `main` branch to create a release\n\n### Releasing Without Changesets\n\nFor maintenance releases with dependency updates:\n\n```bash\n# Defaults to patch release\nnode scripts\u002Fchangeset.js release\n\n# Or specify release type explicitly\nnode scripts\u002Fchangeset.js release minor\n\n# Skip confirmation\nnode scripts\u002Fchangeset.js release --yes\n```\n\nThe script will:\n- Default to patch release if no type specified\n- Add a generic \"Maintenance release\" entry to CHANGELOG.md\n- Commit the changes\n- Create a git tag\n- Push the tag to remote\n\n\n## Firewall Log Parsing\n\nThe firewall log parser provides analysis of network traffic logs from agentic workflow runs.\n\n### Log Format\n\nFirewall logs use space-separated format with 10 fields:\n\n```\ntimestamp client_ip:port domain dest_ip:port proto method status decision url user_agent\n```\n\n**Example:**\n```\n1761332530.474 172.30.0.20:35288 api.enterprise.githubcopilot.com:443 140.82.112.22:443 1.1 CONNECT 200 TCP_TUNNEL:HIER_DIRECT api.enterprise.githubcopilot.com:443 \"-\"\n```\n\n### Field Descriptions\n\n1. **timestamp** - Unix timestamp with decimal (e.g., \"1761332530.474\")\n2. **client_ip:port** - Client IP and port or \"-\"\n3. **domain** - Target domain:port or \"-\"\n4. **dest_ip:port** - Destination IP and port or \"-\"\n5. **proto** - Protocol version (e.g., \"1.1\") or \"-\"\n6. **method** - HTTP method (e.g., \"CONNECT\", \"GET\") or \"-\"\n7. **status** - HTTP status code (e.g., \"200\", \"403\") or \"0\"\n8. **decision** - Proxy decision (e.g., \"TCP_TUNNEL:HIER_DIRECT\") or \"-\"\n9. **url** - Request URL or \"-\"\n10. **user_agent** - User agent string (quoted) or \"-\"\n\n### Request Classification\n\n```mermaid\ngraph TD\n    A[Parse log line] --> B{Check status}\n    B -->|200, 206, 304| C[Allowed]\n    B -->|403, 407| D[Denied]\n    B -->|Other| E{Check decision}\n    E -->|Contains TCP_TUNNEL, TCP_HIT, TCP_MISS| C\n    E -->|Contains NONE_NONE, TCP_DENIED| D\n    E -->|Other| F[Denied by default]\n```\n\n**Allowed Indicators:**\n- Status codes: 200, 206, 304\n- Decisions containing: TCP_TUNNEL, TCP_HIT, TCP_MISS\n\n**Denied Indicators:**\n- Status codes: 403, 407\n- Decisions containing: NONE_NONE, TCP_DENIED\n\n**Default:** Denied (for safety when classification is ambiguous)\n\n### Output Examples\n\n#### Console Output\n\n```\n? Firewall Log Analysis\nTotal Requests   : 8\nAllowed Requests : 5\nDenied Requests  : 3\n\nAllowed Domains:\n  ✓ api.enterprise.githubcopilot.com:443 (1 requests)\n  ✓ api.github.com:443 (2 requests)\n\nBlocked Domains:\n  ✗ blocked-domain.example.com:443 (2 requests)\n```\n\n#### JSON Output\n\n```json\n{\n  \"firewall_log\": {\n    \"total_requests\": 8,\n    \"allowed_requests\": 5,\n    \"blocked_requests\": 3,\n    \"allowed_domains\": [\n      \"api.enterprise.githubcopilot.com:443\",\n      \"api.github.com:443\"\n    ],\n    \"blocked_domains\": [\n      \"blocked-domain.example.com:443\"\n    ],\n    \"requests_by_domain\": {\n      \"api.github.com:443\": {\n        \"allowed\": 2,\n        \"blocked\": 0\n      }\n    }\n  }\n}\n```\n\n### Integration Points\n\nThe `logs` and `audit` commands automatically:\n1. Search for firewall logs in run directories\n2. Parse all `.log` files in `firewall-logs\u002F` or `squid-logs\u002F` directories\n3. Aggregate statistics across all log files\n4. Include firewall analysis in console and JSON output\n5. Cache results in `run_summary.json`\n\n### Implementation\n\n**Files:**\n- `pkg\u002Fcli\u002Ffirewall_log.go` (396 lines) - Core parser implementation\n- `pkg\u002Fcli\u002Ffirewall_log_test.go` (437 lines) - Unit tests\n- `pkg\u002Fcli\u002Ffirewall_log_integration_test.go` (238 lines) - Integration tests\n\n**Testing:**\n```bash\n# Unit tests\nmake test-unit\n\n# Integration tests\ngo test .\u002Fpkg\u002Fcli -run TestFirewallLogIntegration\n```\n\n\n## Breaking CLI Rules\n\nThis section defines what constitutes a breaking change for the gh-aw CLI. These rules help maintainers and contributors evaluate changes during code review and ensure stability for users.\n\n### Overview\n\nBreaking changes require special attention during development and review because they can disrupt existing user workflows. This section provides clear criteria for identifying breaking changes and guidance on how to handle them.\n\n### Categories of Changes\n\n#### Breaking Changes (Major Version Bump)\n\nThe following changes are **always breaking** and require:\n- A `major` changeset type\n- Documentation in CHANGELOG.md with migration guidance\n- Review by maintainers\n\n**1. Command Removal or Renaming**\n\nBreaking:\n- Removing a command entirely (e.g., removing `gh aw logs`)\n- Renaming a command without an alias (e.g., `gh aw compile` → `gh aw build`)\n- Removing a subcommand (e.g., removing `gh aw mcp inspect`)\n\nExamples from past releases:\n- Removing `--no-instructions` flag from compile command (v0.17.0)\n\n**2. Flag Removal or Renaming**\n\nBreaking:\n- Removing a flag (e.g., removing `--strict` flag)\n- Changing a flag name without backward compatibility (e.g., `--output` → `--out`)\n- Changing a flag's short form (e.g., `-o` → `-f`)\n- Changing a required flag to have no default when it previously had one\n\nExamples from past releases:\n- Remove GITHUB_TOKEN fallback for Copilot operations (v0.24.0)\n\n**3. Output Format Changes**\n\nBreaking:\n- Changing the structure of JSON output (removing fields, renaming fields)\n- Changing the order of columns in table output that users might parse positionally\n- Changing exit codes for specific scenarios\n- Removing output fields that scripts may depend on\n\nExamples from past releases:\n- Update status command JSON output structure (v0.21.0): replaced `agent` with `engine_id`, removed `frontmatter` and `prompt` fields\n\n**4. Behavior Changes**\n\nBreaking:\n- Changing default values for flags (e.g., `strict: false` → `strict: true`)\n- Changing authentication requirements\n- Changing permission requirements\n- Changing the semantics of existing options\n\nExamples from past releases:\n- Change strict mode default from false to true (v0.31.0)\n- Remove per-tool Squid proxy - unify network filtering (v0.25.0)\n\n**5. Schema Changes**\n\nBreaking:\n- Removing fields from workflow frontmatter schema\n- Making optional fields required\n- Changing the type of a field (e.g., string → object)\n- Removing allowed values from enums\n\nExamples from past releases:\n- Remove \"defaults\" section from main JSON schema (v0.24.0)\n- Remove deprecated \"claude\" top-level field (v0.24.0)\n\n#### Non-Breaking Changes (Minor or Patch Version Bump)\n\nThe following changes are **not breaking** and typically require:\n- A `minor` changeset for new features\n- A `patch` changeset for bug fixes\n\n**1. Additions**\n\nNot Breaking:\n- Adding new commands\n- Adding new flags with reasonable defaults\n- Adding new fields to JSON output\n- Adding new optional fields to schema\n- Adding new allowed values to enums\n- Adding new exit codes for new scenarios\n\nExamples:\n- Add `--json` flag to status command (v0.20.0)\n- Add mcp-server command (v0.17.0)\n\n**2. Deprecations**\n\nNot Breaking (when handled correctly):\n- Deprecating commands (with warning, keeping functionality)\n- Deprecating flags (with warning, keeping functionality)\n- Deprecating schema fields (with warning, keeping functionality)\n\nRequirements for deprecation:\n- Print deprecation warning to stderr\n- Document the deprecation and migration path\n- Keep deprecated functionality working for at least one minor release\n- Schedule removal in a future major version\n\n**3. Bug Fixes**\n\nNot Breaking (when fixing unintended behavior):\n- Fixing incorrect output\n- Fixing incorrect exit codes\n- Fixing schema validation that was too permissive\n\nNote: Fixing a bug that users depend on may require a breaking change notice.\n\n**4. Performance Improvements**\n\nNot Breaking:\n- Faster execution\n- Reduced memory usage\n- Parallel processing optimizations\n\n**5. Documentation Changes**\n\nNot Breaking:\n- Improving help text\n- Adding examples\n- Clarifying error messages\n\n### Decision Tree: Is This Breaking?\n\n```mermaid\ngraph TD\n    A[CLI Change Proposed] --> B{Removing or renaming\u003Cbr\u002F>command\u002Fsubcommand\u002Fflag?}\n    B -->|Yes| BREAK1[BREAKING]\n    B -->|No| C{Modifying JSON output\u003Cbr\u002F>structure?}\n    C -->|Yes| BREAK2[BREAKING]\n    C -->|No| D{Altering default\u003Cbr\u002F>behavior?}\n    D -->|Yes| BREAK3[BREAKING]\n    D -->|No| E{Modifying exit codes\u003Cbr\u002F>for existing scenarios?}\n    E -->|Yes| BREAK4[BREAKING]\n    E -->|No| F{Removing schema fields\u003Cbr\u002F>or making optional required?}\n    F -->|Yes| BREAK5[BREAKING]\n    F -->|No| SAFE[NOT BREAKING]\n\n    BREAK1 --> REQ[Requires:\u003Cbr\u002F>- major changeset\u003Cbr\u002F>- Migration guide\u003Cbr\u002F>- Maintainer review]\n    BREAK2 --> REQ\n    BREAK3 --> REQ\n    BREAK4 --> REQ\n    BREAK5 --> REQ\n\n    SAFE --> ACT[Allowed:\u003Cbr\u002F>- minor for features\u003Cbr\u002F>- patch for fixes]\n```\n\n### Guidelines for Contributors\n\n**When Making CLI Changes:**\n\n1. Check the decision tree before implementing changes\n2. Document breaking changes clearly in the changeset\n3. Provide migration guidance for users affected by breaking changes\n4. Consider backward compatibility - can you add an alias instead of renaming?\n5. Use deprecation warnings for at least one minor release before removal\n\n**Changeset Format for Breaking Changes:**\n\n```markdown\n\"gh-aw\": major\n\nRemove deprecated `--old-flag` option\n\n**⚠️ Breaking Change**: The `--old-flag` option has been removed.\n\n**Migration guide:**\n- If you used `--old-flag value`, use `--new-flag value` instead\n- Scripts using this flag will need to be updated\n\n**Reason**: The option was deprecated in v0.X.0 and has been removed to simplify the CLI.\n```\n\n**Changeset Format for Non-Breaking Changes:**\n\nFor new features:\n```markdown\n\"gh-aw\": minor\n\nAdd --json flag to logs command for structured output\n```\n\nFor bug fixes:\n```markdown\n\"gh-aw\": patch\n\nFix incorrect exit code when workflow file not found\n```\n\n### Review Checklist for CLI Changes\n\nReviewers should verify:\n\n- [ ] Breaking change identified correctly - Does this change match any breaking change criteria?\n- [ ] Changeset type appropriate - Is it marked as major\u002Fminor\u002Fpatch correctly?\n- [ ] Migration guidance provided - For breaking changes, is there clear migration documentation?\n- [ ] Deprecation warning added - If deprecating, does it warn users?\n- [ ] Backward compatibility considered - Could this be done without breaking compatibility?\n- [ ] Tests updated - Do tests cover the changed behavior?\n- [ ] Help text updated - Is the CLI help accurate?\n\n### Exit Code Standards\n\nThe CLI uses standard exit codes:\n\n| Exit Code | Meaning | Breaking to Change |\n|-----------|---------|-------------------|\n| 0 | Success | No (adding is fine) |\n| 1 | General error | No (for new errors) |\n| 2 | Invalid usage | No (for new checks) |\n\nBreaking: Changing the exit code for an existing scenario (e.g., changing from 1 to 2 for a specific error type).\n\n### JSON Output Standards\n\nWhen adding or modifying JSON output:\n\n1. Never remove fields without a major version bump\n2. Never rename fields without a major version bump\n3. Never change field types without a major version bump\n4. Adding new fields is safe - parsers should ignore unknown fields\n5. Adding new enum values is safe - parsers should handle unknown values gracefully\n\n### Strict Mode and Security Changes\n\nSpecial consideration for strict mode changes:\n\n- Making strict mode validation refuse instead of warn is breaking (e.g., v0.30.0)\n- Changing strict mode defaults is breaking (e.g., v0.31.0)\n- Adding new strict mode validations is not breaking (strictness is opt-in initially)\n\n### References\n\n- **Changeset System**: See Release Management section for version management details\n- **CHANGELOG**: See `CHANGELOG.md` for examples of breaking changes\n- **Semantic Versioning**: https:\u002F\u002Fsemver.org\u002F\n\n\n## Go Module Summaries\n\nThe `scratchpad\u002Fmods\u002F` directory contains AI-generated summaries of Go module usage patterns in the gh-aw repository, created by the Go Fan workflow.\n\n### Purpose\n\nGo module summaries provide:\n- **Module overview** and version information\n- **Files and APIs** that use the module\n- **Research findings** from the module's GitHub repository\n- **Improvement opportunities** (quick wins, feature opportunities, best practices)\n- **References** to documentation and changelog\n\n### File Naming Convention\n\nModule summary files follow a consistent naming pattern where the Go module path has slashes replaced with dashes:\n\n| Module Path | File Name |\n|-------------|-----------|\n| `github.com\u002Fgoccy\u002Fgo-yaml` | `goccy-go-yaml.md` |\n| `github.com\u002Fspf13\u002Fcobra` | `spf13-cobra.md` |\n| `github.com\u002Fstretchr\u002Ftestify` | `stretchr-testify.md` |\n\n### Generation Process\n\nThe summaries are generated by the [Go Fan workflow](\u002F.github\u002Fworkflows\u002Fgo-fan.md):\n\n```mermaid\ngraph LR\n    A[Scheduled Trigger\u003Cbr\u002F>Weekdays 7 AM UTC] --> B[Load Cache Memory]\n    B --> C[Select Next Module\u003Cbr\u002F>Round-Robin]\n    C --> D[Analyze Module Usage]\n    D --> E[Research GitHub Repo]\n    E --> F[Generate Summary]\n    F --> G[Write to scratchpad\u002Fmods\u002F]\n    G --> H[Update Cache Memory]\n    H --> I[Commit & Push]\n```\n\n**Update Frequency**: Daily on weekdays (Monday-Friday) at 7 AM UTC\n\n**Round-Robin Selection**: The workflow uses cache-memory to track which module was analyzed last, ensuring each module gets updated in rotation.\n\n### Usage Guidelines\n\nWhen working with Go modules in the codebase:\n\n1. **Check existing summaries** in `scratchpad\u002Fmods\u002F` for module-specific patterns and best practices\n2. **Reference improvement opportunities** when upgrading or refactoring module usage\n3. **Consult API documentation links** provided in the summaries for authoritative reference\n4. **Update summaries manually** if significant changes are made to module usage patterns (the workflow will refresh on its next run)\n\n### Summary Contents\n\nEach module summary includes the following sections:\n\n- **Module Overview**: Version used and general purpose\n- **Usage Analysis**: Files and code locations using the module\n- **API Surface**: Functions, types, and methods utilized\n- **Research Findings**: Information from the module's repository (recent releases, documentation, best practices)\n- **Improvement Opportunities**: Suggestions for better module usage\n- **References**: Links to documentation, changelog, and GitHub repository\n\n\n**Last Updated:** 2025-12-01\n**Maintainers:** GitHub Next Team\n",{"name":5,"description":7},"main","8541229759617347888641eba917d3b0ad66a984",".github\u002Fskills\u002Fdeveloper-release",626,"https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw","https:\u002F\u002Fgh.io\u002Fgh-aw","https:\u002F\u002Fgithub.com\u002Fgithub","https:\u002F\u002Fgithub.com\u002Fabout","How people build software.","2026-11-15 06:45:15",{"source":8,"skillName":5,"commands":58,"prompt":68,"zipAvailable":69},[59,62,65],{"tool":60,"command":61},"npx","npx skills add github\u002Fgh-aw --skill developer-release",{"tool":63,"command":64},"bunx","bunx skills add github\u002Fgh-aw --skill developer-release",{"tool":66,"command":67},"pnpm","pnpm dlx skills add github\u002Fgh-aw --skill developer-release","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fdeveloper-release\u002FSKILL.md",true,[71,77],{"path":72,"resourceType":73,"resourceTypeDesc":74,"sizeBytes":75,"sourceHtmlUrl":76},"references\u002FREFERENCE.md","REFERENCE","参考文档",6703,"https:\u002F\u002Fgithub.com\u002Fviktomas\u002Fdotfiles\u002Fblob\u002Fmaster\u002Fpi\u002F.pi\u002Fagent\u002Fpurge\u002Fskills\u002Ftmux-cli-testing\u002Freferences\u002FREFERENCE.md",{"path":78,"resourceType":79,"resourceTypeDesc":80,"sizeBytes":81,"sourceHtmlUrl":82},"scripts\u002Ftmux_test_helper.sh","SCRIPT","脚本",12772,"https:\u002F\u002Fgithub.com\u002Fviktomas\u002Fdotfiles\u002Fblob\u002Fmaster\u002Fpi\u002F.pi\u002Fagent\u002Fpurge\u002Fskills\u002Ftmux-cli-testing\u002Fscripts\u002Ftmux_test_helper.sh",[84,92,100,126,144,167],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":91},"01M7DQYVZ9W9DDXKQ9452SNP8J","cracktro","Edit, preview, and verify the standalone interactive talk deck in docs\u002Fpublic\u002Fcracktro (slides, SVG diagrams, transitions, WebAudio sound).","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fcracktro\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":99},"01M7612HQ4378TK8QZ5HPAF4KR","create-connector","Create or extend a declaration-only third-party connector, with narrow reads, separate safe outputs, optional protected triggers, and offline conformance evidence.","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.github\u002Fskills\u002Fcreate-connector\u002FSKILL.md",[],[],"2026-11-12 13:55:43",{"skillNo":101,"name":102,"nameZh":6,"description":103,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":104,"categories":105,"keywords":114,"publishedAt":42},"01M6ADC942STTXHFV410J4DH0X","GitHub Agentic Workflows","GitHub Agentic Workflows (`gh-aw`) is a GitHub CLI extension for writing Agentic Workflows in markdown and compiling them to GitHub Actions.","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002FSKILL.md",[106,111],{"categoryNo":107,"categoryName":108,"taxonomyType":109,"taxonomyTypeDesc":110},"01JBSEEDCAT000000000000011","运维与部署","SCENARIO","使用场景",{"categoryNo":112,"categoryName":113,"taxonomyType":109,"taxonomyTypeDesc":110},"01JBSEEDCAT000000000000023","Skill与智能体开发",[9,115,116,117,118,119,120,121,36,27,29,122,123,124,125],"github agentic workflows","agentic workflows","workflows","agentic","extension","markdown","github cli","compiling","writing","github actions","actions",{"skillNo":127,"name":128,"nameZh":6,"description":129,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":130,"categories":131,"keywords":132,"publishedAt":42},"01M6ADC6ZXSA46N9XD6VNAP1MS","windows-compatibility","Cross-platform path handling and command patterns","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Fwindows-compatibility\u002FSKILL.md",[],[133,134,135,136,137,138,139,140,141,142,143],"windows","windows compatibility","compatibility","command","git","bugs","platform","high","patterns","cross-platform","path",{"skillNo":145,"name":146,"nameZh":6,"description":147,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":148,"categories":149,"keywords":150,"publishedAt":42},"01M6ADC44957SVQF96R5YY247P","versioning-policy","Semver versioning rules for Squad SDK and CLI — prevents prerelease version incidents","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Fversioning-policy\u002FSKILL.md",[],[151,152,153,154,155,36,156,157,158,24,159,160,161,162,29,163,164,34,165,166],"versioning","policy","versioning policy","gate","implementation","workspace","pr","sdk","ci","npm","semver","squad","incident","incidents","version","resolution",{"skillNo":168,"name":169,"nameZh":6,"description":170,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":171,"categories":172,"keywords":177,"publishedAt":42},"01M6ADC1PHMEAEVR87F8PDR89X","tiered-memory","Three-tier agent memory model (hot\u002Fcold\u002Fwiki) for context reduction per spawn","https:\u002F\u002Fgithub.com\u002Fgithub\u002Fgh-aw\u002Fblob\u002Fmain\u002F.squad\u002Ftemplates\u002Fskills\u002Ftiered-memory\u002FSKILL.md",[173,176],{"categoryNo":174,"categoryName":175,"taxonomyType":109,"taxonomyTypeDesc":110},"01JBSEEDCAT000000000000015","视觉设计",{"categoryNo":112,"categoryName":113,"taxonomyType":109,"taxonomyTypeDesc":110},[178,179,180,181,182,183,184,185,186,187,188,189,190,29,191,33],"tiered memory","memory","performance","design","agent memory","proposal","cold","model","wiki","spawn","memory-management","context","three","runtime"]