Repository Tree Map - October 11, 2025

[github-actions[bot]]

🗺️ Repository Tree Map Visualization

Comprehensive visualization of the gh-aw repository structure and file distribution.

---

📊 Repository Overview

┌────────────────────────────────────────────────────────────┐
│  Total Files: 674                                          │
│  Total Directories: 38                                     │
│  Primary Language: Go (346 files, 51.3%)                   │
│  Documentation: Markdown (184 files, 27.3%)                │
│  JavaScript: CJS (50 files, 7.4%)                          │
└────────────────────────────────────────────────────────────┘

---

🌳 Directory Tree Structure

gh-aw/ [674 files] 📦
│
├─ 📁 pkg/ [499 files - 74.0%] ████████████████████████████████████████░░
│  │
│  ├─ 📁 workflow/ [314 files - 62.9%] ██████████████████████████████░░
│  │  ├─ 🧪 js/ [50 CJS files] ████████░░
│  │  │  ├─ 27 Implementation files (.cjs)
│  │  │  └─ 23 Test files (.test.cjs)
│  │  ├─ 📄 *.go [229 files - Go source] ██████████████████████░░
│  │  ├─ 📚 *.md [9 docs]
│  │  ├─ 📁 templates/ [1 file]
│  │  ├─ 📁 schemas/ [1 file]
│  │  ├─ 📁 config/
│  │  ├─ 📁 data/
│  │  ├─ 📁 pretty/
│  │  ├─ 📁 sh/
│  │  └─ 📁 test_data/
│  │
│  ├─ 📁 cli/ [155 files - 31.1%] ████████████░░
│  │  ├─ 📄 *.go [85 files - Go source] ████████░░
│  │  ├─ 📁 templates/ [3 files]
│  │  └─ 📁 workflows/ [67 test workflows] ██████░░
│  │
│  ├─ 📁 parser/ [24 files - 4.8%] ██░░
│  │  ├─ 📄 *.go [21 files]
│  │  └─ 📁 schemas/ [3 JSON schemas]
│  │
│  ├─ 📁 console/ [5 files - 1.0%] ░░
│  │  └─ 📄 *.go [5 files - Console formatting]
│  │
│  └─ 📁 constants/ [1 file - 0.2%] ░
│     └─ 📄 constants.go
│
├─ 📁 .github/ [92 files - 13.6%] ██████████████░░
│  ├─ 📁 workflows/ [82 files - 89.1%] ████████████░░
│  │  ├─ 📄 *.md [45 workflow definitions] ██████░░
│  │  ├─ 📄 *.lock.yml [37 compiled workflows] █████░░
│  │  ├─ 📁 shared/ [18 shared components] ███░░
│  │  └─ 📁 agentics/ [3 agentic workflows] ░
│  ├─ 📁 instructions/ [5 instruction files]
│  └─ 📁 prompts/ [5 prompt templates]
│
├─ 📁 docs/ [45 files - 6.7%] ███████░░
│  ├─ 📁 src/ [35 files - 77.8%] ██████░░
│  │  ├─ 📁 content/ [33 documentation pages] ██████░░
│  │  └─ 📁 assets/ [1 image/asset]
│  ├─ 📁 public/ [files]
│  └─ 📁 .vscode/ [editor config]
│
├─ 📁 cmd/ [3 files - 0.4%] ░
│  └─ 📁 gh-aw/ [3 Go files - CLI entry point]
│
├─ 📁 schemas/ [1 file - 0.1%] ░
│  └─ 📄 agent-output.json
│
├─ 📁 scripts/ [1 file - 0.1%] ░
│  └─ 📄 Shell script
│
├─ 📁 .vscode/ [4 JSON configs] ░
├─ 📁 .devcontainer/ [1 config] ░
├─ 📁 .changeset/ [6 changelog files] ░
│
└─ 📄 Root Files [10 markdown + configs] ██░░
   ├─ 🔧 go.mod, go.sum (Go modules)
   ├─ 🔧 Makefile (Build automation)
   ├─ 🔧 .golangci.yml (Linter config)
   ├─ 🔧 .prettierrc.json (Formatter config)
   ├─ 📚 AGENTS.md, README.md, DEVGUIDE.md
   ├─ 📚 CONTRIBUTING.md, TESTING.md
   └─ 📚 CHANGELOG.md, SECURITY.md, SUPPORT.md

---

📈 File Type Distribution

Extension   Count    Percentage  Visualization
──────────  ─────    ──────────  ─────────────────────────────
.go         346      51.3%       ████████████████████████████████████████
.md         184      27.3%       ███████████████████████░░
.cjs        50       7.4%        ██████░░
.yml        38       5.6%        ████░░
.json       21       3.1%        ██░░
.sh         12       1.8%        █░
.ts         4        0.6%        ░
.txt        3        0.4%        ░
.js         2        0.3%        ░
Other       14       2.1%        █░
──────────  ─────    ──────────  
Total       674      100.0%

---

🎯 Key Repository Metrics

Go Source Code

• Total Go Files: 346 (51.3% of all files)
• Test Files: 225 (65.0% of Go files)
• Code-to-Test Ratio: 1:1.86 (excellent test coverage!)

Package Distribution

pkg/workflow/  ████████████████████████████████  229 Go files (66.2%)
pkg/cli/       ████████████░░░░░░░░░░░░░░░░░░░░   85 Go files (24.6%)
pkg/parser/    ███░░░░░░░░░░░░░░░░░░░░░░░░░░░░░   21 Go files (6.1%)
pkg/console/   █░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░    5 Go files (1.4%)
pkg/constants/ ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░    1 Go file  (0.3%)
cmd/gh-aw/     ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░    3 Go files (0.9%)

JavaScript/TypeScript

• Total CJS Files: 50
  • Implementation: 27 files (54%)
  • Tests: 23 files (46%)
• TypeScript: 4 files
• JavaScript: 2 files

Documentation

• Markdown Files: 184 total
  • Root documentation: 10 files
  • GitHub workflows: 55 files
  • Package docs: 79 files
  • Docs site: 34 files
  • Changesets: 6 files

Workflow Files

• Workflow Definitions: 45 .md files
• Compiled Workflows: 37 .lock.yml files
• Shared Components: 18 files
• Agentic Workflows: 3 files
• Test Workflows: 67 files (in pkg/cli/workflows/)

Configuration Files

• Schema Definitions: 5 JSON schemas
• Build Configs: Makefile, go.mod, go.sum
• Editor Configs: .vscode, .devcontainer, .prettierrc.json
• Linter Config: .golangci.yml

---

🏗️ Architecture Insights

Core Components

1. Workflow Engine (pkg/workflow/ - 314 files)

• Primary engine implementation in Go (229 files)
• JavaScript/CommonJS modules for GitHub Actions (50 files)
• Extensive test coverage (23 test files for JS alone)
• Template system for workflow generation
• Schema validation and configuration management

2. CLI Interface (pkg/cli/ - 155 files)

• Command implementation (85 Go files)
• Template rendering system (3 templates)
• Test workflow library (67 workflows)
• Console output formatting via pkg/console

3. Parser System (pkg/parser/ - 24 files)

• Markdown frontmatter parsing
• Schema validation (3 JSON schemas)
• Workflow compilation logic

4. Documentation (docs/ - 45 files)

• Astro Starlight-based documentation site
• 33 content pages covering all aspects
• Assets and public resources

Development Infrastructure

Testing Strategy

• 225 Go test files out of 346 total Go files (65% test coverage)
• 23 JavaScript test files for CJS modules
• 67 test workflow files for integration testing
• Comprehensive test data directories

Workflow System

• 45 workflow definitions (.md files)
• 37 compiled workflows (.lock.yml files)
• 18 shared components for reuse
• 3 specialized agentic workflows

Build & Development

• Makefile-driven build system
• Go modules for dependency management
• Linter and formatter configurations
• VS Code integration with 4 config files
• Dev container support

---

🎨 Size Visualization Legend

█ = 10% of maximum
▓ = 7.5% of maximum
▒ = 5% of maximum  
░ = 2.5% of maximum

---

📝 Repository Characteristics

Strengths:

• ✅ Excellent test coverage (65% of Go files are tests)
• ✅ Well-documented (184 markdown files, comprehensive docs site)
• ✅ Clear package structure with focused responsibilities
• ✅ Extensive workflow library with 67 test workflows
• ✅ Strong JavaScript testing infrastructure (46% test coverage for CJS)
• ✅ Comprehensive development tooling and configuration

Architecture:

• 🏗️ Modular Go packages with clear separation of concerns
• 🔄 Dual-language implementation (Go core + JavaScript GitHub Actions)
• 📚 Documentation-first approach with Diátaxis framework
• 🧪 Test-driven development evident in file ratios
• 🔧 Template-based code generation system

Repository Type: CLI Tool + GitHub Actions Extension
Primary Use: Agentic workflow compilation and execution
Development Stage: Active development with comprehensive testing

---

Generated on October 11, 2025 | Total analyzed: 674 files across 38 directories

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.