openhermes 4.9.2 → 4.12.1

package/CONTEXT.md

@@ -1,12 +1,12 @@
 # OpenHermes — Shared Language
 
 ## Terms
-**OpenHermes** — OpenCode-native orchestration layer for this package.
-**Skill** — A `SKILL.md` loaded on demand through OpenCode's skill tool.
-**Command** — A slash command backed by package-local markdown in `harness/commands/`.
-**Agent** — A primary or subagent definition loaded through OpenCode config.
-**Instruction** — Markdown loaded through `AGENTS.md` or `opencode.json` instructions.
-**Bootstrap** — The first-message context injected by the OpenHermes plugin.
+**OpenHermes** — OpenCode-native orchestration layer for this package.
+**Skill** — A `SKILL.md` loaded on demand through OpenCode's skill tool.
+**Command** — A slash command backed by package-local command markdown; legacy compatibility loaders remain only where runtime-backed.
+**Agent** — A primary or subagent definition loaded through OpenCode config.
+**Instruction** — Markdown loaded through `AGENTS.md` or `opencode.json` instructions.
+**Bootstrap** — The first-message context injected by the OpenHermes plugin.
 
 ### Confidence Gate Terms
 **Confidence Gate** — Phase 0.5 protocol in the autopilot loop that evaluates signal strength before routing. Bounded to 1 conversational exchange max.
@@ -24,4 +24,4 @@
 - OpenHermes is the default primary Agent.
 
 ## Flagged Ambiguities
-- Durable state is deferred for now and not a domain term for this pass.
+- Durable state resolved — 4-Tier Memory subsystem (System/Project/Mission/Task) now provides structured persistence with importance-driven retention.

package/ETHOS.md

@@ -8,8 +8,8 @@ OpenCode-native loading over manual copying or hidden state.
 ## Small Surface
 Every file earns its keep. Prefer markdown when behavior is declarative.
 
-## Skills Over Glue
-Behavior lives in `SKILL.md`, `commands/*.md`, and `agents/*.md`.
+## Skills Over Glue
+Behavior lives in `SKILL.md`, command markdown, and agent markdown. Legacy command-doc compatibility loaders remain supported only where runtime-backed.
 
 ## Always Delegate — Never Execute
 OpenHermes orchestrates and reports. Sub-agents execute. OpenHermes never writes code, runs tests, or touches files directly.

package/README.md

@@ -5,7 +5,7 @@
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/openhermes"><img src="https://img.shields.io/npm/v/openhermes?style=for-the-badge&label=version&color=FFD700" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/openhermes"><img src="https://img.shields.io/npm/v/openhermes?style=for-the-badge&label=version&color=FFD700" alt="v4.11.3"></a>
   <a href="https://github.com/nathwn12/openhermes/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=for-the-badge" alt="License: MIT"></a>
   <a href="https://opencode.ai"><img src="https://img.shields.io/badge/runs%20on-OpenCode-6366f1?style=for-the-badge" alt="Runs on OpenCode"></a>
   <a href="https://github.com/nathwn12/openhermes"><img src="https://img.shields.io/badge/⭐%20star%20on-GitHub-181717?style=for-the-badge" alt="Star on GitHub"></a>
@@ -31,27 +31,20 @@ To install from `dev` (latest features, may be unstable):
 
 ---
 
-## One sentence. Nine steps.
+## One sentence. One engine.
 
-Add the plugin. Restart. Type:
+OpenHermes v4.11 ships with a hardened internal architecture — 8 subsystems working together to make every session faster, more reliable, and fully autonomous:
 
-> *"Plan a CLI tool for managing dotfiles."*
-
-You see output. Behind the scenes, this runs:
-
-| # | What fires | What it does |
-|---|---|---|
-| **1** | `AUTOPILOT.md` decision matrix | Multi-step, vague → `PLANNING NEEDED` |
-| **2** | `oh-planner` | Brainstorm mode: architecture, user flow, risks |
-| **3** | `oh-planner` → `oh-grill` | Plan passes → stress-test it |
-| **4** | `oh-grill` → `oh-planner` (revise) | Gaps found → planner revises |
-| **5** | `oh-planner` → `oh-manifest` | Plan solid → enter build loop |
-| **6** | `oh-planner` → `oh-builder` → `oh-gauntlet` | Implement → test → review → loop |
-| **7** | `oh-gauntlet` → `oh-ship` | Tests pass → PR pipeline |
-| **8** | `oh-ship` → `oh-retro` | Shipped → retrospective |
-| **9** | `oh-retro` → `oh-planner` | Ready for the next cycle |
-
-One sentence. Nine automated steps. Each skill loaded on demand, executed in isolation, routed to the next specialist. **Auto-classify, delegate, route, repeat.** That's the entire model.
+| Subsystem | What it does |
+|-----------|-------------|
+| **Prompt Composer** | 9 modular fragments joined at runtime → byte-identical. Add a fragment, never edit the composition code. |
+| **Auto-Recovery** | 9 error categories with typed actions — retry with backoff, compact on overflow, escalate on unknowns. Self-healing. |
+| **4-Tier Memory** | System → Project → Mission → Task. Importance-scored, budget-enforced, plan-file-persisted. Context that survives hops. |
+| **Hook Registry** | Pluggable pre-tool, post-tool, route, and session hooks with topological sort. 8 built-in hooks, zero routing boilerplate. |
+| **MVCC Sync** | Atomic writes, version counters, conflict detection. Multiple sub-agents writing the same plan file — no data loss. |
+| **Sanity Checker** | 8 output degeneration detectors — repetition, gibberish, low diversity — with automatic escalation and recovery injection. |
+| **Background Cmd** | Fire-and-forget process spawning with timeout, status polling, and auto-cleanup. Non-blocking long-running tasks. |
+| **Plan Location** | Resolves plan file paths per project with directory-per-project layout in `~/.local/share/openhermes/plans/`. |
 
 ---
 
@@ -78,15 +71,15 @@ The loop runs unsupervised because these never turn off:
 | Capability | Why it matters |
 |---|---|
 | **Self-driving loop** | Type once. OpenHermes classifies, delegates, and routes — no pauses, no asking permission, no verbosity. |
-| **31 specialist skills** | Planning → building → testing → browser → security → review → shipping → retro. Every dev cycle phase. |
-| **Auto-detected user skills** | Drop a skill in `~/.agents/skills/`. OpenHermes finds it. Same name as a built-in? Your version wins. Survives `npm update`. |
-| **`/oh-doctor`** | Verify plugin load, skill discovery, command registration, config safety. |
-| **`/oh-log`** | Session log — routing hops, skill loads, compaction events. |
+| **30 specialist skills** | Planning → building → testing → browser → security → review → shipping → retro. Every dev cycle phase. |
+| **Auto-detected user skills** | Drop a skill in `~/.agents/skills/` or `~/.config/opencode/skills/`. OpenHermes finds it. Same name as a built-in? Your version wins. Survives `npm update`. |
 | **Shared operating model** | CHARTER + AUTOPILOT + CONTEXT + ETHOS injected every session. Every interaction grounded in the same rules. |
 | **CORE/DEEP skill format** | Every skill is a two-file system: CORE (SKILL.md) handles 80% of passes in one read. DEEP.md loads on demand for hard cases. |
-| **Plan file storage** | `~/.local/share/opencode/openhermes/plans/`. Survives `npm update`. |
+| **Plan file storage** | `~/.local/share/openhermes/plans/`. Survives `npm update`. |
+| **8 internal subsystems** | Composer, recovery, memory, sync, hooks, plans, sanity, background — all native Node.js / TypeScript. |
+| **Zero npm dependency additions** | All new subsystems use native Node.js and TypeScript only. No new packages. |
 
-## 31 skills — three tiers
+## 30 skills — four tiers
 
 ### Tier 4 — Pipeline orchestrators
 Full multi-phase workflows:
@@ -132,7 +125,6 @@ Single-purpose, one thing well:
 | **oh-issue** | Break a plan/spec/PRD into independently-grabbable issues |
 | **oh-prd** | Conversation → PRD → GitHub issue |
 | **oh-freeze** | Restrict file edits to a specific directory |
-| **oh-learn** | Extract, evolve, promote session learnings as instincts |
 | **oh-guard** | Safety confirmation — warn before destructive operations |
 | **oh-skills-link** | Verify OpenCode discovers the skill directory |
 | **oh-skills-list** | List all available `oh-*` skills |
@@ -148,17 +140,26 @@ openhermes-pkg/
 ├── ETHOS.md               # Operating principles
 ├── bootstrap.ts           # Plugin entry — registers everything
 ├── index.ts               # Package entrypoint
-├── lib/                   # harness-resolver.ts
 ├── harness/
 │   ├── agents/            # Agent manifests (OpenHermes primary)
 │   ├── codex/             # CHARTER, AUTOPILOT
-│   ├── commands/          # Slash commands (/oh-doctor, /oh-log)
-│   ├── instructions/      # SHELL.md
-│   └── skills/            # 31 skill SKILL.md files (CORE/DEEP format)
+│   ├── instructions/      # SHELL.md
+│   ├── lib/               # Internal subsystems
+│   │   ├── composer/      # Prompt fragment composition
+│   │   ├── recovery/      # Auto-recovery with error patterns
+│   │   ├── memory/        # 4-tier hierarchical memory
+│   │   ├── sync/          # MVCC plan synchronization
+│   │   ├── hooks/         # Pluggable hook registry
+│   │   ├── plans/         # Plan file path resolution
+│   │   ├── sanity/        # Output degeneration detection
+│   │   └── background/    # Fire-and-forget command system
+│   └── skills/            # 30 skill SKILL.md files (CORE/DEEP format)
+├── lib/                   # harness-resolver.ts
 └── test/
+    └── harness/           # Test utilities (fixture, builders, mocks)
 ```
 
-Plan files: `~/.local/share/opencode/openhermes/plans/<project>-plan-<nnn>.md`
+Plan files: `~/.local/share/openhermes/plans/<project>/plan-<nnn>.md`
 
 ---
 
@@ -166,7 +167,7 @@ Plan files: `~/.local/share/opencode/openhermes/plans/<project>-plan-<nnn>.md`
 
 1. Add the plugin line to `opencode.json`
 2. Restart or reload OpenCode
-3. Run `/oh-doctor` to verify everything loaded
+3. Verify the plugin loaded in the startup log
 4. Type *any* prompt — "plan a feature", "investigate this bug", "refactor this module"
 
 The first time you see OpenHermes auto-route to a specialist skill without you asking — you'll feel the loop.