ygl-trees 0.76.0 → 0.76.1

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.76.1（2026-10-17）--ai 多 Agent 支持 + ctx.emit 桥接
+- **skill link --ai <agent>**：一键连接到多种 AI Agent 的技能目录——pi(~/.pi/agent/skills/) · claude · cursor · windsurf · custom(--to)
+- **ctx.emit 桥接**：eventbus 内部事件自动转发到 Cordis ctx.emit——插件可用 ctx.on("ygl") 监听（文档承诺兑现）
+- **plugin-authoring.md**：补 ctx.on 事件监听用法
+
 ## 0.76.0（2026-10-17）Cordis 深化——生命周期+事件驱动（A2A 任务 fedc7ab9）
 - **生命周期真实化**：DatabaseService 补 stop() 钩子（关 SQLite + 释放 .ygllock + 关 ORM）；bin.ts finally 走 Service.stop() 链（fallback DB 仍手动收口）；3 项单测证明 boot→stop 后资源释放
 - **事件驱动真实化**：新建 eventbus（EventEmitter 单例）；logEvent 落表后同步 emitEvent（node.unlock/kb.add/claim.resolve 等）；webui SSE 升级为事件驱动即时推送（1.5s 轮询保留为兜底）

package/README.md

@@ -163,7 +163,7 @@ agent brief               状态 + 建议动作 + 健康度（脏索引、存量
 
 `skill import <SKILL.md>` 直接解析 frontmatter。
 
-`skill link [--global]` 一键软连接到 `.agents/skills/`（DSH/Claude 等 Agent 的技能发现路径即刻可用）。
+`skill link [--global] [--ai pi|claude|cursor|windsurf]` 一键软连接到 `.agents/skills/`（DSH/Claude 等 Agent 的技能发现路径即刻可用）。
 
 ### rel：关联织物（把研究资产挂到树节点）
 

package/dist/bundle/bin.cjs

@@ -12,11 +12,11 @@ let node_crypto = require("node:crypto");
 let _deepseek_ai_cordis = require("@deepseek-ai/cordis");
 require("reflect-metadata");
 let typeorm = require("typeorm");
+let node_events = require("node:events");
 let _deepseek_ai_cordis_plugin_timer = require("@deepseek-ai/cordis-plugin-timer");
 _deepseek_ai_cordis_plugin_timer = require_rolldown_runtime.__toESM(_deepseek_ai_cordis_plugin_timer);
 let node_child_process = require("node:child_process");
 let _deepseek_ai_dsh_atomic_write = require("@deepseek-ai/dsh-atomic-write");
-let node_events = require("node:events");
 let _deepseek_ai_schemastery = require("@deepseek-ai/schemastery");
 _deepseek_ai_schemastery = require_rolldown_runtime.__toESM(_deepseek_ai_schemastery);
 //#region packages/core/text/src/text.ts
@@ -1477,6 +1477,45 @@ var init_orm = require_rolldown_runtime.__esmMin((() => {
 	cached = null;
 }));
 //#endregion
+//#region packages/core/text/src/eventbus.ts
+/**
+* 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
+*/
+var eventbus_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
+	emitEvent: () => emitEvent,
+	onEvent: () => onEvent,
+	onEventKind: () => onEventKind
+});
+/** Publish a cross-domain event (called after events table write). */
+function emitEvent(evt) {
+	bus.emit("ygl", evt);
+	bus.emit(`ygl:${evt.kind}`, evt);
+}
+/** 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);
+}
+var bus;
+var init_eventbus = require_rolldown_runtime.__esmMin((() => {
+	bus = new node_events.EventEmitter();
+	bus.setMaxListeners(50);
+}));
+//#endregion
 //#region packages/core/database/src/plugin.ts
 /**
 * DatabasePlugin — provides ctx.database (DatabaseService).
@@ -1509,6 +1548,36 @@ var DatabaseService = class extends _deepseek_ai_cordis.Service {
 };
 function apply$3(ctx, config) {
 	new DatabaseService(ctx, config.file);
+	try {
+		const { onEvent, onEventKind } = (init_eventbus(), require_rolldown_runtime.__toCommonJS(eventbus_exports));
+		const kindSubs = [onEvent((evt) => {
+			try {
+				ctx.emit("ygl", evt);
+			} catch {}
+		})];
+		for (const kind of [
+			"node.unlock",
+			"node.lock",
+			"node.add",
+			"node.link",
+			"kb.add",
+			"kb.rm",
+			"claim.resolve",
+			"claim.add",
+			"task.status",
+			"project.new",
+			"skill.add"
+		]) kindSubs.push(onEventKind(kind, (evt) => {
+			try {
+				ctx.emit(`ygl:${kind}`, evt);
+			} catch {}
+		}));
+		ctx.fiber?.collect?.(() => {
+			for (const u of kindSubs) try {
+				u();
+			} catch {}
+		});
+	} catch {}
 }
 //#endregion
 //#region packages/web/app/src/index.ts
@@ -3989,45 +4058,6 @@ function preflightTypeCheck(db) {
 	return issues;
 }
 //#endregion
-//#region packages/core/text/src/eventbus.ts
-/**
-* 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
-*/
-var eventbus_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
-	emitEvent: () => emitEvent,
-	onEvent: () => onEvent,
-	onEventKind: () => onEventKind
-});
-/** Publish a cross-domain event (called after events table write). */
-function emitEvent(evt) {
-	bus.emit("ygl", evt);
-	bus.emit(`ygl:${evt.kind}`, evt);
-}
-/** 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);
-}
-var bus;
-var init_eventbus = require_rolldown_runtime.__esmMin((() => {
-	bus = new node_events.EventEmitter();
-	bus.setMaxListeners(50);
-}));
-//#endregion
 //#region packages/research/pipeline/src/writes.ts
 var writes_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	artifactAdd: () => artifactAdd,
@@ -8825,7 +8855,23 @@ function run$4(env, action, rest, args) {
 			return 0;
 		case "link": {
 			const os = require("node:os");
-			const targetDir = args?.flags?.global === true ? node_path.join(os.homedir(), ".agents", "skills") : node_path.join(process.cwd(), ".agents", "skills");
+			const globalFlag = args?.flags?.global === true;
+			const aiName = String(args?.flags?.ai || "").toLowerCase();
+			const customTo = String(args?.flags?.to || "");
+			const AI_SKILL_DIRS = {
+				pi: () => node_path.join(os.homedir(), ".pi", "agent", "skills"),
+				claude: () => node_path.join(os.homedir(), ".claude", "skills"),
+				cursor: () => node_path.join(os.homedir(), ".cursor", "skills"),
+				windsurf: () => node_path.join(os.homedir(), ".windsurf", "skills")
+			};
+			let targetDir;
+			if (customTo) targetDir = node_path.resolve(customTo);
+			else if (aiName && AI_SKILL_DIRS[aiName]) targetDir = AI_SKILL_DIRS[aiName]();
+			else if (aiName && aiName !== "custom") {
+				bad(ctx, `unknown AI agent: ${aiName}`);
+				out(ctx, `  supported: ${Object.keys(AI_SKILL_DIRS).join(", ")} | custom (with --to <path>)`);
+				return 2;
+			} else targetDir = globalFlag ? node_path.join(os.homedir(), ".agents", "skills") : node_path.join(process.cwd(), ".agents", "skills");
 			let skillsDir = null;
 			for (let dir = process.cwd(), i = 0; i < 6; i++, dir = node_path.dirname(dir)) {
 				const candidate = node_path.join(dir, "skills");

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

@@ -49,4 +49,36 @@ class DatabaseService extends cordis_1.Service {
 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/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/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.76.0",
+  "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",
@@ -26,8 +26,8 @@
     "reflect-metadata": "^0.2.2",
     "typeorm": "^1.1.2",
     "@deepseek-ai/cordis-plugin-timer": "~1.1.7-alpha.2",
-    "@deepseek-ai/cordis": "~4.0.5-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": {