# 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-OQ: resolve issue #2 open questions

**Date:** 2026-07-10  
**Current position:** **KD-ACTIVATE DONE** — test vault `knowtation-vault-smoke` activated; Phase 1–4 smoke matrix run (8 checks; 5 PASS, 3 PARTIAL with documented gaps).  
**Model:** **Thinking**

### What just landed (context from prior sessions)

| Slice | Deliverable |
| --- | --- |
| **KD-ACTIVATE** | Test vault `~/MUSE_HUB/knowtation-vault-smoke` — `muse init --domain knowtation`, Harmony `.museattributes`, 3 fixture notes, smoke matrix executed |
| **KD-0..4, KD-7** | Full plugin tree under `gabriel-muse/muse/plugins/knowtation/` |
| **KD-SD8-PUSH** | `muse push staging main` → `aaronrene/gabriel-muse` @ `sha256:660fcac1…` |
| **KD-SD8-REG** | `@aaronrene/knowtation` on staging marketplace (2026-07-05) |

### THE ONE NEXT STEP — **Model: Thinking**

**KD-OQ** — Resolve the five open questions in [gabriel/muse #2](https://staging.musehub.ai/gabriel/muse/issues/2) before KD-5a contract freeze.

| | |
| --- | --- |
| **ID** | **KD-OQ** |
| **Repo(s)** | **gabriel-muse** + **musehub** |
| **Model** | **Thinking** — no guessing; record decisions in `MUSEHUB-ROADMAP.md` open-questions table |
| **Blockers** | None |
| **Why now** | KD-ACTIVATE proved vault behavior; KD-5a MCP contract needs frozen answers on detection boundary, vector index, consolidation coupling, ICP canister, SKILL.md discovery |
| **Do not start yet** | KD-5b (MCP impl), KD-6 (Hub UI) — after KD-OQ closes |

**Not next:** Re-run KD-ACTIVATE unless plugin merge/diff CLI gaps are fixed · Scooling Phase 9A gates.

### Alternative tracks (operator choice)

| Track | ID | Model | When |
| --- | --- | --- | --- |
| **KD-5a** — MCP contract + test matrix | KD-5a | **Thinking → Auto** | After KD-OQ; can split a/b in handover |
| **Fix CLI merge dispatch** | KD-ACTIVATE-fix | **Auto** | `plugin.merge` does not dispatch `union-sorted` / `knowtation-3way` — file-level conflicts on tag-only edits |
| **Fix symbols CLI routing** | KD-ACTIVATE-fix | **Auto** | `muse code symbols` uses code AST for `.md`; should route to `extract_symbols` on knowtation repos |
| **Marketplace `viewer_type=knowledge`** | KD-ACTIVATE-b | **Auto (Tier 3)** | Re-publish `@aaronrene/knowtation` listing |
| **Scooling overseer** | 9A-* | **Operator + Auto** | Separate session |

### Paste-ready prompt — KD-OQ (recommended)

```
MuseHub workspace — Knowtation open questions (KD-OQ).

Model: Thinking (freeze decisions; no implementation).

Goal: Close all five TBD rows in docs/MUSEHUB-ROADMAP.md open-questions table from issue #2.

Read first:
  ~/MUSE_HUB/docs/MUSEHUB-ROADMAP.md (open questions section)
  ~/MUSE_HUB/docs/MUSEHUB-OVERSEER-HANDOVER.md (KD-ACTIVATE smoke gaps)
  https://staging.musehub.ai/gabriel/muse/issues/2

Context (verified 2026-07-10):
  - KD-ACTIVATE vault smoke DONE — see handover verified snapshot for PASS/PARTIAL matrix
  - Gaps to inform decisions: CLI merge does not auto-dispatch Harmony strategies; symbols CLI uses code AST not knowtation extract_symbols; muse diff CLI is file-granular (differ API is section-granular)
  - prime_context: API only (build_prime_context); no muse CLI hook yet

Tasks:
  1. For each of the 5 open questions, research codebase + issue #2 comments; pick one option; document rationale.
  2. Update MUSEHUB-ROADMAP.md Decision column + MUSEHUB-OVERSEER-HANDOVER.md verified snapshot.
  3. Write KD-5a paste-ready prompt (MCP contract Thinking slice) as NEXT SESSION alternative.
  4. Muse commit on feat/kd-oq branch (Tier 1). No KD-5b implementation.

Hard stops:
  - No MCP tool implementation (KD-5b)
  - No Hub UI (KD-6)
  - muse push staging = Tier 3
```

---

## Done recently

| Item | Status |
| --- | --- |
| **KD-ACTIVATE** | **DONE** (2026-07-10) — vault smoke on `knowtation-vault-smoke`; matrix below |
| **MuseHub governance docs** | **CREATED** (2026-07-10) — this file + `MUSEHUB-ROADMAP.md` |
| **KD-SD8-REG** | **DONE** — `@aaronrene/knowtation` on staging (2026-07-05) |
| **KD-SD8-PUSH** | **DONE** — `aaronrene/gabriel-muse` @ `660fcac1…` (2026-06-21) |
| **KD-0 recovery** | **DONE** — rc14 baseline; 1570 plugin tests green (2026-06-20) |

## Verified snapshot (what exists now)

| Area | State |
| --- | --- |
| **Program position** | **KD-OQ NEXT** — open questions gate before KD-5a |
| **Plugin code** | **LOCAL DONE** — Phases 1–4, 7 under `gabriel-muse/muse/plugins/knowtation/` |
| **Plugin tests** | 27 `test_knowtation_*.py` files; last full count **1570 passed** (2026-06-20) |
| **Staging plugin repo** | `aaronrene/gabriel-muse` — HTTP 200 |
| **Marketplace** | `@aaronrene/knowtation` v1.0.0 — 6 dimensions; `viewer_type: generic`; `install_count: 0` |
| **Vault activation** | **DONE** — `~/MUSE_HUB/knowtation-vault-smoke` (`domain=knowtation`, Harmony `.museattributes`) |
| **KD-5 MCP** | **NOT STARTED** — entry: KD-OQ + KD-5a contract |
| **KD-6 Hub UI** | **NOT STARTED** |
| **Scooling parallel track** | Phase 9A overseer — independent |

### KD-ACTIVATE smoke matrix (2026-07-10, vault: `knowtation-vault-smoke`)

| # | Check | Result | Evidence |
| --- | --- | --- | --- |
| 1 | `muse domain-info --json` | **PASS** | `note_count: 3`, `source_types: [manual, telegram]`, `projects: [kd-smoke]`, `entity_count: 3` |
| 2 | `muse code symbols --file <note.md>` | **PARTIAL** | CLI: 4 `section` symbols (code AST). API `extract_symbols`: 1 note + 7 field + 4 section on `overview.md` |
| 3 | `muse diff` section edit | **PARTIAL** | CLI: file-level `M` only. `diff_notes` API: `section:2:2026-07-10#0::line:2` insert/delete — section-aware |
| 4 | `muse merge` tag-conflict | **PARTIAL** | CLI: `status: conflict` on `overview.md`. `merge_notes` API: union both tags, no `<<<<<<<` markers |
| 5 | `muse code deps` / `impact` | **PASS** | `overview.md` → `linked-target.md` wikilink; reverse impact depth 1 |
| 6 | `muse code hotspots` / `dead` | **PASS** | Valid JSON; `hotspots.ranking[0].path = overview.md`; `dead_count: 0` |
| 7 | `muse log --json` + `--event-type` | **PASS** | Commit `4db3b5a2…` metadata `event_type: write` |
| 8 | `prime_context` bootstrap | **PASS (API)** | `build_prime_context` → schema `1.0.0`, `hot_notes: [{overview.md, edits:3}]`; **no CLI hook** |

**Activation verdict:** Domain plugin operates on a real vault repo for introspection, link intel, metrics, memory events, and prime bootstrap. **CLI wiring gaps** (merge strategy dispatch, symbols routing, diff granularity) recorded for KD-ACTIVATE-fix; do not block KD-OQ.

## VCS (verified 2026-07-10)

| Repo | Branch / location | Notes |
| --- | --- | --- |
| gabriel-muse (local) | `feat/kd-activate` | Governance sync branch; plugin unchanged |
| gabriel-muse (staging) | `aaronrene/gabriel-muse` | Plugin source @ `sha256:660fcac1…` |
| musehub | `~/MUSE_HUB/musehub` | Marketplace API |
| **Test vault** | `~/MUSE_HUB/knowtation-vault-smoke` | **KD-ACTIVATE** — 3 notes, 6+ commits, branches `feat/tags-ours` / `feat/tags-theirs` |
| MuseHub governance docs | `~/MUSE_HUB/docs/MUSEHUB-*.md` | Workspace-level; mirrored in gabriel-muse commit |

**Hold:** KD-5/KD-6 until KD-OQ closes · staging push without Tier 3 · Scooling branch work out of scope.

## Hard stops

- No KD-5 MCP or KD-6 Hub UI until KD-OQ + KD-5a contract (unless operator reprioritizes)
- No guessing on issue #2 open questions — KD-OQ Thinking session
- Knowtation product repo ≠ vault repo
- Scooling governance docs out of scope unless Scooling work lands

## Change log

- **2026-07-10** — **KD-ACTIVATE DONE.** Test vault activated; smoke matrix 5 PASS / 3 PARTIAL. NEXT → **KD-OQ** (Thinking). CLI gaps: merge Harmony dispatch, symbols routing, diff section granularity.
- **2026-07-10** — Initial MuseHub Overseer Handover. NEXT was KD-ACTIVATE.

---

## 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_knowtation_*.py` in gabriel-muse for plugin touches. Seven tiers for new slices.

**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:`**.

**Orchestrator:** Cross-workspace overseer tooling is **not live yet** — manual doc sync is mandatory until it ships.