@xdxer/dingtalk-agent 0.1.4-beta.0 → 0.1.4-beta.10

package/skills/dingtalk-basic-behavior/assets/{task-checkpoint.md → task-checkpoint.json}

@@ -1,10 +1,7 @@
-# Task Checkpoint
-
-```json
 {
   "$schema": "dingtalk-agent/task-checkpoint@1",
-  "taskId": "",
-  "scopeId": "",
+  "taskId": "<sessionId>",
+  "scopeId": "<contextId>",
   "status": "working",
   "revision": 1,
   "goal": "",
@@ -19,19 +16,3 @@
   "updatedAt": "",
   "updatedByRunId": ""
 }
-```
-
-## Checklist
-
-- [ ]
-
-## Work notes
-
-- 只保留恢复后继续工作所需的信息；不要复制完整聊天历史。
-- 外部写操作记录定位键和回读证据，不记录凭据。
-
-## Completion
-
-- Result:
-- Unresolved:
-- Next owner:

package/skills/dingtalk-basic-behavior/references/action-contract.md

@@ -29,3 +29,5 @@
 ## 结果判定
 
 模型输出不是完成证据。只有宿主生成的 Intent、Attempt、Verification、Receipt 和必要的平台回读共同构成结果。
+
+消息动作的 Receipt 只证明该消息动作本身。例如 `reply` 已送达不能证明回复中声称的文件、Workspace、文档写入或审批已经完成。任务进入 `completed` 前，还必须按 [task-lifecycle.md](task-lifecycle.md) 将各项 `doneWhen` 与独立证据对应起来。

package/skills/dingtalk-basic-behavior/references/memory-and-evolution.md

@@ -10,7 +10,7 @@ Provider 只改变“内容放在哪里”，不改变下面的筛选规则。
 ## 记什么
 
 - Working：当前 Session 的临时上下文。
-- Task：目标、状态、依赖、审批和检查点；事实源是任务/线程，不是语义记忆。跨 Run 的最小合同见 [task-lifecycle.md](task-lifecycle.md)。
+- Task：目标、状态、依赖、审批和检查点；事实源是任务/线程，不是语义记忆。Prepared Run 通过带 revision CAS 的 `task.json` 维护，跨 Run 的最小合同见 [task-lifecycle.md](task-lifecycle.md)。
 - Episodic：发生过的事件与 Receipt，带来源。
 - Social：当前 Workspace 的角色与沟通习惯，受 ACL 约束。
 - Semantic：相对稳定的知识，保留 provenance、scope、retention、hash。
@@ -25,3 +25,17 @@ Provider 只改变“内容放在哪里”，不改变下面的筛选规则。
 长期写入至少携带：`source`、`scope`、`recorded_at`、`confidence` 和 `supersedes`。没有值得保存的内容时，`nothing-to-save` 是正确结果。
 
 任务 checkpoint 与长期记忆必须分开：完成后可从任务证据中提炼稳定事实或 Skill 候选，但不能把进度、等待状态和临时计划整体写进 `MEMORY.md`。
+
+## L2 Operational Memory
+
+AI 表格宽表保存互动摘要、业务事实和可聚合热数据。Provider 只接受已由 `dws aitable table get` 查询到的 baseId/tableId/fieldId，不按表名或列名猜目标；每条记录以 `key + scopeId` 唯一定位，带 subjectId、kind、sourceRefs、occurredAt、recordedAt、confidence 和 attributes。
+
+默认 `memory operational upsert` 是无副作用 dry-run。真实写入需要 `--live --yes`，每次现查 DWS 身份；create/update 失败或超时后不重试写，而是按稳定 key 或 recordId 回读。匹配多行、无 recordId 或 cells 回读不一致都标为 uncertain/reconcile。Prepared Run 只能让宿主 typed Broker 执行，不能绕开 Action Gate。
+
+## L3 Candidate → Review → Publish
+
+在线 Run 只运行 `memory candidate propose`，候选绑定 contextId、Run、Event 和冻结 Definition hash；相同内容生成相同 candidate ID，重放不重复创建。在线不能 review/publish，也不能直接改本体、长期记忆、知识或 Skill。
+
+离线 reviewer 用 revision CAS approve/reject。批准后先 dry-run `memory candidate publish` 读取目标当前 hash；人工检查差异后带 `--expect-target-hash` 和 `--yes` 发布。本地 `local-md:` 目标位于 Agent/Git 工作树内，用 durable lease + 原子替换 + 回读；CLI 不自动 commit/push。`dingtalk-doc:` 只追加可见的唯一 candidate marker，需 `--live --yes`、DWS 身份校验和全文回读。
+
+钉钉文档 Markdown 没有可靠 CAS，所以其回执明确标记 `best-effort-read-check-append`；expected hash 只能发现发布前漂移，不能消除读写之间的竞态。marker 重复、回读不完整或目标漂移进入 uncertain/reconcile，不自动重试。发布完成也不热替换当前 Session 的 Definition/Skill/memory snapshot，只由新 Session 水合。

package/skills/dingtalk-basic-behavior/references/perception-and-gates.md

@@ -0,0 +1,28 @@
+# 感知补齐与双半闸门
+
+## 读取顺序
+
+```text
+response-gate.json
+  → enriched-invocation.json
+  → agent-definition
+  → trigger / message
+  → 岗位 Skill
+  → Action Gate
+```
+
+Response Gate 在生成内容前决定是否有响应资格；Action Gate 在副作用前重新验证 target、身份、出口、generation、预算、幂等和所有权威快照。贴心感知不能绕过其中任何一个。
+
+## EnrichedInvocation
+
+| 项 | 作用 | 缺失时 |
+|---|---|---|
+| quote | 还原引用原文、作者和时间 | 若不影响含义就继续；真正阻塞才问 |
+| burst | 合并同一 actor/conversation 两分钟内的连发消息 | 只使用当前消息，并承认上下文可能不完整 |
+| identity | 把可信 ID 解析成姓名、部门、职务 | 使用事件 envelope 的显示信息，不猜组织身份 |
+
+每项的 `source` 只能说明内容从哪里取得，不授予权限。`truncated=true` 时不能假装看到了全文；需要全文且无法继续时才 ask。
+
+## 软判断仍由 Skill 完成
+
+mention/DM 通过硬资格门后，仍要判断：是否属于职责、是否已有人完整回答、是否有新增价值、是否泄漏私聊、是否缺少真正阻塞的信息。判断结果只能在硬允许的动作集合内选择；不能把“贴心”解释为主动扩大服务范围。

package/skills/dingtalk-basic-behavior/references/task-lifecycle.md

@@ -56,10 +56,32 @@ goal / deliverable / scope / done_when / constraints / authority / timing
 
 工具返回失败、超时或结果不确定时，不盲重试写操作；先回读。不能把“命令执行过”写成“任务完成”。
 
+把证据绑定到完成条件，而不是堆一串工具日志：
+
+| 完成条件 | 最低证据 |
+|---|---|
+| 内容已生成 | 可展示的结果正文 |
+| 文件已保存 | 文件存在 + 内容/大小/hash 检查 |
+| Workspace/Artifact 已交付 | Definition/manifest 有效 + 声明产物逐项存在 |
+| 钉钉写入已成功 | Action Receipt + 必要的平台独立回读 |
+| 对方已接受 | 明确确认、审批或业务状态变更 |
+
+模型回复“已经创建”只是待验证的 claim。不能用 claim 证明 claim，也不能用消息 `reply` 的送达回执证明任务交付物已经存在。
+
 ### 7. COMPLETE
 
 回复应包含最小充分的四项：结果、验证证据、未解决项、下一责任人。若完成条件需要人确认，状态是 `verifying` 或 `waiting`，不是 `completed`。
 
+完成闸门逐项检查：
+
+1. `deliverable` 与 `doneWhen` 非空且仍符合最新授权；
+2. 状态已经进入 `verifying`，不能从 `working` 直接跳到 `completed`；
+3. 每条 `doneWhen` 都有可定位证据，证据必须指向产物、回读、Receipt 或确认，而不是“模型说已完成”；
+4. `waitingFor = null`、`nextAction = ""`，没有被总分掩盖的硬失败；
+5. 最终 `checkpoint` 说明实际完成到哪里，随后才写 `completed` 并回复 origin。
+
+闸门失败时，保留 `working/verifying/waiting/blocked` 中准确的一种状态，并告诉同事真实进度。准确的“待核验”比虚假的“已完成”更有用。
+
 ## 什么时候需要持久化
 
 只在以下任一条件成立时创建 checkpoint：
@@ -76,17 +98,20 @@ goal / deliverable / scope / done_when / constraints / authority / timing
 
 ```text
 working → waiting → working → verifying → completed
-    └───────────────────────────────→ blocked
+   │          │          │              │
+   └──────────┴──────────┴──────────────→ blocked
 任意非终态 ────────────────────────→ cancelled
 ```
 
-Checkpoint 使用 [task-checkpoint.md](../assets/task-checkpoint.md) 的结构。P0 中 `taskId = sessionId`，避免再发明一套任务身份。
+Runtime 允许 `verifying → working/waiting/blocked`，因为核验失败可能要求返工或等待；不允许 `working → completed`。`completed/cancelled` 是终态，旧 Run 不能重新打开。
+
+Checkpoint 使用 [task-checkpoint.json](../assets/task-checkpoint.json) 的结构。P0 中 `taskId = sessionId`、`scopeId = contextId`，避免再发明一套任务身份。
 
 ## 存在哪里
 
 ### Prepared Run
 
-按需写入 `$DTA_SESSION/memory/task.md`。`working.md` 可放摘录和临时笔记；`task.md` 只放恢复所需的目标、checkpoint、下一步、等待条件和证据。恢复时先读 `CONTEXT.md`、`context/resume.json` 和 task checkpoint，从 `nextAction` 继续，而不是重演全部历史。
+用 `dingtalk-agent task show --json` 读取，用 `dingtalk-agent task checkpoint --input ... --expect-revision N --json` 原子更新 `$DTA_SESSION/memory/task.json`。`working.md` 可放摘录和临时笔记；`task.json` 只放恢复所需的目标、checkpoint、下一步、等待条件和证据。每个新 Run 会把已有状态投影为只读的 `context/task-checkpoint.json`；从 `nextAction` 继续，而不是重演全部历史。
 
 ### Mounted / Direct Session
 
@@ -96,13 +121,13 @@ Checkpoint 使用 [task-checkpoint.md](../assets/task-checkpoint.md) 的结构
 
 钉钉文档和 Markdown 是业务 checkpoint，不是控制面真值。EventIndex、Wait、锁、generation、幂等键、Action intent/receipt 永远留在宿主 state store；超时也不能以文档内容推断副作用是否安全完成。
 
-## 为什么 P0 不增加一套 Task CLI
+## 为什么只增加两个 Task CLI
 
-现有 Session 已表示“一件事”，Wait 已承担事件唤醒。再增加 `task start/plan/wait/resume/complete` 会让模型多选一套同义状态机。若真实轨迹证明模型直接维护 checkpoint 经常出错，P1 只增加两个 provider-neutral 动作即可：
+现有 Session 已表示“一件事”，Wait 已承担事件唤醒。再增加 `task start/plan/wait/resume/complete` 会让模型多选一套同义状态机。当前只提供两个 provider-neutral 动作：
 
 ```bash
 dingtalk-agent task show --json
-dingtalk-agent task checkpoint --input checkpoint.json --expect-revision 3
+dingtalk-agent task checkpoint --input checkpoint.json --expect-revision 3 --json
 ```
 
-它们只负责校验、冲突检测、原子写和回读，不负责重新实现工作流引擎。
+它们只负责作用域校验、状态迁移、revision CAS、原子写和回读，不负责重新实现工作流引擎。Checkpoint 是语义工作记忆，不是 Wait/幂等/回执控制面。

package/dist/src/boot.js

@@ -1,70 +0,0 @@
-// 冷启动 —— **fail-closed**（TypeScript source）。
-//
-// ⚠️ 这里必须【真的调 dws】。只查本地文件存不存在的 boot 是空转 ——
-//    占位模板照样 BOOT OK，fail-closed 变成死代码，dws 硬化包装永远不会被执行。
-//    **「文档是劝，代码是拦」—— 拦的那部分不运行，就等于没有。**
-//
-// **水合不完整 → 禁答身份/能力/记忆/统计类问题。** 报 BOOT FAIL，不许猜、不许找替代路径。
-// **一个「半个记忆」的员工，比一个明确说「我还没醒」的员工危险得多。**
-import { readFileSync, existsSync, readdirSync } from 'node:fs';
-import { join } from 'node:path';
-import * as dws from './dws.js';
-import { parseSource } from './kb.js';
-const REQUIRED = ['index.md', 'self/role-spec.md', 'self/access.md', 'self/workspace.md'];
-const PROBE = {
-    doc: (id) => dws.run(['doc', 'info', '--node', id], { allowFail: true }),
-    wiki: (id) => dws.run(['wiki', 'space', 'get', '--space-id', id], { allowFail: true }),
-    local: (id) => (existsSync(id) ? { ok: true } : null),
-};
-class BootError extends Error {
-    exitCode = 2;
-}
-export function boot(cfg, root) {
-    // ── ① 本体三件套：在不在、是不是还只是模板 ──
-    const bad = [];
-    for (const f of REQUIRED) {
-        const p = join(root, 'ontology', f);
-        if (!existsSync(p)) {
-            bad.push(`ontology/${f} 不存在`);
-            continue;
-        }
-        const txt = readFileSync(p, 'utf8');
-        const holes = (txt.match(/<待填>|TODO/g) || []).length;
-        if (txt.length < 50 || holes >= 3)
-            bad.push(`ontology/${f} 还是模板/占位（${holes} 处没填）`);
-    }
-    if (bad.length) {
-        console.error('[BOOT FAIL] 本体没水合完:');
-        for (const x of bad)
-            console.error(`  ✗ ${x}`);
-        console.error('\n  **禁答身份/能力/记忆/统计类问题。** 不要猜，不要找替代路径。');
-        throw new BootError('BOOT FAIL');
-    }
-    // ── ② 挂载的知识库【真的还在吗】—— 这一步会真调 dws ──
-    const kbs = cfg.kb || [];
-    if (!kbs.length) {
-        console.log('  ⚠️ 一个知识库都没挂 —— 它「知道什么」是空的。');
-        console.log('     dingtalk-agent kb mount --name <名字> --from dingtalk:doc:<folderId> --own external');
-    }
-    const dead = [];
-    for (const kb of kbs) {
-        const { kind, id } = parseSource(kb.from);
-        const ok = PROBE[kind] ? PROBE[kind](id) : null;
-        console.log(`  ${ok ? '✓' : '✗'} ${kb.name.padEnd(14)} ${kb.from}`);
-        if (!ok)
-            dead.push(kb.name);
-    }
-    if (dead.length) {
-        console.error(`\n[BOOT FAIL] 这些知识库【拉不到】: ${dead.join('、')}`);
-        console.error('  可能是：被删了 / 没权限 / 网络不通。**正面修，不要绕过。**');
-        console.error('  **禁答知识类问题** —— 你不知道自己知道什么。');
-        throw new BootError('BOOT FAIL');
-    }
-    const runs = existsSync(join(root, 'runs'))
-        ? readdirSync(join(root, 'runs')).filter((f) => f.endsWith('.md')).length : 0;
-    console.log(`\n[BOOT OK] ${cfg.agent?.name} · 本体已水合 · 知识库 ${kbs.length} 个在线`);
-    console.log(`  · 值班 ${(cfg.duties || []).length} 项 · 运行记录 ${runs} 天`);
-    console.log('\n下一步：读 ontology/index.md → self/（三件套）→ **命中路由才读** world/ 和 skills/。');
-    console.log('**渐进披露：用不上的正文一个字都不读。**');
-}
-//# sourceMappingURL=boot.js.map

package/dist/src/boot.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"boot.js","sourceRoot":"","sources":["../../src/boot.ts"],"names":[],"mappings":"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","sourcesContent":["// 冷启动 —— **fail-closed**（TypeScript source）。\n//\n// ⚠️ 这里必须【真的调 dws】。只查本地文件存不存在的 boot 是空转 ——\n//    占位模板照样 BOOT OK，fail-closed 变成死代码，dws 硬化包装永远不会被执行。\n//    **「文档是劝，代码是拦」—— 拦的那部分不运行，就等于没有。**\n//\n// **水合不完整 → 禁答身份/能力/记忆/统计类问题。** 报 BOOT FAIL，不许猜、不许找替代路径。\n// **一个「半个记忆」的员工，比一个明确说「我还没醒」的员工危险得多。**\nimport { readFileSync, existsSync, readdirSync } from 'node:fs'\nimport { join } from 'node:path'\nimport * as dws from './dws.js'\nimport { parseSource } from './kb.js'\n\nconst REQUIRED = ['index.md', 'self/role-spec.md', 'self/access.md', 'self/workspace.md']\n\nconst PROBE: Record<string, (id: string) => unknown> = {\n  doc: (id) => dws.run(['doc', 'info', '--node', id], { allowFail: true }),\n  wiki: (id) => dws.run(['wiki', 'space', 'get', '--space-id', id], { allowFail: true }),\n  local: (id) => (existsSync(id) ? { ok: true } : null),\n}\n\nclass BootError extends Error {\n  exitCode = 2\n}\n\nexport function boot(cfg, root) {\n  // ── ① 本体三件套：在不在、是不是还只是模板 ──\n  const bad: string[] = []\n  for (const f of REQUIRED) {\n    const p = join(root, 'ontology', f)\n    if (!existsSync(p)) { bad.push(`ontology/${f} 不存在`); continue }\n    const txt = readFileSync(p, 'utf8')\n    const holes = (txt.match(/<待填>|TODO/g) || []).length\n    if (txt.length < 50 || holes >= 3) bad.push(`ontology/${f} 还是模板/占位（${holes} 处没填）`)\n  }\n  if (bad.length) {\n    console.error('[BOOT FAIL] 本体没水合完:')\n    for (const x of bad) console.error(`  ✗ ${x}`)\n    console.error('\\n  **禁答身份/能力/记忆/统计类问题。** 不要猜，不要找替代路径。')\n    throw new BootError('BOOT FAIL')\n  }\n\n  // ── ② 挂载的知识库【真的还在吗】—— 这一步会真调 dws ──\n  const kbs = cfg.kb || []\n  if (!kbs.length) {\n    console.log('  ⚠️ 一个知识库都没挂 —— 它「知道什么」是空的。')\n    console.log('     dingtalk-agent kb mount --name <名字> --from dingtalk:doc:<folderId> --own external')\n  }\n  const dead: string[] = []\n  for (const kb of kbs) {\n    const { kind, id } = parseSource(kb.from)\n    const ok = PROBE[kind] ? PROBE[kind](id) : null\n    console.log(`  ${ok ? '✓' : '✗'} ${kb.name.padEnd(14)} ${kb.from}`)\n    if (!ok) dead.push(kb.name)\n  }\n  if (dead.length) {\n    console.error(`\\n[BOOT FAIL] 这些知识库【拉不到】: ${dead.join('、')}`)\n    console.error('  可能是：被删了 / 没权限 / 网络不通。**正面修，不要绕过。**')\n    console.error('  **禁答知识类问题** —— 你不知道自己知道什么。')\n    throw new BootError('BOOT FAIL')\n  }\n\n  const runs = existsSync(join(root, 'runs'))\n    ? readdirSync(join(root, 'runs')).filter((f) => f.endsWith('.md')).length : 0\n  console.log(`\\n[BOOT OK] ${cfg.agent?.name} · 本体已水合 · 知识库 ${kbs.length} 个在线`)\n  console.log(`  · 值班 ${(cfg.duties || []).length} 项 · 运行记录 ${runs} 天`)\n  console.log('\\n下一步：读 ontology/index.md → self/（三件套）→ **命中路由才读** world/ 和 skills/。')\n  console.log('**渐进披露：用不上的正文一个字都不读。**')\n}\n"]}

package/dist/src/duty.js

@@ -1,74 +0,0 @@
-// 内化心跳值班 —— **待办是给人的，心跳是 Agent 的生理。**（TypeScript source）
-//
-// 把「永远做不完的义务」塞进「有终态的待办」，是错配：
-// 接力链一断 → 列表里没有下一期 → 心跳无事可做、静默收工、**且不自知**。
-//
-// 三类 + 窗口闸门：
-//   轻   白天任意一拍（秒级）
-//   重   00:00–06:00（白天每 15 分钟全量重算一遍是纯浪费）
-//   交付 08:00–22:00（外发，**静默时段顺延，不打扰第三方**）
-//
-// **完成判据必须【数据派生】** —— 不记状态、不建标记文件、不看会话记忆。
-import { scan, ranTonight, now, today } from './runs.js';
-export const NIGHT = [0, 6];
-export const DELIVER = [8, 22];
-const hour = () => new Date(Date.now() + 8 * 3600e3).getUTCHours();
-const minute = () => new Date(Date.now() + 8 * 3600e3).getUTCMinutes();
-const weekday = () => new Date(Date.now() + 8 * 3600e3).getUTCDay(); // 0=周日
-export const inNight = () => hour() >= NIGHT[0] && hour() < NIGHT[1];
-export const inDeliver = () => hour() >= DELIVER[0] && hour() < DELIVER[1];
-/** 近 days 天的运行记录里，有没有一条 what 且 pass 的。 */
-export function ranOk(root, what, days) {
-    const hit = scan(root, days).find((r) => r.did === what && r.r === 'pass');
-    return hit ? `${hit._day} ${hit.t}` : '';
-}
-/**
- * 交付类值班的判据。**外发没有派生数据可查 —— 唯一的证据就是留痕。**
- *
- * ⚠️ 这条 pass 只能在【回读确认送达】之后写。
- *    没送达就写 pass = 自己骗自己，**比链断掉还糟**（断链至少看得出来"今天没跑"）。
- *
- * ⚠️⚠️ **已知缺口**：判据靠本地 runs/，而 runs/ 是 gitignored 的。
- *    换实例 / 换容器 / 清了本地档 → **今天的群消息会再发一遍。群里刷屏不可撤销。**
- *    对策（按可靠性排序）：
- *      1. 发之前**先回读目标本身**（群里今天已经有这条了吗）—— 证据在【外面的世界】
- *      2. runs/ 落共享存储，让多实例看到同一份
- *      3. 至少：发之前先 duty --check，人眼确认
- *    **在 1 或 2 落地之前，只有单实例是安全的。**
- */
-export function deliverDuty(root, { id, hh, mm = 0, playbook, weekly = false }) {
-    const what = '值班·' + id;
-    let days, span, due;
-    if (weekly) {
-        days = weekday() === 0 ? 7 : weekday();
-        span = '本周';
-        // ⚠️ 不能写成「只有周一 due」—— 周一漏一拍 → 这一期【永不补、也永不报警】。
-        //    正确语义：**本期内还没送达，就一直该做。**
-        due = weekday() >= 1 && (weekday() > 1 || hour() >= hh);
-    }
-    else {
-        days = 1;
-        span = '今天';
-        due = hour() > hh || (hour() === hh && minute() >= mm);
-    }
-    const at = ranOk(root, what, days);
-    return {
-        id, kind: '交付', playbook,
-        due: due && inDeliver(),
-        done: Boolean(at),
-        detail: at ? `${span}已送达 ${at}`
-            : `${span}还没送达 · 该做的时刻 ${String(hh).padStart(2, '0')}:${String(mm).padStart(2, '0')}`,
-        gap: at ? '' : '按剧本执行 → **回读确认送达** → runlog 记 pass',
-    };
-}
-/** 值班表 —— **母体出厂是空的，这是【正确】的。** 具体岗位在 config.duties 里加。 */
-export function loadDuties(cfg, root) {
-    const out = {};
-    for (const d of cfg.duties || []) {
-        if (d.kind === '交付')
-            out[d.id] = () => deliverDuty(root, d);
-        // 轻/重 类的 done 判据是【数据派生】的，随岗位而异 → fork 后在这里注册自己的探针。
-    }
-    return out;
-}
-//# sourceMappingURL=duty.js.map

package/dist/src/duty.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"duty.js","sourceRoot":"","sources":["../../src/duty.ts"],"names":[],"mappings":"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","sourcesContent":["// 内化心跳值班 —— **待办是给人的，心跳是 Agent 的生理。**（TypeScript source）\n//\n// 把「永远做不完的义务」塞进「有终态的待办」，是错配：\n// 接力链一断 → 列表里没有下一期 → 心跳无事可做、静默收工、**且不自知**。\n//\n// 三类 + 窗口闸门：\n//   轻   白天任意一拍（秒级）\n//   重   00:00–06:00（白天每 15 分钟全量重算一遍是纯浪费）\n//   交付 08:00–22:00（外发，**静默时段顺延，不打扰第三方**）\n//\n// **完成判据必须【数据派生】** —— 不记状态、不建标记文件、不看会话记忆。\nimport { scan, ranTonight, now, today } from './runs.js'\n\nexport const NIGHT = [0, 6]\nexport const DELIVER = [8, 22]\n\nconst hour = () => new Date(Date.now() + 8 * 3600e3).getUTCHours()\nconst minute = () => new Date(Date.now() + 8 * 3600e3).getUTCMinutes()\nconst weekday = () => new Date(Date.now() + 8 * 3600e3).getUTCDay()   // 0=周日\n\nexport const inNight = () => hour() >= NIGHT[0] && hour() < NIGHT[1]\nexport const inDeliver = () => hour() >= DELIVER[0] && hour() < DELIVER[1]\n\n/** 近 days 天的运行记录里，有没有一条 what 且 pass 的。 */\nexport function ranOk(root, what, days) {\n  const hit = scan(root, days).find((r) => r.did === what && r.r === 'pass')\n  return hit ? `${hit._day} ${hit.t}` : ''\n}\n\n/**\n * 交付类值班的判据。**外发没有派生数据可查 —— 唯一的证据就是留痕。**\n *\n * ⚠️ 这条 pass 只能在【回读确认送达】之后写。\n *    没送达就写 pass = 自己骗自己，**比链断掉还糟**（断链至少看得出来\"今天没跑\"）。\n *\n * ⚠️⚠️ **已知缺口**：判据靠本地 runs/，而 runs/ 是 gitignored 的。\n *    换实例 / 换容器 / 清了本地档 → **今天的群消息会再发一遍。群里刷屏不可撤销。**\n *    对策（按可靠性排序）：\n *      1. 发之前**先回读目标本身**（群里今天已经有这条了吗）—— 证据在【外面的世界】\n *      2. runs/ 落共享存储，让多实例看到同一份\n *      3. 至少：发之前先 duty --check，人眼确认\n *    **在 1 或 2 落地之前，只有单实例是安全的。**\n */\nexport function deliverDuty(root, { id, hh, mm = 0, playbook, weekly = false }) {\n  const what = '值班·' + id\n  let days, span, due\n  if (weekly) {\n    days = weekday() === 0 ? 7 : weekday()\n    span = '本周'\n    // ⚠️ 不能写成「只有周一 due」—— 周一漏一拍 → 这一期【永不补、也永不报警】。\n    //    正确语义：**本期内还没送达，就一直该做。**\n    due = weekday() >= 1 && (weekday() > 1 || hour() >= hh)\n  } else {\n    days = 1; span = '今天'\n    due = hour() > hh || (hour() === hh && minute() >= mm)\n  }\n  const at = ranOk(root, what, days)\n  return {\n    id, kind: '交付', playbook,\n    due: due && inDeliver(),\n    done: Boolean(at),\n    detail: at ? `${span}已送达 ${at}`\n               : `${span}还没送达 · 该做的时刻 ${String(hh).padStart(2, '0')}:${String(mm).padStart(2, '0')}`,\n    gap: at ? '' : '按剧本执行 → **回读确认送达** → runlog 记 pass',\n  }\n}\n\n/** 值班表 —— **母体出厂是空的，这是【正确】的。** 具体岗位在 config.duties 里加。 */\nexport function loadDuties(cfg, root) {\n  const out: Record<string, () => ReturnType<typeof deliverDuty>> = {}\n  for (const d of cfg.duties || []) {\n    if (d.kind === '交付') out[d.id] = () => deliverDuty(root, d)\n    // 轻/重 类的 done 判据是【数据派生】的，随岗位而异 → fork 后在这里注册自己的探针。\n  }\n  return out\n}\n"]}

package/dist/src/kb.js

@@ -1,240 +0,0 @@
-// 知识库挂载与同步（TypeScript source）。
-//
-// ════════════════════════════════════════════════════════════════════
-// 【核心判断】所有权决定真值方向。
-// ════════════════════════════════════════════════════════════════════
-//
-//                owned（我的本体）           external（别人维护的）
-//   真值在        **Git**（本地）             **钉钉**（远端）
-//   同步方向      push  本地 → 钉钉           pull  钉钉 → 本地
-//   为什么        给人看（人机同源）           给我 grep（快、能看上下文）
-//   冲突了        远端被人改过 → **停**       远端赢，本地缓存可丢弃
-//   落在          ontology/（入 Git）         .cache/kb/<name>/（gitignore）
-//
-// 这就是「Git 内核 × 钉钉暴露层」：**Git 是常量层，钉钉是可替换的暴露层。**
-//
-// ════════════════════════════════════════════════════════════════════
-// 【三个硬约束】—— 全是踩出来的
-// ════════════════════════════════════════════════════════════════════
-//
-// 1. **绝不双向自动 merge。** 一个方向是真值，另一个是投影。
-//    自动合并两个都在变的东西 = 灾难，而且是【静默】灾难。
-//
-// 2. **重排版不是漂移。** 判据是「剥掉 markdown 符号后的文字流」，不是行级 diff。
-//    用行级 diff → 每次 sync 都误报 → **你就会开始无脑 --force，真漂移也一起覆盖掉。**
-//
-// 3. **缓存不新鲜就不许用（fail-closed）。** external KB 是快照。
-//    **拿着过期快照回答，比说「我不知道」危险得多。**
-import { mkdirSync, writeFileSync, readFileSync, existsSync, statSync } from 'node:fs';
-import { readdirSync } from 'node:fs';
-import { join, dirname, relative, basename } from 'node:path';
-import { spawnSync } from 'node:child_process';
-import * as dws from './dws.js';
-export const OWNED = 'owned', EXTERNAL = 'external';
-export const PULL = 'pull', PUSH = 'push', NONE = 'none';
-/** external 缓存超过这么久就算过期。过期 → kb search 会警告并要求先 sync。 */
-export const STALE_HOURS = 24;
-const now = () => new Date(Date.now() + 8 * 3600e3).toISOString().replace('Z', '+08:00').slice(0, 19);
-class DriftError extends Error {
-    exitCode = 1;
-}
-/** dingtalk:doc:<folderId> · dingtalk:wiki:<spaceId> · local:<path> */
-export function parseSource(s) {
-    let m = /^dingtalk:(doc|wiki):(.+)$/.exec(s);
-    if (m)
-        return { kind: m[1], id: m[2] };
-    m = /^local:(.+)$/.exec(s);
-    if (m)
-        return { kind: 'local', id: m[1].replace(/^~/, process.env.HOME || '~') };
-    throw new Error(`挂载源写错了: ${s}\n` +
-        `  支持三种:\n` +
-        `    dingtalk:doc:<folderId>    文档文件夹（最常见 —— 很多组织根本没建"知识库"）\n` +
-        `    dingtalk:wiki:<spaceId>    钉钉知识库空间\n` +
-        `    local:<路径>               本地目录（只读挂载，比如另一个仓库的 wiki/）`);
-}
-// ════════════════ pull：钉钉 → 本地缓存 ════════════════
-function walkDoc(folder, prefix = '') {
-    const out = [];
-    for (const n of dws.nodes(dws.run(['doc', 'list', '--folder', folder, '--page-size', '50']))) {
-        const name = n.name || '', nid = n.nodeId;
-        if (n.nodeType === 'folder') {
-            out.push(...walkDoc(nid, join(prefix, name)));
-            continue;
-        }
-        if (n.contentType && n.contentType !== 'ALIDOC')
-            continue; // 二进制附件不是知识
-        out.push({ rel: join(prefix, name.endsWith('.md') ? name : `${name}.md`),
-            nid, mtime: n.updateTime || 0 });
-    }
-    return out;
-}
-function walkWiki(space, folder = '', prefix = '') {
-    const args = ['wiki', 'node', 'list', '--workspace', space, '--limit', '50'];
-    if (folder)
-        args.push('--folder', folder);
-    const out = [];
-    for (const n of dws.nodes(dws.run(args))) {
-        const name = n.name || '', nid = n.nodeId;
-        if (n.nodeType === 'folder' || n.hasChildren)
-            out.push(...walkWiki(space, nid, join(prefix, name)));
-        out.push({ rel: join(prefix, name.endsWith('.md') ? name : `${name}.md`),
-            nid, mtime: n.updateTime || 0 });
-    }
-    return out;
-}
-/** 钉钉 → 本地缓存。**远端赢**（external 的真值在远端）。增量靠 updateTime。 */
-export function pull(kb, root, force = false) {
-    const { kind, id } = parseSource(kb.from);
-    if (kind === 'local') {
-        console.log(`  local  ${kb.name}  就在本地，不用同步`);
-        return;
-    }
-    const dest = join(root, kb.local);
-    const items = kind === 'doc' ? walkDoc(id) : walkWiki(id);
-    if (!items.length) {
-        throw new Error(`「${kb.name}」远端一个节点都没有 —— **不许当成【这个知识库是空的】。**\n` +
-            `  可能是: ID 写错 / 没权限 / 它真的空。先用 dws 手工确认再说。`);
-    }
-    kb._state ??= {};
-    let pulled = 0, skipped = 0;
-    for (const { rel, nid, mtime } of items) {
-        const p = join(dest, rel);
-        if (!force && kb._state[nid]?.mtime === mtime && existsSync(p)) {
-            skipped++;
-            continue;
-        }
-        const md = dws.readDoc(nid);
-        mkdirSync(dirname(p), { recursive: true });
-        // 头三行钉住来源 —— **没有指针的知识，用的时候不敢信。**
-        writeFileSync(p, `<!-- 来自钉钉 · 只读缓存 · 不要在这里改，改了下次 sync 会被覆盖 -->\n` +
-            `<!-- nodeId: ${nid} -->\n<!-- 拉取: ${now()} -->\n\n${md}`);
-        kb._state[nid] = { rel, mtime };
-        pulled++;
-    }
-    kb._syncedAt = now();
-    console.log(`  pull   ${kb.name.padEnd(14)} 拉了 ${pulled} 篇 · 没变 ${skipped} 篇`);
-}
-// ════════════════ push：本地 → 钉钉（人机同源）════════════════
-function walkLocal(dir, base = dir) {
-    const out = [];
-    for (const e of readdirSync(dir, { withFileTypes: true })) {
-        const p = join(dir, e.name);
-        if (e.isDirectory()) {
-            out.push(...walkLocal(p, base));
-            continue;
-        }
-        if (e.name.endsWith('.md'))
-            out.push({ path: p, rel: relative(base, p) });
-    }
-    return out;
-}
-/**
- * 本地 → 钉钉。**Git 赢**（owned 的真值在 Git）。
- *
- * ⚠️ **推之前先查漂移** —— 远端被人改过就【停下来问】，绝不盲覆盖。
- *    人在钉钉里改了东西，说明他有话要说。**盲覆盖 = 把人的意见删了。**
- */
-export function push(kb, root, force = false) {
-    const { kind, id } = parseSource(kb.from);
-    if (kind !== 'doc') {
-        throw new Error('push 目前只支持 dingtalk:doc:<folderId>（文档文件夹）。\n' +
-            '  知识库空间的写入面还没验过 —— **不许假装支持。**');
-    }
-    const src = join(root, kb.local);
-    if (!existsSync(src))
-        throw new Error(`本地目录不存在: ${src}`);
-    kb._state ??= {};
-    const drift = [];
-    let pushed = 0, unchanged = 0;
-    for (const { path, rel } of walkLocal(src)) {
-        const body = readFileSync(path, 'utf8');
-        let nid = Object.keys(kb._state).find((k) => kb._state[k].rel === rel);
-        if (!nid) {
-            nid = String(dws.createDoc(id, basename(rel), path) || '');
-            if (!nid)
-                throw new Error(`创建 ${rel} 后没有返回 nodeId`);
-            kb._state[nid] = { rel, pushedWords: dws.words(body) };
-            pushed++;
-            console.log(`    + 新建 ${rel}`);
-            continue;
-        }
-        const remote = dws.readDoc(nid);
-        if (dws.same(remote, body)) {
-            unchanged++;
-            continue;
-        }
-        // 远端 ≠ 我上次推上去的 → **有人在钉钉里改过**
-        const last = kb._state[nid].pushedWords;
-        if (last && dws.words(remote) !== last && !force) {
-            drift.push({ rel, nid });
-            continue;
-        }
-        dws.updateDoc(nid, path);
-        if (!dws.same(dws.readDoc(nid), body)) {
-            throw new Error(`推了 ${rel} 但回读不一致 —— **写操作报错≠失败，回读定成败。**`);
-        }
-        kb._state[nid].pushedWords = dws.words(body);
-        pushed++;
-        console.log(`    ↑ 更新 ${rel}`);
-    }
-    if (drift.length) {
-        console.log(`\n  ⚠️ **远端被人改过**，默认拒绝覆盖（${drift.length} 篇）:`);
-        for (const { rel, nid } of drift)
-            console.log(`      ${rel}   nodeId=${nid}`);
-        console.log(`  人在钉钉里改了东西，说明他有话要说。**先去看一眼**，别盲覆盖。`);
-        console.log(`  确认要覆盖: dingtalk-agent kb sync --name ${kb.name} --force`);
-        throw new DriftError('有漂移，拒绝覆盖');
-    }
-    kb._syncedAt = now();
-    console.log(`  push   ${kb.name.padEnd(14)} 推了 ${pushed} 篇 · 一致 ${unchanged} 篇`);
-}
-// ════════════════ search：跨所有挂载点 ════════════════
-export function stale(kb) {
-    if (kb.own !== EXTERNAL || kb.sync === NONE)
-        return false;
-    if (!kb._syncedAt)
-        return true;
-    const age = (Date.now() - Date.parse(kb._syncedAt)) / 3600e3;
-    return age > STALE_HOURS;
-}
-/**
- * 跨所有挂载的 KB 搜。**本地 grep 为主** —— 快、确定、能看到上下文。
- *
- * fail-closed：不新鲜的缓存会【警告】。
- * **拿着过期快照回答，比说「我不知道」危险得多。**
- */
-export function search(cfg, root, kw, top = 20) {
-    const hits = [];
-    const warned = [];
-    for (const kb of cfg.kb || []) {
-        const base = kb.local.startsWith('/') ? kb.local : join(root, kb.local);
-        if (!existsSync(base))
-            continue;
-        if (stale(kb))
-            warned.push(kb.name);
-        const r = spawnSync('grep', ['-ril', '--include=*.md', kw, base], { encoding: 'utf8' });
-        for (const p of (r.stdout || '').split('\n').filter(Boolean)) {
-            const ctx = spawnSync('grep', ['-i', '-n', '-m', '2', kw, p], { encoding: 'utf8' }).stdout || '';
-            hits.push({ kb: kb.name, file: relative(root, p), ctx: ctx.trim() });
-        }
-    }
-    if (warned.length) {
-        console.log(`⚠️ 这些知识库的缓存【超过 ${STALE_HOURS} 小时没同步】了: ${warned.join('、')}`);
-        console.log(`   **拿着过期快照回答，比说「我不知道」危险得多。**`);
-        console.log(`   先跑: dingtalk-agent kb sync\n`);
-    }
-    if (!hits.length) {
-        console.log(`没搜到「${kw}」。`);
-        console.log(`**搜不到就说搜不到 —— 不要编。** 挂了哪些库: dingtalk-agent kb list`);
-        return [];
-    }
-    console.log(`命中 ${hits.length} 处:`);
-    for (const h of hits.slice(0, top)) {
-        console.log(`\n── [${h.kb}] ${h.file}`);
-        for (const l of h.ctx.split('\n').slice(0, 2))
-            console.log(`     ${l.slice(0, 110)}`);
-    }
-    console.log(`\n**别只看这几行就作答** —— 打开命中的那一页读完再说。`);
-    return hits;
-}
-//# sourceMappingURL=kb.js.map