Open #144 Enhancement phase/9a-4

filed by aaronrene human · 51 days ago

feat(9A-4 F7): overseer-run provenance enrichment API for Scooling consumer

1 Anchors

— Blast radius

— Churn 30d

1 Proposals

Phase 9A-4 F7 — overseer-run provenance enrichment API

Consumer: Scooling orchestration (readOverseerRunProvenance) — merged on GitHub main @ 10f7b02 (SC #198).

Not vault UI (KD-6b). This is a server-to-server JSON API Scooling calls over HTTPS with a bearer token — same staging read posture as existing MuseHub repo live reads.

Deliverable

New read-only REST route on MuseHub staging:

GET /api/overseer-run-provenance/{run_ref}

Example:

GET /api/overseer-run-provenance/flow_run:fixture-overseer-001

Runtime gate (MuseHub)

MUSEHUB_OVERSEER_PROVENANCE_ENRICHMENT=enabled

When disabled or route absent: fail-closed (404).

Acceptance criteria

Fixed-path route registered before /{owner}/{repo_slug} wildcard (today probe returns 422 — repos route shadows the path).
GET /api/overseer-run-provenance/flow_run:fixture-overseer-001 → 200 with content-free envelope when env enabled.
Response schema: musehub.overseer_run_provenance_envelope/v0 wrapping scooling.overseer_run_provenance/v0 record (no note bodies, prompts, completions, or secrets).
Fixture row seeded for flow_run:fixture-overseer-001 (inert staging store until durable tables land).
Read-only — no canonical write to Knowtation or MuseHub repos.

Implementation notes (drafted locally)

musehub/services/musehub_overseer_provenance.py
musehub/api/routes/musehub/overseer_provenance.py (auto-discovered by route package)
musehub/config.py — musehub_overseer_provenance_enrichment_enabled

Next: branch + MP for review (like MP #129). After merge: deploy/push.sh staging with env flag above.

Scooling consumer env (for spot-check after deploy)

SCOOLING_OVERSEER_PROVENANCE_ENRICHMENT=enabled
SCOOLING_MUSEHUB_REPO_LIVE=enabled
SCOOLING_MUSEHUB_REPO_URL=https://staging.musehub.ai
SCOOLING_MUSEHUB_REPO_TOKEN=<staging token>

References

Scooling frozen outline: docs/PHASE-9A-4-MUSEHUB-PROVENANCE-ENRICHMENT-OUTLINE.md
Scooling handover: docs/OVERSEER-HANDOVER.md (9A-4 spot-check PARTIAL)

◎ Activity1

●

aaronrene opened this issue 51 days ago

○

aaronrene 51 days ago

MP opened: https://staging.musehub.ai/gabriel/musehub/proposals/sha256:01e6a0d4ca543a6a11eeeecd4fa9eca259c0d2ad625954b5465de30a30163c83

Branch feat/9a-4-f7-overseer-provenance @ sha256:42bc547… pushed to staging. Ready for review/merge → deploy with MUSEHUB_OVERSEER_PROVENANCE_ENRICHMENT=enabled.

◈ Symbol Anchors 1

musehub/services/musehub_overseer_provenance.py::get_overseer_run_provenance ↗

Assignee

○ unassigned

Linked Proposals via symbol overlap

○ #9 Phase 9A-4 F7: overseer-run prove… ◆

Release

no commits linked to this issue

create

muse hub issue create \
  --title "..." \
  --body "..." \
  --label bug \
  --anchor path/to/file.py::Symbol \
  --commit-anchor <sha> \
  --repo gabriel/musehub

read

muse hub issue get 144 --json
muse hub issue list --state open --json

update

muse hub issue edit 144 \
  --anchor musehub/services/musehub_overseer_provenance.py::get_overseer_run_provenance \
  --repo gabriel/musehub

comment

muse hub issue comment 144 \
  --body "Fixed in <sha>" \
  --repo gabriel/musehub

muse hub issue close 144 \
  --repo gabriel/musehub

create

create_issue({
  repo_id: "sha256:a265796360c3b1b8700b5682ced5f6b044a2c0d3a2c58918892a5aa494db6c75",
  title: "...",
  body: "...",
  labels: ["bug"],
  symbol_anchors: [
    "path/to/file.py::Symbol"
  ],
  commit_anchors: ["<sha>"]
})

read

get_issue({
  repo_id: "sha256:a265796360c3b1b8700b5682ced5f6b044a2c0d3a2c58918892a5aa494db6c75",
  issue_number: 144
})

list_issues({
  repo_id: "sha256:a265796360c3b1b8700b5682ced5f6b044a2c0d3a2c58918892a5aa494db6c75",
  state: "open"
})

update

edit_issue({
  repo_id: "sha256:a265796360c3b1b8700b5682ced5f6b044a2c0d3a2c58918892a5aa494db6c75",
  issue_number: 144,
  symbol_anchors: [
    "musehub/services/musehub_overseer_provenance.py::get_overseer_run_provenance"
  ]
})

comment

create_issue_comment({
  repo_id: "sha256:a265796360c3b1b8700b5682ced5f6b044a2c0d3a2c58918892a5aa494db6c75",
  issue_number: 144,
  body: "..."
})

close_issue({
  repo_id: "sha256:a265796360c3b1b8700b5682ced5f6b044a2c0d3a2c58918892a5aa494db6c75",
  issue_number: 144
})

create

curl -X POST \
  http://localhost:10003/api/repos/sha256:a265796360c3b1b8700b5682ced5f6b044a2c0d3a2c58918892a5aa494db6c75/issues \
  -H "Content-Type: application/json" \
  -H "Authorization: MSign handle=\"...\" ts=... sig=\"...\"" \
  -d '{
    "title": "...",
    "body": "...",
    "labels": ["bug"],
    "symbol_anchors": ["path/to/file.py::Symbol"]
  }'

read

# get one issue
curl http://localhost:10003/api/repos/sha256:a265796360c3b1b8700b5682ced5f6b044a2c0d3a2c58918892a5aa494db6c75/issues/144

# list open issues
curl "http://localhost:10003/api/repos/sha256:a265796360c3b1b8700b5682ced5f6b044a2c0d3a2c58918892a5aa494db6c75/issues?state=open"

update

curl -X PATCH \
  http://localhost:10003/api/repos/sha256:a265796360c3b1b8700b5682ced5f6b044a2c0d3a2c58918892a5aa494db6c75/issues/144 \
  -H "Content-Type: application/json" \
  -H "Authorization: MSign handle=\"...\" ts=... sig=\"...\"" \
  -d '{"title": "...", "body": "..."}'

comment

curl -X POST \
  http://localhost:10003/api/repos/sha256:a265796360c3b1b8700b5682ced5f6b044a2c0d3a2c58918892a5aa494db6c75/issues/144/comments \
  -H "Content-Type: application/json" \
  -H "Authorization: MSign handle=\"...\" ts=... sig=\"...\"" \
  -d '{"body": "Fixed in <sha>"}'

curl -X POST \
  http://localhost:10003/api/repos/sha256:a265796360c3b1b8700b5682ced5f6b044a2c0d3a2c58918892a5aa494db6c75/issues/144/close \
  -H "Authorization: MSign handle=\"...\" ts=... sig=\"...\""