@quolu/lattice 0.59.1 → 0.60.1

package/bin/lattice.mjs

@@ -2,22 +2,21 @@
 
 import { fileURLToPath } from 'node:url';
 import { installPipeCloseGuard } from '../src/cli-stdio.mjs';
-import { runRuntimeCli } from '../src/runtime-cli.mjs';
 import { renderCliHelp } from '../src/cli-help.mjs';
-import { relaunchSensorForNode22IfNeeded } from '../src/sensor-node-runtime.mjs';
+import { relaunchForNode22IfNeeded } from '../src/sensor-node-runtime.mjs';
 import packageJson from '../package.json' with { type: 'json' };
 
 installPipeCloseGuard();
 
 const args = process.argv.slice(2);
-const sensorRelaunchStatus = relaunchSensorForNode22IfNeeded({
+const node22RelaunchStatus = relaunchForNode22IfNeeded({
   args,
   scriptPath: fileURLToPath(import.meta.url),
 });
 const help = renderCliHelp(args);
 
-if (sensorRelaunchStatus !== null) {
-  process.exitCode = sensorRelaunchStatus;
+if (node22RelaunchStatus !== null) {
+  process.exitCode = node22RelaunchStatus;
 } else if (help !== null) {
   process.stdout.write(help);
 } else if (args.length === 1 && args[0] === '--version') {
@@ -125,6 +124,7 @@ if (sensorRelaunchStatus !== null) {
   });
 } else {
   try {
+    const { runRuntimeCli } = await import('../src/runtime-cli.mjs');
     process.exitCode = await runRuntimeCli({
       argv: args,
       cwd: process.cwd(),

package/docs/schemas/lattice.todo_extraction.v3.schema.json

@@ -22,7 +22,11 @@
       "type": "array", "maxItems": 2048,
       "items": {
         "type": "object", "additionalProperties": false, "required": ["from", "to"],
-        "properties": { "from": { "$ref": "#/$defs/nodeRef" }, "to": { "$ref": "#/$defs/nodeRef" } }
+        "properties": {
+          "from": { "$ref": "#/$defs/nodeRef" },
+          "to": { "$ref": "#/$defs/nodeRef" },
+          "reason": { "$ref": "#/$defs/text" }
+        }
       }
     },
     "joins": {

package/docs/schemas/lattice.todo_extraction.v4.schema.json

@@ -0,0 +1,161 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/kitepon-rgb/Lattice/blob/main/docs/schemas/lattice.todo_extraction.v4.schema.json",
+  "title": "lattice.todo_extraction.v4",
+  "description": "AI-authored ToDo migration artifact. Every task carries a non-blank Markdown design_memo. After the complete plan is written, run `lattice plan scope-review` and confirm that every registered task preserves an owner-supplied work specification without adding a product purpose. If no plan exists, write NO_PLAN explicitly. Runtime validation accepts at most one explicit, reasoned cross-plan dependency; an empty tasks array is reserved for that one dependency between existing tasks, with the top-level plan identity naming the source plan and both endpoint topology digests.",
+  "$comment": "あなたがこのToDoに対して、何も考えていないならば、設計メモに `NO_PLAN` と書いてください。Runtime validation also enforces UTF-8 byte bounds, exact keys, strict sort order, referential integrity, disposition consistency, the cross-plan dependency limit, and the canonical self-digest.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema", "project_id", "plan_key", "plan_version", "actor", "recorded_at",
+    "tasks", "hard_dependencies", "joins", "extraction_digest"
+  ],
+  "properties": {
+    "schema": { "const": "lattice.todo_extraction.v4" },
+    "project_id": { "$ref": "#/$defs/identifier" },
+    "plan_key": { "$ref": "#/$defs/identifier" },
+    "plan_version": { "$ref": "#/$defs/identifier" },
+    "actor": { "$ref": "#/$defs/actor" },
+    "recorded_at": { "$ref": "#/$defs/strictTimestamp" },
+    "tasks": { "type": "array", "minItems": 0, "maxItems": 512, "items": { "$ref": "#/$defs/task" } },
+    "hard_dependencies": {
+      "type": "array", "maxItems": 2048,
+      "items": {
+        "type": "object", "additionalProperties": false, "required": ["from", "to"],
+        "properties": {
+          "from": { "$ref": "#/$defs/nodeRef" },
+          "to": { "$ref": "#/$defs/nodeRef" },
+          "reason": { "$ref": "#/$defs/text" }
+        }
+      }
+    },
+    "joins": {
+      "type": "array", "maxItems": 128,
+      "items": {
+        "type": "object", "additionalProperties": false, "required": ["id", "after", "before"],
+        "properties": {
+          "id": { "$ref": "#/$defs/identifier" },
+          "after": { "type": "array", "minItems": 1, "maxItems": 512, "items": { "$ref": "#/$defs/nodeRef" } },
+          "before": { "$ref": "#/$defs/nodeRef" }
+        }
+      }
+    },
+    "extraction_digest": { "$ref": "#/$defs/digest" }
+  },
+  "allOf": [
+    {
+      "if": { "properties": { "tasks": { "maxItems": 0 } }, "required": ["tasks"] },
+      "then": {
+        "properties": {
+          "hard_dependencies": { "minItems": 1, "maxItems": 1 },
+          "joins": { "maxItems": 0 }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "identifier": { "type": "string", "pattern": "^[0-9A-Za-z](?:[0-9A-Za-z._-]{0,127})$" },
+    "digest": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "repoRef": {
+      "type": "string", "minLength": 1, "maxLength": 1024,
+      "pattern": "^(?!/)(?!.*(?:^|/)\\.{1,2}(?:/|$))(?!.*\\\\)(?!.*[\\u0000-\\u001f\\u007f])[^/]+(?:/[^/]+)*$"
+    },
+    "text": { "type": "string", "minLength": 1, "maxLength": 16384 },
+    "designMemo": {
+      "type": "string", "minLength": 1, "maxLength": 16384, "pattern": "\\S",
+      "description": "Markdown design memo. Use the literal NO_PLAN only when no plan exists."
+    },
+    "nullableText": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/text" }] },
+    "strictTimestamp": {
+      "type": "string",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\\.[0-9]{3}Z$"
+    },
+    "actor": {
+      "type": "object", "additionalProperties": false, "required": ["host", "session", "agent"],
+      "properties": {
+        "host": { "$ref": "#/$defs/identifier" },
+        "session": { "$ref": "#/$defs/identifier" },
+        "agent": { "$ref": "#/$defs/identifier" }
+      }
+    },
+    "nodeRef": {
+      "type": "object", "additionalProperties": false, "required": ["project_id", "plan_key", "task_id"],
+      "properties": {
+        "project_id": { "$ref": "#/$defs/identifier" },
+        "plan_key": { "$ref": "#/$defs/identifier" },
+        "task_id": { "$ref": "#/$defs/identifier" },
+        "expected_topology_digest": { "$ref": "#/$defs/digest" }
+      }
+    },
+    "sourceLocation": {
+      "type": "object", "additionalProperties": false,
+      "required": ["origin_plan_ref", "origin_line", "source_commit", "heading_path", "markdown_depth", "parent_task_id", "checkbox_state"],
+      "properties": {
+        "origin_plan_ref": { "$ref": "#/$defs/repoRef" },
+        "origin_line": { "type": "integer", "minimum": 1 },
+        "source_commit": { "type": "string", "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$" },
+        "heading_path": { "type": "array", "maxItems": 32, "items": { "type": "string", "minLength": 1, "maxLength": 1024 } },
+        "markdown_depth": { "type": "integer", "minimum": 0, "maximum": 64 },
+        "parent_task_id": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/identifier" }] },
+        "checkbox_state": { "enum": ["checked", "unchecked", "absent", "ambiguous"] }
+      }
+    },
+    "migrationContext": {
+      "type": "object", "additionalProperties": false,
+      "required": ["external_canonical_ref", "carry_over_ref", "h_required", "condition", "evidence_refs", "notes"],
+      "properties": {
+        "external_canonical_ref": { "$ref": "#/$defs/nullableText" },
+        "carry_over_ref": { "$ref": "#/$defs/nullableText" },
+        "h_required": { "type": "boolean" },
+        "condition": { "$ref": "#/$defs/nullableText" },
+        "evidence_refs": { "type": "array", "maxItems": 64, "items": { "type": "string", "minLength": 1, "maxLength": 4096 } },
+        "notes": { "type": "array", "maxItems": 64, "items": { "type": "string", "minLength": 1, "maxLength": 4096 } }
+      }
+    },
+    "historicalStart": {
+      "type": "object", "additionalProperties": false, "required": ["start_mode", "status", "started_at"],
+      "properties": {
+        "start_mode": { "const": "historical_import" }, "status": { "const": "in-progress" },
+        "started_at": { "oneOf": [{ "const": "unknown_requires_evidence" }, { "$ref": "#/$defs/strictTimestamp" }] }
+      }
+    },
+    "historicalCompletion": {
+      "type": "object", "additionalProperties": false, "required": ["done_mode", "completed_at"],
+      "properties": {
+        "done_mode": { "const": "historical_import" },
+        "completed_at": { "oneOf": [{ "const": "unknown_requires_evidence" }, { "$ref": "#/$defs/strictTimestamp" }] }
+      }
+    },
+    "task": {
+      "type": "object", "additionalProperties": false,
+      "required": [
+        "task_id", "title", "lane", "design_memo", "narrative_ref", "compile_binding",
+        "disposition", "start", "completion", "source", "migration_context"
+      ],
+      "properties": {
+        "task_id": { "$ref": "#/$defs/identifier" },
+        "title": { "$ref": "#/$defs/text" },
+        "lane": { "$ref": "#/$defs/identifier" },
+        "design_memo": { "$ref": "#/$defs/designMemo" },
+        "narrative_ref": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/repoRef" }] },
+        "compile_binding": { "type": "null" },
+        "disposition": { "enum": ["register_pending", "register_in_progress", "register_done", "exclude_superseded", "exclude_compatibility_record", "unknown_requires_evidence"] },
+        "start": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/historicalStart" }] },
+        "completion": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/historicalCompletion" }] },
+        "source": { "$ref": "#/$defs/sourceLocation" },
+        "migration_context": { "$ref": "#/$defs/migrationContext" }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "disposition": { "const": "register_in_progress" } }, "required": ["disposition"] },
+          "then": { "properties": { "start": { "$ref": "#/$defs/historicalStart" }, "completion": { "type": "null" } } },
+          "else": {
+            "if": { "properties": { "disposition": { "const": "register_done" } }, "required": ["disposition"] },
+            "then": { "properties": { "start": { "type": "null" }, "completion": { "$ref": "#/$defs/historicalCompletion" } } },
+            "else": { "properties": { "start": { "type": "null" }, "completion": { "type": "null" } } }
+          }
+        }
+      ]
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quolu/lattice",
-  "version": "0.59.1",
+  "version": "0.60.1",
   "description": "Schedulability compiler for multi-agent development: observe real code boundaries, refactor the conflicting seam, recompile the plan for parallel execution",
   "author": {
     "name": "Quo / クオ at kitepon.dev",
@@ -35,6 +35,7 @@
     "docs/schemas/lattice.phase_todo_revision.v3.schema.json",
     "docs/schemas/lattice.todo_extraction.v2.schema.json",
     "docs/schemas/lattice.todo_extraction.v3.schema.json",
+    "docs/schemas/lattice.todo_extraction.v4.schema.json",
     "docs/schemas/lattice.todo_structure_set.v1.schema.json",
     "docs/schemas/lattice.todo_structure_realization.v1.schema.json",
     "docs/schemas/lattice.todo_structure_binding.v1.schema.json",

package/src/cli-help.mjs

@@ -91,7 +91,7 @@ Write commands:
   dashboard remove <project_id> --json  # 登録簿から1件外す（対象repoの外からも叩ける）
   note --plan <key> [--task <id>] (--message <text>|--input <file>)
       # ToDoへ作業継続に必要な方針・調査結果・注意をappend-onlyで追記する
-  migrate --input <extraction.json> [--serialization-reviewed]
+  migrate --input <extraction.json> [--serialization-reviewed] [--json]
   migrate --input <extraction.json> --dry-run --json [--serialization-reviewed]
       # 既存storeへplanを追加する（plan createは空store初期化専用）。
       # 依存グラフがほぼ一直線なら一度突き返し、再考後の --serialization-reviewed で通す
@@ -273,7 +273,7 @@ const SUBCOMMAND_USAGE = Object.freeze({
   'todo revise': 'todo revise --plan <key> --input <file> | --schema --json',
   'todo revise-phase': 'todo revise-phase --plan <key> --input <file> | --schema --json',
   'todo revise-set': 'todo revise-set --input <file> | --schema --json',
-  'todo migrate': 'todo migrate --input <extraction.json> [--serialization-reviewed] | --input <extraction.json> --dry-run --json [--serialization-reviewed] | --schema --json',
+  'todo migrate': 'todo migrate --input <extraction.json> [--serialization-reviewed] [--json] | --input <extraction.json> --dry-run --json [--serialization-reviewed] | --schema --json',
   'sensor init': 'sensor init [path] --json',
   'sensor sync': 'sensor sync [path] --json',
   'sensor diff': 'sensor diff <rootA> <rootB> [--subtree-a <rel>] [--subtree-b <rel>]'

package/src/plan-scope-review.mjs

@@ -15,7 +15,10 @@ import { TodoStoreError } from './todo-store.mjs';
 const REVIEW_SCHEMA = 'lattice.plan_scope_review.v1';
 const RESULT_SCHEMA = 'lattice.plan_scope_review_result.v1';
 const PLAN_CREATE_SCHEMA = 'lattice.plan_create_input.v4';
-const TODO_EXTRACTION_SCHEMA = 'lattice.todo_extraction.v3';
+const TODO_EXTRACTION_SCHEMAS = new Set([
+  'lattice.todo_extraction.v3',
+  'lattice.todo_extraction.v4',
+]);
 const MAX_INPUT_BYTES = 8_388_608;
 const JUDGMENTS = new Set(['required', 'out_of_scope']);
 
@@ -73,10 +76,10 @@ async function readJsonWithinRepo(repoRoot, inputRef) {
 
 function authoredPlan(value) {
   const digestField = value?.schema === PLAN_CREATE_SCHEMA ? 'input_digest'
-    : value?.schema === TODO_EXTRACTION_SCHEMA ? 'extraction_digest' : null;
+    : TODO_EXTRACTION_SCHEMAS.has(value?.schema) ? 'extraction_digest' : null;
   if (digestField === null) {
     throw new TodoStoreError('PLAN_SCOPE_REVIEW_INVALID', 'authoring_schema_unsupported', undefined, {
-      pointer: '/schema', expected: [PLAN_CREATE_SCHEMA, TODO_EXTRACTION_SCHEMA],
+      pointer: '/schema', expected: [PLAN_CREATE_SCHEMA, ...TODO_EXTRACTION_SCHEMAS],
       actual: typeof value?.schema === 'string' ? value.schema : null,
     });
   }
@@ -86,7 +89,7 @@ function authoredPlan(value) {
       pointer: `/${digestField}`,
     });
   }
-  const selected = value.schema === TODO_EXTRACTION_SCHEMA
+  const selected = TODO_EXTRACTION_SCHEMAS.has(value.schema)
     ? value.tasks?.filter((task) => typeof task?.disposition === 'string'
       && task.disposition.startsWith('register_'))
     : value.tasks;

package/src/project-cli.mjs

@@ -19,7 +19,10 @@ import { projectTodoStatus } from './todo-status.mjs';
 import { readTodoPlanNotesForStatus } from './todo-note-store.mjs';
 import { projectIndependenceFrontier } from './todo-independence.mjs';
 import { readTodoParallelCandidatesForStatus } from './todo-parallel-candidates.mjs';
-import { readTodoStructureFinalizationsForStatus } from './todo-structure-store.mjs';
+import {
+  readTodoStructureArtifactDiagnostics,
+  readTodoStructureFinalizationsForStatus,
+} from './todo-structure-store.mjs';
 import { isTodoIndependenceLegacyMarker } from './todo-independence-contracts.mjs';
 import { selectIndependenceGuidance } from './todo-independence-guidance.mjs';
 import { ensureTodoDashboardActivity } from './todo-dashboard-registry.mjs';
@@ -223,7 +226,7 @@ function invalidStatus({ cliVersion, repoRoot, reason, nextAction = null }) {
  * store読みはここでしか行わない——session開始経路が同じstoreを二度払っていたのが
  * ADR 0131で直した欠陥である。
  */
-async function resolveProjectState({ cwd, cliVersion }) {
+async function resolveProjectState({ cwd, cliVersion, diagnoseStructureArtifacts = false }) {
   const repoRoot = resolveRepoRoot(cwd);
   if (repoRoot === null) {
     return { exitCode: 1, repoRoot: null, store: null, todo: null,
@@ -271,6 +274,14 @@ async function resolveProjectState({ cwd, cliVersion }) {
   }
   try {
     const store = await readTodoStore({ repoRoot });
+    if (diagnoseStructureArtifacts) {
+      const diagnostics = await readTodoStructureArtifactDiagnostics({ repoRoot, store });
+      if (diagnostics.length > 0) {
+        throw new TodoStoreError(
+          'STRUCTURE_ARTIFACT_INVALID', diagnostics[0].reason, undefined, { diagnostics },
+        );
+      }
+    }
     const todo = projectTodoStatus(store, {
       planNotes: await readTodoPlanNotesForStatus({ repoRoot, store }),
       parallelCandidates: await readTodoParallelCandidatesForStatus({ repoRoot, store, gitHead }),
@@ -314,6 +325,7 @@ async function resolveProjectState({ cwd, cliVersion }) {
     });
     return { exitCode: 0, repoRoot, store, todo, result };
   } catch (error) {
+    if (error?.code === 'STRUCTURE_ARTIFACT_INVALID') throw error;
     const reason = error instanceof TodoStoreError
       ? `${error.code}:${error.detail?.reason ?? error.message}` : 'store_validation_failed';
     return invalid(reason);
@@ -322,7 +334,9 @@ async function resolveProjectState({ cwd, cliVersion }) {
 
 export async function runProjectStatus({ cwd, stdout, cliVersion, env = process.env,
   ensureDashboardActivity = ensureTodoDashboardActivity }) {
-  const state = await resolveProjectState({ cwd, cliVersion });
+  const state = await resolveProjectState({
+    cwd, cliVersion, diagnoseStructureArtifacts: true,
+  });
   // dashboard活動の登録はdiscovery面の副作用として維持する（ADR 0131 Decision 4で
   // session-context側だけが持たない、と決めた面である）。
   if (state.store !== null && env.LATTICE_DASHBOARD_AUTOSTART !== '0') {
@@ -680,6 +694,15 @@ export async function runPlanShow({ cwd, planKey, stdout }) {
 }
 
 export function projectStatusFailure({ cwd, stdout, cliVersion, error }) {
+  if (error?.code === 'STRUCTURE_ARTIFACT_INVALID') {
+    const payload = {
+      schema: 'lattice.cli_error.v2', code: error.code,
+      message: error.message ?? 'structure artifact invalid',
+      detail: error.detail,
+    };
+    stdout.write(`${JSON.stringify(payload)}\n`);
+    return 1;
+  }
   const projectRootConflict = error?.code === 'PROJECT_ROOT_CONFLICT';
   const result = invalidStatus({
     cliVersion, repoRoot: resolveRepoRoot(cwd),

package/src/runtime-pull-intake.mjs

@@ -18,6 +18,7 @@ import {
   BOUNDARY_MANIFEST_SCHEMA, selfDigest, validateRuntimeBoundaryManifest, validateRuntimePlan,
 } from './runtime-contracts.mjs';
 import { TODO_INDEPENDENCE_SCHEMA } from './todo-independence-contracts.mjs';
+import { pullIntakeReadinessGuidance } from './todo-independence-guidance.mjs';
 import {
   readTodoIndependenceArtifact, readTodoStore, readTodoWitnessSet,
 } from './todo-store.mjs';
@@ -315,6 +316,29 @@ function activeMember(store, planKey) {
   return member;
 }
 
+async function pullPlanReadiness({ repoRoot, planKey }) {
+  const store = await readTodoStore({ repoRoot });
+  const member = activeMember(store, planKey);
+  const [artifact, witnessSet] = await Promise.all([
+    readTodoIndependenceArtifact({ repoRoot, store, planKey }),
+    readTodoWitnessSet({ repoRoot, planKey }),
+  ]);
+  const ready = artifact !== null
+    && artifact.schema === TODO_INDEPENDENCE_SCHEMA
+    && artifact.project_id === store.project_id
+    && artifact.plan_key === planKey
+    && artifact.plan_version === member.plan.plan_version
+    && artifact.topology_digest === member.plan.topology_digest
+    && artifact.outcome === 'compiled'
+    && witnessSet?.project_id === store.project_id
+    && witnessSet?.plan_key === planKey
+    && witnessSet?.witness_set_digest === artifact.witness_set_digest;
+  return pullIntakeReadinessGuidance({
+    coordinationMode: member.coordination?.mode ?? null,
+    ready,
+  });
+}
+
 function literalEvent(member, { kind, taskId, actor }) {
   return member.journal?.events?.findLast((event) => (
     event.kind === kind && event.task_id === taskId
@@ -354,6 +378,10 @@ function pathTouches(boundary, changed) {
 }
 
 async function boundaryVerdict({ repoRoot, store, member, meta, taskId, intakeBase }) {
+  const pullRequired = pullIntakeReadinessGuidance({
+    coordinationMode: member.coordination?.mode ?? null,
+    ready: false,
+  });
   let artifact;
   let witnessSet;
   try {
@@ -362,7 +390,7 @@ async function boundaryVerdict({ repoRoot, store, member, meta, taskId, intakeBa
       readTodoWitnessSet({ repoRoot, planKey: meta.plan_key }),
     ]);
   } catch (error) {
-    return { state: 'hold', reason: 'boundary_unverified', next_action: 'recompile_independence',
+    return { state: 'hold', reason: 'boundary_unverified', next_action: pullRequired.next_action,
       detail: { cause: error?.code ?? 'artifact_read_failed' }, artifact: null, witnessSet: null };
   }
   const bindingValid = artifact !== null
@@ -375,11 +403,11 @@ async function boundaryVerdict({ repoRoot, store, member, meta, taskId, intakeBa
     && witnessSet?.plan_key === meta.plan_key
     && witnessSet?.witness_set_digest === artifact.witness_set_digest;
   if (!bindingValid) {
-    return { state: 'hold', reason: 'boundary_unverified', next_action: 'recompile_independence',
+    return { state: 'hold', reason: 'boundary_unverified', next_action: pullRequired.next_action,
       detail: { cause: 'artifact_binding_mismatch' }, artifact, witnessSet };
   }
   if (artifact.outcome !== 'compiled') {
-    return { state: 'hold', reason: 'boundary_unverified', next_action: 'recompile_independence',
+    return { state: 'hold', reason: 'boundary_unverified', next_action: pullRequired.next_action,
       detail: { cause: 'independence_outcome_unknown' }, artifact, witnessSet };
   }
   const boundary = boundaryFor(artifact, taskId);
@@ -603,6 +631,7 @@ export async function startPullRun({ repoRoot, runDir, runId, planKey, equipment
     || !identifier(runId) || !identifier(planKey) || equipment !== 'detached-worktree') {
     fail('INVALID_PULL_START', 'pull start入力が不正');
   }
+  const intakeReadiness = await pullPlanReadiness({ repoRoot, planKey });
   const temporary = await mkdtemp(path.join(path.dirname(runDir), `.${runId}.pull-tmp-`));
   const meta = {
     schema: PULL_RUN_META_SCHEMA,
@@ -634,9 +663,10 @@ export async function startPullRun({ repoRoot, runDir, runId, planKey, equipment
     throw error;
   }
   return {
-    schema: 'lattice.pull_run_start_result.v1',
+    schema: 'lattice.pull_run_start_result.v2',
     outcome: 'started', run_id: runId, plan_key: planKey,
     selection: 'pull', equipment, intake_count: 0,
+    intake_readiness: intakeReadiness,
   };
 }
 

package/src/sensor-node-runtime.mjs

@@ -1,14 +1,14 @@
 import { spawnSync } from 'node:child_process';
 
 export const SQLITE_EXPERIMENTAL_WARNING_FLAG = '--disable-warning=ExperimentalWarning';
-const RELAUNCH_GUARD_ENV = 'LATTICE_SENSOR_SQLITE_WARNING_RELAUNCHED';
+const RELAUNCH_GUARD_ENV = 'LATTICE_SQLITE_WARNING_RELAUNCHED';
 
 export function sensorNodeRuntimeFlags(nodeVersion = process.versions.node) {
   const major = Number(nodeVersion.split('.')[0]);
   return major === 22 ? [SQLITE_EXPERIMENTAL_WARNING_FLAG] : [];
 }
 
-export function sensorRelaunchArgv(
+export function node22RelaunchArgv(
   scriptPath,
   args,
   execArgv = process.execArgv,
@@ -20,20 +20,18 @@ export function sensorRelaunchArgv(
 }
 
 /**
- * Node 22 prints node:sqlite's ExperimentalWarning to stderr. Sensor commands
- * have a strict JSON-only stderr contract, so relaunch only that command
- * surface with Node's warning-category flag before node:sqlite is imported.
+ * Node 22 prints node:sqlite's ExperimentalWarning to stderr. The CLI has a
+ * JSON-only output contract, so relaunch before any command can import node:sqlite.
  */
-export function relaunchSensorForNode22IfNeeded({ args, scriptPath, env = process.env }) {
+export function relaunchForNode22IfNeeded({ args, scriptPath, env = process.env }) {
   const flags = sensorNodeRuntimeFlags();
-  if (args[0] !== 'sensor'
-    || flags.length === 0
+  if (flags.length === 0
     || flags.every((flag) => process.execArgv.includes(flag))
     || env[RELAUNCH_GUARD_ENV] === '1') return null;
 
   const result = spawnSync(
     process.execPath,
-    sensorRelaunchArgv(scriptPath, args),
+    node22RelaunchArgv(scriptPath, args),
     {
       cwd: process.cwd(),
       env: { ...env, [RELAUNCH_GUARD_ENV]: '1' },