aiwcli 0.12.7 → 0.12.8

package/dist/templates/_shared/lib-ts/base/inference.ts

@@ -12,9 +12,9 @@ import { execFileAsync, getInternalSubprocessEnv, shellQuoteWin } from "./subpro
 
 // Model configurations §6.1
 const MODELS: Record<string, string> = {
-  fast: "claude-3-haiku-20240307",
-  standard: "claude-sonnet-4-20250514",
-  smart: "claude-opus-4-20250514",
+  fast: "claude-haiku-4-5-20251001",
+  standard: "claude-sonnet-4-6",
+  smart: "claude-opus-4-6",
 };
 
 const TIMEOUTS: Record<string, number> = {

package/dist/templates/_shared/lib-ts/context/CLAUDE.md

@@ -0,0 +1,134 @@
+# Context Management System
+
+Shared library for context lifecycle management: state machine, session binding, plan tracking, and artifact routing.
+
+## Overview
+
+A "context" is a named work session with a state machine that tracks mode transitions, staged artifacts, and session history. Contexts persist to disk as `state.json` files under `_output/contexts/{id}/`. They are the backbone of the handoff and session-restore system.
+
+## File Structure
+
+```
+context/
+├── CLAUDE.md          ← This file
+├── context-store.ts   ← Core CRUD + state machine transitions
+├── context-formatter.ts ← Context → human-readable text for injection
+├── context-selector.ts  ← Find active/relevant contexts by criteria
+├── plan-manager.ts    ← Plan file archive, discovery, hash, path extraction
+└── task-tracker.ts    ← Task progress tracking within a context
+```
+
+## State Machine
+
+```
+                      ┌─────────────┐
+                      │   created   │
+                      └──────┬──────┘
+                             │ first user prompt / maybeActivate()
+                             ▼
+                      ┌─────────────┐
+                  ┌──▶│   active    │◀──────────────────┐
+                  │   └──────┬──────┘                   │
+                  │          │ session_end + artifact    │ session_start (clear)
+                  │          ▼                           │
+                  │   ┌─────────────────┐               │
+                  │   │ has_staged_work  │ ──────────────┘
+                  │   └──────┬──────────┘
+                  │          │ work_consumed = true
+                  │          ▼
+                  │   ┌─────────────┐
+                  │   │  archived   │──▶ (terminal)
+                  │   └─────────────┘
+                  │
+                  └─── reopenContext()
+```
+
+**Modes:**
+- `created` — context initialized, not yet bound to a session
+- `active` — session in progress, context is current
+- `has_staged_work` — session ended with staged artifact (plan or handoff)
+- `archived` — context complete and closed
+
+## API Reference
+
+### `context-store.ts`
+
+| Function | Purpose |
+|----------|---------|
+| `createContext(id, opts)` | Create new context with initial state |
+| `getContext(contextId)` | Read context by ID |
+| `getAllContexts(mode?, root?)` | List all contexts, optionally filtered by mode |
+| `getContextBySessionId(sessionId, root?)` | Find context that owns a session ID |
+| `updateContext(contextId, patch)` | Partial state update |
+| `bindSession(contextId, sessionId)` | Attach session ID to context |
+| `updateMode(contextId, mode)` | Transition state machine mode |
+| `maybeActivate(contextId)` | Activate if in `created` mode (idempotent) |
+| `completeContext(contextId)` | Mark complete, archive |
+| `archiveContext(contextId)` | Archive without completing |
+| `reopenContext(contextId)` | Transition `archived` → `active` |
+| `createContextFromPrompt(prompt)` | Create context from user prompt text |
+| `loadState(contextId)` | Raw state.json read |
+| `saveState(contextId, state)` | Raw state.json write |
+| `determineArtifactType(context)` | Detect `"plan"` or `"handoff"` from staged state |
+
+### `context-formatter.ts`
+
+Formats context state for injection into Claude's context window.
+
+| Function | Purpose |
+|----------|---------|
+| `formatContext(context)` | Full context as human-readable markdown |
+| `formatContextSummary(context)` | Short one-line summary |
+
+### `context-selector.ts`
+
+Finds contexts by various criteria.
+
+| Function | Purpose |
+|----------|---------|
+| `selectActiveContext(root?)` | Find the single active context (errors if multiple) |
+| `findContextByMode(mode, root?)` | Find contexts in a given mode |
+| `findStagedWorkContext(root?)` | Find context with `has_staged_work` mode |
+
+### `plan-manager.ts`
+
+Manages plan file lifecycle within a context.
+
+| Function | Purpose |
+|----------|---------|
+| `archivePlan(contextId, planPath)` | Copy plan to context's `plans/` folder |
+| `findLatestPlan(contextId)` | Find most recent archived plan |
+| `generatePlanId()` | Generate unique plan ID |
+| `normalizePlanContent(text)` | Strip metadata for hashing |
+| `extractPlanAnchors(content)` | Extract key phrases from plan for matching |
+| `findPlanPathInTranscript(transcriptPath)` | Parse plan path from JSONL transcript |
+| `extractPlanPathFromResult(toolResult)` | Extract plan path from tool result JSON |
+
+### `task-tracker.ts`
+
+Tracks task progress (ISC criteria) within a context.
+
+| Function | Purpose |
+|----------|---------|
+| `initTaskTracker(contextId)` | Create task tracker for context |
+| `addTask(contextId, task)` | Add tracked task |
+| `updateTask(contextId, taskId, patch)` | Update task status |
+| `getTaskSummary(contextId)` | Progress summary |
+
+## Which Hooks Use This System
+
+| Hook | Usage |
+|------|-------|
+| `session_start.ts` | `getContextBySessionId()`, `bindSession()`, `updateMode()`, `getAllContexts()` |
+| `session_end.ts` | `getContextBySessionId()`, `updateMode()`, `saveState()` |
+| `user_prompt_submit.ts` | `getAllContexts()`, `maybeActivate()`, `determineArtifactType()` |
+| `archive_plan.ts` | `getContextBySessionId()`, `archivePlan()` |
+| `save_handoff.ts` | `getContextBySessionId()`, `updateContext()` |
+| `cc-native-plan-review.ts` | `getContextBySessionId()`, `getAllContexts()` |
+
+## Design Decisions
+
+- **Single state.json per context:** All state is in one file. No distributed state. Atomic writes prevent corruption.
+- **No moves out of lib-ts:** Context is pure library code imported by ~8 shared hooks. Moving it would require updating all those import paths for no structural gain. The subfolder is already co-located; it just needed documentation.
+- **`maybeActivate()` is idempotent:** Can be called from any hook without checking current mode — safe to call repeatedly.
+- **`determineArtifactType()` drives session restore:** Returns `"plan"` or `"handoff"` to dispatch the correct restoration path in `session_start.ts`.

package/dist/templates/_shared/scripts/status_line.ts

@@ -266,9 +266,10 @@ function runGit(args: string[], cwd: string, timeout = 2000): string | null {
 }
 
 function getGitStatus(cwd: string): GitStatus | null {
-  if (runGit(["rev-parse", "--git-dir"], cwd) === null) {
-    return null;
-  }
+  // One call replaces 6: branch, modified, staged, untracked, ahead/behind, and repo check.
+  // porcelain=v2 -b gives structured header lines + per-file XY status codes.
+  const porcelain = runGit(["status", "--porcelain=v2", "-b"], cwd);
+  if (porcelain === null) return null;
 
   const status: GitStatus = {
     branch: "detached",
@@ -282,36 +283,32 @@ function getGitStatus(cwd: string): GitStatus | null {
     age_color: GIT_AGE_FRESH,
   };
 
-  // Branch
-  const branch = runGit(["branch", "--show-current"], cwd);
-  if (branch) status.branch = branch;
-
-  // Modified files
-  const diff = runGit(["diff", "--name-only"], cwd);
-  if (diff) status.modified = diff.split(/\r?\n/).filter(Boolean).length;
-
-  // Staged files
-  const staged = runGit(["diff", "--cached", "--name-only"], cwd);
-  if (staged) status.staged = staged.split(/\r?\n/).filter(Boolean).length;
-
-  // Untracked files
-  const untracked = runGit(["ls-files", "--others", "--exclude-standard"], cwd);
-  if (untracked) status.untracked = untracked.split(/\r?\n/).filter(Boolean).length;
+  for (const line of porcelain.split(/\r?\n/)) {
+    if (line.startsWith("# branch.head ")) {
+      const b = line.slice(14).trim();
+      status.branch = b === "(detached)" ? "detached" : b;
+    } else if (line.startsWith("# branch.ab ")) {
+      // Format: "+<ahead> -<behind>"
+      const m = line.match(/\+(\d+) -(\d+)/);
+      if (m) {
+        status.ahead = parseInt(m[1]!, 10);
+        status.behind = parseInt(m[2]!, 10);
+      }
+    } else if (line.startsWith("1 ") || line.startsWith("2 ")) {
+      // Changed tracked file: "1 XY ..." where X=staged Y=unstaged, '.'=unchanged
+      const x = line[2]!;
+      const y = line[3]!;
+      if (x !== ".") status.staged++;
+      if (y !== ".") status.modified++;
+    } else if (line.startsWith("? ")) {
+      status.untracked++;
+    }
+  }
 
-  // Stash count
+  // Stash count (no equivalent in status output)
   const stash = runGit(["stash", "list"], cwd);
   if (stash) status.stash_count = stash.split(/\r?\n/).filter(Boolean).length;
 
-  // Ahead/behind
-  const ab = runGit(["rev-list", "--left-right", "--count", "HEAD...@{u}"], cwd);
-  if (ab) {
-    const parts = ab.split(/\s+/);
-    if (parts.length >= 2) {
-      status.ahead = parseInt(parts[0]!, 10) || 0;
-      status.behind = parseInt(parts[1]!, 10) || 0;
-    }
-  }
-
   // Commit age
   const log = runGit(["log", "-1", "--format=%ct"], cwd);
   if (log) {

package/dist/templates/cc-native/.claude/commands/cc-native/specdev.md

@@ -5,6 +5,6 @@ description: Interview user about a spec file and develop detailed requirements
 
 First, ask the user for the path to the spec file they want to develop.
 
-Then load and execute `_cc-native/workflows/specdev.md`.
+Then load and execute `_cc-native/plan-review/workflows/specdev.md`.
 
 Follow the Clarify → Explore → Write pattern using native tools.

package/dist/templates/cc-native/.claude/settings.json

@@ -162,8 +162,9 @@
         "matcher": "^Task$",
         "hooks": [
           {
-            "type": "prompt",
-            "prompt": "The sub-agent receives ONLY the prompt text — no conversation history, no prior context.\n\nCheck 1 — Dangling References: Does the prompt use pronouns or demonstratives that ONLY make sense with prior conversation? Violations: 'the file we looked at', 'as discussed above', 'that approach we chose', 'the error from earlier', 'fix the issue mentioned above'. NOT violations: relative paths ('_output/', 'src/lib/'), search terms ('context-manager', 'auth module'), directory exploration ('find files matching X'), tool names, or any concrete noun — even if imprecise. Only flag references that are truly UNRESOLVABLE without conversation history.\n\nCheck 2 — Implicit Contract: Does the prompt have ANY discernible goal? 'Explore the _output directory and find context files' IS a clear goal. 'Search for hooks that handle Task events' IS a clear goal. 'Read and summarize all files in X' IS a clear goal. Only flag if the prompt is truly goalless — e.g., a sentence fragment with no verb, or pure context with no request.\n\nIf both checks pass, return ok:true. When in doubt, pass — false negatives (letting a vague prompt through) are far less costly than false positives (blocking legitimate work).\n\nWhen returning ok:false, end your response with: 'Retry: Re-invoke the Task tool with a revised prompt that resolves the issues above.'"
+            "type": "command",
+            "command": "bun .aiwcli/_cc-native/hooks/validate_task_prompt.ts",
+            "timeout": 20000
           }
         ]
       },

package/dist/templates/cc-native/_cc-native/artifacts/CLAUDE.md

@@ -0,0 +1,64 @@
+# Artifacts System
+
+Review artifact generation, formatting, and file I/O for the plan review pipeline.
+
+## Overview
+
+The artifacts system handles all output files produced by plan review runs: combined markdown reports, JSON results, inline summaries, corroboration reports, and the review tracker. It is a pure library — no hooks or scripts.
+
+## File Structure
+
+```
+artifacts/
+├── CLAUDE.md        ← This file
+└── lib/
+    ├── index.ts     ← Barrel re-export of all public API
+    ├── format.ts    ← Pure formatting functions (markdown, JSON, summaries)
+    ├── write.ts     ← File I/O: atomic writes to context reviews dir
+    └── tracker.ts   ← Review tracker: read/write/hash extraction
+```
+
+## Public API (`lib/index.ts`)
+
+| Function | Source | Purpose |
+|----------|--------|---------|
+| `formatReviewMarkdown` | format.ts | Format single agent review as markdown |
+| `formatCombinedMarkdown` | format.ts | Format all agent reviews into combined markdown |
+| `buildInlineReviewSummary` | format.ts | Short inline summary for context injection |
+| `extractTopIssuesText` | format.ts | Extract top issues as text block |
+| `buildHighIssuesDocument` | format.ts | Full high-issues document for context |
+| `buildCorroborationReport` | format.ts | Corroboration analysis markdown report |
+| `generateReviewIndex` | format.ts | Index markdown linking all review files |
+| `buildCombinedJson` | format.ts | Combined JSON artifact for all reviews |
+| `writeCombinedArtifacts` | write.ts | Write all artifacts to context reviews dir |
+| `writeFile` | write.ts | Atomic file write |
+| `writeFileNonCritical` | write.ts | Non-atomic file write (non-critical paths) |
+| `writeReviewTracker` | tracker.ts | Write review tracker JSON to disk |
+| `extractPreviousHashes` | tracker.ts | Read previous plan hashes from tracker |
+| `ReviewTrackerEntry` | tracker.ts | Type: single tracker entry |
+
+## Dependencies
+
+- `../../lib-ts/types.ts` — `CombinedReviewResult`, `CorroborationResult` types
+- `../../lib-ts/constants.ts` — `ENABLE_ROBUST_PLAN_WRITES` feature flag
+- `../../../_shared/lib-ts/base/atomic-write.ts` — atomic file I/O
+- `../../../_shared/lib-ts/base/constants.ts` — `sanitizeFilename`
+- `../../../_shared/lib-ts/base/logger.ts` — logging
+
+## Hooks
+
+Hooks for this system are NOT co-located here. Hooks are path-referenced in `.claude/settings.json` at install time. Moving a hook file requires settings.json updates in both `.aiwcli/` and `packages/cli/src/templates/`, which is high blast-radius and fragile.
+
+The artifacts system is invoked indirectly through the plan review pipeline — it has no dedicated hooks. See `../_cc-native/hooks/` for the plan review hooks that drive this system.
+
+## Callers
+
+- `../plan-review/lib/review-pipeline.ts` — primary caller, writes all review artifacts
+- `../../lib-ts/index.ts` — re-exports public API surface
+
+## Design Decisions
+
+- **Pure library:** No global state, no side effects except file I/O in write.ts/tracker.ts
+- **Atomic writes:** `write.ts` uses atomic writes (write to temp + rename) for critical review files when `ENABLE_ROBUST_PLAN_WRITES` is set, preventing partial writes on crash
+- **format.ts is pure:** All formatting is pure functions — takes data, returns strings. No file I/O.
+- **Co-location:** Moved from `lib-ts/artifacts/` to `artifacts/lib/` to give the system peer-level status alongside `plan-review/` and `rlm/`