ygl-trees 0.73.0 → 0.74.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.74.0（2026-10-17）export-markdown + v2 测试 + 技能同步
+- **db export-markdown**：一键生成工作区 Markdown 报告（Summary/Projects/Claims/Knowledge/Trees）
+- **v2 功能测试**：6 项新单测覆盖 time-travel/timeline/workspace/obsidian/help-suggestions/llms-sections
+- **技能同步 v0.73.0**：quickstart/knowledge/research/techtree 全部更新到最新命令面
+- **141 单测**（+6）
+
 ## 0.73.0（2026-10-17）引导增强 + Token 优化 + A2A 修复
 - **首启引导**：无数据库时显示 Welcome + 3 步入门指南
 - **空态引导**：列表为空时显示具体命令建议（kb/project/task）

package/dist/bundle/bin.cjs

@@ -4670,6 +4670,84 @@ function run$12(env, action, rest, args) {
 			});
 			return 0;
 		}
+		case "export-markdown": {
+			const lines = [];
+			lines.push(`# ygl-trees Workspace Report`);
+			lines.push(`> Generated: ${(/* @__PURE__ */ new Date()).toISOString()}`);
+			lines.push("");
+			const counts = {};
+			for (const t of [
+				"projects",
+				"sources",
+				"evidence",
+				"claims",
+				"kb_notes",
+				"skills",
+				"trees",
+				"nodes",
+				"artifacts",
+				"events"
+			]) try {
+				counts[t] = db.get(`SELECT COUNT(*) as n FROM ${t}`)?.n || 0;
+			} catch {
+				counts[t] = 0;
+			}
+			lines.push(`## Summary`);
+			lines.push("");
+			lines.push(`| Entity | Count |`);
+			lines.push(`|---|---|`);
+			const labels = {
+				projects: "项目",
+				sources: "来源",
+				evidence: "证据",
+				claims: "断言",
+				kb_notes: "知识",
+				skills: "技能",
+				trees: "树",
+				nodes: "节点",
+				artifacts: "产出",
+				events: "事件"
+			};
+			for (const [k, v] of Object.entries(counts)) lines.push(`| ${labels[k] || k} | ${v} |`);
+			lines.push("");
+			lines.push(`## Projects`);
+			const projects = db.all("SELECT name, question, created FROM projects ORDER BY created DESC LIMIT 10");
+			for (const p of projects) lines.push(`- **${p.name}**: ${p.question || "(no question)"}`);
+			lines.push("");
+			lines.push(`## Recent Claims`);
+			const claims = db.all("SELECT text, status, confidence FROM claims ORDER BY created DESC LIMIT 10");
+			for (const c of claims) lines.push(`- [${c.status}] ${String(c.text).slice(0, 80)}... (${c.confidence})`);
+			lines.push("");
+			lines.push(`## Knowledge Notes`);
+			const kb = db.all("SELECT title, tags, confidence FROM kb_notes ORDER BY created DESC LIMIT 10");
+			for (const k of kb) lines.push(`- **${String(k.title).slice(0, 50)}** ${k.tags ? `(${k.tags})` : ""} [${k.confidence}]`);
+			lines.push("");
+			lines.push(`## Trees`);
+			const trees = db.all("SELECT name FROM trees");
+			for (const t of trees) {
+				const nodes = db.get("SELECT COUNT(*) as n FROM nodes WHERE tree_id=(SELECT id FROM trees WHERE name=?)", [t.name])?.n || 0;
+				lines.push(`- **${t.name}** (${nodes} nodes)`);
+			}
+			lines.push("");
+			lines.push(`---`);
+			lines.push(`*Auto-generated by ygl-trees db export-markdown*`);
+			const md = lines.join("\n");
+			const outPath = rest[0];
+			if (outPath) {
+				node_fs.writeFileSync(outPath, md);
+				ok(ctx, `markdown report saved: ${outPath} (${md.length} chars)`);
+			} else {
+				if (ctx.json) {
+					console.log(JSON.stringify({
+						markdown: md,
+						chars: md.length
+					}, null, 2));
+					return 0;
+				}
+				out(ctx, md);
+			}
+			return 0;
+		}
 		case "time-travel": {
 			const when = rest[0];
 			if (!when) {

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

@@ -133,6 +133,76 @@ function run(env, action, rest, args) {
             (0, fmt_1.show)(ctx, { file, size_kb: (fs.statSync(file).size / 1024).toFixed(1), ...s });
             return 0;
         }
+        case "export-markdown": {
+            // v2: auto-generated workspace report in markdown
+            const lines = [];
+            lines.push(`# ygl-trees Workspace Report`);
+            lines.push(`> Generated: ${new Date().toISOString()}`);
+            lines.push("");
+            // Metrics
+            const counts = {};
+            for (const t of ["projects", "sources", "evidence", "claims", "kb_notes", "skills", "trees", "nodes", "artifacts", "events"]) {
+                try {
+                    counts[t] = db.get(`SELECT COUNT(*) as n FROM ${t}`)?.n || 0;
+                }
+                catch {
+                    counts[t] = 0;
+                }
+            }
+            lines.push(`## Summary`);
+            lines.push("");
+            lines.push(`| Entity | Count |`);
+            lines.push(`|---|---|`);
+            const labels = { projects: "项目", sources: "来源", evidence: "证据", claims: "断言", kb_notes: "知识", skills: "技能", trees: "树", nodes: "节点", artifacts: "产出", events: "事件" };
+            for (const [k, v] of Object.entries(counts))
+                lines.push(`| ${labels[k] || k} | ${v} |`);
+            lines.push("");
+            // Projects
+            lines.push(`## Projects`);
+            const projects = db.all("SELECT name, question, created FROM projects ORDER BY created DESC LIMIT 10");
+            for (const p of projects) {
+                lines.push(`- **${p.name}**: ${p.question || "(no question)"}`);
+            }
+            lines.push("");
+            // Recent claims
+            lines.push(`## Recent Claims`);
+            const claims = db.all("SELECT text, status, confidence FROM claims ORDER BY created DESC LIMIT 10");
+            for (const c of claims) {
+                lines.push(`- [${c.status}] ${String(c.text).slice(0, 80)}... (${c.confidence})`);
+            }
+            lines.push("");
+            // Knowledge
+            lines.push(`## Knowledge Notes`);
+            const kb = db.all("SELECT title, tags, confidence FROM kb_notes ORDER BY created DESC LIMIT 10");
+            for (const k of kb) {
+                lines.push(`- **${String(k.title).slice(0, 50)}** ${k.tags ? `(${k.tags})` : ""} [${k.confidence}]`);
+            }
+            lines.push("");
+            // Trees
+            lines.push(`## Trees`);
+            const trees = db.all("SELECT name FROM trees");
+            for (const t of trees) {
+                const nodes = db.get("SELECT COUNT(*) as n FROM nodes WHERE tree_id=(SELECT id FROM trees WHERE name=?)", [t.name])?.n || 0;
+                lines.push(`- **${t.name}** (${nodes} nodes)`);
+            }
+            lines.push("");
+            lines.push(`---`);
+            lines.push(`*Auto-generated by ygl-trees db export-markdown*`);
+            const md = lines.join("\n");
+            const outPath = rest[0];
+            if (outPath) {
+                fs.writeFileSync(outPath, md);
+                (0, fmt_1.ok)(ctx, `markdown report saved: ${outPath} (${md.length} chars)`);
+            }
+            else {
+                if (ctx.json) {
+                    console.log(JSON.stringify({ markdown: md, chars: md.length }, null, 2));
+                    return 0;
+                }
+                (0, fmt_1.out)(ctx, md);
+            }
+            return 0;
+        }
         case "time-travel": {
             // v2: query workspace state at a past moment using entity created_at
             const when = rest[0];

package/llms.txt

@@ -1,4 +1,4 @@
-# ygl-trees v0.73.0 — AI Agent Research Workbench
+# ygl-trees v0.74.0 — 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.73.0",
+  "version": "0.74.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/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/schemastery": "~3.18.5-alpha.2"
+    "@deepseek-ai/cosmokit": "~1.8.6-alpha.2"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",