Repository Tree Map - January 11, 2025 #1507

2025-10-11T00:32:24Z

github-actions[bot]
bot Oct 11, 2025

🗺️ Repository Tree Map Analysis

Generated on January 11, 2025

This comprehensive visualization shows the structure, size distribution, and file organization of the gh-aw repository.

📊 Executive Summary

Metric	Value
Total Files	674 files
Total Size	10.23 MB
Primary Language	Go (346 files, 51.3%)
Deepest Directory	`pkg/workflow/` (314 files)
Largest File	`poem-bot.lock.yml` (0.29 MB)

🌳 Visual Tree Map

gh-aw/ [674 files, 10.23 MB]
│
├─ 📁 .github/ [92 files, 4.93 MB] ████████████████████░░░░░░░░░░░░░░░░░░░░
│  │                                  (48% of repository)
│  │
│  ├─ 📄 workflows/ [82 files, 4.84 MB] ████████████████████░░░░░░░░░░░░░░░░░░░░
│  │  │                                   (98% of .github)
│  │  │
│  │  ├─ 🔧 *.lock.yml files [~41 files, ~4.5 MB] █████████████████░░░
│  │  │  │  Compiled workflow YAML files (largest files in repo)
│  │  │  ├─ poem-bot.lock.yml           0.29 MB  ███████░
│  │  │  ├─ tidy.lock.yml               0.21 MB  █████░
│  │  │  ├─ scout.lock.yml              0.21 MB  █████░
│  │  │  ├─ unbloat-docs.lock.yml       0.20 MB  █████░
│  │  │  └─ technical-doc-writer.lock.yml 0.20 MB █████░
│  │  │
│  │  ├─ 📚 *.md files [~41 files, ~0.3 MB] ███░
│  │  │     Source agentic workflow definitions
│  │  │
│  │  ├─ 📁 agentics/ [subdirectory]
│  │  ├─ 📁 shared/ [subdirectory]
│  │  └─ ⚙️ *.yml files [CI/CD configs]
│  │
│  ├─ 📄 instructions/ [5 files, 0.06 MB] ░
│  │     Agent behavior guidelines
│  │
│  └─ 📄 prompts/ [5 files, 0.04 MB] ░
│        Reusable prompt templates
│
├─ 📁 pkg/ [499 files, 4.53 MB] ███████████████████░░░░░░░░░░░░░░░░░░░░░
│  │                             (44% of repository)
│  │
│  ├─ 📁 workflow/ [314 files, 3.05 MB] ████████████████░░░░░░░░░░░░░░░░░░░░
│  │  │                                  (67% of pkg)
│  │  │  Core workflow compilation engine
│  │  │
│  │  ├─ 🔧 js/ [62 files, 0.88 MB] ██████░
│  │  │     JavaScript runtime for GitHub Actions
│  │  │     - *.cjs files (CommonJS modules)
│  │  │     - Action scripts for safe outputs
│  │  │
│  │  ├─ 🧪 test_data/ [5 files, 0.11 MB] █░
│  │  ├─ 📋 schemas/ [1 file, 0.09 MB] █░
│  │  ├─ 🔧 sh/ [12 files, 0.01 MB] ░
│  │  ├─ 📄 templates/ [1 file, 0.00 MB] ░
│  │  ├─ 📄 config/ [1 file, 0.00 MB] ░
│  │  └─ 🐹 *.go files [~231 files, ~2.0 MB] ████████████░
│  │        Workflow compiler, engines, safe outputs
│  │
│  ├─ 📁 cli/ [155 files, 1.03 MB] ███████░░░░░░░░░░░░░░░░░░░░░░░░░░░░
│  │  │                            (23% of pkg)
│  │  │  Command-line interface implementation
│  │  │
│  │  ├─ 📁 workflows/ [67 files, 0.17 MB] ███░
│  │  │     Test workflow files
│  │  │
│  │  ├─ 📁 templates/ [3 files, 0.05 MB] █░
│  │  │     CLI scaffolding templates
│  │  │
│  │  └─ 🐹 *.go files [~85 files, ~0.8 MB] ████████░
│  │        Commands: compile, logs, mcp, audit, etc.
│  │
│  ├─ 📁 parser/ [24 files, 0.41 MB] ███░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
│  │  │                              (9% of pkg)
│  │  │  YAML frontmatter parsing & validation
│  │  │
│  │  ├─ 📁 schemas/ [JSON Schema definitions]
│  │  └─ 🐹 *.go files [~23 files, ~0.4 MB]
│  │        Frontmatter validation, MCP config
│  │
│  ├─ 📁 console/ [5 files, 0.03 MB] ░
│  │     CLI output formatting utilities
│  │
│  └─ 📁 constants/ [1 file, 0.01 MB] ░
│        Global constants
│
├─ 📁 docs/ [45 files, 0.65 MB] ███░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
│  │                            (6% of repository)
│  │  Astro Starlight documentation site
│  │
│  ├─ 📁 src/ [35 files, 0.39 MB] ██████░
│  │  │   Documentation content (MDX/markdown)
│  │  │
│  │  ├─ 📁 content/ [Documentation pages]
│  │  └─ 📁 assets/ [Images, diagrams]
│  │
│  ├─ 📋 package-lock.json [1 file, 0.23 MB] ███░
│  ├─ 📋 package.json [1 file]
│  └─ 📁 public/ [1 file, 0.00 MB] ░
│        Static assets
│
├─ 📁 cmd/ [3 files, 0.02 MB] ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
│  │                          (<1% of repository)
│  │  CLI entry point
│  │
│  └─ 📁 gh-aw/ [3 files]
│        main.go, init.go
│
├─ 📁 schemas/ [1 file, 0.01 MB] ░
│     JSON schemas for validation
│
├─ 📁 scripts/ [1 file, 0.02 MB] ░
│     Build and automation scripts
│
├─ 📁 .vscode/ [4 files, 0.00 MB] ░
│     Editor configuration
│
├─ 📁 .devcontainer/ [2 files, 0.00 MB] ░
│     Development container setup
│
├─ 📁 .changeset/ [6 files, 0.00 MB] ░
│     Changesets for versioning
│
└─ 📄 Root Files [21 files, 0.06 MB] ░
      README.md, CONTRIBUTING.md, Makefile, go.mod, etc.

📈 File Type Distribution

Extension	Count	Size (MB)	% of Files	Primary Use
`.go`	346	3.12 MB	51.3%	Core application logic
`.md`	184	0.81 MB	27.3%	Documentation & workflows
`.cjs`	50	0.72 MB	7.4%	JavaScript Actions runtime
`.yml`	38	4.72 MB	5.6%	Workflow definitions & CI/CD
`.json`	21	0.58 MB	3.1%	Configs & package manifests
`.sh`	12	0.01 MB	1.8%	Shell scripts
`.ts`	4	0.01 MB	0.6%	TypeScript definitions
`.txt`	3	0.11 MB	0.4%	Text data files
`.js`	2	0.02 MB	0.3%	JavaScript utilities
Other	14	0.13 MB	2.1%	Various configs & assets

🔍 Directory Deep Dive

📁 `.github/workflows/` — Workflow Hub (82 files, 4.84 MB)

The largest directory in the repository, containing agentic workflow definitions and their compiled outputs.

Structure Pattern:

Source workflows: *.md files with natural language instructions
Compiled workflows: *.lock.yml files (GitHub Actions YAML)
Ratio: Approximately 1:1 (41 source .md → 41 compiled .lock.yml)

Notable Workflows:

poem-bot — Largest compiled workflow (0.29 MB)
tidy, scout, unbloat-docs — Documentation management
technical-doc-writer — Documentation generation
ci-doctor, audit-workflows — Workflow health checks
Smoke tests for engines: smoke-claude, smoke-codex, smoke-copilot

Subdirectories:

agentics/ — Complex multi-step workflows
shared/ — Reusable workflow components and imports

📁 `pkg/workflow/` — Compilation Engine (314 files, 3.05 MB)

The heart of gh-aw, responsible for transforming natural language workflow definitions into executable GitHub Actions.

Key Components:

🔧 JavaScript Runtime (js/ — 62 files, 0.88 MB)

Safe output processors for GitHub API operations
Action scripts for issue creation, PR management, comments
Error validation and log parsing
Key files: create_issue.cjs, add_comment.cjs, create_pull_request.cjs, parse_copilot_log.cjs, validate_errors.cjs

🐹 Go Compiler (231+ files, ~2.0 MB)

Engine implementations: claude_engine.go, codex_engine.go, copilot_engine.go, custom_engine.go
Safe outputs system: safe_outputs.go, safe_jobs.go, create_issue.go, create_pull_request.go
Network & security: network.go, threat_detection.go, xpia.go, expression_safety.go
MCP integration: mcp-config.go, mcps.go
Workflow compilation: compiler.go, template.go, jobs.go

📋 Supporting Files

schemas/ — JSON schemas for validation (1 file, 0.09 MB)
test_data/ — Test fixtures (5 files, 0.11 MB)
sh/ — Shell script templates (12 files)

📁 `pkg/cli/` — Command Interface (155 files, 1.03 MB)

CLI command implementations and test workflows.

Command Categories:

Compilation: compile_command.go, compile_instructions_test.go
MCP Management: mcp.go, mcp_inspect.go, mcp_list.go, mcp_registry.go
Log Analysis: logs.go, logs_parse_test.go, audit.go
Workflow Management: add_command.go, remove_command.go, update_command.go
Trial Mode: trial_command.go, run_command.go

Test Infrastructure:

workflows/ — 67 test workflow files (0.17 MB)
templates/ — CLI scaffolding templates (3 files, 0.05 MB)

📁 `pkg/parser/` — Validation Engine (24 files, 0.41 MB)

YAML frontmatter parsing, schema validation, and error reporting.

Responsibilities:

Frontmatter extraction from markdown files
JSON Schema validation with detailed error messages
MCP server configuration parsing
Import resolution and syntax validation

Key Files:

frontmatter.go — Core parsing logic
schema.go — Schema validation engine
json_path_locator.go — Error location tracking
yaml_error.go — Enhanced error messages

📁 `docs/` — Documentation Site (45 files, 0.65 MB)

Astro Starlight documentation following the Diátaxis framework.

Content Organization:

src/content/ — Documentation pages (tutorials, how-tos, reference, explanations)
package-lock.json — Largest file in docs (0.23 MB)
Uses MDX for component-rich documentation

📁 `cmd/gh-aw/` — Application Entry (3 files, 0.02 MB)

Minimal entry point for the CLI application.

Files:

main.go — CLI initialization
init.go — Setup logic
main_entry_test.go — Entry point tests

🏆 Largest Files

Rank	Size (MB)	File	Type
1	0.29	`.github/workflows/poem-bot.lock.yml`	Compiled workflow
2	0.23	`docs/package-lock.json`	NPM dependencies
3	0.21	`.github/workflows/tidy.lock.yml`	Compiled workflow
4	0.21	`.github/workflows/scout.lock.yml`	Compiled workflow
5	0.20	`.github/workflows/unbloat-docs.lock.yml`	Compiled workflow
6	0.20	`.github/workflows/technical-doc-writer.lock.yml`	Compiled workflow
7	0.20	`.github/workflows/pdf-summary.lock.yml`	Compiled workflow
8	0.19	`.github/workflows/brave.lock.yml`	Compiled workflow
9	0.19	`.github/workflows/plan.lock.yml`	Compiled workflow
10	0.19	`.github/workflows/ci-doctor.lock.yml`	Compiled workflow

Observation: 9 out of 10 largest files are compiled workflow YAML files (.lock.yml), demonstrating the expansion from concise markdown definitions to comprehensive GitHub Actions workflows.

💡 Key Insights

Size Distribution

Workflows dominate: .github/ represents 48% of total repository size
Compiled YAML explosion: Workflow compilation expands .md files significantly
Balanced codebase: pkg/ (44%) nearly matches .github/ (48%)
Lean documentation: Only 6% of total size despite 45 files

Code Organization

Test-heavy development: Many *_test.go files throughout pkg/
Modular structure: Clear separation between CLI, parser, and workflow logic
JavaScript integration: 62 .cjs files for GitHub Actions runtime
MCP ecosystem: Extensive MCP server integration and management

Workflow Characteristics

1:1 source-to-compiled ratio: Each .md workflow produces one .lock.yml file
Average expansion: ~0.12 MB compiled size per workflow
Diverse use cases: Issue triage, documentation generation, security fixes, smoke tests
Reusable components: shared/ directory for common patterns

Technology Stack

Primary language: Go (51.3% of files)
Documentation: Markdown/MDX (27.3% of files)
Runtime: Node.js/JavaScript for GitHub Actions
Schema validation: JSON Schema
Documentation framework: Astro Starlight

🎯 Repository Health Metrics

Metric	Value	Status
Code-to-Test Ratio	~1:0.4 (est.)	✅ Well-tested
Documentation Coverage	Extensive	✅ Comprehensive
File Organization	Clear structure	✅ Excellent
Average File Size	15.5 KB	✅ Manageable
Largest Directory Depth	~4 levels	✅ Reasonable
Build Artifacts	None tracked	✅ Clean

🔧 Repository Composition

Code Distribution (by purpose):

Core Go Application    ████████████████████░░░░░ 51.3%  (346 files)
Documentation          █████████░░░░░░░░░░░░░░░░ 27.3%  (184 files)
Workflow Definitions   ██░░░░░░░░░░░░░░░░░░░░░░░  5.6%  ( 38 files)
JavaScript Runtime     ███░░░░░░░░░░░░░░░░░░░░░░  7.7%  ( 52 files)
Configuration          ███░░░░░░░░░░░░░░░░░░░░░░  3.1%  ( 21 files)
Scripts & Tools        ██░░░░░░░░░░░░░░░░░░░░░░░  1.8%  ( 12 files)
Other                  █░░░░░░░░░░░░░░░░░░░░░░░░  3.2%  ( 21 files)

📊 Summary Statistics

By Category

Application Code: 346 Go files (3.12 MB)
Test Code: ~150 *_test.go files (estimated, included in Go total)
Documentation: 184 markdown files (0.81 MB)
Workflows: 82 workflow files (4.84 MB)
Configuration: 59 config files (5.30 MB)

By Purpose

Source Code: 401 files (3.84 MB) — .go, .cjs, .js, .ts
Documentation: 184 files (0.81 MB) — .md, .mdx
Configuration: 60 files (5.43 MB) — .yml, .json, .toml
Assets: 12 files (0.10 MB) — .svg, .webp, .txt
Other: 17 files (0.05 MB)

🚀 Notable Patterns

Workflow Compilation Efficiency

Source: ~0.02 MB average .md file
Compiled: ~0.12 MB average .lock.yml file
Expansion Factor: ~6x (due to GitHub Actions boilerplate)

Test Coverage

Every major Go package has corresponding *_test.go files
Integration tests throughout CLI and workflow packages
Test data fixtures in pkg/workflow/test_data/

Modular Architecture

Clear separation: cmd/ (entry) → pkg/cli/ (interface) → pkg/workflow/ (engine)
Parser isolated in pkg/parser/ for reusability
Console utilities in pkg/console/ for consistent output

This tree map provides a comprehensive overview of the gh-aw repository structure as of January 11, 2025. The visualization helps identify the major components, understand size distribution, and navigate the codebase effectively.

Generated by: Repository Tree Map Agentic Workflow
Repository: githubnext/gh-aw
Version: Latest main branch snapshot

AI generated by Repository Tree Map Generator

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository Tree Map - January 11, 2025 #1507

Uh oh!

{{title}}

Uh oh!

Replies: 0 comments

Select a reply

Uh oh!

Repository Tree Map - January 11, 2025 #1507

Uh oh!

github-actions[bot] bot Oct 11, 2025

🗺️ Repository Tree Map Analysis

📊 Executive Summary

🌳 Visual Tree Map

📈 File Type Distribution

🔍 Directory Deep Dive

📁 .github/workflows/ — Workflow Hub (82 files, 4.84 MB)

📁 pkg/workflow/ — Compilation Engine (314 files, 3.05 MB)

📁 pkg/cli/ — Command Interface (155 files, 1.03 MB)

📁 pkg/parser/ — Validation Engine (24 files, 0.41 MB)

📁 docs/ — Documentation Site (45 files, 0.65 MB)

📁 cmd/gh-aw/ — Application Entry (3 files, 0.02 MB)

🏆 Largest Files

💡 Key Insights

Size Distribution

Code Organization

Workflow Characteristics

Technology Stack

🎯 Repository Health Metrics

🔧 Repository Composition

📊 Summary Statistics

By Category

By Purpose

🚀 Notable Patterns

Workflow Compilation Efficiency

Test Coverage

Modular Architecture

Replies: 0 comments

github-actions[bot]
bot Oct 11, 2025

📁 `.github/workflows/` — Workflow Hub (82 files, 4.84 MB)

📁 `pkg/workflow/` — Compilation Engine (314 files, 3.05 MB)

📁 `pkg/cli/` — Command Interface (155 files, 1.03 MB)

📁 `pkg/parser/` — Validation Engine (24 files, 0.41 MB)

📁 `docs/` — Documentation Site (45 files, 0.65 MB)

📁 `cmd/gh-aw/` — Application Entry (3 files, 0.02 MB)