@indigoai-us/hq-cli 5.144.0 → 5.146.0

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

@@ -0,0 +1,120 @@
+/**
+ * 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.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { readSessionState } from "./state.js";
+export function prdSnapshotPath(sessionId, root) {
+    return path.join(root, "sessions", `${sessionId}.prd-snapshot.json`);
+}
+export function readPrdSnapshot(sessionId, root) {
+    try {
+        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 };
+    }
+    catch {
+        return null;
+    }
+}
+function writeSnapshot(sessionId, root, snapshot) {
+    const dest = prdSnapshotPath(sessionId, root);
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.writeFileSync(dest, `${JSON.stringify(snapshot)}\n`, { mode: 0o600 });
+}
+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);
+}
+function storiesFromPrd(file) {
+    const parsed = JSON.parse(fs.readFileSync(file, "utf8"));
+    const rows = Array.isArray(parsed.userStories) ? parsed.userStories
+        : Array.isArray(parsed.stories) ? parsed.stories
+            : [];
+    const out = [];
+    for (const row of rows) {
+        if (!row || typeof row !== "object")
+            continue;
+        const id = row.id;
+        if (typeof id !== "string" || !id.trim())
+            continue;
+        const status = row.status;
+        out.push({
+            id: id.trim(),
+            passes: row.passes === true,
+            ...(typeof status === "string" && status.trim() ? { status: status.trim() } : {}),
+        });
+    }
+    return out;
+}
+export function planPrdSync(input) {
+    const empty = (skip) => ({
+        changed: false,
+        skip,
+        events: [],
+        seqStart: 0,
+        commit: () => { },
+    });
+    let state;
+    try {
+        state = readSessionState(input.sessionId, input.root);
+    }
+    catch {
+        return empty("unreadable");
+    }
+    if (!state)
+        return empty("no_state");
+    if (!state.projectId || (state.contextStatus !== "bound" && state.contextStatus !== "needs_task")) {
+        return empty("not_bound");
+    }
+    if (!prdBelongsToProject(input.file, state.projectId, state.companySlug))
+        return empty("different_project");
+    let stories;
+    try {
+        stories = storiesFromPrd(input.file);
+    }
+    catch {
+        return empty("unreadable");
+    }
+    const previous = readPrdSnapshot(input.sessionId, input.root);
+    const before = previous?.stories ?? {};
+    const events = [];
+    let taskId;
+    const nextStories = {};
+    for (const story of stories) {
+        nextStories[story.id] = {
+            passes: story.passes,
+            ...(story.status ? { status: story.status } : {}),
+        };
+        const prior = previous ? before[story.id] : undefined;
+        if (story.passes && !prior?.passes) {
+            events.push({ taskId: story.id, status: "done" });
+            continue;
+        }
+        if (story.status === "in_progress" && prior?.status !== "in_progress") {
+            events.push({ taskId: story.id, status: "in_progress" });
+            taskId = story.id;
+        }
+    }
+    const snapshot = { stories: nextStories, seq: (previous?.seq ?? 0) + events.length };
+    return {
+        changed: events.length > 0,
+        events,
+        ...(taskId ? { taskId } : {}),
+        seqStart: previous?.seq ?? 0,
+        commit: () => writeSnapshot(input.sessionId, input.root, snapshot),
+    };
+}
+//# sourceMappingURL=prd-sync.js.map

package/dist/lib/work-context/prompt-rebind.d.ts

@@ -0,0 +1,21 @@
+/**
+ * US-040: UserPromptSubmit re-runs bind-best for a session still in
+ * needs_project. Catalog reads are cached. Failures stay local.
+ */
+export type PromptRebindResult = {
+    action: "bound" | "skipped" | "unchanged";
+    projectId?: string;
+    reason: string;
+};
+export declare function rebindNeedsProjectOnPrompt(input: {
+    sessionId: string;
+    root: string;
+    hqRoot?: string;
+    cwd?: string;
+    companySlug?: string;
+    companyUid?: string;
+    env?: NodeJS.ProcessEnv;
+    nowMs?: number;
+    now?: () => Date;
+}): PromptRebindResult;
+//# sourceMappingURL=prompt-rebind.d.ts.map

package/dist/lib/work-context/prompt-rebind.js

@@ -0,0 +1,76 @@
+/**
+ * US-040: UserPromptSubmit re-runs bind-best for a session still in
+ * needs_project. Catalog reads are cached. Failures stay local.
+ */
+import { projectIdFromCwd } from "./company.js";
+import { readMetaProjectTask } from "./project.js";
+import { refineProjectBinding } from "./bind-best.js";
+import { WORK_CONTEXT_CONTRACT_VERSION } from "./contract.js";
+import { readSessionState, updateSessionState } from "./state.js";
+export function rebindNeedsProjectOnPrompt(input) {
+    let state;
+    try {
+        state = readSessionState(input.sessionId, input.root);
+    }
+    catch {
+        return { action: "skipped", reason: "state_unreadable" };
+    }
+    if (!state)
+        return { action: "skipped", reason: "no_state" };
+    if (state.contextStatus !== "needs_project") {
+        return { action: "skipped", reason: "not_needs_project" };
+    }
+    if (state.projectId)
+        return { action: "skipped", reason: "different_project" };
+    const env = input.env ?? process.env;
+    const hint = state.projectHint?.trim() ||
+        env.HQ_SPAWN_PROJECT?.trim() ||
+        readMetaProjectTask(input.sessionId, input.hqRoot).projectId ||
+        projectIdFromCwd(input.cwd, input.hqRoot) ||
+        undefined;
+    if (!hint)
+        return { action: "unchanged", reason: "no_hint" };
+    let refined;
+    try {
+        refined = refineProjectBinding({
+            hint,
+            hqRoot: input.hqRoot,
+            companySlug: input.companySlug ?? state.companySlug,
+            companyUid: input.companyUid ?? state.companyUid,
+            repoPath: input.cwd,
+            env,
+            nowMs: input.nowMs ?? Date.now(),
+        });
+    }
+    catch (err) {
+        return { action: "unchanged", reason: err instanceof Error ? err.message : "bind_failed" };
+    }
+    if (refined.action !== "bind" && refined.action !== "create") {
+        return { action: "unchanged", reason: refined.action === "ask" ? refined.reason : "no_match" };
+    }
+    const projectId = refined.projectId;
+    const reason = refined.reason;
+    const nowIso = (input.now ?? (() => new Date()))().toISOString();
+    const updated = updateSessionState(input.sessionId, input.root, (current) => {
+        if (!current || current.contextStatus !== "needs_project")
+            return current;
+        if (current.projectId && current.projectId !== projectId)
+            return current;
+        return {
+            ...current,
+            contractVersion: WORK_CONTEXT_CONTRACT_VERSION,
+            contextStatus: current.taskId ? "bound" : "needs_task",
+            projectId,
+            projectGate: undefined,
+            projectCandidates: undefined,
+            projectHint: undefined,
+            projectBindReason: reason,
+            updatedAt: nowIso,
+        };
+    });
+    if (!updated || updated.projectId !== projectId) {
+        return { action: "skipped", reason: "not_applied" };
+    }
+    return { action: "bound", projectId, reason };
+}
+//# sourceMappingURL=prompt-rebind.js.map

package/dist/lib/work-context/reconcile.d.ts

@@ -39,6 +39,8 @@ export interface ReconcileObservation {
     source?: "hooks" | "transcript";
     /** Optional turn signal for the 10-minute ask threshold (US-007B). */
     hasTurn?: boolean;
+    /** Hook name when the caller is a prompt submit. Session start omits this. */
+    hookEvent?: string;
     toolWrites?: number;
     /** Prohibited content may appear on the wire-in observation; must be stripped. */
     prompt?: unknown;

package/dist/lib/work-context/reconcile.js

@@ -10,6 +10,7 @@ import { WORK_CONTEXT_CONTRACT_VERSION, normalizeTaskId, } from "./contract.js";
 import { EXIT_INVALID_IDENTITY, EXIT_NOT_TRACKING, EXIT_OK, InvalidDecisionOriginError, NotTrackingError, } from "./errors.js";
 import { decisionFromCandidates, } from "./organize.js";
 import { refineProjectBinding } from "./bind-best.js";
+import { rebindNeedsProjectOnPrompt } from "./prompt-rebind.js";
 import { resolveProjectTask, shouldAskAfter } from "./project.js";
 import { deriveRemoteOwnerSlug, deriveRepoIdentityKey } from "./repo-remote.js";
 import { enqueueOutbox, listOutboxOperations, markOutboxAcked, markOutboxQuarantined, markOutboxQueued, replayOutbox, writeAckedRegisterState, } from "./outbox.js";
@@ -509,6 +510,35 @@ export async function reconcileObservation(obs, deps) {
             diagnostics.push(`project ask: ${refined.reason}`);
         }
     }
+    const promptSubmit = obs.hookEvent === "UserPromptSubmit" || obs.hookEvent === "user_prompt_submit";
+    if (promptSubmit && prior?.contextStatus === "needs_project" && !projectId && prior.companyUid) {
+        try {
+            const rebound = rebindNeedsProjectOnPrompt({
+                sessionId,
+                root: deps.root,
+                hqRoot,
+                cwd,
+                companySlug: resolvedCompany.slug ?? prior.companySlug,
+                companyUid: resolvedCompany.uid ?? prior.companyUid,
+                env,
+                nowMs: nowFn().getTime(),
+                now: nowFn,
+            });
+            if (rebound.action === "bound" && rebound.projectId) {
+                projectId = rebound.projectId;
+                projectBindReason = rebound.reason;
+                projectCandidates = undefined;
+                projectGate = undefined;
+                diagnostics.push(`prompt rebind: ${rebound.reason}`);
+            }
+        }
+        catch (err) {
+            diagnostics.push(`prompt rebind failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    const projectHint = !projectId
+        ? (prior?.projectHint || projectResolved?.projectId)
+        : undefined;
     const bindResultFields = {
         ...(projectBindReason ? { projectBindReason } : {}),
         ...(projectCandidates ? { projectCandidates } : {}),
@@ -516,6 +546,7 @@ export async function reconcileObservation(obs, deps) {
     const bindStateFields = {
         ...bindResultFields,
         ...(projectGate ? { projectGate } : {}),
+        ...(projectHint ? { projectHint } : {}),
     };
     // Trusted / deterministic auto-bind never asks.
     // Transcript-sourced sessions never ask (US-018).

package/dist/lib/work-context/state.d.ts

@@ -104,6 +104,8 @@ export interface SessionStateFile {
      * `choose` — the match was unclear. `missing_board` — the server 404'd the project.
      */
     projectGate?: "choose" | "missing_board";
+    /** Slug the session was trying to bind. Re-checked on the next prompt. */
+    projectHint?: string;
     updatedAt: string;
 }
 /**

package/dist/lib/work-context/state.js

@@ -32,6 +32,7 @@ export const SESSION_STATE_ALLOWLIST = new Set([
     "projectBindReason",
     "projectCandidates",
     "projectGate",
+    "projectHint",
     "updatedAt",
 ]);
 const SESSION_STATE_LOCK_TIMEOUT_MS = 5_000;
@@ -237,6 +238,8 @@ export function projectSessionState(state) {
         out.projectCandidates = state.projectCandidates;
     if (state.projectGate)
         out.projectGate = state.projectGate;
+    if (state.projectHint && !state.projectId)
+        out.projectHint = state.projectHint;
     return out;
 }
 /**
@@ -295,6 +298,11 @@ export function mergeLocalSessionFields(next, prior, options = {}) {
     if (!out.companyConfidence && prior.companyConfidence && sameCompanyBinding) {
         out.companyConfidence = prior.companyConfidence;
     }
+    if (!out.projectId && !out.projectHint && prior.projectHint) {
+        out.projectHint = prior.projectHint;
+    }
+    if (out.projectId)
+        out.projectHint = undefined;
     const sameBinding = prior.companyUid === out.companyUid &&
         prior.companySlug === out.companySlug &&
         prior.projectId === out.projectId &&

package/package.json

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