ygl-trees 0.78.0 → 0.80.0

package/dist/packages/techtree/model/src/reads.js

@@ -44,6 +44,14 @@ class TreeStore {
     nodeGet(treeId, keyOrId) {
         return this.db.get("SELECT * FROM nodes WHERE tree_id=? AND (key=? OR id=?)", [treeId, keyOrId, keyOrId]);
     }
+    /** Which OTHER trees contain this key? (Report ③: a parallel session
+     *  flipped current_tree; `node can p_dates` then said just "node not
+     *  found" — the key existed the whole time, in another tree. This lookup
+     *  lets the error name the tree instead of forcing a blind node list.) */
+    nodeInOtherTrees(keyOrId, excludeTreeId) {
+        return this.db.all(`SELECT t.name AS tree, n.key FROM nodes n JOIN trees t ON t.id=n.tree_id
+        WHERE n.tree_id<>? AND (n.key=? OR n.id=?) LIMIT 5`, [excludeTreeId, keyOrId, keyOrId]);
+    }
     /** Runtime state for one node (default context). Separate from nodeGet on
      *  purpose: nodeGet feeds WRITE paths, and a context join there could return
      *  one row per context — silently wrong for link/unlink/rm. */
@@ -378,6 +386,12 @@ class TreeStore {
      * + unlocked set + the caller's state bag. The eval API demands a context
      * package — bare state fell into the gray band 6/8 in the material's
      * routing test, so we ship everything the tree knows about this node.
+     *
+     * 0.80: the rel fabric joins the package — evidence/claim/kb summaries
+     * attached to the node (either direction) land in `attachments`, so a
+     * decided-by chain is visible to the eval model without manually
+     * re-carrying facts via --state (user finding: P 0.30 → 0.92 gap).
+     * Bounded: ≤12 rows, text clipped to 120 chars.
      */
     evalContext(treeId, keyOrId, stateBag, context = "default") {
         const n = this.nodeGet(treeId, keyOrId);
@@ -390,7 +404,7 @@ class TreeStore {
             name: c.name, kind: c.kind, op: c.op, value: c.value, required: !!c.required, effect: c.effect,
         }));
         const unlocked = [...this.unlockedSet(treeId, context)].map((id) => idToKey.get(id) || id);
-        return {
+        const pkg = {
             node: { key: n.key, name: n.name, kind: n.kind, tier: n.tier, cost: n.cost },
             parents,
             ancestors,
@@ -398,6 +412,50 @@ class TreeStore {
             unlocked,
             state: stateBag,
         };
+        const attachments = this.relAttachments(String(n.id));
+        if (attachments.length)
+            pkg.attachments = attachments;
+        return pkg;
+    }
+    /** 0.80: rel-fabric summaries for the eval context package (both directions). */
+    relAttachments(nodeId) {
+        const rows = this.db.all(`SELECT rel, src_type, src_id, dst_type, dst_id FROM relations
+       WHERE (src_type='node' AND src_id=?) OR (dst_type='node' AND dst_id=?)
+       ORDER BY rowid LIMIT 12`, [nodeId, nodeId]);
+        const clip = (v, n = 120) => String(v ?? "").slice(0, n);
+        return rows.map((r) => {
+            const srcIsMe = r.src_type === "node" && r.src_id === nodeId;
+            const type = String(srcIsMe ? r.dst_type : r.src_type);
+            const id = String(srcIsMe ? r.dst_id : r.src_id);
+            const base = { rel: String(r.rel), type, id };
+            const q = (sql) => this.db.get(sql, [id]);
+            if (type === "claim") {
+                const c = q("SELECT text, status, confidence FROM claims WHERE id=?");
+                if (c)
+                    return { ...base, text: clip(c.text), status: c.status, confidence: c.confidence };
+            }
+            else if (type === "evidence") {
+                const e = q("SELECT quote FROM evidence WHERE id=?");
+                if (e)
+                    return { ...base, quote: clip(e.quote) };
+            }
+            else if (type === "kb") {
+                const k = q("SELECT title FROM kb_notes WHERE id=?");
+                if (k)
+                    return { ...base, title: clip(k.title, 80) };
+            }
+            else if (type === "source") {
+                const s = q("SELECT title FROM sources WHERE id=?");
+                if (s)
+                    return { ...base, title: clip(s.title, 80) };
+            }
+            else if (type === "node") {
+                const nd = q("SELECT key, name FROM nodes WHERE id=?");
+                if (nd)
+                    return { ...base, key: nd.key, name: clip(nd.name, 80) };
+            }
+            return base; // query/artifact/skill or dangling ref: id only
+        });
     }
     /** Every node whose required gates are currently satisfied. */
     ready(treeId, context = "default", state = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ygl-trees",
-  "version": "0.78.0",
+  "version": "0.80.0",
   "description": "猿光 · 科技树 — database-centric CLI for research → production → knowledge reuse, built for AI agents.",
   "type": "commonjs",
   "main": "dist/apps/cli/index.js",
@@ -27,8 +27,8 @@
     "typeorm": "^1.1.2",
     "@deepseek-ai/cordis": "~4.0.5-alpha.2",
     "@deepseek-ai/cordis-plugin-timer": "~1.1.7-alpha.2",
-    "@deepseek-ai/schemastery": "~3.18.5-alpha.2",
-    "@deepseek-ai/cosmokit": "~1.8.6-alpha.2"
+    "@deepseek-ai/cosmokit": "~1.8.6-alpha.2",
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.2"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
@@ -49,7 +49,8 @@
     ],
     "exclude": [
       "node_modules",
-      "dist"
+      "dist",
+      "tmp"
     ],
     "env": {
       "YGL_TEST": "1"

package/skills/ygl-trees-eval-gates/SKILL.md

@@ -60,7 +60,12 @@ ygl-trees node can gate-node --eval --json     # evaluated[] 带 type 字段 + p
 ## 4. 上下文包（模型看到什么）
 
 节点元数据（key/name/kind/tier/cost）+ 直接父（node_edges）+ 祖先链（node_closure）+
-该节点全部条件 + 已解锁集 + `--state` 袋。**state 必带上下文包**——裸 state 大概率落灰带。
+该节点全部条件 + 已解锁集 + `--state` 袋 + **rel 挂接摘要（0.80）**。**state 必带上下文包**——裸 state 大概率落灰带。
+
+**attachments（0.80 织物并入）**：节点挂接的 rel 关系（双向 ≤12 条）自动摘录入包——
+claim（text+status+confidence）、evidence（quote 截 120 字）、kb/source（标题）、node（key+name）、
+其余类型 id-only。裁决链 `decided-by` 挂好后 eval 模型直接可见，不必 `--state k=v` 手动携带事实
+（用户实测：不挂链 P=0.30，挂链后 0.92）。
 
 ## 5. 凭证与端点（优先级：config > 环境变量/文件 > 默认网关）
 

package/skills/ygl-trees-quickstart/SKILL.md

@@ -9,7 +9,7 @@ description: >-
   触发词：ygl-trees 入门、初始化、quickstart、工作区、退出码、exit code、备份、export、
   PostgreSQL、sync、migrate、镜像、job、tick、定时、doctor、健康检查、任务、task、
   关联、rel、插件、plugin、WebUI、webui、仪表盘、dashboard、bench、基准、bundle。
-version: 0.73.0
+version: 0.79.0
 tags: ygl-trees,quickstart,backup,postgres,schedule,doctor,plugin,webui,bench
 ---
 
@@ -56,25 +56,35 @@ ygl-trees llms --json              # 结构化 JSON
 ## 2b. 运维命令速查
 
 ```bash
-ygl-trees doctor           # 9 项健康检查
-ygl-trees doctor --fix     # 一键安全修复（脏索引标记 + 陈旧锁清理）
+ygl-trees doctor           # 10 项健康检查（含锁 pid 存活、幻影写入对账）
+ygl-trees doctor --fix     # 一键安全修复（脏索引 + 死 pid 陈旧锁；活 holder 不动）
+ygl-trees db unlock        # 清残留 .ygllock（死 pid 直清；活 holder 回显其命令行并拒绝，--force 强清）
 ygl-trees kb rm <id>       # 删除笔记（与 skill rm 对称）
 ygl-trees webui serve --host 0.0.0.0 --port 8642  # LAN/WSL 可访问
+ygl-trees webui serve --help   # 只打印用法不启服务（0.79.1 短路）
 ```
 
 PG 迁移预检：`db migrate pg` 前自动逐表扫描 INTEGER 列类型——非整数值会**点名 table.column rowid=N** 而非迁移时才爆。
 
-## 2c. DB 锁行为（0.68）
+## 2b2. 多会话安全（0.79）
 
-- CLI 短命令：进程级锁（保护写窗口，退出自动释放）
-- webui serve：无锁（WAL 并发安全，与 CLI 共存）
+- `tree use` / `project use` 落 `tree.use` / `project.use` 事件（`YGL_SESSION` 会话标识）
+- `agent brief` 的 `selection_changed`：最近 10 分钟选择变更；跨会话变更置顶提示带 `-t`/`-p`
+- `kb add` 回执自检（`verified:true`）+ 工作区回显（防写错 home 的"丢笔记"事故）
+- `research claim link <cid> <sid> --by-source`：来源下全部证据一次挂齐；误传来源 id 会列出其证据 id
+
+## 2c. DB 锁行为（0.68 → 0.79.1）
+
+- CLI 短命令：进程级锁（保护写窗口，退出自动释放）；锁文件记录**持有者命令行**，撞锁/`db unlock`/`doctor` 都回显真实持有者身份
+- webui serve：无锁（WAL 并发安全，与 CLI 共存；从不取写锁）
 - 死锁自愈：下一进程探测持有者 PID，死则即时清（无需手动 rmdir）
+- 无锁进程（serve / `db unlock` 自身）退出绝不误清并行会话的活锁（0.79.1 所有权守卫）
 - YGL_TEST=1：全旁路（测试并行）
 
 ## 3. 健康检查与任务
 
 ```bash
-ygl-trees doctor                     # 9 项健康检查（schema/索引/FTS/重复/孤儿/config/锁/eval信封/插件）
+ygl-trees doctor                     # 10 项健康检查（schema/索引/FTS/重复/孤儿/config/锁存活/eval信封/插件/幻影写入）
 ygl-trees task add "<标题>"           # 建任务（todo 起步）
 ygl-trees task list                  # 按状态分组
 ygl-trees task done <id>             # 勾销（全程留痕）
@@ -120,6 +130,7 @@ ygl-trees db export <file.sql>          # 全部数据表 + 行数摘要
 ygl-trees db sync pg <url>              # 可刷新 PK-only 镜像
 ygl-trees db migrate pg <url> [--fresh] # 一次性完整保真迁移
 ygl-trees job add <title> -- "<cmd>" --every 60   # cron 每分钟跑 job tick
+ygl-trees job add "闸门探针" -- "node probe.mjs" --every 30   # 树节奏化监控：任意命令皆可（0.79.1 实证）
 ```
 
 禁止双后端同写：ygl-trees 永远只写 SQLite，PG 是单向出口。

package/skills/ygl-trees-relating/SKILL.md

@@ -17,6 +17,11 @@ tags: ygl-trees,methodology,relations,fabric
 **两条平行流水线**：研究管线（source→evidence→claim→report）和科技树各自发育、零缝合——
 检阅者看不出"这个节点依据什么证据、由什么断言决定、跟踪着什么任务"。`relations` 表就是缝合线。
 
+**缝合直接喂决策模型（0.80）**：节点挂接的 rel 关系（双向 ≤12 条）自动进 eval 上下文包
+`attachments`——claim 带 text+status+confidence、evidence 带 quote 摘要。裁决 `decided-by`
+挂链后 `node can --eval` 不必 `--state k=v` 手动携带事实（实测 P 0.30 → 0.92）。
+挂链纪律由此获得语义门槛层面的回报。
+
 ## 2. rel 词汇表（方向：src --rel→ dst）
 
 | rel | 语义 | 典型挂法 |

package/skills/ygl-trees-research/SKILL.md

@@ -26,9 +26,14 @@ ygl-trees research source add --title t --url https://... \
         --abstract "..." --relevance 4 --query "邻接表 vs 闭包表"   # 手工入库+关联检索式
 ygl-trees research source fetch https://example.com/page     # 自动抓取（title/meta/正文；
                                                               # 非 html 拒收零副作用；薄内容打 needs_review）
+ygl-trees research source add --adjudication "会话内裁决：三条件已逐条核对" \
+        --tags adjudication                                    # 会话内裁决原生载体（0.80）：
+                                                              # url 自动 session://adjudication/<时刻>，
+                                                              # 摘要兼作标题——不再需要临时文件绕行
 ```
 
 来源按 `(project, url_hash)` 去重；`--query` 顺带建立召回关联（query list 显示召回数）。
+`--url` 收 http(s):// · file:// · session://（0.80）。
 
 ## 2. 摘录与断言
 
@@ -57,5 +62,7 @@ ygl-trees produce export <reportId> report.md
 
 - 先 `agent brief --json` 看 next_actions（它会告诉你缺来源/缺证据/缺断言）
 - 每条断言至少一条证据再进报告；contested 的要么补证据要么 resolve
+- 预测断言（`[预测·N天]`）定期 `research predict audit` 回测：本地判据自动测；`--state <file|url>`
+  桥接外部计数（裸键名后缀匹配 `counts.y_imported`）；已 resolve 的默认隐藏（`--all` 查看终态表）
 - `--json` 输出可直接 parse 拿 id；列表命令字段：source(id,title,url,relevance,…)、
   claim(id,text,status,confidence,sup,ref)、evidence(id,source,locator,quote,used_by)

package/skills/ygl-trees-techtree/SKILL.md

@@ -38,6 +38,7 @@ ygl-trees node index && ygl-trees node validate
 
 ```bash
 ygl-trees node can steel --state "lab_level=3,has_eng=1"   # 三类失败分开列+成本系数
+ygl-trees node can a b c --state-file bags.json            # 批量：一进程测 N 节点（探针 1s×N → 1s）
 ygl-trees node ready                                        # 当前可解锁集合
 ygl-trees node path steel                                   # 解锁顺序+累计成本（目标恒最后）
 ygl-trees node ancestors bronze                             # 闭包索引直查，depth=1 是直接父
@@ -46,6 +47,7 @@ ygl-trees node unlock mining && ygl-trees node lock mining
 
 - 写入时环守卫：门控边（prereq/unlock）成环当场拒绝
 - `node can` 输出：missing_required（阻塞）/ blocked_by（被排斥）/ missing_optional（不阻塞）
+- `--state-file` 两种形状：扁平 `{"y_imported":40}` 全节点共享；按节点 `{"a":{"y_imported":40}}` 各取各袋；多键 `--json` 返回数组（0.79.1）
 
 ## 3. 迁移与保真