@quolu/lattice 0.12.9 → 0.12.10

package/bin/lattice.mjs

@@ -1,9 +1,12 @@
 #!/usr/bin/env node
 
+import { installPipeCloseGuard } from '../src/cli-stdio.mjs';
 import { runRuntimeCli } from '../src/runtime-cli.mjs';
 import { renderCliHelp } from '../src/cli-help.mjs';
 import packageJson from '../package.json' with { type: 'json' };
 
+installPipeCloseGuard();
+
 const args = process.argv.slice(2);
 const help = renderCliHelp(args);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quolu/lattice",
-  "version": "0.12.9",
+  "version": "0.12.10",
   "description": "Lattice — phase-aware TODO graph compiler and conflict-aware orchestration runtime",
   "type": "module",
   "license": "MIT",
@@ -54,7 +54,7 @@
     "test": "node scripts/run-product-tests.mjs",
     "test:sensor": "npm --prefix sensor test",
     "precheck": "node --check src/bridge-launch-agent.mjs",
-    "check": "node --check bin/lattice.mjs && node --check bin/lattice-mcp.mjs && node --check bin/lattice-dashboard.mjs && node --check bin/lattice-bridge.mjs && node --check src/bridge-config.mjs && node --check src/bridge-server.mjs && node --check src/bridge-daemon.mjs && node --check src/bridge-cli.mjs && node --check src/project-cli.mjs && node --check src/sensor-cli.mjs && node --check src/sensor-runtime.mjs && node --check src/sensor-adapter.mjs && node --check src/factory-diagnostics.mjs && node --check src/runtime-errors.mjs && node --check src/runtime-contracts.mjs && node --check src/runtime-event-store.mjs && node --check src/hash-chain.mjs && node --check src/dag-chain.mjs && node --check src/todo-contracts.mjs && node --check src/todo-chain.mjs && node --check src/todo-store.mjs && node --check src/todo-migration.mjs && node --check src/todo-revision.mjs && node --check src/todo-status.mjs && node --check src/todo-cli.mjs && node --check src/todo-dashboard-registry.mjs && node --check src/todo-gantt-presentation.mjs && node --check src/todo-gantt-live.mjs && node --check src/bounded-seam.mjs && node --check src/todo-narrative-anchor.mjs && node --check src/todo-markdown-renderer.mjs && node --check src/todo-gantt-svg.mjs && node --check src/todo-gantt-html.mjs && node --check src/runtime-projection.mjs && node --check src/runtime-decision-verifier.mjs && node --check src/runtime-front-end.mjs && node --check src/runtime-cli.mjs && node --check src/rc3-dogfood-scaffold.mjs && node --check src/runtime-engine.mjs && node --check src/runtime-scripted-executor.mjs && node --check src/runtime-diff-observer.mjs && node --check src/runtime-worktree-executor.mjs && node --check src/runtime-hold-recompile.mjs && node --check src/rc3-scripted-campaign.mjs && node --check src/rc3-actual-dogfood.mjs && node --check src/rc4-stage1-dogfood.mjs && node --check research/fixtures/dispatch-record/src/dispatch-record.mjs && node --check test/research-dispatch-record.test.mjs",
+    "check": "node --check bin/lattice.mjs && node --check bin/lattice-mcp.mjs && node --check bin/lattice-dashboard.mjs && node --check bin/lattice-bridge.mjs && node --check src/cli-stdio.mjs && node --check src/bridge-config.mjs && node --check src/bridge-server.mjs && node --check src/bridge-daemon.mjs && node --check src/bridge-cli.mjs && node --check src/project-cli.mjs && node --check src/sensor-cli.mjs && node --check src/sensor-runtime.mjs && node --check src/sensor-adapter.mjs && node --check src/factory-diagnostics.mjs && node --check src/runtime-errors.mjs && node --check src/runtime-contracts.mjs && node --check src/runtime-event-store.mjs && node --check src/hash-chain.mjs && node --check src/dag-chain.mjs && node --check src/todo-contracts.mjs && node --check src/todo-chain.mjs && node --check src/todo-store.mjs && node --check src/todo-migration.mjs && node --check src/todo-revision.mjs && node --check src/todo-status.mjs && node --check src/todo-cli.mjs && node --check src/todo-dashboard-registry.mjs && node --check src/todo-gantt-presentation.mjs && node --check src/todo-gantt-live.mjs && node --check src/bounded-seam.mjs && node --check src/todo-narrative-anchor.mjs && node --check src/todo-markdown-renderer.mjs && node --check src/todo-gantt-svg.mjs && node --check src/todo-gantt-html.mjs && node --check src/runtime-projection.mjs && node --check src/runtime-decision-verifier.mjs && node --check src/runtime-front-end.mjs && node --check src/runtime-cli.mjs && node --check src/rc3-dogfood-scaffold.mjs && node --check src/runtime-engine.mjs && node --check src/runtime-scripted-executor.mjs && node --check src/runtime-diff-observer.mjs && node --check src/runtime-worktree-executor.mjs && node --check src/runtime-hold-recompile.mjs && node --check src/rc3-scripted-campaign.mjs && node --check src/rc3-actual-dogfood.mjs && node --check src/rc4-stage1-dogfood.mjs && node --check research/fixtures/dispatch-record/src/dispatch-record.mjs && node --check test/research-dispatch-record.test.mjs",
     "check:project-identity": "node --check src/project-identity.mjs",
     "ci": "npm run test && npm run test:sensor && npm run check && npm run check:project-identity"
   }

package/src/cli-stdio.mjs

@@ -0,0 +1,40 @@
+/**
+ * CLI stdio guards.
+ *
+ * Reading part of a result is a legitimate use: `lattice todo status --json |
+ * head` stops the consumer as soon as it has what it wants. When that consumer
+ * exits, the next write to stdout raises EPIPE, and Node's default handling
+ * turns it into an unhandled 'error' event — the CLI dies with a stack trace
+ * and a non-zero exit, so a working pipeline reports a failure that never
+ * happened.
+ *
+ * EPIPE from a closed consumer is the POSIX contract, not a fault, so the
+ * process stops quietly. This is deliberately narrow: only EPIPE, only on the
+ * output streams. Every other stream error keeps its previous behaviour and
+ * still crashes the CLI, because those are real faults.
+ */
+
+/**
+ * @param {object} [options]
+ * @param {Array<NodeJS.WriteStream>} [options.streams] streams to guard.
+ * @param {(code: number) => void} [options.exit] process exit, injectable for tests.
+ * @returns {() => void} removes the guards again (used by tests).
+ */
+export function installPipeCloseGuard({
+  streams = [process.stdout, process.stderr],
+  exit = (code) => process.exit(code),
+} = {}) {
+  const installed = [];
+  for (const stream of streams) {
+    if (stream === undefined || stream === null || typeof stream.on !== 'function') continue;
+    const onError = (error) => {
+      if (error?.code !== 'EPIPE') throw error;
+      exit(0);
+    };
+    stream.on('error', onError);
+    installed.push(() => stream.off('error', onError));
+  }
+  return () => {
+    for (const remove of installed) remove();
+  };
+}

package/src/todo-store.mjs

@@ -1082,17 +1082,41 @@ function nextEvent(input, storeMember) {
   return event;
 }
 
+/**
+ * The digest replay binds a task's completion to.
+ *
+ * A ToDo completed inside this plan version binds to its own `done` event. A
+ * ToDo carried across a revision has no `done` event in the successor journal —
+ * its completion arrives with the `plan_genesis` state migration, and replay
+ * binds it to the genesis digest (see the carry branch in `replay`). Resolving
+ * only the first case is what made `reopen` unusable on carried work.
+ *
+ * Returns null when the task has no completion to bind to at all.
+ */
+function resolveDoneBindingDigest(storeMember, taskId) {
+  const events = storeMember.journal.events;
+  const authored = [...events].reverse().find((event) => (
+    event.kind === 'done' && event.task_id === taskId
+  ));
+  if (authored !== undefined) return authored.event_digest;
+  const genesis = events[0];
+  if (genesis?.kind !== 'plan_genesis' || !Array.isArray(genesis.state_migration)) return null;
+  const carried = genesis.state_migration.some((migration) => (
+    ['carry', 'carry_reconciled_metadata'].includes(migration.state_policy)
+    && migration.to_task_id === taskId && migration.state?.status === 'done'
+  ));
+  return carried ? genesis.event_digest : null;
+}
+
 function resolveTargetedEvent(input, storeMember) {
   if (input.kind === 'reopen' && exactRecord(input.payload, [
     'reason', 'override_reason',
   ])) {
-    const target = [...storeMember.journal.events].reverse().find((event) => (
-      event.kind === 'done' && event.task_id === input.task_id
-    ));
-    if (target === undefined) fail('STORE_INCONSISTENT', 'invalid_reopen_binding');
+    const targetDigest = resolveDoneBindingDigest(storeMember, input.task_id);
+    if (targetDigest === null) fail('STORE_INCONSISTENT', 'invalid_reopen_binding');
     return {
       ...input,
-      payload: { ...input.payload, target_done_digest: target.event_digest },
+      payload: { ...input.payload, target_done_digest: targetDigest },
     };
   }
   if (input.kind === 'done' && exactRecord(input.payload, [