openhermes 4.11.2 → 4.12.1

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,48 +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
-
-### Depth Scoring
-| Metric | Assessment |
-|--------|-----------|
-| Lines | SKILL.md length |
-| Concrete rules | "must/never/always/banned" count |
-| Examples | Before/after or usage code blocks |
-| Anti-patterns | Explicit "don't" sections |
-| Workflow steps | Sequential, actionable steps |
-| Routing table | pass/fail/blocker defined |
-
-**Score:** High (70-100) = concrete + examples + routing. Medium (30-69) = some structure. Low (0-29) = vague, no rules.
-
-### Overlap Detection
-Compare against existing `harness/skills/oh-*` skills. Overlap: none / partial (complementary) / complete (redundant).
-
-### Convention Check
-- Clear description for triggering? Actionable instructions? Anti-patterns? Examples? Measurable outcomes? No time-sensitive refs? No platform assumptions?
-
-### Report Template
-```markdown
-**Depth:** <0-100> — <High/Medium/Low>
-**Overlap:** <existing skill> — <none/partial/complete>
-**Verdict:** <keep / fuse / discard / ask>
-**Action:** <port directly / fuse with X / discard>
-```
-
-## Phase 3: Decision
-
-| Verdict | Action |
-|---------|--------|
-| Keep | High signal, no overlap. Port to `oh-<name>`. |
-| Fuse | Partial overlap with existing. Merge complementary DNA. |
-| Discard | Low signal or complete overlap. Surface reasoning. |
-| Ask | Ambiguous quality. Surface findings. |
-
-When in doubt: prefer fuse over keep, keep over discard if ANY unique signal.
-
-## 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
@@ -64,29 +79,34 @@ description: "Adapted from <source>. Core function. Use when ..."
 tier: <2|3|4>
 ```
 
-### Body Structure
-1. **Summary** — one-paragraph of what the skill does
-2. **When to Use** — clear triggering context
-3. **Workflow** — numbered steps (the core)
-4. **Anti-patterns** — what NOT to do
-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.
-
-### 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: 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
@@ -98,23 +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 6: 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)
-- Keeping everything — ~50% of external skills 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
+## 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,36 +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-skills-link
-    - oh-skill-craft
-  fail: oh-skill-craft
-  blocker: surface
----
-
-# oh-fusion
-
-Skill ingestion pipeline: Discover → Analyze → Decide → Adapt → Fuse → Integrate.
-
-## Steps
-
-1. Load skill content — read from `.agents/skills/`, `npx skills`, URL, user path, or inline text.
-2. Analyze depth — score by lines, concrete rules, examples, anti-patterns, workflow steps, and routing.
-3. Detect overlap — compare against existing `oh-*` skills. Report none/partial/complete.
-4. Decide verdict — Keep (high signal, no overlap), Fuse (partial overlap, merge DNA), Discard (low/no signal), or Ask (ambiguous).
-5. Adapt to OH-native format — remove emojis, convert paths, add routing, preserve unique signal.
-6. Fuse if merging — identify unique concepts from each source, resolve conflicts, write one coherent workflow.
-7. Integrate — create skill file, wire AUTOPILOT, routing, AGENTS.md, openhermes.md.
-8. Verify — route to oh-skills-link to confirm discovery.
-
-## Routing
-
-| Outcome | Route |
-|---------|-------|
-| Integration complete | → oh-skills-link (verify discovery) |
-| Fusion needs iteration | → oh-skill-craft |
-| Analysis: discard | → surface |
-| Analysis: ask | → surface with recs |
+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-manifest/SKILL.md

@@ -29,3 +29,4 @@ Full build orchestration loop: pre-flight → plan → build → verify → loop
 | pass | → oh-planner |
 | fail | → oh-expert (diagnose loop failure) |
 | blocker | → surface with context and options |
+

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

@@ -20,12 +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.
+### 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/harness/skills/oh-review/SKILL.md

@@ -29,3 +29,4 @@ Two-axis review: Standards + Spec, parallel sub-agents. Three modes: Diff Review
 | pass | → oh-gauntlet or oh-ship |
 | fail | → oh-builder |
 | blocker | → surface |
+

package/package.json

@@ -1,57 +1,55 @@
 {
-  "name": "openhermes",
-  "version": "4.11.2",
-  "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",
-    "lib/",
-    "scripts/",
-    "harness/codex/",
-    "harness/instructions/",
-    "harness/skills/",
-    "harness/commands/",
-    "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.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"
+                        }
 }