aiwcli 0.12.7 → 0.13.0

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

@@ -1,116 +1,97 @@
 {
   "statusLine": {
     "type": "command",
-    "command": "bun .aiwcli/_shared/scripts/status_line.ts"
+    "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/scripts/status_line.ts"
   },
-  "permissions": {
-    "allow": [],
-    "deny": []
-  },
-  "env": {},
-  "enabledPlugins": {},
   "fileSuggestion": {
     "type": "command",
-    "command": "bun .aiwcli/_shared/hooks-ts/file-suggestion.ts"
-  },
-  "methods": {
-    "cc-native": {
-      "ides": [
-        "claude"
-      ],
-      "installedAt": "2026-01-29T01:59:02.558Z"
-    }
+    "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/file-suggestion.ts"
   },
   "hooks": {
-    "SessionStart": [
+    "UserPromptSubmit": [
       {
         "hooks": [
           {
             "type": "command",
-            "command": "bun .aiwcli/_shared/hooks-ts/session_start.ts",
-            "timeout": 5000
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/user_prompt_submit.ts",
+            "timeout": 10000
+          },
+          {
+            "type": "command",
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_cc-native/hooks/plan_questions_early.ts",
+            "timeout": 3000
           }
         ]
       }
     ],
-    "SessionEnd": [
+    "PostToolUse": [
       {
+        "matcher": "Task|Read|Bash|WebFetch|Edit|Write|NotebookEdit",
         "hooks": [
           {
             "type": "command",
-            "command": "bun .aiwcli/_shared/hooks-ts/session_end.ts",
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/context_monitor.ts",
             "timeout": 5000
           }
         ]
-      }
-    ],
-    "PreCompact": [
+      },
       {
+        "matcher": "TaskCreate",
         "hooks": [
           {
             "type": "command",
-            "command": "bun .aiwcli/_shared/hooks-ts/pre_compact.ts",
-            "timeout": 5000
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/task_create_capture.ts",
+            "timeout": 3000
           }
         ]
-      }
-    ],
-    "UserPromptSubmit": [
+      },
       {
+        "matcher": "TaskUpdate",
         "hooks": [
           {
             "type": "command",
-            "command": "bun .aiwcli/_shared/hooks-ts/user_prompt_submit.ts",
-            "timeout": 10000
-          },
-          {
-            "type": "command",
-            "command": "bun .aiwcli/_cc-native/hooks/plan_questions_early.ts",
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/task_update_capture.ts",
             "timeout": 3000
           }
         ]
-      }
-    ],
-    "PostToolUse": [
+      },
       {
-        "matcher": "*",
+        "matcher": "ExitPlanMode",
         "hooks": [
           {
             "type": "command",
-            "command": "bun .aiwcli/_shared/hooks-ts/context_monitor.ts",
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/archive_plan.ts",
             "timeout": 5000
           }
         ]
       },
       {
-        "matcher": "TaskCreate",
+        "matcher": "*",
         "hooks": [
           {
             "type": "command",
-            "command": "bun .aiwcli/_shared/hooks-ts/task_create_capture.ts",
-            "timeout": 3000,
-            "async": true
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/context_monitor.ts",
+            "timeout": 5000
           }
         ]
       },
       {
-        "matcher": "TaskUpdate",
+        "matcher": "AskUserQuestion",
         "hooks": [
           {
             "type": "command",
-            "command": "bun .aiwcli/_shared/hooks-ts/task_update_capture.ts",
-            "timeout": 3000,
-            "async": true
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_cc-native/hooks/mark_questions_asked.ts",
+            "timeout": 3000
           }
         ]
       },
       {
-        "matcher": "AskUserQuestion",
+        "matcher": "Write|Edit",
         "hooks": [
           {
             "type": "command",
-            "command": "bun .aiwcli/_cc-native/hooks/mark_questions_asked.ts",
-            "timeout": 3000
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/lint_after_edit.ts",
+            "timeout": 10000
           }
         ]
       },
@@ -119,7 +100,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bun .aiwcli/_cc-native/hooks/enhance_plan_post_write.ts",
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_cc-native/hooks/enhance_plan_post_write.ts",
             "timeout": 5000
           }
         ]
@@ -129,20 +110,53 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bun .aiwcli/_cc-native/hooks/enhance_plan_post_subagent.ts",
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_cc-native/hooks/enhance_plan_post_subagent.ts",
             "timeout": 10000,
             "blockOnFail": false
           }
         ]
       }
     ],
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/session_start.ts",
+            "timeout": 5000
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/session_end.ts",
+            "timeout": 5000
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/pre_compact.ts",
+            "timeout": 5000
+          }
+        ]
+      }
+    ],
     "PermissionRequest": [
       {
         "matcher": "ExitPlanMode",
         "hooks": [
           {
             "type": "command",
-            "command": "bun .aiwcli/_shared/hooks-ts/archive_plan.ts",
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_shared/hooks-ts/archive_plan.ts",
             "timeout": 5000
           }
         ]
@@ -162,8 +176,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/bin/resolve-run.ts .aiwcli/_cc-native/hooks/validate_task_prompt.ts",
+            "timeout": 20000
           }
         ]
       },
@@ -172,11 +187,25 @@
         "hooks": [
           {
             "type": "command",
-            "command": "bun .aiwcli/_cc-native/hooks/cc-native-plan-review.ts",
+            "command": "bun ~/.aiwcli/bin/resolve-run.ts .aiwcli/_cc-native/hooks/cc-native-plan-review.ts",
             "timeout": 5000
           }
         ]
       }
     ]
+  },
+  "permissions": {
+    "allow": [],
+    "deny": []
+  },
+  "env": {},
+  "enabledPlugins": {},
+  "methods": {
+    "cc-native": {
+      "ides": [
+        "claude"
+      ],
+      "installedAt": "2026-02-16T23:59:38.727Z"
+    }
   }
 }

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/`