@indigoai-us/hq-cli 5.244.0 → 5.246.0

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

@@ -690,32 +690,46 @@ export async function reconcileObservation(obs, deps) {
         registerClassification = "needs_project";
         diagnostics.push(`company rebind to ${resolvedCompany.slug ?? resolvedCompany.uid}; cleared project`);
     }
+    // Acked register operations for this session. A register that did not come
+    // back bound yields no binding episode, so its receipt (not the session's
+    // bindingEpisodeId) is what identifies an already acknowledged binding.
+    const ackedRegisters = prior
+        ? listOutboxOperations(deps.root).filter((operation) => operation.kind === "register" &&
+            operation.delivery === "acked" &&
+            operation.sessionId === sessionId &&
+            Boolean(operation.receiptId))
+        : [];
     const stateClassification = registerClassification === "unresolved" &&
         prior?.contextStatus === "needs_project" &&
         prior.companyUid === resolvedCompany.uid &&
-        prior.bindingEpisodeId
+        (prior.bindingEpisodeId ||
+            ackedRegisters.some((operation) => operation.companyUid === resolvedCompany.uid))
         ? "needs_project"
         : registerClassification;
     // Re-observing an already acknowledged binding is normal for hooks and the
     // resident daemon. A fresh clientOperationId must not turn that observation
     // into a second semantic register operation: the prior receipt is the stable
     // identity for this exact company/project/task binding.
-    const acknowledgedPrior = prior?.bindingEpisodeId &&
+    const priorBindingIsBound = Boolean(projectId && taskId);
+    const acknowledgedReceipt = prior &&
         prior.companyUid === resolvedCompany.uid &&
         prior.companySlug === resolvedCompany.slug &&
         prior.projectId === projectId &&
-        prior.taskId === taskId &&
-        listOutboxOperations(deps.root).some((operation) => operation.kind === "register" &&
-            operation.delivery === "acked" &&
-            operation.sessionId === sessionId &&
-            operation.receiptId === prior.bindingEpisodeId &&
+        prior.taskId === taskId
+        ? ackedRegisters.find((operation) => (priorBindingIsBound
+            ? operation.receiptId === prior.bindingEpisodeId
+            : !prior.bindingEpisodeId || operation.receiptId === prior.bindingEpisodeId) &&
             operation.companyUid === resolvedCompany.uid &&
             operation.companySlug === resolvedCompany.slug &&
             operation.projectId === projectId &&
-            operation.taskId === taskId)
-        ? prior
-        : null;
+            operation.taskId === taskId)?.receiptId
+        : undefined;
+    const acknowledgedPrior = acknowledgedReceipt ? prior : null;
     if (acknowledgedPrior) {
+        // A partial (not bound) acknowledged register carries no server episode.
+        const retainedEpisodeId = priorBindingIsBound
+            ? acknowledgedPrior.bindingEpisodeId
+            : undefined;
         // Activity is local progress, not binding identity. Retain the receipt
         // without another register while carrying hook counters forward so the
         // normal clarification threshold still advances.
@@ -727,7 +741,7 @@ export async function reconcileObservation(obs, deps) {
             contextStatus: stateClassification,
             projectId,
             taskId,
-            bindingEpisodeId: acknowledgedPrior.bindingEpisodeId,
+            bindingEpisodeId: retainedEpisodeId,
             updatedAt: nowIso,
             startedAt,
             ...(typeof toolWrites === "number" ? { toolWrites } : {}),
@@ -735,7 +749,7 @@ export async function reconcileObservation(obs, deps) {
             ...(decision ? { decision } : {}),
             ...bindStateFields,
             ...transcriptFields,
-        }, prior), deps.root);
+        }, prior, { preserveBindingEpisode: priorBindingIsBound }), deps.root);
         const kind = registerClassification === "bound"
             ? "bound"
             : registerClassification === "needs_task"
@@ -743,7 +757,7 @@ export async function reconcileObservation(obs, deps) {
                 : registerClassification === "needs_project"
                     ? "needs_project"
                     : "queued";
-        diagnostics.push(`binding unchanged; retained receipt=${acknowledgedPrior.bindingEpisodeId}`);
+        diagnostics.push(`binding unchanged; retained receipt=${acknowledgedReceipt}`);
         return {
             result: resultOf({
                 kind,
@@ -755,7 +769,7 @@ export async function reconcileObservation(obs, deps) {
                 companySlug: resolvedCompany.slug,
                 projectId,
                 taskId,
-                bindingEpisodeId: acknowledgedPrior.bindingEpisodeId,
+                ...(retainedEpisodeId ? { bindingEpisodeId: retainedEpisodeId } : {}),
                 ...bindResultFields,
             }),
             exitCode: EXIT_OK,

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

@@ -174,4 +174,12 @@ export declare function authoritativeCompanyFromState(state: SessionStateFile |
     slug?: string;
     uid?: string;
 } | null;
+/**
+ * Apply `hq mesh context bind-project`: an operator's local project choice.
+ *
+ * The server issues no binding episode for this local choice, so any prior
+ * bindingEpisodeId (older clients stored a register receipt there) is cleared.
+ * Carrying it forward makes the server drop every later session-event batch.
+ */
+export declare function applyOperatorProjectBinding(state: SessionStateFile, projectId: string, now?: () => Date): SessionStateFile;
 //# sourceMappingURL=state.d.ts.map

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

@@ -367,6 +367,19 @@ export function writeAcknowledgedRegisterBinding(binding, root, now = () => new
     const acknowledgementStrength = acknowledged === "bound" ? 3 : acknowledged === "needs_task" ? 2 : 1;
     const priorStrength = bindingStrength(prior);
     const preservePriorBinding = Boolean(prior.companyUid === binding.companyUid && priorStrength > acknowledgementStrength);
+    // The server issues no binding episode for a register that did not come
+    // back bound (unresolved / needs_project / needs_task). Its receipt must
+    // never stand in for one: session-event batches carry bindingEpisodeId and
+    // the server drops batches whose episode it does not recognise. Older
+    // clients stored that receipt here, so also repair a prior value that is
+    // exactly this partial register's receipt.
+    const receiptEpisode = acknowledged === "bound" ? binding.receiptId : undefined;
+    const priorEpisode = acknowledged !== "bound" && prior.bindingEpisodeId === binding.receiptId
+        ? undefined
+        : prior.bindingEpisodeId;
+    const sameBindingAsPrior = prior.companyUid === binding.companyUid &&
+        prior.projectId === binding.projectId &&
+        prior.taskId === binding.taskId;
     const next = mergeLocalSessionFields({
         contractVersion: WORK_CONTEXT_CONTRACT_VERSION,
         sessionId: binding.sessionId,
@@ -376,10 +389,10 @@ export function writeAcknowledgedRegisterBinding(binding, root, now = () => new
         projectId: preservePriorBinding ? prior.projectId : binding.projectId,
         taskId: preservePriorBinding ? prior.taskId : binding.taskId,
         bindingEpisodeId: preservePriorBinding
-            ? prior.bindingEpisodeId ?? binding.receiptId
-            : binding.receiptId,
+            ? priorEpisode ?? receiptEpisode
+            : receiptEpisode ?? (sameBindingAsPrior ? priorEpisode : undefined),
         updatedAt: now().toISOString(),
-    }, prior);
+    }, prior, { preserveBindingEpisode: false });
     if (prior.companyUid === next.companyUid &&
         prior.companySlug === next.companySlug &&
         prior.contextStatus === next.contextStatus &&
@@ -418,4 +431,24 @@ export function authoritativeCompanyFromState(state) {
         return null;
     return { slug: state.companySlug, uid: state.companyUid };
 }
+/**
+ * Apply `hq mesh context bind-project`: an operator's local project choice.
+ *
+ * The server issues no binding episode for this local choice, so any prior
+ * bindingEpisodeId (older clients stored a register receipt there) is cleared.
+ * Carrying it forward makes the server drop every later session-event batch.
+ */
+export function applyOperatorProjectBinding(state, projectId, now = () => new Date()) {
+    return {
+        ...state,
+        contractVersion: WORK_CONTEXT_CONTRACT_VERSION,
+        contextStatus: state.taskId ? "bound" : "needs_task",
+        projectId,
+        bindingEpisodeId: undefined,
+        projectGate: undefined,
+        projectCandidates: undefined,
+        projectBindReason: `operator selected ${projectId}`,
+        updatedAt: now().toISOString(),
+    };
+}
 //# sourceMappingURL=state.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.244.0",
+  "version": "5.246.0",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {
@@ -44,7 +44,7 @@
   "dependencies": {
     "@aws-sdk/client-iot-data-plane": "^3.1096.0",
     "@aws-sdk/client-s3": "^3.1049.0",
-    "@indigoai-us/hq-cloud": "~6.18.5",
+    "@indigoai-us/hq-cloud": "~6.18.10",
     "@indigoai-us/hq-flags-client": "^0.1.2",
     "@sentry/node": "^10.49.0",
     "@tobilu/qmd": "2.5.3",