dual-brain 4.0.0 → 4.0.1

package/CLAUDE.md

@@ -64,18 +64,49 @@ Profile persists to `.claude/dual-brain.profile.json` (gitignored).
 Switch profiles: `npx dual-brain mode cost-saver`
 Check status: `npx dual-brain status`
 
+Natural language aliases work everywhere: "go aggressive", "be careful", "cheap mode", "fast", "thorough", "smart". The system strips prefixes like "go"/"be"/"use" and resolves to the canonical profile name.
+
 ## Adaptive Routing (Auto Mode)
 
 Auto mode classifies risk from file paths and adjusts routing in real-time:
 
 - **Risk classification**: auth/secrets→critical, billing/migrations→high, tests/utils→medium, docs→low
-- **Failure detection**: 2+ failures on same prompt in 2 hours → auto-escalate tier or trigger dual-brain
+- **Failure detection**: 2+ failures on same prompt in 2 hours → auto-escalate tier or trigger dual-brain. Uses time-weighted decay (recent failures count more) and ledger pruning for entries >24hrs.
 - **Provider balance**: Routes to underused provider when one subscription is hot
+- **Burst awareness**: Suppresses duplicate warnings and balance hints during agent waves (3+ agents in 90s)
+
+## Vibe Coding
+
+Casual natural language → structured work. The vibe coding system translates informal requests into properly routed, risk-classified, quality-gated work.
+
+**Intent compiler** — decompose multi-task requests:
+```bash
+node .claude/hooks/vibe-router.mjs "fix the login bug and also update the nav"
+```
+Returns structured tasks with tier/risk classification, complexity level, quality gates, and wave strategy.
+
+**Plan generator** — Steve-style 3-part markdown plans:
+```bash
+node .claude/hooks/plan-generator.mjs --utterance "..." [--write]
+```
+Generates: (1) dependency-ordered task table, (2) user stories + edge cases, (3) questions with suggested answers. Pass `--write` to save to `.claude/plans/`.
+
+**Durable memory** — preferences persist across sessions:
+```bash
+node .claude/hooks/vibe-memory.mjs                              # show state
+node .claude/hooks/vibe-memory.mjs --set preferences.risk_tolerance=careful
+node .claude/hooks/vibe-memory.mjs --threads                    # active work
+node .claude/hooks/vibe-memory.mjs --infer                      # preference suggestions
+```
+Tracks preferred profile, risk tolerance, active threads, and learns from usage patterns.
 
 ## Available Tools
 
+- `node .claude/hooks/vibe-router.mjs "..."` — decompose casual requests into structured work
+- `node .claude/hooks/plan-generator.mjs --utterance "..."` — generate execution plans
+- `node .claude/hooks/vibe-memory.mjs` — persistent preferences and work threads
 - `node .claude/hooks/cost-report.mjs` — activity and cost estimates
 - `node .claude/hooks/health-check.mjs` — verify system health
 - `node .claude/hooks/budget-balancer.mjs` — provider balance status
 - `node .claude/hooks/decision-ledger.mjs` — routing outcome insights
-- `node .claude/hooks/test-orchestrator.mjs` — run self-tests
+- `node .claude/hooks/test-orchestrator.mjs` — run self-tests (40 tests)

package/README.md

@@ -51,10 +51,35 @@ npx -y dual-brain
 
 **Dual-brain** is recommended automatically for high-risk decisions — hooks detect the risk level and suggest dual-brain analysis, where both providers think on the same problem independently.
 
+## Vibe Coding
+
+Speak naturally. The orchestrator handles the structure.
+
+```bash
+# Decompose a casual request into structured work
+node .claude/hooks/vibe-router.mjs "fix the login bug and also update the nav"
+
+# Generate a Steve-style execution plan
+node .claude/hooks/plan-generator.mjs --utterance "refactor the auth flow" --write
+
+# Switch profiles with natural language
+npx dual-brain mode "go aggressive"
+npx dual-brain mode "be careful"
+npx dual-brain mode "cheap"
+
+# Check persistent preferences and work threads
+node .claude/hooks/vibe-memory.mjs --threads
+```
+
+The vibe-router splits multi-task requests, classifies risk, assigns tiers, and recommends quality gates. The plan-generator produces 3-part plans (dependency-ordered tasks, user stories, questions with suggested answers). Vibe-memory learns your preferences over time.
+
 ## Scripts
 
 | Script | Purpose |
 |--------|---------|
+| `hooks/vibe-router.mjs` | Decompose casual language into structured work orders |
+| `hooks/plan-generator.mjs` | Generate Steve-style 3-part execution plans |
+| `hooks/vibe-memory.mjs` | Persistent preferences, work threads, preference inference |
 | `hooks/cost-report.mjs` | Activity & cost estimates by model tier |
 | `hooks/dual-brain-review.mjs` | Send git diff to GPT for independent review |
 | `hooks/dual-brain-think.mjs` | Dual-perspective analysis on architecture decisions |
@@ -63,7 +88,7 @@ npx -y dual-brain
 | `hooks/gpt-work-dispatcher.mjs` | Dispatch execution tasks to GPT via Codex CLI |
 | `hooks/session-report.mjs` | Session-end summary: activity, compliance, quality |
 | `hooks/health-check.mjs` | Verify all hooks and dependencies are working |
-| `hooks/test-orchestrator.mjs` | Self-test harness (39 tests) |
+| `hooks/test-orchestrator.mjs` | Self-test harness (40 tests) |
 | `hooks/setup-wizard.mjs` | Interactive config (optional — for custom plans) |
 | `hooks/install-git-hooks.mjs` | Git pre-commit hook for quality gate |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dual-brain",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "Dual-provider orchestration for Claude Code — tiered routing, budget balancing, and GPT dual-brain review across Claude + OpenAI subscriptions",
   "type": "module",
   "bin": {