refactor(runtime): consolidate ECC runtime and Studio integration

ecos/agent/PERMISSION_MODEL.md

@@ -155,45 +155,41 @@ Agent 的参数更新路径写完 `home/parameters.json` 后**直接上报成功
 | `project.json`、workspace 目录结构 | 不可改动既有结构 | 同上 |
 | 已完成阶段产物 | 永不可写 | 同上，保证可追溯性 |
 | 新建 workspace / project | 可创建 | 走既有合同确认链路 |
-| `home/parameters.json` 全局参数 | 可写 | typed patch + 值域校验 + 合同确认 |
-| step config 参数 | 可写 | 同上，经 ECC `sync_config` |
+| Workspace Parameter | 可写 | typed patch + 合同确认 + ECC `workspace.updateConfiguration` |
+| Step Option | 可写 | Step identity + 合同确认 + ECC `workspace.updateStepConfiguration` |
 | flow 起止阶段 | 可写 | 同上 |
 | 隔离 rerun workspace 内部 | 可写 | 目标为新建目录，不覆盖 source |
 
 关于「工程的建立」：**新建允许**（当前操作 1 与操作 5 的行为，保留），**改动既有结构不允许**——不重命名、不删除、不覆盖 `project.json`、不调整目录布局。
 
-## 5. 参数写入面统一设计
+## 5. 参数领域命令设计
 
-### 5.1 两个参数面
+### 5.1 单一写入所有者
 
-ECOS 存在两套参数存储：
+ECOS Workspace 中仍可观察到两类派生配置：
 
 - `home/parameters.json`：全局设计参数，ICS55 扁平模板。字段如 `Clock`、`Frequency max [MHz]`、`Max fanout`、`Core.Utilitization`、`Core.Margin`、`Die.Size`、`Target density`、`Target overflow`、`Cell padding x`、`Routability opt flag`、`Bottom layer`、`Top layer`。
 - `config/*.json`：每步工具配置，如 `dreamplace_ecc.json`、`cts_ecc.json`、`route_ecc.json`。
 
-ECC 提供双向同步：
-
-- `refresh_config`：parameters → step config（`data_api.refresh_workspace_config`）
-- `sync_config`：step config → parameters，若 parameters 发生变化则再执行一次 refresh（`data_api.sync_workspace_config_to_parameters`）
-
-部分字段在两个面同时存在（`Target density`、`Target overflow`、`Cell padding x`、`Routability opt flag`）。
+这些路径只用于 Agent 读取当前值，不出现在跨进程合同中。Workspace Descriptor 是唯一权威配置；ECC 负责更新 Descriptor、生成派生配置、提升 Revision 并失效旧结果。Studio 和 Agent 不直接写这些文件。
 
 ### 5.2 写入规则
 
-1. 补丁只描述逻辑 knob，不描述文件路径。
-2. 由**单一映射表**决定每个 knob 落在哪个面、哪个 key。该映射表必须是唯一事实来源，Python 与 TypeScript 侧共用同一份定义，不允许两侧各自硬编码。
-3. 落在 `home/parameters.json` 的改动，写入后**必须调用 `refreshConfig`**。
-4. 落在 `config/*.json` 的改动，写入后**必须调用 `syncConfig`**。
-5. 未知 knob 必须**报错**，不得静默跳过。
-6. 写入格式与 GUI 保持一致（4 空格缩进），避免无意义 diff。
-7. 合同展示的「旧值」必须从该 knob 的**实际写入面**读取。
+1. 提案只描述逻辑 knob，不描述文件路径。
+2. Agent 将提案解析为 canonical Workspace Parameters 和带 Step identity 的 Step Options。
+3. Studio 在用户确认后只调用对应 Product Command，不解释 JSON path。
+4. ECC 校验参数/选项、原子提交、生成派生配置、提升 Revision 并计算 stale 范围。
+5. 未知 knob、Workspace Parameter、Step identity 或 Step Option 必须报错，不得静默跳过。
+6. 合同展示的「旧值」来自只读采集面；执行载荷必须展示逻辑参数身份。
 
 ### 5.3 knob 命名空间扩展
 
 现有前缀 `place.` / `cts.` / `legalization.` / `route.` 保留。新增用于全局参数的前缀：
 
-- `design.clock`、`design.frequency_max`、`design.max_fanout`、`design.top_module`
-- `floorplan.utilitization`、`floorplan.margin`、`floorplan.die_width`、`floorplan.die_height`、`floorplan.aspect_ratio`、`floorplan.die_area_mode`
+- `design.frequency_max`
+- `floorplan.utilitization`、`floorplan.die_width`、`floorplan.die_height`、`floorplan.aspect_ratio`
+
+`design.clock`、`design.top_module` 和 Flow/PDK 变化属于结构性 Workspace Update，不作为普通参数建议。
 
 命名需满足 `knob_id` 正则（至少一个点分隔）。
 
@@ -294,9 +290,7 @@ codex app-server -c mcp_servers={} -c tools.web_search=<true|false>
 
 `codex_rpc.py` 的 `_readonly_activity` 仅匹配 `commandexecution` 类型的 item，web search 相关事件将完全静默，用户会看到 Agent 无响应而不知其在执行什么。
 
-需增加 `webSearch` 分支，在 Tool 卡中展示查询内容与访问域名。
-
-依据：`PRODUCT.md` —— Make the current state and next valid action immediately visible。
+需增加 `webSearch` 分支，在 Tool 卡中展示查询内容与访问域名，让当前状态和下一步有效操作立刻可见。
 
 ### 8.2 审计
 
@@ -351,10 +345,8 @@ codex app-server -c mcp_servers={} -c tools.web_search=<true|false>
 已解决：
 
 - ✅ 未知协议字段在 0.146.0 下被静默接受（实测 `__bogus_probe_field` 返回成功）
-- ✅ 新增 `design.` / `floorplan.` knob 的写入面为 `home/parameters.json`，路径已在
-  `knob_registry.py` 中登记
-- ✅ `refresh_config` 从 `parameters.json` 重新展开 step config，因此 step-config 类
-  knob 必须先 `sync_config` 再 `refresh_config`——实现已按此顺序，并有测试锁定
+- ✅ `design.` / `floorplan.` knob 解析为 canonical Workspace Parameter，文件路径不进入合同
+- ✅ Step Option 解析为 Step identity + option object，并由 ECC 统一提交和刷新派生配置
 
 仍待验证（需要真实 workspace 与真实 Codex 会话）：
 

ecos/agent/knowledge/cts/manifest.json

@@ -1 +1 @@
-{"entity_count": 47, "files": {"catalog.json": "5339ada465d1966d4e0ff2e4d1ddb3ff4819da66f34ac61ce1cf9db92ed1f83e", "knowledge/algorithms.md": "a5af2adf9a4a1fe27232f320cb43034cb5db5af244be4c2b7c5f0ea62e0ef83a", "knowledge/artifacts.md": "fd4c3af58185fb0ad112f5492c3aff0de996bb35fe1c28f3893a37eaae79cab8", "knowledge/failures.md": "f7fd18e1ec479fe971e7d56204a3a3bc3409c208259ea0dc3a52acda94399de0", "knowledge/metrics.md": "8cf1a8070a0eb09f5f18fce7bec1e5bbbb306ec6eb2a4db624a740db24a985d0", "knowledge/parameters.md": "e860c02239e8f0adf76ff7f13d3947bb93bbe86e76ffb9020db6ed2bd625142f", "regression/cts_questions.jsonl": "13b1655b4c30e5b1e8ce95a90f68006f98bf51fb9fbb07d5aebae73a356c39c6", "sources.json": "dd8b2bd1e9cefdf2300dc47d9ad41f60084a56e1b55accc1be1bf0620886e55a"}, "schema_version": "ecos-step-manifest.v1"}
+{"entity_count": 47, "files": {"catalog.json": "5339ada465d1966d4e0ff2e4d1ddb3ff4819da66f34ac61ce1cf9db92ed1f83e", "knowledge/algorithms.md": "a5af2adf9a4a1fe27232f320cb43034cb5db5af244be4c2b7c5f0ea62e0ef83a", "knowledge/artifacts.md": "fd4c3af58185fb0ad112f5492c3aff0de996bb35fe1c28f3893a37eaae79cab8", "knowledge/failures.md": "f7fd18e1ec479fe971e7d56204a3a3bc3409c208259ea0dc3a52acda94399de0", "knowledge/metrics.md": "8cf1a8070a0eb09f5f18fce7bec1e5bbbb306ec6eb2a4db624a740db24a985d0", "knowledge/parameters.md": "e860c02239e8f0adf76ff7f13d3947bb93bbe86e76ffb9020db6ed2bd625142f", "regression/cts_questions.jsonl": "13b1655b4c30e5b1e8ce95a90f68006f98bf51fb9fbb07d5aebae73a356c39c6", "sources.json": "61e9e8427ba3831c7b09eb69e25fc4353ba74b001439454a839b73ec7c82a4b8"}, "schema_version": "ecos-step-manifest.v1"}