ygl-trees 0.75.1 → 0.76.0

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,6 +24,27 @@ 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) {

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ygl-trees",
-  "version": "0.75.1",
+  "version": "0.76.0",
   "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/cordis": "~4.0.5-alpha.2",
+    "@deepseek-ai/cosmokit": "~1.8.6-alpha.2",
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.2"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",