@openlife/cli 1.7.3

package/dist/cli/AutonomousInstaller.js

@@ -0,0 +1,134 @@
+"use strict";
+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.AutonomousInstaller = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class AutonomousInstaller {
+    root;
+    constructor(root = process.cwd()) {
+        this.root = root;
+    }
+    install() {
+        const filesCreated = [];
+        const openlifeDir = path.join(this.root, '.openlife');
+        fs.mkdirSync(openlifeDir, { recursive: true });
+        const runtimeFile = path.join(openlifeDir, 'agent-runtime.json');
+        if (!fs.existsSync(runtimeFile)) {
+            fs.writeFileSync(runtimeFile, JSON.stringify({ running: false, mode: 'autonomous' }, null, 2), 'utf-8');
+            filesCreated.push(runtimeFile);
+        }
+        const queueFile = path.join(openlifeDir, 'agent-queue.json');
+        if (!fs.existsSync(queueFile)) {
+            fs.writeFileSync(queueFile, JSON.stringify({ queuedObjectives: [], updatedAt: new Date().toISOString() }, null, 2), 'utf-8');
+            filesCreated.push(queueFile);
+        }
+        const policyFile = path.join(openlifeDir, 'autonomous-policy.json');
+        if (!fs.existsSync(policyFile)) {
+            fs.writeFileSync(policyFile, JSON.stringify({
+                maxConcurrentMissions: 1,
+                requireGovernanceRiskCheck: true,
+                autoPersistMemory: true,
+                autoRunEvolution: true
+            }, null, 2), 'utf-8');
+            filesCreated.push(policyFile);
+        }
+        const systemdFile = path.join(this.root, 'scripts', 'openlife-agent.service.example');
+        fs.mkdirSync(path.dirname(systemdFile), { recursive: true });
+        fs.writeFileSync(systemdFile, this.systemdTemplate(), 'utf-8');
+        filesCreated.push(systemdFile);
+        const supervisorFile = path.join(this.root, 'scripts', 'openlife-agent.supervisord.conf.example');
+        fs.writeFileSync(supervisorFile, this.supervisorTemplate(), 'utf-8');
+        filesCreated.push(supervisorFile);
+        const launcherFile = path.join(this.root, 'scripts', 'openlife-agent-start.sh');
+        fs.writeFileSync(launcherFile, this.launcherTemplate(), 'utf-8');
+        fs.chmodSync(launcherFile, 0o755);
+        filesCreated.push(launcherFile);
+        const installManifest = path.join(openlifeDir, 'autonomous-install-manifest.json');
+        fs.writeFileSync(installManifest, JSON.stringify({
+            installedAt: new Date().toISOString(),
+            root: this.root,
+            filesCreated
+        }, null, 2), 'utf-8');
+        filesCreated.push(installManifest);
+        return {
+            installedAt: new Date().toISOString(),
+            root: this.root,
+            filesCreated,
+            nextCommands: [
+                'openlife mode set autonomous --host claude-code',
+                'openlife agent start',
+                'openlife agent status'
+            ]
+        };
+    }
+    launcherTemplate() {
+        return `#!/usr/bin/env bash
+set -euo pipefail
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$ROOT"
+node dist/index.js mode set autonomous --host claude-code
+node dist/index.js agent start
+`;
+    }
+    systemdTemplate() {
+        return `[Unit]
+Description=OpenLife Autonomous Agent
+After=network.target
+
+[Service]
+Type=simple
+WorkingDirectory=${this.root}
+ExecStart=/usr/bin/node ${this.root}/dist/index.js start --daemon
+Restart=always
+RestartSec=5
+
+[Install]
+WantedBy=multi-user.target
+`;
+    }
+    supervisorTemplate() {
+        return `[program:openlife-agent]
+command=/usr/bin/node ${this.root}/dist/index.js start --daemon
+directory=${this.root}
+autostart=true
+autorestart=true
+startsecs=5
+stderr_logfile=${this.root}/.openlife/logs/agent.err.log
+stdout_logfile=${this.root}/.openlife/logs/agent.out.log
+`;
+    }
+}
+exports.AutonomousInstaller = AutonomousInstaller;

package/dist/cli/DreamOrganizer.js

@@ -0,0 +1,88 @@
+"use strict";
+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.DreamOrganizer = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class DreamOrganizer {
+    root;
+    constructor(root = process.cwd()) {
+        this.root = root;
+    }
+    organize(raw) {
+        const normalized = raw.toLowerCase();
+        const categories = [];
+        const addCategory = (value) => {
+            if (!categories.includes(value))
+                categories.push(value);
+        };
+        if (/(ideia|criar|build|produto|projeto)/.test(normalized))
+            addCategory('ideias');
+        if (/(estudar|aprendi|aprender|pesquisa|ler)/.test(normalized))
+            addCategory('aprendizado');
+        if (/(preciso|fazer|implementar|entregar|todo)/.test(normalized))
+            addCategory('tarefas');
+        if (/(refleti|senti|mente|foco|disciplina|emoç|emoc)/.test(normalized))
+            addCategory('reflexoes');
+        if (categories.length === 0)
+            addCategory('geral');
+        const summary = raw.length > 180 ? `${raw.slice(0, 177)}...` : raw;
+        return {
+            createdAt: new Date().toISOString(),
+            raw,
+            summary,
+            categories,
+            tags: ['dream', ...categories]
+        };
+    }
+    save(note) {
+        const dreamDir = path.join(this.root, '.openlife', 'dreams');
+        fs.mkdirSync(dreamDir, { recursive: true });
+        const day = note.createdAt.slice(0, 10);
+        const filePath = path.join(dreamDir, `${day}.md`);
+        const block = [
+            `## /dream ${note.createdAt}`,
+            `- summary: ${note.summary}`,
+            `- categories: ${note.categories.join(', ')}`,
+            `- tags: ${note.tags.join(', ')}`,
+            '',
+            note.raw,
+            ''
+        ].join('\n');
+        fs.appendFileSync(filePath, `${block}\n`, 'utf-8');
+        return filePath;
+    }
+}
+exports.DreamOrganizer = DreamOrganizer;

package/dist/cli/HostInstaller.js

@@ -0,0 +1,426 @@
+"use strict";
+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.HostInstaller = exports.HostNotYetSupportedError = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const ToolsetGuard_1 = require("../orchestrator/toolset/ToolsetGuard");
+class HostNotYetSupportedError extends Error {
+    host;
+    code = 'HOST_NOT_YET_SUPPORTED';
+    constructor(host) {
+        super(`HOST_NOT_YET_SUPPORTED: install for "${host}" is not implemented yet. ` +
+            `Story 3.3 ships claude-code only; gemini-cli and codex follow in a later v1.1 story. ` +
+            `Use --host claude-code for now, or set CLAUDECODE=1 to auto-detect.`);
+        this.host = host;
+    }
+}
+exports.HostNotYetSupportedError = HostNotYetSupportedError;
+class HostInstaller {
+    templatesRoot;
+    constructor(opts = {}) {
+        this.templatesRoot = opts.templatesRoot || HostInstaller.defaultTemplatesRoot();
+    }
+    /**
+     * Resolves the dist-templates/ directory relative to this compiled file.
+     * Source: src/cli/HostInstaller.ts → compiled: dist/cli/HostInstaller.js
+     * Going up twice from dist/cli/ lands on the package root where dist-templates/ lives.
+     * Works in both repo-dev (npm run build) and consumer-installed (node_modules/@open-life/cli/) layouts.
+     */
+    static defaultTemplatesRoot() {
+        return path.resolve(__dirname, '..', '..', 'dist-templates');
+    }
+    /**
+     * Dispatch on validated Host. Throws HostNotYetSupportedError for hosts without an installer.
+     */
+    install(host, options) {
+        (0, ToolsetGuard_1.assertToolsetAllowed)('file', 'HostInstaller.install');
+        switch (host) {
+            case 'claude-code':
+                return this.installForClaudeCode(options);
+            case 'gemini-cli':
+                return this.installForGeminiCli(options);
+            case 'codex':
+                return this.installForCodex(options);
+            default:
+                // Should be unreachable because Host is a validated union; defensive throw.
+                throw new HostNotYetSupportedError(host);
+        }
+    }
+    installForClaudeCode(options) {
+        const targetRoot = options.targetRoot;
+        const sourceRoot = path.join(this.templatesRoot, 'claude-code');
+        if (!fs.existsSync(sourceRoot)) {
+            throw new Error(`DIST_TEMPLATES_MISSING: expected templates at ${sourceRoot}. ` +
+                `Run "npm run build" or reinstall @open-life/cli.`);
+        }
+        const files = [];
+        const notes = [];
+        // 1. Agents → <root>/.claude/agents/openlife-*.md
+        const agentsSrc = path.join(sourceRoot, 'agents');
+        const agentsDst = path.join(targetRoot, '.claude', 'agents');
+        files.push(...this.copyDir(agentsSrc, agentsDst));
+        // 2. Slash commands → <root>/.claude/commands/openlife/*.md
+        const commandsSrc = path.join(sourceRoot, 'commands', 'openlife');
+        const commandsDst = path.join(targetRoot, '.claude', 'commands', 'openlife');
+        files.push(...this.copyDir(commandsSrc, commandsDst));
+        // 3. MCP manifest → .openlife/install-mcp-snippet.json (non-invasive: user merges into ~/.claude.json manually)
+        const mcpSrc = path.join(sourceRoot, 'mcp', 'openlife-orchestrator.json');
+        let mcpSnippetPath;
+        if (fs.existsSync(mcpSrc)) {
+            const stateDir = path.join(targetRoot, '.openlife');
+            if (!fs.existsSync(stateDir))
+                fs.mkdirSync(stateDir, { recursive: true });
+            mcpSnippetPath = path.join(stateDir, 'install-mcp-snippet.json');
+            const action = this.copyFile(mcpSrc, mcpSnippetPath);
+            files.push(action);
+            notes.push(`MCP manifest staged at ${mcpSnippetPath}. ` +
+                `To enable, merge its "mcpServers" entry into ~/.claude.json under the "mcpServers" key. ` +
+                `Note: bin/openlife-mcp.js (the server) is not yet implemented — manifest is informational until a later v1.1 story.`);
+        }
+        return {
+            host: 'claude-code',
+            targetRoot,
+            files,
+            mcpSnippetPath,
+            notes
+        };
+    }
+    /**
+     * Story 9.3 — Real implementation for the `gemini-cli` host.
+     *
+     * Mirrors `installForClaudeCode` exactly, swapping `.claude/` for
+     * `.gemini/` and the source template directory for
+     * `dist-templates/gemini-cli/`. Same uninstall pattern.
+     */
+    installForGeminiCli(options) {
+        return this.installForHost('gemini-cli', '.gemini', options);
+    }
+    /**
+     * Story 9.4 — Real implementation for the `codex` host.
+     *
+     * Mirrors `installForClaudeCode`, swapping `.claude/` for `.codex/`
+     * and template root for `dist-templates/codex/`.
+     */
+    installForCodex(options) {
+        return this.installForHost('codex', '.codex', options);
+    }
+    /**
+     * Shared implementation extracted so gemini-cli and codex don't drift
+     * from the claude-code pattern. Same shape as installForClaudeCode.
+     */
+    installForHost(host, hostDirName, options) {
+        const targetRoot = options.targetRoot;
+        const sourceRoot = path.join(this.templatesRoot, host);
+        if (!fs.existsSync(sourceRoot)) {
+            throw new Error(`DIST_TEMPLATES_MISSING: expected templates at ${sourceRoot}. ` +
+                `Run "npm run build" or reinstall @open-life/cli.`);
+        }
+        const files = [];
+        const notes = [];
+        // 1. Agents → <root>/<hostDir>/agents/openlife-*.md
+        const agentsSrc = path.join(sourceRoot, 'agents');
+        if (fs.existsSync(agentsSrc)) {
+            const agentsDst = path.join(targetRoot, hostDirName, 'agents');
+            files.push(...this.copyDir(agentsSrc, agentsDst));
+        }
+        // 2. Slash commands → <root>/<hostDir>/commands/openlife/*.md
+        const commandsSrc = path.join(sourceRoot, 'commands', 'openlife');
+        if (fs.existsSync(commandsSrc)) {
+            const commandsDst = path.join(targetRoot, hostDirName, 'commands', 'openlife');
+            files.push(...this.copyDir(commandsSrc, commandsDst));
+        }
+        // 3. MCP manifest staged for manual merge
+        const mcpSrc = path.join(sourceRoot, 'mcp', 'openlife-orchestrator.json');
+        let mcpSnippetPath;
+        if (fs.existsSync(mcpSrc)) {
+            const stateDir = path.join(targetRoot, '.openlife');
+            if (!fs.existsSync(stateDir))
+                fs.mkdirSync(stateDir, { recursive: true });
+            mcpSnippetPath = path.join(stateDir, `install-mcp-snippet-${host}.json`);
+            const action = this.copyFile(mcpSrc, mcpSnippetPath);
+            files.push(action);
+            notes.push(`MCP manifest staged at ${mcpSnippetPath}. ` +
+                `To enable, merge its "mcpServers" entry into the ${host} configuration file.`);
+        }
+        return {
+            host,
+            targetRoot,
+            files,
+            mcpSnippetPath,
+            notes
+        };
+    }
+    // --- Story 3.4: reversible uninstall ---
+    /**
+     * Dispatch on validated Host for uninstall. Throws HostNotYetSupportedError for hosts
+     * without an uninstaller (currently only claude-code is supported, mirroring install).
+     */
+    uninstall(host, options) {
+        switch (host) {
+            case 'claude-code':
+                return this.uninstallForClaudeCode(options);
+            case 'gemini-cli':
+                return this.uninstallForGeminiCli(options);
+            case 'codex':
+                return this.uninstallForCodex(options);
+            default:
+                throw new HostNotYetSupportedError(host);
+        }
+    }
+    uninstallForClaudeCode(options) {
+        const targetRoot = options.targetRoot;
+        const files = [];
+        const notes = [];
+        // 1. Agents — remove only files prefixed with "openlife-" (user files untouched).
+        //    If a .bak exists next to it, the user had edited the file before reinstall:
+        //    restore the .bak by renaming it back over the destination.
+        const agentsDir = path.join(targetRoot, '.claude', 'agents');
+        if (fs.existsSync(agentsDir)) {
+            // Snapshot entries first — removeFileWithBakRestore mutates the directory
+            // (rename .bak → base) which could race with a live readdirSync iterator.
+            // Skip .bak entries: they're handled implicitly when we process the base file.
+            const entries = fs.readdirSync(agentsDir);
+            for (const entry of entries) {
+                if (!entry.startsWith('openlife-'))
+                    continue;
+                if (entry.endsWith('.bak'))
+                    continue;
+                const dst = path.join(agentsDir, entry);
+                if (!fs.existsSync(dst))
+                    continue;
+                const stat = fs.statSync(dst);
+                if (!stat.isFile())
+                    continue;
+                files.push(this.removeFileWithBakRestore(dst));
+            }
+        }
+        else {
+            files.push({ destination: agentsDir, action: 'skipped-not-found' });
+        }
+        // 2. Commands namespace — the whole .claude/commands/openlife/ directory is ours.
+        //    Iterate files (.bak restore applies the same way), then rmdir the now-empty dir.
+        const commandsDir = path.join(targetRoot, '.claude', 'commands', 'openlife');
+        if (fs.existsSync(commandsDir)) {
+            const entries = fs.readdirSync(commandsDir);
+            // Remove .md files first (handle .bak restore), .bak entries are handled by removeFileWithBakRestore
+            // when it processes the matching .md file. Any orphan files left after .md pass also get removed.
+            const handled = new Set();
+            for (const entry of entries) {
+                if (entry.endsWith('.bak'))
+                    continue; // handled via base file
+                const dst = path.join(commandsDir, entry);
+                const stat = fs.statSync(dst);
+                if (!stat.isFile())
+                    continue;
+                files.push(this.removeFileWithBakRestore(dst));
+                handled.add(entry);
+            }
+            // Now sweep any remaining files (orphan .bak entries whose .md was already gone — rare).
+            for (const entry of fs.readdirSync(commandsDir)) {
+                if (handled.has(entry))
+                    continue;
+                const dst = path.join(commandsDir, entry);
+                const stat = fs.statSync(dst);
+                if (!stat.isFile())
+                    continue;
+                fs.unlinkSync(dst);
+                files.push({ destination: dst, action: 'removed' });
+            }
+            // Only rmdir if empty (after .bak restore there may still be user-edited files left).
+            const remaining = fs.readdirSync(commandsDir);
+            if (remaining.length === 0) {
+                fs.rmdirSync(commandsDir);
+                notes.push(`Removed empty namespace directory: ${commandsDir}`);
+            }
+            else {
+                notes.push(`Kept ${commandsDir} — still contains ${remaining.length} file(s) ` +
+                    `(restored user edits or unexpected entries).`);
+            }
+        }
+        else {
+            files.push({ destination: commandsDir, action: 'skipped-not-found' });
+        }
+        // 3. MCP snippet — single file in .openlife/. Do NOT remove .openlife/ itself
+        //    (it holds runtime state: governance consents, mission state, etc.).
+        const mcpSnippet = path.join(targetRoot, '.openlife', 'install-mcp-snippet.json');
+        if (fs.existsSync(mcpSnippet)) {
+            fs.unlinkSync(mcpSnippet);
+            files.push({ destination: mcpSnippet, action: 'removed' });
+        }
+        else {
+            files.push({ destination: mcpSnippet, action: 'skipped-not-found' });
+        }
+        notes.push(`.openlife/ runtime state directory intentionally preserved (governance consents, mission state, etc.). ` +
+            `Use a future --purge flag to remove it.`);
+        return {
+            host: 'claude-code',
+            targetRoot,
+            files,
+            notes
+        };
+    }
+    /** Story 9.3 uninstall — mirrors uninstallForClaudeCode for `.gemini/`. */
+    uninstallForGeminiCli(options) {
+        return this.uninstallForHost('gemini-cli', '.gemini', options);
+    }
+    /** Story 9.4 uninstall — mirrors uninstallForClaudeCode for `.codex/`. */
+    uninstallForCodex(options) {
+        return this.uninstallForHost('codex', '.codex', options);
+    }
+    uninstallForHost(host, hostDirName, options) {
+        const targetRoot = options.targetRoot;
+        const files = [];
+        const notes = [];
+        // 1. Agents — only files prefixed with "openlife-".
+        const agentsDir = path.join(targetRoot, hostDirName, 'agents');
+        if (fs.existsSync(agentsDir)) {
+            const entries = fs.readdirSync(agentsDir);
+            for (const entry of entries) {
+                if (!entry.startsWith('openlife-'))
+                    continue;
+                if (entry.endsWith('.bak'))
+                    continue;
+                const dst = path.join(agentsDir, entry);
+                if (!fs.existsSync(dst))
+                    continue;
+                const stat = fs.statSync(dst);
+                if (!stat.isFile())
+                    continue;
+                files.push(this.removeFileWithBakRestore(dst));
+            }
+        }
+        else {
+            files.push({ destination: agentsDir, action: 'skipped-not-found' });
+        }
+        // 2. Commands namespace.
+        const commandsDir = path.join(targetRoot, hostDirName, 'commands', 'openlife');
+        if (fs.existsSync(commandsDir)) {
+            const entries = fs.readdirSync(commandsDir);
+            const handled = new Set();
+            for (const entry of entries) {
+                if (entry.endsWith('.bak'))
+                    continue;
+                const dst = path.join(commandsDir, entry);
+                const stat = fs.statSync(dst);
+                if (!stat.isFile())
+                    continue;
+                files.push(this.removeFileWithBakRestore(dst));
+                handled.add(entry);
+            }
+            const remaining = fs.readdirSync(commandsDir);
+            if (remaining.length === 0) {
+                fs.rmdirSync(commandsDir);
+                notes.push(`Removed empty namespace directory: ${commandsDir}`);
+            }
+            else {
+                notes.push(`Kept ${commandsDir} — still contains ${remaining.length} file(s).`);
+            }
+        }
+        else {
+            files.push({ destination: commandsDir, action: 'skipped-not-found' });
+        }
+        // 3. MCP snippet (host-specific name).
+        const mcpSnippet = path.join(targetRoot, '.openlife', `install-mcp-snippet-${host}.json`);
+        if (fs.existsSync(mcpSnippet)) {
+            fs.unlinkSync(mcpSnippet);
+            files.push({ destination: mcpSnippet, action: 'removed' });
+        }
+        else {
+            files.push({ destination: mcpSnippet, action: 'skipped-not-found' });
+        }
+        notes.push('.openlife/ runtime state directory intentionally preserved.');
+        return { host, targetRoot, files, notes };
+    }
+    // --- file ops (private) ---
+    copyDir(src, dst) {
+        if (!fs.existsSync(src)) {
+            return [{ source: src, destination: dst, action: 'skipped-not-found' }];
+        }
+        if (!fs.existsSync(dst))
+            fs.mkdirSync(dst, { recursive: true });
+        const actions = [];
+        for (const entry of fs.readdirSync(src)) {
+            const srcFile = path.join(src, entry);
+            const dstFile = path.join(dst, entry);
+            const stat = fs.statSync(srcFile);
+            if (stat.isFile()) {
+                actions.push(this.copyFile(srcFile, dstFile));
+            }
+            // Subdirs intentionally not recursed at this layer — host layouts are flat-by-design.
+        }
+        return actions;
+    }
+    /**
+     * Story 3.4 — Remove a file installed by Story 3.3, restoring the user's edit
+     * from .bak if one exists. Returns the action descriptor for the result envelope.
+     *
+     * Behavior:
+     *   - dst exists, dst.bak exists: rename dst.bak → dst (user's edit survives), action='restored-from-bak'
+     *   - dst exists, no .bak: unlink dst, action='removed'
+     *   - dst missing: action='skipped-not-found'
+     */
+    removeFileWithBakRestore(dst) {
+        if (!fs.existsSync(dst)) {
+            return { destination: dst, action: 'skipped-not-found' };
+        }
+        const backupPath = `${dst}.bak`;
+        if (fs.existsSync(backupPath)) {
+            // Restore user's edit. fs.renameSync overwrites the target atomically on POSIX/NTFS.
+            fs.unlinkSync(dst);
+            fs.renameSync(backupPath, dst);
+            return { destination: dst, action: 'restored-from-bak', backupPath };
+        }
+        fs.unlinkSync(dst);
+        return { destination: dst, action: 'removed' };
+    }
+    copyFile(src, dst) {
+        const srcContent = fs.readFileSync(src, 'utf-8');
+        if (!fs.existsSync(dst)) {
+            fs.writeFileSync(dst, srcContent, 'utf-8');
+            return { source: src, destination: dst, action: 'created' };
+        }
+        const existing = fs.readFileSync(dst, 'utf-8');
+        if (existing === srcContent) {
+            return { source: src, destination: dst, action: 'skipped-identical' };
+        }
+        // Different content — back up the existing file before overwriting.
+        const backupPath = `${dst}.bak`;
+        fs.writeFileSync(backupPath, existing, 'utf-8');
+        fs.writeFileSync(dst, srcContent, 'utf-8');
+        return { source: src, destination: dst, action: 'updated', backupPath };
+    }
+}
+exports.HostInstaller = HostInstaller;

package/dist/cli/InstallBanner.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installationBanner = installationBanner;
+function installationBanner() {
+    const purple = '\x1b[1;95m';
+    const reset = '\x1b[0m';
+    const title = [
+        '██████╗ ██████╗ ███████╗███╗   ██╗██╗     ██╗███████╗███████╗',
+        '██╔═══██╗██╔══██╗██╔════╝████╗  ██║██║     ██║██╔════╝██╔════╝',
+        '██║   ██║██████╔╝█████╗  ██╔██╗ ██║██║     ██║█████╗  █████╗  ',
+        '██║   ██║██╔═══╝ ██╔══╝  ██║╚██╗██║██║     ██║██╔══╝  ██╔══╝  ',
+        '╚██████╔╝██║     ███████╗██║ ╚████║███████╗██║██║     ███████╗',
+        ' ╚═════╝ ╚═╝     ╚══════╝╚═╝  ╚═══╝╚══════╝╚═╝╚═╝     ╚══════╝'
+    ].join('\n');
+    return `${purple}${title}${reset}`;
+}