阶段4-tool契约: register支持CapabilityMeta(决策8 meta可选+新能力强制), 新增registerAll显式注册入口双入口过渡(决策9), RUNTIME_ERROR_CODES错误码固化+audit校验, 规范v1同步收紧

docs/dev-conventions.md

@@ -45,10 +45,14 @@
    禁止返回"为 UI 拼接的字符串"（渲染层需要展示时自行格式化）。
 2. **必有超时**：涉及外部交互（进程/网络/窗口等待）的能力必须有 timeout 参数和默认值。
 3. **错误契约**：失败抛 `RuntimeError(code, message, { recommendation })`；
-   code 用稳定英文枚举，message 中文，recommendation 给可执行建议。禁止裸 throw string。
+   code 用稳定英文枚举（必须登记在 `packages/rpa-core/src/engine/error-codes.ts`
+   的 `RUNTIME_ERROR_CODES`，任务 4.3 起机器可读），message 中文，recommendation 给可执行建议。禁止裸 throw string。
 4. **平台标记**：Windows 专用能力（user32/UIA/COM）在 catalog 注册时带
    `platforms: ["win32"]`；能用纯 Node 实现的能力不调 PowerShell。
 5. **可测试**：每个能力有同名 `*.test.ts`（vitest），与实现同目录。
+6. **结构化 meta（任务 4.1 起，新能力强制）**：`register(ids, handler, meta)` 第三参
+   必填 `CapabilityMeta`（summary / params / returns / timeoutMs / errorCodes /
+   needsScreenshot / platforms）。老能力逐步补齐，review 时放行不带 meta 的旧文件改动。
 
 ## 四、新能力验收 checklist