ygl-trees 0.69.0 → 0.70.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;

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

@@ -1,6 +1,6 @@
 {
   "name": "ygl-trees",
-  "version": "0.69.0",
+  "version": "0.70.0",
   "description": "猿光 · 科技树 — database-centric CLI for research → production → knowledge reuse, built for AI agents.",
   "type": "commonjs",
   "main": "dist/apps/cli/index.js",
@@ -25,9 +25,9 @@
     "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/schemastery": "~3.18.5-alpha.2",
     "@deepseek-ai/cosmokit": "~1.8.6-alpha.2",
-    "@deepseek-ai/schemastery": "~3.18.5-alpha.2"
+    "@deepseek-ai/cordis-plugin-timer": "~1.1.7-alpha.2"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",