Repository Tree Map - January 10, 2025

[github-actions[bot]]

🗺️ Repository Tree Map

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

---

📊 Repository Overview

Total Files: 665
Total Size:  10.12 MB
Directories: ~50 (excluding .git, node_modules, vendor)
Max Depth:   5-6 levels

File Type Distribution

Extension	Count	Percentage
.go	346	52.0%
.md	178	26.8%
.cjs	50	7.5%
.yml	35	5.3%
.json	21	3.2%
.sh	12	1.8%
.ts	4	0.6%
Other	19	2.9%

---

🌳 ASCII Tree Map Visualization

gh-aw/ [665 files, 10.12 MB]
│
├─ 📁 pkg/ [341 files, 5.21 MB] ████████████████████░░░░░░░░░░ (51.5%)
│  │
│  ├─ 📁 workflow/ [229 files, 2.87 MB] ████████████░░░░░░░░ (28.3%)
│  │  ├─ 🧪 *_test.go [~140 files] ████████░░
│  │  ├─ 📄 compiler.go [117 KB] ███
│  │  ├─ 📄 compiler_test.go [149 KB] ████
│  │  ├─ 📁 js/ [55 files, 389 KB] ████░░
│  │  │  ├─ 📄 *.cjs [workflow logic]
│  │  │  ├─ 📄 package-lock.json [129 KB]
│  │  │  └─ 🧪 *.test.cjs [test files]
│  │  ├─ 📁 sh/ [12 files] ██░░
│  │  ├─ 📁 schemas/ [1 file, 95 KB] ██░░
│  │  ├─ 📁 templates/ [1 file] █░
│  │  ├─ 📁 test_data/ [5 files] ██░
│  │  ├─ 📁 pretty/ [2 files] █░
│  │  └─ 📁 config/ [1 file] █░
│  │
│  ├─ 📁 cli/ [85 files, 1.52 MB] ███████░░░░░░░ (15.0%)
│  │  ├─ 📄 logs.go [73 KB] ███
│  │  ├─ 📄 trial_command.go [52 KB] ██
│  │  ├─ 🧪 *_test.go [~45 files] █████░░
│  │  ├─ 📁 workflows/ [64 files, 387 KB] ████░░
│  │  │  ├─ 📄 test-long.md [120 KB]
│  │  │  └─ 📁 shared/ [3 files]
│  │  └─ 📁 templates/ [3 files] █░
│  │
│  ├─ 📁 parser/ [21 files, 421 KB] ████░░░░ (4.2%)
│  │  ├─ 📄 frontmatter_test.go [49 KB] ██
│  │  ├─ 📁 schemas/ [3 files, 185 KB] ████
│  │  │  └─ 📄 main_workflow_schema.json [94 KB]
│  │  └─ 📄 *.go [parser logic]
│  │
│  ├─ 📁 console/ [5 files, 42 KB] █░░ (0.4%)
│  │  └─ 📄 console formatting utilities
│  │
│  └─ 📁 constants/ [1 file, 4 KB] ░ (<0.1%)
│
├─ 📚 docs/ [53 files, 488 KB] █████░░░░░░░░░░░░░░ (4.8%)
│  ├─ 📄 package-lock.json [237 KB] █████
│  ├─ 📁 src/ [39 files, 251 KB] ████░░
│  │  ├─ 📁 content/docs/ [33 files] ████
│  │  │  ├─ 📁 reference/ [15 files] ██
│  │  │  ├─ 📁 guides/ [8 files] ██
│  │  │  ├─ 📁 samples/ [4 files] █
│  │  │  ├─ 📁 start-here/ [2 files] █
│  │  │  └─ 📁 tools/ [3 files] █
│  │  ├─ 📁 assets/ [1 file, 96 KB] ██
│  │  │  └─ 🖼️ houston.webp [96 KB]
│  │  └─ 📄 content.config.ts
│  ├─ 📁 public/ [1 file] ░
│  └─ 🔧 config files [7 files]
│
├─ 📁 .github/ [82 files, 819 KB] ████████░░░░░░░░░░ (8.1%)
│  │
│  ├─ 📁 workflows/ [59 files, 623 KB] ██████░░░░ (6.2%)
│  │  ├─ 📄 *.md [agentic workflows] ████
│  │  ├─ 📄 *.lock.yml [compiled workflows] ████
│  │  ├─ 📁 shared/ [15 files] ███
│  │  │  ├─ 📁 mcp/ [11 files] ██
│  │  │  └─ 📄 *.md [4 files] █
│  │  └─ 📁 agentics/shared/ [3 files] █
│  │
│  ├─ 📁 instructions/ [5 files, 89 KB] ██░░ (0.9%)
│  │  ├─ 📄 github-agentic-workflows.instructions.md
│  │  ├─ 📄 github-script.instructions.md
│  │  └─ 📄 *.instructions.md [guidance files]
│  │
│  └─ 📁 prompts/ [5 files, 47 KB] █░░ (0.5%)
│
├─ 📁 cmd/gh-aw/ [3 files, 23 KB] █░░░░░░░░░░ (0.2%)
│  ├─ 📄 main.go
│  ├─ 📄 version.go
│  └─ 📄 version_test.go
│
├─ 📄 Root Files [21 files, 197 KB] ██░░░░░░░░░ (1.9%)
│  ├─ 📚 AGENTS.md [9 KB]
│  ├─ 📚 README.md, DEVGUIDE.md, etc.
│  ├─ 🔧 Makefile [10 KB]
│  ├─ 🔧 go.mod, go.sum
│  ├─ 🔧 .golangci.yml
│  └─ 📜 LICENSE, CODE_OF_CONDUCT.md
│
├─ 📁 schemas/ [1 file, 2 KB] ░░ (<0.1%)
│
└─ 📁 scripts/ [1 file, 6 KB] ░░ (<0.1%)

---

📈 Size Distribution by Top-Level Directory

pkg/         5.21 MB  ████████████████████████████████████████████████████  51.5%
.github/     0.82 MB  ████████                                               8.1%
docs/        0.49 MB  █████                                                  4.8%
Root files   0.20 MB  ██                                                     2.0%
cmd/         0.02 MB  ░                                                      0.2%
schemas/     0.00 MB  ░                                                     <0.1%
scripts/     0.01 MB  ░                                                      0.1%

---

🏆 Top 15 Largest Files

Size	File 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.35 KB	pkg/workflow/schemas/github-workflow.json
94.61 KB	pkg/workflow/js/collect_ndjson_output.test.cjs
93.68 KB	pkg/parser/schemas/main_workflow_schema.json
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

Architecture Highlights

1. Test-Driven Development: ~40% of Go files are test files (*_test.go), demonstrating strong testing practices
2. Core Engine: pkg/workflow/ contains the compilation engine and AI engine integrations (Claude, Codex, Copilot)
3. CLI-First: pkg/cli/ houses the command-line interface with extensive workflow management
4. Schema-Driven: JSON schemas in pkg/parser/schemas/ and pkg/workflow/schemas/ validate workflow definitions
5. JavaScript Integration: pkg/workflow/js/ contains CommonJS modules for GitHub Actions runtime

File Organization

• Go Dominance: 52% of files are Go source code (346 files)
• Documentation Rich: 27% markdown files (178 files) including workflows, docs, and guides
• Workflow Examples: .github/workflows/ contains 59 workflow files (both .md and .lock.yml)
• Modular Structure: Clear separation between CLI, parser, and workflow compilation logic

Size Characteristics

• Lean Codebase: 10.12 MB total (excluding dependencies)
• Largest Component: pkg/ directory at 51.5% of total size
• Config Files: Package locks and schemas contribute ~20% of total size
• Test Data: Sample logs and test fixtures are appropriately sized

Code Quality Indicators

• Comprehensive Testing: ~140 test files in pkg/workflow/ alone
• Structured Workflows: Separate .md (source) and .lock.yml (compiled) workflow files
• Shared Components: Reusable workflow components in .github/workflows/shared/
• CI/CD Integration: Multiple GitHub Actions workflows for automation

---

📝 Repository Structure Summary

The gh-aw repository is a well-organized Go-based CLI extension for GitHub that enables natural language agentic workflows. The structure reflects:

• Modular Design: Clear separation between CLI, parsing, and workflow compilation
• Test Coverage: Extensive test files alongside production code
• Documentation: Rich markdown documentation and inline examples
• Integration Focus: Deep GitHub Actions integration with custom JavaScript runtime
• Schema-Driven: JSON schemas enforce workflow definition correctness

The relatively small size (10 MB) and high test-to-code ratio indicate a focused, quality-first codebase designed for maintainability and reliability.

---

Generated using repository analysis tools on January 10, 2025

AI generated by Repository Tree Map Generator