@nathapp/nax 0.18.1

package/docs/releases/v0.15.3.md

@@ -0,0 +1,193 @@
+# nax v0.15.3 Release Notes
+
+**Release Date**: 2026-02-28
+**Type**: Minor Feature Release
+
+## Overview
+
+This release ships two major features:
+1. **US-010**: Constitution-to-Agent-Config Generator — Auto-generate agent-specific config files from `nax/constitution.md`
+2. **US-008**: Interaction System Wiring — Integrate the interaction system into the runner loop
+
+---
+
+## New Features
+
+### US-010: Constitution-to-Agent-Config Generator
+
+The `nax/constitution.md` file is now the **single source of truth** for project coding standards. nax automatically generates agent-specific config files from it.
+
+**What's New:**
+- New `nax constitution generate` CLI command
+- Support for 5 agent formats:
+  - Claude Code (`CLAUDE.md`)
+  - OpenCode/Codex (`AGENTS.md`)
+  - Cursor (`.cursorrules`)
+  - Windsurf (`.windsurfrules`)
+  - Aider (`.aider.conf.yml`)
+- Dry-run mode for testing generation without writing files
+- Automatic file freshness checking
+
+**Usage:**
+
+```bash
+# Generate config files for all agents
+nax constitution generate
+
+# Generate for specific agent
+nax constitution generate --agent claude
+
+# Dry-run mode (preview without writing)
+nax constitution generate --dry-run
+
+# Custom paths
+nax constitution generate --constitution custom/path.md --output dist/
+```
+
+**Implementation Details:**
+- **Generators**: `src/constitution/generators/` — One generator per agent format
+- **Orchestrator**: `src/constitution/generator.ts` — Coordinates all generators
+- **CLI Command**: `src/cli/constitution.ts` — User-facing command
+- **Tests**: `test/unit/constitution-generators.test.ts` — 17 passing tests
+
+**Files Modified/Created:**
+- `src/constitution/generators/types.ts` (new)
+- `src/constitution/generators/claude.ts` (new)
+- `src/constitution/generators/opencode.ts` (new)
+- `src/constitution/generators/cursor.ts` (new)
+- `src/constitution/generators/windsurf.ts` (new)
+- `src/constitution/generators/aider.ts` (new)
+- `src/constitution/generator.ts` (new, 191 lines)
+- `src/cli/constitution.ts` (new, 109 lines)
+- `bin/nax.ts` (modified to register command)
+
+---
+
+### US-008: Interaction System Wiring
+
+The interaction system (v0.15.0) is now fully integrated into the runner loop.
+
+**What's New:**
+- Interaction chain initialized at runner startup
+- Support for headless mode (skips interactions)
+- Automatic cleanup of interaction plugins on shutdown
+- Ready for trigger integration (security-review, cost-warning, pre-merge, max-retries, etc.)
+
+**Implementation Details:**
+- **Initialization**: `src/interaction/init.ts` — Creates interaction chain from config
+- **Runner Integration**: `src/execution/lifecycle/run-setup.ts` — Initializes chain during setup
+- **Cleanup**: `src/execution/lifecycle/run-cleanup.ts` — Destroys chain on shutdown
+- **Runner Context**: `src/execution/runner.ts` — Passes chain through execution pipeline
+
+**Files Modified:**
+- `src/interaction/init.ts` (new, 83 lines)
+- `src/interaction/index.ts` (exports `initInteractionChain`)
+- `src/execution/lifecycle/run-setup.ts` (modified to initialize chain)
+- `src/execution/lifecycle/run-cleanup.ts` (modified to destroy chain)
+- `src/execution/runner.ts` (modified to extract and pass chain)
+
+**Configuration:**
+
+Interaction config in `nax/config.json`:
+```json
+{
+  "interaction": {
+    "plugin": "cli",
+    "defaults": {
+      "timeout": 600000,
+      "fallback": "escalate"
+    },
+    "triggers": {
+      "security-review": true,
+      "cost-warning": true,
+      "pre-merge": true,
+      "max-retries": true
+    }
+  }
+}
+```
+
+When running `--headless`, all interactions are skipped (fallbacks applied immediately).
+
+---
+
+## Breaking Changes
+
+None.
+
+---
+
+## Bug Fixes
+
+None.
+
+---
+
+## Documentation
+
+- Added `docs/releases/v0.15.3.md`
+- Updated `docs/ROADMAP.md` — marked US-008 and US-010 as complete
+
+---
+
+## Testing
+
+- **New Tests**: 17 constitution generator tests (all passing)
+- **Test Coverage**: All generators tested with known input/output
+- **Line Count Compliance**: All new files < 400 lines
+
+---
+
+## Migration Guide
+
+### For Constitution Generator (US-010)
+
+1. Ensure `nax/constitution.md` exists in your project
+2. Run `nax constitution generate` to create agent config files
+3. Commit generated files to version control
+4. Optional: Add generation to CI pipeline
+
+### For Interaction System (US-008)
+
+1. No action required — system initializes automatically if configured
+2. To enable interactions, add `interaction` section to `nax/config.json`
+3. To disable interactions, omit `interaction` section or run with `--headless`
+
+---
+
+## What's Next
+
+- **v0.15.4+**: Wire trigger checkpoints into pipeline stages
+  - Pre-flight security review
+  - Cost gates (warning + exceeded)
+  - Pre-merge approval
+  - Max retries handling
+
+---
+
+## Contributors
+
+- Claude Opus 4.6 <noreply@anthropic.com>
+
+---
+
+## Install
+
+```bash
+# From NPM (when published)
+npm install -g @nathapp/nax@0.15.3
+
+# From source
+git clone https://github.com/nathapp/nax.git
+cd nax
+git checkout v0.15.3
+bun install
+bun run build
+npm install -g .
+```
+
+---
+
+## Changelog
+
+Full changelog: https://github.com/nathapp/nax/compare/v0.15.1...v0.15.3