chiefwiggum 1.3.48 → 1.3.52

package/dist/cli.cjs

@@ -300,6 +300,54 @@ var init_config = __esm({
 });
 
 // src/lib/claude.ts
+function getProjectBoardContext() {
+  try {
+    const owner = (0, import_node_child_process4.execSync)("gh repo view --json owner -q .owner.login", {
+      encoding: "utf-8",
+      stdio: ["pipe", "pipe", "pipe"],
+      timeout: 3e4
+    }).trim();
+    const projectNumber = (0, import_node_child_process4.execSync)(
+      "gh repo view --json projectsV2 -q '.projectsV2.Nodes[0].number'",
+      { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"], timeout: 3e4 }
+    ).trim();
+    if (!projectNumber || projectNumber === "null") return null;
+    const projectId = (0, import_node_child_process4.execSync)(
+      "gh repo view --json projectsV2 -q '.projectsV2.Nodes[0].id'",
+      { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"], timeout: 3e4 }
+    ).trim();
+    const fieldsOutput = (0, import_node_child_process4.execSync)(
+      `gh project field-list ${projectNumber} --owner ${owner} --format json`,
+      { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"], timeout: 3e4 }
+    );
+    const fields = JSON.parse(fieldsOutput);
+    const statusField = fields.fields?.find((f) => f.name === "Status");
+    if (!statusField) return null;
+    const findOption = (names) => {
+      for (const name of names) {
+        const option = statusField.options?.find(
+          (o) => o.name.toLowerCase() === name.toLowerCase()
+        );
+        if (option) return option;
+      }
+      return null;
+    };
+    const todoOption = findOption(["Todo", "To Do", "To do", "Backlog"]);
+    const inProgressOption = findOption(["In Progress", "In progress", "Doing", "Active"]);
+    const doneOption = findOption(["Done", "Completed", "Closed", "Finished"]);
+    return {
+      owner,
+      projectNumber,
+      projectId,
+      statusFieldId: statusField.id,
+      todoOptionId: todoOption?.id || "",
+      inProgressOptionId: inProgressOption?.id || "",
+      doneOptionId: doneOption?.id || ""
+    };
+  } catch {
+    return null;
+  }
+}
 async function runClaude(options) {
   const { prompt, streaming = false, onOutput } = options;
   const timeoutMs = options.timeoutMs || config.iterationTimeoutMinutes * 60 * 1e3;
@@ -422,50 +470,62 @@ IMPORTANT: Only use the root-level files above for project context. Do not read
 Output: RALPH_COMPLETE
 If no tasks remain: RALPH_ALL_DONE`;
 }
-function getGitHubTaskPrompt() {
-  return `You are an autonomous coding agent. Complete ONE GitHub Issue.
-
-## Before Starting
-Read these ROOT-LEVEL files only (ignore subdirectories for project context):
-- CLAUDE.md \u2014 Project context and conventions
-- specs/prd.md \u2014 What we are building
-- specs/technical.md \u2014 How we are building it
+function getGitHubTaskPrompt(boardContext) {
+  const boardInstructions = boardContext && boardContext.inProgressOptionId && boardContext.doneOptionId ? `
+## Project Board Status Updates (REQUIRED)
 
-IMPORTANT: Only use the root-level files above for project context. Do not read subdirectory README files or other nested project files when determining what project you're working on.
-
-Then list open issues: gh issue list --state open
+Pre-computed values for this project:
+- Owner: ${boardContext.owner}
+- Project Number: ${boardContext.projectNumber}
+- Project ID: ${boardContext.projectId}
+- Status Field ID: ${boardContext.statusFieldId}
+- In Progress Option ID: ${boardContext.inProgressOptionId}
+- Done Option ID: ${boardContext.doneOptionId}
 
-## Workflow
-1. Pick the FIRST open issue (lowest number)
-2. Read the issue: gh issue view <number>
-3. Update project board status to "In Progress" (see instructions below)
-4. Implement the code
-5. Close the issue: gh issue close <number> --comment "Completed"
-6. Update project board status to "Done"
-7. Commit: git commit -m "type(scope): description (closes #<number>)"
+### Step 1: Get Item ID for the Issue
+Run this to get the ITEM_ID (replace ISSUE_NUMBER with the actual issue number):
+\`\`\`bash
+ITEM_ID=$(gh project item-list ${boardContext.projectNumber} --owner ${boardContext.owner} --format json | jq -r '.items[] | select(.content.number == ISSUE_NUMBER) | .id')
+echo "Item ID: $ITEM_ID"
+\`\`\`
 
-## Update Project Board Status
-Use this to update issue status on the project board (replace <issue_number> and <status_name>):
+### Step 2: Mark In Progress (do this FIRST, before any code changes)
+\`\`\`bash
+gh project item-edit --project-id ${boardContext.projectId} --id $ITEM_ID --field-id ${boardContext.statusFieldId} --single-select-option-id ${boardContext.inProgressOptionId}
+\`\`\`
 
+### Step 3: Mark Done (do this AFTER closing the issue)
 \`\`\`bash
-# Get repo owner, project number, and project ID
-OWNER=$(gh repo view --json owner -q .owner.login)
-PROJECT_NUM=$(gh repo view --json projectsV2 -q '.projectsV2.Nodes[0].number')
-PROJECT_ID=$(gh repo view --json projectsV2 -q '.projectsV2.Nodes[0].id')
+gh project item-edit --project-id ${boardContext.projectId} --id $ITEM_ID --field-id ${boardContext.statusFieldId} --single-select-option-id ${boardContext.doneOptionId}
+\`\`\`
 
-# Get the issue's item ID in the project
-ITEM_ID=$(gh project item-list $PROJECT_NUM --owner $OWNER --format json | jq -r '.items[] | select(.content.number == <issue_number>) | .id')
+**You MUST update the board status at each step. Do not skip this.**
+` : `
+## Project Board Status Updates
+No project board is linked or Status field not found. Skip board status updates.
+`;
+  return `You are an autonomous coding agent. Complete ONE GitHub Issue.
 
-# Get Status field ID and target status option ID
-FIELD_ID=$(gh project field-list $PROJECT_NUM --owner $OWNER --format json | jq -r '.fields[] | select(.name == "Status") | .id')
-STATUS_ID=$(gh project field-list $PROJECT_NUM --owner $OWNER --format json | jq -r '.fields[] | select(.name == "Status") | .options[] | select(.name == "<status_name>") | .id')
+## Before Starting (REQUIRED - Read these first)
+1. Read specs/prd.md to understand what we're building
+2. Read CLAUDE.md for coding conventions
+3. List open issues: gh issue list --state open --json number,title
 
-# Update status (use "In Progress" when starting, "Done" when complete)
-gh project item-edit --project-id $PROJECT_ID --id $ITEM_ID --field-id $FIELD_ID --single-select-option-id $STATUS_ID
-\`\`\`
+IMPORTANT: Only use root-level files for project context. Do not read subdirectory README files.
 
-If any step fails (no project linked, field not found), skip and continue.
+## Pick an Issue
+Choose the issue that best aligns with the PRD priorities.
+If unsure, pick the lowest numbered open issue.
 
+## Workflow
+1. Read the issue: gh issue view <number>
+2. **Mark issue as "In Progress" on project board** (see commands below)
+3. Implement the code following existing patterns
+4. Test your changes work correctly
+5. Close the issue: gh issue close <number> --comment "Completed: <brief summary>"
+6. **Mark issue as "Done" on project board**
+7. Commit: git add -A && git commit -m "type(scope): description (closes #<number>)"
+${boardInstructions}
 ## Rules
 - ONE issue per iteration
 - Follow existing code patterns
@@ -477,8 +537,8 @@ If any step fails (no project linked, field not found), skip and continue.
 Output: RALPH_COMPLETE
 If no issues remain: RALPH_ALL_DONE`;
 }
-async function runTaskIteration(iteration, useGitHub = false) {
-  const taskPrompt = useGitHub ? getGitHubTaskPrompt() : getTodoTaskPrompt();
+async function runTaskIteration(iteration, useGitHub = false, boardContext) {
+  const taskPrompt = useGitHub ? getGitHubTaskPrompt(boardContext || null) : getTodoTaskPrompt();
   let lastResult = {
     success: false,
     output: "",
@@ -704,6 +764,20 @@ async function cmdLoop() {
   if (isGitHub) {
     await ensureProjectLinked();
   }
+  let boardContext = null;
+  if (isGitHub) {
+    console.log(import_picocolors6.default.dim("Fetching project board context..."));
+    boardContext = getProjectBoardContext();
+    if (boardContext) {
+      console.log(import_picocolors6.default.green(`\u2713 Board context loaded (Project #${boardContext.projectNumber})`));
+      if (!boardContext.inProgressOptionId || !boardContext.doneOptionId) {
+        console.log(import_picocolors6.default.yellow("  \u26A0 Missing status options - status updates may not work"));
+      }
+    } else {
+      console.log(import_picocolors6.default.yellow("\u26A0 Could not fetch project board context."));
+      console.log(import_picocolors6.default.dim("  Status updates will not work. Continuing anyway..."));
+    }
+  }
   let maxIterations;
   let hasRemainingTasks;
   let trackerLabel;
@@ -749,7 +823,7 @@ async function cmdLoop() {
     console.log(import_picocolors6.default.yellow(`\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550 Task ${i} of ${maxIterations} \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550`));
     cleanupStaleProcesses();
     const startTime = Date.now();
-    const result = await runTaskIteration(i, isGitHub);
+    const result = await runTaskIteration(i, isGitHub, boardContext);
     const duration = Math.round((Date.now() - startTime) / 1e3);
     console.log();
     console.log(`Completed in ${duration}s (exit: ${result.success ? 0 : 1})`);
@@ -865,6 +939,22 @@ function countOpenGitHubIssues() {
     return 0;
   }
 }
+function parsePRDFrontmatter(content) {
+  const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!frontmatterMatch) return null;
+  const frontmatter = {};
+  const lines = frontmatterMatch[1].split("\n");
+  for (const line of lines) {
+    const match = line.match(/^(\w+):\s*"?([^"]+)"?$/);
+    if (match) {
+      const [, key, value] = match;
+      if (key === "project" || key === "branch" || key === "priority" || key === "source_plan") {
+        frontmatter[key] = value.trim();
+      }
+    }
+  }
+  return Object.keys(frontmatter).length > 0 ? frontmatter : null;
+}
 function findMarkdownFiles(dir, basePath = "") {
   const results = [];
   try {
@@ -1285,6 +1375,7 @@ async function generateFromPlan(planFile) {
   const claudeTemplate = (0, import_node_fs3.readFileSync)(`${LOCAL_TEMPLATES_DIR}/CLAUDE-template.md`, "utf-8");
   console.log();
   console.log(import_picocolors7.default.yellow(`[1/4] Generating ${prdPath}...`));
+  const planFilename = planFile.split("/").pop() || planFile;
   const prdPrompt = `You are filling in a PRD template based on a project plan.
 
 Here is the plan:
@@ -1299,6 +1390,18 @@ ${prdTemplate}
 
 Fill in the template with specific details from the plan.
 Replace all placeholder text in [brackets] with real content.
+
+IMPORTANT for YAML frontmatter at the top:
+- project: Use a short, descriptive project name (e.g., "User Authentication System")
+- branch: Suggest a git branch name (e.g., "feat/user-auth")
+- priority: Set to "high", "medium", or "low" based on the plan
+- source_plan: Set to "${planFilename}"
+
+For User Stories section:
+- Each "### Story:" becomes a GitHub Issue
+- Use P0 for critical, P1 for important, P2 for nice-to-have
+- Include specific acceptance criteria as checkboxes
+
 Write the completed PRD directly to ${prdPath}.
 Do NOT ask questions \u2014 infer everything from the plan.`;
   await runClaude({ prompt: prdPrompt });
@@ -1435,8 +1538,14 @@ Create 5-15 issues.${projectName ? ` Add each to project "${projectName}".` : ""
       } catch {
       }
       console.log(import_picocolors7.default.dim("  Creating epic from PRD..."));
-      const planTitleMatch = planContent.match(/^#\s+(.+)$/m);
-      const epicTitle = planTitleMatch ? `Epic: ${planTitleMatch[1]}` : "Epic: Project Implementation";
+      const prdFrontmatter = parsePRDFrontmatter(prdGenerated);
+      let epicTitle;
+      if (prdFrontmatter?.project) {
+        epicTitle = `Epic: ${prdFrontmatter.project}`;
+      } else {
+        const planTitleMatch = planContent.match(/^#\s+(.+)$/m);
+        epicTitle = planTitleMatch ? `Epic: ${planTitleMatch[1]}` : "Epic: Project Implementation";
+      }
       const epicBodyInitial = `${prdGenerated}
 
 ---
@@ -1549,14 +1658,23 @@ _Creating issues..._
       let failed = 0;
       const failedIssues = [];
       const createdIssueNumbers = [];
+      const supportsInPlace = process.stdout.isTTY && !process.env.SSH_TTY && !process.env.CI;
       const loggedMilestones = /* @__PURE__ */ new Set();
       for (let i = 0; i < issues.length; i++) {
         const issue = issues[i];
         const progress = Math.round((i + 1) / total * 100);
-        const milestone = Math.floor(progress / 25) * 25;
-        if (milestone > 0 && !loggedMilestones.has(milestone) && milestone < 100) {
-          console.log(import_picocolors7.default.dim(`    ${milestone}% complete (${i + 1}/${total})...`));
-          loggedMilestones.add(milestone);
+        if (supportsInPlace) {
+          const barWidth = 20;
+          const filled = Math.round(progress / 100 * barWidth);
+          const empty = barWidth - filled;
+          const bar = import_picocolors7.default.green("\u2588".repeat(filled)) + import_picocolors7.default.dim("\u2591".repeat(empty));
+          process.stdout.write(`\r  ${bar} ${progress}% (${i + 1}/${total}) Creating: ${issue.title.slice(0, 40)}...`);
+        } else {
+          const milestone = Math.floor(progress / 25) * 25;
+          if (milestone > 0 && !loggedMilestones.has(milestone) && milestone < 100) {
+            console.log(import_picocolors7.default.dim(`    ${milestone}% complete (${i + 1}/${total})...`));
+            loggedMilestones.add(milestone);
+          }
         }
         try {
           const validLabels = issue.labels.filter((label) => availableLabels.size === 0 || availableLabels.has(label));
@@ -1593,20 +1711,20 @@ ${issue.body}`;
           if (projectNumber && issueUrl) {
             try {
               const addOutput = (0, import_node_child_process6.execSync)(
-                `gh project item-add ${projectNumber} --owner ${owner} --url "${issueUrl}"`,
+                `gh project item-add ${projectNumber} --owner ${owner} --url "${issueUrl}" --format json`,
                 { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }
               );
               if (projectId && statusFieldId && todoOptionId) {
-                const itemIdMatch = addOutput.match(/Added item\s+(\S+)/i);
-                const itemId = itemIdMatch?.[1];
-                if (itemId) {
-                  try {
+                try {
+                  const addResult = JSON.parse(addOutput);
+                  const itemId = addResult.id;
+                  if (itemId) {
                     (0, import_node_child_process6.execSync)(
                       `gh project item-edit --project-id ${projectId} --id ${itemId} --field-id ${statusFieldId} --single-select-option-id ${todoOptionId}`,
                       { stdio: ["pipe", "pipe", "pipe"] }
                     );
-                  } catch {
                   }
+                } catch {
                 }
               }
             } catch {
@@ -1619,6 +1737,9 @@ ${issue.body}`;
           failedIssues.push({ title: issue.title, error: errorMsg });
         }
       }
+      if (supportsInPlace) {
+        process.stdout.write("\r" + " ".repeat(80) + "\r");
+      }
       console.log(import_picocolors7.default.green(`  \u2713 Created ${created} GitHub Issues`));
       if (failed > 0) {
         console.log(import_picocolors7.default.yellow(`  \u26A0 ${failed} issues failed to create:`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chiefwiggum",
-  "version": "1.3.48",
+  "version": "1.3.52",
   "description": "Autonomous coding agent CLI. Point it at a plan, watch it build.",
   "type": "module",
   "bin": {

package/templates/prd-template.md

@@ -1,3 +1,10 @@
+---
+project: "[Project Name - short, descriptive title]"
+branch: "[feat/feature-name or fix/bug-name]"
+priority: "[high|medium|low]"
+source_plan: "[filename of the input plan]"
+---
+
 # Product Requirements Document
 
 ## Overview
@@ -15,9 +22,25 @@
 
 ## User Stories
 
-### As a [user type]
-- I want to [action]
-- So that [benefit]
+<!-- Each story becomes a GitHub Issue. Use this exact format: -->
+
+### Story: [Short descriptive title]
+- **Priority**: P0
+- **As a**: [user type]
+- **I want**: [action]
+- **So that**: [benefit]
+- **Acceptance Criteria**:
+  - [ ] Criterion 1
+  - [ ] Criterion 2
+
+### Story: [Another story title]
+- **Priority**: P1
+- **As a**: [user type]
+- **I want**: [action]
+- **So that**: [benefit]
+- **Acceptance Criteria**:
+  - [ ] Criterion 1
+  - [ ] Criterion 2
 
 ## Functional Requirements