Repository Tree Map - 2025-10-11

[github-actions[bot]]

🗺️ Repository Tree Map Analysis

Generated: 2025-10-11
Repository: gh-aw (GitHub Agentic Workflows)

---

📊 Repository Statistics

Metric	Value
Total Files	665 files
Total Size	5.25 MB
Root Files	21 files
Directories	9 top-level
Primary Language	Go (346 files, 52.0%)
Documentation	Markdown (178 files, 26.8%)

---

📁 File Type Distribution

Top File Types by Count:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  346  .go       ████████████████████████████████████████ (52.0%)
  178  .md       ████████████████████░░░░░░░░░░░░░░░░░░░░ (26.8%)
   50  .cjs      █████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ (7.5%)
   35  .yml      ████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ (5.3%)
   21  .json     ██░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ (3.2%)
   12  .sh       █░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ (1.8%)
    4  .ts       ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ (0.6%)
   19  other     ██░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ (2.9%)

---

🌲 ASCII Tree Map Visualization

gh-aw/ [665 files, 5.25 MB]
│
├─ 📦 pkg/ [499 files, 4.55 MB] ██████████████████████████████████████████ (86.7%)
│  │
│  ├─ 🔧 workflow/ [314 files, 3.07 MB] ████████████████████████████░░░░░░░░░░ (67.5%)
│  │  ├─ js/ [62 files, 0.88 MB] ██████████░░░░░░░░░░░░░░░░░░░░░░░░
│  │  ├─ sh/ [12 files, 0.01 MB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
│  │  ├─ test_data/ [5 files, 0.11 MB] ██░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
│  │  ├─ schemas/ [1 file, 0.09 MB] █░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
│  │  ├─ pretty/ [2 files] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
│  │  ├─ data/ [1 file] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
│  │  ├─ config/ [1 file] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
│  │  └─ templates/ [1 file] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
│  │
│  ├─ 💻 cli/ [155 files, 1.03 MB] ███████████████░░░░░░░░░░░░░░░░░░░░░░░░░░ (22.6%)
│  │  ├─ workflows/ [test workflows and samples]
│  │  └─ templates/ [command templates]
│  │
│  ├─ 📋 parser/ [24 files, 0.42 MB] ████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ (9.2%)
│  │  └─ schemas/ [JSON schemas for validation]
│  │
│  ├─ 🎨 console/ [5 files, 0.03 MB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ (0.7%)
│  │
│  └─ 🔢 constants/ [1 file, 0.01 MB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ (0.2%)
│
├─ 📚 docs/ [45 files, 0.65 MB] ████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ (12.4%)
│  ├─ src/content/ [documentation content]
│  ├─ src/assets/ [images and static files]
│  └─ public/ [public assets]
│
├─ 🚀 cmd/gh-aw/ [3 files, 0.02 MB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ (0.4%)
│
├─ 📄 Root Files [21 files] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
│  ├─ README.md, LICENSE, Makefile
│  ├─ CONTRIBUTING.md, DEVGUIDE.md, TESTING.md
│  ├─ go.mod, go.sum
│  └─ Configuration files (.gitignore, etc.)
│
├─ 📐 schemas/ [1 file, 0.01 MB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ (0.2%)
├─ 🔨 scripts/ [1 file, 0.02 MB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ (0.4%)
├─ .vscode/ [4 files] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
├─ .devcontainer/ [2 files] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
├─ .changeset/ [2 files] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
└─ .github/ [config files] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░

---

📈 Size Distribution Analysis

Distribution by Directory:

Directory	Files	Size	% of Total
pkg/	499	4.55 MB	86.7%
docs/	45	0.65 MB	12.4%
cmd/	3	0.02 MB	0.4%
scripts/	1	0.02 MB	0.4%
schemas/	1	0.01 MB	0.2%
other	116	0.00 MB	0.0%

Key Observations:

• 📦 The pkg/ directory dominates with 86.7% of repository size
• 🔧 Within pkg, workflow/ is the largest at 3.07 MB (67.5% of pkg)
• 💻 CLI implementation is second largest at 1.03 MB (22.6% of pkg)
• 📚 Documentation accounts for 12.4% of total size
• 🎯 Core binary entry point (cmd/) is minimal at just 0.02 MB

---

🏆 Top 15 Largest Files

Size      Path
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
236.84 KB  ./docs/package-lock.json
149.16 KB  ./pkg/workflow/compiler_test.go
128.58 KB  ./pkg/workflow/js/package-lock.json
119.82 KB  ./pkg/cli/workflows/test-long.md
117.36 KB  ./pkg/workflow/compiler.go
 96.20 KB  ./docs/src/assets/houston.webp
 95.40 KB  ./pkg/parser/schemas/main_workflow_schema.json
 95.35 KB  ./pkg/workflow/schemas/github-workflow.json
 94.61 KB  ./pkg/workflow/js/collect_ndjson_output.test.cjs
 73.04 KB  ./pkg/cli/logs.go
 63.79 KB  ./pkg/workflow/test_data/sample_codex_log.txt
 55.82 KB  ./pkg/workflow/claude_engine.go
 52.42 KB  ./pkg/cli/trial_command.go
 52.06 KB  ./pkg/workflow/compile_test.go
 48.55 KB  ./pkg/parser/frontmatter_test.go

---

🔍 Key Insights

Repository Structure

• Modular design: Clear separation between CLI, parser, workflow engine, and documentation
• Test coverage: Significant test files indicate good testing practices
• Schema-driven: JSON schemas for validation (parser and workflow)
• Multi-language: Primarily Go with JavaScript for GitHub Actions integration

Code Organization

• pkg/workflow/ is the heart of the system (47% of all files)
  • JavaScript integration for GitHub Actions (js/ - 62 files)
  • Shell scripts for workflow execution (sh/ - 12 files)
  • Comprehensive test data and schemas
• pkg/cli/ handles user interaction (23% of pkg files)
  • Includes test workflows and command templates
• pkg/parser/ manages frontmatter and YAML parsing
• Small footprint: Core binary entry point is minimal, relying on library packages

Development Focus Areas

• Most code is in workflow compilation and execution (pkg/workflow)
• JavaScript files for GitHub Actions integration are substantial (0.88 MB)
• Documentation is well-maintained (45 files, 0.65 MB)
• Test files are substantial, showing commitment to quality

File Size Patterns

• Lock files are the largest individual files (package-lock.json)
• Test files are second largest category (compiler_test.go, test data)
• Core implementation files are well-sized (compiler.go, claude_engine.go)
• Schemas are substantial for validation (95+ KB each)

---

🎯 Repository Health Indicators

✅ Good Test Coverage: Test files throughout codebase
✅ Clear Structure: Well-organized package hierarchy
✅ Documentation: Comprehensive docs/ directory
✅ Schema Validation: JSON schemas for type safety
✅ Small Binary: Minimal cmd/ directory, library-focused
✅ Multi-Engine Support: Multiple AI engine integrations (Copilot, Claude, Codex)

---

Legend:

• 📦 Package/Library Code
• 🔧 Workflow Engine
• 💻 CLI Interface
• 📋 Parser/Validator
• 📚 Documentation
• 🚀 Binary Entry Point
• 🎨 Console/UI
• 🔢 Constants/Config
• 📐 Schemas
• 🔨 Scripts

Note: Bar charts show relative sizes. Each █ represents ~10% of maximum value in that category.

AI generated by Repository Tree Map Generator