aiwcli 0.12.3 → 0.12.7

package/dist/templates/cc-native/_cc-native/lib-ts/agent-selection.ts

@@ -1,163 +1,163 @@
-/**
- * Agent selection: mandatory resolution, orchestrator-based selection, model assignment.
- * Extracted from cc-native-plan-review.ts.
- */
-
-import { logDebug, logInfo, logWarn } from "../../_shared/lib-ts/base/logger.js";
-import { findExecutable } from "../../_shared/lib-ts/base/subprocess-utils.js";
-
-import type {
-  AgentConfig,
-  ModelsConfig,
-  OrchestratorResult,
-  AgentSelectionResult,
-} from "./types.js";
-
-const HOOK = "agent-selection";
-
-// ---------------------------------------------------------------------------
-// Mandatory Agent Resolution
-// ---------------------------------------------------------------------------
-
-/**
- * Resolve mandatory agent names from config. Supports flat arrays or
- * complexity-tiered objects with `always`, `medium+`, and `high` keys.
- */
-export function resolveMandatoryAgents(
-  configValue: unknown,
-  complexity: string,
-): Set<string> {
-  if (Array.isArray(configValue)) {
-    return new Set(configValue as string[]);
-  }
-  if (!configValue || typeof configValue !== "object") {
-    return new Set(["handoff-readiness", "clarity-auditor", "skeptic"]);
-  }
-  const cfg = configValue as Record<string, string[]>;
-  const names = new Set(cfg.always ?? []);
-  if (complexity === "medium" || complexity === "high") {
-    for (const n of cfg["medium+"] ?? []) names.add(n);
-  }
-  if (complexity === "high") {
-    for (const n of cfg.high ?? []) names.add(n);
-  }
-  return names;
-}
-
-// ---------------------------------------------------------------------------
-// Model Assignment
-// ---------------------------------------------------------------------------
-
-/**
- * Randomly assign enabled providers and models to agents.
- * Filters to providers whose CLI is available on PATH.
- */
-export function assignModelsToAgents(
-  agents: AgentConfig[],
-  modelsConfig: ModelsConfig,
-): AgentConfig[] {
-  const enabledProviders = Object.entries(modelsConfig.providers)
-    .filter(([name, config]) => {
-      if (!config.enabled || config.models.length === 0) return false;
-      const cliName = name === "claude" ? "claude" : name;
-      const found = findExecutable(cliName);
-      if (!found) {
-        logWarn(HOOK, `Provider '${name}' enabled but CLI '${cliName}' not found on PATH — skipping`);
-      }
-      return !!found;
-    });
-
-  if (enabledProviders.length === 0) {
-    logWarn(HOOK, "No providers with available CLI found, falling back to Claude with agent defaults");
-    return agents.map(a => ({ ...a, provider: "claude" }));
-  }
-
-  return agents.map(agent => {
-    const idx = Math.floor(Math.random() * enabledProviders.length);
-    const entry = enabledProviders[idx];
-    if (!entry) return { ...agent, provider: "claude" };
-    const [providerName, providerConfig] = entry;
-    const modelIdx = Math.floor(Math.random() * providerConfig.models.length);
-    const model = providerConfig.models[modelIdx] ?? providerConfig.models[0] ?? agent.model;
-    return { ...agent, provider: providerName, model };
-  });
-}
-
-// ---------------------------------------------------------------------------
-// Agent Selection
-// ---------------------------------------------------------------------------
-
-export interface AgentSelectionInput {
-  enabledAgents: AgentConfig[];
-  orchResult: OrchestratorResult | null;
-  mandatoryConfig: unknown;
-  agentSettings: Record<string, unknown>;
-  legacyMode: boolean;
-}
-
-/**
- * Select agents based on orchestrator result and mandatory config.
- */
-export function selectAgents(input: AgentSelectionInput): AgentSelectionResult {
-  const { enabledAgents, orchResult, mandatoryConfig, agentSettings, legacyMode } = input;
-
-  let detectedComplexity = "medium";
-  let mandatoryNames = resolveMandatoryAgents(mandatoryConfig, "simple");
-
-  if (enabledAgents.length === 0) {
-    return { selectedAgents: [], mandatoryNames, detectedComplexity };
-  }
-
-  let mandatoryAgents = enabledAgents.filter(a => mandatoryNames.has(a.name));
-  let nonMandatory = enabledAgents.filter(a => !mandatoryNames.has(a.name));
-
-  logDebug(HOOK, `Mandatory agents: ${mandatoryAgents.map(a => a.name)}`);
-  logDebug(HOOK, `Non-mandatory pool: ${nonMandatory.length} agents`);
-
-  if (orchResult && !legacyMode) {
-    detectedComplexity = orchResult.complexity;
-
-    // Recompute mandatory with actual complexity
-    mandatoryNames = resolveMandatoryAgents(mandatoryConfig, detectedComplexity);
-    mandatoryAgents = enabledAgents.filter(a => mandatoryNames.has(a.name));
-    nonMandatory = enabledAgents.filter(a => !mandatoryNames.has(a.name));
-
-    const orchSelectedNames = new Set(
-      orchResult.selected_agents.filter(n => !mandatoryNames.has(n)),
-    );
-    let orchSelected = nonMandatory.filter(a => orchSelectedNames.has(a.name));
-
-    logDebug(HOOK, `Orchestrator selected (non-mandatory): ${orchSelected.map(a => a.name)}`);
-
-    // Warn if orchestrator returned unknown names
-    const knownNames = new Set(nonMandatory.map(a => a.name));
-    const unmatched = [...orchSelectedNames].filter(n => !knownNames.has(n));
-    if (unmatched.length > 0) {
-      logWarn(HOOK, `Orchestrator selected unknown agents: ${unmatched}`);
-    }
-
-    // Enforce minimum agent count
-    const fallbackByComplexity = agentSettings.fallbackByComplexity ?? { simple: 0, medium: 2, high: 4 };
-    const minAdditional = fallbackByComplexity[detectedComplexity] ?? 5;
-    if (orchSelected.length < minAdditional && nonMandatory.length > 0) {
-      const remaining = nonMandatory.filter(a => !orchSelected.includes(a));
-      const topUpCount = Math.min(minAdditional - orchSelected.length, remaining.length);
-      if (topUpCount > 0) {
-        const shuffled = [...remaining].sort(() => Math.random() - 0.5);
-        const topUp = shuffled.slice(0, topUpCount);
-        orchSelected = [...orchSelected, ...topUp];
-        logDebug(HOOK, `Topped up ${topUpCount} agents to meet ${detectedComplexity} minimum: ${topUp.map(a => a.name)}`);
-      }
-    }
-
-    const selectedAgents = [...mandatoryAgents, ...orchSelected];
-    logInfo(HOOK, `Final selection: ${selectedAgents.length} agents (${mandatoryAgents.length} mandatory + ${orchSelected.length} additional)`);
-    return { selectedAgents, mandatoryNames, detectedComplexity };
-  }
-
-  // Legacy mode: all enabled agents
-  logInfo(HOOK, "Running in legacy mode (all enabled agents)");
-  detectedComplexity = "medium";
-  mandatoryNames = resolveMandatoryAgents(mandatoryConfig, detectedComplexity);
-  return { selectedAgents: enabledAgents, mandatoryNames, detectedComplexity };
-}
+/**
+ * Agent selection: mandatory resolution, orchestrator-based selection, model assignment.
+ * Extracted from cc-native-plan-review.ts.
+ */
+
+import { logDebug, logInfo, logWarn } from "../../_shared/lib-ts/base/logger.js";
+import { findExecutable } from "../../_shared/lib-ts/base/subprocess-utils.js";
+
+import type {
+  AgentConfig,
+  ModelsConfig,
+  OrchestratorResult,
+  AgentSelectionResult,
+} from "./types.js";
+
+const HOOK = "agent-selection";
+
+// ---------------------------------------------------------------------------
+// Mandatory Agent Resolution
+// ---------------------------------------------------------------------------
+
+/**
+ * Resolve mandatory agent names from config. Supports flat arrays or
+ * complexity-tiered objects with `always`, `medium+`, and `high` keys.
+ */
+export function resolveMandatoryAgents(
+  configValue: unknown,
+  complexity: string,
+): Set<string> {
+  if (Array.isArray(configValue)) {
+    return new Set(configValue as string[]);
+  }
+  if (!configValue || typeof configValue !== "object") {
+    return new Set(["handoff-readiness", "clarity-auditor", "skeptic"]);
+  }
+  const cfg = configValue as Record<string, string[]>;
+  const names = new Set(cfg.always ?? []);
+  if (complexity === "medium" || complexity === "high") {
+    for (const n of cfg["medium+"] ?? []) names.add(n);
+  }
+  if (complexity === "high") {
+    for (const n of cfg.high ?? []) names.add(n);
+  }
+  return names;
+}
+
+// ---------------------------------------------------------------------------
+// Model Assignment
+// ---------------------------------------------------------------------------
+
+/**
+ * Randomly assign enabled providers and models to agents.
+ * Filters to providers whose CLI is available on PATH.
+ */
+export function assignModelsToAgents(
+  agents: AgentConfig[],
+  modelsConfig: ModelsConfig,
+): AgentConfig[] {
+  const enabledProviders = Object.entries(modelsConfig.providers)
+    .filter(([name, config]) => {
+      if (!config.enabled || config.models.length === 0) return false;
+      const cliName = name === "claude" ? "claude" : name;
+      const found = findExecutable(cliName);
+      if (!found) {
+        logWarn(HOOK, `Provider '${name}' enabled but CLI '${cliName}' not found on PATH — skipping`);
+      }
+      return !!found;
+    });
+
+  if (enabledProviders.length === 0) {
+    logWarn(HOOK, "No providers with available CLI found, falling back to Claude with agent defaults");
+    return agents.map(a => ({ ...a, provider: "claude" }));
+  }
+
+  return agents.map(agent => {
+    const idx = Math.floor(Math.random() * enabledProviders.length);
+    const entry = enabledProviders[idx];
+    if (!entry) return { ...agent, provider: "claude" };
+    const [providerName, providerConfig] = entry;
+    const modelIdx = Math.floor(Math.random() * providerConfig.models.length);
+    const model = providerConfig.models[modelIdx] ?? providerConfig.models[0] ?? agent.model;
+    return { ...agent, provider: providerName, model };
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Agent Selection
+// ---------------------------------------------------------------------------
+
+export interface AgentSelectionInput {
+  enabledAgents: AgentConfig[];
+  orchResult: OrchestratorResult | null;
+  mandatoryConfig: unknown;
+  agentSettings: Record<string, unknown>;
+  legacyMode: boolean;
+}
+
+/**
+ * Select agents based on orchestrator result and mandatory config.
+ */
+export function selectAgents(input: AgentSelectionInput): AgentSelectionResult {
+  const { enabledAgents, orchResult, mandatoryConfig, agentSettings, legacyMode } = input;
+
+  let detectedComplexity = "medium";
+  let mandatoryNames = resolveMandatoryAgents(mandatoryConfig, "simple");
+
+  if (enabledAgents.length === 0) {
+    return { selectedAgents: [], mandatoryNames, detectedComplexity };
+  }
+
+  let mandatoryAgents = enabledAgents.filter(a => mandatoryNames.has(a.name));
+  let nonMandatory = enabledAgents.filter(a => !mandatoryNames.has(a.name));
+
+  logDebug(HOOK, `Mandatory agents: ${mandatoryAgents.map(a => a.name)}`);
+  logDebug(HOOK, `Non-mandatory pool: ${nonMandatory.length} agents`);
+
+  if (orchResult && !legacyMode) {
+    detectedComplexity = orchResult.complexity;
+
+    // Recompute mandatory with actual complexity
+    mandatoryNames = resolveMandatoryAgents(mandatoryConfig, detectedComplexity);
+    mandatoryAgents = enabledAgents.filter(a => mandatoryNames.has(a.name));
+    nonMandatory = enabledAgents.filter(a => !mandatoryNames.has(a.name));
+
+    const orchSelectedNames = new Set(
+      orchResult.selected_agents.filter(n => !mandatoryNames.has(n)),
+    );
+    let orchSelected = nonMandatory.filter(a => orchSelectedNames.has(a.name));
+
+    logDebug(HOOK, `Orchestrator selected (non-mandatory): ${orchSelected.map(a => a.name)}`);
+
+    // Warn if orchestrator returned unknown names
+    const knownNames = new Set(nonMandatory.map(a => a.name));
+    const unmatched = [...orchSelectedNames].filter(n => !knownNames.has(n));
+    if (unmatched.length > 0) {
+      logWarn(HOOK, `Orchestrator selected unknown agents: ${unmatched}`);
+    }
+
+    // Enforce minimum agent count
+    const fallbackByComplexity = agentSettings.fallbackByComplexity ?? { simple: 0, medium: 2, high: 4 };
+    const minAdditional = fallbackByComplexity[detectedComplexity] ?? 5;
+    if (orchSelected.length < minAdditional && nonMandatory.length > 0) {
+      const remaining = nonMandatory.filter(a => !orchSelected.includes(a));
+      const topUpCount = Math.min(minAdditional - orchSelected.length, remaining.length);
+      if (topUpCount > 0) {
+        const shuffled = [...remaining].sort(() => Math.random() - 0.5);
+        const topUp = shuffled.slice(0, topUpCount);
+        orchSelected = [...orchSelected, ...topUp];
+        logDebug(HOOK, `Topped up ${topUpCount} agents to meet ${detectedComplexity} minimum: ${topUp.map(a => a.name)}`);
+      }
+    }
+
+    const selectedAgents = [...mandatoryAgents, ...orchSelected];
+    logInfo(HOOK, `Final selection: ${selectedAgents.length} agents (${mandatoryAgents.length} mandatory + ${orchSelected.length} additional)`);
+    return { selectedAgents, mandatoryNames, detectedComplexity };
+  }
+
+  // Legacy mode: all enabled agents
+  logInfo(HOOK, "Running in legacy mode (all enabled agents)");
+  detectedComplexity = "medium";
+  mandatoryNames = resolveMandatoryAgents(mandatoryConfig, detectedComplexity);
+  return { selectedAgents: enabledAgents, mandatoryNames, detectedComplexity };
+}

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

@@ -1,156 +1,156 @@
-/**
- * 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,
-): Record<string, unknown> | null {
-  const lines = content.split(/\r?\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(/\r?\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, "utf-8");
-    } 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",
-      provider: "claude", // Default; overwritten by assignModelsToAgents() at runtime
-      focus: (fm.focus as string) ?? "",
-      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;
-}
-
+/**
+ * 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,
+): Record<string, unknown> | null {
+  const lines = content.split(/\r?\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(/\r?\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, "utf-8");
+    } 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",
+      provider: "claude", // Default; overwritten by assignModelsToAgents() at runtime
+      focus: (fm.focus as string) ?? "",
+      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;
+}
+