@locusai/cli 0.24.1 → 0.24.2

package/bin/locus.js

@@ -11637,6 +11637,7 @@ ${bold2("locus plan")} — AI-powered sprint planning
 ${bold2("Usage:")}
   locus plan "<directive>"                 ${dim2("# AI creates a plan file")}
   locus plan approve <id> <sprintname>      ${dim2("# Create GitHub issues from saved plan")}
+  locus plan refine <id> "<feedback>"       ${dim2("# Refine a plan with feedback")}
   locus plan list                          ${dim2("# List saved plans")}
   locus plan show <id>                     ${dim2("# Show a saved plan")}
   locus plan --from-issues --sprint <name> ${dim2("# Organize existing issues")}
@@ -11650,6 +11651,7 @@ ${bold2("Examples:")}
   locus plan "Build user authentication with OAuth"
   locus plan "Improve API performance" --sprint "Sprint 3"
   locus plan approve abc123 "Sprint 3"
+  locus plan refine abc123 "Split the auth issue into login and signup"
   locus plan list
   locus plan --from-issues --sprint "Sprint 2"
 
@@ -11697,6 +11699,19 @@ async function planCommand(projectRoot, args, flags = {}) {
   if (args[0] === "show") {
     return handleShowPlan(projectRoot, args[1]);
   }
+  if (args[0] === "refine") {
+    const refineId = args[1];
+    const refineArgs = parsePlanArgs(args.slice(2));
+    const feedback = refineArgs.directive;
+    if (!refineId || !feedback) {
+      process.stderr.write(`${red2("✗")} Please provide a plan ID and feedback.
+`);
+      process.stderr.write(`  Usage: ${bold2('locus plan refine <id> "your feedback"')}
+`);
+      return;
+    }
+    return handleRefinePlan(projectRoot, refineId, feedback, flags);
+  }
   if (args[0] === "approve") {
     const approveArgs = parsePlanArgs(args.slice(2));
     const sprintName2 = approveArgs.sprintName ?? (approveArgs.directive || undefined);
@@ -11808,6 +11823,100 @@ ${bold2("Plan:")} ${cyan2(plan.directive)}
 `);
   process.stderr.write(`  Approve: ${bold2(`locus plan approve ${plan.id.slice(0, 8)} <sprintname>`)}
 
+`);
+}
+async function handleRefinePlan(projectRoot, id, feedback, flags) {
+  const plan = loadPlanFile(projectRoot, id);
+  if (!plan) {
+    process.stderr.write(`${red2("✗")} Plan "${id}" not found.
+`);
+    process.stderr.write(`  List plans with: ${bold2("locus plan list")}
+`);
+    return;
+  }
+  const config = loadConfig(projectRoot);
+  const planPath = join23(getPlansDir(projectRoot), `${plan.id}.json`);
+  const planPathRelative = `.locus/plans/${plan.id}.json`;
+  process.stderr.write(`
+${bold2("Refining plan:")} ${cyan2(plan.directive)}
+`);
+  process.stderr.write(`  ${dim2(`Feedback: ${feedback}`)}
+
+`);
+  if (config.sandbox.enabled) {
+    const mismatch = checkProviderSandboxMismatch(config.sandbox, flags.model ?? config.ai.model, config.ai.provider);
+    if (mismatch) {
+      process.stderr.write(`${red2("✗")} ${mismatch}
+`);
+      return;
+    }
+  }
+  const prompt = buildRefinePrompt(projectRoot, config, plan, feedback, planPathRelative);
+  const aiResult = await runAI({
+    prompt,
+    provider: config.ai.provider,
+    model: flags.model ?? config.ai.model,
+    cwd: projectRoot,
+    activity: "refining plan",
+    sandboxed: config.sandbox.enabled,
+    sandboxName: getModelSandboxName(config.sandbox, flags.model ?? config.ai.model, config.ai.provider),
+    containerWorkdir: config.sandbox.containerWorkdir
+  });
+  if (aiResult.interrupted) {
+    process.stderr.write(`
+${yellow2("⚡")} Refinement interrupted.
+`);
+    return;
+  }
+  if (!aiResult.success) {
+    process.stderr.write(`
+${red2("✗")} Refinement failed: ${aiResult.error}
+`);
+    return;
+  }
+  if (!existsSync23(planPath)) {
+    process.stderr.write(`
+${yellow2("⚠")} Plan file was not found at ${bold2(planPathRelative)}.
+`);
+    return;
+  }
+  let updatedPlan;
+  try {
+    const content = readFileSync13(planPath, "utf-8");
+    updatedPlan = JSON.parse(content);
+  } catch {
+    process.stderr.write(`
+${red2("✗")} Updated plan file at ${bold2(planPathRelative)} is not valid JSON.
+`);
+    return;
+  }
+  if (!Array.isArray(updatedPlan.issues) || updatedPlan.issues.length === 0) {
+    process.stderr.write(`
+${yellow2("⚠")} Refined plan has no issues.
+`);
+    return;
+  }
+  updatedPlan.id = plan.id;
+  updatedPlan.directive = plan.directive;
+  updatedPlan.sprint = updatedPlan.sprint ?? plan.sprint;
+  updatedPlan.createdAt = plan.createdAt;
+  writeFileSync10(planPath, JSON.stringify(updatedPlan, null, 2), "utf-8");
+  process.stderr.write(`
+${bold2("Plan refined:")} ${cyan2(plan.id)}
+
+`);
+  process.stderr.write(`  ${dim2("Order")}  ${dim2("Title".padEnd(50))}  ${dim2("Priority")}   ${dim2("Type")}
+`);
+  for (const issue of updatedPlan.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(`
+`);
+  process.stderr.write(`  To approve: ${bold2(`locus plan approve ${plan.id.slice(0, 8)} <sprintname>`)}
+`);
+  process.stderr.write(`  To refine again: ${bold2(`locus plan refine ${plan.id.slice(0, 8)} "more feedback"`)}
+
 `);
 }
 async function handleApprovePlan(projectRoot, id, flags, sprintOverride) {
@@ -12136,6 +12245,62 @@ Write ONLY a valid JSON file to ${planPathRelative} with this exact structure:
 </requirements>`);
   return parts.join(`
 
+`);
+}
+function buildRefinePrompt(projectRoot, config, plan, feedback, planPathRelative) {
+  const parts = [];
+  parts.push(`<role>
+You are a sprint planning assistant for the GitHub repository ${config.github.owner}/${config.github.repo}.
+</role>`);
+  parts.push(`<existing-plan>
+${JSON.stringify(plan, null, 2)}
+</existing-plan>`);
+  parts.push(`<feedback>
+${feedback}
+</feedback>`);
+  const locusPath = join23(projectRoot, ".locus", "LOCUS.md");
+  if (existsSync23(locusPath)) {
+    const content = readFileSync13(locusPath, "utf-8");
+    parts.push(`<project-context>
+${content.slice(0, 3000)}
+</project-context>`);
+  }
+  parts.push(`<task>
+You have been given an existing plan and user feedback about it. Modify the plan according to the feedback.
+
+Write the updated plan as valid JSON to ${planPathRelative}, keeping the same structure:
+
+\`\`\`json
+{
+  "id": "${plan.id}",
+  "directive": ${JSON.stringify(plan.directive)},
+  "sprint": ${plan.sprint ? JSON.stringify(plan.sprint) : "null"},
+  "createdAt": "${plan.createdAt}",
+  "issues": [
+    {
+      "order": 1,
+      "title": "concise issue title",
+      "body": "detailed markdown body with acceptance criteria",
+      "priority": "critical|high|medium|low",
+      "type": "feature|bug|chore|refactor|docs",
+      "dependsOn": "none or comma-separated order numbers"
+    }
+  ]
+}
+\`\`\`
+</task>`);
+  parts.push(`<requirements>
+- Apply the user's feedback to modify the existing plan
+- You may add, remove, reorder, or modify issues based on the feedback
+- Keep issues that the feedback does not mention unchanged
+- Ensure each issue is independently executable by an AI agent
+- Order them so dependencies are respected (foundational tasks first)
+- Write detailed issue bodies with clear acceptance criteria
+- Use valid GitHub Markdown only in issue bodies
+- Create the file using the Write tool — do not print the JSON to the terminal
+</requirements>`);
+  return parts.join(`
+
 `);
 }
 function sanitizePlanOutput(output) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@locusai/cli",
-  "version": "0.24.1",
+  "version": "0.24.2",
   "description": "GitHub-native AI engineering assistant",
   "type": "module",
   "bin": {
@@ -36,7 +36,7 @@
   "license": "MIT",
   "dependencies": {},
   "devDependencies": {
-    "@locusai/sdk": "^0.24.1",
+    "@locusai/sdk": "^0.24.2",
     "@types/bun": "latest",
     "typescript": "^5.8.3"
   },