aiwcli 0.10.3 → 0.11.0

package/dist/templates/_shared/lib-ts/context/context-store.ts

@@ -9,20 +9,21 @@
 
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { readStateJson, writeStateJson, toDict, dictToState } from "../base/state-io.js";
+
 import { atomicWrite } from "../base/atomic-write.js";
 import {
+  getArchiveContextDir,
+  getArchiveDir,
+  getArchiveIndexPath,
   getContextDir,
   getContextsDir,
   getIndexPath,
-  getArchiveDir,
-  getArchiveContextDir,
-  getArchiveIndexPath,
   validateContextId,
 } from "../base/constants.js";
-import { logDebug, logInfo, logWarn, logError, setContextPath } from "../base/logger.js";
-import { nowIso, generateContextId } from "../base/utils.js";
-import type { ContextState, IndexFile, IndexEntry, Mode } from "../types.js";
+import { logDebug as _logDebug, logError, logInfo, logWarn, setContextPath } from "../base/logger.js";
+import { dictToState as _dictToState, readStateJson, toDict as _toDict, writeStateJson } from "../base/state-io.js";
+import { generateContextId, nowIso } from "../base/utils.js";
+import type { ContextState, IndexEntry, IndexFile, Mode } from "../types.js";
 
 const INDEX_VERSION = "3.0";
 
@@ -34,12 +35,13 @@ function loadIndex(projectRoot?: string): IndexFile {
   const indexPath = getIndexPath(projectRoot);
   if (fs.existsSync(indexPath)) {
     try {
-      const raw = fs.readFileSync(indexPath, "utf-8");
+      const raw = fs.readFileSync(indexPath, "utf8");
       return JSON.parse(raw) as IndexFile;
-    } catch (e: any) {
-      logWarn("context_store", `Failed to read index, recreating: ${e}`);
+    } catch (error: any) {
+      logWarn("context_store", `Failed to read index, recreating: ${error}`);
     }
   }
+
   return { version: INDEX_VERSION, updated_at: nowIso(), sessions: {}, contexts: {} };
 }
 
@@ -50,6 +52,7 @@ function saveIndex(index: IndexFile, projectRoot?: string): boolean {
   if (!success) {
     logWarn("context_store", `Failed to write index: ${error}`);
   }
+
   return success;
 }
 
@@ -69,7 +72,7 @@ function migrateContextJson(contextId: string, projectRoot?: string): ContextSta
   if (!fs.existsSync(legacyPath)) return null;
 
   try {
-    const data = JSON.parse(fs.readFileSync(legacyPath, "utf-8"));
+    const data = JSON.parse(fs.readFileSync(legacyPath, "utf8"));
     const inFlight = data.in_flight ?? {};
     const oldMode = inFlight.mode ?? "none";
     const MODE_MIGRATION: Record<string, string> = {
@@ -104,8 +107,8 @@ function migrateContextJson(contextId: string, projectRoot?: string): ContextSta
       last_session: null,
       tasks: [],
     };
-  } catch (e: any) {
-    logWarn("context_store", `Failed to migrate context.json for '${contextId}': ${e}`);
+  } catch (error: any) {
+    logWarn("context_store", `Failed to migrate context.json for '${contextId}': ${error}`);
     return null;
   }
 }
@@ -134,7 +137,7 @@ export function saveState(
   contextId: string,
   state: ContextState,
   projectRoot?: string,
-): [boolean, string | null] {
+): [boolean, null | string] {
   // Ensure the state ID matches
   state.id = contextId;
 
@@ -152,10 +155,12 @@ export function saveState(
     if (!index.sessions) index.sessions = {} as Record<string, string>;
     index.sessions[sid] = contextId;
   }
+
   const indexOk = saveIndex(index, projectRoot);
   if (!indexOk) {
     return [true, "state.json saved but index.json update failed"];
   }
+
   return [true, null];
 }
 
@@ -165,7 +170,7 @@ export function saveState(
  * See SPEC.md §7.4
  */
 export function createContext(
-  contextId: string | null,
+  contextId: null | string,
   summary: string,
   method = "",
   projectRoot?: string,
@@ -185,23 +190,8 @@ export function createContext(
         } catch { /* ignore */ }
       }
     }
-    // generateContextId is async but we need sync here — use a simple fallback
-    const now = new Date();
-    const yy = String(now.getFullYear()).slice(2);
-    const mm = String(now.getMonth() + 1).padStart(2, "0");
-    const dd = String(now.getDate()).padStart(2, "0");
-    const hh = String(now.getHours()).padStart(2, "0");
-    const min = String(now.getMinutes()).padStart(2, "0");
-    const timestamp = `${yy}${mm}${dd}-${hh}${min}`;
-    const words = summary.toLowerCase().split(/\s+/).filter(w => w.length > 2).slice(0, 6);
-    const slug = words.length > 0 ? words.join("-").replace(/[^a-z0-9-]/g, "").slice(0, 50) : "context";
-    contextId = `${timestamp}-${slug}`;
-
-    if (existingIds.has(contextId)) {
-      let counter = 2;
-      while (existingIds.has(`${contextId}-${counter}`)) counter++;
-      contextId = `${contextId}-${counter}`;
-    }
+
+    contextId = generateContextId(summary, existingIds);
   }
 
   contextId = validateContextId(contextId);
@@ -251,6 +241,7 @@ export function getContext(contextId: string, projectRoot?: string): ContextStat
   } catch {
     return null;
   }
+
   return loadState(contextId, projectRoot);
 }
 
@@ -288,6 +279,7 @@ export function getAllContexts(
         try {
           if (!fs.statSync(fullPath).isDirectory()) continue;
         } catch { continue; }
+
         const state = loadState(entry, projectRoot);
         if (state && (!status || state.status === status)) {
           results.push(state);
@@ -306,7 +298,7 @@ export function getAllContexts(
  */
 export function updateContext(
   contextId: string,
-  updates: Partial<Pick<ContextState, "summary" | "tags" | "method">>,
+  updates: Partial<Pick<ContextState, "method" | "summary" | "tags">>,
   projectRoot?: string,
 ): ContextState | null {
   const state = getContext(contextId, projectRoot);
@@ -356,6 +348,7 @@ export function getContextBySessionId(
       return state;
     }
   }
+
   return null;
 }
 
@@ -387,6 +380,7 @@ export function bindSession(
   if (!state.session_ids.includes(sessionId)) {
     state.session_ids.push(sessionId);
   }
+
   state.last_active = nowIso();
 
   const [success] = saveState(contextId, state, projectRoot);
@@ -402,13 +396,13 @@ export function updateMode(
   mode: Mode,
   projectRoot?: string,
   opts?: {
-    plan_path?: string;
-    plan_hash?: string;
-    plan_signature?: string;
-    plan_id?: string;
+    handoff_consumed?: boolean;
     plan_anchors?: string[];
     plan_consumed?: boolean;
-    handoff_consumed?: boolean;
+    plan_hash?: string;
+    plan_id?: string;
+    plan_path?: string;
+    plan_signature?: string;
   },
 ): ContextState | null {
   const state = getContext(contextId, projectRoot);
@@ -506,6 +500,7 @@ export function archiveContext(contextId: string, projectRoot?: string): Context
     logWarn("context_store", `Cannot archive: context '${contextId}' not found`);
     return null;
   }
+
   if (state.status !== "completed") {
     logWarn("context_store", `Cannot archive: context '${contextId}' not completed`);
     return null;
@@ -524,8 +519,8 @@ export function archiveContext(contextId: string, projectRoot?: string): Context
 
   try {
     fs.renameSync(sourceDir, archiveDest);
-  } catch (e: any) {
-    logError("context_store", `Failed to move context to archive: ${e}`);
+  } catch (error: any) {
+    logError("context_store", `Failed to move context to archive: ${error}`);
     return null;
   }
 
@@ -536,6 +531,7 @@ export function archiveContext(contextId: string, projectRoot?: string): Context
   for (const [sid, cid] of Object.entries(sessions)) {
     if (cid === contextId) delete sessions[sid];
   }
+
   saveIndex(index, projectRoot);
 
   // Add to archive index
@@ -555,6 +551,7 @@ export function reopenContext(contextId: string, projectRoot?: string): ContextS
   if (!state) {
     state = restoreFromArchive(contextId, projectRoot);
   }
+
   if (!state) return null;
 
   if (state.status === "active") {
@@ -595,6 +592,35 @@ export function createContextFromPrompt(
   );
 }
 
+/**
+ * Find the active context ID programmatically.
+ * Checks CONTEXT_ID env var first, then searches for the single active context.
+ * Returns null if no active context or multiple active contexts found.
+ */
+export function findActiveContextId(projectRoot?: string): null | string {
+  // Env var takes priority
+  const envId = process.env.CONTEXT_ID;
+  if (envId) {
+    const ctx = getContext(envId, projectRoot);
+    if (ctx) return ctx.id;
+  }
+
+  // Search for active contexts
+  const active = getAllContexts("active", projectRoot)
+    .filter(c => c.mode === "active" || c.mode === "has_plan" || c.mode === "has_handoff");
+
+  if (active.length === 1) return active[0]!.id;
+  if (active.length > 1) {
+    // Multiple active — try to find the most recently active
+    const sorted = active.sort((a, b) =>
+      (b.last_active ?? "").localeCompare(a.last_active ?? ""),
+    );
+    return sorted[0]!.id;
+  }
+
+  return null;
+}
+
 // ---------------------------------------------------------------------------
 // Archive helpers
 // ---------------------------------------------------------------------------
@@ -613,9 +639,9 @@ function updateArchiveIndex(state: ContextState, projectRoot?: string): boolean
 
   if (fs.existsSync(archiveIndexPath)) {
     try {
-      archiveIndex = JSON.parse(fs.readFileSync(archiveIndexPath, "utf-8"));
-    } catch (e: any) {
-      logWarn("context_store", `Failed to read archive index, recreating: ${e}`);
+      archiveIndex = JSON.parse(fs.readFileSync(archiveIndexPath, "utf8"));
+    } catch (error_: any) {
+      logWarn("context_store", `Failed to read archive index, recreating: ${error_}`);
     }
   }
 
@@ -627,6 +653,7 @@ function updateArchiveIndex(state: ContextState, projectRoot?: string): boolean
   if (!success) {
     logWarn("context_store", `Failed to write archive index: ${error}`);
   }
+
   return success;
 }
 
@@ -642,8 +669,8 @@ function restoreFromArchive(contextId: string, projectRoot?: string): ContextSta
 
   try {
     fs.renameSync(archiveDir, activeDir);
-  } catch (e: any) {
-    logError("context_store", `Failed to restore context from archive: ${e}`);
+  } catch (error: any) {
+    logError("context_store", `Failed to restore context from archive: ${error}`);
     return null;
   }
 
@@ -660,7 +687,7 @@ function removeFromArchiveIndex(contextId: string, projectRoot?: string): boolea
   if (!fs.existsSync(archiveIndexPath)) return true;
 
   try {
-    const archiveIndex = JSON.parse(fs.readFileSync(archiveIndexPath, "utf-8")) as IndexFile;
+    const archiveIndex = JSON.parse(fs.readFileSync(archiveIndexPath, "utf8")) as IndexFile;
     if (archiveIndex.contexts[contextId]) {
       delete archiveIndex.contexts[contextId];
       archiveIndex.updated_at = nowIso();
@@ -671,9 +698,10 @@ function removeFromArchiveIndex(contextId: string, projectRoot?: string): boolea
         return false;
       }
     }
+
     return true;
-  } catch (e: any) {
-    logWarn("context_store", `Failed to read archive index: ${e}`);
+  } catch (error: any) {
+    logWarn("context_store", `Failed to read archive index: ${error}`);
     return false;
   }
 }

package/dist/templates/_shared/lib-ts/context/plan-manager.ts

@@ -8,14 +8,16 @@
  * - extractPlanPathFromResult: parse plan path from ExitPlanMode output
  */
 
+import * as crypto from "node:crypto";
 import * as fs from "node:fs";
 import * as path from "node:path";
-import * as crypto from "node:crypto";
-import { getContextDir, getContextPlansDir, sanitizeTitle } from "../base/constants.js";
+
 import { atomicWrite } from "../base/atomic-write.js";
+import { getContextDir as _getContextDir, getContextPlansDir, sanitizeTitle } from "../base/constants.js";
+import { logDebug, logError, logInfo, logWarn } from "../base/logger.js";
 import { readStateJson } from "../base/state-io.js";
-import { logDebug, logInfo, logWarn, logError } from "../base/logger.js";
-import type { ContextState } from "../types.js";
+import { generateSlug } from "../base/utils.js";
+import type { ContextState as _ContextState } from "../types.js";
 
 // ---------------------------------------------------------------------------
 // Plan archival
@@ -34,7 +36,7 @@ export async function archivePlan(
   planPath: string,
   contextId: string,
   projectRoot?: string,
-): Promise<[string | null, string | null, string | null]> {
+): Promise<[null | string, null | string, null | string]> {
   if (!fs.existsSync(planPath)) {
     logWarn("plan_manager", `Plan file not found: ${planPath}`);
     return [null, null, null];
@@ -42,9 +44,9 @@ export async function archivePlan(
 
   let content: string;
   try {
-    content = fs.readFileSync(planPath, "utf-8");
-  } catch (e: any) {
-    logError("plan_manager", `Failed to read plan: ${e}`);
+    content = fs.readFileSync(planPath, "utf8");
+  } catch (error_: any) {
+    logError("plan_manager", `Failed to read plan: ${error_}`);
     return [null, null, null];
   }
 
@@ -69,23 +71,12 @@ export async function archivePlan(
     String(now.getMinutes()).padStart(2, "0"),
   ].join("");
 
-  // Try AI inference for a descriptive slug
-  let slug: string | null = null;
-  try {
-    const { generateContextIdSlug } = await import("../base/inference.js");
-    const aiSlug = generateContextIdSlug(content.slice(0, 500), 5);
-    if (aiSlug) {
-      slug = sanitizeTitle(aiSlug, 60);
-    }
-  } catch {
-    // AI inference unavailable — use filename fallback
-  }
-
-  // Fallback: use plan filename
-  if (!slug) {
-    const stem = path.basename(planPath, path.extname(planPath));
-    slug = sanitizeTitle(stem, 30);
-  }
+  // Extract a clean summary from plan content for slug generation.
+  // Headings describe the plan's intent better than raw markdown body.
+  const summary = extractPlanSummary(content);
+  const slug = generateSlug(summary, 60, sanitizeTitle(
+    path.basename(planPath, path.extname(planPath)), 30,
+  ));
 
   let archiveName = `${dateStr}-${slug}.md`;
   let archivePath = path.join(plansDir, archiveName);
@@ -109,6 +100,37 @@ export async function archivePlan(
   return [archivePath, planHash, planSignature];
 }
 
+/**
+ * Extract a human-readable summary from plan markdown content.
+ * Pulls headings and the first substantial paragraph, producing
+ * text suitable for the AI slug generator (which expects conversational input).
+ */
+function extractPlanSummary(content: string): string {
+  const lines = content.split("\n");
+  const parts: string[] = [];
+  let firstParagraph = "";
+
+  for (const line of lines) {
+    const trimmed = line.trim();
+    // Collect markdown headings (strip # prefix)
+    if (trimmed.startsWith("#")) {
+      const heading = trimmed.replace(/^#+\s*/, "");
+      if (heading.length > 2) parts.push(heading);
+    }
+
+    // Grab first substantial non-heading line as context
+    if (!firstParagraph && !trimmed.startsWith("#") && trimmed.length > 20) {
+      firstParagraph = trimmed.slice(0, 120);
+    }
+
+    // Enough material for the AI
+    if (parts.length >= 5) break;
+  }
+
+  if (firstParagraph) parts.push(firstParagraph);
+  return parts.join(" ").slice(0, 500) || content.slice(0, 500);
+}
+
 // ---------------------------------------------------------------------------
 // Plan lookup
 // ---------------------------------------------------------------------------
@@ -121,15 +143,15 @@ export async function archivePlan(
 export function findLatestPlan(
   contextId: string,
   projectRoot?: string,
-): string | null {
+): null | string {
   // 1. Check state.json plan_path first
   try {
     const state = readStateJson(contextId, projectRoot);
     if (state?.plan_path && fs.existsSync(state.plan_path)) {
       return state.plan_path;
     }
-  } catch (e: any) {
-    logWarn("plan_manager", `Failed to check state.json plan_path: ${e}`);
+  } catch (error: any) {
+    logWarn("plan_manager", `Failed to check state.json plan_path: ${error}`);
   }
 
   // 2. Fall back to most recent .md in plans/ dir
@@ -162,7 +184,7 @@ export function findLatestPlan(
  * See SPEC.md §9.4
  */
 export function generatePlanId(): string {
-  return crypto.randomUUID().replace(/-/g, "").slice(0, 8);
+  return crypto.randomUUID().replaceAll('-', "").slice(0, 8);
 }
 
 /**
@@ -171,8 +193,8 @@ export function generatePlanId(): string {
  * See SPEC.md §9.5
  */
 export function normalizePlanContent(text: string): string {
-  let result = text.replace(/<[^>]+>/g, "");
-  result = result.replace(/\s+/g, " ").trim();
+  let result = text.replaceAll(/<[^>]+>/g, "");
+  result = result.replaceAll(/\s+/g, " ").trim();
   return result;
 }
 
@@ -190,8 +212,10 @@ export function extractPlanAnchors(content: string, maxAnchors = 5): string[] {
     } else if (anchors.length === 0 && trimmed.length > 20) {
       anchors.push(trimmed.slice(0, 80));
     }
+
     if (anchors.length >= maxAnchors) break;
   }
+
   return anchors;
 }
 
@@ -206,7 +230,7 @@ const MAX_TRANSCRIPT_SIZE = 50 * 1024 * 1024; // 50 MB
  * Searches in reverse for the most recent Write tool call targeting .claude/plans/.
  * See SPEC.md §9.7
  */
-export function findPlanPathInTranscript(transcriptPath: string): string | null {
+export function findPlanPathInTranscript(transcriptPath: string): null | string {
   if (!transcriptPath) return null;
 
   if (!fs.existsSync(transcriptPath)) {
@@ -228,9 +252,9 @@ export function findPlanPathInTranscript(transcriptPath: string): string | null
 
   let lines: string[];
   try {
-    lines = fs.readFileSync(transcriptPath, "utf-8").split("\n");
-  } catch (e: any) {
-    logWarn("plan_manager", `Failed to read transcript: ${e}`);
+    lines = fs.readFileSync(transcriptPath, "utf8").split("\n");
+  } catch (error: any) {
+    logWarn("plan_manager", `Failed to read transcript: ${error}`);
     return null;
   }
 
@@ -262,7 +286,7 @@ export function findPlanPathInTranscript(transcriptPath: string): string | null
       if (!filePath) continue;
 
       // Check if path contains .claude/plans/ as consecutive parts
-      const parts = filePath.replace(/\\/g, "/").split("/");
+      const parts = filePath.replaceAll('\\', "/").split("/");
       for (let j = 0; j < parts.length - 1; j++) {
         if (parts[j] === ".claude" && parts[j + 1] === "plans") {
           logInfo("plan_manager", `Extracted plan path from transcript: ${filePath}`);
@@ -285,7 +309,7 @@ export function findPlanPathInTranscript(transcriptPath: string): string | null
  * Parses the pattern: "Your plan has been saved to: <path>"
  * See SPEC.md §9.8
  */
-export function extractPlanPathFromResult(toolResult: string): string | null {
+export function extractPlanPathFromResult(toolResult: string): null | string {
   if (!toolResult) return null;
   const match = toolResult.match(/Your plan has been saved to:\s*(.+\.md)/);
   return match ? match[1]!.trim() : null;

package/dist/templates/_shared/lib-ts/context/task-tracker.ts

@@ -6,10 +6,10 @@
  * Uses state-io for I/O to avoid circular imports with context-store.
  */
 
-import { readStateJson, writeStateJson, toDict } from "../base/state-io.js";
 import { logWarn } from "../base/logger.js";
+import { readStateJson, toDict as _toDict, writeStateJson } from "../base/state-io.js";
 import { nowIso } from "../base/utils.js";
-import type { ContextState, Task } from "../types.js";
+import type { ContextState as _ContextState, Task } from "../types.js";
 
 // ---------------------------------------------------------------------------
 // Public API
@@ -27,7 +27,7 @@ export function generateNextTaskId(contextId: string, projectRoot?: string): str
   for (const t of tasks) {
     const match = /^aiw-(\d+)$/.exec(t.id);
     if (match) {
-      const num = parseInt(match[1]!, 10);
+      const num = Number.parseInt(match[1]!, 10);
       if (num > maxNum) maxNum = num;
     }
   }
@@ -46,7 +46,7 @@ export function addTask(
   activeForm = "",
   sessionId = "",
   projectRoot?: string,
-): Task | null {
+): null | Task {
   const state = readStateJson(contextId, projectRoot);
   if (!state) return null;
 
@@ -80,11 +80,11 @@ export function updateTask(
   contextId: string,
   taskId: string,
   opts?: {
-    status?: string;
     evidence?: string;
-    work_summary?: string;
     files_changed?: string[];
     session_id?: string;
+    status?: string;
+    work_summary?: string;
   },
   projectRoot?: string,
 ): boolean {
@@ -99,6 +99,7 @@ export function updateTask(
           task.completed_at = nowIso();
         }
       }
+
       if (opts?.evidence) task.evidence = opts.evidence;
       if (opts?.work_summary) task.work_summary = opts.work_summary;
       if (opts?.files_changed !== undefined) task.files_changed = opts.files_changed;
@@ -167,12 +168,15 @@ export function generateTaskSummary(contextId: string, projectRoot?: string): st
     const ws = t.work_summary ? `\n  Work: ${t.work_summary}` : "";
     lines.push(`- [x] ${t.id}: ${t.subject}${ws}`);
   }
+
   for (const t of inProgress) {
     lines.push(`- [~] ${t.id}: ${t.subject}`);
   }
+
   for (const t of pending) {
     lines.push(`- [ ] ${t.id}: ${t.subject}`);
   }
+
   for (const t of blocked) {
     lines.push(`- [!] ${t.id}: ${t.subject}`);
   }

package/dist/templates/_shared/lib-ts/handoff/document-generator.ts

@@ -6,17 +6,18 @@
  * work to a new session (typically due to context window limits).
  */
 
+import * as crypto from "node:crypto";
 import * as fs from "node:fs";
 import * as path from "node:path";
-import * as crypto from "node:crypto";
-import { getContextHandoffsDir, getContextDir } from "../base/constants.js";
+
 import { atomicWrite } from "../base/atomic-write.js";
-import { logInfo, logError } from "../base/logger.js";
+import { getContextDir, getContextHandoffsDir } from "../base/constants.js";
+import { logError, logInfo } from "../base/logger.js";
 import { nowIso } from "../base/utils.js";
-import { getContext, saveState } from "../context/context-store.js";
+import { getContext, saveState as _saveState } from "../context/context-store.js";
 import { getTasks } from "../context/task-tracker.js";
-import { renderTaskList, formatContinuationHeader, formatReason } from "../templates/formatters.js";
-import type { HandoffDocument, Task } from "../types.js";
+import { formatContinuationHeader, formatReason, renderTaskList } from "../templates/formatters.js";
+import type { HandoffDocument, Task as _Task } from "../types.js";
 
 /**
  * Generate and save a handoff document for a context.
@@ -124,8 +125,7 @@ function renderHandoffMarkdown(doc: HandoffDocument): string {
   );
 
   // Active tasks
-  lines.push(renderTaskList(doc.active_tasks, "Active Tasks", true).trimEnd());
-  lines.push("");
+  lines.push(renderTaskList(doc.active_tasks, "Active Tasks", true).trimEnd(), "");
 
   // Completed this session
   if (doc.completed_tasks_this_session.length > 0) {
@@ -133,8 +133,7 @@ function renderHandoffMarkdown(doc: HandoffDocument): string {
       doc.completed_tasks_this_session as any[],
       "Completed This Session",
       false,
-    ).trimEnd());
-    lines.push("");
+    ).trimEnd(), "");
   }
 
   // Work summary
@@ -148,6 +147,7 @@ function renderHandoffMarkdown(doc: HandoffDocument): string {
     for (let i = 0; i < doc.next_steps.length; i++) {
       lines.push(`${i + 1}. ${doc.next_steps[i]}`);
     }
+
     lines.push("");
   }
 
@@ -157,6 +157,7 @@ function renderHandoffMarkdown(doc: HandoffDocument): string {
     for (const note of doc.important_notes) {
       lines.push(`- ${note}`);
     }
+
     lines.push("");
   }