@zhijiewang/openharness 2.5.0 → 2.8.0

package/README.md

@@ -21,7 +21,7 @@ AI coding agent in your terminal. Works with any LLM -- free local models or clo
   <img src="assets/openharness_v0.11.1_4.gif" alt="OpenHarness demo" width="800" />
 </p>
 
-[![npm version](https://img.shields.io/npm/v/@zhijiewang/openharness)](https://www.npmjs.com/package/@zhijiewang/openharness) [![npm downloads](https://img.shields.io/npm/dm/@zhijiewang/openharness)](https://www.npmjs.com/package/@zhijiewang/openharness) [![license](https://img.shields.io/npm/l/@zhijiewang/openharness)](LICENSE) ![tests](https://img.shields.io/badge/tests-784-brightgreen) ![tools](https://img.shields.io/badge/tools-41-blue) ![Node.js 18+](https://img.shields.io/badge/node-18%2B-green) ![TypeScript](https://img.shields.io/badge/typescript-strict-blue) [![GitHub stars](https://img.shields.io/github/stars/zhijiewong/openharness)](https://github.com/zhijiewong/openharness) [![GitHub issues](https://img.shields.io/github/issues-raw/zhijiewong/openharness)](https://github.com/zhijiewong/openharness/issues) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen)](https://github.com/zhijiewong/openharness/pulls)
+[![npm version](https://img.shields.io/npm/v/@zhijiewang/openharness)](https://www.npmjs.com/package/@zhijiewang/openharness) [![npm downloads](https://img.shields.io/npm/dm/@zhijiewang/openharness)](https://www.npmjs.com/package/@zhijiewang/openharness) [![license](https://img.shields.io/npm/l/@zhijiewang/openharness)](LICENSE) ![tests](https://img.shields.io/badge/tests-890-brightgreen) ![tools](https://img.shields.io/badge/tools-42-blue) ![Node.js 18+](https://img.shields.io/badge/node-18%2B-green) ![TypeScript](https://img.shields.io/badge/typescript-strict-blue) [![GitHub stars](https://img.shields.io/github/stars/zhijiewong/openharness)](https://github.com/zhijiewong/openharness) [![GitHub issues](https://img.shields.io/github/issues-raw/zhijiewong/openharness)](https://github.com/zhijiewong/openharness/issues) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen)](https://github.com/zhijiewong/openharness/pulls)
 
 ---
 

package/dist/commands/ai.d.ts

@@ -0,0 +1,6 @@
+/**
+ * AI commands — /plan, /review, /roles, /agents, /plugins, /btw, /loop
+ */
+import type { CommandHandler } from "./types.js";
+export declare function registerAICommands(register: (name: string, description: string, handler: CommandHandler) => void): void;
+//# sourceMappingURL=ai.d.ts.map

package/dist/commands/ai.js

@@ -0,0 +1,244 @@
+/**
+ * AI commands — /plan, /review, /roles, /agents, /plugins, /btw, /loop
+ */
+import { gitDiff, isGitRepo } from "../git/index.js";
+import { handleCybergotchiCommand } from "./cybergotchi.js";
+export function registerAICommands(register) {
+    register("btw", "Ask a side question (ephemeral, no tools, not saved to history)", (args) => {
+        if (!args.trim()) {
+            return { output: "Usage: /btw <your question>", handled: true };
+        }
+        return {
+            output: `[btw] ${args.trim()}`,
+            handled: false,
+            prependToPrompt: `[Side question — answer briefly without using any tools. This is ephemeral and not part of the main conversation.]\n\n${args.trim()}`,
+        };
+    });
+    register("loop", "Run a prompt repeatedly with self-paced timing", (args) => {
+        const input = args.trim();
+        if (!input) {
+            return {
+                output: "Usage: /loop [interval] <prompt or /command>\n\nExamples:\n  /loop check if the build passed\n  /loop 5m /review\n\nOmit the interval to let the model self-pace via ScheduleWakeup.",
+                handled: true,
+            };
+        }
+        const intervalMatch = input.match(/^(\d+)(s|m|h)\s+(.+)$/);
+        let intervalMs = null;
+        let prompt;
+        if (intervalMatch) {
+            const [, num, unit, rest] = intervalMatch;
+            const multipliers = { s: 1000, m: 60000, h: 3600000 };
+            intervalMs = parseInt(num, 10) * multipliers[unit];
+            prompt = rest;
+        }
+        else {
+            prompt = input;
+        }
+        const mode = intervalMs
+            ? `Fixed interval: ${intervalMatch[1]}${intervalMatch[2]}`
+            : "Dynamic (model self-paces via ScheduleWakeup)";
+        return {
+            output: `[loop] ${mode}\nPrompt: ${prompt}`,
+            handled: false,
+            prependToPrompt: intervalMs
+                ? `You are in LOOP MODE (fixed interval: ${intervalMs / 1000}s). Execute this task, then use ScheduleWakeup with delaySeconds=${intervalMs / 1000} to schedule the next iteration.\n\nTask: ${prompt}`
+                : `You are in LOOP MODE (dynamic pacing). Execute this task, then use ScheduleWakeup to schedule the next iteration at an appropriate interval. Choose your delay based on what you're waiting for. Omit the ScheduleWakeup call to end the loop.\n\nTask: ${prompt}`,
+        };
+    });
+    register("plan", "Enter plan mode", (_args) => {
+        const task = _args.trim();
+        if (!task) {
+            return { output: "Usage: /plan <what you want to build>", handled: true };
+        }
+        return {
+            output: `[plan mode] ${task}`,
+            handled: false,
+            prependToPrompt: `You are in PLAN MODE. Do NOT write any code yet.\n\n1. Call EnterPlanMode to create a plan file in .oh/plans/\n2. Write your detailed implementation plan to that file (files to create/modify, key functions/types, data flow, edge cases)\n3. When the plan is complete, call ExitPlanMode to signal readiness for review\n\nTask: ${task}`,
+        };
+    });
+    register("review", "Review recent code changes", () => {
+        if (!isGitRepo()) {
+            return { output: "Not a git repository.", handled: true };
+        }
+        const diff = gitDiff();
+        if (!diff)
+            return { output: "No changes to review.", handled: true };
+        const lines = diff.split("\n").length;
+        return {
+            output: `[review] ${lines} lines of diff`,
+            handled: false,
+            prependToPrompt: `Review these uncommitted changes and give feedback on correctness, style, and potential issues:\n\n\`\`\`diff\n${diff}\n\`\`\`\n\n`,
+        };
+    });
+    register("roles", "List available agent specialization roles", () => {
+        const { listRoles } = require("../agents/roles.js");
+        const roles = listRoles();
+        const lines = ["Available agent roles:\n"];
+        for (const role of roles) {
+            lines.push(`  ${role.id.padEnd(18)} ${role.name}`);
+            lines.push(`  ${"".padEnd(18)} ${role.description}`);
+            if (role.suggestedTools?.length) {
+                lines.push(`  ${"".padEnd(18)} Tools: ${role.suggestedTools.join(", ")}`);
+            }
+            lines.push("");
+        }
+        lines.push("Usage: Agent({ subagent_type: 'code-reviewer', prompt: '...' })");
+        return { output: lines.join("\n"), handled: true };
+    });
+    register("agents", "Discover running openHarness agents on this machine", () => {
+        const { discoverAgents } = require("../services/a2a.js");
+        const agents = discoverAgents();
+        if (agents.length === 0) {
+            return {
+                output: "No other openHarness agents running on this machine.\n\nOther oh sessions will appear here automatically via the A2A protocol.",
+                handled: true,
+            };
+        }
+        const lines = [`Running Agents (${agents.length}):\n`];
+        for (const agent of agents) {
+            const age = Math.round((Date.now() - agent.registeredAt) / 60_000);
+            lines.push(`  ${agent.name}`);
+            lines.push(`    ID:       ${agent.id}`);
+            lines.push(`    Provider: ${agent.provider ?? "unknown"} / ${agent.model ?? "unknown"}`);
+            lines.push(`    Dir:      ${agent.workingDir ?? "unknown"}`);
+            lines.push(`    Endpoint: ${agent.endpoint.type}${agent.endpoint.port ? `:${agent.endpoint.port}` : ""}`);
+            lines.push(`    Uptime:   ${age}m`);
+            lines.push(`    Caps:     ${agent.capabilities.map((c) => c.name).join(", ")}`);
+            lines.push("");
+        }
+        lines.push("Send messages with: Agent({ prompt: 'ask the other agent...', allowed_tools: ['SendMessage'] })");
+        return { output: lines.join("\n"), handled: true };
+    });
+    register("plugins", "Manage plugins: list, search, install, uninstall, marketplace", (args) => {
+        const { discoverPlugins, discoverSkills } = require("../harness/plugins.js");
+        const { searchMarketplace, installPlugin, uninstallPlugin, getInstalledPlugins, listMarketplaces, addMarketplace, removeMarketplace, formatMarketplaceSearch, formatInstalledPlugins, } = require("../harness/marketplace.js");
+        const parts = args.trim().split(/\s+/);
+        const subcommand = parts[0] ?? "";
+        const rest = parts.slice(1).join(" ");
+        if (subcommand === "marketplace") {
+            const action = parts[1];
+            const source = parts.slice(2).join(" ");
+            if (action === "add" && source) {
+                const mp = addMarketplace(source);
+                if (mp)
+                    return { output: `Added marketplace "${mp.name}" (${mp.plugins.length} plugins)`, handled: true };
+                return { output: `Failed to add marketplace from "${source}"`, handled: true };
+            }
+            if (action === "remove" && source) {
+                return {
+                    output: removeMarketplace(source) ? `Removed marketplace "${source}"` : `Marketplace "${source}" not found`,
+                    handled: true,
+                };
+            }
+            const mps = listMarketplaces();
+            if (mps.length === 0) {
+                return {
+                    output: "No marketplaces configured.\n\nAdd one:\n  /plugins marketplace add owner/repo\n  /plugins marketplace add https://example.com/plugins",
+                    handled: true,
+                };
+            }
+            const lines = [`Marketplaces (${mps.length}):\n`];
+            for (const mp of mps) {
+                lines.push(`  ${mp.name} — ${mp.plugins.length} plugins`);
+            }
+            return { output: lines.join("\n"), handled: true };
+        }
+        if (subcommand === "search") {
+            const query = rest || "all";
+            const results = searchMarketplace(query === "all" ? "" : query);
+            return { output: formatMarketplaceSearch(results), handled: true };
+        }
+        if (subcommand === "install" && rest) {
+            const [name, marketplace] = rest.split("@");
+            const result = installPlugin(name, marketplace);
+            if (result) {
+                return {
+                    output: `Installed ${result.name}@${result.version} from ${result.marketplace}\nCached at: ${result.cachePath}`,
+                    handled: true,
+                };
+            }
+            return {
+                output: `Failed to install "${rest}". Is it listed in a marketplace?\nRun /plugins search ${name} to check.`,
+                handled: true,
+            };
+        }
+        if (subcommand === "uninstall" && rest) {
+            return { output: uninstallPlugin(rest) ? `Uninstalled "${rest}"` : `Plugin "${rest}" not found`, handled: true };
+        }
+        const plugins = discoverPlugins();
+        const skills = discoverSkills();
+        const marketplacePlugins = getInstalledPlugins();
+        const lines = [];
+        if (marketplacePlugins.length > 0) {
+            lines.push(formatInstalledPlugins(marketplacePlugins));
+            lines.push("");
+        }
+        if (plugins.length > 0) {
+            lines.push(`Local Plugins (${plugins.length}):`);
+            for (const p of plugins) {
+                lines.push(`  ${p.name}@${p.version} — ${p.description || "no description"}`);
+            }
+            lines.push("");
+        }
+        if (skills.length > 0) {
+            lines.push(`Skills (${skills.length}):`);
+            for (const s of skills) {
+                lines.push(`  ${s.source}:${s.name} — ${s.description || ""}`);
+            }
+            lines.push("");
+        }
+        if (lines.length === 0) {
+            lines.push("No plugins or skills installed.");
+        }
+        lines.push("");
+        lines.push("Commands:");
+        lines.push("  /plugins search <query>          Search marketplaces");
+        lines.push("  /plugins install <name>          Install from marketplace");
+        lines.push("  /plugins uninstall <name>        Remove a plugin");
+        lines.push("  /plugins marketplace add <src>   Add a marketplace");
+        lines.push("  /plugins marketplace             List marketplaces");
+        return { output: lines.join("\n"), handled: true };
+    });
+    register("cybergotchi", "Manage your cybergotchi — feed · pet · rest · status · rename · reset", (args) => {
+        return handleCybergotchiCommand(args);
+    });
+    register("summarize", "Summarize the current conversation", (_args, ctx) => {
+        if (ctx.messages.length === 0) {
+            return { output: "No messages to summarize.", handled: true };
+        }
+        return {
+            output: `[summarize] ${ctx.messages.length} messages`,
+            handled: false,
+            prependToPrompt: `Summarize this conversation concisely. Highlight the main topics discussed, decisions made, and any pending action items. Be brief but thorough.`,
+        };
+    });
+    register("explain", "Explain a file or concept", (args) => {
+        const topic = args.trim();
+        if (!topic) {
+            return {
+                output: "Usage: /explain <file-path or concept>\n\nExamples:\n  /explain src/index.ts\n  /explain dependency injection\n  /explain the authentication flow",
+                handled: true,
+            };
+        }
+        return {
+            output: `[explain] ${topic}`,
+            handled: false,
+            prependToPrompt: `Explain the following clearly and concisely. If it's a file path, read and explain its purpose, structure, and key functions. If it's a concept, explain it in the context of this project.\n\nTopic: ${topic}`,
+        };
+    });
+    register("fix", "Fix a specific issue", (args) => {
+        const issue = args.trim();
+        if (!issue) {
+            return {
+                output: "Usage: /fix <issue description>\n\nExamples:\n  /fix the failing test in auth.test.ts\n  /fix TypeScript errors in src/utils.ts\n  /fix the broken import on line 42",
+                handled: true,
+            };
+        }
+        return {
+            output: `[fix] ${issue}`,
+            handled: false,
+            prependToPrompt: `Fix the following issue. Diagnose the root cause, implement the fix, and verify it works. Be precise and minimal in your changes.\n\nIssue: ${issue}`,
+        };
+    });
+}
+//# sourceMappingURL=ai.js.map

package/dist/commands/git.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Git commands — /diff, /undo, /rewind, /commit, /log
+ */
+import type { CommandHandler } from "./types.js";
+export declare function registerGitCommands(register: (name: string, description: string, handler: CommandHandler) => void): void;
+//# sourceMappingURL=git.d.ts.map

package/dist/commands/git.js

@@ -0,0 +1,167 @@
+/**
+ * Git commands — /diff, /undo, /rewind, /commit, /log
+ */
+import { execSync } from "node:child_process";
+import { gitBranch, gitCommit, gitDiff, gitLog, gitUndo, isGitRepo } from "../git/index.js";
+export function registerGitCommands(register) {
+    register("diff", "Show uncommitted git changes", () => {
+        if (!isGitRepo()) {
+            return { output: "Not a git repository.", handled: true };
+        }
+        const diff = gitDiff();
+        return { output: diff || "No uncommitted changes.", handled: true };
+    });
+    register("undo", "Undo last AI commit", () => {
+        if (!isGitRepo()) {
+            return { output: "Not a git repository.", handled: true };
+        }
+        const success = gitUndo();
+        return {
+            output: success ? "Undone. Last AI commit reverted." : "Nothing to undo (last commit wasn't from OpenHarness).",
+            handled: true,
+        };
+    });
+    register("rewind", "Restore files from checkpoint (interactive picker or last)", (args) => {
+        const { rewindLastCheckpoint, listCheckpoints, checkpointCount } = require("../harness/checkpoints.js");
+        const checkpoints = listCheckpoints();
+        if (checkpoints.length === 0) {
+            return { output: "No checkpoints available. Checkpoints are created before file modifications.", handled: true };
+        }
+        const idx = args.trim();
+        if (!idx) {
+            const lines = [`Checkpoints (${checkpoints.length}):\n`];
+            for (let i = checkpoints.length - 1; i >= 0; i--) {
+                const cp = checkpoints[i];
+                const age = Math.round((Date.now() - cp.timestamp) / 60_000);
+                lines.push(`  ${i + 1}. [${age}m ago] ${cp.description}`);
+                lines.push(`     Files: ${cp.files.join(", ")}`);
+            }
+            lines.push("");
+            lines.push("Usage: /rewind <number> to restore a specific checkpoint");
+            lines.push("       /rewind last    to restore the most recent");
+            return { output: lines.join("\n"), handled: true };
+        }
+        if (idx === "last") {
+            const cp = rewindLastCheckpoint();
+            if (!cp)
+                return { output: "No checkpoints.", handled: true };
+            return {
+                output: `Rewound: ${cp.description}\nRestored ${cp.files.length} file(s): ${cp.files.join(", ")}\n${checkpointCount()} checkpoint(s) remaining.`,
+                handled: true,
+            };
+        }
+        const num = parseInt(idx, 10);
+        if (Number.isNaN(num) || num < 1 || num > checkpoints.length) {
+            return { output: `Invalid checkpoint number. Use 1-${checkpoints.length}.`, handled: true };
+        }
+        let restored = 0;
+        while (checkpointCount() >= num) {
+            const cp = rewindLastCheckpoint();
+            if (!cp)
+                break;
+            restored++;
+            if (checkpointCount() < num)
+                break;
+        }
+        return {
+            output: `Rewound ${restored} checkpoint(s) to point #${num}.\n${checkpointCount()} checkpoint(s) remaining.`,
+            handled: true,
+        };
+    });
+    register("commit", "Create a git commit", (args) => {
+        if (!isGitRepo()) {
+            return { output: "Not a git repository.", handled: true };
+        }
+        const message = args.trim() || "manual commit";
+        const success = gitCommit(message);
+        return { output: success ? `Committed: ${message}` : "Nothing to commit.", handled: true };
+    });
+    register("log", "Show recent git commits", () => {
+        if (!isGitRepo()) {
+            return { output: "Not a git repository.", handled: true };
+        }
+        return { output: gitLog(10) || "No commits yet.", handled: true };
+    });
+    register("review-pr", "Review a pull request", (args) => {
+        const pr = args.trim();
+        if (!pr) {
+            return { output: "Usage: /review-pr <number or URL>", handled: true };
+        }
+        return {
+            output: `[review-pr] ${pr}`,
+            handled: false,
+            prependToPrompt: `Review pull request ${pr}. Use the Bash tool to run 'gh pr view ${pr} --json title,body,additions,deletions,files' and 'gh pr diff ${pr}' to fetch the PR details and diff. Then provide a thorough code review covering correctness, style, and potential issues.`,
+        };
+    });
+    register("pr-comments", "View comments on a pull request", (args) => {
+        const pr = args.trim();
+        if (!pr) {
+            return { output: "Usage: /pr-comments <number or URL>", handled: true };
+        }
+        return {
+            output: `[pr-comments] ${pr}`,
+            handled: false,
+            prependToPrompt: `Fetch and summarize the comments on pull request ${pr}. Use the Bash tool to run 'gh pr view ${pr} --json comments,reviews' to get all comments and review feedback. Present a clear summary of the discussion.`,
+        };
+    });
+    register("release-notes", "Generate release notes from recent commits", (args) => {
+        if (!isGitRepo()) {
+            return { output: "Not a git repository.", handled: true };
+        }
+        const range = args.trim() || "HEAD~10..HEAD";
+        let log;
+        try {
+            log = execSync(`git log --oneline ${range}`, { encoding: "utf-8" }).trim();
+        }
+        catch {
+            log = gitLog(10) || "";
+        }
+        if (!log)
+            return { output: "No commits found for release notes.", handled: true };
+        return {
+            output: `[release-notes] ${range}`,
+            handled: false,
+            prependToPrompt: `Generate release notes from these commits. Group by category (features, fixes, chores). Use markdown formatting.\n\nCommits:\n${log}`,
+        };
+    });
+    register("stash", "Show git stash list", () => {
+        if (!isGitRepo()) {
+            return { output: "Not a git repository.", handled: true };
+        }
+        let stashList;
+        try {
+            stashList = execSync("git stash list", { encoding: "utf-8" }).trim();
+        }
+        catch {
+            return { output: "Could not retrieve stash list.", handled: true };
+        }
+        if (!stashList)
+            return { output: "No stashes found.", handled: true };
+        return { output: `Git stashes:\n${stashList}`, handled: true };
+    });
+    register("branch", "Show or switch git branch", (args) => {
+        if (!isGitRepo()) {
+            return { output: "Not a git repository.", handled: true };
+        }
+        const target = args.trim();
+        if (!target) {
+            const current = gitBranch();
+            let branches;
+            try {
+                branches = execSync("git branch --list", { encoding: "utf-8" }).trim();
+            }
+            catch {
+                branches = current;
+            }
+            return { output: `Current branch: ${current}\n\n${branches}`, handled: true };
+        }
+        try {
+            execSync(`git checkout ${target}`, { encoding: "utf-8" });
+            return { output: `Switched to branch: ${target}`, handled: true };
+        }
+        catch {
+            return { output: `Failed to switch to branch: ${target}. Does it exist?`, handled: true };
+        }
+    });
+}
+//# sourceMappingURL=git.js.map

package/dist/commands/index.d.ts

@@ -3,38 +3,17 @@
  *
  * Commands are processed in the REPL before being sent to the LLM.
  * If input starts with /, it's treated as a command.
+ *
+ * Command implementations are split into domain-specific modules:
+ *   session.ts  — /clear, /compact, /export, /history, /browse, /resume, /fork, /pin, /unpin
+ *   git.ts      — /diff, /undo, /rewind, /commit, /log
+ *   info.ts     — /help, /cost, /status, /config, /files, /model, /memory, /doctor, /context, /mcp, /init
+ *   settings.ts — /theme, /companion, /fast, /keys, /effort, /sandbox, /permissions, /allowed-tools
+ *   ai.ts       — /plan, /review, /roles, /agents, /plugins, /btw, /loop, /cybergotchi
+ *   skills.ts   — /skill-create, /skill-delete, /skill-edit, /skill-search, /skill-install
  */
-import type { Message } from "../types/message.js";
-export type CommandResult = {
-    /** Text output to display */
-    output: string;
-    /** If true, don't send to LLM */
-    handled: boolean;
-    /** If set, clear messages */
-    clearMessages?: boolean;
-    /** If set, update model */
-    newModel?: string;
-    /** If set, replace messages with compacted version */
-    compactedMessages?: Message[];
-    /** If true, open the cybergotchi setup UI */
-    openCybergotchiSetup?: boolean;
-    /** If set, resume this session ID */
-    resumeSessionId?: string;
-    /** If set, prepend this text to the user's prompt before sending to LLM */
-    prependToPrompt?: string;
-    /** If set, toggle fast mode */
-    toggleFastMode?: boolean;
-};
-export type CommandContext = {
-    messages: Message[];
-    model: string;
-    providerName: string;
-    permissionMode: string;
-    totalCost: number;
-    totalInputTokens: number;
-    totalOutputTokens: number;
-    sessionId: string;
-};
+export type { CommandContext, CommandHandler, CommandResult } from "./types.js";
+import type { CommandContext, CommandResult } from "./types.js";
 /**
  * Check if input is a slash command. If so, execute it.
  */