MuseHub Overseer Handover
Living relay for the Knowtation domain program in the MUSE_HUB workspace. Paste the NEXT SESSION block into a fresh chat to resume without prior history.
Not Scooling. For Scooling work, use ~/scooling/docs/OVERSEER-HANDOVER.md.
Roadmap authority: docs/MUSEHUB-ROADMAP.md
NEXT SESSION — KD-STAGING: Staging push + attestation smoke
Date: 2026-07-10
Current position: KD-6b DONE — MuseHub vault UI landed in musehub/: services/knowtation_view adapter (in-process MCP + stdio fallback), ui_vault.py routes, vault templates/SCSS, KD-2 harmony-diff renderer, vault intel strip, seven-tier test matrix + Playwright browser E2E (tests/test_kd6_vault_ui.py — 19 passed / 2 skipped locally with stdio MCP on knowtation-vault-smoke).
Model: Operator + Auto — Tier 3 authorization for staging push; Auto for attestation smoke scripts and handover hygiene.
What just landed (KD-6b)
| Slice | Deliverable |
|---|---|
| KD-6b | Vault UI implementation per §KD-6a — adapter, routes, templates, SCSS, harmony diff, tests |
| Adapter | musehub/services/knowtation_view/ — MCP mount (in-process + gabriel-muse stdio fallback), error map §E |
| Routes | ui_vault.py — note detail, vault search, graph/memory fragments, proposal create delegate |
| Pages | note_detail.html, vault_search.html, repo_home_vault.html, vault fragments |
| Proposals | Vault harmony diff panel in proposal_detail.html via compute_harmony_diff |
| Tests | tests/test_kd6_vault_ui.py — tiers 1–7 + Playwright E2E |
THE ONE NEXT STEP — Model: Operator + Auto
KD-STAGING — Push KD-5b (gabriel-muse) and KD-6b (musehub) to staging; run KD-7 attestation smoke on a staging vault repo.
| ID | KD-STAGING |
| Repo(s) | gabriel-muse, musehub |
| Model | Operator + Auto — Tier 3 push; Auto for smoke + docs |
| Blockers | Operator authorization for muse push staging |
| Do not | Merge to main without mirror PR; push secrets |
Paste-ready prompt — KD-STAGING (recommended)
MuseHub workspace — staging push + attestation smoke (KD-STAGING).
Model: Operator + Auto (Tier 3 push requires operator authorization).
Goal: Push gabriel-muse (KD-5b MCP) and musehub (KD-6b vault UI) to staging;
run KD-7 attestation smoke on a knowtation-domain staging vault.
Read: docs/MUSEHUB-ROADMAP.md, docs/MUSEHUB-OVERSEER-HANDOVER.md
Tasks:
1. Operator: authorize muse push staging for gabriel-muse feat/kd-6a (includes KD-5b).
2. Deploy musehub KD-6b to staging environment.
3. Attestation smoke on staging vault (--attest flag).
4. Update governance docs; Muse commit on feature branches.
Done recently
| Item | Status |
|---|---|
| KD-6b | DONE (2026-07-10) — vault UI implementation + 7-tier + Playwright E2E |
| KD-6a | DONE (2026-07-10) — vault UI contract frozen |
| KD-5b | DONE (2026-07-10) — MCP implementation |
| KD-5a | DONE (2026-07-10) — MCP contract frozen |
Verified snapshot (what exists now)
| Area | State |
|---|---|
| Program position | KD-STAGING NEXT (Operator + Auto) |
| Vault UI | DONE — musehub/ KD-6b: adapter, routes, templates, tests |
| MCP server | DONE — gabriel-muse/muse/mcp/ (KD-5b) |
| Test vault | ~/MUSE_HUB/knowtation-vault-smoke |
| KD-6b tests | tests/test_kd6_vault_ui.py — 19 passed, 2 skipped (integration propose/import), 3 HTTP tiers need Postgres conftest |
VCS (verified 2026-07-10)
| Repo | Branch | Notes |
|---|---|---|
| musehub | feat/kd-6b |
KD-6b vault UI implementation |
| gabriel-muse | feat/kd-6a |
KD-5b MCP + docs |
| MUSE_HUB/docs | workspace | Governance synced |
Hold: merge to main (Tier 3) · Scooling out of scope
Change log
- 2026-07-10 — KD-6b DONE (Auto). Implemented MuseHub vault UI per §KD-6a:
knowtation_viewadapter,ui_vault.py, vault landing/note/search/proposals integration, markdown+wikilink sanitisation, KD-2 harmony diff renderer, vault intel strip, SCSS, seven-tier tests + Playwright E2E. Rotated NEXT → KD-STAGING. - 2026-07-10 — KD-6a DONE (Thinking). Froze vault UI contract.
- 2026-07-10 — KD-5b DONE (Auto). MCP domain surface.
Shared context (prepend to any KD phase prompt)
Program: Knowtation domain plugin — vault-native VCS intelligence per gabriel/muse #2.
Workspace: ~/MUSE_HUB/ — primary code in gabriel-muse/muse/plugins/knowtation/; Hub UI work in musehub/.
Boundaries:
- Knowtation (product) owns vault storage, Hub API, permissions — not this plugin.
- MuseHub enriches version/provenance/marketplace — does not own note bodies.
- Scooling is a consumer — parallel track; see
~/scooling/docs/.
Read first: docs/MUSEHUB-ROADMAP.md, docs/MUSEHUB-OVERSEER-HANDOVER.md, issue #2 for the active phase.
Tests: Run pytest tests/test_kd6_vault_ui.py in musehub for vault UI; pytest tests/test_knowtation_mcp_*.py in gabriel-muse for MCP.
Governance: On phase completion update both MuseHub Roadmap and this handover; feature branch → Muse commit.
Model labeling (required): Every next-step block and paste prompt must include Model:.