scene-capability-engine 3.5.0 → 3.5.2

package/CHANGELOG.md

@@ -7,6 +7,36 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.5.2] - 2026-03-03
+
+### Added
+- Studio task-stream contract in command JSON payloads:
+  - root IDs: `sessionId`, `sceneId`, `specId`, `taskId`, `eventId`
+  - normalized task payload: `task.goal`, `task.status`, `task.summary`, `task.handoff`, `task.next_action`
+  - UI-ready arrays: `task.file_changes[]`, `task.commands[]`, `task.errors[]`, `task.evidence[]`
+  - raw audit passthrough: `event[]` (with `studio events` keeping `events[]` compatibility)
+- OpenHands bridge for task stream:
+  - `sce studio events --openhands-events <path>`
+  - supports `.json`/`.jsonl` raw OpenHands events ingestion and maps to SCE task contract fields
+
+### Changed
+- `studio verify/release` now persist `gate_steps` in stage metadata so command execution details can be surfaced in `task.commands[]` and `task.errors[]`.
+
+## [3.5.1] - 2026-03-03
+
+### Added
+- Studio historical scene backfill command:
+  - `sce studio backfill-spec-scenes`
+  - supports active-only/default batch backfill and writes `.sce/spec-governance/spec-scene-overrides.json`
+  - optionally refreshes governance artifacts after apply
+
+### Changed
+- Studio intake/governance policy is now stricter by default:
+  - `allow_manual_spec_override=false` blocks `--manual-spec` bypass unless explicitly enabled
+  - `governance.require_auto_on_plan=true` blocks `--no-spec-governance` bypass unless explicitly enabled
+- Spec governance and related-spec lookup now read scene override mappings from `.sce/spec-governance/spec-scene-overrides.json`.
+- Takeover/adoption baseline now provisions the stricter intake policy and backfill defaults.
+
 ## [3.5.0] - 2026-03-02
 
 ### Added

package/README.md

@@ -108,6 +108,8 @@ Hard rule defaults:
 - After two failed rounds on the same problem fingerprint, debug evidence is required in subsequent attempts.
 - `studio verify/release` run `problem-closure-gate` by default when a spec is bound.
 - `studio plan` auto-runs goal intake (`bind existing spec` or `create spec`) and writes scene portfolio governance snapshots by default.
+- `studio plan --manual-spec` and `--no-spec-governance` are blocked by default policy; use policy overrides only when absolutely necessary.
+- Historical specs can be scene-governed incrementally via `sce studio backfill-spec-scenes --apply` (writes `.sce/spec-governance/spec-scene-overrides.json`).
 
 ---
 
@@ -126,10 +128,22 @@ SCE is tool-agnostic and works with Codex, Claude Code, Cursor, Windsurf, VS Cod
   - `sce workspace takeover-audit --json`
   - `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`
+- 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`)
+
 ---
 
 ## Important Version Changes
 
+- `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.
 - `3.4.6`: Added default `problem-closure-gate` + `problem-contract` baseline and strengthened mandatory problem evaluation dimensions (`problem_contract`/`ontology_alignment`/`convergence`) for verify/release convergence control.
 - `3.4.5`: `git-managed-gate` now treats worktree checks as advisory in default relaxed CI mode (`CI/GITHUB_ACTIONS`, non-strict), preventing false release blocking.
@@ -177,5 +191,5 @@ MIT. See [LICENSE](LICENSE).
 
 ---
 
-**Version**: 3.5.0  
-**Last Updated**: 2026-03-02
+**Version**: 3.5.2  
+**Last Updated**: 2026-03-03

package/README.zh.md

@@ -108,6 +108,8 @@ SCE 默认按“问题域闭环”推进诊断与修复：
 - 同一问题指纹失败两轮后，后续尝试必须补充 debug 证据。
 - 当 spec 绑定时，`studio verify/release` 默认执行 `problem-closure-gate`。
 - `studio plan` 默认执行目标 intake（自动绑定已有 spec 或新建 spec），并自动写入 scene 维度的 spec 治理快照。
+- 默认策略会阻断 `studio plan --manual-spec` 与 `--no-spec-governance`（仅在确有必要且策略显式放开时可绕过）。
+- 历史 spec 可通过 `sce studio backfill-spec-scenes --apply` 分批回填到 scene 治理映射（写入 `.sce/spec-governance/spec-scene-overrides.json`）。
 
 ---
 
@@ -126,10 +128,22 @@ SCE 对工具无锁定，可接入 Codex、Claude Code、Cursor、Windsurf、VS
   - `sce workspace takeover-audit --json`
   - `sce workspace takeover-apply --json`
 
+Studio 任务流输出契约（默认）：
+- ID 字段：`sessionId`、`sceneId`、`specId`、`taskId`、`eventId`
+- 任务主体：`task.goal`、`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`）
+
 ---
 
 ## 重要版本变更
 
+- `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 无序增长。
 - `3.4.6`：新增默认 `problem-closure-gate` + `problem-contract` 基线，并强化问题评估强制维度（`problem_contract`/`ontology_alignment`/`convergence`），提升 verify/release 收敛控制。
 - `3.4.5`：`git-managed-gate` 在默认 CI 放宽模式下（`CI/GITHUB_ACTIONS` 且非 strict）对工作区变更改为告警，不再误阻断发布。
@@ -177,5 +191,5 @@ MIT，见 [LICENSE](LICENSE)。
 
 ---
 
-**版本**：3.5.0  
-**最后更新**：2026-03-02
+**版本**：3.5.2  
+**最后更新**：2026-03-03

package/docs/command-reference.md

@@ -2,8 +2,8 @@
 
 > Quick reference for all `sce` commands
 
-**Version**: 3.5.0
-**Last Updated**: 2026-03-02
+**Version**: 3.5.2
+**Last Updated**: 2026-03-03
 
 ---
 
@@ -523,8 +523,6 @@ Curated quality policy (`宁缺毋滥，优胜略汰`) defaults:
 sce studio plan --scene scene.customer-order-inventory --from-chat session-20260226 --goal "customer+order+inventory demo" --json
 # Recommended: bind spec explicitly so Studio can ingest problem-domain-chain deterministically
 sce studio plan --scene scene.customer-order-inventory --spec 01-00-customer-order-inventory --from-chat session-20260226 --goal "customer+order+inventory demo" --json
-# Disable auto intake for emergency/manual mode
-sce studio plan --scene scene.customer-order-inventory --from-chat session-20260226 --goal "customer+order+inventory demo" --manual-spec --json
 
 # Analyze intake decision only (no write by default)
 sce studio intake --scene scene.customer-order-inventory --from-chat session-20260226 --goal "optimize checkout retry flow" --json
@@ -552,6 +550,8 @@ sce studio resume --job <job-id> --json
 
 # Inspect recent stage events
 sce studio events --job <job-id> --limit 50 --json
+# Map OpenHands raw events into the same task-stream contract
+sce studio events --job <job-id> --openhands-events ./openhands-events.json --json
 
 # Rollback a job after apply/release
 sce studio rollback --job <job-id> --reason "manual-check-failed" --json
@@ -560,22 +560,42 @@ sce studio rollback --job <job-id> --reason "manual-check-failed" --json
 sce studio portfolio --json
 sce studio portfolio --scene scene.customer-order-inventory --strict --json
 
+# Backfill historical spec scene bindings into override map (active-only by default)
+sce studio backfill-spec-scenes --apply --json
+# Backfill a bounded batch from unassigned scene and refresh governance snapshot
+sce studio backfill-spec-scenes --scene scene.unassigned --limit 20 --apply --json
+
 # Enforce authorization for a protected action
 SCE_STUDIO_REQUIRE_AUTH=1 SCE_STUDIO_AUTH_PASSWORD=top-secret sce studio apply --job <job-id> --auth-password top-secret --json
 ```
 
+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`
+- `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.
+
 Stage guardrails are enforced by default:
 - `plan` requires `--scene`; SCE binds one active primary session per scene
 - `plan` runs auto intake by default (`.sce/config/studio-intake-policy.json`):
   - detect goal intent (`change_request` vs `analysis_only`)
   - resolve spec via explicit binding / scene latest / related specs / auto-create
   - auto-create spec artifacts when no suitable spec is found and policy requires tracking
+- `plan --manual-spec` is blocked by default (`allow_manual_spec_override=false`)
+- `plan --no-spec-governance` is blocked by default (`governance.require_auto_on_plan=true`)
 - `plan --spec <id>` (recommended) ingests `.sce/specs/<spec>/custom/problem-domain-chain.json` into studio job context
 - when `--spec` is omitted, `plan` auto-resolves the latest matching spec chain by `scene_id` when available
 - `plan` auto-searches related historical specs by `scene + goal` and writes top candidates into job metadata (`source.related_specs`)
 - `plan` auto-runs scene spec governance snapshot and writes:
   - `.sce/spec-governance/scene-portfolio.latest.json`
   - `.sce/spec-governance/scene-index.json`
+- historical spec scene backfill can be managed via:
+  - `sce studio backfill-spec-scenes --apply`
+  - writes `.sce/spec-governance/spec-scene-overrides.json`
 - successful `release` auto-archives current scene session and auto-opens the next scene cycle session
 - `generate` requires `plan`
 - `generate` consumes the plan-stage domain-chain context and writes chain-aware metadata/report (`.sce/reports/studio/generate-<job-id>.json`)
@@ -657,13 +677,21 @@ Studio intake policy file (default, recommended to commit): `.sce/config/studio-
   "enabled": true,
   "auto_create_spec": true,
   "force_spec_for_studio_plan": true,
+  "allow_manual_spec_override": false,
   "prefer_existing_scene_spec": true,
   "related_spec_min_score": 45,
   "governance": {
     "auto_run_on_plan": true,
+    "require_auto_on_plan": true,
     "max_active_specs_per_scene": 3,
     "stale_days": 14,
     "duplicate_similarity_threshold": 0.66
+  },
+  "backfill": {
+    "enabled": true,
+    "active_only_default": true,
+    "default_scene_id": "scene.sce-core",
+    "override_file": ".sce/spec-governance/spec-scene-overrides.json"
   }
 }
 ```