@indigoai-us/hq-cli 5.244.0 → 5.245.0

package/CHANGELOG.md

@@ -2,8 +2,31 @@
 
 ## [Unreleased]
 
+## [5.245.0] — 2026-09-27
+
+### Fixed
+
+- Work Mesh sessions registered without a bound project (unresolved,
+  needs_project, needs_task) no longer store the register receipt as their
+  binding episode, and `hq mesh context bind-project` clears it. The server
+  dropped every session-event batch carrying that id, so turn and session ends
+  never landed and no work report posted. Existing state files are repaired on
+  the next flush.
+
 ## [5.244.0] — 2026-09-27
 
+### Fixed
+
+- A bot whose agent home is on a network share can now mint a token. The
+  refresh lock was a POSIX hard-link lock, and CIFS/SMB shares — Azure Files
+  again — do not implement `link()` at all, so every mint failed with
+  ENOTSUP and took the whole probe down with it: no heartbeat ever posted
+  and the inbox poller retried and failed every 15 seconds. The lock now
+  falls back to an exclusive create, which gives the same guarantee and
+  works there. Contention still surfaces as EEXIST on both paths, so
+  stale-owner reclamation is unchanged, and a link that fails for any other
+  reason is still a real error.
+
 ### Changed
 
 - The setup bot no longer posts "This one takes a minute. I'll reply here as
@@ -1643,16 +1666,6 @@
 
 ### Fixed
 
-- A bot whose agent home is on a network share can now mint a token. The
-  refresh lock was a POSIX hard-link lock, and CIFS/SMB shares — Azure Files
-  again — do not implement `link()` at all, so every mint failed with
-  ENOTSUP and took the whole probe down with it: no heartbeat ever posted
-  and the inbox poller retried and failed every 15 seconds. The lock now
-  falls back to an exclusive create, which gives the same guarantee and
-  works there. Contention still surfaces as EEXIST on both paths, so
-  stale-owner reclamation is unchanged, and a link that fails for any other
-  reason is still a real error.
-
 - `hq mesh daemon install` and `hq mesh daemon run` unload and remove the
   legacy `ai.getindigo.hq-work-mesh-listen` unit (LaunchAgent, systemd user
   unit, or Scheduled Task) so only the daemon subscribes. The daemon writes

package/dist/commands/mesh.js

@@ -42,13 +42,12 @@ import { defaultRunCommand } from "../lib/service-manager/launchd.js";
 import { workContextRoot } from "../lib/work-context/paths.js";
 import { formatMigrateConfirmation, submitSessionMigration, } from "../lib/work-context/migrate.js";
 import { formatOrganizeList, prepareOrganizeDecision, settleOrganizeAskWithoutBind, submitOrganizeDecision, } from "../lib/work-context/organize.js";
-import { readSessionState, updateSessionState } from "../lib/work-context/state.js";
+import { applyOperatorProjectBinding, readSessionState, updateSessionState, } from "../lib/work-context/state.js";
 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, 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";
 import { resolveCompany } from "../lib/work-context/company.js";
 import { deriveRemoteOwnerSlug, deriveRepoIdentityKey, } from "../lib/work-context/repo-remote.js";
@@ -835,20 +834,7 @@ async function runBindProject(target, opts) {
             fail(`No candidate ${projectId} on session ${sessionId}.`);
         projectId = chosen.projectId;
     }
-    const updated = updateSessionState(sessionId, root, (state) => {
-        if (!state)
-            return null;
-        return {
-            ...state,
-            contractVersion: WORK_CONTEXT_CONTRACT_VERSION,
-            contextStatus: state.taskId ? "bound" : "needs_task",
-            projectId,
-            projectGate: undefined,
-            projectCandidates: undefined,
-            projectBindReason: `operator selected ${projectId}`,
-            updatedAt: new Date().toISOString(),
-        };
-    });
+    const updated = updateSessionState(sessionId, root, (state) => state ? applyOperatorProjectBinding(state, projectId) : null);
     if (!updated)
         fail(`No work-context state for session ${sessionId}.`);
     if (opts.json) {

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