openhermes 1.12.1 → 1.13.1

package/README.md

@@ -12,7 +12,7 @@
 
 ---
 
-**Your OpenCode agent, leveled up.** Add it to your plugins and your agent gains a personality, a memory, a conscience, 25 specialist subagents, 27 slash commands, 6 native memory tools, 10 procedural skills, autonomous checkpointing, and the discipline to self-improve.
+**Your OpenCode agent, leveled up.** Add it to your plugins and your agent gains a personality, a memory, a conscience, 25 specialist subagents, 28 slash commands, 6 native memory tools, 10 procedural skills, autonomous checkpointing, and the discipline to self-improve.
 
 ```bash
 npm i openhermes
@@ -73,7 +73,7 @@ Either way, **no other config needed.** The plugin auto-registers:
 | What | Details |
 |------|---------|
 | **25 subagents** | 7 core + 18 specialist:<br>**Core:** architect, planner, build-error-resolver, code-reviewer, security-reviewer, e2e-runner, explore<br>**Specialist:** tdd-guide, docs-lookup, doc-updater, refactor-cleaner, loop-operator, harness-optimizer, review-go, build-go, review-rust, build-rust, review-python, review-java, build-java, review-kotlin, build-kotlin, review-cpp, build-cpp, review-database |
-| **27 slash commands** | `/plan`, `/build-fix`, `/code-review`, `/security`, `/doctor`, `/memory-search`, `/learn`, `/ohc`, `/orchestrate`, `/eval`, `/model-route`, `/quality-gate`, `/test-coverage`, `/update-docs`, `/update-codemaps`, `/refactor-clean`, `/verify`, `/checkpoint`, `/loop-start`, `/loop-status`, `/harness-audit`, `/setup-pm`, `/go-build`, `/go-review`, `/rust-build`, `/rust-review`, `/skill-create`, `/update-me` |
+| **28 slash commands** | `/build-fix`, `/checkpoint`, `/code-review`, `/doctor`, `/eval`, `/go-build`, `/go-review`, `/harness-audit`, `/learn`, `/loop-start`, `/loop-status`, `/memory-search`, `/model-route`, `/ohc`, `/orchestrate`, `/plan`, `/quality-gate`, `/refactor-clean`, `/rust-build`, `/rust-review`, `/security`, `/setup-pm`, `/skill-create`, `/test-coverage`, `/update-codemaps`, `/update-docs`, `/update-me`, `/verify` |
 | **6 native memory tools** | `add_memory`, `fetch_memory`, `list_memory`, `latest_memory`, `search_memory`, `archive_memory` — in-process, no MCP server needed |
 | **10 procedural skills** | API design, backend patterns, coding standards, E2E testing, frontend patterns, frontend slides, security review, strategic compaction, TDD workflow, verification loop |
 | **6 lifecycle plugins** | bootstrap, curator, autorecall, skill-builder, memory-tools, ohc |
@@ -85,7 +85,7 @@ You only need to define primary agents (like `build` or `OpenHermes`) in `openco
 <details>
 <summary><b>What happens on your next session</b></summary>
 
-1. **Config hook** — BootstrapPlugin registers auto-config: 25 subagents, 27 commands, 10 skill dirs.
+1. **Config hook** — BootstrapPlugin registers auto-config: 25 subagents, 28 commands, 10 skill dirs.
 2. **Chat transform hook** — bootstrap content is injected into the first user message:
    - &#9733; **Constitution** (`soul.md`) — 11 immutable principles
    - &#9733; **Runtime** (`RUNTIME.md`) — gather → delegate → verify → compress
@@ -153,7 +153,7 @@ System prompt is injected with your budget and floor. As context grows, progress
 ### BootstrapPlugin
 _Registers agents, commands, skills at config hook; injects constitution + router + runtime into every session._
 - **Hooks:** `config`, `chat.transform`
-- Registers 25 subagents, 27 commands, 10 skill paths
+- Registers 25 subagents, 28 commands, 10 skill paths
 
 ### MemoryToolsPlugin
 _Provides 6 native memory tools — no MCP server, no network, no sidecars._

package/bootstrap.mjs

@@ -37,6 +37,7 @@ Snapshot before mutation. Never delete unrelated files. Never assume \`%USERPROF
 | **Memory recall cache** | \`openhermes/memory/recall/cache.json\` — read on session start, no MCP round-trip |
 | **Subagents** | \`explore\` (read-only), \`general\` (multi-step), \`architect\`, \`planner\`, \`build-error-resolver\`, \`code-reviewer\`, \`security-reviewer\`, \`e2e-runner\`, \`docs-lookup\`, \`doc-updater\`, \`refactor-cleaner\`, \`loop-operator\`, \`harness-optimizer\`, \`tdd-guide\`, \`review-go\`, \`build-go\`, \`review-database\`, \`review-cpp\`, \`build-cpp\`, \`review-java\`, \`build-java\`, \`review-kotlin\`, \`build-kotlin\`, \`review-python\`, \`review-rust\`, \`build-rust\` |
 | **Plugins** | \`curator\` (checkpoints, mistakes, audit, compaction), \`autorecall\` (recall cache on \`session.created\`), \`skill-builder\` (complex session detection) |
+| **Slash commands** | <!-- COMMANDS:START --> \`/build-fix\`, \`/checkpoint\`, \`/code-review\`, \`/doctor\`, \`/eval\`, \`/go-build\`, \`/go-review\`, \`/harness-audit\`, \`/learn\`, \`/loop-start\`, \`/loop-status\`, \`/memory-search\`, \`/model-route\`, \`/ohc\`, \`/orchestrate\`, \`/plan\`, \`/quality-gate\`, \`/refactor-clean\`, \`/rust-build\`, \`/rust-review\`, \`/security\`, \`/setup-pm\`, \`/skill-create\`, \`/test-coverage\`, \`/update-codemaps\`, \`/update-docs\`, \`/update-me\`, \`/verify\`<!-- COMMANDS:END --> |
 
 ## Skills (available via \`skill\` tool)
 
@@ -169,6 +170,7 @@ export const BootstrapPlugin = async ({ client, directory }) => {
         "memory-search": { agent: "OpenHermes", description: "Search OpenHermes memory with LLM summarization", subtask: true, template: ct("memory-search.md") },
         "learn": { agent: "OpenHermes", description: "Create a new skill from recent work patterns", subtask: true, template: ct("learn.md") },
         "ohc": { template: "", description: "OHC context management: /ohc status, /ohc compress [focus]" },
+        "update-me": { template: "", description: "Force reinstall OpenHermes plugin from latest source" },
         "orchestrate": { agent: "planner", description: "Orchestrate multiple agents for complex tasks", subtask: true, template: ct("orchestrate.md") },
         "eval": { agent: "planner", description: "Evaluate implementation against acceptance criteria", subtask: true, template: ct("eval.md") },
         "model-route": { agent: "OpenHermes", description: "Recommend model tier by task complexity and budget", subtask: true, template: ct("model-route.md") },

package/harness/commands/ohc.md

@@ -0,0 +1,13 @@
+---
+description: OHC context management: /ohc status, /ohc compress [focus]
+agent: OpenHermes
+subtask: true
+---
+
+# Ohc Command
+
+OHC context management — hook-handled.
+
+Run `/ohc status` to check context usage, `/ohc compress [targetTokens] [focus]` to free space.
+
+$ARGUMENTS

package/harness/scripts/sync-commands.mjs

@@ -0,0 +1,259 @@
+#!/usr/bin/env node
+import fs from "node:fs"
+import path from "node:path"
+import { fileURLToPath } from "node:url"
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const REPO_ROOT = path.resolve(__dirname, "..", "..")
+const COMMANDS_DIR = path.join(REPO_ROOT, "harness", "commands")
+const BOOTSTRAP_FILE = path.join(REPO_ROOT, "bootstrap.mjs")
+const README_FILE = path.join(REPO_ROOT, "README.md")
+
+const COMMANDS_START = "<!-- COMMANDS:START -->"
+const COMMANDS_END = "<!-- COMMANDS:END -->"
+
+const HOOK_ONLY = new Set(["update-me"])
+
+function parseRegistry(src) {
+  const commands = {}
+  const blockMatch = src.match(/config\.command\s*=\s*\{([\s\S]*?)\n\s*\}/)
+  if (!blockMatch) return commands
+
+  let rest = blockMatch[1]
+  const entryRe = /^\s*"([^"]+)"\s*:\s*\{([\s\S]*?)\},?\s*$/gm
+  let m
+  while ((m = entryRe.exec(rest)) !== null) {
+    const name = m[1]
+    const body = m[2]
+    const agent = body.match(/agent:\s*"([^"]+)"/)?.[1] ?? ""
+    const description = body.match(/description:\s*"([^"]+)"/)?.[1] ?? ""
+    const template = body.match(/template:\s*ct\("([^"]+)"\)/) ? m[0].match(/template:\s*(ct\("[^"]+"\)|""|'')/)?.[1] : ""
+    const hasFile = template.includes("ct(")
+    commands[name] = { name, agent, description, hasFile }
+  }
+  return commands
+}
+
+function parseCommandFile(filePath) {
+  const src = fs.readFileSync(filePath, "utf8")
+  const name = path.basename(filePath, ".md")
+  const description = src.match(/^description:\s*(.+)$/m)?.[1] ?? ""
+  const agent = src.match(/^agent:\s*(.+)$/m)?.[1] ?? ""
+  return { name, description, agent }
+}
+
+function scanCommandFiles() {
+  const files = fs.readdirSync(COMMANDS_DIR).filter(f => f.endsWith(".md"))
+  const map = {}
+  for (const f of files) {
+    const parsed = parseCommandFile(path.join(COMMANDS_DIR, f))
+    map[parsed.name] = parsed
+  }
+  return map
+}
+
+function getHookCommands() {
+  return [...HOOK_ONLY].map(name => ({ name, agent: "", description: "Hook-handled (see plugin source)" }))
+}
+
+function printReport(registry, filesOnDisk, hookCommands, cmdNames) {
+  console.log("")
+  console.log("  COMMAND SYNC REPORT")
+  console.log("  " + "=".repeat(50))
+  const registered = new Set(Object.keys(registry))
+  const onDisk = new Set(Object.keys(filesOnDisk))
+  const allHooks = new Set(hookCommands.map(h => h.name))
+  const hookNoReg = [...allHooks].filter(n => !registered.has(n) && !onDisk.has(n))
+
+  console.log(`  Registered in bootstrap.mjs:  ${registered.size}`)
+  console.log(`  Files in harness/commands/:    ${onDisk.size}`)
+  console.log(`  Hook-only (no registry):        ${hookNoReg.length}`)
+  console.log(`  Total real commands:           ${cmdNames.length}`)
+  console.log("")
+
+  const registeredNoFile = [...registered].filter(n => !onDisk.has(n))
+  const fileNotRegistered = [...onDisk].filter(n => !registered.has(n) && !allHooks.has(n))
+
+  if (registeredNoFile.length) {
+    console.log("  ⚠ REGISTERED, NO FILE:")
+    for (const n of registeredNoFile) {
+      const e = registry[n]
+      console.log(`    /${n}  —  ${e.description}`)
+    }
+    console.log("")
+  }
+
+  if (fileNotRegistered.length) {
+    console.log("  ⚠ FILE EXISTS, NOT REGISTERED:")
+    for (const n of fileNotRegistered) {
+      console.log(`    /${n}`)
+    }
+    console.log("")
+  }
+
+  if (hookNoReg.length) {
+    console.log("  ℹ HOOK-ONLY (no registry, no file):")
+    for (const n of hookNoReg) {
+      console.log(`    /${n}`)
+    }
+    console.log("")
+  }
+
+  if (!registeredNoFile.length && !fileNotRegistered.length) {
+    console.log("  ✓ Everything in sync — no gaps.")
+    console.log("")
+  }
+}
+
+function generateMissingFiles(registry, filesOnDisk) {
+  let count = 0
+  for (const [name, entry] of Object.entries(registry)) {
+    if (filesOnDisk[name]) continue
+
+    const templateFile = `${name}.md`
+    const agent = entry.agent || "OpenHermes"
+    const desc = entry.description
+
+    let md = `---
+description: ${desc}
+agent: ${agent}
+subtask: true
+---
+
+# ${name.charAt(0).toUpperCase() + name.slice(1)} Command
+
+`
+
+    if (name === "ohc") {
+      md += `OHC context management — hook-handled.\n\nRun \`/ohc status\` to check context usage, \`/ohc compress [targetTokens] [focus]\` to free space.\n\n$ARGUMENTS\n`
+    } else {
+      md += `${desc}: $ARGUMENTS\n`
+    }
+
+    fs.writeFileSync(path.join(COMMANDS_DIR, templateFile), md, "utf8")
+    console.log(`  ✓ Created harness/commands/${templateFile}`)
+    count++
+  }
+
+  if (count === 0) console.log("  No missing files to generate.")
+  return count
+}
+
+function getCommandNames(registry, hookCommands) {
+  const registered = new Set(Object.keys(registry))
+  const hookOnly = hookCommands.filter(h => !registered.has(h.name)).map(h => h.name)
+  const names = [...registered, ...hookOnly]
+  names.sort()
+  return names
+}
+
+function formatCommandRow(names) {
+  const count = names.length
+  const list = names.map(n => `\`/${n}\``).join(", ")
+  return `| **${count} slash commands** | ${list} |`
+}
+
+function formatBacktickList(names) {
+  return ` ${names.map(n => `\\\`/${n}\\\``).join(", ")}`
+}
+
+function syncBootstrap(registry, hookCommands) {
+  let src = fs.readFileSync(BOOTSTRAP_FILE, "utf8")
+  const cmdNames = getCommandNames(registry, hookCommands)
+  const row = formatCommandRow(cmdNames)
+
+  const startIdx = src.indexOf(COMMANDS_START)
+  const endIdx = src.indexOf(COMMANDS_END)
+
+  if (startIdx === -1 || endIdx === -1) {
+    console.log("  ✗ Markers not found in bootstrap.mjs. Inserting markers.")
+    const plugRowRe = /(\|\s+\*\*Plugins\s*\*\*.*\|)/
+    const match = src.match(plugRowRe)
+    if (!match) {
+      console.log("  ✗ Could not find Plugins row to anchor insertion.")
+      return false
+    }
+    const insertAfter = match.index + match[0].length
+    const newRow = `\n| **Slash commands** | ${COMMANDS_START} ${COMMANDS_END} |`
+    src = src.slice(0, insertAfter) + newRow + src.slice(insertAfter)
+    // Re-find markers for content replacement below
+    const newStart = src.indexOf(COMMANDS_START)
+    const newEnd = src.indexOf(COMMANDS_END)
+    if (newStart !== -1 && newEnd !== -1 && newEnd > newStart) {
+      const content = formatBacktickList(cmdNames)
+      src = src.slice(0, newStart + COMMANDS_START.length) + content + src.slice(newEnd)
+    }
+    fs.writeFileSync(BOOTSTRAP_FILE, src, "utf8")
+    console.log("  ✓ Inserted Slash commands row in bootstrap.mjs")
+    return true
+  }
+
+  if (endIdx <= startIdx) {
+    console.log("  ✗ Markers out of order in bootstrap.mjs")
+    return false
+  }
+
+  const content = formatBacktickList(cmdNames)
+  src = src.slice(0, startIdx + COMMANDS_START.length) + content + src.slice(endIdx)
+  fs.writeFileSync(BOOTSTRAP_FILE, src, "utf8")
+  console.log("  ✓ Updated Slash commands row in bootstrap.mjs")
+  return true
+}
+
+function syncReadme(registry, hookCommands) {
+  let src = fs.readFileSync(README_FILE, "utf8")
+  const cmdNames = getCommandNames(registry, hookCommands)
+  const row = formatCommandRow(cmdNames)
+
+  const tableRowRe = /^\|\s*\*\*(\d+)\s*slash commands\s*\*\*.*\|$/m
+  const match = src.match(tableRowRe)
+  if (!match) {
+    console.log("  ✗ Could not find slash commands row in README.md")
+    return false
+  }
+
+  src = src.replace(tableRowRe, row)
+  fs.writeFileSync(README_FILE, src, "utf8")
+  console.log(`  ✓ Updated README.md: ${cmdNames.length} commands`)
+  return true
+}
+
+// Main
+const args = process.argv.slice(2)
+const doAudit = args.includes("--audit") || args.length === 0
+const doGenerate = args.includes("--generate") || args.length === 0
+const doSyncBootstrap = args.includes("--sync-bootstrap") || args.includes("--sync") || args.length === 0
+const doSyncReadme = args.includes("--sync-readme") || args.includes("--sync") || args.length === 0
+
+console.log("  ▸ syncing command definitions...")
+console.log("")
+
+const bootstrapSrc = fs.readFileSync(BOOTSTRAP_FILE, "utf8")
+const registry = parseRegistry(bootstrapSrc)
+const filesOnDisk = scanCommandFiles()
+const hookCommands = getHookCommands()
+const cmdNames = getCommandNames(registry, hookCommands)
+
+if (doAudit) printReport(registry, filesOnDisk, hookCommands, cmdNames)
+
+if (doGenerate) {
+  console.log("  [generate]")
+  generateMissingFiles(registry, filesOnDisk)
+  console.log("")
+}
+
+if (doSyncBootstrap) {
+  console.log("  [sync-bootstrap]")
+  const ok = syncBootstrap(registry, hookCommands)
+  if (!ok) process.exitCode = 1
+  console.log("")
+}
+
+if (doSyncReadme) {
+  console.log("  [sync-readme]")
+  const ok = syncReadme(registry, hookCommands)
+  if (!ok) process.exitCode = 1
+  console.log("")
+}
+
+console.log("  done.")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openhermes",
-  "version": "1.12.1",
+  "version": "1.13.1",
   "description": "OpenHermes plugin suite for OpenCode — autonomous checkpointing, native memory tools, subagent routing, slash commands, and skill-candidate detection.",
   "type": "module",
   "license": "MIT",
@@ -26,7 +26,11 @@
     "harness/"
   ],
   "scripts": {
-    "test": "node --test"
+    "test": "node --test",
+    "commands:audit": "node harness/scripts/sync-commands.mjs --audit",
+    "commands:generate": "node harness/scripts/sync-commands.mjs --generate",
+    "commands:sync": "node harness/scripts/sync-commands.mjs --sync",
+    "commands:full": "node harness/scripts/sync-commands.mjs"
   },
   "keywords": [
     "opencode",