@teamscala/service-boot 0.23.291 → 0.23.292

package/package.json

@@ -6,7 +6,7 @@
   },
   "name": "@teamscala/service-boot",
   "type": "module",
-  "version": "0.23.291",
+  "version": "0.23.292",
   "sideEffects": false,
   "files": [
     "src"

package/src/fn-routers/task-sync-router.ts

@@ -501,10 +501,31 @@ async function reconcileTaskList(
 	laneSession: string,
 	list: TaskListItem[],
 	source?: string,
+	pane?: string | null,
 ): Promise<{ task_id: string; created: number; updated: number; deleted: number; total: number }> {
-	const task = await resolveLaneTask(prisma, laneSession);
+	// BIND ON DEMAND — this path used to `resolveLaneTask` and THROW, which is the
+	// exact failure `ensureLaneTask` was written to make impossible (see its
+	// comment above, and the operator ruling it cites: "ALL lanes can comply,
+	// there is no reason why a tab cant comply"). The backstop existed and this
+	// caller did not use it, so a lane whose SessionStart bindLane never ran — or
+	// ran while the endpoint was failing — could never sync a task list again.
+	// Not degraded: permanently, with a 404 on every attempt and no path to
+	// self-recover.
+	//
+	// Measured 2026-07-30: a live lane reported ~9 consecutive failures over
+	// hours and correctly diagnosed its own lane-compliance flag as a false
+	// positive it was structurally unable to clear. The gate was telling it to
+	// keep a task list while the only endpoint that records one refused it.
+	//
+	// A lane calling this HAS everything the bind needs — its session, its pane,
+	// its list — so requiring a prior call is a sequencing demand with no
+	// informational content. `friction-is-a-stop-condition`: the compliant path
+	// must exist, or the rule is unenforceable against the lane it binds.
+	const task = await ensureLaneTask(prisma, laneSession, pane ?? null);
 	if (!task) {
-		throw new Error(`No task bound to session ${laneSession}. Call taskSync.bindLane first (SessionStart adapter).`);
+		throw new Error(
+			`Could not bind a task for session ${laneSession} — the create failed and no existing task was found.`,
+		);
 	}
 	const existing = await prisma.work_items.findMany({
 		where: { parent_id: task.id, kind: "subtask" },
@@ -701,8 +722,13 @@ export const taskSyncRouter = {
 			const { ORPCError } = await import("@orpc/server");
 			throw new ORPCError("BAD_REQUEST", { message: "upsertFromTaskList requires lane_session" });
 		}
+		// The pane rides in the header the callers already send (`x-lane-pane`),
+		// and it is what lets the on-demand bind link the new task to the lane's
+		// run. Absent, the bind still succeeds — it just cannot link the run — so
+		// this is passed opportunistically rather than required.
+		const headerPane = (context as Context).headers?.get("x-lane-pane") ?? null;
 		try {
-			const res = await reconcileTaskList(prisma, session, list, body.source);
+			const res = await reconcileTaskList(prisma, session, list, body.source, headerPane);
 			log.info("[task-sync] upsertFromTaskList reconciled", { session, ...res });
 			return res;
 		} catch (err) {