kld-sdd 2.6.13 → 2.6.15

package/skywalk-sdd/metrics-v3.cjs

@@ -1,10 +1,30 @@
 'use strict';
 
-const REPORT_SCHEMA_VERSION = 'sdd-efficiency-report/v3';
-const METRICS_CONTRACT_VERSION = '3.0';
-const CHANGE_TYPES = ['config', 'document', 'report', 'composite', 'other'];
+const REPORT_SCHEMA_VERSION = 'sdd-efficiency-report/v4';
+const METRICS_CONTRACT_VERSION = '4.0';
+const SCHEME_VERSION = 'V3.0';
+/** Writable change types (scheme 5.3). Legacy document/other read as unknown. */
+const CHANGE_TYPES = ['config', 'transaction', 'report', 'composite'];
+const LEGACY_CHANGE_TYPES = ['document', 'other'];
 const MINIMUM_METRICS = ['e1', 'q3', 'p4', 'p_r', 'p_h'];
 
+/**
+ * Format artifact byte size: <1MiB → KB, else MB; two decimals; never bare B.
+ * @param {number} bytes
+ * @returns {string}
+ */
+function formatArtifactSize(bytes) {
+  const n = Number(bytes);
+  if (!Number.isFinite(n) || n < 0) return '0.00 KB';
+  const kib = 1024;
+  const mib = 1024 * 1024;
+  if (n < mib) {
+    const kb = n / kib;
+    return `${kb.toFixed(2)} KB`;
+  }
+  return `${(n / mib).toFixed(2)} MB`;
+}
+
 const ALERT_THRESHOLDS = {
   q3: { red: 70, yellow: 85, direction: 'higher_better' },
   p4: { red: 0.4, yellow: 0.6, direction: 'higher_better' },
@@ -126,7 +146,27 @@ function countScenariosInMarkdown(text) {
 function validateChangeType(value) {
   if (typeof value !== 'string') return 'unknown';
   const normalized = value.trim().toLowerCase();
-  return CHANGE_TYPES.includes(normalized) ? normalized : 'unknown';
+  if (CHANGE_TYPES.includes(normalized)) return normalized;
+  if (LEGACY_CHANGE_TYPES.includes(normalized)) return 'unknown';
+  return 'unknown';
+}
+
+function diagnoseChangeType(value) {
+  if (typeof value !== 'string') {
+    return { change_type: 'unknown', legacy_change_type: null, warning: null };
+  }
+  const normalized = value.trim().toLowerCase();
+  if (CHANGE_TYPES.includes(normalized)) {
+    return { change_type: normalized, legacy_change_type: null, warning: null };
+  }
+  if (LEGACY_CHANGE_TYPES.includes(normalized)) {
+    return {
+      change_type: 'unknown',
+      legacy_change_type: normalized,
+      warning: `legacy_change_type:${normalized}`,
+    };
+  }
+  return { change_type: 'unknown', legacy_change_type: null, warning: 'invalid_change_type' };
 }
 
 function resolveReviewerIndependence(meta = {}) {
@@ -850,9 +890,41 @@ function buildSchemeCompliance(input = {}) {
   const minimumStatus = minimum.numeric_available === minimum.numeric_total
     ? (minimum.trusted_available === minimum.numeric_total ? 'implemented' : 'provisional')
     : 'provisional';
-  const q1Status = quality.q1_status || quality.q1_spec_conformance?.status || 'pending-upstream';
-  const q4Status = quality.q4_status || quality.q4_tdd_coverage?.status || 'pending-upstream';
-  const q3Status = quality.q3_score_status === 'verified' ? 'implemented' : 'provisional';
+  const q1Raw = quality.q1_human_status
+    || quality.q1_status
+    || quality.q1_spec_conformance?.status
+    || 'pending-upstream';
+  const q1Status = (q1Raw === 'unverified' || q1Raw === 'self-review')
+    ? 'provisional'
+    : (q1Raw === 'pending-upstream' ? 'pending-upstream' : q1Raw);
+  const q4Raw = quality.q4_status || quality.q4_tdd_coverage?.status || 'pending-upstream';
+  const q4Source = quality.q4_source || quality.q4_tdd_coverage?.source || null;
+  const q4Status = q4Source === 'conformance-fallback' || q4Raw === 'conformance-fallback'
+    ? 'pending-upstream'
+    : q4Raw;
+  const q3Independence = quality.q3_reviewer_independence || 'unknown';
+  const q3Status = quality.q3_score_status === 'verified'
+    && q3Independence === 'independent-review'
+    ? 'implemented'
+    : 'provisional';
+  const semanticParity = input.semantic_parity_status || input.semantic_parity || null;
+  const multiFormatStatus = semanticParity === 'pass'
+    ? 'implemented'
+    : (['md', 'html', 'json'].every(format => formats.includes(format)) ? 'provisional' : 'provisional');
+  const alertLoopReady = Boolean(
+    input.alert_loop
+    && input.alert_loop.root_cause
+    && input.alert_loop.owner
+    && input.alert_loop.due
+    && input.alert_loop.expected_impact
+    && input.alert_loop.two_cycle_evidence,
+  );
+  const eventContractHealth = input.evidence_contract_health
+    || input.event_contract_health
+    || null;
+  const reproducibleStatus = eventContractHealth === 'healthy' && Number(input.event_count) > 0
+    ? 'implemented'
+    : (Number(input.event_count) > 0 ? 'provisional' : 'provisional');
   const statusLabel = status => ({
     implemented: '已实现',
     provisional: '部分可用',
@@ -864,6 +936,7 @@ function buildSchemeCompliance(input = {}) {
     unknown: '未知',
     'independent-review': '独立复核',
     'self-review': '自评',
+    unverified: '未人工验证',
   }[status] || status || '未知');
 
   const items = [
@@ -886,7 +959,7 @@ function buildSchemeCompliance(input = {}) {
       label: '条件指标（Q1、Q4）',
       status: q1Status === 'pending-upstream' || q4Status === 'pending-upstream'
         ? 'pending-upstream'
-        : 'implemented',
+        : (q1Status === 'provisional' || q4Status === 'provisional' ? 'provisional' : 'implemented'),
       evidence: `Q1：${statusLabel(q1Status)}；Q4：${statusLabel(q4Status)}`,
     },
     {
@@ -899,7 +972,7 @@ function buildSchemeCompliance(input = {}) {
       requirement: 'independent-reviewer',
       label: '独立复核',
       status: q3Status,
-      evidence: `Q3：${statusLabel(quality.q3_score_status || 'provisional')}；复核方式：${statusLabel(quality.q3_reviewer_independence || 'unknown')}`,
+      evidence: `Q3：${statusLabel(quality.q3_score_status || 'provisional')}；复核方式：${statusLabel(q3Independence)}`,
     },
     {
       requirement: 'tracking-periods',
@@ -922,20 +995,30 @@ function buildSchemeCompliance(input = {}) {
     {
       requirement: 'alert-feedback-loop',
       label: '指标与证据告警闭环',
-      status: input.evidence_alerts ? 'implemented' : 'provisional',
-      evidence: input.evidence_alerts ? '稳定问题编号、未解决/已解决状态和历史记录' : '当前模型未提供告警生命周期',
+      status: alertLoopReady ? 'implemented' : 'provisional',
+      evidence: alertLoopReady
+        ? '具备根因、负责人、期限、预期影响与两周期验证'
+        : '仍缺根因/负责人/期限/预期影响/两周期验证中的完整字段',
     },
     {
       requirement: 'multi-format-same-model',
       label: 'Markdown、HTML、JSON 同源',
-      status: ['md', 'html', 'json'].every(format => formats.includes(format)) ? 'implemented' : 'provisional',
-      evidence: formats.length > 0 ? formats.map(format => ({ md: 'Markdown', html: 'HTML', json: 'JSON' }[format] || format)).join(' / ') : '格式信息未提供',
+      status: multiFormatStatus,
+      evidence: semanticParity === 'pass'
+        ? '三格式语义对账通过'
+        : (formats.length > 0
+          ? `${formats.map(format => ({ md: 'Markdown', html: 'HTML', json: 'JSON' }[format] || format)).join(' / ')} 已产出，语义对账未确认`
+          : '格式信息未提供'),
     },
     {
       requirement: 'reproducible-auditable',
       label: '可复算、可审计',
-      status: input.event_count > 0 ? 'implemented' : 'provisional',
-      evidence: input.event_count > 0 ? `${input.event_count} 条 JSONL 事件` : '未提供事件数量',
+      status: reproducibleStatus,
+      evidence: eventContractHealth === 'healthy'
+        ? `${input.event_count} 条事件且证据契约健康`
+        : (input.event_count > 0
+          ? `${input.event_count} 条 JSONL 事件；证据契约健康度未达标`
+          : '未提供事件数量'),
     },
   ];
   const counts = {};
@@ -945,6 +1028,7 @@ function buildSchemeCompliance(input = {}) {
     version: 'V3.0',
     items,
     counts,
+    evidence_contract_health: eventContractHealth || null,
   };
 }
 
@@ -1125,7 +1209,9 @@ function deriveSuccessfulReworkReason(attemptContext = {}) {
 module.exports = {
   REPORT_SCHEMA_VERSION,
   METRICS_CONTRACT_VERSION,
+  SCHEME_VERSION,
   CHANGE_TYPES,
+  LEGACY_CHANGE_TYPES,
   ALERT_THRESHOLDS,
   MINIMUM_METRICS,
   clamp,
@@ -1148,6 +1234,8 @@ module.exports = {
   findDevelopmentActivities,
   deriveSuccessfulReworkReason,
   validateChangeType,
+  diagnoseChangeType,
+  formatArtifactSize,
   createInvalidArgError,
   countScenariosInMarkdown,
 };

package/skywalk-sdd/ontology/archive-package.cjs

@@ -65,10 +65,16 @@ function ensureProjectIdentity(projectRoot) {
     }
     return existing;
   }
+  // 兜底：project-identity.json 未通过 opsx-ontology-query 配置 KB 时创建
+  // 此时 project_id 为随机值，KB 入库时会因 project_id !== spaceKey 而失败
+  console.warn('⚠️  project-identity.json 不存在 — 未通过 opsx-ontology-query 配置 KB。');
+  console.warn('⚠️  将生成临时 project_id，KB 入库时需确保与 Space spaceKey 一致。');
+  console.warn('⚠️  建议在首次使用 opsx-ontology-query 配置 KB 时自动创建正确的 project-identity.json。');
   const identity = {
     schema_version: PROJECT_IDENTITY_SCHEMA_VERSION,
     project_id: `urn:kld:sdd:project:${generateUuidV7()}`,
     created_at: new Date().toISOString(),
+    _warning: 'UNCONFIGURED — 请通过 opsx-ontology-query 配置 KB 后更新 project_id 为 Space spaceKey',
   };
   writeJson(identityPath, identity);
   return identity;

package/skywalk-sdd/ontology/identity-index.cjs

@@ -5,6 +5,10 @@ const path = require('path');
 const { parseChangeArtifacts } = require('./artifact-parser.cjs');
 const { normalizeFacts } = require('./normalizer.cjs');
 const { DIAGNOSTIC_CODES } = require('./schema.cjs');
+const {
+  ONTOLOGY_STATE_FILES,
+  resolveOntologyStateFile,
+} = require('./ontology-paths.cjs');
 
 function catalogDiagnostic(code, message, context = {}) {
   return {
@@ -97,11 +101,14 @@ function validateArchiveCandidate(candidate, facts) {
     return { eligible: false, snapshot, manifest, diagnostics };
   }
 
-  const artifactIndexPath = path.join(candidate.changeDir, 'artifact-index.json');
+  const artifactIndexPath = resolveOntologyStateFile(
+    candidate.changeDir,
+    ONTOLOGY_STATE_FILES.artifactIndex,
+  );
   if (!fs.existsSync(artifactIndexPath)) {
     diagnostics.push(catalogDiagnostic(
       DIAGNOSTIC_CODES.ARCHIVE_NOT_CONFIRMED,
-      `Archive 缺少 change 目录下的 artifact-index.json: ${candidate.change}`,
+      `Archive 缺少 change 目录下的 ontology/artifact-index.json: ${candidate.change}`,
       { file: artifactIndexPath, suggestion: '通过 KLD-SDD reconcile/archive 在 change 目录生成工作态 JSON 后再归档' },
     ));
     return { eligible: false, snapshot, manifest, diagnostics };

package/skywalk-sdd/ontology/ontology-paths.cjs

@@ -0,0 +1,73 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const ONTOLOGY_STATE_DIR = 'ontology';
+
+const ONTOLOGY_STATE_FILES = {
+  working: 'working-ontology.json',
+  diagnostics: 'diagnostics.json',
+  fileIndex: 'file-index.json',
+  artifactIndex: 'artifact-index.json',
+  identities: 'ontology-identities.json',
+  continuityResolution: 'continuity-resolution.json',
+};
+
+function ontologyStateRelative(basename) {
+  return `${ONTOLOGY_STATE_DIR}/${basename}`;
+}
+
+function changeOntologyFilePaths(changeDir) {
+  const resolved = path.resolve(changeDir);
+  const ontologyDir = path.join(resolved, ONTOLOGY_STATE_DIR);
+  return {
+    changeDir: resolved,
+    ontologyDir,
+    working: path.join(ontologyDir, ONTOLOGY_STATE_FILES.working),
+    diagnostics: path.join(ontologyDir, ONTOLOGY_STATE_FILES.diagnostics),
+    fileIndex: path.join(ontologyDir, ONTOLOGY_STATE_FILES.fileIndex),
+    artifactIndex: path.join(ontologyDir, ONTOLOGY_STATE_FILES.artifactIndex),
+    continuityResolution: path.join(ontologyDir, ONTOLOGY_STATE_FILES.continuityResolution),
+    identities: path.join(ontologyDir, ONTOLOGY_STATE_FILES.identities),
+    artifactDir: path.join(resolved, 'artifacts'),
+  };
+}
+
+function resolveOntologyStateFile(changeDir, basename) {
+  const resolved = path.resolve(changeDir);
+  const modern = path.join(resolved, ONTOLOGY_STATE_DIR, basename);
+  if (fs.existsSync(modern)) return modern;
+  const legacy = path.join(resolved, basename);
+  if (fs.existsSync(legacy)) return legacy;
+  return modern;
+}
+
+function resolveRevisionBundlePaths(changeDir) {
+  const preferred = changeOntologyFilePaths(changeDir);
+  return {
+    ...preferred,
+    working: resolveOntologyStateFile(changeDir, ONTOLOGY_STATE_FILES.working),
+    diagnostics: resolveOntologyStateFile(changeDir, ONTOLOGY_STATE_FILES.diagnostics),
+    fileIndex: resolveOntologyStateFile(changeDir, ONTOLOGY_STATE_FILES.fileIndex),
+    artifactIndex: resolveOntologyStateFile(changeDir, ONTOLOGY_STATE_FILES.artifactIndex),
+  };
+}
+
+function removeLegacyOntologyStateFiles(changeDir) {
+  const resolved = path.resolve(changeDir);
+  for (const basename of Object.values(ONTOLOGY_STATE_FILES)) {
+    const legacy = path.join(resolved, basename);
+    if (fs.existsSync(legacy)) fs.rmSync(legacy, { force: true });
+  }
+}
+
+module.exports = {
+  ONTOLOGY_STATE_DIR,
+  ONTOLOGY_STATE_FILES,
+  ontologyStateRelative,
+  changeOntologyFilePaths,
+  resolveOntologyStateFile,
+  resolveRevisionBundlePaths,
+  removeLegacyOntologyStateFiles,
+};

package/skywalk-sdd/ontology/runtime.cjs

@@ -20,6 +20,14 @@ const {
   assertChangeLock,
   releaseChangeLock,
 } = require('./change-lock.cjs');
+const {
+  ONTOLOGY_STATE_FILES,
+  ontologyStateRelative,
+  changeOntologyFilePaths,
+  resolveOntologyStateFile,
+  resolveRevisionBundlePaths,
+  removeLegacyOntologyStateFiles,
+} = require('./ontology-paths.cjs');
 
 function sha256(value) {
   return crypto.createHash('sha256').update(value).digest('hex');
@@ -31,15 +39,7 @@ function resolveChangeDir(projectRoot, changeName) {
 }
 
 function changeOntologyPaths(projectRoot, changeName) {
-  const changeDir = resolveChangeDir(projectRoot, changeName);
-  return {
-    changeDir,
-    working: path.join(changeDir, 'working-ontology.json'),
-    diagnostics: path.join(changeDir, 'diagnostics.json'),
-    fileIndex: path.join(changeDir, 'file-index.json'),
-    artifactIndex: path.join(changeDir, 'artifact-index.json'),
-    artifactDir: path.join(changeDir, 'artifacts'),
-  };
+  return changeOntologyFilePaths(resolveChangeDir(projectRoot, changeName));
 }
 
 function statePaths(projectRoot, changeName) {
@@ -160,14 +160,16 @@ function commitRevision(projectRoot, changeName, result, lock) {
   assertChangeLock(lock);
   const basePaths = statePaths(projectRoot, changeName);
   const paths = changeOntologyPaths(projectRoot, changeName);
+  const readablePaths = resolveRevisionBundlePaths(paths.changeDir);
   fs.mkdirSync(basePaths.dir, { recursive: true });
   fs.mkdirSync(paths.changeDir, { recursive: true });
+  fs.mkdirSync(paths.ontologyDir, { recursive: true });
 
-  if (fs.existsSync(paths.working)) {
-    const existing = readJson(paths.working, 'SEM_STATE_CORRUPT');
+  if (fs.existsSync(readablePaths.working)) {
+    const existing = readJson(readablePaths.working, 'SEM_STATE_CORRUPT');
     if (existing.revision === result.revision) {
-      readRevisionBundle(paths, result.revision);
-      const artifactIndex = readJson(paths.artifactIndex, 'SEM_STATE_CORRUPT');
+      readRevisionBundle(readablePaths, result.revision);
+      const artifactIndex = readJson(readablePaths.artifactIndex, 'SEM_STATE_CORRUPT');
       return {
         changed: false,
         paths: {
@@ -225,6 +227,7 @@ function commitRevision(projectRoot, changeName, result, lock) {
     atomicWriteIfChanged(path.join(paths.changeDir, artifactFile.path), fs.readFileSync(stagedPath, 'utf8'));
   }
   pruneStaleArtifacts(paths.changeDir, artifactBundle.index);
+  removeLegacyOntologyStateFiles(paths.changeDir);
   fs.rmSync(stagingDir, { recursive: true, force: true });
 
   const pointer = {
@@ -232,7 +235,7 @@ function commitRevision(projectRoot, changeName, result, lock) {
     change: safeChangeName(changeName),
     revision: result.revision,
     change_dir: path.relative(path.resolve(projectRoot), paths.changeDir).replace(/\\/g, '/'),
-    artifact_index: 'artifact-index.json',
+    artifact_index: ontologyStateRelative(ONTOLOGY_STATE_FILES.artifactIndex),
   };
   assertChangeLock(lock);
   const changed = atomicWriteIfChanged(basePaths.current, pointer);
@@ -272,9 +275,9 @@ function scanChange(projectRoot, changeName, options = {}) {
     identityHistory,
     effectiveGraph,
     projectRoot,
-    continuityResolutionPath: path.join(
+    continuityResolutionPath: resolveOntologyStateFile(
       parsed.changeDir,
-      'continuity-resolution.json',
+      ONTOLOGY_STATE_FILES.continuityResolution,
     ),
   });
   const reviewStatus = options.markPending && validation.valid ? 'pending' : 'draft';
@@ -358,16 +361,17 @@ function reconcileChange(projectRoot, changeName, options = {}) {
 function readWorkingState(projectRoot, changeName) {
   const basePaths = statePaths(projectRoot, changeName);
   const paths = changeOntologyPaths(projectRoot, changeName);
+  const readablePaths = resolveRevisionBundlePaths(paths.changeDir);
   if (fs.existsSync(basePaths.current)) {
     const pointer = readJson(basePaths.current, 'SEM_STATE_POINTER_CORRUPT');
     if (!pointer.revision || pointer.change !== safeChangeName(changeName)) {
       throw stateError('SEM_STATE_POINTER_CORRUPT', `current.json 不属于 Change ${changeName}`);
     }
-    return readRevisionBundle(paths, pointer.revision).working;
+    return readRevisionBundle(readablePaths, pointer.revision).working;
   }
-  if (!fs.existsSync(paths.working)) return null;
-  const working = readJson(paths.working, 'SEM_STATE_CORRUPT');
-  readRevisionBundle(paths, working.revision);
+  if (!fs.existsSync(readablePaths.working)) return null;
+  const working = readJson(readablePaths.working, 'SEM_STATE_CORRUPT');
+  readRevisionBundle(readablePaths, working.revision);
   return working;
 }
 
@@ -396,9 +400,12 @@ function createArchiveSnapshot(projectRoot, changeName, archiveDir, inputState)
   if (!state.facts_hash || state.facts_hash !== actualFacts.facts_hash) {
     throw new Error(`归档正文与待确认本体事实不一致: ${changeName}`);
   }
-  const artifactIndexPath = path.join(targetDir, 'artifact-index.json');
+  const artifactIndexPath = resolveOntologyStateFile(
+    targetDir,
+    ONTOLOGY_STATE_FILES.artifactIndex,
+  );
   if (!fs.existsSync(artifactIndexPath)) {
-    throw new Error(`归档目录缺少 artifact-index.json: ${targetDir}`);
+    throw new Error(`归档目录缺少 ontology/artifact-index.json: ${targetDir}`);
   }
   const artifactIndex = readJson(artifactIndexPath, 'SEM_STATE_CORRUPT');
   if (artifactIndex.revision !== state.revision) {
@@ -468,4 +475,7 @@ module.exports = {
   reconcileChange,
   readWorkingState,
   createArchiveSnapshot,
+  resolveOntologyStateFile,
+  resolveRevisionBundlePaths,
+  ONTOLOGY_STATE_FILES,
 };

package/skywalk-sdd/ontology/structural-identity.cjs

@@ -4,15 +4,20 @@ const fs = require('fs');
 const path = require('path');
 const { SCHEMA_VERSION } = require('./schema.cjs');
 const { generateUuidV7, isValidUuidV7 } = require('./id.cjs');
+const {
+  ONTOLOGY_STATE_FILES,
+  ontologyStateRelative,
+  resolveOntologyStateFile,
+} = require('./ontology-paths.cjs');
 
-const REGISTRY_FILE = 'ontology-identities.json';
+const REGISTRY_FILE = ontologyStateRelative(ONTOLOGY_STATE_FILES.identities);
 
 function registryPath(changeDir) {
   return path.join(path.resolve(changeDir), REGISTRY_FILE);
 }
 
 function readRegistry(changeDir) {
-  const filePath = registryPath(changeDir);
+  const filePath = resolveOntologyStateFile(changeDir, ONTOLOGY_STATE_FILES.identities);
   if (!fs.existsSync(filePath)) {
     return { schema_version: SCHEMA_VERSION, identities: {} };
   }
@@ -35,6 +40,10 @@ function writeRegistry(changeDir, registry) {
   const tempPath = `${filePath}.${process.pid}.tmp`;
   fs.writeFileSync(tempPath, content, 'utf8');
   fs.renameSync(tempPath, filePath);
+  const legacy = path.join(path.resolve(changeDir), ONTOLOGY_STATE_FILES.identities);
+  if (legacy !== filePath && fs.existsSync(legacy)) {
+    fs.rmSync(legacy, { force: true });
+  }
   return true;
 }
 

package/skywalk-sdd/ontology/traceability-validator.cjs

@@ -1,11 +1,18 @@
 'use strict';
 
+const path = require('path');
+const fs = require('fs');
 const {
   DIAGNOSTIC_CODES,
   normalizeProfile,
   relationDefinition,
 } = require('./schema.cjs');
 const { isValidEntityId, isValidUuid } = require('./id.cjs');
+const {
+  ONTOLOGY_STATE_FILES,
+  ontologyStateRelative,
+  resolveOntologyStateFile,
+} = require('./ontology-paths.cjs');
 
 function diagnostic(code, severity, message, context = {}) {
   return {
@@ -350,18 +357,19 @@ function validateContinuityAndExternalRefs(facts, diagnostics, options = {}) {
   const kind = String(continuity.kind || '').toLowerCase();
   const resolutionPath = options.continuityResolutionPath
     || (facts.change
-      ? require('path').join(
-        options.projectRoot || process.cwd(),
-        'openspec',
-        'changes',
-        facts.change,
-        'continuity-resolution.json',
+      ? resolveOntologyStateFile(
+        path.join(
+          options.projectRoot || process.cwd(),
+          'openspec',
+          'changes',
+          facts.change,
+        ),
+        ONTOLOGY_STATE_FILES.continuityResolution,
       )
       : '');
   let resolution = null;
   if (resolutionPath) {
     try {
-      const fs = require('fs');
       if (fs.existsSync(resolutionPath)) {
         resolution = JSON.parse(fs.readFileSync(resolutionPath, 'utf8'));
       }
@@ -392,7 +400,7 @@ function validateContinuityAndExternalRefs(facts, diagnostics, options = {}) {
         'error',
         'Continuity=iteration 但 continuity-resolution.json 缺失或仍为 pending',
         {
-          file: resolutionPath || 'continuity-resolution.json',
+          file: resolutionPath || ontologyStateRelative(ONTOLOGY_STATE_FILES.continuityResolution),
           suggestion: '在 propose/spec 完成 A/B/C 决议后再 check',
         },
       ));

package/skywalk-sdd/ontology/working-artifacts.cjs

@@ -3,6 +3,7 @@
 const crypto = require('crypto');
 const path = require('path');
 const { resolveRuntimeMetadata } = require('../runtime-metadata.cjs');
+const { ontologyStateRelative, ONTOLOGY_STATE_FILES } = require('./ontology-paths.cjs');
 
 const WORKING_ARTIFACT_SCHEMA_VERSION = 'kld-sdd-working-artifact-facts/v1';
 const ARTIFACT_INDEX_SCHEMA_VERSION = 'kld-sdd-working-artifact-index/v1';
@@ -228,7 +229,7 @@ function buildWorkingArtifactFacts(result, options = {}) {
       review_status: reviewStatus,
       valid: Boolean(result.valid),
       revision: result.revision,
-      working_ontology_path: 'working-ontology.json',
+      working_ontology_path: ontologyStateRelative(ONTOLOGY_STATE_FILES.working),
       artifacts: artifactIndex,
     },
     files: artifactFiles,