aiwcli 0.12.6 → 0.12.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (163) hide show
  1. package/bin/dev.cmd +3 -3
  2. package/bin/dev.js +16 -16
  3. package/bin/run.cmd +3 -3
  4. package/bin/run.js +21 -21
  5. package/dist/commands/branch.js +7 -2
  6. package/dist/lib/bmad-installer.js +37 -37
  7. package/dist/lib/terminal.d.ts +2 -0
  8. package/dist/lib/terminal.js +57 -7
  9. package/dist/templates/CLAUDE.md +232 -205
  10. package/dist/templates/_shared/.claude/settings.json +65 -65
  11. package/dist/templates/_shared/.claude/{commands/handoff.md → skills/handoff/SKILL.md} +13 -12
  12. package/dist/templates/_shared/.claude/{commands/handoff-resume.md → skills/handoff-resume/SKILL.md} +13 -12
  13. package/dist/templates/_shared/.codex/workflows/handoff.md +226 -226
  14. package/dist/templates/_shared/.windsurf/workflows/handoff.md +226 -226
  15. package/dist/templates/_shared/handoff-system/CLAUDE.md +15 -3
  16. package/dist/templates/_shared/handoff-system/lib/document-generator.ts +215 -215
  17. package/dist/templates/_shared/handoff-system/lib/handoff-reader.ts +158 -158
  18. package/dist/templates/_shared/handoff-system/scripts/resume_handoff.ts +373 -373
  19. package/dist/templates/_shared/handoff-system/scripts/save_handoff.ts +469 -469
  20. package/dist/templates/_shared/handoff-system/workflows/handoff-resume.md +66 -66
  21. package/dist/templates/_shared/handoff-system/workflows/handoff.md +254 -254
  22. package/dist/templates/_shared/hooks-ts/_utils/git-state.ts +2 -2
  23. package/dist/templates/_shared/hooks-ts/archive_plan.ts +159 -159
  24. package/dist/templates/_shared/hooks-ts/context_monitor.ts +147 -147
  25. package/dist/templates/_shared/hooks-ts/file-suggestion.ts +128 -128
  26. package/dist/templates/_shared/hooks-ts/pre_compact.ts +49 -49
  27. package/dist/templates/_shared/hooks-ts/session_end.ts +196 -196
  28. package/dist/templates/_shared/hooks-ts/session_start.ts +163 -163
  29. package/dist/templates/_shared/hooks-ts/task_create_capture.ts +48 -48
  30. package/dist/templates/_shared/hooks-ts/task_update_capture.ts +74 -74
  31. package/dist/templates/_shared/hooks-ts/user_prompt_submit.ts +93 -93
  32. package/dist/templates/_shared/lib-ts/CLAUDE.md +367 -367
  33. package/dist/templates/_shared/lib-ts/base/atomic-write.ts +138 -138
  34. package/dist/templates/_shared/lib-ts/base/constants.ts +24 -6
  35. package/dist/templates/_shared/lib-ts/base/git-state.ts +58 -58
  36. package/dist/templates/_shared/lib-ts/base/hook-utils.ts +582 -582
  37. package/dist/templates/_shared/lib-ts/base/inference.ts +301 -301
  38. package/dist/templates/_shared/lib-ts/base/logger.ts +247 -247
  39. package/dist/templates/_shared/lib-ts/base/state-io.ts +202 -202
  40. package/dist/templates/_shared/lib-ts/base/stop-words.ts +184 -184
  41. package/dist/templates/_shared/lib-ts/base/utils.ts +184 -184
  42. package/dist/templates/_shared/lib-ts/context/CLAUDE.md +134 -0
  43. package/dist/templates/_shared/lib-ts/context/context-formatter.ts +566 -566
  44. package/dist/templates/_shared/lib-ts/context/context-selector.ts +524 -524
  45. package/dist/templates/_shared/lib-ts/context/context-store.ts +712 -712
  46. package/dist/templates/_shared/lib-ts/context/plan-manager.ts +312 -312
  47. package/dist/templates/_shared/lib-ts/context/task-tracker.ts +185 -185
  48. package/dist/templates/_shared/lib-ts/package.json +20 -20
  49. package/dist/templates/_shared/lib-ts/templates/formatters.ts +102 -102
  50. package/dist/templates/_shared/lib-ts/templates/plan-context.ts +58 -58
  51. package/dist/templates/_shared/lib-ts/tsconfig.json +13 -13
  52. package/dist/templates/_shared/lib-ts/types.ts +186 -186
  53. package/dist/templates/_shared/scripts/resolve_context.ts +33 -33
  54. package/dist/templates/_shared/scripts/status_line.ts +687 -690
  55. package/dist/templates/cc-native/.claude/commands/cc-native/rlm/ask.md +136 -136
  56. package/dist/templates/cc-native/.claude/commands/cc-native/rlm/index.md +21 -21
  57. package/dist/templates/cc-native/.claude/commands/cc-native/rlm/overview.md +56 -56
  58. package/dist/templates/cc-native/.claude/commands/cc-native/specdev.md +10 -10
  59. package/dist/templates/cc-native/.claude/settings.json +3 -2
  60. package/dist/templates/cc-native/.windsurf/workflows/cc-native/fix.md +8 -8
  61. package/dist/templates/cc-native/.windsurf/workflows/cc-native/implement.md +8 -8
  62. package/dist/templates/cc-native/.windsurf/workflows/cc-native/research.md +8 -8
  63. package/dist/templates/cc-native/CC-NATIVE-README.md +189 -189
  64. package/dist/templates/cc-native/TEMPLATE-SCHEMA.md +304 -304
  65. package/dist/templates/cc-native/_cc-native/agents/CLAUDE.md +143 -143
  66. package/dist/templates/cc-native/_cc-native/agents/PLAN-ORCHESTRATOR.md +213 -213
  67. package/dist/templates/cc-native/_cc-native/agents/plan-questions/PLAN-QUESTIONER.md +70 -70
  68. package/dist/templates/cc-native/_cc-native/artifacts/CLAUDE.md +64 -0
  69. package/dist/templates/cc-native/_cc-native/{lib-ts/artifacts → artifacts/lib}/format.ts +1 -1
  70. package/dist/templates/cc-native/_cc-native/{lib-ts/artifacts → artifacts/lib}/write.ts +2 -2
  71. package/dist/templates/cc-native/_cc-native/cc-native.config.json +96 -96
  72. package/dist/templates/cc-native/_cc-native/hooks/CLAUDE.md +14 -24
  73. package/dist/templates/cc-native/_cc-native/hooks/cc-native-plan-review.ts +1 -1
  74. package/dist/templates/cc-native/_cc-native/hooks/enhance_plan_post_subagent.ts +54 -54
  75. package/dist/templates/cc-native/_cc-native/hooks/enhance_plan_post_write.ts +51 -51
  76. package/dist/templates/cc-native/_cc-native/hooks/mark_questions_asked.ts +53 -53
  77. package/dist/templates/cc-native/_cc-native/hooks/plan_questions_early.ts +61 -61
  78. package/dist/templates/cc-native/_cc-native/hooks/validate_task_prompt.ts +76 -0
  79. package/dist/templates/cc-native/_cc-native/lib-ts/aggregate-agents.ts +9 -2
  80. package/dist/templates/cc-native/_cc-native/lib-ts/cc-native-state.ts +319 -319
  81. package/dist/templates/cc-native/_cc-native/lib-ts/cli-output-parser.ts +144 -144
  82. package/dist/templates/cc-native/_cc-native/lib-ts/config.ts +57 -57
  83. package/dist/templates/cc-native/_cc-native/lib-ts/constants.ts +83 -83
  84. package/dist/templates/cc-native/_cc-native/lib-ts/debug.ts +79 -79
  85. package/dist/templates/cc-native/_cc-native/lib-ts/index.ts +4 -4
  86. package/dist/templates/cc-native/_cc-native/lib-ts/json-parser.ts +168 -168
  87. package/dist/templates/cc-native/_cc-native/lib-ts/plan-discovery.ts +80 -80
  88. package/dist/templates/cc-native/_cc-native/lib-ts/plan-enhancement.ts +41 -41
  89. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/CLAUDE.md +480 -480
  90. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/embedding-indexer.ts +287 -287
  91. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/hyde.ts +148 -148
  92. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/index.ts +54 -54
  93. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/logger.ts +58 -58
  94. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/ollama-client.ts +208 -208
  95. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/retrieval-pipeline.ts +460 -460
  96. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/transcript-indexer.ts +446 -446
  97. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/transcript-loader.ts +280 -280
  98. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/transcript-searcher.ts +274 -274
  99. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/types.ts +201 -201
  100. package/dist/templates/cc-native/_cc-native/lib-ts/rlm/vector-store.ts +278 -278
  101. package/dist/templates/cc-native/_cc-native/lib-ts/settings.ts +184 -184
  102. package/dist/templates/cc-native/_cc-native/lib-ts/state.ts +275 -275
  103. package/dist/templates/cc-native/_cc-native/lib-ts/tsconfig.json +18 -18
  104. package/dist/templates/cc-native/_cc-native/lib-ts/types.ts +1 -1
  105. package/dist/templates/cc-native/_cc-native/plan-review/CLAUDE.md +149 -0
  106. package/dist/templates/cc-native/_cc-native/plan-review/agents/CLAUDE.md +143 -0
  107. package/dist/templates/cc-native/_cc-native/plan-review/agents/PLAN-ORCHESTRATOR.md +213 -0
  108. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-questions/PLAN-QUESTIONER.md +70 -0
  109. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/ARCH-EVOLUTION.md +62 -0
  110. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/ARCH-PATTERNS.md +61 -0
  111. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/ARCH-STRUCTURE.md +62 -0
  112. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/ASSUMPTION-TRACER.md +56 -0
  113. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/CLARITY-AUDITOR.md +53 -0
  114. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/COMPLETENESS-FEASIBILITY.md +66 -0
  115. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/COMPLETENESS-GAPS.md +70 -0
  116. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/COMPLETENESS-ORDERING.md +62 -0
  117. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/CONSTRAINT-VALIDATOR.md +72 -0
  118. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/DESIGN-ADR-VALIDATOR.md +61 -0
  119. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/DESIGN-SCALE-MATCHER.md +64 -0
  120. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/DEVILS-ADVOCATE.md +56 -0
  121. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/DOCUMENTATION-PHILOSOPHY.md +86 -0
  122. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/HANDOFF-READINESS.md +59 -0
  123. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/HIDDEN-COMPLEXITY.md +58 -0
  124. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/INCREMENTAL-DELIVERY.md +66 -0
  125. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/RISK-DEPENDENCY.md +62 -0
  126. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/RISK-FMEA.md +66 -0
  127. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/RISK-PREMORTEM.md +71 -0
  128. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/RISK-REVERSIBILITY.md +74 -0
  129. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/SCOPE-BOUNDARY.md +77 -0
  130. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/SIMPLICITY-GUARDIAN.md +62 -0
  131. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/SKEPTIC.md +68 -0
  132. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TESTDRIVEN-BEHAVIOR-AUDITOR.md +61 -0
  133. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TESTDRIVEN-CHARACTERIZATION.md +71 -0
  134. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TESTDRIVEN-FIRST-VALIDATOR.md +61 -0
  135. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TESTDRIVEN-PYRAMID-ANALYZER.md +61 -0
  136. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TRADEOFF-COSTS.md +67 -0
  137. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/TRADEOFF-STAKEHOLDERS.md +65 -0
  138. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/VERIFY-COVERAGE.md +74 -0
  139. package/dist/templates/cc-native/_cc-native/plan-review/agents/plan-review/VERIFY-STRENGTH.md +69 -0
  140. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/agent-selection.ts +3 -3
  141. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/corroboration.ts +1 -1
  142. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/graduation.ts +1 -1
  143. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/orchestrator.ts +2 -2
  144. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/output-builder.ts +3 -3
  145. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/plan-questions.ts +6 -6
  146. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/review-pipeline.ts +15 -15
  147. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/agent.ts +5 -5
  148. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/base/base-agent.ts +4 -4
  149. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/providers/claude-agent.ts +4 -4
  150. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/providers/codex-agent.ts +6 -6
  151. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/providers/gemini-agent.ts +1 -1
  152. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/providers/orchestrator-claude-agent.ts +4 -4
  153. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/types.ts +3 -3
  154. package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/verdict.ts +1 -1
  155. package/oclif.manifest.json +1 -1
  156. package/package.json +108 -108
  157. package/dist/templates/cc-native/_cc-native/lib-ts/artifacts.ts +0 -21
  158. package/dist/templates/cc-native/_cc-native/lib-ts/nul +0 -3
  159. /package/dist/templates/cc-native/_cc-native/{lib-ts/artifacts → artifacts/lib}/index.ts +0 -0
  160. /package/dist/templates/cc-native/_cc-native/{lib-ts/artifacts → artifacts/lib}/tracker.ts +0 -0
  161. /package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/index.ts +0 -0
  162. /package/dist/templates/cc-native/_cc-native/{lib-ts → plan-review/lib}/reviewers/schemas.ts +0 -0
  163. /package/dist/templates/cc-native/_cc-native/{workflows → plan-review/workflows}/specdev.md +0 -0
@@ -1,163 +1,163 @@
1
- #!/usr/bin/env bun
2
- /**
3
- * SessionStart hook: Restore context after /clear (plan/handoff) or compaction.
4
- * Routes by source field to appropriate handler.
5
- */
6
- import {
7
- loadHookInput, emitContext, runHook, runHookAsync,
8
- logDebug, logInfo, logWarn, logError, logDiagnostic,
9
- } from "../lib-ts/base/hook-utils.js";
10
- import { getProjectRoot } from "../lib-ts/base/constants.js";
11
- import {
12
- getContextBySessionId, getAllContexts, bindSession, updateMode, determineArtifactType,
13
- } from "../lib-ts/context/context-store.js";
14
- import {
15
- buildRestoreSections, formatHandoffContinuation, getModeDisplay,
16
- buildContextInventory,
17
- } from "../lib-ts/context/context-formatter.js";
18
- import type { ContextState } from "../lib-ts/types.js";
19
-
20
- /**
21
- * Handle post-compaction restore: re-inject context that was lost during compaction.
22
- * Plan content is inlined because Claude doesn't auto-paste after compact.
23
- */
24
- function handleCompactRestore(sessionId: string, projectRoot: string): void {
25
- const state = getContextBySessionId(sessionId, projectRoot);
26
- if (!state) {
27
- logDebug("session_start", `No context for session ${sessionId} (compact)`);
28
- return;
29
- }
30
-
31
- const sections: string[] = [
32
- `## Resuming Context After Compaction: ${state.id}`,
33
- "",
34
- `**Summary:** ${state.summary}`,
35
- `**Mode:** ${getModeDisplay(state.mode) || state.mode}`,
36
- `**Session ID:** ${sessionId}`,
37
- "",
38
- ];
39
-
40
- // Inline plan = true (plan not auto-pasted after compact)
41
- const restore = buildRestoreSections(state, projectRoot, true);
42
- if (restore) sections.push(restore);
43
-
44
- const inventory = buildContextInventory(state, projectRoot);
45
- if (inventory) sections.push("", inventory);
46
-
47
- sections.push(
48
- "",
49
- "---",
50
- "*Context was compacted to free up space. The above restores your working state.*",
51
- );
52
-
53
- emitContext(sections.join("\n"));
54
- logInfo("session_start", `Compact restore for ${state.id}`);
55
- }
56
-
57
- /**
58
- * Handle post-clear restore: find staged has_staged_work context,
59
- * bind session, transition to active, inject context.
60
- */
61
- async function handleClearRestore(
62
- sessionId: string,
63
- projectRoot: string,
64
- ): Promise<void> {
65
- const allContexts = getAllContexts("active", projectRoot);
66
-
67
- // Find staged contexts (CHANGED: unified mode search)
68
- const staged = allContexts.filter((c) => c.mode === "has_staged_work");
69
- if (staged.length === 0) {
70
- logDebug("session_start", "No has_staged_work contexts found");
71
- return;
72
- }
73
-
74
- // Pick most recent (getAllContexts sorts by last_active desc)
75
- const ctx = staged[0]!;
76
- const artifactType = determineArtifactType(ctx);
77
-
78
- // Edge case: has_staged_work mode but no artifacts (corrupted state)
79
- // Graceful degradation: Reset mode to idle, log warning, skip restoration
80
- if (!artifactType) {
81
- logWarn(
82
- "session_start",
83
- `has_staged_work context ${ctx.id} has no artifacts - corrupted state, resetting to idle`,
84
- );
85
- updateMode(ctx.id, "idle", projectRoot);
86
- return;
87
- }
88
-
89
- // Bind and consume (CHANGED: unified flag)
90
- bindSession(ctx.id, sessionId, projectRoot);
91
- updateMode(ctx.id, "active", projectRoot, {
92
- work_consumed: true, // CHANGED: unified flag
93
- plan_hash_consumed: artifactType === "plan" ? ctx.plan_hash : undefined,
94
- });
95
-
96
- logInfo(
97
- "session_start",
98
- `Restored ${ctx.id}: has_staged_work → active (${artifactType})`,
99
- );
100
-
101
- // Build context sections (dispatch by artifact type)
102
- const sections: string[] = [
103
- `## Resuming Context After ${artifactType === "plan" ? "Plan" : "Handoff"} Clear: ${ctx.id}`,
104
- "",
105
- `**Summary:** ${ctx.summary}`,
106
- `**Mode:** Active (${artifactType === "plan" ? "Plan" : "Handoff"} Restored)`,
107
- `**Session ID:** ${sessionId}`,
108
- "",
109
- ];
110
-
111
- if (artifactType === "plan") {
112
- // Plan restoration (inline_plan=false, Claude auto-pastes)
113
- const restore = buildRestoreSections(ctx, projectRoot, false);
114
- if (restore) sections.push(restore);
115
- } else {
116
- // Handoff restoration (inject content via hook)
117
- const handoffContent = formatHandoffContinuation(ctx, projectRoot);
118
- sections.push(handoffContent);
119
- }
120
-
121
- const inventory = buildContextInventory(ctx, projectRoot);
122
- if (inventory) sections.push("", inventory);
123
-
124
- sections.push(
125
- "",
126
- "---",
127
- artifactType === "plan"
128
- ? "*Plan has been accepted. The plan content was auto-pasted above. Implement according to the plan.*"
129
- : "*Handoff document has been loaded. Continue the work from where it was left off.*",
130
- );
131
-
132
- emitContext(sections.join("\n"));
133
- }
134
-
135
- async function main(): Promise<void> {
136
- const payload = loadHookInput();
137
- if (!payload) return;
138
-
139
- const sessionId = payload.session_id;
140
- if (!sessionId) {
141
- logDebug("session_start", "No session_id");
142
- return;
143
- }
144
-
145
- const projectRoot = getProjectRoot(payload.cwd);
146
- const source = payload.source ?? "";
147
-
148
- logDiagnostic("session_start", "entry", `source=${source}, session=${sessionId}`);
149
-
150
- switch (source) {
151
- case "compact":
152
- handleCompactRestore(sessionId, projectRoot);
153
- break;
154
- case "clear":
155
- await handleClearRestore(sessionId, projectRoot);
156
- break;
157
- default:
158
- logDebug("session_start", `Unhandled source: ${source}`);
159
- break;
160
- }
161
- }
162
-
163
- runHookAsync(main, "session_start");
1
+ #!/usr/bin/env bun
2
+ /**
3
+ * SessionStart hook: Restore context after /clear (plan/handoff) or compaction.
4
+ * Routes by source field to appropriate handler.
5
+ */
6
+ import {
7
+ loadHookInput, emitContext, runHook, runHookAsync,
8
+ logDebug, logInfo, logWarn, logError, logDiagnostic,
9
+ } from "../lib-ts/base/hook-utils.js";
10
+ import { getProjectRoot } from "../lib-ts/base/constants.js";
11
+ import {
12
+ getContextBySessionId, getAllContexts, bindSession, updateMode, determineArtifactType,
13
+ } from "../lib-ts/context/context-store.js";
14
+ import {
15
+ buildRestoreSections, formatHandoffContinuation, getModeDisplay,
16
+ buildContextInventory,
17
+ } from "../lib-ts/context/context-formatter.js";
18
+ import type { ContextState } from "../lib-ts/types.js";
19
+
20
+ /**
21
+ * Handle post-compaction restore: re-inject context that was lost during compaction.
22
+ * Plan content is inlined because Claude doesn't auto-paste after compact.
23
+ */
24
+ function handleCompactRestore(sessionId: string, projectRoot: string): void {
25
+ const state = getContextBySessionId(sessionId, projectRoot);
26
+ if (!state) {
27
+ logDebug("session_start", `No context for session ${sessionId} (compact)`);
28
+ return;
29
+ }
30
+
31
+ const sections: string[] = [
32
+ `## Resuming Context After Compaction: ${state.id}`,
33
+ "",
34
+ `**Summary:** ${state.summary}`,
35
+ `**Mode:** ${getModeDisplay(state.mode) || state.mode}`,
36
+ `**Session ID:** ${sessionId}`,
37
+ "",
38
+ ];
39
+
40
+ // Inline plan = true (plan not auto-pasted after compact)
41
+ const restore = buildRestoreSections(state, projectRoot, true);
42
+ if (restore) sections.push(restore);
43
+
44
+ const inventory = buildContextInventory(state, projectRoot);
45
+ if (inventory) sections.push("", inventory);
46
+
47
+ sections.push(
48
+ "",
49
+ "---",
50
+ "*Context was compacted to free up space. The above restores your working state.*",
51
+ );
52
+
53
+ emitContext(sections.join("\n"));
54
+ logInfo("session_start", `Compact restore for ${state.id}`);
55
+ }
56
+
57
+ /**
58
+ * Handle post-clear restore: find staged has_staged_work context,
59
+ * bind session, transition to active, inject context.
60
+ */
61
+ async function handleClearRestore(
62
+ sessionId: string,
63
+ projectRoot: string,
64
+ ): Promise<void> {
65
+ const allContexts = getAllContexts("active", projectRoot);
66
+
67
+ // Find staged contexts (CHANGED: unified mode search)
68
+ const staged = allContexts.filter((c) => c.mode === "has_staged_work");
69
+ if (staged.length === 0) {
70
+ logDebug("session_start", "No has_staged_work contexts found");
71
+ return;
72
+ }
73
+
74
+ // Pick most recent (getAllContexts sorts by last_active desc)
75
+ const ctx = staged[0]!;
76
+ const artifactType = determineArtifactType(ctx);
77
+
78
+ // Edge case: has_staged_work mode but no artifacts (corrupted state)
79
+ // Graceful degradation: Reset mode to idle, log warning, skip restoration
80
+ if (!artifactType) {
81
+ logWarn(
82
+ "session_start",
83
+ `has_staged_work context ${ctx.id} has no artifacts - corrupted state, resetting to idle`,
84
+ );
85
+ updateMode(ctx.id, "idle", projectRoot);
86
+ return;
87
+ }
88
+
89
+ // Bind and consume (CHANGED: unified flag)
90
+ bindSession(ctx.id, sessionId, projectRoot);
91
+ updateMode(ctx.id, "active", projectRoot, {
92
+ work_consumed: true, // CHANGED: unified flag
93
+ plan_hash_consumed: artifactType === "plan" ? ctx.plan_hash : undefined,
94
+ });
95
+
96
+ logInfo(
97
+ "session_start",
98
+ `Restored ${ctx.id}: has_staged_work → active (${artifactType})`,
99
+ );
100
+
101
+ // Build context sections (dispatch by artifact type)
102
+ const sections: string[] = [
103
+ `## Resuming Context After ${artifactType === "plan" ? "Plan" : "Handoff"} Clear: ${ctx.id}`,
104
+ "",
105
+ `**Summary:** ${ctx.summary}`,
106
+ `**Mode:** Active (${artifactType === "plan" ? "Plan" : "Handoff"} Restored)`,
107
+ `**Session ID:** ${sessionId}`,
108
+ "",
109
+ ];
110
+
111
+ if (artifactType === "plan") {
112
+ // Plan restoration (inline_plan=false, Claude auto-pastes)
113
+ const restore = buildRestoreSections(ctx, projectRoot, false);
114
+ if (restore) sections.push(restore);
115
+ } else {
116
+ // Handoff restoration (inject content via hook)
117
+ const handoffContent = formatHandoffContinuation(ctx, projectRoot);
118
+ sections.push(handoffContent);
119
+ }
120
+
121
+ const inventory = buildContextInventory(ctx, projectRoot);
122
+ if (inventory) sections.push("", inventory);
123
+
124
+ sections.push(
125
+ "",
126
+ "---",
127
+ artifactType === "plan"
128
+ ? "*Plan has been accepted. The plan content was auto-pasted above. Implement according to the plan.*"
129
+ : "*Handoff document has been loaded. Continue the work from where it was left off.*",
130
+ );
131
+
132
+ emitContext(sections.join("\n"));
133
+ }
134
+
135
+ async function main(): Promise<void> {
136
+ const payload = loadHookInput();
137
+ if (!payload) return;
138
+
139
+ const sessionId = payload.session_id;
140
+ if (!sessionId) {
141
+ logDebug("session_start", "No session_id");
142
+ return;
143
+ }
144
+
145
+ const projectRoot = getProjectRoot(payload.cwd);
146
+ const source = payload.source ?? "";
147
+
148
+ logDiagnostic("session_start", "entry", `source=${source}, session=${sessionId}`);
149
+
150
+ switch (source) {
151
+ case "compact":
152
+ handleCompactRestore(sessionId, projectRoot);
153
+ break;
154
+ case "clear":
155
+ await handleClearRestore(sessionId, projectRoot);
156
+ break;
157
+ default:
158
+ logDebug("session_start", `Unhandled source: ${source}`);
159
+ break;
160
+ }
161
+ }
162
+
163
+ runHookAsync(main, "session_start");
@@ -1,48 +1,48 @@
1
- #!/usr/bin/env bun
2
- /**
3
- * PostToolUse:TaskCreate hook: Persist Claude's TaskCreate calls to state.json.
4
- */
5
- import { getProjectRoot } from "../lib-ts/base/constants.js";
6
- import {
7
- checkSkipPersistence, getToolInput, loadHookInput, logDebug,
8
- logError, logInfo, logWarn, runHook, validateHookEvent,
9
- } from "../lib-ts/base/hook-utils.js";
10
- import { getContextBySessionId } from "../lib-ts/context/context-store.js";
11
- import { addTask } from "../lib-ts/context/task-tracker.js";
12
-
13
- function main(): void {
14
- const payload = loadHookInput();
15
- if (!payload) return;
16
- if (!validateHookEvent(payload, "PostToolUse", "TaskCreate")) return;
17
-
18
- const toolInput = getToolInput(payload);
19
- if (!toolInput) return;
20
- if (checkSkipPersistence(payload, "task_create_capture")) return;
21
-
22
- const projectRoot = getProjectRoot(payload.cwd);
23
- const sessionId = payload.session_id ?? "unknown";
24
-
25
- const state = getContextBySessionId(sessionId, projectRoot);
26
- if (!state) {
27
- logDebug("task_create_capture", `No context for session ${sessionId}`);
28
- return;
29
- }
30
-
31
- const subject = toolInput.subject as string | undefined;
32
- if (!subject) {
33
- logWarn("task_create_capture", "TaskCreate missing subject field");
34
- return;
35
- }
36
-
37
- const description = (toolInput.description as string) ?? "";
38
- const activeForm = (toolInput.activeForm as string) ?? "";
39
-
40
- const task = addTask(state.id, subject, description, activeForm, sessionId, projectRoot);
41
- if (task) {
42
- logInfo("task_create_capture", `Persisted task ${task.id}: ${subject}`);
43
- } else {
44
- logError("task_create_capture", `Failed to persist task: ${subject}`);
45
- }
46
- }
47
-
48
- runHook(main, "task_create_capture");
1
+ #!/usr/bin/env bun
2
+ /**
3
+ * PostToolUse:TaskCreate hook: Persist Claude's TaskCreate calls to state.json.
4
+ */
5
+ import { getProjectRoot } from "../lib-ts/base/constants.js";
6
+ import {
7
+ checkSkipPersistence, getToolInput, loadHookInput, logDebug,
8
+ logError, logInfo, logWarn, runHook, validateHookEvent,
9
+ } from "../lib-ts/base/hook-utils.js";
10
+ import { getContextBySessionId } from "../lib-ts/context/context-store.js";
11
+ import { addTask } from "../lib-ts/context/task-tracker.js";
12
+
13
+ function main(): void {
14
+ const payload = loadHookInput();
15
+ if (!payload) return;
16
+ if (!validateHookEvent(payload, "PostToolUse", "TaskCreate")) return;
17
+
18
+ const toolInput = getToolInput(payload);
19
+ if (!toolInput) return;
20
+ if (checkSkipPersistence(payload, "task_create_capture")) return;
21
+
22
+ const projectRoot = getProjectRoot(payload.cwd);
23
+ const sessionId = payload.session_id ?? "unknown";
24
+
25
+ const state = getContextBySessionId(sessionId, projectRoot);
26
+ if (!state) {
27
+ logDebug("task_create_capture", `No context for session ${sessionId}`);
28
+ return;
29
+ }
30
+
31
+ const subject = toolInput.subject as string | undefined;
32
+ if (!subject) {
33
+ logWarn("task_create_capture", "TaskCreate missing subject field");
34
+ return;
35
+ }
36
+
37
+ const description = (toolInput.description as string) ?? "";
38
+ const activeForm = (toolInput.activeForm as string) ?? "";
39
+
40
+ const task = addTask(state.id, subject, description, activeForm, sessionId, projectRoot);
41
+ if (task) {
42
+ logInfo("task_create_capture", `Persisted task ${task.id}: ${subject}`);
43
+ } else {
44
+ logError("task_create_capture", `Failed to persist task: ${subject}`);
45
+ }
46
+ }
47
+
48
+ runHook(main, "task_create_capture");
@@ -1,74 +1,74 @@
1
- #!/usr/bin/env bun
2
- /**
3
- * PostToolUse:TaskUpdate hook: Persist Claude's TaskUpdate calls to state.json.
4
- * Maps Claude's ephemeral task IDs to persistent aiw-N IDs.
5
- */
6
- import { getProjectRoot } from "../lib-ts/base/constants.js";
7
- import {
8
- checkSkipPersistence, getToolInput, loadHookInput, logDebug,
9
- logError as _logError, logInfo, logWarn, runHook, validateHookEvent,
10
- } from "../lib-ts/base/hook-utils.js";
11
- import { getContextBySessionId } from "../lib-ts/context/context-store.js";
12
- import { deleteTask, updateTask } from "../lib-ts/context/task-tracker.js";
13
-
14
- function main(): void {
15
- const payload = loadHookInput();
16
- if (!payload) return;
17
- if (!validateHookEvent(payload, "PostToolUse", "TaskUpdate")) return;
18
-
19
- const toolInput = getToolInput(payload);
20
- if (!toolInput) return;
21
- if (checkSkipPersistence(payload, "task_update_capture")) return;
22
-
23
- const projectRoot = getProjectRoot(payload.cwd);
24
- const sessionId = payload.session_id ?? "unknown";
25
-
26
- const state = getContextBySessionId(sessionId, projectRoot);
27
- if (!state) {
28
- logDebug("task_update_capture", `No context for session ${sessionId}`);
29
- return;
30
- }
31
-
32
- const claudeTaskId = toolInput.taskId as string | undefined;
33
- if (!claudeTaskId) {
34
- logWarn("task_update_capture", "TaskUpdate missing taskId");
35
- return;
36
- }
37
-
38
- // Map Claude's ephemeral ID to persistent ID
39
- const metadata = (toolInput.metadata ?? {}) as Record<string, any>;
40
- const persistentId = (metadata.persistent_id as string) ?? `aiw-${claudeTaskId}`;
41
-
42
- const status = toolInput.status as string | undefined;
43
-
44
- if (status === "deleted") {
45
- const ok = deleteTask(state.id, persistentId, projectRoot);
46
- if (ok) {
47
- logInfo("task_update_capture", `Deleted task ${persistentId}`);
48
- } else {
49
- logWarn("task_update_capture", `Task ${persistentId} not found for deletion`);
50
- }
51
-
52
- return;
53
- }
54
-
55
- if (status) {
56
- const opts: Record<string, any> = { status };
57
- if (metadata.evidence) opts.evidence = metadata.evidence;
58
- if (metadata.work_summary) opts.work_summary = metadata.work_summary;
59
- if (metadata.files_changed && Array.isArray(metadata.files_changed)) {
60
- opts.files_changed = metadata.files_changed;
61
- }
62
-
63
- opts.session_id = sessionId;
64
-
65
- const ok = updateTask(state.id, persistentId, opts, projectRoot);
66
- if (ok) {
67
- logInfo("task_update_capture", `Updated task ${persistentId} → ${status}`);
68
- } else {
69
- logWarn("task_update_capture", `Task ${persistentId} not found for update`);
70
- }
71
- }
72
- }
73
-
74
- runHook(main, "task_update_capture");
1
+ #!/usr/bin/env bun
2
+ /**
3
+ * PostToolUse:TaskUpdate hook: Persist Claude's TaskUpdate calls to state.json.
4
+ * Maps Claude's ephemeral task IDs to persistent aiw-N IDs.
5
+ */
6
+ import { getProjectRoot } from "../lib-ts/base/constants.js";
7
+ import {
8
+ checkSkipPersistence, getToolInput, loadHookInput, logDebug,
9
+ logError as _logError, logInfo, logWarn, runHook, validateHookEvent,
10
+ } from "../lib-ts/base/hook-utils.js";
11
+ import { getContextBySessionId } from "../lib-ts/context/context-store.js";
12
+ import { deleteTask, updateTask } from "../lib-ts/context/task-tracker.js";
13
+
14
+ function main(): void {
15
+ const payload = loadHookInput();
16
+ if (!payload) return;
17
+ if (!validateHookEvent(payload, "PostToolUse", "TaskUpdate")) return;
18
+
19
+ const toolInput = getToolInput(payload);
20
+ if (!toolInput) return;
21
+ if (checkSkipPersistence(payload, "task_update_capture")) return;
22
+
23
+ const projectRoot = getProjectRoot(payload.cwd);
24
+ const sessionId = payload.session_id ?? "unknown";
25
+
26
+ const state = getContextBySessionId(sessionId, projectRoot);
27
+ if (!state) {
28
+ logDebug("task_update_capture", `No context for session ${sessionId}`);
29
+ return;
30
+ }
31
+
32
+ const claudeTaskId = toolInput.taskId as string | undefined;
33
+ if (!claudeTaskId) {
34
+ logWarn("task_update_capture", "TaskUpdate missing taskId");
35
+ return;
36
+ }
37
+
38
+ // Map Claude's ephemeral ID to persistent ID
39
+ const metadata = (toolInput.metadata ?? {}) as Record<string, any>;
40
+ const persistentId = (metadata.persistent_id as string) ?? `aiw-${claudeTaskId}`;
41
+
42
+ const status = toolInput.status as string | undefined;
43
+
44
+ if (status === "deleted") {
45
+ const ok = deleteTask(state.id, persistentId, projectRoot);
46
+ if (ok) {
47
+ logInfo("task_update_capture", `Deleted task ${persistentId}`);
48
+ } else {
49
+ logWarn("task_update_capture", `Task ${persistentId} not found for deletion`);
50
+ }
51
+
52
+ return;
53
+ }
54
+
55
+ if (status) {
56
+ const opts: Record<string, any> = { status };
57
+ if (metadata.evidence) opts.evidence = metadata.evidence;
58
+ if (metadata.work_summary) opts.work_summary = metadata.work_summary;
59
+ if (metadata.files_changed && Array.isArray(metadata.files_changed)) {
60
+ opts.files_changed = metadata.files_changed;
61
+ }
62
+
63
+ opts.session_id = sessionId;
64
+
65
+ const ok = updateTask(state.id, persistentId, opts, projectRoot);
66
+ if (ok) {
67
+ logInfo("task_update_capture", `Updated task ${persistentId} → ${status}`);
68
+ } else {
69
+ logWarn("task_update_capture", `Task ${persistentId} not found for update`);
70
+ }
71
+ }
72
+ }
73
+
74
+ runHook(main, "task_update_capture");