openhermes 4.3.0 → 4.11.2

package/CONTEXT.md

@@ -8,6 +8,15 @@
 **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.
+**Confidence Level** — One of HIGH, MEDIUM, LOW, derived from signal axis evaluation.
+**Transparent Gate** — HIGH confidence behavior: zero conversational overhead, proceed directly to Auto-Classify.
+**Echo Gate** — MEDIUM confidence behavior: one-liner echo to confirm understanding, then classify.
+**Question Gate** — LOW confidence behavior: one targeted question, then classify. Fallback to oh-planner on no answer.
+**1 Exchange** — One user response to one orchestrator prompt. The gate is bounded to exactly 0 (HIGH) or 1 (MEDIUM/LOW) exchanges.
+**Signal** — Evidence in user input used to evaluate confidence across 6 axes (domain vocabulary, deliverable clarity, scope, ambiguity, file reference, domain count).
+
 ## Relationships
 - OpenHermes contains many Skills, Commands, Agents, and Instructions.
 - Skills are invoked on demand.
@@ -15,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/README.md

@@ -1,11 +1,11 @@
 <p align="center">
   <h1 align="center">⟳ OpenHermes</h1>
-  <p align="center"><b>Closed loop. Zero permission.</b><br>
-  <i>The AI orchestrator that never asks "should I continue?" — it just routes.</i></p>
+  <p align="center"><b>Pragmatic. Task-focused. Concise.</b><br>
+  <i>The AI orchestrator that never stalls — it classifies, delegates, and routes.</i></p>
 </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.1"></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>
@@ -17,7 +17,7 @@
 
 OpenHermes doesn't.
 
-Drop it into OpenCode. Get a self-driving pipeline: auto-classify every request, delegate to specialists, route results automatically. No "can I?", no "shall I?", no "what next?" — just execution until the job is done.
+Drop it into OpenCode. Get a closed-loop pipeline: auto-classify every request, delegate to specialists, route results automatically. No "can I?", no "shall I?", no "what next?" — just concise execution until the job is done.
 
 ```json
 { "plugin": ["openhermes@git+https://github.com/nathwn12/openhermes.git"] }
@@ -31,36 +31,37 @@ 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. |
+| **Test Harness** | Disposable temp dirs (Symbol.asyncDispose), factory builders, restore-capable mocks. Professional-grade test utilities. |
 
 ---
 
-### Three safety layers
+### Four safety layers
 
 The loop runs unsupervised because these never turn off:
 
-- **🔁 Loop Guard** — stops if the same skill fires 3+ times or 5+ hops produce no progress
+- **🔁 Loop Guard** — stops if the same skill fires 5+ times or 8+ hops produce no progress
 - **❓ Question Gate** — never routes into uncertainty; surfaces if input is missing
+- **💬 Confidence Gate** — calibrates whether to skip, echo, or ask before classifying
+
+```
+  HIGH  ──→ classify silently (transparent gate)
+  MEDIUM ──→ echo + confirm, then classify
+  LOW   ──→ ask + classify (defaults to oh-planner)
+```
+
 - **📋 Auto-Handoff** — writes a structured session artifact before context switches
 
 ---
@@ -69,15 +70,16 @@ 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. |
-| **29 specialist skills** | Planning → building → testing → security → review → shipping → retro. Every dev cycle phase. |
+| **Self-driving loop** | Type once. OpenHermes classifies, delegates, and routes — no pauses, no asking permission, no verbosity. |
+| **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/`. 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. |
-| **Shared operating model** | CONSTITUTION + RUNTIME + CONTEXT + ETHOS injected every session. Every interaction grounded in the same rules. |
-| **Plan file storage** | `~/.local/share/opencode/openhermes/plans/`. 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/openhermes/plans/`. Survives `npm update`. |
+| **8 internal subsystems** | Compositor, hooks, memory, recovery, sync, sanity checks, background commands, test harness — all native Node.js / TypeScript. |
+| **Zero npm dependency additions** | All new subsystems use native Node.js and TypeScript only. No new packages. |
 
-## 29 skills — three tiers
+## 30 skills — three tiers
 
 ### Tier 4 — Pipeline orchestrators
 Full multi-phase workflows:
@@ -95,20 +97,23 @@ Span multiple phases and coordinate other skills:
 
 | Skill | Purpose |
 |---|---|
-| **oh-planner** | Brainstorm, architect, autoplan, decision pipeline |
+| **oh-browser** | Browser automation via agent-browser CLI. Navigate pages, fill forms, take screenshots, scrape data, test web apps. |
 | **oh-grill** | Stress-test plans through relentless Socratic questioning |
 | **oh-plan-review** | Multi-lens review: Engineering, Design, DX, Strategy |
+| **oh-planner** | Brainstorm, architect, autoplan, decision pipeline |
 | **oh-security** | Audit: secrets, supply chain, CI/CD, OWASP, LLM security |
 | **oh-refactor** | Surgical behavior-preserving refactoring |
 | **oh-review** | Two-axis review (Standards + Spec) in parallel sub-agents |
 | **oh-fusion** | Skill ingestion pipeline: discover → analyze → adapt → fuse → integrate |
 | **oh-retro** | Weekly retrospective — analyze commit history and patterns |
+| **oh-worktree** | Workspace isolation via git worktrees. Detect existing isolation, create isolated workspaces, run project setup, verify clean baseline. |
 
 ### Tier 2 — Focused skills
 Single-purpose, one thing well:
 
 | Skill | Purpose |
 |---|---|
+| **oh-ascii** | Complete ASCII diagramming: design patterns, generation, structural validation |
 | **oh-expert** | AI self-diagnosis: sycophancy, hallucination, attention dynamics |
 | **oh-full-output** | Override truncation, ban placeholders, enforce complete generation |
 | **oh-health** | Code quality dashboard: tools, composite score, trend |
@@ -119,9 +124,7 @@ Single-purpose, one thing well:
 | **oh-triage** | Issue triage state machine — classify, prioritise, assign |
 | **oh-issue** | Break a plan/spec/PRD into independently-grabbable issues |
 | **oh-prd** | Conversation → PRD → GitHub issue |
-| **oh-caveman** | Ultra-compressed mode — cut token usage ~75% |
 | **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 |
@@ -137,17 +140,26 @@ openhermes-pkg/
 ├── ETHOS.md               # Operating principles
 ├── bootstrap.ts           # Plugin entry — registers everything
 ├── index.ts               # Package entrypoint
-├── lib/                   # harness-resolver.ts, logger.ts
 ├── harness/
 │   ├── agents/            # Agent manifests (OpenHermes primary)
-│   ├── codex/             # CONSTITUTION, AUTOPILOT, ROUTING
-│   ├── commands/          # Slash commands (/oh-doctor, /oh-log)
-│   ├── instructions/      # RUNTIME.md
-│   └── skills/            # 29 skill SKILL.md files
+│   ├── codex/             # CHARTER, AUTOPILOT
+│   ├── commands/          # Slash commands
+│   ├── 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
+│   │   ├── 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`
 
 ---
 
@@ -155,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.