@phren/cli 0.0.7 → 0.0.9

package/mcp/dist/memory-ui-scripts.js

@@ -579,96 +579,7 @@ export function renderProjectReferenceEnhancementScript(authToken) {
   })();`;
 }
 export function renderReviewQueueEditSyncScript() {
-    return `(function() {
-    function normalizeQueueText(raw) {
-      return String(raw == null ? '' : raw)
-        .replace(/\\r\\n?/g, '\\n')
-        .replace(/\\0/g, ' ')
-        .replace(/<!--[\\s\\S]*?-->/g, ' ')
-        .replace(/\\\\[nrt]/g, ' ')
-        .replace(/\\\\\"/g, '"')
-        .replace(/\\\\\\\\/g, '\\\\')
-        .replace(/\\n+/g, ' ')
-        .replace(/\\s+/g, ' ')
-        .trim();
-    }
-
-    function rebuildEditedQueueLine(line, newText) {
-      var dateMatch = String(line || '').match(/^- \\[(\\d{4}-\\d{2}-\\d{2})\\]/);
-      var confidenceMatch = String(line || '').match(/\\[confidence\\s+([01](?:\\.\\d+)?)\\]/i);
-      var normalizedText = normalizeQueueText(newText);
-      var date = dateMatch ? dateMatch[1] : new Date().toISOString().slice(0, 10);
-      var confidencePart = confidenceMatch
-        ? ' [confidence ' + Number(confidenceMatch[1]).toFixed(2) + ']'
-        : '';
-      return {
-        text: normalizedText,
-        line: '- [' + date + '] ' + normalizedText + confidencePart
-      };
-    }
-
-    function escapeHtml(text) {
-      return String(text)
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-    }
-
-    function syncEditedCard(card, project, nextLine, nextText) {
-      if (!card || !project || !nextLine) return;
-      card.setAttribute('data-key', project + '\\\\x00' + nextLine);
-      card.setAttribute('data-project', project);
-      var approveBtn = card.querySelector('.btn-approve');
-      if (approveBtn) {
-        approveBtn.setAttribute('data-project', project);
-        approveBtn.setAttribute('data-line', nextLine);
-      }
-      var rejectBtn = card.querySelector('.btn-reject');
-      if (rejectBtn) {
-        rejectBtn.setAttribute('data-project', project);
-        rejectBtn.setAttribute('data-line', nextLine);
-      }
-      var editForm = card.querySelector('.review-card-edit form');
-      if (editForm) {
-        editForm.setAttribute('data-project', project);
-        editForm.setAttribute('data-line', nextLine);
-      }
-      var editTextarea = card.querySelector('textarea[name="new_text"]');
-      if (editTextarea) editTextarea.value = nextText;
-    }
-
-    function maybeSyncEditedCard(card, project, line, newText, attemptsLeft) {
-      if (!card || !project) return;
-      var rebuilt = rebuildEditedQueueLine(line, newText);
-      var textEl = card.querySelector('.review-card-text');
-      var editSection = card.querySelector('.review-card-edit');
-      if (editSection && editSection.style.display === 'none') {
-        if (textEl) textEl.innerHTML = escapeHtml(rebuilt.text);
-        syncEditedCard(card, project, rebuilt.line, rebuilt.text);
-        return;
-      }
-      if (attemptsLeft > 0) {
-        setTimeout(function() {
-          maybeSyncEditedCard(card, project, line, newText, attemptsLeft - 1);
-        }, 150);
-      }
-    }
-
-    document.addEventListener('submit', function(event) {
-      var form = event.target;
-      if (!form || typeof form.getAttribute !== 'function' || typeof form.querySelector !== 'function') return;
-      if (!form.closest || !form.closest('.review-card-edit')) return;
-      var project = form.getAttribute('data-project') || '';
-      var line = form.getAttribute('data-line') || '';
-      var textarea = form.querySelector('textarea[name="new_text"]');
-      var newText = textarea ? textarea.value : '';
-      var card = form.closest('.review-card');
-      setTimeout(function() {
-        maybeSyncEditedCard(card, project, line, newText, 20);
-      }, 0);
-    }, true);
-  })();`;
+    return "";
 }
 export function renderTasksAndSettingsScript(authToken) {
     return `(function() {
@@ -1342,9 +1253,6 @@ export function renderEventWiringScript() {
   var highlightBtn = document.getElementById('highlight-only-btn');
   if (highlightBtn) highlightBtn.addEventListener('click', function() { toggleHighlightOnly(this); });
 
-  var selectAllCheckbox = document.getElementById('review-select-all-checkbox');
-  if (selectAllCheckbox) selectAllCheckbox.addEventListener('change', function() { toggleSelectAll(this.checked); });
-
   // --- Graph controls ---
   var graphZoomIn = document.getElementById('graph-zoom-in');
   if (graphZoomIn) graphZoomIn.addEventListener('click', function() { graphZoom(1.2); });
@@ -1363,16 +1271,6 @@ export function renderEventWiringScript() {
   var sessionsFilterProject = document.getElementById('sessions-filter-project');
   if (sessionsFilterProject) sessionsFilterProject.addEventListener('change', function() { loadSessions(); });
 
-  // --- Batch bar ---
-  var batchApproveBtn = document.getElementById('batch-approve-btn');
-  if (batchApproveBtn) batchApproveBtn.addEventListener('click', function() { batchAction('approve'); });
-  var batchRejectBtn = document.getElementById('batch-reject-btn');
-  if (batchRejectBtn) batchRejectBtn.addEventListener('click', function() { batchAction('reject'); });
-  var batchTagSelect = document.getElementById('batch-tag-select');
-  if (batchTagSelect) batchTagSelect.addEventListener('change', function() { if(this.value){batchActionByTag(this.value,'approve');this.value='';} });
-  var batchCancelBtn = document.getElementById('batch-cancel-btn');
-  if (batchCancelBtn) batchCancelBtn.addEventListener('click', function() { clearBatchSelection(); });
-
   // --- Command palette ---
   var cmdpal = document.getElementById('cmdpal');
   if (cmdpal) cmdpal.addEventListener('click', function(e) { closeCmdPal(e); });

package/mcp/dist/memory-ui-server.js

@@ -5,7 +5,7 @@ import * as fs from "fs";
 import * as path from "path";
 import * as querystring from "querystring";
 import { spawn, execFileSync } from "child_process";
-import { PhrenError, computePhrenLiveStateToken, getProjectDirs, } from "./shared.js";
+import { computePhrenLiveStateToken, getProjectDirs, } from "./shared.js";
 import { editFinding, readReviewQueue, removeFinding, readFindings, addFinding as addFindingStore, readTasksAcrossProjects, addTask as addTaskStore, completeTask as completeTaskStore, removeTask as removeTaskStore, TASKS_FILENAME, } from "./data-access.js";
 import { isValidProjectName, errorMessage } from "./utils.js";
 import { readInstallPreferences, writeInstallPreferences, writeGovernanceInstallPreferences } from "./init-preferences.js";
@@ -251,40 +251,6 @@ function readProjectQueue(phrenPath, profile) {
     }
     return items;
 }
-function runQueueAction(_phrenPath, pathname, _project, _line, _newText) {
-    if (pathname === "/api/approve" || pathname === "/approve")
-        return { ok: false, error: "Queue approval has been removed. Use the review queue as a read-only reference." };
-    if (pathname === "/api/reject" || pathname === "/reject")
-        return { ok: false, error: "Queue rejection has been removed. Use the review queue as a read-only reference." };
-    if (pathname === "/api/edit" || pathname === "/edit")
-        return { ok: false, error: "Queue editing has been removed. Use the review queue as a read-only reference." };
-    return { ok: false, error: "unknown action" };
-}
-function handleLegacyQueueActionResult(res, result) {
-    if (result.ok) {
-        res.writeHead(302, { location: "/" });
-        res.end();
-        return;
-    }
-    const code = result.code;
-    if (code === PhrenError.PERMISSION_DENIED || result.error.includes("requires maintainer/admin role")) {
-        res.writeHead(403, { "content-type": "text/plain; charset=utf-8" });
-        res.end(result.error);
-        return;
-    }
-    if (code === PhrenError.NOT_FOUND) {
-        res.writeHead(404, { "content-type": "text/plain; charset=utf-8" });
-        res.end(result.error);
-        return;
-    }
-    if (code === PhrenError.INVALID_PROJECT_NAME || code === PhrenError.EMPTY_INPUT) {
-        res.writeHead(400, { "content-type": "text/plain; charset=utf-8" });
-        res.end(result.error);
-        return;
-    }
-    res.writeHead(500, { "content-type": "text/plain; charset=utf-8" });
-    res.end(result.error);
-}
 function parseTopicsPayload(raw) {
     try {
         const parsed = JSON.parse(raw);
@@ -1024,53 +990,6 @@ export function createWebUiHttpServer(phrenPath, renderPage, profile, opts) {
             res.end(JSON.stringify({ ok: true, token }));
             return;
         }
-        if (req.method === "POST" && ["/api/approve", "/api/reject", "/api/edit"].includes(pathname)) {
-            void readFormBody(req, res).then((parsed) => {
-                if (!parsed)
-                    return;
-                if (!requirePostAuth(req, res, url, parsed, authToken, true))
-                    return;
-                if (!requireCsrf(res, parsed, csrfTokens, true))
-                    return;
-                const project = String(parsed.project || "");
-                const line = String(parsed.line || "");
-                const newText = String(parsed.new_text || "");
-                if (!project || !line || !isValidProjectName(project)) {
-                    res.writeHead(400, { "content-type": "application/json" });
-                    res.end(JSON.stringify({ ok: false, error: "Missing or invalid project/line" }));
-                    return;
-                }
-                const result = runQueueAction(phrenPath, pathname, project, line, newText);
-                res.writeHead(200, { "content-type": "application/json" });
-                res.end(JSON.stringify({ ok: result.ok, error: result.ok ? undefined : result.error }));
-            });
-            return;
-        }
-        if (req.method === "POST" && ["/approve", "/reject", "/edit"].includes(pathname)) {
-            void readFormBody(req, res).then((parsed) => {
-                if (!parsed)
-                    return;
-                if (!requirePostAuth(req, res, url, parsed, authToken))
-                    return;
-                if (!requireCsrf(res, parsed, csrfTokens))
-                    return;
-                const project = String(parsed.project || "");
-                const line = String(parsed.line || "");
-                const newText = String(parsed.new_text || "");
-                if (!project || !line) {
-                    res.writeHead(400, { "content-type": "text/plain; charset=utf-8" });
-                    res.end("Missing project/line");
-                    return;
-                }
-                if (!isValidProjectName(project)) {
-                    res.writeHead(400, { "content-type": "text/plain; charset=utf-8" });
-                    res.end("Invalid project name");
-                    return;
-                }
-                handleLegacyQueueActionResult(res, runQueueAction(phrenPath, pathname, project, line, newText));
-            });
-            return;
-        }
         // GET /api/findings/:project — list findings for a project
         if (req.method === "GET" && pathname.startsWith("/api/findings/")) {
             const project = decodeURIComponent(pathname.slice("/api/findings/".length));

package/mcp/dist/phren-paths.js

@@ -134,7 +134,7 @@ let cachedPhrenPath;
 let cachedPhrenPathKey;
 export function findPhrenPath() {
     const cacheKey = [
-        ((process.env.PHREN_PATH || process.env.PHREN_PATH) ?? ""),
+        ((process.env.PHREN_PATH) ?? ""),
         process.env.HOME ?? "",
         process.env.USERPROFILE ?? "",
         process.cwd(),
@@ -142,7 +142,7 @@ export function findPhrenPath() {
     if (cachedPhrenPath !== undefined && cachedPhrenPathKey === cacheKey)
         return cachedPhrenPath;
     cachedPhrenPathKey = cacheKey;
-    const envVal = (process.env.PHREN_PATH || process.env.PHREN_PATH)?.trim();
+    const envVal = (process.env.PHREN_PATH)?.trim();
     if (envVal) {
         const resolved = path.resolve(expandHomePath(envVal));
         cachedPhrenPath = isPhrenRootCandidate(resolved) ? resolved : null;
@@ -170,7 +170,7 @@ export function ensurePhrenPath() {
     });
     cachedPhrenPath = defaultPath;
     cachedPhrenPathKey = [
-        ((process.env.PHREN_PATH || process.env.PHREN_PATH) ?? ""),
+        ((process.env.PHREN_PATH) ?? ""),
         process.env.HOME ?? "",
         process.env.USERPROFILE ?? "",
         process.cwd(),

package/mcp/dist/shell-input.js

@@ -274,14 +274,6 @@ export async function executePalette(host, input) {
         host.setMessage("  Usage: :find add <text> | :find remove <id|match>");
         return;
     }
-    if (command === "mq") {
-        const project = host.ensureProjectSelected();
-        if (!project)
-            return;
-        const action = (parts[1] || "").toLowerCase();
-        host.setMessage("  Queue approve/reject/edit have been removed. The review queue is now read-only.");
-        return;
-    }
     if (command === "machine" && parts[1]?.toLowerCase() === "map") {
         if (parts.length < 4) {
             host.setMessage("  Usage: :machine map <hostname> <profile>");
@@ -409,7 +401,7 @@ export async function executePalette(host, input) {
                 if (queueResult.ok) {
                     const conflictItems = queueResult.data.filter((q) => q.section === "Conflicts");
                     if (conflictItems.length) {
-                        lines.push(`  ${style.yellow(`${conflictItems.length} conflict(s) in Review Queue`)}  (:mq approve|reject)`);
+                        lines.push(`  ${style.yellow(`${conflictItems.length} conflict(s) in Review Queue`)}  (inspect in :review queue)`);
                     }
                 }
             }
@@ -473,8 +465,7 @@ function suggestCommand(input) {
     const known = [
         "help", "projects", "tasks", "task", "findings", "review queue", "machines", "health",
         "open", "search", "add", "complete", "move", "reprioritize", "pin", "unpin", "context",
-        "work next", "tidy", "find add", "find remove", "mq approve", "mq reject",
-        "mq edit", "machine map", "profile add-project", "profile remove-project",
+        "work next", "tidy", "find add", "find remove", "machine map", "profile add-project", "profile remove-project",
         "run fix", "relink", "rerun hooks", "update", "govern", "consolidate",
         "undo", "diff", "conflicts", "reset",
     ];
@@ -494,7 +485,7 @@ export function completeInput(line, phrenPath, profile, state) {
         ":projects", ":tasks", ":task", ":findings", ":review queue", ":machines", ":health",
         ":open", ":search", ":add", ":complete", ":move", ":reprioritize", ":pin",
         ":unpin", ":context", ":work next", ":tidy", ":find add", ":find remove",
-        ":mq approve", ":mq reject", ":mq edit", ":machine map",
+        ":machine map",
         ":profile add-project", ":profile remove-project",
         ":run fix", ":relink", ":rerun hooks", ":update", ":govern", ":consolidate",
         ":undo", ":diff", ":conflicts", ":reset", ":help",
@@ -528,15 +519,6 @@ export function completeInput(line, phrenPath, profile, state) {
             ...result.data.items.Done,
         ].map((item) => `:${cmd} ${item.id}`);
     }
-    if (cmd === "mq" && ["approve", "reject", "edit"].includes((parts[1] || "").toLowerCase())) {
-        const project = state.project;
-        if (!project)
-            return [];
-        const result = readReviewQueue(phrenPath, project);
-        if (!result.ok)
-            return [];
-        return result.data.map((item) => `:mq ${parts[1].toLowerCase()} ${item.id}`);
-    }
     if (cmd === "find" && (parts[1] || "").toLowerCase() === "remove") {
         const project = state.project;
         if (!project)
@@ -640,7 +622,7 @@ async function activateSelected(host) {
             break;
         case "Review Queue":
             if (item.text) {
-                host.setMessage(`  ${style.dim(item.id ?? "")}  ${item.text}  ${style.dim("[ a approve · d reject ]")}`);
+                host.setMessage(`  ${style.dim(item.id ?? "")}  ${item.text}  ${style.dim("[ read-only ]")}`);
             }
             break;
         case "Skills":

package/mcp/dist/shell-render.js

@@ -182,7 +182,7 @@ export function shellHelpText() {
         `  ${style.bold("Projects")}     ${k("↵")} ${d("open project tasks")}  ${k("i")} ${d("cycle intro mode")}`,
         `  ${style.bold("Tasks")}        ${k("a")} ${d("add task")}  ${k("d")} ${d("toggle active/queue")}  ${k("↵")} ${d("mark complete")}`,
         `  ${style.bold("Fragments")}   ${k("a")} ${d("tell phren")}  ${k("d")} ${d("delete selected")}`,
-        `  ${style.bold("Review Queue")} ${k("a")} ${d("approve")}  ${k("r")} ${d("reject")}  ${k("e")} ${d("edit")}`,
+        `  ${style.bold("Review Queue")} ${k("↵")} ${d("inspect selected item")}  ${d("(read-only)")}`,
         `  ${style.bold("Skills")}       ${k("t")} ${d("toggle enabled")}  ${k("d")} ${d("remove")}`,
         "",
         hdr("Palette commands  (:cmd)"),
@@ -195,7 +195,7 @@ export function shellHelpText() {
         `  ${cmd(":pin <id>")}  ${cmd(":unpin <id>")}  ${cmd(":work next")}  ${cmd(":tidy [keep]")}`,
         `  ${cmd(":find add <text>")}  ${cmd(":find remove <id|match>")}`,
         `  ${cmd(":intro always|once-per-version|off")}`,
-        `  ${cmd(":mq approve|reject|edit <id>")}`,
+        `  ${cmd(":review queue")}                              ${d("inspect review queue (read-only)")}`,
         `  ${cmd(":govern")}  ${cmd(":consolidate")}  ${cmd(":search <query>")}`,
         `  ${cmd(":undo")}  ${cmd(":diff")}  ${cmd(":conflicts")}  ${cmd(":reset")}`,
         `  ${cmd(":run fix")}  ${cmd(":relink")}  ${cmd(":rerun hooks")}  ${cmd(":update")}`,

package/mcp/dist/shell-view.js

@@ -57,7 +57,6 @@ function renderBottomBar(state, navMode, inputCtx, inputBuf) {
             add: "add task",
             "learn-add": "add finding",
             "skill-add": "new skill name",
-            "mq-edit": "edit Review Queue item",
         };
         const label = labels[inputCtx] || inputCtx;
         return `${sep}\n  ${style.boldCyan(label + " ›")} ${inputBuf}${style.cyan("█")}`;
@@ -66,7 +65,7 @@ function renderBottomBar(state, navMode, inputCtx, inputBuf) {
         Projects: [`${k("↵")} ${d("open project")}`, `${k("i")} ${d("intro mode")}`],
         Tasks: [`${k("a")} ${d("add")}`, `${k("↵")} ${d("mark done")}`, `${k("d")} ${d("toggle active")}`],
         Findings: [`${k("a")} ${d("add")}`, `${k("d")} ${d("remove")}`],
-        "Review Queue": [`${k("a")} ${d("keep")}`, `${k("d")} ${d("discard")}`, `${k("e")} ${d("edit")}`],
+        "Review Queue": [`${k("↵")} ${d("inspect")}`],
         Skills: [`${k("t")} ${d("toggle")}`, `${k("d")} ${d("remove")}`],
         Hooks: [`${k("a")} ${d("enable")}`, `${k("d")} ${d("disable")}`],
         Health: [`${k("↑↓")} ${d("scroll")}`, `${k("esc")} ${d("back")}`],

package/mcp/dist/shell.js

@@ -162,11 +162,6 @@ export class PhrenShell {
                 this.setMessage(`  Created skill "${name}" — edit ${dest}`);
                 break;
             }
-            case "mq-edit": {
-                this.setMessage("  Queue editing has been removed. The review queue is now read-only.");
-                this.inputMqId = "";
-                break;
-            }
         }
     }
     // ── Raw key handling ───────────────────────────────────────────────────

package/mcp/dist/tool-registry.js

@@ -12,6 +12,7 @@ const CATEGORY_BY_MODULE = {
     "mcp-ops": "Operations and review",
     "mcp-skills": "Skills management",
     "mcp-hooks": "Hooks management",
+    "mcp-config": "Configuration",
     "mcp-extract": "Extraction",
 };
 const MODULE_ORDER = Object.keys(CATEGORY_BY_MODULE);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phren/cli",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "description": "Knowledge layer for AI agents. Claude remembers you. Phren remembers your work.",
   "type": "module",
   "bin": {
@@ -8,6 +8,7 @@
   },
   "files": [
     "mcp/dist",
+    "icon.svg",
     "starter",
     "skills"
   ],

package/skills/docs.md

@@ -0,0 +1,170 @@
+---
+name: docs
+description: Update and verify all phren documentation surfaces after code changes.
+dependencies:
+  - git
+---
+# phren-docs - Documentation accuracy check and update
+
+> Keep all phren documentation surfaces in sync with the code after any change.
+
+Invoke this after adding tools, changing CLI commands, bumping versions, or editing hooks. It walks every documentation surface, checks what's stale, and updates `docs/documentation.html` (the canonical public-facing reference).
+
+## When to run
+
+- After adding, removing, or renaming MCP tools
+- After changing CLI commands or their flags
+- After bumping the version number
+- After changing hook names, events, or behavior
+- Before publishing to npm
+- When the user says "update the docs" or "check the docs"
+
+## Documentation surfaces
+
+| File | What it contains | What to check |
+|------|-----------------|---------------|
+| `README.md` | Project overview, install steps, quick-start | Tool count, version badge, CLI examples |
+| `CLAUDE.md` | In-repo instructions for Claude | Tool count (heading says "MCP Tools (N)"), CLI command list, key file list |
+| `AGENTS.md` | Agent-facing instructions | Tool count, hook table, CLI commands |
+| `CONTRIBUTING.md` | Dev setup, build/test commands | `npm run build`, `npm test`, publish steps |
+| `CHANGELOG.md` | Release history | Latest version matches `package.json` version |
+| `docs/index.html` | GitHub Pages landing page | Install commands, version references, feature list |
+| `docs/documentation.html` | Full reference doc (primary surface) | Tool count, CLI commands, hook table, env vars table |
+| `docs/api-reference.md` | API / tool reference | Tool signatures, return shapes |
+| `docs/architecture.md` | Data-flow diagrams and architecture | File paths, hook names, flow descriptions |
+| `docs/faq.md` | Common questions and answers | References to commands, file paths |
+| `docs/llms.txt` | Short LLM-friendly summary | Tool count, version, install command |
+| `docs/llms-full.txt` | Full LLM-readable reference | Complete tool list, CLI commands, env vars |
+| `mcp/README.md` | MCP server README | Tool count, server entry point |
+| `vscode-extension/README.md` | VS Code extension README | Feature list, commands |
+
+## Step-by-step
+
+### 1. Read the source of truth
+
+The source of truth for counts and signatures lives in the code, not the docs:
+
+```bash
+# Count exported MCP tools in index.ts
+grep -c 'server\.tool(' mcp/src/index.ts
+
+# Current version
+node -p "require('./package.json').version"
+
+# CLI commands (scan cli.ts / index.ts for subcommand registrations)
+grep 'program\.' mcp/src/cli.ts | head -40
+```
+
+Record: **tool count**, **version**, and the list of top-level CLI subcommands.
+
+### 2. Check each documentation surface
+
+For each surface in the table above:
+
+1. Read the file
+2. Find every place it mentions a tool count (e.g. "65 tools", "MCP Tools (65)")
+3. Find every place it mentions the version number
+4. Find every CLI command listing
+5. Find the hook table (event names, what each hook does)
+6. Note any stale references (old file paths, renamed tools, removed commands)
+
+### 3. Spot-check critical numbers
+
+These numbers appear in multiple files and must all agree:
+
+| Item | Where to verify |
+|------|----------------|
+| MCP tool count | `mcp/src/index.ts` — count `server.tool(` calls |
+| CLI subcommand count | `mcp/src/cli.ts` — count `program.command(` calls |
+| Version | `package.json` → `version` field |
+| Hook events | `mcp/src/init.ts` — look for hook registration |
+
+Run `/parity` if it is installed to automate numeric cross-checking across surfaces.
+
+### 4. Update `docs/documentation.html`
+
+This is the primary public reference. It must reflect the current state of the code.
+
+Sections to verify and update:
+
+- **Tool reference table**: every tool name, description, and parameter signature
+- **CLI commands block**: every `phren <subcommand>` with flags and description
+- **Hooks table**: event name, what it runs, what it does
+- **Environment variables table**: variable name, default, description
+- **Version number** in the page title, install command snippets, and any badges
+- **Tool count** in any summary sentence (e.g. "65 MCP tools")
+
+When updating the HTML:
+- Keep existing structure and CSS classes — do not restructure the page
+- Update text content only; do not rewrite layout
+- Preserve the `<details>` blocks for env var categories if they exist
+
+### 5. Update `docs/llms.txt` and `docs/llms-full.txt`
+
+These files are consumed by LLMs directly. Keep them plain text with no HTML.
+
+`llms.txt` — short summary (under 60 lines):
+- Tool count
+- Install command
+- One-line description of what phren does
+
+`llms-full.txt` — comprehensive reference:
+- All MCP tool signatures with descriptions
+- All CLI commands
+- All environment variables
+- Directory structure
+
+### 6. Update `CLAUDE.md` (in-repo)
+
+The heading `## MCP Tools (N)` must match the actual tool count. Update N if it changed.
+
+The CLI commands block must list every top-level command. Add or remove lines to match.
+
+### 7. Sync version references
+
+`CHANGELOG.md`: the top entry's version must match `package.json`. If a new version was bumped but the changelog has no entry yet, note it — do not fabricate one.
+
+`README.md` and `docs/index.html`: update any hardcoded version strings (badges, `npm install @phren/cli@X.Y.Z`, etc.).
+
+### 8. Report
+
+After reviewing and updating, output:
+
+```
+phren-docs
+
+Version: 0.0.8
+MCP tools: 65
+CLI subcommands: 22
+
+Surfaces checked: 14
+
+Changes made:
+  - docs/documentation.html: updated tool count (64→65), added new env var PHREN_X
+  - CLAUDE.md: updated MCP Tools heading (64→65)
+  - docs/llms-full.txt: added PHREN_X to env vars section
+
+No changes needed:
+  - README.md: version and tool count already correct
+  - CHANGELOG.md: top entry matches package.json version
+  - mcp/README.md: tool count correct
+
+Warnings:
+  - docs/faq.md: references `phren init` — command was renamed to `phren link` in v0.0.7
+```
+
+List every file checked. Be specific about what changed and what line/section.
+
+## What not to do
+
+- Do not restructure or reformat documentation for style — only fix accuracy
+- Do not add new sections or features to the docs without user direction
+- Do not fabricate changelog entries for unreleased versions
+- Do not silently skip a surface because it looks "probably fine" — check all of them
+- Do not guess tool counts — always derive from `grep` on the source file
+
+## Related skills
+
+- `/parity`: numeric cross-check across all documentation surfaces
+- `/consolidate`: surface cross-project patterns before updating architecture docs
+- `/discover`: find gaps in project documentation