@indigoai-us/hq-cli 5.193.0 → 5.193.1

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 ## [Unreleased]
 
+## [5.193.1] — 2026-09-25
+
+### Fixed
+
+- Work Mesh project sync maps ledger states (`todo` to `queued`, `in_progress` to
+  `in_progress`, `in_review`/`verification`/`blocked` to `review`, and `done`/`dropped`
+  to `done`), with explicit `status` taking precedence and `passes` preserved. PRD
+  sync emits review transitions; Board readers preserve unknown status strings and
+  ignore unknown ledger states. `hq mesh project ensure --dry-run` previews merged
+  Board statuses without writing.
+- Claude lane balance reports now normalize Outpost lane-list and queued show
+  views before strict lane-record validation, including `no_story_reason: null`.
+
 ## [5.193.0] — 2026-09-25
 
 ### Fixed

package/dist/command-catalog.generated.d.ts

@@ -5777,6 +5777,9 @@ export declare const COMMAND_CATALOG: readonly [{
             }, {
                 readonly flags: "--stories-file <path>";
                 readonly description: "PRD JSON file with userStories and metadata.repos";
+            }, {
+                readonly flags: "--dry-run";
+                readonly description: "Read the current Board and print computed story statuses without writing";
             }, {
                 readonly flags: "--json";
                 readonly description: "Print {projectId, threadId, channelId, version, stories}";

package/dist/command-catalog.generated.js

@@ -7458,6 +7458,10 @@ export const COMMAND_CATALOG = [
                                 "flags": "--stories-file <path>",
                                 "description": "PRD JSON file with userStories and metadata.repos"
                             },
+                            {
+                                "flags": "--dry-run",
+                                "description": "Read the current Board and print computed story statuses without writing"
+                            },
                             {
                                 "flags": "--json",
                                 "description": "Print {projectId, threadId, channelId, version, stories}"

package/dist/commands/lanes.js

@@ -534,6 +534,30 @@ function ownerErrorFromOutput(stdout) {
         : `Outpost owner returned ${owner.error}`;
     return { error: owner.error, message, details };
 }
+const LANE_RECORD_VIEW_FIELDS = [
+    "story_ids",
+    "hire_alive_children",
+    "hire",
+    "hire_summary",
+    "hire_source",
+    "hire_warning",
+    "senior_lost",
+    "remote_state",
+];
+/** Remove presentation-only fields before validating a remote lane snapshot. */
+function normalizeLaneRecordView(raw) {
+    if (raw === null || typeof raw !== "object" || Array.isArray(raw))
+        return raw;
+    const normalized = { ...raw };
+    if (normalized.state === "remote" && normalized.remote_state !== undefined) {
+        normalized.state = normalized.remote_state;
+    }
+    for (const field of LANE_RECORD_VIEW_FIELDS)
+        delete normalized[field];
+    if (normalized.no_story_reason === null)
+        delete normalized.no_story_reason;
+    return normalized;
+}
 async function ownerLaneHireFields(ctx, lane) {
     if (lane.host.kind !== "outpost") {
         throw new LanesError("outpost_lane_hire_summary_invalid", "Owner summary requires an Outpost-hosted lane", {
@@ -567,7 +591,7 @@ async function ownerLaneHireFields(ctx, lane) {
     }
     let ownerLane;
     try {
-        ownerLane = parseLaneRecord(remote.lane);
+        ownerLane = parseLaneRecord(normalizeLaneRecordView(remote.lane));
     }
     catch (err) {
         throw new LanesError("outpost_lane_hire_summary_invalid", `Outpost ${outpostId} returned an invalid lane snapshot for ${lane.lane_id}`, { lane_id: lane.lane_id, outpost_id: outpostId, cause: dispatchErrorMessage(err) });
@@ -890,11 +914,8 @@ async function readOutpostLaneRecords(ctx, outpostId) {
             typeof rowHost.id === "string" && rowHost.id.trim() !== "";
         if (!belongsToOutpost && !hasLocalHostIdentity)
             continue;
-        const normalized = raw.state === "remote" && raw.remote_state !== undefined
-            ? { ...raw, state: raw.remote_state }
-            : raw;
         try {
-            lanes.push(parseLaneRecord(normalized));
+            lanes.push(parseLaneRecord(normalizeLaneRecordView(raw)));
         }
         catch (err) {
             throw new LanesError("outpost_lane_list_invalid", `Outpost ${outpostId} returned an invalid owned lane record: ${dispatchErrorMessage(err)}`, { outpost_id: outpostId, index });

package/dist/commands/mesh.js

@@ -14,7 +14,8 @@ import chalk from "chalk";
 import { loadCachedTokens, isMachineIdentity } from "../utils/cognito-session.js";
 import * as readline from "node:readline/promises";
 import { STORY_STATUSES, appendThreadEvent, ensureProjectThread, eventPayload, getProjectView, listActiveMembershipCompanies, listActiveThreads, patchStory, putProjectView, registerMeshProject, resolveActiveMembershipCompany, resolveMeshPrincipalUid, warmMeshConversationCache, } from "../lib/mesh/api.js";
-import { closeSupersededProjectThread, ensureMissingBoardStories, ensureProjectBoard, formatStoryStatusChanges, mergeProjectStories, prdSyncEventsThatChangeBoard, } from "../lib/mesh/project-board.js";
+import { closeSupersededProjectThread, ensureMissingBoardStories, ensureProjectBoard, boardStoryStatus, formatStoryStatusChanges, mergeProjectStories, prdSyncEventsThatChangeBoard, } from "../lib/mesh/project-board.js";
+import { mapSourceStoryStatus } from "../lib/mesh/story-status.js";
 import { buildPreflightFixtures } from "../lib/work-context/preflight-contract.js";
 import { createCandidatesFetcher, createMigratePoster, createOrganizePoster, createWorkSessionDeliverer, fetchCompanyLive, formatCompanyLiveTable, openMeshTransport, probeMigrationCapabilityForMemberships, requireToken, } from "../lib/mesh/client.js";
 import { clearDefaultCompany, isDefaultCompanyDisabled, readDeviceConfig, recordMigrationCapabilitySnapshot, setRepairHeldWithDefault, setDefaultCompany, } from "../lib/work-context/config.js";
@@ -258,10 +259,7 @@ function projectStoriesFromJson(value, source) {
         if (!story || !id || !title) {
             fail(`${source} userStories[${index}] requires string id and title.`);
         }
-        const status = typeof story.status === "string" ? story.status.trim() : undefined;
-        if (status && !STORY_STATUSES.has(status)) {
-            fail(`${source} userStories[${index}].status must be queued|in_progress|review|done.`);
-        }
+        const status = mapSourceStoryStatus(story, `${source} userStories[${index}]`);
         const resolvedStatus = status || (story.passes === true ? "done" : undefined);
         return {
             id,
@@ -475,6 +473,42 @@ async function runProjectEnsure(projectId, opts) {
         if (httpStatus(err) !== 404)
             throw err;
     }
+    if (opts.dryRun) {
+        if (current && (current.companyUid !== company.companyUid || current.projectId !== projectId)) {
+            fail("Work mesh project ensure dry-run: Board company or project id did not match the request.");
+        }
+        const stories = current ? mergeProjectStories(current.stories, source.stories) : source.stories;
+        const sourceStatuses = source.stories.map((story) => ({
+            id: story.id,
+            title: story.title,
+            status: boardStoryStatus(story),
+        }));
+        const boardStatuses = stories.map((story) => ({
+            id: story.id,
+            title: story.title,
+            status: boardStoryStatus(story),
+        }));
+        if (opts.json) {
+            console.log(JSON.stringify({
+                ok: true,
+                action: "project.ensure.dry-run",
+                projectId,
+                companyUid: company.companyUid,
+                sourceStatuses,
+                stories: boardStatuses,
+            }, null, 2));
+        }
+        else {
+            console.log(`Work mesh: project ${projectId} dry run (${sourceStatuses.length} source stories)`);
+            console.log("Source statuses:");
+            for (const story of sourceStatuses)
+                console.log(`${story.id}\t${story.status}`);
+            console.log("Merged Board statuses:");
+            for (const story of boardStatuses)
+                console.log(`${story.id}\t${story.status}`);
+        }
+        return;
+    }
     // Genesis thread, then the view, then register. Register returns 403
     // PROJECT_NOT_IN_COMPANY until both exist. A missing view uses that chain
     // from ensureProjectBoard; an existing view is merged, then registered.
@@ -659,7 +693,11 @@ async function runPrdSync(opts) {
         source: "hooks",
         taskId: event.taskId,
         status: event.status,
-        summary: event.status === "done" ? `${event.taskId} passes` : `${event.taskId} in progress`,
+        summary: event.status === "done"
+            ? `${event.taskId} passes`
+            : event.status === "in_progress"
+                ? `${event.taskId} in progress`
+                : `${event.taskId} in review`,
         evidence: { ...evidenceBase, task: event.taskId },
     }));
     const poster = createEmitPoster({ token, baseUrl: resolveVaultApiBase(process.env) });
@@ -1855,6 +1893,7 @@ export function registerMeshCommand(program) {
         .description("Idempotently register a PRD on the Board and verify the view")
         .requiredOption("--company <slug|uid>", "Company slug or cloud uid")
         .requiredOption("--stories-file <path>", "PRD JSON file with userStories and metadata.repos")
+        .option("--dry-run", "Read the current Board and print computed story statuses without writing")
         .option("--json", "Print {projectId, threadId, channelId, version, stories}")
         .action((projectId, opts) => wrap(() => runProjectEnsure(projectId, opts))());
     project

package/dist/lib/mesh/live/daemon/board-refresh.js

@@ -10,6 +10,7 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import { workContextSessionsDir } from "../../../work-context/paths.js";
 import { readSessionState } from "../../../work-context/state.js";
+import { mapReaderStoryStatus } from "../../story-status.js";
 import { sessionBoardPath } from "./paths.js";
 export const BOARD_REFRESH_INTERVAL_MS = 60_000;
 function listBoundSessionIds(workContextRoot) {
@@ -147,7 +148,7 @@ function storiesFromProject(project) {
                 : typeof row.name === "string"
                     ? row.name.slice(0, 120)
                     : undefined,
-            status: typeof row.status === "string" ? row.status : undefined,
+            status: mapReaderStoryStatus(row),
         });
     }
     return stories;

package/dist/lib/mesh/project-board.js

@@ -1,4 +1,5 @@
 import { appendThreadEvent, ensureProjectThread, getProjectView, putProjectView, registerMeshProject, } from "./api.js";
+import { mapReaderStoryStatus } from "./story-status.js";
 function httpStatus(err) {
     if (err && typeof err === "object" && "status" in err && typeof err.status === "number") {
         return err.status;
@@ -19,7 +20,7 @@ export function mergeProjectStories(current, planned, opts) {
                 ...(live.assigneeUid ? { assigneeUid: live.assigneeUid } : {}),
             };
         }
-        const status = live.status || story.status;
+        const status = mapReaderStoryStatus(live) || story.status;
         return {
             ...story,
             ...(status ? { status } : {}),
@@ -30,8 +31,9 @@ export function mergeProjectStories(current, planned, opts) {
     return [...merged, ...current.filter((story) => !plannedIds.has(story.id))];
 }
 export function boardStoryStatus(story) {
-    if (story.status)
-        return story.status;
+    const status = mapReaderStoryStatus(story);
+    if (status)
+        return status;
     return story.passes === true ? "done" : "queued";
 }
 /**

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.193.1",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {