@nathapp/nax 0.28.0 → 0.30.0

package/.claude/settings.json

@@ -1,15 +0,0 @@
-{
-  "hooks": {
-    "PostToolUse": [
-      {
-        "matcher": "Edit|Write",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bun x biome lint --write src/ bin/"
-          }
-        ]
-      }
-    ]
-  }
-}

package/.githooks/pre-commit

@@ -1,16 +0,0 @@
-#!/usr/bin/env bash
-# nax pre-commit hook — runs typecheck + lint
-# Install: git config core.hooksPath .githooks
-
-set -e
-
-# Ensure bun is on PATH (git hooks run with minimal PATH)
-export PATH="$HOME/.bun/bin:$PATH"
-
-echo "[pre-commit] Running typecheck..."
-bun run typecheck
-
-echo "[pre-commit] Running lint..."
-bun run lint
-
-echo "[pre-commit] OK"

package/.gitlab-ci.yml

@@ -1,103 +0,0 @@
-# .gitlab-ci.yml - nax CI/CD
-# Bun-native, single package (no turbo/monorepo)
-#
-# Triggers:
-#   - MR: test only (gate for merge)
-#   - [run-release] on master: test + release + notify
-#   - [run-prerelease] on non-master: test + canary release + notify
-#   - release-by-bot commits and tags: skipped entirely
-
-stages:
-  - test
-  - release
-  - notify
-
-# --- Stage: Test ---
-test:
-  stage: test
-  image: 
-    name: nathapp/node-bun:22.21.0-1.3.9-alpine
-    pull_policy: always
-  before_script:
-    - apk add --no-cache git 
-    - git config --global safe.directory '*'
-    - git config --global user.name "CI Runner"
-    - git config --global user.email "ci@nathapp.io"
-  cache:
-    key:
-      files:
-        - bun.lock
-    paths:
-      - node_modules/
-    policy: pull-push
-  script:
-    - bun install --frozen-lockfile
-    - bun run typecheck
-    - bun run lint
-    - bun run test
-  rules:
-    - if: '$CI_COMMIT_MESSAGE =~ /release-by-bot/ || $CI_COMMIT_TAG'
-      when: never
-    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
-    - if: '$CI_COMMIT_MESSAGE =~ /run-prerelease/ && $CI_COMMIT_BRANCH != $CI_DEFAULT_BRANCH'
-    - if: '$CI_COMMIT_MESSAGE =~ /run-release/ && $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'
-
-# --- Stage: Release ---
-release:
-  stage: release
-  image: 
-    name: nathapp/node-bun:22.21.0-1.3.9-alpine
-    pull_policy: always
-  cache:
-    key:
-      files:
-        - bun.lock
-    paths:
-      - node_modules/
-    policy: pull
-  variables:
-    NPM_REGISTRY: "//registry.npmjs.org/"
-    NPM_RELEASE_TOKEN: $NPM_TOKEN
-  before_script:
-    - apk add --no-cache git
-    - git config --global safe.directory '*'
-    - git config --global user.name "$GITLAB_USER_NAME"
-    - git config --global user.email "$GITLAB_USER_EMAIL"
-  script:
-    - bun install --frozen-lockfile
-    - VERSION=$(bun -e "console.log(require('./package.json').version)")
-    - bun run build
-    - echo "${NPM_REGISTRY}:_authToken=${NPM_RELEASE_TOKEN}" > .npmrc
-    - npm publish --access public
-    - git tag -a "v${VERSION}" -m "v${VERSION}"
-    - git push "https://${GITLAB_USER_NAME}:${CI_GIT_TOKEN}@${CI_REPOSITORY_URL#*@}" --tags
-  rules:
-    - if: '$CI_COMMIT_MESSAGE =~ /release-by-bot/ || $CI_COMMIT_TAG'
-      when: never
-    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
-      when: never
-    - if: '$CI_COMMIT_MESSAGE =~ /run-prerelease/ && $CI_COMMIT_BRANCH != $CI_DEFAULT_BRANCH'
-      variables:
-        NPM_REGISTRY: "//npm.nathapp.io/"
-        NPM_RELEASE_TOKEN: $NPM_PRIVATE_TOKEN
-    - if: '$CI_COMMIT_MESSAGE =~ /run-release/ && $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'
-
-# --- Stage: Notify ---
-notify:
-  stage: notify
-  image: 
-    name: registry-intl.cn-hongkong.aliyuncs.com/gkci/node:22.14.0-alpine-ci
-    pull_policy: always
-  needs: [release]
-  script:
-    - VERSION=$(node -e "console.log(require('./package.json').version)")
-    - 'curl -s -X POST -H "Content-Type: application/json" -d "{\"chat_id\": \"$TELEGRAM_CHAT_ID\", \"text\": \"nax v${VERSION} released\"}" https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/sendMessage'
-  rules:
-    - if: '$CI_COMMIT_MESSAGE =~ /release-by-bot/ || $CI_COMMIT_TAG'
-      when: never
-    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
-      when: never
-    - if: '$TELEGRAM_BOT_TOKEN == null || $TELEGRAM_BOT_TOKEN == ""'
-      when: never
-    - if: '$CI_COMMIT_MESSAGE =~ /run-prerelease/ && $CI_COMMIT_BRANCH != $CI_DEFAULT_BRANCH'
-    - if: '$CI_COMMIT_MESSAGE =~ /run-release/ && $CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'

package/.mcp.json

@@ -1,8 +0,0 @@
-{
-  "mcpServers": {
-    "code-graph": {
-      "type": "http",
-      "url": "http://192.168.1.142:3100/mcp"
-    }
-  }
-}

package/BRIEF.md

@@ -1,140 +0,0 @@
-# nax — Brief
-
-## What
-AI coding agent orchestrator (CLI, Bun + TypeScript). Takes a feature spec, decomposes into user stories via LLM, routes each to the right model tier by complexity, and executes them with auto-escalation and retry. Supports three-session TDD for quality-critical work. Currently v0.10.1 on master. Published as `@nathapp/nax` (not yet on npm — local/global install only).
-
-## Architecture
-
-```
-spec.md + tasks.md
-    ↓
-nax analyze → prd.json (user stories with routing metadata)
-    ↓
-nax run → pipeline per story:
-    routing → context → constitution → prompt → optimizer → execution → review → acceptance → completion
-                                                  ↑                                ↑
-                                            (v0.10 plugin)                   (v0.10 plugin)
-    ↑                         ↑
-  plugin routers        plugin context-providers
-```
-
-**Key modules:**
-
-| Module | Purpose |
-|:-------|:--------|
-| `pipeline/` | Stage-based runner — each stage returns continue/skip/fail/escalate/pause |
-| `routing/` | Strategy chain: keyword → LLM → adaptive → manual → plugin |
-| `context/` | Builds per-story context from PRD + dependencies within token budget |
-| `tdd/` | Three-session orchestrator: test-writer → implementer → verifier with git-diff isolation |
-| `execution/` | Spawns `claude -p` via ClaudeCodeAdapter, handles timeouts and cost tracking |
-| `status-file/` | *(v0.10.1)* Atomic JSON status writer for external monitoring (dashboards/CI) |
-| `acceptance/` | LLM-generated acceptance tests, validates story output |
-| `agents/` | Adapter pattern — currently only Claude Code, designed for Codex/Gemini/OpenCode |
-| `hooks/` | Lifecycle events (on-start, on-complete, on-pause, on-error) via shell commands |
-| `config/` | Layered config: global (`~/.nax/`) → project (`nax/`) with Zod validation + deep merge |
-| `constitution/` | Injected rules/constraints prepended to every agent prompt |
-| `plugins/` | *(v0.10)* Plugin loader, registry, and extension point interfaces |
-| `optimizer/` | *(v0.10)* Prompt optimization stage (rule-based built-in + plugin support) |
-
-## Key Decisions
-
-| Decision | Why | Date | Ref |
-|:---------|:----|:-----|:----|
-| Classify complexity upfront, not start-cheap | Avoids wasting cycles on wrong model; LLM routing is cheap (~$0.002/story) | 2026-02-16 | SPEC.md |
-| Three-session TDD (not two) | Session 3 (verifier) catches cases where implementer subtly modifies tests; git-diff isolation between all sessions | 2026-02-16 | SPEC.md |
-| LLM outputs testStrategy directly | Keyword matching caused false positives ("endpoint"→TDD). LLM handles nuance better | 2026-02-23 | #11, #12 |
-| Stage-based pipeline over monolithic runner | Composable, testable, each stage can skip/fail independently | 2026-02-17 | v0.3-spec |
-| Bun over Node | Faster test execution, native TypeScript, built-in file APIs | 2026-02-16 | — |
-| Token budget for context | Prevents context overflow (200k window); reserves 100k for agent reasoning | 2026-02-17 | context/builder.ts |
-| Constitution as separate file | Project-level rules (coding standards, forbidden patterns) injected into every prompt without modifying CLAUDE.md | 2026-02-18 | — |
-| Hooks over built-in integrations | Users wire their own notifications/CI via shell commands; nax stays standalone | 2026-02-16 | SPEC.md |
-| Dropped greenfield scaffolding (#13) | Chicken-and-egg: nax/ must exist inside project, but scaffolding creates the project. Manual US-000 works fine. Existing tools (na-cli, nest new) handle scaffolding better. | 2026-03-03 | #13 |
-| Test-writer allowed paths for barrel exports | `src/index.ts` re-exports are common TDD collateral; soft-warn instead of hard-block | 2026-02-22 | #9 |
-| Story pause doesn't block unrelated stories | Dependency graph determines which stories can proceed independently | 2026-02-22 | #10 |
-| Use actual BuiltContext tokens in frontmatter | Re-estimating tokens independently caused mismatches; element-level tracking is more accurate for audit | 2026-02-23 | #15 |
-| Shared TDD prompt module | Extracting TDD prompts from orchestrator ensures consistency between CLI and execution | 2026-02-23 | #15 |
-| Plugin system over ad-hoc extension | Unified registration/loading for all extension points (optimizer, router, agent, reviewer, context, reporter). Reuses existing interfaces. | 2026-03-03 | #8, #14 |
-| Deep merge for global+project config | More intuitive than section replace; users only override what they change. Hooks and constitution concatenate (global first). | 2026-03-03 | #14 |
-| No LLM optimizer built-in | Fast-tier LLM rewrite adds cost/complexity. Rule-based covers deterministic wins. External LLM optimizers (LLMLingua, etc.) can be added via plugins. | 2026-03-03 | #8 |
-| TDD-Lite over removing TDD | TDD is nax's differentiator; instead of dropping it, add a relaxed variant (lite) where only verifier stays isolated. Strict for TS libs, lite for UI/polyglot. | 2026-02-24 | #20 |
-| Fix nax over replacing with dev-orchestrator | dev-orchestrator lacks TDD pipeline, structured logging, PRD workflow. Porting those is more work than fixing nax's weaknesses. | 2026-02-24 | `docs/20260224-nax-roadmap-phases.md` |
-| Dry-run marks stories as passed | Previous dry-run never changed story status, causing infinite loop until maxIterations. Now marks passed + saves PRD for natural completion. | 2026-02-24 | `09996c8` |
-| Targeted git reset for TDD fallback | `git checkout .` was too aggressive; now resets only files touched by the failed session, preserving other local changes. | 2026-02-24 | `d1dc4b9` |
-| Atomic Status File (v0.10.1) | Machine-readable status tracking via JSON. Atomic write (write-then-rename) prevents partial reads during polling. | 2026-02-25 | `status-file-v0.10.1.md` |
-| Category-based TDD routing (v0.10.1) | Isolation violations trigger strategy downgrade (Lite) while mechanical failures trigger tier escalation. Reduces manual pause/resume cycles. | 2026-02-25 | `status-file-v0.10.1.md` |
-
-## Config Reference
-
-Config loaded from `~/.nax/config.json` (global) deep-merged with `nax/config.json` (project). CLI flags override both.
-
-**Resolution order:** Built-in defaults → `~/.nax/config.json` → `nax/config.json` → CLI flags
-
-| Section | Key | Type | Default | Purpose |
-|:--------|:----|:-----|:--------|:--------|
-| models | fast/balanced/powerful | ModelDef \| string | haiku/sonnet/opus | Maps abstract tiers to actual models |
-| autoMode | complexityRouting | Record<Complexity, Tier> | simple→fast, medium→balanced, complex/expert→powerful | Which tier handles which complexity |
-| autoMode | escalation.tierOrder | TierConfig[] | fast×5, balanced×3, powerful×2 | Retry budget per tier before escalating |
-| routing | strategy | keyword\|llm\|manual\|adaptive\|custom | keyword | How stories get classified |
-| routing | llm.mode | one-shot\|per-story\|hybrid | hybrid | Batch-route upfront + re-route on retry |
-| execution | costLimit | number (USD) | 5.0 | Pause run when cost exceeds this |
-| execution | sessionTimeoutSeconds | number | 600 | Kill agent session after this |
-| execution | verificationTimeoutSeconds | number | 300 | Kill test/typecheck/lint subprocess |
-| quality | commands.test | string | (auto-detect) | Custom test command |
-| quality | forceExit | boolean | false | Append --forceExit to test command |
-| quality | stripEnvVars | string[] | CLAUDECODE, REPL_ID, AGENT | Env vars removed during verification |
-| tdd | sessionTiers | {testWriter, implementer, verifier} | balanced/story-tier/fast | Per-session model overrides |
-| tdd | testWriterAllowedPaths | string[] | src/index.ts, src/**/index.ts | Soft-allowed paths for test-writer |
-| constitution | path | string | constitution.md | Relative to config dir (~/.nax/ or nax/) |
-| constitution | skipGlobal | boolean | false | *(v0.10)* Skip global constitution for this project |
-| context | testCoverage.detail | names-only\|names-and-counts\|describe-blocks | names-and-counts | How much test info to inject |
-| context | testCoverage.maxTokens | number | 500 | Token budget for test coverage section |
-| context | testCoverage.scopeToStory | boolean | true | Filter test coverage to story-relevant files only |
-| acceptance | enabled | boolean | true | Run LLM acceptance validation |
-| analyze | llmEnhanced | boolean | true | Use LLM for story decomposition |
-| optimizer | enabled | boolean | false | *(v0.10)* Enable prompt optimization stage |
-| optimizer | strategy | noop\|rule-based | noop | *(v0.10)* Built-in optimizer strategy |
-| hooks | skipGlobal | boolean | false | *(v0.10)* Skip global hooks for this project |
-| plugins | (array) | PluginConfigEntry[] | [] | *(v0.10)* Explicit plugin modules + config |
-
-Full schema with Zod validation: `src/config/schema.ts`
-
-## v0.10 Specs
-
-| Feature | Spec File | Stories | Summary |
-|:--------|:----------|:--------|:--------|
-| Plugin System | `docs/v0.10-plugin-system.md` | 9 | Loader, registry, 6 extension point interfaces (optimizer, router, agent, reviewer, context-provider, reporter) |
-| Prompt Optimizer | `docs/v0.10-prompt-optimizer.md` | 5 | NoopOptimizer (default), RuleBasedOptimizer (strip whitespace, compact criteria, dedup context), optimizer pipeline stage |
-| Global Config | `docs/v0.10-global-config.md` | 7 | `~/.nax/` directory, deep merge (project wins), hooks concatenate (global first), constitution concatenate, `nax init --global`, `skipGlobal` opt-out |
-| Status File & Smart Escalation | `docs/specs/status-file-v0.10.1.md` | 9 | Atomic JSON status tracking, failure categorization, retry-as-lite strategy downgrade |
-
-**Total: ~30 user stories** across 4 features.
-
-## Version History
-
-| Version | What Changed | Issues |
-|:--------|:-------------|:-------|
-| v0.10.1 | Status file (machine-readable), Smart TDD escalation (retryAsLite), Verifier Verdicts | #16 |
-| v0.10.0 | Plugin system, Global config layering, Prompt optimizer stage | #8, #14 |
-| v0.9.3 | Prompt Audit CLI (`nax prompts`), context isolation unit tests, scoped test coverage scanner | #15 |
-
-## Roadmap
-
-| Priority | Feature | Status | Ref |
-|:---------|:--------|:-------|:----|
-| **Done** | Phase 1: TDD-Lite strategy + zero-file fallback | ✅ Done | #20, `docs/20260224-nax-roadmap-phases.md` |
-| **Next** | Phase 2: LLM Service Layer — agent interface with pluggable backends | 📋 Planned | #3 |
-| **Next** | Phase 3: Worktree parallelism — N stories concurrent | 📋 Planned | — |
-| **Backlog** | CLI for paused stories (`nax stories`, `nax resume`) | 📋 Planned | #18 |
-| **Backlog** | Quality flags + review.checks unification | 📋 Planned | #19 |
-
-### Phase Dependency Chain
-```
-Phase 1: tdd-lite + fallback     ← standalone, no blockers
-    ↓
-Phase 2: LLM Service Layer (#3)  ← abstracts agent spawning (claude-cli, openclaw, api)
-    ↓
-Phase 3: Worktree parallelism    ← needs Phase 2 for multi-agent coordination
-```
-
----
-*Updated 2026-02-25*

package/CLAUDE.md

@@ -1,143 +0,0 @@
-# nax — AI Coding Agent Orchestrator
-
-Bun + TypeScript CLI that orchestrates AI coding agents (Claude Code) with model-tier routing, TDD strategies, plugin hooks, and a Central Run Registry.
-
-## Tech Stack
-
-| Layer | Choice |
-|:------|:-------|
-| Runtime | **Bun 1.3.7+** — Bun-native APIs only, no Node.js equivalents |
-| Language | **TypeScript strict** — no `any` without explicit justification |
-| Test | **`bun:test`** — describe/test/expect |
-| Lint/Format | **Biome** (`bun run lint`) |
-| Build | `bun run build` |
-
-## Git Identity
-
-```bash
-git config user.name "subrina.tai"
-git config user.email "subrina8080@outlook.com"
-```
-
-## Commands
-
-| Command | Purpose |
-|:--------|:--------|
-| `bun run typecheck` | tsc --noEmit |
-| `bun run lint` | Biome |
-| `bun test test/unit/foo.test.ts` | Targeted test during iteration |
-| `NAX_SKIP_PRECHECK=1 bun test test/ --timeout=60000 --bail` | Full suite |
-
-nax runs lint, typecheck, and tests automatically via the pipeline. Run these manually only when working outside a nax session.
-
-## Engineering Persona
-
-- **Senior Engineer mindset**: check edge cases, null/undefined, race conditions, and error states.
-- **TDD first**: write or update tests before implementation when the story calls for it.
-- **Stuck rule**: if the same test fails 2+ iterations, stop, summarise failed attempts, reassess approach.
-- **Never push to remote** — the human reviews and pushes.
-
-## Architecture
-
-```
-Runner.run()  [src/execution/runner.ts — thin orchestrator only]
-  → loadPlugins()
-  → for each story:
-    → Pipeline.execute()  [src/pipeline/pipeline.ts]
-      → stages: queueCheck → routing → constitution → context → prompt
-               → execution → verify → review → completion
-    → Reporter.emit()
-  → registry.teardownAll()
-```
-
-### Key Source Directories
-
-| Directory | Purpose |
-|:----------|:--------|
-| `src/execution/` | Runner loop, agent adapters, escalation, lifecycle hooks |
-| `src/execution/escalation/` | Tier escalation on repeated failures |
-| `src/pipeline/stages/` | One file per pipeline stage |
-| `src/pipeline/subscribers/` | Event-driven hooks (interaction, hooks.ts) |
-| `src/routing/` | Model-tier routing — keyword, LLM, plugin chain |
-| `src/routing/strategies/` | keyword.ts, llm.ts, llm-prompts.ts |
-| `src/interaction/` | Interaction triggers + plugins (Auto, Telegram, Webhook) |
-| `src/plugins/` | Plugin system — loader, registry, validator |
-| `src/verification/` | Test execution, smart runner, scoped runner |
-| `src/metrics/` | StoryMetrics, aggregator, tracker |
-| `src/config/` | Config schema + layered loader (global → project) |
-| `src/agents/adapters/` | Agent integrations (Claude Code) |
-| `src/cli/` + `src/commands/` | CLI commands — check both locations |
-| `src/prd/` | PRD types, loader, story state machine |
-| `src/hooks/` | Lifecycle hook wiring |
-| `src/constitution/` | Constitution loader + injection |
-| `src/analyze/` | `nax analyze` — story classifier |
-
-### Plugin Extension Points
-
-| Interface | Loaded By | Purpose |
-|:----------|:----------|:--------|
-| `IContextProvider` | `context.ts` stage | Inject context into agent prompts |
-| `IReviewer` | Review stage | Post-verify quality checks |
-| `IReporter` | Runner | onRunStart / onStoryComplete / onRunEnd events |
-| `IRoutingStrategy` | Router chain | Override model-tier routing |
-
-### Config
-
-- Global: `~/.nax/config.json` → Project: `<workdir>/nax/config.json`
-- Schema: `src/config/schema.ts` — no hardcoded flags or credentials anywhere
-
-## Workflow Protocol
-
-1. **Explore first**: use `grep`, `cat`, and solograph MCP to understand context before writing code.
-2. **Plan complex tasks**: for multi-file changes, write a short plan before implementing.
-3. **Implement in small chunks**: one logical concern per commit.
-
-## Code Intelligence (Solograph MCP) — MANDATORY
-
-**Always use solograph MCP tools before writing code or analyzing architecture.** Do NOT use `web_search` or `kb_search` as substitutes.
-
-### Tool Selection Guide
-
-| Tool | Capability | When to Use | Availability |
-|:-----|:-----------|:-----------|:-------------|
-| `codegraph_query` | Structural queries (Cypher) — find calls, dependencies, imports | **Preferred for dependency analysis, call tracing, symbol lookup** | ✅ Always works (in-memory graph) |
-| `project_code_search` | Semantic search (Redis vector DB) — pattern matching by meaning | Natural language queries like "find auth patterns" | ⚠️ Requires explicit `project_code_reindex` + Redis daemon |
-| `codegraph_explain` | Architecture overview for unfamiliar subsystems | Understand module relationships before major changes | ✅ Always works |
-| `project_code_reindex` | Index project for semantic search | After creating/deleting source files | ✅ Always works |
-
-### Recommended Workflow
-
-For nax, **prefer `codegraph_query`** for routine tasks:
-- Finding where functions are called (`calculateAggregateMetrics` called by `status-cost.ts`)
-- Analyzing dependencies before refactoring
-- Tracing import/export chains
-- Querying symbol definitions and relationships
-
-**Use `project_code_search` only if:**
-- You need semantic similarity ("find authentication patterns")
-- Redis is indexed and running (not guaranteed in all sessions)
-
-### Example Queries
-
-```cypher
--- Find files calling calculateAggregateMetrics
-MATCH (f:File)-[:CALLS]->(s:Symbol {name: "calculateAggregateMetrics"})
-RETURN f.path
-
--- Find all imports of aggregator.ts
-MATCH (f:File)-[:IMPORTS]->(target:File {path: "src/metrics/aggregator.ts"})
-RETURN f.path
-
--- Find symbols defined in a file
-MATCH (f:File {path: "src/metrics/aggregator.ts"})-[:DEFINES]->(s:Symbol)
-RETURN s.name, s.type
-```
-
-## Coding Standards & Forbidden Patterns
-
-Full rules in `.claude/rules/` (loaded automatically):
-
-- `01-project-conventions.md` — Bun-native APIs, 400-line limit, barrel imports, logging, commits
-- `02-test-architecture.md` — directory mirroring, placement rules, file naming
-- `03-test-writing.md` — `_deps` injection pattern, mock discipline, CI guards
-- `04-forbidden-patterns.md` — banned APIs and test anti-patterns with alternatives

package/US-007-IMPLEMENTATION.md

@@ -1,139 +0,0 @@
-# US-007 Implementation Summary
-
-## Story: Read plugin config entries from nax config.json
-
-**Status:** ✅ COMPLETE
-
-## Implementation Details
-
-The functionality described in US-007 was already implemented in the codebase. This document verifies that all acceptance criteria are met.
-
-### Acceptance Criteria Verification
-
-#### ✅ AC1: plugins[] from config.json are passed to loadPlugins() as configPlugins parameter
-
-**Implementation:**
-- `src/config/loader.ts`: Config schema includes `plugins?: PluginConfigEntry[]` (line 369)
-- `src/execution/runner.ts`: Reads `config.plugins` and passes to `loadPlugins()` (line 201)
-- `src/execution/run-lifecycle.ts`: Reads `config.plugins` and passes to `loadPlugins()` (line 88)
-- `src/cli/plugins.ts`: Reads `config.plugins` and passes to `loadPlugins()` (line 22)
-
-**Test Coverage:**
-- `test/integration/config-loader.test.ts`: New tests verify plugins[] are loaded from config.json
-- `test/integration/plugins/config-integration.test.ts`: End-to-end test with realistic scenario
-- `test/integration/plugins/config-resolution.test.ts`: Comprehensive path resolution tests
-
-#### ✅ AC2: Relative module paths in plugins[].module are resolved relative to project root
-
-**Implementation:**
-- `src/plugins/loader.ts`: `resolveModulePath()` function (lines 173-186)
-  - Relative paths (starting with `./` or `../`) are resolved relative to `projectRoot`
-  - Uses `path.resolve(projectRoot, modulePath)` for relative paths
-
-**Test Coverage:**
-- `test/integration/plugins/config-resolution.test.ts`:
-  - "AC2: Relative module paths resolved relative to project root"
-  - "resolves ./custom-plugins/plugin.ts relative to project root"
-
-#### ✅ AC3: Absolute module paths and npm package names work as-is
-
-**Implementation:**
-- `src/plugins/loader.ts`: `resolveModulePath()` function (lines 173-186)
-  - Absolute paths: `path.isAbsolute(modulePath)` returns true → no resolution needed
-  - NPM packages: No leading `./` or `../` → treated as package name, passed as-is
-
-**Test Coverage:**
-- `test/integration/plugins/config-resolution.test.ts`:
-  - "AC3: Absolute paths and npm packages work as-is"
-  - "resolves npm package names as-is"
-  - "resolves absolute paths as-is"
-
-#### ✅ AC4: If a plugin module cannot be found, a clear error message is logged with the path tried
-
-**Implementation:**
-- `src/plugins/loader.ts`: `loadAndValidatePlugin()` function (lines 225-241)
-  - Catches import errors and provides helpful error messages
-  - Lines 230-235: Special handling for "Cannot find module" and "ENOENT" errors
-  - Logs both original path and attempted resolved path
-  - Provides guidance: "Ensure the module exists and the path is correct (relative paths are resolved from project root)"
-
-**Test Coverage:**
-- `test/integration/plugins/config-resolution.test.ts`:
-  - "AC4: Clear error message when plugin module not found (relative path)"
-  - "AC4: Clear error message when plugin module not found (npm package)"
-
-**Example Error Output:**
-```
-[nax] Failed to load plugin module './custom-plugins/missing.ts'
-[nax] Attempted path: /path/to/project/custom-plugins/missing.ts
-[nax] Ensure the module exists and the path is correct (relative paths are resolved from project root)
-```
-
-#### ✅ AC5: Plugin-specific config (plugins[].config) is passed to the plugin's setup() function
-
-**Implementation:**
-- `src/plugins/loader.ts`: `loadAndValidatePlugin()` function (lines 214-221)
-  - Calls plugin's `setup()` function with the provided config
-  - Config is passed as the first parameter: `await validated.setup(config)`
-
-**Test Coverage:**
-- `test/integration/plugins/config-integration.test.ts`:
-  - "realistic scenario: project with relative plugin paths in config"
-  - Verifies that plugin configs are written to tracker file via setup()
-- `test/integration/plugins/config-resolution.test.ts`:
-  - "AC5: Plugin-specific config passed to setup() function"
-
-## Test Results
-
-All plugin-related tests pass:
-
-```bash
-$ bun test test/integration/plugins/ test/integration/config-loader.test.ts test/integration/runner-plugin-integration.test.ts
-
-✓ 101 tests passed
-✓ 154 expect() calls
-✓ 0 failures
-```
-
-### New Tests Added
-
-Added 4 new tests to `test/integration/config-loader.test.ts`:
-
-1. **"loads plugins[] from config.json"** - Verifies plugins array is loaded correctly
-2. **"handles missing plugins[] array"** - Verifies graceful handling of missing plugins
-3. **"merges plugins[] from global and project config"** - Verifies config merging behavior
-4. **"validates plugin config entries have required fields"** - Verifies validation works
-
-## Files Modified
-
-1. **test/integration/config-loader.test.ts**
-   - Added new test suite: "Config Loader - Plugin Configuration (US-007)"
-   - Added 4 tests covering config loading scenarios
-   - Tests verify plugins[] array is properly loaded and validated
-
-## Architecture Overview
-
-```
-config.json
-  └─> loadConfig() (src/config/loader.ts)
-      └─> NaxConfig { plugins?: PluginConfigEntry[] }
-          └─> Runner/CLI reads config.plugins
-              └─> loadPlugins(globalDir, projectDir, configPlugins, projectRoot)
-                  └─> resolveModulePath() for each entry
-                      └─> loadAndValidatePlugin()
-                          └─> import module
-                              └─> validatePlugin()
-                                  └─> plugin.setup(config)
-```
-
-## Conclusion
-
-All acceptance criteria for US-007 are met. The implementation correctly:
-1. Reads plugins[] from config.json
-2. Passes them to loadPlugins() as configPlugins parameter
-3. Resolves relative paths relative to project root
-4. Handles absolute paths and npm packages correctly
-5. Provides clear error messages when modules are not found
-6. Passes plugin-specific config to setup() functions
-
-The feature is production-ready and fully tested.

package/biome.json

@@ -1,14 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
-  "organizeImports": { "enabled": true },
-  "linter": {
-    "enabled": true,
-    "rules": { "recommended": true }
-  },
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space",
-    "indentWidth": 2,
-    "lineWidth": 120
-  }
-}