@indigoai-us/hq-cli 5.121.2 → 5.122.1

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

@@ -91,6 +91,20 @@ export interface SessionStateFile {
     transcriptMarker?: "from transcript";
     updatedAt: string;
 }
+/**
+ * Metadata from a register operation that the control plane has acknowledged.
+ * Kept structural here so the state projection does not need a runtime
+ * dependency on the outbox implementation.
+ */
+export interface AcknowledgedRegisterBinding {
+    kind: "register";
+    sessionId: string;
+    companyUid?: string;
+    companySlug?: string;
+    projectId?: string;
+    taskId?: string;
+    receiptId: string;
+}
 /** Allowlisted keys that may appear in the durable state projection. */
 export declare const SESSION_STATE_ALLOWLIST: Set<string>;
 export declare function readSessionState(sessionId: string, root: string): SessionStateFile | null;
@@ -102,6 +116,15 @@ export declare function projectSessionState(state: SessionStateFile): SessionSta
  * and reconcile updates do not clobber each other.
  */
 export declare function mergeLocalSessionFields(next: SessionStateFile, prior: SessionStateFile | null): SessionStateFile;
+/**
+ * Upgrade the local projection after the server acknowledges a register.
+ *
+ * A receipt makes the operation's company authoritative, but it must never
+ * erase an explicit untracked choice, a conflicting existing company, or a
+ * more specific binding for the same company. This is also used to repair
+ * state files created by older clients before this write-back existed.
+ */
+export declare function writeAcknowledgedRegisterBinding(binding: AcknowledgedRegisterBinding, root: string, now?: () => Date): SessionStateFile | null;
 /** True when a durable state file was written by the hook / reconcile path. */
 export declare function isHookWrittenSessionState(state: SessionStateFile | null): boolean;
 /** Authoritative prior scope usable for company precedence. */

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

@@ -136,6 +136,73 @@ export function mergeLocalSessionFields(next, prior) {
     }
     return out;
 }
+function acknowledgedStatus(binding) {
+    if (!binding.companyUid)
+        return null;
+    if (binding.projectId && binding.taskId)
+        return "bound";
+    if (binding.projectId)
+        return "needs_task";
+    return "needs_project";
+}
+function bindingStrength(state) {
+    if (state.contextStatus === "bound" && state.projectId && state.taskId)
+        return 3;
+    if (state.contextStatus === "needs_task" && state.projectId)
+        return 2;
+    if (state.contextStatus === "needs_project")
+        return 1;
+    return 0;
+}
+/**
+ * Upgrade the local projection after the server acknowledges a register.
+ *
+ * A receipt makes the operation's company authoritative, but it must never
+ * erase an explicit untracked choice, a conflicting existing company, or a
+ * more specific binding for the same company. This is also used to repair
+ * state files created by older clients before this write-back existed.
+ */
+export function writeAcknowledgedRegisterBinding(binding, root, now = () => new Date()) {
+    const acknowledged = acknowledgedStatus(binding);
+    if (!acknowledged || !isSafeWorkContextSegment(binding.sessionId))
+        return null;
+    const prior = readSessionState(binding.sessionId, root);
+    // Reconcile always writes the local projection before network delivery. Do
+    // not manufacture session files when replay sees an orphaned legacy outbox
+    // record with no corresponding tracked session.
+    if (!prior)
+        return null;
+    if (prior.contextStatus === "untracked" ||
+        (prior.companyUid && prior.companyUid !== binding.companyUid)) {
+        return prior;
+    }
+    const acknowledgementStrength = acknowledged === "bound" ? 3 : acknowledged === "needs_task" ? 2 : 1;
+    const priorStrength = bindingStrength(prior);
+    const preservePriorBinding = Boolean(prior.companyUid === binding.companyUid && priorStrength > acknowledgementStrength);
+    const next = mergeLocalSessionFields({
+        contractVersion: WORK_CONTEXT_CONTRACT_VERSION,
+        sessionId: binding.sessionId,
+        companyUid: binding.companyUid,
+        companySlug: binding.companySlug ?? prior.companySlug,
+        contextStatus: preservePriorBinding ? prior.contextStatus : acknowledged,
+        projectId: preservePriorBinding ? prior.projectId : binding.projectId,
+        taskId: preservePriorBinding ? prior.taskId : binding.taskId,
+        bindingEpisodeId: preservePriorBinding
+            ? prior.bindingEpisodeId ?? binding.receiptId
+            : binding.receiptId,
+        updatedAt: now().toISOString(),
+    }, prior);
+    if (prior.companyUid === next.companyUid &&
+        prior.companySlug === next.companySlug &&
+        prior.contextStatus === next.contextStatus &&
+        prior.projectId === next.projectId &&
+        prior.taskId === next.taskId &&
+        prior.bindingEpisodeId === next.bindingEpisodeId) {
+        return prior;
+    }
+    writeSessionState(next, root);
+    return next;
+}
 /** True when a durable state file was written by the hook / reconcile path. */
 export function isHookWrittenSessionState(state) {
     if (!state)

package/package.json

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