2026-05-13.111757

Summary

• YAML block scalar support + installer bundle smoke isolation
• README architecture diagram (simplified, centered SVG)
• Blueprint First-Use Adoption Proof criteria expansion

Changed

• Runtime: Add block scalar parsing (|, |-, >, >-) to built-in YAML parser; external skill front-matter parse errors degrade gracefully (fail-closed for builtin, tolerant for user)
• Installer: Isolate bundle smoke HOME to prevent user-level skills from interfering with validation
• Docs: Add simplified architecture SVG to README (EN + CN); expand Adoption Proof deliverables; add Release pipeline + test health baseline to process items
• Tests: Block scalar, skill registry tolerance, installer isolation coverage (+75 lines)

2026-05-11.202509

Summary

P4c Host Consumption Governance release.

This release converges Sopify host-facing consumption surfaces so Codex/Claude prompts, runtime output, status, and doctor views consume canonical
protocol and handoff facts instead of exposing internal route taxonomy, helper wiring, or blueprint implementation details.

Highlights

• Added protocol.md §8 as the authoritative host-consumption contract.
• Reduced Codex/Claude prompt assets to stable protocol references and user-facing workflow semantics.
• Converged runtime output around handoff/protocol facts:
  • loaded files render as Context
  • route fields are no longer exposed in user-facing output
  • gate status fallback is stable
  • status symbols and Next hints map through handoff semantics
• Improved status/doctor output:
  • raw taxonomy codes are replaced with human-facing labels
  • checkpoint/state-conflict wording is clearer
• Added host enhancement declarations for:
  • continuation
  • interaction
  • audit
• Added validation script:
  • scripts/check-enhancement-declaration.py
• Expanded automated coverage for output rendering, installer status, and doctor contracts.

Plan / Blueprint References

• Archived plan:
  • .sopify-skills/history/2026-05/20260510_p4c_host_consumption_governance/
• Blueprint updates:
  • .sopify-skills/blueprint/protocol.md
  • .sopify-skills/blueprint/design.md
  • .sopify-skills/blueprint/tasks.md
  • .sopify-skills/history/index.md

Verification

Release preflight passed locally with Python 3.14:

PATH=/opt/homebrew/opt/python@3.14/bin:$PATH bash scripts/release-preflight.sh

Results:

- hard gate: 686 passed
- implementation-mirror tests: 31 passed
- install/payload bootstrap smoke: passed
- prompt runtime gate smoke: passed
- bundle runtime smoke: passed
- skill eval gate: passed

## Assets

Upload the rendered stable release assets, not the repository root installer files:

- install.sh
- install.ps1

2026-05-07.220011

Summary

P3a Contract-Aligned Surface Cleanup 完整交付。Execution routing 收敛、cancel_scope 修复、knowledge_sync audit trail、dead path cleanup (-88 LOC)、blueprint 已完成里程碑压缩 + Px 独立里程碑。

Changed

• Execution routing convergence: authorized ActionProposal → deterministic route derive (_derive_route_from_authorized_proposal); Router.classify 降为 bare-text legacy fallback
• cancel_scope fix: cancel_flow 在 derive 路径内联处理，修复 artifacts 为空时默认全局清理的 bug
• knowledge_sync audit trail: knowledge_sync_result 贯穿 archive 全管道（success / blocked / archive_target_conflict 三路径）
• Dead code removal: 删除 6 个无引用私有函数 + 1 个孤立常量 (-88 LOC)
• Test coverage: +17 routing convergence tests, +2 archive knowledge_sync tests, classify exclusion + checkpoint split 补齐
• Blueprint restructure: P0–P3a 压缩为一行摘要；Px runtime_surface_consolidation 独立里程碑（post-P4）
• P3a archived: plan → history/2026-05/20260507_p3a_contract_aligned_surface_cleanup/

Plan Packages

• 20260507_p3a_contract_aligned_surface_cleanup (archived)

File details

Runtime — Execution routing + archive audit trail + dead code removal:

• runtime/engine.py (+207 derive functions, -36 dead code)
• runtime/archive_lifecycle.py (+47 knowledge_sync pipeline)
• runtime/router.py (-26 dead function + constant + imports)
• runtime/workspace_preflight.py (-20 dead function)
• runtime/action_projection.py
• runtime/checkpoint_request.py
• runtime/deterministic_guard.py
• runtime/develop_callback.py
• runtime/handoff.py
• runtime/output.py
• runtime/plan_orchestrator.py
• runtime/vnext_phase_boundary.py

Contracts — Schema cleanup:

• runtime/contracts/decision_tables.schema.json
• runtime/contracts/decision_tables.yaml
• runtime/contracts/failure_recovery_table.schema.json
• runtime/contracts/failure_recovery_table.yaml
• runtime/contracts/signal_priority_table.schema.json

Tests — 689 tests, 49 subtests:

• tests/test_runtime_engine.py (+337 routing convergence + archive assertions)
• tests/test_runtime_plan_registry.py (+70 knowledge_sync receipt tests)
• tests/test_context_v1_scope.py
• tests/test_runtime_decision.py
• tests/test_runtime_decision_tables.py
• tests/test_runtime_failure_recovery.py
• tests/test_runtime_gate.py
• tests/test_runtime_plan_reuse.py
• tests/test_runtime_router.py
• tests/test_runtime_state.py
• tests/test_bundle_smoke.py
• tests/fixtures/context_fail_close_contract.yaml
• tests/pytest_entries/fail_close_contract_entry.py

Blueprint — Milestone compression + Px:

• .sopify-skills/blueprint/tasks.md
• .sopify-skills/blueprint/design.md
• .sopify-skills/blueprint/protocol.md
• .sopify-skills/blueprint/README.md
• .sopify-skills/history/index.md
• .sopify-skills/history/2026-05/20260507_p3a_contract_aligned_surface_cleanup/

Docs & Skills:

• README.md, README.zh-CN.md
• Claude/Skills/CN/CLAUDE.md, Claude/Skills/EN/CLAUDE.md
• Codex/Skills/CN/AGENTS.md, Codex/Skills/EN/AGENTS.md
• scripts/check-prompt-runtime-gate-smoke.py

2026-05-06.181908

Release Overview

Item	Value
Compare	2026-05-03.203432 → 2026-05-06.181908
Scope	69 files changed, +4215 / -3746

Highlights

• 完成 P1 / P1.5 主线收口，重点强化 execute_existing_plan 的授权、验证与拒绝链路。
• 为 ActionProposal 引入 plan_subject 与 revision_digest 校验，补齐执行主体、目标 plan 与工作区边界的输入约束。
• 将非命令态 planning 的默认策略收紧为 authorized_only，未授权的 plan materialization 请求统一降级为受保护的 consult / guard surface。
• 落地 ExecutionAuthorizationReceipt contract，提供规范化序列化、稳定 fingerprint、标准化 proposal_id 生成，以及跨 handoff / run 的持久化传递。
• 新增 stale receipt 的 fail-closed 校验，按完整性、绑定关系与新鲜度三层验证，阻止旧授权凭证跨运行误复用。
• 将 DECISION_REJECT 从 consult 伪装语义中剥离，统一为独立的 proposal_rejected surface，并同步对齐 engine、handoff 与 output。
• 将 verifier 的关键字段与消费路径升级为规范性 contract，明确 verdict / evidence / source 的要求，并收紧与 receipt、存储边界的关系。
• 完整移除 ~summary 路由及相关模型、输出和测试残留，进一步缩小 runtime 职责面并降低维护成本。
• 补齐协议与运行时测试覆盖，包括 convention/compliance suite、action intent、engine 集成测试，以及 stale receipt cross-run proof；关键切片累计验证至
  632 项通过。
• 重写 README.md 与 README.zh-CN.md 首屏叙事，强化产品定位、协作方式与入口表达。
• 更新 blueprint 基线，补充 plugin taxonomy、promise tiers、collaboration positioning 与外部接入差距分析，并同步收敛 P1.5 plan/history 轨迹。

2026-05-03.203432 — Blueprint Truth Cutover

Blueprint Truth Cutover — 完成

让 blueprint 成为产品预算和契约的唯一定义源。Runtime 从 truth source 降为迁移层 + 参考实现。

核心变更

Runtime 表面收敛到 canonical 预算：

• Checkpoint kinds: 5 → 2（clarification, decision）
• Route families: 18 → 6（consult, plan, develop, archive, summary, cancel）
• Host actions: 11 → 5 canonical + 1 legacy

删除三个大型 legacy 概念层：

• plan_proposal 层（confirm_plan_package / plan_proposal_pending）— Wave 3a
• execution_confirm 层（confirm_execute / execution_confirm_pending）— Wave 3b
• archive_review 从 host action 退出 — Wave 2b

净删 3596 行代码，93 文件变更。

Breaking Changes

• execution_confirm.py 已删除
• plan_proposal.py 已删除
• develop_checkpoint 重命名为 develop_callback（无兼容 alias）
• Host action confirm_execute / confirm_plan_package / archive_review 不再出现
• V1 scope 收缩到 confirm_decision only

验证

• 580 tests passed, 46 subtests passed
• 8 条验收标准全 PASS
• Cross-review advisory: 0 blocker
• Release preflight: all checks passed

已知 Legacy Debt

• review_or_execute_plan: host action 超 canonical 预算
• continue_checkpoint_confirmation: 孤儿映射

安装

curl -fsSL https://raw.githubusercontent.com/evidentloop/Sopify/2026-05-03.203432/install.sh | bash

2026-04-29.182018

变更记录

本次发布覆盖 2026-04-14.175552..2026-04-29.182018 的全部变更。

亮点

• 引入 ActionProposal / ActionValidator 边界层，明确区分“用户意图提案”和“runtime effect 执行”。
• 完成 runtime gate 对 --action-proposal-json 的接收、校验、retry contract 和 host prompt 接入。
• 新增 CrossReview advisory skill，并同步 CrossReview Phase 4a 的 host-integrated 默认流程。
• 完成 legacy feature cleanup：移除旧 ~compare / model-compare runtime，以及旧 consult override 路径。
• 退役 TraeCn legacy host surface，收敛到更轻量的可插拔 host/runtime 架构。
• 补充 prompt governance / philosophy intake gate 设计文档，为后续 AGENTS/CLAUDE prompt 收敛打基础。

Runtime & Safety

• 新增 runtime/action_intent.py，包含 ActionProposal、ValidationContext、ValidationDecision、ActionValidator 与 adapter。
• gate 支持 malformed proposal fail-close：解析失败时返回 action_proposal_retry，避免静默fallback 到 legacy path。
• decision tables 支持同一 resolved action 下按 checkpoint kind 分行匹配。
• 更新 failure recovery schema、manifest、engine、router、handoff、output、replay 等 runtime内部契约。
• 移除 explain-only / consult override 旧分支，为后续 ActionProposal-only 路由收口做准备。

Distribution & Hosts

• 更新 Codex / Claude 中英文 host prompt，补齐 action proposal capability、retry、schema 动态读取和非 0 exit stdout 解析规则。
• 更新 installer、bootstrap、sync scripts、version consistency 检查和 release process 文档。
• install.sh / install.ps1 已指向 stable channel 与本次 tag。
• 退役 TraeCn host adapter 与相关 skill payload。

CrossReview & Evaluation

• 新增 .agents/skills/cross-review advisory skill。
• 新增/归档 CrossReview engine、product form analysis、Hermes insights、cross-project insights等方案材料。
• 调整 skill eval gate 与 baseline/SLO，以适配 legacy compare 移除后的新边界。

Knowledge Base & Blueprint

• 新增和更新多个方案包：
  • blueprint graphify integration
  • UX perception tuning
  • cross review engine
  • lightweight pluggable architecture
  • action proposal boundary
  • host prompt governance
  • legacy feature cleanup
• 归档已完成方案，清理 abandoned/过期 plan。
• 更新 blueprint README / design / history index，记录当前架构方向。

Removed / Cleanup

• 移除 scripts/model_compare_runtime.py、runtime/compare_decision.py 和 builtin model-
  compare skill package。
• 移除 Codex / Claude skill payload 中的 model-compare 子技能。
• 移除 TraeCn CN/EN skills、user rules、installer host adapter。
• 从 example config 中移除 multi_model 配置，避免用户复制后触发无效配置。

Validation

已验证：

• python3 -m compileall runtime scripts tests
• Focus pytest: 324 passed, 24 subtests passed
• Full pytest: 639 passed, 68 subtests passed
• release preflight hook
• install / payload bootstrap smoke
• prompt runtime gate smoke
• bundle runtime smoke
• skill eval quality gate
• version consistency check

2026-04-14.175552

What's New in 2026-04-14.175552

🚀 Trae CN Host Adapter (Experimental)

Sopify now supports Trae CN (ByteDance Trae China Edition IDE) as a third host, alongside Codex and Claude.

• Full HostAdapter + HostCapability + HostRegistration three-layer architecture
• Skill payloads synced: TraeCn/Skills/{CN,EN} with all 7 skills (analyze, design, develop, kb, model-compare, templates, workflow-learning)
• Integrated into sync/release/CI tool chain (sync-skills.sh, check-skills-sync.sh, check-version-consistency.sh)
• Installer support: --target trae-cn:{zh-CN,en-US}
• Phase 0-2 complete; Phase 3 (real IDE smoke) pending

🔍 Ingress Proof Diagnostics

• New ingress proof doctor for diagnosing installation and payload discovery issues

🐛 Bug Fixes

• Fixed test environment isolation: ambient CLAUDE_*/CODEX_* variables no longer leak into test subprocess environments
• Finalized V1 handoff and archive truth

📄 Documentation

• Updated README host compatibility matrix (3 hosts)
• Added TraeCn/ to directory structure docs
• Updated sub-skills mirror notes for Trae CN
• Refined CONTRIBUTING guides

---

2026-04-14.175552 更新内容

🚀 Trae CN 宿主适配器（实验性）

Sopify 现在支持 Trae CN（字节跳动 Trae 国内版 IDE）作为第三个宿主，与 Codex 和 Claude 并列。

• 完整的 HostAdapter + HostCapability + HostRegistration 三层架构
• Skill 载荷同步：TraeCn/Skills/{CN,EN} 包含全部 7 个 Skill（analyze、design、develop、kb、model-compare、templates、workflow-learning）
• 集成到同步/发布/CI 工具链（sync-skills.sh、check-skills-sync.sh、check-version-consistency.sh）
• 安装器支持：--target trae-cn:{zh-CN,en-US}
• Phase 0-2 已完成；Phase 3（真实 IDE 烟测）待进行

🔍 入口证明诊断

• 新增入口证明诊断工具，用于排查安装和载荷发现问题

🐛 Bug 修复

• 修复测试环境隔离：环境中的 CLAUDE_*/CODEX_* 变量不再泄漏到测试子进程环境
• 完成 V1 交接和归档确认

📄 文档

• 更新 README 宿主兼容性矩阵（3 个宿主）
• 在目录结构文档中添加 TraeCn/
• 更新子技能镜像说明以包含 Trae CN
• 优化 CONTRIBUTING 指南

2026-04-10.104951

Summary

This patch release closes the Plan A V1 parser-first release
narrative.

It ships the V1-ready boundary after Checkpoint A/B/C
closure:

• parser-first remains the only active V1 path
• V1 scope boundary is locked
• Plan A checkpoint governance is enforced for scoped
  commits and PRs
• machine-contract and task ledger wording are aligned with
  the shipped runtime behavior

Included

• Enforced V1 decision-table scope validation through the
  shared loader
• Normalized repo-internal absolute paths and fail-closed
  external absolute paths for the V1 file-map guard
• Enforced Plan A context-checkpoint governance across
  scoped commit / PR flows
• Documented guardrail handoff artifacts and the V1 scope
  registry in the machine-contract overview
• Synced release-managed docs and version surfaces to 2026- 04-10.104951

Verification

Release preflight passed on this version, including:

• version consistency
• fail-close contract checks
• context checkpoint checks
• full runtime unit test suite
• install / payload bootstrap smoke
• prompt runtime gate smoke
• bundle runtime smoke
• skill eval quality gate

Deferred

The following remain intentionally deferred to V2 and do not
block this V1 patch release:

• 12.x
• 13.2~13.4
• 14.6
• 15.7

Checkpoint D and classifier rollout are still V2-only.

2026-04-02.224459

发布概览

本版本完成 Plan B1 主线收口，重点是 runtime 控制面解耦、安装链路稳定性、诊断可读性与兼容路径可见性。默认使用方式保持不变。

主要变更（What’s Changed）

• [Runtime] 统一运行解析链路：stub -> global bundle -> gate/preload -> legacy fallback，减少路径分叉导致的行为不一致。
• [Workspace] 新 workspace 不再复制整套重型 runtime 到仓库，仅保留轻量 thin stub 入口，仓库更干净。
• [Installer] payload 解析升级为 versioned bundle 模式，支持 exact pin 与 host-delegated（active_version）两类解析。
• [Bootstrap] 首次写入策略更明确：non-git 场景要求显式确认；git 默认走可控 ignore 策略，避免无感污染仓库。
• [Diagnostics] status / doctor 与 installer 的结果码和提示语义对齐，缺失/不兼容场景可直接看到原因与下一步。
• [Fallback] 保留 legacy 兼容路径，但改为显式可见，不再静默降级。

破坏性变更（Breaking Changes）

• 无。

升级操作（Upgrade Actions Required）

• 通常无需手动迁移，按现有方式继续使用即可。
• 建议发布后执行一次快速自检：

python3 scripts/sopify_status.py --format text
python3 scripts/sopify_doctor.py --format text

质量与验证（Validation）

• 通过 release preflight 检查链路。
• 覆盖 install/bootstrap smoke、runtime gate smoke、bundle smoke 与核心回归测试。
• dual-host、monorepo root 选择、legacy fallback 可见性等关键场景已纳入验证。

已知限制与后续（Known Limits / Next）

• 本版本不包含一键迁移旧 vendored runtime 的 Migration Utility。
• 本版本不包含历史 bundle 自动清理（prune）。
• 部分 CLI 文案润色项（如 workspace_hint / runtime_notes）延后处理。

Full Changelog

• Compare: 2026-03-28.220226...
• Included PRs: #3 #4 #5 #6 #7

———

Overview

This release completes the core scope of Plan B1, focusing on control-plane decoupling, installer/runtime stability, clearer diagnostics, and visible compatibility
behavior, while keeping the default user workflow unchanged.

What’s Changed

• [Runtime] Unified resolution flow: stub -> global bundle -> gate/preload -> legacy fallback for more predictable behavior.
• [Workspace] New workspaces no longer copy the full heavy runtime; only a lightweight thin-stub entry is kept.
• [Installer] Payload resolution now uses versioned bundles, covering exact pin and host-delegated (active_version) modes.
• [Bootstrap] First-write policy is stricter and clearer: explicit confirmation for non-git paths; safer ignore behavior for git repos.
• [Diagnostics] status / doctor outputs are aligned with installer reason codes and remediation guidance.
• [Fallback] Legacy compatibility remains available, but fallback is now explicit and visible, not silent.

Breaking Changes

• None.

Upgrade Actions Required

• Manual migration is usually not required.
• Recommended post-release checks:

python3 scripts/sopify_status.py --format text
python3 scripts/sopify_doctor.py --format text

Validation

• Release preflight pipeline passed.
• Covered install/bootstrap smoke, runtime gate smoke, bundle smoke, and core regression tests.
• Key scenarios verified: dual-host handling, monorepo root selection, and visible legacy fallback behavior.

Known Limits / Next

• One-click migration utility for legacy vendored runtime is not included in this release.
• Automatic prune for historical bundles is not included.
• Additional CLI wording polish (for example workspace_hint / runtime_notes) is deferred.

Full Changelog

• Compare: 2026-03-28.220226...
• Included PRs: #3 #4 #5 #6 #7

2026-03-28.220226

Background

This release closes the current Plan H state-machine hotfix loop on top of the previous public runtime baseline.

• .sopify-skills/history/2026-03/20260327_hotfix/design.md
• .sopify-skills/history/2026-03/20260327_hotfix/tasks.md

Highlights:

• tightened the transition between planning and pending-confirmation states to reduce drift and incorrect recovery
• completed the remaining guardrail fixes from 20260327_hotfix
• unified cancel handling across plan-review and decision-review checkpoints
• relaxed cancel submission requirements so cancellation can succeed even when no option was selected
• improved status / doctor diagnostics for runtime state conflicts
• added regression coverage across router, engine, decision, state, and installer status/doctor

Not included in this release:

• follow-up semantic recall improvements
• control-plane / payload / compatibility migration

---

背景

本次版本在上一公开 runtime 基线之上，完成当前 Plan H 状态机 hotfix 的收口：

• .sopify-skills/history/2026-03/20260327_hotfix/design.md
• .sopify-skills/history/2026-03/20260327_hotfix/tasks.md

主要内容：

• 收紧规划与待确认状态之间的流转，减少状态漂移和误恢复
• 完成 20260327_hotfix 的剩余护栏修复
• 统一方案确认 / 决策确认场景下的“取消”处理
• 放宽取消场景下的提交约束，避免因为缺少选择项而无法正确取消
• 增强 status / doctor 对运行态冲突的诊断信息
• 补齐 router / engine / decision / state / installer status-doctor 相关回归测试

本次不包含：

• 后续语义召回增强
• control-plane / payload / compatibility 迁移