@davesheffer/hunch 1.7.1 → 1.8.0

package/dist/mcp/server.js

@@ -29,6 +29,7 @@ import { nowData, wikiStatus, publicHome, readWikiManifestAt } from "../wiki/wik
 import { HUNCH_VERSION } from "../core/version.js";
 import { indexRepo } from "../extractors/indexer.js";
 import { liveForTopic, historyForTopic, rejectedForTopic, captureConflicts } from "../core/topics.js";
+import { pendingEscalations, policyEscalations } from "../core/escalations.js";
 import { issueCaptureToken as issueToken, consumeCaptureToken as consumeToken } from "../core/capturetoken.js";
 import { randomUUID } from "node:crypto";
 const ok = (text) => ({ content: [{ type: "text", text }] });
@@ -341,7 +342,38 @@ export function buildServer(root) {
         for (const r of roadmap)
             L.push(`  • ${r.title} (${r.id}${r.topic ? `, ${r.topic}` : ""}, since ${r.date})\n      ${r.note}`);
         if (pendingReview > 0)
-            L.push("", `${pendingReview} auto-drafted proposal(s) awaiting review — \`hunch review\`.`);
+            L.push("", `${pendingReview} legacy un-vouched draft(s) — \`hunch adopt-drafts\` auto-trusts them as advisory (new captures land trusted automatically).`);
+        const escalations = pendingEscalations(store.json.loadAll("decisions"));
+        if (escalations.length) {
+            L.push("", `⚖ ${escalations.length} decision(s) need the human's call — ASK inline (never queue): ${escalations.map((e) => e.question).join(" · ")}`);
+        }
+        return ok(L.join("\n"));
+    });
+    // -- hunch_escalations (the inline "ask the human" surface) -----------------
+    // Captured memory auto-trusts; this returns ONLY what the graph can't resolve
+    // itself, framed as questions to raise in conversation: topic conflicts, plus the
+    // Constitution's human moments (a candidate awaiting review, a proposed policy
+    // whose activation is a human call — §59.5.3). Public store only — same
+    // jurisdiction rule as hunch_now (an assistant may paste it). Client-agnostic
+    // (con_e04226bd05): no Claude-specific behavior.
+    server.registerTool("hunch_escalations", {
+        title: "Decisions the human must make now (ask inline, not a queue)",
+        description: "The rare decisions the graph cannot resolve on its own — surfaced so you ASK THE USER in the prompt at the moment, then act. Auto-captured memory is trusted automatically and never appears here; this returns topic conflicts (>1 live decision for one topic) and Constitution human moments (candidate policies awaiting review, proposed policies awaiting an activation decision). Normally empty. Raise each question with the user; do NOT decide it for them — an entry is a question, never an approval. Public store only.",
+        inputSchema: {},
+    }, async () => {
+        const items = pendingEscalations(store.json.loadAll("decisions"));
+        try {
+            items.push(...policyEscalations(new ConstitutionService(store, root).list({ publicOnly: true }).map((p) => ({ ...p, last_action: p.audit.at(-1)?.action ?? null }))));
+        }
+        catch { /* constitution unavailable — memory escalations still surface */ }
+        if (!items.length)
+            return ok("✓ Nothing needs a human decision — memory is auto-trusted and self-consistent.");
+        const L = [`${items.length} decision(s) need the human's call — ask each inline, don't decide it for them:`, ""];
+        for (const e of items) {
+            L.push(`⚖ ${e.question}`);
+            L.push(`   ${e.detail}`);
+            L.push(`   → ${e.resolution}`, "");
+        }
         return ok(L.join("\n"));
     });
     // -- hunch_wiki_status (generated-wiki freshness) ---------------------------

package/dist/synthesis/synthesize.js

@@ -149,7 +149,14 @@ export async function syncCommit(store, root, sha, opts = {}) {
         // Auto-synthesized decisions are un-anchored (topic null) — a topic is a human
         // act, never a machine guess. Preserve one an earlier human capture attached.
         topic: existing?.topic ?? null,
-        status: existing?.status === "accepted" ? "accepted" : "proposed",
+        // Auto-trust model: captured memory enters the graph LIVE (accepted = in-force
+        // advisory), never a `proposed` draft rotting in a review queue. It grounds and
+        // ranks immediately but NEVER blocks — the source stays llm_draft, so the veto /
+        // strict gates (which key on human_confirmed, not status) treat it as advisory
+        // and its tripwires stay unarmed until a human vouches INLINE (dec_a466655539
+        // intact). An existing human status (a deliberate `proposed` roadmap entry, or a
+        // `superseded` record) is preserved — re-sync never clobbers a human's intent.
+        status: existing?.status ?? "accepted",
         context: draft.context + constraintNote,
         decision: draft.decision,
         consequences: draft.consequences,

package/dist/wiki/graph.js

@@ -0,0 +1,301 @@
+/**
+ * Wiki memory graph — one self-contained, zero-dependency HTML page
+ * (<dir>/graph.html): the VISUAL KNOWLEDGE BASE over the wiki.
+ *
+ *   • Components as circles — sized by code, colored by fragility, ringed when
+ *     a blocking invariant guards them; dependencies as links.
+ *   • Repo docs as squares wired to the components they describe — freshness is
+ *     the color: grounded ✅ green, STALE ⚠ amber-red (pulsing), unverified ◻
+ *     gray. A stale doc's click opens its wiki-managed healed copy.
+ *   • An ACT-NOW panel: stale docs, drafts awaiting `hunch review`, unverified
+ *     docs — each row highlights its nodes; nothing is ever mutated from here.
+ *   • A time scrubber that replays the memory compounding, plus a this-week
+ *     pulse on components whose decisions are fresh.
+ *
+ * Same doctrine as every wiki page: a derived VIEW, deterministic inputs only.
+ * The embedded JSON is the page's freshness hash input; the force layout and
+ * the "this week" cutoff run client-side at view time and are presentation.
+ * No CDN, no fetch — works as a local file in the private overlay repo
+ * (con_547fff76bd).
+ */
+/** Pure assembly from already-computed wiki inputs — sorted for a stable hash. */
+export function assembleGraphData(kind, entries, decisionDates, repoDocs = [], adoptedPageByRel = new Map(), pendingReview = 0) {
+    const ids = new Set(entries.map((e) => e.pack.component.id));
+    const nodes = entries.map((e) => ({
+        id: e.pack.component.id,
+        name: e.pack.component.name,
+        slug: e.slug,
+        responsibility: e.pack.component.responsibility.slice(0, 160),
+        fragility: e.pack.component.fragility,
+        symbols: e.pack.symbols.length,
+        blocking: e.pack.constraints.filter((c) => c.severity === "blocking").length,
+        constraints: e.pack.constraints.length,
+        bugs: e.pack.bugs.length,
+        decisions: e.pack.decisions
+            .map((d) => (decisionDates.get(d.id) ?? "").slice(0, 10))
+            .filter(Boolean)
+            .sort(),
+    })).sort((a, b) => a.id.localeCompare(b.id));
+    const links = [];
+    for (const e of entries) {
+        for (const dep of e.pack.dependsOn) {
+            if (ids.has(dep.id))
+                links.push({ source: e.pack.component.id, target: dep.id });
+        }
+    }
+    links.sort((a, b) => a.source.localeCompare(b.source) || a.target.localeCompare(b.target));
+    const componentsByDoc = new Map();
+    for (const e of entries) {
+        for (const d of e.pack.docs) {
+            const list = componentsByDoc.get(d.path) ?? [];
+            list.push(e.pack.component.id);
+            componentsByDoc.set(d.path, list);
+        }
+    }
+    const docs = repoDocs
+        .filter((d) => d.status === "grounded" || d.status === "stale" || d.status === "unverified")
+        .map((d) => ({
+        rel: d.rel,
+        title: d.title.slice(0, 80),
+        status: d.status,
+        adopted: adoptedPageByRel.get(d.rel) ?? null,
+        components: [...new Set(componentsByDoc.get(d.rel) ?? [])].sort(),
+    }))
+        .sort((a, b) => a.rel.localeCompare(b.rel));
+    return { kind, nodes, links, docs, pendingReview };
+}
+export function renderGraphPage(data) {
+    const json = JSON.stringify(data).replace(/</g, "\\u003c");
+    const priv = data.kind === "private"
+        ? `<div class="banner">⚠ PRIVATE — rendered from the full graph including the private overlay; do not publish.</div>`
+        : "";
+    return `<!DOCTYPE html>
+<!-- hunch:wiki _graph — GENERATED memory graph by \`hunch wiki\`; do not edit by hand. -->
+<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>Hunch — memory graph</title>
+<style>
+  :root{--bg:#faf8f4;--fg:#26241f;--dim:#8a857b;--line:#c9c2b4;--panel:#f1ede4;--accent:#3a6b58;--warn:#b5544d;--stale:#c9822e}
+  @media (prefers-color-scheme: dark){:root{--bg:#16150f;--fg:#e8e4da;--dim:#8a857b;--line:#3d392f;--panel:#201e17;--accent:#5d9c82;--warn:#d0736b;--stale:#d99a45}}
+  html,body{margin:0;height:100%;background:var(--bg);color:var(--fg);font:14px/1.45 system-ui,sans-serif;overflow:hidden}
+  .banner{position:fixed;top:0;left:0;right:0;background:var(--warn);color:#fff;text-align:center;padding:3px 8px;font-size:12px;z-index:9}
+  header{position:fixed;top:${data.kind === "private" ? "26px" : "8px"};left:14px;z-index:5;pointer-events:none;max-width:44vw}
+  header h1{margin:0;font-size:16px}header p{margin:2px 0 0;font-size:12px;color:var(--dim)}
+  svg{width:100vw;height:100vh;display:block;cursor:grab}
+  svg.panning{cursor:grabbing}
+  .link{stroke:var(--line);stroke-width:1.2}
+  .doclink{stroke:var(--line);stroke-width:1;stroke-dasharray:2 3;opacity:.7}
+  .node circle.body{stroke:var(--bg);stroke-width:1.5;cursor:pointer}
+  .node circle.shield{fill:none;stroke:var(--warn);stroke-width:2;stroke-dasharray:3 3}
+  .node circle.mem{fill:var(--accent);opacity:.16;pointer-events:none}
+  .node circle.week{fill:none;stroke:var(--accent);stroke-width:2;opacity:.9}
+  .node text{font-size:11px;fill:var(--fg);pointer-events:none;text-anchor:middle}
+  .node.asleep{opacity:.22}
+  .doc rect{stroke:var(--bg);stroke-width:1.2;cursor:pointer;rx:3}
+  .doc.grounded rect{fill:#7fae9a}
+  .doc.unverified rect{fill:#9b968b}
+  .doc.stale rect{fill:var(--stale);animation:pulse 1.6s ease-in-out infinite}
+  @keyframes pulse{50%{opacity:.45}}
+  .doc text{font-size:10px;fill:var(--dim);pointer-events:none;text-anchor:middle}
+  .hi .body,.hi rect{stroke:var(--fg) !important;stroke-width:3 !important}
+  #tip{position:fixed;display:none;max-width:320px;background:var(--panel);border:1px solid var(--line);border-radius:6px;
+    padding:8px 10px;font-size:12px;pointer-events:none;z-index:8}
+  #tip b{display:block;margin-bottom:2px}
+  #bar{position:fixed;left:50%;transform:translateX(-50%);bottom:14px;background:var(--panel);border:1px solid var(--line);
+    border-radius:8px;padding:8px 14px;display:flex;gap:12px;align-items:center;z-index:6}
+  #bar input[type=range]{width:min(40vw,380px)}
+  #bar button{background:var(--accent);border:0;color:#fff;border-radius:4px;padding:3px 10px;cursor:pointer;font-size:13px}
+  #when{font-variant-numeric:tabular-nums;min-width:170px;text-align:left;font-size:12px;color:var(--dim)}
+  #act{position:fixed;right:14px;top:${data.kind === "private" ? "34px" : "14px"};width:250px;background:var(--panel);border:1px solid var(--line);
+    border-radius:8px;padding:10px 12px;font-size:12px;z-index:6}
+  #act h2{margin:0 0 6px;font-size:13px}
+  #act .row{display:flex;justify-content:space-between;gap:8px;padding:4px 6px;border-radius:5px;cursor:pointer;margin:2px -6px}
+  #act .row:hover{background:var(--bg)}
+  #act .row b{font-variant-numeric:tabular-nums}
+  #act .ok{color:var(--dim);cursor:default}
+  #act .hint{color:var(--dim);margin-top:6px;font-size:11px}
+  #act .warnc{color:var(--stale)}#act .badc{color:var(--warn)}
+  #legend{position:fixed;right:14px;bottom:14px;background:var(--panel);border:1px solid var(--line);border-radius:8px;
+    padding:8px 12px;font-size:11px;color:var(--dim);z-index:6}
+  #legend .sw{display:inline-block;width:9px;height:9px;border-radius:50%;margin-right:4px;vertical-align:-1px}
+  #legend .sq{display:inline-block;width:9px;height:9px;border-radius:2px;margin-right:4px;vertical-align:-1px}
+</style></head><body>
+${priv}
+<header><h1>🧠 Memory graph — the knowledge base</h1><p>Circles = components (size = code, color = fragility, dashed red ring = blocking invariant, halo = memory). Squares = docs, colored by TRUST: green grounded, pulsing amber STALE, gray unverified. Drag time to replay the compounding. Click anything to read it.</p></header>
+<svg id="s"><g id="view"><g id="links"></g><g id="nodes"></g></g></svg>
+<div id="tip"></div>
+<div id="act"><h2>⚡ Act now</h2><div id="actrows"></div></div>
+<div id="bar"><button id="play">▶ replay</button><input id="t" type="range" min="0" max="1000" value="1000"><span id="when"></span></div>
+<div id="legend"><span class="sw" style="background:#7fae9a"></span>calm <span class="sw" style="background:#c9a24a"></span>warm <span class="sw" style="background:#c96a4a"></span>fragile · <span class="sq" style="background:#7fae9a"></span>grounded <span class="sq" style="background:var(--stale)"></span>stale <span class="sq" style="background:#9b968b"></span>unverified</div>
+<script id="hunch-graph-data" type="application/json">${json}</script>
+<script>
+"use strict";
+const DATA = JSON.parse(document.getElementById("hunch-graph-data").textContent);
+const svg = document.getElementById("s"), view = document.getElementById("view");
+const W = innerWidth, H = innerHeight;
+const N = DATA.nodes.map((n, i) => ({ ...n, kind: "cmp",
+  x: W/2 + Math.cos(i / Math.max(1, DATA.nodes.length) * 2 * Math.PI) * Math.min(W,H)/3.4,
+  y: H/2 + Math.sin(i / Math.max(1, DATA.nodes.length) * 2 * Math.PI) * Math.min(W,H)/3.4,
+  vx: 0, vy: 0, r: 7 + Math.sqrt(n.symbols || 1) * 1.4 }));
+const byId = new Map(N.map((n) => [n.id, n]));
+const D = DATA.docs.map((d, i) => ({ ...d, kind: "doc",
+  x: W/2 + Math.cos((i + .5) / Math.max(1, DATA.docs.length) * 2 * Math.PI) * Math.min(W,H)/2.2,
+  y: H/2 + Math.sin((i + .5) / Math.max(1, DATA.docs.length) * 2 * Math.PI) * Math.min(W,H)/2.2,
+  vx: 0, vy: 0, r: 7 }));
+const ALL = N.concat(D);
+const L = DATA.links.map((l) => ({ a: byId.get(l.source), b: byId.get(l.target), doc: false }))
+  .concat(D.flatMap((d) => d.components.map((c) => ({ a: d, b: byId.get(c), doc: true }))))
+  .filter((l) => l.a && l.b);
+
+const DATES = N.flatMap((n) => n.decisions).sort();
+const T0 = DATES.length ? Date.parse(DATES[0]) : Date.now();
+const T1 = DATES.length ? Date.parse(DATES[DATES.length - 1]) + 864e5 : Date.now();
+const WEEK_AGO = Date.now() - 7 * 864e5; // presentation only — never hashed
+
+function frag(f){
+  const stops = [[0,[127,174,154]],[.4,[201,162,74]],[1,[201,106,74]]];
+  let lo = stops[0], hi = stops[stops.length-1];
+  for (let i=0;i<stops.length-1;i++) if (f>=stops[i][0] && f<=stops[i+1][0]) { lo=stops[i]; hi=stops[i+1]; break; }
+  const t = hi[0]===lo[0] ? 0 : (f-lo[0])/(hi[0]-lo[0]);
+  const c = lo[1].map((v,i)=>Math.round(v+(hi[1][i]-v)*t));
+  return "rgb("+c.join(",")+")";
+}
+
+const linkEls = L.map((l) => { const e = document.createElementNS("http://www.w3.org/2000/svg","line"); e.setAttribute("class", l.doc ? "doclink" : "link"); document.getElementById("links").appendChild(e); return e; });
+
+const tipEl = document.getElementById("tip");
+function showTip(ev, html){
+  tipEl.innerHTML = html; tipEl.style.display = "block";
+  tipEl.style.left = Math.min(ev.clientX + 14, innerWidth - 330) + "px";
+  tipEl.style.top = (ev.clientY + 14) + "px";
+}
+
+const nodeEls = N.map((n) => {
+  const g = document.createElementNS("http://www.w3.org/2000/svg","g"); g.setAttribute("class","node");
+  const mem = document.createElementNS("http://www.w3.org/2000/svg","circle"); mem.setAttribute("class","mem");
+  const body = document.createElementNS("http://www.w3.org/2000/svg","circle"); body.setAttribute("class","body");
+  body.setAttribute("r", n.r); body.setAttribute("fill", frag(Math.min(1, n.fragility)));
+  g.appendChild(mem); g.appendChild(body);
+  if (n.blocking) { const sh = document.createElementNS("http://www.w3.org/2000/svg","circle"); sh.setAttribute("class","shield"); sh.setAttribute("r", n.r + 3.5); g.appendChild(sh); }
+  if (n.decisions.some((d)=>Date.parse(d) >= WEEK_AGO)) { const wk = document.createElementNS("http://www.w3.org/2000/svg","circle"); wk.setAttribute("class","week"); wk.setAttribute("r", n.r + 7); g.appendChild(wk); }
+  const label = document.createElementNS("http://www.w3.org/2000/svg","text"); label.textContent = n.name; label.setAttribute("dy", -(n.r + 9));
+  g.appendChild(label);
+  body.addEventListener("click", () => { if (!dragged) location.href = n.slug + ".md"; });
+  body.addEventListener("mousemove", (ev) => showTip(ev, "<b>" + n.name + "</b>" + (n.responsibility || "") +
+    "<br><span style='opacity:.7'>" + n.decisions.length + " decisions · " + n.constraints + " invariants" +
+    (n.blocking ? " (" + n.blocking + " blocking)" : "") + " · " + n.bugs + " bugs · fragility " + n.fragility.toFixed(2) + "</span>"));
+  body.addEventListener("mouseleave", () => { tipEl.style.display = "none"; });
+  attachDrag(g, n);
+  document.getElementById("nodes").appendChild(g);
+  return { g, mem };
+});
+
+const STATUS_TIP = { grounded: "anchored to current decisions — safe to trust",
+  stale: "contradicts the live decision — read the wiki-managed copy; heal the original (hunch heal)",
+  unverified: "Hunch can't vouch — anchor it with a hunch:topic marker" };
+const docEls = D.map((d) => {
+  const g = document.createElementNS("http://www.w3.org/2000/svg","g"); g.setAttribute("class","doc " + d.status);
+  const rect = document.createElementNS("http://www.w3.org/2000/svg","rect");
+  rect.setAttribute("width", 14); rect.setAttribute("height", 14); rect.setAttribute("x", -7); rect.setAttribute("y", -7);
+  const label = document.createElementNS("http://www.w3.org/2000/svg","text"); label.textContent = d.title; label.setAttribute("dy", -12);
+  g.appendChild(rect); g.appendChild(label);
+  rect.addEventListener("click", () => {
+    if (dragged) return;
+    if (d.status === "stale" && d.adopted) location.href = d.adopted;      // read the healed copy
+    else if (DATA.kind === "public") location.href = "../" + d.rel;         // original (main repo)
+  });
+  rect.addEventListener("mousemove", (ev) => showTip(ev, "<b>📄 " + d.title + "</b><code>" + d.rel + "</code>" +
+    "<br><span style='opacity:.7'>" + d.status + " — " + STATUS_TIP[d.status] + "</span>" +
+    (d.status === "stale" && d.adopted ? "<br><span style='opacity:.7'>click → wiki-managed healed copy</span>" : "")));
+  rect.addEventListener("mouseleave", () => { tipEl.style.display = "none"; });
+  attachDrag(g, d);
+  document.getElementById("nodes").appendChild(g);
+  return { g };
+});
+
+// --- Act now panel: read-only rows that HIGHLIGHT their nodes ----------------
+const rows = document.getElementById("actrows");
+let hiSet = null;
+function setHi(items){
+  hiSet = hiSet === items ? null : items;
+  D.forEach((d, i) => docEls[i].g.classList.toggle("hi", !!hiSet && hiSet.includes(d)));
+  N.forEach((n, i) => nodeEls[i].g.classList.toggle("hi", false));
+}
+function row(cls, label, count, onClick, hint){
+  const r = document.createElement("div"); r.className = "row" + (count ? "" : " ok");
+  r.innerHTML = "<span class='" + cls + "'>" + label + "</span><b>" + count + "</b>";
+  if (count && onClick) r.addEventListener("click", onClick);
+  if (count && hint) r.title = hint;
+  rows.appendChild(r);
+}
+const staleDocs = D.filter((d) => d.status === "stale");
+const unverified = D.filter((d) => d.status === "unverified");
+row("badc", "⚠ stale docs — click to locate", staleDocs.length, () => setHi(staleDocs), "amber squares pulse; click one to read its healed copy");
+row("warnc", "◻ unverified docs", unverified.length, () => setHi(unverified), "gray squares; anchor with a hunch:topic marker to ground them");
+row("", "🗂 drafts awaiting review", DATA.pendingReview, null, null);
+if (DATA.pendingReview) { const h = document.createElement("div"); h.className = "hint"; h.textContent = "triage in a terminal: hunch review"; rows.appendChild(h); }
+if (!staleDocs.length && !unverified.length && !DATA.pendingReview) { const h = document.createElement("div"); h.className = "hint"; h.textContent = "Nothing needs you — the knowledge base is clean. 🎉"; rows.appendChild(h); }
+
+// --- tiny force simulation ----------------------------------------------------
+let alpha = 1;
+function tick(){
+  for (let i=0;i<ALL.length;i++) for (let j=i+1;j<ALL.length;j++){
+    const a=ALL[i], b=ALL[j]; let dx=b.x-a.x, dy=b.y-a.y; let d2=dx*dx+dy*dy || 1;
+    const f = Math.min((a.kind==="doc"||b.kind==="doc" ? 700 : 1200)/d2, .6); dx*=f; dy*=f; a.vx-=dx; a.vy-=dy; b.vx+=dx; b.vy+=dy;
+  }
+  for (const l of L){
+    const dx=l.b.x-l.a.x, dy=l.b.y-l.a.y, d=Math.sqrt(dx*dx+dy*dy)||1;
+    const rest = l.doc ? 70 : 120;
+    const f=(d-rest)/d*.02; l.a.vx+=dx*f; l.a.vy+=dy*f; l.b.vx-=dx*f; l.b.vy-=dy*f;
+  }
+  for (const n of ALL){
+    n.vx += (W/2-n.x)*.0008; n.vy += (H/2-n.y)*.0008;
+    if (n !== held) { n.x += n.vx*alpha; n.y += n.vy*alpha; }
+    n.vx*=.85; n.vy*=.85;
+  }
+  alpha = Math.max(.06, alpha*.995);
+  L.forEach((l,i)=>{ linkEls[i].setAttribute("x1",l.a.x); linkEls[i].setAttribute("y1",l.a.y); linkEls[i].setAttribute("x2",l.b.x); linkEls[i].setAttribute("y2",l.b.y); });
+  N.forEach((n,i)=>{ nodeEls[i].g.setAttribute("transform","translate("+n.x+","+n.y+")"); });
+  D.forEach((d,i)=>{ docEls[i].g.setAttribute("transform","translate("+d.x+","+d.y+")"); });
+  requestAnimationFrame(tick);
+}
+
+// --- pan / zoom / drag ---------------------------------------------------------
+let scale=1, tx=0, ty=0, held=null, dragged=false;
+function applyView(){ view.setAttribute("transform","translate("+tx+","+ty+") scale("+scale+")"); }
+svg.addEventListener("wheel",(e)=>{ e.preventDefault();
+  const k = e.deltaY < 0 ? 1.1 : 1/1.1, mx = e.clientX, my = e.clientY;
+  tx = mx - (mx - tx) * k; ty = my - (my - ty) * k; scale *= k; applyView();
+},{passive:false});
+let panning=null;
+svg.addEventListener("mousedown",(e)=>{ if(e.target===svg||e.target===view){ panning={x:e.clientX-tx,y:e.clientY-ty}; svg.classList.add("panning"); }});
+addEventListener("mousemove",(e)=>{ if(panning){ tx=e.clientX-panning.x; ty=e.clientY-panning.y; applyView(); }
+  if(held){ held.x=(e.clientX-tx)/scale; held.y=(e.clientY-ty)/scale; dragged=true; alpha=Math.max(alpha,.3); }});
+addEventListener("mouseup",()=>{ panning=null; held=null; svg.classList.remove("panning"); setTimeout(()=>{dragged=false;},0); });
+function attachDrag(g,n){ g.addEventListener("mousedown",(e)=>{ e.stopPropagation(); held=n; dragged=false; }); }
+
+// --- the time scrubber: replay the memory compounding ---------------------------
+const slider = document.getElementById("t"), when = document.getElementById("when"), play = document.getElementById("play");
+function setTime(frac){
+  const t = T0 + (T1 - T0) * frac;
+  let total = 0;
+  N.forEach((n,i)=>{
+    const k = n.decisions.filter((d)=>Date.parse(d) <= t).length;
+    total += k;
+    nodeEls[i].mem.setAttribute("r", n.r + Math.sqrt(k) * 5);
+    nodeEls[i].g.classList.toggle("asleep", k === 0 && n.decisions.length > 0);
+  });
+  when.textContent = new Date(t).toISOString().slice(0,10) + " · " + total + " decision" + (total===1?"":"s") + " remembered";
+}
+slider.addEventListener("input",()=>setTime(slider.value/1000));
+let timer=null;
+play.addEventListener("click",()=>{
+  if (timer){ clearInterval(timer); timer=null; play.textContent="▶ replay"; return; }
+  slider.value=0; play.textContent="⏸";
+  timer=setInterval(()=>{ const v=Math.min(1000,+slider.value+6); slider.value=v; setTime(v/1000); if(v>=1000){ clearInterval(timer); timer=null; play.textContent="▶ replay"; } },50);
+});
+setTime(1);
+tick();
+</script></body></html>
+`;
+}
+//# sourceMappingURL=graph.js.map

package/dist/wiki/wiki.js

@@ -34,6 +34,7 @@ import { hunchPaths, toPosixTarget } from "../core/paths.js";
 import { isLive } from "../core/topics.js";
 import { scanRepoDocs } from "../core/docscan.js";
 import { adoptedSlug, adoptionHash, renderAdoptedDoc } from "./adopt.js";
+import { assembleGraphData, renderGraphPage } from "./graph.js";
 /** Normalize a --dir override: POSIX separators, no trailing slash — the dir is
  *  a committed manifest key prefix, so it must hash identically on every OS. */
 const normDir = (d) => d ? toPosixTarget(d).replace(/\/+$/, "") || undefined : undefined;
@@ -263,6 +264,7 @@ export function renderIndex(entries, repoWide, home, docs = []) {
         L.push("", `📄 [Specs & docs ledger](specs.md) — ${docs.length} repo doc(s): ${n("grounded")} grounded, ${n("stale")} stale, ${n("unverified")} unverified.`);
     }
     L.push("", "🔥 [Now — recent activity & roadmap](now.md)");
+    L.push("", "🕸 [Memory graph](graph.html) — the interactive map: components, dependencies, and a time scrubber that replays the memory compounding.");
     if (repoWide.length) {
         L.push("", "## Repo-wide invariants", "");
         for (const k of repoWide)
@@ -343,6 +345,8 @@ const SPECS_ID = "_specs";
 const INDEX_ID = "_index";
 /** Reserved manifest component id for the NOW page (activity ledger + roadmap). */
 const NOW_ID = "_now";
+/** Reserved manifest component id for the interactive memory-graph page. */
+const GRAPH_ID = "_graph";
 /** Manifest component-id prefix for adopted (wiki-managed) doc copies. */
 const ADOPTED_PREFIX = "doc:";
 /** The hot view's inputs: last `recentLimit` decisions by date (any status — a
@@ -389,7 +393,7 @@ export function renderNowPage(recent, roadmap, home, pendingReview = 0) {
     if (roadmap.length)
         L.push("");
     if (pendingReview > 0)
-        L.push(`_${pendingReview} auto-drafted proposed decision(s) awaiting review are not shown — triage with \`hunch review\`._`, "");
+        L.push(`_${pendingReview} legacy un-vouched proposed decision(s) not shown — \`hunch adopt-drafts\` auto-trusts them as advisory memory._`, "");
     L.push("---", "", "_Derived from the decision graph — regen: `hunch wiki --heal`. Ship a roadmap item by accepting/superseding its decision; never edit this page._", "");
     return L.join("\n");
 }
@@ -477,6 +481,7 @@ export function wikiStatus(store, home, srcRoot) {
         rows: entries.map((e) => ({ slug: e.slug, name: e.pack.component.name, responsibility: e.pack.component.responsibility, decisions: e.pack.decisions.length, constraints: e.pack.constraints.length })),
         repoWide: repoWide.map((c) => ({ id: c.id, severity: c.severity, statement: c.statement })),
         docs: { grounded: docs.filter((d) => d.status === "grounded").length, stale: docs.filter((d) => d.status === "stale").length, unverified: docs.filter((d) => d.status === "unverified").length, total: docs.length },
+        graphLink: true, // the index links graph.html — pre-graph manifests re-render once
     })));
     const index = { page: indexPage, hash: indexHash, state: pageState(home, indexPage, INDEX_ID, indexHash, manifest?.pages[indexPage]).state };
     // The NOW page: recent activity + live proposed decisions (the roadmap).
@@ -484,11 +489,21 @@ export function wikiStatus(store, home, srcRoot) {
     const nowPage = `${home.dir}/now.md`;
     const nowHash = sha16(JSON.stringify(canonical({ recent, roadmap, pendingReview })));
     const now = { page: nowPage, hash: nowHash, state: pageState(home, nowPage, NOW_ID, nowHash, manifest?.pages[nowPage]).state, recent, roadmap, pendingReview };
+    // The memory-graph page — the visual knowledge base: components + dependencies
+    // + per-component decision dates (the scrubber's timeline) + every repo doc
+    // with its freshness grade (stale docs point at their adopted healed copy) +
+    // the actionable review count. Hashed over the exact embedded data — the
+    // client-side force layout is presentation and never participates.
+    const decisionDates = new Map(decisions.map((d) => [d.id, d.valid_from ?? d.date]));
+    const graphData = assembleGraphData(home.kind, entries, decisionDates, docs, adoptedPageByRel, pendingReview);
+    const graphPage = `${home.dir}/graph.html`;
+    const graphHash = sha16(JSON.stringify(canonical(graphData)));
+    const graph = { page: graphPage, hash: graphHash, state: pageState(home, graphPage, GRAPH_ID, graphHash, manifest?.pages[graphPage]).state, data: graphData };
     // Orphans by PAGE KEY, not component id: anything the manifest tracks that no
     // current artifact claims (deleted component, renamed component whose slug
     // moved, a retired adoption) gets removed on heal — nothing generated is ever
     // stranded on disk while the manifest forgets it.
-    const expected = new Set([...entries.map((e) => e.page), ...adoptions.map((a) => a.page), specsPage, indexPage, nowPage]);
+    const expected = new Set([...entries.map((e) => e.page), ...adoptions.map((a) => a.page), specsPage, indexPage, nowPage, graphPage]);
     const orphans = [];
     const adoptionOrphans = [];
     for (const [page, p] of Object.entries(manifest?.pages ?? {})) {
@@ -496,7 +511,7 @@ export function wikiStatus(store, home, srcRoot) {
             continue;
         (p.component.startsWith(ADOPTED_PREFIX) ? adoptionOrphans : orphans).push(page);
     }
-    return { home, entries, docs, adoptions, adoptionOrphans, decisions, specs, index, now, repoWide, orphans };
+    return { home, entries, docs, adoptions, adoptionOrphans, decisions, specs, index, now, graph, repoWide, orphans };
 }
 /** Read short excerpts of the component's heaviest files as LLM grounding.
  *  Source files always live in the MAIN repo (`srcRoot`), even for the private
@@ -529,6 +544,7 @@ export async function generateWiki(store, srcRoot, home, opts) {
     const specsTarget = opts.only === "all" || status.specs.state !== "fresh";
     const indexTarget = opts.only === "all" || status.index.state !== "fresh";
     const nowTarget = opts.only === "all" || status.now.state !== "fresh";
+    const graphTarget = opts.only === "all" || status.graph.state !== "fresh";
     const log = opts.log ?? (() => { });
     const written = [];
     /** Written-bytes ledger — the hand-edit tripwire recorded per page. */
@@ -578,6 +594,10 @@ export async function generateWiki(store, srcRoot, home, opts) {
         put(status.now.page, renderNowPage(status.now.recent, status.now.roadmap, home, status.now.pendingReview));
         log(`  ✎ ${status.now.page}${status.now.state === "fresh" ? "" : ` (${status.now.state})`} [${status.now.recent.length} recent, ${status.now.roadmap.length} roadmap]`);
     }
+    if (graphTarget) {
+        put(status.graph.page, renderGraphPage(status.graph.data));
+        log(`  ✎ ${status.graph.page}${status.graph.state === "fresh" ? "" : ` (${status.graph.state})`} [${status.graph.data.nodes.length} node(s), ${status.graph.data.links.length} link(s)]`);
+    }
     if (indexTarget) {
         put(status.index.page, renderIndex(status.entries.map((e) => ({ pack: e.pack, slug: e.slug })), status.repoWide, home, status.docs));
         log(`  ✎ ${status.index.page}${status.index.state === "fresh" ? "" : ` (${status.index.state})`}`);
@@ -611,6 +631,7 @@ export async function generateWiki(store, srcRoot, home, opts) {
         entry(status.specs.page, SPECS_ID, status.specs.hash, status.specs.state);
         entry(status.index.page, INDEX_ID, status.index.hash, status.index.state);
         entry(status.now.page, NOW_ID, status.now.hash, status.now.state);
+        entry(status.graph.page, GRAPH_ID, status.graph.hash, status.graph.state);
         writeWikiManifestAt(home.manifestPath, { version: 1, dir: home.dir, pages });
     }
     return { written, removed, unchanged: status.entries.length - targets.length };
@@ -663,6 +684,13 @@ export function computeWikiDrift(store, root) {
                 detail: `the activity ledger / roadmap moved (a decision was recorded, accepted, or superseded) — regenerate with \`${heal}\`${where}`,
             });
         }
+        if (status.graph.state !== "fresh") {
+            findings.push({
+                kind: "wiki-stale",
+                id: status.graph.page,
+                detail: `the memory graph's inputs moved (components, dependencies, or decision dates) — regenerate with \`${heal}\`${where}`,
+            });
+        }
         for (const a of status.adoptions) {
             if (a.state === "fresh")
                 continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@davesheffer/hunch",
-  "version": "1.7.1",
+  "version": "1.8.0",
   "license": "Apache-2.0",
   "author": "Dave Sheffer <dave.sheffer1@gmail.com>",
   "description": "Architectural Conformance for AI-generated code: a git-native graph that deterministically blocks AI changes which break your architecture — the semantic invariants (layering, must-reach, dependency direction) pattern-SAST can't express — grounded in the decisions and bugs behind each rule, across any MCP assistant (Claude Code, Cursor, Copilot, Windsurf, Antigravity, Codex).",