Skip to content

docs: add #1882 gateway/orchestrator files to STRUCTURE.md [doc-updater] #1960

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 2 commits into from
Apr 24, 2026
Merged

docs: add #1882 gateway/orchestrator files to STRUCTURE.md [doc-updater] #1960

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
24ee0e9
docs: add #1882 gateway files to STRUCTURE.md
jwbron Apr 23, 2026
9925a63
Fix routes/ alphabetical ordering for commit_authorship.py
egg-reviewer[bot] Apr 24, 2026
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
5 changes: 5 additions & 0 deletions docs/development/STRUCTURE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,9 @@ gateway/
├── private_repo_policy.py # Private/public repo access
├── phase_filter.py # Phase-based operation filtering, file restrictions
├── agent_restrictions.py # Agent role-based file access enforcement
├── filtered_push.py # Per-commit auto-filter: rewrites own commits to remove blocked paths; passes cross-role pulled commits bitwise-unchanged
├── commit_observer.py # Gateway-inline commit observer: registers new SHAs with the authorship registry after each git-execute call
├── commit_registry_client.py # HTTP client for the orchestrator's commit-authorship registry (register + lookup_bulk)
├── phase_transition.py # Phase transition validation
├── phase_api.py # Phase API endpoints
├── contract_api.py # Contract API endpoints
Expand Down Expand Up @@ -116,6 +119,7 @@ orchestrator/
├── sandbox_template.py # Sandbox container template
├── sse.py # Server-Sent Events streaming for pipeline visualization
├── startup_reconciliation.py # Startup reconciliation for orphaned containers
├── commit_authorship_store.py # Durable {sha → role} registry sharded by pipeline on the pipeline-state branch; backing store for the commit-authorship registry
├── state_store.py # Git-backed pipeline state
├── status_reporter.py # Real-time status reporter for collaborators
├── unified_sse.py # Unified SSE stream for all pipelines
Expand All @@ -141,6 +145,7 @@ orchestrator/
│ └── agent_inspector.py # Claude-powered agent progress analysis
├── routes/ # API route handlers
│ ├── anchors.py # Agent anchor CRUD and team anchor generation endpoints
│ ├── commit_authorship.py # Commit-authorship registry endpoints (register + lookup); called by gateway commit observer and push handler
│ ├── containers.py # Container management endpoints
│ ├── decisions.py # HITL decision endpoints
│ ├── deployment.py # Deployment introspection and action endpoints (k8s diagnostics, prune, rebuild)
Expand Down
Loading