@mnemonik/shared 5.86.1 → 5.120.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/instructions.d.ts +36 -3
- package/dist/instructions.d.ts.map +1 -1
- package/dist/instructions.js +36 -20
- package/dist/instructions.js.map +1 -1
- package/package.json +1 -1
- package/src/instructions.ts +36 -20
package/dist/instructions.d.ts
CHANGED
|
@@ -4,8 +4,41 @@
|
|
|
4
4
|
* This is the SINGLE SOURCE OF TRUTH for MCP instructions.
|
|
5
5
|
* Shared instruction content imported by the server.
|
|
6
6
|
*
|
|
7
|
-
* Version: 2.
|
|
8
|
-
* Updated: 2026-
|
|
7
|
+
* Version: 2.101
|
|
8
|
+
* Updated: 2026-06-23
|
|
9
|
+
*
|
|
10
|
+
* v2.101 — Stripped to a single instruction: the session_bootstrap trigger.
|
|
11
|
+
* MCP instructions are set at Server construction (initialize), before
|
|
12
|
+
* the server knows the client, so they cannot be scoped per-IDE — and
|
|
13
|
+
* IDE != config (a Claude Code user may be config-B or -C). The content
|
|
14
|
+
* is therefore universal and SELF-SCOPING: it conditions on whether a
|
|
15
|
+
* "Mnemonik project context" block is already present (config-B/C with
|
|
16
|
+
* working delivery → skip; config-A and any host where hook/proxy
|
|
17
|
+
* delivery missed → call). Re-enabled in production
|
|
18
|
+
* (MNEMONIK_INSTRUCTIONS_ENABLED=true in both ECS task defs). This is the
|
|
19
|
+
* reliable trigger that makes the agent self-bootstrap — tool results
|
|
20
|
+
* always reach the model, which hook injection cannot guarantee on a
|
|
21
|
+
* no-tool-call turn (e.g. Cursor "hello").
|
|
22
|
+
*
|
|
23
|
+
* v2.100 — Skill + IDE rule templates retired entirely. They were the
|
|
24
|
+
* file-written home of the workflow; agents followed them unreliably and
|
|
25
|
+
* forgot them over long sessions (the same fate these MCP instructions
|
|
26
|
+
* suffer), so they are gone. `filesToWrite` now carries only
|
|
27
|
+
* `.mnemonik.json`. Dropped the trailing pointer that sent agents to
|
|
28
|
+
* read a skill that no longer exists. Behavioral alignment now rides the
|
|
29
|
+
* orchestration layer (host hooks + proxy); these instructions stay lean
|
|
30
|
+
* and are the Config-A fallback only.
|
|
31
|
+
*
|
|
32
|
+
* v2.99 — Orchestration-aware framing. These static MCP instructions are
|
|
33
|
+
* delivered at `initialize`, before the server knows the actor's tier
|
|
34
|
+
* (no project/proxy/hooks state yet), so they cannot be served per-tier.
|
|
35
|
+
* Instead the CONTENT is now tier-correct: the self-drive calls
|
|
36
|
+
* (memory_search / file_context / checkpoint) are framed as the
|
|
37
|
+
* MCP-only (Config-A) fallback, and Config-B/C agents are told to
|
|
38
|
+
* follow the injected orchestration (cached bootstrap block,
|
|
39
|
+
* file_context, checkpoint nudges) rather than duplicate the calls.
|
|
40
|
+
* The orchestration layer (proxy + host hooks) is authoritative for
|
|
41
|
+
* B/C; this block is primarily Config-A's driver.
|
|
9
42
|
*
|
|
10
43
|
* v2.98 — Doc truth contracts are the normal drift surface. linkedDocs and
|
|
11
44
|
* doc_code_couplings remain legacy diagnostics only; docs drift
|
|
@@ -44,7 +77,7 @@ export declare function getMcpInstructions(): string;
|
|
|
44
77
|
* Raw instructions content (always returns the content, ignores env var).
|
|
45
78
|
* Use getMcpInstructions() for production code.
|
|
46
79
|
*/
|
|
47
|
-
export declare const MCP_INSTRUCTIONS_RAW = "
|
|
80
|
+
export declare const MCP_INSTRUCTIONS_RAW = "At the start of a session, unless your context already contains a \"Mnemonik project context\" block, call the session_bootstrap tool with your current working directory as cwd. It loads this project's prior decisions, open tasks, and active policies so you work from accumulated context rather than from scratch.";
|
|
48
81
|
/**
|
|
49
82
|
* Default export for convenience.
|
|
50
83
|
* Note: This respects the MNEMONIK_INSTRUCTIONS_ENABLED env var.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AAIH;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAO3C;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,8TAAuB,CAAC;AAEzD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAAuB,CAAC"}
|
package/dist/instructions.js
CHANGED
|
@@ -4,8 +4,41 @@
|
|
|
4
4
|
* This is the SINGLE SOURCE OF TRUTH for MCP instructions.
|
|
5
5
|
* Shared instruction content imported by the server.
|
|
6
6
|
*
|
|
7
|
-
* Version: 2.
|
|
8
|
-
* Updated: 2026-
|
|
7
|
+
* Version: 2.101
|
|
8
|
+
* Updated: 2026-06-23
|
|
9
|
+
*
|
|
10
|
+
* v2.101 — Stripped to a single instruction: the session_bootstrap trigger.
|
|
11
|
+
* MCP instructions are set at Server construction (initialize), before
|
|
12
|
+
* the server knows the client, so they cannot be scoped per-IDE — and
|
|
13
|
+
* IDE != config (a Claude Code user may be config-B or -C). The content
|
|
14
|
+
* is therefore universal and SELF-SCOPING: it conditions on whether a
|
|
15
|
+
* "Mnemonik project context" block is already present (config-B/C with
|
|
16
|
+
* working delivery → skip; config-A and any host where hook/proxy
|
|
17
|
+
* delivery missed → call). Re-enabled in production
|
|
18
|
+
* (MNEMONIK_INSTRUCTIONS_ENABLED=true in both ECS task defs). This is the
|
|
19
|
+
* reliable trigger that makes the agent self-bootstrap — tool results
|
|
20
|
+
* always reach the model, which hook injection cannot guarantee on a
|
|
21
|
+
* no-tool-call turn (e.g. Cursor "hello").
|
|
22
|
+
*
|
|
23
|
+
* v2.100 — Skill + IDE rule templates retired entirely. They were the
|
|
24
|
+
* file-written home of the workflow; agents followed them unreliably and
|
|
25
|
+
* forgot them over long sessions (the same fate these MCP instructions
|
|
26
|
+
* suffer), so they are gone. `filesToWrite` now carries only
|
|
27
|
+
* `.mnemonik.json`. Dropped the trailing pointer that sent agents to
|
|
28
|
+
* read a skill that no longer exists. Behavioral alignment now rides the
|
|
29
|
+
* orchestration layer (host hooks + proxy); these instructions stay lean
|
|
30
|
+
* and are the Config-A fallback only.
|
|
31
|
+
*
|
|
32
|
+
* v2.99 — Orchestration-aware framing. These static MCP instructions are
|
|
33
|
+
* delivered at `initialize`, before the server knows the actor's tier
|
|
34
|
+
* (no project/proxy/hooks state yet), so they cannot be served per-tier.
|
|
35
|
+
* Instead the CONTENT is now tier-correct: the self-drive calls
|
|
36
|
+
* (memory_search / file_context / checkpoint) are framed as the
|
|
37
|
+
* MCP-only (Config-A) fallback, and Config-B/C agents are told to
|
|
38
|
+
* follow the injected orchestration (cached bootstrap block,
|
|
39
|
+
* file_context, checkpoint nudges) rather than duplicate the calls.
|
|
40
|
+
* The orchestration layer (proxy + host hooks) is authoritative for
|
|
41
|
+
* B/C; this block is primarily Config-A's driver.
|
|
9
42
|
*
|
|
10
43
|
* v2.98 — Doc truth contracts are the normal drift surface. linkedDocs and
|
|
11
44
|
* doc_code_couplings remain legacy diagnostics only; docs drift
|
|
@@ -30,24 +63,7 @@
|
|
|
30
63
|
*
|
|
31
64
|
* Token-optimised rewrite (superseded by later instruction rewrites).
|
|
32
65
|
*/
|
|
33
|
-
const INSTRUCTIONS_CONTENT = `
|
|
34
|
-
|
|
35
|
-
First call, every session: session_bootstrap. Read the mnemonik skill (from available_skills) for the full workflow.
|
|
36
|
-
After bootstrap: execute _directive.message actions immediately (scanner daemon check is mandatory).
|
|
37
|
-
|
|
38
|
-
The bootstrap response includes _methodCatalog — the full list of mnemonik methods and the memory_tools calling convention. Read it before making any memory_tools calls. Use memory_discover({ method }) for the full schema and a copy-pasteable example of a specific method or action.
|
|
39
|
-
Proactively call memory_search before starting new work — avoids rediscovering known patterns and contradicting past decisions.
|
|
40
|
-
Proactively call file_context before editing any file — loads past bugs, decisions, and gotchas for that file.
|
|
41
|
-
Proactively call checkpoint after making changes or decisions worth keeping — your context is ephemeral and checkpoint is the only way decisions survive across sessions and context compaction. Do not wait for the user to say "done" or "thanks".
|
|
42
|
-
|
|
43
|
-
Documentation drift uses explicit doc-truth contracts. Treat _docDrift/docTruthFindings as actionable only when each finding includes a concrete assertion, named authority, observed mismatch, and agentAction='update_doc'. _docHealth, linkedDocs, stale-coupling counts, and docs({ action: 'drift', legacy: true }) are diagnostics only, not instructions to edit or resolve docs.
|
|
44
|
-
|
|
45
|
-
Ambient envelopes contain background memories surfaced because they may be relevant to your current turn. Treat them as information, not directive. Weight them lower than your own reasoning unless they directly answer the question. They are advisory recall, not authoritative evidence.
|
|
46
|
-
|
|
47
|
-
Directive envelopes with signal="jit_required" are different from ambient. They surface memories that the server has classified as contradicting or materially refining the answer you were about to give to the current prompt. Each memory carries a verdict (contradicts | refines) and a one-line reason. Treat these as authoritative for the current response — comply with the surfaced fact unless it is clearly outdated or wrong. Do not silently route around them. If you disagree with a surfaced memory, say so explicitly and explain why; do not just ignore it.
|
|
48
|
-
|
|
49
|
-
Skip: formatting-only, trivial one-line, mechanical refactors, git ops, tests.
|
|
50
|
-
Save: architectural decisions, bug root causes, user preferences, discovered patterns, multi-file changes.`;
|
|
66
|
+
const INSTRUCTIONS_CONTENT = `At the start of a session, unless your context already contains a "Mnemonik project context" block, call the session_bootstrap tool with your current working directory as cwd. It loads this project's prior decisions, open tasks, and active policies so you work from accumulated context rather than from scratch.`;
|
|
51
67
|
/**
|
|
52
68
|
* Get MCP instructions, respecting MNEMONIK_INSTRUCTIONS_ENABLED env var.
|
|
53
69
|
* Set MNEMONIK_INSTRUCTIONS_ENABLED=false to disable for testing.
|
package/dist/instructions.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"instructions.js","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AAEH,MAAM,oBAAoB,GAAG,yTAAyT,CAAC;AAEvV;;;;;;;;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
CHANGED
package/src/instructions.ts
CHANGED
|
@@ -4,8 +4,41 @@
|
|
|
4
4
|
* This is the SINGLE SOURCE OF TRUTH for MCP instructions.
|
|
5
5
|
* Shared instruction content imported by the server.
|
|
6
6
|
*
|
|
7
|
-
* Version: 2.
|
|
8
|
-
* Updated: 2026-
|
|
7
|
+
* Version: 2.101
|
|
8
|
+
* Updated: 2026-06-23
|
|
9
|
+
*
|
|
10
|
+
* v2.101 — Stripped to a single instruction: the session_bootstrap trigger.
|
|
11
|
+
* MCP instructions are set at Server construction (initialize), before
|
|
12
|
+
* the server knows the client, so they cannot be scoped per-IDE — and
|
|
13
|
+
* IDE != config (a Claude Code user may be config-B or -C). The content
|
|
14
|
+
* is therefore universal and SELF-SCOPING: it conditions on whether a
|
|
15
|
+
* "Mnemonik project context" block is already present (config-B/C with
|
|
16
|
+
* working delivery → skip; config-A and any host where hook/proxy
|
|
17
|
+
* delivery missed → call). Re-enabled in production
|
|
18
|
+
* (MNEMONIK_INSTRUCTIONS_ENABLED=true in both ECS task defs). This is the
|
|
19
|
+
* reliable trigger that makes the agent self-bootstrap — tool results
|
|
20
|
+
* always reach the model, which hook injection cannot guarantee on a
|
|
21
|
+
* no-tool-call turn (e.g. Cursor "hello").
|
|
22
|
+
*
|
|
23
|
+
* v2.100 — Skill + IDE rule templates retired entirely. They were the
|
|
24
|
+
* file-written home of the workflow; agents followed them unreliably and
|
|
25
|
+
* forgot them over long sessions (the same fate these MCP instructions
|
|
26
|
+
* suffer), so they are gone. `filesToWrite` now carries only
|
|
27
|
+
* `.mnemonik.json`. Dropped the trailing pointer that sent agents to
|
|
28
|
+
* read a skill that no longer exists. Behavioral alignment now rides the
|
|
29
|
+
* orchestration layer (host hooks + proxy); these instructions stay lean
|
|
30
|
+
* and are the Config-A fallback only.
|
|
31
|
+
*
|
|
32
|
+
* v2.99 — Orchestration-aware framing. These static MCP instructions are
|
|
33
|
+
* delivered at `initialize`, before the server knows the actor's tier
|
|
34
|
+
* (no project/proxy/hooks state yet), so they cannot be served per-tier.
|
|
35
|
+
* Instead the CONTENT is now tier-correct: the self-drive calls
|
|
36
|
+
* (memory_search / file_context / checkpoint) are framed as the
|
|
37
|
+
* MCP-only (Config-A) fallback, and Config-B/C agents are told to
|
|
38
|
+
* follow the injected orchestration (cached bootstrap block,
|
|
39
|
+
* file_context, checkpoint nudges) rather than duplicate the calls.
|
|
40
|
+
* The orchestration layer (proxy + host hooks) is authoritative for
|
|
41
|
+
* B/C; this block is primarily Config-A's driver.
|
|
9
42
|
*
|
|
10
43
|
* v2.98 — Doc truth contracts are the normal drift surface. linkedDocs and
|
|
11
44
|
* doc_code_couplings remain legacy diagnostics only; docs drift
|
|
@@ -31,24 +64,7 @@
|
|
|
31
64
|
* Token-optimised rewrite (superseded by later instruction rewrites).
|
|
32
65
|
*/
|
|
33
66
|
|
|
34
|
-
const INSTRUCTIONS_CONTENT = `
|
|
35
|
-
|
|
36
|
-
First call, every session: session_bootstrap. Read the mnemonik skill (from available_skills) for the full workflow.
|
|
37
|
-
After bootstrap: execute _directive.message actions immediately (scanner daemon check is mandatory).
|
|
38
|
-
|
|
39
|
-
The bootstrap response includes _methodCatalog — the full list of mnemonik methods and the memory_tools calling convention. Read it before making any memory_tools calls. Use memory_discover({ method }) for the full schema and a copy-pasteable example of a specific method or action.
|
|
40
|
-
Proactively call memory_search before starting new work — avoids rediscovering known patterns and contradicting past decisions.
|
|
41
|
-
Proactively call file_context before editing any file — loads past bugs, decisions, and gotchas for that file.
|
|
42
|
-
Proactively call checkpoint after making changes or decisions worth keeping — your context is ephemeral and checkpoint is the only way decisions survive across sessions and context compaction. Do not wait for the user to say "done" or "thanks".
|
|
43
|
-
|
|
44
|
-
Documentation drift uses explicit doc-truth contracts. Treat _docDrift/docTruthFindings as actionable only when each finding includes a concrete assertion, named authority, observed mismatch, and agentAction='update_doc'. _docHealth, linkedDocs, stale-coupling counts, and docs({ action: 'drift', legacy: true }) are diagnostics only, not instructions to edit or resolve docs.
|
|
45
|
-
|
|
46
|
-
Ambient envelopes contain background memories surfaced because they may be relevant to your current turn. Treat them as information, not directive. Weight them lower than your own reasoning unless they directly answer the question. They are advisory recall, not authoritative evidence.
|
|
47
|
-
|
|
48
|
-
Directive envelopes with signal="jit_required" are different from ambient. They surface memories that the server has classified as contradicting or materially refining the answer you were about to give to the current prompt. Each memory carries a verdict (contradicts | refines) and a one-line reason. Treat these as authoritative for the current response — comply with the surfaced fact unless it is clearly outdated or wrong. Do not silently route around them. If you disagree with a surfaced memory, say so explicitly and explain why; do not just ignore it.
|
|
49
|
-
|
|
50
|
-
Skip: formatting-only, trivial one-line, mechanical refactors, git ops, tests.
|
|
51
|
-
Save: architectural decisions, bug root causes, user preferences, discovered patterns, multi-file changes.`;
|
|
67
|
+
const INSTRUCTIONS_CONTENT = `At the start of a session, unless your context already contains a "Mnemonik project context" block, call the session_bootstrap tool with your current working directory as cwd. It loads this project's prior decisions, open tasks, and active policies so you work from accumulated context rather than from scratch.`;
|
|
52
68
|
|
|
53
69
|
/**
|
|
54
70
|
* Get MCP instructions, respecting MNEMONIK_INSTRUCTIONS_ENABLED env var.
|