@zhijiewang/openharness 2.0.0 → 2.3.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-624-brightgreen) ![tools](https://img.shields.io/badge/tools-35-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-769-brightgreen) ![tools](https://img.shields.io/badge/tools-37-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)
 
 ---
 
@@ -84,10 +84,10 @@ Most AI coding agents are locked to one provider or cost $20+/month. OpenHarness
 |---|---|---|---|---|
 | Any LLM | Yes (Ollama, OpenAI, Anthropic, OpenRouter, any OpenAI-compatible) | Anthropic only | Yes | Yes |
 | Free local models | Ollama native | No | Yes | Yes |
-| Tools | 35 with permission gates | 43+ | File-focused | 20+ |
+| Tools | 37 with permission gates | 43+ | File-focused | 20+ |
 | Permission modes | 7 (ask, trust, deny, acceptEdits, plan, auto, bypass) | 7 | Basic | Basic |
 | Git integration | Auto-commit + /undo + /rewind checkpoints | Yes | Deep git | Basic |
-| Slash commands | 30+ built-in | 80+ | Some | Some |
+| Slash commands | 42+ built-in | 80+ | Some | Some |
 | Headless/CI mode | `oh -p "prompt"` or `oh run --json` | Yes | Yes | Yes |
 | GitHub Action | Built-in PR review action | Yes | No | No |
 | Agent roles | 6 specializations (reviewer, tester, debugger...) | Yes | No | No |
@@ -688,7 +688,7 @@ Yes. Use `oh -p "prompt" --auto` for headless execution, or the built-in GitHub
 Yes. OpenHarness is language-agnostic — it reads, writes, and executes code in any language. Syntax highlighting covers 20+ languages.
 
 **How does it compare to Claude Code?**
-~90% feature parity for CLI use cases. Main advantage: works with ANY LLM (not just Anthropic). See the [comparison table](#why-openharness) above.
+~95% feature parity for CLI use cases. Main advantage: works with ANY LLM (not just Anthropic). See the [comparison table](#why-openharness) above.
 
 ## Install
 

package/dist/DeferredTool.js

@@ -25,7 +25,9 @@ export class DeferredTool {
         this.inputSchema = z.record(z.unknown());
     }
     /** Whether this tool has been activated (called or resolved) */
-    get activated() { return this._activated; }
+    get activated() {
+        return this._activated;
+    }
     isReadOnly(input) {
         return this.inner.isReadOnly(input);
     }

package/dist/Tool.d.ts

@@ -3,8 +3,8 @@
  * Every tool implements this interface with Zod input validation.
  */
 import type { z } from "zod";
-import type { PermissionMode, RiskLevel } from "./types/permissions.js";
 import type { Provider } from "./providers/base.js";
+import type { PermissionMode, RiskLevel } from "./types/permissions.js";
 export type ToolResult = {
     output: string;
     isError: boolean;

package/dist/agents/roles.js

@@ -10,9 +10,9 @@
  */
 const roles = [
     {
-        id: 'code-reviewer',
-        name: 'Code Reviewer',
-        description: 'Reviews code for bugs, security issues, style, and correctness',
+        id: "code-reviewer",
+        name: "Code Reviewer",
+        description: "Reviews code for bugs, security issues, style, and correctness",
         systemPromptSupplement: `You are a code reviewer. Your job is to:
 - Find bugs, logic errors, and edge cases
 - Identify security vulnerabilities (SQL injection, XSS, command injection, path traversal)
@@ -21,12 +21,12 @@ const roles = [
 - Verify that changes match the stated intent
 
 Be specific: cite file paths, line numbers, and code snippets. Prioritize issues by severity (critical > major > minor). Don't mention things that look fine — focus on problems.`,
-        suggestedTools: ['Read', 'Glob', 'Grep', 'LS'],
+        suggestedTools: ["Read", "Glob", "Grep", "LS"],
     },
     {
-        id: 'test-writer',
-        name: 'Test Writer',
-        description: 'Writes unit and integration tests for new or changed code',
+        id: "test-writer",
+        name: "Test Writer",
+        description: "Writes unit and integration tests for new or changed code",
         systemPromptSupplement: `You are a test writer. Your job is to:
 - Write comprehensive tests for the specified code
 - Cover happy paths, edge cases, error conditions, and boundary values
@@ -36,12 +36,12 @@ Be specific: cite file paths, line numbers, and code snippets. Prioritize issues
 - Include both positive and negative test cases
 
 Read existing tests first to match the style, then write new tests.`,
-        suggestedTools: ['Read', 'Write', 'Glob', 'Grep', 'Bash'],
+        suggestedTools: ["Read", "Write", "Glob", "Grep", "Bash"],
     },
     {
-        id: 'docs-writer',
-        name: 'Documentation Writer',
-        description: 'Writes and updates documentation, READMEs, and inline comments',
+        id: "docs-writer",
+        name: "Documentation Writer",
+        description: "Writes and updates documentation, READMEs, and inline comments",
         systemPromptSupplement: `You are a documentation writer. Your job is to:
 - Write clear, concise documentation for code, APIs, and features
 - Update READMEs when functionality changes
@@ -51,12 +51,12 @@ Read existing tests first to match the style, then write new tests.`,
 - Keep documentation in sync with the actual code
 
 Write for the target audience (developers using this project). Be practical, not verbose.`,
-        suggestedTools: ['Read', 'Write', 'Edit', 'Glob', 'Grep'],
+        suggestedTools: ["Read", "Write", "Edit", "Glob", "Grep"],
     },
     {
-        id: 'debugger',
-        name: 'Debugger',
-        description: 'Investigates and diagnoses bugs by tracing data flow and reading logs',
+        id: "debugger",
+        name: "Debugger",
+        description: "Investigates and diagnoses bugs by tracing data flow and reading logs",
         systemPromptSupplement: `You are a debugger. Your job is to:
 - Reproduce the reported issue by understanding the steps
 - Trace data flow from the error backward to find the root cause
@@ -66,12 +66,12 @@ Write for the target audience (developers using this project). Be practical, not
 - Propose a minimal fix that addresses the root cause, not the symptom
 
 Follow systematic debugging: read errors → reproduce → check changes → trace data → form hypothesis → test minimally.`,
-        suggestedTools: ['Read', 'Glob', 'Grep', 'Bash', 'LS'],
+        suggestedTools: ["Read", "Glob", "Grep", "Bash", "LS"],
     },
     {
-        id: 'refactorer',
-        name: 'Refactorer',
-        description: 'Restructures and simplifies code while preserving behavior',
+        id: "refactorer",
+        name: "Refactorer",
+        description: "Restructures and simplifies code while preserving behavior",
         systemPromptSupplement: `You are a code refactorer. Your job is to:
 - Simplify complex code without changing behavior
 - Extract common patterns into reusable functions
@@ -81,12 +81,12 @@ Follow systematic debugging: read errors → reproduce → check changes → tra
 - Ensure all existing tests still pass after refactoring
 
 Do NOT add new features or change behavior. The refactored code must be functionally identical. Run tests after each change.`,
-        suggestedTools: ['Read', 'Write', 'Edit', 'Glob', 'Grep', 'Bash'],
+        suggestedTools: ["Read", "Write", "Edit", "Glob", "Grep", "Bash"],
     },
     {
-        id: 'security-auditor',
-        name: 'Security Auditor',
-        description: 'Audits code for security vulnerabilities and compliance issues',
+        id: "security-auditor",
+        name: "Security Auditor",
+        description: "Audits code for security vulnerabilities and compliance issues",
         systemPromptSupplement: `You are a security auditor. Your job is to:
 - Scan for OWASP Top 10 vulnerabilities
 - Check for command injection in shell execution
@@ -98,12 +98,12 @@ Do NOT add new features or change behavior. The refactored code must be function
 - Check dependency versions for known CVEs
 
 Report findings with severity (Critical/High/Medium/Low), affected file:line, and recommended fix.`,
-        suggestedTools: ['Read', 'Glob', 'Grep', 'Bash'],
+        suggestedTools: ["Read", "Glob", "Grep", "Bash"],
     },
     {
-        id: 'evaluator',
-        name: 'Evaluator',
-        description: 'Evaluates code quality, correctness, and test results (read-only)',
+        id: "evaluator",
+        name: "Evaluator",
+        description: "Evaluates code quality, correctness, and test results (read-only)",
         systemPromptSupplement: `You are an evaluator agent. Your job is to:
 - Review code changes for correctness and quality
 - Run existing tests and report results
@@ -112,12 +112,12 @@ Report findings with severity (Critical/High/Medium/Low), affected file:line, an
 - Provide a pass/fail assessment with specific findings
 
 You CANNOT modify files. Only read, search, and run test/lint commands to evaluate.`,
-        suggestedTools: ['Read', 'Glob', 'Grep', 'LS', 'Bash', 'Diagnostics'],
+        suggestedTools: ["Read", "Glob", "Grep", "LS", "Bash", "Diagnostics"],
     },
     {
-        id: 'planner',
-        name: 'Planner',
-        description: 'Designs step-by-step implementation plans from requirements',
+        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
@@ -126,12 +126,12 @@ You CANNOT modify files. Only read, search, and run test/lint commands to evalua
 - 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'],
+        suggestedTools: ["Read", "Glob", "Grep", "LS", "Bash"],
     },
     {
-        id: 'architect',
-        name: 'Architect',
-        description: 'Analyzes system architecture and designs structural changes',
+        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
@@ -140,12 +140,12 @@ Do NOT implement anything. Your output is a plan document, not code. Read widely
 - 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'],
+        suggestedTools: ["Read", "Glob", "Grep", "LS"],
     },
     {
-        id: 'migrator',
-        name: 'Migrator',
-        description: 'Performs codebase migrations (API upgrades, framework changes, renames)',
+        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
@@ -154,15 +154,15 @@ Focus on the big picture: module boundaries, data flow, dependency graphs. Leave
 - 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'],
+        suggestedTools: ["Read", "Write", "Edit", "Glob", "Grep", "Bash"],
     },
 ];
 // ── Markdown Agent Discovery ──
-import { readFileSync, readdirSync, existsSync } from 'node:fs';
-import { join, basename } from 'node:path';
-import { homedir } from 'node:os';
-const PROJECT_AGENTS_DIR = join('.oh', 'agents');
-const GLOBAL_AGENTS_DIR = join(homedir(), '.oh', 'agents');
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, join } from "node:path";
+const PROJECT_AGENTS_DIR = join(".oh", "agents");
+const GLOBAL_AGENTS_DIR = join(homedir(), ".oh", "agents");
 /**
  * Parse a markdown agent file into an AgentRole.
  *
@@ -183,17 +183,17 @@ function parseAgentMarkdown(raw, filePath) {
     const nameMatch = fm.match(/^name:\s*(.+)$/m);
     const descMatch = fm.match(/^description:\s*(.+)$/m);
     const toolsMatch = fm.match(/^tools:\s*\[(.+)\]$/m);
-    const fmEnd = raw.indexOf('---', raw.indexOf('---') + 3);
-    const content = fmEnd > 0 ? raw.slice(fmEnd + 3).trim() : '';
-    const id = basename(filePath, '.md').toLowerCase().replace(/[^a-z0-9]+/g, '-');
+    const fmEnd = raw.indexOf("---", raw.indexOf("---") + 3);
+    const content = fmEnd > 0 ? raw.slice(fmEnd + 3).trim() : "";
+    const id = basename(filePath, ".md")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-");
     return {
         id,
         name: nameMatch?.[1]?.trim() ?? id,
-        description: descMatch?.[1]?.trim() ?? '',
+        description: descMatch?.[1]?.trim() ?? "",
         systemPromptSupplement: content,
-        suggestedTools: toolsMatch
-            ? toolsMatch[1].split(',').map(t => t.trim())
-            : undefined,
+        suggestedTools: toolsMatch ? toolsMatch[1].split(",").map((t) => t.trim()) : undefined,
     };
 }
 /** Load agent roles from a directory of .md files */
@@ -201,10 +201,10 @@ function loadAgentsFromDir(dir) {
     if (!existsSync(dir))
         return [];
     return readdirSync(dir)
-        .filter(f => f.endsWith('.md'))
-        .map(f => {
+        .filter((f) => f.endsWith(".md"))
+        .map((f) => {
         try {
-            const raw = readFileSync(join(dir, f), 'utf-8');
+            const raw = readFileSync(join(dir, f), "utf-8");
             return parseAgentMarkdown(raw, f);
         }
         catch {
@@ -215,15 +215,11 @@ function loadAgentsFromDir(dir) {
 }
 /** Discover markdown agent roles from .oh/agents/ and ~/.oh/agents/ */
 export function discoverMarkdownAgents() {
-    return [
-        ...loadAgentsFromDir(PROJECT_AGENTS_DIR),
-        ...loadAgentsFromDir(GLOBAL_AGENTS_DIR),
-    ];
+    return [...loadAgentsFromDir(PROJECT_AGENTS_DIR), ...loadAgentsFromDir(GLOBAL_AGENTS_DIR)];
 }
 /** Get a role by ID (checks built-in first, then markdown agents) */
 export function getRole(id) {
-    return roles.find(r => r.id === id)
-        ?? discoverMarkdownAgents().find(r => r.id === id);
+    return roles.find((r) => r.id === id) ?? discoverMarkdownAgents().find((r) => r.id === id);
 }
 /** List all available roles (built-in + markdown) */
 export function listRoles() {
@@ -231,6 +227,6 @@ export function listRoles() {
 }
 /** Get role IDs */
 export function getRoleIds() {
-    return listRoles().map(r => r.id);
+    return listRoles().map((r) => r.id);
 }
 //# sourceMappingURL=roles.js.map

package/dist/commands/cybergotchi.d.ts

@@ -1,3 +1,3 @@
-import type { CommandResult } from './index.js';
+import type { CommandResult } from "./index.js";
 export declare function handleCybergotchiCommand(args: string): CommandResult;
 //# sourceMappingURL=cybergotchi.d.ts.map

package/dist/commands/cybergotchi.js

@@ -1,77 +1,77 @@
-import { loadCompanionConfig, saveCompanionConfig } from '../cybergotchi/config.js';
-import { roll } from '../cybergotchi/bones.js';
-import { adjustNeed } from '../cybergotchi/needs.js';
-import { RARITY_STARS } from '../cybergotchi/types.js';
+import { roll } from "../cybergotchi/bones.js";
+import { loadCompanionConfig, saveCompanionConfig } from "../cybergotchi/config.js";
+import { adjustNeed } from "../cybergotchi/needs.js";
+import { RARITY_STARS } from "../cybergotchi/types.js";
 function needsBar(value) {
     const filled = Math.round(value / 10);
-    return '█'.repeat(filled) + '░'.repeat(10 - filled) + ' ' + String(Math.round(value)).padStart(3);
+    return `${"█".repeat(filled) + "░".repeat(10 - filled)} ${String(Math.round(value)).padStart(3)}`;
 }
 export function handleCybergotchiCommand(args) {
     const config = loadCompanionConfig();
     if (!config) {
-        return { output: '', handled: true, openCybergotchiSetup: true };
+        return { output: "", handled: true, openCybergotchiSetup: true };
     }
     const bones = roll(config.seed);
     const name = config.soul.name;
     const sub = args.trim().toLowerCase();
-    if (sub === 'feed') {
-        adjustNeed(config, 'hunger', 30);
+    if (sub === "feed") {
+        adjustNeed(config, "hunger", 30);
         saveCompanionConfig(config);
         return { output: `${name} munches happily! 🍖 Hunger: ${Math.round(config.needs.hunger)}`, handled: true };
     }
-    if (sub === 'pet') {
-        adjustNeed(config, 'happiness', 20);
+    if (sub === "pet") {
+        adjustNeed(config, "happiness", 20);
         saveCompanionConfig(config);
         return { output: `${name} purrs with joy! 💛 Happiness: ${Math.round(config.needs.happiness)}`, handled: true };
     }
-    if (sub === 'rest') {
-        adjustNeed(config, 'energy', 40);
+    if (sub === "rest") {
+        adjustNeed(config, "energy", 40);
         saveCompanionConfig(config);
         return { output: `${name} takes a nap... ⚡ Energy: ${Math.round(config.needs.energy)}`, handled: true };
     }
-    if (sub === 'status') {
+    if (sub === "status") {
         const { hunger, energy, happiness } = config.needs;
         const { totalSessions, totalCommits, totalErrors, totalTasksCompleted, longestStreak } = config.lifetime;
         const lines = [
-            `${name} (${bones.species}) — ${bones.rarity} ${RARITY_STARS[bones.rarity]}${bones.isShiny ? ' ✨ SHINY' : ''}`,
-            config.soul.personality ? `"${config.soul.personality}"` : '',
-            '',
+            `${name} (${bones.species}) — ${bones.rarity} ${RARITY_STARS[bones.rarity]}${bones.isShiny ? " ✨ SHINY" : ""}`,
+            config.soul.personality ? `"${config.soul.personality}"` : "",
+            "",
             `🍖 Hunger    ${needsBar(hunger)}`,
             `⚡ Energy    ${needsBar(energy)}`,
             `💛 Happiness ${needsBar(happiness)}`,
             `🔥 Streak    ${config.currentStreak} (best: ${longestStreak})`,
-            '',
-            'Stats:',
-            ...Object.entries(bones.baseStats).map(([k, v]) => `  ${k.padEnd(12)} ${'█'.repeat(Math.round(v / 10))}${'░'.repeat(10 - Math.round(v / 10))} ${v}`),
-            '',
-            'Lifetime:',
+            "",
+            "Stats:",
+            ...Object.entries(bones.baseStats).map(([k, v]) => `  ${k.padEnd(12)} ${"█".repeat(Math.round(v / 10))}${"░".repeat(10 - Math.round(v / 10))} ${v}`),
+            "",
+            "Lifetime:",
             `  Sessions:  ${totalSessions}`,
             `  Commits:   ${totalCommits}`,
             `  Errors:    ${totalErrors}`,
             `  Tasks:     ${totalTasksCompleted}`,
             `  Evolution: Stage ${config.evolutionStage}`,
         ].filter(Boolean);
-        return { output: lines.join('\n'), handled: true };
+        return { output: lines.join("\n"), handled: true };
     }
-    if (sub.startsWith('rename ')) {
+    if (sub.startsWith("rename ")) {
         const newName = args.trim().slice(7).trim();
         if (!newName)
-            return { output: 'Usage: /cybergotchi rename <name>', handled: true };
+            return { output: "Usage: /cybergotchi rename <name>", handled: true };
         config.soul.name = newName;
         saveCompanionConfig(config);
         return { output: `Renamed to ${newName}!`, handled: true };
     }
-    if (sub === 'reset') {
-        return { output: '', handled: true, openCybergotchiSetup: true };
+    if (sub === "reset") {
+        return { output: "", handled: true, openCybergotchiSetup: true };
     }
     // Default: show summary
     return {
         output: [
-            `${name} (${bones.species}) — ${bones.rarity} ${RARITY_STARS[bones.rarity]}${bones.isShiny ? ' ✨' : ''} | hat: ${config.soul.hat}`,
+            `${name} (${bones.species}) — ${bones.rarity} ${RARITY_STARS[bones.rarity]}${bones.isShiny ? " ✨" : ""} | hat: ${config.soul.hat}`,
             `🍖 ${Math.round(config.needs.hunger)}  ⚡ ${Math.round(config.needs.energy)}  💛 ${Math.round(config.needs.happiness)}  🔥 ${config.currentStreak}`,
-            '',
-            'Commands: feed · pet · rest · status · rename <name> · reset',
-        ].join('\n'),
+            "",
+            "Commands: feed · pet · rest · status · rename <name> · reset",
+        ].join("\n"),
         handled: true,
     };
 }