@indigoai-us/hq-cli 5.193.0 → 5.194.0

package/dist/lib/mesh/story-status.d.ts

@@ -0,0 +1,22 @@
+export declare const BOARD_STORY_STATUSES: readonly ["queued", "in_progress", "review", "done"];
+export type BoardStoryStatus = (typeof BOARD_STORY_STATUSES)[number];
+/**
+ * The ledger has more states than the Board. `blocked` and the review states
+ * need attention, while `dropped` is terminal; the Board has only one terminal
+ * column (`done`).
+ */
+export declare const LEDGER_STATE_TO_BOARD_STATUS: Readonly<Record<string, BoardStoryStatus>>;
+export declare function mapSourceStoryStatus(story: {
+    status?: unknown;
+    state?: unknown;
+}, source: string): BoardStoryStatus | undefined;
+/**
+ * Read a status from an existing PRD or Board response without imposing the
+ * stricter `--stories-file` contract. Before state mapping was added, these
+ * readers passed explicit status strings through and ignored state.
+ */
+export declare function mapReaderStoryStatus(story: {
+    status?: unknown;
+    state?: unknown;
+}): string | undefined;
+//# sourceMappingURL=story-status.d.ts.map

package/dist/lib/mesh/story-status.js

@@ -0,0 +1,49 @@
+export const BOARD_STORY_STATUSES = ["queued", "in_progress", "review", "done"];
+const boardStoryStatusSet = new Set(BOARD_STORY_STATUSES);
+/**
+ * The ledger has more states than the Board. `blocked` and the review states
+ * need attention, while `dropped` is terminal; the Board has only one terminal
+ * column (`done`).
+ */
+export const LEDGER_STATE_TO_BOARD_STATUS = {
+    todo: "queued",
+    in_progress: "in_progress",
+    in_review: "review",
+    verification: "review",
+    blocked: "review",
+    done: "done",
+    dropped: "done",
+};
+export function mapSourceStoryStatus(story, source) {
+    if (story.status !== undefined && story.status !== null) {
+        if (typeof story.status !== "string" || !boardStoryStatusSet.has(story.status.trim())) {
+            throw new Error(`${source}.status must be queued|in_progress|review|done.`);
+        }
+        return story.status.trim();
+    }
+    if (Object.hasOwn(story, "state")) {
+        if (typeof story.state !== "string" ||
+            !Object.hasOwn(LEDGER_STATE_TO_BOARD_STATUS, story.state.trim())) {
+            throw new Error(`${source}.state must be todo|in_progress|in_review|verification|blocked|done|dropped.`);
+        }
+        return LEDGER_STATE_TO_BOARD_STATUS[story.state.trim()];
+    }
+    return undefined;
+}
+/**
+ * Read a status from an existing PRD or Board response without imposing the
+ * stricter `--stories-file` contract. Before state mapping was added, these
+ * readers passed explicit status strings through and ignored state.
+ */
+export function mapReaderStoryStatus(story) {
+    if (story.status !== undefined && story.status !== null) {
+        return typeof story.status === "string" ? story.status : undefined;
+    }
+    if (typeof story.state !== "string")
+        return undefined;
+    const state = story.state.trim();
+    return Object.hasOwn(LEDGER_STATE_TO_BOARD_STATUS, state)
+        ? LEDGER_STATE_TO_BOARD_STATUS[state]
+        : undefined;
+}
+//# sourceMappingURL=story-status.js.map

package/dist/lib/work-context/prd-sync.d.ts

@@ -8,7 +8,7 @@
 import { type SessionStateFile } from "./state.js";
 export interface PrdStatusEvent {
     taskId: string;
-    status: "done" | "in_progress";
+    status: "done" | "in_progress" | "review";
 }
 export interface PrdSnapshot {
     stories: Record<string, {

package/dist/lib/work-context/prd-sync.js

@@ -8,6 +8,7 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { readSessionState, updateSessionState } from "./state.js";
+import { mapReaderStoryStatus } from "../mesh/story-status.js";
 export function prdSnapshotPath(sessionId, root) {
     return path.join(root, "sessions", `${sessionId}.prd-snapshot.json`);
 }
@@ -87,11 +88,12 @@ function storiesFromPrd(file) {
         const id = row.id;
         if (typeof id !== "string" || !id.trim())
             continue;
-        const status = row.status;
+        const rawStatus = mapReaderStoryStatus(row);
+        const status = rawStatus?.trim() ? rawStatus.trim() : undefined;
         out.push({
             id: id.trim(),
             passes: row.passes === true,
-            ...(typeof status === "string" && status.trim() ? { status: status.trim() } : {}),
+            ...(status ? { status } : {}),
         });
     }
     return out;
@@ -144,7 +146,7 @@ export function planPrdSync(input) {
             ...(story.status ? { status: story.status } : {}),
         };
         const prior = previous ? before[story.id] : undefined;
-        if (story.passes && !prior?.passes) {
+        if ((story.passes || story.status === "done") && !prior?.passes && prior?.status !== "done") {
             events.push({ taskId: story.id, status: "done" });
             continue;
         }
@@ -152,6 +154,9 @@ export function planPrdSync(input) {
             events.push({ taskId: story.id, status: "in_progress" });
             taskId = story.id;
         }
+        if (story.status === "review" && prior?.status !== "review") {
+            events.push({ taskId: story.id, status: "review" });
+        }
     }
     const snapshot = {
         stories: nextStories,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.193.0",
+  "version": "5.194.0",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {