ygl-trees 0.69.0 → 0.71.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.70.0（2026-10-17）`agent metrics`——从 R11 手动测量到自动化指标
+- **`ygl-trees agent metrics`**：一条命令输出工作台全量量化指标——冷启动（brief 耗时/next actions/可用技能）、知识（总量/7日增长/增长率）、研究（来源/证据/断言/验证率/证据密度）、技能（总数/命中/均命中）、科技树（棵数/节点/解锁率）、活动（7 日 events）
+- **来源**：R11 冷启动量化研究的手动测量 → 自动化——从 `time agent brief` + 手动 grep 统计变为一键输出
+- 135 单测全绿
+
 ## 0.69.0（2026-10-17）MCP Server——R8 研究设计的工程落地
 - **`ygl-trees mcp`**：启动 stdio MCP 服务器（JSON-RPC 2.0），Claude Desktop / Cursor / VS Code 等 IDE Agent 可直接连接
 - **8 工具面**（三支柱理论驱动）：agent_brief · agent_match · kb_search · claim_evaluate · tree_state · produce_report · doctor · task_advance

package/dist/bundle/bin.cjs

@@ -5351,6 +5351,72 @@ function buildBrief(env) {
 function run$9(env, action, rest, args) {
 	const { ctx, store } = env;
 	switch (action) {
+		case "metrics": {
+			const t0 = Date.now();
+			const brief = buildBrief(env);
+			const briefMs = Date.now() - t0;
+			const kbTotal = env.db.get("SELECT COUNT(*) AS n FROM kb_notes")?.n || 0;
+			const kbRecent = env.db.get("SELECT COUNT(*) AS n FROM kb_notes WHERE created > datetime('now', '-7 days')")?.n || 0;
+			const claims = env.db.get("SELECT COUNT(*) AS n FROM claims")?.n || 0;
+			const claimsVerified = env.db.get("SELECT COUNT(*) AS n FROM claims WHERE status='supported'")?.n || 0;
+			const evidence = env.db.get("SELECT COUNT(*) AS n FROM evidence")?.n || 0;
+			const sources = env.db.get("SELECT COUNT(*) AS n FROM sources")?.n || 0;
+			const skills = store.skillList();
+			const skillHits = skills.reduce((s, x) => s + (x.hits || 0), 0);
+			const trees = env.db.all("SELECT id, name FROM trees");
+			let nodesTotal = 0, nodesUnlocked = 0;
+			for (const t of trees) {
+				const r = env.db.get("SELECT COUNT(*) AS total, SUM(CASE WHEN ns.status='unlocked' THEN 1 ELSE 0 END) AS unlocked FROM nodes n LEFT JOIN node_state ns ON ns.node_id=n.id AND ns.context='default' WHERE n.tree_id=?", [t.id]);
+				nodesTotal += r?.total || 0;
+				nodesUnlocked += r?.unlocked || 0;
+			}
+			const events7d = env.db.get("SELECT COUNT(*) AS n FROM events WHERE ts > datetime('now', '-7 days')")?.n || 0;
+			const metrics = {
+				cold_start: {
+					brief_ms: briefMs,
+					next_actions: brief.next_actions?.length || 0,
+					skills_available: skills.length
+				},
+				knowledge: {
+					total_notes: kbTotal,
+					recent_7d: kbRecent,
+					growth_rate_7d: kbTotal > 0 ? Math.round(kbRecent / kbTotal * 100) : 0
+				},
+				research: {
+					sources,
+					evidence,
+					claims,
+					verified_claims: claimsVerified,
+					verification_rate: claims > 0 ? Math.round(claimsVerified / claims * 100) : 0,
+					evidence_per_claim: claims > 0 ? (evidence / claims).toFixed(1) : "0"
+				},
+				skills: {
+					total: skills.length,
+					total_hits: skillHits,
+					avg_hits: skills.length > 0 ? (skillHits / skills.length).toFixed(1) : "0"
+				},
+				trees: {
+					total_trees: trees.length,
+					nodes: nodesTotal,
+					unlocked: nodesUnlocked,
+					unlock_rate: nodesTotal > 0 ? Math.round(nodesUnlocked / nodesTotal * 100) : 0
+				},
+				activity: { events_7d: events7d },
+				doctor: "run `doctor` for health checks"
+			};
+			if (ctx.json) {
+				console.log(JSON.stringify(metrics, null, 2));
+				return 0;
+			}
+			head(ctx, "ygl-trees metrics");
+			out(ctx, `  冷启动     brief ${metrics.cold_start.brief_ms}ms · ${metrics.cold_start.next_actions} next actions · ${metrics.cold_start.skills_available} skills`);
+			out(ctx, `  知识       ${metrics.knowledge.total_notes} notes (${metrics.knowledge.recent_7d} in 7d, ${metrics.knowledge.growth_rate_7d}% growth)`);
+			out(ctx, `  研究       ${metrics.research.sources} sources · ${metrics.research.evidence} evidence · ${metrics.research.verified_claims}/${metrics.research.claims} verified (${metrics.research.verification_rate}%)`);
+			out(ctx, `  技能       ${metrics.skills.total} skills · ${metrics.skills.total_hits} hits (avg ${metrics.skills.avg_hits})`);
+			out(ctx, `  科技树     ${metrics.trees.total_trees} trees · ${metrics.trees.unlocked}/${metrics.trees.nodes} unlocked (${metrics.trees.unlock_rate}%)`);
+			out(ctx, `  活动       ${metrics.activity.events_7d} events in 7d`);
+			return 0;
+		}
 		case "brief": {
 			const payload = buildBrief(env);
 			const cur = payload.current_project;
@@ -9090,6 +9156,61 @@ function gatherData(env) {
 			}));
 		}
 	}
+	const kgEdges = [];
+	const kgMap = /* @__PURE__ */ new Map();
+	try {
+		const rels = db.all("SELECT src_type, src_id, dst_type, dst_id, rel FROM relations LIMIT 200");
+		const colors = {
+			node: "#7c9885",
+			claim: "#6a994e",
+			kb: "#8b7355",
+			evidence: "#daa520",
+			artifact: "#5b8db8",
+			skill: "#9b7cb8"
+		};
+		for (const r of rels) {
+			for (const side of ["src", "dst"]) {
+				const type = r[`${side}_type`];
+				const id = r[`${side}_id`];
+				const key = `${type}:${id}`;
+				if (kgMap.has(key)) continue;
+				let label = id;
+				try {
+					if (type === "node") {
+						const n = db.get("SELECT name FROM nodes WHERE id=?", [id]);
+						if (n) label = n.name;
+					} else if (type === "claim") {
+						const c = db.get("SELECT substr(text,1,40) AS t FROM claims WHERE id=?", [id]);
+						if (c) label = c.t;
+					} else if (type === "kb") {
+						const k = db.get("SELECT title FROM kb_notes WHERE id=?", [id]);
+						if (k) label = k.title.slice(0, 40);
+					} else if (type === "evidence") {
+						const e = db.get("SELECT substr(quote,1,40) AS q FROM evidence WHERE id=?", [id]);
+						if (e) label = e.q;
+					} else if (type === "artifact") {
+						const a = db.get("SELECT title FROM artifacts WHERE id=?", [id]);
+						if (a) label = a.title;
+					}
+				} catch {}
+				kgMap.set(key, {
+					id: key,
+					label,
+					type,
+					color: colors[type] || "#999"
+				});
+			}
+			kgEdges.push({
+				source: `${r.src_type}:${r.src_id}`,
+				target: `${r.dst_type}:${r.dst_id}`,
+				label: r.rel
+			});
+		}
+	} catch {}
+	data.knowledge_graph = {
+		nodes: Array.from(kgMap.values()),
+		edges: kgEdges
+	};
 	return data;
 }
 /** Single-file dashboard HTML. `live` adds a fetch bootstrap + auto-refresh. */

package/dist/packages/ops/tools/src/agent-cmds.js

@@ -74,6 +74,78 @@ function buildBrief(env) {
 function run(env, action, rest, args) {
     const { ctx, store } = env;
     switch (action) {
+        case "metrics": {
+            // R11 cold-start research → automated measurement. Health/efficiency
+            // metrics for the workspace — one command answers "how good is this
+            // workbench?" with quantified data.
+            const t0 = Date.now();
+            const brief = buildBrief(env);
+            const briefMs = Date.now() - t0;
+            // Knowledge metrics
+            const kbTotal = env.db.get("SELECT COUNT(*) AS n FROM kb_notes")?.n || 0;
+            const kbRecent = env.db.get("SELECT COUNT(*) AS n FROM kb_notes WHERE created > datetime('now', '-7 days')")?.n || 0;
+            // Research metrics
+            const claims = env.db.get("SELECT COUNT(*) AS n FROM claims")?.n || 0;
+            const claimsVerified = env.db.get("SELECT COUNT(*) AS n FROM claims WHERE status='supported'")?.n || 0;
+            const evidence = env.db.get("SELECT COUNT(*) AS n FROM evidence")?.n || 0;
+            const sources = env.db.get("SELECT COUNT(*) AS n FROM sources")?.n || 0;
+            // Skill metrics
+            const skills = store.skillList();
+            const skillHits = skills.reduce((s, x) => s + (x.hits || 0), 0);
+            // Tree metrics
+            const trees = env.db.all("SELECT id, name FROM trees");
+            let nodesTotal = 0, nodesUnlocked = 0;
+            for (const t of trees) {
+                const r = env.db.get("SELECT COUNT(*) AS total, SUM(CASE WHEN ns.status='unlocked' THEN 1 ELSE 0 END) AS unlocked FROM nodes n LEFT JOIN node_state ns ON ns.node_id=n.id AND ns.context='default' WHERE n.tree_id=?", [t.id]);
+                nodesTotal += r?.total || 0;
+                nodesUnlocked += r?.unlocked || 0;
+            }
+            // Event metrics
+            const events7d = env.db.get("SELECT COUNT(*) AS n FROM events WHERE ts > datetime('now', '-7 days')")?.n || 0;
+            const metrics = {
+                cold_start: {
+                    brief_ms: briefMs,
+                    next_actions: brief.next_actions?.length || 0,
+                    skills_available: skills.length,
+                },
+                knowledge: {
+                    total_notes: kbTotal,
+                    recent_7d: kbRecent,
+                    growth_rate_7d: kbTotal > 0 ? Math.round(kbRecent / kbTotal * 100) : 0,
+                },
+                research: {
+                    sources, evidence, claims,
+                    verified_claims: claimsVerified,
+                    verification_rate: claims > 0 ? Math.round(claimsVerified / claims * 100) : 0,
+                    evidence_per_claim: claims > 0 ? (evidence / claims).toFixed(1) : "0",
+                },
+                skills: {
+                    total: skills.length,
+                    total_hits: skillHits,
+                    avg_hits: skills.length > 0 ? (skillHits / skills.length).toFixed(1) : "0",
+                },
+                trees: {
+                    total_trees: trees.length,
+                    nodes: nodesTotal,
+                    unlocked: nodesUnlocked,
+                    unlock_rate: nodesTotal > 0 ? Math.round(nodesUnlocked / nodesTotal * 100) : 0,
+                },
+                activity: { events_7d: events7d },
+                doctor: "run `doctor` for health checks",
+            };
+            if (ctx.json) {
+                console.log(JSON.stringify(metrics, null, 2));
+                return 0;
+            }
+            (0, fmt_1.head)(ctx, "ygl-trees metrics");
+            (0, fmt_1.out)(ctx, `  冷启动     brief ${metrics.cold_start.brief_ms}ms · ${metrics.cold_start.next_actions} next actions · ${metrics.cold_start.skills_available} skills`);
+            (0, fmt_1.out)(ctx, `  知识       ${metrics.knowledge.total_notes} notes (${metrics.knowledge.recent_7d} in 7d, ${metrics.knowledge.growth_rate_7d}% growth)`);
+            (0, fmt_1.out)(ctx, `  研究       ${metrics.research.sources} sources · ${metrics.research.evidence} evidence · ${metrics.research.verified_claims}/${metrics.research.claims} verified (${metrics.research.verification_rate}%)`);
+            (0, fmt_1.out)(ctx, `  技能       ${metrics.skills.total} skills · ${metrics.skills.total_hits} hits (avg ${metrics.skills.avg_hits})`);
+            (0, fmt_1.out)(ctx, `  科技树     ${metrics.trees.total_trees} trees · ${metrics.trees.unlocked}/${metrics.trees.nodes} unlocked (${metrics.trees.unlock_rate}%)`);
+            (0, fmt_1.out)(ctx, `  活动       ${metrics.activity.events_7d} events in 7d`);
+            return 0;
+        }
         case "brief": {
             const payload = buildBrief(env);
             const cur = payload.current_project;

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

@@ -145,6 +145,59 @@ function gatherData(env) {
                 .map((r) => ({ id: r.id, kind: r.kind, title: r.title, version: r.version, created: r.created }));
         }
     }
+    // R19: knowledge graph — entities and relations from the rel fabric
+    const kgNodes = [];
+    const kgEdges = [];
+    const kgMap = new Map();
+    try {
+        const rels = db.all("SELECT src_type, src_id, dst_type, dst_id, rel FROM relations LIMIT 200");
+        const colors = {
+            node: "#7c9885", claim: "#6a994e", kb: "#8b7355",
+            evidence: "#daa520", artifact: "#5b8db8", skill: "#9b7cb8",
+        };
+        for (const r of rels) {
+            for (const side of ["src", "dst"]) {
+                const type = r[`${side}_type`];
+                const id = r[`${side}_id`];
+                const key = `${type}:${id}`;
+                if (kgMap.has(key))
+                    continue;
+                let label = id;
+                try {
+                    if (type === "node") {
+                        const n = db.get("SELECT name FROM nodes WHERE id=?", [id]);
+                        if (n)
+                            label = n.name;
+                    }
+                    else if (type === "claim") {
+                        const c = db.get("SELECT substr(text,1,40) AS t FROM claims WHERE id=?", [id]);
+                        if (c)
+                            label = c.t;
+                    }
+                    else if (type === "kb") {
+                        const k = db.get("SELECT title FROM kb_notes WHERE id=?", [id]);
+                        if (k)
+                            label = k.title.slice(0, 40);
+                    }
+                    else if (type === "evidence") {
+                        const e = db.get("SELECT substr(quote,1,40) AS q FROM evidence WHERE id=?", [id]);
+                        if (e)
+                            label = e.q;
+                    }
+                    else if (type === "artifact") {
+                        const a = db.get("SELECT title FROM artifacts WHERE id=?", [id]);
+                        if (a)
+                            label = a.title;
+                    }
+                }
+                catch { /* best-effort */ }
+                kgMap.set(key, { id: key, label, type, color: colors[type] || "#999" });
+            }
+            kgEdges.push({ source: `${r.src_type}:${r.src_id}`, target: `${r.dst_type}:${r.dst_id}`, label: r.rel });
+        }
+    }
+    catch { /* graph data best-effort */ }
+    data.knowledge_graph = { nodes: Array.from(kgMap.values()), edges: kgEdges };
     return data;
 }
 /** Single-file dashboard HTML. `live` adds a fetch bootstrap + auto-refresh. */

package/package.json

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