> ## Documentation Index
> Fetch the complete documentation index at: https://prism.ntecdev.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Plan #1: MCP Surface Audit + Improvements (Donna review, 2026-04-17)

> MCP Surface Audit + Improvements (Donna review, 2026-04-17)

<Info>**Status:** `active` · **Version** `1` · Filed 2026-04-17</Info>

# 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

4. Resolve prism\_spec / create\_spec duplication. Pick canonical, alias the other, document.
5. Resolve register\_project / bootstrap\_project(strategy=register) overlap.
6. 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)

7. Add type + namespace filters to semantic\_recall. Metadata already exists on every row.
8. Reindex retro what\_didnt/what\_worked/lessons as first-class records (or per-field embeddings).
9. Design L→G lesson promotion pipeline. Reuse Phase 3 candidate/promote/reject plumbing.

### Wave 4 — Lifecycle cohesion

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

### Wave 5 — Reliability

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

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