scene-capability-engine 3.6.0 → 3.6.2

package/CHANGELOG.md

@@ -7,6 +7,15 @@ 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

package/README.md

@@ -130,7 +130,7 @@ SCE is tool-agnostic and works with Codex, Claude Code, Cursor, Windsurf, VS Cod
 
 Studio task-stream output contract (default):
 - IDs: `sessionId`, `sceneId`, `specId`, `taskId`, `taskRef`, `eventId`
-- Task: `task.goal`, `task.status`, `task.summary` (3-line), `task.handoff`, `task.next_action`
+- 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)
@@ -150,6 +150,7 @@ Studio task-stream output contract (default):
 
 ## 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.
@@ -200,5 +201,5 @@ MIT. See [LICENSE](LICENSE).
 
 ---
 
-**Version**: 3.6.0  
+**Version**: 3.6.2  
 **Last Updated**: 2026-03-04

package/README.zh.md

@@ -130,7 +130,7 @@ SCE 对工具无锁定，可接入 Codex、Claude Code、Cursor、Windsurf、VS
 
 Studio 任务流输出契约（默认）：
 - ID 字段：`sessionId`、`sceneId`、`specId`、`taskId`、`taskRef`、`eventId`
-- 任务主体：`task.goal`、`task.status`、`task.summary`（固定三行）、`task.handoff`、`task.next_action`
+- 任务主体：`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 修复）
@@ -150,6 +150,7 @@ Studio 任务流输出契约（默认）：
 
 ## 重要版本变更
 
+- `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 的场景映射。
@@ -200,5 +201,5 @@ MIT，见 [LICENSE](LICENSE)。
 
 ---
 
-**版本**：3.6.0  
+**版本**：3.6.2  
 **最后更新**：2026-03-04

package/docs/command-reference.md

@@ -587,7 +587,7 @@ 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`, `taskRef`, `eventId`
-- `task.goal`, `task.status`, `task.summary` (fixed 3-line summary), `task.handoff`, `task.next_action`
+- `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)

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 测试

package/lib/commands/studio.js

@@ -1336,6 +1336,129 @@ function buildTaskSummaryLines(job = {}, stageName = '', taskStatus = '', nextAc
   ];
 }
 
+function truncateTaskText(value = '', maxLength = 96) {
+  const normalized = normalizeString(value).replace(/\s+/g, ' ');
+  if (!normalized) {
+    return '';
+  }
+  if (normalized.length <= maxLength) {
+    return normalized;
+  }
+  return `${normalized.slice(0, Math.max(0, maxLength - 3)).trim()}...`;
+}
+
+function dedupeTaskList(items = [], limit = 3) {
+  const seen = new Set();
+  const result = [];
+  for (const item of items) {
+    const normalized = truncateTaskText(item, 120);
+    if (!normalized) {
+      continue;
+    }
+    const key = normalized.toLowerCase();
+    if (seen.has(key)) {
+      continue;
+    }
+    seen.add(key);
+    result.push(normalized);
+    if (result.length >= limit) {
+      break;
+    }
+  }
+  return result;
+}
+
+function splitTaskRawRequest(rawRequest = '') {
+  const normalized = normalizeString(rawRequest).replace(/\s+/g, ' ');
+  if (!normalized) {
+    return [];
+  }
+  const chunks = normalized
+    .split(/(?:\r?\n|[;；。!?！？]|(?:\s+\band\b\s+)|(?:\s+\bthen\b\s+)|(?:\s+\balso\b\s+)|(?:\s*并且\s*)|(?:\s*同时\s*)|(?:\s*以及\s*)|(?:\s*然后\s*))/gi)
+    .map((item) => normalizeString(item).replace(/^(?:and|then|also)\s+/i, ''))
+    .filter(Boolean);
+  return dedupeTaskList(chunks, 3);
+}
+
+function deriveTaskIntentShape(rawRequest = '', stageName = '') {
+  const normalizedRaw = normalizeString(rawRequest).replace(/\s+/g, ' ');
+  const clauses = splitTaskRawRequest(normalizedRaw);
+  const hasRaw = normalizedRaw.length > 0;
+  const inferredSubGoals = clauses.length > 1 ? clauses.slice(0, 3) : [];
+  const needsSplit = inferredSubGoals.length > 1;
+  const titleSource = clauses.length > 0
+    ? clauses[0]
+    : (hasRaw ? normalizedRaw : `Studio ${stageName || 'task'} execution`);
+
+  let confidence = hasRaw ? 0.9 : 0.6;
+  if (needsSplit) {
+    confidence = 0.72;
+  }
+  if (normalizeString(stageName) && normalizeString(stageName) !== 'plan') {
+    confidence = Math.min(0.95, confidence + 0.03);
+  }
+
+  return {
+    title_norm: truncateTaskText(titleSource, 96) || `Studio ${stageName || 'task'} execution`,
+    raw_request: hasRaw ? normalizedRaw : null,
+    sub_goals: inferredSubGoals,
+    needs_split: needsSplit,
+    confidence: Number(confidence.toFixed(2))
+  };
+}
+
+function buildTaskAcceptanceCriteria(stageName = '', job = {}, nextAction = '') {
+  const normalizedStage = normalizeString(stageName) || 'task';
+  const artifacts = job && job.artifacts ? job.artifacts : {};
+  const criteriaByStage = {
+    plan: [
+      'Scene/spec binding is resolved and persisted in studio job metadata.',
+      'Plan stage problem evaluation passes with no blockers.',
+      `Next action is executable (${nextAction || 'sce studio generate --job <job-id>'}).`
+    ],
+    generate: [
+      'Patch bundle id is produced for downstream apply stage.',
+      'Generate stage report is written to artifacts.',
+      `Next action is executable (${nextAction || 'sce studio apply --patch-bundle <id> --job <job-id>'}).`
+    ],
+    apply: [
+      'Authorization requirements are satisfied for apply stage.',
+      'Apply stage completes without policy blockers.',
+      `Next action is executable (${nextAction || 'sce studio verify --job <job-id>'}).`
+    ],
+    verify: [
+      'Verification gates finish with no required-step failures.',
+      `Verify report is available (${normalizeString(artifacts.verify_report) || 'artifact pending'}).`,
+      `Next action is executable (${nextAction || 'sce studio release --job <job-id>'}).`
+    ],
+    release: [
+      'Release gates pass under configured release profile.',
+      `Release reference is emitted (${normalizeString(artifacts.release_ref) || 'artifact pending'}).`,
+      `Next action is executable (${nextAction || 'complete'}).`
+    ],
+    rollback: [
+      'Rollback stage transitions job status to rolled_back.',
+      'Rollback evidence is appended to studio event stream.',
+      `Recovery next action is executable (${nextAction || 'sce studio plan --scene <scene-id> --from-chat <session>'}).`
+    ],
+    events: [
+      'Events stream payload is available for task-level audit.',
+      'Task envelope preserves normalized IDs and handoff fields.',
+      `Next action is explicit (${nextAction || 'n/a'}).`
+    ],
+    resume: [
+      'Current job status and stage progress are restored deterministically.',
+      'Task envelope remains schema-compatible for downstream UI.',
+      `Next action is explicit (${nextAction || 'n/a'}).`
+    ]
+  };
+  return criteriaByStage[normalizedStage] || [
+    'Task envelope contains normalized identifiers and task contract fields.',
+    'Task output preserves evidence, command logs, and error bundles.',
+    `Next action is explicit (${nextAction || 'n/a'}).`
+  ];
+}
+
 function buildTaskEnvelope(mode, job, options = {}) {
   const stageName = resolveTaskStage(mode, job, options.stageName);
   const stageState = stageName && job && job.stages && job.stages[stageName]
@@ -1359,8 +1482,10 @@ function buildTaskEnvelope(mode, job, options = {}) {
     || (normalizeString(job && job.job_id)
       ? `${job.job_id}:${stageName || 'task'}`
       : null);
-  const goal = normalizeString(job?.source?.goal)
+  const rawRequest = normalizeString(job?.source?.goal);
+  const goal = rawRequest
     || `Studio ${stageName || 'task'} execution`;
+  const taskIntent = deriveTaskIntentShape(rawRequest, stageName);
   const sessionId = normalizeString(job?.session?.scene_session_id) || null;
   const sceneId = normalizeString(job?.scene?.id) || null;
   const specId = normalizeString(job?.scene?.spec_id) || normalizeString(job?.source?.spec_id) || null;
@@ -1400,7 +1525,14 @@ function buildTaskEnvelope(mode, job, options = {}) {
     eventId: normalizeString(latestEvent && latestEvent.event_id) || null,
     task: {
       ref: taskRef,
+      task_ref: taskRef,
+      title_norm: taskIntent.title_norm,
+      raw_request: taskIntent.raw_request,
       goal,
+      sub_goals: taskIntent.sub_goals,
+      acceptance_criteria: buildTaskAcceptanceCriteria(stageName, job, nextAction),
+      needs_split: taskIntent.needs_split,
+      confidence: taskIntent.confidence,
       status: taskStatus,
       summary: buildTaskSummaryLines(job, stageName, taskStatus, nextAction, taskRef),
       handoff: normalizedHandoff,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scene-capability-engine",
-  "version": "3.6.0",
+  "version": "3.6.2",
   "description": "SCE (Scene Capability Engine) - A CLI tool and npm package for spec-driven development with AI coding assistants.",
   "main": "index.js",
   "bin": {
@@ -29,6 +29,7 @@
     "test:ci": "npx jest --config=jest.config.ci.js",
     "test:unit": "npx jest tests/unit",
     "test:integration": "npx jest tests/integration",
+    "test:release": "npm run test:integration -- --runInBand",
     "test:properties": "npx jest tests/properties",
     "test:orchestrator-429": "npx jest tests/orchestrator/orchestration-engine.test.js tests/orchestrator/orchestrate-command.status-events.test.js --runInBand",
     "test:handles": "npx jest --config=jest.config.js --runInBand --detectOpenHandles",
@@ -74,7 +75,7 @@
     "gate:release-asset-integrity": "node scripts/release-asset-integrity-check.js",
     "report:release-risk-remediation": "node scripts/release-risk-remediation-bundle.js --json",
     "report:moqui-core-regression": "node scripts/moqui-core-regression-suite.js --json",
-    "prepublishOnly": "npm run test:full && npm run test:skip-audit && npm run test:sce-tracking && npm run test:brand-consistency && npm run gate:git-managed && npm run gate:errorbook-registry-health && npm run gate:errorbook-release && npm run report:interactive-governance -- --fail-on-alert",
+    "prepublishOnly": "npm run test:release && npm run test:skip-audit && npm run test:sce-tracking && npm run test:brand-consistency && npm run gate:git-managed && npm run gate:errorbook-registry-health && npm run gate:errorbook-release && npm run report:interactive-governance -- --fail-on-alert",
     "publish:manual": "npm publish --access public",
     "install-global": "npm install -g .",
     "uninstall-global": "npm uninstall -g scene-capability-engine"