scene-capability-engine 3.6.61 → 3.6.62

package/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [3.6.62] - 2026-03-21
+
+### Removed
+- Removed the OpenHands-specific `sce studio events --openhands-events <path>` bridge so current SCE no longer exposes a vendor-specific event-ingestion path in the active CLI surface.
+
 ## [3.6.61] - 2026-03-20
 
 ### Added

package/README.md

@@ -155,7 +155,7 @@ SCE is opinionated by default.
 For IDEs, AI shells, or custom frontends, the most important SCE surfaces are:
 
 - `sce studio plan|generate|apply|verify|release`
-- `sce studio events --openhands-events <path>`
+- `sce studio events`
 - `sce task ref|show|rerun`
 - `sce timeline save|list|show|restore`
 - `sce capability inventory`
@@ -230,5 +230,5 @@ MIT. See [LICENSE](LICENSE).
 
 ---
 
-**Version**: 3.6.61
-**Last Updated**: 2026-03-20
+**Version**: 3.6.62
+**Last Updated**: 2026-03-21

package/README.zh.md

@@ -160,7 +160,7 @@ SCE 默认是强治理的。
 如果你要对接 IDE、AI 助手或前端，优先关注这些接口面：
 
 - `sce studio plan|generate|apply|verify|release`
-- `sce studio events --openhands-events <path>`
+- `sce studio events`
 - `sce task ref|show|rerun`
 - `sce timeline save|list|show|restore`
 - `sce capability inventory`
@@ -235,5 +235,5 @@ MIT，见 [LICENSE](LICENSE)。
 
 ---
 
-**版本**：3.6.61
-**最后更新**：2026-03-20
+**版本**：3.6.62
+**最后更新**：2026-03-21

package/docs/command-reference.md

@@ -744,8 +744,6 @@ 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
@@ -779,7 +777,6 @@ Studio JSON output now includes a stable UI-oriented task stream contract (in ad
 - `task.evidence[]`: structured evidence references
 - `task.feedback_model`: human-facing task feedback (`problem`, `execution`, `diagnosis`, `evidence`, `next_step`, `mb_status`)
 - `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`

package/docs/magicball-task-feedback-timeline-guide.md

@@ -117,7 +117,6 @@ SCE 现在在时间线命令中增加：
 ## 4. 最小接口清单
 
 - `sce studio events --job <job-id> --json`
-- `sce studio events --job <job-id> --openhands-events <path> --json`
 - `sce timeline list --limit 20 --json`
 - `sce timeline show <snapshot-id> --json`
 

package/docs/releases/README.md

@@ -9,6 +9,7 @@ This directory stores release-facing documents:
 ## Archived Versions
 
 - [Release checklist](../release-checklist.md)
+- [v3.6.62 release notes](./v3.6.62.md)
 - [v3.6.61 release notes](./v3.6.61.md)
 - [v3.6.60 release notes](./v3.6.60.md)
 - [v3.6.59 release notes](./v3.6.59.md)

package/docs/releases/v3.6.62.md

@@ -0,0 +1,32 @@
+# v3.6.62 Release Notes
+
+Release date: 2026-03-21
+
+## Highlights
+
+- Removed the OpenHands-specific `sce studio events --openhands-events <path>` bridge from the tracked CLI surface so SCE no longer publishes a vendor-specific event-ingestion path as a first-class runtime contract.
+- Removed the corresponding OpenHands mapping test coverage and cleaned the main command reference plus README surfaces to keep shipped documentation aligned with the active product boundary.
+- Kept the broader external-runtime direction vendor-neutral so future IDE embedding can focus on Codex CLI, Claude Code, and similar in-process tool endpoints without carrying a stale OpenHands-first entry point.
+
+## Validation
+
+- `npx jest tests/unit/commands/studio.test.js --runInBand`
+- `npm run test:release`
+- `npm run audit:release-docs`
+- `npm run audit:steering`
+- `npm run test:skip-audit`
+- `npm run test:sce-tracking`
+- `npm run gate:npm-runtime-assets`
+- `npm run test:brand-consistency`
+- `npm run audit:clarification-first`
+- `npm run audit:magicball-engineering-contract`
+- `npm run audit:magicball-project-contract`
+- `npm run gate:collab-governance`
+- `npm run gate:errorbook-registry-health`
+- `npm run gate:errorbook-release`
+- `npm pack --dry-run`
+
+## Release Notes
+
+- Use `v3.6.62` when you need the published SCE package to exclude the old OpenHands-specific `studio events` bridge from the active CLI and doc surface.
+- This patch intentionally does not rewrite user-local draft Specs; it only cleans the tracked engine, tests, and release-facing documentation.

package/docs/zh/releases/README.md

@@ -9,6 +9,7 @@
 ## 历史版本归档
 
 - [发布检查清单](../release-checklist.md)
+- [v3.6.62 发布说明](./v3.6.62.md)
 - [v3.6.61 发布说明](./v3.6.61.md)
 - [v3.6.60 发布说明](./v3.6.60.md)
 - [v3.6.59 发布说明](./v3.6.59.md)

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

@@ -0,0 +1,32 @@
+# v3.6.62 发布说明
+
+发布日期：2026-03-21
+
+## 重点变化
+
+- 从已跟踪 CLI 正式接口面移除了 OpenHands 专有的 `sce studio events --openhands-events <path>` 桥接入口，避免 SCE 继续把某个供应商专有事件摄取路径作为一等运行时契约发布。
+- 同步移除了对应的 OpenHands 映射测试，并清理了主命令参考与 README 中的相关说明，保证随包发布的文档与当前正式产品边界一致。
+- 外部 runtime 方向继续保持 vendor-neutral，为后续 IDE 内嵌 Codex CLI、Claude Code 等执行端预留稳定空间，而不是继续背着过时的 OpenHands-first 入口。
+
+## 验证
+
+- `npx jest tests/unit/commands/studio.test.js --runInBand`
+- `npm run test:release`
+- `npm run audit:release-docs`
+- `npm run audit:steering`
+- `npm run test:skip-audit`
+- `npm run test:sce-tracking`
+- `npm run gate:npm-runtime-assets`
+- `npm run test:brand-consistency`
+- `npm run audit:clarification-first`
+- `npm run audit:magicball-engineering-contract`
+- `npm run audit:magicball-project-contract`
+- `npm run gate:collab-governance`
+- `npm run gate:errorbook-registry-health`
+- `npm run gate:errorbook-release`
+- `npm pack --dry-run`
+
+## 发布说明
+
+- 当你需要已发布的 SCE 包不再暴露旧的 OpenHands 专有 `studio events` 桥接入口时，请使用 `v3.6.62`。
+- 本次补丁刻意不去重写用户本地未纳管的草稿 spec，只清理已跟踪的 engine、测试与发布文档面。

package/lib/commands/studio.js

@@ -921,273 +921,6 @@ function extractEventArrayFromPayload(payload) {
   return [payload];
 }
 
-async function readOpenHandsEventsFile(openhandsEventsPath, fileSystem = fs) {
-  const normalizedPath = normalizeString(openhandsEventsPath);
-  if (!normalizedPath) {
-    return [];
-  }
-  const exists = await fileSystem.pathExists(normalizedPath);
-  if (!exists) {
-    throw new Error(`OpenHands events file not found: ${normalizedPath}`);
-  }
-
-  const content = await fileSystem.readFile(normalizedPath, 'utf8');
-  const trimmed = `${content || ''}`.trim();
-  if (!trimmed) {
-    return [];
-  }
-
-  try {
-    const parsed = JSON.parse(trimmed);
-    return extractEventArrayFromPayload(parsed);
-  } catch (_error) {
-    const lines = trimmed
-      .split(/\r?\n/)
-      .map((line) => line.trim())
-      .filter(Boolean);
-    const parsedLines = [];
-    for (const line of lines) {
-      try {
-        parsedLines.push(JSON.parse(line));
-      } catch (_innerError) {
-        // Skip malformed JSONL lines to keep ingestion robust.
-      }
-    }
-    return parsedLines;
-  }
-}
-
-function normalizeOpenHandsEventRecord(rawEvent, index, jobId) {
-  const raw = rawEvent && typeof rawEvent === 'object'
-    ? rawEvent
-    : { value: rawEvent };
-  const eventId = pickFirstString([
-    raw.event_id,
-    raw.eventId,
-    raw.id,
-    raw.uuid
-  ]) || `oh-evt-${index + 1}`;
-  const eventType = pickFirstString([
-    raw.event_type,
-    raw.eventType,
-    raw.type,
-    raw.kind,
-    raw.action
-  ]) || 'unknown';
-  const timestamp = pickFirstString([
-    raw.timestamp,
-    raw.time,
-    raw.created_at,
-    raw.createdAt,
-    raw.ts
-  ]) || nowIso();
-  return {
-    api_version: STUDIO_EVENT_API_VERSION,
-    event_id: eventId,
-    job_id: jobId,
-    event_type: `openhands.${eventType}`,
-    timestamp,
-    metadata: {
-      source: 'openhands',
-      raw
-    }
-  };
-}
-
-function tryParseJsonText(value) {
-  if (typeof value !== 'string') {
-    return null;
-  }
-  const trimmed = value.trim();
-  if (!trimmed) {
-    return null;
-  }
-  if (!(trimmed.startsWith('{') || trimmed.startsWith('['))) {
-    return null;
-  }
-  try {
-    return JSON.parse(trimmed);
-  } catch (_error) {
-    return null;
-  }
-}
-
-function stringifyCompact(value) {
-  if (value == null) {
-    return '';
-  }
-  if (typeof value === 'string') {
-    return value;
-  }
-  try {
-    return JSON.stringify(value);
-  } catch (_error) {
-    return `${value}`;
-  }
-}
-
-function extractOpenHandsCommandCandidates(raw = {}) {
-  const command = pickFirstString([
-    raw.command,
-    raw.cmd,
-    raw.input && raw.input.command,
-    raw.action && raw.action.command,
-    raw.observation && raw.observation.command,
-    raw.tool_input && raw.tool_input.command
-  ]);
-
-  const toolName = pickFirstString([
-    raw.tool_name,
-    raw.toolName,
-    raw.tool && raw.tool.name,
-    raw.name
-  ]);
-  const toolArgs = raw.arguments || raw.tool_input || raw.input || null;
-
-  const cmd = command || (toolName
-    ? `tool:${toolName}${toolArgs ? ` ${stringifyCompact(toolArgs)}` : ''}`
-    : '');
-
-  return {
-    cmd,
-    exit_code: pickFirstNumber([
-      raw.exit_code,
-      raw.exitCode,
-      raw.result && (raw.result.exit_code ?? raw.result.exitCode)
-    ]),
-    stdout: pickFirstString([
-      raw.stdout,
-      raw.output,
-      raw.result && raw.result.stdout,
-      raw.observation && raw.observation.stdout
-    ]),
-    stderr: pickFirstString([
-      raw.stderr,
-      raw.result && raw.result.stderr,
-      raw.error && raw.error.message,
-      typeof raw.error === 'string' ? raw.error : ''
-    ]),
-    log_path: pickFirstString([
-      raw.log_path,
-      raw.logPath,
-      raw.log && raw.log.path
-    ])
-  };
-}
-
-function collectOpenHandsFileChangesFromRaw(raw = {}) {
-  const changes = [];
-  const addPath = (pathValue, lineValue, diffRefValue = '') => {
-    const pathRef = normalizeString(pathValue);
-    if (!pathRef) {
-      return;
-    }
-    const line = Number.parseInt(`${lineValue != null ? lineValue : 1}`, 10);
-    const normalizedLine = Number.isFinite(line) && line > 0 ? line : 1;
-    const diffRef = normalizeString(diffRefValue) || `${pathRef}:${normalizedLine}`;
-    changes.push({
-      path: pathRef,
-      line: normalizedLine,
-      diffRef
-    });
-  };
-
-  if (typeof raw.path === 'string') {
-    addPath(raw.path, raw.line || raw.line_number, raw.diff_ref);
-  }
-  if (raw.file && typeof raw.file === 'object') {
-    addPath(raw.file.path || raw.file.name, raw.file.line || raw.file.line_number, raw.file.diffRef || raw.file.diff_ref);
-  }
-
-  const arrayKeys = ['files', 'changed_files', 'modified_files', 'created_files', 'deleted_files'];
-  for (const key of arrayKeys) {
-    const values = Array.isArray(raw[key]) ? raw[key] : [];
-    for (const value of values) {
-      if (typeof value === 'string') {
-        addPath(value, 1);
-      } else if (value && typeof value === 'object') {
-        addPath(value.path || value.file || value.name, value.line || value.line_number, value.diffRef || value.diff_ref);
-      }
-    }
-  }
-
-  const patchText = pickFirstString([raw.patch, raw.diff]);
-  if (patchText) {
-    const parsedJson = tryParseJsonText(patchText);
-    if (parsedJson && typeof parsedJson === 'object') {
-      const nested = collectOpenHandsFileChangesFromRaw(parsedJson);
-      changes.push(...nested);
-    } else {
-      const lines = patchText.split(/\r?\n/);
-      for (const line of lines) {
-        const match = line.match(/^\+\+\+\s+b\/(.+)$/);
-        if (match && match[1]) {
-          addPath(match[1], 1);
-        }
-      }
-    }
-  }
-
-  return changes;
-}
-
-function mapOpenHandsEventsToTaskSignals(openhandsEvents = [], context = {}) {
-  const normalizedEvents = openhandsEvents.map((item, index) =>
-    normalizeOpenHandsEventRecord(item, index, context.jobId)
-  );
-
-  const commands = [];
-  const fileChanges = [];
-  const errors = [];
-  const evidence = [];
-
-  for (const event of normalizedEvents) {
-    const raw = event && event.metadata ? event.metadata.raw || {} : {};
-    const commandCandidate = extractOpenHandsCommandCandidates(raw);
-    if (commandCandidate.cmd || commandCandidate.stdout || commandCandidate.stderr || commandCandidate.exit_code != null) {
-      commands.push(commandCandidate);
-    }
-
-    fileChanges.push(...collectOpenHandsFileChangesFromRaw(raw));
-
-    const eventType = normalizeString(event.event_type).toLowerCase();
-    const failedByType = eventType.includes('error') || eventType.includes('fail');
-    const failedByExit = commandCandidate.exit_code != null && Number(commandCandidate.exit_code) !== 0;
-    const failedByStderr = commandCandidate.stderr.length > 0 && !commandCandidate.stdout;
-    if (failedByType || failedByExit || failedByStderr) {
-      const message = pickFirstString([
-        raw.message,
-        raw.error && raw.error.message,
-        typeof raw.error === 'string' ? raw.error : '',
-        failedByExit ? `OpenHands command failed (exit ${commandCandidate.exit_code})` : '',
-        'OpenHands event indicates failure'
-      ]);
-      errors.push({
-        message,
-        step_id: event.event_type,
-        cmd: commandCandidate.cmd,
-        exit_code: commandCandidate.exit_code,
-        stderr: commandCandidate.stderr,
-        stdout: commandCandidate.stdout
-      });
-    }
-
-    evidence.push({
-      type: 'openhands-event',
-      ref: event.event_id,
-      detail: event.event_type
-    });
-  }
-
-  return {
-    event: normalizedEvents,
-    commands: normalizeTaskCommands(commands),
-    file_changes: normalizeTaskFileChanges(fileChanges),
-    errors: normalizeTaskErrors(errors),
-    evidence: normalizeTaskEvidence(evidence)
-  };
-}
-
 function extractCommandsFromStageMetadata(stageMetadata = {}) {
   const gateSteps = Array.isArray(stageMetadata && stageMetadata.gate_steps)
     ? stageMetadata.gate_steps
@@ -2919,21 +2652,7 @@ async function runStudioEventsCommand(options = {}, dependencies = {}) {
 
   const limit = normalizePositiveInteger(options.limit, 50);
   const job = await loadJob(paths, jobId, fileSystem);
-  const openhandsEventsPath = normalizeString(options.openhandsEvents);
-  let sourceStream = 'studio';
   let events = await readStudioEvents(paths, jobId, { limit }, fileSystem);
-  let openhandsSignals = null;
-  if (openhandsEventsPath) {
-    const absoluteOpenhandsPath = path.isAbsolute(openhandsEventsPath)
-      ? openhandsEventsPath
-      : path.join(projectPath, openhandsEventsPath);
-    const rawOpenhandsEvents = await readOpenHandsEventsFile(absoluteOpenhandsPath, fileSystem);
-    openhandsSignals = mapOpenHandsEventsToTaskSignals(rawOpenhandsEvents, {
-      jobId: job.job_id
-    });
-    events = openhandsSignals.event;
-    sourceStream = 'openhands';
-  }
 
   const payload = await buildCommandPayload('studio-events', job, {
     events,
@@ -2941,47 +2660,11 @@ async function runStudioEventsCommand(options = {}, dependencies = {}) {
     fileSystem
   });
   payload.limit = limit;
-  payload.source_stream = sourceStream;
-  if (sourceStream === 'openhands') {
-    payload.openhands_events_file = path.relative(projectPath, path.isAbsolute(openhandsEventsPath)
-      ? openhandsEventsPath
-      : path.join(projectPath, openhandsEventsPath)).replace(/\\/g, '/');
-    payload.task = {
-      ...payload.task,
-      summary: [
-        `OpenHands events: ${events.length} | commands: ${openhandsSignals.commands.length} | errors: ${openhandsSignals.errors.length}`,
-        `File changes: ${openhandsSignals.file_changes.length} | source: ${payload.openhands_events_file}`,
-        `Next: ${payload.task.next_action}`
-      ],
-      handoff: {
-        ...(payload.task.handoff || {}),
-        source_stream: 'openhands',
-        openhands_event_count: events.length,
-        openhands_command_count: openhandsSignals.commands.length,
-        openhands_error_count: openhandsSignals.errors.length
-      },
-      commands: openhandsSignals.commands,
-      file_changes: openhandsSignals.file_changes,
-      errors: openhandsSignals.errors,
-      evidence: normalizeTaskEvidence([
-        ...(Array.isArray(payload.task.evidence) ? payload.task.evidence : []),
-        ...openhandsSignals.evidence,
-        {
-          type: 'openhands-event-file',
-          ref: payload.openhands_events_file,
-          detail: 'mapped'
-        }
-      ])
-    };
-    payload.eventId = events.length > 0
-      ? events[events.length - 1].event_id
-      : null;
-  }
+  payload.source_stream = 'studio';
   payload.events = events;
   const normalizedPayload = attachTaskFeedbackModel(payload);
   printStudioEventsPayload(normalizedPayload, options);
   return normalizedPayload;
-  return payload;
 }
 
 function printStudioIntakePayload(payload, options = {}) {
@@ -3267,7 +2950,6 @@ function registerStudioCommands(program) {
     .description('Show studio job event stream')
     .option('--job <job-id>', 'Studio job id (defaults to latest)')
     .option('--limit <number>', 'Maximum number of recent events to return', '50')
-    .option('--openhands-events <path>', 'Optional OpenHands raw events file (.json/.jsonl) mapped to task stream')
     .option('--json', 'Print machine-readable JSON output')
     .action(async (options) => runStudioCommand(runStudioEventsCommand, options, 'events'));
 

package/package.json

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

package/template/.sce/README.md

@@ -243,6 +243,6 @@ A Spec is a complete feature definition with three parts:
 ---
 
 **Project Type**: Spec-driven development  
-**sce Version**: 3.6.61  
-**Last Updated**: 2026-03-20
+**sce Version**: 3.6.62  
+**Last Updated**: 2026-03-21
 **Purpose**: Guide AI tools to work effectively with this project