Skip to main content
Status: active · Version 1 · Filed 2026-04-17

​
Plan: MCP Surface Audit + Improvements

Source: Donna’s external review session on 2026-04-17 (Lola project, claude.ai).

​
Goal

Address the findings from the tool-surface audit without rebuilding the server. All work is additive or surgical; no breaking changes to existing verbs.

​
Sequencing

​
Wave 1 — Data integrity (do first, cheapest wins)

  1. Fix PID-PGR01 project_dir — set to actual Prism repo root. Trivial UPDATE.
  2. Investigate prism_diff empty recent_deltas bug. Repro: prism_remember then prism_diff. Likely a time-window or filter mismatch.
  3. Audit phase field drift — PID-PGR01 shows Phase 0 but retros reach Phase 3.5.

​
Wave 2 — Surface cleanup

  1. Resolve prism_spec / create_spec duplication. Pick canonical, alias the other, document.
  2. Resolve register_project / bootstrap_project(strategy=register) overlap.
  3. Add uniform action=list to all typed-artifact verbs (decide, spec, journal, note) OR add explicit list_* verbs. Pick one pattern.

​
Wave 3 — Retrieval precision (the architectural work)

  1. Add type + namespace filters to semantic_recall. Metadata already exists on every row.
  2. Reindex retro what_didnt/what_worked/lessons as first-class records (or per-field embeddings).
  3. Design L→G lesson promotion pipeline. Reuse Phase 3 candidate/promote/reject plumbing.

​
Wave 4 — Lifecycle cohesion

  1. Retro-close auto-advances project.phase. Small backend change, eliminates metadata drift.
  2. Restructure prism_diff to return structured payload (ADR #1). Deprecate instruction-emitting shape.

​
Wave 5 — Reliability

  1. Investigate prism_decide 4-minute timeout. Likely sync embedding generation blocking the MCP response. Move embedding to background task or shorter timeout with 202 + polling.

​
Wave 6 — Packaging (non-blocking, onboarding prerequisite)

  1. Build a .dxt manifest.json for the Prism MCP server. Desktop-only distribution wrapper.

​
Out of Scope

  • Rewriting any verb semantics.
  • Any consumer-facing connector (Prism stays local-first).
  • Phase 4 deploy work.

​
Source Artifacts

  • ADRs #1 through #4 on PID-PGR01.
  • Notes tagged: api-surface, data-integrity, failure-modes, reliability.
  • Memory namespace: tool-surface-audit, packaging-strategy.
Last modified on April 20, 2026