@h-rig/planning-plugin 0.0.6-alpha.142 → 0.0.6-alpha.143

package/dist/src/cli.d.ts

@@ -1,4 +1,4 @@
-import type { RuntimeCliContext } from "@rig/core";
+import type { RuntimeCliContext } from "@rig/core/config";
 export declare const PLANNING_PLAN_CLI_ID = "planning.plan";
 type CommandOutcome = {
     readonly ok: boolean;
@@ -10,9 +10,9 @@ export declare function executePlan(context: RuntimeCliContext, args: readonly s
 export declare const planningCliCommands: readonly [{
     readonly id: "planning.plan";
     readonly family: "plan";
-    readonly command: "rig plan --text <prd>|--prd <file>";
-    readonly description: "Generate a plan from a PRD and optionally materialize task-source tasks.";
-    readonly usage: "rig plan --text <prd>|--prd <file> [--title <title>] [--materialize|--dry-run] [--json]";
+    readonly command: "rig plan --text <prd>|--prd <file>|--issue <id>";
+    readonly description: "Generate a plan from a PRD or task-source issue and optionally materialize task-source tasks.";
+    readonly usage: "rig plan --text <prd>|--prd <file>|--issue <id> [--title <title>] [--materialize|--dry-run] [--json]";
     readonly projectRequired: true;
     readonly run: typeof executePlan;
 }];

package/dist/src/cli.js

@@ -47,27 +47,94 @@ function requireNoExtraArgs(args, usage) {
     throw new Error(`Unexpected argument: ${args[0]}
 Usage: ${usage}`);
 }
+function stripMarkdownPrefix(line) {
+  return line.replace(/^#{1,6}\s+/, "").replace(/^[-*+]\s+/, "").replace(/^\d+[.)]\s+/, "").replace(/^\[[ xX]\]\s+/, "").replace(/^\*\*(.+)\*\*:?\s*/, "$1: ").trim();
+}
+function sectionizePrd(body) {
+  const sections = [{ title: "Overview", lines: [] }];
+  for (const rawLine of body.split(/\r?\n/)) {
+    const heading = rawLine.match(/^(#{2,4})\s+(.+?)\s*$/);
+    if (heading) {
+      sections.push({ title: stripMarkdownPrefix(heading[2] ?? "Section"), lines: [] });
+      continue;
+    }
+    const line = stripMarkdownPrefix(rawLine);
+    if (!line || line.startsWith("<!--") || line.startsWith("-->") || line.startsWith("```"))
+      continue;
+    sections[sections.length - 1]?.lines.push(line);
+  }
+  return sections.filter((section) => section.lines.length > 0 || section.title !== "Overview");
+}
+function checkboxItems(body) {
+  return body.split(/\r?\n/).map((line) => line.match(/^\s*[-*]\s+\[[ xX]\]\s+(.+?)\s*$/)?.[1]?.trim()).filter((line) => Boolean(line));
+}
+function slugFor(value, index) {
+  const slug = value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 42);
+  return slug || `task-${index + 1}`;
+}
+function evidenceFor(sections, title) {
+  const titleWords = title.toLowerCase().split(/[^a-z0-9]+/).filter((word) => word.length > 3);
+  const section = sections.find((candidate) => {
+    const haystack = `${candidate.title}
+${candidate.lines.join(`
+`)}`.toLowerCase();
+    return titleWords.some((word) => haystack.includes(word));
+  }) ?? sections[0] ?? { title: "PRD", lines: [] };
+  const evidence = section.lines.find((line) => titleWords.some((word) => line.toLowerCase().includes(word))) ?? section.lines[0] ?? title;
+  return { title, evidence, section: section.title };
+}
+function extractPlanItems(input) {
+  const sections = sectionizePrd(input.body);
+  const checklist = checkboxItems(input.body);
+  const titles = checklist.length > 0 ? checklist : sections.filter((section) => /requirement|criteria|deliverable|scope|pain|problem|challenge|objective|task/i.test(section.title)).flatMap((section) => section.lines.filter((line) => line.length >= 18).slice(0, 3));
+  const distinctTitles = [...new Set(titles.map(stripMarkdownPrefix).filter((line) => line.length > 0))];
+  const fallback = distinctTitles.length > 0 ? distinctTitles : [`Analyze ${input.title}`, `Design implementation plan for ${input.title}`, `Define validation gates for ${input.title}`];
+  return fallback.slice(0, 8).map((title) => evidenceFor(sections, title));
+}
+function questionItems(sections) {
+  const explicit = sections.flatMap((section) => section.lines.filter((line) => line.endsWith("?")));
+  if (explicit.length > 0)
+    return explicit.slice(0, 4);
+  return ["Which PRD constraints require owner confirmation before materializing implementation issues?"];
+}
+function planTasksForPrd(input) {
+  const items = extractPlanItems(input);
+  return items.map((item, index) => ({
+    localId: slugFor(item.title, index),
+    title: item.title,
+    description: [`Source section: ${item.section}.`, `PRD evidence: ${item.evidence}`].join(`
+`),
+    acceptance: [`Deliver: ${item.title}`, "Trace the implementation choice back to the source PRD evidence.", "Record unresolved assumptions before closeout."],
+    scope: [slugFor(item.section, index), slugFor(item.title, index)],
+    validationKeys: ["prd-traceability", "implementation-review"],
+    dependsOn: index === 0 ? [] : [slugFor(items[0]?.title ?? input.title, 0)],
+    parent: null,
+    parallelizable: index > 0
+  }));
+}
 function defaultPlanningProvider(now) {
   return {
     spec: (input) => {
-      const headings = input.body.split(/\r?\n/).map((line) => line.match(/^#{1,3}\s+(.+)$/)?.[1]?.trim()).filter((line) => Boolean(line));
-      const titles = headings.length > 0 ? headings : [input.title];
+      const sections = sectionizePrd(input.body);
+      const items = extractPlanItems(input);
       return {
         prdTitle: input.title,
-        userStories: [],
-        functionalRequirements: [],
-        openQuestions: [],
-        tasks: titles.map((title, index) => ({
-          localId: `task-${index + 1}`,
-          title,
-          description: `Implement: ${title}`,
-          acceptance: [],
-          scope: [],
-          validationKeys: [],
-          dependsOn: index === 0 ? [] : [`task-${index}`],
-          parent: null,
-          parallelizable: index === 0
+        userStories: items.slice(0, 5).map((item, index) => ({
+          id: `US-${String(index + 1).padStart(3, "0")}`,
+          title: `Stakeholders can evaluate: ${item.title}`,
+          priority: index + 1
         })),
+        functionalRequirements: items.slice(0, 8).map((item, index) => ({
+          id: `FR-${String(index + 1).padStart(3, "0")}`,
+          text: item.title
+        })),
+        openQuestions: questionItems(sections).map((question, index) => ({
+          id: `Q-${String(index + 1).padStart(3, "0")}`,
+          question,
+          status: "deferred",
+          resolution: null
+        })),
+        tasks: [...planTasksForPrd(input)],
         generatedAt: now()
       };
     },
@@ -78,14 +145,29 @@ function defaultPlanningProvider(now) {
 async function loadPlanningClient() {
   return await import("@rig/client");
 }
-function readPrdText(args) {
+async function readPrdText(context, args) {
   const title = takeOption(args, "--title");
   const text = takeOption(title.rest, "--text");
   const prd = takeOption(text.rest, "--prd");
+  const issue = takeOption(prd.rest, "--issue");
+  const sources = [text.value, prd.value, issue.value].filter(Boolean);
+  if (sources.length !== 1)
+    throw new Error("rig plan requires exactly one of --text <prd>, --prd <file>, or --issue <id>.");
+  if (issue.value) {
+    const { getTask } = await loadPlanningClient();
+    const task = await getTask(context.projectRoot, issue.value);
+    if (!task)
+      throw new Error(`No task found for issue ${issue.value}.`);
+    const body2 = typeof task.body === "string" ? task.body : "";
+    if (!body2.trim())
+      throw new Error(`Issue ${issue.value} has no PRD body text.`);
+    const taskTitle = typeof task.title === "string" && task.title.trim() ? task.title.trim() : `Issue ${issue.value}`;
+    return { title: title.value?.trim() || taskTitle, body: body2, rest: issue.rest };
+  }
   const body = text.value ?? (prd.value ? readFileSync(prd.value, "utf8") : null);
   if (!body?.trim())
-    throw new Error("rig plan requires --text <prd> or --prd <file>.");
-  return { title: title.value?.trim() || "Rig generated plan", body, rest: prd.rest };
+    throw new Error("rig plan requires non-empty PRD text.");
+  return { title: title.value?.trim() || "Rig generated plan", body, rest: issue.rest };
 }
 async function executePlan(context, args) {
   const materialize = takeFlag(args, "--materialize");
@@ -93,8 +175,8 @@ async function executePlan(context, args) {
   const json = takeFlag(dryRun.rest, "--json");
   if (materialize.value && dryRun.value)
     throw new Error("Pass only one of --materialize or --dry-run.");
-  const prd = readPrdText(json.rest);
-  requireNoExtraArgs(prd.rest, "rig plan --text <prd>|--prd <file> [--title <title>] [--materialize|--dry-run] [--json]");
+  const prd = await readPrdText(context, json.rest);
+  requireNoExtraArgs(prd.rest, "rig plan --text <prd>|--prd <file>|--issue <id> [--title <title>] [--materialize|--dry-run] [--json]");
   const willMaterialize = materialize.value && !dryRun.value;
   const now = () => new Date().toISOString();
   const provider = defaultPlanningProvider(now);
@@ -116,9 +198,9 @@ var planningCliCommands = [
   {
     id: PLANNING_PLAN_CLI_ID,
     family: "plan",
-    command: "rig plan --text <prd>|--prd <file>",
-    description: "Generate a plan from a PRD and optionally materialize task-source tasks.",
-    usage: "rig plan --text <prd>|--prd <file> [--title <title>] [--materialize|--dry-run] [--json]",
+    command: "rig plan --text <prd>|--prd <file>|--issue <id>",
+    description: "Generate a plan from a PRD or task-source issue and optionally materialize task-source tasks.",
+    usage: "rig plan --text <prd>|--prd <file>|--issue <id> [--title <title>] [--materialize|--dry-run] [--json]",
     projectRequired: true,
     run: executePlan
   }

package/dist/src/index.js

@@ -147,27 +147,94 @@ function requireNoExtraArgs(args, usage) {
     throw new Error(`Unexpected argument: ${args[0]}
 Usage: ${usage}`);
 }
+function stripMarkdownPrefix(line) {
+  return line.replace(/^#{1,6}\s+/, "").replace(/^[-*+]\s+/, "").replace(/^\d+[.)]\s+/, "").replace(/^\[[ xX]\]\s+/, "").replace(/^\*\*(.+)\*\*:?\s*/, "$1: ").trim();
+}
+function sectionizePrd(body) {
+  const sections = [{ title: "Overview", lines: [] }];
+  for (const rawLine of body.split(/\r?\n/)) {
+    const heading = rawLine.match(/^(#{2,4})\s+(.+?)\s*$/);
+    if (heading) {
+      sections.push({ title: stripMarkdownPrefix(heading[2] ?? "Section"), lines: [] });
+      continue;
+    }
+    const line = stripMarkdownPrefix(rawLine);
+    if (!line || line.startsWith("<!--") || line.startsWith("-->") || line.startsWith("```"))
+      continue;
+    sections[sections.length - 1]?.lines.push(line);
+  }
+  return sections.filter((section) => section.lines.length > 0 || section.title !== "Overview");
+}
+function checkboxItems(body) {
+  return body.split(/\r?\n/).map((line) => line.match(/^\s*[-*]\s+\[[ xX]\]\s+(.+?)\s*$/)?.[1]?.trim()).filter((line) => Boolean(line));
+}
+function slugFor(value, index) {
+  const slug = value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 42);
+  return slug || `task-${index + 1}`;
+}
+function evidenceFor(sections, title) {
+  const titleWords = title.toLowerCase().split(/[^a-z0-9]+/).filter((word) => word.length > 3);
+  const section = sections.find((candidate) => {
+    const haystack = `${candidate.title}
+${candidate.lines.join(`
+`)}`.toLowerCase();
+    return titleWords.some((word) => haystack.includes(word));
+  }) ?? sections[0] ?? { title: "PRD", lines: [] };
+  const evidence = section.lines.find((line) => titleWords.some((word) => line.toLowerCase().includes(word))) ?? section.lines[0] ?? title;
+  return { title, evidence, section: section.title };
+}
+function extractPlanItems(input) {
+  const sections = sectionizePrd(input.body);
+  const checklist = checkboxItems(input.body);
+  const titles = checklist.length > 0 ? checklist : sections.filter((section) => /requirement|criteria|deliverable|scope|pain|problem|challenge|objective|task/i.test(section.title)).flatMap((section) => section.lines.filter((line) => line.length >= 18).slice(0, 3));
+  const distinctTitles = [...new Set(titles.map(stripMarkdownPrefix).filter((line) => line.length > 0))];
+  const fallback = distinctTitles.length > 0 ? distinctTitles : [`Analyze ${input.title}`, `Design implementation plan for ${input.title}`, `Define validation gates for ${input.title}`];
+  return fallback.slice(0, 8).map((title) => evidenceFor(sections, title));
+}
+function questionItems(sections) {
+  const explicit = sections.flatMap((section) => section.lines.filter((line) => line.endsWith("?")));
+  if (explicit.length > 0)
+    return explicit.slice(0, 4);
+  return ["Which PRD constraints require owner confirmation before materializing implementation issues?"];
+}
+function planTasksForPrd(input) {
+  const items = extractPlanItems(input);
+  return items.map((item, index) => ({
+    localId: slugFor(item.title, index),
+    title: item.title,
+    description: [`Source section: ${item.section}.`, `PRD evidence: ${item.evidence}`].join(`
+`),
+    acceptance: [`Deliver: ${item.title}`, "Trace the implementation choice back to the source PRD evidence.", "Record unresolved assumptions before closeout."],
+    scope: [slugFor(item.section, index), slugFor(item.title, index)],
+    validationKeys: ["prd-traceability", "implementation-review"],
+    dependsOn: index === 0 ? [] : [slugFor(items[0]?.title ?? input.title, 0)],
+    parent: null,
+    parallelizable: index > 0
+  }));
+}
 function defaultPlanningProvider(now) {
   return {
     spec: (input) => {
-      const headings = input.body.split(/\r?\n/).map((line) => line.match(/^#{1,3}\s+(.+)$/)?.[1]?.trim()).filter((line) => Boolean(line));
-      const titles = headings.length > 0 ? headings : [input.title];
+      const sections = sectionizePrd(input.body);
+      const items = extractPlanItems(input);
       return {
         prdTitle: input.title,
-        userStories: [],
-        functionalRequirements: [],
-        openQuestions: [],
-        tasks: titles.map((title, index) => ({
-          localId: `task-${index + 1}`,
-          title,
-          description: `Implement: ${title}`,
-          acceptance: [],
-          scope: [],
-          validationKeys: [],
-          dependsOn: index === 0 ? [] : [`task-${index}`],
-          parent: null,
-          parallelizable: index === 0
+        userStories: items.slice(0, 5).map((item, index) => ({
+          id: `US-${String(index + 1).padStart(3, "0")}`,
+          title: `Stakeholders can evaluate: ${item.title}`,
+          priority: index + 1
         })),
+        functionalRequirements: items.slice(0, 8).map((item, index) => ({
+          id: `FR-${String(index + 1).padStart(3, "0")}`,
+          text: item.title
+        })),
+        openQuestions: questionItems(sections).map((question, index) => ({
+          id: `Q-${String(index + 1).padStart(3, "0")}`,
+          question,
+          status: "deferred",
+          resolution: null
+        })),
+        tasks: [...planTasksForPrd(input)],
         generatedAt: now()
       };
     },
@@ -178,14 +245,29 @@ function defaultPlanningProvider(now) {
 async function loadPlanningClient() {
   return await import("@rig/client");
 }
-function readPrdText(args) {
+async function readPrdText(context, args) {
   const title = takeOption(args, "--title");
   const text = takeOption(title.rest, "--text");
   const prd = takeOption(text.rest, "--prd");
+  const issue = takeOption(prd.rest, "--issue");
+  const sources = [text.value, prd.value, issue.value].filter(Boolean);
+  if (sources.length !== 1)
+    throw new Error("rig plan requires exactly one of --text <prd>, --prd <file>, or --issue <id>.");
+  if (issue.value) {
+    const { getTask } = await loadPlanningClient();
+    const task = await getTask(context.projectRoot, issue.value);
+    if (!task)
+      throw new Error(`No task found for issue ${issue.value}.`);
+    const body2 = typeof task.body === "string" ? task.body : "";
+    if (!body2.trim())
+      throw new Error(`Issue ${issue.value} has no PRD body text.`);
+    const taskTitle = typeof task.title === "string" && task.title.trim() ? task.title.trim() : `Issue ${issue.value}`;
+    return { title: title.value?.trim() || taskTitle, body: body2, rest: issue.rest };
+  }
   const body = text.value ?? (prd.value ? readFileSync(prd.value, "utf8") : null);
   if (!body?.trim())
-    throw new Error("rig plan requires --text <prd> or --prd <file>.");
-  return { title: title.value?.trim() || "Rig generated plan", body, rest: prd.rest };
+    throw new Error("rig plan requires non-empty PRD text.");
+  return { title: title.value?.trim() || "Rig generated plan", body, rest: issue.rest };
 }
 async function executePlan(context, args) {
   const materialize2 = takeFlag(args, "--materialize");
@@ -193,8 +275,8 @@ async function executePlan(context, args) {
   const json = takeFlag(dryRun.rest, "--json");
   if (materialize2.value && dryRun.value)
     throw new Error("Pass only one of --materialize or --dry-run.");
-  const prd = readPrdText(json.rest);
-  requireNoExtraArgs(prd.rest, "rig plan --text <prd>|--prd <file> [--title <title>] [--materialize|--dry-run] [--json]");
+  const prd = await readPrdText(context, json.rest);
+  requireNoExtraArgs(prd.rest, "rig plan --text <prd>|--prd <file>|--issue <id> [--title <title>] [--materialize|--dry-run] [--json]");
   const willMaterialize = materialize2.value && !dryRun.value;
   const now = () => new Date().toISOString();
   const provider = defaultPlanningProvider(now);
@@ -216,15 +298,15 @@ var planningCliCommands = [
   {
     id: PLANNING_PLAN_CLI_ID,
     family: "plan",
-    command: "rig plan --text <prd>|--prd <file>",
-    description: "Generate a plan from a PRD and optionally materialize task-source tasks.",
-    usage: "rig plan --text <prd>|--prd <file> [--title <title>] [--materialize|--dry-run] [--json]",
+    command: "rig plan --text <prd>|--prd <file>|--issue <id>",
+    description: "Generate a plan from a PRD or task-source issue and optionally materialize task-source tasks.",
+    usage: "rig plan --text <prd>|--prd <file>|--issue <id> [--title <title>] [--materialize|--dry-run] [--json]",
     projectRequired: true,
     run: executePlan
   }
 ];
 // packages/planning-plugin/src/plugin.ts
-import { definePlugin } from "@rig/core";
+import { definePlugin } from "@rig/core/config";
 var PLANNING_PLUGIN_NAME = "@rig/planning-plugin";
 var PLANNING_PLAN_PANEL_ID = "plan-intake";
 var planningPlugin = definePlugin({

package/dist/src/plugin.js

@@ -2,7 +2,7 @@
 var __require = import.meta.require;
 
 // packages/planning-plugin/src/plugin.ts
-import { definePlugin } from "@rig/core";
+import { definePlugin } from "@rig/core/config";
 
 // packages/planning-plugin/src/cli.ts
 import { readFileSync } from "fs";
@@ -50,27 +50,94 @@ function requireNoExtraArgs(args, usage) {
     throw new Error(`Unexpected argument: ${args[0]}
 Usage: ${usage}`);
 }
+function stripMarkdownPrefix(line) {
+  return line.replace(/^#{1,6}\s+/, "").replace(/^[-*+]\s+/, "").replace(/^\d+[.)]\s+/, "").replace(/^\[[ xX]\]\s+/, "").replace(/^\*\*(.+)\*\*:?\s*/, "$1: ").trim();
+}
+function sectionizePrd(body) {
+  const sections = [{ title: "Overview", lines: [] }];
+  for (const rawLine of body.split(/\r?\n/)) {
+    const heading = rawLine.match(/^(#{2,4})\s+(.+?)\s*$/);
+    if (heading) {
+      sections.push({ title: stripMarkdownPrefix(heading[2] ?? "Section"), lines: [] });
+      continue;
+    }
+    const line = stripMarkdownPrefix(rawLine);
+    if (!line || line.startsWith("<!--") || line.startsWith("-->") || line.startsWith("```"))
+      continue;
+    sections[sections.length - 1]?.lines.push(line);
+  }
+  return sections.filter((section) => section.lines.length > 0 || section.title !== "Overview");
+}
+function checkboxItems(body) {
+  return body.split(/\r?\n/).map((line) => line.match(/^\s*[-*]\s+\[[ xX]\]\s+(.+?)\s*$/)?.[1]?.trim()).filter((line) => Boolean(line));
+}
+function slugFor(value, index) {
+  const slug = value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 42);
+  return slug || `task-${index + 1}`;
+}
+function evidenceFor(sections, title) {
+  const titleWords = title.toLowerCase().split(/[^a-z0-9]+/).filter((word) => word.length > 3);
+  const section = sections.find((candidate) => {
+    const haystack = `${candidate.title}
+${candidate.lines.join(`
+`)}`.toLowerCase();
+    return titleWords.some((word) => haystack.includes(word));
+  }) ?? sections[0] ?? { title: "PRD", lines: [] };
+  const evidence = section.lines.find((line) => titleWords.some((word) => line.toLowerCase().includes(word))) ?? section.lines[0] ?? title;
+  return { title, evidence, section: section.title };
+}
+function extractPlanItems(input) {
+  const sections = sectionizePrd(input.body);
+  const checklist = checkboxItems(input.body);
+  const titles = checklist.length > 0 ? checklist : sections.filter((section) => /requirement|criteria|deliverable|scope|pain|problem|challenge|objective|task/i.test(section.title)).flatMap((section) => section.lines.filter((line) => line.length >= 18).slice(0, 3));
+  const distinctTitles = [...new Set(titles.map(stripMarkdownPrefix).filter((line) => line.length > 0))];
+  const fallback = distinctTitles.length > 0 ? distinctTitles : [`Analyze ${input.title}`, `Design implementation plan for ${input.title}`, `Define validation gates for ${input.title}`];
+  return fallback.slice(0, 8).map((title) => evidenceFor(sections, title));
+}
+function questionItems(sections) {
+  const explicit = sections.flatMap((section) => section.lines.filter((line) => line.endsWith("?")));
+  if (explicit.length > 0)
+    return explicit.slice(0, 4);
+  return ["Which PRD constraints require owner confirmation before materializing implementation issues?"];
+}
+function planTasksForPrd(input) {
+  const items = extractPlanItems(input);
+  return items.map((item, index) => ({
+    localId: slugFor(item.title, index),
+    title: item.title,
+    description: [`Source section: ${item.section}.`, `PRD evidence: ${item.evidence}`].join(`
+`),
+    acceptance: [`Deliver: ${item.title}`, "Trace the implementation choice back to the source PRD evidence.", "Record unresolved assumptions before closeout."],
+    scope: [slugFor(item.section, index), slugFor(item.title, index)],
+    validationKeys: ["prd-traceability", "implementation-review"],
+    dependsOn: index === 0 ? [] : [slugFor(items[0]?.title ?? input.title, 0)],
+    parent: null,
+    parallelizable: index > 0
+  }));
+}
 function defaultPlanningProvider(now) {
   return {
     spec: (input) => {
-      const headings = input.body.split(/\r?\n/).map((line) => line.match(/^#{1,3}\s+(.+)$/)?.[1]?.trim()).filter((line) => Boolean(line));
-      const titles = headings.length > 0 ? headings : [input.title];
+      const sections = sectionizePrd(input.body);
+      const items = extractPlanItems(input);
       return {
         prdTitle: input.title,
-        userStories: [],
-        functionalRequirements: [],
-        openQuestions: [],
-        tasks: titles.map((title, index) => ({
-          localId: `task-${index + 1}`,
-          title,
-          description: `Implement: ${title}`,
-          acceptance: [],
-          scope: [],
-          validationKeys: [],
-          dependsOn: index === 0 ? [] : [`task-${index}`],
-          parent: null,
-          parallelizable: index === 0
+        userStories: items.slice(0, 5).map((item, index) => ({
+          id: `US-${String(index + 1).padStart(3, "0")}`,
+          title: `Stakeholders can evaluate: ${item.title}`,
+          priority: index + 1
         })),
+        functionalRequirements: items.slice(0, 8).map((item, index) => ({
+          id: `FR-${String(index + 1).padStart(3, "0")}`,
+          text: item.title
+        })),
+        openQuestions: questionItems(sections).map((question, index) => ({
+          id: `Q-${String(index + 1).padStart(3, "0")}`,
+          question,
+          status: "deferred",
+          resolution: null
+        })),
+        tasks: [...planTasksForPrd(input)],
         generatedAt: now()
       };
     },
@@ -81,14 +148,29 @@ function defaultPlanningProvider(now) {
 async function loadPlanningClient() {
   return await import("@rig/client");
 }
-function readPrdText(args) {
+async function readPrdText(context, args) {
   const title = takeOption(args, "--title");
   const text = takeOption(title.rest, "--text");
   const prd = takeOption(text.rest, "--prd");
+  const issue = takeOption(prd.rest, "--issue");
+  const sources = [text.value, prd.value, issue.value].filter(Boolean);
+  if (sources.length !== 1)
+    throw new Error("rig plan requires exactly one of --text <prd>, --prd <file>, or --issue <id>.");
+  if (issue.value) {
+    const { getTask } = await loadPlanningClient();
+    const task = await getTask(context.projectRoot, issue.value);
+    if (!task)
+      throw new Error(`No task found for issue ${issue.value}.`);
+    const body2 = typeof task.body === "string" ? task.body : "";
+    if (!body2.trim())
+      throw new Error(`Issue ${issue.value} has no PRD body text.`);
+    const taskTitle = typeof task.title === "string" && task.title.trim() ? task.title.trim() : `Issue ${issue.value}`;
+    return { title: title.value?.trim() || taskTitle, body: body2, rest: issue.rest };
+  }
   const body = text.value ?? (prd.value ? readFileSync(prd.value, "utf8") : null);
   if (!body?.trim())
-    throw new Error("rig plan requires --text <prd> or --prd <file>.");
-  return { title: title.value?.trim() || "Rig generated plan", body, rest: prd.rest };
+    throw new Error("rig plan requires non-empty PRD text.");
+  return { title: title.value?.trim() || "Rig generated plan", body, rest: issue.rest };
 }
 async function executePlan(context, args) {
   const materialize = takeFlag(args, "--materialize");
@@ -96,8 +178,8 @@ async function executePlan(context, args) {
   const json = takeFlag(dryRun.rest, "--json");
   if (materialize.value && dryRun.value)
     throw new Error("Pass only one of --materialize or --dry-run.");
-  const prd = readPrdText(json.rest);
-  requireNoExtraArgs(prd.rest, "rig plan --text <prd>|--prd <file> [--title <title>] [--materialize|--dry-run] [--json]");
+  const prd = await readPrdText(context, json.rest);
+  requireNoExtraArgs(prd.rest, "rig plan --text <prd>|--prd <file>|--issue <id> [--title <title>] [--materialize|--dry-run] [--json]");
   const willMaterialize = materialize.value && !dryRun.value;
   const now = () => new Date().toISOString();
   const provider = defaultPlanningProvider(now);
@@ -119,9 +201,9 @@ var planningCliCommands = [
   {
     id: PLANNING_PLAN_CLI_ID,
     family: "plan",
-    command: "rig plan --text <prd>|--prd <file>",
-    description: "Generate a plan from a PRD and optionally materialize task-source tasks.",
-    usage: "rig plan --text <prd>|--prd <file> [--title <title>] [--materialize|--dry-run] [--json]",
+    command: "rig plan --text <prd>|--prd <file>|--issue <id>",
+    description: "Generate a plan from a PRD or task-source issue and optionally materialize task-source tasks.",
+    usage: "rig plan --text <prd>|--prd <file>|--issue <id> [--title <title>] [--materialize|--dry-run] [--json]",
     projectRequired: true,
     run: executePlan
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h-rig/planning-plugin",
-  "version": "0.0.6-alpha.142",
+  "version": "0.0.6-alpha.143",
   "type": "module",
   "description": "First-party PRD-to-plan plugin for Rig task sources.",
   "license": "UNLICENSED",
@@ -10,8 +10,8 @@
   ],
   "exports": {
     ".": {
-      "types": "./dist/src/index.d.ts",
-      "import": "./dist/src/index.js"
+      "types": "./dist/src/plugin.d.ts",
+      "import": "./dist/src/plugin.js"
     },
     "./planning": {
       "types": "./dist/src/planning.d.ts",
@@ -29,8 +29,8 @@
   "module": "./dist/src/index.js",
   "types": "./dist/src/index.d.ts",
   "dependencies": {
-    "@rig/client": "npm:@h-rig/client@0.0.6-alpha.142",
-    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.142",
-    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.142"
+    "@rig/client": "npm:@h-rig/client@0.0.6-alpha.143",
+    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.143",
+    "@rig/core": "npm:@h-rig/core@0.0.6-alpha.143"
   }
 }