@quolu/lattice 0.52.3 → 0.53.0

package/src/node-version-guard.mjs

@@ -1,44 +1,44 @@
-/**
- * lattice-mcp bin向けNode versionガード（ADR 0049 wave2レビューでのスコープ外
- * 発見の修理 — bin/lattice-mcp.mjs が sensor/dist/index.js を直import して
- * MCPServer を起動する経路には、sensor CLI (sensor/src/bin/sensor.ts) が
- * 持つNode versionガードが一切通っていなかった）。
- *
- * 閾値・banner文言は複製せず、sensor CLI と同じ
- * `sensor/dist/bin/node-version-check.js`（Node 25.x のV8 turboshaft WASM JIT
- * Zone allocatorバグと、MIN_NODE_MAJOR未満のfloorを扱う）から再利用する。
- *
- * 判定ロジックだけをここに切り出し、process.versions.node / env を直接
- * 読まない純関数にすることで、境界値（MIN_NODE_MAJOR-1 / MIN_NODE_MAJOR /
- * 24 / 25 / 26、override有無）をunit testで固定できるようにする。
- */
-
-import {
-  MIN_NODE_MAJOR,
-  buildNode25BlockBanner,
-  buildNodeTooOldBanner,
-  isNode25Affected,
-} from '../sensor/dist/bin/node-version-check.js';
-
-export { MIN_NODE_MAJOR };
-
-/**
- * @param {string} nodeVersion - process.versions.node相当の文字列 (例: "26.5.0")
- * @param {boolean} overrideActive - LATTICE_SENSOR_ALLOW_UNSAFE_NODE が設定されているか
- * @returns {{ blocked: boolean, banner: string | null }}
- *   banner: 表示すべきbanner文言（sensor CLIと同一文言）。null ならサポート
- *     対象内で表示不要。
- *   blocked: true なら呼び出し側は起動を止める（exit 1 相当）。
- *     override有効時は nodeMajor が範囲外でも blocked は false になるが、
- *     banner は「表示のみ」で non-null のまま返る（sensor CLIと同一意味論）。
- */
-export function evaluateNodeVersionGuard(nodeVersion, overrideActive) {
-  const nodeMajor = parseInt(nodeVersion.split('.')[0] ?? '0', 10);
-  if (isNode25Affected(nodeMajor)) {
-    return { blocked: !overrideActive, banner: buildNode25BlockBanner(nodeVersion) };
-  }
-  if (nodeMajor < MIN_NODE_MAJOR) {
-    return { blocked: !overrideActive, banner: buildNodeTooOldBanner(nodeVersion) };
-  }
-  return { blocked: false, banner: null };
-}
+/**
+ * lattice-mcp bin向けNode versionガード（ADR 0049 wave2レビューでのスコープ外
+ * 発見の修理 — bin/lattice-mcp.mjs が sensor/dist/index.js を直import して
+ * MCPServer を起動する経路には、sensor CLI (sensor/src/bin/sensor.ts) が
+ * 持つNode versionガードが一切通っていなかった）。
+ *
+ * 閾値・banner文言は複製せず、sensor CLI と同じ
+ * `sensor/dist/bin/node-version-check.js`（Node 25.x のV8 turboshaft WASM JIT
+ * Zone allocatorバグと、MIN_NODE_MAJOR未満のfloorを扱う）から再利用する。
+ *
+ * 判定ロジックだけをここに切り出し、process.versions.node / env を直接
+ * 読まない純関数にすることで、境界値（MIN_NODE_MAJOR-1 / MIN_NODE_MAJOR /
+ * 24 / 25 / 26、override有無）をunit testで固定できるようにする。
+ */
+
+import {
+  MIN_NODE_MAJOR,
+  buildNode25BlockBanner,
+  buildNodeTooOldBanner,
+  isNode25Affected,
+} from '../sensor/dist/bin/node-version-check.js';
+
+export { MIN_NODE_MAJOR };
+
+/**
+ * @param {string} nodeVersion - process.versions.node相当の文字列 (例: "26.5.0")
+ * @param {boolean} overrideActive - LATTICE_SENSOR_ALLOW_UNSAFE_NODE が設定されているか
+ * @returns {{ blocked: boolean, banner: string | null }}
+ *   banner: 表示すべきbanner文言（sensor CLIと同一文言）。null ならサポート
+ *     対象内で表示不要。
+ *   blocked: true なら呼び出し側は起動を止める（exit 1 相当）。
+ *     override有効時は nodeMajor が範囲外でも blocked は false になるが、
+ *     banner は「表示のみ」で non-null のまま返る（sensor CLIと同一意味論）。
+ */
+export function evaluateNodeVersionGuard(nodeVersion, overrideActive) {
+  const nodeMajor = parseInt(nodeVersion.split('.')[0] ?? '0', 10);
+  if (isNode25Affected(nodeMajor)) {
+    return { blocked: !overrideActive, banner: buildNode25BlockBanner(nodeVersion) };
+  }
+  if (nodeMajor < MIN_NODE_MAJOR) {
+    return { blocked: !overrideActive, banner: buildNodeTooOldBanner(nodeVersion) };
+  }
+  return { blocked: false, banner: null };
+}

package/src/project-cli.mjs

@@ -1,4 +1,4 @@
-import { execFileSync } from 'node:child_process';
+import { gitSync } from './git-process.mjs';
 import { constants as fsConstants } from 'node:fs';
 import { lstat, open, realpath } from 'node:fs/promises';
 import path from 'node:path';
@@ -56,7 +56,7 @@ function resolveRepoRoot(cwd) {
   try {
     // gitはWindowsでもforward slashを返すため、OS nativeへ正規化して
     // path.join由来のabsolute_pathと区切りを揃える。末尾newline以外（末尾空白等）は改変しない。
-    return path.resolve(execFileSync('git', ['rev-parse', '--show-toplevel'], {
+    return path.resolve(gitSync(['rev-parse', '--show-toplevel'], {
       cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'],
     }).replace(/\r?\n$/u, ''));
   } catch {
@@ -66,7 +66,7 @@ function resolveRepoRoot(cwd) {
 
 function gitHead(repoRoot) {
   try {
-    return execFileSync('git', ['rev-parse', 'HEAD'], {
+    return gitSync(['rev-parse', 'HEAD'], {
       cwd: repoRoot, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'],
     }).replace(/\r?\n$/u, '');
   } catch {

package/src/project-identity.mjs

@@ -1,130 +1,130 @@
-import { lstat, readFile, realpath } from 'node:fs/promises';
-import path from 'node:path';
-import { parseTree } from 'jsonc-parser';
-
-export const PROJECT_IDENTITY_REF = '.lattice/project.json';
-const MAX_BYTES = 65_536;
-const URL_MAX_BYTES = 2_048;
-const IDENTITY_KEYS = 'display_name,project_id,schema';
-const IDENTITY_KEYS_WITH_PANE = 'display_name,external_pane,project_id,schema';
-const CONTROL = /[\u0000-\u001f\u007f]/u;
-
-function fail(reason) {
-  const error = new Error(reason);
-  error.code = 'PROJECT_IDENTITY_INVALID';
-  error.detail = { reason };
-  throw error;
-}
-
-function displayName(value) {
-  return typeof value === 'string' && value.length > 0 && value === value.trim()
-    && !CONTROL.test(value) && Buffer.byteLength(value, 'utf8') <= 256;
-}
-
-function duplicateKey(node) {
-  if (node?.type === 'object') {
-    const keys = new Set();
-    for (const property of node.children ?? []) {
-      const [key, value] = property.children ?? [];
-      if (keys.has(key?.value) || duplicateKey(value)) return true;
-      keys.add(key?.value);
-    }
-  } else if (node?.type === 'array') return (node.children ?? []).some(duplicateKey);
-  return false;
-}
-
-/** 外部ペインのURLは、閲覧者のブラウザが実際に取りに行く先である。絶対URLだけを通す。 */
-function paneUrl(value) {
-  if (typeof value !== 'string' || value.length === 0 || CONTROL.test(value)
-    || Buffer.byteLength(value, 'utf8') > URL_MAX_BYTES) return null;
-  let url;
-  try { url = new URL(value); } catch { return null; }
-  if (url.protocol !== 'https:' && url.protocol !== 'http:') return null;
-  return url;
-}
-
-/**
- * projectごとに1枚だけ差せる外部ペインの設定。Latticeは中身が何のサービスかを知らない
- * ——題名・埋め込み先URL・生存probe URLの3つだけを受け取る汎用の口である。
- */
-function externalPane(value) {
-  if (value === null || typeof value !== 'object' || Array.isArray(value)
-    || Object.keys(value).sort().join(',') !== 'probe_url,title,url') {
-    fail('external_pane_schema_invalid');
-  }
-  if (!displayName(value.title)) fail('external_pane_title_invalid');
-  const url = paneUrl(value.url);
-  const probe = paneUrl(value.probe_url);
-  if (url === null) fail('external_pane_url_invalid');
-  if (probe === null) fail('external_pane_probe_url_invalid');
-  return Object.freeze({
-    title: value.title,
-    url: url.href,
-    probeUrl: probe.href,
-    frameOrigin: url.origin,
-    probeOrigin: probe.origin,
-  });
-}
-
-async function readIdentityDocument({ repoRoot, projectId }) {
-  const canonicalRoot = await realpath(repoRoot);
-  const ref = path.join(canonicalRoot, PROJECT_IDENTITY_REF);
-  let stats;
-  try { stats = await lstat(ref); } catch (error) {
-    if (error?.code === 'ENOENT') return null;
-    throw error;
-  }
-  if (!stats.isFile() || stats.isSymbolicLink() || stats.size > MAX_BYTES) fail('identity_file_unsafe');
-  const resolved = await realpath(ref);
-  if (resolved !== ref) fail('identity_file_alias');
-  const bytes = await readFile(ref);
-  if (bytes.length > MAX_BYTES) fail('identity_file_too_large');
-  let text;
-  try { text = new TextDecoder('utf-8', { fatal: true }).decode(bytes); } catch { fail('identity_utf8_invalid'); }
-  const errors = [];
-  const tree = parseTree(text, errors, { allowTrailingComma: false, disallowComments: true });
-  if (errors.length > 0 || tree === undefined || duplicateKey(tree)) fail('identity_json_invalid');
-  let document;
-  try { document = JSON.parse(text); } catch { fail('identity_json_invalid'); }
-  const keys = document === null || typeof document !== 'object' || Array.isArray(document)
-    ? '' : Object.keys(document).sort().join(',');
-  if ((keys !== IDENTITY_KEYS && keys !== IDENTITY_KEYS_WITH_PANE)
-    || document.schema !== 'lattice.project_identity.v1'
-    || document.project_id !== projectId || !displayName(document.display_name)) {
-    fail('identity_schema_invalid');
-  }
-  return document;
-}
-
-export async function resolveProjectIdentity({ repoRoot, projectId, env = process.env }) {
-  if (!path.isAbsolute(repoRoot) || typeof projectId !== 'string' || projectId.length === 0
-    || env === null || typeof env !== 'object' || Array.isArray(env)) {
-    throw new TypeError('project identity options invalid');
-  }
-  const override = env.LATTICE_PROJECT_DISPLAY_NAME;
-  if (override !== undefined) {
-    if (!displayName(override)) fail('environment_display_name_invalid');
-    return Object.freeze({ projectId, displayName: override, source: 'environment' });
-  }
-  const document = await readIdentityDocument({ repoRoot, projectId });
-  if (document === null) {
-    return Object.freeze({ projectId, displayName: projectId, source: 'project_id' });
-  }
-  // external_paneは表示名の出典ではない。ここでは形の妥当性だけ確かめて落とす
-  // ——壊れた設定を黙って無視すると、差したはずのペインが出ない理由が追えなくなる。
-  if (document.external_pane !== undefined) externalPane(document.external_pane);
-  return Object.freeze({ projectId, displayName: document.display_name, source: 'project_file' });
-}
-
-/**
- * 差してあるなら外部ペイン設定を、無ければnullを返す。配信のたびに読むので、
- * 設定を書いた／消した側はdaemonの再起動を要さない（reloadで反映される）。
- */
-export async function readProjectExternalPane({ repoRoot, projectId }) {
-  if (!path.isAbsolute(repoRoot) || typeof projectId !== 'string' || projectId.length === 0) {
-    throw new TypeError('project identity options invalid');
-  }
-  const document = await readIdentityDocument({ repoRoot, projectId });
-  if (document === null || document.external_pane === undefined) return null;
-  return externalPane(document.external_pane);
-}
+import { lstat, readFile, realpath } from 'node:fs/promises';
+import path from 'node:path';
+import { parseTree } from 'jsonc-parser';
+
+export const PROJECT_IDENTITY_REF = '.lattice/project.json';
+const MAX_BYTES = 65_536;
+const URL_MAX_BYTES = 2_048;
+const IDENTITY_KEYS = 'display_name,project_id,schema';
+const IDENTITY_KEYS_WITH_PANE = 'display_name,external_pane,project_id,schema';
+const CONTROL = /[\u0000-\u001f\u007f]/u;
+
+function fail(reason) {
+  const error = new Error(reason);
+  error.code = 'PROJECT_IDENTITY_INVALID';
+  error.detail = { reason };
+  throw error;
+}
+
+function displayName(value) {
+  return typeof value === 'string' && value.length > 0 && value === value.trim()
+    && !CONTROL.test(value) && Buffer.byteLength(value, 'utf8') <= 256;
+}
+
+function duplicateKey(node) {
+  if (node?.type === 'object') {
+    const keys = new Set();
+    for (const property of node.children ?? []) {
+      const [key, value] = property.children ?? [];
+      if (keys.has(key?.value) || duplicateKey(value)) return true;
+      keys.add(key?.value);
+    }
+  } else if (node?.type === 'array') return (node.children ?? []).some(duplicateKey);
+  return false;
+}
+
+/** 外部ペインのURLは、閲覧者のブラウザが実際に取りに行く先である。絶対URLだけを通す。 */
+function paneUrl(value) {
+  if (typeof value !== 'string' || value.length === 0 || CONTROL.test(value)
+    || Buffer.byteLength(value, 'utf8') > URL_MAX_BYTES) return null;
+  let url;
+  try { url = new URL(value); } catch { return null; }
+  if (url.protocol !== 'https:' && url.protocol !== 'http:') return null;
+  return url;
+}
+
+/**
+ * projectごとに1枚だけ差せる外部ペインの設定。Latticeは中身が何のサービスかを知らない
+ * ——題名・埋め込み先URL・生存probe URLの3つだけを受け取る汎用の口である。
+ */
+function externalPane(value) {
+  if (value === null || typeof value !== 'object' || Array.isArray(value)
+    || Object.keys(value).sort().join(',') !== 'probe_url,title,url') {
+    fail('external_pane_schema_invalid');
+  }
+  if (!displayName(value.title)) fail('external_pane_title_invalid');
+  const url = paneUrl(value.url);
+  const probe = paneUrl(value.probe_url);
+  if (url === null) fail('external_pane_url_invalid');
+  if (probe === null) fail('external_pane_probe_url_invalid');
+  return Object.freeze({
+    title: value.title,
+    url: url.href,
+    probeUrl: probe.href,
+    frameOrigin: url.origin,
+    probeOrigin: probe.origin,
+  });
+}
+
+async function readIdentityDocument({ repoRoot, projectId }) {
+  const canonicalRoot = await realpath(repoRoot);
+  const ref = path.join(canonicalRoot, PROJECT_IDENTITY_REF);
+  let stats;
+  try { stats = await lstat(ref); } catch (error) {
+    if (error?.code === 'ENOENT') return null;
+    throw error;
+  }
+  if (!stats.isFile() || stats.isSymbolicLink() || stats.size > MAX_BYTES) fail('identity_file_unsafe');
+  const resolved = await realpath(ref);
+  if (resolved !== ref) fail('identity_file_alias');
+  const bytes = await readFile(ref);
+  if (bytes.length > MAX_BYTES) fail('identity_file_too_large');
+  let text;
+  try { text = new TextDecoder('utf-8', { fatal: true }).decode(bytes); } catch { fail('identity_utf8_invalid'); }
+  const errors = [];
+  const tree = parseTree(text, errors, { allowTrailingComma: false, disallowComments: true });
+  if (errors.length > 0 || tree === undefined || duplicateKey(tree)) fail('identity_json_invalid');
+  let document;
+  try { document = JSON.parse(text); } catch { fail('identity_json_invalid'); }
+  const keys = document === null || typeof document !== 'object' || Array.isArray(document)
+    ? '' : Object.keys(document).sort().join(',');
+  if ((keys !== IDENTITY_KEYS && keys !== IDENTITY_KEYS_WITH_PANE)
+    || document.schema !== 'lattice.project_identity.v1'
+    || document.project_id !== projectId || !displayName(document.display_name)) {
+    fail('identity_schema_invalid');
+  }
+  return document;
+}
+
+export async function resolveProjectIdentity({ repoRoot, projectId, env = process.env }) {
+  if (!path.isAbsolute(repoRoot) || typeof projectId !== 'string' || projectId.length === 0
+    || env === null || typeof env !== 'object' || Array.isArray(env)) {
+    throw new TypeError('project identity options invalid');
+  }
+  const override = env.LATTICE_PROJECT_DISPLAY_NAME;
+  if (override !== undefined) {
+    if (!displayName(override)) fail('environment_display_name_invalid');
+    return Object.freeze({ projectId, displayName: override, source: 'environment' });
+  }
+  const document = await readIdentityDocument({ repoRoot, projectId });
+  if (document === null) {
+    return Object.freeze({ projectId, displayName: projectId, source: 'project_id' });
+  }
+  // external_paneは表示名の出典ではない。ここでは形の妥当性だけ確かめて落とす
+  // ——壊れた設定を黙って無視すると、差したはずのペインが出ない理由が追えなくなる。
+  if (document.external_pane !== undefined) externalPane(document.external_pane);
+  return Object.freeze({ projectId, displayName: document.display_name, source: 'project_file' });
+}
+
+/**
+ * 差してあるなら外部ペイン設定を、無ければnullを返す。配信のたびに読むので、
+ * 設定を書いた／消した側はdaemonの再起動を要さない（reloadで反映される）。
+ */
+export async function readProjectExternalPane({ repoRoot, projectId }) {
+  if (!path.isAbsolute(repoRoot) || typeof projectId !== 'string' || projectId.length === 0) {
+    throw new TypeError('project identity options invalid');
+  }
+  const document = await readIdentityDocument({ repoRoot, projectId });
+  if (document === null || document.external_pane === undefined) return null;
+  return externalPane(document.external_pane);
+}