Skip to content

Commit 13ee4b2

Browse files
committed
w3.6: blueprint sync — post-P8 narrative alignment across all layers
Blueprint (design.md): - Product positioning: "开发过程协议层" (development process protocol layer) - 4-layer table: 用户层/产品层/能力层/架构层 - Convergence chain: produce→verify→record evidence→settle (final) - Three-layer positioning: Protocol Kernel + Default Workflow + Host Adapters - Core pipeline: Validator → protocol admission - Runtime 五层架构: [RETIRED by P8] - 宿主能力治理: full rewrite (convention_only / payload_capable / protocol_verified) - 削减预算表: P8 Final with completion markers - Hard constraints: updated to post-P8 terms - Core contracts: Checkpoint/Archive/Runtime state scope → post-P8 ADR-013: P8 scope clarification → final ADR-017: SUPERSEDED → RETIRED (all instances) Protocol.md: P8 terminology mapping note, SUPERSEDED → RETIRED Product docs: - README: "development process protocol layer", tracked vs gitignored distinction - README.zh-CN: synchronized - Architecture SVG: regenerated with user-friendly labels, product slogans Active governance: - install.sh: "runtime" → "protocol kernel" - .githooks/pre-commit: runtime/* → sopify_writer/* + sopify_contracts/* Blueprint tasks.md: - Runtime retirement Phase 2 marked done - Protocol prose cleanup recorded as explicit future item - Product direction principle updated P8 plan package: W3.6 + Wave 3 Gate marked complete, status → Finalize 181 passed / 0 failed. Protocol smoke 3/3 PASS.
1 parent b177e10 commit 13ee4b2

14 files changed

Lines changed: 230 additions & 492 deletions

File tree

.githooks/pre-commit

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -83,10 +83,10 @@ trap on_exit EXIT
8383
is_release_relevant_file() {
8484
local path="$1"
8585
case "$path" in
86-
runtime/*|installer/*|skills/*|README.md|README.zh-CN.md|CHANGELOG.md)
86+
sopify_writer/*|sopify_contracts/*|installer/*|skills/*|README.md|README.zh-CN.md|CHANGELOG.md)
8787
return 0
8888
;;
89-
scripts/sopify_runtime.py|scripts/model_compare_runtime.py|scripts/check-bundle-smoke.sh|scripts/release-sync.sh|scripts/release-preflight.sh|scripts/sync-skills.sh|scripts/check-version-consistency.sh)
89+
scripts/release-sync.sh|scripts/release-preflight.sh|scripts/sync-skills.sh|scripts/check-version-consistency.sh)
9090
return 0
9191
;;
9292
*)

.sopify/blueprint/architecture-decision-records/ADR-013.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -15,13 +15,13 @@ Sopify 需要明确自身在 AI 编程生态中的定位,避免与宿主(Kir
1515

1616
Sopify 官方在 core 之上提供轻量、可插拔、收敛式的 blueprint-driven workflow 作为默认产品体验。
1717

18-
> **P8 Scope Clarification(2026-06)**:P8 后"Authorization"的含义显式收窄。本 ADR 标题"Evidence & Authorization Layer"不改(不做品牌手术)。P8 后 Authorization 不再指 pre-execution side-effect approval(该职责退回宿主原生权限、sandbox、用户确认、工具审批)。Sopify 保留的 authorization 语义收窄为:protocol admission(sopify_writer schema/contract 校验)、receipt validity(证据链完整性)、archive admission(归档准入)。ExecutionAuthorizationReceipt 作为 pre-execution authorization artifact 在 P8 显式退场(详见 ADR-017 [SUPERSEDED by P8])。收敛链从 produce → verify → authorize → settle 收窄为 produce → verify → record evidence → settle。
18+
> **P8 Final Scope(2026-06)**:P8 后"Authorization"的含义已最终收窄。本 ADR 标题"Evidence & Authorization Layer"不改(不做品牌手术)。P8 后 Authorization 不再指 pre-execution side-effect approval(该职责退回宿主原生权限、sandbox、用户确认、工具审批)。Sopify 保留的 authorization 语义为:protocol admission(sopify_writer schema/contract 校验)、receipt validity(证据链完整性)、archive admission(归档准入)。ExecutionAuthorizationReceipt 作为 pre-execution authorization artifact 在 P8 已退场(详见 ADR-017 [RETIRED by P8])。收敛链已确定为 produce → verify → record evidence → settle。
1919
2020
Core 职责:
2121

2222
1. **证据规范**:定义任务/方案/交接/归档事实的标准格式(`.sopify/` 纯文件协议)
23-
2. **授权判定**Validator 是唯一授权者——判定行动是否可执行、方案是否可归档
24-
3. **收据生成**fail-closed 授权回执让每次决策可追溯、可审计
23+
2. **协议准入**sopify_writer 做结构级校验——判定写入是否符合协议格式、receipt 是否有效、归档是否完整
24+
3. **审计证据**receipts 让每次决策可追溯、可审计
2525
4. **跨宿主接力**:handoff 机器契约让任务在不同 session/model/host 间精确恢复
2626
5. **知识沉淀**:跨任务可复用的稳定结论沉淀为 blueprint / history
2727

@@ -59,13 +59,13 @@ Core + Default Workflow 之外的生产/验证/知识增强,归入 **Plugins /
5959

6060
如果以上任一能力被宿主完全替代且无跨宿主可携带性需求,该能力应 sunset。
6161

62-
**Feature intake gate**:每个新特性必须回答——它增强了哪项不可替代能力?是否扩大了 runtime surface?如果只在单宿主场景下有价值,不进 core。
62+
**Feature intake gate**:每个新特性必须回答——它增强了哪项不可替代能力?是否扩大了 protocol surface?如果只在单宿主场景下有价值,不进 core。
6363

6464
## 后果
6565

66-
- Core(durable)只保留证据规范 / 授权判定 / 收据生成 / 合规验证 / 跨宿主接力契约
66+
- Core(durable)只保留证据规范 / 协议准入 / 审计证据 / 合规验证 / 跨宿主接力契约
6767
- Default Workflow 是 Core 之上的官方收敛式工作流,地位高于参考 demo,低于 Core
6868
- 具有独立用户价值的生产/验证/知识能力设计为外插 Plugins / Skills
6969
- CrossReview 是已实现的外插参考范本
70-
- Runtime 是参考实现,服务于 Default Workflow,不是 co-equal product
70+
- Runtime 已在 P8 中退场;protocol kernel(sopify_writer + sopify_contracts + protocol.md)是 post-P8 的真相源
7171
- Core promotion rule:只有影响跨宿主互操作、receipt validity、archive admissibility 的契约才进 Core

.sopify/blueprint/architecture-decision-records/ADR-017.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# ADR-017: Action/Effect Boundary
22

3-
状态: P0 完成,P1.5-B ExecutionAuthorizationReceipt 升格 normative ~~(P8 SUPERSEDED)~~
3+
状态: P0 完成,P1.5-B ExecutionAuthorizationReceipt 升格 normative(P8 RETIRED)
44
日期: 2026-04-28 (P0),2026-05-06 (P1.5-B receipt normative)
55

66
## 背景
@@ -29,11 +29,11 @@
2929
4. **执行层不理解人话** — 只按结构化字段和文件事实做事
3030
5. **`fallback_router` 是临时兼容出口** — 应单调收缩,不承接新的长期能力
3131

32-
### ExecutionAuthorizationReceipt — *[SUPERSEDED by P8]*
32+
### ExecutionAuthorizationReceipt — *[RETIRED by P8]*
3333

34-
> **P8 退场声明**:本节在 P8 中标记为 [SUPERSEDED by P8]。pre-execution authorization model(runtime gate 在执行前生成 EAR)不再适用;P8 删除 runtime gate 后,不存在稳定的"执行前授权时刻"。post-P8 审计主链改由 `plan/<id>/receipts/*.json` + `history/<id>/receipt.md` 承担(post-execution evidence chain)。W3.6 全量收口时升级为 [RETIRED by P8]。以下为 pre-P8 legacy reference,不作为 post-P8 新宿主接入 contract。
34+
> **P8 退场声明**:本节在 P8 中标记为 [RETIRED by P8]。pre-execution authorization model(runtime gate 在执行前生成 EAR)不再适用;P8 删除 runtime gate 后,不存在稳定的"执行前授权时刻"。post-P8 审计主链改由 `plan/<id>/receipts/*.json` + `history/<id>/receipt.md` 承担(post-execution evidence chain)。W3.6 全量收口时升级为 [RETIRED by P8]。以下为 pre-P8 legacy reference,不作为 post-P8 新宿主接入 contract。
3535
36-
> ~~**升格状态**:本节从"方向"升格为 **normative**(P1.5-B 升格)。字段语义使用 RFC 2119 表述。~~ [SUPERSEDED by P8 — normative 状态已随 runtime gate 退场]
36+
> ~~**升格状态**:本节从"方向"升格为 **normative**(P1.5-B 升格)。字段语义使用 RFC 2119 表述。~~ [RETIRED by P8 — normative 状态已随 runtime gate 退场]
3737
3838
execution_confirm checkpoint 重分类为机器授权事实:
3939

@@ -81,7 +81,7 @@ Implementation plan 可补充字段,但 MUST NOT 删除或弱化上述字段
8181
## 后续扩展方向
8282

8383
-`propose_plan` + `write_plan_package` side-effect proof(P1.5-C 完成:authorized_only 策略)
84-
- ~~`execute_existing_plan` 通过 ExecutionAuthorizationReceipt 授权(P1.5-B 升格 normative)~~ [SUPERSEDED by P8 — pre-execution authorization model retired]
84+
- ~~`execute_existing_plan` 通过 ExecutionAuthorizationReceipt 授权(P1.5-B 升格 normative)~~ [RETIRED by P8 — pre-execution authorization model retired]
8585
- `fallback_router` 职责单调收缩
8686

8787
## 后果

0 commit comments

Comments
 (0)