aiwcli 0.10.3 → 0.11.0

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

@@ -4,8 +4,8 @@
  */
 
 import { sanitizeTitle } from "./constants.js";
+import { logDebug, logError, logWarn } from "./logger.js";
 import { STOP_WORDS } from "./stop-words.js";
-import { logDebug, logWarn, logError } from "./logger.js";
 
 /**
  * Print to stderr. For terminal-only UX messages, not diagnostics.
@@ -77,22 +77,79 @@ export function parseIsoTimestamp(isoStr: string): Date | null {
 export function cleanTextForSlug(text: string): string {
   if (!text) return "";
   let result = text.toLowerCase();
-  result = result.replace(/'/g, "");            // i'm -> im, you're -> youre
-  result = result.replace(/[^a-z0-9\s]/g, " "); // punctuation -> spaces
-  result = result.replace(/\s+/g, " ").trim();
+  result = result.replaceAll('\'', "");            // i'm -> im, you're -> youre
+  result = result.replaceAll(/[^a-z0-9\s]/g, " "); // punctuation -> spaces
+  result = result.replaceAll(/\s+/g, " ").trim();
   return result;
 }
 
+/**
+ * Generate a slug from text using AI inference with stop-word fallbacks.
+ * Pipeline: AI inference → stop-word post-filter → stop-word fallback → word-length fallback.
+ * Reusable by both context ID generation and plan archival.
+ * See SPEC.md §14.2
+ */
+export function generateSlug(
+  text: string,
+  maxLen = 150,
+  fallbackSlug = "context",
+): string {
+  if (!text || !text.trim()) return fallbackSlug;
+
+  let slug: null | string = null;
+  const cleanedText = cleanTextForSlug(text);
+
+  // Tier 1: AI inference via generateContextIdSlug (sync — uses execFileSync)
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, no-undef
+    const { generateContextIdSlug } = require("./inference.js");
+    const aiSlug = generateContextIdSlug(text);
+    if (aiSlug) {
+      const filteredWords = aiSlug
+        .split(/\s+/)
+        .filter(
+          (w: string) => !STOP_WORDS.has(w.toLowerCase()) && w.length > 1,
+        );
+      if (filteredWords.length >= 5) {
+        slug = sanitizeTitle(filteredWords.join(" "), maxLen);
+      } else {
+        logDebug(
+          "utils",
+          `AI slug too generic after stop-word filter (${filteredWords.length} words remain), using fallback`,
+        );
+      }
+    }
+  } catch (error: any) {
+    logWarn("utils", `AI slug generation failed, using fallback: ${error}`);
+  }
+
+  // Tier 2: Stop-word filtering on cleaned text
+  if (!slug) {
+    const words = cleanedText
+      .split(/\s+/)
+      .filter((w) => !STOP_WORDS.has(w) && w.length > 1)
+      .slice(0, 12);
+    slug = words.length >= 3
+      ? sanitizeTitle(words.join(" "), maxLen)
+      : sanitizeTitle(
+          cleanedText.split(/\s+/).filter((w) => w.length > 2).slice(0, 6).join(" "),
+          maxLen,
+        ) || fallbackSlug;
+  }
+
+  return slug;
+}
+
 /**
  * Generate a context ID from a summary string.
  * Format: YYMMDD-HHMM-slug
- * 3-tier slug: AI inference → stop-word filter → simple word filter
+ * Delegates slug generation to generateSlug().
  * See SPEC.md §14.2
  */
-export async function generateContextId(
+export function generateContextId(
   summary: string,
   existingIds?: Set<string>,
-): Promise<string> {
+): string {
   const now = new Date();
   const yy = String(now.getFullYear()).slice(2);
   const mm = String(now.getMonth() + 1).padStart(2, "0");
@@ -104,70 +161,12 @@ export async function generateContextId(
   let baseId: string;
 
   try {
-    if (!summary || !summary.trim()) {
-      baseId = `${timestamp}-context`;
-    } else {
-      let slug: string | null = null;
-      // Pre-clean for Tier 2/3: strip punctuation so stop words match
-      const cleanedSummary = cleanTextForSlug(summary);
-
-      // Tier 1: AI inference (imported dynamically to avoid circular deps)
-      try {
-        const { generateContextIdSlug } = await import("./inference.js");
-        const aiSlug = generateContextIdSlug(summary);
-        if (aiSlug) {
-          const filteredWords = aiSlug
-            .split(/\s+/)
-            .filter(
-              (w: string) => !STOP_WORDS.has(w.toLowerCase()) && w.length > 1,
-            );
-          if (filteredWords.length >= 5) {
-            slug = sanitizeTitle(filteredWords.join(" "), 150);
-          } else {
-            logDebug(
-              "utils",
-              `AI slug too generic after stop-word filter (${filteredWords.length} words remain), using fallback`,
-            );
-          }
-        }
-      } catch (e: any) {
-        logWarn("utils", `AI context ID slug failed, using fallback: ${e}`);
-      }
-
-      // Tier 2: Stop-word filtering on cleaned text
-      if (!slug) {
-        try {
-          const words = cleanedSummary
-            .split(/\s+/)
-            .filter((w) => !STOP_WORDS.has(w) && w.length > 1)
-            .slice(0, 12);
-          if (words.length >= 3) {
-            slug = sanitizeTitle(words.join(" "), 150);
-          } else {
-            logDebug("utils", `Tier 2 too few content words (${words.length}), falling through to Tier 3`);
-          }
-        } catch (e: any) {
-          logWarn("utils", `Stop-word fallback failed: ${e}`);
-        }
-      }
-
-      // Tier 3: Simple word-length filter on cleaned text
-      if (!slug || slug === "unknown") {
-        const words = cleanedSummary
-          .split(/\s+/)
-          .filter((w) => w.length > 2)
-          .slice(0, 6);
-        slug = words.length > 0
-          ? sanitizeTitle(words.join(" "), 150)
-          : "context";
-      }
-
-      baseId = `${timestamp}-${slug}`;
-    }
-  } catch (e: any) {
+    const slug = generateSlug(summary);
+    baseId = `${timestamp}-${slug}`;
+  } catch (error: any) {
     logError(
       "utils",
-      `Context ID generation failed entirely, using timestamp: ${e}`,
+      `Context ID generation failed entirely, using timestamp: ${error}`,
     );
     baseId = `${timestamp}-context`;
   }
@@ -180,5 +179,6 @@ export async function generateContextId(
   while (existingIds.has(`${baseId}-${counter}`)) {
     counter++;
   }
+
   return `${baseId}-${counter}`;
 }

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

@@ -8,7 +8,8 @@
  */
 
 import * as fs from "node:fs";
-import * as path from "node:path";
+import * as _path from "node:path";
+
 import { parseIsoTimestamp } from "../base/utils.js";
 import type { ContextState, Task } from "../types.js";
 
@@ -41,10 +42,10 @@ export function getModeDisplay(mode: string): string {
  * Format ISO timestamp as '2 hours ago', 'yesterday', etc.
  * See SPEC.md §11.3
  */
-export function formatRelativeTime(isoTimestamp: string | null): string {
+export function formatRelativeTime(isoTimestamp: null | string): string {
   if (!isoTimestamp) return "unknown";
 
-  let dt = parseIsoTimestamp(isoTimestamp);
+  const dt = parseIsoTimestamp(isoTimestamp);
   if (!dt) return isoTimestamp.slice(0, 16);
 
   const now = new Date();
@@ -61,8 +62,10 @@ export function formatRelativeTime(isoTimestamp: string | null): string {
       if (diffMin === 0) return "just now";
       return diffMin === 1 ? "1 minute ago" : `${diffMin} minutes ago`;
     }
+
     return diffHours === 1 ? "1 hour ago" : `${diffHours} hours ago`;
   }
+
   if (diffDays === 1) return "yesterday";
   if (diffDays < 7) return `${diffDays} days ago`;
 
@@ -77,21 +80,23 @@ export function formatRelativeTime(isoTimestamp: string | null): string {
 // Internal helpers
 // ---------------------------------------------------------------------------
 
-function taskAttr(task: Task | Record<string, any>, key: string, defaultVal = ""): string {
+function taskAttr(task: Record<string, any> | Task, key: string, defaultVal = ""): string {
   if (typeof task === "object" && task !== null) {
     return (task as any)[key] ?? defaultVal;
   }
+
   return defaultVal;
 }
 
-function readPlanContent(planPath: string): [string | null, boolean, number] {
+function readPlanContent(planPath: string): [null | string, boolean, number] {
   try {
     if (!fs.existsSync(planPath)) return [null, false, 0];
-    const content = fs.readFileSync(planPath, "utf-8");
+    const content = fs.readFileSync(planPath, "utf8");
     const total = content.length;
     if (total > MAX_PLAN_INLINE_CHARS) {
       return [content.slice(0, MAX_PLAN_INLINE_CHARS), true, total];
     }
+
     return [content, false, total];
   } catch {
     return [null, false, 0];
@@ -100,7 +105,7 @@ function readPlanContent(planPath: string): [string | null, boolean, number] {
 
 function modeLabel(ctx: ContextState): string {
   const d = getModeDisplay(ctx.mode ?? "idle");
-  return d ? d.replace(/^\[|\]$/g, "") : "Active";
+  return d ? d.replaceAll(/^\[|\]$/g, "") : "Active";
 }
 
 /**
@@ -119,7 +124,7 @@ export function buildRestoreSections(
     const savedAt = lastSession.saved_at ?? "";
     if (savedAt) {
       const reason = lastSession.save_reason ?? "";
-      const reasonDisplay = reason ? reason.replace(/_/g, " ") : "unknown";
+      const reasonDisplay = reason ? reason.replaceAll('_', " ") : "unknown";
       sections.push(`**Last session ended:** ${formatRelativeTime(savedAt)} (${reasonDisplay})`);
     }
   }
@@ -138,6 +143,7 @@ export function buildRestoreSections(
         buckets[s]!.push(taskAttr(t, "subject"));
       }
     }
+
     if (Object.values(buckets).some(b => b.length > 0)) {
       sections.push("", `### Previous Work (${tasks.length} tasks)`, "");
       const marks: Record<string, string> = {
@@ -195,8 +201,7 @@ function resumeBlock(ctx: ContextState, projectRoot: string | undefined, modeTex
   ];
   const restore = buildRestoreSections(ctx, projectRoot, true);
   if (restore) lines.push(restore);
-  lines.push("", "---", "", "**Instructions:**");
-  lines.push(...instructions);
+  lines.push("", "---", "", "**Instructions:**", ...instructions);
   return lines.join("\n");
 }
 
@@ -218,12 +223,12 @@ export function formatHandoffContinuation(ctx: ContextState, projectRoot?: strin
 
   try {
     if (handoffPath && fs.existsSync(handoffPath)) {
-      lines.push("### Previous Session Handoff", "", fs.readFileSync(handoffPath, "utf-8"), "");
+      lines.push("### Previous Session Handoff", "", fs.readFileSync(handoffPath, "utf8"), "");
     } else {
       lines.push(`*Handoff document not found at \`${handoffPath}\`*`, "");
     }
-  } catch (e: any) {
-    lines.push(`*Handoff document at \`${handoffPath}\` could not be read: ${e}*`, "");
+  } catch (error: any) {
+    lines.push(`*Handoff document at \`${handoffPath}\` could not be read: ${error}*`, "");
   }
 
   const restore = buildRestoreSections(ctx, projectRoot, true);
@@ -266,20 +271,21 @@ export function formatContextList(contexts: ContextState[]): string {
   if (contexts.length === 0) return "No active contexts found.";
 
   const lines = ["## Active Contexts\n"];
-  for (let i = 0; i < contexts.length; i++) {
-    const ctx = contexts[i]!;
+  for (const [i, context_] of contexts.entries()) {
+    const ctx = context_!;
     const timeStr = formatRelativeTime(ctx.last_active);
     const md = getModeDisplay(ctx.mode ?? "idle");
     const si = md ? ` ${md}` : "";
-    lines.push(`**${i + 1}. ${ctx.id}**${si}`);
-    lines.push(`   ${ctx.summary}`);
+    lines.push(`**${i + 1}. ${ctx.id}**${si}`, `   ${ctx.summary}`);
     if (ctx.method) {
       lines.push(`   Method: ${ctx.method} | Last active: ${timeStr}`);
     } else {
       lines.push(`   Last active: ${timeStr}`);
     }
+
     lines.push("");
   }
+
   return lines.join("\n");
 }
 
@@ -349,11 +355,11 @@ export function formatContextPickerStderr(contexts: ContextState[]): string {
   ];
 
   let selectableCount = 0;
-  for (let i = 0; i < contexts.length; i++) {
-    const ctx = contexts[i]!;
+  for (const [i, context_] of contexts.entries()) {
+    const ctx = context_!;
     const timeStr = formatRelativeTime(ctx.last_active);
     const mode = ctx.mode ?? "idle";
-    const isSelectable = mode === "active" || !!ctx.handoff_path;
+    const isSelectable = mode === "active" || Boolean(ctx.handoff_path);
     if (isSelectable) selectableCount++;
 
     let status = "";
@@ -366,10 +372,7 @@ export function formatContextPickerStderr(contexts: ContextState[]): string {
     const summary = ctx.summary.length > 48 ? ctx.summary.slice(0, 45) + "..." : ctx.summary;
     const selTag = isSelectable ? " [selectable]" : " [end only]";
 
-    lines.push(`|  ^${i + 1}  ${ctx.id}${status}${selTag}`);
-    lines.push(`|       ${summary}`);
-    lines.push(`|       [${timeStr}]`);
-    lines.push("|");
+    lines.push(`|  ^${i + 1}  ${ctx.id}${status}${selTag}`, `|       ${summary}`, `|       [${timeStr}]`, "|");
   }
 
   lines.push(
@@ -394,6 +397,7 @@ export function formatContextPickerStderr(contexts: ContextState[]): string {
       "+----------------------------------------------------------------+",
     );
   }
+
   lines.push("");
   return lines.join("\n");
 }
@@ -413,6 +417,7 @@ export function formatCommandFeedback(
       const s = ctx.summary.length > 50 ? ctx.summary.slice(0, 50) + "..." : ctx.summary;
       lines.push(`- **${ctx.id}**: ${s}`);
     }
+
     lines.push("");
   }
 
@@ -428,5 +433,6 @@ export function formatCommandFeedback(
       "Tasks created with TaskCreate will be persisted to this context.",
     );
   }
+
   return lines.join("\n");
 }

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

@@ -14,29 +14,30 @@
  */
 
 import * as crypto from "node:crypto";
-import {
-  getContext,
-  getAllContexts,
-  getContextBySessionId,
-  createContextFromPrompt,
-  createContext,
-  completeContext,
-  bindSession,
-  updateMode,
-} from "./context-store.js";
+
 import {
   formatActiveContextReminder,
+  formatActiveContinuation as _formatActiveContinuation,
+  formatCommandFeedback,
   formatContextCreated,
   formatContextPickerStderr,
-  formatCommandFeedback,
   formatHandoffContinuation,
   formatPlanContinuation,
-  formatActiveContinuation,
 } from "./context-formatter.js";
+import {
+  bindSession,
+  completeContext,
+  createContext,
+  createContextFromPrompt,
+  getAllContexts,
+  getContext,
+  getContextBySessionId,
+  updateMode,
+} from "./context-store.js";
 import { normalizePlanContent } from "./plan-manager.js";
+import { logDebug, logError, logInfo, logWarn as _logWarn } from "../base/logger.js";
 import { isInternalCall } from "../base/subprocess-utils.js";
-import { logDebug, logInfo, logWarn, logError } from "../base/logger.js";
-import type { ContextState, CaretCommand } from "../types.js";
+import type { CaretCommand, ContextState } from "../types.js";
 
 /** Minimum characters required for new context description. */
 const MIN_NEW_CONTEXT_CHARS = 10;
@@ -65,7 +66,7 @@ export class BlockRequest extends Error {
 export function resolveContextByPrefix(
   query: string,
   contexts: ContextState[],
-): [number | null, string | null] {
+): [null | number, null | string] {
   const q = query.toLowerCase();
   const available = contexts.map(c => c.id).join(", ");
 
@@ -107,7 +108,7 @@ export function resolveContextByPrefix(
 export function parseChainedCaret(
   prompt: string,
   contexts: ContextState[],
-): [CaretCommand | null, string | null] {
+): [CaretCommand | null, null | string] {
   if (!prompt.startsWith("^")) return [null, null];
 
   const match = prompt.match(/^\^(\S+)(?:\s+(.*))?$/s);
@@ -120,7 +121,7 @@ export function parseChainedCaret(
 
   // ^N shorthand
   if (/^\d+$/.test(commandStr)) {
-    const num = parseInt(commandStr, 10);
+    const num = Number.parseInt(commandStr, 10);
     if (num === 0) {
       if (remaining.length < MIN_NEW_CONTEXT_CHARS) {
         return [null,
@@ -130,21 +131,25 @@ export function parseChainedCaret(
           `Example: ^0 implement user authentication with JWT tokens`,
         ];
       }
+
       return [{ ends: [], select: null, new_context_desc: remaining, remaining_prompt: "" }, null];
     }
+
     if (num < 1 || num > contexts.length) {
       if (contexts.length === 0) {
         return [null, "No existing contexts. Use ^0 <description> to create a new one."];
       }
+
       return [null, `Invalid selection. Choose 1-${contexts.length} for existing contexts, or ^0 for new.`];
     }
+
     const ctx = contexts[num - 1]!;
     return [{ ends: [], select: ctx.id, new_context_desc: null, remaining_prompt: remaining }, null];
   }
 
   // Parse chained commands
   const ends: string[] = [];
-  let select: string | null = null;
+  let select: null | string = null;
   let pos = 0;
 
   while (pos < commandStr.length) {
@@ -174,11 +179,13 @@ export function parseChainedCaret(
         if (numStart === pos) {
           return [null, `Expected number, '*', or ':prefix' after 'E' at position ${numStart + 1}`];
         }
-        const num = parseInt(commandStr.slice(numStart, pos), 10);
+
+        const num = Number.parseInt(commandStr.slice(numStart, pos), 10);
         if (num < 1 || num > contexts.length) {
           if (contexts.length === 0) return [null, "No contexts to end."];
           return [null, `Context ^E${num} invalid. Choose 1-${contexts.length}.`];
         }
+
         if (pos < commandStr.length && commandStr[pos] === "+") {
           pos++;
           for (let i = num; i <= contexts.length; i++) {
@@ -208,13 +215,16 @@ export function parseChainedCaret(
         if (numStart === pos) {
           return [null, `Expected number or ':prefix' after 'S' at position ${numStart + 1}`];
         }
-        const num = parseInt(commandStr.slice(numStart, pos), 10);
+
+        const num = Number.parseInt(commandStr.slice(numStart, pos), 10);
         if (num < 1 || num > contexts.length) {
           if (contexts.length === 0) return [null, "No contexts to select."];
           return [null, `Context ^S${num} invalid. Choose 1-${contexts.length}.`];
         }
+
         ctx = contexts[num - 1]!;
       }
+
       if (select === null) select = ctx.id;
     } else {
       return [null,
@@ -274,9 +284,9 @@ function matchPlanContent(prompt: string, hasPlanContexts: ContextState[]): Cont
   }
 
   // Tier 4 (legacy): Signature match
-  const promptHead = prompt.slice(0, 500);
+  const promptHead = new Set(prompt.slice(0, 500));
   for (const ctx of hasPlanContexts) {
-    if (ctx.plan_signature && promptHead.includes(ctx.plan_signature)) {
+    if (ctx.plan_signature && promptHead.has(ctx.plan_signature)) {
       logDebug("context_selector", `Tier 4 legacy signature match: ${ctx.id}`);
       return ctx;
     }
@@ -292,15 +302,15 @@ function matchPlanContent(prompt: string, hasPlanContexts: ContextState[]): Cont
 function createNewContext(
   prompt: string,
   projectRoot?: string,
-): [string | null, string, string | null] {
+): [null | string, string, null | string] {
   try {
     const newCtx = createContextFromPrompt(prompt, projectRoot);
     updateMode(newCtx.id, "active", projectRoot);
     newCtx.mode = "active";
     logInfo("context_selector", `Auto-created context: ${newCtx.id}`);
     return [newCtx.id, "auto_created", formatContextCreated(newCtx)];
-  } catch (e: any) {
-    logError("context_selector", `Primary context creation failed: ${e}`);
+  } catch (error: any) {
+    logError("context_selector", `Primary context creation failed: ${error}`);
     try {
       const now = new Date();
       const yy = String(now.getFullYear()).slice(2);
@@ -320,8 +330,8 @@ function createNewContext(
       newCtx.mode = "active";
       logInfo("context_selector", `Fallback context created: ${newCtx.id}`);
       return [newCtx.id, "auto_created_fallback", formatContextCreated(newCtx)];
-    } catch (e2: any) {
-      logError("context_selector", `ALL context creation failed: ${e2}`);
+    } catch (error: any) {
+      logError("context_selector", `ALL context creation failed: ${error}`);
       return [null, "creation_failed", null];
     }
   }
@@ -335,7 +345,7 @@ function handleCaretCommand(
   prompt: string,
   contexts: ContextState[],
   projectRoot?: string,
-): [string | null, string, string | null] {
+): [null | string, string, null | string] {
   if (contexts.length === 0) {
     const match = prompt.match(/^\^(\S+)(?:\s+(.*))?$/s);
     if (!match) {
@@ -344,14 +354,16 @@ function handleCaretCommand(
         "Example: ^0 implement user authentication system",
       );
     }
+
     const prefixValue = match[1]!;
     const remaining = match[2] ?? "";
-    if (!/^\d+$/.test(prefixValue) || parseInt(prefixValue, 10) !== 0) {
+    if (!/^\d+$/.test(prefixValue) || Number.parseInt(prefixValue, 10) !== 0) {
       throw new BlockRequest(
         "No existing contexts to select. Use ^0 <description> to create a new context.\n" +
         "Example: ^0 implement user authentication system",
       );
     }
+
     const description = remaining.trim();
     if (description.length < MIN_NEW_CONTEXT_CHARS) {
       throw new BlockRequest(
@@ -361,6 +373,7 @@ function handleCaretCommand(
         `Example: ^0 implement user authentication with JWT tokens`,
       );
     }
+
     return createNewContext(description, projectRoot);
   }
 
@@ -374,6 +387,7 @@ function handleCaretCommand(
     if (!ctxToEnd) {
       throw new BlockRequest(`Context '${ctxId}' no longer exists.\n` + formatContextPickerStderr(contexts));
     }
+
     completeContext(ctxToEnd.id, projectRoot);
     endedContexts.push(ctxToEnd);
     logInfo("context_selector", `Ended context: ${ctxToEnd.id}`);
@@ -384,9 +398,10 @@ function handleCaretCommand(
     if (ctxId && endedContexts.length > 0) {
       const newCtx = getContext(ctxId, projectRoot);
       const feedback = formatCommandFeedback(endedContexts, newCtx);
-      return [ctxId, method !== "creation_failed" ? "caret_new" : method, feedback];
+      return [ctxId, method === "creation_failed" ? method : "caret_new", feedback];
     }
-    return [ctxId, method !== "creation_failed" ? "caret_new" : method, output];
+
+    return [ctxId, method === "creation_failed" ? method : "caret_new", output];
   }
 
   if (cmd.select) {
@@ -394,6 +409,7 @@ function handleCaretCommand(
     if (!selectedCtx) {
       throw new BlockRequest(`Context '${cmd.select}' no longer exists.\n` + formatContextPickerStderr(contexts));
     }
+
     logInfo("context_selector", `Caret-selected context: ${selectedCtx.id}`);
     return [selectedCtx.id, "caret_select", formatCommandFeedback(endedContexts, selectedCtx)];
   }
@@ -408,6 +424,7 @@ function handleCaretCommand(
         "Example: implement user authentication system",
       );
     }
+
     throw new BlockRequest(
       feedback + "\nNo context selected.\n\nSelect a context to continue:\n" +
       formatContextPickerStderr(remainingContexts),
@@ -432,7 +449,7 @@ export function determineContext(
   prompt: string,
   sessionId?: string,
   projectRoot?: string,
-): [string | null, string, string | null] {
+): [null | string, string, null | string] {
   if (isInternalCall()) {
     logDebug("context_selector", "Skipping: internal subprocess call");
     return [null, "skip_internal", null];
@@ -460,6 +477,7 @@ export function determineContext(
         "Example: implement user authentication system",
       );
     }
+
     throw new BlockRequest(formatContextPickerStderr(contexts));
   }