Skip to content

docs: Update STRUCTURE.md for checkpoint infrastructure [doc-updater] #520

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jwbron merged 1 commit into from
Feb 11, 2026
Merged

docs: Update STRUCTURE.md for checkpoint infrastructure [doc-updater] #520

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 11 additions & 3 deletions docs/development/STRUCTURE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,8 @@ gateway/
├── auth.py # Session authentication
├── token_refresher.py # GitHub App token management
├── anthropic_credentials.py # API key injection for Claude
├── checkpoint_handler.py # Per-commit checkpoint capture
├── transcript_buffer.py # API proxy transcript capture buffer
├── worktree_manager.py # Git worktree lifecycle
├── session_manager.py # Agent session management
├── repo_parser.py # Repository config parsing
Expand Down Expand Up @@ -81,9 +83,11 @@ sandbox/
│ ├── git
│ ├── gh
│ ├── egg-contract # Symlink to contract_cli.py
│ ├── egg-checkpoint # Symlink to checkpoint_cli.py
│ └── git-credential-github-token
├── egg_lib/ # Container utility libraries
│ └── contract_cli.py # SDLC contract CLI implementation
│ ├── contract_cli.py # SDLC contract CLI implementation
│ └── checkpoint_cli.py # Checkpoint browsing CLI wrapper
├── llm/ # Claude Code / Agent SDK integration
├── tools/ # Interactive tools
│ ├── discover-tests.py # Test framework discovery
Expand All @@ -99,14 +103,18 @@ sandbox/
shared/
├── egg_config/ # Configuration utilities
│ └── constants.py # Centralized constants (ports, networks, container names)
├── egg_contracts/ # SDLC contract models, plan parser, role-based validation, HITL, feedback, phase checks, multi-agent orchestration
├── egg_contracts/ # SDLC contract models, plan parser, role-based validation, HITL, feedback, phase checks, multi-agent orchestration, checkpoints
│ ├── models.py # Pydantic models including CheckDefinition, CheckResult, PhaseConfig, AgentExecutionModel
│ ├── phase_defaults.py # Default check configurations per SDLC phase
│ ├── agent_roles.py # Multi-agent role definitions (Coder, Tester, Documenter, Integrator)
│ ├── orchestrator.py # Multi-agent orchestration dispatch logic
│ ├── orchestration.py # Agent execution state management
│ ├── dependency_graph.py # Agent dependency resolution for parallel execution
│ └── agent_recovery.py # Failed agent recovery logic
│ ├── agent_recovery.py # Failed agent recovery logic
│ ├── checkpoints.py # Checkpoint data models
│ ├── checkpoint_loader.py # Checkpoint storage and retrieval
│ ├── checkpoint_cli.py # Checkpoint browsing CLI
│ └── transcript_extractor.py # API transcript extraction
├── egg_git/ # Git utilities
└── egg_logging/ # Structured logging
```
Expand Down