@indigoai-us/hq-cli 5.152.1 → 5.153.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [5.153.0] — 2026-09-23
+
+### Fixed
+
+- `hq mesh context prd-sync` rebinds a session to the PRD's project when that project is in the same company, then emits `task_status` against the new project so the Board and channel line land there. A PRD in another company is still skipped and does not rebind.
+
 ## [5.152.1] — 2026-09-23
 
 ### Fixed

package/dist/commands/mesh.js

@@ -44,7 +44,7 @@ import { readSessionState, updateSessionState } from "../lib/work-context/state.
 import { findLocalPrd, listNeedsProjectSessions } from "../lib/work-context/bind-best.js";
 import { bindCallingSession, formatSessionBoundLine } from "../lib/work-context/bind-calling-session.js";
 import { rebindNeedsProjectOnPrompt } from "../lib/work-context/prompt-rebind.js";
-import { planPrdSync } from "../lib/work-context/prd-sync.js";
+import { planPrdSync, rebindSessionToProject } from "../lib/work-context/prd-sync.js";
 import { reserveSessionSeq } from "../lib/mesh/live/session-seq.js";
 import { WORK_CONTEXT_CONTRACT_VERSION } from "../lib/work-context/contract.js";
 import { loadObservationFromFile, markUntracked, parseObservationJson, reconcileObservation, } from "../lib/work-context/reconcile.js";
@@ -550,6 +550,9 @@ async function runPrdSync(opts) {
         fail("Usage: hq mesh context prd-sync --session <sid> --file <prd.json>");
     const root = workContextHomeRoot();
     const plan = planPrdSync({ sessionId, file, root });
+    if (plan.rebindTo) {
+        rebindSessionToProject({ sessionId, root, projectId: plan.rebindTo });
+    }
     if (!plan.changed) {
         const payload = { ok: true, action: "context.prd-sync", changed: 0, ...(plan.skip ? { skip: plan.skip } : {}) };
         if (opts.json)
@@ -570,7 +573,9 @@ async function runPrdSync(opts) {
         return;
     }
     // Attribution evidence: without company and project the server files these
-    // as unassigned and the Board never moves.
+    // as unassigned and the Board never moves. After a same-company switch,
+    // this is the new project's id so ingest writes SESSION_STATE.projectId
+    // and bound-forward posts the channel line there.
     const bound = readSessionState(sessionId, root);
     const evidenceBase = {
         ...(bound?.companySlug ? { companySlug: bound.companySlug } : {}),

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

@@ -1,8 +1,11 @@
 /**
- * US-040: diff a bound project's prd.json and describe task_status events.
- * Planning never touches the network. The snapshot is written only after
- * the caller accepts the plan (commit), so a failed emit can retry.
+ * US-040 / F14: diff a bound project's prd.json and describe task_status events.
+ * A same-company PRD for a different project is a project switch (rebindTo).
+ * A PRD in another company is skipped. Planning never touches the network.
+ * The snapshot is written only after the caller accepts the plan (commit),
+ * so a failed emit can retry.
  */
+import { type SessionStateFile } from "./state.js";
 export interface PrdStatusEvent {
     taskId: string;
     status: "done" | "in_progress";
@@ -13,14 +16,29 @@ export interface PrdSnapshot {
         status?: string;
     }>;
     seq: number;
+    /** Project the snapshot belongs to. A switch starts a fresh story set. */
+    projectId?: string;
 }
 export declare function prdSnapshotPath(sessionId: string, root: string): string;
 export declare function readPrdSnapshot(sessionId: string, root: string): PrdSnapshot | null;
+/** `companies/<slug>/projects/<projectId>/prd.json` — nowhere else. */
+export declare function prdPathIdentity(file: string): {
+    companySlug: string;
+    projectId: string;
+} | null;
 export declare function prdBelongsToProject(file: string, projectId: string, companySlug: string | undefined): boolean;
+export declare function rebindSessionToProject(input: {
+    sessionId: string;
+    root: string;
+    projectId: string;
+    now?: () => Date;
+}): SessionStateFile | null;
 export interface PrdSyncPlan {
     changed: boolean;
     skip?: "no_state" | "not_bound" | "different_project" | "unreadable";
     events: PrdStatusEvent[];
+    /** Same-company project the session should switch to before emit. */
+    rebindTo?: string;
     /** Story most recently moved to in_progress, if any. */
     taskId?: string;
     seqStart: number;

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

@@ -1,11 +1,13 @@
 /**
- * US-040: diff a bound project's prd.json and describe task_status events.
- * Planning never touches the network. The snapshot is written only after
- * the caller accepts the plan (commit), so a failed emit can retry.
+ * US-040 / F14: diff a bound project's prd.json and describe task_status events.
+ * A same-company PRD for a different project is a project switch (rebindTo).
+ * A PRD in another company is skipped. Planning never touches the network.
+ * The snapshot is written only after the caller accepts the plan (commit),
+ * so a failed emit can retry.
  */
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { readSessionState } from "./state.js";
+import { readSessionState, updateSessionState } from "./state.js";
 export function prdSnapshotPath(sessionId, root) {
     return path.join(root, "sessions", `${sessionId}.prd-snapshot.json`);
 }
@@ -14,12 +16,33 @@ export function readPrdSnapshot(sessionId, root) {
         const parsed = JSON.parse(fs.readFileSync(prdSnapshotPath(sessionId, root), "utf8"));
         if (!parsed || typeof parsed !== "object" || !parsed.stories)
             return null;
-        return { stories: parsed.stories, seq: typeof parsed.seq === "number" ? parsed.seq : 0 };
+        return {
+            stories: parsed.stories,
+            seq: typeof parsed.seq === "number" ? parsed.seq : 0,
+            ...(typeof parsed.projectId === "string" && parsed.projectId.trim()
+                ? { projectId: parsed.projectId.trim() }
+                : {}),
+        };
     }
     catch {
         return null;
     }
 }
+/** `companies/<slug>/projects/<projectId>/prd.json` — nowhere else. */
+export function prdPathIdentity(file) {
+    const parts = path.resolve(file).split(path.sep);
+    if (parts[parts.length - 1] !== "prd.json")
+        return null;
+    const projectsAt = parts.lastIndexOf("projects");
+    if (projectsAt < 2 || parts[projectsAt - 2] !== "companies" || parts.length !== projectsAt + 3) {
+        return null;
+    }
+    const companySlug = parts[projectsAt - 1];
+    const projectId = parts[projectsAt + 1];
+    if (!companySlug || !projectId)
+        return null;
+    return { companySlug, projectId };
+}
 function writeSnapshot(sessionId, root, snapshot) {
     const dest = prdSnapshotPath(sessionId, root);
     fs.mkdirSync(path.dirname(dest), { recursive: true });
@@ -28,15 +51,29 @@ function writeSnapshot(sessionId, root, snapshot) {
 export function prdBelongsToProject(file, projectId, companySlug) {
     if (!companySlug)
         return false;
-    const parts = path.resolve(file).split(path.sep);
-    if (parts[parts.length - 1] !== "prd.json")
-        return false;
-    const projectsAt = parts.lastIndexOf("projects");
-    return (projectsAt >= 2 &&
-        parts[projectsAt - 2] === "companies" &&
-        parts[projectsAt - 1] === companySlug &&
-        parts[projectsAt + 1] === projectId &&
-        parts.length === projectsAt + 3);
+    const identity = prdPathIdentity(file);
+    return Boolean(identity &&
+        identity.companySlug.toLowerCase() === companySlug.toLowerCase() &&
+        identity.projectId === projectId);
+}
+export function rebindSessionToProject(input) {
+    const nowIso = (input.now ?? (() => new Date()))().toISOString();
+    return updateSessionState(input.sessionId, input.root, (current) => {
+        if (!current)
+            return null;
+        if (current.projectId === input.projectId)
+            return current;
+        return {
+            ...current,
+            projectId: input.projectId,
+            taskId: undefined,
+            contextStatus: current.contextStatus === "bound" || current.contextStatus === "needs_task"
+                ? "needs_task"
+                : current.contextStatus,
+            projectBindReason: `prd-sync project switch to ${input.projectId}`,
+            updatedAt: nowIso,
+        };
+    });
 }
 function storiesFromPrd(file) {
     const parsed = JSON.parse(fs.readFileSync(file, "utf8"));
@@ -79,8 +116,14 @@ export function planPrdSync(input) {
     if (!state.projectId || (state.contextStatus !== "bound" && state.contextStatus !== "needs_task")) {
         return empty("not_bound");
     }
-    if (!prdBelongsToProject(input.file, state.projectId, state.companySlug))
+    const identity = prdPathIdentity(input.file);
+    if (!identity || !state.companySlug)
+        return empty("different_project");
+    if (identity.companySlug.toLowerCase() !== state.companySlug.toLowerCase()) {
         return empty("different_project");
+    }
+    const targetProjectId = identity.projectId;
+    const rebindTo = state.projectId !== targetProjectId ? targetProjectId : undefined;
     let stories;
     try {
         stories = storiesFromPrd(input.file);
@@ -88,7 +131,9 @@ export function planPrdSync(input) {
     catch {
         return empty("unreadable");
     }
-    const previous = readPrdSnapshot(input.sessionId, input.root);
+    const previousRaw = readPrdSnapshot(input.sessionId, input.root);
+    const previousProject = previousRaw?.projectId ?? state.projectId;
+    const previous = previousProject === targetProjectId ? previousRaw : null;
     const before = previous?.stories ?? {};
     const events = [];
     let taskId;
@@ -108,10 +153,15 @@ export function planPrdSync(input) {
             taskId = story.id;
         }
     }
-    const snapshot = { stories: nextStories, seq: (previous?.seq ?? 0) + events.length };
+    const snapshot = {
+        stories: nextStories,
+        seq: (previous?.seq ?? 0) + events.length,
+        projectId: targetProjectId,
+    };
     return {
         changed: events.length > 0,
         events,
+        ...(rebindTo ? { rebindTo } : {}),
         ...(taskId ? { taskId } : {}),
         seqStart: previous?.seq ?? 0,
         commit: (acceptedTaskIds) => {
@@ -134,6 +184,7 @@ export function planPrdSync(input) {
             writeSnapshot(input.sessionId, input.root, {
                 stories,
                 seq: (previous?.seq ?? 0) + advanced,
+                projectId: targetProjectId,
             });
         },
     };

package/package.json

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