# 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_view` adapter, `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](https://staging.musehub.ai/gabriel/muse/issues/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:`**.