ygl-trees 0.75.1 → 0.76.1

package/dist/packages/core/database/src/plugin.js

@@ -12,6 +12,7 @@ const cordis_1 = require("@deepseek-ai/cordis");
 const db_1 = require("./db");
 class DatabaseService extends cordis_1.Service {
     db;
+    disposed = false;
     constructor(ctx, dbFile) {
         super(ctx, "database");
         // GPT-6.1 SOL fix: the DB lock was only applied in the profile-boot
@@ -23,8 +24,61 @@ class DatabaseService extends cordis_1.Service {
         const lock = process.env.YGL_TEST !== "1" && process.env.YGL_SERVE !== "1";
         this.db = new db_1.DB(dbFile, { lock });
     }
+    /** Lifecycle: Cordis calls this when the Context is disposed — the
+     *  "Services stop with Context, resources auto-clean" promise made real.
+     *  Closes the SQLite handle AND the cached ORM DataSource. */
+    stop() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        try {
+            // Close the cached ORM DataSource if it was opened on this file
+            const { closeOrm } = require("./orm");
+            // closeOrm is async but stop() is sync in Cordis — fire-and-forget is
+            // safe here because db.close() below releases the file handle the ORM
+            // depends on; the ORM will see a closed connection and GC naturally.
+            closeOrm().catch(() => { });
+        }
+        catch { /* orm module not loaded — fine */ }
+        try {
+            this.db.close(); // releases .ygllock + closes SQLite handle
+        }
+        catch { /* already closed */ }
+    }
 }
 exports.DatabaseService = DatabaseService;
 function apply(ctx, config) {
     new DatabaseService(ctx, config.file);
+    // 0.76 bridge: eventbus (internal) → ctx.emit (Cordis public API).
+    // This makes "ctx.on()/emit()" work as documented — plugins can listen
+    // with ctx.on("ygl", handler) or ctx.on("ygl:node.unlock", handler).
+    // The eventbus remains the internal write-path transport.
+    try {
+        const { onEvent, onEventKind } = require("../../../core/text/src/eventbus");
+        const unsub = onEvent((evt) => { try {
+            ctx.emit("ygl", evt);
+        }
+        catch { /* */ } });
+        // Also bridge kind-specific channels
+        const kindSubs = [unsub];
+        const knownKinds = ["node.unlock", "node.lock", "node.add", "node.link",
+            "kb.add", "kb.rm", "claim.resolve", "claim.add", "task.status",
+            "project.new", "skill.add"];
+        for (const kind of knownKinds) {
+            kindSubs.push(onEventKind(kind, (evt) => { try {
+                ctx.emit(`ygl:${kind}`, evt);
+            }
+            catch { /* */ } }));
+        }
+        // Cleanup on Context dispose (best-effort — this fork has no ctx.dispose)
+        ctx.fiber?.collect?.(() => {
+            for (const u of kindSubs) {
+                try {
+                    u();
+                }
+                catch { /* */ }
+            }
+        });
+    }
+    catch { /* eventbus optional */ }
 }

package/dist/packages/core/text/src/eventbus.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitEvent = emitEvent;
+exports.onEvent = onEvent;
+exports.onEventKind = onEventKind;
+/**
+ * Cross-domain event bus — connects logEvent writes to real-time consumers.
+ *
+ * Architecture: a process-wide EventEmitter singleton. Write services call
+ * `emitEvent()` after logEvent persists to the events table; consumers
+ * (webui SSE, user plugins, future watchers) subscribe with `onEvent()`.
+ *
+ * This makes "ctx.on reactivity" real without requiring a full Cordis
+ * event system — a lightweight bridge that the webui and plugins can use.
+ *
+ * @module @ygl/core-text/eventbus
+ */
+const node_events_1 = require("node:events");
+const bus = new node_events_1.EventEmitter();
+bus.setMaxListeners(50); // SSE connections + plugins
+/** Publish a cross-domain event (called after events table write). */
+function emitEvent(evt) {
+    bus.emit("ygl", evt);
+    bus.emit(`ygl:${evt.kind}`, evt); // specific subscription channel
+}
+/** Subscribe to all events. Returns an unsubscribe function. */
+function onEvent(handler) {
+    bus.on("ygl", handler);
+    return () => bus.off("ygl", handler);
+}
+/** Subscribe to a specific kind (e.g. "node.unlock"). Returns unsubscribe. */
+function onEventKind(kind, handler) {
+    bus.on(`ygl:${kind}`, handler);
+    return () => bus.off(`ygl:${kind}`, handler);
+}

package/dist/packages/knowledge/skills/src/skill-cmds.js

@@ -187,13 +187,46 @@ function run(env, action, rest, args) {
             ]);
             return 0;
         case "link": {
-            // One-command symlink: skills/ → .agents/skills/ (or ~/.agents/skills/ with --global)
-            // so host agents (DSH, Claude, etc.) can discover them without manual junction setup.
+            // One-command symlink: skills/ → AI agent's skill directory.
+            // Supported targets:
+            //   (default)     ./.agents/skills/          (project-level, DSH/Claude)
+            //   --global      ~/.agents/skills/          (user-level, DSH/Claude)
+            //   --ai pi       ~/.pi/agent/skills/        (Pi agent)
+            //   --ai claude   ~/.claude/skills/          (Claude Code)
+            //   --ai cursor   ~/.cursor/skills/          (Cursor IDE)
+            //   --ai custom --to <path>                  (any directory)
             const os = require("node:os");
             const globalFlag = args?.flags?.global === true;
-            const targetDir = globalFlag
-                ? path.join(os.homedir(), ".agents", "skills")
-                : path.join(process.cwd(), ".agents", "skills");
+            const aiName = String(args?.flags?.ai || "").toLowerCase();
+            const customTo = String(args?.flags?.to || "");
+            // AI agent skill directory registry
+            const AI_SKILL_DIRS = {
+                pi: () => path.join(os.homedir(), ".pi", "agent", "skills"),
+                claude: () => path.join(os.homedir(), ".claude", "skills"),
+                cursor: () => path.join(os.homedir(), ".cursor", "skills"),
+                windsurf: () => path.join(os.homedir(), ".windsurf", "skills"),
+            };
+            let targetDir;
+            if (customTo) {
+                // --ai custom --to <path>
+                targetDir = path.resolve(customTo);
+            }
+            else if (aiName && AI_SKILL_DIRS[aiName]) {
+                // --ai <known-agent>
+                targetDir = AI_SKILL_DIRS[aiName]();
+            }
+            else if (aiName && aiName !== "custom") {
+                // --ai <unknown> → error with suggestions
+                (0, fmt_1.bad)(ctx, `unknown AI agent: ${aiName}`);
+                (0, fmt_1.out)(ctx, `  supported: ${Object.keys(AI_SKILL_DIRS).join(", ")} | custom (with --to <path>)`);
+                return 2;
+            }
+            else {
+                // default or --global
+                targetDir = globalFlag
+                    ? path.join(os.homedir(), ".agents", "skills")
+                    : path.join(process.cwd(), ".agents", "skills");
+            }
             // Find source skills directory (probe upward from cwd, same as repoRoot)
             let skillsDir = null;
             for (let dir = process.cwd(), i = 0; i < 6; i++, dir = path.dirname(dir)) {

package/dist/packages/ops/tools/src/webui.js

@@ -852,6 +852,23 @@ function createDashboardServer(env) {
         if (typeof h.unref === "function")
             h.unref();
     }
+    // ── 0.76 Event-driven SSE: subscribe to the cross-domain event bus.
+    // Writes (node unlock, claim resolve, kb add, etc.) now emit instantly —
+    // SSE pushes fresh data on write instead of waiting for the 1.5s tick.
+    // The fingerprint tick above stays as a fallback/degradation path.
+    let unsubBus = null;
+    try {
+        const { onEvent } = require("../../../core/text/src/eventbus");
+        unsubBus = onEvent((evt) => {
+            if (!sseClients.size)
+                return;
+            // Event received — push immediately (no polling delay)
+            push("data", gatherData(env));
+            // Also push the event itself as a named SSE event for fine-grained consumers
+            push(evt.kind.replace(/\//g, "-"), evt);
+        });
+    }
+    catch { /* eventbus optional — fingerprint tick still covers */ }
     const server = http.createServer((req, res) => {
         const u = new URL(req.url || "/", "http://127.0.0.1");
         const url = u.pathname;
@@ -962,7 +979,16 @@ function createDashboardServer(env) {
         sseClients.clear();
     };
     server.on("close", dropLive);
-    server.closeLive = dropLive;
+    server.closeLive = () => {
+        dropLive();
+        if (unsubBus) {
+            try {
+                unsubBus();
+            }
+            catch { /* */ }
+            unsubBus = null;
+        }
+    };
     return server;
 }
 /** Live dashboard: blocks until SIGINT/SIGTERM, then resolves so the CLI can

package/dist/packages/research/pipeline/src/writes.js

@@ -40,6 +40,12 @@ async function logEvent(mgr, kind, entity, entityId, payload, level = "info") {
         payload: p,
         level,
     });
+    // 0.76: cross-domain event bus — notify real-time consumers (SSE/plugins)
+    try {
+        const { emitEvent } = require("../../../core/text/src/eventbus");
+        emitEvent({ kind, entity, entityId, payload: String(payload), ts: new Date().toISOString() });
+    }
+    catch { /* eventbus optional — never block the write path */ }
 }
 // ================================================================ queries
 async function queryAdd(ds, projectId, text, engine = "", force = false) {

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

@@ -26,6 +26,12 @@ async function logEvent(mgr, kind, entityId, payload, level = "info") {
     const run = process.env.YGL_RUN_ID || "";
     const body = run ? JSON.stringify({ ...payload, run }) : JSON.stringify(payload ?? {});
     await mgr.query(`INSERT INTO events(id,ts,actor,kind,entity,entity_id,payload,level) VALUES(?,?,?,?,?,?,?,?)`, [(0, text_1.shortId)([kind, entityId], 12), (0, text_1.nowIso)(), "cli", kind, "node", entityId, body, level]);
+    // 0.76: cross-domain event bus — notify real-time consumers (SSE/plugins)
+    try {
+        const { emitEvent } = require("../../../core/text/src/eventbus");
+        emitEvent({ kind, entity: "node", entityId, payload: String(body), ts: new Date().toISOString() });
+    }
+    catch { /* eventbus optional — never block the write path */ }
 }
 async function reaches(mgr, treeId, fromId, toId) {
     const rows = (await mgr.query(`SELECT 1 AS hit FROM node_closure WHERE tree_id=? AND ancestor=? AND descendant=? AND depth>0`, [treeId, fromId, toId]));
@@ -134,8 +140,8 @@ async function buildIndex(mgr, treeId) {
         inDegree[n.key] = (requiredParents.get(n.id) || []).length;
     for (const n of nodes)
         await mgr.query(`UPDATE nodes SET tier=? WHERE id=? AND tier<>?`, [tierOf.get(n.id) ?? 0, n.id, tierOf.get(n.id) ?? 0]);
-    await mgr.query(`INSERT INTO node_index(tree_id,topo_order,tiers,in_degree,built_at,dirty) VALUES(?,?,?,?,?,0)
-     ON CONFLICT(tree_id) DO UPDATE SET topo_order=excluded.topo_order, tiers=excluded.tiers,
+    await mgr.query(`INSERT INTO node_index(tree_id,topo_order,tiers,in_degree,built_at,dirty) VALUES(?,?,?,?,?,0)
+     ON CONFLICT(tree_id) DO UPDATE SET topo_order=excluded.topo_order, tiers=excluded.tiers,
        in_degree=excluded.in_degree, built_at=excluded.built_at, dirty=0`, [treeId, JSON.stringify(topo), JSON.stringify(tiers), JSON.stringify(inDegree), (0, text_1.nowIso)()]);
     return { topo, tiers, inDegree };
 }
@@ -222,10 +228,10 @@ async function link(ds, treeId, parentKey, childKey, o = {}) {
         const before = (await mgr.query(`SELECT id FROM node_edges WHERE parent_id=? AND child_id=? AND rel=?`, [p[0].id, c[0].id, rel]));
         const duplicate = before.length > 0;
         const id = duplicate ? before[0].id : (0, text_1.shortId)(["edge", p[0].id, c[0].id, rel], 12);
-        await mgr.query(`INSERT INTO node_edges(id,tree_id,parent_id,child_id,rel,mode,required,min_level,weight,note,created)
-       VALUES(?,?,?,?,?,?,?,?,?,?,?)
-       ON CONFLICT(parent_id,child_id,rel) DO UPDATE SET
-         mode=excluded.mode, required=excluded.required, min_level=excluded.min_level,
+        await mgr.query(`INSERT INTO node_edges(id,tree_id,parent_id,child_id,rel,mode,required,min_level,weight,note,created)
+       VALUES(?,?,?,?,?,?,?,?,?,?,?)
+       ON CONFLICT(parent_id,child_id,rel) DO UPDATE SET
+         mode=excluded.mode, required=excluded.required, min_level=excluded.min_level,
          weight=excluded.weight, note=excluded.note`, [id, treeId, p[0].id, c[0].id, rel, mode, o.required === false ? 0 : 1, o.min_level ?? 1, o.weight ?? 1, o.note || "", (0, text_1.nowIso)()]);
         await rebuildClosure(mgr, treeId);
         await logEvent(mgr, "node.link", id, { tree: treeId, parent: parentKey, child: childKey, rel, mode, required: o.required !== false, duplicate });
@@ -256,7 +262,7 @@ async function condAdd(ds, treeId, keyOrId, o) {
         if (!db_1.COND_KINDS.includes(kind))
             throw new Error(`kind must be one of ${db_1.COND_KINDS.join("|")}`);
         const id = (0, text_1.shortId)(["cond", n[0].id, o.name], 12);
-        await mgr.query(`INSERT INTO node_conditions(id,node_id,name,kind,expr,op,value,required,effect,weight,note)
+        await mgr.query(`INSERT INTO node_conditions(id,node_id,name,kind,expr,op,value,required,effect,weight,note)
        VALUES(?,?,?,?,?,?,?,?,?,?,?)`, [id, n[0].id, o.name, kind, o.expr || o.name, o.op || ">=", o.value || "", o.required === false ? 0 : 1, o.effect || "gate", o.weight ?? 1, o.note || ""]);
         await markDirty(mgr, treeId);
         await logEvent(mgr, "node.cond", id, { tree: treeId, node: keyOrId, name: o.name, kind, op: o.op || ">=", required: o.required !== false });
@@ -269,7 +275,7 @@ async function stateSet(ds, treeId, keyOrId, status, context = "default", level
         const n = (await mgr.query(`SELECT id FROM nodes WHERE tree_id=? AND (key=? OR id=?)`, [treeId, keyOrId, keyOrId]));
         if (!n.length)
             throw new Error(`node not found: ${keyOrId}`);
-        await mgr.query(`INSERT INTO node_state(tree_id,context,node_id,status,level,progress,updated) VALUES(?,?,?,?,?,?,?)
+        await mgr.query(`INSERT INTO node_state(tree_id,context,node_id,status,level,progress,updated) VALUES(?,?,?,?,?,?,?)
        ON CONFLICT(tree_id,context,node_id) DO UPDATE SET status=excluded.status, level=excluded.level, updated=excluded.updated`, [treeId, context, n[0].id, status, level, status === "unlocked" ? 1 : 0, (0, text_1.nowIso)()]);
         // R10.1: unlock/lock are the timeline anchors for R11's time axis
         await logEvent(mgr, status === "unlocked" ? "node.unlock" : "node.lock", n[0].id, {
@@ -414,10 +420,10 @@ async function importTree(ds, spec, opts = {}) {
         for (const e of edges) {
             const pid = nodeId.get(String(e.parent));
             const cid = nodeId.get(String(e.child));
-            await mgr.query(`INSERT INTO node_edges(id,tree_id,parent_id,child_id,rel,mode,required,min_level,weight,note,created)
-         VALUES(?,?,?,?,?,?,?,?,?,?,?)
-         ON CONFLICT(parent_id,child_id,rel) DO UPDATE SET
-           mode=excluded.mode, required=excluded.required, min_level=excluded.min_level,
+            await mgr.query(`INSERT INTO node_edges(id,tree_id,parent_id,child_id,rel,mode,required,min_level,weight,note,created)
+         VALUES(?,?,?,?,?,?,?,?,?,?,?)
+         ON CONFLICT(parent_id,child_id,rel) DO UPDATE SET
+           mode=excluded.mode, required=excluded.required, min_level=excluded.min_level,
            weight=excluded.weight, note=excluded.note`, [
                 (0, text_1.shortId)(["edge", tid, pid, cid, String(e.rel)], 12), tid, pid, cid,
                 String(e.rel), String(e.mode || "AND"), e.required === false ? 0 : 1,
@@ -427,7 +433,7 @@ async function importTree(ds, spec, opts = {}) {
         for (const c of conds) {
             const nid = nodeId.get(String(c.node));
             await mgr.query(`DELETE FROM node_conditions WHERE node_id=? AND name=?`, [nid, String(c.name)]);
-            await mgr.query(`INSERT INTO node_conditions(id,node_id,name,kind,expr,op,value,required,effect,weight,note)
+            await mgr.query(`INSERT INTO node_conditions(id,node_id,name,kind,expr,op,value,required,effect,weight,note)
          VALUES(?,?,?,?,?,?,?,?,?,?,?)`, [
                 (0, text_1.shortId)(["cond", tid, nid, String(c.name)], 10), nid, String(c.name),
                 String(c.kind || "flag"), String(c.expr || ""), String(c.op || ">="), String(c.value ?? ""),

package/docs/plugin-authoring.md

@@ -93,3 +93,22 @@ repo-root/
 | `plugin list` 显示 ✗ 不可解析 | `plugin remove <name>` 后重装；或 `doctor` 看 plugin_profile 项 |
 | 启动报 "N plugin issue(s) during startup" | 读终端给出的 report 路径（`$YGL_HOME/logs/startup-*.log`） |
 | 装了命令组不生效 | 命令组在**下次进程启动**时注册（CLI 每命令独立进程，自然生效） |
+
+
+## 事件监听（0.76+）
+
+插件可以通过 Cordis 标准 `ctx.on` 监听跨域事件：
+
+```typescript
+// 监听全部事件
+ctx.on("ygl", (evt) => {
+  console.log(evt.kind, evt.entityId);  // e.g. "node.unlock" "sn123"
+});
+
+// 监听特定类型
+ctx.on("ygl:node.unlock", (evt) => { /* ... */ });
+ctx.on("ygl:kb.add", (evt) => { /* ... */ });
+ctx.on("ygl:claim.resolve", (evt) => { /* ... */ });
+```
+
+事件在 logEvent 落表后即时发出（事件驱动 SSE 同通道）。支持的事件类型见 `packages/core/text/src/eventbus.ts`。

package/llms.txt

@@ -1,4 +1,4 @@
-# ygl-trees v0.74.0 — AI Agent Research Workbench
+# ygl-trees v0.76.1 — AI Agent Research Workbench
 
 > Single SQLite source of truth. Research → Production → Knowledge Reuse + Tech Tree.
 > CLI for AI agents: every command supports --json (machine-readable, including errors).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ygl-trees",
-  "version": "0.75.1",
+  "version": "0.76.1",
   "description": "猿光 · 科技树 — database-centric CLI for research → production → knowledge reuse, built for AI agents.",
   "type": "commonjs",
   "main": "dist/apps/cli/index.js",
@@ -25,10 +25,10 @@
     "node-sqlite3-wasm": "^0.8.61",
     "reflect-metadata": "^0.2.2",
     "typeorm": "^1.1.2",
-    "@deepseek-ai/cordis": "~4.0.5-alpha.2",
-    "@deepseek-ai/schemastery": "~3.18.5-alpha.2",
     "@deepseek-ai/cordis-plugin-timer": "~1.1.7-alpha.2",
-    "@deepseek-ai/cosmokit": "~1.8.6-alpha.2"
+    "@deepseek-ai/cosmokit": "~1.8.6-alpha.2",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2",
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.2"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",