scene-capability-engine 3.6.7 → 3.6.8

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.8] - 2026-03-05
+
+### Added
+- New one-shot state command:
+  - `sce state reconcile --all --apply --json`
+  - runs `doctor -> migrate -> doctor` with before/after drift summary in one payload
+- Release workflow now runs state reconcile before reconciliation gate and uploads:
+  - `state-reconcile-<tag>.json`
+
+### Changed
+- Release workflow state reconciliation gate is now enforce-by-default (`KSE_RELEASE_STATE_MIGRATION_ENFORCE` defaults to `true`).
+- Release workflow Node runtime updated to `22.x` so sqlite-backed reconciliation can run in release pipeline.
+
 ## [3.6.7] - 2026-03-05
 
 ### Fixed

package/README.md

@@ -149,8 +149,10 @@ Studio task-stream output contract (default):
   - `sce state plan --json`
   - `sce state doctor --json`
   - `sce state migrate --all --apply --json`
+  - `sce state reconcile --all --apply --json` (doctor -> migrate -> doctor one-shot)
   - `sce state export --out .sce/reports/state-migration/state-export.latest.json --json`
   - reconciliation gate: `npm run gate:state-migration-reconciliation`
+  - release workflow defaults to enforce mode for state reconciliation gate and runs reconcile before publish
   - runtime reads now prefer sqlite indexes for timeline/scene-session views when indexed data exists
   - `state doctor` now emits `summary` and runtime diagnostics (`runtime.timeline`, `runtime.scene_session`) with read-source and consistency status
   - migratable components now include runtime + errorbook + spec-governance + release evidence indexes (`errorbook.entry-index`, `errorbook.incident-index`, `governance.spec-scene-overrides`, `governance.scene-index`, `release.evidence-runs-index`, `release.gate-history-index`)

package/README.zh.md

@@ -149,8 +149,10 @@ Studio 任务流输出契约（默认）：
   - `sce state plan --json`
   - `sce state doctor --json`
   - `sce state migrate --all --apply --json`
+  - `sce state reconcile --all --apply --json`（一键执行 doctor -> migrate -> doctor）
   - `sce state export --out .sce/reports/state-migration/state-export.latest.json --json`
   - 对账门禁：`npm run gate:state-migration-reconciliation`
+  - 发布工作流默认对 state reconciliation 启用 enforce，并在发布前执行 reconcile
   - 运行时读取在存在索引数据时优先使用 SQLite（timeline/scene-session 视图）
   - `state doctor` 新增 `summary` 与运行时诊断（`runtime.timeline`、`runtime.scene_session`），可直接读取读源与一致性状态
   - 可迁移组件扩展到 runtime + errorbook + spec-governance + release evidence 索引（`errorbook.entry-index`、`errorbook.incident-index`、`governance.spec-scene-overrides`、`governance.scene-index`、`release.evidence-runs-index`、`release.gate-history-index`）

package/docs/command-reference.md

@@ -719,6 +719,9 @@ sce state migrate --all --json
 # apply migration writes into sqlite index tables
 sce state migrate --all --apply --json
 
+# reconcile in one flow (doctor -> migrate -> doctor)
+sce state reconcile --all --apply --json
+
 # migrate specific components
 sce state migrate --component collab.agent-registry --component runtime.timeline-index --apply --json
 
@@ -756,6 +759,7 @@ SQLite index tables introduced for gradual migration:
 Runtime read preference:
 - timeline/session runtime views now prefer SQLite indexes when indexed rows exist.
 - file artifacts remain source-of-truth for content payload and recovery operations.
+- release workflow runs `state reconcile --all --apply` before reconciliation gate.
 - `sce state doctor --json` now includes:
   - `summary` aggregate (`pending_components`, `total_record_drift`, `blocking_count`, `alert_count`)
   - runtime read diagnostics (`runtime.timeline`, `runtime.scene_session`) with read-source/read-preference and consistency status

package/lib/commands/state.js

@@ -8,6 +8,7 @@ const {
   runStateDoctor,
   runStateExport
 } = require('../state/state-migration-manager');
+const { getSceStateStore } = require('../state/sce-state-store');
 
 function normalizeString(value) {
   if (typeof value !== 'string') {
@@ -147,6 +148,85 @@ async function runStateExportCommand(options = {}, dependencies = {}) {
   return payload;
 }
 
+async function runStateReconcileCommand(options = {}, dependencies = {}) {
+  const projectPath = dependencies.projectPath || process.cwd();
+  const fileSystem = dependencies.fileSystem || fs;
+  const env = dependencies.env || process.env;
+  const components = normalizeComponentInput(options.component);
+  const componentIds = options.all === true ? [] : components;
+  const apply = options.apply === true;
+  const stateStore = dependencies.stateStore || getSceStateStore(projectPath, {
+    fileSystem,
+    env
+  });
+
+  const before = await runStateDoctor({}, {
+    projectPath,
+    fileSystem,
+    env,
+    stateStore
+  });
+
+  const migration = await runStateMigration({
+    apply,
+    all: options.all === true,
+    componentIds
+  }, {
+    projectPath,
+    fileSystem,
+    env,
+    stateStore
+  });
+
+  const after = await runStateDoctor({}, {
+    projectPath,
+    fileSystem,
+    env,
+    stateStore
+  });
+
+  const beforePending = Number(before && before.summary && before.summary.pending_components) || 0;
+  const afterPending = Number(after && after.summary && after.summary.pending_components) || 0;
+  const beforeBlocking = Number(before && before.summary && before.summary.blocking_count) || 0;
+  const afterBlocking = Number(after && after.summary && after.summary.blocking_count) || 0;
+  const pendingReduced = Math.max(0, beforePending - afterPending);
+  const blockingReduced = Math.max(0, beforeBlocking - afterBlocking);
+
+  const payload = {
+    mode: 'state-reconcile',
+    success: Boolean(migration && migration.success) && afterBlocking === 0,
+    apply,
+    generated_at: new Date().toISOString(),
+    store_path: after && after.store_path ? after.store_path : null,
+    sqlite: after && after.sqlite ? after.sqlite : null,
+    migration,
+    before: {
+      summary: before && before.summary ? before.summary : null,
+      blocking: Array.isArray(before && before.blocking) ? before.blocking : [],
+      alerts: Array.isArray(before && before.alerts) ? before.alerts : []
+    },
+    after: {
+      summary: after && after.summary ? after.summary : null,
+      blocking: Array.isArray(after && after.blocking) ? after.blocking : [],
+      alerts: Array.isArray(after && after.alerts) ? after.alerts : []
+    },
+    summary: {
+      apply,
+      migrated_components: Number(migration && migration.summary && migration.summary.migrated_components) || 0,
+      migrated_records: Number(migration && migration.summary && migration.summary.migrated_records) || 0,
+      before_pending_components: beforePending,
+      after_pending_components: afterPending,
+      pending_components_reduced: pendingReduced,
+      before_blocking_count: beforeBlocking,
+      after_blocking_count: afterBlocking,
+      blocking_reduced: blockingReduced
+    }
+  };
+
+  printPayload(payload, options, 'State Reconcile');
+  return payload;
+}
+
 async function safeRun(handler, options = {}, dependencies = {}, title = 'state command') {
   try {
     await handler(options, dependencies);
@@ -199,6 +279,15 @@ function registerStateCommands(program) {
     .option('--out <path>', 'Output file path', '.sce/reports/state-migration/state-export.latest.json')
     .option('--json', 'Print machine-readable JSON output')
     .action(async (options) => safeRun(runStateExportCommand, options, {}, 'state export'));
+
+  state
+    .command('reconcile')
+    .description('Run doctor + migrate + doctor in one flow (dry-run by default)')
+    .option('--component <id>', `Component id (repeatable): ${knownIds}`, collectOptionValue, [])
+    .option('--all', 'Reconcile all known components')
+    .option('--apply', 'Apply migration writes (default is dry-run)')
+    .option('--json', 'Print machine-readable JSON output')
+    .action(async (options) => safeRun(runStateReconcileCommand, options, {}, 'state reconcile'));
 }
 
 module.exports = {
@@ -206,5 +295,6 @@ module.exports = {
   runStateDoctorCommand,
   runStateMigrateCommand,
   runStateExportCommand,
+  runStateReconcileCommand,
   registerStateCommands
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scene-capability-engine",
-  "version": "3.6.7",
+  "version": "3.6.8",
   "description": "SCE (Scene Capability Engine) - A CLI tool and npm package for spec-driven development with AI coding assistants.",
   "main": "index.js",
   "bin": {