@kitsy/coop-ai 2.0.0 → 2.1.1

package/dist/index.cjs

@@ -30,18 +30,26 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  CliAgentClient: () => CliAgentClient,
+  CliCompletionProvider: () => CliCompletionProvider,
+  buildIdeaRefinementPrompt: () => buildIdeaRefinementPrompt,
+  buildTaskRefinementPrompt: () => buildTaskRefinementPrompt,
   build_contract: () => build_contract,
   build_decomposition_prompt: () => build_decomposition_prompt,
   constraint_violation_reasons: () => constraint_violation_reasons,
   create_provider: () => create_provider,
   create_provider_agent_client: () => create_provider_agent_client,
   create_provider_idea_decomposer: () => create_provider_idea_decomposer,
+  create_provider_refinement_client: () => create_provider_refinement_client,
   create_run: () => create_run,
   decompose_idea_to_tasks: () => decompose_idea_to_tasks,
   enforce_constraints: () => enforce_constraints,
   execute_task: () => execute_task,
   finalize_run: () => finalize_run,
   log_step: () => log_step,
+  parseRefinementDraftResponse: () => parseRefinementDraftResponse,
+  refine_idea_to_draft: () => refine_idea_to_draft,
+  refine_task_to_draft: () => refine_task_to_draft,
   resolve_provider_config: () => resolve_provider_config,
   select_agent: () => select_agent,
   validate_command: () => validate_command,
@@ -101,6 +109,17 @@ function taskAcceptance(task) {
   const maybe = asRecord(task).acceptance;
   return asStringArray(maybe) ?? [];
 }
+function taskTestsRequired(task) {
+  const maybe = asRecord(task).tests_required;
+  return asStringArray(maybe) ?? [];
+}
+function taskOriginRefs(task) {
+  const origin = asRecord(asRecord(task).origin);
+  return {
+    authority_refs: asStringArray(origin.authority_refs) ?? [],
+    derived_refs: asStringArray(origin.derived_refs) ?? []
+  };
+}
 function collectRelatedArtifacts(task, graph) {
   const context = asRecord(task.execution?.context ?? {});
   const relatedTaskIds = dedupe(asStringArray(context.tasks) ?? []);
@@ -195,9 +214,12 @@ function build_contract(task, graph, config) {
   const taskContextFiles = asStringArray(executionContext.files) ?? [];
   const taskContextTasks = asStringArray(executionContext.tasks) ?? [];
   const acceptance_criteria = taskAcceptance(task);
+  const tests_required = taskTestsRequired(task);
+  const origin_refs = taskOriginRefs(task);
   const related_task_artifacts = collectRelatedArtifacts(task, graph);
   const output_requirements = [
     ...DEFAULT_OUTPUT_REQUIREMENTS,
+    ...tests_required.length > 0 ? tests_required.map((entry) => `Required test: ${entry}`) : [],
     ...(task.artifacts?.produces ?? []).map((artifact) => {
       if (artifact.path) {
         return `Produce ${artifact.type} artifact at ${artifact.path}`;
@@ -229,6 +251,9 @@ function build_contract(task, graph, config) {
       files: taskContextFiles,
       tasks: taskContextTasks,
       acceptance_criteria,
+      tests_required,
+      authority_refs: origin_refs.authority_refs,
+      derived_refs: origin_refs.derived_refs,
       related_task_artifacts
     },
     output_requirements
@@ -628,7 +653,7 @@ function build_decomposition_prompt(input) {
   return [
     "You are a planning agent for COOP.",
     "Decompose the idea into 2-5 implementation tasks.",
-    "Each task needs: title, type(feature|bug|chore|spike), priority(p0-p3), and body.",
+    "Each task needs: title, type(feature|bug|chore|spike), priority(p0-p3), body, acceptance_criteria, and tests_required.",
     `Idea ID: ${input.idea_id}`,
     `Title: ${input.title}`,
     "Body:",
@@ -647,12 +672,273 @@ async function decompose_idea_to_tasks(input, client) {
   return drafts;
 }
 
+// src/refinement/refine.ts
+function sentenceCase2(value) {
+  if (value.length === 0) return value;
+  return `${value[0]?.toUpperCase() ?? ""}${value.slice(1)}`;
+}
+function nonEmptyLines2(input) {
+  return input.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+}
+function extractBulletIdeas2(body) {
+  return nonEmptyLines2(body).filter((line) => /^[-*]\s+/.test(line)).map((line) => line.replace(/^[-*]\s+/, "").trim()).filter(Boolean).slice(0, 5);
+}
+function taskBodySections(title) {
+  return [
+    "## Objective",
+    title,
+    "",
+    "## Scope",
+    "- Define implementation boundaries",
+    "",
+    "## Constraints",
+    "- Preserve existing behavior unless explicitly changed",
+    "",
+    "## References",
+    "- Add source refs during refinement/apply",
+    "",
+    "## Refinement Notes",
+    "- Generated by COOP refinement fallback"
+  ].join("\n");
+}
+function normalizeStringArray(value) {
+  if (!Array.isArray(value)) return void 0;
+  const entries = value.filter((entry) => typeof entry === "string").map((entry) => entry.trim()).filter(Boolean);
+  return entries.length > 0 ? entries : void 0;
+}
+function normalizeProposal(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return null;
+  }
+  const record = value;
+  const title = typeof record.title === "string" ? record.title.trim() : "";
+  if (!title) return null;
+  const action = record.action === "update" ? "update" : "create";
+  return {
+    action,
+    id: typeof record.id === "string" && record.id.trim() ? record.id.trim() : void 0,
+    target_id: typeof record.target_id === "string" && record.target_id.trim() ? record.target_id.trim() : void 0,
+    title,
+    type: record.type === "feature" || record.type === "bug" || record.type === "chore" || record.type === "spike" || record.type === "epic" ? record.type : void 0,
+    status: record.status === "todo" || record.status === "blocked" || record.status === "in_progress" || record.status === "in_review" || record.status === "done" || record.status === "canceled" ? record.status : void 0,
+    track: typeof record.track === "string" ? record.track.trim() || void 0 : void 0,
+    priority: record.priority === "p0" || record.priority === "p1" || record.priority === "p2" || record.priority === "p3" ? record.priority : void 0,
+    depends_on: normalizeStringArray(record.depends_on),
+    acceptance: normalizeStringArray(record.acceptance),
+    tests_required: normalizeStringArray(record.tests_required),
+    authority_refs: normalizeStringArray(record.authority_refs),
+    derived_refs: normalizeStringArray(record.derived_refs),
+    body: typeof record.body === "string" ? record.body : void 0
+  };
+}
+function normalizeDraft(value, mode, sourceId, sourceTitle) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return null;
+  }
+  const record = value;
+  const proposalsRaw = Array.isArray(record.proposals) ? record.proposals : Array.isArray(record.tasks) ? record.tasks : [];
+  const proposals = proposalsRaw.map((entry) => normalizeProposal(entry)).filter((entry) => Boolean(entry));
+  if (proposals.length === 0) return null;
+  const summary = typeof record.summary === "string" && record.summary.trim() ? record.summary.trim() : `Refined ${mode} ${sourceId}`;
+  return {
+    kind: "refinement_draft",
+    version: 1,
+    mode,
+    source: {
+      entity_type: mode,
+      id: sourceId,
+      title: sourceTitle
+    },
+    summary,
+    generated_at: (/* @__PURE__ */ new Date()).toISOString(),
+    proposals
+  };
+}
+function parseJsonObject(text) {
+  const trimmed = text.trim();
+  const candidates = [trimmed];
+  const fenced = trimmed.match(/```json\s*([\s\S]*?)```/i);
+  if (fenced?.[1]) {
+    candidates.push(fenced[1]);
+  }
+  const start = trimmed.indexOf("{");
+  const end = trimmed.lastIndexOf("}");
+  if (start >= 0 && end > start) {
+    candidates.push(trimmed.slice(start, end + 1));
+  }
+  for (const candidate of candidates) {
+    try {
+      const parsed = JSON.parse(candidate);
+      if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+        return parsed;
+      }
+    } catch {
+    }
+  }
+  return null;
+}
+function fallbackIdeaRefinement(input) {
+  const bullets = extractBulletIdeas2(input.body);
+  const tasks = bullets.length > 0 ? bullets.slice(0, 3).map((bullet, index) => ({
+    title: sentenceCase2(bullet),
+    body: taskBodySections(sentenceCase2(bullet)),
+    type: index === 0 ? "spike" : "feature",
+    priority: index === 0 ? "p1" : "p2",
+    track: "unassigned",
+    acceptance_criteria: [`${sentenceCase2(bullet)} is implemented as described`],
+    tests_required: ["Relevant integration or regression coverage is added"]
+  })) : [
+    {
+      title: `Define scope and acceptance for ${input.title}`,
+      body: taskBodySections(`Define scope and acceptance for ${input.title}`),
+      type: "spike",
+      priority: "p1",
+      track: "unassigned",
+      acceptance_criteria: [`Scope and acceptance are explicit for ${input.title}`],
+      tests_required: ["Planning review recorded"]
+    },
+    {
+      title: `Implement ${input.title}`,
+      body: taskBodySections(`Implement ${input.title}`),
+      type: "feature",
+      priority: "p1",
+      track: "unassigned",
+      acceptance_criteria: [`${input.title} is implemented end-to-end`],
+      tests_required: ["Automated test coverage added for the primary path"]
+    }
+  ];
+  return {
+    kind: "refinement_draft",
+    version: 1,
+    mode: "idea",
+    source: {
+      entity_type: "idea",
+      id: input.idea_id,
+      title: input.title
+    },
+    summary: `Refined idea ${input.idea_id} into ${tasks.length} proposed task(s).`,
+    generated_at: (/* @__PURE__ */ new Date()).toISOString(),
+    proposals: tasks.map((task) => ({
+      action: "create",
+      title: task.title,
+      type: task.type,
+      status: "todo",
+      track: task.track ?? "unassigned",
+      priority: task.priority,
+      acceptance: task.acceptance_criteria,
+      tests_required: task.tests_required,
+      body: task.body
+    }))
+  };
+}
+function fallbackTaskRefinement(input) {
+  const authorityRefs = input.task.origin?.authority_refs ?? [];
+  const derivedRefs = input.task.origin?.derived_refs ?? [];
+  const acceptance = input.task.acceptance && input.task.acceptance.length > 0 ? input.task.acceptance : [`${input.task.title} is complete and reviewable against its defined scope`];
+  const testsRequired = input.task.tests_required && input.task.tests_required.length > 0 ? input.task.tests_required : ["Automated regression coverage for the changed behavior"];
+  return {
+    kind: "refinement_draft",
+    version: 1,
+    mode: "task",
+    source: {
+      entity_type: "task",
+      id: input.task.id,
+      title: input.task.title
+    },
+    summary: `Refined task ${input.task.id} into an execution-ready update proposal.`,
+    generated_at: (/* @__PURE__ */ new Date()).toISOString(),
+    proposals: [
+      {
+        action: "update",
+        target_id: input.task.id,
+        title: input.task.title,
+        type: input.task.type,
+        status: input.task.status,
+        track: input.task.track,
+        priority: input.task.priority,
+        depends_on: input.task.depends_on,
+        acceptance,
+        tests_required: testsRequired,
+        authority_refs: authorityRefs,
+        derived_refs: derivedRefs,
+        body: input.body?.trim() || taskBodySections(input.task.title)
+      }
+    ]
+  };
+}
+function buildIdeaRefinementPrompt(input) {
+  return [
+    "You are a COOP planning agent.",
+    "Return ONLY JSON object with keys: summary, proposals.",
+    "proposals must be an array of task proposals.",
+    "Each proposal must include: action(create), title, type(feature|bug|chore|spike), priority(p0-p3), track, acceptance(string[]), tests_required(string[]), body.",
+    "Use depends_on only for existing task ids when necessary.",
+    `Idea ID: ${input.idea_id}`,
+    `Title: ${input.title}`,
+    "Body:",
+    input.body || "(empty)",
+    input.supplemental_context?.trim() ? ["Supplemental Context:", input.supplemental_context].join("\n") : ""
+  ].filter(Boolean).join("\n");
+}
+function buildTaskRefinementPrompt(input) {
+  const authorityContext = (input.authority_context ?? []).map((entry) => `Ref: ${entry.ref}
+${entry.content}`).join("\n\n---\n\n");
+  return [
+    "You are a COOP planning/refinement agent.",
+    "Return ONLY JSON object with keys: summary, proposals.",
+    "proposals must be an array with one update proposal for the current task.",
+    "The proposal must include: action(update), target_id, title, type, status, track, priority, depends_on, acceptance(string[]), tests_required(string[]), authority_refs(string[]), derived_refs(string[]), body.",
+    `Task ID: ${input.task.id}`,
+    `Title: ${input.task.title}`,
+    `Status: ${input.task.status}`,
+    `Type: ${input.task.type}`,
+    `Priority: ${input.task.priority ?? "p2"}`,
+    `Track: ${input.task.track ?? "unassigned"}`,
+    `Depends On: ${(input.task.depends_on ?? []).join(", ") || "-"}`,
+    "Task Body:",
+    input.body || "(empty)",
+    authorityContext ? ["Authority Context:", authorityContext].join("\n") : "",
+    input.supplemental_context?.trim() ? ["Supplemental Context:", input.supplemental_context].join("\n") : ""
+  ].filter(Boolean).join("\n");
+}
+async function refine_idea_to_draft(input, client) {
+  const prompt = buildIdeaRefinementPrompt(input);
+  if (!client) {
+    return fallbackIdeaRefinement(input);
+  }
+  const result = await client.refineIdea(prompt, input);
+  return result ?? fallbackIdeaRefinement(input);
+}
+async function refine_task_to_draft(input, client) {
+  const prompt = buildTaskRefinementPrompt(input);
+  if (!client) {
+    return fallbackTaskRefinement(input);
+  }
+  const result = await client.refineTask(prompt, input);
+  return result ?? fallbackTaskRefinement(input);
+}
+function parseRefinementDraftResponse(text, mode, sourceId, sourceTitle) {
+  const parsed = parseJsonObject(text);
+  if (!parsed) {
+    return null;
+  }
+  return normalizeDraft(parsed, mode, sourceId, sourceTitle);
+}
+
 // src/providers/config.ts
 var DEFAULT_MODELS = {
   openai: "gpt-5-mini",
   anthropic: "claude-3-5-sonnet-latest",
   gemini: "gemini-2.0-flash",
-  ollama: "llama3.2"
+  ollama: "llama3.2",
+  codex_cli: "gpt-5-codex",
+  claude_cli: "sonnet",
+  gemini_cli: "gemini-2.5-pro"
+};
+var DEFAULT_COMMAND = {
+  codex_cli: "codex",
+  claude_cli: "claude",
+  gemini_cli: "gemini"
 };
 var DEFAULT_KEY_ENV = {
   openai: "OPENAI_API_KEY",
@@ -682,7 +968,7 @@ function asFinite(value) {
 }
 function readProvider(value) {
   const normalized = asString(value)?.toLowerCase();
-  if (normalized === "openai" || normalized === "anthropic" || normalized === "gemini" || normalized === "ollama" || normalized === "mock") {
+  if (normalized === "openai" || normalized === "anthropic" || normalized === "gemini" || normalized === "ollama" || normalized === "mock" || normalized === "codex_cli" || normalized === "claude_cli" || normalized === "gemini_cli") {
     return normalized;
   }
   return "mock";
@@ -703,15 +989,34 @@ function resolve_provider_config(config) {
       timeout_ms: 6e4
     };
   }
+  if (provider === "codex_cli" || provider === "claude_cli" || provider === "gemini_cli") {
+    const section2 = lookupProviderSection(ai, provider);
+    const model2 = asString(section2.model) ?? asString(ai.model) ?? DEFAULT_MODELS[provider];
+    const timeout_ms2 = asFinite(section2.timeout_ms) ?? asFinite(ai.timeout_ms) ?? 3e5;
+    const command = asString(section2.command) ?? DEFAULT_COMMAND[provider];
+    const argsRaw = Array.isArray(section2.args) ? section2.args : Array.isArray(ai.args) ? ai.args : [];
+    const args = argsRaw.filter((entry) => typeof entry === "string" && entry.trim().length > 0);
+    return {
+      provider,
+      model: model2,
+      command,
+      args,
+      temperature: 0.2,
+      max_output_tokens: 4096,
+      timeout_ms: timeout_ms2
+    };
+  }
   const section = lookupProviderSection(ai, provider);
-  const model = asString(section.model) ?? asString(ai.model) ?? DEFAULT_MODELS[provider];
-  const base_url = asString(section.base_url) ?? asString(ai.base_url) ?? DEFAULT_BASE_URL[provider];
+  const cloudProvider = provider;
+  const model = asString(section.model) ?? asString(ai.model) ?? DEFAULT_MODELS[cloudProvider];
+  const base_url = asString(section.base_url) ?? asString(ai.base_url) ?? DEFAULT_BASE_URL[cloudProvider];
   const temperature = asFinite(section.temperature) ?? asFinite(ai.temperature) ?? 0.2;
   const max_output_tokens = asFinite(section.max_output_tokens) ?? asFinite(ai.max_output_tokens) ?? 1024;
   const timeout_ms = asFinite(section.timeout_ms) ?? asFinite(ai.timeout_ms) ?? 6e4;
   let api_key;
   if (provider !== "ollama") {
-    const envName = asString(section.api_key_env) ?? asString(ai.api_key_env) ?? DEFAULT_KEY_ENV[provider];
+    const keyedProvider = provider;
+    const envName = asString(section.api_key_env) ?? asString(ai.api_key_env) ?? DEFAULT_KEY_ENV[keyedProvider];
     const envValue = envName ? asString(process.env[envName]) : null;
     api_key = asString(section.api_key) ?? asString(ai.api_key) ?? envValue ?? void 0;
     if (!api_key) {
@@ -731,6 +1036,250 @@ function resolve_provider_config(config) {
   };
 }
 
+// src/providers/cli.ts
+var import_node_fs2 = __toESM(require("fs"), 1);
+var import_node_os = __toESM(require("os"), 1);
+var import_node_path3 = __toESM(require("path"), 1);
+var import_node_child_process2 = require("child_process");
+function defaultRunner(invocation) {
+  const result = (0, import_node_child_process2.spawnSync)(invocation.command, invocation.args, {
+    cwd: invocation.cwd,
+    encoding: "utf8",
+    input: invocation.input,
+    timeout: invocation.timeout_ms,
+    windowsHide: true
+  });
+  return {
+    status: result.status,
+    stdout: result.stdout ?? "",
+    stderr: result.stderr ?? "",
+    error: result.error
+  };
+}
+function asText(result) {
+  return [result.stdout, result.stderr].map((value) => value.trim()).filter(Boolean).join("\n").trim();
+}
+function requireSuccess(provider, result) {
+  if ((result.status ?? 1) === 0 && !result.error) {
+    return;
+  }
+  const details = asText(result) || result.error?.message || "unknown error";
+  throw new Error(`${provider} execution failed: ${details}`);
+}
+function tempOutputFile(prefix) {
+  return import_node_path3.default.join(import_node_os.default.tmpdir(), `${prefix}-${Date.now()}-${Math.random().toString(16).slice(2)}.txt`);
+}
+function combinedPrompt(input) {
+  return [input.system.trim(), input.prompt.trim()].filter(Boolean).join("\n\n");
+}
+function completionInvocation(config, input, cwd) {
+  if (config.provider === "codex_cli") {
+    const outputFile = tempOutputFile("coop-codex-complete");
+    return {
+      command: config.command ?? "codex",
+      args: [
+        "exec",
+        "-C",
+        cwd,
+        "--skip-git-repo-check",
+        "--sandbox",
+        "read-only",
+        ...config.model ? ["--model", config.model] : [],
+        "--output-last-message",
+        outputFile,
+        ...config.args ?? [],
+        "-"
+      ],
+      cwd,
+      input: combinedPrompt(input),
+      timeout_ms: config.timeout_ms
+    };
+  }
+  if (config.provider === "claude_cli") {
+    return {
+      command: config.command ?? "claude",
+      args: [
+        "-p",
+        combinedPrompt(input),
+        "--output-format",
+        "text",
+        "--permission-mode",
+        "plan",
+        ...config.model ? ["--model", config.model] : [],
+        ...config.args ?? []
+      ],
+      cwd,
+      timeout_ms: config.timeout_ms
+    };
+  }
+  return {
+    command: config.command ?? "gemini",
+    args: [
+      "-p",
+      combinedPrompt(input),
+      "--output-format",
+      "text",
+      "--approval-mode",
+      "plan",
+      ...config.model ? ["--model", config.model] : [],
+      ...config.args ?? []
+    ],
+    cwd,
+    timeout_ms: config.timeout_ms
+  };
+}
+function readCodexOutput(invocation) {
+  const index = invocation.args.indexOf("--output-last-message");
+  const outputFile = index >= 0 ? invocation.args[index + 1] : void 0;
+  if (!outputFile) return null;
+  if (!import_node_fs2.default.existsSync(outputFile)) return null;
+  try {
+    return import_node_fs2.default.readFileSync(outputFile, "utf8").trim();
+  } finally {
+    import_node_fs2.default.rmSync(outputFile, { force: true });
+  }
+}
+var CliCompletionProvider = class {
+  name;
+  config;
+  cwd;
+  runner;
+  constructor(config, options = {}) {
+    this.name = config.provider;
+    this.config = config;
+    this.cwd = import_node_path3.default.resolve(options.cwd ?? process.cwd());
+    this.runner = options.runner ?? defaultRunner;
+  }
+  async complete(input) {
+    const invocation = completionInvocation(this.config, input, this.cwd);
+    const result = this.runner(invocation);
+    requireSuccess(this.name, result);
+    const codexOutput = this.config.provider === "codex_cli" ? readCodexOutput(invocation) : null;
+    return {
+      text: codexOutput || result.stdout.trim() || result.stderr.trim()
+    };
+  }
+};
+function buildExecutionPrompt(task, contract, step, prompt, mode) {
+  const sections = [
+    mode === "execute" ? "You are executing a COOP task inside the repo. Make the necessary file changes, run allowed commands when needed, and finish with a concise summary." : "You are reviewing a COOP task inside the repo. Inspect the current workspace and return concise review findings only.",
+    `Task: ${task.id} - ${task.title}`,
+    `Goal: ${contract.goal}`,
+    `Step: ${step.step} (${step.action})`,
+    contract.context.acceptance_criteria.length > 0 ? `Acceptance: ${contract.context.acceptance_criteria.join(" | ")}` : "",
+    contract.context.tests_required.length > 0 ? `Tests Required: ${contract.context.tests_required.join(" | ")}` : "",
+    contract.context.authority_refs.length > 0 ? `Authority Refs: ${contract.context.authority_refs.join(" | ")}` : "",
+    contract.context.derived_refs.length > 0 ? `Derived Refs: ${contract.context.derived_refs.join(" | ")}` : "",
+    contract.permissions.read_paths.length > 0 ? `Allowed Read Paths: ${contract.permissions.read_paths.join(", ")}` : "",
+    contract.permissions.write_paths.length > 0 ? `Allowed Write Paths: ${contract.permissions.write_paths.join(", ")}` : "",
+    contract.permissions.allowed_commands.length > 0 ? `Allowed Commands: ${contract.permissions.allowed_commands.join(", ")}` : "",
+    contract.permissions.forbidden_commands.length > 0 ? `Forbidden Commands: ${contract.permissions.forbidden_commands.join(", ")}` : "",
+    prompt
+  ].filter(Boolean);
+  return sections.join("\n\n");
+}
+function countGitChanges(repoRoot, runner, timeoutMs) {
+  const result = runner({
+    command: "git",
+    args: ["status", "--porcelain"],
+    cwd: repoRoot,
+    timeout_ms: timeoutMs
+  });
+  if ((result.status ?? 1) !== 0) return 0;
+  return result.stdout.split(/\r?\n/).map((line) => line.trim()).filter(Boolean).length;
+}
+function executionInvocation(config, prompt, repoRoot, mode) {
+  if (config.provider === "codex_cli") {
+    const outputFile = tempOutputFile("coop-codex-run");
+    return {
+      command: config.command ?? "codex",
+      args: [
+        "exec",
+        "-C",
+        repoRoot,
+        "--skip-git-repo-check",
+        "--sandbox",
+        mode === "execute" ? "workspace-write" : "read-only",
+        ...mode === "execute" ? ["--full-auto"] : [],
+        ...config.model ? ["--model", config.model] : [],
+        "--output-last-message",
+        outputFile,
+        ...config.args ?? [],
+        "-"
+      ],
+      cwd: repoRoot,
+      input: prompt,
+      timeout_ms: config.timeout_ms
+    };
+  }
+  if (config.provider === "claude_cli") {
+    return {
+      command: config.command ?? "claude",
+      args: [
+        "-p",
+        prompt,
+        "--output-format",
+        "text",
+        "--permission-mode",
+        mode === "execute" ? "bypassPermissions" : "plan",
+        ...config.model ? ["--model", config.model] : [],
+        ...config.args ?? []
+      ],
+      cwd: repoRoot,
+      timeout_ms: config.timeout_ms
+    };
+  }
+  return {
+    command: config.command ?? "gemini",
+    args: [
+      "-p",
+      prompt,
+      "--output-format",
+      "text",
+      "--approval-mode",
+      mode === "execute" ? "yolo" : "plan",
+      ...config.model ? ["--model", config.model] : [],
+      ...config.args ?? []
+    ],
+    cwd: repoRoot,
+    timeout_ms: config.timeout_ms
+  };
+}
+var CliAgentClient = class {
+  config;
+  repoRoot;
+  runner;
+  constructor(config, options = {}) {
+    this.config = config;
+    this.repoRoot = import_node_path3.default.resolve(options.cwd ?? process.cwd());
+    this.runner = options.runner ?? defaultRunner;
+  }
+  async generate(input) {
+    const before = countGitChanges(this.repoRoot, this.runner, this.config.timeout_ms);
+    const prompt = buildExecutionPrompt(input.task, input.contract, input.step, input.prompt, "execute");
+    const invocation = executionInvocation(this.config, prompt, this.repoRoot, "execute");
+    const result = this.runner(invocation);
+    requireSuccess(this.config.provider, result);
+    const after = countGitChanges(this.repoRoot, this.runner, this.config.timeout_ms);
+    const codexOutput = this.config.provider === "codex_cli" ? readCodexOutput(invocation) : null;
+    return {
+      summary: codexOutput || result.stdout.trim() || result.stderr.trim() || `Completed ${input.step.step}.`,
+      file_changes: Math.max(0, after - before)
+    };
+  }
+  async review(input) {
+    const prompt = buildExecutionPrompt(input.task, input.contract, input.step, input.prompt, "review");
+    const invocation = executionInvocation(this.config, prompt, this.repoRoot, "review");
+    const result = this.runner(invocation);
+    requireSuccess(this.config.provider, result);
+    const codexOutput = this.config.provider === "codex_cli" ? readCodexOutput(invocation) : null;
+    return {
+      summary: codexOutput || result.stdout.trim() || result.stderr.trim() || `Reviewed ${input.step.step}.`,
+      file_changes: 0
+    };
+  }
+};
+
 // src/providers/http.ts
 async function post_json(url, init) {
   const controller = new AbortController();
@@ -927,6 +1476,10 @@ function create_provider(config) {
       return new GeminiProvider(resolved);
     case "ollama":
       return new OllamaProvider(resolved);
+    case "codex_cli":
+    case "claude_cli":
+    case "gemini_cli":
+      return new CliCompletionProvider(resolved);
     case "mock":
     default:
       return new MockProvider();
@@ -978,13 +1531,23 @@ function toTaskDrafts(value) {
   }
   return out;
 }
+function refinementSystemPrompt(mode) {
+  if (mode === "idea") {
+    return "Return ONLY JSON object with keys summary and proposals. proposals must be an array of task proposals with action(create), title, type, priority, track, acceptance, tests_required, body.";
+  }
+  return "Return ONLY JSON object with keys summary and proposals. proposals must be an array with one update proposal containing action(update), target_id, title, type, status, track, priority, depends_on, acceptance, tests_required, authority_refs, derived_refs, body.";
+}
 function asAgentResponse(text, tokens) {
   return {
     summary: text.trim(),
     tokens_used: tokens
   };
 }
-function create_provider_agent_client(config) {
+function create_provider_agent_client(config, runtime = {}) {
+  const resolved = resolve_provider_config(config);
+  if (resolved.provider === "codex_cli" || resolved.provider === "claude_cli" || resolved.provider === "gemini_cli") {
+    return new CliAgentClient(resolved, runtime);
+  }
   const provider = create_provider(config);
   return {
     async generate(input) {
@@ -1019,20 +1582,47 @@ function create_provider_idea_decomposer(config) {
     }
   };
 }
+function create_provider_refinement_client(config) {
+  const provider = create_provider(config);
+  return {
+    async refineIdea(prompt, input) {
+      const result = await provider.complete({
+        system: refinementSystemPrompt("idea"),
+        prompt
+      });
+      return parseRefinementDraftResponse(result.text, "idea", input.idea_id, input.title);
+    },
+    async refineTask(prompt, input) {
+      const result = await provider.complete({
+        system: refinementSystemPrompt("task"),
+        prompt
+      });
+      return parseRefinementDraftResponse(result.text, "task", input.task.id, input.task.title);
+    }
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  CliAgentClient,
+  CliCompletionProvider,
+  buildIdeaRefinementPrompt,
+  buildTaskRefinementPrompt,
   build_contract,
   build_decomposition_prompt,
   constraint_violation_reasons,
   create_provider,
   create_provider_agent_client,
   create_provider_idea_decomposer,
+  create_provider_refinement_client,
   create_run,
   decompose_idea_to_tasks,
   enforce_constraints,
   execute_task,
   finalize_run,
   log_step,
+  parseRefinementDraftResponse,
+  refine_idea_to_draft,
+  refine_task_to_draft,
   resolve_provider_config,
   select_agent,
   validate_command,