scene-capability-engine 3.2.0 → 3.3.2

package/CHANGELOG.md

@@ -8,6 +8,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 ### Added
+- **Auto handoff default takeover hard gate + preflight-check command**: `sce auto handoff` profiles now default to release-gate preflight hard requirement (`default|moqui|enterprise`), added `sce auto handoff preflight-check` (`pass|warning|blocked` + reasons/signals/recommended commands), and `handoff run` precheck/details now exposes full runtime ui-mode pressure aggregates for machine-readable triage.
+- **Interactive runtime ui-mode telemetry closed-loop**: `interactive-customization-loop` now emits runtime policy signal streams (`interactive-runtime-signals.jsonl` global + session) with `ui_mode` violation markers; `interactive-governance-report` now ingests runtime signals by default and reports runtime/ui-mode pressure metrics + alerts; weekly ops summary/gate now carry and enforce runtime ui-mode violation signals (default `RELEASE_WEEKLY_OPS_MAX_RUNTIME_UI_MODE_VIOLATION_TOTAL=0`).
+- **Interactive dual-surface runtime policy contract**: `interactive-runtime-policy-evaluate` now supports `--ui-mode` and enforces optional `policy.ui_modes` constraints (UI mode vs runtime mode/execution mode), `interactive-customization-loop` now passes UI mode through runtime evaluation by default, and baseline runtime policy/docs now include `user-app`/`ops-console` contract defaults for safer embedded assistant routing.
+- **Handoff run observability-phase weekly-ops routing**: `sce auto handoff run` now injects weekly-ops stop pressure counters into the `observability` phase details, propagates weekly pressure into `failure_summary.highlights`, and auto-adds weekly summary/gate + policy-tuning recommendations when governance weekly pressure is observed.
+- **Runtime ui-mode pressure propagation across auto governance/handoff**: `sce auto handoff gate-index` now ingests runtime weekly-ops telemetry (`runtime_block_rate`, `runtime_ui_mode_violation_*`) into history latest/aggregates/markdown; `auto governance stats|close-loop|session list|session stats|observability snapshot` now preserves runtime stop-detail pressure and recommendation signals end-to-end; `sce auto handoff run` observability/failure/recommendation outputs now surface runtime ui-mode pressure guidance by default.
+- **Handoff preflight/evidence runtime diagnostics uplift**: `sce auto handoff run` now exposes runtime ui-mode pressure fields directly in `release_gate_preflight` (including precheck details), and `sce auto handoff evidence --format markdown` / release draft outputs now render runtime block-rate + ui-mode violation lines for faster operator triage.
+- **Observability snapshot weekly-ops governance highlights**: `sce auto observability snapshot` now exposes governance weekly-ops stop pressure in `highlights` and `snapshots.governance_weekly_ops_stop`, enabling dashboards to consume weekly pressure trends directly without traversing nested governance session payloads.
+- **Governance session stats weekly-ops pressure trend**: `sce auto governance session list|stats` now exposes weekly-ops stop-detail telemetry (per-session flags + aggregated `release_gate.weekly_ops_stop` counters/rates/averages), with backward-compatible fallback that infers pressure from historical `stop_detail.reasons`.
+- **Governance close-loop weekly-ops structured stop detail**: `sce auto governance close-loop` now emits `stop_detail.weekly_ops` (latest, aggregates, pressure flags) whenever weekly release pressure contributes to a release-gate block, so embedded assistants and UI layers can consume machine-readable diagnostics without parsing reason strings.
+- **Governance close-loop now emits weekly-ops block reasons by default**: `sce auto governance close-loop` now maps weekly-ops pressure (blocked runs/rates, config-warning pressure, auth-tier/dialogue authorization block-rate pressure, latest weekly risk/governance status) into `stop_detail.reasons`, treats those signals as release-gate blocking conditions, and emits direct weekly-ops remediation recommendations in close-loop output.
+- **Governance risk routing uses weekly-ops history pressure**: `auto governance stats` now ingests `weekly_ops_*` signals from release gate history (block/warning/config-warning pressure + auth-tier/dialogue block-rate maxima), elevates risk/concerns accordingly, and emits targeted remediation recommendations for weekly gate reruns, variable fixes, and policy tuning.
+- **Release gate history weekly-ops visibility uplift**: `sce auto handoff gate-index` now ingests nested `weekly_ops` telemetry from release-gate artifacts (blocked/warnings/config-warnings/dialogue/auth-tier rates), exposes new `weekly_ops_*` aggregates in JSON/markdown, and release workflow trend notes now surface config-warning totals and weekly-ops pressure signals.
+- **Weekly ops remediation + gate config warning hardening**: `release-risk-remediation-bundle` now outputs policy-specific remediation for `dialogue-authorization` and `authorization-tier` block-rate pressure; `release-weekly-ops-gate` now emits `config_warnings` when threshold env values are invalid and falls back to safe defaults.
+- **Dialogue-authorization telemetry defaultization**: `interactive-customization-loop` now appends dialogue-authorization signal streams (`interactive-dialogue-authorization-signals.jsonl` global + session), and `interactive-governance-report` now ingests these signals by default to compute deny/review block-rate metrics with threshold alerts.
+- **Machine-readable authorization dialogue contract**: `interactive-dialogue-governance` now emits `authorization_dialogue` requirements (decision/required inputs/confirmation steps/prompts) with default baseline policy (`authorization-dialogue-policy-baseline.json`), supports explicit UI surface mode routing (`--ui-mode user-app|ops-console`), and interactive loop/flow summaries now expose `summary.dialogue_authorization_decision`.
+- **Interactive authorization tier default gate**: Added `interactive-authorization-tier-evaluate` with baseline policy (`authorization-tier-policy-baseline.json`) and integrated it into interactive loop/flow pipeline by default, enforcing profile/environment step-up rules (`business-user` suggestion-only, `system-maintainer` apply-enabled with environment-specific secondary authorization requirements).
+- **Authorization tier work-order/governance wiring**: `interactive-customization-loop` now appends authorization-tier signal streams by default, `interactive-work-order-build` ingests authorization-tier decisions/requirements into governance fields and next-actions, and `interactive-governance-report` now computes authorization-tier deny/review metrics with threshold alerts.
+- **Weekly ops hard-gate includes authorization-tier pressure**: `release-ops-weekly-summary` now carries authorization-tier deny/review/block-rate snapshot fields and risk concerns, and `release-weekly-ops-gate` now supports `RELEASE_WEEKLY_OPS_MAX_AUTHORIZATION_TIER_BLOCK_RATE_PERCENT` (default `40`) as a release blocking condition.
+- **Embedded assistant authorization dialogue baseline**: Added `docs/interactive-customization/embedded-assistant-authorization-dialogue-rules.md` to standardize user-mode vs maintainer-mode interaction, step-up authorization prompts, deny fallback behavior, and mandatory audit references for in-product AI assistants.
+- **Interactive dialogue profile governance**: `interactive-dialogue-governance` now supports `--profile business-user|system-maintainer` with profile-aware policy merge (including maintenance ticket/rollback safety prompts), and `interactive-customization-loop`/`interactive-flow`/`sce scene interactive-loop|interactive-flow` now pass through `--dialogue-profile` and expose active profile in summaries.
+- **Batch 429 exhaustion recovery guidance**: `sce auto close-loop-batch` now emits rate-limit pressure telemetry and automatic recovery recommendation metadata (`batch_retry.recovery_*`) when retry budget is exhausted under throttling, plus a ready-to-run `close-loop-recover` suggested command in CLI summary.
+- **Interactive execution-block diagnostics in summaries**: `interactive-customization-loop` now emits normalized block categories and remediation hints (`summary.execution_block_reason_category`, `summary.execution_block_remediation_hint`), with `interactive-flow` passthrough plus `summary.authorization_execute_roles` for role-policy guided UI remediation.
+- **Interactive smoke role-policy coverage**: `interactive-loop-smoke` and `interactive-flow-smoke` now run with approval role-policy + actor-role parameters by default to validate password+role dual-authorization path in CI/release smoke stage.
 - **Interactive approval role-policy step-up**: `interactive-approval-workflow` now supports optional role-based action authorization (`--role-policy`, `--actor-role`) and loop/flow/scene commands can pass role policy and actor roles (`--approval-role-policy`, `--approval-actor-role`, `--approver-actor-role`) for separation-of-duties governance.
 - **Interactive runtime policy + work-order default pipeline**: Added `interactive-runtime-policy-evaluate` and `interactive-work-order-build`, integrated both into `interactive-customization-loop` and `interactive-flow` (including `sce scene interactive-loop/interactive-flow` passthrough), with default `runtime_mode=ops-fix`, `runtime_environment=staging`, runtime non-allow fail gate option, and auditable work-order artifacts.
 - **Release weekly ops closed-loop summary**: Added `node scripts/release-ops-weekly-summary.js` (npm alias `npm run report:release-ops-weekly`) to aggregate handoff evidence, release-gate history, interactive governance, and matrix signals into one weekly risk/recommendation card (`weekly-ops-summary.json|.md`).

package/README.md

@@ -275,8 +275,7 @@ sequenceDiagram
 - [Adoption Guide](docs/adoption-guide.md) - Adopting sce in existing projects
 - [Upgrade Guide](docs/upgrade-guide.md) - Version upgrade instructions
 - [Release Archive](docs/releases/README.md) - Versioned release notes and validation report index
-- [Release Notes v1.46.2](docs/releases/v1.46.2.md) - Current release highlights and impact
-- [Validation Report v1.46.2](docs/releases/v1.46.2-validation.md) - Release-readiness evidence and verification results
+- [GitHub Releases](https://github.com/heguangyong/scene-capability-engine/releases) - Latest published versions and release assets
 - [Release Checklist](docs/release-checklist.md) - Repeatable pre-release verification flow
 - [Manual Workflows](docs/manual-workflows-guide.md) - Step-by-step workflows
 - [Developer Guide](docs/developer-guide.md) - Contributing and extending sce
@@ -288,7 +287,12 @@ sequenceDiagram
 
 ## Key Features
 
-### Autonomous Control 🚀 NEW in v1.23.0
+### Current Baseline
+- **Default hard gate for handoff preflight**: Release flow enforces `sce auto handoff preflight-check --require-pass --json` and blocks publish on failures.
+- **Takeover-first execution**: Once sce is adopted, autonomous and orchestrated flows are designed to run end-to-end without per-step confirmation loops.
+- **Tag-driven release**: Pushing `v*` tags to GitHub triggers automated test, release evidence gates, and npm publish workflow.
+
+### Autonomous Control 🚀
 - **Fully Autonomous Execution**: AI independently manages entire development workflows from requirements to delivery
 - **Closed-Loop Program Execution**: `sce auto close-loop "<goal>"` runs from goal decomposition to terminal orchestration state without manual confirmation gates
 - **Automatic Master/Sub Portfolio Split**: Large goals are auto-split into dependency-wired sub-specs and coordinated by a master spec
@@ -327,21 +331,21 @@ sce auto resume
 ### Spec-Driven Development
 Structure your work with Requirements → Design → Tasks workflow
 
-### KPI Automation & Observability 🚀 NEW in v1.46.2
+### KPI Automation & Observability 🚀
 - **Unified Metric Contract**: Load and validate KPI definitions from `metric-definition.yaml`
 - **Weekly Snapshot Pipeline**: Generate machine-readable snapshots with risk level and audit reasons
 - **Baseline and Trend Analysis**: Build baseline from historical data and detect worsening trends automatically
 - **Gate-Ready Summary**: Emit Day30/Day60-consumable summary payloads with evidence paths
 - **CLI Commands**: `value metrics sample`, `value metrics snapshot`, `value metrics baseline`, `value metrics trend` with `--json` support
 
-### Multi-Workspace Management 🚀 NEW in v1.11.0
+### Multi-Workspace Management 🚀
 - **Workspace Registry**: Manage multiple sce projects from a single location
 - **Quick Switching**: Switch between projects without directory navigation
 - **Data Atomicity**: Single source of truth (`~/.kse/workspace-state.json`)
 - **Cross-Platform**: Consistent path handling across Windows/Linux/macOS
 - **Auto Migration**: Seamless upgrade from legacy workspace format
 
-### Environment Configuration Management 🚀 NEW in v1.14.0
+### Environment Configuration Management 🚀
 - **Environment Registry**: Manage multiple environment configurations (dev, test, staging, prod)
 - **Quick Switching**: Switch between environments with automatic backup
 - **Automatic Backup**: Create timestamped backups before each switch
@@ -350,7 +354,7 @@ Structure your work with Requirements → Design → Tasks workflow
 - **Command Execution**: Run commands in specific environment context
 - **Cross-Platform**: Works seamlessly on Windows, Linux, and macOS
 
-### Multi-Repository Management 🚀 NEW in v1.20.0
+### Multi-Repository Management 🚀
 - **Unified Interface**: Manage multiple Git subrepositories from a single command
 - **Auto-Discovery**: Automatically scan and configure all Git repositories in your project
 - **Nested Repository Support**: Discover and manage Git repositories nested inside other repositories
@@ -361,7 +365,7 @@ Structure your work with Requirements → Design → Tasks workflow
 - **Cross-Platform**: Consistent path handling across Windows/Linux/macOS
 - **Smart Exclusions**: Automatically skip common non-repository directories (node_modules, build, etc.)
 
-### Moqui ERP Integration 🚀 NEW in v1.39.0
+### Moqui ERP Integration 🚀
 - **Moqui ERP Adapter**: Connect sce scene runtime to live Moqui ERP instances
   - `MoquiClient` — HTTP client with JWT auth lifecycle (login, refresh, re-login, logout) and retry logic
   - `MoquiAdapter` — Binding handler for `spec.erp.*` and `moqui.*` refs, entity CRUD, service invocation, screen discovery
@@ -370,7 +374,7 @@ Structure your work with Requirements → Design → Tasks workflow
   - Pattern-based manifest generation with governance contracts
 - **CLI Commands**: `scene connect`, `scene discover`, `scene extract` with `--json` support
 
-### Multi-Agent Parallel Coordination 🚀 NEW in v1.43.0
+### Multi-Agent Parallel Coordination 🚀
 - **Agent Registry**: MachineIdentifier-based agent lifecycle with heartbeat monitoring and inactive cleanup
 - **Task Lock Manager**: File-based task locking with atomic operations, single-agent backward compatibility
 - **Task Status Store**: Concurrent-safe task status updates with exponential backoff retry
@@ -381,7 +385,7 @@ Structure your work with Requirements → Design → Tasks workflow
 
 [Learn more about Multi-Agent Coordination →](docs/multi-agent-coordination-guide.md)
 
-### Agent Orchestrator 🚀 NEW in v1.45.0
+### Agent Orchestrator 🚀
 - **Automated Multi-Agent Spec Execution**: Replace manual multi-terminal workflows with a single command
 - **DAG-Based Scheduling**: Analyze Spec dependencies, compute execution batches via topological sort
 - **Parallel Execution**: Run up to N Specs simultaneously via Codex CLI sub-agents (`--max-parallel`)
@@ -429,7 +433,7 @@ Tip: `sce spec bootstrap|pipeline run|gate run --specs ...` now defaults to this
 If Codex CLI is globally installed, you can set `"codexCommand": "codex"`.
 Use the `rateLimit*` settings to absorb transient 429/too-many-requests failures without stalling orchestration.
 
-### Spec-Level Steering & Context Sync 🚀 NEW in v1.44.0
+### Spec-Level Steering & Context Sync 🚀
 - **Spec Steering (L4)**: Independent `steering.md` per Spec with constraints, notes, and decisions — zero cross-agent conflict
 - **Steering Loader**: Unified L1-L4 four-layer steering loader with priority-based merging
 - **Context Sync Manager**: Multi-agent friendly CURRENT_CONTEXT.md with structured Spec progress table, concurrent-safe updates
@@ -437,7 +441,7 @@ Use the `rateLimit*` settings to absorb transient 429/too-many-requests failures
 - **Sync Barrier**: Agent Spec-switch synchronization — uncommitted change check + steering reload
 - **Coordinator Integration**: Auto Spec completion check on task complete, SyncBarrier on task assign
 
-### Scene Ontology Enhancement 🚀 NEW in v1.42.0
+### Scene Ontology Enhancement 🚀
 - **OntologyGraph**: Semantic relationship graph for binding refs (depends_on, composes, extends, produces)
 - **Action Abstraction**: Intent, preconditions, postconditions per binding for AI agent understanding
 - **Data Lineage**: Source → transform → sink tracking in governance_contract
@@ -445,19 +449,19 @@ Use the `rateLimit*` settings to absorb transient 429/too-many-requests failures
 - **Agent Readiness Score**: Bonus quality dimension (max +10 points)
 - **CLI Commands**: `scene ontology show|deps|validate|actions|lineage|agent-info` with `--json` support
 
-### Scene Template Quality Pipeline 🚀 NEW in v1.41.0
+### Scene Template Quality Pipeline 🚀
 - **Template Lint Engine**: 10-category quality checks for scene packages (manifest completeness, binding refs, governance, consistency, variables, documentation, action abstraction, data lineage, agent hints)
 - **Quality Score Calculator**: 4-dimension scoring + agent_readiness bonus (contract validity, lint pass rate, documentation quality, governance completeness + agent readiness max +10) with 0-100+ scale
 - **One-Stop Contribute Pipeline**: Validate → Lint → Score → Preview → Publish in a single command
 - **CLI Commands**: `scene lint`, `scene score`, `scene contribute` with `--strict`, `--dry-run`, `--skip-lint`, `--json` support
 
-### Scene Template Engine 🚀 NEW in v1.25.0
+### Scene Template Engine 🚀
 - **Template Variable Schema**: Define typed variables (string, number, boolean, enum, array) with validation rules in scene-package.json
 - **Multi-File Rendering**: Recursive template processing with `{{variable}}` substitution, `{{#if}}` conditionals, `{{#each}}` loops
 - **Three-Layer Inheritance**: L1-Capability / L2-Domain / L3-Instance package hierarchy with schema and file merging
 - **CLI Commands**: `scene template-validate`, `scene template-resolve`, `scene template-render` with `--json` support
 
-### Spec-Level Collaboration 🚀 NEW in v1.22.0
+### Spec-Level Collaboration 🚀
 - **Parallel Development**: Enable multiple AI instances to work on different Specs simultaneously
 - **Dependency Management**: Define and track dependencies between Specs with circular dependency detection
 - **Interface Contracts**: Formal API definitions ensuring compatibility between independently developed Specs
@@ -468,7 +472,7 @@ Use the `rateLimit*` settings to absorb transient 429/too-many-requests failures
 
 [Learn more about Spec-Level Collaboration →](docs/spec-collaboration-guide.md)
 
-### Spec Locking Mechanism 🚀 NEW
+### Spec Locking Mechanism 🚀
 - **Multi-User Coordination**: Prevent conflicts when multiple developers work on the same Spec
 - **Machine Identification**: Unique machine IDs for accurate lock ownership tracking
 - **Stale Lock Detection**: Automatic detection and cleanup of abandoned locks (default: 24h timeout)
@@ -566,7 +570,7 @@ sce spec gate run --specs "<spec-a,spec-b>" --max-parallel <N>     # Multi-Spec
 sce context export <spec-name>     # Export context for AI tools
 sce prompt generate <spec> <task>  # Generate task-specific prompt
 
-# KPI automation and observability (NEW in v1.46.2)
+# KPI automation and observability
 sce value metrics sample --out <path> --json               # Generate sample KPI input JSON
 sce value metrics snapshot --input <path> --json          # Generate weekly KPI snapshot + gate summary
 sce value metrics baseline --from-history <N> --json      # Build baseline from earliest N snapshots
@@ -575,14 +579,14 @@ sce auto kpi trend --weeks 8 --period week --json         # Aggregate autonomous
 sce auto kpi trend --weeks 8 --period day --csv --out <path> # Export autonomous KPI trend as CSV
 sce auto kpi trend --weeks 8 --mode controller --json     # Filter trend to close-loop-controller sessions only
 
-# Workspace management (NEW in v1.11.0)
+# Workspace management
 sce workspace create <name> [path] # Register a new workspace
 sce workspace list                 # List all workspaces
 sce workspace switch <name>        # Switch active workspace
 sce workspace info [name]          # Show workspace details
 sce workspace remove <name>        # Remove workspace
 
-# Environment management (NEW in v1.14.0)
+# Environment management
 sce env list                       # List all environments
 sce env switch <name>              # Switch to environment (with backup)
 sce env info                       # Show active environment details
@@ -592,13 +596,13 @@ sce env rollback                   # Rollback to previous environment
 sce env verify                     # Verify current environment
 sce env run "<command>"            # Run command in environment context
 
-# Multi-repository management (NEW in v1.20.0)
+# Multi-repository management
 sce repo init [--nested]           # Initialize repository configuration (nested scanning by default)
 sce repo init --no-nested          # Initialize without nested repository scanning
 sce repo status [--verbose]        # Show status of all repositories (including nested)
 sce repo exec "<command>"          # Execute command in all repositories
 
-# Spec-level collaboration (NEW in v1.22.0)
+# Spec-level collaboration
 sce collab init <master> [options] # Initialize Master Spec with Sub-Specs
 sce collab status [spec] [--graph] # Display collaboration status
 sce collab assign <spec> <assignee> # Assign Spec to an assignee
@@ -607,22 +611,22 @@ sce collab integrate <specs...>    # Run integration tests
 sce collab migrate <spec>          # Convert standalone Spec to collaborative
 sce repo health                    # Check repository health
 
-# Scene template engine (NEW in v1.25.0)
+# Scene template engine
 sce scene template-validate --package <path>   # Validate template variable schema
 sce scene template-resolve --package <name>    # Resolve inheritance chain and merged schema
 sce scene template-render --package <name> --values <json> --out <dir>  # Render template files
 
-# Moqui ERP integration (NEW in v1.39.0)
+# Moqui ERP integration
 sce scene connect --config <path>              # Test connectivity to Moqui ERP instance
 sce scene discover --config <path>             # Discover entities, services, screens from Moqui
 sce scene extract --config <path> --out <dir>  # Extract scene templates from Moqui (v1.40.0)
 
-# Scene template quality pipeline (NEW in v1.41.0)
+# Scene template quality pipeline
 sce scene lint --package <path>                # Lint scene package for quality issues
 sce scene score --package <path>               # Calculate quality score (0-100)
 sce scene contribute --package <path>          # One-stop validate → lint → score → publish
 
-# Scene ontology (NEW in v1.42.0)
+# Scene ontology
 sce scene ontology show --package <path>       # Show ontology graph
 sce scene ontology deps --ref <ref>            # Query dependency chain
 sce scene ontology impact --ref <ref>          # Analyze reverse impact radius
@@ -633,11 +637,16 @@ sce scene ontology lineage --ref <ref>         # Show data lineage
 sce scene ontology agent-info --package <path> # Show agent hints
 sce scene contribute --package <path>          # One-stop validate → lint → score → publish
 
-# Agent orchestration (NEW in v1.45.0)
+# Agent orchestration
 sce orchestrate run --specs "<spec-list>" --max-parallel <N>  # Start multi-agent orchestration
 sce orchestrate status                         # View orchestration progress
 sce orchestrate stop                           # Stop all sub-agents
 
+# Release baseline (default in CI)
+sce auto handoff preflight-check --require-pass --json  # Hard gate: block release on preflight failures
+git tag -a vX.Y.Z -m "vX.Y.Z"                          # Create release tag
+git push origin vX.Y.Z                                  # Push tag to trigger GitHub release + npm publish
+
 # DevOps operations
 sce ops init <project-name>        # Initialize operations specs
 sce ops validate [<project>]       # Validate operations completeness
@@ -760,6 +769,6 @@ A deep conversation about AI development trends, Neo-Confucian philosophy, and s
 
 ---
 
-**Version**: 2.0.0  
-**Last Updated**: 2026-02-18
+**Version**: 3.3.1  
+**Last Updated**: 2026-02-22
 

package/README.zh.md

@@ -270,8 +270,7 @@ sequenceDiagram
 - [采用指南](docs/adoption-guide.md) - 在现有项目中采用 sce
 - [升级指南](docs/upgrade-guide.md) - 版本升级说明
 - [发布归档](docs/zh/releases/README.md) - 版本化发布说明与验证报告入口
-- [发布说明 v1.46.2](docs/zh/releases/v1.46.2.md) - 当前版本更新亮点
-- [验证报告 v1.46.2](docs/zh/releases/v1.46.2-validation.md) - 发布就绪验证与证据结果
+- [GitHub Releases](https://github.com/heguangyong/scene-capability-engine/releases) - 最新发布版本与发布资产
 - [发布检查清单](docs/zh/release-checklist.md) - 可重复执行的发版前核验流程
 - [手动工作流](docs/manual-workflows-guide.md) - 分步工作流
 - [开发者指南](docs/developer-guide.md) - 贡献和扩展 sce
@@ -283,6 +282,11 @@ sequenceDiagram
 
 ## 主要功能
 
+### 当前基线能力
+- **默认 preflight 硬门禁**：发布流程强制执行 `sce auto handoff preflight-check --require-pass --json`，未通过即阻断发布。
+- **接管优先执行**：项目采用 sce 后，默认按自治/编排方式端到端推进，不再依赖逐步人工确认。
+- **Tag 驱动发版**：向 GitHub 推送 `v*` tag 即触发自动测试、发布证据门禁与 npm 发布流程。
+
 ### Autonomous Control（自动闭环）🚀
 - **自动闭环推进**：`sce auto close-loop "<目标>"` 从目标拆分到编排完成全程自动推进
 - **自动主从拆分**：自动生成 Master/Sub Spec 组合、依赖关系与 Agent 分配
@@ -293,21 +297,21 @@ sequenceDiagram
 ### Spec 驱动开发
 使用需求 → 设计 → 任务工作流结构化你的工作
 
-### KPI 自动化与可观测 🚀 v1.46.2 新增
+### KPI 自动化与可观测 🚀
 - **统一指标契约**：从 `metric-definition.yaml` 加载并校验 KPI 定义
 - **周快照流水线**：生成包含风险级别和审计原因的 machine-readable 快照
 - **基线与趋势分析**：基于历史快照生成 baseline，并自动识别连续恶化趋势
 - **门禁可复用摘要**：输出 Day30/Day60 可直接消费的 summary 与证据路径
 - **CLI 命令**：`value metrics sample`、`value metrics snapshot`、`value metrics baseline`、`value metrics trend`，支持 `--json`
 
-### 多工作区管理 🚀 v1.11.0 新功能
+### 多工作区管理 🚀
 - **工作区注册表**：从单一位置管理多个 sce 项目
 - **快速切换**：无需目录导航即可在项目间切换
 - **数据原子性**：单一数据源（`~/.kse/workspace-state.json`）
 - **跨平台**：Windows/Linux/macOS 一致的路径处理
 - **自动迁移**：从旧版工作区格式无缝升级
 
-### 环境配置管理 🚀 v1.14.0 新功能
+### 环境配置管理 🚀
 - **环境注册表**：管理多个环境配置（dev, test, staging, prod）
 - **快速切换**：自动备份的环境切换
 - **自动备份**：每次切换前创建时间戳备份
@@ -316,7 +320,7 @@ sequenceDiagram
 - **命令执行**：在特定环境上下文中运行命令
 - **跨平台**：在 Windows、Linux 和 macOS 上无缝工作
 
-### Moqui ERP 集成 🚀 v1.39.0 新增
+### Moqui ERP 集成 🚀
 - **Moqui ERP 适配器**: 将 sce 场景运行时连接到 Moqui ERP 实例
   - `MoquiClient` — 支持 JWT 认证生命周期（登录、刷新、重登录、登出）和重试逻辑的 HTTP 客户端
   - `MoquiAdapter` — 处理 `spec.erp.*` 和 `moqui.*` 引用的绑定处理器，支持实体 CRUD、服务调用、屏幕发现
@@ -325,7 +329,7 @@ sequenceDiagram
   - 基于模式的清单生成，包含治理合约
 - **CLI 命令**: `scene connect`、`scene discover`、`scene extract`，支持 `--json` 输出
 
-### 多 Agent 并行协调 🚀 v1.43.0 新增
+### 多 Agent 并行协调 🚀
 - **Agent 注册表**: 基于 MachineIdentifier 的 Agent 生命周期管理，心跳监控和不活跃清理
 - **任务锁管理器**: 基于文件的任务锁定，原子操作，单 Agent 向后兼容
 - **任务状态存储**: 并发安全的任务状态更新，指数退避重试
@@ -336,7 +340,7 @@ sequenceDiagram
 
 [了解更多多 Agent 协调 →](docs/multi-agent-coordination-guide.md)
 
-### Agent 编排器 🚀 v1.45.0 新增
+### Agent 编排器 🚀
 - **自动化多 Agent Spec 执行**: 一条命令替代手工开多个终端分配 Spec 给 Codex Agent
 - **DAG 依赖调度**: 分析 Spec 间依赖关系，拓扑排序计算执行批次
 - **并行执行**: 通过 Codex CLI 子进程同时运行多个 Spec（`--max-parallel` 控制并行度）
@@ -380,7 +384,7 @@ sce orchestrate stop
 如果你已全局安装 Codex CLI，可将 `"codexCommand"` 改为 `"codex"`。
 可通过 `rateLimit*` 配置吸收 429/too-many-requests 等限流抖动，避免编排流程卡死。
 
-### Spec 级 Steering 与上下文同步 🚀 v1.44.0 新增
+### Spec 级 Steering 与上下文同步 🚀
 - **Spec Steering (L4)**: 每个 Spec 独立的 `steering.md`，包含约束、注意事项、决策记录 — 跨 Agent 零冲突
 - **Steering 加载器**: 统一 L1-L4 四层 Steering 加载，优先级合并
 - **上下文同步管理器**: 多 Agent 友好的 CURRENT_CONTEXT.md，结构化 Spec 进度表，并发安全更新
@@ -388,7 +392,7 @@ sce orchestrate stop
 - **同步屏障**: Agent 切换 Spec 时的同步检查 — 未提交更改检测 + Steering 重新加载
 - **Coordinator 集成**: 任务完成时自动检测 Spec 完成，任务分配时运行同步屏障
 
-### 场景 Ontology 增强 🚀 v1.42.0 新增
+### 场景 Ontology 增强 🚀
 - **OntologyGraph**: 绑定引用语义关系图（depends_on、composes、extends、produces）
 - **Action Abstraction**: 每个绑定的 intent、preconditions、postconditions，提升 AI 可读性
 - **Data Lineage**: governance_contract 中的数据血缘追踪（source → transform → sink）
@@ -396,13 +400,13 @@ sce orchestrate stop
 - **Agent Readiness 评分**: 质量评分新增可选加分维度（最高 +10 分）
 - **CLI 命令**: `scene ontology show|deps|validate|actions|lineage|agent-info`，支持 `--json`
 
-### 场景模板质量流水线 🚀 v1.41.0 新增
+### 场景模板质量流水线 🚀
 - **模板 Lint 引擎**: 10 类质量检查（清单完整性、绑定引用、治理合约、一致性、变量、文档、Action Abstraction、Data Lineage、Agent Hints）
 - **质量评分计算器**: 4 维度评分 + agent_readiness 加分（合约有效性、lint 通过率、文档质量、治理完整性 + Agent Readiness 最高 +10），0-100+ 分制
 - **一站式贡献流水线**: 验证 → Lint → 评分 → 预览 → 发布，一条命令完成
 - **CLI 命令**: `scene lint`、`scene score`、`scene contribute`，支持 `--strict`、`--dry-run`、`--skip-lint`、`--json`
 
-### 场景模板引擎 🚀 v1.25.0 新增
+### 场景模板引擎 🚀
 - **模板变量 Schema**: 在 scene-package.json 中定义类型化变量（string, number, boolean, enum, array）及验证规则
 - **多文件渲染**: 递归模板处理，支持 `{{variable}}` 替换、`{{#if}}` 条件、`{{#each}}` 循环
 - **三层继承**: L1-能力层 / L2-领域层 / L3-实例层包层级结构，支持 schema 和文件合并
@@ -480,7 +484,7 @@ sce spec gate run --specs "<spec-a,spec-b>" --max-parallel <N>     # 多 Spec
 sce context export <spec-name>     # 为 AI 工具导出上下文
 sce prompt generate <spec> <task>  # 生成任务特定提示
 
-# KPI 自动化与可观测（v1.46.2 新增）
+# KPI 自动化与可观测
 sce value metrics sample --out <path> --json               # 生成 KPI 输入样例 JSON
 sce value metrics snapshot --input <path> --json          # 生成周度 KPI 快照 + gate 摘要
 sce value metrics baseline --from-history <N> --json      # 从最早 N 个快照生成 baseline
@@ -489,14 +493,14 @@ sce auto kpi trend --weeks 8 --period week --json         # 聚合自动交付 K
 sce auto kpi trend --weeks 8 --period day --csv --out <path> # 以 CSV 导出自动 KPI 趋势
 sce auto kpi trend --weeks 8 --mode controller --json     # 仅查看 close-loop-controller 会话趋势
 
-# 工作区管理（v1.11.0 新增）
+# 工作区管理
 sce workspace create <name> [path] # 注册新工作区
 sce workspace list                 # 列出所有工作区
 sce workspace switch <name>        # 切换活动工作区
 sce workspace info [name]          # 显示工作区详情
 sce workspace remove <name>        # 删除工作区
 
-# 环境管理（v1.14.0 新增）
+# 环境管理
 sce env list                       # 列出所有环境
 sce env switch <name>              # 切换到环境（自动备份）
 sce env info                       # 显示活动环境详情
@@ -506,22 +510,22 @@ sce env rollback                   # 回滚到上一个环境
 sce env verify                     # 验证当前环境
 sce env run "<command>"            # 在环境上下文中运行命令
 
-# 场景模板引擎 (v1.25.0 新增)
+# 场景模板引擎
 sce scene template-validate --package <path>   # 验证模板变量 schema
 sce scene template-resolve --package <name>    # 解析继承链和合并 schema
 sce scene template-render --package <name> --values <json> --out <dir>  # 渲染模板文件
 
-# Moqui ERP 集成 (v1.39.0 新增)
+# Moqui ERP 集成
 sce scene connect --config <path>              # 测试 Moqui ERP 实例连接
 sce scene discover --config <path>             # 发现 Moqui 实体、服务、屏幕
 sce scene extract --config <path> --out <dir>  # 从 Moqui 提取场景模板 (v1.40.0)
 
-# 场景模板质量流水线 (v1.41.0 新增)
+# 场景模板质量流水线
 sce scene lint --package <path>                # Lint 场景包质量检查
 sce scene score --package <path>               # 计算质量评分 (0-100)
 sce scene contribute --package <path>          # 一站式验证 → lint → 评分 → 发布
 
-# 场景 Ontology (v1.42.0 新增)
+# 场景 Ontology
 sce scene ontology show --package <path>       # 显示 Ontology 图
 sce scene ontology deps --ref <ref>            # 查询依赖链
 sce scene ontology impact --ref <ref>          # 分析反向影响面
@@ -531,13 +535,18 @@ sce scene ontology actions --ref <ref>         # 显示 Action Abstraction
 sce scene ontology lineage --ref <ref>         # 显示数据血缘
 sce scene ontology agent-info --package <path> # 显示 Agent Hints
 
-# Agent 编排 (v1.45.0 新增)
+# Agent 编排
 sce orchestrate run --specs "<spec列表>" --max-parallel <N>  # 启动多 Agent 编排
 sce orchestrate status                         # 查看编排进度
 sce orchestrate stop                           # 停止所有子 Agent
 
 # 说明：当使用 --specs 调用 sce spec bootstrap/pipeline run/gate run 时，会默认转到 orchestrate 模式
 
+# 发布基线（CI 默认）
+sce auto handoff preflight-check --require-pass --json  # 硬门禁：preflight 不通过则阻断发布
+git tag -a vX.Y.Z -m "vX.Y.Z"                          # 创建发布 tag
+git push origin vX.Y.Z                                  # 推送 tag，触发 GitHub Release + npm 自动发布
+
 # DevOps 运维
 sce ops init <project-name>        # 初始化运维 specs
 sce ops validate [<project>]       # 验证运维完整性
@@ -621,7 +630,7 @@ sce spec bootstrap --name 01-00-my-first-feature --non-interactive
 
 ---
 
-**版本**：2.0.0  
-**最后更新**：2026-02-18
+**版本**：3.3.1  
+**最后更新**：2026-02-22