@mnemonik/shared 6.2.2 → 6.2.4

package/dist/instructions.d.ts

@@ -4,14 +4,8 @@
  * This is the SINGLE SOURCE OF TRUTH for MCP instructions.
  * Shared instruction content imported by the server.
  *
- * Version: 2.103
- * Updated: 2026-07-11
- *
- * v2.103 — Removed the model-facing initialize imperative. MCP initialize
- *         runs before actor/project/host orchestration can be classified, so
- *         it cannot safely own bootstrap timing. Config-B/C bootstrap belongs
- *         to hooks/proxy; the project-resolved response path owns Config-A.
- *         Returning an empty string makes the server omit `instructions`.
+ * Version: 2.102
+ * Updated: 2026-06-29
  *
  * v2.102 — Strengthened the self-bootstrap trigger to a compelling imperative.
  *         The v2.101 phrasing ("At the start of a session, unless ... call ...")
@@ -88,15 +82,24 @@
  *
  * Token-optimised rewrite (superseded by later instruction rewrites).
  */
-/** MCP initialize intentionally carries no model-facing orchestration. */
+/**
+ * Get MCP instructions, respecting MNEMONIK_INSTRUCTIONS_ENABLED env var.
+ * Set MNEMONIK_INSTRUCTIONS_ENABLED=false to disable for testing.
+ *
+ * Reads env through globalThis so this package compiles cleanly without
+ * `@types/node` (shared package's tsconfig doesn't include it, which made
+ * IDEs flag `process` as an unknown global even though the workspace
+ * tsc resolution found it).
+ */
 export declare function getMcpInstructions(): string;
 /**
  * Raw instructions content (always returns the content, ignores env var).
  * Use getMcpInstructions() for production code.
  */
-export declare const MCP_INSTRUCTIONS_RAW = "";
+export declare const MCP_INSTRUCTIONS_RAW = "If your context does not contain a block beginning \"Mnemonik project context (cached\", call session_bootstrap before replying or taking any other action \u2014 e.g. session_bootstrap({ cwd: \"/absolute/path/to/project\" }), where cwd is the real absolute path to the project root you are working in (required; the call fails without it \u2014 substitute your actual path, not the example). It loads this project's prior decisions, open tasks, and policies. If that block is already present, do not call session_bootstrap; the context is already loaded.";
 /**
  * Default export for convenience.
+ * Note: This respects the MNEMONIK_INSTRUCTIONS_ENABLED env var.
  */
 export declare const MCP_INSTRUCTIONS: string;
 //# sourceMappingURL=instructions.d.ts.map

package/dist/instructions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyFG;AAIH,0EAA0E;AAC1E,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,KAAuB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,gBAAgB,QAAuB,CAAC"}
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AAIH;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAO3C;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,+iBAAuB,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAuB,CAAC"}

package/dist/instructions.js

@@ -4,14 +4,8 @@
  * This is the SINGLE SOURCE OF TRUTH for MCP instructions.
  * Shared instruction content imported by the server.
  *
- * Version: 2.103
- * Updated: 2026-07-11
- *
- * v2.103 — Removed the model-facing initialize imperative. MCP initialize
- *         runs before actor/project/host orchestration can be classified, so
- *         it cannot safely own bootstrap timing. Config-B/C bootstrap belongs
- *         to hooks/proxy; the project-resolved response path owns Config-A.
- *         Returning an empty string makes the server omit `instructions`.
+ * Version: 2.102
+ * Updated: 2026-06-29
  *
  * v2.102 — Strengthened the self-bootstrap trigger to a compelling imperative.
  *         The v2.101 phrasing ("At the start of a session, unless ... call ...")
@@ -88,9 +82,22 @@
  *
  * Token-optimised rewrite (superseded by later instruction rewrites).
  */
-const INSTRUCTIONS_CONTENT = '';
-/** MCP initialize intentionally carries no model-facing orchestration. */
+const INSTRUCTIONS_CONTENT = `If your context does not contain a block beginning "Mnemonik project context (cached", call session_bootstrap before replying or taking any other action — e.g. session_bootstrap({ cwd: "/absolute/path/to/project" }), where cwd is the real absolute path to the project root you are working in (required; the call fails without it — substitute your actual path, not the example). It loads this project's prior decisions, open tasks, and policies. If that block is already present, do not call session_bootstrap; the context is already loaded.`;
+/**
+ * Get MCP instructions, respecting MNEMONIK_INSTRUCTIONS_ENABLED env var.
+ * Set MNEMONIK_INSTRUCTIONS_ENABLED=false to disable for testing.
+ *
+ * Reads env through globalThis so this package compiles cleanly without
+ * `@types/node` (shared package's tsconfig doesn't include it, which made
+ * IDEs flag `process` as an unknown global even though the workspace
+ * tsc resolution found it).
+ */
 export function getMcpInstructions() {
+    const env = globalThis.process
+        ?.env;
+    if (env?.MNEMONIK_INSTRUCTIONS_ENABLED === 'false') {
+        return '';
+    }
     return INSTRUCTIONS_CONTENT;
 }
 /**
@@ -100,6 +107,7 @@ export function getMcpInstructions() {
 export const MCP_INSTRUCTIONS_RAW = INSTRUCTIONS_CONTENT;
 /**
  * Default export for convenience.
+ * Note: This respects the MNEMONIK_INSTRUCTIONS_ENABLED env var.
  */
 export const MCP_INSTRUCTIONS = getMcpInstructions();
 //# sourceMappingURL=instructions.js.map

package/dist/instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyFG;AAEH,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC,0EAA0E;AAC1E,MAAM,UAAU,kBAAkB;IAChC,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AAEH,MAAM,oBAAoB,GAAG,8hBAA8hB,CAAC;AAE5jB;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,GAAG,GAAI,UAAyE,CAAC,OAAO;QAC5F,EAAE,GAAG,CAAC;IACR,IAAI,GAAG,EAAE,6BAA6B,KAAK,OAAO,EAAE,CAAC;QACnD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAEzD;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnemonik/shared",
-  "version": "6.2.2",
+  "version": "6.2.4",
   "description": "Shared constants and utilities for Mnemonik packages",
   "type": "module",
   "main": "dist/index.js",

package/src/instructions.ts

@@ -4,14 +4,8 @@
  * This is the SINGLE SOURCE OF TRUTH for MCP instructions.
  * Shared instruction content imported by the server.
  *
- * Version: 2.103
- * Updated: 2026-07-11
- *
- * v2.103 — Removed the model-facing initialize imperative. MCP initialize
- *         runs before actor/project/host orchestration can be classified, so
- *         it cannot safely own bootstrap timing. Config-B/C bootstrap belongs
- *         to hooks/proxy; the project-resolved response path owns Config-A.
- *         Returning an empty string makes the server omit `instructions`.
+ * Version: 2.102
+ * Updated: 2026-06-29
  *
  * v2.102 — Strengthened the self-bootstrap trigger to a compelling imperative.
  *         The v2.101 phrasing ("At the start of a session, unless ... call ...")
@@ -89,10 +83,23 @@
  * Token-optimised rewrite (superseded by later instruction rewrites).
  */
 
-const INSTRUCTIONS_CONTENT = '';
+const INSTRUCTIONS_CONTENT = `If your context does not contain a block beginning "Mnemonik project context (cached", call session_bootstrap before replying or taking any other action — e.g. session_bootstrap({ cwd: "/absolute/path/to/project" }), where cwd is the real absolute path to the project root you are working in (required; the call fails without it — substitute your actual path, not the example). It loads this project's prior decisions, open tasks, and policies. If that block is already present, do not call session_bootstrap; the context is already loaded.`;
 
-/** MCP initialize intentionally carries no model-facing orchestration. */
+/**
+ * Get MCP instructions, respecting MNEMONIK_INSTRUCTIONS_ENABLED env var.
+ * Set MNEMONIK_INSTRUCTIONS_ENABLED=false to disable for testing.
+ *
+ * Reads env through globalThis so this package compiles cleanly without
+ * `@types/node` (shared package's tsconfig doesn't include it, which made
+ * IDEs flag `process` as an unknown global even though the workspace
+ * tsc resolution found it).
+ */
 export function getMcpInstructions(): string {
+  const env = (globalThis as { process?: { env?: Record<string, string | undefined> } }).process
+    ?.env;
+  if (env?.MNEMONIK_INSTRUCTIONS_ENABLED === 'false') {
+    return '';
+  }
   return INSTRUCTIONS_CONTENT;
 }
 
@@ -104,5 +111,6 @@ export const MCP_INSTRUCTIONS_RAW = INSTRUCTIONS_CONTENT;
 
 /**
  * Default export for convenience.
+ * Note: This respects the MNEMONIK_INSTRUCTIONS_ENABLED env var.
  */
 export const MCP_INSTRUCTIONS = getMcpInstructions();