@zhijiewang/openharness 0.12.0 → 1.0.0

package/README.md

@@ -366,6 +366,16 @@ mcpServers:
 
 MCP tools appear alongside built-in tools. `/status` shows connected servers.
 
+**MCP Server Registry** — browse and install from a curated catalog:
+
+```
+/mcp-registry              # browse all available servers
+/mcp-registry github       # show install config for a specific server
+/mcp-registry database     # search by category
+```
+
+Categories: filesystem, git, database, api, search, productivity, dev-tools, ai.
+
 ## Git Integration
 
 OpenHarness auto-commits AI edits in git repos:
@@ -460,6 +470,9 @@ Dispatch specialized sub-agents for focused tasks:
 | `refactorer` | Simplify code without changing behavior | All file tools + Bash |
 | `security-auditor` | OWASP, injection, secrets, CVE scanning | Read-only + Bash |
 | `evaluator` | Evaluate code quality and run tests (read-only) | Read-only + Bash + Diagnostics |
+| `planner` | Design step-by-step implementation plans | Read-only + Bash |
+| `architect` | Analyze architecture and design structural changes | Read-only |
+| `migrator` | Systematic codebase migrations and upgrades | All file tools + Bash |
 
 Each role restricts the sub-agent to only its suggested tools. You can also pass `allowed_tools` explicitly:
 
@@ -598,6 +611,49 @@ Create `.oh/RULES.md` in any repo (or run `oh init`):
 
 Rules load automatically into every session.
 
+## Skills & Plugins
+
+### Skills
+
+Skills are markdown files with YAML frontmatter that add reusable behaviors:
+
+```markdown
+---
+name: deploy
+description: Deploy the application to production
+trigger: deploy
+tools: [Bash, Read]
+---
+
+Run the deploy script with health checks...
+```
+
+**Locations** (searched in order):
+1. `.oh/skills/` — project-level skills
+2. `~/.oh/skills/` — global skills (available in all projects)
+
+Skills auto-trigger when the user's message contains the trigger keyword, or can be invoked explicitly with `/skill deploy`.
+
+### Plugins
+
+Plugins are npm packages that bundle skills, hooks, and MCP servers:
+
+```json
+{
+  "name": "my-openharness-plugin",
+  "version": "1.0.0",
+  "skills": ["skills/deploy.md", "skills/review.md"],
+  "hooks": {
+    "sessionStart": "scripts/setup.sh"
+  },
+  "mcpServers": [
+    { "name": "my-api", "command": "npx", "args": ["-y", "@my-org/mcp-server"] }
+  ]
+}
+```
+
+Save as `openharness-plugin.json` in your npm package root. Install with `npm install`, and openHarness discovers it automatically from `node_modules/`.
+
 ## How It Works
 
 ```mermaid

package/dist/agents/roles.js

@@ -114,6 +114,48 @@ Report findings with severity (Critical/High/Medium/Low), affected file:line, an
 You CANNOT modify files. Only read, search, and run test/lint commands to evaluate.`,
         suggestedTools: ['Read', 'Glob', 'Grep', 'LS', 'Bash', 'Diagnostics'],
     },
+    {
+        id: 'planner',
+        name: 'Planner',
+        description: 'Designs step-by-step implementation plans from requirements',
+        systemPromptSupplement: `You are a planning agent. Your job is to:
+- Read the codebase to understand architecture, patterns, and conventions
+- Design a detailed step-by-step implementation plan for the given task
+- Identify files to create, modify, or delete with specific change descriptions
+- Flag risks, dependencies, and the recommended implementation order
+- Estimate scope (number of files, complexity)
+
+Do NOT implement anything. Your output is a plan document, not code. Read widely before planning.`,
+        suggestedTools: ['Read', 'Glob', 'Grep', 'LS', 'Bash'],
+    },
+    {
+        id: 'architect',
+        name: 'Architect',
+        description: 'Analyzes system architecture and designs structural changes',
+        systemPromptSupplement: `You are an architecture agent. Your job is to:
+- Map the current system architecture (modules, dependencies, data flow)
+- Identify architectural patterns and conventions in use
+- Design structural changes that preserve existing patterns
+- Evaluate trade-offs between approaches (performance, maintainability, complexity)
+- Document interfaces, contracts, and integration points
+
+Focus on the big picture: module boundaries, data flow, dependency graphs. Leave implementation details to other agents.`,
+        suggestedTools: ['Read', 'Glob', 'Grep', 'LS'],
+    },
+    {
+        id: 'migrator',
+        name: 'Migrator',
+        description: 'Performs codebase migrations (API upgrades, framework changes, renames)',
+        systemPromptSupplement: `You are a migration agent. Your job is to:
+- Identify all occurrences of the pattern/API/convention being migrated
+- Apply changes systematically across all affected files
+- Preserve behavior while updating the implementation
+- Run tests after each batch of changes to catch regressions
+- Handle edge cases and conditional patterns that need manual review
+
+Work methodically: search exhaustively, change incrementally, test after each batch. Never leave a migration half-done.`,
+        suggestedTools: ['Read', 'Write', 'Edit', 'Glob', 'Grep', 'Bash'],
+    },
 ];
 /** Get a role by ID */
 export function getRole(id) {

package/dist/commands/index.js

@@ -27,7 +27,7 @@ register("help", "Show available commands", () => {
     const categories = {
         'Session': ['clear', 'compact', 'export', 'history', 'browse', 'resume', 'fork', 'pin', 'unpin'],
         'Git': ['diff', 'undo', 'rewind', 'commit', 'log'],
-        'Info': ['help', 'cost', 'status', 'config', 'files', 'model', 'memory', 'doctor', 'context', 'mcp'],
+        'Info': ['help', 'cost', 'status', 'config', 'files', 'model', 'memory', 'doctor', 'context', 'mcp', 'mcp-registry'],
         'Settings': ['theme', 'vim', 'companion', 'fast', 'keys'],
         'AI': ['plan', 'review', 'roles'],
         'Pet': ['cybergotchi'],
@@ -473,18 +473,61 @@ register("doctor", "Run diagnostic health checks", (_args, ctx) => {
     lines.push(`  Session:       ${ctx.sessionId}`);
     lines.push(`  Messages:      ${ctx.messages.length}`);
     lines.push(`  Cost:          $${ctx.totalCost.toFixed(4)}`);
-    // Disk space (basic check)
+    // Disk space & storage
     try {
-        const { statSync } = require("node:fs");
         const ohDir = join(homedir(), ".oh");
         if (existsSync(ohDir)) {
-            const sessions = readdirSync(join(ohDir, "sessions")).length;
-            lines.push(`  Sessions:      ${sessions} saved`);
-            if (sessions > 80)
-                issues.push(`${sessions} saved sessions. Consider cleaning old ones.`);
+            const sessionsDir = join(ohDir, "sessions");
+            const sessCount = existsSync(sessionsDir) ? readdirSync(sessionsDir).filter(f => f.endsWith('.json')).length : 0;
+            lines.push(`  Sessions:      ${sessCount} saved`);
+            if (sessCount > 80)
+                issues.push(`${sessCount} saved sessions. Consider cleaning old ones.`);
+            // Memory stats
+            const memDir = join(ohDir, "memory");
+            const memCount = existsSync(memDir) ? readdirSync(memDir).filter(f => f.endsWith('.md')).length : 0;
+            lines.push(`  Memories:      ${memCount} global`);
+            // Cron stats
+            const cronDir = join(ohDir, "crons");
+            const cronCount = existsSync(cronDir) ? readdirSync(cronDir).filter(f => f.endsWith('.json')).length : 0;
+            lines.push(`  Cron tasks:    ${cronCount}`);
         }
     }
     catch { /* ignore */ }
+    // Project-level stats
+    try {
+        const projMemDir = join(".oh", "memory");
+        const projMemCount = existsSync(projMemDir) ? readdirSync(projMemDir).filter(f => f.endsWith('.md')).length : 0;
+        if (projMemCount > 0)
+            lines.push(`  Project mems:  ${projMemCount}`);
+        const skillsDir = join(".oh", "skills");
+        const skillCount = existsSync(skillsDir) ? readdirSync(skillsDir).filter(f => f.endsWith('.md')).length : 0;
+        if (skillCount > 0)
+            lines.push(`  Skills:        ${skillCount}`);
+    }
+    catch { /* ignore */ }
+    // Global config
+    const globalCfg = existsSync(join(homedir(), ".oh", "config.yaml"));
+    lines.push(`  Global config: ${globalCfg ? "~/.oh/config.yaml ✓" : "not set (optional)"}`);
+    // Verification config
+    try {
+        const { getVerificationConfig } = require('../harness/verification.js');
+        const vCfg = getVerificationConfig();
+        if (vCfg?.enabled) {
+            lines.push(`  Verification:  ✓ (${vCfg.rules.length} rules, mode: ${vCfg.mode})`);
+        }
+        else {
+            lines.push(`  Verification:  off (no rules detected)`);
+        }
+    }
+    catch { /* ignore */ }
+    // Tools
+    lines.push("");
+    lines.push(`  Tools:         ${ctx.messages.length > 0 ? 'ready' : 'loaded'}`);
+    // Node.js version
+    lines.push(`  Node.js:       ${process.version}`);
+    const [major] = process.version.slice(1).split('.').map(Number);
+    if (major && major < 18)
+        issues.push(`Node.js ${process.version} is below minimum (18+). Upgrade Node.js.`);
     // Issues summary
     if (issues.length > 0) {
         lines.push("");
@@ -519,14 +562,43 @@ register("context", "Show context window usage breakdown", (_args, ctx) => {
 register("mcp", "Show MCP server status", () => {
     const mcp = connectedMcpServers();
     if (mcp.length === 0) {
-        return { output: "No MCP servers connected.\nConfigure in .oh/config.yaml under mcpServers.", handled: true };
+        return { output: "No MCP servers connected.\nConfigure in .oh/config.yaml under mcpServers.\nRun /mcp-registry to browse available servers.", handled: true };
     }
     const lines = [`MCP Servers (${mcp.length} connected):\n`];
     for (const name of mcp) {
         lines.push(`  ✓ ${name}`);
     }
+    lines.push("\nRun /mcp-registry to browse and add more servers.");
     return { output: lines.join("\n"), handled: true };
 });
+register("mcp-registry", "Browse and add MCP servers from the curated registry", (args) => {
+    const { searchRegistry, formatRegistry, generateConfigBlock, MCP_REGISTRY } = require('../mcp/registry.js');
+    const query = args.trim();
+    if (!query) {
+        // Show full registry
+        const output = `MCP Server Registry (${MCP_REGISTRY.length} servers)\n${'─'.repeat(50)}\n\n${formatRegistry()}\n\nUsage:\n  /mcp-registry <name>    Show install config for a server\n  /mcp-registry <keyword> Search by name, description, or category`;
+        return { output, handled: true };
+    }
+    // Search or show specific server
+    const results = searchRegistry(query);
+    if (results.length === 0) {
+        return { output: `No MCP servers found matching "${query}".`, handled: true };
+    }
+    if (results.length === 1) {
+        // Show install instructions
+        const entry = results[0];
+        const config = generateConfigBlock(entry);
+        const envNote = entry.envVars?.length
+            ? `\n\nRequired environment variables:\n${entry.envVars.map((v) => `  - ${v}`).join('\n')}`
+            : '';
+        return {
+            output: `${entry.name} — ${entry.description}\nPackage: ${entry.package}\nRisk: ${entry.riskLevel ?? 'medium'}${envNote}\n\nAdd to .oh/config.yaml under mcpServers:\n\n${config}`,
+            handled: true,
+        };
+    }
+    // Multiple results
+    return { output: `Found ${results.length} servers:\n\n${formatRegistry(results)}`, handled: true };
+});
 function setPinned(args, ctx, pinned) {
     const idx = parseInt(args.trim(), 10);
     if (isNaN(idx) || idx < 1 || idx > ctx.messages.length) {
@@ -542,6 +614,53 @@ function setPinned(args, ctx, pinned) {
 }
 register("pin", "Pin a message (survives /compact)", (args, ctx) => setPinned(args, ctx, true));
 register("unpin", "Unpin a message", (args, ctx) => setPinned(args, ctx, false));
+register("plugins", "List installed plugins and discover new ones", (args) => {
+    const { discoverPlugins, discoverSkills } = require('../harness/plugins.js');
+    const query = args.trim();
+    if (query === 'search' || query.startsWith('search ')) {
+        // npm registry search
+        const keyword = query.replace(/^search\s*/, '').trim() || 'openharness-plugin';
+        return {
+            output: `To discover plugins, search npm:\n\n  npm search openharness-plugin${keyword !== 'openharness-plugin' ? ' ' + keyword : ''}\n\nInstall with:\n  npm install <package-name>\n\nPlugins are auto-discovered from node_modules/ if they contain openharness-plugin.json.`,
+            handled: true,
+        };
+    }
+    // List installed
+    const plugins = discoverPlugins();
+    const skills = discoverSkills();
+    const lines = [];
+    if (plugins.length > 0) {
+        lines.push(`Installed Plugins (${plugins.length}):`);
+        for (const p of plugins) {
+            lines.push(`  ${p.name}@${p.version} — ${p.description || 'no description'}`);
+            if (p.skills?.length)
+                lines.push(`    Skills: ${p.skills.length}`);
+            if (p.mcpServers?.length)
+                lines.push(`    MCP servers: ${p.mcpServers.map((s) => s.name).join(', ')}`);
+        }
+        lines.push('');
+    }
+    if (skills.length > 0) {
+        lines.push(`Available Skills (${skills.length}):`);
+        const bySource = {};
+        for (const s of skills) {
+            (bySource[s.source] ??= []).push(s);
+        }
+        for (const [source, sourceSkills] of Object.entries(bySource)) {
+            lines.push(`  ${source}:`);
+            for (const s of sourceSkills) {
+                lines.push(`    ${s.name} — ${s.description}${s.trigger ? ` (trigger: "${s.trigger}")` : ''}`);
+            }
+        }
+    }
+    else if (plugins.length === 0) {
+        lines.push('No plugins or skills installed.');
+        lines.push('');
+        lines.push('Create skills in .oh/skills/ or ~/.oh/skills/');
+        lines.push('Run /plugins search to find npm packages.');
+    }
+    return { output: lines.join('\n'), handled: true };
+});
 // ── Command Parser ──
 /**
  * Check if input is a slash command. If so, execute it.

package/dist/components/InitWizard.js

@@ -30,9 +30,30 @@ const PERMISSION_MODES = [
     { key: "trust", label: "trust — auto-approve everything" },
     { key: "deny", label: "deny  — read-only, block write/run tools" },
 ];
+/** Auto-detect provider from environment variables */
+function detectProviderFromEnv() {
+    if (process.env.ANTHROPIC_API_KEY)
+        return PROVIDERS.findIndex(p => p.key === "anthropic");
+    if (process.env.OPENAI_API_KEY)
+        return PROVIDERS.findIndex(p => p.key === "openai");
+    if (process.env.OPENROUTER_API_KEY)
+        return PROVIDERS.findIndex(p => p.key === "openrouter");
+    return 0; // Default to Ollama
+}
+/** Get the detected API key for a provider */
+function getEnvApiKey(providerKey) {
+    const envMap = {
+        anthropic: 'ANTHROPIC_API_KEY',
+        openai: 'OPENAI_API_KEY',
+        openrouter: 'OPENROUTER_API_KEY',
+    };
+    const envVar = envMap[providerKey];
+    return envVar ? (process.env[envVar] ?? '') : '';
+}
 export default function InitWizard({ onDone }) {
+    const detectedIdx = detectProviderFromEnv();
     const [step, setStep] = useState("provider");
-    const [providerIdx, setProviderIdx] = useState(0);
+    const [providerIdx, setProviderIdx] = useState(detectedIdx);
     const [apiKey, setApiKey] = useState("");
     const [baseUrl, setBaseUrl] = useState("");
     const [model, setModel] = useState("");
@@ -43,6 +64,9 @@ export default function InitWizard({ onDone }) {
     const [permIdx, setPermIdx] = useState(0);
     const [hatchGotchi, setHatchGotchi] = useState(false);
     const [showSetup, setShowSetup] = useState(false);
+    const [suggestedMcp, setSuggestedMcp] = useState([]);
+    const [selectedMcp, setSelectedMcp] = useState(new Set());
+    const [mcpIdx, setMcpIdx] = useState(0);
     const provider = PROVIDERS[providerIdx];
     // ── Keyboard navigation ──
     useInput(useCallback((input, key) => {
@@ -54,11 +78,19 @@ export default function InitWizard({ onDone }) {
             if (key.return) {
                 setBaseUrl(provider.defaultBaseUrl ?? "");
                 setModel(provider.defaultModel);
+                // Auto-fill API key from environment if available
+                const envKey = getEnvApiKey(provider.key);
+                if (envKey)
+                    setApiKey(envKey);
                 if (!provider.needsApiKey) {
-                    // Skip API key, go straight to testing
                     runTest(provider, "", provider.defaultBaseUrl ?? "");
                     setStep("testing");
                 }
+                else if (envKey) {
+                    // Have env API key — skip manual entry, go to testing
+                    runTest(provider, envKey, provider.defaultBaseUrl ?? "");
+                    setStep("testing");
+                }
                 else {
                     setStep("apikey");
                 }
@@ -69,8 +101,37 @@ export default function InitWizard({ onDone }) {
                 setPermIdx(i => Math.max(0, i - 1));
             if (key.downArrow)
                 setPermIdx(i => Math.min(PERMISSION_MODES.length - 1, i + 1));
+            if (key.return) {
+                // Suggest popular MCP servers
+                setSuggestedMcp(['github', 'memory', 'fetch', 'sequential-thinking', 'brave-search']);
+                setMcpIdx(0);
+                setSelectedMcp(new Set());
+                setStep("mcp");
+            }
+        }
+        if (step === "mcp") {
+            if (key.upArrow)
+                setMcpIdx(i => Math.max(0, i - 1));
+            if (key.downArrow)
+                setMcpIdx(i => Math.min(suggestedMcp.length - 1, i + 1));
+            if (input === " ") {
+                // Toggle selection
+                const name = suggestedMcp[mcpIdx];
+                if (name) {
+                    setSelectedMcp(prev => {
+                        const next = new Set(prev);
+                        if (next.has(name))
+                            next.delete(name);
+                        else
+                            next.add(name);
+                        return next;
+                    });
+                }
+            }
             if (key.return)
                 setStep("gotchi");
+            if (input === "s" || input === "S")
+                setStep("gotchi"); // Skip
         }
         if (step === "model" && availableModels.length > 0) {
             if (key.upArrow)
@@ -120,16 +181,34 @@ export default function InitWizard({ onDone }) {
     // ── Write final config ──
     const writeFinal = useCallback(() => {
         const selectedModel = availableModels.length > 0 ? (availableModels[modelIdx] ?? model) : model;
+        // Build MCP server configs from selected registry entries
+        let mcpServers;
+        if (selectedMcp.size > 0) {
+            try {
+                const { MCP_REGISTRY } = require('../mcp/registry.js');
+                mcpServers = [...selectedMcp]
+                    .map(name => MCP_REGISTRY.find((e) => e.name === name))
+                    .filter(Boolean)
+                    .map((e) => ({
+                    name: e.name,
+                    command: 'npx',
+                    args: ['-y', e.package, ...(e.args ?? [])],
+                    ...(e.envVars?.length ? { env: Object.fromEntries(e.envVars.map((v) => [v, `YOUR_${v}`])) } : {}),
+                }));
+            }
+            catch { /* ignore */ }
+        }
         writeOhConfig({
             provider: provider.key,
             model: selectedModel || provider.defaultModel,
             permissionMode: PERMISSION_MODES[permIdx].key,
             ...(apiKey ? { apiKey } : {}),
             ...(baseUrl ? { baseUrl } : {}),
+            ...(mcpServers?.length ? { mcpServers } : {}),
         });
         setStep("done");
         setTimeout(() => onDone?.(), 1500);
-    }, [provider, model, availableModels, modelIdx, permIdx, apiKey, baseUrl]);
+    }, [provider, model, availableModels, modelIdx, permIdx, apiKey, baseUrl, selectedMcp]);
     // ── Render ──
     if (showSetup) {
         return _jsx(CybergotchiSetup, { onComplete: () => { setShowSetup(false); writeFinal(); }, onSkip: () => { setShowSetup(false); writeFinal(); } });
@@ -137,7 +216,7 @@ export default function InitWizard({ onDone }) {
     if (step === "done") {
         return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Text, { color: "green", children: "\u2713 OpenHarness configured!" }), _jsx(Text, { dimColor: true, children: "Config saved to .oh/config.yaml" }), _jsx(Text, { dimColor: true, children: "Run: oh" })] }));
     }
-    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "OpenHarness Setup" }), _jsx(Text, { children: " " }), step === "provider" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Select provider:" }), PROVIDERS.map((p, i) => (_jsxs(Text, { color: i === providerIdx ? "cyan" : undefined, children: [i === providerIdx ? "▶ " : "  ", p.label] }, p.key))), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "\u2191\u2193 navigate  Enter select" })] })), step === "apikey" && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["API key for ", _jsx(Text, { color: "cyan", children: provider.label }), ":"] }), _jsx(TextInput, { value: apiKey, onChange: setApiKey, mask: "*", onSubmit: (val) => {
+    return (_jsxs(Box, { flexDirection: "column", padding: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "OpenHarness Setup" }), _jsx(Text, { children: " " }), step === "provider" && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["Select provider:", detectedIdx > 0 ? _jsx(Text, { dimColor: true, children: " (auto-detected from env)" }) : ''] }), PROVIDERS.map((p, i) => (_jsxs(Text, { color: i === providerIdx ? "cyan" : undefined, children: [i === providerIdx ? "▶ " : "  ", p.label] }, p.key))), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "\u2191\u2193 navigate  Enter select" })] })), step === "apikey" && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["API key for ", _jsx(Text, { color: "cyan", children: provider.label }), ":"] }), _jsx(TextInput, { value: apiKey, onChange: setApiKey, mask: "*", onSubmit: (val) => {
                             if (!val.trim())
                                 return;
                             if (provider.key === "custom") {
@@ -158,6 +237,6 @@ export default function InitWizard({ onDone }) {
                                     const gi = start + vi;
                                     return (_jsxs(Text, { color: gi === modelIdx ? "cyan" : undefined, children: [gi === modelIdx ? "▶ " : "  ", m] }, m));
                                 }), start + WINDOW < availableModels.length && (_jsxs(Text, { dimColor: true, children: ["  \u2193 ", availableModels.length - start - WINDOW, " more"] }))] }));
-                    })() : (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "Could not fetch model list. Enter model name:" }), _jsx(TextInput, { value: model, onChange: setModel, onSubmit: () => setStep("permission") })] })), availableModels.length > 0 && _jsx(Text, { dimColor: true, children: "\u2191\u2193 navigate  Enter select" })] })), step === "permission" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Permission mode:" }), PERMISSION_MODES.map((p, i) => (_jsxs(Text, { color: i === permIdx ? "cyan" : undefined, children: [i === permIdx ? "▶ " : "  ", p.label] }, p.key))), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "\u2191\u2193 navigate  Enter select" })] })), step === "gotchi" && (_jsx(Box, { flexDirection: "column", children: _jsxs(Text, { children: ["Hatch a cybergotchi companion? ", _jsx(Text, { dimColor: true, children: "(Y/n)" })] }) }))] }));
+                    })() : (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "Could not fetch model list. Enter model name:" }), _jsx(TextInput, { value: model, onChange: setModel, onSubmit: () => setStep("permission") })] })), availableModels.length > 0 && _jsx(Text, { dimColor: true, children: "\u2191\u2193 navigate  Enter select" })] })), step === "permission" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: "Permission mode:" }), PERMISSION_MODES.map((p, i) => (_jsxs(Text, { color: i === permIdx ? "cyan" : undefined, children: [i === permIdx ? "▶ " : "  ", p.label] }, p.key))), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "\u2191\u2193 navigate  Enter select" })] })), step === "mcp" && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["Add MCP servers? ", _jsx(Text, { dimColor: true, children: "(Space to toggle, Enter to confirm, S to skip)" })] }), _jsx(Text, { children: " " }), suggestedMcp.map((name, i) => (_jsxs(Text, { color: i === mcpIdx ? "cyan" : undefined, children: [i === mcpIdx ? "▶ " : "  ", selectedMcp.has(name) ? "[✓] " : "[ ] ", name] }, name))), _jsx(Text, { children: " " }), _jsx(Text, { dimColor: true, children: "\u2191\u2193 navigate  Space toggle  Enter confirm  S skip" })] })), step === "gotchi" && (_jsx(Box, { flexDirection: "column", children: _jsxs(Text, { children: ["Hatch a cybergotchi companion? ", _jsx(Text, { dimColor: true, children: "(Y/n)" })] }) }))] }));
 }
 //# sourceMappingURL=InitWizard.js.map

package/dist/harness/session.d.ts

@@ -13,6 +13,14 @@ export type Session = {
     gitBranch?: string;
     workingDir?: string;
     tools?: string[];
+    /** Hibernate state — saved on exit for wake reconstruction */
+    hibernate?: {
+        summary?: string;
+        lastUserMessage?: string;
+        pendingTask?: string;
+        totalInputTokens?: number;
+        totalOutputTokens?: number;
+    };
 };
 export declare function createSession(provider: string, model: string, extras?: {
     gitBranch?: string;
@@ -30,6 +38,17 @@ export declare function listSessions(dir?: string): Array<{
 }>;
 /** Returns the ID of the most recently updated session, or null if none exist. */
 export declare function getLastSessionId(dir?: string): string | null;
+/**
+ * Build hibernate state from the current session.
+ * Captures the last user message, recent assistant activity,
+ * and a brief summary for context reconstruction on wake.
+ */
+export declare function buildHibernateState(messages: Message[]): Session['hibernate'];
+/**
+ * Generate a wake-up context message for a resumed session.
+ * Tells the LLM what happened in the previous session.
+ */
+export declare function buildWakeContext(session: Session): string;
 /**
  * Evict oldest sessions when count exceeds MAX_SESSIONS.
  * Called automatically by saveSession.

package/dist/harness/session.js

@@ -72,6 +72,59 @@ export function getLastSessionId(dir) {
     const sessions = listSessions(dir);
     return sessions.length > 0 ? sessions[0].id : null;
 }
+/**
+ * Build hibernate state from the current session.
+ * Captures the last user message, recent assistant activity,
+ * and a brief summary for context reconstruction on wake.
+ */
+export function buildHibernateState(messages) {
+    if (messages.length === 0)
+        return undefined;
+    // Find last user message
+    const lastUser = [...messages].reverse().find(m => m.role === 'user');
+    const lastAssistant = [...messages].reverse().find(m => m.role === 'assistant');
+    // Build a brief summary from the last few exchanges
+    const recentMsgs = messages.slice(-6);
+    const summaryParts = [];
+    for (const m of recentMsgs) {
+        if (m.role === 'user') {
+            summaryParts.push(`User: ${m.content.slice(0, 100)}`);
+        }
+        else if (m.role === 'assistant' && m.content) {
+            summaryParts.push(`Assistant: ${m.content.slice(0, 100)}`);
+        }
+    }
+    return {
+        lastUserMessage: lastUser?.content.slice(0, 200),
+        pendingTask: lastAssistant?.content.slice(0, 200),
+        summary: summaryParts.join('\n'),
+    };
+}
+/**
+ * Generate a wake-up context message for a resumed session.
+ * Tells the LLM what happened in the previous session.
+ */
+export function buildWakeContext(session) {
+    const parts = ['[Session Resumed]'];
+    if (session.workingDir) {
+        parts.push(`Previous working directory: ${session.workingDir}`);
+        if (session.workingDir !== process.cwd()) {
+            parts.push(`WARNING: Working directory changed! Was: ${session.workingDir}, Now: ${process.cwd()}`);
+        }
+    }
+    if (session.gitBranch) {
+        parts.push(`Previous git branch: ${session.gitBranch}`);
+    }
+    if (session.hibernate?.summary) {
+        parts.push(`\nPrevious session context:\n${session.hibernate.summary}`);
+    }
+    if (session.hibernate?.lastUserMessage) {
+        parts.push(`\nLast user request: ${session.hibernate.lastUserMessage}`);
+    }
+    parts.push(`\nSession has ${session.messages.length} messages and cost $${session.totalCost.toFixed(4)} so far.`);
+    parts.push('Continue where you left off. If the user\'s last request was incomplete, acknowledge that and ask how to proceed.');
+    return parts.join('\n');
+}
 /** Maximum number of sessions to keep on disk. */
 const MAX_SESSIONS = 100;
 /**

package/dist/mcp/registry.d.ts

@@ -0,0 +1,31 @@
+/**
+ * MCP Server Registry — curated list of compatible MCP servers.
+ *
+ * Provides a browsable catalog of MCP servers that users can add
+ * to their .oh/config.yaml with a single command.
+ */
+export type McpRegistryEntry = {
+    name: string;
+    package: string;
+    description: string;
+    category: 'filesystem' | 'git' | 'database' | 'api' | 'search' | 'productivity' | 'dev-tools' | 'ai';
+    args?: string[];
+    envVars?: string[];
+    riskLevel?: 'low' | 'medium' | 'high';
+};
+/**
+ * Curated registry of popular MCP servers.
+ * Each entry has enough info to generate the config.yaml block.
+ */
+export declare const MCP_REGISTRY: McpRegistryEntry[];
+/** Search the registry by name or keyword */
+export declare function searchRegistry(query: string): McpRegistryEntry[];
+/** Get all entries in a category */
+export declare function getByCategory(category: McpRegistryEntry['category']): McpRegistryEntry[];
+/** Get all unique categories */
+export declare function getCategories(): string[];
+/** Generate the config.yaml block for a registry entry */
+export declare function generateConfigBlock(entry: McpRegistryEntry): string;
+/** Format registry as a browsable list */
+export declare function formatRegistry(entries?: McpRegistryEntry[]): string;
+//# sourceMappingURL=registry.d.ts.map