Repository Tree Map - October 11, 2025

[github-actions[bot]]

Repository Tree Map - gh-aw

Generated: October 11, 2025
Repository: githubnext/gh-aw
Total Files: 671 files

---

📊 Repository Overview

gh-aw/ [671 files]
├─ Go codebase
│  └─ 346 .go files (primary language)
├─ Documentation  
│  └─ 184 .md files
├─ JavaScript/Node
│  └─ 50 .cjs files (GitHub Actions scripts)
├─ Configuration
│  └─ 35 .yml files
└─ Other assets
   └─ 56 files (JSON, shell, etc.)

---

🌳 Directory Structure

Root Level [23 files]

gh-aw/
│
├─ 📚 Documentation Files [10 files]
│  ├─ AGENTS.md              (6.4 KB)  - AI agent guidelines
│  ├─ README.md              (3.6 KB)  - Project overview
│  ├─ DEVGUIDE.md            (6.0 KB)  - Development guide
│  ├─ TESTING.md             (4.0 KB)  - Testing strategy
│  ├─ CONTRIBUTING.md        (4.5 KB)  - Contribution guidelines
│  ├─ CHANGELOG.md           (3.4 KB)  - Version history
│  ├─ SECURITY.md            (1.7 KB)  - Security policy
│  ├─ CODE_OF_CONDUCT.md     (3.2 KB)  - Community standards
│  ├─ SUPPORT.md             (425 B)   - Support resources
│  └─ CHANGESET_README.md    (3.4 KB)  - Changeset info
│
├─ 🔧 Configuration Files [7 files]
│  ├─ Makefile               (6.8 KB)  - Build automation
│  ├─ go.mod                 (2.4 KB)  - Go dependencies
│  ├─ go.sum                 (12 KB)   - Dependency checksums ███
│  ├─ .golangci.yml          (1.0 KB)  - Linter config
│  ├─ .prettierrc.json       (184 B)   - Code formatting
│  ├─ .gitignore             (832 B)   - Git ignore rules
│  └─ .gitattributes         (357 B)   - Git attributes
│
└─ 🔨 Build Scripts [2 files]
   ├─ install-gh-aw.sh       (4.0 KB)  - Installation script
   └─ LICENSE                (1.0 KB)  - MIT License

---

📦 pkg/ [499 files] ████████████████████████

Primary Go codebase - 74% of repository

pkg/ [499 files, ~343 .go files]
│
├─ workflow/ [314 files, 63%] ████████████████████
│  │  Core workflow compilation and execution engine
│  │
│  ├─ 📄 Go Files [~231 .go files]
│  │  ├─ Engines:
│  │  │  ├─ agentic_engine.go
│  │  │  ├─ claude_engine.go        - Claude AI integration
│  │  │  ├─ codex_engine.go         - GitHub Codex integration
│  │  │  ├─ copilot_engine.go       - Copilot CLI integration
│  │  │  └─ custom_engine.go        - Custom engine support
│  │  │
│  │  ├─ Compilation:
│  │  │  ├─ compiler.go             - Main compiler logic
│  │  │  ├─ template.go             - Template rendering
│  │  │  ├─ jobs.go                 - Job generation
│  │  │  └─ yaml.go                 - YAML generation
│  │  │
│  │  ├─ Safe Outputs:
│  │  │  ├─ create_issue.go
│  │  │  ├─ create_pull_request.go
│  │  │  ├─ add_comment.go
│  │  │  ├─ update_issue.go
│  │  │  └─ safe_outputs.go
│  │  │
│  │  ├─ Security:
│  │  │  ├─ expression_safety.go    - Expression validation
│  │  │  ├─ threat_detection.go     - XPIA protection
│  │  │  ├─ redact_secrets.go       - Secret redaction
│  │  │  └─ xpia.go                 - Cross-prompt injection
│  │  │
│  │  ├─ MCP Integration:
│  │  │  ├─ mcp-config.go           - MCP server config
│  │  │  ├─ mcps.go                 - MCP management
│  │  │  └─ tools.go                - Tool configuration
│  │  │
│  │  ├─ Network:
│  │  │  ├─ network.go              - Network controls
│  │  │  ├─ network_proxy.go        - Proxy setup
│  │  │  ├─ domains.go              - Domain allowlists
│  │  │  └─ fetch.go                - Web fetching
│  │  │
│  │  └─ Git Operations:
│  │     ├─ git.go                  - Git integration
│  │     ├─ git_patch.go            - Patch handling
│  │     └─ git_commands_*.go       - Git commands
│  │
│  ├─ js/ [~55 files] ████████
│  │  │  JavaScript/TypeScript for GitHub Actions
│  │  │
│  │  ├─ 📄 CommonJS Scripts [50 .cjs files]
│  │  │  ├─ Log Parsers:
│  │  │  │  ├─ parse_claude_log.cjs
│  │  │  │  ├─ parse_codex_log.cjs
│  │  │  │  └─ parse_copilot_log.cjs
│  │  │  │
│  │  │  ├─ Safe Outputs:
│  │  │  │  ├─ create_issue.cjs
│  │  │  │  ├─ create_pull_request.cjs
│  │  │  │  ├─ add_comment.cjs
│  │  │  │  ├─ update_issue.cjs
│  │  │  │  ├─ create_pr_review_comment.cjs
│  │  │  │  └─ safe_outputs_mcp_server.cjs
│  │  │  │
│  │  │  ├─ Utilities:
│  │  │  │  ├─ compute_text.cjs       - Text sanitization
│  │  │  │  ├─ redact_secrets.cjs     - Secret masking
│  │  │  │  ├─ sanitize_output.cjs    - Output cleaning
│  │  │  │  ├─ validate_errors.cjs    - Error validation
│  │  │  │  └─ render_template.cjs    - Template engine
│  │  │  │
│  │  │  └─ Security:
│  │  │     ├─ check_permissions.cjs
│  │  │     └─ check_team_member.cjs
│  │  │
│  │  ├─ 🧪 Test Files [~25 .test.cjs files]
│  │  │  └─ Comprehensive test coverage
│  │  │
│  │  └─ 🔧 Config Files [5 files]
│  │     ├─ package.json
│  │     ├─ package-lock.json       (large file) ████
│  │     ├─ tsconfig.json
│  │     ├─ vitest.config.js
│  │     └─ tsconfig.build.json
│  │
│  ├─ 📁 Subdirectories:
│  │  ├─ config/                    - Config templates
│  │  ├─ data/                      - Test data
│  │  ├─ pretty/                    - Pretty printing
│  │  ├─ schemas/                   - JSON schemas
│  │  ├─ sh/                        - Shell utilities
│  │  ├─ templates/                 - Workflow templates
│  │  └─ test_data/                 - Test fixtures
│  │
│  └─ 🧪 Test Files [~150+ *_test.go files]
│     ├─ Integration tests (_integration_test.go)
│     ├─ Unit tests (_test.go)
│     └─ Specialized tests (*_simple_test.go)
│
├─ cli/ [155 files, 31%] ████████████
│  │  Command-line interface implementation
│  │
│  ├─ 📄 Go Files [~85 .go files]
│  │  ├─ Commands:
│  │  │  ├─ compile.go              - Workflow compilation
│  │  │  ├─ logs.go                 - Log download/analysis
│  │  │  ├─ audit.go                - Workflow auditing
│  │  │  └─ mcp.go                  - MCP server management
│  │  │
│  │  └─ Utilities:
│  │     ├─ config.go               - CLI configuration
│  │     ├─ formatting.go           - Output formatting
│  │     └─ helpers.go              - Helper functions
│  │
│  ├─ 📁 workflows/ [~70 files]
│  │  │  Test workflow definitions
│  │  │
│  │  ├─ *.md files                 - Workflow definitions
│  │  └─ *.lock.yml files           - Compiled workflows
│  │
│  └─ 🧪 Test Files [~70 *_test.go files]
│     └─ CLI command tests
│
├─ parser/ [24 files, 5%] ███
│  │  Markdown frontmatter parsing
│  │
│  ├─ 📄 Go Files [~21 .go files]
│  │  ├─ parser.go                  - Main parser
│  │  ├─ frontmatter.go             - YAML frontmatter
│  │  ├─ validation.go              - Schema validation
│  │  └─ imports.go                 - Import resolution
│  │
│  ├─ 📁 schemas/                   - JSON schemas
│  │  └─ Embedded schema files
│  │
│  └─ 🧪 Test Files
│     └─ parser_test.go
│
├─ console/ [5 files, 1%] █
│  │  Console output formatting
│  │
│  ├─ console.go                    - Formatting helpers
│  ├─ colors.go                     - Color definitions
│  └─ *_test.go                     - Tests
│
└─ constants/ [1 file] ░
   └─ constants.go                  - Global constants

---

🌐 .github/ [87 files] ████████

GitHub-specific configuration and workflows

.github/ [87 files]
│
├─ workflows/ [77 files, 89%] ████████████████████
│  │  Agentic workflow definitions
│  │
│  ├─ 📄 Markdown Workflows [43 .md files]
│  │  │  Human-readable workflow definitions
│  │  │
│  │  ├─ Issue Management:
│  │  │  ├─ issue-greeter.md
│  │  │  ├─ issue-triage.md
│  │  │  └─ label-sync.md
│  │  │
│  │  ├─ Code Analysis:
│  │  │  ├─ code-review.md
│  │  │  ├─ security-scan.md
│  │  │  └─ dependency-check.md
│  │  │
│  │  ├─ Documentation:
│  │  │  ├─ doc-sync.md
│  │  │  └─ readme-update.md
│  │  │
│  │  └─ Custom Agents:
│  │     └─ Various specialized workflows
│  │
│  ├─ 🔒 Compiled Workflows [25 .lock.yml files]
│  │  └─ Generated GitHub Actions YAML
│  │
│  └─ ⚙️ Standard Workflows [9 .yml files]
│     ├─ ci.yml                     - Continuous integration
│     ├─ release.yml                - Release automation
│     └─ test.yml                   - Test execution
│
├─ instructions/ [5 files] ██
│  │  Code modification guidelines
│  │
│  ├─ github-script.instructions.md
│  ├─ github-agentic-workflows.instructions.md
│  ├─ error-pattern-safety.instructions.md
│  ├─ documentation.instructions.md
│  └─ copilot-cli.instructions.md
│
└─ prompts/ [5 files] ██
   │  AI agent prompts
   │
   └─ Various prompt templates

---

📖 docs/ [45 files] ██████

Documentation site (Astro Starlight)

docs/ [45 files]
│
├─ src/ [35 files, 78%] ███████████████
│  │  Documentation source files
│  │
│  ├─ content/
│  │  ├─ docs/
│  │  │  ├─ getting-started/        - Tutorials
│  │  │  ├─ how-to/                 - How-to guides
│  │  │  ├─ reference/              - API reference
│  │  │  └─ concepts/               - Explanations
│  │  │
│  │  └─ config.ts                  - Site configuration
│  │
│  └─ components/                   - Astro components
│
├─ public/                          - Static assets
│  └─ Images, icons, etc.
│
└─ 🔧 Config Files [5 files]
   ├─ astro.config.mjs              - Astro configuration
   ├─ package.json                  - Dependencies
   ├─ package-lock.json             (237 KB) ████████
   ├─ tsconfig.json                 - TypeScript config
   └─ README.md                     - Docs info

---

🔧 cmd/ [3 files] █

CLI entry point

cmd/
└─ gh-aw/
   ├─ main.go                       - Application entry point
   └─ version.go                    - Version information

---

📋 Other Directories

scripts/ [1 file]
└─ Build and automation scripts

schemas/ [1 file]
└─ JSON schemas for validation

.changeset/
└─ Changeset configuration

.devcontainer/
└─ Dev container setup

.vscode/
└─ VS Code workspace settings

---

📈 File Type Distribution

Extension	Count	Percentage	Bar Chart
.go	346	51.6%	██████████████████████████
.md	184	27.4%	█████████████
.cjs	50	7.5%	████
.yml	35	5.2%	███
.json	21	3.1%	██
.sh	12	1.8%	█
.ts	4	0.6%	░
.js	2	0.3%	░
Other	17	2.5%	█

---

🎯 Key Statistics

Code Distribution

• Primary Language: Go (346 files, 51.6%)
• Testing Coverage: 150+ test files
• Integration Tests: 50+ files
• JavaScript/Node: 50+ .cjs files for GitHub Actions

Repository Composition

• Source Code: ~500 files (74.6%)
• Documentation: ~184 files (27.4%)
• Configuration: ~35 files (5.2%)
• Tests: ~150+ files (22.4%)

Major Components

1. Workflow Engine (pkg/workflow/): 314 files - 47% of repository
2. CLI Interface (pkg/cli/): 155 files - 23% of repository
3. GitHub Integration (.github/workflows/): 77 files - 11% of repository
4. Documentation (docs/): 45 files - 7% of repository
5. Parser (pkg/parser/): 24 files - 4% of repository

---

🔍 Notable Features

Security Implementation

• Expression Safety: expression_safety.go
• XPIA Protection: xpia.go, threat_detection.go
• Secret Redaction: redact_secrets.go, redact_secrets.cjs
• Permission Checks: check_permissions.cjs

AI Engine Support

• Claude Engine: Full MCP integration, network controls
• Codex Engine: GitHub Codex integration
• Copilot Engine: GitHub Copilot CLI integration
• Custom Engine: User-defined workflows

Safe Outputs System

• Issue Creation: Automated GitHub issue generation
• PR Creation: Safe pull request workflow
• Comment Management: Automated commenting
• MCP Server: Dedicated safe-outputs MCP integration

Testing Strategy

• Unit Tests: Fast, focused tests
• Integration Tests: End-to-end validation
• Specialized Tests: Simple, minimal, snapshot tests
• JavaScript Tests: Vitest-based test suite

---

📊 Visual Size Representation

Repository Composition (by file count)

pkg/workflow/     ████████████████████ (314 files, 47%)
pkg/cli/          ██████████ (155 files, 23%)
.github/workflows ████ (77 files, 11%)
docs/             ██ (45 files, 7%)
pkg/parser/       █ (24 files, 4%)
Other             ███ (56 files, 8%)

---

🏗️ Architecture Highlights

Compilation Pipeline

Markdown (.md) → Parser → Compiler → YAML (.lock.yml)
     ↓              ↓          ↓           ↓
 Frontmatter   Validation  Templates  GitHub Actions

Execution Flow

Trigger → Activation → Task Job → Safe Outputs → Reaction
   ↓          ↓           ↓            ↓           ↓
Event     Filter       AI Engine   GitHub API   Feedback

MCP Integration

MCP Servers ← Config Generator ← Tools Definition
     ↓               ↓                  ↓
 Local/Remote   Docker/NPX        Allow Lists

---

Legend:

• 📁 Directory
• 📄 Regular file
• 📚 Documentation
• 🔧 Configuration
• 🧪 Test file
• 🔨 Build script
• █ ▓ ▒ ░ Size/count indicators (relative scale)

---

This tree map provides a comprehensive overview of the gh-aw repository structure, emphasizing the relationship between Go code, JavaScript GitHub Actions scripts, documentation, and test coverage.

AI generated by Repository Tree Map Generator

[github-actions[bot]]

This discussion was automatically closed because it was created by an agentic workflow more than 1 month ago.