@engramprotocol/mcp-server 0.10.1 → 0.10.2

package/dist/setup/_helpers.js

@@ -0,0 +1,275 @@
+"use strict";
+// Setup-mode helpers: TTY prompts, config IO, settings.json merging, claude CLI wrapper,
+// template resolution. Used by install/update/uninstall flows.
+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.HOOK_TEMPLATES = exports.MCP_SERVER_NAME = exports.MANAGED_BY_MARKER = exports.CLAUDE_SETTINGS = exports.CLAUDE_JSON = exports.CLAUDE_DIR = exports.EML_HOOKS_DIR = exports.EML_CONFIG = exports.EML_DIR = exports.HOME_DIR = void 0;
+exports.pkgRoot = pkgRoot;
+exports.pkgVersion = pkgVersion;
+exports.templatesDir = templatesDir;
+exports.promptText = promptText;
+exports.promptConfirm = promptConfirm;
+exports.readConfig = readConfig;
+exports.writeConfig = writeConfig;
+exports.readSettings = readSettings;
+exports.backupSettings = backupSettings;
+exports.writeSettings = writeSettings;
+exports.mergePermission = mergePermission;
+exports.removePermissions = removePermissions;
+exports.mergeHookCommand = mergeHookCommand;
+exports.removeHooksByCommandPrefix = removeHooksByCommandPrefix;
+exports.claudeCli = claudeCli;
+exports.claudeCliExists = claudeCliExists;
+exports.verifyHealth = verifyHealth;
+exports.verifyToken = verifyToken;
+exports.readTemplate = readTemplate;
+exports.hasMarker = hasMarker;
+exports.installTemplate = installTemplate;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
+const child_process_1 = require("child_process");
+// --- Paths ----------------------------------------------------------------
+exports.HOME_DIR = process.env.HOME || process.env.USERPROFILE || '';
+exports.EML_DIR = path.join(exports.HOME_DIR, '.eml');
+exports.EML_CONFIG = path.join(exports.EML_DIR, 'config');
+exports.EML_HOOKS_DIR = path.join(exports.EML_DIR, 'hooks');
+exports.CLAUDE_DIR = path.join(exports.HOME_DIR, '.claude');
+exports.CLAUDE_JSON = path.join(exports.HOME_DIR, '.claude.json');
+exports.CLAUDE_SETTINGS = path.join(exports.CLAUDE_DIR, 'settings.json');
+exports.MANAGED_BY_MARKER = 'engramprotocol-setup';
+// MCP-server-name registered with Claude Code. Hardcoded per v0.10.0-PROPOSAL B.1.
+exports.MCP_SERVER_NAME = 'engramprotocol';
+// --- Package introspection ------------------------------------------------
+/** Resolve the package's own root (where templates/ lives). Works from dist/. */
+function pkgRoot() {
+    // CommonJS: __dirname → .../packages/mcp-server/dist/setup
+    // pkg root is two levels up
+    return path.resolve(__dirname, '..', '..');
+}
+function pkgVersion() {
+    const pkgPath = path.join(pkgRoot(), 'package.json');
+    const raw = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    return raw.version || '0.0.0';
+}
+function templatesDir() {
+    return path.join(pkgRoot(), 'templates');
+}
+// --- TTY prompts ----------------------------------------------------------
+async function promptText(question) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+async function promptConfirm(question, defaultYes = false) {
+    const suffix = defaultYes ? '[Y/n]' : '[y/N]';
+    const answer = await promptText(`${question} ${suffix} `);
+    if (!answer)
+        return defaultYes;
+    return /^y(es)?$/i.test(answer);
+}
+function readConfig() {
+    if (!fs.existsSync(exports.EML_CONFIG))
+        return null;
+    const raw = fs.readFileSync(exports.EML_CONFIG, 'utf-8');
+    const out = {};
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eq = trimmed.indexOf('=');
+        if (eq < 0)
+            continue;
+        const key = trimmed.slice(0, eq).trim();
+        const value = trimmed.slice(eq + 1).trim();
+        if (key === 'EML_URL' || key === 'EML_API_TOKEN' || key === 'EML_CLIENT_VERSION') {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+function writeConfig(cfg) {
+    fs.mkdirSync(exports.EML_DIR, { recursive: true });
+    const lines = [
+        '# EML config — managed by engramprotocol-setup. Edit with care.',
+        `EML_URL=${cfg.EML_URL || ''}`,
+        `EML_API_TOKEN=${cfg.EML_API_TOKEN || ''}`,
+        `EML_CLIENT_VERSION=${cfg.EML_CLIENT_VERSION || ''}`,
+        '',
+    ];
+    fs.writeFileSync(exports.EML_CONFIG, lines.join('\n'), { mode: 0o600 });
+}
+function readSettings() {
+    if (!fs.existsSync(exports.CLAUDE_SETTINGS))
+        return {};
+    const raw = fs.readFileSync(exports.CLAUDE_SETTINGS, 'utf-8');
+    try {
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        const e = err;
+        throw new Error(`Invalid JSON in ${exports.CLAUDE_SETTINGS}: ${e.message}`);
+    }
+}
+function backupSettings() {
+    if (!fs.existsSync(exports.CLAUDE_SETTINGS))
+        return '';
+    const ts = new Date().toISOString().replace(/[:.]/g, '-').replace('T', '-').slice(0, 19);
+    const backupPath = `${exports.CLAUDE_SETTINGS}.pre-eml-install-${ts}.bak`;
+    fs.copyFileSync(exports.CLAUDE_SETTINGS, backupPath);
+    return backupPath;
+}
+function writeSettings(settings) {
+    fs.mkdirSync(exports.CLAUDE_DIR, { recursive: true });
+    const tmp = `${exports.CLAUDE_SETTINGS}.tmp-${process.pid}`;
+    fs.writeFileSync(tmp, JSON.stringify(settings, null, 2) + '\n');
+    fs.renameSync(tmp, exports.CLAUDE_SETTINGS);
+}
+// --- Permissions merge ----------------------------------------------------
+/** Add a permission entry to settings.permissions.allow if not already present. */
+function mergePermission(settings, entry) {
+    if (!settings.permissions)
+        settings.permissions = {};
+    if (!Array.isArray(settings.permissions.allow))
+        settings.permissions.allow = [];
+    const allow = settings.permissions.allow;
+    if (allow.includes(entry))
+        return false;
+    allow.push(entry);
+    return true;
+}
+/** Remove permission entries matching the predicate. Returns count removed. */
+function removePermissions(settings, predicate) {
+    if (!settings.permissions || !Array.isArray(settings.permissions.allow))
+        return 0;
+    const before = settings.permissions.allow.length;
+    settings.permissions.allow = settings.permissions.allow.filter((e) => !predicate(e));
+    return before - settings.permissions.allow.length;
+}
+/** Add a command-hook to settings.hooks.<event>[] if no existing entry references the same command. */
+function mergeHookCommand(settings, event, command) {
+    if (!settings.hooks)
+        settings.hooks = {};
+    if (!Array.isArray(settings.hooks[event]))
+        settings.hooks[event] = [];
+    const events = settings.hooks[event];
+    const already = events.some((e) => Array.isArray(e.hooks) && e.hooks.some((h) => h.command === command));
+    if (already)
+        return false;
+    events.push({ hooks: [{ type: 'command', command }] });
+    return true;
+}
+/** Remove hook entries whose command starts with the given prefix (e.g. `$HOME/.eml/hooks/`). Returns count removed. */
+function removeHooksByCommandPrefix(settings, prefix) {
+    if (!settings.hooks)
+        return 0;
+    let removed = 0;
+    for (const event of Object.keys(settings.hooks)) {
+        const entries = settings.hooks[event];
+        if (!Array.isArray(entries))
+            continue;
+        const kept = entries.filter((entry) => {
+            const matches = Array.isArray(entry.hooks) && entry.hooks.some((h) => h.command.includes(prefix));
+            if (matches)
+                removed += 1;
+            return !matches;
+        });
+        settings.hooks[event] = kept;
+        if (kept.length === 0)
+            delete settings.hooks[event];
+    }
+    return removed;
+}
+// --- claude CLI wrapper ---------------------------------------------------
+function claudeCli(args) {
+    const result = (0, child_process_1.spawnSync)('claude', args, { encoding: 'utf-8' });
+    return {
+        stdout: result.stdout || '',
+        stderr: result.stderr || '',
+        status: typeof result.status === 'number' ? result.status : 1,
+    };
+}
+function claudeCliExists() {
+    const result = (0, child_process_1.spawnSync)('claude', ['--version'], { encoding: 'utf-8' });
+    return typeof result.status === 'number' && result.status === 0;
+}
+// --- HTTP checks ----------------------------------------------------------
+/** Unauthenticated reachability check — "is the server alive?". */
+async function verifyHealth(url) {
+    try {
+        const res = await fetch(`${url.replace(/\/$/, '')}/health`);
+        return { ok: res.ok, status: res.status };
+    }
+    catch (err) {
+        const e = err;
+        return { ok: false, error: e.message };
+    }
+}
+/** Authenticated round-trip — "does this token work?". Uses GET /stats (lightweight, auth-required). */
+async function verifyToken(url, token) {
+    try {
+        const res = await fetch(`${url.replace(/\/$/, '')}/stats`, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        return { ok: res.ok, status: res.status };
+    }
+    catch (err) {
+        const e = err;
+        return { ok: false, error: e.message };
+    }
+}
+exports.HOOK_TEMPLATES = [
+    { filename: 'session_start_boot.sh', event: 'SessionStart' },
+    { filename: 'user_prompt_submit_reminder.sh', event: 'UserPromptSubmit' },
+];
+function readTemplate(filename) {
+    return fs.readFileSync(path.join(templatesDir(), 'hooks', filename), 'utf-8');
+}
+function hasMarker(content) {
+    return content.includes(exports.MANAGED_BY_MARKER);
+}
+function installTemplate(filename) {
+    fs.mkdirSync(exports.EML_HOOKS_DIR, { recursive: true });
+    const installedPath = path.join(exports.EML_HOOKS_DIR, filename);
+    const alreadyExisted = fs.existsSync(installedPath);
+    const content = readTemplate(filename);
+    fs.writeFileSync(installedPath, content, { mode: 0o755 });
+    return { installedPath, alreadyExisted };
+}
+//# sourceMappingURL=_helpers.js.map

package/dist/setup/_helpers.js.map

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

package/dist/setup/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AAqBA,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B5D"}

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"}