compound-agent 1.4.4 → 1.5.0

package/dist/cli.js

@@ -3348,7 +3348,7 @@ Before capturing, verify the lesson is:
 The JSONL file requires proper ID generation, schema validation, and SQLite sync.
 Use CLI (\`npx ca learn\`) \u2014 never manual edits.
 
-See [documentation](https://github.com/Nathandela/learning_agent) for more details.
+See [documentation](https://github.com/Nathandela/compound-agent) for more details.
 ${AGENTS_SECTION_END_MARKER}
 `;
 var LEGACY_ROOT_SLASH_COMMANDS = [
@@ -3368,7 +3368,7 @@ var PLUGIN_MANIFEST = {
     name: "Nathan Delacr\xE9taz",
     url: "https://github.com/Nathandela"
   },
-  repository: "https://github.com/Nathandela/learning_agent",
+  repository: "https://github.com/Nathandela/compound-agent",
   license: "MIT",
   hooks: {
     SessionStart: [
@@ -3737,674 +3737,6 @@ function formatError(command, code, message, remediation) {
   return `ERROR [${command}] ${code}: ${message} \u2014 ${remediation}`;
 }
 
-// src/setup/hooks-user-prompt.ts
-var CORRECTION_PATTERNS = [
-  /\bactually\b/i,
-  /\bno[,.]?\s/i,
-  /\bwrong\b/i,
-  /\bthat'?s not right\b/i,
-  /\bthat'?s incorrect\b/i,
-  /\buse .+ instead\b/i,
-  /\bi told you\b/i,
-  /\bi already said\b/i,
-  /\bnot like that\b/i,
-  /\byou forgot\b/i,
-  /\byou missed\b/i,
-  /\bstop\s*(,\s*)?(doing|using|that)\b/i,
-  /\bwait\s*(,\s*)?(that|no|wrong)\b/i
-];
-var HIGH_CONFIDENCE_PLANNING = [
-  /\bdecide\b/i,
-  /\bchoose\b/i,
-  /\bpick\b/i,
-  /\bwhich approach\b/i,
-  /\bwhat do you think\b/i,
-  /\bshould we\b/i,
-  /\bwould you\b/i,
-  /\bhow should\b/i,
-  /\bwhat'?s the best\b/i,
-  /\badd feature\b/i,
-  /\bset up\b/i
-];
-var LOW_CONFIDENCE_PLANNING = [
-  /\bimplement\b/i,
-  /\bbuild\b/i,
-  /\bcreate\b/i,
-  /\brefactor\b/i,
-  /\bfix\b/i,
-  /\bwrite\b/i,
-  /\bdevelop\b/i
-];
-var CORRECTION_REMINDER = "Remember: You have memory tools available - `npx ca learn` to save insights, `npx ca search` to find past solutions.";
-var PLANNING_REMINDER = "If you're uncertain or hesitant, remember your memory tools: `npx ca search` may have relevant context from past sessions.";
-function detectCorrection(prompt) {
-  return CORRECTION_PATTERNS.some((pattern) => pattern.test(prompt));
-}
-function detectPlanning(prompt) {
-  if (HIGH_CONFIDENCE_PLANNING.some((pattern) => pattern.test(prompt))) {
-    return true;
-  }
-  const lowMatches = LOW_CONFIDENCE_PLANNING.filter((pattern) => pattern.test(prompt));
-  return lowMatches.length >= 2;
-}
-function processUserPrompt(prompt) {
-  if (detectCorrection(prompt)) {
-    return {
-      hookSpecificOutput: {
-        hookEventName: "UserPromptSubmit",
-        additionalContext: CORRECTION_REMINDER
-      }
-    };
-  }
-  if (detectPlanning(prompt)) {
-    return {
-      hookSpecificOutput: {
-        hookEventName: "UserPromptSubmit",
-        additionalContext: PLANNING_REMINDER
-      }
-    };
-  }
-  return {};
-}
-var SAME_TARGET_THRESHOLD = 2;
-var TOTAL_FAILURE_THRESHOLD = 3;
-var STATE_FILE_NAME = ".ca-failure-state.json";
-var STATE_MAX_AGE_MS = 60 * 60 * 1e3;
-var failureCount = 0;
-var lastFailedTarget = null;
-var sameTargetCount = 0;
-function defaultState() {
-  return { count: 0, lastTarget: null, sameTargetCount: 0, timestamp: Date.now() };
-}
-function readFailureState(stateDir) {
-  try {
-    const filePath = join(stateDir, STATE_FILE_NAME);
-    if (!existsSync(filePath)) return defaultState();
-    const raw = readFileSync(filePath, "utf-8");
-    const parsed = JSON.parse(raw);
-    if (Date.now() - parsed.timestamp > STATE_MAX_AGE_MS) return defaultState();
-    return parsed;
-  } catch {
-    return defaultState();
-  }
-}
-function writeFailureState(stateDir, state) {
-  try {
-    const filePath = join(stateDir, STATE_FILE_NAME);
-    writeFileSync(filePath, JSON.stringify(state), "utf-8");
-  } catch {
-  }
-}
-function deleteStateFile(stateDir) {
-  try {
-    const filePath = join(stateDir, STATE_FILE_NAME);
-    if (existsSync(filePath)) unlinkSync(filePath);
-  } catch {
-  }
-}
-var FAILURE_TIP = "Tip: Multiple failures detected. `npx ca search` may have solutions for similar issues.";
-function resetFailureState(stateDir) {
-  failureCount = 0;
-  lastFailedTarget = null;
-  sameTargetCount = 0;
-  if (stateDir) deleteStateFile(stateDir);
-}
-function getFailureTarget(toolName, toolInput) {
-  if (toolName === "Bash" && typeof toolInput.command === "string") {
-    const trimmed = toolInput.command.trim();
-    const firstSpace = trimmed.indexOf(" ");
-    return firstSpace === -1 ? trimmed : trimmed.slice(0, firstSpace);
-  }
-  if ((toolName === "Edit" || toolName === "Write") && typeof toolInput.file_path === "string") {
-    return toolInput.file_path;
-  }
-  return null;
-}
-function processToolFailure(toolName, toolInput, stateDir) {
-  if (stateDir) {
-    const persisted = readFailureState(stateDir);
-    failureCount = persisted.count;
-    lastFailedTarget = persisted.lastTarget;
-    sameTargetCount = persisted.sameTargetCount;
-  }
-  failureCount++;
-  const target = getFailureTarget(toolName, toolInput);
-  if (target !== null && target === lastFailedTarget) {
-    sameTargetCount++;
-  } else {
-    sameTargetCount = 1;
-    lastFailedTarget = target;
-  }
-  const shouldShowTip = sameTargetCount >= SAME_TARGET_THRESHOLD || failureCount >= TOTAL_FAILURE_THRESHOLD;
-  if (shouldShowTip) {
-    resetFailureState(stateDir);
-    return {
-      hookSpecificOutput: {
-        hookEventName: "PostToolUseFailure",
-        additionalContext: FAILURE_TIP
-      }
-    };
-  }
-  if (stateDir) {
-    writeFailureState(stateDir, {
-      count: failureCount,
-      lastTarget: lastFailedTarget,
-      sameTargetCount,
-      timestamp: Date.now()
-    });
-  }
-  return {};
-}
-function processToolSuccess(stateDir) {
-  resetFailureState(stateDir);
-}
-var STATE_DIR = ".claude";
-var STATE_FILE = ".ca-phase-state.json";
-var PHASE_STATE_MAX_AGE_MS = 72 * 60 * 60 * 1e3;
-var PHASES = ["brainstorm", "plan", "work", "review", "compound"];
-var GATES = ["post-plan", "gate-3", "gate-4", "final"];
-var PHASE_INDEX = {
-  brainstorm: 1,
-  plan: 2,
-  work: 3,
-  review: 4,
-  compound: 5
-};
-function getStatePath(repoRoot) {
-  return join(repoRoot, STATE_DIR, STATE_FILE);
-}
-function isPhaseName(value) {
-  return typeof value === "string" && PHASES.includes(value);
-}
-function isGateName(value) {
-  return typeof value === "string" && GATES.includes(value);
-}
-function isIsoDate(value) {
-  if (typeof value !== "string") return false;
-  return !Number.isNaN(Date.parse(value));
-}
-function isStringArray(value) {
-  return Array.isArray(value) && value.every((item) => typeof item === "string");
-}
-function validatePhaseState(raw) {
-  if (typeof raw !== "object" || raw === null) return false;
-  const state = raw;
-  return typeof state.lfg_active === "boolean" && typeof state.epic_id === "string" && isPhaseName(state.current_phase) && typeof state.phase_index === "number" && state.phase_index >= 1 && state.phase_index <= 5 && isStringArray(state.skills_read) && Array.isArray(state.gates_passed) && state.gates_passed.every((gate) => isGateName(gate)) && isIsoDate(state.started_at);
-}
-function expectedGateForPhase(phaseIndex) {
-  if (phaseIndex === 2) return "post-plan";
-  if (phaseIndex === 3) return "gate-3";
-  if (phaseIndex === 4) return "gate-4";
-  if (phaseIndex === 5) return "final";
-  return null;
-}
-function initPhaseState(repoRoot, epicId) {
-  const dir = join(repoRoot, STATE_DIR);
-  mkdirSync(dir, { recursive: true });
-  const state = {
-    lfg_active: true,
-    epic_id: epicId,
-    current_phase: "brainstorm",
-    phase_index: PHASE_INDEX.brainstorm,
-    skills_read: [],
-    gates_passed: [],
-    started_at: (/* @__PURE__ */ new Date()).toISOString()
-  };
-  writeFileSync(getStatePath(repoRoot), JSON.stringify(state, null, 2), "utf-8");
-  return state;
-}
-function getPhaseState(repoRoot) {
-  try {
-    const path2 = getStatePath(repoRoot);
-    if (!existsSync(path2)) return null;
-    const raw = readFileSync(path2, "utf-8");
-    const parsed = JSON.parse(raw);
-    if (!validatePhaseState(parsed)) return null;
-    const age = Date.now() - new Date(parsed.started_at).getTime();
-    if (age > PHASE_STATE_MAX_AGE_MS) {
-      cleanPhaseState(repoRoot);
-      return null;
-    }
-    return parsed;
-  } catch {
-    return null;
-  }
-}
-function updatePhaseState(repoRoot, partial) {
-  const current = getPhaseState(repoRoot);
-  if (current === null) return null;
-  const updated = {
-    ...current,
-    ...partial
-  };
-  if (!validatePhaseState(updated)) return null;
-  writeFileSync(getStatePath(repoRoot), JSON.stringify(updated, null, 2), "utf-8");
-  return updated;
-}
-function startPhase(repoRoot, phase) {
-  return updatePhaseState(repoRoot, {
-    current_phase: phase,
-    phase_index: PHASE_INDEX[phase]
-  });
-}
-function cleanPhaseState(repoRoot) {
-  try {
-    const path2 = getStatePath(repoRoot);
-    if (existsSync(path2)) unlinkSync(path2);
-  } catch {
-  }
-}
-function recordGatePassed(repoRoot, gate) {
-  const current = getPhaseState(repoRoot);
-  if (current === null) return null;
-  const gatesPassed = current.gates_passed.includes(gate) ? current.gates_passed : [...current.gates_passed, gate];
-  const updated = { ...current, gates_passed: gatesPassed };
-  if (gate === "final") {
-    cleanPhaseState(repoRoot);
-    return updated;
-  }
-  writeFileSync(getStatePath(repoRoot), JSON.stringify(updated, null, 2), "utf-8");
-  return updated;
-}
-function printStatusHuman(state) {
-  if (state === null) {
-    console.log("No active LFG session.");
-    return;
-  }
-  console.log("Active LFG Session");
-  console.log(`  Epic: ${state.epic_id}`);
-  console.log(`  Phase: ${state.current_phase} (${state.phase_index}/5)`);
-  console.log(`  Skills read: ${state.skills_read.length === 0 ? "(none)" : state.skills_read.join(", ")}`);
-  console.log(`  Gates passed: ${state.gates_passed.length === 0 ? "(none)" : state.gates_passed.join(", ")}`);
-  console.log(`  Started: ${state.started_at}`);
-}
-function registerPhaseSubcommands(phaseCheck, getDryRun, repoRoot) {
-  phaseCheck.command("init <epic-id>").description("Initialize phase state for an epic").action((epicId) => {
-    if (!EPIC_ID_PATTERN.test(epicId)) {
-      console.error(`Invalid epic ID: "${epicId}"`);
-      process.exitCode = 1;
-      return;
-    }
-    if (getDryRun()) {
-      console.log(`[dry-run] Would initialize phase state for epic ${epicId} in ${repoRoot()}`);
-      return;
-    }
-    initPhaseState(repoRoot(), epicId);
-    console.log(`Phase state initialized for ${epicId}. Current phase: brainstorm (1/5).`);
-  });
-  phaseCheck.command("start <phase>").description("Start or resume a phase").action((phase) => {
-    if (!isPhaseName(phase)) {
-      console.error(`Invalid phase: "${phase}". Valid phases: ${PHASES.join(", ")}`);
-      process.exitCode = 1;
-      return;
-    }
-    if (getDryRun()) {
-      console.log(`[dry-run] Would start phase ${phase}`);
-      return;
-    }
-    const state = startPhase(repoRoot(), phase);
-    if (state === null) {
-      console.error("No active phase state. Run: ca phase-check init <epic-id>");
-      process.exitCode = 1;
-      return;
-    }
-    console.log(`Phase updated: ${state.current_phase} (${state.phase_index}/5).`);
-  });
-  phaseCheck.command("gate <gate-name>").description("Record a phase gate as passed").action((gateName) => {
-    if (!isGateName(gateName)) {
-      console.error(`Invalid gate: "${gateName}". Valid gates: ${GATES.join(", ")}`);
-      process.exitCode = 1;
-      return;
-    }
-    if (getDryRun()) {
-      console.log(`[dry-run] Would record gate ${gateName}`);
-      return;
-    }
-    const state = recordGatePassed(repoRoot(), gateName);
-    if (state === null) {
-      console.error("No active phase state. Run: ca phase-check init <epic-id>");
-      process.exitCode = 1;
-      return;
-    }
-    if (gateName === "final") {
-      console.log("Final gate recorded. Phase state cleaned.");
-      return;
-    }
-    console.log(`Gate recorded: ${gateName}.`);
-  });
-  phaseCheck.command("status").description("Show current phase state").option("--json", "Output raw JSON").action((options) => {
-    const state = getPhaseState(repoRoot());
-    if (options.json) {
-      console.log(JSON.stringify(state ?? { lfg_active: false }));
-      return;
-    }
-    printStatusHuman(state);
-  });
-  phaseCheck.command("clean").description("Remove phase state file").action(() => {
-    if (getDryRun()) {
-      console.log("[dry-run] Would delete phase state file");
-      return;
-    }
-    cleanPhaseState(repoRoot());
-    console.log("Phase state cleaned.");
-  });
-}
-function registerPhaseCheckCommand(program2) {
-  const phaseCheck = program2.command("phase-check").description("Manage LFG phase state").option("--dry-run", "Show what would be done without making changes");
-  const getDryRun = () => phaseCheck.opts().dryRun ?? false;
-  const repoRoot = () => getRepoRoot();
-  registerPhaseSubcommands(phaseCheck, getDryRun, repoRoot);
-  program2.command("phase-clean").description("Remove phase state file (alias for `phase-check clean`)").action(() => {
-    cleanPhaseState(repoRoot());
-    console.log("Phase state cleaned.");
-  });
-}
-
-// src/setup/hooks-phase-guard.ts
-function processPhaseGuard(repoRoot, toolName, _toolInput) {
-  try {
-    if (toolName !== "Edit" && toolName !== "Write") return {};
-    const state = getPhaseState(repoRoot);
-    if (state === null || !state.lfg_active) return {};
-    const expectedSkillPath = `.claude/skills/compound/${state.current_phase}/SKILL.md`;
-    const skillRead = state.skills_read.includes(expectedSkillPath);
-    if (!skillRead) {
-      return {
-        hookSpecificOutput: {
-          hookEventName: "PreToolUse",
-          additionalContext: `PHASE GUARD WARNING: You are in LFG phase ${state.phase_index}/5 (${state.current_phase}) but have NOT read the skill file yet. Read ${expectedSkillPath} before continuing.`
-        }
-      };
-    }
-    return {};
-  } catch {
-    return {};
-  }
-}
-
-// src/setup/hooks-read-tracker.ts
-var SKILL_PATH_PATTERN = /(?:^|\/)\.claude\/skills\/compound\/([^/]+)\/SKILL\.md$/;
-function normalizePath(path2) {
-  return path2.replaceAll("\\", "/");
-}
-function toCanonicalSkillPath(filePath) {
-  const normalized = normalizePath(filePath);
-  const match = SKILL_PATH_PATTERN.exec(normalized);
-  if (!match?.[1]) return null;
-  return `.claude/skills/compound/${match[1]}/SKILL.md`;
-}
-function processReadTracker(repoRoot, toolName, toolInput) {
-  try {
-    if (toolName !== "Read") return {};
-    const state = getPhaseState(repoRoot);
-    if (state === null || !state.lfg_active) return {};
-    const filePath = typeof toolInput.file_path === "string" ? toolInput.file_path : null;
-    if (filePath === null) return {};
-    const canonicalPath = toCanonicalSkillPath(filePath);
-    if (canonicalPath === null) return {};
-    if (!state.skills_read.includes(canonicalPath)) {
-      updatePhaseState(repoRoot, {
-        skills_read: [...state.skills_read, canonicalPath]
-      });
-    }
-    return {};
-  } catch {
-    return {};
-  }
-}
-
-// src/setup/hooks-stop-audit.ts
-function hasTransitionEvidence(state) {
-  if (state.phase_index === 5) return true;
-  const nextPhase = PHASES[state.phase_index];
-  if (nextPhase === void 0) return false;
-  const nextSkillPath = `.claude/skills/compound/${nextPhase}/SKILL.md`;
-  return state.skills_read.includes(nextSkillPath);
-}
-function processStopAudit(repoRoot, stopHookActive = false) {
-  try {
-    if (stopHookActive) return {};
-    const state = getPhaseState(repoRoot);
-    if (state === null || !state.lfg_active) return {};
-    const expectedGate = expectedGateForPhase(state.phase_index);
-    if (expectedGate === null) return {};
-    if (state.gates_passed.includes(expectedGate)) return {};
-    if (!hasTransitionEvidence(state)) return {};
-    return {
-      continue: false,
-      stopReason: `PHASE GATE NOT VERIFIED: ${state.current_phase} requires gate '${expectedGate}'. Run: npx ca phase-check gate ${expectedGate}`
-    };
-  } catch {
-    return {};
-  }
-}
-
-// src/setup/hooks.ts
-var HOOK_FILE_MODE = 493;
-function hasCompoundAgentHook(content) {
-  return content.includes(HOOK_MARKER);
-}
-async function getGitHooksDir(repoRoot) {
-  const gitPath = join(repoRoot, ".git");
-  if (!existsSync(gitPath)) {
-    return null;
-  }
-  let gitDir = gitPath;
-  if (lstatSync(gitPath).isFile()) {
-    const content = readFileSync(gitPath, "utf-8").trim();
-    const match = /^gitdir:\s*(.+)$/.exec(content);
-    if (!match?.[1]) return null;
-    gitDir = resolve(repoRoot, match[1]);
-  }
-  const configPath2 = join(gitDir, "config");
-  if (existsSync(configPath2)) {
-    const config = await readFile(configPath2, "utf-8");
-    const match = /hooksPath\s*=\s*(.+)$/m.exec(config);
-    if (match?.[1]) {
-      const hooksPath = match[1].trim();
-      return hooksPath.startsWith("/") ? hooksPath : join(repoRoot, hooksPath);
-    }
-  }
-  const defaultHooksDir = join(gitDir, "hooks");
-  return existsSync(defaultHooksDir) ? defaultHooksDir : null;
-}
-function findFirstTopLevelExitLine(lines) {
-  let insideFunction = 0;
-  let heredocDelimiter = null;
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i] ?? "";
-    const trimmed = line.trim();
-    if (heredocDelimiter !== null) {
-      if (trimmed === heredocDelimiter) {
-        heredocDelimiter = null;
-      }
-      continue;
-    }
-    const heredocMatch = /<<-?\s*['"]?(\w+)['"]?/.exec(line);
-    if (heredocMatch?.[1]) {
-      heredocDelimiter = heredocMatch[1];
-      continue;
-    }
-    for (const char of line) {
-      if (char === "{") insideFunction++;
-      if (char === "}") insideFunction = Math.max(0, insideFunction - 1);
-    }
-    if (insideFunction > 0) {
-      continue;
-    }
-    if (/^\s*exit\s+(\d+|\$\w+|\$\?)\s*$/.test(trimmed)) {
-      return i;
-    }
-  }
-  return -1;
-}
-async function installPreCommitHook(repoRoot) {
-  const gitHooksDir = await getGitHooksDir(repoRoot);
-  if (!gitHooksDir) {
-    return { status: "not_git_repo" };
-  }
-  await mkdir(gitHooksDir, { recursive: true });
-  const hookPath = join(gitHooksDir, "pre-commit");
-  if (existsSync(hookPath)) {
-    const content = await readFile(hookPath, "utf-8");
-    if (hasCompoundAgentHook(content)) {
-      return { status: "already_installed" };
-    }
-    const lines = content.split("\n");
-    const exitLineIndex = findFirstTopLevelExitLine(lines);
-    let newContent;
-    if (exitLineIndex === -1) {
-      newContent = content.trimEnd() + "\n" + COMPOUND_AGENT_HOOK_BLOCK;
-    } else {
-      const before = lines.slice(0, exitLineIndex);
-      const after = lines.slice(exitLineIndex);
-      newContent = before.join("\n") + COMPOUND_AGENT_HOOK_BLOCK + after.join("\n");
-    }
-    await writeFile(hookPath, newContent, "utf-8");
-    chmodSync(hookPath, HOOK_FILE_MODE);
-    return { status: "appended" };
-  }
-  await writeFile(hookPath, PRE_COMMIT_HOOK_TEMPLATE, "utf-8");
-  chmodSync(hookPath, HOOK_FILE_MODE);
-  return { status: "installed" };
-}
-async function installPostCommitHook(repoRoot) {
-  const gitHooksDir = await getGitHooksDir(repoRoot);
-  if (!gitHooksDir) {
-    return { status: "not_git_repo" };
-  }
-  await mkdir(gitHooksDir, { recursive: true });
-  const hookPath = join(gitHooksDir, "post-commit");
-  if (existsSync(hookPath)) {
-    const content = await readFile(hookPath, "utf-8");
-    if (content.includes(POST_COMMIT_HOOK_MARKER)) {
-      return { status: "already_installed" };
-    }
-    const lines = content.split("\n");
-    const exitLineIndex = findFirstTopLevelExitLine(lines);
-    let newContent;
-    if (exitLineIndex === -1) {
-      newContent = content.trimEnd() + "\n" + COMPOUND_AGENT_POST_COMMIT_BLOCK;
-    } else {
-      const before = lines.slice(0, exitLineIndex);
-      const after = lines.slice(exitLineIndex);
-      newContent = before.join("\n") + COMPOUND_AGENT_POST_COMMIT_BLOCK + after.join("\n");
-    }
-    await writeFile(hookPath, newContent, "utf-8");
-    chmodSync(hookPath, HOOK_FILE_MODE);
-    return { status: "appended" };
-  }
-  await writeFile(hookPath, POST_COMMIT_HOOK_TEMPLATE, "utf-8");
-  chmodSync(hookPath, HOOK_FILE_MODE);
-  return { status: "installed" };
-}
-async function readStdin() {
-  const chunks = [];
-  for await (const chunk of process.stdin) {
-    chunks.push(chunk);
-  }
-  return Buffer.concat(chunks).toString("utf-8");
-}
-async function runUserPromptHook() {
-  try {
-    const input = await readStdin();
-    const data = JSON.parse(input);
-    if (!data.prompt) {
-      console.log(JSON.stringify({}));
-      return;
-    }
-    const result = processUserPrompt(data.prompt);
-    console.log(JSON.stringify(result));
-  } catch {
-    console.log(JSON.stringify({}));
-  }
-}
-async function runPostToolFailureHook() {
-  try {
-    const input = await readStdin();
-    const data = JSON.parse(input);
-    if (!data.tool_name) {
-      console.log(JSON.stringify({}));
-      return;
-    }
-    const stateDir = join(getRepoRoot(), ".claude");
-    const result = processToolFailure(data.tool_name, data.tool_input ?? {}, stateDir);
-    console.log(JSON.stringify(result));
-  } catch {
-    console.log(JSON.stringify({}));
-  }
-}
-async function runPostToolSuccessHook() {
-  try {
-    await readStdin();
-    const stateDir = join(getRepoRoot(), ".claude");
-    processToolSuccess(stateDir);
-    console.log(JSON.stringify({}));
-  } catch {
-    console.log(JSON.stringify({}));
-  }
-}
-async function runToolHook(processor) {
-  try {
-    const input = await readStdin();
-    const data = JSON.parse(input);
-    if (!data.tool_name) {
-      console.log(JSON.stringify({}));
-      return;
-    }
-    console.log(JSON.stringify(processor(getRepoRoot(), data.tool_name, data.tool_input ?? {})));
-  } catch {
-    console.log(JSON.stringify({}));
-  }
-}
-async function runStopAuditHook() {
-  try {
-    const input = await readStdin();
-    const data = JSON.parse(input);
-    console.log(JSON.stringify(processStopAudit(getRepoRoot(), data.stop_hook_active ?? false)));
-  } catch {
-    console.log(JSON.stringify({}));
-  }
-}
-function registerHooksCommand(program2) {
-  const hooksCommand = program2.command("hooks").description("Git hooks management");
-  hooksCommand.command("run <hook>").description("Run a hook script (called by git/Claude hooks)").option("--json", "Output as JSON").action(async (hook, options) => {
-    if (hook === "pre-commit") {
-      if (options.json) {
-        console.log(JSON.stringify({ hook: "pre-commit", message: PRE_COMMIT_MESSAGE }));
-      } else {
-        console.log(PRE_COMMIT_MESSAGE);
-      }
-    } else if (hook === "user-prompt") {
-      await runUserPromptHook();
-    } else if (hook === "post-tool-failure") {
-      await runPostToolFailureHook();
-    } else if (hook === "post-tool-success") {
-      await runPostToolSuccessHook();
-    } else if (hook === "phase-guard") {
-      await runToolHook(processPhaseGuard);
-    } else if (hook === "post-read" || hook === "read-tracker") {
-      await runToolHook(processReadTracker);
-    } else if (hook === "phase-audit" || hook === "stop-audit") {
-      await runStopAuditHook();
-    } else {
-      if (options.json) {
-        console.log(JSON.stringify({ error: `Unknown hook: ${hook}` }));
-      } else {
-        console.error(
-          formatError(
-            "hooks",
-            "UNKNOWN_HOOK",
-            `Unknown hook: ${hook}`,
-            "Valid hooks: pre-commit, user-prompt, post-tool-failure, post-tool-success, post-read (or read-tracker), phase-guard, phase-audit (or stop-audit)"
-          )
-        );
-      }
-      process.exitCode = 1;
-    }
-  });
-}
-
 // src/setup/templates/agents-external.ts
 var EXTERNAL_AGENT_TEMPLATES = {
   "external-reviewer-gemini.md": `---
@@ -6850,80 +6182,907 @@ name: Test Cleaner
 description: Multi-phase test suite optimization with adversarial review
 ---
 
-# Test Cleaner Skill
-
-## Overview
-Analyze, optimize, and clean a project's test suite through a multi-phase workflow with adversarial review. Produces machine-readable output and feeds findings into compound-agent memory.
-
-## Methodology
-
-### Phase 1: Analysis
-Spawn multiple analysis subagents in parallel:
-- **Cargo-cult detector**: Find fake tests, mocked business logic, trivial assertions
-- **Redundancy analyzer**: Identify overlapping/duplicate test coverage
-- **Independence checker**: Verify tests don't depend on execution order or shared state
-- **Invariant tracer**: Map which invariants each test verifies (Lamport framework)
-- **Coverage analyzer**: Identify untested code paths and modules
-
-### Phase 2: Planning
-Synthesize analysis results into a refined optimization plan:
-- Categorize findings by severity (P1/P2/P3)
-- Propose specific changes for each finding
-- Estimate impact on test suite speed and coverage
-- Iterate with subagents until the plan is comprehensive
-
-### Phase 3: Adversarial Review (CRITICAL QUALITY GATE)
-**This is THE KEY PHASE -- the most important phase in the entire workflow. NEVER skip, NEVER rush, NEVER settle for "good enough."**
-
-Expose the plan to two neutral reviewer subagents:
-- **Reviewer A** (Opus): Independent critique of the optimization plan
-- **Reviewer B** (Sonnet): Independent critique from a different perspective
-
-Both reviewers challenge assumptions, identify risks, and suggest improvements.
-
-**Mandatory iteration loop**: After each reviewer pass, if ANY issues, concerns, or suggestions remain from EITHER reviewer, revise the plan and re-submit to BOTH reviewers. Repeat until BOTH reviewers explicitly approve with ZERO reservations. Do not proceed to Phase 4 until unanimous, unconditional approval is reached.
-
-This is the critical quality gate. Loop as many times as needed. The test suite must be bulletproof before execution begins.
-
-### Phase 4: Execution
-Apply the agreed changes:
-- Machine-readable output format: \`ERROR [file:line] type: description\`
-- Include \`REMEDIATION\` suggestions and \`SEE\` references
-- Use \`pnpm test:segment\`, \`pnpm test:random\`, \`pnpm test:critical\` for targeted validation
+# Test Cleaner Skill
+
+## Overview
+Analyze, optimize, and clean a project's test suite through a multi-phase workflow with adversarial review. Produces machine-readable output and feeds findings into compound-agent memory.
+
+## Methodology
+
+### Phase 1: Analysis
+Spawn multiple analysis subagents in parallel:
+- **Cargo-cult detector**: Find fake tests, mocked business logic, trivial assertions
+- **Redundancy analyzer**: Identify overlapping/duplicate test coverage
+- **Independence checker**: Verify tests don't depend on execution order or shared state
+- **Invariant tracer**: Map which invariants each test verifies (Lamport framework)
+- **Coverage analyzer**: Identify untested code paths and modules
+
+### Phase 2: Planning
+Synthesize analysis results into a refined optimization plan:
+- Categorize findings by severity (P1/P2/P3)
+- Propose specific changes for each finding
+- Estimate impact on test suite speed and coverage
+- Iterate with subagents until the plan is comprehensive
+
+### Phase 3: Adversarial Review (CRITICAL QUALITY GATE)
+**This is THE KEY PHASE -- the most important phase in the entire workflow. NEVER skip, NEVER rush, NEVER settle for "good enough."**
+
+Expose the plan to two neutral reviewer subagents:
+- **Reviewer A** (Opus): Independent critique of the optimization plan
+- **Reviewer B** (Sonnet): Independent critique from a different perspective
+
+Both reviewers challenge assumptions, identify risks, and suggest improvements.
+
+**Mandatory iteration loop**: After each reviewer pass, if ANY issues, concerns, or suggestions remain from EITHER reviewer, revise the plan and re-submit to BOTH reviewers. Repeat until BOTH reviewers explicitly approve with ZERO reservations. Do not proceed to Phase 4 until unanimous, unconditional approval is reached.
+
+This is the critical quality gate. Loop as many times as needed. The test suite must be bulletproof before execution begins.
+
+### Phase 4: Execution
+Apply the agreed changes:
+- Machine-readable output format: \`ERROR [file:line] type: description\`
+- Include \`REMEDIATION\` suggestions and \`SEE\` references
+- Use \`pnpm test:segment\`, \`pnpm test:random\`, \`pnpm test:critical\` for targeted validation
+
+### Phase 5: Verification
+- Run full test suite after changes
+- Compare before/after metrics (count, duration, coverage)
+- Feed findings into compound-agent memory via \`npx ca learn\`
+
+## Test Scripts Integration
+- \`pnpm test:segment <module>\` -- Test specific module in isolation
+- \`pnpm test:random <pct>\` -- Deterministic random subset (seeded per-agent)
+- \`pnpm test:critical\` -- P1/critical tests only (fast CI feedback)
+
+## Memory Integration
+- Run \`npx ca search "test optimization"\` before starting
+- After completion, capture findings via \`npx ca learn\`
+- Feed patterns into CCT system for future sessions
+
+## Common Pitfalls
+- Deleting tests without verifying coverage is maintained elsewhere
+- Optimizing for speed at the cost of correctness
+- Settling for partial approval or cutting the Phase 3 review loop short before BOTH reviewers approve with zero reservations
+- Making changes without machine-readable output
+- Not feeding results back into compound-agent memory
+
+## Quality Criteria
+- All 5 phases completed (analysis, planning, review, execution, verification)
+- Both adversarial reviewers approved with zero reservations after iterative refinement
+- Machine-readable output format used throughout
+- Full test suite passes after changes
+- Coverage not degraded
+- Findings captured in compound-agent memory
+`
+};
+
+// src/setup/gemini.ts
+var HOOKS = {
+  "ca-prime.sh": `#!/usr/bin/env bash
+input=$(cat)
+echo "$input" | npx ca prime > /dev/null 2>&1
+echo '{"decision": "allow"}'
+`,
+  "ca-user-prompt.sh": `#!/usr/bin/env bash
+input=$(cat)
+echo "$input" | npx ca hooks run user-prompt > /dev/null 2>&1
+echo '{"decision": "allow"}'
+`,
+  "ca-post-tool.sh": `#!/usr/bin/env bash
+input=$(cat)
+echo "$input" | npx ca hooks run post-tool-success > /dev/null 2>&1
+echo '{"decision": "allow"}'
+`,
+  "ca-phase-guard.sh": `#!/usr/bin/env bash
+input=$(cat)
+echo "$input" | npx ca hooks run phase-guard > /dev/null 2>&1
+rc=$?
+if [ $rc -ne 0 ]; then
+  echo '{"decision": "deny", "reason": "Phase guard: read the phase skill before editing"}'
+  exit 0
+fi
+echo '{"decision": "allow"}'
+`
+};
+var SETTINGS_JSON = {
+  hooks: {
+    SessionStart: [
+      {
+        matcher: ".*",
+        hooks: [{ name: "ca-prime", type: "command", command: "bash .gemini/hooks/ca-prime.sh" }]
+      }
+    ],
+    BeforeAgent: [
+      {
+        matcher: ".*",
+        hooks: [{ name: "ca-user-prompt", type: "command", command: "bash .gemini/hooks/ca-user-prompt.sh" }]
+      }
+    ],
+    BeforeTool: [
+      {
+        matcher: "replace|write_file|create_file",
+        hooks: [{ name: "ca-phase-guard", type: "command", command: "bash .gemini/hooks/ca-phase-guard.sh" }]
+      }
+    ],
+    AfterTool: [
+      {
+        matcher: "run_shell_command|replace|write_file|create_file",
+        hooks: [{ name: "ca-post-tool", type: "command", command: "bash .gemini/hooks/ca-post-tool.sh" }]
+      }
+    ]
+  }
+};
+function parseDescription(content, fallback) {
+  const raw = content.match(/description:\s*(.*)/)?.[1] ?? fallback;
+  return raw.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+async function writeSettings(geminiDir) {
+  const settingsPath = join(geminiDir, "settings.json");
+  let settings = SETTINGS_JSON;
+  if (existsSync(settingsPath)) {
+    try {
+      const existing = JSON.parse(await readFile(settingsPath, "utf8"));
+      settings = {
+        ...existing,
+        hooks: {
+          ...existing.hooks,
+          ...SETTINGS_JSON.hooks
+        }
+      };
+    } catch {
+    }
+  }
+  await writeFile(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf8");
+}
+async function writeTomlCommands(geminiDir) {
+  for (const [filename, content] of Object.entries(WORKFLOW_COMMANDS)) {
+    const cmdName = filename.replace(".md", "");
+    const description = parseDescription(content, `Compound ${cmdName} command`);
+    const toml = `description = "${description}"
+prompt = """
+@{.claude/commands/compound/${filename}}
+
+{{args}}
+"""
+`;
+    await writeFile(join(geminiDir, "commands", "compound", `${cmdName}.toml`), toml, "utf8");
+  }
+}
+async function writeSkills(geminiDir) {
+  for (const [phase, content] of Object.entries(PHASE_SKILLS)) {
+    const skillDir = join(geminiDir, "skills", `compound-${phase}`);
+    await mkdir(skillDir, { recursive: true });
+    const description = parseDescription(content, `Compound ${phase} skill`);
+    await writeFile(join(skillDir, "SKILL.md"), `---
+name: compound-${phase}
+description: ${description}
+---
+
+${content}
+`, "utf8");
+  }
+  for (const [name, content] of Object.entries(AGENT_ROLE_SKILLS)) {
+    const skillDir = join(geminiDir, "skills", `compound-agent-${name}`);
+    await mkdir(skillDir, { recursive: true });
+    const description = parseDescription(content, `Compound agent ${name} skill`);
+    await writeFile(join(skillDir, "SKILL.md"), `---
+name: compound-agent-${name}
+description: ${description}
+---
 
-### Phase 5: Verification
-- Run full test suite after changes
-- Compare before/after metrics (count, duration, coverage)
-- Feed findings into compound-agent memory via \`npx ca learn\`
+${content}
+`, "utf8");
+  }
+}
+async function installGeminiAdapter(options) {
+  const repoRoot = getRepoRoot();
+  const geminiDir = join(repoRoot, ".gemini");
+  if (options.dryRun) {
+    if (options.json) {
+      console.log(JSON.stringify({ dryRun: true, wouldInstall: true, location: geminiDir }));
+    } else {
+      console.log(`Would install gemini hooks and commands to ${geminiDir}`);
+    }
+    return;
+  }
+  await mkdir(join(geminiDir, "hooks"), { recursive: true });
+  await mkdir(join(geminiDir, "commands", "compound"), { recursive: true });
+  for (const [filename, content] of Object.entries(HOOKS)) {
+    await writeFile(join(geminiDir, "hooks", filename), content, { mode: 493 });
+  }
+  await writeSettings(geminiDir);
+  await writeTomlCommands(geminiDir);
+  await writeSkills(geminiDir);
+  if (options.json) {
+    console.log(JSON.stringify({ installed: true, location: geminiDir, action: "created" }));
+  } else {
+    out.success("Gemini CLI compatibility hooks installed");
+    console.log(`  Location: ${geminiDir}`);
+    console.log("  Hooks: SessionStart, BeforeAgent, BeforeTool, AfterTool");
+    console.log("  Commands: /compound:* aliases generated");
+  }
+}
+function registerGeminiSubcommand(setupCommand) {
+  setupCommand.command("gemini").description("Install Gemini CLI compatibility hooks (Adapter Pattern)").option("--dry-run", "Show what would change without writing").option("--json", "Output as JSON").action(async (options) => {
+    try {
+      await installGeminiAdapter(options);
+    } catch (err) {
+      if (options.json) {
+        console.log(JSON.stringify({ error: String(err) }));
+      } else {
+        console.error(formatError("setup", "GEMINI_INSTALL_ERROR", String(err), "Check .gemini/ directory permissions"));
+      }
+      process.exitCode = 1;
+    }
+  });
+}
 
-## Test Scripts Integration
-- \`pnpm test:segment <module>\` -- Test specific module in isolation
-- \`pnpm test:random <pct>\` -- Deterministic random subset (seeded per-agent)
-- \`pnpm test:critical\` -- P1/critical tests only (fast CI feedback)
+// src/setup/hooks-user-prompt.ts
+var CORRECTION_PATTERNS = [
+  /\bactually\b/i,
+  /\bno[,.]?\s/i,
+  /\bwrong\b/i,
+  /\bthat'?s not right\b/i,
+  /\bthat'?s incorrect\b/i,
+  /\buse .+ instead\b/i,
+  /\bi told you\b/i,
+  /\bi already said\b/i,
+  /\bnot like that\b/i,
+  /\byou forgot\b/i,
+  /\byou missed\b/i,
+  /\bstop\s*(,\s*)?(doing|using|that)\b/i,
+  /\bwait\s*(,\s*)?(that|no|wrong)\b/i
+];
+var HIGH_CONFIDENCE_PLANNING = [
+  /\bdecide\b/i,
+  /\bchoose\b/i,
+  /\bpick\b/i,
+  /\bwhich approach\b/i,
+  /\bwhat do you think\b/i,
+  /\bshould we\b/i,
+  /\bwould you\b/i,
+  /\bhow should\b/i,
+  /\bwhat'?s the best\b/i,
+  /\badd feature\b/i,
+  /\bset up\b/i
+];
+var LOW_CONFIDENCE_PLANNING = [
+  /\bimplement\b/i,
+  /\bbuild\b/i,
+  /\bcreate\b/i,
+  /\brefactor\b/i,
+  /\bfix\b/i,
+  /\bwrite\b/i,
+  /\bdevelop\b/i
+];
+var CORRECTION_REMINDER = "Remember: You have memory tools available - `npx ca learn` to save insights, `npx ca search` to find past solutions.";
+var PLANNING_REMINDER = "If you're uncertain or hesitant, remember your memory tools: `npx ca search` may have relevant context from past sessions.";
+function detectCorrection(prompt) {
+  return CORRECTION_PATTERNS.some((pattern) => pattern.test(prompt));
+}
+function detectPlanning(prompt) {
+  if (HIGH_CONFIDENCE_PLANNING.some((pattern) => pattern.test(prompt))) {
+    return true;
+  }
+  const lowMatches = LOW_CONFIDENCE_PLANNING.filter((pattern) => pattern.test(prompt));
+  return lowMatches.length >= 2;
+}
+function processUserPrompt(prompt) {
+  if (detectCorrection(prompt)) {
+    return {
+      hookSpecificOutput: {
+        hookEventName: "UserPromptSubmit",
+        additionalContext: CORRECTION_REMINDER
+      }
+    };
+  }
+  if (detectPlanning(prompt)) {
+    return {
+      hookSpecificOutput: {
+        hookEventName: "UserPromptSubmit",
+        additionalContext: PLANNING_REMINDER
+      }
+    };
+  }
+  return {};
+}
+var SAME_TARGET_THRESHOLD = 2;
+var TOTAL_FAILURE_THRESHOLD = 3;
+var STATE_FILE_NAME = ".ca-failure-state.json";
+var STATE_MAX_AGE_MS = 60 * 60 * 1e3;
+var failureCount = 0;
+var lastFailedTarget = null;
+var sameTargetCount = 0;
+function defaultState() {
+  return { count: 0, lastTarget: null, sameTargetCount: 0, timestamp: Date.now() };
+}
+function readFailureState(stateDir) {
+  try {
+    const filePath = join(stateDir, STATE_FILE_NAME);
+    if (!existsSync(filePath)) return defaultState();
+    const raw = readFileSync(filePath, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (Date.now() - parsed.timestamp > STATE_MAX_AGE_MS) return defaultState();
+    return parsed;
+  } catch {
+    return defaultState();
+  }
+}
+function writeFailureState(stateDir, state) {
+  try {
+    const filePath = join(stateDir, STATE_FILE_NAME);
+    writeFileSync(filePath, JSON.stringify(state), "utf-8");
+  } catch {
+  }
+}
+function deleteStateFile(stateDir) {
+  try {
+    const filePath = join(stateDir, STATE_FILE_NAME);
+    if (existsSync(filePath)) unlinkSync(filePath);
+  } catch {
+  }
+}
+var FAILURE_TIP = "Tip: Multiple failures detected. `npx ca search` may have solutions for similar issues.";
+function resetFailureState(stateDir) {
+  failureCount = 0;
+  lastFailedTarget = null;
+  sameTargetCount = 0;
+  if (stateDir) deleteStateFile(stateDir);
+}
+function getFailureTarget(toolName, toolInput) {
+  if (toolName === "Bash" && typeof toolInput.command === "string") {
+    const trimmed = toolInput.command.trim();
+    const firstSpace = trimmed.indexOf(" ");
+    return firstSpace === -1 ? trimmed : trimmed.slice(0, firstSpace);
+  }
+  if ((toolName === "Edit" || toolName === "Write") && typeof toolInput.file_path === "string") {
+    return toolInput.file_path;
+  }
+  return null;
+}
+function processToolFailure(toolName, toolInput, stateDir) {
+  if (stateDir) {
+    const persisted = readFailureState(stateDir);
+    failureCount = persisted.count;
+    lastFailedTarget = persisted.lastTarget;
+    sameTargetCount = persisted.sameTargetCount;
+  }
+  failureCount++;
+  const target = getFailureTarget(toolName, toolInput);
+  if (target !== null && target === lastFailedTarget) {
+    sameTargetCount++;
+  } else {
+    sameTargetCount = 1;
+    lastFailedTarget = target;
+  }
+  const shouldShowTip = sameTargetCount >= SAME_TARGET_THRESHOLD || failureCount >= TOTAL_FAILURE_THRESHOLD;
+  if (shouldShowTip) {
+    resetFailureState(stateDir);
+    return {
+      hookSpecificOutput: {
+        hookEventName: "PostToolUseFailure",
+        additionalContext: FAILURE_TIP
+      }
+    };
+  }
+  if (stateDir) {
+    writeFailureState(stateDir, {
+      count: failureCount,
+      lastTarget: lastFailedTarget,
+      sameTargetCount,
+      timestamp: Date.now()
+    });
+  }
+  return {};
+}
+function processToolSuccess(stateDir) {
+  resetFailureState(stateDir);
+}
+var STATE_DIR = ".claude";
+var STATE_FILE = ".ca-phase-state.json";
+var PHASE_STATE_MAX_AGE_MS = 72 * 60 * 60 * 1e3;
+var PHASES = ["brainstorm", "plan", "work", "review", "compound"];
+var GATES = ["post-plan", "gate-3", "gate-4", "final"];
+var PHASE_INDEX = {
+  brainstorm: 1,
+  plan: 2,
+  work: 3,
+  review: 4,
+  compound: 5
+};
+function getStatePath(repoRoot) {
+  return join(repoRoot, STATE_DIR, STATE_FILE);
+}
+function isPhaseName(value) {
+  return typeof value === "string" && PHASES.includes(value);
+}
+function isGateName(value) {
+  return typeof value === "string" && GATES.includes(value);
+}
+function isIsoDate(value) {
+  if (typeof value !== "string") return false;
+  return !Number.isNaN(Date.parse(value));
+}
+function isStringArray(value) {
+  return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+function validatePhaseState(raw) {
+  if (typeof raw !== "object" || raw === null) return false;
+  const state = raw;
+  return typeof state.lfg_active === "boolean" && typeof state.epic_id === "string" && isPhaseName(state.current_phase) && typeof state.phase_index === "number" && state.phase_index >= 1 && state.phase_index <= 5 && isStringArray(state.skills_read) && Array.isArray(state.gates_passed) && state.gates_passed.every((gate) => isGateName(gate)) && isIsoDate(state.started_at);
+}
+function expectedGateForPhase(phaseIndex) {
+  if (phaseIndex === 2) return "post-plan";
+  if (phaseIndex === 3) return "gate-3";
+  if (phaseIndex === 4) return "gate-4";
+  if (phaseIndex === 5) return "final";
+  return null;
+}
+function initPhaseState(repoRoot, epicId) {
+  const dir = join(repoRoot, STATE_DIR);
+  mkdirSync(dir, { recursive: true });
+  const state = {
+    lfg_active: true,
+    epic_id: epicId,
+    current_phase: "brainstorm",
+    phase_index: PHASE_INDEX.brainstorm,
+    skills_read: [],
+    gates_passed: [],
+    started_at: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  writeFileSync(getStatePath(repoRoot), JSON.stringify(state, null, 2), "utf-8");
+  return state;
+}
+function getPhaseState(repoRoot) {
+  try {
+    const path2 = getStatePath(repoRoot);
+    if (!existsSync(path2)) return null;
+    const raw = readFileSync(path2, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (!validatePhaseState(parsed)) return null;
+    const age = Date.now() - new Date(parsed.started_at).getTime();
+    if (age > PHASE_STATE_MAX_AGE_MS) {
+      cleanPhaseState(repoRoot);
+      return null;
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function updatePhaseState(repoRoot, partial) {
+  const current = getPhaseState(repoRoot);
+  if (current === null) return null;
+  const updated = {
+    ...current,
+    ...partial
+  };
+  if (!validatePhaseState(updated)) return null;
+  writeFileSync(getStatePath(repoRoot), JSON.stringify(updated, null, 2), "utf-8");
+  return updated;
+}
+function startPhase(repoRoot, phase) {
+  return updatePhaseState(repoRoot, {
+    current_phase: phase,
+    phase_index: PHASE_INDEX[phase]
+  });
+}
+function cleanPhaseState(repoRoot) {
+  try {
+    const path2 = getStatePath(repoRoot);
+    if (existsSync(path2)) unlinkSync(path2);
+  } catch {
+  }
+}
+function recordGatePassed(repoRoot, gate) {
+  const current = getPhaseState(repoRoot);
+  if (current === null) return null;
+  const gatesPassed = current.gates_passed.includes(gate) ? current.gates_passed : [...current.gates_passed, gate];
+  const updated = { ...current, gates_passed: gatesPassed };
+  if (gate === "final") {
+    cleanPhaseState(repoRoot);
+    return updated;
+  }
+  writeFileSync(getStatePath(repoRoot), JSON.stringify(updated, null, 2), "utf-8");
+  return updated;
+}
+function printStatusHuman(state) {
+  if (state === null) {
+    console.log("No active LFG session.");
+    return;
+  }
+  console.log("Active LFG Session");
+  console.log(`  Epic: ${state.epic_id}`);
+  console.log(`  Phase: ${state.current_phase} (${state.phase_index}/5)`);
+  console.log(`  Skills read: ${state.skills_read.length === 0 ? "(none)" : state.skills_read.join(", ")}`);
+  console.log(`  Gates passed: ${state.gates_passed.length === 0 ? "(none)" : state.gates_passed.join(", ")}`);
+  console.log(`  Started: ${state.started_at}`);
+}
+function registerPhaseSubcommands(phaseCheck, getDryRun, repoRoot) {
+  phaseCheck.command("init <epic-id>").description("Initialize phase state for an epic").action((epicId) => {
+    if (!EPIC_ID_PATTERN.test(epicId)) {
+      console.error(`Invalid epic ID: "${epicId}"`);
+      process.exitCode = 1;
+      return;
+    }
+    if (getDryRun()) {
+      console.log(`[dry-run] Would initialize phase state for epic ${epicId} in ${repoRoot()}`);
+      return;
+    }
+    initPhaseState(repoRoot(), epicId);
+    console.log(`Phase state initialized for ${epicId}. Current phase: brainstorm (1/5).`);
+  });
+  phaseCheck.command("start <phase>").description("Start or resume a phase").action((phase) => {
+    if (!isPhaseName(phase)) {
+      console.error(`Invalid phase: "${phase}". Valid phases: ${PHASES.join(", ")}`);
+      process.exitCode = 1;
+      return;
+    }
+    if (getDryRun()) {
+      console.log(`[dry-run] Would start phase ${phase}`);
+      return;
+    }
+    const state = startPhase(repoRoot(), phase);
+    if (state === null) {
+      console.error("No active phase state. Run: ca phase-check init <epic-id>");
+      process.exitCode = 1;
+      return;
+    }
+    console.log(`Phase updated: ${state.current_phase} (${state.phase_index}/5).`);
+  });
+  phaseCheck.command("gate <gate-name>").description("Record a phase gate as passed").action((gateName) => {
+    if (!isGateName(gateName)) {
+      console.error(`Invalid gate: "${gateName}". Valid gates: ${GATES.join(", ")}`);
+      process.exitCode = 1;
+      return;
+    }
+    if (getDryRun()) {
+      console.log(`[dry-run] Would record gate ${gateName}`);
+      return;
+    }
+    const state = recordGatePassed(repoRoot(), gateName);
+    if (state === null) {
+      console.error("No active phase state. Run: ca phase-check init <epic-id>");
+      process.exitCode = 1;
+      return;
+    }
+    if (gateName === "final") {
+      console.log("Final gate recorded. Phase state cleaned.");
+      return;
+    }
+    console.log(`Gate recorded: ${gateName}.`);
+  });
+  phaseCheck.command("status").description("Show current phase state").option("--json", "Output raw JSON").action((options) => {
+    const state = getPhaseState(repoRoot());
+    if (options.json) {
+      console.log(JSON.stringify(state ?? { lfg_active: false }));
+      return;
+    }
+    printStatusHuman(state);
+  });
+  phaseCheck.command("clean").description("Remove phase state file").action(() => {
+    if (getDryRun()) {
+      console.log("[dry-run] Would delete phase state file");
+      return;
+    }
+    cleanPhaseState(repoRoot());
+    console.log("Phase state cleaned.");
+  });
+}
+function registerPhaseCheckCommand(program2) {
+  const phaseCheck = program2.command("phase-check").description("Manage LFG phase state").option("--dry-run", "Show what would be done without making changes");
+  const getDryRun = () => phaseCheck.opts().dryRun ?? false;
+  const repoRoot = () => getRepoRoot();
+  registerPhaseSubcommands(phaseCheck, getDryRun, repoRoot);
+  program2.command("phase-clean").description("Remove phase state file (alias for `phase-check clean`)").action(() => {
+    cleanPhaseState(repoRoot());
+    console.log("Phase state cleaned.");
+  });
+}
 
-## Memory Integration
-- Run \`npx ca search "test optimization"\` before starting
-- After completion, capture findings via \`npx ca learn\`
-- Feed patterns into CCT system for future sessions
+// src/setup/hooks-phase-guard.ts
+function processPhaseGuard(repoRoot, toolName, _toolInput) {
+  try {
+    if (toolName !== "Edit" && toolName !== "Write") return {};
+    const state = getPhaseState(repoRoot);
+    if (state === null || !state.lfg_active) return {};
+    const expectedSkillPath = `.claude/skills/compound/${state.current_phase}/SKILL.md`;
+    const skillRead = state.skills_read.includes(expectedSkillPath);
+    if (!skillRead) {
+      return {
+        hookSpecificOutput: {
+          hookEventName: "PreToolUse",
+          additionalContext: `PHASE GUARD WARNING: You are in LFG phase ${state.phase_index}/5 (${state.current_phase}) but have NOT read the skill file yet. Read ${expectedSkillPath} before continuing.`
+        }
+      };
+    }
+    return {};
+  } catch {
+    return {};
+  }
+}
 
-## Common Pitfalls
-- Deleting tests without verifying coverage is maintained elsewhere
-- Optimizing for speed at the cost of correctness
-- Settling for partial approval or cutting the Phase 3 review loop short before BOTH reviewers approve with zero reservations
-- Making changes without machine-readable output
-- Not feeding results back into compound-agent memory
+// src/setup/hooks-read-tracker.ts
+var SKILL_PATH_PATTERN = /(?:^|\/)\.claude\/skills\/compound\/([^/]+)\/SKILL\.md$/;
+function normalizePath(path2) {
+  return path2.replaceAll("\\", "/");
+}
+function toCanonicalSkillPath(filePath) {
+  const normalized = normalizePath(filePath);
+  const match = SKILL_PATH_PATTERN.exec(normalized);
+  if (!match?.[1]) return null;
+  return `.claude/skills/compound/${match[1]}/SKILL.md`;
+}
+function processReadTracker(repoRoot, toolName, toolInput) {
+  try {
+    if (toolName !== "Read") return {};
+    const state = getPhaseState(repoRoot);
+    if (state === null || !state.lfg_active) return {};
+    const filePath = typeof toolInput.file_path === "string" ? toolInput.file_path : null;
+    if (filePath === null) return {};
+    const canonicalPath = toCanonicalSkillPath(filePath);
+    if (canonicalPath === null) return {};
+    if (!state.skills_read.includes(canonicalPath)) {
+      updatePhaseState(repoRoot, {
+        skills_read: [...state.skills_read, canonicalPath]
+      });
+    }
+    return {};
+  } catch {
+    return {};
+  }
+}
 
-## Quality Criteria
-- All 5 phases completed (analysis, planning, review, execution, verification)
-- Both adversarial reviewers approved with zero reservations after iterative refinement
-- Machine-readable output format used throughout
-- Full test suite passes after changes
-- Coverage not degraded
-- Findings captured in compound-agent memory
-`
-};
+// src/setup/hooks-stop-audit.ts
+function hasTransitionEvidence(state) {
+  if (state.phase_index === 5) return true;
+  const nextPhase = PHASES[state.phase_index];
+  if (nextPhase === void 0) return false;
+  const nextSkillPath = `.claude/skills/compound/${nextPhase}/SKILL.md`;
+  return state.skills_read.includes(nextSkillPath);
+}
+function processStopAudit(repoRoot, stopHookActive = false) {
+  try {
+    if (stopHookActive) return {};
+    const state = getPhaseState(repoRoot);
+    if (state === null || !state.lfg_active) return {};
+    const expectedGate = expectedGateForPhase(state.phase_index);
+    if (expectedGate === null) return {};
+    if (state.gates_passed.includes(expectedGate)) return {};
+    if (!hasTransitionEvidence(state)) return {};
+    return {
+      continue: false,
+      stopReason: `PHASE GATE NOT VERIFIED: ${state.current_phase} requires gate '${expectedGate}'. Run: npx ca phase-check gate ${expectedGate}`
+    };
+  } catch {
+    return {};
+  }
+}
 
-// src/setup/primitives.ts
+// src/setup/hooks.ts
+var HOOK_FILE_MODE = 493;
+function hasCompoundAgentHook(content) {
+  return content.includes(HOOK_MARKER);
+}
+async function getGitHooksDir(repoRoot) {
+  const gitPath = join(repoRoot, ".git");
+  if (!existsSync(gitPath)) {
+    return null;
+  }
+  let gitDir = gitPath;
+  if (lstatSync(gitPath).isFile()) {
+    const content = readFileSync(gitPath, "utf-8").trim();
+    const match = /^gitdir:\s*(.+)$/.exec(content);
+    if (!match?.[1]) return null;
+    gitDir = resolve(repoRoot, match[1]);
+  }
+  const configPath2 = join(gitDir, "config");
+  if (existsSync(configPath2)) {
+    const config = await readFile(configPath2, "utf-8");
+    const match = /hooksPath\s*=\s*(.+)$/m.exec(config);
+    if (match?.[1]) {
+      const hooksPath = match[1].trim();
+      return hooksPath.startsWith("/") ? hooksPath : join(repoRoot, hooksPath);
+    }
+  }
+  const defaultHooksDir = join(gitDir, "hooks");
+  return existsSync(defaultHooksDir) ? defaultHooksDir : null;
+}
+function findFirstTopLevelExitLine(lines) {
+  let insideFunction = 0;
+  let heredocDelimiter = null;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i] ?? "";
+    const trimmed = line.trim();
+    if (heredocDelimiter !== null) {
+      if (trimmed === heredocDelimiter) {
+        heredocDelimiter = null;
+      }
+      continue;
+    }
+    const heredocMatch = /<<-?\s*['"]?(\w+)['"]?/.exec(line);
+    if (heredocMatch?.[1]) {
+      heredocDelimiter = heredocMatch[1];
+      continue;
+    }
+    for (const char of line) {
+      if (char === "{") insideFunction++;
+      if (char === "}") insideFunction = Math.max(0, insideFunction - 1);
+    }
+    if (insideFunction > 0) {
+      continue;
+    }
+    if (/^\s*exit\s+(\d+|\$\w+|\$\?)\s*$/.test(trimmed)) {
+      return i;
+    }
+  }
+  return -1;
+}
+async function installPreCommitHook(repoRoot) {
+  const gitHooksDir = await getGitHooksDir(repoRoot);
+  if (!gitHooksDir) {
+    return { status: "not_git_repo" };
+  }
+  await mkdir(gitHooksDir, { recursive: true });
+  const hookPath = join(gitHooksDir, "pre-commit");
+  if (existsSync(hookPath)) {
+    const content = await readFile(hookPath, "utf-8");
+    if (hasCompoundAgentHook(content)) {
+      return { status: "already_installed" };
+    }
+    const lines = content.split("\n");
+    const exitLineIndex = findFirstTopLevelExitLine(lines);
+    let newContent;
+    if (exitLineIndex === -1) {
+      newContent = content.trimEnd() + "\n" + COMPOUND_AGENT_HOOK_BLOCK;
+    } else {
+      const before = lines.slice(0, exitLineIndex);
+      const after = lines.slice(exitLineIndex);
+      newContent = before.join("\n") + COMPOUND_AGENT_HOOK_BLOCK + after.join("\n");
+    }
+    await writeFile(hookPath, newContent, "utf-8");
+    chmodSync(hookPath, HOOK_FILE_MODE);
+    return { status: "appended" };
+  }
+  await writeFile(hookPath, PRE_COMMIT_HOOK_TEMPLATE, "utf-8");
+  chmodSync(hookPath, HOOK_FILE_MODE);
+  return { status: "installed" };
+}
+async function installPostCommitHook(repoRoot) {
+  const gitHooksDir = await getGitHooksDir(repoRoot);
+  if (!gitHooksDir) {
+    return { status: "not_git_repo" };
+  }
+  await mkdir(gitHooksDir, { recursive: true });
+  const hookPath = join(gitHooksDir, "post-commit");
+  if (existsSync(hookPath)) {
+    const content = await readFile(hookPath, "utf-8");
+    if (content.includes(POST_COMMIT_HOOK_MARKER)) {
+      return { status: "already_installed" };
+    }
+    const lines = content.split("\n");
+    const exitLineIndex = findFirstTopLevelExitLine(lines);
+    let newContent;
+    if (exitLineIndex === -1) {
+      newContent = content.trimEnd() + "\n" + COMPOUND_AGENT_POST_COMMIT_BLOCK;
+    } else {
+      const before = lines.slice(0, exitLineIndex);
+      const after = lines.slice(exitLineIndex);
+      newContent = before.join("\n") + COMPOUND_AGENT_POST_COMMIT_BLOCK + after.join("\n");
+    }
+    await writeFile(hookPath, newContent, "utf-8");
+    chmodSync(hookPath, HOOK_FILE_MODE);
+    return { status: "appended" };
+  }
+  await writeFile(hookPath, POST_COMMIT_HOOK_TEMPLATE, "utf-8");
+  chmodSync(hookPath, HOOK_FILE_MODE);
+  return { status: "installed" };
+}
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(chunk);
+  }
+  return Buffer.concat(chunks).toString("utf-8");
+}
+async function runUserPromptHook() {
+  try {
+    const input = await readStdin();
+    const data = JSON.parse(input);
+    if (!data.prompt) {
+      console.log(JSON.stringify({}));
+      return;
+    }
+    const result = processUserPrompt(data.prompt);
+    console.log(JSON.stringify(result));
+  } catch {
+    console.log(JSON.stringify({}));
+  }
+}
+async function runPostToolFailureHook() {
+  try {
+    const input = await readStdin();
+    const data = JSON.parse(input);
+    if (!data.tool_name) {
+      console.log(JSON.stringify({}));
+      return;
+    }
+    const stateDir = join(getRepoRoot(), ".claude");
+    const result = processToolFailure(data.tool_name, data.tool_input ?? {}, stateDir);
+    console.log(JSON.stringify(result));
+  } catch {
+    console.log(JSON.stringify({}));
+  }
+}
+async function runPostToolSuccessHook() {
+  try {
+    await readStdin();
+    const stateDir = join(getRepoRoot(), ".claude");
+    processToolSuccess(stateDir);
+    console.log(JSON.stringify({}));
+  } catch {
+    console.log(JSON.stringify({}));
+  }
+}
+async function runToolHook(processor) {
+  try {
+    const input = await readStdin();
+    const data = JSON.parse(input);
+    if (!data.tool_name) {
+      console.log(JSON.stringify({}));
+      return;
+    }
+    console.log(JSON.stringify(processor(getRepoRoot(), data.tool_name, data.tool_input ?? {})));
+  } catch {
+    console.log(JSON.stringify({}));
+  }
+}
+async function runStopAuditHook() {
+  try {
+    const input = await readStdin();
+    const data = JSON.parse(input);
+    console.log(JSON.stringify(processStopAudit(getRepoRoot(), data.stop_hook_active ?? false)));
+  } catch {
+    console.log(JSON.stringify({}));
+  }
+}
+function registerHooksCommand(program2) {
+  const hooksCommand = program2.command("hooks").description("Git hooks management");
+  hooksCommand.command("run <hook>").description("Run a hook script (called by git/Claude hooks)").option("--json", "Output as JSON").action(async (hook, options) => {
+    if (hook === "pre-commit") {
+      if (options.json) {
+        console.log(JSON.stringify({ hook: "pre-commit", message: PRE_COMMIT_MESSAGE }));
+      } else {
+        console.log(PRE_COMMIT_MESSAGE);
+      }
+    } else if (hook === "user-prompt") {
+      await runUserPromptHook();
+    } else if (hook === "post-tool-failure") {
+      await runPostToolFailureHook();
+    } else if (hook === "post-tool-success") {
+      await runPostToolSuccessHook();
+    } else if (hook === "phase-guard") {
+      await runToolHook(processPhaseGuard);
+    } else if (hook === "post-read" || hook === "read-tracker") {
+      await runToolHook(processReadTracker);
+    } else if (hook === "phase-audit" || hook === "stop-audit") {
+      await runStopAuditHook();
+    } else {
+      if (options.json) {
+        console.log(JSON.stringify({ error: `Unknown hook: ${hook}` }));
+      } else {
+        console.error(
+          formatError(
+            "hooks",
+            "UNKNOWN_HOOK",
+            `Unknown hook: ${hook}`,
+            "Valid hooks: pre-commit, user-prompt, post-tool-failure, post-tool-success, post-read (or read-tracker), phase-guard, phase-audit (or stop-audit)"
+          )
+        );
+      }
+      process.exitCode = 1;
+    }
+  });
+}
 var GENERATED_MARKER = "<!-- generated by compound-agent -->\n";
 function hasCompoundAgentSection(content) {
   return content.includes(COMPOUND_AGENT_SECTION_HEADER);
@@ -7410,6 +7569,7 @@ async function runSetup(options) {
     postCommitHook = (await installPostCommitHook(repoRoot)).status;
   }
   const { hooks } = await configureClaudeSettings();
+  await installGeminiAdapter({ dryRun: false, json: true });
   const gitignore = await ensureGitignore(repoRoot);
   let modelStatus = "skipped";
   if (!options.skipModel) {
@@ -7499,6 +7659,7 @@ async function runUpdate(repoRoot, dryRun) {
   let configUpdated = false;
   if (!dryRun) {
     const { hooks } = await configureClaudeSettings();
+    await installGeminiAdapter({ dryRun: false, json: true });
     configUpdated = hooks;
   }
   const gitignore = dryRun ? { added: [] } : await ensureGitignore(repoRoot);
@@ -9030,7 +9191,27 @@ function registerVerifyGatesCommand(program2) {
 }
 
 // src/changelog-data.ts
-var CHANGELOG_RECENT = `## [1.4.4] - 2026-02-23
+var CHANGELOG_RECENT = `## [1.5.0] - 2026-02-24
+
+### Added
+
+- **Gemini CLI compatibility adapter**: \`ca setup gemini\` scaffolds \`.gemini/\` directory with hook scripts, TOML slash commands, and inlined skills -- bridging compound-agent to work with Google's Gemini CLI via the Adapter Pattern
+- **Gemini hooks**: Maps SessionStart, BeforeAgent, BeforeTool, AfterTool to compound-agent's existing hook pipeline (\`ca prime\`, \`ca hooks run user-prompt\`, \`ca hooks run phase-guard\`, \`ca hooks run post-tool-success\`)
+- **Gemini TOML commands**: Auto-generates \`.gemini/commands/compound/*.toml\` using \`@{path}\` file injection to maintain a single source of truth with Claude commands
+- **Gemini skills proxying**: Inlines phase and agent role skill content into \`.gemini/skills/\` with YAML frontmatter
+- **23 integration tests** for the Gemini adapter covering hooks, settings.json, TOML commands, skills, and dry-run mode
+
+### Fixed
+
+- **Gemini hook stderr leak**: Corrected \`2>&1 > /dev/null\` (leaks stderr to stdout, corrupting JSON) to \`> /dev/null 2>&1\`
+- **Gemini TOML file injection syntax**: Changed \`@path\` to \`@{path}\` (Gemini CLI requires curly braces)
+- **Gemini skill file injection**: Skills now inline content instead of using \`@{path}\` which only works in TOML prompt fields, not SKILL.md
+- **Gemini phase guard always allowing**: Hook now checks \`ca hooks run phase-guard\` exit code and returns structured \`{"decision": "deny"}\` on failure (exit 0, not exit 2, so Gemini parses the reason from stdout)
+- **Gemini BeforeTool matcher incomplete**: Added \`create_file\` to BeforeTool and AfterTool matchers alongside \`replace\` and \`write_file\`
+- **TOML description escaping**: \`parseDescription\` now escapes \`\\\` and \`"\` to prevent malformed TOML output
+- **Flaky embedding test**: Added 15s timeout to \`isModelUsable\` test
+
+## [1.4.4] - 2026-02-23
 
 ### Added
 
@@ -9076,15 +9257,7 @@ var CHANGELOG_RECENT = `## [1.4.4] - 2026-02-23
 
 - **SQLite health check in \`ca doctor\`**: New check reports \`[FAIL]\` with fix hint when \`better-sqlite3\` cannot load
 - **SQLite status in \`ca setup --status\`**: Shows "OK" or "not available" alongside other status checks
-- **\`resetSqliteAvailability()\` export**: Allows re-probing SQLite after native module rebuild
-
-## [1.4.2] - 2026-02-23
-
-### Fixed
-
-- **Banner audio crash on headless Linux**: Async \`ENOENT\` error from missing \`aplay\` no longer crashes \`ca setup --update\`
-- **PowerShell path injection on Windows**: Temp paths containing apostrophes no longer break or inject commands in \`banner-audio.ts\`
-- **Banner audio test coverage**: Rewrote tests with proper mock isolation (\`vi.spyOn\` + file-scope \`vi.mock\`), covering async ENOENT, sync throw, stop() idempotency, and normal exit cleanup`;
+- **\`resetSqliteAvailability()\` export**: Allows re-probing SQLite after native module rebuild`;
 
 // src/commands/about.ts
 function registerAboutCommand(program2) {
@@ -9759,21 +9932,27 @@ fi
 
 # parse_json() - extract a value from JSON stdin
 # Uses jq (primary) with python3 fallback
-# Usage: echo '{"status":"open"}' | parse_json '.status'
+# Auto-unwraps single-element arrays (bd show --json returns [...])
+# Usage: echo '[{"status":"open"}]' | parse_json '.status'
 parse_json() {
   local filter="$1"
   if [ "$HAS_JQ" = true ]; then
-    jq -r "$filter"
+    jq -r "if type == \\"array\\" then .[0] else . end | $filter"
   else
     python3 -c "
 import sys, json
 data = json.load(sys.stdin)
+if isinstance(data, list):
+    data = data[0] if data else {}
 f = '$filter'.strip('.')
 parts = [p for p in f.split('.') if p]
 v = data
-for p in parts:
-    v = v[p]
-print(v)
+try:
+    for p in parts:
+        v = v[p]
+except (KeyError, IndexError, TypeError):
+    v = None
+print('' if v is None else v)
 "
   fi
 }
@@ -10299,6 +10478,7 @@ function registerSetupCommands(program2) {
   const setupCommand = program2.command("setup");
   registerSetupAllCommand(setupCommand);
   registerClaudeSubcommand(setupCommand);
+  registerGeminiSubcommand(setupCommand);
   registerDownloadModelCommand(program2);
 }
 function registerManagementCommands(program2) {