[issue-3288][slice-4/6] Gateway docstrings + gateway/CLAUDE.md

[james-in-a-box]

De-ledger gateway/ .py docstrings and inline comments (coder) and re-key the gateway/CLAUDE.md submodule seam tables by current structure (documenter). Docstring/comment edits only — no code-behavior change; keep load-bearing rationale links.

Base PR: #3317

What's in this PR

Commits (6):

• Persist BRC history for slice-4 (Slice PRs are missing analysis/plan docs and all BRC history; need a 'context' PR for refine+plan phases plus per-slice BRC in each slice PR #2548)
• docs(gateway): reword JIRA_WRITE_VERBS_DENIED comment to current-state
• implement(Documenter agent + docs: snapshot of current state, not a ledger of changes #3288): de-ledger artifact_api strict-schema and jira multi-site notes
• Strip residual SDLC-artifact ledger markers from jira_client docstrings
• implement(Documenter agent + docs: snapshot of current state, not a ledger of changes #3288): de-ledger gateway/CLAUDE.md seam tables
• implement(Documenter agent + docs: snapshot of current state, not a ledger of changes #3288): strip slice ledger markers from gateway docstrings

.egg-state/brc-history/3288-implement-slice-4.json | 1383 ++++++++++++++++++++++++++++++
 .egg-state/brc-history/3288-implement-slice-4.md   | 1842 ++++++++++++++++++++++++++++++++++++++++
 gateway/CLAUDE.md                                  |   53 +-
 gateway/artifact_api.py                            |    6 +-
 gateway/jira_client.py                             |   40 +-
 5 files changed, 3267 insertions(+), 57 deletions(-)

This slice

Gateway docstrings + gateway/CLAUDE.md

Files affected:

• gateway/artifact_api.py
• gateway/jira_client.py
• gateway/CLAUDE.md

Tasks (2) + acceptance criteria

• task-4-1: Clean gateway/ .py docstrings and comments. In gateway/artifact_api.py, rewrite the module docstring """Artifact API endpoints on the gateway (#3077 slice-4).""" to describe the endpoints' current purpose without the slice tag (keep a bare Design: coordination state is served, not replicated — retire git/prompt choreography for agent state exchange #3077 rationale link only if it explains why the endpoint exists). In gateway/jira_client.py, strip the # Issue #1557 slice-2 … markers from the affected methods, keeping any genuinely useful rationale as a present-tense comment. No code/control-flow changes — comments/docstrings only.
  • Acceptance criteria: - artifact_api.py module docstring describes current behavior with no "slice-4" tag. - jira_client.py method comments carry no "slice-2" ledger markers; retained text is current-state rationale. - No behavior change; the gateway test suite stays green.
• task-4-2: Re-key the submodule seam tables in gateway/CLAUDE.md. Today they are organized by which slice landed each decomposition; reorganize them to describe the current submodule structure (module → responsibility), dropping the slice-landed column. Keep the decomposition-pattern rationale link.
  • Acceptance criteria: - The gateway/CLAUDE.md seam tables are organized by current structure, not by which slice landed each piece; no slice-N references remain; retained links are rationale.

Stack

• Position: slice 4 of 6 in pipeline issue-3288
• Base PR: Documenter snapshot-not-ledger framing + corpus cleanup (#3288) #3317
• Stacked on top of egg/issue-3288/slice-1