@locusai/cli 0.17.5 → 0.17.7

package/bin/locus.js

@@ -1271,7 +1271,12 @@ function updateIssueLabels(number, addLabels, removeLabels, options = {}) {
   gh(args, options);
 }
 function addIssueComment(number, body, options = {}) {
-  gh(`issue comment ${number} --body ${JSON.stringify(body)}`, options);
+  const cwd = options.cwd ?? process.cwd();
+  execFileSync("gh", ["issue", "comment", String(number), "--body", body], {
+    cwd,
+    encoding: "utf-8",
+    stdio: ["pipe", "pipe", "pipe"]
+  });
 }
 function createMilestone(owner, repo, title, dueOn, description, options = {}) {
   let args = `api repos/${owner}/${repo}/milestones -f title=${JSON.stringify(title)}`;
@@ -2800,11 +2805,17 @@ ${dim("Press Ctrl+C again to exit")}\r
             render();
             return;
           case SEQ_WORD_LEFT:
+          case SEQ_SHIFT_LEFT:
+          case SEQ_META_LEFT:
+          case SEQ_META_SHIFT_LEFT:
           case "\x1Bb":
             moveWordLeft();
             render();
             return;
           case SEQ_WORD_RIGHT:
+          case SEQ_SHIFT_RIGHT:
+          case SEQ_META_RIGHT:
+          case SEQ_META_SHIFT_RIGHT:
           case "\x1Bf":
             moveWordRight();
             render();
@@ -2828,7 +2839,7 @@ ${dim("Press Ctrl+C again to exit")}\r
             render();
             return;
           default:
-            if (seq.charCodeAt(0) >= 32 || seq.length > 1) {
+            if (seq.charCodeAt(0) >= 32) {
               insertText(seq);
               render();
             }
@@ -3131,7 +3142,7 @@ ${dim("Press")} ${yellow("ESC")} ${dim("again to force exit")}\r
 }
 var CSI = "\x1B[", SAVE_CURSOR = "\x1B7", RESTORE_CURSOR = "\x1B8", ENABLE_BRACKETED_PASTE, DISABLE_BRACKETED_PASTE, ENABLE_KITTY_KEYBOARD = "\x1B[>1u", DISABLE_KITTY_KEYBOARD = "\x1B[<u", PASTE_START, PASTE_END, CTRL_A = "\x01", CTRL_C = "\x03", CTRL_D = "\x04", CTRL_E = "\x05", CTRL_K = "\v", CTRL_J = `
 `, CTRL_U = "\x15", CTRL_W = "\x17", TAB = "\t", ENTER = "\r", ENTER_CRLF = `\r
-`, ESC = "\x1B", BACKSPACE = "", SEQ_LEFT, SEQ_RIGHT, SEQ_UP, SEQ_DOWN, SEQ_HOME, SEQ_END, SEQ_HOME_1, SEQ_END_4, SEQ_HOME_O = "\x1BOH", SEQ_END_O = "\x1BOF", SEQ_DELETE, SEQ_WORD_LEFT, SEQ_WORD_RIGHT, SEQ_SHIFT_ENTER_CSI_U, SEQ_SHIFT_ENTER_MODIFY, SEQ_SHIFT_ENTER_TILDE, SEQ_ALT_ENTER, CONTROL_SEQUENCES;
+`, ESC = "\x1B", BACKSPACE = "", SEQ_LEFT, SEQ_RIGHT, SEQ_UP, SEQ_DOWN, SEQ_HOME, SEQ_END, SEQ_HOME_1, SEQ_END_4, SEQ_HOME_O = "\x1BOH", SEQ_END_O = "\x1BOF", SEQ_DELETE, SEQ_WORD_LEFT, SEQ_WORD_RIGHT, SEQ_SHIFT_LEFT, SEQ_SHIFT_RIGHT, SEQ_META_LEFT, SEQ_META_RIGHT, SEQ_META_SHIFT_LEFT, SEQ_META_SHIFT_RIGHT, SEQ_SHIFT_ENTER_CSI_U, SEQ_SHIFT_ENTER_MODIFY, SEQ_SHIFT_ENTER_TILDE, SEQ_ALT_ENTER, CONTROL_SEQUENCES;
 var init_input_handler = __esm(() => {
   init_terminal();
   init_image_detect();
@@ -3150,6 +3161,12 @@ var init_input_handler = __esm(() => {
   SEQ_DELETE = `${CSI}3~`;
   SEQ_WORD_LEFT = `${CSI}1;5D`;
   SEQ_WORD_RIGHT = `${CSI}1;5C`;
+  SEQ_SHIFT_LEFT = `${CSI}1;2D`;
+  SEQ_SHIFT_RIGHT = `${CSI}1;2C`;
+  SEQ_META_LEFT = `${CSI}1;9D`;
+  SEQ_META_RIGHT = `${CSI}1;9C`;
+  SEQ_META_SHIFT_LEFT = `${CSI}1;10D`;
+  SEQ_META_SHIFT_RIGHT = `${CSI}1;10C`;
   SEQ_SHIFT_ENTER_CSI_U = `${CSI}13;2u`;
   SEQ_SHIFT_ENTER_MODIFY = `${CSI}27;2;13~`;
   SEQ_SHIFT_ENTER_TILDE = `${CSI}13;2~`;
@@ -3163,6 +3180,12 @@ var init_input_handler = __esm(() => {
     SEQ_ALT_ENTER,
     SEQ_WORD_LEFT,
     SEQ_WORD_RIGHT,
+    SEQ_META_SHIFT_LEFT,
+    SEQ_META_SHIFT_RIGHT,
+    SEQ_META_LEFT,
+    SEQ_META_RIGHT,
+    SEQ_SHIFT_LEFT,
+    SEQ_SHIFT_RIGHT,
     SEQ_DELETE,
     SEQ_HOME_1,
     SEQ_END_4,
@@ -3449,6 +3472,10 @@ var init_runner = __esm(() => {
 });
 
 // src/ai/run-ai.ts
+var exports_run_ai = {};
+__export(exports_run_ai, {
+  runAI: () => runAI
+});
 async function runAI(options) {
   const indicator = getStatusIndicator();
   const renderer = options.silent ? null : new StreamRenderer;
@@ -7668,14 +7695,23 @@ __export(exports_plan, {
   parsePlanOutput: () => parsePlanOutput,
   parsePlanArgs: () => parsePlanArgs
 });
-import { existsSync as existsSync13, readFileSync as readFileSync10 } from "node:fs";
+import {
+  existsSync as existsSync13,
+  mkdirSync as mkdirSync10,
+  readdirSync as readdirSync7,
+  readFileSync as readFileSync10,
+  writeFileSync as writeFileSync8
+} from "node:fs";
 import { join as join14 } from "node:path";
 function printHelp() {
   process.stderr.write(`
 ${bold("locus plan")} — AI-powered sprint planning
 
 ${bold("Usage:")}
-  locus plan "<directive>"                 ${dim("# AI breaks down into issues")}
+  locus plan "<directive>"                 ${dim("# AI creates a plan file")}
+  locus plan approve <id>                  ${dim("# Create GitHub issues from saved plan")}
+  locus plan list                          ${dim("# List saved plans")}
+  locus plan show <id>                     ${dim("# Show a saved plan")}
   locus plan --from-issues --sprint <name> ${dim("# Organize existing issues")}
 
 ${bold("Options:")}
@@ -7686,6 +7722,8 @@ ${bold("Options:")}
 ${bold("Examples:")}
   locus plan "Build user authentication with OAuth"
   locus plan "Improve API performance" --sprint "Sprint 3"
+  locus plan approve abc123
+  locus plan list
   locus plan --from-issues --sprint "Sprint 2"
 
 `);
@@ -7693,11 +7731,48 @@ ${bold("Examples:")}
 function normalizeSprintName(name) {
   return name.trim().toLowerCase();
 }
+function getPlansDir(projectRoot) {
+  return join14(projectRoot, ".locus", "plans");
+}
+function ensurePlansDir(projectRoot) {
+  const dir = getPlansDir(projectRoot);
+  if (!existsSync13(dir)) {
+    mkdirSync10(dir, { recursive: true });
+  }
+  return dir;
+}
+function generateId() {
+  return `${Math.random().toString(36).slice(2, 8)}`;
+}
+function loadPlanFile(projectRoot, id) {
+  const dir = getPlansDir(projectRoot);
+  if (!existsSync13(dir))
+    return null;
+  const files = readdirSync7(dir).filter((f) => f.endsWith(".json"));
+  const match = files.find((f) => f.startsWith(id));
+  if (!match)
+    return null;
+  try {
+    const content = readFileSync10(join14(dir, match), "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
 async function planCommand(projectRoot, args, flags = {}) {
   if (args[0] === "help" || args.length === 0) {
     printHelp();
     return;
   }
+  if (args[0] === "list") {
+    return handleListPlans(projectRoot);
+  }
+  if (args[0] === "show") {
+    return handleShowPlan(projectRoot, args[1]);
+  }
+  if (args[0] === "approve") {
+    return handleApprovePlan(projectRoot, args[1], flags);
+  }
   const parsedArgs = parsePlanArgs(args);
   if (parsedArgs.error) {
     process.stderr.write(`${red("✗")} ${parsedArgs.error}
@@ -7721,7 +7796,138 @@ async function planCommand(projectRoot, args, flags = {}) {
   }
   return handleAIPlan(projectRoot, config, directive, sprintName, flags);
 }
+function handleListPlans(projectRoot) {
+  const dir = getPlansDir(projectRoot);
+  if (!existsSync13(dir)) {
+    process.stderr.write(`${dim("No saved plans yet.")}
+`);
+    return;
+  }
+  const files = readdirSync7(dir).filter((f) => f.endsWith(".json")).sort().reverse();
+  if (files.length === 0) {
+    process.stderr.write(`${dim("No saved plans yet.")}
+`);
+    return;
+  }
+  process.stderr.write(`
+${bold("Saved Plans:")}
+
+`);
+  for (const file of files) {
+    const id = file.replace(".json", "");
+    try {
+      const content = readFileSync10(join14(dir, file), "utf-8");
+      const plan = JSON.parse(content);
+      const date = plan.createdAt ? plan.createdAt.slice(0, 10) : "";
+      const issueCount = Array.isArray(plan.issues) ? plan.issues.length : 0;
+      process.stderr.write(`  ${cyan(id.slice(0, 12))}  ${plan.directive.slice(0, 55)}  ${dim(`${issueCount} issues`)}  ${dim(date)}
+`);
+    } catch {
+      process.stderr.write(`  ${cyan(id.slice(0, 12))}  ${dim("(unreadable)")}
+`);
+    }
+  }
+  process.stderr.write(`
+`);
+  process.stderr.write(`  Approve a plan: ${bold("locus plan approve <id>")}
+
+`);
+}
+function handleShowPlan(projectRoot, id) {
+  if (!id) {
+    process.stderr.write(`${red("✗")} Please provide a plan ID.
+`);
+    process.stderr.write(`  Usage: ${bold("locus plan show <id>")}
+`);
+    return;
+  }
+  const plan = loadPlanFile(projectRoot, id);
+  if (!plan) {
+    process.stderr.write(`${red("✗")} Plan "${id}" not found.
+`);
+    process.stderr.write(`  List plans with: ${bold("locus plan list")}
+`);
+    return;
+  }
+  process.stderr.write(`
+${bold("Plan:")} ${cyan(plan.directive)}
+`);
+  process.stderr.write(`  ${dim(`ID: ${plan.id}`)}
+`);
+  if (plan.sprint) {
+    process.stderr.write(`  ${dim(`Sprint: ${plan.sprint}`)}
+`);
+  }
+  process.stderr.write(`  ${dim(`Created: ${plan.createdAt.slice(0, 10)}`)}
+`);
+  process.stderr.write(`
+`);
+  process.stderr.write(`  ${dim("Order")}  ${dim("Title".padEnd(50))}  ${dim("Priority")}   ${dim("Type")}
+`);
+  for (const issue of plan.issues) {
+    process.stderr.write(`  ${String(issue.order).padStart(5)}  ${issue.title.padEnd(50).slice(0, 50)}  ${issue.priority.padEnd(10)} ${issue.type}
+`);
+  }
+  process.stderr.write(`
+`);
+  process.stderr.write(`  Approve: ${bold(`locus plan approve ${plan.id.slice(0, 8)}`)}
+
+`);
+}
+async function handleApprovePlan(projectRoot, id, flags) {
+  if (!id) {
+    process.stderr.write(`${red("✗")} Please provide a plan ID.
+`);
+    process.stderr.write(`  Usage: ${bold("locus plan approve <id>")}
+`);
+    process.stderr.write(`  List plans with: ${bold("locus plan list")}
+`);
+    return;
+  }
+  const plan = loadPlanFile(projectRoot, id);
+  if (!plan) {
+    process.stderr.write(`${red("✗")} Plan "${id}" not found.
+`);
+    process.stderr.write(`  List plans with: ${bold("locus plan list")}
+`);
+    return;
+  }
+  if (!Array.isArray(plan.issues) || plan.issues.length === 0) {
+    process.stderr.write(`${red("✗")} Plan "${id}" has no issues.
+`);
+    return;
+  }
+  const config = loadConfig(projectRoot);
+  process.stderr.write(`
+${bold("Approving plan:")} ${cyan(plan.directive)}
+`);
+  if (plan.sprint) {
+    process.stderr.write(`  ${dim(`Sprint: ${plan.sprint}`)}
+`);
+  }
+  process.stderr.write(`
+`);
+  process.stderr.write(`  ${dim("Order")}  ${dim("Title".padEnd(50))}  ${dim("Priority")}   ${dim("Type")}
+`);
+  for (const issue of plan.issues) {
+    process.stderr.write(`  ${String(issue.order).padStart(5)}  ${issue.title.padEnd(50).slice(0, 50)}  ${issue.priority.padEnd(10)} ${issue.type}
+`);
+  }
+  process.stderr.write(`
+`);
+  if (flags.dryRun) {
+    process.stderr.write(`${yellow("⚠")} ${bold("Dry run")} — no issues created.
+
+`);
+    return;
+  }
+  await createPlannedIssues(projectRoot, config, plan.issues, plan.sprint ?? undefined);
+}
 async function handleAIPlan(projectRoot, config, directive, sprintName, flags) {
+  const id = generateId();
+  const plansDir = ensurePlansDir(projectRoot);
+  const planPath = join14(plansDir, `${id}.json`);
+  const planPathRelative = `.locus/plans/${id}.json`;
   process.stderr.write(`
 ${bold("Planning:")} ${cyan(directive)}
 `);
@@ -7731,55 +7937,65 @@ ${bold("Planning:")} ${cyan(directive)}
   }
   process.stderr.write(`
 `);
-  const context = buildPlanningContext(projectRoot, config, directive);
-  const aiResult = await runAI({
-    prompt: context,
-    provider: config.ai.provider,
-    model: flags.model ?? config.ai.model,
-    cwd: projectRoot,
-    activity: "sprint planning"
-  });
-  if (aiResult.interrupted) {
+  const prompt = buildPlanningPrompt(projectRoot, config, directive, sprintName, id, planPathRelative);
+  const { execCommand: execCommand2 } = await Promise.resolve().then(() => (init_exec(), exports_exec));
+  await execCommand2(projectRoot, [prompt], {});
+  if (!existsSync13(planPath)) {
     process.stderr.write(`
-${yellow("⚡")} Planning interrupted.
+${yellow("⚠")} Plan file was not created at ${bold(planPathRelative)}.
+`);
+    process.stderr.write(`  Try again or create issues manually with ${bold("locus issue create")}.
 `);
     return;
   }
-  if (!aiResult.success) {
+  let plan;
+  try {
+    const content = readFileSync10(planPath, "utf-8");
+    plan = JSON.parse(content);
+  } catch {
     process.stderr.write(`
-${red("✗")} Planning failed: ${aiResult.error ?? "Unknown error"}
+${red("✗")} Plan file at ${bold(planPathRelative)} is not valid JSON.
 `);
     return;
   }
-  const output = sanitizePlanOutput(aiResult.output);
-  const planned = parsePlanOutput(output);
-  if (planned.length === 0) {
+  if (!Array.isArray(plan.issues) || plan.issues.length === 0) {
     process.stderr.write(`
-${yellow("⚠")} Could not extract structured issues from plan.
-`);
-    process.stderr.write(`  The AI output is shown above. Create issues manually with ${bold("locus issue create")}.
+${yellow("⚠")} Plan file has no issues.
 `);
     return;
   }
+  if (!plan.id)
+    plan.id = id;
+  if (!plan.directive)
+    plan.directive = directive;
+  if (!plan.sprint && sprintName)
+    plan.sprint = sprintName;
+  if (!plan.createdAt)
+    plan.createdAt = new Date().toISOString();
+  writeFileSync8(planPath, JSON.stringify(plan, null, 2), "utf-8");
   process.stderr.write(`
-${bold("Planned Issues:")}
+${bold("Plan saved:")} ${cyan(id)}
 
 `);
-  process.stderr.write(`  ${dim("Order")}  ${dim("Title".padEnd(45))}  ${dim("Priority")}   ${dim("Type")}
+  process.stderr.write(`  ${dim("Order")}  ${dim("Title".padEnd(50))}  ${dim("Priority")}   ${dim("Type")}
 `);
-  for (const issue of planned) {
-    process.stderr.write(`  ${String(issue.order).padStart(5)}  ${issue.title.padEnd(45).slice(0, 45)}  ${issue.priority.padEnd(10)} ${issue.type}
+  for (const issue of plan.issues) {
+    process.stderr.write(`  ${String(issue.order).padStart(5)}  ${issue.title.padEnd(50).slice(0, 50)}  ${(issue.priority ?? "medium").padEnd(10)} ${issue.type ?? "feature"}
 `);
   }
   process.stderr.write(`
 `);
   if (flags.dryRun) {
     process.stderr.write(`${yellow("⚠")} ${bold("Dry run")} — no issues created.
+`);
+    process.stderr.write(`  Approve later with: ${bold(`locus plan approve ${id.slice(0, 8)}`)}
 
 `);
     return;
   }
-  await createPlannedIssues(projectRoot, config, planned, sprintName);
+  process.stderr.write(`  To create these issues: ${bold(`locus plan approve ${id.slice(0, 8)}`)}
+
+`);
 }
 async function handleFromIssues(projectRoot, config, sprintName, flags) {
   if (!sprintName) {
@@ -7801,6 +8017,7 @@ ${bold("Organizing issues for:")} ${cyan(sprintName)}
 ${i.body?.slice(0, 300) ?? ""}`).join(`
 
 `);
+  const { runAI: runAI2 } = await Promise.resolve().then(() => (init_run_ai(), exports_run_ai));
   const prompt = `You are organizing GitHub issues for a sprint. Analyze these issues and suggest the optimal execution order.
 
 Issues:
@@ -7811,7 +8028,7 @@ ORDER: #<number> <reason for this position>
 
 Order them so that dependencies are respected (issues that produce code needed by later issues should come first).
 Start with foundational/setup tasks, then core features, then integration/testing.`;
-  const aiResult = await runAI({
+  const aiResult = await runAI2({
     prompt,
     provider: config.ai.provider,
     model: flags.model ?? config.ai.model,
@@ -7879,11 +8096,14 @@ ${bold("Suggested Order:")}
 `);
   }
 }
-function buildPlanningContext(projectRoot, config, directive) {
+function buildPlanningPrompt(projectRoot, config, directive, sprintName, id, planPathRelative) {
   const parts = [];
   parts.push(`You are a sprint planning assistant for the GitHub repository ${config.github.owner}/${config.github.repo}.`);
   parts.push("");
   parts.push(`DIRECTIVE: ${directive}`);
+  if (sprintName) {
+    parts.push(`SPRINT: ${sprintName}`);
+  }
   parts.push("");
   const locusPath = join14(projectRoot, "LOCUS.md");
   if (existsSync13(locusPath)) {
@@ -7899,28 +8119,37 @@ function buildPlanningContext(projectRoot, config, directive) {
     parts.push(content.slice(0, 2000));
     parts.push("");
   }
-  parts.push("INSTRUCTIONS:");
-  parts.push("Break down the directive into specific, actionable GitHub issues.");
-  parts.push("Each issue should be independently executable by an AI agent.");
-  parts.push("Order them so dependencies are respected (foundational tasks first).");
+  parts.push("TASK:");
+  parts.push(`Break down the directive into specific, actionable GitHub issues and write them to the file: ${planPathRelative}`);
   parts.push("");
-  parts.push("For EACH issue, output EXACTLY this format (one per issue):");
+  parts.push(`Write ONLY a valid JSON file to ${planPathRelative} with this exact structure:`);
   parts.push("");
-  parts.push("---ISSUE---");
-  parts.push("ORDER: <number>");
-  parts.push("TITLE: <concise issue title>");
-  parts.push("PRIORITY: <critical|high|medium|low>");
-  parts.push("TYPE: <feature|bug|chore|refactor|docs>");
-  parts.push("DEPENDS_ON: <comma-separated previous order numbers, or 'none'>");
-  parts.push("BODY:");
-  parts.push("<detailed issue description with acceptance criteria>");
-  parts.push("---END---");
+  parts.push("```json");
+  parts.push("{");
+  parts.push(`  "id": "${id}",`);
+  parts.push(`  "directive": ${JSON.stringify(directive)},`);
+  parts.push(`  "sprint": ${sprintName ? JSON.stringify(sprintName) : "null"},`);
+  parts.push(`  "createdAt": "${new Date().toISOString()}",`);
+  parts.push('  "issues": [');
+  parts.push("    {");
+  parts.push('      "order": 1,');
+  parts.push('      "title": "concise issue title",');
+  parts.push('      "body": "detailed markdown body with acceptance criteria",');
+  parts.push('      "priority": "critical|high|medium|low",');
+  parts.push('      "type": "feature|bug|chore|refactor|docs",');
+  parts.push('      "dependsOn": "none or comma-separated order numbers"');
+  parts.push("    }");
+  parts.push("  ]");
+  parts.push("}");
+  parts.push("```");
   parts.push("");
-  parts.push("Be specific in issue bodies. Include:");
-  parts.push("- What code/files should be created or modified");
-  parts.push("- Acceptance criteria (testable conditions)");
-  parts.push("- What previous tasks produce that this task needs");
-  parts.push("- Use valid GitHub Markdown only (no ANSI color/control codes)");
+  parts.push("Requirements for the issues:");
+  parts.push("- Break the directive into 3-10 specific, actionable issues");
+  parts.push("- Each issue must be independently executable by an AI agent");
+  parts.push("- Order them so dependencies are respected (foundational tasks first)");
+  parts.push("- Write detailed issue bodies with clear acceptance criteria");
+  parts.push("- Use valid GitHub Markdown only in issue bodies");
+  parts.push("- Create the file using the Write tool — do not print the JSON to the terminal");
   return parts.join(`
 `);
 }
@@ -8050,7 +8279,6 @@ ${green("✓")} Created ${planned.length} issues.${milestoneTitle ? ` Sprint: ${
 `);
 }
 var init_plan = __esm(() => {
-  init_run_ai();
   init_config();
   init_github();
   init_terminal();
@@ -8525,11 +8753,11 @@ __export(exports_discuss, {
 });
 import {
   existsSync as existsSync15,
-  mkdirSync as mkdirSync10,
-  readdirSync as readdirSync7,
+  mkdirSync as mkdirSync11,
+  readdirSync as readdirSync8,
   readFileSync as readFileSync12,
   unlinkSync as unlinkSync5,
-  writeFileSync as writeFileSync8
+  writeFileSync as writeFileSync9
 } from "node:fs";
 import { join as join16 } from "node:path";
 import { createInterface as createInterface2 } from "node:readline";
@@ -8541,6 +8769,7 @@ ${bold("Usage:")}
   locus discuss "<topic>"          ${dim("# Start a new discussion")}
   locus discuss list               ${dim("# List all discussions")}
   locus discuss show <id>          ${dim("# Show a discussion")}
+  locus discuss plan <id>          ${dim("# Convert discussion to a plan")}
   locus discuss delete <id>        ${dim("# Delete a discussion")}
 
 ${bold("Examples:")}
@@ -8548,6 +8777,7 @@ ${bold("Examples:")}
   locus discuss "Monorepo vs polyrepo for our microservices"
   locus discuss list
   locus discuss show abc123
+  locus discuss plan abc123
 
 `);
 }
@@ -8557,11 +8787,11 @@ function getDiscussionsDir(projectRoot) {
 function ensureDiscussionsDir(projectRoot) {
   const dir = getDiscussionsDir(projectRoot);
   if (!existsSync15(dir)) {
-    mkdirSync10(dir, { recursive: true });
+    mkdirSync11(dir, { recursive: true });
   }
   return dir;
 }
-function generateId() {
+function generateId2() {
   return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
 }
 async function discussCommand(projectRoot, args, flags = {}) {
@@ -8576,6 +8806,9 @@ async function discussCommand(projectRoot, args, flags = {}) {
   if (subcommand === "show") {
     return showDiscussion(projectRoot, args[1]);
   }
+  if (subcommand === "plan") {
+    return convertDiscussionToPlan(projectRoot, args[1]);
+  }
   if (subcommand === "delete") {
     return deleteDiscussion(projectRoot, args[1]);
   }
@@ -8597,7 +8830,7 @@ function listDiscussions(projectRoot) {
 `);
     return;
   }
-  const files = readdirSync7(dir).filter((f) => f.endsWith(".md")).sort().reverse();
+  const files = readdirSync8(dir).filter((f) => f.endsWith(".md")).sort().reverse();
   if (files.length === 0) {
     process.stderr.write(`${dim("No discussions yet.")}
 `);
@@ -8632,7 +8865,7 @@ function showDiscussion(projectRoot, id) {
 `);
     return;
   }
-  const files = readdirSync7(dir).filter((f) => f.endsWith(".md"));
+  const files = readdirSync8(dir).filter((f) => f.endsWith(".md"));
   const match = files.find((f) => f.startsWith(id));
   if (!match) {
     process.stderr.write(`${red("✗")} Discussion "${id}" not found.
@@ -8655,7 +8888,7 @@ function deleteDiscussion(projectRoot, id) {
 `);
     return;
   }
-  const files = readdirSync7(dir).filter((f) => f.endsWith(".md"));
+  const files = readdirSync8(dir).filter((f) => f.endsWith(".md"));
   const match = files.find((f) => f.startsWith(id));
   if (!match) {
     process.stderr.write(`${red("✗")} Discussion "${id}" not found.
@@ -8666,6 +8899,38 @@ function deleteDiscussion(projectRoot, id) {
   process.stderr.write(`${green("✓")} Deleted discussion: ${match.replace(".md", "")}
 `);
 }
+async function convertDiscussionToPlan(projectRoot, id) {
+  if (!id) {
+    process.stderr.write(`${red("✗")} Please provide a discussion ID.
+`);
+    process.stderr.write(`  Usage: ${bold("locus discuss plan <id>")}
+`);
+    return;
+  }
+  const dir = getDiscussionsDir(projectRoot);
+  if (!existsSync15(dir)) {
+    process.stderr.write(`${red("✗")} No discussions found.
+`);
+    return;
+  }
+  const files = readdirSync8(dir).filter((f) => f.endsWith(".md"));
+  const match = files.find((f) => f.startsWith(id));
+  if (!match) {
+    process.stderr.write(`${red("✗")} Discussion "${id}" not found.
+`);
+    return;
+  }
+  const content = readFileSync12(join16(dir, match), "utf-8");
+  process.stderr.write(`
+${bold("Converting discussion to plan:")} ${cyan(id)}
+
+`);
+  await planCommand(projectRoot, [
+    `Create a detailed, actionable implementation plan based on this discussion document:
+
+${content.slice(0, 8000)}`
+  ], {});
+}
 async function promptForTopic() {
   return new Promise((resolve2) => {
     const rl = createInterface2({
@@ -8681,58 +8946,131 @@ async function promptForTopic() {
     rl.once("close", () => resolve2(""));
   });
 }
+async function promptForAnswers() {
+  return new Promise((resolve2) => {
+    const rl = createInterface2({
+      input: process.stdin,
+      output: process.stderr,
+      terminal: true
+    });
+    const lines = [];
+    rl.on("line", (line) => {
+      if (line.trim() === "" && lines.length > 0) {
+        rl.close();
+        resolve2(lines.join(`
+`).trim());
+      } else {
+        lines.push(line);
+      }
+    });
+    rl.once("close", () => resolve2(lines.join(`
+`).trim()));
+  });
+}
+function isQuestionsResponse(output) {
+  const trimmed = output.trimStart();
+  if (trimmed.startsWith("#"))
+    return false;
+  const questionMarks = (trimmed.match(/\?/g) ?? []).length;
+  return questionMarks >= 2;
+}
 async function startDiscussion(projectRoot, topic, flags) {
   const config = loadConfig(projectRoot);
   const timer = createTimer();
-  const id = generateId();
+  const id = generateId2();
   process.stderr.write(`
 ${bold("Discussion:")} ${cyan(topic)}
 
 `);
-  const prompt = buildDiscussionPrompt(projectRoot, config, topic);
-  const aiResult = await runAI({
-    prompt,
-    provider: config.ai.provider,
-    model: flags.model ?? config.ai.model,
-    cwd: projectRoot,
-    activity: "discussion"
-  });
-  if (aiResult.interrupted) {
-    process.stderr.write(`
+  const conversation = [];
+  let finalAnalysis = "";
+  for (let round = 0;round < MAX_DISCUSSION_ROUNDS; round++) {
+    const isFinalRound = round === MAX_DISCUSSION_ROUNDS - 1;
+    const prompt = buildDiscussionPrompt(projectRoot, config, topic, conversation, isFinalRound);
+    const aiResult = await runAI({
+      prompt,
+      provider: config.ai.provider,
+      model: flags.model ?? config.ai.model,
+      cwd: projectRoot,
+      activity: "discussion"
+    });
+    if (aiResult.interrupted) {
+      process.stderr.write(`
 ${yellow("⚡")} Discussion interrupted.
 `);
-    if (!aiResult.output.trim())
+      if (!aiResult.output.trim())
+        return;
+      finalAnalysis = aiResult.output.trim();
+      break;
+    }
+    if (!aiResult.success && !aiResult.interrupted) {
+      process.stderr.write(`
+${red("✗")} Discussion failed: ${aiResult.error}
+`);
       return;
-  }
-  if (!aiResult.success && !aiResult.interrupted) {
+    }
+    const response = aiResult.output.trim();
+    conversation.push({ role: "assistant", content: response });
+    if (!isQuestionsResponse(response) || isFinalRound) {
+      finalAnalysis = response;
+      break;
+    }
+    process.stderr.write(`
+${dim("─".repeat(50))}
+${bold("Your answers:")} ${dim("(press Enter on an empty line when done)")}
+`);
+    const answers = await promptForAnswers();
+    if (!answers.trim()) {
+      conversation.push({
+        role: "user",
+        content: "Please proceed with your analysis based on the information available."
+      });
+    } else {
+      conversation.push({ role: "user", content: answers });
+    }
     process.stderr.write(`
-${red("✗")} Discussion failed: ${aiResult.error}
 `);
-    return;
   }
-  const output = aiResult.output;
+  if (!finalAnalysis)
+    return;
   const dir = ensureDiscussionsDir(projectRoot);
   const date = new Date().toISOString().slice(0, 10);
-  const markdown = `# ${topic}
+  const transcript = conversation.map((turn) => {
+    const label = turn.role === "user" ? "You" : "AI";
+    return `**${label}:**
 
-**Date:** ${date}
-**Provider:** ${config.ai.provider} / ${flags.model ?? config.ai.model}
+${turn.content}`;
+  }).join(`
 
 ---
 
-${output}
-`;
-  writeFileSync8(join16(dir, `${id}.md`), markdown, "utf-8");
+`);
+  const markdown = [
+    `# ${topic}`,
+    ``,
+    `**Date:** ${date}`,
+    `**Provider:** ${config.ai.provider} / ${flags.model ?? config.ai.model}`,
+    ``,
+    `---`,
+    ``,
+    finalAnalysis,
+    ``,
+    ...conversation.length > 1 ? [`---`, ``, `## Discussion Transcript`, ``, transcript, ``] : []
+  ].join(`
+`);
+  writeFileSync9(join16(dir, `${id}.md`), markdown, "utf-8");
   process.stderr.write(`
 ${green("✓")} Discussion saved: ${cyan(id)} ${dim(`(${timer.formatted()})`)}
 `);
   process.stderr.write(`  View with: ${bold(`locus discuss show ${id.slice(0, 8)}`)}
+`);
+  process.stderr.write(`  Plan with: ${bold(`locus discuss plan ${id.slice(0, 8)}`)}
 
 `);
 }
-function buildDiscussionPrompt(projectRoot, config, topic) {
+function buildDiscussionPrompt(projectRoot, config, topic, conversation, forceFinal) {
   const parts = [];
-  parts.push(`You are a senior software architect helping make decisions for the ${config.github.owner}/${config.github.repo} project.`);
+  parts.push(`You are a senior software architect and consultant for the ${config.github.owner}/${config.github.repo} project.`);
   parts.push("");
   const locusPath = join16(projectRoot, "LOCUS.md");
   if (existsSync15(locusPath)) {
@@ -8748,26 +9086,48 @@ function buildDiscussionPrompt(projectRoot, config, topic) {
     parts.push(content.slice(0, 2000));
     parts.push("");
   }
-  parts.push(`TOPIC: ${topic}`);
+  parts.push(`DISCUSSION TOPIC: ${topic}`);
   parts.push("");
-  parts.push("Please provide a thorough analysis covering:");
-  parts.push("1. **Context**: Restate the problem/question and why it matters");
-  parts.push("2. **Options**: List all viable approaches with pros/cons");
-  parts.push("3. **Recommendation**: Your recommended approach with reasoning");
-  parts.push("4. **Trade-offs**: What we gain and what we sacrifice");
-  parts.push("5. **Implementation Notes**: Key technical considerations");
-  parts.push("6. **Decision**: A clear, actionable conclusion");
-  parts.push("");
-  parts.push("Be specific to this project's codebase and constraints.");
-  parts.push("Reference specific files or patterns where relevant.");
+  if (conversation.length === 0) {
+    parts.push("Before providing recommendations, you need to ask targeted clarifying questions.");
+    parts.push("");
+    parts.push("Ask 3-5 focused questions that will significantly improve the quality of your analysis.");
+    parts.push("Format as a numbered list. Be specific and focused on the most important unknowns.");
+    parts.push("Do NOT provide any analysis yet — questions only.");
+  } else {
+    parts.push("CONVERSATION SO FAR:");
+    parts.push("");
+    for (const turn of conversation) {
+      if (turn.role === "user") {
+        parts.push(`USER: ${turn.content}`);
+      } else {
+        parts.push(`ASSISTANT: ${turn.content}`);
+      }
+      parts.push("");
+    }
+    if (forceFinal) {
+      parts.push("Based on everything discussed, provide your complete analysis and recommendations now.");
+      parts.push("Format as a thorough markdown document with a clear title (# Heading), sections, trade-offs, and actionable recommendations.");
+    } else {
+      parts.push("Review the information gathered so far.");
+      parts.push("");
+      parts.push("If you have enough information to make a thorough recommendation:");
+      parts.push("  → Provide a complete analysis as a markdown document with a title (# Heading), sections, trade-offs, and concrete recommendations.");
+      parts.push("");
+      parts.push("If you still need key information to give a good answer:");
+      parts.push("  → Ask 2-3 more focused follow-up questions (numbered list only, no analysis yet).");
+    }
+  }
   return parts.join(`
 `);
 }
+var MAX_DISCUSSION_ROUNDS = 5;
 var init_discuss = __esm(() => {
   init_run_ai();
   init_config();
   init_progress();
   init_terminal();
+  init_plan();
 });
 
 // src/commands/artifacts.ts
@@ -8779,7 +9139,7 @@ __export(exports_artifacts, {
   formatDate: () => formatDate2,
   artifactsCommand: () => artifactsCommand
 });
-import { existsSync as existsSync16, readdirSync as readdirSync8, readFileSync as readFileSync13, statSync as statSync4 } from "node:fs";
+import { existsSync as existsSync16, readdirSync as readdirSync9, readFileSync as readFileSync13, statSync as statSync4 } from "node:fs";
 import { join as join17 } from "node:path";
 function printHelp5() {
   process.stderr.write(`
@@ -8806,7 +9166,7 @@ function listArtifacts(projectRoot) {
   const dir = getArtifactsDir(projectRoot);
   if (!existsSync16(dir))
     return [];
-  return readdirSync8(dir).filter((f) => f.endsWith(".md")).map((fileName) => {
+  return readdirSync9(dir).filter((f) => f.endsWith(".md")).map((fileName) => {
     const filePath = join17(dir, fileName);
     const stat = statSync4(filePath);
     return {
@@ -9118,7 +9478,8 @@ ${bold("Examples:")}
   locus init                          ${dim("# Set up Locus in this repo")}
   locus exec                          ${dim("# Start interactive REPL")}
   locus issue create "Fix login bug"  ${dim("# Create a new issue")}
-  locus plan "Build auth system"      ${dim("# AI plans issues + sprint")}
+  locus plan "Build auth system"      ${dim("# AI creates a plan file")}
+  locus plan approve <id>             ${dim("# Create issues from saved plan")}
   locus run                           ${dim("# Execute active sprint")}
   locus run 42 43                     ${dim("# Run issues in parallel")}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@locusai/cli",
-  "version": "0.17.5",
+  "version": "0.17.7",
   "description": "GitHub-native AI engineering assistant",
   "type": "module",
   "bin": {