@zhijiewang/openharness 0.12.1 → 1.0.0

package/README.md

@@ -611,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/commands/index.js

@@ -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("");
@@ -571,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/renderer/index.d.ts

@@ -86,6 +86,13 @@ export declare class TerminalRenderer {
     private handlePermissionKey;
     /** Handle question prompt text input. Returns true if key was consumed. */
     private handleQuestionKey;
+    private renderTimer;
+    private lastRenderTime;
+    private static readonly FRAME_MS;
+    /**
+     * Schedule a render at ~60fps. Multiple calls within a frame are batched.
+     * This prevents excessive re-renders during fast token streaming.
+     */
     private scheduleRender;
     /** Apply lightweight markdown styling to a line for scrollback output */
     private styleMarkdownLine;

package/dist/renderer/index.js

@@ -108,6 +108,10 @@ export class TerminalRenderer {
             clearInterval(this.animationTimer);
             this.animationTimer = null;
         }
+        if (this.renderTimer) {
+            clearTimeout(this.renderTimer);
+            this.renderTimer = null;
+        }
         if (this.resizeHandler) {
             process.stdout.off('resize', this.resizeHandler);
             this.resizeHandler = null;
@@ -363,15 +367,39 @@ export class TerminalRenderer {
         return true;
     }
     // ── Rendering ──
+    renderTimer = null;
+    lastRenderTime = 0;
+    static FRAME_MS = 16; // ~60fps
+    /**
+     * Schedule a render at ~60fps. Multiple calls within a frame are batched.
+     * This prevents excessive re-renders during fast token streaming.
+     */
     scheduleRender() {
         if (this.renderPending || !this.started)
             return;
         this.renderPending = true;
-        queueMicrotask(() => {
-            this.renderPending = false;
-            if (this.started)
-                this.render();
-        });
+        const now = Date.now();
+        const elapsed = now - this.lastRenderTime;
+        if (elapsed >= TerminalRenderer.FRAME_MS) {
+            // Enough time has passed — render on next microtask (no delay)
+            queueMicrotask(() => {
+                this.renderPending = false;
+                this.lastRenderTime = Date.now();
+                if (this.started)
+                    this.render();
+            });
+        }
+        else {
+            // Too soon — debounce to next frame boundary
+            const delay = TerminalRenderer.FRAME_MS - elapsed;
+            this.renderTimer = setTimeout(() => {
+                this.renderTimer = null;
+                this.renderPending = false;
+                this.lastRenderTime = Date.now();
+                if (this.started)
+                    this.render();
+            }, delay);
+        }
     }
     /** Apply lightweight markdown styling to a line for scrollback output */
     styleMarkdownLine(line) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhijiewang/openharness",
-  "version": "0.12.1",
+  "version": "1.0.0",
   "description": "Open-source terminal coding agent. Works with any LLM.",
   "type": "module",
   "bin": {