openxiangda-skill-kit 2.3.110 → 2.3.111

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openxiangda-skill-kit",
-  "version": "2.3.110",
+  "version": "2.3.111",
   "description": "OpenXiangda 2.0 中文 AI 技能的校验、分发与安装。",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
     "README.md"
   ],
   "dependencies": {
-    "openxiangda-devkit-core": "2.63.3"
+    "openxiangda-devkit-core": "2.64.0"
   },
   "devDependencies": {
     "tsx": "4.23.12",

package/skills/openxiangda-v2/references/application-operations.md

@@ -30,6 +30,41 @@ CLI与MCP共用输入Schema、服务和平台错误。成功结果在 `data.resu
 配置与恢复在已授权范围内直接执行；health访问外部健康接口并保存元信息。
 操作目录不证明远端接口已部署或当前用户有权，执行结果由平台决定。
 
+## 原执行健康 {#execution-health}
+
+从 `admin operations` 发现 `diagnostics.execution-health`，输入只提供原 kind 和 UUID：
+
+```bash
+printf '%s' '{"kind":"event-delivery","id":"<原投递UUID>"}' | \
+  pnpm openxiangda admin execute diagnostics.execution-health --environment test --input - --json
+```
+
+kind 为 timer、date-trigger、event-delivery 或 legacy-schedule；legacy-schedule只接受production，V1工作区仍由原V1引擎维护。按当前工作区 appCode 和原登录身份的应用管理权限只读查询，不传tenant、任意URL或恢复动作。
+
+`admission`、`due`、`claim` 分别表示当前准入、原周期和claim；暂停可能仍有有效旧claim，未来/夜间周期不是卡住。lease过期或 `needs_review` 先核对原owner、退出证明与效果回执，不重放旧周期。timer当前按原事务行锁调度，预留lease字段不会被解释为executor空闲。缺记录/超时/schema缺失明确为未知，HTTP200只是诊断响应。
+
+目标平台需要提供此受管诊断路由；404先核对平台版本，不创建业务shim或替代执行。原requestId/commandId/DeploymentRun/fileId诊断继续用于原操作读回；健康投影不替代业务验收。
+
+## TEST 文件语义观察 {#semantic-audit}
+
+原平台管理员从目录发现 `diagnostics.semantic-audit`；只接受test。以下input的版本、Head修订、resourceCode均取自当前应用的实际TEST目标：
+
+```json
+{
+  "requirementId":"native.file-value.v2-envelope",
+  "resourceCode":"records",
+  "expectedAppVersionId":"11111111-1111-4111-8111-111111111111",
+  "expectedHeadRevision":1,
+  "limit":50
+}
+```
+
+把input交给 `admin execute diagnostics.semantic-audit --environment test --input <文件> --json`，或通过原MCP `application_operation`。版本/Head变化先刷新目标；不递增修订猜测当前状态。最多100行、32个file/image字段、单行文件值投影16KiB、20个原因样本。分页用原nextCursor传afterRecordId；后续页不冒充同一完整资源快照，工具不自动无限扫描。
+
+`satisfied`、`violations`、`incomplete`、`unknown`分别描述本次快照；报告始终 `admission: observe-only`。即使complete且satisfied也不是激活许可；dataLogicalRevisionId是定义版本，dataRevision明确为空。报告没有文件名、正文或原错误正文。signature.file遵循自身Omit协议，不误当file/image数组。
+
+此观察不证明文件存在/下载授权或历史权限/流程兼容，不自动转换或删除。需修复时交原repair owner评审精确before-image和目标；生产不在此入口范围。404仍先核对实际平台能力；旧SDK版本不能仅凭本文认定已安装该新操作。
+
 ## 事件高水位与指定恢复 {#events}
 
 遇到 `EVENT_V2_BACKPRESSURE_HIGH_WATER` 先读 `events.status` 的admission：采样新鲜度、

package/skills/openxiangda-v2/references/appspec.md

@@ -139,6 +139,10 @@ MCP `appspec_verify` 读取同一报告与运行事实。`spec verify` 根据当
 
 ## 新任务找回上下文
 
+读取时核对 `documentReadback` 的实际文件字节、读取字节、全文/历史索引模式和不可用原因；最多128条，`total`/`unavailable`/`truncated`明确其覆盖范围。单文件上限256KiB，正文上下文上限256KiB，按UTF-8字节计。`contextBudget.requestedContentBytes` 是预算前请求正文总量，`omitted` 每项包含实际字节及 `context-budget` 原因。
+
+超限、格式错误、符号链接或读取期间变化表示文件不可用；selector会提示在已成功读取的文档中无法解析，不能据此删除、重建文档或补造确认。真实不存在仍保留原not-found。先按相对路径处理原因，保留稳定ID/确认；相关正文过多时用稳定ID选择或拆分当前总纲，历史索引不是全文。81,602字节的普通资料在当前单文件预算内，不应套用旧64KiB限制。
+
 ### 架构决定的编号与创建
 
 需要长期引用的决定写入 `appspec/decisions/` 下的 Markdown。ADR 的 `id` 格式是 `ADR-` 加**恰好四位数字**，可选 `-` 分隔的大写字母或数字后缀，例如 `ADR-0001`、`ADR-0001-DATA-OWNER`；`ADR-001` 不合法。文件名建议与 ID 一致，引用使用元数据中的 ID。当前没有独立的 ADR 创建命令，可以手工创建，随后用 `spec context <ID>` 和 `spec check` 核对。

package/skills/openxiangda-v2/references/mcp.md

@@ -288,6 +288,117 @@ MCP 使用项目锁定的根包；在客户端配置下列 stdio 启动参数，
 {
   "type": "object",
   "oneOf": [
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "operation": {
+          "const": "diagnostics.semantic-audit",
+          "description": "绑定当前TEST版本和Head的文件值语义审计；仅观察，不修复或授予激活许可"
+        },
+        "environment": {
+          "type": "string",
+          "enum": [
+            "test"
+          ]
+        },
+        "input": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "requirementId": {
+              "const": "native.file-value.v2-envelope"
+            },
+            "resourceCode": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 128,
+              "pattern": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
+            },
+            "expectedAppVersionId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 36,
+              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
+            },
+            "expectedHeadRevision": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 9007199254740991
+            },
+            "afterRecordId": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 36,
+              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
+            },
+            "limit": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 100
+            }
+          },
+          "required": [
+            "requirementId",
+            "resourceCode",
+            "expectedAppVersionId",
+            "expectedHeadRevision"
+          ]
+        }
+      },
+      "required": [
+        "operation",
+        "environment",
+        "input"
+      ]
+    },
+    {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "operation": {
+          "const": "diagnostics.execution-health",
+          "description": "按原ID核对未来计划、暂停、claim和租约；不恢复或重放"
+        },
+        "environment": {
+          "type": "string",
+          "enum": [
+            "test",
+            "production"
+          ]
+        },
+        "input": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "kind": {
+              "type": "string",
+              "enum": [
+                "legacy-schedule",
+                "timer",
+                "date-trigger",
+                "event-delivery"
+              ]
+            },
+            "id": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 36,
+              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
+            }
+          },
+          "required": [
+            "kind",
+            "id"
+          ]
+        }
+      },
+      "required": [
+        "operation",
+        "environment",
+        "input"
+      ]
+    },
     {
       "type": "object",
       "additionalProperties": false,