kld-sdd 2.6.13 → 2.6.14

package/README.md

@@ -69,7 +69,7 @@ node skywalk-sdd/log.cjs semantic-status --project=. --change=<name>
 node skywalk-sdd/log.cjs semantic-observe --project=. --change=<name>
 ```
 
-`propose/spec/design/task` 在文档写入完成时就必须同步工作态 JSON，不等待 Check 或 Archive。各阶段的 `stage_end` 会自动执行一次 reconcile 作为无 Hook 环境的兜底；Skill 中的显式 `semantic-reconcile` 与该兜底幂等。每份 Markdown 的结构化结果写入 `openspec/changes/<name>/artifacts/<原相对路径>.ontology.json`，`openspec/changes/<name>/artifact-index.json` 与 `working-ontology.json` 提供统一索引与全量工作态视图；这些文件随 change 目录一起提交和归档。`skywalk-sdd/state/ontology/` 仅保留 revision 指针与跨进程锁，默认不提交。
+`propose/spec/design/task` 在文档写入完成时就必须同步工作态 JSON，不等待 Check 或 Archive。各阶段的 `stage_end` 会自动执行一次 reconcile 作为无 Hook 环境的兜底；Skill 中的显式 `semantic-reconcile` 与该兜底幂等。每份 Markdown 的结构化结果写入 `openspec/changes/<name>/artifacts/<原相对路径>.ontology.json`，聚合索引与全量工作态写入 `openspec/changes/<name>/ontology/`（含 `artifact-index.json`、`working-ontology.json` 等）；这些文件随 change 目录一起提交和归档。`skywalk-sdd/state/ontology/` 仅保留 revision 指针与跨进程锁，默认不提交。
 
 工作态 JSON 使用 `kld-sdd-working-artifact-facts/v1`，明确标记 `canonical=false` 和 `review_status=draft|pending`。它用于当前 Change 的渐进式展开、定向查询和跨文档校验，不能直接入知识库。Check 重新解析原文、校验并在全部通过时生成 pending revision；Archive 再次对账后才确认、转换为 `canonical-facts.json` 并打包。
 
@@ -83,7 +83,7 @@ node skywalk-sdd/log.cjs semantic-observe --project=. --change=<name>
 | `full` | 强制 STMT→AC→Design→Task 全链和 Task DAG |
 | `strict` | 在 full 基础上要求完整语义来源 |
 
-同一 Change 的作者阶段同步、observe、reconcile、check 和 archive 共用跨进程事务锁。`working-ontology.json`、diagnostics、file index、artifact index 及所有分文件 JSON 在 change 目录内原子提交，随后切换 `skywalk-sdd/state/ontology/<change>/current.json` 指针；读取时会拒绝任一文件缺失或 revision 撕裂。
+同一 Change 的作者阶段同步、observe、reconcile、check 和 archive 共用跨进程事务锁。`ontology/working-ontology.json`、diagnostics、file index、artifact index 及所有分文件 JSON 在 change 目录内原子提交，随后切换 `skywalk-sdd/state/ontology/<change>/current.json` 指针；读取时会拒绝任一文件缺失或 revision 撕裂。
 
 Archive 使用两阶段事务：先复制到 staging，从 staging 重新解析正文并生成本体快照、canonical facts、转换报告和 v2 manifest，所有步骤成功后才切换为正式 archive。归档完成后同时生成相邻的 `<日期>-<name>.zip`，其中 `archive-manifest.json` 的文件清单和 SHA-256 必须精确覆盖包内文件，可直接交给知识库消费。语义校验、快照、协议转换、打包或 Spec 同步失败时，活动 Change 会保留或恢复，不留下伪 confirmed 半成品。
 
@@ -286,11 +286,13 @@ your-project/
 │   └── changes/
 │       └── <name>/
 │           ├── proposal.md
-│           ├── working-ontology.json
-│           ├── artifact-index.json
-│           ├── diagnostics.json
-│           ├── file-index.json
-│           ├── ontology-identities.json
+│           ├── ontology/
+│           │   ├── working-ontology.json
+│           │   ├── artifact-index.json
+│           │   ├── diagnostics.json
+│           │   ├── file-index.json
+│           │   ├── ontology-identities.json
+│           │   └── continuity-resolution.json
 │           └── artifacts/
 │               ├── proposal.ontology.json
 │               └── specs/<capability>/

package/kld-sdd-guide.html

@@ -680,7 +680,7 @@ npx kld-sdd --version">复制</button>
         <div class="top"><span class="idx">01</span><h3>opsx-propose <span class="arg">&lt;变更名称&gt;</span></h3><span class="role">Why · 业务意图</span></div>
         <p>创建业务意图文档，明确“为什么做”。除痛点、目标、影响模块与约束外，还会让你确认 <b>Full / Simple 模式、测试策略和 change-type</b>（config / document / report / composite / other），并写入稳定的 <code>change-id</code>。</p>
         <p>若提供 REQ / FEAT 外部编号，会通过 <code>opsx-ontology-query</code> 做 Continuity 查询，识别新增、延续或迭代能力；不会把本地 archive 当成跨迭代权威。</p>
-        <div class="out">proposal.md + artifacts/proposal.ontology.json + working-ontology.json</div>
+        <div class="out">proposal.md + artifacts/proposal.ontology.json + ontology/working-ontology.json</div>
       </div>
 
       <div class="skill reveal" id="sk-spec" style="border-left-color:#38bdf8">
@@ -824,7 +824,7 @@ npx kld-sdd --version">复制</button>
       <article class="feature-card reveal">
         <div class="eyebrow">Materialize</div>
         <h3>写完即生成工作态事实</h3>
-        <p>propose/spec/design/task 每次写入后立即 reconcile，产出 <code>artifacts/**/*.ontology.json</code>、<code>artifact-index.json</code> 与 <code>working-ontology.json</code>，状态为 draft/pending，尚不能直接入库。</p>
+        <p>propose/spec/design/task 每次写入后立即 reconcile，产出 <code>artifacts/**/*.ontology.json</code>、<code>ontology/artifact-index.json</code> 与 <code>ontology/working-ontology.json</code>，状态为 draft/pending，尚不能直接入库。</p>
       </article>
       <article class="feature-card reveal">
         <div class="eyebrow">Traceability</div>
@@ -913,9 +913,8 @@ node skywalk-sdd/log.cjs semantic-observe --project=. --change=add-user-auth">
 │       │   ├── <span class="file">proposal.md</span>        <span class="cmt"># mode / change-id / change-type / test-strategy</span>
 │       │   ├── <span class="dir">specs/&lt;capability&gt;/</span> <span class="cmt"># Full：spec / design / tasks</span>
 │       │   ├── <span class="file">spec · design · tasks.md</span> <span class="cmt"># Simple：根目录三文档</span>
-│       │   ├── <span class="file">working-ontology.json</span>
-│       │   ├── <span class="dir">artifact-index/ · diagnostics/ · file-index/</span>
-│       │   ├── <span class="dir">ontology-identities/ · artifacts/**/*.ontology.json</span>
+│       │   ├── <span class="dir">ontology/</span>          <span class="cmt"># working-ontology · artifact-index · diagnostics · file-index · identities · continuity-resolution</span>
+│       │   ├── <span class="dir">artifacts/**/*.ontology.json</span>
 │       │   └── <span class="file">logs/execution-log.md</span>
 │       └── <span class="dir">archive/</span>
 │           ├── <span class="dir">&lt;date&gt;-&lt;name&gt;/</span>

package/lib/init.js

@@ -831,18 +831,14 @@ function deployTelemetryDataDir(targetCwd = process.cwd()) {
     console.log(`   ⚠️  V3 指标模块源文件缺失: ${metricsV3Src}（report/metrics 可能无法加载 metrics-v3）`);
   }
 
-  const runtimeMetadataSrc = path.join(pkgPath, 'skywalk-sdd', 'runtime-metadata.cjs');
+  const packageVersion = require(path.join(pkgPath, 'package.json')).version;
   const runtimeMetadataDst = path.join(dataDir, 'runtime-metadata.cjs');
-  if (fs.existsSync(runtimeMetadataSrc)) {
-    fs.copyFileSync(runtimeMetadataSrc, runtimeMetadataDst);
-    const packageVersion = require(path.join(pkgPath, 'package.json')).version;
-    fs.writeFileSync(path.join(dataDir, 'runtime-metadata.json'), `${JSON.stringify({
-      schema_version: 'kld-sdd-runtime-metadata/v1',
-      package_name: '@hunterzheng/kld-sdd',
-      version: packageVersion,
-    }, null, 2)}\n`, 'utf8');
-    console.log(`   ✓ 部署 kld-sdd 运行时身份（${packageVersion}）`);
-  }
+  fs.writeFileSync(
+    runtimeMetadataDst,
+    `'use strict';\nmodule.exports = { resolveRuntimeMetadata() { return { version: '${packageVersion}', producer: 'kld-sdd@${packageVersion}' }; } };\n`,
+    'utf8',
+  );
+  console.log(`   ✓ 部署 kld-sdd 运行时身份（${packageVersion}）`);
 
   const reportingSrc = path.join(pkgPath, 'skywalk-sdd', 'reporting');
   const reportingDst = path.join(dataDir, 'reporting');
@@ -887,6 +883,7 @@ function deployTelemetryDataDir(targetCwd = process.cwd()) {
   console.log('   ✓ openspec: node skywalk-sdd/openspec-shim.cjs list（自动 cd 到 *-sdd-specs）');
   console.log('   ✓ Spec Context: node skywalk-sdd/context-client.cjs --query="<自然语言需求>" --target-stage=spec');
   console.log('   ✓ Apply worktree: record-base 在 §1.5；收尾 apply-worktree-finish.cjs --change=<name>');
+  console.log('   ℹ️  project-identity.json 将在首次配置 KB（opsx-ontology-query）时自动创建');
   console.log('✅ Telemetry 已就绪（数据存储在 skywalk-sdd/，无需配置 MCP）');
   return true;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kld-sdd",
-  "version": "2.6.13",
+  "version": "2.6.14",
   "description": "KLD SDD OpenSpec 项目初始化工具 - 一键部署 SDD skills",
   "main": "index.js",
   "bin": {

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,