@quolu/lattice 0.57.1 → 0.57.2

package/bin/lattice-bridge.mjs

@@ -140,12 +140,15 @@ timer = setInterval(async () => {
     // the terminal identity file) reaches this catch.
     try {
       const heartbeat = await hubHeartbeat.tick({ config });
-      hubHeartbeatError = null;
+      // 直前に書いた指紋は、健全な状態へ戻った時にだけ捨てる。判定より前に捨てると
+      // 比較相手が毎周期nullになり、同じ結果をpoll周期ごとに書き続ける。stderrの
+      // 消費者が居ない常駐（WindowsのStartup launcher、LaunchAgent）では、この
+      // 書込みが積み上がること自体が常駐を不安定にする。
       if (['unreachable', 'rejected', 'partial'].includes(heartbeat?.state)) {
         const fingerprint = JSON.stringify(heartbeat);
         if (fingerprint !== hubHeartbeatError) process.stderr.write(`${fingerprint}\n`);
         hubHeartbeatError = fingerprint;
-      }
+      } else hubHeartbeatError = null;
     } catch (error) {
       const failure = { schema: 'lattice.bridge_daemon_error.v1',
         code: error?.code ?? 'BRIDGE_HUB_HEARTBEAT_FAILED',

package/docs/bridge-setup.md

@@ -54,6 +54,11 @@ bridgeが無効な間は以下すべてnullで、bridgeを有効にしている
 | `node_path`・`node_exists` | 起動するNode実行体と、それが今も存在するか |
 | `bridge_path`・`bridge_exists` | 起動するbridge scriptと、それが今も存在するか |
 | `error` | `unreadable`のときだけtyped code（例`BRIDGE_LAUNCH_AGENT_PLIST_UNSAFE`） |
+| `error=BRIDGE_PERSISTENCE_STATE_SPLIT` | launcherまたはplistの片割れだけが残った状態。手でfileを消さず、`lattice bridge reconfigure --json`で常駐設定を揃える（0.57.2以降） |
+
+`BRIDGE_PERSISTENCE_STATE_SPLIT`は、常駐設定の一方（macOSのplist、またはWindowsのlauncher／descriptor）だけが
+存在することを示す。これは復旧対象そのものが壊れている状態なので、手作業でfileを削除せず、
+`lattice bridge reconfigure --json`を実行して正規のinstall経路で両方を再生成する。
 
 **`runtime`** — いま応答しているprocess自身の申告。`state`は`running`／`not_running`／`unattested`／
 `descriptor_invalid`で、`running`以外では各値がnullになる。`running`でも、identityを返さない

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quolu/lattice",
-  "version": "0.57.1",
+  "version": "0.57.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/bridge-cli.mjs

@@ -112,6 +112,10 @@ async function bridgePersistence({ launchAgent, env }) {
     // `loaded` is launchd-specific; the Windows Startup folder has no such
     // concept and reports null rather than pretending to know.
     const loaded = typeof snapshot?.loaded === 'boolean' ? snapshot.loaded : null;
+    if (snapshot?.split === true) {
+      return { state: 'unreadable', ...UNREADABLE_PERSISTENCE, loaded,
+        error: 'BRIDGE_PERSISTENCE_STATE_SPLIT' };
+    }
     if (described === null) return { state: 'not_installed', ...UNREADABLE_PERSISTENCE, loaded, error: null };
     return { state: 'installed', loaded, ...described, error: null };
   } catch (error) {

package/src/bridge-launch-agent.mjs

@@ -247,10 +247,8 @@ export async function snapshotBridgeLaunchAgent({ env = process.env,
   await prepareDirectory(refs.directory, uid);
   const content = await strictPlist(refs.plist, uid);
   const loaded = await loadedState(runner, uid);
-  if (loaded && content === null) {
-    throw fail('BRIDGE_LAUNCH_AGENT_STATE_INVALID', 'loaded bridge LaunchAgent has no owned plist');
-  }
-  return Object.freeze({ installed: content !== null, loaded, content });
+  const split = loaded && content === null;
+  return Object.freeze({ installed: content !== null, loaded, split, content });
 }
 
 const PROGRAM_ARGUMENTS_PATTERN =
@@ -346,6 +344,10 @@ export async function restoreBridgeLaunchAgent({ snapshot, listen = null, env =
   await prepareDirectory(refs.directory, uid);
   const stopped = await bootoutIfLoaded({ runner, uid });
   if (stopped) await waitStopped({ listen, env });
+  if (snapshot.split === true) {
+    await rm(refs.plist, { force: true });
+    return snapshot;
+  }
   if (snapshot.installed) await atomicPlist(refs.plist, snapshot.content);
   else await rm(refs.plist, { force: true });
   if (snapshot.loaded) {

package/src/bridge-startup-folder.mjs

@@ -239,10 +239,9 @@ export async function snapshotBridgeStartupFolder({ env = process.env } = {}) {
   await prepareDirectory(refs.runtimeDirectory);
   const launcherContent = await strictFile(refs.launcher);
   const descriptorContent = await strictFile(refs.descriptor);
-  if ((launcherContent === null) !== (descriptorContent === null)) {
-    throw fail('BRIDGE_STARTUP_FOLDER_STATE_INVALID', 'startup launcher and descriptor disagree on installed state');
-  }
-  return Object.freeze({ installed: launcherContent !== null, launcherContent, descriptorContent });
+  const split = (launcherContent === null) !== (descriptorContent === null);
+  return Object.freeze({ installed: launcherContent !== null && descriptorContent !== null,
+    split, launcherContent, descriptorContent });
 }
 
 async function pathPresent(ref) {