scene-capability-engine 3.5.2 → 3.6.2

package/CHANGELOG.md

@@ -7,6 +7,34 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.2] - 2026-03-04
+
+### Changed
+- Release default test gate now runs integration tests only (`npm run test:release`) for faster online publish verification.
+- `prepublishOnly` now uses `test:release` instead of `test:full`.
+- GitHub `release.yml` test job now runs integration-only release tests and skips coverage in release path.
+- Studio task-stream schema now includes normalized task-intent fields (`title_norm`, `raw_request`, `sub_goals`, `acceptance_criteria`, `needs_split`, `confidence`) while preserving existing task fields for compatibility.
+- Added version CLI integration coverage (`tests/integration/version-cli.integration.test.js`) to ensure `--version` output remains deterministic and package-aligned.
+
+## [3.6.0] - 2026-03-04
+
+### Added
+- SQLite-backed SCE state store (`.sce/state/sce-state.sqlite`) for scene/spec/task-ref/event runtime governance.
+- Hierarchical task reference registry (`SS.PP.TT`) persisted in SQLite (`task_ref_registry` table).
+- New task reference commands:
+  - `sce task ref --scene <scene-id> --spec <spec-id> --task <task-id> --json`
+  - `sce task show --ref <SS.PP.TT> --json`
+  - `sce task rerun --ref <SS.PP.TT> [--dry-run] --json`
+- New module: `lib/task/task-ref-registry.js`.
+- New state-store unit tests for sqlite-only backend enforcement and fallback gating.
+
+### Changed
+- Studio task-stream payload now includes `taskRef` at root level and `task.ref` in `task` object.
+- Studio `task.summary` now carries task reference context for UI traceability.
+- Studio event stream persistence switched to SQLite (`studio_event_stream`) as the single source of truth.
+- CLI now registers a dedicated `task` command group (`claim/unclaim/list/status/ref/show/rerun`).
+- State backend selection now enforces sqlite-only runtime policy (no legacy file backend branch).
+
 ## [3.5.2] - 2026-03-03
 
 ### Added

package/README.md

@@ -129,19 +129,29 @@ SCE is tool-agnostic and works with Codex, Claude Code, Cursor, Windsurf, VS Cod
   - `sce workspace takeover-apply --json`
 
 Studio task-stream output contract (default):
-- IDs: `sessionId`, `sceneId`, `specId`, `taskId`, `eventId`
-- Task: `task.goal`, `task.status`, `task.summary` (3-line), `task.handoff`, `task.next_action`
+- IDs: `sessionId`, `sceneId`, `specId`, `taskId`, `taskRef`, `eventId`
+- Task: `task.task_ref`, `task.title_norm`, `task.raw_request`, `task.goal`, `task.sub_goals`, `task.acceptance_criteria`, `task.needs_split`, `task.confidence`, `task.status`, `task.summary` (3-line), `task.handoff`, `task.next_action`
 - File refs: `task.file_changes[]` with `path`, `line`, `diffRef`
 - Command logs: `task.commands[]` with `cmd`, `exit_code`, `stdout`, `stderr`, `log_path`
 - Errors: `task.errors[]` with `message`, `error_bundle` (copy-ready)
 - Evidence: `task.evidence[]`
 - Raw audit stream: `event[]` (and `studio events` keeps `events[]` compatibility field)
 - OpenHands bridge: `sce studio events --openhands-events <path>` maps OpenHands raw events into the same task contract (`source_stream=openhands`)
+- Hierarchical task reference operations:
+  - `sce task ref --scene <scene-id> --spec <spec-id> --task <task-id> --json`
+  - `sce task show --ref <SS.PP.TT> --json`
+  - `sce task rerun --ref <SS.PP.TT> [--dry-run] --json`
+- Runtime governance state store policy:
+  - SQLite-only backend (`.sce/state/sce-state.sqlite`)
+  - In-memory fallback only in `NODE_ENV=test` or when `SCE_STATE_ALLOW_MEMORY_FALLBACK=1`
+  - Outside those conditions, unavailable SQLite support fails fast for task-ref/event persistence
 
 ---
 
 ## Important Version Changes
 
+- `3.6.2`: Added release-level version integration tests (`tests/integration/version-cli.integration.test.js`) and switched release default verification to integration-only gate (`npm run test:release`) for faster publish feedback.
+- `3.6.0`: Added hierarchical task references (`taskRef`, format `SS.PP.TT`) backed by SQLite state store `.sce/state/sce-state.sqlite`, plus new task commands (`sce task ref/show/rerun`) for reference lookup and deterministic rerun.
 - `3.5.2`: Introduced task-stream output contract for Studio commands (`sessionId/sceneId/specId/taskId/eventId`, structured `task.*` fields, `event[]` audit stream) and added OpenHands raw-event bridge via `sce studio events --openhands-events <path>`.
 - `3.5.1`: Enforced stricter Studio intake defaults (`--manual-spec` and `--no-spec-governance` blocked unless policy override), added historical spec scene backfill command (`sce studio backfill-spec-scenes`) and persisted override mapping (`.sce/spec-governance/spec-scene-overrides.json`) for portfolio/related-spec alignment.
 - `3.5.0`: Added Studio automatic goal intake + scene spec portfolio governance (`sce studio intake`, `sce studio portfolio`), including default intake policy baseline and governance artifacts for bounded scene spec growth.
@@ -191,5 +201,5 @@ MIT. See [LICENSE](LICENSE).
 
 ---
 
-**Version**: 3.5.2  
-**Last Updated**: 2026-03-03
+**Version**: 3.6.2  
+**Last Updated**: 2026-03-04

package/README.zh.md

@@ -129,19 +129,29 @@ SCE 对工具无锁定，可接入 Codex、Claude Code、Cursor、Windsurf、VS
   - `sce workspace takeover-apply --json`
 
 Studio 任务流输出契约（默认）：
-- ID 字段：`sessionId`、`sceneId`、`specId`、`taskId`、`eventId`
-- 任务主体：`task.goal`、`task.status`、`task.summary`（固定三行）、`task.handoff`、`task.next_action`
+- ID 字段：`sessionId`、`sceneId`、`specId`、`taskId`、`taskRef`、`eventId`
+- 任务主体：`task.task_ref`、`task.title_norm`、`task.raw_request`、`task.goal`、`task.sub_goals`、`task.acceptance_criteria`、`task.needs_split`、`task.confidence`、`task.status`、`task.summary`（固定三行）、`task.handoff`、`task.next_action`
 - 文件引用：`task.file_changes[]`（`path`、`line`、`diffRef`）
 - 命令执行：`task.commands[]`（`cmd`、`exit_code`、`stdout`、`stderr`、`log_path`）
 - 错误复制：`task.errors[]`（`message`、`error_bundle`，可直接复制给 AI 修复）
 - 证据引用：`task.evidence[]`
 - 原始审计流：`event[]`（`studio events` 同时保留 `events[]` 兼容字段）
 - OpenHands 桥接：`sce studio events --openhands-events <path>` 可将 OpenHands 原始事件映射为同一 task 契约（`source_stream=openhands`）
+- 分层任务引用操作：
+  - `sce task ref --scene <scene-id> --spec <spec-id> --task <task-id> --json`
+  - `sce task show --ref <SS.PP.TT> --json`
+  - `sce task rerun --ref <SS.PP.TT> [--dry-run] --json`
+- 运行时治理状态库策略：
+  - 仅支持 SQLite 后端（`.sce/state/sce-state.sqlite`）
+  - 仅在 `NODE_ENV=test` 或 `SCE_STATE_ALLOW_MEMORY_FALLBACK=1` 时允许内存回退
+  - 在上述条件之外若 SQLite 不可用，任务引用/事件持久化会快速失败
 
 ---
 
 ## 重要版本变更
 
+- `3.6.2`：新增发布版本号集成测试（`tests/integration/version-cli.integration.test.js`），并将发布默认验证切换为仅 integration 门禁（`npm run test:release`），加速发布反馈。
+- `3.6.0`：新增分层任务引用（`taskRef`，格式 `SS.PP.TT`），持久化到 SQLite 状态库 `.sce/state/sce-state.sqlite`；新增 `sce task ref/show/rerun` 用于引用查询与可重放执行。
 - `3.5.2`：新增 Studio 任务流输出契约（`sessionId/sceneId/specId/taskId/eventId`、结构化 `task.*` 字段、`event[]` 审计流），并新增 OpenHands 原始事件桥接能力：`sce studio events --openhands-events <path>`。
 - `3.5.1`：默认强化 Studio intake 治理（`--manual-spec`、`--no-spec-governance` 在未显式放开策略时会被阻断），新增历史 spec 场景回填命令 `sce studio backfill-spec-scenes`，并写入 `.sce/spec-governance/spec-scene-overrides.json` 以统一 portfolio 与 related-spec 的场景映射。
 - `3.5.0`：新增 Studio 目标自动 intake + 场景 spec 组合治理（`sce studio intake`、`sce studio portfolio`），并默认启用 intake 策略基线与治理快照产物，控制场景内 spec 无序增长。
@@ -191,5 +201,5 @@ MIT，见 [LICENSE](LICENSE)。
 
 ---
 
-**版本**：3.5.2  
-**最后更新**：2026-03-03
+**版本**：3.6.2  
+**最后更新**：2026-03-04

package/bin/scene-capability-engine.js

@@ -23,6 +23,7 @@ const { registerSpecDomainCommand } = require('../lib/commands/spec-domain');
 const { registerSpecRelatedCommand } = require('../lib/commands/spec-related');
 const { registerTimelineCommands } = require('../lib/commands/timeline');
 const { registerValueCommands } = require('../lib/commands/value');
+const { registerTaskCommands } = require('../lib/commands/task');
 const VersionChecker = require('../lib/version/version-checker');
 const {
   findLegacyKiroDirectories,
@@ -943,6 +944,7 @@ registerOrchestrateCommands(program);
 
 // Value realization and observability commands
 registerValueCommands(program);
+registerTaskCommands(program);
 
 // Template management commands
 const templatesCommand = require('../lib/commands/templates');

package/docs/command-reference.md

@@ -3,7 +3,7 @@
 > Quick reference for all `sce` commands
 
 **Version**: 3.5.2
-**Last Updated**: 2026-03-03
+**Last Updated**: 2026-03-04
 
 ---
 
@@ -181,10 +181,26 @@ sce task claim <spec-name> <task-id>
 # Unclaim a task
 sce task unclaim <spec-name> <task-id>
 
-# Show task status
+# List claimed tasks
+sce task list <spec-name>
 sce task status <spec-name>
+
+# Resolve or create hierarchical task reference (scene.spec.task)
+sce task ref --scene <scene-id> --spec <spec-id> --task <task-id> --json
+
+# Show task mapping from hierarchical ref
+sce task show --ref <SS.PP.TT> --json
+
+# Rerun by hierarchical ref (dry-run preview)
+sce task rerun --ref <SS.PP.TT> --dry-run --json
 ```
 
+Task references and studio runtime events are persisted in SQLite state store:
+- `.sce/state/sce-state.sqlite`
+- Backend policy: SQLite only (no file-backend mode).
+- In-memory fallback is restricted to `NODE_ENV=test` or `SCE_STATE_ALLOW_MEMORY_FALLBACK=1`.
+- If SQLite runtime support is unavailable outside fallback conditions, `task ref/show/rerun` and `studio events` persistence operations fail fast.
+
 ### Context & Prompts
 
 ```bash
@@ -570,14 +586,17 @@ SCE_STUDIO_REQUIRE_AUTH=1 SCE_STUDIO_AUTH_PASSWORD=top-secret sce studio apply -
 ```
 
 Studio JSON output now includes a stable UI-oriented task stream contract (in addition to existing `job_*` fields):
-- root IDs: `sessionId`, `sceneId`, `specId`, `taskId`, `eventId`
-- `task.goal`, `task.status`, `task.summary` (fixed 3-line summary), `task.handoff`, `task.next_action`
+- root IDs: `sessionId`, `sceneId`, `specId`, `taskId`, `taskRef`, `eventId`
+- `task.task_ref`, `task.title_norm`, `task.raw_request`, `task.goal`, `task.sub_goals`, `task.acceptance_criteria`, `task.needs_split`, `task.confidence`, `task.status`, `task.summary` (fixed 3-line summary), `task.handoff`, `task.next_action`
 - `task.file_changes[]`: `path`, `line`, `diffRef`
 - `task.commands[]`: `cmd`, `exit_code`, `stdout`, `stderr`, `log_path`
 - `task.errors[]`: `message`, `error_bundle` (copy-ready diagnostic bundle)
 - `task.evidence[]`: structured evidence references
 - `event[]`: raw audit event stream (`studio events` also keeps legacy `events[]` for compatibility)
 - `studio events --openhands-events <path>` switches `source_stream=openhands` and maps OpenHands raw events to the same task contract fields.
+- hierarchical task reference lookup/rerun:
+  - `sce task show --ref <SS.PP.TT> --json`
+  - `sce task rerun --ref <SS.PP.TT> [--dry-run] --json`
 
 Stage guardrails are enforced by default:
 - `plan` requires `--scene`; SCE binds one active primary session per scene

package/docs/release-checklist.md

@@ -7,10 +7,10 @@
 ## 1. Functional Verification
 
 ```bash
-# Fast CI smoke suite (integration-focused)
-npm run test:smoke
+# Default release test gate (integration-only)
+npm run test:release
 
-# Full regression suite (unit + integration + properties)
+# Optional full regression suite (unit + integration + properties)
 npm run test:full
 
 # Guardrail: fail on newly introduced .skip tests

package/docs/zh/release-checklist.md

@@ -7,10 +7,10 @@
 ## 1. 功能验证
 
 ```bash
-# 快速 CI 冒烟（integration 为主）
-npm run test:smoke
+# 默认发布测试门禁（仅 integration）
+npm run test:release
 
-# 全量回归（unit + integration + properties）
+# 可选全量回归（unit + integration + properties）
 npm run test:full
 
 # 防回归：禁止新增 .skip 测试