@davesheffer/hunch 1.20.0-rc.6 → 1.20.0

package/README.md

@@ -171,7 +171,7 @@ repository, separate from the code repository. Hunch does not host it. Create a
 that every teammate can access, install Hunch on team machines and CI, then have one maintainer run:
 
 ```bash
-npm i -g @davesheffer/hunch@1.19.0
+npm i -g @davesheffer/hunch@1.20.0
 hunch shared --repo git@github.com:acme/project-hunch-memory.git
 git add .gitignore .hunch/team.json
 git commit -m "chore: connect shared Hunch memory"
@@ -186,7 +186,7 @@ printed by Hunch. Omit `--migrate` for a new setup.
 After the pointer commit lands, teammates need Hunch installed and Git access to the memory repo:
 
 ```bash
-npm i -g @davesheffer/hunch@1.19.0
+npm i -g @davesheffer/hunch@1.20.0
 git pull
 hunch init
 hunch doctor
@@ -234,7 +234,7 @@ but stops automatic memory commits and pushes. As a team-coordinated rollback, r
 commit to stop discovery after teammates pull the revert. Existing machines retain their ignored
 local overlay until they are deliberately disconnected; do not delete the memory repo as part of a
 rollback. For this rollout, reinstall the previous published package with
-`npm i -g @davesheffer/hunch@1.16.0`; the release receipt resolves and records the verified rollback
+`npm i -g @davesheffer/hunch@1.19.0`; the release receipt resolves and records the verified rollback
 target from the npm registry instead of trusting Git tags. Pause enforcement first as shown above,
 and keep every team client on the same release before resuming Matrix policy workflows.
 

package/dist/integrations/claudemd.js

@@ -46,7 +46,7 @@ export function renderHunchSection(store, root) {
     lines.push("**Consult Hunch via the `hunch_*` MCP tools — pick by MOMENT, not from memory:**");
     lines.push("");
     lines.push("**Orient (session/task start):**");
-    lines.push("- `hunch_context(target_or_task)` — the minimal relevant slice for what you're about to do; a task phrase falls back to the closest graph matches. **Call FIRST.**");
+    lines.push("- `hunch_context(target)` — the minimal relevant slice for what you're about to do; a task phrase falls back to the closest graph matches. **Call FIRST.**");
     lines.push("- `hunch_structure(target?)` — the indexed shape of the repo/dir/file/symbol — orient from the graph, not grep rounds.");
     lines.push("- `hunch_runbook(task)` — the proven steps for a recurring task, before re-deriving them.");
     lines.push("- `hunch_escalations()` — the decisions only the HUMAN can make (including one exact imported ADR at a time, topic conflicts, and policy calls). Normally empty; when it isn't, ASK the user inline — an entry is a question, silence is never approval. Apply an ADR answer only through `hunch_review_imported_adr` with its printed source and review hashes.");

package/dist/mcp/server.js

@@ -477,14 +477,22 @@ export function buildServerWithRootControl(initialRoot) {
     };
     const pullTeamMemory = (force = false) => {
         if (!store.privateDir)
-            return;
+            return "not_shared";
         const now = Date.now();
         if (!force && now < nextRemotePullAt)
-            return;
-        notePull(pullHunchStatus(store.privateDir, {
-            timeoutMs: 5_000,
-            remote: startupTeamRoute ?? advertisedTeamRemoteContract(root, join(store.privateDir, "..")),
-        }), Date.now());
+            return "cooldown";
+        let status;
+        try {
+            status = pullHunchStatus(store.privateDir, {
+                timeoutMs: 5_000,
+                remote: startupTeamRoute ?? advertisedTeamRemoteContract(root, join(store.privateDir, "..")),
+            });
+        }
+        catch {
+            status = "failed";
+        }
+        notePull(status, Date.now());
+        return status;
     };
     // A source stamp is acknowledged ONLY after a stable, successful rebuild. If
     // another process changes the atomic JSON tree during the rebuild, retry once;
@@ -626,10 +634,7 @@ export function buildServerWithRootControl(initialRoot) {
                 return err("The committed team memory destination is invalid or no longer matches this process. Refusing the stale graph; reconnect Hunch first.");
             }
             if (store.mode === "shared" && store.privateDir) {
-                try {
-                    pullTeamMemory();
-                }
-                catch { /* offline / lock held / invalid remote — use local */ }
+                pullTeamMemory();
                 // Recompute the full semantic + physical snapshot after the synchronous
                 // network seam. A paired team.json/origin change can occur while fetch is
                 // blocked; serving after that race would attach the old checkout to a new
@@ -1087,11 +1092,31 @@ export function buildServerWithRootControl(initialRoot) {
     // -- hunch_current_decision (decision-grounding: current(topic)) ----------
     server.registerTool("hunch_current_decision", {
         title: "Current decision for a topic",
-        description: "Decision-grounding: return the single CURRENT (accepted, non-superseded) decision anchored to a topic — the authoritative answer a doc or diff is checked against, plus what it rejected. If a topic has NO current decision, or an unresolved collision (>1 live), it says so and injects nothing (fail-safe).",
+        description: "Decision-grounding: return the single CURRENT (accepted, non-superseded) decision anchored to a topic — the authoritative answer a doc or diff is checked against, plus what it rejected. A shared-store miss is confirmed against fresh team memory before Hunch says the topic has no current decision. If freshness is unavailable, or a topic has an unresolved collision (>1 live), it injects nothing (fail-safe).",
         inputSchema: { topic: z.string().describe("the decision anchor, e.g. 'auth-transport'") },
     }, async ({ topic }) => {
-        const decs = store.recs("decisions");
-        const live = liveForTopic(decs, topic);
+        let decs = store.recs("decisions");
+        let live = liveForTopic(decs, topic);
+        // A prior transient fetch failure may have placed ordinary tool traffic in
+        // backoff. That is acceptable for cached positive reads, but an exact topic
+        // miss is an authority claim: local absence must never be presented as team
+        // absence. Bypass the cooldown once, then reread only after a successful
+        // bounded convergence. An unavailable remote produces an explicit abstention.
+        if (live.length === 0 && store.mode === "shared" && store.privateDir) {
+            const status = pullTeamMemory(true);
+            if (status !== "updated" && status !== "current") {
+                return err(`Shared team memory refresh is ${status}; Hunch cannot confirm that topic "${topic}" has no current decision. Retry when the shared store is available.`);
+            }
+            try {
+                if (store.sourceStamp() !== indexedSourceStamp)
+                    refreshIndex();
+            }
+            catch {
+                return err(`Shared team memory refreshed, but its derived index could not be rebuilt; Hunch cannot confirm that topic "${topic}" is absent. Retry this read.`);
+            }
+            decs = store.recs("decisions");
+            live = liveForTopic(decs, topic);
+        }
         if (live.length === 0)
             return ok(`No current decision for topic "${topic}". (Un-anchored, or never captured.)`);
         if (live.length > 1) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@davesheffer/hunch",
-  "version": "1.20.0-rc.6",
+  "version": "1.20.0",
   "mcpName": "io.github.davesheffer/hunch",
   "license": "Apache-2.0",
   "author": "Dave Sheffer <dave.sheffer1@gmail.com>",

package/server.json

@@ -7,13 +7,13 @@
     "source": "github"
   },
   "websiteUrl": "https://hunch-pi.vercel.app",
-  "version": "1.20.0-rc.6",
+  "version": "1.20.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@davesheffer/hunch",
-      "version": "1.20.0-rc.6",
+      "version": "1.20.0",
       "runtimeHint": "npx",
       "packageArguments": [
         {