@mnemonik/shared 7.39.0 → 7.39.2

package/LICENSE

@@ -0,0 +1,38 @@
+MNEMONIK PROPRIETARY SOFTWARE LICENSE
+
+Copyright © 2026 JayDeeCo Limited. All rights reserved.
+
+This licence applies to the Mnemonik software distributed with this file
+(the "Software").
+
+Subject to the Mnemonik Terms of Service and while you are an authorised
+Mnemonik account holder, JayDeeCo Limited grants you a limited, revocable,
+non-exclusive, non-transferable, non-sublicensable licence to download,
+install, and run unmodified copies of the Software solely to access and use
+the Mnemonik service. This permission applies to authorised free, trial, and
+paid accounts.
+
+You may not:
+
+1. modify the Software or create derivative works from it;
+2. reverse engineer, decompile, or disassemble the Software, except to the
+   extent that applicable law does not permit this restriction;
+3. redistribute, publish, sell, rent, lease, sublicense, or resell the
+   Software or access to it;
+4. use the Software to build or operate a product or service that competes
+   with Mnemonik;
+5. remove or alter any copyright, trade mark, attribution, or proprietary
+   notice; or
+6. bypass authentication, service limits, or technical restrictions.
+
+JayDeeCo Limited and its licensors retain all right, title, and interest in
+the Software. No rights are granted except those expressly stated here.
+
+This licence ends automatically when your right to use Mnemonik ends or if
+you breach this licence or the Mnemonik Terms of Service. When it ends, you
+must stop using the Software and delete copies in your possession or control.
+
+Third-party components remain subject to their own licences. The warranty
+disclaimers, limitations of liability, termination terms, and governing law
+in the Mnemonik Terms of Service at https://mnemonik.ai/terms apply to this
+licence and the Software.

package/dist/ambientPointer.d.ts

@@ -0,0 +1,4 @@
+export declare const AMBIENT_ID_PREFIX_LENGTH = 8;
+export declare const AMBIENT_ITEM_POINTER_SOURCE = "\u2014\\s*memory_get\\s+([0-9A-Za-z_-]{8})(?![0-9A-Za-z_-])";
+export declare function ambientItemPointerRegex(flags?: string): RegExp;
+//# sourceMappingURL=ambientPointer.d.ts.map

package/dist/ambientPointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambientPointer.d.ts","sourceRoot":"","sources":["../src/ambientPointer.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,eAAO,MAAM,2BAA2B,gEAAqF,CAAC;AAE9H,wBAAgB,uBAAuB,CAAC,KAAK,SAAM,GAAG,MAAM,CAE3D"}

package/dist/ambientPointer.js

@@ -0,0 +1,6 @@
+export const AMBIENT_ID_PREFIX_LENGTH = 8;
+export const AMBIENT_ITEM_POINTER_SOURCE = `—\\s*memory_get\\s+([0-9A-Za-z_-]{${AMBIENT_ID_PREFIX_LENGTH}})(?![0-9A-Za-z_-])`;
+export function ambientItemPointerRegex(flags = 'g') {
+    return new RegExp(AMBIENT_ITEM_POINTER_SOURCE, flags);
+}
+//# sourceMappingURL=ambientPointer.js.map

package/dist/ambientPointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambientPointer.js","sourceRoot":"","sources":["../src/ambientPointer.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAE1C,MAAM,CAAC,MAAM,2BAA2B,GAAG,qCAAqC,wBAAwB,qBAAqB,CAAC;AAE9H,MAAM,UAAU,uBAAuB,CAAC,KAAK,GAAG,GAAG;IACjD,OAAO,IAAI,MAAM,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC"}

package/dist/hookRuntime.d.ts

@@ -0,0 +1,10 @@
+export interface ProjectIdentity {
+    projectId?: string;
+    projectName?: string;
+    projectRoot: string;
+}
+export declare function findProjectIdentity(startCwd: string, opts?: {
+    maxDepth?: number;
+}): Promise<ProjectIdentity | null>;
+export declare function parseHookResponse<T>(response: Response): Promise<T>;
+//# sourceMappingURL=hookRuntime.d.ts.map

package/dist/hookRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookRuntime.d.ts","sourceRoot":"","sources":["../src/hookRuntime.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CA6BjC;AAID,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAYzE"}

package/dist/hookRuntime.js

@@ -0,0 +1,48 @@
+import { readFile } from 'node:fs/promises';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { stderr } from 'node:process';
+const identityCache = new Map();
+export async function findProjectIdentity(startCwd, opts = {}) {
+    if (!startCwd)
+        return null;
+    if (identityCache.has(startCwd))
+        return identityCache.get(startCwd);
+    let directory = isAbsolute(startCwd) ? startCwd : resolve(startCwd);
+    const maxDepth = opts.maxDepth ?? 10;
+    for (let depth = 0; depth <= maxDepth; depth += 1) {
+        try {
+            const parsed = JSON.parse(await readFile(join(directory, '.mnemonik.json'), 'utf8'));
+            if (typeof parsed.projectId === 'string' && parsed.projectId.length > 0) {
+                const identity = {
+                    projectId: parsed.projectId,
+                    projectName: typeof parsed.projectName === 'string' ? parsed.projectName : undefined,
+                    projectRoot: directory,
+                };
+                identityCache.set(startCwd, identity);
+                return identity;
+            }
+        }
+        catch {
+            // Missing, unreadable, or malformed: keep walking upward.
+        }
+        const parent = dirname(directory);
+        if (parent === directory)
+            break;
+        directory = parent;
+    }
+    identityCache.set(startCwd, null);
+    return null;
+}
+let mismatchEmitted = false;
+export async function parseHookResponse(response) {
+    const body = (await response.json());
+    const result = body;
+    if (!mismatchEmitted && result?.ok === false && result.reason === 'identity_mismatch') {
+        stderr.write('mnemonik-hook: project identity mismatch — .mnemonik.json points to one project, ' +
+            'but this directory is registered to a different one on the server. ' +
+            'Fix .mnemonik.json (delete it and let session_bootstrap rewrite it) or cd to the correct project root.\n');
+        mismatchEmitted = true;
+    }
+    return body;
+}
+//# sourceMappingURL=hookRuntime.js.map

package/dist/hookRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hookRuntime.js","sourceRoot":"","sources":["../src/hookRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAQtC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkC,CAAC;AAEhE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,QAAgB,EAChB,IAAI,GAA0B,EAAE;IAEhC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,OAAO,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;IAErE,IAAI,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;IACrC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CACvB,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,CAC/B,CAAC;YAC7B,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxE,MAAM,QAAQ,GAAoB;oBAChC,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,WAAW,EAAE,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;oBACpF,WAAW,EAAE,SAAS;iBACvB,CAAC;gBACF,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACtC,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0DAA0D;QAC5D,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM;QAChC,SAAS,GAAG,MAAM,CAAC;IACrB,CAAC;IACD,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,IAAI,eAAe,GAAG,KAAK,CAAC;AAE5B,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAI,QAAkB;IAC3D,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAyC,CAAC;IACzD,IAAI,CAAC,eAAe,IAAI,MAAM,EAAE,EAAE,KAAK,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,mBAAmB,EAAE,CAAC;QACtF,MAAM,CAAC,KAAK,CACV,mFAAmF;YACjF,qEAAqE;YACrE,0GAA0G,CAC7G,CAAC;QACF,eAAe,GAAG,IAAI,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnemonik/shared",
-  "version": "7.39.0",
+  "version": "7.39.2",
   "description": "Shared constants and utilities for Mnemonik packages",
   "type": "module",
   "main": "dist/index.js",
@@ -13,6 +13,14 @@
     "./hook-timeouts": {
       "import": "./dist/hookTimeouts.js",
       "types": "./dist/hookTimeouts.d.ts"
+    },
+    "./hook-runtime": {
+      "import": "./dist/hookRuntime.js",
+      "types": "./dist/hookRuntime.d.ts"
+    },
+    "./ambient-pointer": {
+      "import": "./dist/ambientPointer.js",
+      "types": "./dist/ambientPointer.d.ts"
     }
   },
   "scripts": {
@@ -26,7 +34,7 @@
     "constants"
   ],
   "author": "Anthony",
-  "license": "UNLICENSED",
+  "license": "SEE LICENSE IN LICENSE",
   "dependencies": {
     "ignore": "^7.0.6",
     "web-tree-sitter": "0.26.11"

package/src/ambientPointer.ts

@@ -0,0 +1,7 @@
+export const AMBIENT_ID_PREFIX_LENGTH = 8;
+
+export const AMBIENT_ITEM_POINTER_SOURCE = `—\\s*memory_get\\s+([0-9A-Za-z_-]{${AMBIENT_ID_PREFIX_LENGTH}})(?![0-9A-Za-z_-])`;
+
+export function ambientItemPointerRegex(flags = 'g'): RegExp {
+  return new RegExp(AMBIENT_ITEM_POINTER_SOURCE, flags);
+}

package/src/hookRuntime.ts

@@ -0,0 +1,61 @@
+import { readFile } from 'node:fs/promises';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { stderr } from 'node:process';
+
+export interface ProjectIdentity {
+  projectId?: string;
+  projectName?: string;
+  projectRoot: string;
+}
+
+const identityCache = new Map<string, ProjectIdentity | null>();
+
+export async function findProjectIdentity(
+  startCwd: string,
+  opts: { maxDepth?: number } = {}
+): Promise<ProjectIdentity | null> {
+  if (!startCwd) return null;
+  if (identityCache.has(startCwd)) return identityCache.get(startCwd)!;
+
+  let directory = isAbsolute(startCwd) ? startCwd : resolve(startCwd);
+  const maxDepth = opts.maxDepth ?? 10;
+  for (let depth = 0; depth <= maxDepth; depth += 1) {
+    try {
+      const parsed = JSON.parse(
+        await readFile(join(directory, '.mnemonik.json'), 'utf8')
+      ) as Record<string, unknown>;
+      if (typeof parsed.projectId === 'string' && parsed.projectId.length > 0) {
+        const identity: ProjectIdentity = {
+          projectId: parsed.projectId,
+          projectName: typeof parsed.projectName === 'string' ? parsed.projectName : undefined,
+          projectRoot: directory,
+        };
+        identityCache.set(startCwd, identity);
+        return identity;
+      }
+    } catch {
+      // Missing, unreadable, or malformed: keep walking upward.
+    }
+    const parent = dirname(directory);
+    if (parent === directory) break;
+    directory = parent;
+  }
+  identityCache.set(startCwd, null);
+  return null;
+}
+
+let mismatchEmitted = false;
+
+export async function parseHookResponse<T>(response: Response): Promise<T> {
+  const body = (await response.json()) as T;
+  const result = body as { ok?: boolean; reason?: string };
+  if (!mismatchEmitted && result?.ok === false && result.reason === 'identity_mismatch') {
+    stderr.write(
+      'mnemonik-hook: project identity mismatch — .mnemonik.json points to one project, ' +
+        'but this directory is registered to a different one on the server. ' +
+        'Fix .mnemonik.json (delete it and let session_bootstrap rewrite it) or cd to the correct project root.\n'
+    );
+    mismatchEmitted = true;
+  }
+  return body;
+}