scene-capability-engine 3.6.38 → 3.6.44

package/docs/zh/releases/v3.6.41.md

@@ -0,0 +1,20 @@
+# v3.6.41 发布说明
+
+发布日期：2026-03-13
+
+## 重点变化
+
+- 完成了一轮务实的 SCE 接管清理，仓库当前已经与 takeover baseline 对齐，活跃代码路径的命名也统一回到了 SCE。
+- 修复协作分配元数据写入逻辑，新写入统一持久化 `sceInstance`，同时继续兼容读取旧的 `kiroInstance` 元数据。
+- 清理了备份、adoption、bootstrap、spec gate、auto runtime、repo config、CLI 初始化等活跃模块中的高价值 legacy 命名漂移，但没有破坏刻意保留的 `.kiro` 迁移兼容层。
+
+## 验证
+
+- `npx jest tests/unit/collab/collab-manager.test.js tests/unit/adoption/strategy-selector.test.js tests/unit/adoption/adoption-logger.test.js tests/unit/adoption.test.js --runInBand`
+- `node bin/sce.js workspace takeover-audit --json`
+
+## 发布说明
+
+- 这次发布刻意只做“有价值清理”，不是全仓盲目重命名。真正的 `.kiro` legacy migration 支持仍然保留。
+- 运行时规范命名现在以 `hasSceDir` 和 `sceInstance` 为准；对历史项目状态和旧元数据所需的兼容别名仍然继续支持。
+- 仓库内并不存在实际的 `.kiro-workspaces` 运行时目录遗留；本次交付主要消化的是活跃命名债和一个真实的协作元数据写入缺陷。

package/docs/zh/releases/v3.6.42.md

@@ -0,0 +1,19 @@
+# v3.6.42 发布说明
+
+发布日期：2026-03-13
+
+## 重点变化
+
+- 加固了 handoff release preflight：当发布过程里 `release-gate-history.json` 临时不可用，但当前 `release-gate-*.json` 已生成时，发布仍可继续判定。
+- 提升了 release-gate history 加载的容错性，单个异常 report 或 seed entry 现在会被告警跳过，而不是直接打断整个 gate-index 构建。
+- 补强了发布工作流诊断信息：当 history index 生成失败时，会把 `gate-index` 的 stderr 一并落到 release evidence 中。
+
+## 验证
+
+- `npx jest tests/unit/commands/auto.test.js --runInBand --testNamePattern "preflight-check|falls back to latest release gate report when history index is empty"`
+- `npx jest tests/unit/auto/handoff-release-gate-history-loaders-service.test.js --runInBand`
+
+## 发布说明
+
+- 这个补丁版直接针对 `v3.6.41` 发布工作流失败链路，重点修复的是 history index 构建失败后又把 publish 阻断的路径。
+- 发布门槛本身没有放松，只是在当前 gate report 已经存在时提供了安全回退，并补上真实上游错误的诊断暴露。

package/docs/zh/releases/v3.6.43.md

@@ -0,0 +1,17 @@
+# v3.6.43 发布说明
+
+发布日期：2026-03-13
+
+## 重点变化
+
+- 修复了 `v3.6.42` 暴露出的第二层发布阻断问题：当 drift 只有 advisory alert、没有 `drift-blocked runs` 时，不再让 `Enforce handoff preflight hard gate` 失败。
+- 再次补强了发布工作流可观测性：如果 preflight gate 失败，现在会把生成出来的 JSON 直接打印到 Actions 日志里。
+
+## 验证
+
+- `npx jest tests/unit/commands/auto.test.js --runInBand --testNamePattern "preflight-check|advisory drift alerts without blocked runs|falls back to latest release gate report when history index is empty"`
+
+## 发布说明
+
+- `v3.6.42` 修的是 history 缺失链路，但同时暴露出另一个策略缺陷：advisory drift alert 被误当成了 hard blocker。
+- `v3.6.43` 把 hard gate 收敛回真正应该阻断发布的条件：最新 release gate 失败，或 history 中存在 drift-blocked runs。

package/docs/zh/releases/v3.6.44.md

@@ -0,0 +1,17 @@
+# v3.6.44 发布说明
+
+发布日期：2026-03-13
+
+## 重点变化
+
+- 修复了 GitHub Actions tag 发布工作流中的最后一个阻断点：当声明交付文件都已被跟踪且工作区干净时，spec delivery sync 现在允许 detached `HEAD` 的 release checkout 通过。
+
+## 验证
+
+- `npx jest tests/unit/workspace/spec-delivery-audit.test.js --runInBand`
+- `npx jest tests/unit/commands/auto.test.js --runInBand --testNamePattern "preflight-check|advisory drift alerts without blocked runs|falls back to latest release gate report when history index is empty"`
+
+## 发布说明
+
+- 这个补丁版专门针对 GitHub Actions 的 `v*` tag push 发布场景；该场景天然是 detached `HEAD`，本来就不具备 branch upstream tracking。
+- 声明文件是否已跟踪、工作区是否干净、是否缺文件这些真正的交付完整性校验仍然继续强制执行；放开的只是该发布环境下无意义的 upstream 证明。

package/lib/adoption/adoption-logger.js

@@ -307,7 +307,7 @@ class AdoptionLogger {
    */
   detectionResult(state) {
     this.info('Project state detected', {
-      hasKiroDir: state.hasKiroDir,
+      hasSceDir: state.hasSceDir !== undefined ? state.hasSceDir : state.hasKiroDir,
       hasVersionFile: state.hasVersionFile,
       currentVersion: state.currentVersion,
       targetVersion: state.targetVersion,

package/lib/adoption/adoption-strategy.js

@@ -34,7 +34,7 @@ class AdoptionStrategy {
    * @param {string} projectPath - Absolute path to project root
    * @returns {string}
    */
-  getKiroPath(projectPath) {
+  getScePath(projectPath) {
     return path.join(projectPath, this.sceDir);
   }
 
@@ -65,17 +65,17 @@ class AdoptionStrategy {
   /**
    * Creates initial directory structure
    * 
-   * @param {string} kiroPath - Path to .sce/ directory
+   * @param {string} scePath - Path to .sce/ directory
    * @returns {Promise<void>}
    */
-  async createDirectoryStructure(kiroPath) {
-    await ensureDirectory(kiroPath);
-    await ensureDirectory(path.join(kiroPath, 'specs'));
-    await ensureDirectory(path.join(kiroPath, 'steering'));
-    await ensureDirectory(path.join(kiroPath, 'tools'));
-    await ensureDirectory(path.join(kiroPath, 'config'));
-    await ensureDirectory(path.join(kiroPath, 'backups'));
-    await ensureDirectory(path.join(kiroPath, 'hooks'));
+  async createDirectoryStructure(scePath) {
+    await ensureDirectory(scePath);
+    await ensureDirectory(path.join(scePath, 'specs'));
+    await ensureDirectory(path.join(scePath, 'steering'));
+    await ensureDirectory(path.join(scePath, 'tools'));
+    await ensureDirectory(path.join(scePath, 'config'));
+    await ensureDirectory(path.join(scePath, 'backups'));
+    await ensureDirectory(path.join(scePath, 'hooks'));
   }
 
   /**
@@ -90,7 +90,7 @@ class AdoptionStrategy {
    */
   async copyTemplateFiles(projectPath, options = {}) {
     const { overwrite = false, skip = [], resolutionMap = {} } = options;
-    const kiroPath = this.getKiroPath(projectPath);
+    const scePath = this.getScePath(projectPath);
     const templatePath = this.getTemplatePath();
     
     const created = [];
@@ -144,7 +144,7 @@ class AdoptionStrategy {
       }
       
       const sourcePath = path.join(templatePath, file);
-      const destPath = path.join(kiroPath, file);
+      const destPath = path.join(scePath, file);
       
       // Check if source exists
       const sourceExists = await pathExists(sourcePath);
@@ -208,11 +208,11 @@ class FreshAdoption extends AdoptionStrategy {
     const warnings = [];
     
     try {
-      const kiroPath = this.getKiroPath(projectPath);
+      const scePath = this.getScePath(projectPath);
       
       // Check if .sce/ already exists
-      const kiroExists = await pathExists(kiroPath);
-      if (kiroExists) {
+      const sceExists = await pathExists(scePath);
+      if (sceExists) {
         throw new Error('.sce/ directory already exists - use partial or full adoption');
       }
       
@@ -230,7 +230,7 @@ class FreshAdoption extends AdoptionStrategy {
       }
       
       // Create directory structure
-      await this.createDirectoryStructure(kiroPath);
+      await this.createDirectoryStructure(scePath);
       filesCreated.push('.sce/');
       filesCreated.push('.sce/specs/');
       filesCreated.push('.sce/steering/');
@@ -299,16 +299,16 @@ class PartialAdoption extends AdoptionStrategy {
     const warnings = [];
     
     try {
-      const kiroPath = this.getKiroPath(projectPath);
+      const scePath = this.getScePath(projectPath);
       
       // Check if .sce/ exists
-      const kiroExists = await pathExists(kiroPath);
-      if (!kiroExists) {
+      const sceExists = await pathExists(scePath);
+      if (!sceExists) {
         throw new Error('.sce/ directory does not exist - use fresh adoption');
       }
       
       // Check if version.json exists
-      const versionPath = path.join(kiroPath, 'version.json');
+      const versionPath = path.join(scePath, 'version.json');
       const versionExists = await pathExists(versionPath);
       if (versionExists) {
         warnings.push('version.json already exists - use full adoption for upgrades');
@@ -328,12 +328,12 @@ class PartialAdoption extends AdoptionStrategy {
       }
       
       // Ensure all required directories exist
-      const specsPath = path.join(kiroPath, 'specs');
-      const steeringPath = path.join(kiroPath, 'steering');
-      const toolsPath = path.join(kiroPath, 'tools');
-      const configPath = path.join(kiroPath, 'config');
-      const backupsPath = path.join(kiroPath, 'backups');
-      const hooksPath = path.join(kiroPath, 'hooks');
+      const specsPath = path.join(scePath, 'specs');
+      const steeringPath = path.join(scePath, 'steering');
+      const toolsPath = path.join(scePath, 'tools');
+      const configPath = path.join(scePath, 'config');
+      const backupsPath = path.join(scePath, 'backups');
+      const hooksPath = path.join(scePath, 'hooks');
       
       if (!await pathExists(specsPath)) {
         await ensureDirectory(specsPath);
@@ -437,11 +437,11 @@ class FullAdoption extends AdoptionStrategy {
     const warnings = [];
     
     try {
-      const kiroPath = this.getKiroPath(projectPath);
+      const scePath = this.getScePath(projectPath);
       
       // Check if .sce/ exists
-      const kiroExists = await pathExists(kiroPath);
-      if (!kiroExists) {
+      const sceExists = await pathExists(scePath);
+      if (!sceExists) {
         throw new Error('.sce/ directory does not exist - use fresh adoption');
       }
       

package/lib/adoption/detection-engine.js

@@ -31,8 +31,8 @@ class DetectionEngine {
    */
   async analyze(projectPath) {
     try {
-      const kiroPath = path.join(projectPath, this.sceDir);
-      const hasKiroDir = await pathExists(kiroPath);
+      const scePath = path.join(projectPath, this.sceDir);
+      const hasSceDir = await pathExists(scePath);
       
       let hasVersionFile = false;
       let hasSpecs = false;
@@ -41,9 +41,9 @@ class DetectionEngine {
       let existingVersion = null;
       let steeringDetection = null;
       
-      if (hasKiroDir) {
+      if (hasSceDir) {
         // Check for version.json
-        const versionPath = path.join(kiroPath, this.versionFile);
+        const versionPath = path.join(scePath, this.versionFile);
         hasVersionFile = await pathExists(versionPath);
         
         if (hasVersionFile) {
@@ -57,7 +57,7 @@ class DetectionEngine {
         }
         
         // Check for specs/
-        const specsPath = path.join(kiroPath, this.specsDir);
+        const specsPath = path.join(scePath, this.specsDir);
         hasSpecs = await pathExists(specsPath);
         
         // Check for steering/ using SteeringManager
@@ -65,7 +65,7 @@ class DetectionEngine {
         hasSteering = steeringDetection.hasExistingSteering;
         
         // Check for tools/
-        const toolsPath = path.join(kiroPath, this.toolsDir);
+        const toolsPath = path.join(scePath, this.toolsDir);
         hasTools = await pathExists(toolsPath);
       }
       
@@ -73,10 +73,11 @@ class DetectionEngine {
       const projectType = await this.detectProjectType(projectPath);
       
       // Detect conflicts (only if we're going to add template files)
-      const conflicts = hasKiroDir ? await this.detectConflicts(projectPath) : [];
+      const conflicts = hasSceDir ? await this.detectConflicts(projectPath) : [];
       
       return {
-        hasKiroDir,
+        hasSceDir,
+        hasKiroDir: hasSceDir,
         hasVersionFile,
         hasSpecs,
         hasSteering,
@@ -98,8 +99,9 @@ class DetectionEngine {
    * @returns {AdoptionMode} - 'fresh', 'partial', or 'full'
    */
   determineStrategy(result) {
+    const hasSceDir = result && result.hasSceDir !== undefined ? result.hasSceDir : result.hasKiroDir;
     // Fresh adoption: no .sce/ directory
-    if (!result.hasKiroDir) {
+    if (!hasSceDir) {
       return 'fresh';
     }
     
@@ -152,7 +154,7 @@ class DetectionEngine {
     const conflicts = [];
     
     try {
-      const kiroPath = path.join(projectPath, this.sceDir);
+      const scePath = path.join(projectPath, this.sceDir);
       
       // Define template files that might conflict
       const templateFiles = [
@@ -177,7 +179,7 @@ class DetectionEngine {
       ];
       
       for (const templateFile of templateFiles) {
-        const filePath = path.join(kiroPath, templateFile);
+        const filePath = path.join(scePath, templateFile);
         const exists = await pathExists(filePath);
         
         if (exists) {
@@ -249,12 +251,13 @@ class DetectionEngine {
    */
   getSummary(result) {
     const lines = [];
+    const hasSceDir = result && result.hasSceDir !== undefined ? result.hasSceDir : result.hasKiroDir;
     
     lines.push('Project Analysis:');
     lines.push(`  Project Type: ${result.projectType}`);
-    lines.push(`  .sce/ Directory: ${result.hasKiroDir ? 'Yes' : 'No'}`);
+    lines.push(`  .sce/ Directory: ${hasSceDir ? 'Yes' : 'No'}`);
     
-    if (result.hasKiroDir) {
+    if (hasSceDir) {
       lines.push(`  version.json: ${result.hasVersionFile ? 'Yes' : 'No'}`);
       if (result.existingVersion) {
         lines.push(`  Current Version: ${result.existingVersion}`);

package/lib/adoption/smart-orchestrator.js

@@ -317,10 +317,10 @@ class SmartOrchestrator {
 
     } else if (mode === 'smart-adopt' || mode === 'smart-update') {
       // Check which template files exist and differ
-      const kiroPath = path.join(projectPath, '.sce');
+      const scePath = path.join(projectPath, '.sce');
       
       for (const templateFile of templateFiles) {
-        const filePath = path.join(kiroPath, templateFile);
+        const filePath = path.join(scePath, templateFile);
         const fs = require('fs-extra');
         
         if (await fs.pathExists(filePath)) {
@@ -340,7 +340,7 @@ class SmartOrchestrator {
       }
 
       // Always preserve CURRENT_CONTEXT.md if it exists
-      const currentContextPath = path.join(kiroPath, 'steering/CURRENT_CONTEXT.md');
+      const currentContextPath = path.join(scePath, 'steering/CURRENT_CONTEXT.md');
       const fs = require('fs-extra');
       if (await fs.pathExists(currentContextPath)) {
         plan.filesToPreserve.push('steering/CURRENT_CONTEXT.md');

package/lib/adoption/strategy-selector.js

@@ -31,7 +31,11 @@ const AdoptionMode = {
  */
 class ProjectState {
   constructor(data = {}) {
-    this.hasKiroDir = data.hasKiroDir !== undefined ? data.hasKiroDir : false;
+    this.hasSceDir = data.hasSceDir !== undefined
+      ? data.hasSceDir
+      : (data.hasKiroDir !== undefined ? data.hasKiroDir : false);
+    // Backward-compatible alias for older callers/tests.
+    this.hasKiroDir = this.hasSceDir;
     this.hasVersionFile = data.hasVersionFile !== undefined ? data.hasVersionFile : false;
     this.currentVersion = data.currentVersion !== undefined ? data.currentVersion : null;
     this.targetVersion = data.targetVersion !== undefined ? data.targetVersion : null;
@@ -61,22 +65,22 @@ class StrategySelector {
    * @returns {Promise<ProjectState>} - Comprehensive project state
    */
   async detectProjectState(projectPath) {
-    const kiroPath = path.join(projectPath, '.sce');
-    const versionPath = path.join(kiroPath, 'version.json');
-    const specsPath = path.join(kiroPath, 'specs');
-    const steeringPath = path.join(kiroPath, 'steering');
-    const toolsPath = path.join(kiroPath, 'tools');
+    const scePath = path.join(projectPath, '.sce');
+    const versionPath = path.join(scePath, 'version.json');
+    const specsPath = path.join(scePath, 'specs');
+    const steeringPath = path.join(scePath, 'steering');
+    const toolsPath = path.join(scePath, 'tools');
 
     // Get target version from package.json
     const packageJson = require('../../package.json');
     const targetVersion = packageJson.version;
 
     // Check directory existence
-    const hasKiroDir = await this.fs.pathExists(kiroPath);
-    const hasVersionFile = hasKiroDir && await this.fs.pathExists(versionPath);
-    const hasSpecs = hasKiroDir && await this.fs.pathExists(specsPath);
-    const hasSteering = hasKiroDir && await this.fs.pathExists(steeringPath);
-    const hasTools = hasKiroDir && await this.fs.pathExists(toolsPath);
+    const hasSceDir = await this.fs.pathExists(scePath);
+    const hasVersionFile = hasSceDir && await this.fs.pathExists(versionPath);
+    const hasSpecs = hasSceDir && await this.fs.pathExists(specsPath);
+    const hasSteering = hasSceDir && await this.fs.pathExists(steeringPath);
+    const hasTools = hasSceDir && await this.fs.pathExists(toolsPath);
 
     // Read current version if available
     let currentVersion = null;
@@ -103,7 +107,7 @@ class StrategySelector {
 
     // Detect potential conflicts (files that exist and might be overwritten)
     const conflicts = [];
-    if (hasKiroDir) {
+    if (hasSceDir) {
       const templateFiles = [
         'steering/CORE_PRINCIPLES.md',
         'steering/ENVIRONMENT.md',
@@ -116,7 +120,7 @@ class StrategySelector {
       ];
 
       for (const templateFile of templateFiles) {
-        const filePath = path.join(kiroPath, templateFile);
+        const filePath = path.join(scePath, templateFile);
         if (await this.fs.pathExists(filePath)) {
           conflicts.push(templateFile);
         }
@@ -124,7 +128,7 @@ class StrategySelector {
     }
 
     return new ProjectState({
-      hasKiroDir,
+      hasSceDir,
       hasVersionFile,
       currentVersion,
       targetVersion,
@@ -144,7 +148,7 @@ class StrategySelector {
    */
   selectMode(state) {
     // No .sce/ directory - fresh adoption
-    if (!state.hasKiroDir) {
+    if (!state.hasSceDir) {
       return AdoptionMode.FRESH;
     }
 

package/lib/adoption/template-sync.js

@@ -59,7 +59,7 @@ class TemplateSync {
       errors: []        // Files that couldn't be compared
     };
 
-    const kiroPath = path.join(projectPath, '.sce');
+    const scePath = path.join(projectPath, '.sce');
 
     for (const templateFile of this.templateFiles) {
       try {
@@ -72,7 +72,7 @@ class TemplateSync {
           continue;
         }
 
-        const projectFilePath = path.join(kiroPath, templateFile);
+        const projectFilePath = path.join(scePath, templateFile);
         const templateFilePath = path.join(templatePath, templateFile);
 
         // Check if template file exists
@@ -323,7 +323,7 @@ class TemplateSync {
 
     const synced = [];
     const errors = [];
-    const kiroPath = path.join(projectPath, '.sce');
+    const scePath = path.join(projectPath, '.sce');
 
     // Sync missing files
     for (const missing of report.differences.missing) {

package/lib/auto/autonomous-engine.js

@@ -69,25 +69,25 @@ class AutonomousEngine {
     const fs = require('fs-extra');
     
     // Check for .sce directory (接管标志)
-    const kiroDir = path.join(process.cwd(), '.sce');
-    if (!await fs.pathExists(kiroDir)) {
+    const sceDir = path.join(process.cwd(), '.sce');
+    if (!await fs.pathExists(sceDir)) {
       throw new Error('CORE_PRINCIPLES violation: .sce directory not found. Project not adopted by sce.');
     }
     
     // Check for version.json
-    const versionFile = path.join(kiroDir, 'version.json');
+    const versionFile = path.join(sceDir, 'version.json');
     if (!await fs.pathExists(versionFile)) {
       console.warn('Warning: version.json not found. Consider running sce adoption.');
     }
     
     // Check for specs directory
-    const specsDir = path.join(kiroDir, 'specs');
+    const specsDir = path.join(sceDir, 'specs');
     if (!await fs.pathExists(specsDir)) {
       await fs.ensureDir(specsDir);
     }
     
     // Check for steering directory
-    const steeringDir = path.join(kiroDir, 'steering');
+    const steeringDir = path.join(sceDir, 'steering');
     if (!await fs.pathExists(steeringDir)) {
       console.warn('Warning: steering directory not found.');
     }

package/lib/auto/handoff-release-gate-history-loaders-service.js

@@ -426,7 +426,19 @@ async function loadAutoHandoffReleaseGateReports(projectPath, dirCandidate = nul
       warnings.push(`skip invalid release gate payload: ${reportFile}`);
       continue;
     }
-    entries.push(buildAutoHandoffReleaseGateHistoryEntry(payload, { projectPath, file: reportFile, tag: parseAutoHandoffReleaseGateTag(path.basename(reportFile)) }, dependencies));
+    try {
+      entries.push(buildAutoHandoffReleaseGateHistoryEntry(
+        payload,
+        {
+          projectPath,
+          file: reportFile,
+          tag: parseAutoHandoffReleaseGateTag(path.basename(reportFile))
+        },
+        dependencies
+      ));
+    } catch (error) {
+      warnings.push(`skip invalid release gate report entry: ${reportFile} (${error.message})`);
+    }
   }
 
   return {
@@ -459,13 +471,21 @@ async function loadAutoHandoffReleaseGateHistorySeed(projectPath, fileCandidate
     };
   }
   const list = Array.isArray(payload && payload.entries) ? payload.entries : [];
-  const entries = list
+  const warnings = [];
+  const entries = [];
+  list
     .filter(item => item && typeof item === 'object' && !Array.isArray(item))
-    .map(item => buildAutoHandoffReleaseGateHistoryEntry(item, { projectPath }, dependencies));
+    .forEach((item, index) => {
+      try {
+        entries.push(buildAutoHandoffReleaseGateHistoryEntry(item, { projectPath }, dependencies));
+      } catch (error) {
+        warnings.push(`skip invalid gate history entry #${index + 1}: ${error.message}`);
+      }
+    });
   return {
     file: filePath,
     entries,
-    warnings: []
+    warnings
   };
 }
 

package/lib/auto/handoff-run-service.js

@@ -13,6 +13,8 @@ async function runAutoHandoff(projectPath, options = {}, dependencies = {}) {
     loadGovernanceReleaseGateSignals,
     completeAutoHandoffRunPhase,
     evaluateAutoHandoffOntologyGateReasons,
+    auditSpecDeliverySync,
+    evaluateAutoHandoffSpecDeliveryGateReasons,
     evaluateAutoHandoffReleaseGatePreflightGateReasons,
     failAutoHandoffRunPhase,
     buildAutoHandoffMoquiBaselineSnapshot,
@@ -63,6 +65,7 @@ async function runAutoHandoff(projectPath, options = {}, dependencies = {}) {
     observability_snapshot: null,
     spec_status: null,
     ontology_validation: null,
+    spec_delivery_sync: null,
     moqui_baseline: null,
     scene_package_batch: null,
     moqui_capability_coverage: null,
@@ -92,6 +95,9 @@ async function runAutoHandoff(projectPath, options = {}, dependencies = {}) {
       result.ontology_validation = evaluateHandoffOntologyValidation(
         plan && plan.handoff ? plan.handoff.ontology_validation : null
       );
+      result.spec_delivery_sync = await auditSpecDeliverySync(projectPath, {
+        requireManifest: false
+      });
       result.template_diff = await buildAutoHandoffTemplateDiff(projectPath, { manifest: options.manifest });
       result.release_gate_preflight = buildAutoHandoffReleaseGatePreflight(
         await loadGovernanceReleaseGateSignals(projectPath)
@@ -110,6 +116,15 @@ async function runAutoHandoff(projectPath, options = {}, dependencies = {}) {
       completeAutoHandoffRunPhase(precheckPhase, {
         validation: plan.validation,
         phase_count: Array.isArray(plan.phases) ? plan.phases.length : 0,
+        spec_delivery_sync: result.spec_delivery_sync
+          ? {
+            manifest_count: result.spec_delivery_sync.summary
+              ? result.spec_delivery_sync.summary.manifest_count
+              : 0,
+            passed: result.spec_delivery_sync.passed === true,
+            reason: result.spec_delivery_sync.reason || null
+          }
+          : null,
         template_compatibility: result.template_diff.compatibility,
         release_gate_preflight: {
           available: result.release_gate_preflight.available,
@@ -139,6 +154,28 @@ async function runAutoHandoff(projectPath, options = {}, dependencies = {}) {
       if (ontologyGateReasons.length > 0) {
         throw new Error(`handoff ontology validation gate failed: ${ontologyGateReasons.join('; ')}`);
       }
+      const specDeliveryGateReasons = evaluateAutoHandoffSpecDeliveryGateReasons(
+        result.policy,
+        result.spec_delivery_sync
+      );
+      if (specDeliveryGateReasons.length > 0) {
+        throw new Error(`handoff spec delivery sync gate failed: ${specDeliveryGateReasons.join('; ')}`);
+      }
+      if (
+        result.policy.require_spec_delivery_sync !== true &&
+        result.spec_delivery_sync &&
+        result.spec_delivery_sync.reason !== 'no-manifests' &&
+        result.spec_delivery_sync.passed !== true
+      ) {
+        const advisoryReasons = Array.isArray(result.spec_delivery_sync.violations)
+          ? result.spec_delivery_sync.violations
+          : [];
+        if (advisoryReasons.length > 0) {
+          result.warnings.push(
+            `spec delivery sync advisory: ${advisoryReasons.join('; ')}`
+          );
+        }
+      }
       const releaseGatePreflightReasons = evaluateAutoHandoffReleaseGatePreflightGateReasons(
         result.policy,
         result.release_gate_preflight