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 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.
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.