@quolu/lattice 0.46.0 → 0.46.2

package/README.ja.md

@@ -1,5 +1,7 @@
 <p align="center">
-  <img src=".github/og.png" alt="Lattice — 見かけだけの競合で作業を直列化しない" width="100%">
+  <img src=".github/og.png" alt="Lattice — 閉ざされて見えた山岳地形から複数の進行経路が現れる" width="100%">
+  <br>
+  <sub><em>この画像は、閉ざされているように見えた場所から複数の進行経路が現れ、自律した実行者たちが協調して動き出す瞬間を表しています。</em></sub>
 </p>
 
 # Lattice
@@ -295,6 +297,12 @@ dashboard daemonは起動時に読み込んだ版数をhealthで名乗り、inst
 その間伸びます（実測: 8 project登録で約50秒台）。待ち時間は固定秒数ではなく、spawnした子が生きている
 間だけ待ち、子が死ねば即座に`DASHBOARD_DAEMON_UNAVAILABLE`を返します。既定120秒の上限は、応答を
 返さない子に対するbackstopであって正常な起動時間の見積りではありません。
+daemonの生死はdescriptor 1枚では持ちません。daemonは自分のpidの記録を書き、起動のたびに死んだ記録を
+掃除して、descriptorから外れた生存daemonを再認証のうえ停止します。入れ替えの途中でCLI側が落ちても、
+旧daemonが観測されないまま生き残ることはありません。descriptorだけを失った場合は2本目を建てず、
+配信を続けているdaemonを引き取ります。signalを送るのはその場で再認証を通った相手だけで、応答しない
+pidへは送りません（pid再利用で無関係のprocessを止めうるためです）。規約は
+[ADR 0157](docs/adr/0157-dashboard-daemons-are-discoverable-by-record.md)が正です。
 状態を書き込む`start / block / unblock / done / evidence promote / reopen / revise / revise-phase / revise-set`
 では、監査actorとして次の3環境変数をすべて設定してください。
 

package/README.md

@@ -1,5 +1,7 @@
 <p align="center">
-  <img src=".github/og.png" alt="Lattice — stop serializing work that only looks like it conflicts" width="100%">
+  <img src=".github/og.png" alt="Lattice — several viable routes emerging through an apparently blocked mountain valley" width="100%">
+  <br>
+  <sub><em>This image represents several viable paths emerging from terrain that first appeared blocked, as autonomous executors begin moving in coordination.</em></sub>
 </p>
 
 # Lattice

package/bin/lattice.mjs

@@ -1,16 +1,24 @@
 #!/usr/bin/env node
 
+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 packageJson from '../package.json' with { type: 'json' };
 
 installPipeCloseGuard();
 
 const args = process.argv.slice(2);
+const sensorRelaunchStatus = relaunchSensorForNode22IfNeeded({
+  args,
+  scriptPath: fileURLToPath(import.meta.url),
+});
 const help = renderCliHelp(args);
 
-if (help !== null) {
+if (sensorRelaunchStatus !== null) {
+  process.exitCode = sensorRelaunchStatus;
+} else if (help !== null) {
   process.stdout.write(help);
 } else if (args.length === 1 && args[0] === '--version') {
   process.stdout.write(`${packageJson.version}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quolu/lattice",
-  "version": "0.46.0",
+  "version": "0.46.2",
   "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",

package/src/hooks-cli.mjs

@@ -427,18 +427,41 @@ function hostHandler(host, command) {
     : { type: 'command', command, timeout: 5, async: false, statusMessage: null };
 }
 
-async function resolveCanonical(host, source) {
+export async function resolveStableNodePath(execPath, {
+  platform = process.platform,
+  accessImpl = access,
+  realpathImpl = realpath,
+} = {}) {
+  await accessImpl(execPath, fsConstants.X_OK);
+  if (platform !== 'darwin') return execPath;
+  const match = execPath.match(/^\/(opt\/homebrew|usr\/local)\/Cellar\/([^/]+)\/[^/]+\/bin\/node$/u);
+  if (match === null) return execPath;
+  const prefix = `/${match[1]}`;
+  const candidates = [path.join(prefix, 'bin/node'), path.join(prefix, 'opt', match[2], 'bin/node')];
+  const resolvedExec = await realpathImpl(execPath);
+  for (const candidate of candidates) {
+    try {
+      await accessImpl(candidate, fsConstants.X_OK);
+      if (await realpathImpl(candidate) === resolvedExec) return candidate;
+    } catch {
+      // A candidate is usable only when it exists and resolves to this running Node binary.
+    }
+  }
+  return execPath;
+}
+
+async function resolveCanonical(host, source, platform) {
   const sourcePaths = [source.execPath, source.binPath];
   if (sourcePaths.some((entry) => typeof entry !== 'string' || !path.isAbsolute(entry)
     || /[\0\r\n]/u.test(entry))) {
     throw Object.assign(new Error('install source is not absolute'), { code: 'INSTALL_SOURCE_UNRESOLVED' });
   }
   try {
-    await access(source.execPath, fsConstants.X_OK);
+    const executable = await resolveStableNodePath(source.execPath, { platform });
     const script = await realpath(source.binPath);
     if (/[\0\r\n]/u.test(script)) throw new Error('resolved install source has unsafe characters');
     await access(script, fsConstants.R_OK | fsConstants.X_OK);
-    return [source.execPath, script, 'hooks', 'emit', '--host', host];
+    return [executable, script, 'hooks', 'emit', '--host', host];
   } catch (error) {
     throw Object.assign(error, { code: 'INSTALL_SOURCE_UNRESOLVED' });
   }
@@ -613,13 +636,13 @@ async function hostDirectory(home, host) {
   }
 }
 
-async function mutate(host, env, stdout, uninstall, source, testHooks) {
+async function mutate(host, env, stdout, uninstall, source, platform, testHooks) {
   const home = env.HOME ?? os.homedir();
   if (await hostDirectory(home, host) === null) {
     return failure(stdout, 'HOST_NOT_PRESENT', 'host home directory is not present');
   }
   let current;
-  try { current = await resolveCanonical(host, source); } catch {
+  try { current = await resolveCanonical(host, source, platform); } catch {
     return failure(stdout, 'INSTALL_SOURCE_UNRESOLVED', 'install source cannot be resolved');
   }
   const target = configPath(home, host);
@@ -708,7 +731,7 @@ async function status(host, env, stdout, source, platform, testHooks) {
   const home = env.HOME ?? os.homedir();
   const target = configPath(home, host);
   let argv;
-  try { argv = await resolveCanonical(host, source); } catch {
+  try { argv = await resolveCanonical(host, source, platform); } catch {
     writeJson(stdout, statusResult(host, target, null, 'unreadable', 0, false, 0));
     return 1;
   }
@@ -1023,8 +1046,8 @@ export async function runHooksCli({
     if (command === 'status') return status(host, env, stdout, source, platform, testHooks);
     return failure(stdout, 'HOST_PLATFORM_UNSUPPORTED', 'native Windows hooks are unsupported');
   }
-  if (command === 'install') return mutate(host, env, stdout, false, source, testHooks);
-  if (command === 'uninstall') return mutate(host, env, stdout, true, source, testHooks);
+  if (command === 'install') return mutate(host, env, stdout, false, source, platform, testHooks);
+  if (command === 'uninstall') return mutate(host, env, stdout, true, source, platform, testHooks);
   if (command === 'status') return status(host, env, stdout, source, platform, testHooks);
   return emit(host, env, stdin, stdout, spawnImpl, gitTimeoutMs, testHooks);
 }

package/src/sensor-node-runtime.mjs

@@ -0,0 +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;
+}

package/src/sensor-runtime.mjs

@@ -1,6 +1,7 @@
 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),
@@ -28,7 +29,10 @@ export function sensorCliInvocation(args) {
     throw new TypeError('sensor args must be an array of strings');
   }
   assertBundledSensor();
-  return Object.freeze({ command: process.execPath, args: Object.freeze([LATTICE_SENSOR_CLI, ...args]) });
+  return Object.freeze({
+    command: process.execPath,
+    args: Object.freeze([...sensorNodeRuntimeFlags(), LATTICE_SENSOR_CLI, ...args]),
+  });
 }
 
 export function invokeSensorCli(run, args, options) {