Shared memory and context tools for agentic work.
Code Rooms
"use strict";
const assert = require("node:assert/strict");
const fs = require("node:fs");
const os = require("node:os");
const path = require("node:path");
const { spawnSync } = require("node:child_process");
const test = require("node:test");
const CLI = path.resolve(__dirname, "../bin/m1nd.js");
const POSIX = { skip: process.platform === "win32" && "POSIX fixture launcher" };
function run(mode) {
const root = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), "m1nd-dirty-context-")));
try {
const repo = path.join(root, "repo-alpha"), binary = path.join(root, "fixture.js");
fs.mkdirSync(repo);
const anchor = path.join(repo, "signal.js");
fs.writeFileSync(anchor, "export const signal = 1;\n");
const connected = path.join(repo, "connected.js");
fs.writeFileSync(connected, "original");
fs.writeFileSync(binary, `#!${process.execPath}\n` + `
const fs=require('node:fs'), readline=require('node:readline');
if(process.argv.includes('--version')){console.log('m1nd-mcp 1.6.5');process.exit(0);}
const file=process.env.FIXTURE_ANCHOR, mode=process.env.FIXTURE_DRIFT;
const original=fs.readFileSync(file,'utf8');
const connected=process.env.FIXTURE_CONNECTED;
readline.createInterface({input:process.stdin}).on('line',line=>{
const q=JSON.parse(line);let result={};
if(q.method==='tools/list')result={tools:['trust_selftest','session_handshake','surgical_context_v2'].map(name=>({name}))};
if(q.method==='tools/call'){
const name=q.params.name;let payload={};
if(name==='trust_selftest')payload={verdict:'full_trust',graph_state:{node_count:1}};
if(name==='session_handshake'){
payload={trust_mode:'full_trust',graph_state:{node_count:1}};
if(mode==='before')fs.writeFileSync(file,'export const signal = 2;\\n');
}
if(name==='am_i_stale'){
const changed=fs.readFileSync(file,'utf8')!==original;
const requested=q.params.arguments.files;
const stale=requested.filter(p=>p===file?changed:fs.readFileSync(p,'utf8')!=='original');
payload={checked:requested.length,fresh:mode==='unknown'?[]:requested.filter(p=>!stale.includes(p)),unknown:mode==='unknown'?requested:[],stale:stale.map(path=>({path,reason:'changed'})),notes:['private-note-not-forwarded']};
if(name==='surgical_context_v2'){
payload={ok:true,primary_file:{file_path:file,source:'obsolete-capsule-sentinel'}};
if(mode==='unsafe')payload.connected_files=[{file_path:process.env.FIXTURE_OUTSIDE,source_excerpt:'unsafe-sentinel'}];
if(mode==='over-budget')payload.connected_files=Array(6).fill({file_path:connected});
if(mode==='primary-flat-outside')payload={ok:true,file_path:process.env.FIXTURE_OUTSIDE,file_contents:'unsafe-primary-sentinel',connected_files:[]};
if(mode==='primary-flat-other')payload={ok:true,file_path:connected,file_contents:'unsafe-primary-sentinel',connected_files:[]};
if(mode==='primary-nested-outside')payload.primary_file={file_path:process.env.FIXTURE_OUTSIDE,source:'unsafe-primary-sentinel'};
if(mode==='primary-nested-other')payload.primary_file={file_path:connected,source:'unsafe-primary-sentinel'};
if(mode==='context-error')payload={ok:false,refused:true};
if(mode.startsWith('connected'))payload.connected_files=[{file_path:connected,source_excerpt:'obsolete-connected-sentinel'}];
if(mode==='connected-change')fs.writeFileSync(connected,'changed');
if(mode==='after')fs.writeFileSync(file,'export const signal = 3;\\n');
result={content:[{type:'text',text:JSON.stringify(payload)}]};
process.stdout.write(JSON.stringify({jsonrpc:'2.0',id:q.id,result})+'\\n');
});`, { mode: 0o700 });
const env = Object.fromEntries(Object.entries(process.env).filter(([key]) => !key.startsWith("M1ND_") && !key.startsWith("GIT_")));
Object.assign(env, { FIXTURE_ANCHOR: anchor, FIXTURE_CONNECTED: connected, FIXTURE_OUTSIDE: path.join(root, "outside.js"), FIXTURE_DRIFT: mode, M1ND_REGISTRY_DIR: path.join(root, "registry") });
const command = spawnSync(process.execPath, [CLI, "agent", "context", "--repo", repo,
"--binary", binary, "--no-attach", "--shared-runtime", "--query", "signal", "--anchor", "signal.js", "--json"],
{ encoding: "utf8", timeout: 15000, env });
assert.equal(command.error, undefined);
assert.equal(command.signal, null, command.stderr);
return { status: command.status, payload: JSON.parse(command.stdout) };
} finally { fs.rmSync(root, { recursive: true, force: true }); }
for (const phase of ["before", "after"]) {
test(`context suppresses a capsule when uncommitted source changes ${phase} retrieval`, POSIX, () => {
const { status, payload } = run(phase);
assert.equal(status, 1);
assert.equal(payload.ok, false);
assert.equal(payload.status, "source_changed_during_context");
assert.deepEqual(payload.results, []);
assert.ok(!JSON.stringify(payload).includes("obsolete-capsule-sentinel"));
assert.ok(!JSON.stringify(payload).includes("private-note-not-forwarded"));
const contextCalls = payload.calls.filter(call => call.tool === "surgical_context_v2");
assert.equal(contextCalls.length, phase === "before" ? 0 : 1);
});
test("context reports unknown anchor freshness without inventing a fresh result or retrying", POSIX, () => {
const { status, payload } = run("unknown");
assert.equal(status, 0);
assert.equal(payload.source_freshness.status, "not_proven");
assert.equal(payload.calls.filter(call => call.tool === "am_i_stale").length, 1);
for (const mode of ["connected-change", "connected-stable"]) {
test(`context checks returned connected files: ${mode}`, POSIX, () => {
const { status, payload } = run(mode);
assert.equal(status, mode === "connected-change" ? 1 : 0);
if (mode === "connected-change") {
assert.ok(!JSON.stringify(payload).includes("obsolete-connected-sentinel"));
} else {
assert.equal(payload.source_freshness.status, "fresh_at_boundaries");
assert.equal(payload.source_freshness.after.files.length, 2);
assert.equal(payload.source_freshness.after_scope, "anchor_and_returned_connected_files");
assert.equal(payload.calls.filter(c => c.tool === "am_i_stale").length, 2);
for (const mode of ["unsafe", "over-budget", "primary-flat-outside", "primary-flat-other", "primary-nested-outside", "primary-nested-other"]) {
test(`context discards an unvalidated returned scope: ${mode}`, POSIX, () => {
assert.equal(payload.status, "context_scope_not_proven");
assert.equal(payload.calls.filter(c => c.tool === "am_i_stale").length, 1);
assert.ok(!JSON.stringify(payload).includes("unsafe-primary-sentinel"));
test("context refusal leaves surgical context as the last call", POSIX, () => {
const { status, payload } = run("context-error");
assert.equal(payload.status, "context_refused");
assert.equal(payload.calls.at(-1).tool, "surgical_context_v2");