@quolu/lattice 0.52.3 → 0.53.0

package/src/sensor-node-runtime.mjs

@@ -1,53 +1,53 @@
-import { spawnSync } from 'node:child_process';
-
-export const SQLITE_EXPERIMENTAL_WARNING_FLAG = '--disable-warning=ExperimentalWarning';
-const RELAUNCH_GUARD_ENV = 'LATTICE_SENSOR_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(
-  scriptPath,
-  args,
-  execArgv = process.execArgv,
-  nodeVersion = process.versions.node,
-) {
-  const flags = sensorNodeRuntimeFlags(nodeVersion)
-    .filter((flag) => !execArgv.includes(flag));
-  return [...flags, ...execArgv, scriptPath, ...args];
-}
-
-/**
- * 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.
- */
-export function relaunchSensorForNode22IfNeeded({ args, scriptPath, env = process.env }) {
-  const flags = sensorNodeRuntimeFlags();
-  if (args[0] !== 'sensor'
-    || 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),
-    {
-      cwd: process.cwd(),
-      env: { ...env, [RELAUNCH_GUARD_ENV]: '1' },
-      stdio: 'inherit',
-      windowsHide: true,
-    },
-  );
-  if (result.error) {
-    process.stderr.write(`${JSON.stringify({
-      schema: 'lattice.cli_error.v2',
-      code: 'LATTICE_SENSOR_RELAUNCH_FAILED',
-      message: result.error.message,
-    })}\n`);
-    return 1;
-  }
-  return result.status ?? 1;
-}
+import { spawnSync } from 'node:child_process';
+
+export const SQLITE_EXPERIMENTAL_WARNING_FLAG = '--disable-warning=ExperimentalWarning';
+const RELAUNCH_GUARD_ENV = 'LATTICE_SENSOR_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(
+  scriptPath,
+  args,
+  execArgv = process.execArgv,
+  nodeVersion = process.versions.node,
+) {
+  const flags = sensorNodeRuntimeFlags(nodeVersion)
+    .filter((flag) => !execArgv.includes(flag));
+  return [...flags, ...execArgv, scriptPath, ...args];
+}
+
+/**
+ * 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.
+ */
+export function relaunchSensorForNode22IfNeeded({ args, scriptPath, env = process.env }) {
+  const flags = sensorNodeRuntimeFlags();
+  if (args[0] !== 'sensor'
+    || 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),
+    {
+      cwd: process.cwd(),
+      env: { ...env, [RELAUNCH_GUARD_ENV]: '1' },
+      stdio: 'inherit',
+      windowsHide: true,
+    },
+  );
+  if (result.error) {
+    process.stderr.write(`${JSON.stringify({
+      schema: 'lattice.cli_error.v2',
+      code: 'LATTICE_SENSOR_RELAUNCH_FAILED',
+      message: result.error.message,
+    })}\n`);
+    return 1;
+  }
+  return result.status ?? 1;
+}

package/src/sensor-runtime.mjs

@@ -1,52 +1,52 @@
-import { spawn, spawnSync } from 'node:child_process';
-import { lstatSync } from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { sensorNodeRuntimeFlags } from './sensor-node-runtime.mjs';
-
-export const LATTICE_SENSOR_CLI = fileURLToPath(
-  new URL('../sensor/dist/bin/lattice-sensor.js', import.meta.url),
-);
-
-export class SensorRuntimeError extends Error {
-  constructor(message) {
-    super(message);
-    this.name = 'SensorRuntimeError';
-    this.code = 'LATTICE_SENSOR_UNAVAILABLE';
-  }
-}
-
-function assertBundledSensor() {
-  try {
-    const info = lstatSync(LATTICE_SENSOR_CLI);
-    if (!info.isFile() || info.isSymbolicLink()) throw new Error('not a regular file');
-  } catch (error) {
-    throw new SensorRuntimeError(`bundled sensor is unavailable: ${error.message}`);
-  }
-}
-
-export function sensorCliInvocation(args) {
-  if (!Array.isArray(args) || !args.every((arg) => typeof arg === 'string')) {
-    throw new TypeError('sensor args must be an array of strings');
-  }
-  assertBundledSensor();
-  return Object.freeze({
-    command: process.execPath,
-    args: Object.freeze([...sensorNodeRuntimeFlags(), LATTICE_SENSOR_CLI, ...args]),
-  });
-}
-
-export function invokeSensorCli(run, args, options) {
-  if (typeof run !== 'function') throw new TypeError('run must be a function');
-  const invocation = sensorCliInvocation(args);
-  return run(invocation.command, invocation.args, options);
-}
-
-export function spawnSensorCli(args, options = {}) {
-  const invocation = sensorCliInvocation(args);
-  return spawn(invocation.command, invocation.args, { ...options, shell: false });
-}
-
-export function spawnSensorCliSync(args, options = {}) {
-  const invocation = sensorCliInvocation(args);
-  return spawnSync(invocation.command, invocation.args, { ...options, shell: false });
-}
+import { spawn, spawnSync } from 'node:child_process';
+import { lstatSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { sensorNodeRuntimeFlags } from './sensor-node-runtime.mjs';
+
+export const LATTICE_SENSOR_CLI = fileURLToPath(
+  new URL('../sensor/dist/bin/lattice-sensor.js', import.meta.url),
+);
+
+export class SensorRuntimeError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = 'SensorRuntimeError';
+    this.code = 'LATTICE_SENSOR_UNAVAILABLE';
+  }
+}
+
+function assertBundledSensor() {
+  try {
+    const info = lstatSync(LATTICE_SENSOR_CLI);
+    if (!info.isFile() || info.isSymbolicLink()) throw new Error('not a regular file');
+  } catch (error) {
+    throw new SensorRuntimeError(`bundled sensor is unavailable: ${error.message}`);
+  }
+}
+
+export function sensorCliInvocation(args) {
+  if (!Array.isArray(args) || !args.every((arg) => typeof arg === 'string')) {
+    throw new TypeError('sensor args must be an array of strings');
+  }
+  assertBundledSensor();
+  return Object.freeze({
+    command: process.execPath,
+    args: Object.freeze([...sensorNodeRuntimeFlags(), LATTICE_SENSOR_CLI, ...args]),
+  });
+}
+
+export function invokeSensorCli(run, args, options) {
+  if (typeof run !== 'function') throw new TypeError('run must be a function');
+  const invocation = sensorCliInvocation(args);
+  return run(invocation.command, invocation.args, options);
+}
+
+export function spawnSensorCli(args, options = {}) {
+  const invocation = sensorCliInvocation(args);
+  return spawn(invocation.command, invocation.args, { ...options, shell: false });
+}
+
+export function spawnSensorCliSync(args, options = {}) {
+  const invocation = sensorCliInvocation(args);
+  return spawnSync(invocation.command, invocation.args, { ...options, shell: false });
+}

package/src/timestamp-contract.mjs

@@ -1,8 +1,8 @@
-const CANONICAL_UTC_MILLISECONDS = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/u;
-
-/** JavaScript Dateの暦日正規化（例: 2月30日）を受理しないUTC timestamp契約。 */
-export function isCanonicalUtcTimestamp(value) {
-  if (typeof value !== 'string' || !CANONICAL_UTC_MILLISECONDS.test(value)) return false;
-  const parsed = new Date(value);
-  return !Number.isNaN(parsed.valueOf()) && parsed.toISOString() === value;
-}
+const CANONICAL_UTC_MILLISECONDS = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/u;
+
+/** JavaScript Dateの暦日正規化（例: 2月30日）を受理しないUTC timestamp契約。 */
+export function isCanonicalUtcTimestamp(value) {
+  if (typeof value !== 'string' || !CANONICAL_UTC_MILLISECONDS.test(value)) return false;
+  const parsed = new Date(value);
+  return !Number.isNaN(parsed.valueOf()) && parsed.toISOString() === value;
+}

package/src/todo-audit-pending.mjs

@@ -1,91 +1,91 @@
-/**
- * 監査待ちPhaseの定義（ADR 0147／0148）。
- *
- * 「監査待ち」は同じ3状態の集合として、gantt scopeのfold判定・dashboardの表示判定へ
- * 別々に書かれていた。status面にも同じ判定が要るので、定義をここへ一本化する——
- * 集合が三重になれば、片方だけ更新された時に「図には出るがstatusには出ない」形の
- * ずれが生まれる。ADR 0147が塞ごうとした事故と外形が同じになる。
- *
- * このmoduleが持つのは監査待ちの**定義**だけである。各消費者の方針
- * （ganttのfold対象をどのplan世代へ限るか等）はここへ持ち込まない。
- */
-
-/**
- * 監査の判断がまだ着いていないPhase状態。
- *
- * - `gate_ready`: 所属ToDoが全てdoneで、監査待ち。
- * - `reviewing`: 監査中（reviewは出たが、acceptもrejectも出ていない）。
- * - `rejected`: 監査が通らず、要フォロー。
- *
- * `accepted`と`closed_unaudited`は含めない。どちらも判断が着いた終端状態で、
- * 待っているものが無い（ADR 0148裁定4）。`active`も含めない——まだpending taskが
- * 残っており、監査の地点へ到達していない。
- */
-export const AUDIT_PENDING_PHASE_STATUSES = new Set(['gate_ready', 'reviewing', 'rejected']);
-
-/** そのPhase状態が監査待ちか。null／undefined／未知の値はfalse。 */
-export function isAuditPendingPhaseStatus(status) {
-  return AUDIT_PENDING_PHASE_STATUSES.has(status ?? null);
-}
-
-/**
- * その監査待ち状態から実際に打てるコマンド。
- *
- * `src/todo-store.mjs`の遷移guardと一致させる——gate_readyからいきなりacceptはできず
- * （`phase_gate_not_ready`）、reviewing以外からのrejectもできない（`phase_reject_binding_invalid`）。
- * 実行すれば必ず弾かれる遷移を「次の一歩」として案内しない。
- *
- * 監査待ちでない状態を渡すのは呼び出し側の誤りなので、空配列へ丸めずに投げる。
- * 呼ぶ前に`isAuditPendingPhaseStatus`で絞ること。
- *
- * @returns {string[]} 実行可能なコマンド行（1つ以上）
- */
-export function auditPendingNextCommands(planKey, phaseId, status) {
-  const target = `--plan ${planKey} --phase ${phaseId}`;
-  if (status === 'gate_ready') {
-    return [
-      `lattice todo phase review ${target} --reason <text>`,
-      `lattice todo phase close-unaudited ${target} --reason <text>`,
-    ];
-  }
-  if (status === 'reviewing') {
-    return [
-      `lattice todo phase accept ${target} --input <file>`,
-      `lattice todo phase reject ${target} --input <file>`,
-    ];
-  }
-  if (status === 'rejected') {
-    return [`lattice todo phase reopen ${target} --reason <text>`];
-  }
-  const error = new Error(`phase status is not audit pending: ${status}`);
-  error.code = 'AUDIT_PENDING_STATUS_INVALID';
-  throw error;
-}
-
-/**
- * store read model(`lattice.todo_store_read.v1`)の中の監査待ちPhaseを列挙する。
- *
- * `member.phases`はstoreが常に埋める導出ビューで、phase無しplanの暗黙terminal-audit Phaseも
- * 同じ形で入っている(ADR 0147)。planの世代で分岐しないのはそのためである。
- *
- * 返すのは`plan_key`・`phase_id`・`status`だけにする。消費者ごとに要る付随情報
- * (evidence slot、次コマンド、implicitかどうか)は形が違うので、ここで先回りして
- * 詰め込まない。並び順はplan_key→phase_idで固定する——同じstoreからは同じ列が出る。
- *
- * @returns {Array<{plan_key: string, phase_id: string, status: string}>}
- */
-export function auditPendingPhasesOf(readModel) {
-  const entries = [];
-  for (const member of readModel?.members ?? []) {
-    if (!Array.isArray(member?.phases)) continue;
-    for (const phase of member.phases) {
-      if (!isAuditPendingPhaseStatus(phase?.status)) continue;
-      entries.push({
-        plan_key: member.plan.plan_key, phase_id: phase.phase_id, status: phase.status,
-      });
-    }
-  }
-  return entries.sort((left, right) => (
-    left.plan_key < right.plan_key ? -1 : left.plan_key > right.plan_key ? 1
-      : left.phase_id < right.phase_id ? -1 : left.phase_id > right.phase_id ? 1 : 0));
-}
+/**
+ * 監査待ちPhaseの定義（ADR 0147／0148）。
+ *
+ * 「監査待ち」は同じ3状態の集合として、gantt scopeのfold判定・dashboardの表示判定へ
+ * 別々に書かれていた。status面にも同じ判定が要るので、定義をここへ一本化する——
+ * 集合が三重になれば、片方だけ更新された時に「図には出るがstatusには出ない」形の
+ * ずれが生まれる。ADR 0147が塞ごうとした事故と外形が同じになる。
+ *
+ * このmoduleが持つのは監査待ちの**定義**だけである。各消費者の方針
+ * （ganttのfold対象をどのplan世代へ限るか等）はここへ持ち込まない。
+ */
+
+/**
+ * 監査の判断がまだ着いていないPhase状態。
+ *
+ * - `gate_ready`: 所属ToDoが全てdoneで、監査待ち。
+ * - `reviewing`: 監査中（reviewは出たが、acceptもrejectも出ていない）。
+ * - `rejected`: 監査が通らず、要フォロー。
+ *
+ * `accepted`と`closed_unaudited`は含めない。どちらも判断が着いた終端状態で、
+ * 待っているものが無い（ADR 0148裁定4）。`active`も含めない——まだpending taskが
+ * 残っており、監査の地点へ到達していない。
+ */
+export const AUDIT_PENDING_PHASE_STATUSES = new Set(['gate_ready', 'reviewing', 'rejected']);
+
+/** そのPhase状態が監査待ちか。null／undefined／未知の値はfalse。 */
+export function isAuditPendingPhaseStatus(status) {
+  return AUDIT_PENDING_PHASE_STATUSES.has(status ?? null);
+}
+
+/**
+ * その監査待ち状態から実際に打てるコマンド。
+ *
+ * `src/todo-store.mjs`の遷移guardと一致させる——gate_readyからいきなりacceptはできず
+ * （`phase_gate_not_ready`）、reviewing以外からのrejectもできない（`phase_reject_binding_invalid`）。
+ * 実行すれば必ず弾かれる遷移を「次の一歩」として案内しない。
+ *
+ * 監査待ちでない状態を渡すのは呼び出し側の誤りなので、空配列へ丸めずに投げる。
+ * 呼ぶ前に`isAuditPendingPhaseStatus`で絞ること。
+ *
+ * @returns {string[]} 実行可能なコマンド行（1つ以上）
+ */
+export function auditPendingNextCommands(planKey, phaseId, status) {
+  const target = `--plan ${planKey} --phase ${phaseId}`;
+  if (status === 'gate_ready') {
+    return [
+      `lattice todo phase review ${target} --reason <text>`,
+      `lattice todo phase close-unaudited ${target} --reason <text>`,
+    ];
+  }
+  if (status === 'reviewing') {
+    return [
+      `lattice todo phase accept ${target} --input <file>`,
+      `lattice todo phase reject ${target} --input <file>`,
+    ];
+  }
+  if (status === 'rejected') {
+    return [`lattice todo phase reopen ${target} --reason <text>`];
+  }
+  const error = new Error(`phase status is not audit pending: ${status}`);
+  error.code = 'AUDIT_PENDING_STATUS_INVALID';
+  throw error;
+}
+
+/**
+ * store read model(`lattice.todo_store_read.v1`)の中の監査待ちPhaseを列挙する。
+ *
+ * `member.phases`はstoreが常に埋める導出ビューで、phase無しplanの暗黙terminal-audit Phaseも
+ * 同じ形で入っている(ADR 0147)。planの世代で分岐しないのはそのためである。
+ *
+ * 返すのは`plan_key`・`phase_id`・`status`だけにする。消費者ごとに要る付随情報
+ * (evidence slot、次コマンド、implicitかどうか)は形が違うので、ここで先回りして
+ * 詰め込まない。並び順はplan_key→phase_idで固定する——同じstoreからは同じ列が出る。
+ *
+ * @returns {Array<{plan_key: string, phase_id: string, status: string}>}
+ */
+export function auditPendingPhasesOf(readModel) {
+  const entries = [];
+  for (const member of readModel?.members ?? []) {
+    if (!Array.isArray(member?.phases)) continue;
+    for (const phase of member.phases) {
+      if (!isAuditPendingPhaseStatus(phase?.status)) continue;
+      entries.push({
+        plan_key: member.plan.plan_key, phase_id: phase.phase_id, status: phase.status,
+      });
+    }
+  }
+  return entries.sort((left, right) => (
+    left.plan_key < right.plan_key ? -1 : left.plan_key > right.plan_key ? 1
+      : left.phase_id < right.phase_id ? -1 : left.phase_id > right.phase_id ? 1 : 0));
+}