@davesheffer/hunch 1.32.2 → 1.32.4

package/dist/mcp/toolset.d.ts

@@ -0,0 +1,30 @@
+export declare const MCP_TOOL_GROUPS: {
+    /** nuryel.state/1 — the state-partition contract (Sofia-style agents). */
+    readonly nuryel: readonly ["nuryel_capabilities", "nuryel_read", "nuryel_write", "nuryel_capture", "nuryel_capture_batch", "nuryel_subscribe", "nuryel_records"];
+    /** Constitution G2/G3 experiment-track tools; the CLI remains the primary surface. */
+    readonly "constitution-experiments": readonly ["hunch_constitution_g2_readiness", "hunch_constitution_g3_readiness", "hunch_constitution_g2_shadow_queue", "hunch_constitution_g2_operational_drill", "hunch_constitution_g2_candidates", "hunch_constitution_g2_behavior_candidates", "hunch_constitution_g2_behavior_replay", "hunch_constitution_g2_behavior_materialization", "hunch_constitution_g2_behavior_policy_materialize"];
+};
+export type McpToolGroup = keyof typeof MCP_TOOL_GROUPS;
+export declare const MCP_TOOL_GROUP_NAMES: McpToolGroup[];
+export interface McpToolset {
+    enabled: (group: McpToolGroup) => boolean;
+    groups: McpToolGroup[];
+    hidden: string[];
+    /** Where the selection came from, for the startup log and doctor. */
+    source: "env" | "config" | "default";
+}
+/** Grammar shared by the env var and the config value: `all`, `core`, or a
+ * comma-separated list of extra groups on top of core (`core,nuryel`). Unknown
+ * words are ignored rather than failing the server. */
+export declare function parseToolsetSpec(spec: string): McpToolGroup[] | null;
+/** A root that already stores nuryel state records is a state partition and
+ * needs the nuryel tools; every other root gets the everyday set by default. */
+export declare function rootStoresState(root: string): boolean;
+/** `pinned` is `hunch mcp --root <dir>`: a server dedicated to one root, which is
+ * how state partitions are served — including a brand-new partition that has no
+ * state records yet and could never receive its first nuryel_write otherwise. */
+export declare function resolveMcpToolset(root: string, opts?: {
+    env?: NodeJS.ProcessEnv;
+    configSpec?: string | null;
+    pinned?: boolean;
+}): McpToolset;

package/dist/mcp/toolset.js

@@ -0,0 +1,72 @@
+/** Which MCP tool groups a server exposes. Every host shares one server, so the
+ * selection surface is the same for all of them: 57 tools with ~24 KB of
+ * descriptions dilute tool choice for everyday grounding. The everyday set is
+ * the default; the two specialist groups are enabled by evidence (a root that
+ * stores nuryel state records), by `.hunch/config.json` `mcp_tools`, or by the
+ * `HUNCH_MCP_TOOLS` environment variable. Hidden tools are not registered at
+ * all, so a client never sees them in tools/list. */
+import { existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { STATE_KINDS } from "../core/stateDelivery.js";
+export const MCP_TOOL_GROUPS = {
+    /** nuryel.state/1 — the state-partition contract (Sofia-style agents). */
+    nuryel: ["nuryel_capabilities", "nuryel_read", "nuryel_write", "nuryel_capture", "nuryel_capture_batch", "nuryel_subscribe", "nuryel_records"],
+    /** Constitution G2/G3 experiment-track tools; the CLI remains the primary surface. */
+    "constitution-experiments": [
+        "hunch_constitution_g2_readiness", "hunch_constitution_g3_readiness", "hunch_constitution_g2_shadow_queue",
+        "hunch_constitution_g2_operational_drill", "hunch_constitution_g2_candidates", "hunch_constitution_g2_behavior_candidates",
+        "hunch_constitution_g2_behavior_replay", "hunch_constitution_g2_behavior_materialization", "hunch_constitution_g2_behavior_policy_materialize",
+    ],
+};
+export const MCP_TOOL_GROUP_NAMES = Object.keys(MCP_TOOL_GROUPS);
+/** Grammar shared by the env var and the config value: `all`, `core`, or a
+ * comma-separated list of extra groups on top of core (`core,nuryel`). Unknown
+ * words are ignored rather than failing the server. */
+export function parseToolsetSpec(spec) {
+    const words = spec.split(",").map(w => w.trim().toLowerCase()).filter(Boolean);
+    if (!words.length)
+        return null;
+    if (words.includes("all"))
+        return [...MCP_TOOL_GROUP_NAMES];
+    return MCP_TOOL_GROUP_NAMES.filter(g => words.includes(g));
+}
+/** A root that already stores nuryel state records is a state partition and
+ * needs the nuryel tools; every other root gets the everyday set by default. */
+export function rootStoresState(root) {
+    return STATE_KINDS.some(kind => {
+        const dir = join(root, ".hunch", kind);
+        try {
+            return existsSync(dir) && readdirSync(dir).some(f => f.endsWith(".json"));
+        }
+        catch {
+            return false;
+        }
+    });
+}
+/** `pinned` is `hunch mcp --root <dir>`: a server dedicated to one root, which is
+ * how state partitions are served — including a brand-new partition that has no
+ * state records yet and could never receive its first nuryel_write otherwise. */
+export function resolveMcpToolset(root, opts = {}) {
+    const env = opts.env ?? process.env;
+    let groups = null;
+    let source = "default";
+    const fromEnv = env.HUNCH_MCP_TOOLS?.trim();
+    if (fromEnv) {
+        groups = parseToolsetSpec(fromEnv);
+        if (groups)
+            source = "env";
+    }
+    if (!groups && opts.configSpec?.trim()) {
+        groups = parseToolsetSpec(opts.configSpec);
+        if (groups)
+            source = "config";
+    }
+    if (!groups) {
+        groups = opts.pinned || rootStoresState(root) ? ["nuryel"] : [];
+        source = "default";
+    }
+    const set = new Set(groups);
+    const hidden = MCP_TOOL_GROUP_NAMES.filter(g => !set.has(g)).flatMap(g => [...MCP_TOOL_GROUPS[g]]);
+    return { enabled: g => set.has(g), groups: [...set], hidden, source };
+}
+//# sourceMappingURL=toolset.js.map

package/dist/store/stateBinding.js

@@ -806,6 +806,22 @@ export function writeState(store, input, opts = {}) {
             supersedes = null; // already closed by this record: nothing to close again, no second "superseded" event
         }
     }
+    // one-current-derived-per-subject-transform: a NEW current derived statement on a subject that
+    // already holds a current statement under the same transform must name it in `supersedes`.
+    // Otherwise a writer that never names its predecessor leaves a growing pile of "current"
+    // statements that every reader has to reconcile (season finding fnd_1939ced249: up to 58 on
+    // one subject over half a year). Writing the same identity again is an update or a replay of
+    // that record and is not affected; a different transform is a different statement.
+    if (facet === "derived" && record.state === "current") {
+        const d = record;
+        const incumbent = store.recsInHome("derived", home).find((r) => {
+            const x = r;
+            return x.id !== id && x.id !== supersedes && x.subject === d.subject && x.transform_version === d.transform_version && x.state === "current" && x.valid_to === null;
+        });
+        if (incumbent) {
+            throw new StateRefusal("conflict", `${d.subject} already has a current ${d.transform_version} statement ${incumbent.id}; pass supersedes: "${incumbent.id}" to replace it, or write that identity to update it`, { incumbent_id: incumbent.id, reason: "one-current-derived-per-subject-transform" });
+        }
+    }
     // The chain (Gate 4): a receipt names what it rested on, a closure names the receipt.
     // Both are checked against the drawer, grants first, before anything lands.
     if (facet === "receipts")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@davesheffer/hunch",
-  "version": "1.32.2",
+  "version": "1.32.4",
   "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://www.hunchmemory.com",
-  "version": "1.32.2",
+  "version": "1.32.4",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@davesheffer/hunch",
-      "version": "1.32.2",
+      "version": "1.32.4",
       "runtimeHint": "npx",
       "packageArguments": [
         {