aiwcli 0.12.3 → 0.12.7

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

@@ -1,58 +1,58 @@
-/**
- * Plan evaluation guidance template.
- * Injected as context to guide the Plan agent during plan creation.
- */
-
-export function getEvaluationContextReminder(): string {
-  return `## Write This Plan for a Different Agent
-
-The agent executing this plan has zero context from this conversation — no chat history, no memory of files explored or decisions made.
-
-Write as if you are that agent. What would you need?
-
-### Structure
-
-\`\`\`
-# Plan: [descriptive title]
-
-## Background
-Why this change is needed (2-3 sentences of motivation)
-
-## Task
-What exactly to build or change
-
-## Files
-**Modify:**
-- \`exact/path/to/file.ext\` — What changes and why
-
-**Reference:**
-- \`exact/path/to/reference.ext\` — Why relevant (e.g., "pattern to follow at lines 12-30")
-
-## Steps
-Numbered steps with specific details. For each step, consider whether any of the skills available in your system-reminder messages would help the implementation agent — if so, reference the skill inline at the point of use.
-
-1. [Specific action with function names, patterns, or code snippets]
-2. [Enough detail for someone who never saw this conversation]
-
-## Constraints
-Technical requirements, preferences, or limitations discovered during planning
-
-## Verification
-Binary-testable checks the implementation agent runs to confirm success. Reference relevant skills inline where they aid verification.
-
-## Decisions Worth Preserving
-Decisions made during this session that would be lost without documentation. Focus on:
-- What was chosen and why the alternatives were rejected
-- Constraints that aren't obvious from the code itself
-- Patterns discovered that prevent future mistakes
-
-The implementation agent should document these so the next session inherits what this session learned.
-\`\`\`
-
-### Self-Check
-- [ ] Could I execute this plan having never seen this conversation?
-- [ ] Are all file paths exact (not "the auth file")?
-- [ ] Are implementation details specific (not "use the approach we discussed")?
-- [ ] Are relevant skills referenced where they add value?
-- [ ] Are key decisions captured so they survive this session?`;
-}
+/**
+ * Plan evaluation guidance template.
+ * Injected as context to guide the Plan agent during plan creation.
+ */
+
+export function getEvaluationContextReminder(): string {
+  return `## Write This Plan for a Different Agent
+
+The agent executing this plan has zero context from this conversation — no chat history, no memory of files explored or decisions made.
+
+Write as if you are that agent. What would you need?
+
+### Structure
+
+\`\`\`
+# Plan: [descriptive title]
+
+## Background
+Why this change is needed (2-3 sentences of motivation)
+
+## Task
+What exactly to build or change
+
+## Files
+**Modify:**
+- \`exact/path/to/file.ext\` — What changes and why
+
+**Reference:**
+- \`exact/path/to/reference.ext\` — Why relevant (e.g., "pattern to follow at lines 12-30")
+
+## Steps
+Numbered steps with specific details. For each step, consider whether any of the skills available in your system-reminder messages would help the implementation agent — if so, reference the skill inline at the point of use.
+
+1. [Specific action with function names, patterns, or code snippets]
+2. [Enough detail for someone who never saw this conversation]
+
+## Constraints
+Technical requirements, preferences, or limitations discovered during planning
+
+## Verification
+Binary-testable checks the implementation agent runs to confirm success. Reference relevant skills inline where they aid verification.
+
+## Decisions Worth Preserving
+Decisions made during this session that would be lost without documentation. Focus on:
+- What was chosen and why the alternatives were rejected
+- Constraints that aren't obvious from the code itself
+- Patterns discovered that prevent future mistakes
+
+The implementation agent should document these so the next session inherits what this session learned.
+\`\`\`
+
+### Self-Check
+- [ ] Could I execute this plan having never seen this conversation?
+- [ ] Are all file paths exact (not "the auth file")?
+- [ ] Are implementation details specific (not "use the approach we discussed")?
+- [ ] Are relevant skills referenced where they add value?
+- [ ] Are key decisions captured so they survive this session?`;
+}

package/dist/templates/_shared/lib-ts/tsconfig.json

@@ -1,13 +1,13 @@
-{
-  "compilerOptions": {
-    "target": "es2022",
-    "module": "Node16",
-    "moduleResolution": "node16",
-    "strict": true,
-    "noUncheckedIndexedAccess": true,
-    "outDir": "dist",
-    "rootDir": ".",
-    "declaration": true
-  },
-  "include": ["./**/*.ts"]
-}
+{
+  "compilerOptions": {
+    "target": "es2022",
+    "module": "Node16",
+    "moduleResolution": "node16",
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "outDir": "dist",
+    "rootDir": ".",
+    "declaration": true
+  },
+  "include": ["./**/*.ts"]
+}

package/dist/templates/_shared/lib-ts/types.ts

@@ -1,180 +1,186 @@
-/**
- * Shared type definitions for the lib-ts library.
- * All field names use snake_case for JSON backward compatibility with state.json.
- * See SPEC.md §1 for full behavioral specification.
- */
-
-// §1.1
-export type Mode = "idle" | "has_plan" | "has_handoff" | "active";
-
-export interface ContextState {
-  id: string;
-  status: "active" | "completed";
-  summary: string;
-  method: string;
-  tags: string[];
-  created_at: string;
-  last_active: string;
-  mode: Mode;
-  plan_path: string | null;
-  plan_hash: string | null;
-  plan_signature: string | null;
-  plan_id: string | null;
-  plan_anchors: string[];
-  plan_consumed: boolean;
-  plan_hash_consumed: string | null;
-  handoff_path: string | null;
-  handoff_consumed: boolean;
-  session_ids: string[];
-  last_session: LastSession | null;
-  tasks: Task[];
-}
-
-// §1.2
-export interface GitState {
-  branch?: string;
-  uncommitted_files?: string[];
-  last_commit_short?: string;
-}
-
-export interface LastSession {
-  session_id?: string;
-  saved_at?: string;
-  save_reason?: string;
-  transcript_path?: string;
-  context_remaining_pct?: number;
-  context_warnings_fired?: number[];
-  git_state?: GitState;
-}
-
-// §1.3
-export interface Task {
-  id: string;
-  subject: string;
-  description: string;
-  active_form: string;
-  status: "pending" | "in_progress" | "completed" | "blocked";
-  created_at: string;
-  completed_at: string | null;
-  evidence: string;
-  work_summary: string;
-  files_changed: string[];
-  session_id?: string;
-}
-
-// §1.4
-export interface IndexEntry {
-  summary: string;
-  mode: string;
-  last_active: string;
-}
-
-export interface IndexFile {
-  version: "3.0";
-  updated_at: string;
-  sessions: Record<string, string>;
-  contexts: Record<string, IndexEntry>;
-}
-
-// §1.5
-export interface LogEntry {
-  ts: string;
-  level: "debug" | "info" | "warn" | "error";
-  hook: string;
-  msg: string;
-  component?: string;
-  data?: any;
-  tb?: string;
-}
-
-// §1.6
-export interface HookInput {
-  hook_event_name: string;
-  tool_name?: string;
-  tool_input?: Record<string, any>;
-  tool_result?: string;
-  session_id?: string;
-  cwd?: string;
-  transcript_path?: string;
-  context_window?: {
-    current_usage?: {
-      cache_read_input_tokens?: number;
-      input_tokens?: number;
-      cache_creation_input_tokens?: number;
-      output_tokens?: number;
-    };
-    context_window_size?: number;
-  };
-  permission_mode?: string;
-  source?: string;
-}
-
-// §1.7 — Three hook output patterns (see hook-utils.ts for emit functions)
-export interface HookOutput {
-  // Pattern 1: hookSpecificOutput (PreToolUse, PostToolUse, UserPromptSubmit, etc.)
-  hookSpecificOutput?: {
-    hookEventName?: string;
-    additionalContext?: string;
-    permissionDecision?: "allow" | "deny" | "ask";
-    permissionDecisionReason?: string;
-    updatedInput?: Record<string, unknown>;
-  };
-  // Pattern 2: Top-level decision (UserPromptSubmit, Stop, SubagentStop)
-  decision?: "block";
-  reason?: string;
-}
-
-// §1.7b — PermissionRequest output (structurally different from HookOutput)
-export interface PermissionRequestOutput {
-  decision: {
-    behavior: "allow" | "deny";
-    message?: string;
-    updatedInput?: Record<string, unknown>;
-    updatedPermissions?: Record<string, unknown>;
-  };
-}
-
-// §1.8
-export interface InferenceResult {
-  success: boolean;
-  output: string;
-  error?: string;
-  latency_ms: number;
-}
-
-// §1.9
-export interface HandoffDocument {
-  context_id: string;
-  context_summary: string;
-  session_id: string;
-  reason: string;
-  created_at: string;
-  plan_path: string | null;
-  context_folder: string;
-  events_log_path: string;
-  active_tasks: Task[];
-  completed_tasks_this_session: Array<{ subject: string }>;
-  work_summary: string;
-  next_steps: string[];
-  important_notes: string[];
-  file_path: string | null;
-}
-
-// §1.10
-export interface HandoffSections {
-  index: string | null;
-  deadEnds: string | null;
-  pending: string | null;
-  plan: string | null;
-  decisions: string | null;
-  completedWork: string | null;
-  context: string | null;
-}
-
-// §1.11
-export interface CaretCommand {
-  ends: string[];
-  select: string | null;
-  new_context_desc: string | null;
-  remaining_prompt: string;
-}
+/**
+ * Shared type definitions for the lib-ts library.
+ * All field names use snake_case for JSON backward compatibility with state.json.
+ * See SPEC.md §1 for full behavioral specification.
+ */
+
+// §1.1
+export type Mode = "idle" | "has_staged_work" | "active";
+
+export interface ContextState {
+  id: string;
+  status: "active" | "completed";
+  summary: string;
+  method: string;
+  tags: string[];
+  created_at: string;
+  last_active: string;
+  mode: Mode;
+  plan_path: string | null;
+  plan_hash: string | null;
+  plan_signature: string | null;
+  plan_id: string | null;
+  plan_anchors: string[];
+  plan_hash_consumed: string | null;
+  handoff_path: string | null;
+  // Unified lifecycle fields (v0.13.0+)
+  work_consumed: boolean;  // Replaces plan_consumed + handoff_consumed
+  next_artifact_type: "plan" | "handoff" | null;  // Explicit artifact type for has_staged_work mode
+  // Deprecated fields (kept for migration)
+  /** @deprecated Use work_consumed instead */
+  plan_consumed?: boolean;
+  /** @deprecated Use work_consumed instead */
+  handoff_consumed?: boolean;
+  session_ids: string[];
+  last_session: LastSession | null;
+  tasks: Task[];
+}
+
+// §1.2
+export interface GitState {
+  branch?: string;
+  uncommitted_files?: string[];
+  last_commit_short?: string;
+}
+
+export interface LastSession {
+  session_id?: string;
+  saved_at?: string;
+  save_reason?: string;
+  transcript_path?: string;
+  context_remaining_pct?: number;
+  context_warnings_fired?: number[];
+  git_state?: GitState;
+}
+
+// §1.3
+export interface Task {
+  id: string;
+  subject: string;
+  description: string;
+  active_form: string;
+  status: "pending" | "in_progress" | "completed" | "blocked";
+  created_at: string;
+  completed_at: string | null;
+  evidence: string;
+  work_summary: string;
+  files_changed: string[];
+  session_id?: string;
+}
+
+// §1.4
+export interface IndexEntry {
+  summary: string;
+  mode: string;
+  last_active: string;
+}
+
+export interface IndexFile {
+  version: "3.0";
+  updated_at: string;
+  sessions: Record<string, string>;
+  contexts: Record<string, IndexEntry>;
+}
+
+// §1.5
+export interface LogEntry {
+  ts: string;
+  level: "debug" | "info" | "warn" | "error";
+  hook: string;
+  msg: string;
+  component?: string;
+  data?: any;
+  tb?: string;
+}
+
+// §1.6
+export interface HookInput {
+  hook_event_name: string;
+  tool_name?: string;
+  tool_input?: Record<string, any>;
+  tool_result?: string;
+  session_id?: string;
+  cwd?: string;
+  transcript_path?: string;
+  context_window?: {
+    current_usage?: {
+      cache_read_input_tokens?: number;
+      input_tokens?: number;
+      cache_creation_input_tokens?: number;
+      output_tokens?: number;
+    };
+    context_window_size?: number;
+  };
+  permission_mode?: string;
+  source?: string;
+}
+
+// §1.7 — Three hook output patterns (see hook-utils.ts for emit functions)
+export interface HookOutput {
+  // Pattern 1: hookSpecificOutput (PreToolUse, PostToolUse, UserPromptSubmit, etc.)
+  hookSpecificOutput?: {
+    hookEventName?: string;
+    additionalContext?: string;
+    permissionDecision?: "allow" | "deny" | "ask";
+    permissionDecisionReason?: string;
+    updatedInput?: Record<string, unknown>;
+  };
+  // Pattern 2: Top-level decision (UserPromptSubmit, Stop, SubagentStop)
+  decision?: "block";
+  reason?: string;
+}
+
+// §1.7b — PermissionRequest output (structurally different from HookOutput)
+export interface PermissionRequestOutput {
+  decision: {
+    behavior: "allow" | "deny";
+    message?: string;
+    updatedInput?: Record<string, unknown>;
+    updatedPermissions?: Record<string, unknown>;
+  };
+}
+
+// §1.8
+export interface InferenceResult {
+  success: boolean;
+  output: string;
+  error?: string;
+  latency_ms: number;
+}
+
+// §1.9
+export interface HandoffDocument {
+  context_id: string;
+  context_summary: string;
+  session_id: string;
+  reason: string;
+  created_at: string;
+  plan_path: string | null;
+  context_folder: string;
+  events_log_path: string;
+  active_tasks: Task[];
+  completed_tasks_this_session: Array<{ subject: string }>;
+  work_summary: string;
+  next_steps: string[];
+  important_notes: string[];
+  file_path: string | null;
+}
+
+// §1.10
+export interface HandoffSections {
+  index: string | null;
+  deadEnds: string | null;
+  pending: string | null;
+  plan: string | null;
+  decisions: string | null;
+  completedWork: string | null;
+  context: string | null;
+}
+
+// §1.11
+export interface CaretCommand {
+  ends: string[];
+  select: string | null;
+  new_context_desc: string | null;
+  remaining_prompt: string;
+}

package/dist/templates/_shared/scripts/resolve_context.ts

@@ -1,33 +1,33 @@
-#!/usr/bin/env bun
-/**
- * Resolve and print the active context ID.
- *
- * Usage:
- *   bun .aiwcli/_shared/scripts/resolve_context.ts
- *
- * Prints the context ID to stdout. Exits 1 if no active context found.
- * Used by command templates (/handoff, /handoff-resume) to programmatically
- * get the context ID instead of parsing system reminders.
- *
- * Requires CLAUDE_SESSION_ID environment variable (set by Claude Code).
- */
-import { getContextBySessionId } from "../lib-ts/context/context-store.js";
-import { getProjectRoot } from "../lib-ts/base/constants.js";
-import { eprint } from "../lib-ts/base/utils.js";
-
-const projectRoot = getProjectRoot(process.cwd());
-const sessionId = process.env.CLAUDE_SESSION_ID;
-
-if (!sessionId) {
-  eprint("CLAUDE_SESSION_ID not set. This script must be run from within a Claude Code session.");
-  process.exit(1);
-}
-
-const context = getContextBySessionId(sessionId, projectRoot);
-
-if (!context) {
-  eprint(`No context found for session: ${sessionId}`);
-  process.exit(1);
-}
-
-console.log(context.id);
+#!/usr/bin/env bun
+/**
+ * Resolve and print the active context ID.
+ *
+ * Usage:
+ *   bun .aiwcli/_shared/scripts/resolve_context.ts
+ *
+ * Prints the context ID to stdout. Exits 1 if no active context found.
+ * Used by command templates (/handoff, /handoff-resume) to programmatically
+ * get the context ID instead of parsing system reminders.
+ *
+ * Requires CLAUDE_SESSION_ID environment variable (set by Claude Code).
+ */
+import { getContextBySessionId } from "../lib-ts/context/context-store.js";
+import { getProjectRoot } from "../lib-ts/base/constants.js";
+import { eprint } from "../lib-ts/base/utils.js";
+
+const projectRoot = getProjectRoot(process.cwd());
+const sessionId = process.env.CLAUDE_SESSION_ID;
+
+if (!sessionId) {
+  eprint("CLAUDE_SESSION_ID not set. This script must be run from within a Claude Code session.");
+  process.exit(1);
+}
+
+const context = getContextBySessionId(sessionId, projectRoot);
+
+if (!context) {
+  eprint(`No context found for session: ${sessionId}`);
+  process.exit(1);
+}
+
+console.log(context.id);