Close runtime bundle sync and CI

Author: Li-Sanze

.github/workflows/ci.yml

@@ -22,3 +22,20 @@ jobs:
 
       - name: Check version consistency
         run: bash scripts/check-version-consistency.sh
+
+  runtime-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Run runtime unit tests
+        run: python3 -m unittest tests/test_runtime.py
+
+      - name: Run runtime smoke check
+        run: bash scripts/check-runtime-smoke.sh

.gitignore

@@ -1,2 +1,14 @@
 .DS_Store
 Thumbs.db
+sopify.config.yaml
+
+__pycache__/
+.pytest_cache/
+
+.sopify-runtime/
+
+.sopify-skills/state/
+.sopify-skills/replay/
+.sopify-skills/plan/*
+!.sopify-skills/plan/20260313_sopify_runtime_blueprint/
+!.sopify-skills/plan/20260313_sopify_runtime_blueprint/**

.sopify-skills/plan/20260313_sopify_runtime_blueprint/README.md

@@ -96,13 +96,13 @@ R0 需要补齐：
 - 仓库内新增 `scripts/sopify_runtime.py` 作为默认 repo-local 原始输入入口
 - `scripts/go_plan_runtime.py` 退回为 plan-only helper
 - `runtime/output.py` 已将 `RuntimeResult` 渲染为 Sopify 统一摘要
-- 本地验证已覆盖 plan / state / replay 落盘与重复执行目录冲突处理
-- README、AGENTS、design skill、蓝图任务单口径已对齐
+- `.gitignore` 已只忽略 runtime 本地产物，`tests/test_runtime.py` 不再被误忽略
+- 新增 `scripts/sync-runtime-assets.sh`，可把 runtime bundle 同步到目标仓库 `.sopify-runtime/`
+- 新增 `scripts/check-runtime-smoke.sh`，并已将 runtime unit test + smoke check 接入 CI
+- README、AGENTS、蓝图任务单口径已对齐
 
 当前仍未收口：
 
-- 面向安装分发的 runtime 资产自动同步
-- CI 与进仓测试纳入
 - `~compare` 的通用入口自动桥接
 - `~go exec` / `workflow-learning` 的独立 runtime helper
 

.sopify-skills/plan/20260313_sopify_runtime_blueprint/tasks.md

@@ -227,8 +227,8 @@ P0 实现原则：
 
 备注：
 
-- 当前本地已有 `tests/test_runtime.py`
-- 是否纳入版本控制并接入 CI，跟随当前 P0 接入闭环一起决策
+- `tests/test_runtime.py` 已纳入版本控制
+- 当前 CI 已接入 runtime unit test 与 smoke check
 
 ## R0 目标（后置，可选）
 
@@ -249,9 +249,9 @@ R0 实现原则：
 
 ### 1. 发布范围收口
 
-- [ ] 明确本次发布只承诺 `runtime-backed ~go plan`
-- [ ] 明确 `~go` / `~go exec` / 回放 runtime 不属于本次发布承诺
-- [ ] 同步蓝图、README、AGENTS 的能力口径
+- [x] 明确本次发布只承诺 `runtime-backed ~go plan`
+- [x] 明确 `~go` / `~go exec` / 回放 runtime 不属于本次发布承诺
+- [x] 同步蓝图、README、AGENTS 的能力口径
 
 验收条件：
 
@@ -260,9 +260,9 @@ R0 实现原则：
 
 ### 2. 安装与分发闭环
 
-- [ ] 让安装产物包含 runtime 所需代码
-- [ ] 保证 Codex / Claude 两侧都能拿到一致的运行时资产
-- [ ] 更新安装说明或同步脚本，消除“仓库里有代码、安装后没有”的断层
+- [x] 让安装产物包含 runtime 所需代码
+- [x] 保证 Codex / Claude 两侧都能拿到一致的运行时资产
+- [x] 更新安装说明或同步脚本，消除“仓库里有代码、安装后没有”的断层
 
 验收条件：
 
@@ -271,9 +271,9 @@ R0 实现原则：
 
 ### 3. `~go plan` 入口接线
 
-- [ ] 为 `~go plan` 提供稳定的宿主入口
-- [ ] 明确入口到 `run_runtime(...)` 的参数传递约定
-- [ ] 保持现有 `~compare` 运行时路径不被这次发布回归破坏
+- [x] 为 `~go plan` 提供稳定的宿主入口
+- [x] 明确入口到 `run_runtime(...)` 的参数传递约定
+- [x] 保持现有 `~compare` 运行时路径不被这次发布回归破坏
 
 验收条件：
 
@@ -282,9 +282,9 @@ R0 实现原则：
 
 ### 4. 输出适配
 
-- [ ] 将 `RuntimeResult` 渲染为 Sopify 统一输出模板
-- [ ] 在 `plan_only` 路由下稳定展示方案路径、产物文件和 Next 提示
-- [ ] 为失败场景补充可诊断输出
+- [x] 将 `RuntimeResult` 渲染为 Sopify 统一输出模板
+- [x] 在 `plan_only` 路由下稳定展示方案路径、产物文件和 Next 提示
+- [x] 为失败场景补充可诊断输出
 
 验收条件：
 
@@ -293,9 +293,9 @@ R0 实现原则：
 
 ### 5. 端到端验证
 
-- [ ] 在零配置工作区验证 `~go plan <需求>`
-- [ ] 验证 plan / state / replay 产物是否稳定落盘
-- [ ] 验证重复调用和跨会话恢复不会破坏当前 plan 状态
+- [x] 在零配置工作区验证 `~go plan <需求>`
+- [x] 验证 plan / state / replay 产物是否稳定落盘
+- [x] 验证重复调用和跨会话恢复不会破坏当前 plan 状态
 
 验收条件：
 
@@ -304,9 +304,9 @@ R0 实现原则：
 
 ### 6. 测试与 CI
 
-- [ ] 将 runtime 行为测试纳入版本控制
-- [ ] 在 CI 中增加最小 runtime 测试 job
-- [ ] 为发布切片补充至少一条安装后 smoke test 或等价验证
+- [x] 将 runtime 行为测试纳入版本控制
+- [x] 在 CI 中增加最小 runtime 测试 job
+- [x] 为发布切片补充至少一条安装后 smoke test 或等价验证
 
 验收条件：
 

Claude/Skills/CN/CLAUDE.md

@@ -133,7 +133,7 @@ Next: {下一步提示}
  | `~go exec` | 执行已有方案 |
  | `~compare` | 多模型并发对比（默认含当前会话模型；可用模型数不足 2 时降级并给出原因） |
 
-说明：当前仓库若存在 `scripts/sopify_runtime.py`，原始输入应优先走该默认 repo-local runtime 入口；仅在明确只走 `~go plan` 时使用 `scripts/go_plan_runtime.py` 这个 plan-only helper。
+说明：当前仓库若存在 `scripts/sopify_runtime.py`，原始输入应优先走该默认 repo-local runtime 入口；若 runtime 以 bundle 方式接入到其他仓库，则优先走 `.sopify-runtime/scripts/sopify_runtime.py`；仅在明确只走 `~go plan` 时使用对应的 `go_plan_runtime.py` helper。
 
 **workflow-learning 主动记录策略：**
 ```yaml
@@ -258,7 +258,7 @@ progressive: 按需创建文件 (默认)
 检查命令前缀 (~go, ~go plan, ~go exec, ~compare)
     ↓
 ├─ ~go exec → 执行已有方案
-├─ ~go plan → 规划模式 (需求分析 → 方案设计；若存在 scripts/sopify_runtime.py 则原始输入优先走该默认入口，plan-only 场景再使用 scripts/go_plan_runtime.py)
+├─ ~go plan → 规划模式 (需求分析 → 方案设计；若存在 scripts/sopify_runtime.py 或 .sopify-runtime/scripts/sopify_runtime.py，则原始输入优先走默认入口，plan-only 场景再使用对应的 go_plan_runtime.py)
 ├─ ~go → 全流程模式
 ├─ ~compare → 模型对比（调用 scripts/model_compare_runtime.py 运行时）
 └─ 无前缀 → 语义分析
@@ -404,14 +404,16 @@ Next: 请验证功能
 ~compare         # 对同一问题做多模型并发对比（可用模型不足 2 时自动单模型并解释原因）
 ```
 
-**repo-local runtime helper：**
+**runtime helper：**
 ```
-scripts/sopify_runtime.py         # 当前仓库默认原始输入入口，直接交给 router 分流
-scripts/go_plan_runtime.py        # 当前仓库用于 plan-only slice 的 helper
-scripts/model_compare_runtime.py  # ~compare 的运行时实现，不是默认通用入口
+scripts/sopify_runtime.py                    # 当前仓库默认原始输入入口，直接交给 router 分流
+.sopify-runtime/scripts/sopify_runtime.py    # 二次接入后 vendored 默认入口
+scripts/go_plan_runtime.py                   # 当前仓库用于 plan-only slice 的 helper
+.sopify-runtime/scripts/go_plan_runtime.py   # vendored plan-only helper
+scripts/model_compare_runtime.py             # ~compare 的运行时实现，不是默认通用入口
 ```
 
-说明：当前默认入口是 `scripts/sopify_runtime.py`；`scripts/go_plan_runtime.py` 只负责 plan-only；`~compare` 仍依赖宿主侧专用桥接。
+说明：当前默认入口是 `scripts/sopify_runtime.py`；若以 bundle 方式接入则入口对应 `.sopify-runtime/scripts/sopify_runtime.py`；`go_plan_runtime.py` 只负责 plan-only；`~compare` 仍依赖宿主侧专用桥接。
 
 **配置文件：** `sopify.config.yaml` (项目根目录)
 

Claude/Skills/EN/CLAUDE.md

@@ -133,7 +133,7 @@ Complex Task (full 3 phases):
 | `~go exec` | Execute existing plan |
 | `~compare` | Multi-model parallel comparison (includes session default model by default; falls back with reasons when usable model count is below 2) |
 
-Note: when the current repository provides `scripts/sopify_runtime.py`, raw input should prefer that default repo-local runtime entry; use `scripts/go_plan_runtime.py` only when you explicitly want the plan-only path.
+Note: when the current repository provides `scripts/sopify_runtime.py`, raw input should prefer that default repo-local runtime entry; when the runtime is vendored into another repository, prefer `.sopify-runtime/scripts/sopify_runtime.py`; use the matching `go_plan_runtime.py` helper only when you explicitly want the plan-only path.
 
 **workflow-learning proactive capture policy:**
 ```yaml
@@ -258,7 +258,7 @@ User Input
 Check command prefix (~go, ~go plan, ~go exec, ~compare)
     ↓
 ├─ ~go exec → Execute existing plan
-├─ ~go plan → Plan mode (Analysis → Design; prefer scripts/sopify_runtime.py for raw input, and use scripts/go_plan_runtime.py only for the plan-only slice)
+├─ ~go plan → Plan mode (Analysis → Design; prefer scripts/sopify_runtime.py or .sopify-runtime/scripts/sopify_runtime.py for raw input, and use the matching go_plan_runtime.py only for the plan-only slice)
 ├─ ~go → Full workflow mode
 ├─ ~compare → Model compare (wired to scripts/model_compare_runtime.py runtime)
 └─ No prefix → Semantic analysis
@@ -404,14 +404,16 @@ Next: Please verify the functionality
 ~compare         # Compare one prompt across models (fallbacks below 2 usable models with explicit reasons)
 ```
 
-**Repo-local runtime helpers:**
+**Runtime helpers:**
 ```
-scripts/sopify_runtime.py         # default repo-local raw-input entry, routed by the runtime router
-scripts/go_plan_runtime.py        # helper for the plan-only slice
-scripts/model_compare_runtime.py  # runtime implementation for ~compare, not the default generic entry
+scripts/sopify_runtime.py                    # default repo-local raw-input entry, routed by the runtime router
+.sopify-runtime/scripts/sopify_runtime.py    # default vendored raw-input entry after secondary integration
+scripts/go_plan_runtime.py                   # helper for the plan-only slice
+.sopify-runtime/scripts/go_plan_runtime.py   # vendored helper for the plan-only slice
+scripts/model_compare_runtime.py             # runtime implementation for ~compare, not the default generic entry
 ```
 
-Note: the default entry is `scripts/sopify_runtime.py`; `scripts/go_plan_runtime.py` is only for plan-only; `~compare` still depends on a host-side dedicated bridge.
+Note: the default entry is `scripts/sopify_runtime.py`; when vendored, the entry becomes `.sopify-runtime/scripts/sopify_runtime.py`; `go_plan_runtime.py` is only for plan-only; `~compare` still depends on a host-side dedicated bridge.
 
 **Configuration File:** `sopify.config.yaml` (project root)
 

Codex/Skills/CN/AGENTS.md

@@ -133,7 +133,7 @@ Next: {下一步提示}
  | `~go exec` | 执行已有方案 |
  | `~compare` | 多模型并发对比（默认含当前会话模型；可用模型数不足 2 时降级并给出原因） |
 
-说明：当前仓库若存在 `scripts/sopify_runtime.py`，原始输入应优先走该默认 repo-local runtime 入口；仅在明确只走 `~go plan` 时使用 `scripts/go_plan_runtime.py` 这个 plan-only helper。
+说明：当前仓库若存在 `scripts/sopify_runtime.py`，原始输入应优先走该默认 repo-local runtime 入口；若 runtime 以 bundle 方式接入到其他仓库，则优先走 `.sopify-runtime/scripts/sopify_runtime.py`；仅在明确只走 `~go plan` 时使用对应的 `go_plan_runtime.py` helper。
 
 **workflow-learning 主动记录策略：**
 ```yaml
@@ -258,7 +258,7 @@ progressive: 按需创建文件 (默认)
 检查命令前缀 (~go, ~go plan, ~go exec, ~compare)
     ↓
 ├─ ~go exec → 执行已有方案
-├─ ~go plan → 规划模式 (需求分析 → 方案设计；若存在 scripts/sopify_runtime.py 则原始输入优先走该默认入口，plan-only 场景再使用 scripts/go_plan_runtime.py)
+├─ ~go plan → 规划模式 (需求分析 → 方案设计；若存在 scripts/sopify_runtime.py 或 .sopify-runtime/scripts/sopify_runtime.py，则原始输入优先走默认入口，plan-only 场景再使用对应的 go_plan_runtime.py)
 ├─ ~go → 全流程模式
 ├─ ~compare → 模型对比（调用 scripts/model_compare_runtime.py 运行时）
 └─ 无前缀 → 语义分析
@@ -404,14 +404,16 @@ Next: 请验证功能
 ~compare         # 对同一问题做多模型并发对比（可用模型不足 2 时自动单模型并解释原因）
 ```
 
-**repo-local runtime helper：**
+**runtime helper：**
 ```
-scripts/sopify_runtime.py         # 当前仓库默认原始输入入口，直接交给 router 分流
-scripts/go_plan_runtime.py        # 当前仓库用于 plan-only slice 的 helper
-scripts/model_compare_runtime.py  # ~compare 的运行时实现，不是默认通用入口
+scripts/sopify_runtime.py                    # 当前仓库默认原始输入入口，直接交给 router 分流
+.sopify-runtime/scripts/sopify_runtime.py    # 二次接入后 vendored 默认入口
+scripts/go_plan_runtime.py                   # 当前仓库用于 plan-only slice 的 helper
+.sopify-runtime/scripts/go_plan_runtime.py   # vendored plan-only helper
+scripts/model_compare_runtime.py             # ~compare 的运行时实现，不是默认通用入口
 ```
 
-说明：当前默认入口是 `scripts/sopify_runtime.py`；`scripts/go_plan_runtime.py` 只负责 plan-only；`~compare` 仍依赖宿主侧专用桥接。
+说明：当前默认入口是 `scripts/sopify_runtime.py`；若以 bundle 方式接入则入口对应 `.sopify-runtime/scripts/sopify_runtime.py`；`go_plan_runtime.py` 只负责 plan-only；`~compare` 仍依赖宿主侧专用桥接。
 
 **配置文件：** `sopify.config.yaml` (项目根目录)
 

Codex/Skills/EN/AGENTS.md

@@ -133,7 +133,7 @@ Complex Task (full 3 phases):
 | `~go exec` | Execute existing plan |
 | `~compare` | Multi-model parallel comparison (includes session default model by default; falls back with reasons when usable model count is below 2) |
 
-Note: when the current repository provides `scripts/sopify_runtime.py`, raw input should prefer that default repo-local runtime entry; use `scripts/go_plan_runtime.py` only when you explicitly want the plan-only path.
+Note: when the current repository provides `scripts/sopify_runtime.py`, raw input should prefer that default repo-local runtime entry; when the runtime is vendored into another repository, prefer `.sopify-runtime/scripts/sopify_runtime.py`; use the matching `go_plan_runtime.py` helper only when you explicitly want the plan-only path.
 
 **workflow-learning proactive capture policy:**
 ```yaml
@@ -258,7 +258,7 @@ User Input
 Check command prefix (~go, ~go plan, ~go exec, ~compare)
     ↓
 ├─ ~go exec → Execute existing plan
-├─ ~go plan → Plan mode (Analysis → Design; prefer scripts/sopify_runtime.py for raw input, and use scripts/go_plan_runtime.py only for the plan-only slice)
+├─ ~go plan → Plan mode (Analysis → Design; prefer scripts/sopify_runtime.py or .sopify-runtime/scripts/sopify_runtime.py for raw input, and use the matching go_plan_runtime.py only for the plan-only slice)
 ├─ ~go → Full workflow mode
 ├─ ~compare → Model compare (wired to scripts/model_compare_runtime.py runtime)
 └─ No prefix → Semantic analysis
@@ -404,14 +404,16 @@ Next: Please verify the functionality
 ~compare         # Compare one prompt across models (fallbacks below 2 usable models with explicit reasons)
 ```
 
-**Repo-local runtime helpers:**
+**Runtime helpers:**
 ```
-scripts/sopify_runtime.py         # default repo-local raw-input entry, routed by the runtime router
-scripts/go_plan_runtime.py        # helper for the plan-only slice
-scripts/model_compare_runtime.py  # runtime implementation for ~compare, not the default generic entry
+scripts/sopify_runtime.py                    # default repo-local raw-input entry, routed by the runtime router
+.sopify-runtime/scripts/sopify_runtime.py    # default vendored raw-input entry after secondary integration
+scripts/go_plan_runtime.py                   # helper for the plan-only slice
+.sopify-runtime/scripts/go_plan_runtime.py   # vendored helper for the plan-only slice
+scripts/model_compare_runtime.py             # runtime implementation for ~compare, not the default generic entry
 ```
 
-Note: the default entry is `scripts/sopify_runtime.py`; `scripts/go_plan_runtime.py` is only for plan-only; `~compare` still depends on a host-side dedicated bridge.
+Note: the default entry is `scripts/sopify_runtime.py`; when vendored, the entry becomes `.sopify-runtime/scripts/sopify_runtime.py`; `go_plan_runtime.py` is only for plan-only; `~compare` still depends on a host-side dedicated bridge.
 
 **Configuration File:** `sopify.config.yaml` (project root)