@engramprotocol/mcp-server 0.9.1 → 0.10.0

package/dist/setup/index.js

@@ -0,0 +1,83 @@
+"use strict";
+// Setup-mode router. Dispatched from cli.ts when first arg is `setup`.
+//
+// Sub-commands:
+//   setup            → install (initial setup)
+//   setup install    → same as `setup`
+//   setup update     → refresh npm-package + hook-templates, retain config
+//   setup uninstall  → reverse install via marker-tagged entries
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSetup = runSetup;
+const HELP = `npx @engramprotocol/mcp-server setup [install|update|uninstall]
+
+Sub-commands:
+  install     Initial setup: token prompt, config write, MCP registration, permissions, hooks. (default)
+  update      Refresh installed templates + EML_CLIENT_VERSION in config.
+  uninstall   Reverse install. Removes EML-managed entries from Claude Code config.
+
+Flags (any sub-command):
+  --help      Show this help.
+
+Documentation: https://engramprotocol.io/docs/setup
+`;
+async function runSetup(argv) {
+    if (argv.includes('--help') || argv.includes('-h')) {
+        process.stderr.write(HELP);
+        return;
+    }
+    const sub = argv[0] || 'install';
+    switch (sub) {
+        case 'install': {
+            const { runInstall } = await Promise.resolve().then(() => __importStar(require('./install.js')));
+            await runInstall(argv.slice(1));
+            return;
+        }
+        case 'update': {
+            const { runUpdate } = await Promise.resolve().then(() => __importStar(require('./update.js')));
+            await runUpdate(argv.slice(1));
+            return;
+        }
+        case 'uninstall': {
+            const { runUninstall } = await Promise.resolve().then(() => __importStar(require('./uninstall.js')));
+            await runUninstall(argv.slice(1));
+            return;
+        }
+        default:
+            process.stderr.write(`Unknown setup sub-command: ${sub}\n\n${HELP}`);
+            process.exit(1);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/setup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":";AAAA,uEAAuE;AACvE,EAAE;AACF,gBAAgB;AAChB,+CAA+C;AAC/C,uCAAuC;AACvC,2EAA2E;AAC3E,iEAAiE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAejE,4BA4BC;AAzCD,MAAM,IAAI,GAAG;;;;;;;;;;;CAWZ,CAAA;AAEM,KAAK,UAAU,QAAQ,CAAC,IAAc;IAC3C,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC1B,OAAM;IACR,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,SAAS,CAAA;IAEhC,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,EAAE,UAAU,EAAE,GAAG,wDAAa,cAAc,GAAC,CAAA;YACnD,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;YAC/B,OAAM;QACR,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,EAAE,SAAS,EAAE,GAAG,wDAAa,aAAa,GAAC,CAAA;YACjD,MAAM,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;YAC9B,OAAM;QACR,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,EAAE,YAAY,EAAE,GAAG,wDAAa,gBAAgB,GAAC,CAAA;YACvD,MAAM,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;YACjC,OAAM;QACR,CAAC;QACD;YACE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,GAAG,OAAO,IAAI,EAAE,CAAC,CAAA;YACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACnB,CAAC;AACH,CAAC"}

package/dist/setup/install.d.ts

@@ -0,0 +1,2 @@
+export declare function runInstall(_argv: string[]): Promise<void>;
+//# sourceMappingURL=install.d.ts.map

package/dist/setup/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/setup/install.ts"],"names":[],"mappings":"AAyMA,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyC/D"}

package/dist/setup/install.js

@@ -0,0 +1,241 @@
+"use strict";
+// Setup-mode install flow. Implements v0.10.0-PROPOSAL C.2 §setup.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInstall = runInstall;
+const fs = __importStar(require("fs"));
+const _helpers_1 = require("./_helpers");
+const API_URL = 'https://api.engramprotocol.io';
+const BASH_PERMISSION = `Bash(npx @engramprotocol/${_helpers_1.MCP_SERVER_NAME === 'engramprotocol' ? 'mcp-server' : _helpers_1.MCP_SERVER_NAME} setup *)`;
+const MCP_PERMISSION = `mcp__${_helpers_1.MCP_SERVER_NAME}__*`;
+function log(msg) {
+    process.stderr.write(msg + '\n');
+}
+function fail(msg, code = 1) {
+    log(`\n❌ ${msg}`);
+    process.exit(code);
+}
+async function preflight() {
+    log('\nStep 1/8 — Pre-flight checks');
+    if (!(0, _helpers_1.claudeCliExists)()) {
+        fail('claude CLI not found in PATH. Install Claude Code first: https://claude.ai/code');
+    }
+    log('  ✓ claude CLI available');
+    for (const file of [_helpers_1.CLAUDE_JSON, _helpers_1.CLAUDE_SETTINGS]) {
+        if (!fs.existsSync(file)) {
+            log(`  ✓ ${file} does not exist yet (will be created)`);
+            continue;
+        }
+        try {
+            JSON.parse(fs.readFileSync(file, 'utf-8'));
+            log(`  ✓ ${file} is valid JSON`);
+        }
+        catch (err) {
+            const e = err;
+            fail(`${file} contains invalid JSON: ${e.message}\n   Fix or remove the file before running setup.`);
+        }
+    }
+}
+async function tokenPrompt() {
+    log('\nStep 2/8 — Token');
+    log(`  EML endpoint: ${API_URL}`);
+    // Accept EML_API_TOKEN from the environment — same convention as the
+    // `claude mcp add --env EML_API_TOKEN=...` pattern. Lets `setup install`
+    // run as a single self-contained command instead of an interactive prompt.
+    const envToken = process.env.EML_API_TOKEN;
+    if (envToken && envToken.startsWith('eml_')) {
+        log('  ℹ EML_API_TOKEN found in environment — verifying...');
+        const health = await (0, _helpers_1.verifyToken)(API_URL, envToken);
+        if (health.ok) {
+            log('  ✓ Token verified');
+            return envToken;
+        }
+        if (health.status === 401) {
+            log('  ❌ env-var token rejected (401). Falling back to interactive prompt.');
+        }
+        else {
+            log(`  ❌ env-var token check failed (${health.error ?? `HTTP ${health.status ?? '?'}`}). Falling back to interactive prompt.`);
+        }
+    }
+    while (true) {
+        const token = await (0, _helpers_1.promptText)('  Paste your EML API token (eml_...): ');
+        if (!token) {
+            log('  Empty token, try again.');
+            continue;
+        }
+        if (!token.startsWith('eml_')) {
+            log('  Tokens should start with "eml_". Try again.');
+            continue;
+        }
+        log('  Verifying token against /stats (auth-required)...');
+        const health = await (0, _helpers_1.verifyToken)(API_URL, token);
+        if (health.ok) {
+            log('  ✓ Token verified');
+            return token;
+        }
+        if (health.status === 401) {
+            log('  ❌ Token rejected (401). Try a different token.');
+            continue;
+        }
+        log(`  ❌ Health check failed: ${health.error ?? `HTTP ${health.status ?? '?'}`}. Try again or check connectivity.`);
+    }
+}
+function summarizePlan() {
+    log(`
+EML Setup is about to make the following changes:
+
+  ${_helpers_1.EML_CONFIG}
+    Write token + URL + client-version (chmod 600).
+
+  Claude Code MCP config (~/.claude.json)
+    Register MCP server "${_helpers_1.MCP_SERVER_NAME}" via \`claude mcp add\`.
+
+  ~/.claude/settings.json  (backup created first)
+    Add permission entries:
+      • ${MCP_PERMISSION}
+        (Claude calls EML MCP tools without per-call permission prompt)
+      • ${BASH_PERMISSION}
+        (Claude can run \`setup update\` etc. without per-call prompt)
+    Add hook entries:
+      • SessionStart → ~/.eml/hooks/session_start_boot.sh
+      • UserPromptSubmit → ~/.eml/hooks/user_prompt_submit_reminder.sh
+
+  ${_helpers_1.EML_HOOKS_DIR}
+    Copy 2 hook scripts from this npm-package's templates/.
+
+The setup is idempotent. Re-running won't create duplicates. \`setup uninstall\` reverses everything.
+`);
+}
+function writeConfigStep(token) {
+    log('\nStep 4/8 — Write ~/.eml/config (chmod 600)');
+    (0, _helpers_1.writeConfig)({
+        EML_URL: API_URL,
+        EML_API_TOKEN: token,
+        EML_CLIENT_VERSION: (0, _helpers_1.pkgVersion)(),
+    });
+    log(`  ✓ Config written (EML_CLIENT_VERSION=${(0, _helpers_1.pkgVersion)()})`);
+}
+function registerMcpServer(token) {
+    log('\nStep 5/8 — Register MCP server with Claude Code');
+    // Best-effort remove any prior registration with the same name (idempotency).
+    const remove = (0, _helpers_1.claudeCli)(['mcp', 'remove', _helpers_1.MCP_SERVER_NAME]);
+    if (remove.status === 0) {
+        log(`  ℹ Removed existing "${_helpers_1.MCP_SERVER_NAME}" registration (idempotent reinstall)`);
+    }
+    const args = [
+        'mcp', 'add', _helpers_1.MCP_SERVER_NAME,
+        '--scope', 'user',
+        '--transport', 'stdio',
+        '--env', `EML_API_TOKEN=${token}`,
+        '--',
+        'npx', '@engramprotocol/mcp-server@~0.10',
+        '--url', API_URL,
+    ];
+    const result = (0, _helpers_1.claudeCli)(args);
+    if (result.status !== 0) {
+        fail(`claude mcp add failed (exit ${result.status}):\n${result.stderr || result.stdout}`);
+    }
+    log(`  ✓ MCP server "${_helpers_1.MCP_SERVER_NAME}" registered (scope=user, stdio)`);
+}
+function patchPermissions(settings) {
+    log('\nStep 6/8 — Permissions');
+    const a = (0, _helpers_1.mergePermission)(settings, MCP_PERMISSION);
+    const b = (0, _helpers_1.mergePermission)(settings, BASH_PERMISSION);
+    if (a)
+        log(`  ✓ Added ${MCP_PERMISSION}`);
+    else
+        log(`  ℹ ${MCP_PERMISSION} already present`);
+    if (b)
+        log(`  ✓ Added ${BASH_PERMISSION}`);
+    else
+        log(`  ℹ ${BASH_PERMISSION} already present`);
+}
+function patchHooks(settings) {
+    log('\nStep 7/8 — Hooks');
+    for (const tpl of _helpers_1.HOOK_TEMPLATES) {
+        const { installedPath, alreadyExisted } = (0, _helpers_1.installTemplate)(tpl.filename);
+        log(`  ${alreadyExisted ? 'ℹ overwrote' : '✓ installed'} ${installedPath}`);
+        const command = `bash ${installedPath}`;
+        const added = (0, _helpers_1.mergeHookCommand)(settings, tpl.event, command);
+        if (added)
+            log(`    ↳ hook entry added for ${tpl.event}`);
+        else
+            log(`    ↳ hook entry for ${tpl.event} already present`);
+    }
+}
+async function smokeTest(token) {
+    log('\nStep 8/8 — Smoke test');
+    const result = await (0, _helpers_1.verifyToken)(API_URL, token);
+    if (!result.ok) {
+        fail(`/stats round-trip failed (${result.status ?? result.error}). Setup completed but server may be unreachable; check ~/.eml/config and try again.`);
+    }
+    log('  ✓ /stats round-trip OK');
+}
+async function runInstall(_argv) {
+    log('Engram Protocol — Setup (install)');
+    await preflight();
+    const token = await tokenPrompt();
+    log('\nStep 3/8 — Consent');
+    summarizePlan();
+    const ok = await (0, _helpers_1.promptConfirm)('Proceed?', false);
+    if (!ok) {
+        log('\nCancelled. No changes made.');
+        return;
+    }
+    // ---- Begin mutations ----
+    const backupPath = (0, _helpers_1.backupSettings)();
+    if (backupPath)
+        log(`  ℹ Backup: ${backupPath}`);
+    writeConfigStep(token);
+    registerMcpServer(token);
+    // Single read-modify-write cycle for settings.json: permissions + hooks merged together.
+    const settings = (0, _helpers_1.readSettings)();
+    patchPermissions(settings);
+    patchHooks(settings);
+    (0, _helpers_1.writeSettings)(settings);
+    log(`  ✓ ${_helpers_1.CLAUDE_SETTINGS} updated`);
+    await smokeTest(token);
+    log(`
+✅ Done.
+
+Restart Claude Code for the changes to take effect.
+Hooks installed in: ${_helpers_1.EML_HOOKS_DIR}
+Config: ${_helpers_1.EML_CONFIG}
+Marker: # ${_helpers_1.MANAGED_BY_MARKER} (line 2 of each hook script + on managed entries)
+
+To reverse: \`npx @engramprotocol/mcp-server setup uninstall\`
+`);
+}
+//# sourceMappingURL=install.js.map

package/dist/setup/install.js.map

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

package/dist/setup/uninstall.d.ts

@@ -0,0 +1,2 @@
+export declare function runUninstall(_argv: string[]): Promise<void>;
+//# sourceMappingURL=uninstall.d.ts.map

package/dist/setup/uninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../src/setup/uninstall.ts"],"names":[],"mappings":"AA6BA,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiFjE"}

package/dist/setup/uninstall.js

@@ -0,0 +1,120 @@
+"use strict";
+// Setup-mode uninstall flow. Implements v0.10.0-PROPOSAL C.5 §Uninstall flow.
+//
+// Removes all engramprotocol-managed entries from Claude Code config and removes
+// the hook scripts. User's non-EML hooks, permissions, and settings remain untouched.
+// ~/.eml/config is kept by default (user data — confirmed before delete).
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runUninstall = runUninstall;
+const fs = __importStar(require("fs"));
+const _helpers_1 = require("./_helpers");
+function log(msg) {
+    process.stderr.write(msg + '\n');
+}
+const MCP_PERMISSION = `mcp__${_helpers_1.MCP_SERVER_NAME}__*`;
+const BASH_PERMISSION = `Bash(npx @engramprotocol/mcp-server setup *)`;
+async function runUninstall(_argv) {
+    log('Engram Protocol — Setup (uninstall)\n');
+    log('Will remove:');
+    log(`  • Hook entries in ${_helpers_1.CLAUDE_SETTINGS} that reference ${_helpers_1.EML_HOOKS_DIR}`);
+    log(`  • Permission entries: ${MCP_PERMISSION}, ${BASH_PERMISSION}`);
+    log(`  • MCP server registration "${_helpers_1.MCP_SERVER_NAME}" (via \`claude mcp remove\`)`);
+    log(`  • ${_helpers_1.EML_HOOKS_DIR} (hook scripts)`);
+    log(`  • ${_helpers_1.EML_CONFIG} (only after explicit confirmation — contains token)`);
+    log('');
+    const ok = await (0, _helpers_1.promptConfirm)('Proceed?', false);
+    if (!ok) {
+        log('\nCancelled. No changes made.');
+        return;
+    }
+    // --- 1. settings.json — backup + remove managed entries -------------------
+    if (fs.existsSync(_helpers_1.CLAUDE_SETTINGS)) {
+        const backupPath = (0, _helpers_1.backupSettings)();
+        log(`\n  ℹ Backup: ${backupPath}`);
+        const settings = (0, _helpers_1.readSettings)();
+        const hooksRemoved = (0, _helpers_1.removeHooksByCommandPrefix)(settings, _helpers_1.EML_HOOKS_DIR);
+        log(`  ✓ Removed ${hooksRemoved} hook entr${hooksRemoved === 1 ? 'y' : 'ies'}`);
+        const permsRemoved = (0, _helpers_1.removePermissions)(settings, (e) => e === MCP_PERMISSION || e === BASH_PERMISSION);
+        log(`  ✓ Removed ${permsRemoved} permission entr${permsRemoved === 1 ? 'y' : 'ies'}`);
+        (0, _helpers_1.writeSettings)(settings);
+        log(`  ✓ ${_helpers_1.CLAUDE_SETTINGS} updated`);
+    }
+    else {
+        log(`  ℹ ${_helpers_1.CLAUDE_SETTINGS} not found — nothing to clean there`);
+    }
+    // --- 2. claude mcp remove -------------------------------------------------
+    const remove = (0, _helpers_1.claudeCli)(['mcp', 'remove', _helpers_1.MCP_SERVER_NAME]);
+    if (remove.status === 0) {
+        log(`  ✓ MCP server "${_helpers_1.MCP_SERVER_NAME}" removed`);
+    }
+    else {
+        log(`  ℹ \`claude mcp remove ${_helpers_1.MCP_SERVER_NAME}\` returned non-zero (likely already absent)`);
+    }
+    // --- 3. ~/.eml/hooks/ -----------------------------------------------------
+    if (fs.existsSync(_helpers_1.EML_HOOKS_DIR)) {
+        fs.rmSync(_helpers_1.EML_HOOKS_DIR, { recursive: true, force: true });
+        log(`  ✓ Removed ${_helpers_1.EML_HOOKS_DIR}`);
+    }
+    else {
+        log(`  ℹ ${_helpers_1.EML_HOOKS_DIR} not found — already gone`);
+    }
+    // --- 4. ~/.eml/config — confirm before delete -----------------------------
+    if (fs.existsSync(_helpers_1.EML_CONFIG)) {
+        log('');
+        const deleteConfig = await (0, _helpers_1.promptConfirm)(`Delete ${_helpers_1.EML_CONFIG} (contains your API token)?`, false);
+        if (deleteConfig) {
+            fs.rmSync(_helpers_1.EML_CONFIG);
+            log(`  ✓ Removed ${_helpers_1.EML_CONFIG}`);
+            // ~/.eml/ — remove if empty
+            try {
+                if (fs.readdirSync(_helpers_1.EML_DIR).length === 0) {
+                    fs.rmdirSync(_helpers_1.EML_DIR);
+                    log(`  ✓ Removed empty ${_helpers_1.EML_DIR}`);
+                }
+            }
+            catch { /* logs subdir or similar exists — leave as-is */ }
+        }
+        else {
+            log(`  ℹ Kept ${_helpers_1.EML_CONFIG}`);
+        }
+    }
+    log(`
+✅ Uninstall complete.
+
+Restart Claude Code for the changes to take full effect.
+`);
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/setup/uninstall.js.map

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

package/dist/setup/update.d.ts

@@ -0,0 +1,2 @@
+export declare function runUpdate(_argv: string[]): Promise<void>;
+//# sourceMappingURL=update.d.ts.map

package/dist/setup/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/setup/update.ts"],"names":[],"mappings":"AAwCA,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyE9D"}

package/dist/setup/update.js

@@ -0,0 +1,130 @@
+"use strict";
+// Setup-mode update flow. Implements v0.10.0-PROPOSAL C.5 §Update flow.
+//
+// What this does:
+//   - Refreshes EML_CLIENT_VERSION in ~/.eml/config to match the currently-installed
+//     package version (so the hook's banner-check sees the right version)
+//   - Overwrites hook templates in ~/.eml/hooks/ from the current package's templates/
+//     (marker-aware: skips files that the user has customized — no marker present)
+//   - Verifies that ~/.claude/settings.json still has the managed entries
+//
+// What this does NOT do:
+//   - Refresh the npm package itself. That's the user's responsibility (typically via
+//     `npx @engramprotocol/mcp-server@latest setup update` to bust npx cache).
+//     If the package version hasn't changed when `setup update` runs, it's a no-op
+//     except for config-bump and template-overwrite (idempotent).
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runUpdate = runUpdate;
+const fs = __importStar(require("fs"));
+const _helpers_1 = require("./_helpers");
+function log(msg) {
+    process.stderr.write(msg + '\n');
+}
+function fail(msg, code = 1) {
+    log(`\n❌ ${msg}`);
+    process.exit(code);
+}
+async function runUpdate(_argv) {
+    log('Engram Protocol — Setup (update)');
+    // --- 1. Read existing config ---------------------------------------------
+    const cfg = (0, _helpers_1.readConfig)();
+    if (!cfg) {
+        fail(`No installation found at ${_helpers_1.EML_CONFIG}. Run \`setup install\` first.`);
+    }
+    if (!cfg.EML_URL || !cfg.EML_API_TOKEN) {
+        fail(`Config at ${_helpers_1.EML_CONFIG} is incomplete (missing EML_URL or EML_API_TOKEN). Re-run \`setup install\`.`);
+    }
+    const oldVersion = cfg.EML_CLIENT_VERSION || '(unset)';
+    const newVersion = (0, _helpers_1.pkgVersion)();
+    log(`  Current installed version: ${oldVersion}`);
+    log(`  This package's version:    ${newVersion}`);
+    if (oldVersion === newVersion) {
+        log('  → Config already at this version; will still refresh templates (idempotent).');
+    }
+    // --- 2. Update config (bump EML_CLIENT_VERSION) --------------------------
+    (0, _helpers_1.writeConfig)({ ...cfg, EML_CLIENT_VERSION: newVersion });
+    log(`  ✓ ${_helpers_1.EML_CONFIG} EML_CLIENT_VERSION → ${newVersion}`);
+    // --- 3. Hook templates: overwrite (marker-aware) -------------------------
+    log('\nHook templates:');
+    fs.mkdirSync(_helpers_1.EML_HOOKS_DIR, { recursive: true });
+    for (const tpl of _helpers_1.HOOK_TEMPLATES) {
+        const installedPath = `${_helpers_1.EML_HOOKS_DIR}/${tpl.filename}`;
+        if (fs.existsSync(installedPath)) {
+            const current = fs.readFileSync(installedPath, 'utf-8');
+            if (!(0, _helpers_1.hasMarker)(current)) {
+                log(`  ⚠ skip ${installedPath} — user-customized (no \`${_helpers_1.MANAGED_BY_MARKER}\` marker). Manual review needed.`);
+                continue;
+            }
+        }
+        (0, _helpers_1.installTemplate)(tpl.filename);
+        log(`  ✓ ${installedPath}`);
+    }
+    // --- 4. Settings.json sanity check ---------------------------------------
+    log('\nSettings.json sanity check:');
+    if (!fs.existsSync(_helpers_1.CLAUDE_SETTINGS)) {
+        log(`  ⚠ ${_helpers_1.CLAUDE_SETTINGS} missing — was the install completed? Run \`setup install\` again.`);
+    }
+    else {
+        const settings = (0, _helpers_1.readSettings)();
+        const allow = settings.permissions?.allow ?? [];
+        const hasMcpPerm = allow.includes(`mcp__${_helpers_1.MCP_SERVER_NAME}__*`);
+        if (hasMcpPerm)
+            log(`  ✓ mcp__${_helpers_1.MCP_SERVER_NAME}__* present in permissions.allow`);
+        else
+            log(`  ⚠ mcp__${_helpers_1.MCP_SERVER_NAME}__* missing from permissions.allow — run \`setup install\` to restore`);
+        let hookEntries = 0;
+        for (const event of Object.keys(settings.hooks ?? {})) {
+            const arr = settings.hooks[event] ?? [];
+            for (const e of arr) {
+                for (const h of e.hooks ?? []) {
+                    if (typeof h.command === 'string' && h.command.includes(_helpers_1.EML_HOOKS_DIR))
+                        hookEntries += 1;
+                }
+            }
+        }
+        log(`  ${hookEntries > 0 ? '✓' : '⚠'} ${hookEntries} hook entries reference ${_helpers_1.EML_HOOKS_DIR}`);
+    }
+    log(`
+✅ Update complete.
+
+Note: this updates the local config + hook templates of the currently-running setup-mode.
+If you ran an old version via npx cache, run again with @latest to force a fresh download:
+  npx @engramprotocol/mcp-server@latest setup update
+
+Restart Claude Code for changes to take effect.
+`);
+}
+//# sourceMappingURL=update.js.map

package/dist/setup/update.js.map

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

package/dist/tools/boot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../../src/tools/boot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAGhD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAkB1E"}
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../../src/tools/boot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAGhD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAgB1E"}

package/dist/tools/boot.js

@@ -6,10 +6,8 @@ const _helpers_1 = require("./_helpers");
 function registerBootTool(server, http) {
     server.registerTool('eml_boot', {
         title: 'Boot Brain',
-        description: 'Loads the brain boot view: identity (profile/rule), current status, ' +
-            'open tasks, recent logs, brain-hygiene reviews. Call at session start ' +
-            'to load context — the returned markdown is suitable for direct ' +
-            'injection into the context window.',
+        description: 'Manual brain-reload — returns the same markdown the SessionStart-Hook ' +
+            'delivers automatically. Use mid-session to refresh brain state.',
         inputSchema: {
             agent: zod_1.z.string().optional().describe('Agent ID (e.g. "motti", "default"). If omitted, the server uses the brain name as default.'),
         },

package/dist/tools/boot.js.map

@@ -1 +1 @@
-{"version":3,"file":"boot.js","sourceRoot":"","sources":["../../src/tools/boot.ts"],"names":[],"mappings":";;AAKA,4CAkBC;AAvBD,6BAAuB;AAGvB,yCAAqC;AAErC,SAAgB,gBAAgB,CAAC,MAAiB,EAAE,IAAgB;IAClE,MAAM,CAAC,YAAY,CACjB,UAAU,EACV;QACE,KAAK,EAAE,YAAY;QACnB,WAAW,EACT,sEAAsE;YACtE,wEAAwE;YACxE,iEAAiE;YACjE,oCAAoC;QACtC,WAAW,EAAE;YACX,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACnC,4FAA4F,CAC7F;SACF;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAC1E,CAAA;AACH,CAAC"}
+{"version":3,"file":"boot.js","sourceRoot":"","sources":["../../src/tools/boot.ts"],"names":[],"mappings":";;AAKA,4CAgBC;AArBD,6BAAuB;AAGvB,yCAAqC;AAErC,SAAgB,gBAAgB,CAAC,MAAiB,EAAE,IAAgB;IAClE,MAAM,CAAC,YAAY,CACjB,UAAU,EACV;QACE,KAAK,EAAE,YAAY;QACnB,WAAW,EACT,wEAAwE;YACxE,iEAAiE;QACnE,WAAW,EAAE;YACX,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACnC,4FAA4F,CAC7F;SACF;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAC1E,CAAA;AACH,CAAC"}