@quolu/lattice 0.73.0 → 0.75.0

package/bin/lattice.mjs

@@ -177,6 +177,29 @@ if (help !== null) {
   }
 }
 
+await pendingObservation;
+await scheduleRuntimeErrorReport();
+
+/**
+ * 未受領のruntime error記録を、切り離した子processで送らせる（ADR 0193）。このCLIの応答は待たせない。
+ * 送信を有効にしていない端末では、設定fileの有無を1回見るだけで終わる。hookは打鍵ごとに走るので見ない。
+ */
+async function scheduleRuntimeErrorReport() {
+  if (help !== null || args[0] === '--version' || args[0] === 'hooks'
+    || (args[0] === 'runtime-errors' && args[1] === 'report')) return;
+  try {
+    const { runtimeErrorReportingEnabled } = await import('../src/runtime-errors.mjs');
+    if (!runtimeErrorReportingEnabled()) return;
+    const { runtimeErrorAutoReportDue } = await import('../src/runtime-error-reporting.mjs');
+    if (!runtimeErrorAutoReportDue()) return;
+    const { spawn } = await import('node:child_process');
+    const { tmpdir } = await import('node:os');
+    const { fileURLToPath } = await import('node:url');
+    spawn(process.execPath, [fileURLToPath(import.meta.url), 'runtime-errors', 'report', '--auto', '--json'],
+      { cwd: tmpdir(), detached: true, stdio: 'ignore', windowsHide: true }).unref();
+  } catch { /* 送信の予約に失敗しても、打たれたcommandの結果は変えない。 */ }
+}
+
 // typed契約の外へ漏れた例外を、opt-inのruntime error記録へ残す。どの面で・どの種類の例外で
 // 落ちたかを固定語彙の分類（safe_context）で添える——error_codeだけでは原因を追えなかった。
 function observeInternalFailure(error, commandKind) {
@@ -199,7 +222,7 @@ function workingDirectory() {
 async function runRuntimeErrorsCli(rest) {
   const runtimeErrors = await import('../src/runtime-errors.mjs');
   const usage = () => {
-    process.stderr.write(`${JSON.stringify({ schema: 'lattice.cli_error.v2', code: 'USAGE', message: 'usage: lattice runtime-errors <snapshot [--after-cursor N] [--limit N]|ack <cursor>|diagnostics|resolve <fingerprint>|reopen <fingerprint>|compact> --json' })}\n`);
+    process.stderr.write(`${JSON.stringify({ schema: 'lattice.cli_error.v2', code: 'USAGE', message: 'usage: lattice runtime-errors <snapshot [--after-cursor N] [--limit N]|ack <cursor>|diagnostics|resolve <fingerprint>|reopen <fingerprint>|compact|report|reporting <status|enable|disable>> --json' })}\n`);
     return 2;
   };
   const options = { version: packageJson.version };
@@ -228,6 +251,16 @@ async function runRuntimeErrorsCli(rest) {
       result = runtimeErrors.setRuntimeErrorStatus(words[1], words[0] === 'resolve' ? 'resolved' : 'open', options);
     } else if (words[0] === 'compact' && words.length === 1) {
       result = runtimeErrors.compactRuntimeErrors(options);
+    } else if (words[0] === 'reporting' && words.length === 2 && ['status', 'enable', 'disable'].includes(words[1])) {
+      const reporting = await import('../src/runtime-error-reporting.mjs');
+      result = words[1] === 'status' ? reporting.runtimeErrorReportingStatus(options)
+        : reporting.setRuntimeErrorReporting(words[1] === 'enable', options);
+    } else if (words[0] === 'report' && (words.length === 1 || (words.length === 2 && words[1] === '--auto'))) {
+      // 送れなかった時も結果は1行で返す。受領まで済んだ時と、送るものが無い時だけexit 0。
+      const reporting = await import('../src/runtime-error-reporting.mjs');
+      result = await reporting.reportRuntimeErrors({ ...options, auto: words.length === 2 });
+      process.stdout.write(`${JSON.stringify(result)}\n`);
+      return ['delivered', 'nothing_pending'].includes(result.outcome) ? 0 : 1;
     } else {
       return usage();
     }

package/package.json

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

@@ -196,6 +196,8 @@ Commands:
   resolve <fingerprint>
   reopen <fingerprint>
   compact
+  report                        未受領の記録をBugHubの受け口へ送る（送信を有効にした端末だけ）
+  reporting <status|enable|disable>
 `,
   bridge: `Usage: lattice bridge <command> [options] --json
 
@@ -312,6 +314,8 @@ const SUBCOMMAND_USAGE = Object.freeze({
   'runtime-errors resolve': 'runtime-errors resolve <fingerprint> --json',
   'runtime-errors reopen': 'runtime-errors reopen <fingerprint> --json',
   'runtime-errors compact': 'runtime-errors compact --json',
+  'runtime-errors report': 'runtime-errors report --json',
+  'runtime-errors reporting': 'runtime-errors reporting <status|enable|disable> --json',
   'bridge setup': 'bridge setup --listen <IP> [--port <49152..65535|auto>] [--dashboard|--upstream <URL>] [--hub <URL>|none] [--allow-host <host>...] --json',
   'bridge reconfigure': 'bridge reconfigure [--listen <IP>] [--port <49152..65535|auto>] [--dashboard|--upstream <URL>] [--hub <URL>|none] [--allow-host <host>...] --json',
   'bridge status': 'bridge status --json',

package/src/runtime-error-reporting.mjs

@@ -0,0 +1,365 @@
+import { createHash, createHmac, randomBytes, randomUUID, timingSafeEqual } from 'node:crypto';
+import {
+  existsSync, lstatSync, mkdirSync, readFileSync, rmSync, writeFileSync,
+} from 'node:fs';
+import http from 'node:http';
+import https from 'node:https';
+import { homedir, platform as hostPlatform } from 'node:os';
+import { dirname, join } from 'node:path';
+
+import {
+  REPORTING_CONFIG_SCHEMA,
+  acknowledgeRuntimeErrors,
+  ensureSafeDir,
+  ensureSafeFile,
+  replaceStoreFile,
+  runtimeErrorCollectionSupported,
+  runtimeErrorReportingConfigPath,
+  runtimeErrorReportingEnabled,
+  runtimeErrorsDiagnostics,
+  runtimeErrorsSnapshot,
+  runtimeErrorsStatePath,
+  windowsLocalAppData,
+} from './runtime-errors.mjs';
+
+/**
+ * runtime error記録を、Lattice自身がBugHubの製品報告の受け口へ送る（ADR 0193）。
+ *
+ * - 既定では通信しない。端末で`runtime-errors reporting enable`を打ち、BugHubの持ち主が合鍵のfileを
+ *   置いた端末だけが送る。どちらかが欠ければ、networkへ触れない。
+ * - 秘密は通信に載せない。本文のSHA-256と時刻へのHMAC-SHA256署名だけを`Authorization`に付ける。
+ * - 受領済みにするのは、200・`accepted: true`・`report_id`一致・応答の署名一致がそろった時だけ。
+ *   そろわなければ「届いたか不明」として記録を未受領のまま残し、後から今の累計を送り直す。
+ * - 送るのは`runtime-errors snapshot`が出す項目だけ。message本文・path・引数・stackは記録に無い。
+ */
+
+const REPORT_SCHEMA_VERSION = '1.0';
+const RESULT_SCHEMA = 'lattice.runtime_error_report_result.v1';
+const STATUS_SCHEMA = 'lattice.runtime_error_reporting_status.v1';
+const DELIVERY_SCHEMA = 'lattice.runtime_error_delivery.v1';
+const PRODUCT_ID = 'lattice';
+const REQUEST_TIMEOUT_MS = 10_000;
+const RESPONSE_MAX_BYTES = 64 * 1024;
+const REPORT_MAX_BYTES = 512 * 1024;
+const REPORT_MAX_RECORDS = 256;
+// BugHubは端末×製品ごとに1分に1回まで受ける。届かなかった同じ中身の送り直しは1時間に1回まで。
+const MIN_ATTEMPT_INTERVAL_MS = 60_000;
+const RETRY_INTERVAL_MS = 60 * 60_000;
+const KEY_ID = /^[A-Za-z0-9._:-]{1,128}$/;
+const REJECTION_CODE = /^[a-z][a-z0-9_]{0,63}$/;
+const OUTCOMES = Object.freeze(['delivered', 'nothing_pending', 'disabled', 'unsupported', 'credential_missing',
+  'credential_unsafe', 'throttled', 'rejected', 'unconfirmed', 'store_unavailable']);
+
+const plain = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const exact = (value, keys) => Object.keys(value).length === keys.length && keys.every((key) => Object.hasOwn(value, key));
+
+/** 合鍵の置き場（BugHubの契約）。Windowsは`%LOCALAPPDATA%\bughub\product-credentials\`。 */
+export function productCredentialPath(env = process.env, platform = hostPlatform()) {
+  const base = platform === 'win32' ? join(windowsLocalAppData(env), 'bughub') : join(env.HOME || homedir(), '.config', 'bughub');
+  return join(base, 'product-credentials', `${PRODUCT_ID}.json`);
+}
+
+/**
+ * Windowsの合鍵が本人・SYSTEM・Administratorsだけのものか。DACLの読み取りは出力fileを置く場所が要るので、
+ * 絞ったstoreのフォルダを使う（無ければ作る）。合鍵のフォルダへは何も書かない。
+ */
+function windowsCredentialUnsafeReason(path, options) {
+  const storeDir = dirname(options.storePath ?? runtimeErrorsStatePath(options.env ?? process.env));
+  try {
+    ensureSafeDir(storeDir);
+  } catch {
+    return 'acl_unverifiable';
+  }
+  try {
+    ensureSafeFile(path, storeDir);
+    return null;
+  } catch {
+    return 'acl_not_owner_only';
+  }
+}
+
+/**
+ * 合鍵のfileを読む。BugHubの持ち主が置く形（symlinkでなく、POSIXは本人所有・0600、Windowsは
+ * 本人・SYSTEM・Administratorsだけに権限）以外は使わない。秘密は戻り値の中だけに留め、結果や記録へ写さない。
+ */
+export function readProductCredential(options = {}) {
+  const path = options.credentialPath ?? productCredentialPath(options.env ?? process.env);
+  let stats;
+  try {
+    stats = lstatSync(path);
+  } catch (error) {
+    return error?.code === 'ENOENT' ? { status: 'missing' } : { status: 'unsafe', reason: 'unreadable' };
+  }
+  if (!stats.isFile() || stats.isSymbolicLink()) return { status: 'unsafe', reason: 'not_regular_file' };
+  if (hostPlatform() === 'win32') {
+    const reason = windowsCredentialUnsafeReason(path, options);
+    if (reason !== null) return { status: 'unsafe', reason };
+  } else {
+    if ((stats.mode & 0o777) !== 0o600) return { status: 'unsafe', reason: 'mode_not_0600' };
+    if (typeof process.getuid === 'function' && stats.uid !== process.getuid()) return { status: 'unsafe', reason: 'owner_mismatch' };
+  }
+  let value;
+  try {
+    value = JSON.parse(readFileSync(path, 'utf8'));
+  } catch {
+    return { status: 'unsafe', reason: 'not_json' };
+  }
+  if (!plain(value) || !exact(value, ['url', 'key_id', 'secret'])
+    || typeof value.url !== 'string' || typeof value.key_id !== 'string' || typeof value.secret !== 'string'
+    || !KEY_ID.test(value.key_id) || value.secret.length < 16 || value.secret.length > 1024) {
+    return { status: 'unsafe', reason: 'invalid_shape' };
+  }
+  let url;
+  try {
+    url = new URL(value.url);
+  } catch {
+    return { status: 'unsafe', reason: 'invalid_url' };
+  }
+  if (!['http:', 'https:'].includes(url.protocol) || url.username !== '' || url.password !== '') {
+    return { status: 'unsafe', reason: 'invalid_url' };
+  }
+  return { status: 'ok', credential: { url, keyId: value.key_id, secret: value.secret } };
+}
+
+const sha256Hex = (bytes) => createHash('sha256').update(bytes).digest('hex');
+const hmacHex = (secret, text) => createHmac('sha256', Buffer.from(secret, 'utf8')).update(text, 'utf8').digest('hex');
+
+/** `sig = HMAC-SHA256(secret, ts + "\n" + SHA-256(送るバイト列の16進))`。秘密は文字列のままUTF-8で鍵にする。 */
+export function signReport(secret, ts, bodyBytes) {
+  return hmacHex(secret, `${ts}\n${sha256Hex(bodyBytes)}`);
+}
+
+/** 応答の署名: `HMAC-SHA256(secret, report_id + "\n" + received_at)`。別の機器が返した200を受領済みにしない。 */
+export function receiptSignatureMatches(secret, reportId, receivedAt, sig) {
+  if (typeof receivedAt !== 'string' || typeof sig !== 'string' || !/^[0-9a-f]{64}$/.test(sig)) return false;
+  const expected = Buffer.from(hmacHex(secret, `${reportId}\n${receivedAt}`), 'hex');
+  return timingSafeEqual(expected, Buffer.from(sig, 'hex'));
+}
+
+/** snapshotの未受領分から、受け口へ送る本文を組む。項目はsnapshotが出すものをそのまま載せる。 */
+export function buildRuntimeErrorReport({ snapshot, version, reportId, observedAt }) {
+  return {
+    schema_version: REPORT_SCHEMA_VERSION,
+    report_id: reportId,
+    product_id: PRODUCT_ID,
+    installed_version: version,
+    observed_at: observedAt,
+    runtime_errors: snapshot.runtime_errors,
+    resolutions: snapshot.resolutions,
+  };
+}
+
+function deliveryStatePath(options) {
+  const env = options.env ?? process.env;
+  return join(dirname(options.storePath ?? runtimeErrorsStatePath(env)), 'runtime-errors-delivery.json');
+}
+
+const emptyDelivery = () => ({ schema: DELIVERY_SCHEMA, last_attempt_at: null, last_outcome: null, attempted_through: 0 });
+
+function readDelivery(options) {
+  const path = deliveryStatePath(options);
+  if (!existsSync(path)) return emptyDelivery();
+  try {
+    ensureSafeFile(path);
+    const value = JSON.parse(readFileSync(path, 'utf8'));
+    if (!plain(value) || !exact(value, ['schema', 'last_attempt_at', 'last_outcome', 'attempted_through'])
+      || value.schema !== DELIVERY_SCHEMA
+      || (value.last_attempt_at !== null && !Number.isFinite(Date.parse(value.last_attempt_at)))
+      || (value.last_outcome !== null && !OUTCOMES.includes(value.last_outcome))
+      || !Number.isSafeInteger(value.attempted_through) || value.attempted_through < 0) return emptyDelivery();
+    return value;
+  } catch {
+    return emptyDelivery();
+  }
+}
+
+function writeDelivery(options, state) {
+  const path = deliveryStatePath(options);
+  ensureSafeDir(dirname(path));
+  const temporary = join(dirname(path), `.runtime-errors-delivery-${process.pid}-${randomBytes(6).toString('hex')}`);
+  try {
+    writeFileSync(temporary, `${JSON.stringify(state)}\n`, { mode: 0o600, flag: 'wx' });
+    replaceStoreFile(temporary, path);
+  } finally {
+    rmSync(temporary, { force: true });
+  }
+}
+
+const nowMs = (options) => (options.now ? new Date(options.now).valueOf() : Date.now());
+
+/**
+ * 自動送信してよい時機か。故障を記録した直後・解決を打った直後・以後のCLI実行が呼ぶ。
+ * 未受領が無い、直前の試みから1分未満、同じ中身の送り直しが1時間未満、のどれかなら送らない。
+ */
+function throttleReason(options, delivery, highWatermark) {
+  if (delivery.last_attempt_at === null) return null;
+  const elapsed = nowMs(options) - Date.parse(delivery.last_attempt_at);
+  if (elapsed < MIN_ATTEMPT_INTERVAL_MS) return 'attempted_within_a_minute';
+  if (delivery.last_outcome !== 'delivered' && delivery.attempted_through === highWatermark
+    && elapsed < RETRY_INTERVAL_MS) return 'same_report_retried_within_an_hour';
+  return null;
+}
+
+export function runtimeErrorReportingStatus(options = {}) {
+  const supported = runtimeErrorCollectionSupported(options);
+  const enabled = runtimeErrorReportingEnabled(options);
+  const credential = supported ? readProductCredential(options) : { status: 'missing' };
+  const diagnostics = runtimeErrorsDiagnostics(options);
+  const delivery = supported ? readDelivery(options) : emptyDelivery();
+  return {
+    schema: STATUS_SCHEMA,
+    reporting: !supported ? 'unsupported' : enabled ? 'enabled' : 'disabled',
+    credential: credential.status === 'ok' ? 'present' : credential.status,
+    credential_reason: credential.status === 'unsafe' ? credential.reason : null,
+    collection: diagnostics.collection,
+    store_status: diagnostics.status,
+    pending_count: diagnostics.pending_count,
+    last_attempt_at: delivery.last_attempt_at,
+    last_outcome: delivery.last_outcome,
+  };
+}
+
+/** 送信の設定をLattice自身のfileへ書く。dotagentsの設定は読みも書きもしない。 */
+export function setRuntimeErrorReporting(enabled, options = {}) {
+  if (typeof enabled !== 'boolean') throw Error('invalid_enabled');
+  if (!runtimeErrorCollectionSupported(options)) throw Error('reporting_unsupported');
+  const env = options.env ?? process.env;
+  const path = options.reportingConfigPath ?? runtimeErrorReportingConfigPath(env);
+  mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+  try {
+    if (lstatSync(path).isSymbolicLink()) throw Error('config_unsafe');
+  } catch (error) {
+    if (error?.code !== 'ENOENT') throw error;
+  }
+  const temporary = join(dirname(path), `.runtime-error-reporting-${process.pid}-${randomBytes(6).toString('hex')}`);
+  try {
+    writeFileSync(temporary, `${JSON.stringify({ schema: REPORTING_CONFIG_SCHEMA, enabled })}\n`, { mode: 0o600, flag: 'wx' });
+    replaceStoreFile(temporary, path);
+  } finally {
+    rmSync(temporary, { force: true });
+  }
+  return runtimeErrorReportingStatus(options);
+}
+
+function post(url, headers, bodyBytes, timeoutMs) {
+  return new Promise((resolve) => {
+    const client = url.protocol === 'https:' ? https : http;
+    const request = client.request(url, { method: 'POST', headers, timeout: timeoutMs }, (response) => {
+      const chunks = [];
+      let size = 0;
+      response.on('data', (chunk) => {
+        size += chunk.length;
+        if (size > RESPONSE_MAX_BYTES) { request.destroy(); resolve({ status: null, reason: 'response_too_large' }); return; }
+        chunks.push(chunk);
+      });
+      response.on('end', () => resolve({ status: response.statusCode ?? null, body: Buffer.concat(chunks).toString('utf8') }));
+      response.on('error', () => resolve({ status: null, reason: 'response_error' }));
+    });
+    request.on('timeout', () => { request.destroy(); resolve({ status: null, reason: 'timeout' }); });
+    request.on('error', () => resolve({ status: null, reason: 'network_error' }));
+    request.end(bodyBytes);
+  });
+}
+
+const result = (outcome, extra = {}) => ({
+  schema: RESULT_SCHEMA, outcome, reason: null, http_status: null,
+  sent: { runtime_errors: 0, resolutions: 0 }, acknowledged_through: null, ...extra,
+});
+
+function parseJson(text) {
+  try {
+    const value = JSON.parse(text);
+    return plain(value) ? value : null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 未受領の記録を1回送る。`options.auto`の時だけ送る時機の制限を見る（手で打った`report`は見ない
+ * ——多すぎればBugHubが429で断る）。戻り値に秘密・key_id・宛先は入れない。
+ */
+export async function reportRuntimeErrors(options = {}) {
+  if (!runtimeErrorCollectionSupported(options)) return result('unsupported');
+  if (!runtimeErrorReportingEnabled(options)) return result('disabled');
+  const credential = readProductCredential(options);
+  if (credential.status === 'missing') return result('credential_missing');
+  if (credential.status !== 'ok') return result('credential_unsafe', { reason: credential.reason });
+
+  let pending;
+  let delivery;
+  try {
+    const diagnostics = runtimeErrorsDiagnostics(options);
+    if (diagnostics.status !== 'ready') return result('store_unavailable');
+    pending = runtimeErrorsSnapshot(diagnostics.acknowledged_through, REPORT_MAX_RECORDS, options);
+    delivery = readDelivery(options);
+  } catch {
+    return result('store_unavailable');
+  }
+  const sent = { runtime_errors: pending.runtime_errors.length, resolutions: pending.resolutions.length };
+  if (sent.runtime_errors + sent.resolutions === 0) {
+    return result('nothing_pending', { acknowledged_through: pending.cursor.acknowledged_through });
+  }
+  if (options.auto === true) {
+    const reason = throttleReason(options, delivery, pending.cursor.high_watermark);
+    if (reason !== null) return result('throttled', { reason });
+  }
+
+  // `ts`と`observed_at`は同じ時刻から作る（BugHubは10分より離れた組を断る）。
+  const ts = Math.floor(nowMs(options) / 1000);
+  const report = buildRuntimeErrorReport({ snapshot: pending, version: options.version ?? 'unknown',
+    reportId: options.reportId ?? randomUUID(), observedAt: new Date(ts * 1000).toISOString() });
+  const bodyBytes = Buffer.from(JSON.stringify(report), 'utf8');
+  if (bodyBytes.length > REPORT_MAX_BYTES) return result('rejected', { reason: 'report_too_large', sent });
+
+  const finish = (outcome, extra = {}) => {
+    try {
+      writeDelivery(options, { schema: DELIVERY_SCHEMA, last_attempt_at: new Date(nowMs(options)).toISOString(),
+        last_outcome: outcome, attempted_through: pending.cursor.high_watermark });
+    } catch { /* 送信の結果は返す。時機の記録だけが残らない。 */ }
+    return result(outcome, { sent, acknowledged_through: pending.cursor.acknowledged_through, ...extra });
+  };
+
+  const { credential: { url, keyId, secret } } = credential;
+  const response = await post(url, {
+    'Content-Type': 'application/json',
+    'Content-Length': String(bodyBytes.length),
+    Authorization: `BugHub-HMAC-SHA256 key_id=${keyId}, ts=${ts}, sig=${signReport(secret, String(ts), bodyBytes)}`,
+  }, bodyBytes, options.timeoutMs ?? REQUEST_TIMEOUT_MS);
+
+  if (response.status === null) return finish('unconfirmed', { reason: response.reason });
+  const body = parseJson(response.body);
+  if (response.status === 200) {
+    if (body === null || body.accepted !== true || body.report_id !== report.report_id
+      || !receiptSignatureMatches(secret, report.report_id, body.received_at, body.sig)) {
+      return finish('unconfirmed', { reason: 'receipt_not_verified', http_status: 200 });
+    }
+    try {
+      const acknowledged = acknowledgeRuntimeErrors(pending.cursor.next, options);
+      return finish('delivered', { http_status: 200, acknowledged_through: acknowledged.cursor.acknowledged_through });
+    } catch {
+      // 届いているが受領済みを残せなかった。次の送信が同じ累計を送り直す（BugHubは二重に数えない）。
+      return finish('unconfirmed', { reason: 'ack_not_recorded', http_status: 200 });
+    }
+  }
+  const code = typeof body?.error === 'string' && REJECTION_CODE.test(body.error) ? body.error : 'unrecognized_response';
+  if (response.status >= 500) return finish('unconfirmed', { reason: code, http_status: response.status });
+  return finish('rejected', { reason: code, http_status: response.status });
+}
+
+/**
+ * 自動送信の入口が、子processを起こす前に見る軽い判定。設定が無い端末（外の利用者）では、
+ * 設定fileの有無を1回見るだけで終わる。合鍵は、送るものがある時だけ確かめる——Windowsでは
+ * 合鍵の確認が外のprogramを起こすので、毎回のCLI実行には載せない。
+ */
+export function runtimeErrorAutoReportDue(options = {}) {
+  if (!runtimeErrorReportingEnabled(options)) return false;
+  try {
+    const diagnostics = runtimeErrorsDiagnostics(options);
+    if (diagnostics.status !== 'ready' || diagnostics.pending_count === 0) return false;
+    if (throttleReason(options, readDelivery(options), diagnostics.high_watermark) !== null) return false;
+    return readProductCredential(options).status === 'ok';
+  } catch {
+    return false;
+  }
+}

package/src/runtime-errors.mjs

@@ -1,26 +1,32 @@
 import { createHash, randomBytes } from 'node:crypto';
 import {
-  existsSync, lstatSync, mkdirSync, readFileSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync,
+  existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync,
 } from 'node:fs';
 import { homedir, platform as hostPlatform, arch as hostArch } from 'node:os';
 import { dirname, join } from 'node:path';
 
+import {
+  daclIsOwnerOnly, daclIsProtected, isAclScratchName, readWindowsDacl, restrictWindowsDirToOwner, windowsSelfSid,
+} from './windows-owner-only.mjs';
+
 /**
  * opt-in runtime error store（親plan L6要件。Caveat `caveat.runtime_errors.v1` と同型の工場契約）。
  *
- * - collection/reporting分離: 収集可否は工場共有config
- *   `${XDG_CONFIG_HOME:-~/.config}/dotagents/factory-reporter.json` の `collection.enabled` だけが決める。
- *   reporting設定はconfig validationの一部だが、本storeは外部送信を一切行わない（送信はdotagents adapter所有）。
- * - 既定OFF: config欠落・malformed・disabledでは state も network も触らない。
+ * - 収集の有効化: 工場共有config `${XDG_CONFIG_HOME:-~/.config}/dotagents/factory-reporter.json` の
+ *   `collection.enabled`、またはLattice自身の送信設定（`runtime-error-reporting.json`、ADR 0193）のどちらかが
+ *   有効な時だけ収集する。本storeは外部送信を行わない——送信は`runtime-error-reporting.mjs`が持つ。
+ * - 既定OFF: どちらの設定も無い・malformed・disabledでは state も network も触らない。
  * - privacy by design: 保存するのは固定catalogの `error_code` / `message_template` のみ。
  *   生message・path・引数を保存しない。
  * - retention: fingerprint集約（同一原因はcount/last_seen更新）＋ack済みresolvedの30日compact。
- * - POSIX専用: Lattice runtimeはWindows nativeでunsupported（親plan L6）。owner-onlyを証明できない
- *   環境では `store_unsafe` でfail closedする。
+ * - owner-only: storeは本人だけが触れる形でしか使わない。POSIXはmode（0700・0600）と所有者、Windowsは
+ *   DACL（本人・SYSTEM・Administratorsだけ、ADR 0194）で確かめ、確かめられなければ `store_unsafe` で
+ *   fail closedする。
  */
 
 const RUNTIME_ERRORS_SCHEMA = 'lattice.runtime_errors.v1';
 const DIAGNOSTICS_SCHEMA = 'lattice.runtime_error_diagnostics.v1';
+export const REPORTING_CONFIG_SCHEMA = 'lattice.runtime_error_reporting_config.v1';
 const PRODUCT = 'lattice';
 const STATE_VERSION = '1.0';
 const MAX_RECORDS = 256;
@@ -53,7 +59,9 @@ const plain = (value) => typeof value === 'object' && value !== null && !Array.i
 const exact = (value, keys) => Object.keys(value).length === keys.length && keys.every((key) => Object.hasOwn(value, key));
 const validTime = (value) => typeof value === 'string' && Number.isFinite(Date.parse(value)) && new Date(value).toISOString() === value;
 const validVersion = (value) => typeof value === 'string' && /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/.test(value);
-const validOs = (value) => typeof value === 'string' && ['darwin', 'linux'].includes(value);
+// 収集に対応するOS。storeを本人だけが触れる形で置けると確かめられるものだけを載せる。
+const SUPPORTED_OS = Object.freeze(['darwin', 'linux', 'win32']);
+const validOs = (value) => typeof value === 'string' && SUPPORTED_OS.includes(value);
 const validArch = (value) => typeof value === 'string' && ['x64', 'arm64', 'arm'].includes(value);
 
 export function defaultFactoryReporterConfigPath(env = process.env) {
@@ -61,9 +69,19 @@ export function defaultFactoryReporterConfigPath(env = process.env) {
   return join(env.XDG_CONFIG_HOME || join(home, '.config'), 'dotagents', 'factory-reporter.json');
 }
 
-export function runtimeErrorsStatePath(env = process.env) {
-  const home = env.HOME || homedir();
-  return join(env.XDG_STATE_HOME || join(home, '.local', 'state'), 'lattice', 'runtime-errors.json');
+/** Windowsで利用者ごとのdataを置く場所（`%LOCALAPPDATA%`）。 */
+export function windowsLocalAppData(env = process.env) {
+  return env.LOCALAPPDATA || join(env.USERPROFILE || homedir(), 'AppData', 'Local');
+}
+
+/**
+ * storeの置き場。Windowsは`%LOCALAPPDATA%\Lattice\runtime-errors\`という専用のフォルダへ置く
+ * ——`%LOCALAPPDATA%\Lattice`には他の機能のfileがあり、フォルダごと本人だけに絞れない。
+ */
+export function runtimeErrorsStatePath(env = process.env, platform = hostPlatform()) {
+  if (env.XDG_STATE_HOME) return join(env.XDG_STATE_HOME, 'lattice', 'runtime-errors.json');
+  if (platform === 'win32') return join(windowsLocalAppData(env), 'Lattice', 'runtime-errors', 'runtime-errors.json');
+  return join(env.HOME || homedir(), '.local', 'state', 'lattice', 'runtime-errors.json');
 }
 
 function canonicalReporting(value) {
@@ -76,13 +94,47 @@ function canonicalReporting(value) {
   return !value.enabled || (value.endpoint !== undefined && value.credential_file !== undefined);
 }
 
-// このOSで収集に対応するか。Windowsはstoreの所有者と権限をPOSIXの形で確かめられない（`ensureSafeDir`）ので
-// 対応しない。設定が有効でも記録は作らず、工場へは`disabled`でなく`unsupported`と答える——設定は有効なのに
-// 製品が黙って無効と答えると、受け側は故障と区別できない。
-const collectionSupported = (options = {}) => (options.platform ?? hostPlatform()) !== 'win32';
+// このOSで収集に対応するか。対応しないOSでは、設定が有効でも記録は作らず、`disabled`でなく`unsupported`と
+// 答える——設定は有効なのに製品が黙って無効と答えると、受け側は故障と区別できない。
+const collectionSupported = (options = {}) => SUPPORTED_OS.includes(options.platform ?? hostPlatform());
 const inactiveCollection = (options = {}) => (collectionSupported(options) ? 'disabled' : 'unsupported');
 
+export function runtimeErrorCollectionSupported(options = {}) {
+  return collectionSupported(options);
+}
+
+export function runtimeErrorReportingConfigPath(env = process.env, platform = hostPlatform()) {
+  if (env.XDG_CONFIG_HOME) return join(env.XDG_CONFIG_HOME, 'lattice', 'runtime-error-reporting.json');
+  if (platform === 'win32') return join(windowsLocalAppData(env), 'Lattice', 'runtime-error-reporting.json');
+  return join(env.HOME || homedir(), '.config', 'lattice', 'runtime-error-reporting.json');
+}
+
+/**
+ * Lattice自身の送信設定（ADR 0193）。端末で`runtime-errors reporting enable`を打った時だけ有効になる。
+ * `LATTICE_RUNTIME_ERROR_REPORTING=0`は既定の置き場を読まない——試験と自動化が、その端末の本物の設定を
+ * 拾って送信しないための口。`options.reportingConfigPath`を明示した呼び出しはそのfileを読む。
+ */
+export function runtimeErrorReportingEnabled(options = {}) {
+  if (!collectionSupported(options)) return false;
+  const env = options.env ?? process.env;
+  if (options.reportingConfigPath === undefined && env.LATTICE_RUNTIME_ERROR_REPORTING === '0') return false;
+  try {
+    const path = options.reportingConfigPath ?? runtimeErrorReportingConfigPath(env);
+    const stats = lstatSync(path);
+    if (!stats.isFile() || stats.isSymbolicLink()) return false;
+    const config = JSON.parse(readFileSync(path, 'utf8'));
+    return plain(config) && exact(config, ['schema', 'enabled'])
+      && config.schema === REPORTING_CONFIG_SCHEMA && config.enabled === true;
+  } catch {
+    return false;
+  }
+}
+
 function collectionEnabled(options = {}) {
+  return factoryCollectionEnabled(options) || runtimeErrorReportingEnabled(options);
+}
+
+function factoryCollectionEnabled(options = {}) {
   if (!collectionSupported(options)) return false;
   const env = options.env ?? process.env;
   try {
@@ -140,18 +192,63 @@ function assertPosix(info, mode) {
   if ((info.mode & 0o777) !== mode || (typeof process.getuid === 'function' && info.uid !== process.getuid())) throw Error('store_unsafe');
 }
 
-function ensureSafeDir(dir) {
-  if (hostPlatform() === 'win32') throw Error('store_unsafe');
+const windows = () => hostPlatform() === 'win32';
+
+/**
+ * Windowsのフォルダが本人・SYSTEM・Administratorsだけのもので、親からの継承を切ってあるか確かめる。
+ * 作ったばかりのフォルダは親の権限を継いでいるので、絞る。ただし、他のaccountが触れる形なのに中身がある
+ * フォルダは、その中身を信用できないので、絞らずに止める。
+ */
+function ensureWindowsDirOwnerOnly(dir) {
+  const sid = windowsSelfSid();
+  const settled = (sddl) => daclIsOwnerOnly(sddl, sid) && daclIsProtected(sddl);
+  const current = readWindowsDacl(dir, dir);
+  if (settled(current)) return;
+  if (!daclIsOwnerOnly(current, sid) && readdirSync(dir).some((name) => !isAclScratchName(name))) throw Error('store_unsafe');
+  restrictWindowsDirToOwner(dir, sid);
+  if (!settled(readWindowsDacl(dir, dir))) throw Error('store_unsafe');
+}
+
+export function ensureSafeDir(dir) {
   mkdirSync(dir, { recursive: true, mode: 0o700 });
   const stats = lstatSync(dir);
+  // Windowsのjunctionも`isSymbolicLink`で落ちる。
   if (!stats.isDirectory() || stats.isSymbolicLink()) throw Error('store_unsafe');
-  assertPosix(stats, 0o700);
+  if (windows()) ensureWindowsDirOwnerOnly(dir);
+  else assertPosix(stats, 0o700);
 }
 
-function ensureSafeFile(path) {
+/**
+ * `scratchDir`はWindowsだけが使う: DACLの読み取りが出力fileを置くフォルダ。既定はそのfileのフォルダ。
+ * storeの外のfile（合鍵）を確かめる時は、絞ってあるstoreのフォルダを渡す。
+ */
+export function ensureSafeFile(path, scratchDir = dirname(path)) {
   const stats = lstatSync(path);
   if (!stats.isFile() || stats.isSymbolicLink()) throw Error('store_unsafe');
-  assertPosix(statSync(path), 0o600);
+  if (!windows()) {
+    assertPosix(statSync(path), 0o600);
+    return;
+  }
+  const sid = windowsSelfSid();
+  // 出力fileを置くフォルダを他のaccountが書けるなら、読んだDACLを信用できない。先にそれを確かめる。
+  if (!daclIsOwnerOnly(readWindowsDacl(scratchDir, scratchDir), sid)
+    || !daclIsOwnerOnly(readWindowsDacl(path, scratchDir), sid)) throw Error('store_unsafe');
+}
+
+/**
+ * 一時fileを本番の名前へ置き換える。Windowsは、読み手が開いている宛先へのrenameを一時的に断るので、
+ * 少し待って繰り返す（`fs-publish.mjs`と同じ事情）。
+ */
+export function replaceStoreFile(source, destination) {
+  for (let attempt = 0; ; attempt++) {
+    try {
+      renameSync(source, destination);
+      return;
+    } catch (error) {
+      if (!windows() || !['EPERM', 'EACCES', 'EBUSY'].includes(error?.code) || attempt >= 7) throw error;
+      sleepSync(Math.min(64, 2 ** attempt));
+    }
+  }
 }
 
 const RECORD_KEYS = Object.freeze(['product', 'product_version', 'component', 'error_code', 'message_template', 'severity', 'fingerprint', 'count', 'first_seen', 'last_seen', 'state_schema_version', 'os', 'arch', 'status', 'resolved_at', 'reason_code', 'sequence']);
@@ -200,8 +297,9 @@ function writeStore(path, store) {
   const temporary = join(dirname(path), `.runtime-errors-${process.pid}-${randomBytes(6).toString('hex')}`);
   try {
     writeFileSync(temporary, `${JSON.stringify(store)}\n`, { mode: 0o600, flag: 'wx' });
-    assertPosix(statSync(temporary), 0o600);
-    renameSync(temporary, path);
+    // Windowsの一時fileはフォルダの権限を引き継ぐ。置き換えた後の`ensureSafeFile`が確かめる。
+    if (!windows()) assertPosix(statSync(temporary), 0o600);
+    replaceStoreFile(temporary, path);
     ensureSafeFile(path);
   } finally {
     rmSync(temporary, { force: true });
@@ -221,9 +319,15 @@ function lock(path, fn) {
       writeFileSync(lockPath, `${process.pid}\n`, { mode: 0o600, flag: 'wx' });
       break;
     } catch (error) {
-      if (!plain(error) || error.code !== 'EEXIST') throw error;
+      // Windowsは、消している最中のlockと同じ名前の作成を`EEXIST`でなく`EPERM`で断る。
+      if (!plain(error) || !(error.code === 'EEXIST' || (windows() && ['EPERM', 'EACCES'].includes(error.code)))) throw error;
       let age = 0;
-      try { age = Date.now() - lstatSync(lockPath).mtimeMs; } catch { continue; }
+      try {
+        age = Date.now() - lstatSync(lockPath).mtimeMs;
+      } catch {
+        if (Date.now() >= deadline) throw Error('store_locked');
+        continue;
+      }
       // crash残置lockの恒久ロックを避ける唯一の明示救済。閾値未満は正当な並行writerとして待つ。
       if (age > LOCK_STALE_MS) { try { unlinkSync(lockPath); } catch {} continue; }
       if (Date.now() >= deadline) throw Error('store_locked');

package/src/windows-owner-only.mjs

@@ -0,0 +1,95 @@
+import { spawnSync } from 'node:child_process';
+import { randomBytes } from 'node:crypto';
+import { readFileSync, rmSync } from 'node:fs';
+import { join } from 'node:path';
+
+/**
+ * Windowsで「本人・SYSTEM・Administratorsだけが触れる」ことを確かめる（ADR 0194）。
+ *
+ * POSIXのmode・uidに当たるものがWindowsには無いので、DACL（誰に何を許すかの一覧）を読む。
+ * - 読み方は`icacls <path> /save <file>`。SDDLという、表示言語に依らない形で返る。
+ *   `icacls <path>`の画面表示は名前が表示言語で変わるので使わない。
+ * - 自分のSIDは`whoami /user`で得る。どちらも`%SystemRoot%\System32`の実物を絶対pathで呼ぶ
+ *   ——PATHに置かれた同名のprogramへ答えを作らせない。
+ * - 所有者は読まない（`icacls`は返さない）。空のフォルダを絞る時に所有者を本人へ替える。
+ */
+
+const SELF_SID = /^S-1-[0-9]+(?:-[0-9]+)+$/;
+const SYSTEM_SID = 'S-1-5-18';
+const ADMINISTRATORS_SID = 'S-1-5-32-544';
+const COMMAND_TIMEOUT_MS = 10_000;
+// `icacls /save`の出力fileの名前。フォルダが空かを見る時、同時に走る別processのこのfileは数えない。
+const SCRATCH_NAME = /^\.acl-\d+-[0-9a-f]{12}$/;
+
+let cachedSelfSid = null;
+
+function systemTool(name, env = process.env) {
+  return join(env.SystemRoot || env.SYSTEMROOT || 'C:\\Windows', 'System32', name);
+}
+
+function run(tool, args) {
+  const result = spawnSync(systemTool(tool), args, { encoding: 'utf8', windowsHide: true, timeout: COMMAND_TIMEOUT_MS });
+  if (result.error || result.status !== 0) throw Error('store_unsafe');
+  return result.stdout;
+}
+
+/** このprocessを動かしている利用者のSID。process中は変わらないので1回だけ聞く。 */
+export function windowsSelfSid() {
+  if (cachedSelfSid === null) {
+    const sid = run('whoami.exe', ['/user', '/fo', 'csv', '/nh']).trim().split(',').at(-1).replaceAll('"', '');
+    if (!SELF_SID.test(sid)) throw Error('store_unsafe');
+    cachedSelfSid = sid;
+  }
+  return cachedSelfSid;
+}
+
+/**
+ * SDDLのDACLが、本人・SYSTEM・Administratorsへの許可だけで出来ているか。
+ * 読めない形（DACL無し・拒否・条件つき・object用のACE）はすべて「確かめられない」として通さない。
+ */
+export function daclIsOwnerOnly(sddl, selfSid) {
+  if (typeof sddl !== 'string' || !SELF_SID.test(selfSid)) return false;
+  const match = /^D:(?:P|AR|AI)*((?:\([^()]*\))+)$/.exec(sddl);
+  if (match === null) return false;
+  const trusted = new Set([selfSid, 'SY', SYSTEM_SID, 'BA', ADMINISTRATORS_SID]);
+  return match[1].slice(1, -1).split(')(').every((ace) => {
+    const fields = ace.split(';');
+    return fields.length === 6 && fields[0] === 'A' && fields[3] === '' && fields[4] === '' && trusted.has(fields[5]);
+  });
+}
+
+/** 親からの継承を切ってあるか（`P`）。切ってあれば、親の権限が後から変わっても降りてこない。 */
+export function daclIsProtected(sddl) {
+  return typeof sddl === 'string' && /^D:(?:AR|AI)*P/.test(sddl);
+}
+
+export const isAclScratchName = (name) => SCRATCH_NAME.test(name);
+
+/**
+ * `path`のDACLをSDDLで読む。`icacls`はfileへしか書き出せないので、出力は`scratchDir`へ置いてすぐ消す。
+ * `scratchDir`には、他のaccountが書けないフォルダ（絞ったstoreのフォルダ）を渡す——他のaccountが書ける
+ * 場所へ置くと、読む前に中身を書き換えられる。
+ */
+export function readWindowsDacl(path, scratchDir) {
+  const scratch = join(scratchDir, `.acl-${process.pid}-${randomBytes(6).toString('hex')}`);
+  try {
+    run('icacls.exe', [path, '/save', scratch]);
+    const lines = readFileSync(scratch, 'utf16le').replaceAll('\ufeff', '').split(/\r?\n/).filter((line) => line !== '');
+    // 1行目が名前、2行目がSDDL。それ以外の形は読めなかったものとして扱う。
+    if (lines.length !== 2) throw Error('store_unsafe');
+    return lines[1];
+  } finally {
+    rmSync(scratch, { force: true });
+  }
+}
+
+/**
+ * フォルダを本人・SYSTEM・Administratorsだけに絞る。親からの継承を切り、所有者を本人にする。
+ * 中に作るfileはこの権限を引き継ぎ、renameで置き換えた後も保たれる。
+ * 誰かがそのフォルダへ直接足した権限は消さない——呼び出し側が絞った後のDACLを読み直して、残っていれば止める。
+ */
+export function restrictWindowsDirToOwner(dir, selfSid) {
+  const sids = [...new Set([selfSid, SYSTEM_SID, ADMINISTRATORS_SID])];
+  run('icacls.exe', [dir, '/inheritance:r', '/grant:r', ...sids.map((sid) => `*${sid}:(OI)(CI)F`)]);
+  run('icacls.exe', [dir, '/setowner', `*${selfSid}`]);
+}