klypix-mcp 1.64.0 → 1.65.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "klypix-mcp",
-  "version": "1.64.0",
+  "version": "1.65.0",
   "description": "Shared project brain and MCP coordination server for multi-agent coding.",
   "type": "module",
   "license": "Apache-2.0",
@@ -79,7 +79,7 @@
     "test:project-graph": "node test/project-graph.mjs",
     "bench": "node bin/klypix-mcp.mjs bench",
     "test:bench": "node test/bench.mjs",
-    "test": "node test/publish-verdict.mjs && node test/project-graph.mjs && node test/project-map-cli.mjs && node test/mcp-auto-update.mjs && node test/mcp-supervisor.mjs && node test/runtime-inspector.mjs && node test/codex-hooks.mjs && node test/agent-presence.mjs && node test/intent-guard.mjs && node test/git-capture-install.mjs && node test/brain-history.mjs && node test/brain-graveyard.mjs && node test/finding-routing.mjs && node test/finding-routing-hook.mjs && node test/presence-relay.mjs && node test/context-gateway.mjs && node test/conformance.mjs && node test/brain-doctor.mjs && node test/version-currency.mjs && node test/ship-capture.mjs && node test/lane-message.mjs && node test/brain-quality.mjs && node test/brain-connect-orphans.mjs && node test/brief-and-recall.mjs && node test/layout-cluster.mjs && node test/brain-ask.mjs && node test/field-report-2026-07-04.mjs && node test/autoprop.mjs && node test/overlay-recency-2026-07-12.mjs && node test/brain-challenge.mjs && node test/brain-lens.mjs && node test/brain-kind.mjs && node test/rule-drafts.mjs && node test/claim-engine.mjs && node test/skill-staleness.mjs && node test/canvas-view.mjs && node test/status-completeness.mjs && node test/semantic-gate.mjs && node test/memory-runtime.mjs && node test/semantic-cache.mjs && node test/decay-status.mjs && node test/decay-hook.mjs && node test/evidence-anchors.mjs && node test/presence-visibility.mjs && node test/merge-brains.mjs && node test/concurrent-writes.mjs && node test/lock-interop.mjs && node test/a2a-smoke.mjs && node test/cli-args.mjs && node test/format-guard.mjs && node test/git-tools.mjs && node test/uninstall.mjs",
+    "test": "node test/publish-verdict.mjs && node test/project-graph.mjs && node test/project-map-cli.mjs && node test/mcp-auto-update.mjs && node test/mcp-supervisor.mjs && node test/runtime-inspector.mjs && node test/codex-hooks.mjs && node test/agent-presence.mjs && node test/intent-guard.mjs && node test/git-capture-install.mjs && node test/brain-history.mjs && node test/brain-graveyard.mjs && node test/archived-visibility.mjs && node test/finding-routing.mjs && node test/finding-routing-hook.mjs && node test/presence-relay.mjs && node test/context-gateway.mjs && node test/conformance.mjs && node test/brain-doctor.mjs && node test/version-currency.mjs && node test/ship-capture.mjs && node test/lane-message.mjs && node test/brain-quality.mjs && node test/brain-connect-orphans.mjs && node test/brief-and-recall.mjs && node test/layout-cluster.mjs && node test/brain-ask.mjs && node test/field-report-2026-07-04.mjs && node test/autoprop.mjs && node test/overlay-recency-2026-07-12.mjs && node test/brain-challenge.mjs && node test/brain-lens.mjs && node test/brain-kind.mjs && node test/rule-drafts.mjs && node test/claim-engine.mjs && node test/skill-staleness.mjs && node test/canvas-view.mjs && node test/status-completeness.mjs && node test/semantic-gate.mjs && node test/memory-runtime.mjs && node test/semantic-cache.mjs && node test/decay-status.mjs && node test/decay-hook.mjs && node test/evidence-anchors.mjs && node test/presence-visibility.mjs && node test/merge-brains.mjs && node test/concurrent-writes.mjs && node test/lock-interop.mjs && node test/a2a-smoke.mjs && node test/cli-args.mjs && node test/format-guard.mjs && node test/git-tools.mjs && node test/uninstall.mjs",
     "test:memory": "node test/memory-runtime.mjs",
     "test:memory:soak": "node --expose-gc test/memory-soak.mjs",
     "runtime": "node bin/klypix-runtime.mjs"

package/src/klypix-core.mjs

@@ -264,11 +264,17 @@ export async function opSearchCanvases({ vault, query }) {
       hit(c.text) ||
       (c.tags || []).some(t => hit('#' + t)));
     if (nameMatch || matched.length) {
-      const head = `## ${rel} — "${struct.title}" · ${struct.counts.cards} cards, ${struct.counts.connections} connections${nameMatch && !matched.length ? '  (name/title match)' : ''}`;
+      // Matching stays recall-first (an archived card CAN be the right answer to
+      // "what did we try?"), but an archived hit is now labelled. Unlabelled, a
+      // superseded or retired decision read exactly like a current one.
+      const isArchived = (c) => /^archive$/i.test(c.area || '');
+      const n = struct.counts;
+      const head = `## ${rel} — "${struct.title}" · ${n.live ?? n.cards} live cards${n.archived ? `, ${n.archived} archived` : ''}, ${n.connections} connections${nameMatch && !matched.length ? '  (name/title match)' : ''}`;
       const body = matched.slice(0, 8).map(c => {
         const pos = (c.pos && c.pos.x != null) ? ` @(${Math.round(c.pos.x)},${Math.round(c.pos.y)})` : '';
         const tags = (c.tags && c.tags.length) ? ' ' + c.tags.map(t => '#' + t).join(' ') : '';
-        return `- [${c.type}] "${c.title || '(card)'}" (${c.id})${pos}${tags}\n    ${String(c.text || '').replace(/\s+/g, ' ').slice(0, 240)}`;
+        const arch = isArchived(c) ? ' ⛔ archived' : '';
+        return `- [${c.type}] "${c.title || '(card)'}" (${c.id})${pos}${tags}${arch}\n    ${String(c.text || '').replace(/\s+/g, ' ').slice(0, 240)}`;
       }).join('\n');
       hits.push(matched.length ? `${head}\n${body}` : head);
     }

package/src/klypix-format.mjs

@@ -326,7 +326,20 @@ export async function parseKlypix(buffer) {
     const struct = {
         title: manifest?.title || canvas.title || 'Untitled',
         format: isV4 ? 'klypix-v4' : `legacy-v${canvas.version ?? '?'}`,
-        counts: { cards: cards.length, connections: connections.length, assets: assetPaths.length },
+        // `cards` counts EVERY item in `order` — containers and archived cards
+        // included — and several headers print it raw, so a brain whose brief
+        // describes 1,574 live cards announced "1981 cards". Keeping it (readers
+        // depend on it) and adding the honest breakdown beside it, so a surface
+        // that means "how much is live here" can say so.
+        counts: {
+            cards: cards.length,
+            connections: connections.length,
+            assets: assetPaths.length,
+            containers: cards.filter(c => c?.type === 'container').length,
+            archived: cards.filter(c => c?.type !== 'container' && /^archive$/i.test(
+                (c?.parentId ? cardTitle(items[c.parentId]) : '') || '')).length,
+            get live() { return this.cards - this.containers - this.archived; },
+        },
         cards: cards.map(it => ({
             id: it.id, type: it.type,
             title: cardTitle(it),
@@ -5130,12 +5143,22 @@ export function lensToMarkdown(d, view = 'all') {
 
 /** Render a parsed struct to the markdown brief (shared by read-klypix + MCP). */
 export function structToMarkdown(struct, { assetsDir } = {}) {
+    // Archived cards were rendered here IDENTICALLY to live ones — no marker, and
+    // `area` was never printed at all — so read_canvas served superseded,
+    // consolidated and deleted-then-archived decisions as current fact. This is
+    // the surface an agent reads to learn a project, which makes it the worst
+    // place for that. They stay in the output (this is a whole-canvas dump, and
+    // history is legitimately part of it) but they are now labelled.
+    const isArchived = (c) => /^archive$/i.test(c.area || '');
     const L = [];
+    const n = struct.counts;
     L.push(`# ${struct.title}`);
-    L.push(`*${struct.format} · ${struct.counts.cards} cards · ${struct.counts.connections} connections · ${struct.counts.assets} assets*\n`);
+    L.push(`*${struct.format} · ${n.live ?? n.cards} live cards${n.archived ? ` · ${n.archived} archived` : ''}${n.containers ? ` · ${n.containers} containers` : ''} · ${n.connections} connections · ${n.assets} assets*\n`);
+    if (n.archived) L.push(`> ⛔ ${n.archived} card(s) below are marked archived — superseded, consolidated or retired. Read them as history, not as the current state.\n`);
     L.push(`## Cards`);
     for (const c of struct.cards) {
-        L.push(`### ${c.title || `(${c.type})`}  \`${c.type}\``);
+        const archived = isArchived(c);
+        L.push(`### ${c.title || `(${c.type})`}  \`${c.type}\`${archived ? '  ⛔ archived' : ''}${c.area && !archived ? `  _[${c.area}]_` : ''}`);
         if (c.text) L.push(c.type === 'text' ? String(c.text).trim() : `→ ${c.text}`);
         const meta = [];
         if (c.links?.length) meta.push(`links: ${c.links.map(t => `[[${t}]]`).join(', ')}`);