Skip to content
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
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
4 changes: 2 additions & 2 deletions docs/development/STRUCTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,8 +55,8 @@ The gateway sidecar holds credentials and enforces policies:

```
gateway/
├── gateway.py # Main HTTP server
├── _module_loader.py # Sibling-module bootstrap loader (isolated to keep gateway.py out of the dynamic-import seed set; do not add gateway imports here)
├── gateway/ # Main HTTP server package (barrel `__init__.py` + `__main__.py` entry point + 12 `_<cluster>.py` submodules: `_helpers`, `_health`, `_git_ops`, `_git_execute`, `_gh_ops`, `_gh_execute`, `_jira`, `_jira_writes`, `_confluence`, `_worktree`, `_sessions`, `_proxy`, `_server`); run via `python3 -m gateway`; see gateway/CLAUDE.md for the full seam table
├── _module_loader.py # Sibling-module bootstrap loader (isolated to keep gateway/gateway/ out of the dynamic-import seed set; do not add gateway imports here)
├── git_client.py # Git operation handler
├── github_client.py # GitHub API handler (supports bot/user/reviewer modes)
├── policy.py # Branch ownership, push policies, reviewer identity management
Expand Down
4 changes: 2 additions & 2 deletions docs/guides/decomposition-pattern.md
Original file line number Diff line number Diff line change
Expand Up @@ -221,11 +221,11 @@ allowlist entry — see section (g).
## (f) Routes-handling convention

Both `orchestrator/routes/*.py` (Flask Blueprints) and
`gateway/gateway.py` (`@app.route(...)`) follow the **same** seam:
`gateway/gateway/` (`@app.route(...)`) follow the **same** seam:

1. **Route registrations stay in `__init__.py`.** Decorators
(`@<bp>.route(...)` for routes/*.py; `@app.route(...)` for
gateway.py) live on thin wrapper functions in `__init__.py`.
the gateway barrel) live on thin wrapper functions in `__init__.py`.
2. **Wrapper bodies delegate to submodule implementations.**

```python
Expand Down
2 changes: 1 addition & 1 deletion docs/guides/per-agent-models.md
Original file line number Diff line number Diff line change
Expand Up @@ -717,7 +717,7 @@ the built-in default (`"opus"` for all roles).
Submit a pipeline. The gateway audit log records the per-session
routing decision **once per session** (the gateway's
`audit_log("session_created", …)` at
`gateway/gateway.py:8920` includes the resolved `upstream` and
`gateway/gateway/_sessions.py:535` includes the resolved `upstream` and
`upstream_model`); every subsequent `/v1/messages` request from that
session inherits the decision implicitly via the session-keyed
lookup, with no per-request routing log line:
Expand Down
3 changes: 1 addition & 2 deletions orchestrator/event_loop/_supervisor.py
Original file line number Diff line number Diff line change
Expand Up @@ -368,8 +368,7 @@ def reset_exhausted(self) -> list[str]:
self.retire(key)
if cleared:
logger.info(
"JobSupervisor: operator reset cleared %d exhausted key(s) — "
"fresh spawn budgets: %s",
"JobSupervisor: operator reset cleared %d exhausted key(s) — fresh spawn budgets: %s",
len(cleared),
", ".join(cleared),
)
Expand Down
Loading