aiwcli 0.12.3 → 0.12.7

package/dist/templates/_shared/hooks-ts/session_start.ts

@@ -1,151 +1,163 @@
-#!/usr/bin/env bun
-/**
- * SessionStart hook: Restore context after /clear (plan/handoff) or compaction.
- * Routes by source field to appropriate handler.
- */
-import {
-  loadHookInput, emitContext, runHook, runHookAsync,
-  logDebug, logInfo, logError, logDiagnostic,
-} from "../lib-ts/base/hook-utils.js";
-import { getProjectRoot } from "../lib-ts/base/constants.js";
-import {
-  getContextBySessionId, getAllContexts, bindSession, updateMode,
-} from "../lib-ts/context/context-store.js";
-import {
-  buildRestoreSections, formatHandoffContinuation, getModeDisplay,
-  buildContextInventory,
-} from "../lib-ts/context/context-formatter.js";
-import type { ContextState } from "../lib-ts/types.js";
-
-/**
- * Handle post-compaction restore: re-inject context that was lost during compaction.
- * Plan content is inlined because Claude doesn't auto-paste after compact.
- */
-function handleCompactRestore(sessionId: string, projectRoot: string): void {
-  const state = getContextBySessionId(sessionId, projectRoot);
-  if (!state) {
-    logDebug("session_start", `No context for session ${sessionId} (compact)`);
-    return;
-  }
-
-  const sections: string[] = [
-    `## Resuming Context After Compaction: ${state.id}`,
-    "",
-    `**Summary:** ${state.summary}`,
-    `**Mode:** ${getModeDisplay(state.mode) || state.mode}`,
-    "",
-  ];
-
-  // Inline plan = true (plan not auto-pasted after compact)
-  const restore = buildRestoreSections(state, projectRoot, true);
-  if (restore) sections.push(restore);
-
-  const inventory = buildContextInventory(state, projectRoot);
-  if (inventory) sections.push("", inventory);
-
-  sections.push(
-    "",
-    "---",
-    "*Context was compacted to free up space. The above restores your working state.*",
-  );
-
-  emitContext(sections.join("\n"));
-  logInfo("session_start", `Compact restore for ${state.id}`);
-}
-
-/**
- * Handle post-clear restore: find staged has_plan or has_handoff context,
- * bind session, transition to active, inject context.
- */
-async function handleClearRestore(sessionId: string, projectRoot: string): Promise<void> {
-  const allContexts = getAllContexts("active", projectRoot);
-
-  // Priority 1: has_plan contexts
-  const hasPlan = allContexts.filter(c => c.mode === "has_plan");
-  if (hasPlan.length > 0) {
-    // Pick most recently active (getAllContexts sorts by last_active desc)
-    const ctx = hasPlan[0]!;
-
-    bindSession(ctx.id, sessionId, projectRoot);
-    updateMode(ctx.id, "active", projectRoot, {
-      plan_consumed: true,
-      plan_hash_consumed: ctx.plan_hash  // Track which hash was consumed
-    });
-
-    logInfo("session_start", `Clear restore: ${ctx.id} has_plan → active (plan_consumed=true)`);
-
-    const sections: string[] = [
-      `## Resuming Context After Plan Clear: ${ctx.id}`,
-      "",
-      `**Summary:** ${ctx.summary}`,
-      `**Mode:** Active (Plan Restored)`,
-      "",
-    ];
-
-    // inline_plan=false — Claude auto-pastes plan content after /clear
-    const restore = buildRestoreSections(ctx, projectRoot, false);
-    if (restore) sections.push(restore);
-
-    const inventory = buildContextInventory(ctx, projectRoot);
-    if (inventory) sections.push("", inventory);
-
-    sections.push(
-      "",
-      "---",
-      "*Plan has been accepted. The plan content was auto-pasted above. Implement according to the plan.*",
-    );
-
-    emitContext(sections.join("\n"));
-    return;
-  }
-
-  // Priority 2: has_handoff contexts
-  const hasHandoff = allContexts.filter(c => c.mode === "has_handoff");
-  if (hasHandoff.length > 0) {
-    const ctx = hasHandoff[0]!;
-
-    bindSession(ctx.id, sessionId, projectRoot);
-    updateMode(ctx.id, "active", projectRoot, { handoff_consumed: true });
-
-    logInfo("session_start", `Clear restore: ${ctx.id} has_handoff → active (handoff_consumed=true)`);
-
-    const handoffContent = formatHandoffContinuation(ctx, projectRoot);
-    const handoffInventory = buildContextInventory(ctx, projectRoot);
-    const combined = handoffInventory ? handoffContent + "\n\n" + handoffInventory : handoffContent;
-    emitContext(combined);
-    return;
-  }
-
-  // Nothing to restore
-  logDebug("session_start", "No has_plan or has_handoff contexts found");
-}
-
-async function main(): Promise<void> {
-  const payload = loadHookInput();
-  if (!payload) return;
-
-  const sessionId = payload.session_id;
-  if (!sessionId) {
-    logDebug("session_start", "No session_id");
-    return;
-  }
-
-  const projectRoot = getProjectRoot(payload.cwd);
-  const source = payload.source ?? "";
-
-  logDiagnostic("session_start", "entry", `source=${source}, session=${sessionId}`);
-
-  switch (source) {
-    case "compact":
-      handleCompactRestore(sessionId, projectRoot);
-      break;
-    case "clear":
-      await handleClearRestore(sessionId, projectRoot);
-      break;
-    default:
-      logDebug("session_start", `Unhandled source: ${source}`);
-      break;
-  }
-}
-
-runHookAsync(main, "session_start");
+#!/usr/bin/env bun
+/**
+ * SessionStart hook: Restore context after /clear (plan/handoff) or compaction.
+ * Routes by source field to appropriate handler.
+ */
+import {
+  loadHookInput, emitContext, runHook, runHookAsync,
+  logDebug, logInfo, logWarn, logError, logDiagnostic,
+} from "../lib-ts/base/hook-utils.js";
+import { getProjectRoot } from "../lib-ts/base/constants.js";
+import {
+  getContextBySessionId, getAllContexts, bindSession, updateMode, determineArtifactType,
+} from "../lib-ts/context/context-store.js";
+import {
+  buildRestoreSections, formatHandoffContinuation, getModeDisplay,
+  buildContextInventory,
+} from "../lib-ts/context/context-formatter.js";
+import type { ContextState } from "../lib-ts/types.js";
+
+/**
+ * Handle post-compaction restore: re-inject context that was lost during compaction.
+ * Plan content is inlined because Claude doesn't auto-paste after compact.
+ */
+function handleCompactRestore(sessionId: string, projectRoot: string): void {
+  const state = getContextBySessionId(sessionId, projectRoot);
+  if (!state) {
+    logDebug("session_start", `No context for session ${sessionId} (compact)`);
+    return;
+  }
+
+  const sections: string[] = [
+    `## Resuming Context After Compaction: ${state.id}`,
+    "",
+    `**Summary:** ${state.summary}`,
+    `**Mode:** ${getModeDisplay(state.mode) || state.mode}`,
+    `**Session ID:** ${sessionId}`,
+    "",
+  ];
+
+  // Inline plan = true (plan not auto-pasted after compact)
+  const restore = buildRestoreSections(state, projectRoot, true);
+  if (restore) sections.push(restore);
+
+  const inventory = buildContextInventory(state, projectRoot);
+  if (inventory) sections.push("", inventory);
+
+  sections.push(
+    "",
+    "---",
+    "*Context was compacted to free up space. The above restores your working state.*",
+  );
+
+  emitContext(sections.join("\n"));
+  logInfo("session_start", `Compact restore for ${state.id}`);
+}
+
+/**
+ * Handle post-clear restore: find staged has_staged_work context,
+ * bind session, transition to active, inject context.
+ */
+async function handleClearRestore(
+  sessionId: string,
+  projectRoot: string,
+): Promise<void> {
+  const allContexts = getAllContexts("active", projectRoot);
+
+  // Find staged contexts (CHANGED: unified mode search)
+  const staged = allContexts.filter((c) => c.mode === "has_staged_work");
+  if (staged.length === 0) {
+    logDebug("session_start", "No has_staged_work contexts found");
+    return;
+  }
+
+  // Pick most recent (getAllContexts sorts by last_active desc)
+  const ctx = staged[0]!;
+  const artifactType = determineArtifactType(ctx);
+
+  // Edge case: has_staged_work mode but no artifacts (corrupted state)
+  // Graceful degradation: Reset mode to idle, log warning, skip restoration
+  if (!artifactType) {
+    logWarn(
+      "session_start",
+      `has_staged_work context ${ctx.id} has no artifacts - corrupted state, resetting to idle`,
+    );
+    updateMode(ctx.id, "idle", projectRoot);
+    return;
+  }
+
+  // Bind and consume (CHANGED: unified flag)
+  bindSession(ctx.id, sessionId, projectRoot);
+  updateMode(ctx.id, "active", projectRoot, {
+    work_consumed: true, // CHANGED: unified flag
+    plan_hash_consumed: artifactType === "plan" ? ctx.plan_hash : undefined,
+  });
+
+  logInfo(
+    "session_start",
+    `Restored ${ctx.id}: has_staged_work → active (${artifactType})`,
+  );
+
+  // Build context sections (dispatch by artifact type)
+  const sections: string[] = [
+    `## Resuming Context After ${artifactType === "plan" ? "Plan" : "Handoff"} Clear: ${ctx.id}`,
+    "",
+    `**Summary:** ${ctx.summary}`,
+    `**Mode:** Active (${artifactType === "plan" ? "Plan" : "Handoff"} Restored)`,
+    `**Session ID:** ${sessionId}`,
+    "",
+  ];
+
+  if (artifactType === "plan") {
+    // Plan restoration (inline_plan=false, Claude auto-pastes)
+    const restore = buildRestoreSections(ctx, projectRoot, false);
+    if (restore) sections.push(restore);
+  } else {
+    // Handoff restoration (inject content via hook)
+    const handoffContent = formatHandoffContinuation(ctx, projectRoot);
+    sections.push(handoffContent);
+  }
+
+  const inventory = buildContextInventory(ctx, projectRoot);
+  if (inventory) sections.push("", inventory);
+
+  sections.push(
+    "",
+    "---",
+    artifactType === "plan"
+      ? "*Plan has been accepted. The plan content was auto-pasted above. Implement according to the plan.*"
+      : "*Handoff document has been loaded. Continue the work from where it was left off.*",
+  );
+
+  emitContext(sections.join("\n"));
+}
+
+async function main(): Promise<void> {
+  const payload = loadHookInput();
+  if (!payload) return;
+
+  const sessionId = payload.session_id;
+  if (!sessionId) {
+    logDebug("session_start", "No session_id");
+    return;
+  }
+
+  const projectRoot = getProjectRoot(payload.cwd);
+  const source = payload.source ?? "";
+
+  logDiagnostic("session_start", "entry", `source=${source}, session=${sessionId}`);
+
+  switch (source) {
+    case "compact":
+      handleCompactRestore(sessionId, projectRoot);
+      break;
+    case "clear":
+      await handleClearRestore(sessionId, projectRoot);
+      break;
+    default:
+      logDebug("session_start", `Unhandled source: ${source}`);
+      break;
+  }
+}
+
+runHookAsync(main, "session_start");

package/dist/templates/_shared/hooks-ts/task_create_capture.ts

@@ -1,48 +1,48 @@
-#!/usr/bin/env bun
-/**
- * PostToolUse:TaskCreate hook: Persist Claude's TaskCreate calls to state.json.
- */
-import { getProjectRoot } from "../lib-ts/base/constants.js";
-import {
-  checkSkipPersistence, getToolInput, loadHookInput, logDebug,
-  logError, logInfo, logWarn, runHook, validateHookEvent,
-} from "../lib-ts/base/hook-utils.js";
-import { getContextBySessionId } from "../lib-ts/context/context-store.js";
-import { addTask } from "../lib-ts/context/task-tracker.js";
-
-function main(): void {
-  const payload = loadHookInput();
-  if (!payload) return;
-  if (!validateHookEvent(payload, "PostToolUse", "TaskCreate")) return;
-
-  const toolInput = getToolInput(payload);
-  if (!toolInput) return;
-  if (checkSkipPersistence(payload, "task_create_capture")) return;
-
-  const projectRoot = getProjectRoot(payload.cwd);
-  const sessionId = payload.session_id ?? "unknown";
-
-  const state = getContextBySessionId(sessionId, projectRoot);
-  if (!state) {
-    logDebug("task_create_capture", `No context for session ${sessionId}`);
-    return;
-  }
-
-  const subject = toolInput.subject as string | undefined;
-  if (!subject) {
-    logWarn("task_create_capture", "TaskCreate missing subject field");
-    return;
-  }
-
-  const description = (toolInput.description as string) ?? "";
-  const activeForm = (toolInput.activeForm as string) ?? "";
-
-  const task = addTask(state.id, subject, description, activeForm, sessionId, projectRoot);
-  if (task) {
-    logInfo("task_create_capture", `Persisted task ${task.id}: ${subject}`);
-  } else {
-    logError("task_create_capture", `Failed to persist task: ${subject}`);
-  }
-}
-
-runHook(main, "task_create_capture");
+#!/usr/bin/env bun
+/**
+ * PostToolUse:TaskCreate hook: Persist Claude's TaskCreate calls to state.json.
+ */
+import { getProjectRoot } from "../lib-ts/base/constants.js";
+import {
+  checkSkipPersistence, getToolInput, loadHookInput, logDebug,
+  logError, logInfo, logWarn, runHook, validateHookEvent,
+} from "../lib-ts/base/hook-utils.js";
+import { getContextBySessionId } from "../lib-ts/context/context-store.js";
+import { addTask } from "../lib-ts/context/task-tracker.js";
+
+function main(): void {
+  const payload = loadHookInput();
+  if (!payload) return;
+  if (!validateHookEvent(payload, "PostToolUse", "TaskCreate")) return;
+
+  const toolInput = getToolInput(payload);
+  if (!toolInput) return;
+  if (checkSkipPersistence(payload, "task_create_capture")) return;
+
+  const projectRoot = getProjectRoot(payload.cwd);
+  const sessionId = payload.session_id ?? "unknown";
+
+  const state = getContextBySessionId(sessionId, projectRoot);
+  if (!state) {
+    logDebug("task_create_capture", `No context for session ${sessionId}`);
+    return;
+  }
+
+  const subject = toolInput.subject as string | undefined;
+  if (!subject) {
+    logWarn("task_create_capture", "TaskCreate missing subject field");
+    return;
+  }
+
+  const description = (toolInput.description as string) ?? "";
+  const activeForm = (toolInput.activeForm as string) ?? "";
+
+  const task = addTask(state.id, subject, description, activeForm, sessionId, projectRoot);
+  if (task) {
+    logInfo("task_create_capture", `Persisted task ${task.id}: ${subject}`);
+  } else {
+    logError("task_create_capture", `Failed to persist task: ${subject}`);
+  }
+}
+
+runHook(main, "task_create_capture");

package/dist/templates/_shared/hooks-ts/task_update_capture.ts

@@ -1,74 +1,74 @@
-#!/usr/bin/env bun
-/**
- * PostToolUse:TaskUpdate hook: Persist Claude's TaskUpdate calls to state.json.
- * Maps Claude's ephemeral task IDs to persistent aiw-N IDs.
- */
-import { getProjectRoot } from "../lib-ts/base/constants.js";
-import {
-  checkSkipPersistence, getToolInput, loadHookInput, logDebug,
-  logError as _logError, logInfo, logWarn, runHook, validateHookEvent,
-} from "../lib-ts/base/hook-utils.js";
-import { getContextBySessionId } from "../lib-ts/context/context-store.js";
-import { deleteTask, updateTask } from "../lib-ts/context/task-tracker.js";
-
-function main(): void {
-  const payload = loadHookInput();
-  if (!payload) return;
-  if (!validateHookEvent(payload, "PostToolUse", "TaskUpdate")) return;
-
-  const toolInput = getToolInput(payload);
-  if (!toolInput) return;
-  if (checkSkipPersistence(payload, "task_update_capture")) return;
-
-  const projectRoot = getProjectRoot(payload.cwd);
-  const sessionId = payload.session_id ?? "unknown";
-
-  const state = getContextBySessionId(sessionId, projectRoot);
-  if (!state) {
-    logDebug("task_update_capture", `No context for session ${sessionId}`);
-    return;
-  }
-
-  const claudeTaskId = toolInput.taskId as string | undefined;
-  if (!claudeTaskId) {
-    logWarn("task_update_capture", "TaskUpdate missing taskId");
-    return;
-  }
-
-  // Map Claude's ephemeral ID to persistent ID
-  const metadata = (toolInput.metadata ?? {}) as Record<string, any>;
-  const persistentId = (metadata.persistent_id as string) ?? `aiw-${claudeTaskId}`;
-
-  const status = toolInput.status as string | undefined;
-
-  if (status === "deleted") {
-    const ok = deleteTask(state.id, persistentId, projectRoot);
-    if (ok) {
-      logInfo("task_update_capture", `Deleted task ${persistentId}`);
-    } else {
-      logWarn("task_update_capture", `Task ${persistentId} not found for deletion`);
-    }
-
-    return;
-  }
-
-  if (status) {
-    const opts: Record<string, any> = { status };
-    if (metadata.evidence) opts.evidence = metadata.evidence;
-    if (metadata.work_summary) opts.work_summary = metadata.work_summary;
-    if (metadata.files_changed && Array.isArray(metadata.files_changed)) {
-      opts.files_changed = metadata.files_changed;
-    }
-
-    opts.session_id = sessionId;
-
-    const ok = updateTask(state.id, persistentId, opts, projectRoot);
-    if (ok) {
-      logInfo("task_update_capture", `Updated task ${persistentId} → ${status}`);
-    } else {
-      logWarn("task_update_capture", `Task ${persistentId} not found for update`);
-    }
-  }
-}
-
-runHook(main, "task_update_capture");
+#!/usr/bin/env bun
+/**
+ * PostToolUse:TaskUpdate hook: Persist Claude's TaskUpdate calls to state.json.
+ * Maps Claude's ephemeral task IDs to persistent aiw-N IDs.
+ */
+import { getProjectRoot } from "../lib-ts/base/constants.js";
+import {
+  checkSkipPersistence, getToolInput, loadHookInput, logDebug,
+  logError as _logError, logInfo, logWarn, runHook, validateHookEvent,
+} from "../lib-ts/base/hook-utils.js";
+import { getContextBySessionId } from "../lib-ts/context/context-store.js";
+import { deleteTask, updateTask } from "../lib-ts/context/task-tracker.js";
+
+function main(): void {
+  const payload = loadHookInput();
+  if (!payload) return;
+  if (!validateHookEvent(payload, "PostToolUse", "TaskUpdate")) return;
+
+  const toolInput = getToolInput(payload);
+  if (!toolInput) return;
+  if (checkSkipPersistence(payload, "task_update_capture")) return;
+
+  const projectRoot = getProjectRoot(payload.cwd);
+  const sessionId = payload.session_id ?? "unknown";
+
+  const state = getContextBySessionId(sessionId, projectRoot);
+  if (!state) {
+    logDebug("task_update_capture", `No context for session ${sessionId}`);
+    return;
+  }
+
+  const claudeTaskId = toolInput.taskId as string | undefined;
+  if (!claudeTaskId) {
+    logWarn("task_update_capture", "TaskUpdate missing taskId");
+    return;
+  }
+
+  // Map Claude's ephemeral ID to persistent ID
+  const metadata = (toolInput.metadata ?? {}) as Record<string, any>;
+  const persistentId = (metadata.persistent_id as string) ?? `aiw-${claudeTaskId}`;
+
+  const status = toolInput.status as string | undefined;
+
+  if (status === "deleted") {
+    const ok = deleteTask(state.id, persistentId, projectRoot);
+    if (ok) {
+      logInfo("task_update_capture", `Deleted task ${persistentId}`);
+    } else {
+      logWarn("task_update_capture", `Task ${persistentId} not found for deletion`);
+    }
+
+    return;
+  }
+
+  if (status) {
+    const opts: Record<string, any> = { status };
+    if (metadata.evidence) opts.evidence = metadata.evidence;
+    if (metadata.work_summary) opts.work_summary = metadata.work_summary;
+    if (metadata.files_changed && Array.isArray(metadata.files_changed)) {
+      opts.files_changed = metadata.files_changed;
+    }
+
+    opts.session_id = sessionId;
+
+    const ok = updateTask(state.id, persistentId, opts, projectRoot);
+    if (ok) {
+      logInfo("task_update_capture", `Updated task ${persistentId} → ${status}`);
+    } else {
+      logWarn("task_update_capture", `Task ${persistentId} not found for update`);
+    }
+  }
+}
+
+runHook(main, "task_update_capture");