@quolu/lattice 0.72.0 → 0.73.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quolu/lattice",
-  "version": "0.72.0",
+  "version": "0.73.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/runtime-errors.mjs

@@ -45,6 +45,9 @@ const COMMAND_KIND = /^[a-z][a-z0-9-]*(?:\.[a-z][a-z0-9-]*)?$/;
 const COMMAND_KIND_MAX = 48;
 // Nodeが付けるerror code（ENOENT・ERR_MODULE_NOT_FOUND等）だけを通す。Lattice自身のcodeや任意文字列は`none`。
 const CAUSE_CODE = /^(?:E[A-Z0-9]{2,15}|ERR_[A-Z0-9_]{1,60})$/;
+// 工場の`factory-reporter.json`が名乗る端末の種類。dotagentsの契約（lib/factory/contract.mjs）と同じ語を
+// 受ける——ここに無い語の端末は設定全体が無効とみなされ、故障を1件も記録しない。
+const HOST_PROFILES = Object.freeze(['server', 'mac', 'linux', 'wsl', 'windows-native']);
 
 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));
@@ -73,7 +76,14 @@ 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';
+const inactiveCollection = (options = {}) => (collectionSupported(options) ? 'disabled' : 'unsupported');
+
 function collectionEnabled(options = {}) {
+  if (!collectionSupported(options)) return false;
   const env = options.env ?? process.env;
   try {
     const path = options.configPath ?? defaultFactoryReporterConfigPath(env);
@@ -83,7 +93,7 @@ function collectionEnabled(options = {}) {
     return plain(config) && exact(config, ['schema_version', 'host', 'collection', 'reporting'])
       && config.schema_version === '1.0' && plain(config.host) && exact(config.host, ['id', 'profile'])
       && typeof config.host.id === 'string' && /^[a-z0-9][a-z0-9._-]{0,63}$/.test(config.host.id)
-      && ['server', 'mac', 'wsl', 'windows-native'].includes(config.host.profile)
+      && HOST_PROFILES.includes(config.host.profile)
       && plain(config.collection) && exact(config.collection, ['enabled']) && config.collection.enabled === true
       && canonicalReporting(config.reporting);
   } catch {
@@ -261,7 +271,7 @@ function snapshot(options = {}) {
     runtime_errors: rows.filter((record) => record.status === 'open').map(({ product_version, error_code, component, status, severity, fingerprint, message_template, count, first_seen, last_seen, state_schema_version, safe_context }) => ({ product_version, error_code, component, status, severity, fingerprint, message_template, occurrence_count: count, first_seen, last_seen, state_schema_version, ...(safe_context === undefined ? {} : { safe_context }) })),
     resolutions: rows.filter((record) => record.status === 'resolved').map(({ fingerprint, resolved_at, reason_code }) => ({ fingerprint, resolved_at, reason_code })),
     diagnostics: {
-      collection: enabled ? 'enabled' : 'disabled',
+      collection: enabled ? 'enabled' : inactiveCollection(options),
       status: enabled ? 'ready' : 'not_applicable',
       total_count: store.records.length,
       pending_count: store.records.filter((record) => record.sequence > store.acknowledged_through).length,
@@ -276,7 +286,7 @@ export function runtimeErrorsSnapshot(afterCursor = 0, limit = MAX_RECORDS, opti
 
 export function runtimeErrorsDiagnostics(options = {}) {
   if (!collectionEnabled(options)) {
-    return { schema: DIAGNOSTICS_SCHEMA, collection: 'disabled', status: 'not_applicable', total_count: 0, open_count: 0, pending_count: 0, high_watermark: 0, acknowledged_through: 0 };
+    return { schema: DIAGNOSTICS_SCHEMA, collection: inactiveCollection(options), status: 'not_applicable', total_count: 0, open_count: 0, pending_count: 0, high_watermark: 0, acknowledged_through: 0 };
   }
   try {
     const { path } = optionsFor(options);
@@ -297,7 +307,7 @@ export function runtimeErrorsDiagnostics(options = {}) {
 }
 
 export function recordRuntimeError(code, options = {}) {
-  if (!collectionEnabled(options)) return { status: 'disabled' };
+  if (!collectionEnabled(options)) return { status: inactiveCollection(options) };
   const definition = definitions[code];
   if (!definition) throw Error('unknown_runtime_code');
   const { path } = optionsFor(options);