openhermes 4.12.1 → 4.13.0

package/harness/lib/routing/types.ts

@@ -1,52 +1,52 @@
-export const ROUTE_OUTCOMES = ["pass", "fail", "blocker"] as const;
-export const ROUTE_VERIFICATIONS = ["verified", "unverified"] as const;
-export const ROUTE_ACTIONS = ["done", "fixable", "needs-context", "blocked"] as const;
-export const ROUTE_WORK_TYPES = ["implement", "verify", "ship", "diagnose", "surface"] as const;
-
-export type RouteOutcome = (typeof ROUTE_OUTCOMES)[number];
-export type RouteVerification = (typeof ROUTE_VERIFICATIONS)[number];
-export type RouteAction = (typeof ROUTE_ACTIONS)[number];
-export type RouteWork = (typeof ROUTE_WORK_TYPES)[number];
-
-export interface SkillRouteMap {
-  pass: string[];
-  fail: string[];
-  blocker: string[];
-}
-
-export interface SkillRoutingFrontmatter {
-  name?: string;
-  description?: string;
-  tier?: string;
-  route: SkillRouteMap;
-}
-
-export interface RouteEvidence {
-  outcome: RouteOutcome;
-  verification?: RouteVerification;
-  action?: RouteAction;
-  work?: RouteWork;
-  target?: string;
-  reason?: string;
-}
-
-export interface RouteResolution {
-  outcome: RouteOutcome;
-  verification?: RouteVerification;
-  action?: RouteAction;
-  work?: RouteWork;
-  candidates: string[];
-  selected: string | null;
-  reason: string;
-}
-
-export interface RuntimeRouteDecision {
-  selected: string;
-  source: "next_route" | "route_guidance";
-  outcome?: RouteOutcome;
-  verification?: RouteVerification;
-  action?: RouteAction;
-  work?: RouteWork;
-  candidates?: string[];
-  reason?: string;
-}
+export const ROUTE_OUTCOMES = ["pass", "fail", "blocker"] as const;
+export const ROUTE_VERIFICATIONS = ["verified", "unverified"] as const;
+export const ROUTE_ACTIONS = ["done", "fixable", "needs-context", "blocked"] as const;
+export const ROUTE_WORK_TYPES = ["implement", "verify", "ship", "diagnose", "surface"] as const;
+
+export type RouteOutcome = (typeof ROUTE_OUTCOMES)[number];
+export type RouteVerification = (typeof ROUTE_VERIFICATIONS)[number];
+export type RouteAction = (typeof ROUTE_ACTIONS)[number];
+export type RouteWork = (typeof ROUTE_WORK_TYPES)[number];
+
+export interface SkillRouteMap {
+  pass: string[];
+  fail: string[];
+  blocker: string[];
+}
+
+export interface SkillRoutingFrontmatter {
+  name?: string;
+  description?: string;
+  tier?: string;
+  route: SkillRouteMap;
+}
+
+export interface RouteEvidence {
+  outcome: RouteOutcome;
+  verification?: RouteVerification;
+  action?: RouteAction;
+  work?: RouteWork;
+  target?: string;
+  reason?: string;
+}
+
+export interface RouteResolution {
+  outcome: RouteOutcome;
+  verification?: RouteVerification;
+  action?: RouteAction;
+  work?: RouteWork;
+  candidates: string[];
+  selected: string | null;
+  reason: string;
+}
+
+export interface RuntimeRouteDecision {
+  selected: string;
+  source: "next_route" | "route_guidance";
+  outcome?: RouteOutcome;
+  verification?: RouteVerification;
+  action?: RouteAction;
+  work?: RouteWork;
+  candidates?: string[];
+  reason?: string;
+}

package/harness/skills/oh-ascii/SKILL.md

@@ -19,7 +19,7 @@ Create and validate ASCII diagrams in three phases: design, generate, validate.
 3. Fence all diagrams in markdown code blocks
 4. Keep diagrams under 80 columns with max 3 nesting levels
 5. For complex diagrams, author PlantUML and render with `-utxt`
-6. Validate structural alignment with `scripts/check_ascii_alignment.py`
+6. Validate visual alignment manually: check that box-drawing characters connect cleanly and all columns align within the markdown code block
 7. Fix reported issues and re-validate until clean
 
 ## Routing

package/harness/skills/oh-fusion/DEEP.md

@@ -1,10 +1,10 @@
 # oh-fusion — Deep Reference
 
-## When to Use
-
-Use when a user wants to bring an external skill or capability into the OpenHermes harness as an OH-native skill.
-
-## Phase 1: Discovery
+## When to Use
+
+Use when a user wants to bring an external skill or capability into the OpenHermes harness as an OH-native skill.
+
+## Phase 1: Discovery
 
 | Source | Access |
 |--------|--------|
@@ -14,63 +14,63 @@ Use when a user wants to bring an external skill or capability into the OpenHerm
 | User path | Resolve and read |
 | Inline text | Capture raw |
 
-Confirm: content loaded, frontmatter present, no access restrictions. For multiple: all loaded.
-
-## Phase 2: Analysis
-
-### Required Lenses
-
-Analyze every source through these lenses:
-
-- **OH gaps** — what OH does not currently cover, or covers weakly
-- **OH wins** — where OH already outperforms the source and should not regress
-- **Missed patterns** — reusable patterns the source surfaces that OH should absorb
-- **Overlap target** — the strongest existing `oh-*` candidate for merge, if any
-
-### Merge Rubric
-
-Choose one verdict:
-
-| Verdict | Use when |
-|---------|----------|
-| Merge | The source upgrades an existing OH capability more than it defines a new one |
-| Standalone | The source adds a distinct capability with its own trigger, workflow, and routing needs |
-| Discard | The source is redundant, weak, or anti-native |
-
-### Strength Check
-
-Reject or rewrite any protocol that makes OH weaker, slower, noisier, or less OpenCode-native.
-
-### Fusion Report Template
-```markdown
-## OH gaps
-- ...
-
-## OH wins
-- ...
-
-## Missed patterns
-- ...
-
-## Merge verdict
-- Verdict: <merge | standalone | discard>
-- Target: <existing oh-* or new oh-*>
-- Why: <short rationale>
-
-## Action plan
-1. ...
-2. ...
-
-## Approval gate
-- Status: pending approval
-- Next move after approval: <skill/action>
-```
-
-## Phase 3: Decision
-
-Default to `merge` when the source sharpens an existing OH workflow. Default to `standalone` only when the capability stays clean, distinct, and reusable after removing overlap.
-
-## Phase 4: Adaptation
+Confirm: content loaded, frontmatter present, no access restrictions. For multiple: all loaded.
+
+## Phase 2: Analysis
+
+### Required Lenses
+
+Analyze every source through these lenses:
+
+- **OH gaps** — what OH does not currently cover, or covers weakly
+- **OH wins** — where OH already outperforms the source and should not regress
+- **Missed patterns** — reusable patterns the source surfaces that OH should absorb
+- **Overlap target** — the strongest existing `oh-*` candidate for merge, if any
+
+### Merge Rubric
+
+Choose one verdict:
+
+| Verdict | Use when |
+|---------|----------|
+| Merge | The source upgrades an existing OH capability more than it defines a new one |
+| Standalone | The source adds a distinct capability with its own trigger, workflow, and routing needs |
+| Discard | The source is redundant, weak, or anti-native |
+
+### Strength Check
+
+Reject or rewrite any protocol that makes OH weaker, slower, noisier, or less OpenCode-native.
+
+### Fusion Report Template
+```markdown
+## OH gaps
+- ...
+
+## OH wins
+- ...
+
+## Missed patterns
+- ...
+
+## Merge verdict
+- Verdict: <merge | standalone | discard>
+- Target: <existing oh-* or new oh-*>
+- Why: <short rationale>
+
+## Action plan
+1. ...
+2. ...
+
+## Approval gate
+- Status: pending approval
+- Next move after approval: <skill/action>
+```
+
+## Phase 3: Decision
+
+Default to `merge` when the source sharpens an existing OH workflow. Default to `standalone` only when the capability stays clean, distinct, and reusable after removing overlap.
+
+## Phase 4: Adaptation
 
 ### Frontmatter
 ```yaml
@@ -79,34 +79,34 @@ description: "Adapted from <source>. Core function. Use when ..."
 tier: <2|3|4>
 ```
 
-### Body Structure
-1. **Summary** — one short paragraph
-2. **When to Use** — clear triggering context
-3. **Protocol** — numbered workflow
-4. **Rubric / guardrails** — what to merge, reject, or escalate
-5. **Routing** — pass/fail/blocker table
-
-### Adaptation Rules
-- Remove emojis. Replace ecosystem terms with OH equivalents.
-- Convert relative paths to OH harness conventions.
-- Add routing table based on the skill's purpose.
-- Keep all concrete rules, examples, and anti-patterns from the original.
-- Discard fluff, philosophy, and motivational language.
-- Preserve the original's unique signal — that's why you're importing it.
-- Keep the result OpenCode/OpenHermes-native only.
-
-### Naming
-Match `^[a-z0-9]+(-[a-z0-9]+)*$`, prefix `oh-`. Original name if good fit, adapt if not. Fusion names signal combined purpose.
-
-## Phase 5: Approval Gate
-
-Before any harness mutation, surface the fusion report and wait for approval. Approved intent already present in the conversation counts. Do not ask new questions unless a blocker cannot be resolved from the codebase or prior conversation.
-
-## Phase 6: Fusion (opt — skip for single imports)
-
-For each skill being fused, identify:
-- **Unique concepts** — content only this skill has
-- **Overlapping content** — same idea expressed differently (keep the better version)
+### Body Structure
+1. **Summary** — one short paragraph
+2. **When to Use** — clear triggering context
+3. **Protocol** — numbered workflow
+4. **Rubric / guardrails** — what to merge, reject, or escalate
+5. **Routing** — pass/fail/blocker table
+
+### Adaptation Rules
+- Remove emojis. Replace ecosystem terms with OH equivalents.
+- Convert relative paths to OH harness conventions.
+- Add routing table based on the skill's purpose.
+- Keep all concrete rules, examples, and anti-patterns from the original.
+- Discard fluff, philosophy, and motivational language.
+- Preserve the original's unique signal — that's why you're importing it.
+- Keep the result OpenCode/OpenHermes-native only.
+
+### Naming
+Match `^[a-z0-9]+(-[a-z0-9]+)*$`, prefix `oh-`. Original name if good fit, adapt if not. Fusion names signal combined purpose.
+
+## Phase 5: Approval Gate
+
+Before any harness mutation, surface the fusion report and wait for approval. Approved intent already present in the conversation counts. Do not ask new questions unless a blocker cannot be resolved from the codebase or prior conversation.
+
+## Phase 6: Fusion (opt — skip for single imports)
+
+For each skill being fused, identify:
+- **Unique concepts** — content only this skill has
+- **Overlapping content** — same idea expressed differently (keep the better version)
 - **Conflicting directives** — skills that say opposite things (surface to user)
 
 ### Merge Architecture
@@ -118,26 +118,26 @@ Structure so each source contributes its strength. Do NOT concatenate — must r
 ### Phase B: <from skill 2>
 ```
 
-### Naming
-Name signals combined purpose, not individual sources. E.g., `oh-facade` from redesign + design-taste + high-end-visual, not `oh-redesign-plus-taste`.
-
-## Phase 7: Integration
-
-1. **Create file** → user dir (`~/.config/opencode/skills/oh-<name>/SKILL.md`)
-2. **Wire AUTOPILOT** → add to auto-classify matrix in `harness/codex/AUTOPILOT.md`: signal keywords → classification → "Load **oh-<name>**. Do not ask."
-3. **Wire routing** → add `route:` frontmatter in the skill. Dynamic loading reads `route.pass`, `route.fail`, `route.blocker` directly from `SKILL.md` — no ROUTING.md edit needed. Skill becomes routable automatically.
+### Naming
+Name signals combined purpose, not individual sources. E.g., `oh-facade` from redesign + design-taste + high-end-visual, not `oh-redesign-plus-taste`.
+
+## Phase 7: Integration
+
+1. **Create file** → user dir (`~/.config/opencode/skills/oh-<name>/SKILL.md`)
+2. **Wire AUTOPILOT** → add to auto-classify matrix in `harness/codex/AUTOPILOT.md`: signal keywords → classification → "Load **oh-<name>**. Do not ask."
+3. **Wire routing** → add `route:` frontmatter in the skill. Dynamic loading reads `route.pass`, `route.fail`, `route.blocker` directly from `SKILL.md` — no ROUTING.md edit needed. Skill becomes routable automatically.
 4. **Wire AGENTS.md** → add to skills table with tier and purpose. Increment total count.
 5. **Wire openhermes.md** → add to orchestrator's skill list in `harness/agents/openhermes.md`.
 6. **Verify** → route to `oh-skills-link` to confirm OpenCode discovers it.
 
-## Anti-patterns
-
-- Importing without analysis (always run Phase 2)
-- Asking before checking code or prior conversation
-- Changing the harness before the approval gate clears
-- Keeping everything — most external skill text is fluff
-- Fusing incompatible domains (confusing to model and user)
-- Naming after source ("oh-tailwind-v2") instead of capability ("oh-styles")
-- Skipping route frontmatter — without it, autopilot can't route
-- Overwriting existing routing without checking for collisions
-- Shipping a protocol that weakens OH or makes it less native
+## Anti-patterns
+
+- Importing without analysis (always run Phase 2)
+- Asking before checking code or prior conversation
+- Changing the harness before the approval gate clears
+- Keeping everything — most external skill text is fluff
+- Fusing incompatible domains (confusing to model and user)
+- Naming after source ("oh-tailwind-v2") instead of capability ("oh-styles")
+- Skipping route frontmatter — without it, autopilot can't route
+- Overwriting existing routing without checking for collisions
+- Shipping a protocol that weakens OH or makes it less native

package/harness/skills/oh-fusion/SKILL.md

@@ -1,50 +1,50 @@
 ---
 name: oh-fusion
-description: "Use when the user has an existing skill, finds a skill in their .agents/skills, or wants to bring an external capability into OH as a skill."
-tier: 3
-route:
-  pass: [oh-skill-craft, oh-skills-link]
-  fail: surface
-  blocker: surface
----
-
-# oh-fusion
-
-Skill fusion pipeline: Discover → Analyze → Verdict → Approval Gate → Integrate.
-
-## Protocol
-
-1. Load skill content — read from `.agents/skills/`, `npx skills`, URL, user path, or inline text.
-2. Analyze the source against OH — report `OH gaps`, `OH wins`, and `missed patterns`.
-3. Compare overlap — identify the best existing `oh-*` target, if any.
-4. Decide with a rubric:
-   - **Merge** when the source mainly strengthens an existing OH capability.
-   - **Standalone** when the source adds a distinct, reusable capability.
-   - **Discard** when the signal is weak or redundant.
-5. Produce a fusion report with these sections, in order:
-   - `OH gaps`
-   - `OH wins`
-   - `missed patterns`
-   - `merge verdict`
-   - `action plan`
-   - `approval gate`
-6. Resolve from code and prior conversation first. Ask only if a blocker remains.
-7. After approval, adapt to OH-native form and route directly to implementation.
-8. Verify discovery with `oh-skills-link` when a new or renamed skill is added.
-
-## Merge Rubric
-
-- **Merge into existing `oh-*`** when domain, trigger, and route already exist; the source mostly adds sharper rules, better sequencing, or stronger edge-case handling.
-- **Create standalone `oh-*`** when the source introduces a capability with distinct trigger words, workflow, and handoff points.
-- **Discard** when the source adds fluff, duplicates OH, or weakens OpenCode/OpenHermes-native operation.
-
-## Routing
-
-| Outcome | Route |
-|---------|-------|
-| Approved merge or standalone plan | → oh-skill-craft |
-| New or renamed skill needs discovery check | → oh-skills-link |
-| Analysis: discard | → surface |
-| Approval not yet granted | → surface |
+description: "Use when the user has an existing skill, finds a skill in their .agents/skills, or wants to bring an external capability into OH as a skill."
+tier: 3
+route:
+  pass: [oh-skill-craft, oh-skills-link]
+  fail: surface
+  blocker: surface
+---
+
+# oh-fusion
+
+Skill fusion pipeline: Discover → Analyze → Verdict → Approval Gate → Integrate.
+
+## Protocol
+
+1. Load skill content — read from `.agents/skills/`, `npx skills`, URL, user path, or inline text.
+2. Analyze the source against OH — report `OH gaps`, `OH wins`, and `missed patterns`.
+3. Compare overlap — identify the best existing `oh-*` target, if any.
+4. Decide with a rubric:
+   - **Merge** when the source mainly strengthens an existing OH capability.
+   - **Standalone** when the source adds a distinct, reusable capability.
+   - **Discard** when the signal is weak or redundant.
+5. Produce a fusion report with these sections, in order:
+   - `OH gaps`
+   - `OH wins`
+   - `missed patterns`
+   - `merge verdict`
+   - `action plan`
+   - `approval gate`
+6. Resolve from code and prior conversation first. Ask only if a blocker remains.
+7. After approval, adapt to OH-native form and route directly to implementation.
+8. Verify discovery with `oh-skills-link` when a new or renamed skill is added.
+
+## Merge Rubric
+
+- **Merge into existing `oh-*`** when domain, trigger, and route already exist; the source mostly adds sharper rules, better sequencing, or stronger edge-case handling.
+- **Create standalone `oh-*`** when the source introduces a capability with distinct trigger words, workflow, and handoff points.
+- **Discard** when the source adds fluff, duplicates OH, or weakens OpenCode/OpenHermes-native operation.
+
+## Routing
+
+| Outcome | Route |
+|---------|-------|
+| Approved merge or standalone plan | → oh-skill-craft |
+| New or renamed skill needs discovery check | → oh-skills-link |
+| Analysis: discard | → surface |
+| Approval not yet granted | → surface |
 | Blocker | → surface |
-
+

package/harness/skills/oh-init/DEEP.md

@@ -26,7 +26,7 @@ OpenHermes is the primary orchestrator. All routing, planning, and delegation fl
 - **Test command**: <fill or auto-detect>
 
 ## Key Directives
-- Plan first. Write to `~/.local/share/openhermes/plans/<project>/plan-<nnn>.md` before multi-file changes.
+- Plan first. Write to `~/.local/share/openhermes/plans/<project>/plan-<nnn>.md` before multi-file changes.
 - OpenHermes delegates everything to sub-agents — never executes directly.
 - Verify before claiming success. Read files, run commands, confirm output.
 - Use oh-* skills on demand via the skill tool.
@@ -40,7 +40,7 @@ Ask user to fill or auto-detect from manifests.
 ```markdown
 ## OpenHermes Orchestrator
 OpenHermes is the primary orchestrator.
-- **Plan**: `~/.local/share/openhermes/plans/<project>/plan-<nnn>.md`
+- **Plan**: `~/.local/share/openhermes/plans/<project>/plan-<nnn>.md`
 - **Never execute**: delegates everything to sub-agents
 - **Verify before claim**: read files, run commands, confirm output
 ```

package/harness/skills/oh-plan-review/DEEP.md

@@ -80,7 +80,7 @@ One section at a time: Architecture → Code Quality → Tests → Performance.
 
 ## Output
 
-Plan file (`~/.local/share/openhermes/plans/<project-name>/plan-<nnn>.md`) updated with findings and decisions.
+Plan file (`~/.local/share/openhermes/plans/<project-name>/plan-<nnn>.md`) updated with findings and decisions.
 
 ## Anti-patterns
 

package/harness/skills/oh-planner/DEEP.md

@@ -92,18 +92,18 @@ Runs sequentially: **Strategy → Architecture → Design → Engineering → DX
 Every plan written by oh-planner uses this canonical format.
 
 ### Storage
-Canonical path: `~/.local/share/openhermes/plans/<project>/plan-<nnn>.md`
+Canonical path: `~/.local/share/openhermes/plans/<project>/plan-<nnn>.md`
 
 ### Template
 ```markdown
 # PLAN: <project>
 
-Plan ID: <project>/plan-<nnn>
+Plan ID: <project>/plan-<nnn>
 Project: <project>
 Status: active | in-progress | blocked | complete | abandoned
 Created: <ts> | Updated: <ts>
 Project Path: <absolute-path>
-Plan Path: <canonical-path>/<project>/plan-<nnn>.md
+Plan Path: <canonical-path>/<project>/plan-<nnn>.md
 Objective: <short>
 
 ## Current State

package/harness/skills/oh-review/DEEP.md

@@ -20,14 +20,14 @@ AGENTS.md, CLAUDE.md, CONTRIBUTING.md, CONTEXT.md, ADRs, eslint/biome/prettier c
 - **Standards** — Read standards + diff. Per-file/hunk: violations citing standard + rule. Distinguish hard violations from judgment calls. Skip tool-enforced.
 - **Spec** — Read spec + diff. Report: missing/partial requirements, scope creep, wrong implementations. Quote spec line.
 
-### 5. Aggregate
-Present under `## Standards` / `## Spec`. Do not merge. End with total + worst issue.
-
-Concrete, low-risk, fixable findings should be converted into implementation work and dispatched to oh-builder immediately instead of stopping as report-only notes.
+### 5. Aggregate
+Present under `## Standards` / `## Spec`. Do not merge. End with total + worst issue.
+
+Concrete, low-risk, fixable findings should be converted into implementation work and dispatched to oh-builder immediately instead of stopping as report-only notes.
 
 ### Safety Check (inline before spawning)
 - SQL injection, LLM trust boundary violations, conditional side effects (test vs prod), hardcoded secrets
-- Block immediately if critical — do not spawn sub-agents.
+- Block immediately if critical — do not spawn sub-agents.
 
 ## Mode B: Architecture Deepening
 

package/package.json

@@ -1,55 +1,58 @@
 {
-    "name":  "openhermes",
-    "version":  "4.12.1",
-    "description":  "Autonomous agent orchestration for OpenCode.",
-    "type":  "module",
-    "license":  "MIT",
-    "engines":  {
-                    "bun":  "\u003e=1.0"
-                },
-    "main":  "./index.ts",
-    "dependencies":  {
-                         "@opencode-ai/plugin":  "1.15.0"
-                     },
-    "exports":  {
-                    ".":  "./index.ts",
-                    "./bootstrap":  "./bootstrap.ts"
-                },
-    "files":  [
-                  "index.ts",
-                  "bootstrap.ts",
-                  "tsconfig.json",
-                  "ETHOS.md",
-                  "CONTEXT.md",
-                  "lib/",
-                  "harness/codex/",
-                  "harness/instructions/",
-                  "harness/skills/",
-                  "harness/agents/",
-                  "harness/lib/"
-              ],
-    "scripts":  {
-                    "test":  "bun test"
-                },
-    "keywords":  [
-                     "opencode",
-                     "openhermes",
-                     "orchestrator",
-                     "skills",
-                     "commands",
-                     "agents",
-                     "rules"
-                 ],
-    "repository":  {
-                       "type":  "git",
-                       "url":  "git+https://github.com/nathwn12/openhermes.git"
-                   },
-    "bugs":  {
-                 "url":  "https://github.com/nathwn12/openhermes/issues"
-             },
-    "homepage":  "https://github.com/nathwn12/openhermes#readme",
-    "author":  "nathwn12",
-    "devDependencies":  {
-                            "@types/node":  "^25.8.0"
-                        }
+    "name": "openhermes",
+    "version": "4.13.0",
+    "description": "Autonomous agent orchestration for OpenCode.",
+    "type": "module",
+    "license": "MIT",
+    "engines": {
+        "bun": ">=1.0"
+    },
+    "main": "./index.ts",
+    "dependencies": {
+        "@opencode-ai/plugin": "1.15.0"
+    },
+    "exports": {
+        ".": "./index.ts",
+        "./bootstrap": "./bootstrap.ts"
+    },
+    "files": [
+        "index.ts",
+        "bootstrap.ts",
+        "tsconfig.json",
+        "ETHOS.md",
+        "CONTEXT.md",
+        "docs/",
+        "lib/",
+        "harness/codex/",
+        "harness/instructions/",
+        "harness/skills/",
+        "harness/agents/",
+        "harness/lib/"
+    ],
+    "scripts": {
+        "test": "bun test",
+        "typecheck": "bun tsc --noEmit"
+    },
+    "keywords": [
+        "opencode",
+        "openhermes",
+        "orchestrator",
+        "skills",
+        "commands",
+        "agents",
+        "rules"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/nathwn12/openhermes.git"
+    },
+    "bugs": {
+        "url": "https://github.com/nathwn12/openhermes/issues"
+    },
+    "homepage": "https://github.com/nathwn12/openhermes#readme",
+    "author": "nathwn12",
+    "devDependencies": {
+        "@types/node": "^25.8.0",
+        "typescript": "^6.0.3"
+    }
 }