pi-bmad-flow 0.1.1 → 0.1.3

package/extensions/bmad-orchestrator/commands.ts

@@ -82,6 +82,15 @@ export function registerBmadCommands(pi: ExtensionAPI, cwd: string): void {
       ctx.ui.notify(`Delivery: ${deliverySummary}`, "info");
       ctx.ui.notify(`Design: ${designSummary}`, "info");
       ctx.ui.notify(`TEA: ${teaSummary}`, "info");
+      if (state.activeSprintStatusPath) {
+        ctx.ui.notify(`Status file: ${state.activeSprintStatusPath}`, "info");
+      }
+      if (state.activeStoryLocation) {
+        ctx.ui.notify(`Story location: ${state.activeStoryLocation}`, "info");
+      }
+      if (state.inventory.epicFiles.length > 0) {
+        ctx.ui.notify(`Epic file: ${state.inventory.epicFiles[0]}`, "info");
+      }
       ctx.ui.notify(`Next: ${next.command} - ${next.summary}`, "info");
 
       refreshBmadUi(ctx, state, next);
@@ -96,9 +105,15 @@ export function registerBmadCommands(pi: ExtensionAPI, cwd: string): void {
       const next = decideNextAction(state);
       ctx.ui.notify(`Current phase: ${state.phase}`, "info");
       ctx.ui.notify(
-        `Artifacts: PRD ${state.inventory.prdFiles.length}, UX ${state.inventory.uxFiles.length}, Architecture ${state.inventory.architectureFiles.length}, Stories ${state.inventory.storyFiles.length}`,
+        `Artifacts: PRD ${state.inventory.prdFiles.length}, UX ${state.inventory.uxFiles.length}, Architecture ${state.inventory.architectureFiles.length}, Epics ${state.inventory.epicFiles.length}, Stories ${state.inventory.storyFiles.length}`,
         "info",
       );
+      if (state.activeSprintStatusPath) {
+        ctx.ui.notify(`Status file: ${state.activeSprintStatusPath}`, "info");
+      }
+      if (state.activeStoryLocation) {
+        ctx.ui.notify(`Story location: ${state.activeStoryLocation}`, "info");
+      }
       ctx.ui.notify(`Recommended: ${next.command} (${next.reason})`, "info");
       refreshBmadUi(ctx, state, next);
       appendBmadState(pi, { event: "status", nextCommand: next.command });

package/extensions/bmad-orchestrator/detector.ts

@@ -16,14 +16,35 @@ function collectStructuredFiles(dirPath: string): string[] {
   return unique([...collectMarkdownFiles(dirPath), ...collectYamlFiles(dirPath)]);
 }
 
+function detectStoryFiles(storyLocationFiles: string[]): string[] {
+  return storyLocationFiles.filter((file) => {
+    const lower = file.toLowerCase();
+    const base = lower.split("/").pop() ?? lower;
+    if (!base.endsWith(".md")) return false;
+    if (["readme.md", "index.md", "deferred-work.md"].includes(base)) return false;
+    if (/(checklist|traceability|report|spec-|specification|validation)/.test(base)) return false;
+    return /^(story-.*|\d+-\d+-.*|rb\d+-\d+-.*)\.md$/.test(base);
+  });
+}
+
+function detectEpicFiles(planningFiles: string[]): string[] {
+  const canonical = planningFiles.filter((file) => file.toLowerCase().endsWith("/epics.md"));
+  if (canonical.length > 0) return canonical;
+
+  return planningFiles.filter((file) => {
+    const lower = file.toLowerCase();
+    const base = lower.split("/").pop() ?? lower;
+    return /(^|.*-)epics\.md$/.test(base) || /^epic-.*\.md$/.test(base);
+  });
+}
+
 function detectInventory(paths: BmadPaths): ArtifactInventory {
   const resolvedSprintStatusPath = resolveSprintStatusPath(paths.sprintStatusPath);
   const sprint = loadSprintStatus(resolvedSprintStatusPath);
   const storyLocationDir = resolveStoryLocation(resolvedSprintStatusPath, sprint);
   const planningFiles = collectMarkdownFiles(paths.planningArtifactsDir);
   const implementationFiles = collectMarkdownFiles(paths.implementationArtifactsDir);
-  const storyLocationFiles =
-    storyLocationDir !== paths.implementationArtifactsDir ? collectMarkdownFiles(storyLocationDir) : implementationFiles;
+  const storyLocationFiles = collectMarkdownFiles(storyLocationDir);
   const designFiles = collectStructuredFiles(paths.designArtifactsDir);
   const docsFiles = collectStructuredFiles(paths.docsDir);
   const teaFiles = unique([
@@ -65,8 +86,8 @@ function detectInventory(paths: BmadPaths): ArtifactInventory {
       /(ux|wds-|wireframe|storyboard|page-spec|page-specification|design-delivery|scenario)/,
     ),
     architectureFiles: matches(allContextFiles, /architecture|adr/),
-    epicFiles: matches(allContextFiles, /(^|\/)epics?\/|epic-/),
-    storyFiles: matches(allContextFiles, /(^|\/)story-.*\.md$/),
+    epicFiles: detectEpicFiles(planningFiles),
+    storyFiles: detectStoryFiles(storyLocationFiles),
     reviewFiles: matches(allContextFiles, /review|retrospective|readiness-report|validation-report/),
     projectContextFiles: matches(allContextFiles, /project-context/),
     wdsScenarioFiles,
@@ -154,6 +175,7 @@ export function detectBmadProjectState(cwd: string): BmadProjectState {
   const nextBacklogStory = sprint?.storyOrder.find((story) => sprint.developmentStatus[story] === "backlog");
   const nextReadyStory = sprint?.storyOrder.find((story) => sprint.developmentStatus[story] === "ready-for-dev");
   const activeStory = sprint?.storyOrder.find((story) => sprint.developmentStatus[story] === "in-progress");
+  const activeStoryLocation = sprint ? resolveStoryLocation(resolvedSprintStatusPath, sprint) : undefined;
 
   return {
     phase,
@@ -163,6 +185,8 @@ export function detectBmadProjectState(cwd: string): BmadProjectState {
     hasWdsArtifacts,
     hasTeaArtifacts,
     inventory,
+    activeSprintStatusPath: hasSprintStatus ? resolvedSprintStatusPath : undefined,
+    activeStoryLocation,
     nextBacklogStory,
     nextReadyStory,
     activeStory,

package/extensions/bmad-orchestrator/router.ts

@@ -47,6 +47,14 @@ export function decideNextAction(state: BmadProjectState): NextAction {
     };
   }
 
+  if (!state.activeStoryLocation) {
+    return {
+      summary: "Sprint tracking exists, but story_location is missing or could not be resolved.",
+      command: "bmad-sprint-planning",
+      reason: "The active story directory should come from sprint-status.yaml before story execution starts.",
+    };
+  }
+
   if (state.activeStory) {
     return {
       summary: `Story ${state.activeStory} is already in progress.`,

package/extensions/bmad-orchestrator/sprint.ts

@@ -3,8 +3,7 @@ import { dirname, resolve } from "node:path";
 import type { SprintStatus } from "./types.js";
 
 const STATUS_FILE_CANDIDATES = ["sprint-status.yaml", "story-status.yaml"];
-
-const STORY_KEY_PATTERN = /^\d+-\d+-/;
+const STORY_KEY_PATTERN = /^(?:\d+-\d+-|rb\d+-\d+-)/;
 
 function parseStatusLine(line: string): { key: string; value: string } | undefined {
   const match = line.match(/^\s{2}([a-zA-Z0-9._-]+):\s*([a-zA-Z0-9._-]+)\s*$/);
@@ -57,6 +56,18 @@ export function loadSprintStatus(statusPath: string): SprintStatus | undefined {
     if (STORY_KEY_PATTERN.test(parsed.key)) storyOrder.push(parsed.key);
   }
 
+  if (storyOrder.length === 0) {
+    for (const key of Object.keys(developmentStatus)) {
+      if (STORY_KEY_PATTERN.test(key)) storyOrder.push(key);
+    }
+  }
+
+  if (storyOrder.length === 0) {
+    for (const key of Object.keys(developmentStatus)) {
+      if (!key.startsWith("epic-") && !key.endsWith("-retrospective")) storyOrder.push(key);
+    }
+  }
+
   return { developmentStatus, storyOrder, storyLocation };
 }
 
@@ -94,5 +105,13 @@ export function resolveStoryLocation(statusPath: string, sprint?: SprintStatus):
   if (!location) return fallbackDir;
   if (location.startsWith("{")) return fallbackDir;
   if (location.startsWith("/")) return location;
-  return resolve(dirname(statusPath), location);
+
+  const relativeToStatusDir = resolve(dirname(statusPath), location);
+  if (existsSync(relativeToStatusDir)) return relativeToStatusDir;
+
+  const projectRoot = resolve(dirname(statusPath), "..", "..");
+  const relativeToProjectRoot = resolve(projectRoot, location);
+  if (existsSync(relativeToProjectRoot)) return relativeToProjectRoot;
+
+  return relativeToStatusDir;
 }

package/extensions/bmad-orchestrator/types.ts

@@ -65,6 +65,8 @@ export interface BmadProjectState {
   hasWdsArtifacts: boolean;
   hasTeaArtifacts: boolean;
   inventory: ArtifactInventory;
+  activeSprintStatusPath?: string;
+  activeStoryLocation?: string;
   nextBacklogStory?: string;
   nextReadyStory?: string;
   activeStory?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-bmad-flow",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "description": "Pi-native orchestration overlay for BMAD workflows",
   "keywords": [

package/scripts/audit-project.mjs

@@ -1,5 +1,7 @@
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
-import { resolve, join, relative } from "node:path";
+import { resolve, join, relative, dirname } from "node:path";
+
+const STORY_KEY_PATTERN = /^(?:\d+-\d+-|rb\d+-\d+-)/;
 
 function parseArgs(argv) {
   const options = {
@@ -48,13 +50,10 @@ function readJson(path) {
 function resolveSprintStatusPath(path) {
   if (existsSync(path)) return path;
 
-  const candidates = [
-    path.replace(/sprint-status\.yaml$/, "story-status.yaml"),
-    path.replace(/story-status\.yaml$/, "sprint-status.yaml"),
-  ];
-
-  for (const candidate of candidates) {
-    if (candidate !== path && existsSync(candidate)) return candidate;
+  const directory = dirname(path);
+  for (const candidate of ["sprint-status.yaml", "story-status.yaml"]) {
+    const candidatePath = resolve(directory, candidate);
+    if (existsSync(candidatePath)) return candidatePath;
   }
 
   return path;
@@ -73,76 +72,93 @@ function parseSprintStatus(path) {
     storyLocation: undefined,
   };
 
-  let section = "";
+  let inDevelopmentStatus = false;
   for (const rawLine of lines) {
-    const line = rawLine.replace(/\t/g, "  ");
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith("#")) continue;
-
-    if (/^story_order:\s*$/.test(trimmed)) {
-      section = "story_order";
-      continue;
-    }
-    if (/^development_status:\s*$/.test(trimmed)) {
-      section = "development_status";
-      continue;
-    }
-    if (/^story_location:\s*/.test(trimmed)) {
-      state.storyLocation = trimmed.split(":").slice(1).join(":").trim().replace(/^['"]|['"]$/g, "");
-      section = "";
-      continue;
+    const line = rawLine.trimEnd();
+    if (!inDevelopmentStatus && !state.storyLocation) {
+      const storyLocationMatch = line.match(/^story_location:\s*["']?(.+?)["']?\s*$/);
+      if (storyLocationMatch) state.storyLocation = storyLocationMatch[1];
     }
 
-    if (section === "story_order") {
-      const match = trimmed.match(/^-\s+(.+)$/);
-      if (match) state.storyOrder.push(match[1].trim().replace(/^['"]|['"]$/g, ""));
+    if (!inDevelopmentStatus) {
+      if (line === "development_status:") inDevelopmentStatus = true;
       continue;
     }
 
-    if (section === "development_status") {
-      const match = trimmed.match(/^([^:]+):\s*(.+)$/);
-      if (match) {
-        const key = match[1].trim().replace(/^['"]|['"]$/g, "");
-        const value = match[2].trim().replace(/^['"]|['"]$/g, "");
-        state.developmentStatus[key] = value;
-      }
+    if (!line.startsWith("  ") && line.length > 0 && !line.startsWith("#")) break;
+    const match = line.match(/^\s{2}([a-zA-Z0-9._-]+):\s*([a-zA-Z0-9._-]+)\s*$/);
+    if (!match) continue;
+
+    const key = match[1];
+    const value = match[2];
+    state.developmentStatus[key] = value;
+    if (STORY_KEY_PATTERN.test(key)) state.storyOrder.push(key);
+  }
+
+  if (state.storyOrder.length === 0) {
+    for (const key of Object.keys(state.developmentStatus)) {
+      if (STORY_KEY_PATTERN.test(key)) state.storyOrder.push(key);
     }
   }
 
   return state;
 }
 
-function decideNextAction(inventory, sprintStatusExists, sprint) {
-  if (inventory.prdFiles.length === 0) {
-    return "bmad-create-prd";
-  }
-  if (inventory.uxFiles.length === 0) {
-    return "bmad-create-ux-design";
-  }
-  if (inventory.architectureFiles.length === 0) {
-    return "bmad-create-architecture";
-  }
-  if (inventory.epicFiles.length === 0) {
-    return "bmad-create-epics-and-stories";
-  }
-  if (!sprintStatusExists) {
-    return "bmad-sprint-planning";
-  }
+function resolveStoryLocation(statusPath, sprint) {
+  const fallbackDir = dirname(statusPath);
+  const location = sprint.storyLocation?.trim();
+  if (!location) return fallbackDir;
+  if (location.startsWith("{")) return fallbackDir;
+  if (location.startsWith("/")) return location;
+
+  const relativeToStatusDir = resolve(dirname(statusPath), location);
+  if (existsSync(relativeToStatusDir)) return relativeToStatusDir;
+
+  const projectRoot = resolve(dirname(statusPath), "..", "..");
+  const relativeToProjectRoot = resolve(projectRoot, location);
+  if (existsSync(relativeToProjectRoot)) return relativeToProjectRoot;
+
+  return relativeToStatusDir;
+}
+
+function detectStoryFiles(storyLocationFiles) {
+  return storyLocationFiles.filter((file) => {
+    const lower = file.toLowerCase();
+    const base = lower.split("/").pop() ?? lower;
+    if (!base.endsWith(".md")) return false;
+    if (["readme.md", "index.md", "deferred-work.md"].includes(base)) return false;
+    if (/(checklist|traceability|report|spec-|specification|validation)/.test(base)) return false;
+    return /^(story-.*|\d+-\d+-.*|rb\d+-\d+-.*)\.md$/.test(base);
+  });
+}
+
+function detectEpicFiles(planningFiles) {
+  const canonical = planningFiles.filter((file) => file.toLowerCase().endsWith("/epics.md"));
+  if (canonical.length > 0) return canonical;
+
+  return planningFiles.filter((file) => {
+    const lower = file.toLowerCase();
+    const base = lower.split("/").pop() ?? lower;
+    return /(^|.*-)epics\.md$/.test(base) || /^epic-.*\.md$/.test(base);
+  });
+}
+
+function decideNextAction(inventory, sprintStatusExists, sprint, activeStoryLocation) {
+  if (inventory.prdFiles.length === 0) return "bmad-create-prd";
+  if (inventory.uxFiles.length === 0) return "bmad-create-ux-design";
+  if (inventory.architectureFiles.length === 0) return "bmad-create-architecture";
+  if (inventory.epicFiles.length === 0) return "bmad-create-epics-and-stories";
+  if (!sprintStatusExists) return "bmad-sprint-planning";
+  if (!activeStoryLocation) return "bmad-sprint-planning";
 
   const activeStory = sprint.storyOrder.find((story) => sprint.developmentStatus[story] === "in-progress");
-  if (activeStory) {
-    return `bmad-dev-story ${activeStory}`;
-  }
+  if (activeStory) return `bmad-dev-story ${activeStory}`;
 
   const nextReadyStory = sprint.storyOrder.find((story) => sprint.developmentStatus[story] === "ready-for-dev");
-  if (nextReadyStory) {
-    return `/bmad-start (${nextReadyStory})`;
-  }
+  if (nextReadyStory) return `/bmad-start (${nextReadyStory})`;
 
   const nextBacklogStory = sprint.storyOrder.find((story) => sprint.developmentStatus[story] === "backlog");
-  if (nextBacklogStory) {
-    return `bmad-create-story (${nextBacklogStory})`;
-  }
+  if (nextBacklogStory) return `bmad-create-story (${nextBacklogStory})`;
 
   return "bmad-correct-course";
 }
@@ -205,12 +221,18 @@ function main() {
   const testFiles = collectStructuredFiles(paths.testArtifactsDir);
   const allContextFiles = [...planningFiles, ...implementationFiles, ...docsFiles, ...designFiles, ...testFiles];
 
+  const resolvedSprintStatusPath = resolveSprintStatusPath(paths.sprintStatusPath);
+  const sprint = parseSprintStatus(resolvedSprintStatusPath);
+  const sprintStatusExists = existsSync(resolvedSprintStatusPath);
+  const activeStoryLocation = sprintStatusExists ? resolveStoryLocation(resolvedSprintStatusPath, sprint) : undefined;
+  const activeStoryFiles = activeStoryLocation ? collectStructuredFiles(activeStoryLocation) : [];
+
   const inventory = {
     prdFiles: matches(allContextFiles, /(^|\/)(prd|.*prd.*)\.md$/),
     uxFiles: matches(allContextFiles, /(ux|wds-|wireframe|storyboard|page-spec|page-specification|design-delivery|scenario)/),
     architectureFiles: matches(allContextFiles, /architecture|adr/),
-    epicFiles: matches(allContextFiles, /(^|\/)epics?\/|epic-/),
-    storyFiles: matches(allContextFiles, /(^|\/)story-.*\.md$/),
+    epicFiles: detectEpicFiles(planningFiles),
+    storyFiles: detectStoryFiles(activeStoryFiles),
     projectContextFiles: matches(allContextFiles, /project-context/),
     wdsDeliveryFiles: matches(allContextFiles, /(design-deliver(y|ies)|\/deliveries\/|dd-\d+)/),
     wdsPageSpecFiles: matches(allContextFiles, /\/c-ux-scenarios\/.*(specifications\.md|page-spec|page-specification|\/frontend\/.*\.md)/),
@@ -219,10 +241,7 @@ function main() {
     teaNfrFiles: matches(allContextFiles, /nfr-assessment|nfr-report/),
   };
 
-  const resolvedSprintStatusPath = resolveSprintStatusPath(paths.sprintStatusPath);
-  const sprint = parseSprintStatus(resolvedSprintStatusPath);
-  const sprintStatusExists = existsSync(resolvedSprintStatusPath);
-  const nextAction = decideNextAction(inventory, sprintStatusExists, sprint);
+  const nextAction = decideNextAction(inventory, sprintStatusExists, sprint, activeStoryLocation);
 
   console.log("pi-bmad-flow project audit");
   console.log(`project: ${projectDir}`);
@@ -259,6 +278,7 @@ function main() {
   console.log("");
   console.log("sprint:");
   console.log(`sprint status: ${sprintStatusExists ? "present" : "missing"}`);
+  console.log(`status file: ${resolvedSprintStatusPath}`);
   console.log(`story order entries: ${sprint.storyOrder.length}`);
   console.log(`ready stories: ${sprint.storyOrder.filter((story) => sprint.developmentStatus[story] === "ready-for-dev").length}`);
   console.log(`active stories: ${sprint.storyOrder.filter((story) => sprint.developmentStatus[story] === "in-progress").length}`);
@@ -266,6 +286,9 @@ function main() {
   if (sprint.storyLocation) {
     console.log(`story location: ${sprint.storyLocation}`);
   }
+  if (activeStoryLocation) {
+    console.log(`resolved story location: ${activeStoryLocation}`);
+  }
 
   console.log("");
   console.log(`next action: ${nextAction}`);