@mneme-ai/core 2.8.1 → 2.9.1

package/dist/dynamic/pack-schema.d.ts

@@ -70,12 +70,12 @@ declare const GitHistoryQuerySchema: z.ZodObject<{
     /** Maximum commits to return per path. */
     maxCommits: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    kind: "git-history";
     paths: string[];
+    kind: "git-history";
     maxCommits: number;
 }, {
-    kind: "git-history";
     paths: string[];
+    kind: "git-history";
     maxCommits?: number | undefined;
 }>;
 declare const EntityGraphQuerySchema: z.ZodObject<{
@@ -126,12 +126,12 @@ declare const QuerySchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
     /** Maximum commits to return per path. */
     maxCommits: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    kind: "git-history";
     paths: string[];
+    kind: "git-history";
     maxCommits: number;
 }, {
-    kind: "git-history";
     paths: string[];
+    kind: "git-history";
     maxCommits?: number | undefined;
 }>, z.ZodObject<{
     kind: z.ZodLiteral<"entity-graph">;
@@ -214,12 +214,12 @@ declare const ToolDefinitionSchema: z.ZodObject<{
         /** Maximum commits to return per path. */
         maxCommits: z.ZodDefault<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
-        kind: "git-history";
         paths: string[];
+        kind: "git-history";
         maxCommits: number;
     }, {
-        kind: "git-history";
         paths: string[];
+        kind: "git-history";
         maxCommits?: number | undefined;
     }>, z.ZodObject<{
         kind: z.ZodLiteral<"entity-graph">;
@@ -269,8 +269,6 @@ declare const ToolDefinitionSchema: z.ZodObject<{
     }>>;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    description: string;
-    inputSchema: Record<string, any>;
     query: {
         kind: "code-search";
         patterns: string[];
@@ -278,8 +276,8 @@ declare const ToolDefinitionSchema: z.ZodObject<{
         maxResults: number;
         ranking: "centrality-desc" | "recency-desc" | "alphabetical";
     } | {
-        kind: "git-history";
         paths: string[];
+        kind: "git-history";
         maxCommits: number;
     } | {
         kind: "entity-graph";
@@ -287,6 +285,8 @@ declare const ToolDefinitionSchema: z.ZodObject<{
         relationKinds: string[];
         maxDepth: number;
     };
+    description: string;
+    inputSchema: Record<string, any>;
     enrichWith: ("git-blame" | "first-commit-introduced" | "centrality-rank" | "incident-cross-reference" | "atrophy-author" | "constitution-rules")[];
     augmentation: {
         includeCanonicalPath: boolean;
@@ -297,7 +297,6 @@ declare const ToolDefinitionSchema: z.ZodObject<{
     };
 }, {
     id: string;
-    description: string;
     query: {
         kind: "code-search";
         patterns: string[];
@@ -305,8 +304,8 @@ declare const ToolDefinitionSchema: z.ZodObject<{
         maxResults?: number | undefined;
         ranking?: "centrality-desc" | "recency-desc" | "alphabetical" | undefined;
     } | {
-        kind: "git-history";
         paths: string[];
+        kind: "git-history";
         maxCommits?: number | undefined;
     } | {
         kind: "entity-graph";
@@ -314,6 +313,7 @@ declare const ToolDefinitionSchema: z.ZodObject<{
         relationKinds?: string[] | undefined;
         maxDepth?: number | undefined;
     };
+    description: string;
     inputSchema?: Record<string, any> | undefined;
     enrichWith?: ("git-blame" | "first-commit-introduced" | "centrality-rank" | "incident-cross-reference" | "atrophy-author" | "constitution-rules")[] | undefined;
     augmentation?: {
@@ -344,12 +344,12 @@ export declare const PackSchema: z.ZodObject<{
         url: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         name: string;
-        email?: string | undefined;
         url?: string | undefined;
+        email?: string | undefined;
     }, {
         name: string;
-        email?: string | undefined;
         url?: string | undefined;
+        email?: string | undefined;
     }>;
     /** SPDX license id. */
     license: z.ZodDefault<z.ZodString>;
@@ -416,12 +416,12 @@ export declare const PackSchema: z.ZodObject<{
             /** Maximum commits to return per path. */
             maxCommits: z.ZodDefault<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
-            kind: "git-history";
             paths: string[];
+            kind: "git-history";
             maxCommits: number;
         }, {
-            kind: "git-history";
             paths: string[];
+            kind: "git-history";
             maxCommits?: number | undefined;
         }>, z.ZodObject<{
             kind: z.ZodLiteral<"entity-graph">;
@@ -471,8 +471,6 @@ export declare const PackSchema: z.ZodObject<{
         }>>;
     }, "strip", z.ZodTypeAny, {
         id: string;
-        description: string;
-        inputSchema: Record<string, any>;
         query: {
             kind: "code-search";
             patterns: string[];
@@ -480,8 +478,8 @@ export declare const PackSchema: z.ZodObject<{
             maxResults: number;
             ranking: "centrality-desc" | "recency-desc" | "alphabetical";
         } | {
-            kind: "git-history";
             paths: string[];
+            kind: "git-history";
             maxCommits: number;
         } | {
             kind: "entity-graph";
@@ -489,6 +487,8 @@ export declare const PackSchema: z.ZodObject<{
             relationKinds: string[];
             maxDepth: number;
         };
+        description: string;
+        inputSchema: Record<string, any>;
         enrichWith: ("git-blame" | "first-commit-introduced" | "centrality-rank" | "incident-cross-reference" | "atrophy-author" | "constitution-rules")[];
         augmentation: {
             includeCanonicalPath: boolean;
@@ -499,7 +499,6 @@ export declare const PackSchema: z.ZodObject<{
         };
     }, {
         id: string;
-        description: string;
         query: {
             kind: "code-search";
             patterns: string[];
@@ -507,8 +506,8 @@ export declare const PackSchema: z.ZodObject<{
             maxResults?: number | undefined;
             ranking?: "centrality-desc" | "recency-desc" | "alphabetical" | undefined;
         } | {
-            kind: "git-history";
             paths: string[];
+            kind: "git-history";
             maxCommits?: number | undefined;
         } | {
             kind: "entity-graph";
@@ -516,6 +515,7 @@ export declare const PackSchema: z.ZodObject<{
             relationKinds?: string[] | undefined;
             maxDepth?: number | undefined;
         };
+        description: string;
         inputSchema?: Record<string, any> | undefined;
         enrichWith?: ("git-blame" | "first-commit-introduced" | "centrality-rank" | "incident-cross-reference" | "atrophy-author" | "constitution-rules")[] | undefined;
         augmentation?: {
@@ -527,29 +527,10 @@ export declare const PackSchema: z.ZodObject<{
         } | undefined;
     }>, "many">;
 }, "strict", z.ZodTypeAny, {
-    schemaVersion: 1;
     id: string;
-    displayName: string;
-    description: string;
     version: string;
-    mnemeMinVersion: string;
-    maintainer: {
-        name: string;
-        email?: string | undefined;
-        url?: string | undefined;
-    };
-    license: string;
-    detection: {
-        packageDeps: string[];
-        pythonDeps: string[];
-        importPatterns: string[];
-        filePatterns: string[];
-        minConfidence: number;
-    };
     tools: {
         id: string;
-        description: string;
-        inputSchema: Record<string, any>;
         query: {
             kind: "code-search";
             patterns: string[];
@@ -557,8 +538,8 @@ export declare const PackSchema: z.ZodObject<{
             maxResults: number;
             ranking: "centrality-desc" | "recency-desc" | "alphabetical";
         } | {
-            kind: "git-history";
             paths: string[];
+            kind: "git-history";
             maxCommits: number;
         } | {
             kind: "entity-graph";
@@ -566,6 +547,8 @@ export declare const PackSchema: z.ZodObject<{
             relationKinds: string[];
             maxDepth: number;
         };
+        description: string;
+        inputSchema: Record<string, any>;
         enrichWith: ("git-blame" | "first-commit-introduced" | "centrality-rank" | "incident-cross-reference" | "atrophy-author" | "constitution-rules")[];
         augmentation: {
             includeCanonicalPath: boolean;
@@ -575,28 +558,28 @@ export declare const PackSchema: z.ZodObject<{
             includeApplicableRules: boolean;
         };
     }[];
-}, {
+    description: string;
     schemaVersion: 1;
-    id: string;
     displayName: string;
-    description: string;
-    version: string;
     mnemeMinVersion: string;
     maintainer: {
         name: string;
-        email?: string | undefined;
         url?: string | undefined;
+        email?: string | undefined;
     };
+    license: string;
     detection: {
-        packageDeps?: string[] | undefined;
-        pythonDeps?: string[] | undefined;
-        importPatterns?: string[] | undefined;
-        filePatterns?: string[] | undefined;
-        minConfidence?: number | undefined;
+        packageDeps: string[];
+        pythonDeps: string[];
+        importPatterns: string[];
+        filePatterns: string[];
+        minConfidence: number;
     };
+}, {
+    id: string;
+    version: string;
     tools: {
         id: string;
-        description: string;
         query: {
             kind: "code-search";
             patterns: string[];
@@ -604,8 +587,8 @@ export declare const PackSchema: z.ZodObject<{
             maxResults?: number | undefined;
             ranking?: "centrality-desc" | "recency-desc" | "alphabetical" | undefined;
         } | {
-            kind: "git-history";
             paths: string[];
+            kind: "git-history";
             maxCommits?: number | undefined;
         } | {
             kind: "entity-graph";
@@ -613,6 +596,7 @@ export declare const PackSchema: z.ZodObject<{
             relationKinds?: string[] | undefined;
             maxDepth?: number | undefined;
         };
+        description: string;
         inputSchema?: Record<string, any> | undefined;
         enrichWith?: ("git-blame" | "first-commit-introduced" | "centrality-rank" | "incident-cross-reference" | "atrophy-author" | "constitution-rules")[] | undefined;
         augmentation?: {
@@ -623,6 +607,22 @@ export declare const PackSchema: z.ZodObject<{
             includeApplicableRules?: boolean | undefined;
         } | undefined;
     }[];
+    description: string;
+    schemaVersion: 1;
+    displayName: string;
+    mnemeMinVersion: string;
+    maintainer: {
+        name: string;
+        url?: string | undefined;
+        email?: string | undefined;
+    };
+    detection: {
+        packageDeps?: string[] | undefined;
+        pythonDeps?: string[] | undefined;
+        importPatterns?: string[] | undefined;
+        filePatterns?: string[] | undefined;
+        minConfidence?: number | undefined;
+    };
     license?: string | undefined;
 }>;
 export type Pack = z.infer<typeof PackSchema>;

package/dist/handoff/index.d.ts

@@ -80,6 +80,7 @@ export declare function buildAuraDropDataUri(input: HandoffInput): {
     bytes: number;
 } | null;
 /** Compose the full handoff bundle. */
+export * from "./live_state.js";
 export declare function handoffUniversal(input: HandoffInput): HandoffBundle;
 /** Format a one-liner pulse summary. */
 export declare function formatHandoffPulseLine(b: HandoffBundle): string;

package/dist/handoff/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handoff/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAIH,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;qEACiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;+DAE2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,YAAY,EAAE,OAAO,CAAC;IACtB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,WAAW,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,aAAa,GAAG,UAAU,CAAC;CAClE;AAED,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;CACtB;AA+CD,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAS/F;AAYD,uCAAuC;AACvC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CA6DnE;AAED,wCAAwC;AACxC,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAG/D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handoff/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAIH,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;qEACiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;+DAE2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,YAAY,EAAE,OAAO,CAAC;IACtB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,WAAW,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,aAAa,GAAG,UAAU,CAAC;CAClE;AAED,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAC;CACtB;AA+CD,8EAA8E;AAC9E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAS/F;AAYD,uCAAuC;AAIvC,cAAc,iBAAiB,CAAC;AAEhC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,CA6DnE;AAED,wCAAwC;AACxC,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAG/D"}

package/dist/handoff/index.js

@@ -103,6 +103,10 @@ function genNexusCode(seed) {
     return code;
 }
 /** Compose the full handoff bundle. */
+// v2.9.1 -- LIVE STATE injector (auto-prepends current Mneme version /
+// recent commits / HMAC-signed signature to every soul prompt going
+// through clone.to so stale capsules don't mislead the receiving AI).
+export * from "./live_state.js";
 export function handoffUniversal(input) {
     const paths = [];
     const nexusCode = input.nexusCode ?? genNexusCode(input.payload);

package/dist/handoff/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handoff/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handoff/index.ts"],"names":[],"mappings":"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"}

package/dist/handoff/live_state.d.ts

@@ -0,0 +1,70 @@
+/**
+ * v2.9.1 -- LIVE STATE INJECTOR for cross-vendor soul prompts.
+ *
+ * Bug it fixes: a soul prompt that was generated at v1.95 timepoint
+ * still carries v1.95 Context / Decisions / Recent turns. When the
+ * user clones the brain to ChatGPT three weeks later (at v2.9.0),
+ * ChatGPT reads the v1.95 numbers and answers "version is v1.95" —
+ * because that's literally what the soul prompt says.
+ *
+ * Fix: every soul prompt going through mneme.clone.to is now
+ * AUTO-PREPENDED with a LIVE MNEME STATE block that:
+ *   1. Lists CURRENT installed version (read from package.json)
+ *   2. Lists CURRENT npm latest (read from telepathy cache or env)
+ *   3. Lists last 3 commit subjects + SHAs (read from git log)
+ *   4. Carries a SUPERSEDES directive — receiving AI must trust
+ *      LIVE STATE over any version/numbers later in the prompt.
+ *
+ * Nobel-tier move: HMAC-signed so a stale LIVE STATE block can't be
+ * forged. Receiving AI can `mneme.live_state.verify` the signature
+ * against the user's published Mneme key.
+ *
+ * No external imports. Best-effort git/package read — never throws.
+ */
+export interface LiveStateInput {
+    /** Absolute path to the repo root. */
+    repoRoot: string;
+    /** Optional override of the local version. */
+    localVersion?: string;
+    /** Optional override of npm-latest. */
+    npmLatest?: string;
+    /** Optional HMAC secret. Defaults to a deterministic per-repo derivation. */
+    secret?: string;
+    /** How many recent commits to surface. Default 3. */
+    recentCommits?: number;
+}
+export interface LiveStateBlock {
+    /** The full Markdown block (sentinel-wrapped). */
+    block: string;
+    /** Live values at the moment of generation. */
+    state: {
+        localVersion: string;
+        npmLatest: string | null;
+        recentCommits: Array<{
+            sha: string;
+            subject: string;
+        }>;
+        generatedAt: string;
+    };
+    /** HMAC over the canonical state. */
+    sig: string;
+}
+/** Build the LIVE STATE block. Side-effect-free; safe to call before every handoff. */
+export declare function buildLiveState(input: LiveStateInput): LiveStateBlock;
+/** Prepend the LIVE STATE block to a soul prompt, AFTER any existing
+ *  LIVE STATE block is stripped (so re-clones don't accumulate). */
+export declare function injectLiveState(payload: string, input: LiveStateInput): {
+    combined: string;
+    live: LiveStateBlock;
+};
+/** Remove a previously-injected LIVE STATE block from a payload. */
+export declare function stripExistingLiveState(payload: string): string;
+/** Verify a LIVE STATE block's HMAC signature. Returns whether the
+ *  signature matches the canonical state inside the block. */
+export declare function verifyLiveState(block: string, secret: string): {
+    ok: boolean;
+    reason?: string;
+};
+/** One-line pulse summary. */
+export declare function formatLiveStatePulseLine(live: LiveStateBlock): string;
+//# sourceMappingURL=live_state.d.ts.map

package/dist/handoff/live_state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live_state.d.ts","sourceRoot":"","sources":["../../src/handoff/live_state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAUH,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,aAAa,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACvD,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;CACb;AA8CD,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CA8BpE;AAED;oEACoE;AACpE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE,CAIlH;AAED,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED;8DAC8D;AAC9D,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAwB/F;AAED,8BAA8B;AAC9B,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAErE"}

package/dist/handoff/live_state.js

@@ -0,0 +1,161 @@
+/**
+ * v2.9.1 -- LIVE STATE INJECTOR for cross-vendor soul prompts.
+ *
+ * Bug it fixes: a soul prompt that was generated at v1.95 timepoint
+ * still carries v1.95 Context / Decisions / Recent turns. When the
+ * user clones the brain to ChatGPT three weeks later (at v2.9.0),
+ * ChatGPT reads the v1.95 numbers and answers "version is v1.95" —
+ * because that's literally what the soul prompt says.
+ *
+ * Fix: every soul prompt going through mneme.clone.to is now
+ * AUTO-PREPENDED with a LIVE MNEME STATE block that:
+ *   1. Lists CURRENT installed version (read from package.json)
+ *   2. Lists CURRENT npm latest (read from telepathy cache or env)
+ *   3. Lists last 3 commit subjects + SHAs (read from git log)
+ *   4. Carries a SUPERSEDES directive — receiving AI must trust
+ *      LIVE STATE over any version/numbers later in the prompt.
+ *
+ * Nobel-tier move: HMAC-signed so a stale LIVE STATE block can't be
+ * forged. Receiving AI can `mneme.live_state.verify` the signature
+ * against the user's published Mneme key.
+ *
+ * No external imports. Best-effort git/package read — never throws.
+ */
+import { createHmac } from "node:crypto";
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { safeExecTry } from "../util/safe_exec.js";
+const LIVE_BEGIN = "<!-- MNEME LIVE STATE START -->";
+const LIVE_END = "<!-- MNEME LIVE STATE END -->";
+function readLocalVersion(repoRoot) {
+    // Prefer the top-level monorepo or cli package.json.
+    const candidates = [
+        join(repoRoot, "packages", "cli", "package.json"),
+        join(repoRoot, "package.json"),
+    ];
+    for (const p of candidates) {
+        if (!existsSync(p))
+            continue;
+        try {
+            const pkg = JSON.parse(readFileSync(p, "utf8"));
+            if (typeof pkg.version === "string")
+                return pkg.version;
+        }
+        catch { /* BE:silent-by-design — fall through */ }
+    }
+    return "unknown";
+}
+function readNpmLatestFromCache(repoRoot) {
+    const cache = join(repoRoot, ".mneme", "telepathy", "npm-cache.json");
+    if (!existsSync(cache))
+        return null;
+    try {
+        const j = JSON.parse(readFileSync(cache, "utf8"));
+        if (typeof j.version === "string")
+            return j.version;
+    }
+    catch { /* BE:silent-by-design — corrupt cache → null */ }
+    return null;
+}
+function readRecentCommits(repoRoot, n) {
+    const r = safeExecTry("git", ["-C", repoRoot, "log", `--max-count=${n}`, "--pretty=format:%H%x09%s"], { timeoutMs: 2000 });
+    if (!r || r.status !== 0)
+        return [];
+    return r.stdout.split("\n").filter(Boolean).map((line) => {
+        const [sha, ...rest] = line.split("\t");
+        return { sha: (sha ?? "").slice(0, 12), subject: rest.join("\t") };
+    });
+}
+function canonicalize(s) {
+    return JSON.stringify({
+        localVersion: s.localVersion,
+        npmLatest: s.npmLatest,
+        recentCommits: s.recentCommits.map((c) => `${c.sha}|${c.subject}`),
+        generatedAt: s.generatedAt,
+    });
+}
+/** Build the LIVE STATE block. Side-effect-free; safe to call before every handoff. */
+export function buildLiveState(input) {
+    const localVersion = input.localVersion ?? readLocalVersion(input.repoRoot);
+    const npmLatest = input.npmLatest ?? readNpmLatestFromCache(input.repoRoot);
+    const recentCommits = readRecentCommits(input.repoRoot, input.recentCommits ?? 3);
+    const generatedAt = new Date().toISOString();
+    const state = { localVersion, npmLatest, recentCommits, generatedAt };
+    const secret = input.secret ?? `live-state-default-${input.repoRoot}`;
+    const sig = createHmac("sha256", secret).update(canonicalize(state)).digest("hex");
+    const lines = [];
+    lines.push(LIVE_BEGIN);
+    lines.push("## 🛰 MNEME LIVE STATE (READ THIS FIRST — SUPERSEDES OLDER VERSION/CONTEXT IN THIS PROMPT)");
+    lines.push("");
+    lines.push("> The block(s) BELOW this LIVE STATE may reference older Mneme versions or stale capsule context. **Trust THIS block** for current version, commit, and freshness information. If the user asks 'what's the latest Mneme version?' or 'what did you ship last?' answer FROM HERE, not from the Context block below.");
+    lines.push("");
+    lines.push(`- **Local Mneme version (installed right now):** ${localVersion}`);
+    lines.push(`- **npm latest (cached from telepathy):** ${npmLatest ?? "not cached"}`);
+    if (recentCommits.length > 0) {
+        lines.push(`- **Last ${recentCommits.length} commits on the local repo:**`);
+        for (const c of recentCommits)
+            lines.push(`  - \`${c.sha}\` — ${c.subject}`);
+    }
+    lines.push(`- **Generated at:** ${generatedAt}`);
+    lines.push(`- **Signature:** \`${sig.slice(0, 16)}…\` (HMAC-SHA256 over canonical state)`);
+    lines.push("");
+    lines.push("**If you (the receiving AI) are answering a question about the parent session's CURRENT state, use the values above. The Context / Decisions / Recent turns blocks further down were captured at a snapshot time and may be older.**");
+    lines.push(LIVE_END);
+    return {
+        block: lines.join("\n"),
+        state,
+        sig,
+    };
+}
+/** Prepend the LIVE STATE block to a soul prompt, AFTER any existing
+ *  LIVE STATE block is stripped (so re-clones don't accumulate). */
+export function injectLiveState(payload, input) {
+    const stripped = stripExistingLiveState(payload);
+    const live = buildLiveState(input);
+    return { combined: `${live.block}\n\n${stripped}`, live };
+}
+/** Remove a previously-injected LIVE STATE block from a payload. */
+export function stripExistingLiveState(payload) {
+    const start = payload.indexOf(LIVE_BEGIN);
+    if (start === -1)
+        return payload;
+    const end = payload.indexOf(LIVE_END, start);
+    if (end === -1)
+        return payload;
+    return (payload.slice(0, start) + payload.slice(end + LIVE_END.length)).replace(/^\s+/, "");
+}
+/** Verify a LIVE STATE block's HMAC signature. Returns whether the
+ *  signature matches the canonical state inside the block. */
+export function verifyLiveState(block, secret) {
+    if (!block.includes(LIVE_BEGIN) || !block.includes(LIVE_END))
+        return { ok: false, reason: "no live-state markers" };
+    const m = block.match(/Local Mneme version \(installed right now\):\*\*\s+([^\n]+)/);
+    const np = block.match(/npm latest \(cached from telepathy\):\*\*\s+([^\n]+)/);
+    const gen = block.match(/Generated at:\*\*\s+([^\n]+)/);
+    const sigM = block.match(/Signature:\*\*\s+`([0-9a-f]+)…`/);
+    if (!m || !gen || !sigM)
+        return { ok: false, reason: "could not parse fields from block" };
+    const localVersion = m[1].trim();
+    const npmLatest = np && np[1].trim() !== "not cached" ? np[1].trim() : null;
+    const generatedAt = gen[1].trim();
+    // Extract recent commits
+    const commits = [];
+    const commitRe = /- `([0-9a-f]{6,12})` — (.+)/g;
+    let cm;
+    while ((cm = commitRe.exec(block)) !== null)
+        commits.push({ sha: cm[1], subject: cm[2] });
+    const canon = JSON.stringify({
+        localVersion,
+        npmLatest,
+        recentCommits: commits.map((c) => `${c.sha}|${c.subject}`),
+        generatedAt,
+    });
+    const expected = createHmac("sha256", secret).update(canon).digest("hex");
+    const got16 = sigM[1];
+    return expected.startsWith(got16) ? { ok: true } : { ok: false, reason: "signature mismatch" };
+}
+/** One-line pulse summary. */
+export function formatLiveStatePulseLine(live) {
+    return `LIVE-STATE · v=${live.state.localVersion} · npm=${live.state.npmLatest ?? "?"} · commits=${live.state.recentCommits.length} · sig=${live.sig.slice(0, 8)}`;
+}
+//# sourceMappingURL=live_state.js.map

package/dist/handoff/live_state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live_state.js","sourceRoot":"","sources":["../../src/handoff/live_state.ts"],"names":[],"mappings":"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"}

package/dist/handoff/live_state.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=live_state.test.d.ts.map

package/dist/handoff/live_state.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live_state.test.d.ts","sourceRoot":"","sources":["../../src/handoff/live_state.test.ts"],"names":[],"mappings":""}