@stalfh233/omc-cli 0.4.15 → 0.4.16

package/skills/omc-write-hazards.md

@@ -1,87 +1,88 @@
----
-name: omc-write-hazards
-description: 分发版 CLI 的底层写面安全形状。配置表单、视图、按钮、子表、关联、规则或在线 JS 时使用；CLI dry-lint 是主防线，浏览器不是常规验收步骤。
----
-
-# CLI 写面安全形状
-
-本技能随 `omc-cli` 包分发，可用：
-
-```bash
-omc help omc-write-hazards
-```
-
-优先依赖 CLI 的 schema、contract、dry-lint、writable/生产确认和权威读回。浏览器只在用户报告明确的 UI 回归时使用。
-
-## 表单与 Sheet201
-
-- 控件 `options` 必须是 **object**，不能是 JSON 字符串。8.6.34 渲染器会写 `options.name_i18n`；字符串会抛 `Cannot create property 'name_i18n' on string` 并白屏。
-- 子表父控件是 `type: 201`，业务子列放 `columns`；子列 key 不得进入 `viewJson`。
-- 调用方显式传 `draftAttributesJson`/`draftViewJson` 时，CLI 会在写前拒绝字符串 options、非字符串 viewJson 单元、子列混入 viewJson。
-- `form.draft rebuild:true` 会重建布局，但会保留已存在的非结构性控件 options；Sheet201 columns 以最新 subSchema 为准。
-- 空布局 `[]`/`{}` 默认拒绝；只有显式 `allowEmptyLayout:true` 才能清空。
-
-## 模型字段与关联
-
-- **code 定位写前先核在册**：`field.update` / `rule.node.update` 等按 code 定位的精确写，先 `model.inspect` / `field.list` 确认 code 在册；缺码即停并报"目标不存在 + 当前字段清单"——**别凭用户措辞假定 code 正确**（用户可能记错字段名），**也别擅自替换成语义相近的字段**（改错对象比不改更糟）。缺码 `field.update` 本就拒 301001，但写前先核能省一轮失败往返，并在草稿阶段就把"字段不存在"与"需求理解偏差"分清。
-- **改名核对以字段读为准**：`field.update` 改名后，`model.inspect` 聚合面的 `fields[].name` 可能仍是旧值（发布态快照/聚合缓存）；核对显示名、options 一律用 `field.list` / `field.get` 或 `form.publish` 回读——两处读数不一致时以字段读为准，别误判"写入没生效"而重复写。
-- `propertyEmpty` 默认 `false`。模型层保持可空；必填、只读、可见性在表单和流程节点配置。
-- 无映射关联单选 `WORK_SHEET` 使用 `mappings: ""`，不要用 `"[]"`。`"[]"` 是非空字符串，设计器会显示“已设置”，但弹窗没有映射行。
-- 有映射时传非空 JSON 数组字符串，并在 draft/published 两面读回。
-- **运行时写关联值是另一种形状**（`data.save`/`data.update` 的 formData）：单选关联（`propertyType 9`）传 **id 字符串或 `{ id }`**，传**数组会稳定 50000**；多选关联（11）才用数组；**人员/组织（50/51/60/61）传 `[{"id","type","name"}]`，`type` 必填**（缺它稳定 50000）——`type` 是 UnitType 索引：**用户=3、部门=1**。用错形状只会拿到一个不透明的 50000。
-- **`mappings` 由表单运行时在用户选择时套用**，服务端 `data.save` **不会**自动回填映射目标字段。API 侧要自己写被映射字段，否则读回为空——别把它误判成“映射配置失败”。
-- **运行时写值的最小形状**（组合出错只会得到一个不透明的 `50000`/NPE，逐一最小化再合）：单选关联(9) → id 字符串 `"<id>"`；**人员/组织(50/51/60/61) → `[{"id":"<id>","type":3,"name":"<名>"}]`，`type` 必填且为整数**（缺/非整数 → `BizField.parseFromClient` 拆箱 NPE→50000；用户=3、部门=1）；日期(3) → 字符串 `"2026-09-30 10:00:00"`；子表(8) → 行对象数组 `[{"<子列code>":<值>, ...}]`。先各写一条最小行通过，再组合。
-- **DATE(3) 字段的 `options.format` 必须是平台大写枚举**（`YYYY-MM-DD`、`YYYY-MM-DD HH:mm:ss`、`YYYY年MM月DD日`…），**不是 Java 的 `yyyy-MM-dd`**：平台 `DateBizField` 按字面比较，Java 写法能创建字段但**首次运行时 save 稳定 `50000`（`不支持的format`）**（2026-09-30 R5 实测）。`field.create`/`intent` 会就地拒绝非枚举值。
-
-## 视图
-
-- `conditions[].visible` 未传时 CLI 默认 `true`；只有需求明确隐藏时传 `false`。
-- `fieldCodes` 不要加入系统字段。平台可能在最终查询面保留默认系统列，那不是 agent 配置的业务列。
-- 新模型先配列表视图再依赖 `data.list`。部分 8.6.26 读面在没有 query/view 配置时会把业务列投影为 null；单行核对可用 `data.load`。
-- **默认列表视图不能单独 `listview.delete`**（平台回 `303025 列表是默认列表`）；要清掉它就删模型（`model.delete` 级联）。清理时别把它当失败。
-
-## 按钮
-
-- 列表按钮用 `listview.configure` 的 `buttons`（传 `code`/`name`/`useLocation`/`bindAction`/`targetModel`/`targetForm`…）；**不要因为没找到就叫「CLI 无列表按钮能力」**（dogfood 实测该误判会假阻塞整条需求）。配完 `listview.get --full` 回读 `customButtons`。
-- `BUSINESS_RULE` 按钮需要 target rule 和 actionConfig 对象。
-- `FLOW`/`FORM`/`ADD_DATA` 的 actionConfig 必须有 `configureList: []`；FLOW 还需要 `WorkflowListData[0].workflowCode` 与 `schemaCodeVal`。CLI 只给 FLOW 的 targetCode 时会自动展开。
-- `WITH_VIEW` 是打开表单；`WITH_OUT_VIEW` 才是直接执行。行级按钮要用 `useLocation: ROW` 才能拿到当前行上下文。
-
-## 子表
-
-- 一个主表可以有多个 `CHILD_TABLE`，子表不能嵌套 `CHILD_TABLE`。
-- 子列是子表字段 code 对应 schema 上的普通字段：
-
-```bash
-omc call field.create --env local --args '{"schemaCode":"expense_items","code":"item_note","name":"明细备注","propertyType":"LONG_TEXT"}'
-omc call field.update --env local --args '{"schemaCode":"expense_items","code":"item_note","name":"备注"}'
-omc call field.delete --env local --args '{"schemaCode":"expense_items","code":"item_note"}'
-omc call field.publish --env local --args '{"schemaCode":"expense"}'
-```
-
-父 `CHILD_TABLE` 行不接受 `options/choices/subFields` 更新；子列直接走上面的 CRUD 面。
-
-## 规则与业务集成
-
-- 规则节点缺 `nodeName` 时 CLI 按平台 `RuleNodeType` 补默认名并给 warning；业务节点优先显式命名。
-- BIZ_ACTION 先 `service.get` 读取现存方法参数面，再写 methodMapping。PROPERTY 输入使用 `codeType: 1`、`bizCode` 为业务字段 code、`propertyName` 为显示名、`serviceMethodParameterCode` 命中方法参数。
-- **`codeType:1` 映射的 `bizCode` 必须是该模型上**已创建且已发布**的字段 code**：指向不存在/未发布的字段时，平台 publish 只回一个**无明细的 `550018 保存规则失败，规则存在异常`**（真因只经设计器「检测」/`POST /api/app/businessrule/node_run_map → notExistPropertyObjectList` 可见）。`rule.save` 现已本地前置校验并拒绝（`rule-graph-bizaction-mapping-field-missing`）；改字段族类型也要同步映射。
-- **把 BIZ_ACTION 挂到预置数据事件规则（`Create`/`Update`）上时**：映射的 `bizCode` 数据项必须真实存在于该模型，否则发布被拒 `550010 业务规则使用的数据项不存在`（典型：REST 短文本入参要映射一个关联字段——先在模型加一个短文本「快照」字段承接，再映射它）。若预置规则仍不接受，改挂**自定义按钮触发规则**（`customTrigger:true`）或 `Update` 规则，更稳；不要因此判定“平台不支持 BIZ_ACTION”。
-- **BIZ_ACTION 的 `outputMappings` 按“响应 JSON 根级路径”取值**（源码 `MapOps.toMapByBizServiceJson`/`convertJsonObject`：keyMap 以 `serviceMethodParameterCode` 为键，与响应体**根级**各键匹配）。所以 `serviceMethodParameterCode` 必须等于 REST 响应**根级**的键名：
-  - **扩展接口若返回信封 `ResponseResult{errcode,data:{x}}`，平铺出参 `x` 在根级找不到 → 静默空回写**（真机 2026-10-01 实证：`h_log_biz_service` 显示 invoke SUCCESS、`data.amount:300`，目标字段仍空）。**正解：扩展接口在根级返回业务负载**（`GET` handler 直接 `return Map.of("amount", n)`，不分信封），出参 code=根键 `amount`。
-  - 也**不要**试图用输出参数的 `subParameters` 下沉取值：实测把出参声明为父 `data`+`subParameters[value]` 会把整个 `{value:99}` 子对象赋给标量字段，触发 `数据项【x】的值是未知的类型:com.alibaba.JSONObject`（50000）。嵌套出参结构只用于 OBJECT/子表类的整体赋值，不能用来“取 `data.x` 这个标量”。
-  - 对照：平台自带 `skb_risk_service` 出参平铺 `riskLevel` ↔ 响应根级键；真机三态验证：平铺根级→回写 42 ✓；信封+平铺出参→不回写 ✗；信封+嵌套出参→50000 ✗。
-  - `method.test` 的 `externalSuccess:true` **不代表**回写成功——回写要另看目标字段实际值（`data.submit` 读回）。
-- 流程结束新增目标表单必须运行验证；配置发布不等于映射成功。检查目标记录的每个字段。
-- **`model.delete` 不物理清理 `h_business_rule`**：预置规则（Create/Update/GetList/Load/Delete/Available/Cancel）与历史版本行会残留在规则表（`rule.list` 对已删 schema 也读不到，属物理孤儿）。平台写面没有“按 schema 物理清规则”的手段；验收“零残留”以**可见面**为准（`model.list`/`rule.list`/`service.get`/列表/按钮），物理行需 DB 侧清理。清理顺序让规则先于模型删能减少、但不消除预置规则行。
-
-## 在线 JS
-
-- **本 CLI 只负责发布，不负责写 JS**。脚本内容的创作与增量合并不在本 CLI：若当前项目自带在线 JS 编写规范（例如其 `.cpdocs`/技能或项目文档），遵循它；否则向用户/设计者索取已定稿 `source`。不要在 omc 技能里手写/臆造 JS 逻辑。
-- 经 omc 发布时用 `onlinejs.compose`：把已定稿的 `source` 组合进平台 skeleton 的 `customScript`，再 `publish`，并回读 `publishedHtmlJson` + SHA-256。不要用裸脚本覆盖平台 skeleton。
-- **`replace:true` 对裸代码被拒是设计**：`replace` 必须传完整的 `(function(form){…})`，否则会写坏脚本槽让表单空白；同样，`merge` 传完整带外层的脚本也会被拒（避免嵌套丢内容）。远端 `customScript` 为空时，定稿脚本带外层 + `replace:true` 即可，不要把它当成缺陷。
-- 源码不能有 import/export，事件名必须在支持集合内；compose 后读回 draft/published HTML，浏览器不是默认步骤。
-
-## 固定验收顺序
-
-执行阶段以 `omc-five-piece-flow` 为准；写面安全只额外强调两点：写前先 `commands/describe/contract` + dry-run 静态校验，写后权威 readback，必要时再用 CLI 触发运行验证。
+---
+name: omc-write-hazards
+description: 分发版 CLI 的底层写面安全形状。配置表单、视图、按钮、子表、关联、规则或在线 JS 时使用；CLI dry-lint 是主防线，浏览器不是常规验收步骤。
+---
+
+# CLI 写面安全形状
+
+本技能随 `omc-cli` 包分发，可用：
+
+```bash
+omc help omc-write-hazards
+```
+
+优先依赖 CLI 的 schema、contract、dry-lint、writable/生产确认和权威读回。浏览器只在用户报告明确的 UI 回归时使用。
+
+## 表单与 Sheet201
+
+- 控件 `options` 必须是 **object**，不能是 JSON 字符串。8.6.34 渲染器会写 `options.name_i18n`；字符串会抛 `Cannot create property 'name_i18n' on string` 并白屏。
+- 子表父控件是 `type: 201`，业务子列放 `columns`；子列 key 不得进入 `viewJson`。
+- 调用方显式传 `draftAttributesJson`/`draftViewJson` 时，CLI 会在写前拒绝字符串 options、非字符串 viewJson 单元、子列混入 viewJson。
+- `form.draft rebuild:true` 会重建布局，但会保留已存在的非结构性控件 options；Sheet201 columns 以最新 subSchema 为准。
+- 空布局 `[]`/`{}` 默认拒绝；只有显式 `allowEmptyLayout:true` 才能清空。
+
+## 模型字段与关联
+
+- **code 定位写前先核在册**：`field.update` / `rule.node.update` 等按 code 定位的精确写，先 `model.inspect` / `field.list` 确认 code 在册；缺码即停并报"目标不存在 + 当前字段清单"——**别凭用户措辞假定 code 正确**（用户可能记错字段名），**也别擅自替换成语义相近的字段**（改错对象比不改更糟）。缺码 `field.update` 本就拒 301001，但写前先核能省一轮失败往返，并在草稿阶段就把"字段不存在"与"需求理解偏差"分清。
+- **改名核对以字段读为准**：`field.update` 改名后，`model.inspect` 聚合面的 `fields[].name` 可能仍是旧值（发布态快照/聚合缓存）；核对显示名、options 一律用 `field.list` / `field.get` 或 `form.publish` 回读——两处读数不一致时以字段读为准，别误判"写入没生效"而重复写。
+- `propertyEmpty` 默认 `false`。模型层保持可空；必填、只读、可见性在表单和流程节点配置。
+- 无映射关联单选 `WORK_SHEET` 使用 `mappings: ""`，不要用 `"[]"`。`"[]"` 是非空字符串，设计器会显示“已设置”，但弹窗没有映射行。
+- 有映射时传非空 JSON 数组字符串，并在 draft/published 两面读回。
+- **运行时写关联值是另一种形状**（`data.save`/`data.update` 的 formData）：单选关联（`propertyType 9`）传 **id 字符串或 `{ id }`**，传**数组会稳定 50000**；多选关联（11）才用数组；**人员/组织（50/51/60/61）传 `[{"id","type","name"}]`，`type` 必填**（缺它稳定 50000）——`type` 是 UnitType 索引：**用户=3、部门=1**。用错形状只会拿到一个不透明的 50000。
+- **`mappings` 由表单运行时在用户选择时套用**，服务端 `data.save` **不会**自动回填映射目标字段。API 侧要自己写被映射字段，否则读回为空——别把它误判成“映射配置失败”。
+- **运行时写值的最小形状**（组合出错只会得到一个不透明的 `50000`/NPE，逐一最小化再合）：单选关联(9) → id 字符串 `"<id>"`；**人员/组织(50/51/60/61) → `[{"id":"<id>","type":3,"name":"<名>"}]`，`type` 必填且为整数**（缺/非整数 → `BizField.parseFromClient` 拆箱 NPE→50000；用户=3、部门=1）；日期(3) → 字符串 `"2026-09-30 10:00:00"`；子表(8) → 行对象数组 `[{"<子列code>":<值>, ...}]`。先各写一条最小行通过，再组合。
+- **DATE(3) 字段的 `options.format` 必须是平台大写枚举**（`YYYY-MM-DD`、`YYYY-MM-DD HH:mm:ss`、`YYYY年MM月DD日`…），**不是 Java 的 `yyyy-MM-dd`**：平台 `DateBizField` 按字面比较，Java 写法能创建字段但**首次运行时 save 稳定 `50000`（`不支持的format`）**（2026-09-30 R5 实测）。`field.create`/`intent` 会就地拒绝非枚举值。
+
+## 视图
+
+- `conditions[].visible` 未传时 CLI 默认 `true`；只有需求明确隐藏时传 `false`。
+- `fieldCodes` 不要加入系统字段。平台可能在最终查询面保留默认系统列，那不是 agent 配置的业务列。
+- 新模型先配列表视图再依赖 `data.list`。部分 8.6.26 读面在没有 query/view 配置时会把业务列投影为 null；单行核对可用 `data.load`。
+- **默认列表视图不能单独 `listview.delete`**（平台回 `303025 列表是默认列表`）；要清掉它就删模型（`model.delete` 级联）。清理时别把它当失败。
+
+## 按钮
+
+- 列表按钮用 `listview.configure` 的 `buttons`（传 `code`/`name`/`useLocation`/`bindAction`/`targetModel`/`targetForm`…）；**不要因为没找到就叫「CLI 无列表按钮能力」**（dogfood 实测该误判会假阻塞整条需求）。配完 `listview.get --full` 回读 `customButtons`。
+- `BUSINESS_RULE` 按钮需要 target rule 和 actionConfig 对象。
+- `FLOW`/`FORM`/`ADD_DATA` 的 actionConfig 必须有 `configureList: []`；FLOW 还需要 `WorkflowListData[0].workflowCode` 与 `schemaCodeVal`。CLI 只给 FLOW 的 targetCode 时会自动展开。
+- `WITH_VIEW` 是打开表单；`WITH_OUT_VIEW` 才是直接执行。行级按钮要用 `useLocation: ROW` 才能拿到当前行上下文。
+
+## 子表
+
+- 一个主表可以有多个 `CHILD_TABLE`，子表不能嵌套 `CHILD_TABLE`。
+- 子列是子表字段 code 对应 schema 上的普通字段：
+
+```bash
+# --env 在单环境项目（.omc-env 在位）可省；下例显式写出仅为多环境演示
+omc call field.create --env local --args '{"schemaCode":"expense_items","code":"item_note","name":"明细备注","propertyType":"LONG_TEXT"}'
+omc call field.update --env local --args '{"schemaCode":"expense_items","code":"item_note","name":"备注"}'
+omc call field.delete --env local --args '{"schemaCode":"expense_items","code":"item_note"}'
+omc call field.publish --env local --args '{"schemaCode":"expense"}'
+```
+
+父 `CHILD_TABLE` 行不接受 `options/choices/subFields` 更新；子列直接走上面的 CRUD 面。
+
+## 规则与业务集成
+
+- 规则节点缺 `nodeName` 时 CLI 按平台 `RuleNodeType` 补默认名并给 warning；业务节点优先显式命名。
+- BIZ_ACTION 先 `service.get` 读取现存方法参数面，再写 methodMapping。PROPERTY 输入使用 `codeType: 1`、`bizCode` 为业务字段 code、`propertyName` 为显示名、`serviceMethodParameterCode` 命中方法参数。
+- **`codeType:1` 映射的 `bizCode` 必须是该模型上**已创建且已发布**的字段 code**：指向不存在/未发布的字段时，平台 publish 只回一个**无明细的 `550018 保存规则失败，规则存在异常`**（真因只经设计器「检测」/`POST /api/app/businessrule/node_run_map → notExistPropertyObjectList` 可见）。`rule.save` 现已本地前置校验并拒绝（`rule-graph-bizaction-mapping-field-missing`）；改字段族类型也要同步映射。
+- **把 BIZ_ACTION 挂到预置数据事件规则（`Create`/`Update`）上时**：映射的 `bizCode` 数据项必须真实存在于该模型，否则发布被拒 `550010 业务规则使用的数据项不存在`（典型：REST 短文本入参要映射一个关联字段——先在模型加一个短文本「快照」字段承接，再映射它）。若预置规则仍不接受，改挂**自定义按钮触发规则**（`customTrigger:true`）或 `Update` 规则，更稳；不要因此判定“平台不支持 BIZ_ACTION”。
+- **BIZ_ACTION 的 `outputMappings` 按“响应 JSON 根级路径”取值**（源码 `MapOps.toMapByBizServiceJson`/`convertJsonObject`：keyMap 以 `serviceMethodParameterCode` 为键，与响应体**根级**各键匹配）。所以 `serviceMethodParameterCode` 必须等于 REST 响应**根级**的键名：
+  - **扩展接口若返回信封 `ResponseResult{errcode,data:{x}}`，平铺出参 `x` 在根级找不到 → 静默空回写**（真机 2026-10-01 实证：`h_log_biz_service` 显示 invoke SUCCESS、`data.amount:300`，目标字段仍空）。**正解：扩展接口在根级返回业务负载**（`GET` handler 直接 `return Map.of("amount", n)`，不分信封），出参 code=根键 `amount`。
+  - 也**不要**试图用输出参数的 `subParameters` 下沉取值：实测把出参声明为父 `data`+`subParameters[value]` 会把整个 `{value:99}` 子对象赋给标量字段，触发 `数据项【x】的值是未知的类型:com.alibaba.JSONObject`（50000）。嵌套出参结构只用于 OBJECT/子表类的整体赋值，不能用来“取 `data.x` 这个标量”。
+  - 对照：平台自带 `skb_risk_service` 出参平铺 `riskLevel` ↔ 响应根级键；真机三态验证：平铺根级→回写 42 ✓；信封+平铺出参→不回写 ✗；信封+嵌套出参→50000 ✗。
+  - `method.test` 的 `externalSuccess:true` **不代表**回写成功——回写要另看目标字段实际值（`data.submit` 读回）。
+- 流程结束新增目标表单必须运行验证；配置发布不等于映射成功。检查目标记录的每个字段。
+- **`model.delete` 不物理清理 `h_business_rule`**：预置规则（Create/Update/GetList/Load/Delete/Available/Cancel）与历史版本行会残留在规则表（`rule.list` 对已删 schema 也读不到，属物理孤儿）。平台写面没有“按 schema 物理清规则”的手段；验收“零残留”以**可见面**为准（`model.list`/`rule.list`/`service.get`/列表/按钮），物理行需 DB 侧清理。清理顺序让规则先于模型删能减少、但不消除预置规则行。
+
+## 在线 JS
+
+- **本 CLI 只负责发布，不负责写 JS**。脚本内容的创作与增量合并不在本 CLI：若当前项目自带在线 JS 编写规范（例如其 `.cpdocs`/技能或项目文档），遵循它；否则向用户/设计者索取已定稿 `source`。不要在 omc 技能里手写/臆造 JS 逻辑。
+- 经 omc 发布时用 `onlinejs.compose`：把已定稿的 `source` 组合进平台 skeleton 的 `customScript`，再 `publish`，并回读 `publishedHtmlJson` + SHA-256。不要用裸脚本覆盖平台 skeleton。
+- **`replace:true` 对裸代码被拒是设计**：`replace` 必须传完整的 `(function(form){…})`，否则会写坏脚本槽让表单空白；同样，`merge` 传完整带外层的脚本也会被拒（避免嵌套丢内容）。远端 `customScript` 为空时，定稿脚本带外层 + `replace:true` 即可，不要把它当成缺陷。
+- 源码不能有 import/export，事件名必须在支持集合内；compose 后读回 draft/published HTML，浏览器不是默认步骤。
+
+## 固定验收顺序
+
+执行阶段以 `omc-five-piece-flow` 为准；写面安全只额外强调两点：写前先 `commands/describe/contract` + dry-run 静态校验，写后权威 readback，必要时再用 CLI 触发运行验证。

package/dist/approval-token.js

@@ -1,102 +0,0 @@
-import { createHash, createHmac, randomUUID, timingSafeEqual } from "node:crypto";
-export class ApprovalTokenRejectedError extends Error {
-    reason;
-    constructor(reason) {
-        super(`approval token rejected: ${reason}`);
-        this.reason = reason;
-    }
-}
-function canonical(value) {
-    return JSON.stringify(sort(value));
-}
-function sort(value) {
-    if (Array.isArray(value))
-        return value.map(sort);
-    if (value && typeof value === "object")
-        return Object.fromEntries(Object.entries(value)
-            .sort(([a], [b]) => a.localeCompare(b))
-            .map(([k, v]) => [k, sort(v)]));
-    return value;
-}
-export function packageFingerprint(plan) {
-    return createHash("sha256")
-        .update(canonical({
-        environment: plan.environment,
-        environmentFingerprint: plan.environmentFingerprint,
-        actions: plan.actions.map((a) => ({ tool: a.tool, args: sort(a.args) })),
-    }))
-        .digest("hex");
-}
-export class ApprovalTokenService {
-    key;
-    ttlMs;
-    now;
-    used = new Set();
-    constructor(options) {
-        const key = Buffer.from(options.key, "base64");
-        if (key.length !== 32)
-            throw new Error("approval token key must be exactly 32 bytes (base64).");
-        this.key = key;
-        this.ttlMs = options.ttlMs ?? 10 * 60 * 1000;
-        this.now = options.now ?? Date.now;
-    }
-    requestApproval(plan) {
-        const approvalId = randomUUID();
-        const fingerprint = packageFingerprint(plan);
-        const issuedAt = this.now();
-        const expiresAt = issuedAt + this.ttlMs;
-        const payload = canonical({
-            v: 1,
-            approvalId,
-            packageFingerprint: fingerprint,
-            issuedAt,
-            expiresAt,
-        });
-        const sig = createHmac("sha256", this.key).update(payload).digest("base64url");
-        const token = Buffer.from(payload, "utf8").toString("base64url") + "." + sig;
-        return {
-            token,
-            approvalId,
-            packageFingerprint: fingerprint,
-            expiresAt: new Date(expiresAt).toISOString(),
-            ttlSeconds: Math.round(this.ttlMs / 1000),
-            singleUse: true,
-        };
-    }
-    verify(plan, token) {
-        const parts = token.split(".");
-        if (parts.length !== 2 || !parts[0] || !parts[1])
-            throw new ApprovalTokenRejectedError("token-malformed");
-        let payload;
-        try {
-            payload = Buffer.from(parts[0], "base64url").toString("utf8");
-        }
-        catch {
-            throw new ApprovalTokenRejectedError("token-malformed");
-        }
-        let decoded;
-        try {
-            decoded = JSON.parse(payload);
-        }
-        catch {
-            throw new ApprovalTokenRejectedError("token-malformed");
-        }
-        const expectedSig = createHmac("sha256", this.key).update(payload).digest("base64url");
-        if (!timingSafeEqualB64(parts[1], expectedSig))
-            throw new ApprovalTokenRejectedError("token-signature-invalid");
-        if (this.used.has(String(decoded.approvalId)))
-            throw new ApprovalTokenRejectedError("token-already-used");
-        if (Number(decoded.expiresAt) <= this.now())
-            throw new ApprovalTokenRejectedError("token-expired");
-        if (decoded.packageFingerprint !== packageFingerprint(plan))
-            throw new ApprovalTokenRejectedError("package-fingerprint-mismatch");
-        this.used.add(String(decoded.approvalId));
-        return { approvalId: String(decoded.approvalId) };
-    }
-}
-function timingSafeEqualB64(a, b) {
-    const ba = Buffer.from(a);
-    const bb = Buffer.from(b);
-    return ba.length === bb.length && timingSafeEqual(ba, bb);
-}
-//# sourceMappingURL=approval-token.js.map

package/dist/server.js

@@ -1,92 +0,0 @@
-#!/usr/bin/env node
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { randomBytes } from "node:crypto";
-import { realpathSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { buildToolRegistry, makeToolContext } from "./tools.js";
-import { SessionManager } from "./session-manager.js";
-import { redact, redactError } from "./redact.js";
-import { ConfigStore } from "./config-store.js";
-import { contractMarkdown, contractResourceUri, LANE_CONTRACTS, shortToolDescription } from "./contract-resources.js";
-import { listSkills, readSkill } from "./skills.js";
-export function createMcpServer(options = {}) {
-    const context = makeToolContext({
-        sessions: options.sessions ?? new SessionManager(new ConfigStore()),
-        artifactsDir: options.artifactsDir,
-        tokenKey: options.tokenKey ?? randomBytes(32).toString("base64"),
-        tokenTtlMs: options.tokenTtlMs,
-    });
-    const secrets = options.secrets ?? (() => []);
-    const server = new McpServer({ name: "omc-cli", version: "0.1.0" }, {
-        capabilities: { tools: {}, resources: {} },
-        instructions: "Governed CloudPivot 8.6 configuration server. Tool schemas are self-describing (field families, relation options, rule nodeGraph, workflow template, formData, and the two-step approval flow). Methodology is served as MCP resources under omc://skills/ (five-piece flow, tool selection, acceptance criteria, requirement analysis, capability scouting, glossary, config draft review); read them with resources/list + resources/read rather than reading repository source. Before ANY write, read omc://skills/omc-config-draft-review: present the design (exact names/codes/types, layout, rule graph, view) as a plain-language draft and get explicit human approval first — the conversational human gate (approval granularity is the enumerated change package; an interrupted package loses its approval and resuming needs a fresh draft and go-ahead). Then: call without approvalToken to preview the plan, approval.request to get a token (the machine gate — it carries no human check), re-call with it. Production environments refuse writes by default (dual-key grant). Deliver ONE closing report per run — never interrupt per step.",
-    });
-    const register = server.tool.bind(server);
-    for (const definition of buildToolRegistry()) {
-        register(definition.name, shortToolDescription(definition.name, definition.kind, definition.lane) ?? definition.description, definition.inputSchema, async (args) => {
-            try {
-                const result = await definition.handler(context, args, definition);
-                return { content: [{ type: "text", text: redact(result, secrets()) }] };
-            }
-            catch (error) {
-                const refusal = error.payload;
-                if (refusal)
-                    return { content: [{ type: "text", text: redact(refusal, secrets()) }] };
-                const redacted = redactError(error, secrets());
-                return { content: [{ type: "text", text: redact({ status: "error", message: redacted.message }, secrets()) }], isError: true };
-            }
-        });
-    }
-    registerSkillResources(server);
-    registerContractResources(server);
-    return { server, context };
-}
-/**
- * Serve the package's methodology notes as MCP resources so any client can
- * read them on demand (host-agnostic) instead of the agent globbing the
- * filesystem for them. Each skill file's YAML frontmatter supplies its name
- * and description.
- */
-function registerSkillResources(server) {
-    for (const entry of listSkills()) {
-        const document = readSkill(entry.name);
-        if (document === undefined)
-            continue;
-        server.registerResource(entry.name, entry.uri, { title: entry.name, description: entry.description, mimeType: "text/markdown" }, async (uri) => ({ contents: [{ uri: uri.href, mimeType: "text/markdown", text: document.content }] }));
-    }
-}
-function registerContractResources(server) {
-    for (const contract of LANE_CONTRACTS) {
-        const text = contractMarkdown(contract);
-        server.registerResource(`contract-${contract.lane}`, contractResourceUri(contract), {
-            title: `${contract.lane} contract`,
-            description: `CloudPivot ${contract.family} contract for ${contract.lane}; reference ${contract.referenceVersion}`,
-            mimeType: "text/markdown",
-        }, async (uri) => ({ contents: [{ uri: uri.href, mimeType: "text/markdown", text }] }));
-    }
-}
-export async function runStdioServer(options = {}) {
-    const { server } = createMcpServer(options);
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-}
-function isProcessEntryPoint() {
-    const entry = process.argv[1];
-    if (!entry)
-        return false;
-    try {
-        return realpathSync(entry) === fileURLToPath(import.meta.url);
-    }
-    catch {
-        return false;
-    }
-}
-if (isProcessEntryPoint()) {
-    runStdioServer().catch((error) => {
-        console.error(error instanceof Error ? error.message : String(error));
-        process.exit(1);
-    });
-}
-export { buildToolRegistry, makeToolContext };
-//# sourceMappingURL=server.js.map