aiwcli 0.10.2 → 0.11.0

package/dist/templates/cc-native/_cc-native/hooks/plan_questions_early.ts

@@ -0,0 +1,61 @@
+#!/usr/bin/env bun
+/**
+ * UserPromptSubmit hook — injects Phase A clarification prompt in plan mode.
+ *
+ * On the first prompt in plan mode (before any code exploration), injects
+ * a system-reminder telling Claude to ask clarification questions via
+ * AskUserQuestion before exploring the codebase.
+ *
+ * Skips if questions were already asked this session.
+ */
+
+import { getProjectRoot } from "../../_shared/lib-ts/base/constants.js";
+import { emitContext, loadHookInput, logDebug, logInfo, runHook } from "../../_shared/lib-ts/base/hook-utils.js";
+import { wasQuestionsAsked } from "../lib-ts/cc-native-state.js";
+
+const PHASE_A_PROMPT = `## Plan Mode: Clarify Before Exploring
+
+Use AskUserQuestion now — one call, 3-4 questions — before reading any code.
+
+### Why This Matters
+Once you explore the codebase, you anchor on what you find. Questions asked after exploration confirm your assumptions instead of challenging them. Ask now, while your interpretation is still flexible.
+
+### What to Ask About
+Only ask about things you cannot discover from code — the user's intent, constraints, history, and priorities:
+
+- **Ambiguity:** If you can read this request two different ways, ask which interpretation is correct. Provide your top 2-3 readings as options.
+- **Invisible context:** What does the user assume "everyone knows" about this system that isn't documented? What's obvious to them but hidden to you?
+- **Success criteria:** What does "done well" look like beyond the literal request? What would make them rate this a 10?
+- **Constraints and history:** Has this been attempted before? Are there parts of the system that are off-limits or sensitive?
+
+### How to Select Questions
+1. Generate 5+ candidate questions across the lenses above
+2. For each, evaluate: "If they answered A vs B, would I explore different files or take a different approach?" If no — discard it.
+3. Keep the 3-4 where different answers lead to meaningfully different exploration strategies
+4. Frame each with 2-3 concrete options so the user can react rather than generate from scratch`;
+
+function main(): void {
+  const payload = loadHookInput();
+  if (!payload) return;
+
+  const permissionMode = payload.permission_mode ?? "";
+  if (permissionMode !== "plan") return;
+
+  const sessionId = String(payload.session_id ?? "");
+  if (!sessionId) {
+    logDebug("plan_questions_early", "No session_id, skipping");
+    return;
+  }
+
+  const projectRoot = getProjectRoot(payload.cwd);
+
+  if (wasQuestionsAsked(sessionId, projectRoot)) {
+    logDebug("plan_questions_early", "Questions already asked, skipping");
+    return;
+  }
+
+  logInfo("plan_questions_early", "Plan mode detected, injecting Phase A prompt");
+  emitContext(PHASE_A_PROMPT);
+}
+
+runHook(main, "plan_questions_early");

package/dist/templates/cc-native/_cc-native/lib-ts/aggregate-agents.ts

@@ -0,0 +1,157 @@
+/**
+ * Agent frontmatter parser — discovers and loads agent configs from markdown files.
+ * See cc-native-plan-review-spec.md §4.14
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+import type { AgentConfig } from "./types.js";
+import { logDebug, logInfo, logWarn } from "../../_shared/lib-ts/base/logger.js";
+
+/**
+ * Extract simple YAML frontmatter from markdown content.
+ * Only handles flat key: value pairs (no nested YAML).
+ */
+export function extractFrontmatter(
+  content: string,
+): null | Record<string, unknown> {
+  const lines = content.split("\n");
+  if (lines[0]?.trim() !== "---") return null;
+
+  const frontmatterLines: string[] = [];
+  let endIndex = -1;
+
+  for (let i = 1; i < lines.length; i++) {
+    if (lines[i]?.trim() === "---") {
+      endIndex = i;
+      break;
+    }
+
+    const line = lines[i];
+    if (line !== undefined) {
+      frontmatterLines.push(line);
+    }
+  }
+
+  if (endIndex === -1) return null;
+
+  const result: Record<string, unknown> = {};
+  for (const line of frontmatterLines) {
+    const colonIdx = line.indexOf(":");
+    if (colonIdx === -1) continue;
+
+    const key = line.slice(0, colonIdx).trim();
+    let value: unknown = line.slice(colonIdx + 1).trim();
+
+    // Handle arrays: [item1, item2]
+    if (typeof value === "string" && value.startsWith("[") && value.endsWith("]")) {
+      value = value
+        .slice(1, -1)
+        .split(",")
+        .map((s) => s.trim().replaceAll(/^["']|["']$/g, ""))
+        .filter(Boolean);
+    }
+    // Handle booleans
+    else if (value === "true") value = true;
+    else if (value === "false") value = false;
+    // Handle quoted strings
+    else if (
+      typeof value === "string" &&
+      ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'")))
+    ) {
+      value = value.slice(1, -1);
+    }
+
+    if (key) result[key] = value;
+  }
+
+  return result;
+}
+
+/**
+ * Extract markdown body after frontmatter.
+ */
+export function extractBody(content: string): string {
+  const lines = content.split("\n");
+  if (lines[0]?.trim() !== "---") return content;
+
+  for (let i = 1; i < lines.length; i++) {
+    if (lines[i]?.trim() === "---") {
+      return lines
+        .slice(i + 1)
+        .join("\n")
+        .trim();
+    }
+  }
+
+  return content;
+}
+
+/**
+ * Discover and load all agent configs from a directory of markdown files.
+ * Skips the plan-orchestrator agent. Defaults categories to ["code"].
+ *
+ * @param agentsDir - Path to agents directory (default: _cc-native/agents/)
+ * @returns Array of AgentConfig objects
+ */
+export function aggregateAgents(agentsDir?: string): AgentConfig[] {
+  const dir = agentsDir ?? path.join("_cc-native", "agents");
+
+  if (!fs.existsSync(dir)) {
+    logWarn("aggregate", `Agents directory not found: ${dir}`);
+    return [];
+  }
+
+  const files = fs
+    .readdirSync(dir)
+    .filter((f) => f.endsWith(".md"))
+    .sort();
+
+  const agents: AgentConfig[] = [];
+
+  for (const file of files) {
+    const filePath = path.join(dir, file);
+    let content: string;
+    try {
+      content = fs.readFileSync(filePath, "utf8");
+    } catch (error: unknown) {
+      logWarn("aggregate", `Failed to read ${file}: ${error}`);
+      continue;
+    }
+
+    const fm = extractFrontmatter(content);
+    if (!fm) {
+      logDebug("aggregate", `No frontmatter in ${file}, skipping`);
+      continue;
+    }
+
+    const name = (fm.name as string) ?? path.basename(file, ".md");
+
+    // Skip the plan orchestrator — it's not a reviewer
+    if (name === "plan-orchestrator") {
+      logDebug("aggregate", `Skipping plan-orchestrator agent`);
+      continue;
+    }
+
+    const agent: AgentConfig = {
+      name,
+      model: (fm.model as string) ?? "sonnet",
+      focus: (fm.focus as string) ?? "",
+      enabled: fm.enabled !== false,
+      categories: Array.isArray(fm.categories)
+        ? (fm.categories as string[])
+        : ["code"],
+      description: (fm.description as string) ?? "",
+      system_prompt: extractBody(content),
+    };
+
+    agents.push(agent);
+    logDebug("aggregate", `Loaded agent: ${agent.name} [${agent.categories.join(", ")}]`);
+  }
+
+  logInfo("aggregate", `Loaded ${agents.length} agents from ${dir}`);
+  return agents;
+}
+