@nathapp/nax 0.28.0 → 0.29.0

package/docs/releases/v0.15.0.md

@@ -1,502 +0,0 @@
-# Release Notes: v0.15.0
-
-**Release Date:** 2026-02-28
-**Type:** Feature Release + Architecture Refactor
-
-## Summary
-
-**Part 1: Interactive Pipeline Core (US-001 through US-004)**
-
-Implemented the foundation for interactive decision gates, user prompts, and pause/resume workflows. This enables nax to ask for user approval at critical points (security reviews, cost limits, merge gates) and persist state for long-running feature development.
-
-**Part 2: Execution Module Refactor (Phase 1 + 2 + 3)**
-
-Complete re-architecture of the execution module. Extracted god-file logic from `runner.ts` (1,638 lines) into focused sub-modules within new `lifecycle/` and `escalation/` subdirectories. Phase 1 extracted escalation and reporter notification logic. Phase 2 extracted sequential executor and initialization. **Phase 3 achieved <400 line target by extracting all remaining concerns.**
-
-## Part 1: Interactive Pipeline Core
-
-### US-001: Interaction Plugin Interface + Types
-
-**New Directory:** `src/interaction/`
-
-```typescript
-// Core types
-interface InteractionRequest {
-  id: string;                    // e.g. 'ix-US003-review-1'
-  type: 'confirm' | 'choose' | 'input' | 'review' | 'notify' | 'webhook';
-  stage: 'pre-flight' | 'execution' | 'review' | 'merge' | 'cost' | 'custom';
-  summary: string;               // human-readable question
-  fallback: 'continue' | 'skip' | 'escalate' | 'abort';
-  // ... metadata, options, timeout
-}
-
-interface InteractionResponse {
-  requestId: string;
-  action: 'approve' | 'reject' | 'choose' | 'input' | 'skip' | 'abort';
-  value?: string;
-  respondedBy?: string;
-  // ...
-}
-
-interface InteractionPlugin {
-  name: string;
-  send(request: InteractionRequest): Promise<void>;
-  receive(requestId: string, timeout?: number): Promise<InteractionResponse>;
-  init?(config: Record<string, unknown>): Promise<void>;
-  destroy?(): Promise<void>;
-}
-```
-
-**Files:**
-- `src/interaction/types.ts` — Core types, trigger metadata
-- `src/interaction/chain.ts` — Plugin chain with priority and fallback cascade
-- `src/interaction/index.ts` — Barrel exports
-
-### US-002: CLI Plugin (Default)
-
-**File:** `src/interaction/plugins/cli.ts`
-
-- Default plugin for non-headless mode
-- Reads from stdin using readline
-- Supports `confirm`, `choose`, `input`, `review` types
-- Timeout handling with fallback to configured behavior
-
-### US-003: State Persistence (Pause/Resume)
-
-**File:** `src/interaction/state.ts`
-
-- `serializeRunState()` — Save run state to `nax/features/<name>/run-state.json`
-- `deserializeRunState()` — Load and resume from paused state
-- `savePendingInteraction()` — Persist pending interactions to `interactions/` directory
-- Support for `--force-resume` flag (future integration)
-
-### US-004: Built-in Triggers + Hook Extension
-
-**File:** `src/interaction/triggers.ts`
-
-**8 Built-in Triggers:**
-
-| Trigger | Fallback | Safety | Use Case |
-|:--------|:---------|:-------|:---------|
-| `security-review` | abort | red | Critical security issues found |
-| `cost-exceeded` | abort | red | Cost limit exceeded |
-| `merge-conflict` | abort | red | Merge conflict detected |
-| `cost-warning` | escalate | yellow | Approaching cost limit |
-| `max-retries` | skip | yellow | Max retries reached |
-| `pre-merge` | escalate | yellow | Before merging to main |
-| `story-ambiguity` | continue | green | Story requirements unclear |
-| `review-gate` | continue | green | Code review checkpoint |
-
-**Hook Extension:**
-
-Extended `HookDef` interface to support interaction field:
-
-```typescript
-interface HookDef {
-  command: string;
-  interaction?: {
-    type: "confirm" | "choose" | "input" | "review" | "notify";
-    summary: string;  // supports {{variable}} syntax
-    fallback: "continue" | "skip" | "escalate" | "abort";
-    timeout?: number;
-  };
-}
-```
-
-**Config Integration:**
-
-Added `interaction` config to `NaxConfig`:
-
-```json
-{
-  "interaction": {
-    "plugin": "cli",
-    "config": {},
-    "defaults": {
-      "timeout": 600000,
-      "fallback": "escalate"
-    },
-    "triggers": {
-      "security-review": true,
-      "cost-warning": true
-    }
-  }
-}
-```
-
-## Part 2: Execution Module Refactor
-
-### New Directory Structure
-
-```
-src/execution/
-  lifecycle/
-    acceptance-loop.ts         — acceptance retry loop (272 lines)
-    precheck-runner.ts         — precheck validation (101 lines)
-    run-initialization.ts      — agent check, state reconciliation (141 lines)
-    run-lifecycle.ts           — setup/teardown orchestration (307 lines)
-    run-setup.ts               — initial setup phase (177 lines)
-    run-completion.ts          — final metrics and status (122 lines)
-    run-cleanup.ts             — finally block cleanup (67 lines)
-    headless-formatter.ts      — headless output formatting (88 lines)
-    parallel-lifecycle.ts      — parallel completion handling (97 lines)
-    story-hooks.ts             — reporter notification helpers
-    index.ts                   — barrel exports
-  escalation/
-    escalation.ts              — tier escalation helpers
-    tier-escalation.ts         — pre-iteration checks + tier handling
-    index.ts                   — barrel exports
-  sequential-executor.ts       — sequential story execution loop (648 lines)
-  parallel-executor.ts         — parallel execution wrapper (213 lines)
-  runner.ts                    — thin orchestrator (366 lines)
-```
-
-### Phase 1: Escalation + Lifecycle Extraction
-
-1. **`lifecycle/story-hooks.ts`** (new)
-   - `emitStoryComplete()` — centralized reporter notification
-   - Eliminates 4+ duplicated reporter emission blocks
-
-2. **`escalation/tier-escalation.ts`** (new)
-   - `resolveMaxAttemptsOutcome()` — pause vs fail decision logic
-   - `preIterationTierCheck()` — pre-iteration budget validation
-   - `handleTierEscalation()` — pipeline escalation handler (203 lines)
-
-3. **Moved modules to subdirectories:**
-   - `lifecycle/run-lifecycle.ts`
-   - `lifecycle/acceptance-loop.ts`
-   - `escalation/escalation.ts`
-
-### Phase 2: Sequential Executor + Initialization Extraction
-
-4. **`sequential-executor.ts`** (new)
-   - `executeSequential()` — main sequential execution loop
-   - Story selection, pipeline invocation, result handling
-   - Heartbeat management, progress tracking
-   - Extracted ~700 lines from runner.ts
-
-5. **`lifecycle/precheck-runner.ts`** (new)
-   - `runPrecheckValidation()` — precheck execution before run starts
-   - Validates project state, dependencies, configuration
-   - Blocks on Tier 1 failures, warns on Tier 2 failures
-   - Extracted ~70 lines from runner.ts
-
-6. **`lifecycle/run-initialization.ts`** (new)
-   - `initializeRun()` — agent check, state reconciliation, limits validation
-   - `reconcileState()` — marks failed stories with git commits as passed
-   - `checkAgentInstalled()` — validates agent binary availability
-   - `validateStoryCount()` — enforces maxStoriesPerFeature limit
-   - Extracted ~45 lines from runner.ts
-
-### Phase 3: Runner.ts Under 400 Lines
-
-7. **`lifecycle/run-setup.ts`** (new)
-   - `setupRun()` — complete initial setup phase
-   - Status writer initialization, PID registry, crash handlers
-   - Lock acquisition, plugin loading, precheck validation
-   - Run initialization orchestration
-   - Extracted ~100 lines from runner.ts
-
-8. **`lifecycle/run-completion.ts`** (new)
-   - `handleRunCompletion()` — final metrics and status updates
-   - Save run metrics, log completion summary
-   - Update final status with per-story metrics
-   - Extracted ~50 lines from runner.ts
-
-9. **`lifecycle/run-cleanup.ts`** (new)
-   - `cleanupRun()` — finally block cleanup operations
-   - Reporter onRunEnd notifications, plugin teardown
-   - Lock release
-   - Extracted ~35 lines from runner.ts
-
-10. **`lifecycle/headless-formatter.ts`** (new)
-    - `outputRunHeader()` — headless mode run header
-    - `outputRunFooter()` — headless mode run summary
-    - Extracted ~45 lines from runner.ts (with deduplication)
-
-11. **`lifecycle/parallel-lifecycle.ts`** (new)
-    - `handleParallelCompletion()` — parallel execution completion
-    - Metrics saving and reporter notifications
-    - Extracted ~30 lines from runner.ts
-
-12. **`parallel-executor.ts`** (new)
-    - `runParallelExecution()` — complete parallel execution flow
-    - Status updates, parallel story execution, completion handling
-    - Extracted ~130 lines from runner.ts
-
-## Impact
-
-### Interactive Pipeline Core
-
-- **New Capability:** Decision gates and user prompts during execution
-- **Pause/Resume:** State persistence for long-running features
-- **Safety Tiers:** Red/yellow/green classification for trigger severity
-- **Extensible:** Plugin architecture supports custom interaction backends (Slack, webhook, etc.)
-- **Hook Integration:** Hooks can now trigger interactive prompts via `interaction` field
-
-**Use Cases Unlocked:**
-- Pre-merge approval gates
-- Cost budget enforcement with user confirmation
-- Security review checkpoints
-- Story ambiguity clarification during execution
-- Long-running features with pause/resume across sessions
-
-### File Size Reduction
-
-- **Phase 1:** runner.ts: 1,638 → 1,428 lines (-210 lines, -13%)
-- **Phase 2:** runner.ts: 1,428 → 601 lines (-827 lines, -58%)
-- **Phase 3:** runner.ts: 601 → 366 lines (-235 lines, -39%)
-- **Total Reduction:** 1,638 → 366 lines (-1,272 lines, -78%)
-- **Target Achievement:** ✅ 366 lines is under the 400-line target (hard limit achieved)
-
-### Code Quality
-
-- **runner.ts now 366 lines** (under 400-line hard limit)
-- All lifecycle modules under 310 lines
-- Eliminated duplicated code (reporter notifications, output formatting, metrics saving)
-- Centralized all concerns (escalation, precheck, initialization, setup, completion, cleanup)
-- All existing tests pass
-- No lint violations
-- No logic changes — pure structural refactor
-
-### Modular Benefits
-
-- **runner.ts is now a thin orchestrator** — delegates all concerns to focused modules
-- **Setup phase** fully encapsulated in run-setup.ts
-- **Completion phase** fully encapsulated in run-completion.ts
-- **Cleanup phase** fully encapsulated in run-cleanup.ts
-- **Parallel execution** fully encapsulated in parallel-executor.ts
-- **Sequential execution** fully encapsulated in sequential-executor.ts
-- **Headless formatting** reusable across execution paths
-- All modules independently testable
-
-## Testing
-
-- **Test Suite:** ✓ All tests pass
-- **Integration Tests:** ✓ runner.test.ts (62 tests passing)
-- **Lint:** ✓ No violations (`bun x biome check src/`)
-- **Type Check:** ✓ Passes
-
-## Breaking Changes
-
-**None.** All exports re-exported from new modules for backward compatibility.
-
-## Migration Guide
-
-No migration required. All existing imports continue to work via barrel exports.
-
-## Architecture Achievement
-
-**Target achieved:** runner.ts reduced from 1,638 lines to 366 lines (78% reduction).
-
-The 400-line hard limit is now met. runner.ts is a true thin orchestrator that:
-- Delegates setup to run-setup.ts
-- Delegates parallel execution to parallel-executor.ts
-- Delegates sequential execution to sequential-executor.ts
-- Delegates completion to run-completion.ts
-- Delegates cleanup to run-cleanup.ts
-
-No further extraction needed. All files are under 650 lines (most under 400).
-
----
-
-## Part 3: Interactive Pipeline Phase 2 (US-005 through US-009)
-
-### US-005: Telegram Plugin
-
-**File:** `src/interaction/plugins/telegram.ts`
-
-- Sends interaction requests via Telegram Bot API with inline keyboard buttons
-- Polls for callback query (button click) or reply message responses
-- Config: `{ botToken, chatId }` (supports env vars: `NAX_TELEGRAM_TOKEN`, `NAX_TELEGRAM_CHAT_ID`)
-- Timeout handling with graceful expiration message (editMessageText)
-- Formatting: emoji headers, feature/story/stage context, inline keyboard rows
-
-**Example:**
-
-```typescript
-const plugin = new TelegramInteractionPlugin();
-await plugin.init({
-  botToken: process.env.NAX_TELEGRAM_TOKEN,
-  chatId: process.env.NAX_TELEGRAM_CHAT_ID,
-});
-
-await plugin.send(request);
-const response = await plugin.receive(request.id, 60000);
-```
-
-### US-006: `nax interact` CLI
-
-**File:** `src/cli/interact.ts`
-
-**Commands:**
-
-1. **`nax interact list -f <feature>`** — List pending interactions
-   - Shows requestId, type, stage, summary, timeout countdown
-   - JSON output mode with `--json`
-
-2. **`nax interact respond <id> --action approve|reject|choose|input --value <val>`** — Respond to interaction
-   - Validates action matches request type
-   - Saves response to `responses/<id>.json`
-   - Deletes pending interaction
-
-3. **`nax interact cancel <id>`** — Cancel with fallback
-   - Applies configured fallback behavior
-   - Saves response and cleans up
-
-**Example:**
-
-```bash
-# List pending interactions
-nax interact list -f my-feature
-
-# Respond to confirm request
-nax interact respond ix-US003-review-1 --action approve
-
-# Respond to choose request
-nax interact respond ix-choice-1 --action choose --value option-a
-
-# Cancel with fallback
-nax interact cancel ix-timeout-1
-```
-
-### US-007: Webhook Plugin
-
-**File:** `src/interaction/plugins/webhook.ts`
-
-- Sends HTTP POST InteractionRequest JSON to configured URL
-- Starts local HTTP server to receive callback at `/nax/interact/:requestId`
-- HMAC-SHA256 signature verification (header: `X-Nax-Signature`)
-- Auto-shutdown server after response or timeout
-- Config: `{ url, callbackPort?, secret? }`
-
-**Example:**
-
-```typescript
-const plugin = new WebhookInteractionPlugin();
-await plugin.init({
-  url: "https://my-app.com/nax/webhook",
-  callbackPort: 8765,
-  secret: "my-hmac-secret",
-});
-```
-
-### US-008: Auto AI Responder Plugin
-
-**File:** `src/interaction/plugins/auto.ts`
-
-- Automatically responds to interactions using LLM decision-making
-- Confidence threshold (default: 0.7) — escalates to human if confidence < threshold
-- Safety rule: **NEVER** auto-approves `security-review` (hardcoded)
-- Config: `{ model?, confidenceThreshold?, maxCostPerDecision? }`
-
-**Decision Prompt:**
-
-```
-You are an AI decision assistant for a code orchestration system.
-
-## Rules
-1. For "red" safety tier (security-review, cost-exceeded, merge-conflict): ALWAYS return confidence 0
-2. For "yellow" safety tier (cost-warning, max-retries, pre-merge): High confidence (0.8+) ONLY if clearly safe
-3. For "green" safety tier (story-ambiguity, review-gate): Can approve with moderate confidence (0.6+)
-4. Never auto-approve security issues
-
-Respond with JSON: {"action":"...","value":"...","confidence":0.0-1.0,"reasoning":"..."}
-```
-
-**Example:**
-
-```typescript
-const plugin = new AutoInteractionPlugin();
-await plugin.init({
-  model: "fast",
-  confidenceThreshold: 0.7,
-  naxConfig: config,
-});
-
-const response = await plugin.decide(request);
-// Returns undefined if confidence < threshold or security-review
-```
-
-### US-009: `nax status` Enhancement
-
-**File:** `src/cli/status.ts`
-
-**New Features:**
-
-- Shows paused state with pending interaction details
-- Timeout countdown display (seconds remaining or EXPIRED)
-- Fallback action and safety category indicator (🔴/🟡/🟢)
-- Hint to respond with `nax interact respond` command
-
-**Example Output:**
-
-```
-📊 my-feature
-
-⏸️  Paused — Waiting for Interaction (2 pending)
-
-   🔴 trigger-security-review-1709234567890
-      Type:     confirm
-      Summary:  Security review failed — abort execution?
-      Fallback: abort
-      Timeout:  543s remaining
-
-   🟡 trigger-cost-warning-1709234567891
-      Type:     confirm
-      Summary:  Cost warning: $2.50 / $5.00 — escalate to higher tier?
-      Fallback: escalate
-      Timeout:  EXPIRED
-
-   💡 Respond with: nax interact respond <id> --action approve|reject|skip|abort
-
-⚡ Active Run:
-   Run ID:     run-20260228T120000
-   PID:        12345
-   Progress:   3/5 stories
-   Cost:       $2.50
-```
-
-## Impact
-
-### New Plugins
-
-- **Telegram:** Remote interaction via Telegram Bot API
-- **Webhook:** HTTP-based integration for custom backends
-- **Auto:** AI-powered automatic responses (with safety guardrails)
-
-### CLI Improvements
-
-- **`nax interact list`** — View pending interactions
-- **`nax interact respond`** — Respond from CLI
-- **`nax interact cancel`** — Cancel with fallback
-- **`nax status`** — Shows paused state and interaction details
-
-### Safety Features
-
-- Auto plugin never auto-approves security-review (hardcoded safety rule)
-- Confidence threshold prevents low-confidence auto-approvals
-- Safety tier indicators (red/yellow/green) in status display
-- Timeout countdown for time-sensitive decisions
-
-## Testing
-
-- **Unit Tests:** `test/unit/interaction-plugins.test.ts` (10 tests passing)
-- **All Tests:** ✓ New tests pass, pre-existing failures unrelated to changes
-- **Lint:** ✓ No violations (`bun x biome check src/`)
-- **Type Check:** ✓ No new errors
-
-## Future Work
-
-**US-010:** Runner integration — wire triggers into pipeline stages
-**US-011:** TUI integration for interactive prompts in TUI mode
-**US-012:** Slack plugin for team-based approval workflows
-
----
-
-**Commits:**
-- Interactive Pipeline Phase 1: `feat(interaction): implement interactive pipeline core (US-001 through US-004)`
-- Interactive Pipeline Phase 2: `feat(interaction): implement Telegram, webhook, auto plugins + interact CLI (US-005 through US-009)`
-- Phase 1: `refactor(execution): split runner.ts god file into focused sub-modules`
-- Phase 2: `refactor(execution): Phase 2 — extract sequential/parallel executors, complete runner.ts split`
-- Phase 3: `refactor(execution): Phase 3 — runner.ts under 400 lines`

package/docs/releases/v0.15.1.md

@@ -1,170 +0,0 @@
-# v0.15.1 — Architectural Compliance + Security Hardening
-
-**Release Date:** 2026-02-28
-**Type:** Patch
-**Breaking Changes:** None
-
----
-
-## Overview
-
-This release resolves all critical findings from the v0.15.0 code review. The primary focus is architectural compliance (enforcing the 400-line file limit) and security hardening for the interaction plugin system.
-
----
-
-## Changes
-
-### ARCH-001: File Size Compliance (CRITICAL)
-
-**Issue:** 14 files exceeded the 400-line hard limit mandated by CLAUDE.md.
-
-**Resolution:** All files have been split into smaller, cohesive modules:
-
-| Original File | Lines | Split Into | Result |
-|:---|---:|:---|:---|
-| `config/schema.ts` | 853 | `types.ts` + `schemas.ts` + `defaults.ts` + barrel | ✅ All under 400 |
-| `agents/claude.ts` | 820 | `claude.ts` + `claude-decompose.ts` + `claude-plan.ts` | ✅ All under 400 |
-| `agents/types.ts` | 430 | `types.ts` + `types-extended.ts` | ✅ All under 400 |
-| `tdd/orchestrator.ts` | 743 | `orchestrator.ts` + `session-runner.ts` + `rectification-gate.ts` | ✅ All under 400 |
-| `execution/sequential-executor.ts` | 648 | `sequential-executor.ts` + `pipeline-result-handler.ts` | ✅ All under 400 |
-| `cli/diagnose.ts` | 638 | `diagnose.ts` + `diagnose-analysis.ts` + `diagnose-formatter.ts` | ✅ All under 400 |
-| `execution/post-verify.ts` | 584 | `post-verify.ts` + `post-verify-rectification.ts` | ✅ All under 400 |
-| `context/builder.ts` | 576 | `builder.ts` + `elements.ts` + `formatter.ts` | ✅ All under 400 |
-| `cli/analyze.ts` | 568 | `analyze.ts` + `analyze-parser.ts` | ✅ All under 400 |
-| `precheck/checks.ts` | 548 | barrel + `checks-blockers.ts` + `checks-warnings.ts` | ✅ All under 400 |
-| `cli/status.ts` | 519 | barrel + `status-cost.ts` + `status-features.ts` | ✅ All under 400 |
-| `execution/helpers.ts` | 450 | barrel + `story-context.ts` + `lock.ts` | ✅ All under 400 |
-| `execution/escalation/tier-escalation.ts` | 439 | `tier-escalation.ts` + `tier-outcome.ts` | ✅ All under 400 |
-| `routing/strategies/llm.ts` | 432 | `llm.ts` + `llm-prompts.ts` | ✅ All under 400 |
-
-**Backward Compatibility:** All split files use barrel re-exports. No external import paths were broken.
-
-**Verification:**
-```bash
-find src/ -name '*.ts' -exec wc -l {} + | awk '$1 > 400 { print }'
-# Output: (empty) — all files under 400 lines
-```
-
----
-
-### SEC-001: Webhook Payload Security (CRITICAL)
-
-**Issue:** Webhook plugin did not enforce payload size limit. Malicious actors could send multi-GB JSON payloads to exhaust memory.
-
-**Resolution:**
-- Added `maxPayloadBytes` config option (default: 1MB)
-- Enforced payload size limit via `Content-Length` header check
-- Added fallback body size check for requests without `Content-Length`
-- Returns `413 Payload Too Large` for oversized requests
-
-**Error Message Sanitization:**
-- Previously: `Bad Request: Invalid response format (${err.message})` (leaks Zod validation errors)
-- Now: `Bad Request: Invalid response format` (sanitized, no leak)
-
-**Files Changed:**
-- `src/interaction/plugins/webhook.ts`
-
----
-
-### SEC-002/SEC-003: Telegram Network Error Handling + Exponential Backoff (CRITICAL)
-
-**Issue:** Telegram plugin had no error handling for network failures in `getUpdates()`. On network errors, the plugin would:
-1. Return empty updates (correct)
-2. Immediately retry at 1-second intervals (incorrect — hammers failing API)
-3. Use `console.error` instead of proper logging (information leakage risk)
-
-**Resolution:**
-- Added exponential backoff to `getUpdates()` polling:
-  - Initial backoff: 1 second
-  - Max backoff: 30 seconds
-  - Backoff resets on successful API call
-- Removed all `console.error` calls (fire-and-forget errors are silently dropped)
-- `answerCallbackQuery()` and `sendTimeoutMessage()` remain fire-and-forget (non-critical operations)
-
-**Files Changed:**
-- `src/interaction/plugins/telegram.ts`
-
----
-
-### TEST-001: Network Failure Test Coverage (MEDIUM)
-
-**Issue:** No tests for network failures, malformed responses, or timeout edge cases.
-
-**Resolution:** Added comprehensive test suite:
-
-**New Test File:** `test/unit/interaction-network-failures.test.ts` (15 tests, 100% pass)
-
-**Test Coverage:**
-- **Telegram Plugin:**
-  - Network error in `send()` (connection refused)
-  - Malformed API response (invalid JSON)
-  - HTTP error status (500)
-  - Network failure in `getUpdates()` (returns empty updates)
-  - Exponential backoff on consecutive failures
-  - Backoff reset on success
-- **Webhook Plugin:**
-  - Network error in `send()` (connection refused)
-  - HTTP error in `send()` (503)
-  - Exponential backoff in `receive()` polling
-  - Payload size limit enforcement (via `Content-Length`)
-  - Payload size limit enforcement (via actual body size)
-  - Malformed JSON rejection (sanitized error message)
-  - Invalid schema rejection (sanitized error message)
-  - Missing HMAC signature rejection
-  - Invalid HMAC signature rejection
-
----
-
-## Schema Validation
-
-**InteractionConfig Zod Schema:** Already present and correct (lines 663-683 in `config/schemas.ts`). No changes needed.
-
----
-
-## Test Results
-
-**Full Test Suite:**
-```bash
-bun test --timeout=60000
-```
-
-**Results:**
-- ✅ 1775 pass
-- ⏭ 10 skip
-- ❌ 56 fail (all pre-existing, unrelated to v0.15.1 changes)
-
-**New Tests:**
-- ✅ 15 pass (`test/unit/interaction-network-failures.test.ts`)
-- ✅ 10 pass (`test/unit/interaction-plugins.test.ts` — existing tests, still passing)
-
----
-
-## Migration Guide
-
-No migration needed. This is a pure patch release with backward-compatible structural refactoring and security hardening.
-
-**If you use webpack/rollup/esbuild:** The file splits may slightly increase bundle size due to additional module boundaries. In practice, tree-shaking should eliminate any overhead.
-
-**If you import from deep paths:**
-- ✅ `import { NaxConfig } from "@nathapp/nax/config"` — still works (barrel re-exports)
-- ✅ `import { ClaudeCodeAdapter } from "@nathapp/nax/agents"` — still works
-- ✅ All public APIs unchanged
-
----
-
-## Contributors
-
-- Claude Sonnet 4.5 (code-reviewer agent)
-- Claude Opus 4.6 (refactor-cleaner agent)
-- William (review)
-
----
-
-## Next Steps
-
-See [ROADMAP.md](../ROADMAP.md) for v0.16.0 planning.
-
-**Immediate Backlog:**
-- Add Prometheus metrics for interaction plugin success/failure rates
-- Implement plugin fallback cascade (REL-001 from code review — deferred to v0.16.0)
-- Add LLM call mocking for Auto plugin tests (TEST-002 from code review)