docs: add #1882 gateway/orchestrator files to STRUCTURE.md [doc-updater] - #1960
Conversation
There was a problem hiding this comment.
Doc-only change, all five referenced files verified to exist on main, descriptions match file docstrings. One non-blocking ordering issue.
Non-blocking
routes/commit_authorship.py placement breaks alphabetical order — The routes/ subsection is currently alphabetical (anchors → containers → decisions → … → pipelines → progress → signals). The new commit_authorship.py entry is placed after pipelines.py, but it should go between anchors.py and containers.py to maintain the established ordering.
│ ├── 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 endpointsThe gateway section and top-level orchestrator section use loose thematic grouping rather than strict alphabetical order, so those placements are fine.
— Authored by egg
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
This comment has been minimized.
There was a problem hiding this comment.
Agreed. Moved commit_authorship.py entry to its correct alphabetical position between anchors.py and containers.py in the routes/ subsection. Fixed in 9925a63.
— Authored by egg
There was a problem hiding this comment.
Re-review of changes since 24ee0e9.
The single new commit (9925a63) correctly addresses the alphabetical ordering feedback from the previous review — commit_authorship.py is now placed between anchors.py and containers.py in the routes/ subsection.
Verified:
- All five files added across both commits exist on
main - Descriptions match file purposes
- Gateway section maintains its thematic grouping convention
routes/section maintains alphabetical order
No issues found.
— Authored by egg
|
egg review completed. View run logs 2 previous review(s) hidden. |
Update STRUCTURE.md to reflect new modules introduced in #1882 (cbd831e).
Three new gateway files and two new orchestrator files were added by the auto-filter PR but not listed in the project structure doc:
gateway/filtered_push.py— per-commit rewriter that strips blocked paths from own commits while passing cross-role pulled commits bitwise-unchangedgateway/commit_observer.py— gateway-inline observer that registers new SHAs with the authorship registry after eachgit-executecallgateway/commit_registry_client.py— HTTP client for the orchestrator's commit-authorship registry (register + lookup_bulk)orchestrator/commit_authorship_store.py— durable{sha → role}registry sharded by pipeline on the pipeline-state branchorchestrator/routes/commit_authorship.py— register and lookup endpoints called by the gateway observer and push handlerThe architecture doc (
docs/architecture/gateway-auto-filter.md) and the index (docs/index.md) were already updated as part of #1937 and fully describe these components. This PR just adds them to the directory-level inventory in STRUCTURE.md.Triggered by: #1937
Authored-by: egg