ygl-trees 0.68.0 → 0.69.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 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
+- **每个工具继承 CLI 冻结契约**（幂等写入、JSON 纯净、snake_case）——Agent 调用工具不需要解析命令行
+- **实现**：`packages/ops/tools/src/mcp.ts`——readline stdio + JSON-RPC 路由 + `cliJson()` 子进程调用（`process.argv[1]` 自引用，bundle/源码双兼容）
+- 实测：initialize ✓ · tools/list(8) ✓ · agent_brief(project) ✓ · kb_search(CJK 命中) ✓ · doctor(9 项) ✓
+
 ## 0.68.0（2026-10-17）锁设计修复——serve/CLI 共存 + PID 活锁检测 + JSON 纯净 + v9 时间纪律
 - **F1（P0）：webui serve 不再持排他锁**——原实现进程级锁让 serve 生命周期内挡掉一切 CLI 命令；现 serve 跳过锁（`YGL_SERVE=1` 旁路），SQLite WAL 天然支持并发读 + 序列化写；CLI 短命令仍锁（单写者保护写窗口）
 - **P1（用户反馈）：PID 活锁检测替代 15 分钟 mtime**——Windows 上 `process.on("exit")` 的 rmSync 句柄未释放时静默失败→锁残留→下进程撞白锁；现用 `process.kill(pid, 0)` 探测持有者是否存活（EPERM=活/ESRCH=死），死 PID **立即清锁**（不看 mtime），活 PID **如实报告**（不误报 stale）

package/dist/apps/cli/src/bin.js

@@ -116,132 +116,132 @@ function appVersion() {
 }
 // ── Usage text ──
 // (kept in apps/cli because it's presentation, not domain logic)
-const USAGE = `
-${(0, fmt_1.paint)(fmt_1.C.bold, "ygl-trees", true)}  猿光 · 科技树
-${(0, fmt_1.paint)(fmt_1.C.dim, "database-centric CLI: research → production → knowledge reuse", true)}
-
-  ygl-trees <group> <action> [args] [options]        add --json for machine output
-
-${(0, fmt_1.paint)(fmt_1.C.bold, "config", true)}      user-tunable settings (registry defaults + overrides)
-  list                       all keys: value + default + note
-  get <key>                  resolved value (config table > default)
-  set <key> <value>          validated against registry (type/range); events logged
-  reset <key>                drop override → back to default
-
-${(0, fmt_1.paint)(fmt_1.C.bold, "db", true)}
-  init                       create the workspace + schema
-  stats                      row counts per table
-  path                       print the database file path
-  export <file.sql> [--lean] dump ALL data tables (+ summary); --lean skips derived
-  sync pg <url>              one-way full mirror to PostgreSQL (L1, see docs/pg-compat.md)
-  migrate pg <url> [--fresh] one-time full-fidelity graduation (constraints + data, atomic)
-  dups                       list duplicate-content rows
-  reset                      delete the database (asks nothing, be careful)
-  sql "<sql>"                ad-hoc statement (can mutate — power tool, no guardrails)
-
-${(0, fmt_1.paint)(fmt_1.C.bold, "skill", true)}        L1 description / L2 body / L3 references
-  import <file.md>           import a SKILL.md (frontmatter = L1, body = L2)
-  add                        --name --description --body [-f file.md]
-  list | show <name> | rm <name> | enable <name> | disable <name>
-  match "<query>"            full-text match, prints L1 candidates for an agent
-  refs add <skill> <path> --body ...
-
-${(0, fmt_1.paint)(fmt_1.C.bold, "project", true)}
-  new <name> -q "<question>"  create + select
-  list | use <name> | show
-
-${(0, fmt_1.paint)(fmt_1.C.bold, "research", true)}    collect → screen → extract → claim
-  query add "<text>"          register a search query
-  query attach <qid> <sid>    link source to query (recalled count)
-  query list
-  source add --title --url [--abstract --content --relevance --confidence --query]
-  source fetch <url>          fetch page, extract title/meta/text (zero side-effect on failure)
-  source list | search "<q>" | show <id> | rm <id>
-  evidence add <sourceId> --quote "..." [--note --locator]
-  evidence list
-  claim add "<text>" [--confidence A|B|C]
-  claim link <claimId> <evidenceId> [--stance supports|refutes]
-  claim resolve <claimId> --as supported|refuted|contested [--note]
-  claim list
-
-${(0, fmt_1.paint)(fmt_1.C.bold, "produce", true)}     outline → section → report · spec/design（工程产出）
-  outline                    auto-outline from claims
-  section <title> --body|-f  add a section artifact
-  report                     assemble claims+evidence+sections into a report
-  spec <title> --body|-f     requirements spec artifact (R12)
-  design <title> --body|-f   design artifact (R12) --design-type ui-ux|arch|decision
-  list | show <id> | export <id> <file>
-
-${(0, fmt_1.paint)(fmt_1.C.bold, "task", true)}          任务清单（todo|doing|done 状态机，R12）
-  add "<title>" [--note ...] create a task (status todo)
-  list [--status todo|doing|done]
-  doing|done <id>            move along the state machine（勾销全程留痕）
-
-${(0, fmt_1.paint)(fmt_1.C.bold, "kb", true)}          long-term knowledge
-  add --title --body|-f [--tags --confidence]
-  import <dir|file.md>       batch markdown (frontmatter, idempotent, single tx)
-  search "<q>" | list | show <id>
-  link <a> <b> [--rel]
-  ingest <artifactId>        import a finished artifact
-  promote <noteId> [--name]  turn a note into a reusable skill
-
-${(0, fmt_1.paint)(fmt_1.C.bold, "job", true)}         batch + schedule (drive with cron: job tick)
-  add <title> -- <command> [--every <min>] [--at "YYYY-MM-DD HH:MM"]
-  list | run <id> | tick | enable <id> | disable <id> | logs
-
-${(0, fmt_1.paint)(fmt_1.C.bold, "tree / node", true)}   tech-tree node model
-  tree new <name> [--project p]      create a tree (nodes live in it)
-  tree list | tree use <name>
-
-  node add <key> [--name --kind --tier --cost --tags --payload]
-  node link <parent> <child>         [--rel prereq|unlock|excludes|enables]
-                                      [--mode AND|OR|XOR|NOT] [--optional]
-                                      [--min-level n] [--weight n]
-  node unlink <parent> <child> [--rel prereq]
-  node cond <key> --name <c>         [--kind flag|resource|level|quest|time|expr]
-                                      [--op >=|==|<=|!=|has] [--value v] [--optional]
-                                      [--op eval --value "<布尔问题>"]
-                                      [--op eval-choice --value "<问题>" --options "k=desc,..." --answer k]
-                                      [--op eval-score --value "<问题>" --levels "级0,..." --min-score n]
-                                      [--effect gate|cost_mul] [--weight n]
-  node index                         rebuild closure + topo order
-  node can <key> [--state k=v]       evaluate required vs optional gates
-                                     (--eval: eval 题型经决策模型判定；
-                                      boolean P / choice P(期望答案) / score ±1 灰带)
-  node ready [--state k=v] [--eval]  currently unlockable set
-  node path <key>                    dependency-order path to target (all locked ancestors; OR branches not optimized)
-  node parents|children <key>        direct relations
-  node ancestors|descendants <key>   transitive, via closure index
-  node list | show <key> | search "<q>" | unlock|lock <key>
-  node validate                      cycles, dangling edges, dirty index
-  node export [--out file.json]      portable JSON
-  node import --file <file.json>     [--tree name] [--merge] — strict, transactional
-
-  Writes are idempotent (claim/evidence/query/kb/job dedupe by content
-  hash); pass --force to keep a deliberate duplicate.
-
-${(0, fmt_1.paint)(fmt_1.C.bold, "webui", true)}            dashboard (zero-dependency)
-  export [--out <file>]     single-file dashboard.html (open in browser)
-  serve [--port N]          live dashboard at http://127.0.0.1:N/ (Ctrl+C to stop)
-
-${(0, fmt_1.paint)(fmt_1.C.bold, "rel", true)}             关联织物（spec R9：任意两类实体互相挂接）
-  add <src> <dst> [--rel t]   link two refs: node:key claim:id kb:id artifact:id
-                             skill:name evidence:id source:id query:id
-  rm <src> <dst> [--rel t]    unlink
-  list [--src r] [--dst r]    browse (either side filter, resolves displays)
-
-${(0, fmt_1.paint)(fmt_1.C.bold, "plugin", true)}          用户层插件分发（spec R14 L3，业务域扩展位）
-  init                       create $YGL_HOME/plugins profile
-  install <spec>             npm package / git url / local dir (auto link:)
-  remove <name> | list       manage the user layer ($YGL_HOME/ygl.user.bundle.json)
-  插件契约：export apply(ctx,config) + 可选 commands 贡献 CLI 命令组
-
-${(0, fmt_1.paint)(fmt_1.C.bold, "agent", true)}       agent-facing views
-  brief                      current project state + next actions (start here)
-  match "<task>"             which skill should handle this task
-  log                        recent events
-
-Global: --json  --no-color  --db <file>  --home <dir>
+const USAGE = `
+${(0, fmt_1.paint)(fmt_1.C.bold, "ygl-trees", true)}  猿光 · 科技树
+${(0, fmt_1.paint)(fmt_1.C.dim, "database-centric CLI: research → production → knowledge reuse", true)}
+
+  ygl-trees <group> <action> [args] [options]        add --json for machine output
+
+${(0, fmt_1.paint)(fmt_1.C.bold, "config", true)}      user-tunable settings (registry defaults + overrides)
+  list                       all keys: value + default + note
+  get <key>                  resolved value (config table > default)
+  set <key> <value>          validated against registry (type/range); events logged
+  reset <key>                drop override → back to default
+
+${(0, fmt_1.paint)(fmt_1.C.bold, "db", true)}
+  init                       create the workspace + schema
+  stats                      row counts per table
+  path                       print the database file path
+  export <file.sql> [--lean] dump ALL data tables (+ summary); --lean skips derived
+  sync pg <url>              one-way full mirror to PostgreSQL (L1, see docs/pg-compat.md)
+  migrate pg <url> [--fresh] one-time full-fidelity graduation (constraints + data, atomic)
+  dups                       list duplicate-content rows
+  reset                      delete the database (asks nothing, be careful)
+  sql "<sql>"                ad-hoc statement (can mutate — power tool, no guardrails)
+
+${(0, fmt_1.paint)(fmt_1.C.bold, "skill", true)}        L1 description / L2 body / L3 references
+  import <file.md>           import a SKILL.md (frontmatter = L1, body = L2)
+  add                        --name --description --body [-f file.md]
+  list | show <name> | rm <name> | enable <name> | disable <name>
+  match "<query>"            full-text match, prints L1 candidates for an agent
+  refs add <skill> <path> --body ...
+
+${(0, fmt_1.paint)(fmt_1.C.bold, "project", true)}
+  new <name> -q "<question>"  create + select
+  list | use <name> | show
+
+${(0, fmt_1.paint)(fmt_1.C.bold, "research", true)}    collect → screen → extract → claim
+  query add "<text>"          register a search query
+  query attach <qid> <sid>    link source to query (recalled count)
+  query list
+  source add --title --url [--abstract --content --relevance --confidence --query]
+  source fetch <url>          fetch page, extract title/meta/text (zero side-effect on failure)
+  source list | search "<q>" | show <id> | rm <id>
+  evidence add <sourceId> --quote "..." [--note --locator]
+  evidence list
+  claim add "<text>" [--confidence A|B|C]
+  claim link <claimId> <evidenceId> [--stance supports|refutes]
+  claim resolve <claimId> --as supported|refuted|contested [--note]
+  claim list
+
+${(0, fmt_1.paint)(fmt_1.C.bold, "produce", true)}     outline → section → report · spec/design（工程产出）
+  outline                    auto-outline from claims
+  section <title> --body|-f  add a section artifact
+  report                     assemble claims+evidence+sections into a report
+  spec <title> --body|-f     requirements spec artifact (R12)
+  design <title> --body|-f   design artifact (R12) --design-type ui-ux|arch|decision
+  list | show <id> | export <id> <file>
+
+${(0, fmt_1.paint)(fmt_1.C.bold, "task", true)}          任务清单（todo|doing|done 状态机，R12）
+  add "<title>" [--note ...] create a task (status todo)
+  list [--status todo|doing|done]
+  doing|done <id>            move along the state machine（勾销全程留痕）
+
+${(0, fmt_1.paint)(fmt_1.C.bold, "kb", true)}          long-term knowledge
+  add --title --body|-f [--tags --confidence]
+  import <dir|file.md>       batch markdown (frontmatter, idempotent, single tx)
+  search "<q>" | list | show <id>
+  link <a> <b> [--rel]
+  ingest <artifactId>        import a finished artifact
+  promote <noteId> [--name]  turn a note into a reusable skill
+
+${(0, fmt_1.paint)(fmt_1.C.bold, "job", true)}         batch + schedule (drive with cron: job tick)
+  add <title> -- <command> [--every <min>] [--at "YYYY-MM-DD HH:MM"]
+  list | run <id> | tick | enable <id> | disable <id> | logs
+
+${(0, fmt_1.paint)(fmt_1.C.bold, "tree / node", true)}   tech-tree node model
+  tree new <name> [--project p]      create a tree (nodes live in it)
+  tree list | tree use <name>
+
+  node add <key> [--name --kind --tier --cost --tags --payload]
+  node link <parent> <child>         [--rel prereq|unlock|excludes|enables]
+                                      [--mode AND|OR|XOR|NOT] [--optional]
+                                      [--min-level n] [--weight n]
+  node unlink <parent> <child> [--rel prereq]
+  node cond <key> --name <c>         [--kind flag|resource|level|quest|time|expr]
+                                      [--op >=|==|<=|!=|has] [--value v] [--optional]
+                                      [--op eval --value "<布尔问题>"]
+                                      [--op eval-choice --value "<问题>" --options "k=desc,..." --answer k]
+                                      [--op eval-score --value "<问题>" --levels "级0,..." --min-score n]
+                                      [--effect gate|cost_mul] [--weight n]
+  node index                         rebuild closure + topo order
+  node can <key> [--state k=v]       evaluate required vs optional gates
+                                     (--eval: eval 题型经决策模型判定；
+                                      boolean P / choice P(期望答案) / score ±1 灰带)
+  node ready [--state k=v] [--eval]  currently unlockable set
+  node path <key>                    dependency-order path to target (all locked ancestors; OR branches not optimized)
+  node parents|children <key>        direct relations
+  node ancestors|descendants <key>   transitive, via closure index
+  node list | show <key> | search "<q>" | unlock|lock <key>
+  node validate                      cycles, dangling edges, dirty index
+  node export [--out file.json]      portable JSON
+  node import --file <file.json>     [--tree name] [--merge] — strict, transactional
+
+  Writes are idempotent (claim/evidence/query/kb/job dedupe by content
+  hash); pass --force to keep a deliberate duplicate.
+
+${(0, fmt_1.paint)(fmt_1.C.bold, "webui", true)}            dashboard (zero-dependency)
+  export [--out <file>]     single-file dashboard.html (open in browser)
+  serve [--port N]          live dashboard at http://127.0.0.1:N/ (Ctrl+C to stop)
+
+${(0, fmt_1.paint)(fmt_1.C.bold, "rel", true)}             关联织物（spec R9：任意两类实体互相挂接）
+  add <src> <dst> [--rel t]   link two refs: node:key claim:id kb:id artifact:id
+                             skill:name evidence:id source:id query:id
+  rm <src> <dst> [--rel t]    unlink
+  list [--src r] [--dst r]    browse (either side filter, resolves displays)
+
+${(0, fmt_1.paint)(fmt_1.C.bold, "plugin", true)}          用户层插件分发（spec R14 L3，业务域扩展位）
+  init                       create $YGL_HOME/plugins profile
+  install <spec>             npm package / git url / local dir (auto link:)
+  remove <name> | list       manage the user layer ($YGL_HOME/ygl.user.bundle.json)
+  插件契约：export apply(ctx,config) + 可选 commands 贡献 CLI 命令组
+
+${(0, fmt_1.paint)(fmt_1.C.bold, "agent", true)}       agent-facing views
+  brief                      current project state + next actions (start here)
+  match "<task>"             which skill should handle this task
+  log                        recent events
+
+Global: --json  --no-color  --db <file>  --home <dir>
 `;
 function usage() {
     return USAGE;
@@ -276,6 +276,14 @@ async function main(argv) {
         (0, fmt_1.out)(ctx, generateLlmsManifest());
         return 0;
     }
+    // MCP: Model Context Protocol server (stdio) — 8-tool surface.
+    // Designed by the unified three-pillar theory (R8 research); each tool
+    // routes to CLI --json, inheriting frozen contracts.
+    if (group === "mcp") {
+        const { serveMcp } = await Promise.resolve().then(() => __importStar(require("../../../packages/ops/tools/src/mcp")));
+        serveMcp();
+        return new Promise(() => { });
+    }
     if (!group || group === "help" || group === "-h" || group === "--help") {
         if (!ctx.json)
             (0, fmt_1.out)(ctx, usage());

package/dist/bundle/bin.cjs

@@ -1,64 +1,25 @@
 #!/usr/bin/env node
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __esmMin = (fn, res, err) => () => {
-	if (err) throw err[0];
-	try {
-		return fn && (res = fn(fn = 0)), res;
-	} catch (e) {
-		throw err = [e], e;
-	}
-};
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-var __toCommonJS = (mod) => __hasOwnProp.call(mod, "module.exports") ? mod["module.exports"] : __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-//#endregion
+const require_rolldown_runtime = require("./rolldown-runtime-C96Ew50Q.cjs");
 let node_os = require("node:os");
-node_os = __toESM(node_os);
+node_os = require_rolldown_runtime.__toESM(node_os);
 let node_path = require("node:path");
-node_path = __toESM(node_path);
+node_path = require_rolldown_runtime.__toESM(node_path);
 let node_sqlite3_wasm = require("node-sqlite3-wasm");
 let node_fs = require("node:fs");
-node_fs = __toESM(node_fs);
+node_fs = require_rolldown_runtime.__toESM(node_fs);
 let node_crypto = require("node:crypto");
 let _deepseek_ai_cordis = require("@deepseek-ai/cordis");
 let _deepseek_ai_cordis_plugin_timer = require("@deepseek-ai/cordis-plugin-timer");
-_deepseek_ai_cordis_plugin_timer = __toESM(_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");
 require("reflect-metadata");
 let typeorm = require("typeorm");
 let _deepseek_ai_schemastery = require("@deepseek-ai/schemastery");
-_deepseek_ai_schemastery = __toESM(_deepseek_ai_schemastery);
+_deepseek_ai_schemastery = require_rolldown_runtime.__toESM(_deepseek_ai_schemastery);
 //#region packages/core/text/src/text.ts
-var text_exports = /* @__PURE__ */ __exportAll({
+var text_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	clip: () => clip,
 	contentHash: () => contentHash,
 	ngram: () => ngram,
@@ -167,7 +128,7 @@ function splitTags(v) {
 	return (v || "").split(/[,，;；\s]+/).map((s) => s.trim()).filter(Boolean);
 }
 var CJK, CJK_RUN_RE, CJK_ONLY_RE;
-var init_text = __esmMin((() => {
+var init_text = require_rolldown_runtime.__esmMin((() => {
 	CJK = "\\u4e00-\\u9fff\\u3400-\\u4dbf\\uf900-\\ufaff";
 	new RegExp(`[${CJK}]`, "u");
 	CJK_RUN_RE = new RegExp(`[${CJK}]+|[^\\s${CJK}]+`, "gu");
@@ -181,7 +142,7 @@ var init_text = __esmMin((() => {
 * Everything — skills, research state, evidence, drafts, knowledge notes and
 * schedules — lives in one SQLite file. No sidecar JSON, no git-as-database.
 */
-var db_exports = /* @__PURE__ */ __exportAll({
+var db_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	COND_KINDS: () => COND_KINDS,
 	DB: () => DB,
 	EDGE_MODES: () => EDGE_MODES,
@@ -195,7 +156,7 @@ function dbPath(home) {
 	return node_path.join(home, "ygl-trees.db");
 }
 var SCHEMA_SQL, DB, EDGE_RELS, EDGE_MODES, COND_KINDS;
-var init_db = __esmMin((() => {
+var init_db = require_rolldown_runtime.__esmMin((() => {
 	init_text();
 	SCHEMA_SQL = `
 -- ---------------------------------------------------------------- meta
@@ -1425,7 +1386,7 @@ function mapOutcome(r, high = .7, low = .4) {
 	};
 }
 var GATEWAY_URL, MODEL_ID, NO_TOKEN;
-var init_eval = __esmMin((() => {
+var init_eval = require_rolldown_runtime.__esmMin((() => {
 	GATEWAY_URL = "https://ai-gateway.vercel.sh/v4/ai/evaluation-model";
 	MODEL_ID = "typesafe-ai/jev";
 	NO_TOKEN = "no evaluator configured (set config decision_model_llm_token, or AI_GATEWAY_API_KEY / ~/.vercel.ai-gateway.env)";
@@ -1937,7 +1898,7 @@ var TreeStore = class {
 	/** Full-text search over nodes. Title/key substring hits outrank same-hit
 	*  rows (same ranking semantics as kb/skill/source search). */
 	nodeSearch(treeId, q, limit = 20) {
-		const tokens = Array.from(new Set(String((init_text(), __toCommonJS(text_exports)).ngram(q) || "").split(/\s+/).filter(Boolean)));
+		const tokens = Array.from(new Set(String((init_text(), require_rolldown_runtime.__toCommonJS(text_exports)).ngram(q) || "").split(/\s+/).filter(Boolean)));
 		if (!tokens.length) return [];
 		const agg = /* @__PURE__ */ new Map();
 		const st = this.db.db.prepare(`SELECT n.id,n.key,n.name,n.tier, bm25(nodes_fts) AS score
@@ -2591,7 +2552,7 @@ function apply(ctx) {
 *
 * @module @ygl/ops-tools/plugins
 */
-var plugins_exports = /* @__PURE__ */ __exportAll({
+var plugins_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	initProfile: () => initProfile,
 	installPlugin: () => installPlugin,
 	listPlugins: () => listPlugins,
@@ -2842,7 +2803,7 @@ function loadUserPlugins(home) {
 	};
 }
 var PROFILE_PKG, cachedPm, q2;
-var init_plugins = __esmMin((() => {
+var init_plugins = require_rolldown_runtime.__esmMin((() => {
 	PROFILE_PKG = () => ({
 		name: "ygl-user-plugins",
 		private: true,
@@ -3073,7 +3034,7 @@ function runPluginCommand(env, action, rest, args) {
 						bad(ctx, `'${name}' is not in the user bundle`);
 						return 1;
 					}
-					const bundle = (init_plugins(), __toCommonJS(plugins_exports)).readUserBundle(home).find((p) => p.name === name);
+					const bundle = (init_plugins(), require_rolldown_runtime.__toCommonJS(plugins_exports)).readUserBundle(home).find((p) => p.name === name);
 					out(ctx, JSON.stringify(bundle?.config ?? {}, null, 2));
 					return 0;
 				}
@@ -3484,7 +3445,7 @@ function preflightTypeCheck(db) {
 function __decorateMetadata(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
-var init_decorateMetadata = __esmMin((() => {}));
+var init_decorateMetadata = require_rolldown_runtime.__esmMin((() => {}));
 //#endregion
 //#region \0@oxc-project+runtime@0.154.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
@@ -3493,7 +3454,7 @@ function __decorate(decorators, target, key, desc) {
 	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
 	return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-var init_decorate = __esmMin((() => {}));
+var init_decorate = require_rolldown_runtime.__esmMin((() => {}));
 //#endregion
 //#region packages/research/pipeline/src/entities.ts
 /**
@@ -3508,7 +3469,7 @@ var init_decorate = __esmMin((() => {}));
 *    stay raw SQL in store.ts (see docs/plan.md TypeORM boundaries).
 */
 var Project, Query, Source, QuerySource, Evidence, Claim, ClaimEvidence, RESEARCH_ENTITIES;
-var init_entities$1 = __esmMin((() => {
+var init_entities$1 = require_rolldown_runtime.__esmMin((() => {
 	init_decorateMetadata();
 	init_decorate();
 	Project = class Project {
@@ -3882,7 +3843,7 @@ var init_entities$1 = __esmMin((() => {
 /** Cross-cutting entities (audit trail). Research-domain entities live in
 *  research.ts; both are registered in src/orm.ts. */
 var Event, CORE_ENTITIES;
-var init_entities = __esmMin((() => {
+var init_entities = require_rolldown_runtime.__esmMin((() => {
 	init_decorateMetadata();
 	init_decorate();
 	Event = class Event {
@@ -3948,7 +3909,7 @@ var init_entities = __esmMin((() => {
 *  - CLI commands using the ORM must return a Promise (main() awaits) so
 *    the DataSource settles before the wasm DB closes.
 */
-var orm_exports = /* @__PURE__ */ __exportAll({
+var orm_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	closeOrm: () => closeOrm,
 	getOrm: () => getOrm
 });
@@ -3979,14 +3940,14 @@ async function closeOrm() {
 	}
 }
 var cached;
-var init_orm = __esmMin((() => {
+var init_orm = require_rolldown_runtime.__esmMin((() => {
 	init_entities$1();
 	init_entities();
 	cached = null;
 }));
 //#endregion
 //#region packages/research/pipeline/src/writes.ts
-var writes_exports = /* @__PURE__ */ __exportAll({
+var writes_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	artifactAdd: () => artifactAdd,
 	claimAdd: () => claimAdd,
 	claimLink: () => claimLink,
@@ -4611,7 +4572,7 @@ async function projectCreate(ds, name, question = "") {
 	});
 }
 var TASK_STATUSES;
-var init_writes = __esmMin((() => {
+var init_writes = require_rolldown_runtime.__esmMin((() => {
 	init_entities$1();
 	init_entities();
 	init_text();
@@ -4623,7 +4584,7 @@ var init_writes = __esmMin((() => {
 }));
 //#endregion
 //#region packages/ops/tools/src/db-cmds.ts
-var db_cmds_exports = /* @__PURE__ */ __exportAll({ run: () => run$12 });
+var db_cmds_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run$12 });
 init_db();
 /**
 * Cold-start: import the built-in skills that ship with this package, so a
@@ -4645,9 +4606,9 @@ async function autoImportBuiltinSkills(env, dbFile) {
 		}
 	}
 	if (!skillsDir) return 0;
-	const { getOrm } = (init_orm(), __toCommonJS(orm_exports));
-	const writes = (init_writes(), __toCommonJS(writes_exports));
-	const { parseFrontmatter } = (init_text(), __toCommonJS(text_exports));
+	const { getOrm } = (init_orm(), require_rolldown_runtime.__toCommonJS(orm_exports));
+	const writes = (init_writes(), require_rolldown_runtime.__toCommonJS(writes_exports));
+	const { parseFrontmatter } = (init_text(), require_rolldown_runtime.__toCommonJS(text_exports));
 	const ds = await getOrm(dbFile);
 	let count = 0;
 	for (const entry of fs2.readdirSync(skillsDir)) {
@@ -4674,16 +4635,16 @@ function run$12(env, action, rest, args) {
 	switch (action) {
 		case "init": {
 			node_fs.mkdirSync(home, { recursive: true });
-			const d = new (init_db(), __toCommonJS(db_exports)).DB(file);
+			const d = new (init_db(), require_rolldown_runtime.__toCommonJS(db_exports)).DB(file);
 			d.metaSet("created", (/* @__PURE__ */ new Date()).toISOString());
-			d.metaSet("schema_version", String((init_db(), __toCommonJS(db_exports)).SCHEMA_VERSION));
+			d.metaSet("schema_version", String((init_db(), require_rolldown_runtime.__toCommonJS(db_exports)).SCHEMA_VERSION));
 			d.close();
 			ok(ctx, `workspace ready: ${home}`);
 			ok(ctx, `database:        ${file}`);
 			autoImportBuiltinSkills(env, file).then(async (n) => {
 				if (n > 0) ok(ctx, `built-in skills:  ${n} imported (agent match ready)`);
 				try {
-					const { closeOrm } = (init_orm(), __toCommonJS(orm_exports));
+					const { closeOrm } = (init_orm(), require_rolldown_runtime.__toCommonJS(orm_exports));
 					await closeOrm();
 				} catch {}
 			});
@@ -5029,7 +4990,7 @@ function configReset(db, key) {
 }
 //#endregion
 //#region packages/ops/tools/src/config-cmds.ts
-var config_cmds_exports = /* @__PURE__ */ __exportAll({ run: () => run$11 });
+var config_cmds_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run$11 });
 function run$11(env, action, rest, args) {
 	const { ctx, db } = env;
 	switch (action) {
@@ -5115,7 +5076,7 @@ function run$11(env, action, rest, args) {
 //#region packages/ops/tools/src/job-cmds.ts
 /** job group — batch + schedule. `job tick` is what cron/systemctl drives.
 *  Writes (add) run on the TypeORM write service (src/writes.ts). */
-var job_cmds_exports = /* @__PURE__ */ __exportAll({ run: () => run$10 });
+var job_cmds_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run$10 });
 init_text();
 init_orm();
 init_writes();
@@ -5319,7 +5280,7 @@ function withTickLock(env, fn) {
 }
 //#endregion
 //#region packages/ops/tools/src/agent-cmds.ts
-var agent_cmds_exports = /* @__PURE__ */ __exportAll({
+var agent_cmds_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	buildBrief: () => buildBrief,
 	run: () => run$9
 });
@@ -5565,7 +5526,7 @@ function validateEnum(ctx, flags, name, allowed, required = false) {
 }
 //#endregion
 //#region packages/ops/tools/src/eval-enhance.ts
-var eval_enhance_exports = /* @__PURE__ */ __exportAll({
+var eval_enhance_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	assessEvidenceQuality: () => assessEvidenceQuality,
 	evaluateClaimConfidence: () => evaluateClaimConfidence,
 	semanticReRank: () => semanticReRank
@@ -5693,7 +5654,7 @@ async function assessEvidenceQuality(ctx, token) {
 		usage: r.usage
 	};
 }
-var init_eval_enhance = __esmMin((() => {
+var init_eval_enhance = require_rolldown_runtime.__esmMin((() => {
 	init_eval();
 }));
 //#endregion
@@ -5701,7 +5662,7 @@ var init_eval_enhance = __esmMin((() => {
 /** research group — collect → screen → extract → claim.
 *  `source fetch` is async (Node 18+ global fetch) and returns a promise.
 *  List commands run on TypeORM (src/orm.ts); search stays raw SQL (FTS5). */
-var cmds_exports$2 = /* @__PURE__ */ __exportAll({ run: () => run$8 });
+var cmds_exports$2 = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run$8 });
 init_text();
 init_orm();
 init_writes();
@@ -6028,7 +5989,7 @@ function run$8(env, action, rest, args) {
 				bad(ctx, `evidence not found: ${id}`);
 				return 1;
 			}
-			const { assessEvidenceQuality } = (init_eval_enhance(), __toCommonJS(eval_enhance_exports));
+			const { assessEvidenceQuality } = (init_eval_enhance(), require_rolldown_runtime.__toCommonJS(eval_enhance_exports));
 			return assessEvidenceQuality({
 				quote: ev.quote,
 				locator: ev.locator,
@@ -6120,7 +6081,7 @@ function run$8(env, action, rest, args) {
 			return getOrm(env.db.path).then((ds) => claimLink(ds, rest[1], rest[2], stance)).then((r) => {
 				ok(ctx, `linked; claim status now: ${r.status}`);
 				try {
-					const { evaluateClaimConfidence } = (init_eval_enhance(), __toCommonJS(eval_enhance_exports));
+					const { evaluateClaimConfidence } = (init_eval_enhance(), require_rolldown_runtime.__toCommonJS(eval_enhance_exports));
 					const evRows = store.db.all(`SELECT e.quote, ce.stance, s.title AS source_title
                  FROM claim_evidence ce
                  JOIN evidence e ON e.id = ce.evidence_id
@@ -6202,7 +6163,7 @@ function run$8(env, action, rest, args) {
            JOIN evidence e ON e.id = ce.evidence_id
            LEFT JOIN sources s ON s.id = e.source_id
           WHERE ce.claim_id = ?`, [id]);
-			const { evaluateClaimConfidence } = (init_eval_enhance(), __toCommonJS(eval_enhance_exports));
+			const { evaluateClaimConfidence } = (init_eval_enhance(), require_rolldown_runtime.__toCommonJS(eval_enhance_exports));
 			return (async () => {
 				const result = await evaluateClaimConfidence({
 					claim_text: claim.text,
@@ -6277,7 +6238,7 @@ function run$8(env, action, rest, args) {
 }
 //#endregion
 //#region packages/research/produce/src/project-cmds.ts
-var project_cmds_exports = /* @__PURE__ */ __exportAll({ run: () => run$7 });
+var project_cmds_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run$7 });
 init_orm();
 init_writes();
 init_entities$1();
@@ -6415,7 +6376,7 @@ function run$7(env, action, rest, args) {
 /** produce group — evidence-backed outline → sections → report.
 *  Writes run on the TypeORM write service (src/writes.ts); reads stay on
 *  Store until their own migration batch. */
-var produce_cmds_exports = /* @__PURE__ */ __exportAll({ run: () => run$6 });
+var produce_cmds_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run$6 });
 init_text();
 init_orm();
 init_writes();
@@ -7305,7 +7266,7 @@ async function importTree(ds, spec, opts = {}) {
 *   ygl-trees node validate             sanity checks
 *   ygl-trees node export [--out file]  portable JSON
 */
-var cmds_exports$1 = /* @__PURE__ */ __exportAll({ run: () => run$5 });
+var cmds_exports$1 = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run$5 });
 init_orm();
 init_eval();
 init_text();
@@ -8151,7 +8112,7 @@ function parseState(args) {
 //#region packages/knowledge/skills/src/skill-cmds.ts
 /** skill group — the L1/L2/L3 registry agents query before acting.
 *  Writes run on the TypeORM write service (src/writes.ts). */
-var skill_cmds_exports = /* @__PURE__ */ __exportAll({ run: () => run$4 });
+var skill_cmds_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run$4 });
 init_text();
 init_orm();
 init_writes();
@@ -8404,7 +8365,7 @@ function wrap(text, indent = 4) {
 //#region packages/knowledge/skills/src/cmds.ts
 /** kb group — long-term knowledge: store, retrieve, connect, promote to skill.
 *  Writes (add/ingest) run on the TypeORM write service (src/writes.ts). */
-var cmds_exports = /* @__PURE__ */ __exportAll({ run: () => run$3 });
+var cmds_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run$3 });
 init_text();
 init_orm();
 init_writes();
@@ -8453,7 +8414,7 @@ function run$3(env, action, rest, args) {
 			}
 			const raw = store.kbSearch(q, Number(args.flags.limit || configGetNumber(env.db, "search.limit")));
 			if (args.flags.eval) {
-				const { semanticReRank } = (init_eval_enhance(), __toCommonJS(eval_enhance_exports));
+				const { semanticReRank } = (init_eval_enhance(), require_rolldown_runtime.__toCommonJS(eval_enhance_exports));
 				return semanticReRank(q, raw.map((r) => ({
 					id: r.id,
 					title: r.title,
@@ -8708,7 +8669,7 @@ function run$3(env, action, rest, args) {
 }
 //#endregion
 //#region packages/ops/tools/src/rels.ts
-var rels_exports = /* @__PURE__ */ __exportAll({
+var rels_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	REL_TYPES: () => REL_TYPES,
 	RelError: () => RelError,
 	relAdd: () => relAdd,
@@ -9014,7 +8975,7 @@ function run$2(env, action, rest, args) {
 }
 //#endregion
 //#region packages/ops/tools/src/webui.ts
-var webui_exports = /* @__PURE__ */ __exportAll({
+var webui_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	createDashboardServer: () => createDashboardServer,
 	gatherData: () => gatherData,
 	generateHTML: () => generateHTML,
@@ -9936,7 +9897,7 @@ function serve(env, args) {
 }
 //#endregion
 //#region packages/ops/tools/src/doctor.ts
-var doctor_exports = /* @__PURE__ */ __exportAll({ run: () => run });
+var doctor_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run });
 init_eval();
 init_db();
 init_plugins();
@@ -10363,6 +10324,11 @@ async function main(argv) {
 		out(ctx, generateLlmsManifest());
 		return 0;
 	}
+	if (group === "mcp") {
+		const { serveMcp } = await Promise.resolve().then(() => require("./mcp-C27lIHd1.cjs"));
+		serveMcp();
+		return new Promise(() => {});
+	}
 	if (!group || group === "help" || group === "-h" || group === "--help") {
 		if (!ctx.json) out(ctx, usage());
 		return 0;
@@ -10437,7 +10403,7 @@ async function main(argv) {
 			db?.close();
 		} catch {}
 		try {
-			(init_db(), __toCommonJS(db_exports)).DB.releaseLockFor(file);
+			(init_db(), require_rolldown_runtime.__toCommonJS(db_exports)).DB.releaseLockFor(file);
 		} catch {}
 	});
 	process.on("SIGINT", () => shutdown.interrupt(0));

package/dist/bundle/mcp-C27lIHd1.cjs

@@ -0,0 +1,276 @@
+const require_rolldown_runtime = require("./rolldown-runtime-C96Ew50Q.cjs");
+let node_readline = require("node:readline");
+node_readline = require_rolldown_runtime.__toESM(node_readline);
+//#region packages/ops/tools/src/mcp.ts
+/**
+* MCP (Model Context Protocol) Server — stdio transport.
+*
+* Eight-tool surface designed by the unified three-pillar theory (R8 research):
+*   agent_brief · agent_match · kb_search · claim_evaluate
+*   tree_state  · produce_report · doctor · task_advance
+*
+* Each tool routes to the CLI --json backend, inheriting its frozen contracts
+* (idempotent writes, pure JSON errors, snake_case fields). Agents call tools
+* directly — no command-line parsing layer.
+*
+* Protocol: JSON-RPC 2.0 over stdio (one message per line).
+*   → {"jsonrpc":"2.0","id":1,"method":"initialize","params":{...}}
+*   ← {"jsonrpc":"2.0","id":1,"result":{...}}
+*
+* @module @ygl/ops-tools/mcp
+*/
+/** Build a CLI invocation and capture JSON stdout.
+*  Uses process.argv[1] (the running script — bundle or source) to re-invoke
+*  the CLI as a child process. This works in both dev (dist/apps/...) and
+*  bundle (dist/bundle/bin.cjs) contexts. */
+function cliJson(parts) {
+	const { spawn } = require("node:child_process");
+	const self = process.argv[1];
+	return new Promise((resolve, reject) => {
+		const child = spawn(process.execPath, [
+			self,
+			"--json",
+			...parts
+		], {
+			env: {
+				...process.env,
+				YGL_SERVE: "1",
+				YGL_MCP_CHILD: "1"
+			},
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+		let out = "";
+		let err = "";
+		child.stdout.on("data", (d) => out += d);
+		child.stderr.on("data", (d) => err += d);
+		child.on("close", (code) => {
+			if (out.trim()) try {
+				resolve(JSON.parse(out));
+				return;
+			} catch {}
+			reject(/* @__PURE__ */ new Error(`CLI rc=${code}: ${err.slice(0, 200) || out.slice(0, 200)}`));
+		});
+		child.on("error", (e) => reject(e));
+	});
+}
+function buildTools() {
+	return [
+		{
+			name: "agent_brief",
+			description: "Current workspace state: project, progress, counts, next actions, available skills. Always start here.",
+			inputSchema: {
+				type: "object",
+				properties: {}
+			},
+			execute: () => cliJson(["agent", "brief"])
+		},
+		{
+			name: "agent_match",
+			description: "Discover which skill handles a task. Returns matched skills with relevance scores.",
+			inputSchema: {
+				type: "object",
+				properties: { query: {
+					type: "string",
+					description: "Task description to match"
+				} },
+				required: ["query"]
+			},
+			execute: (a) => cliJson([
+				"agent",
+				"match",
+				String(a.query)
+			])
+		},
+		{
+			name: "kb_search",
+			description: "Search knowledge notes (CJK full-text). Returns notes with title, body, tags, confidence.",
+			inputSchema: {
+				type: "object",
+				properties: {
+					query: {
+						type: "string",
+						description: "Search query (Chinese supported)"
+					},
+					eval: {
+						type: "boolean",
+						description: "Enable decision-model semantic re-ranking"
+					}
+				},
+				required: ["query"]
+			},
+			execute: (a) => {
+				const parts = [
+					"kb",
+					"search",
+					String(a.query)
+				];
+				if (a.eval) parts.push("--eval");
+				return cliJson(parts);
+			}
+		},
+		{
+			name: "claim_evaluate",
+			description: "Decision model evaluates a claim's confidence (score 0-5 → grade A/B/C/D).",
+			inputSchema: {
+				type: "object",
+				properties: { claim_id: {
+					type: "string",
+					description: "Claim ID to evaluate"
+				} },
+				required: ["claim_id"]
+			},
+			execute: (a) => cliJson([
+				"research",
+				"claim",
+				"evaluate",
+				String(a.claim_id)
+			])
+		},
+		{
+			name: "tree_state",
+			description: "All trees with node states (locked/unlocked). Visualize the dependency graph.",
+			inputSchema: {
+				type: "object",
+				properties: { tree: {
+					type: "string",
+					description: "Optional tree name (omit for all)"
+				} }
+			},
+			execute: (a) => cliJson([
+				"node",
+				"list",
+				...a.tree ? [String(a.tree)] : []
+			])
+		},
+		{
+			name: "produce_report",
+			description: "Assemble claims + evidence into a markdown report. Returns report ID and content.",
+			inputSchema: {
+				type: "object",
+				properties: {}
+			},
+			execute: () => cliJson(["produce", "report"])
+		},
+		{
+			name: "doctor",
+			description: "9-item workspace health check. Pass fix=true to auto-fix safe issues.",
+			inputSchema: {
+				type: "object",
+				properties: { fix: {
+					type: "boolean",
+					description: "Auto-fix dirty index + stale locks"
+				} }
+			},
+			execute: (a) => cliJson(["doctor", ...a.fix ? ["--fix"] : []])
+		},
+		{
+			name: "task_advance",
+			description: "Advance a task through the state machine: todo → doing → done (or roll back).",
+			inputSchema: {
+				type: "object",
+				properties: {
+					task_id: {
+						type: "string",
+						description: "Task artifact ID"
+					},
+					action: {
+						type: "string",
+						enum: [
+							"doing",
+							"done",
+							"todo"
+						],
+						description: "Target status"
+					}
+				},
+				required: ["task_id", "action"]
+			},
+			execute: (a) => cliJson([
+				"task",
+				String(a.action),
+				String(a.task_id)
+			])
+		}
+	];
+}
+/** Run the MCP server on stdio. */
+function serveMcp() {
+	const tools = buildTools();
+	const rl = node_readline.createInterface({ input: process.stdin });
+	const respond = (id, result) => {
+		process.stdout.write(JSON.stringify({
+			jsonrpc: "2.0",
+			id,
+			result
+		}) + "\n");
+	};
+	const respondErr = (id, code, message) => {
+		process.stdout.write(JSON.stringify({
+			jsonrpc: "2.0",
+			id,
+			error: {
+				code,
+				message
+			}
+		}) + "\n");
+	};
+	rl.on("line", (line) => {
+		if (!line.trim()) return;
+		let msg;
+		try {
+			msg = JSON.parse(line);
+		} catch {
+			return;
+		}
+		const { id, method, params } = msg;
+		switch (method) {
+			case "initialize":
+				respond(id, {
+					protocolVersion: "2024-11-05",
+					capabilities: { tools: {} },
+					serverInfo: {
+						name: "ygl-trees",
+						version: "0.69.0"
+					}
+				});
+				break;
+			case "tools/list":
+				respond(id, { tools: tools.map((t) => ({
+					name: t.name,
+					description: t.description,
+					inputSchema: t.inputSchema
+				})) });
+				break;
+			case "tools/call": {
+				const name = params?.name;
+				const tool = tools.find((t) => t.name === name);
+				if (!tool) {
+					respondErr(id, -32602, `Unknown tool: ${name}`);
+					break;
+				}
+				tool.execute(params?.arguments || {}).then((data) => respond(id, { content: [{
+					type: "text",
+					text: JSON.stringify(data, null, 2)
+				}] })).catch((e) => respond(id, {
+					content: [{
+						type: "text",
+						text: `Error: ${e?.message || e}`
+					}],
+					isError: true
+				}));
+				break;
+			}
+			case "ping":
+				respond(id, {});
+				break;
+			default: if (id !== void 0) respondErr(id, -32601, `Method not found: ${method}`);
+		}
+	});
+	process.stderr.write("[ygl-trees MCP] stdio server ready — 8 tools\n");
+}
+//#endregion
+exports.serveMcp = serveMcp;

package/dist/bundle/rolldown-runtime-C96Ew50Q.cjs

@@ -0,0 +1,64 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esmMin = (fn, res, err) => () => {
+	if (err) throw err[0];
+	try {
+		return fn && (res = fn(fn = 0)), res;
+	} catch (e) {
+		throw err = [e], e;
+	}
+};
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+var __toCommonJS = (mod) => __hasOwnProp.call(mod, "module.exports") ? mod["module.exports"] : __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+//#endregion
+Object.defineProperty(exports, "__esmMin", {
+	enumerable: true,
+	get: function() {
+		return __esmMin;
+	}
+});
+Object.defineProperty(exports, "__exportAll", {
+	enumerable: true,
+	get: function() {
+		return __exportAll;
+	}
+});
+Object.defineProperty(exports, "__toCommonJS", {
+	enumerable: true,
+	get: function() {
+		return __toCommonJS;
+	}
+});
+Object.defineProperty(exports, "__toESM", {
+	enumerable: true,
+	get: function() {
+		return __toESM;
+	}
+});

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.apply = exports.OpsService = exports.MIRROR_TABLES = exports.migrateToPg = exports.syncToPg = exports.configAll = exports.configReset = exports.configSet = exports.configGetBool = exports.configGetNumber = exports.configGet = exports.CONFIG_REGISTRY = void 0;
+exports.buildTools = exports.serveMcp = exports.apply = exports.OpsService = exports.MIRROR_TABLES = exports.migrateToPg = exports.syncToPg = exports.configAll = exports.configReset = exports.configSet = exports.configGetBool = exports.configGetNumber = exports.configGet = exports.CONFIG_REGISTRY = void 0;
 /**
  * @module @ygl/ops-tools
  */
@@ -20,3 +20,6 @@ Object.defineProperty(exports, "MIRROR_TABLES", { enumerable: true, get: functio
 var plugin_1 = require("./plugin");
 Object.defineProperty(exports, "OpsService", { enumerable: true, get: function () { return plugin_1.OpsService; } });
 Object.defineProperty(exports, "apply", { enumerable: true, get: function () { return plugin_1.apply; } });
+var mcp_1 = require("./mcp");
+Object.defineProperty(exports, "serveMcp", { enumerable: true, get: function () { return mcp_1.serveMcp; } });
+Object.defineProperty(exports, "buildTools", { enumerable: true, get: function () { return mcp_1.buildTools; } });

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

@@ -0,0 +1,233 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTools = buildTools;
+exports.serveMcp = serveMcp;
+/**
+ * MCP (Model Context Protocol) Server — stdio transport.
+ *
+ * Eight-tool surface designed by the unified three-pillar theory (R8 research):
+ *   agent_brief · agent_match · kb_search · claim_evaluate
+ *   tree_state  · produce_report · doctor · task_advance
+ *
+ * Each tool routes to the CLI --json backend, inheriting its frozen contracts
+ * (idempotent writes, pure JSON errors, snake_case fields). Agents call tools
+ * directly — no command-line parsing layer.
+ *
+ * Protocol: JSON-RPC 2.0 over stdio (one message per line).
+ *   → {"jsonrpc":"2.0","id":1,"method":"initialize","params":{...}}
+ *   ← {"jsonrpc":"2.0","id":1,"result":{...}}
+ *
+ * @module @ygl/ops-tools/mcp
+ */
+const readline = __importStar(require("node:readline"));
+/** Build a CLI invocation and capture JSON stdout.
+ *  Uses process.argv[1] (the running script — bundle or source) to re-invoke
+ *  the CLI as a child process. This works in both dev (dist/apps/...) and
+ *  bundle (dist/bundle/bin.cjs) contexts. */
+function cliJson(parts) {
+    const { spawn } = require("node:child_process");
+    const self = process.argv[1]; // the bin.cjs or bin.js that's running this MCP server
+    return new Promise((resolve, reject) => {
+        const child = spawn(process.execPath, [self, "--json", ...parts], {
+            env: { ...process.env, YGL_SERVE: "1", YGL_MCP_CHILD: "1" },
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let out = "";
+        let err = "";
+        child.stdout.on("data", (d) => (out += d));
+        child.stderr.on("data", (d) => (err += d));
+        child.on("close", (code) => {
+            if (out.trim()) {
+                try {
+                    resolve(JSON.parse(out));
+                    return;
+                }
+                catch { /* fall through */ }
+            }
+            reject(new Error(`CLI rc=${code}: ${err.slice(0, 200) || out.slice(0, 200)}`));
+        });
+        child.on("error", (e) => reject(e));
+    });
+}
+function buildTools() {
+    return [
+        {
+            name: "agent_brief",
+            description: "Current workspace state: project, progress, counts, next actions, available skills. Always start here.",
+            inputSchema: { type: "object", properties: {} },
+            execute: () => cliJson(["agent", "brief"]),
+        },
+        {
+            name: "agent_match",
+            description: "Discover which skill handles a task. Returns matched skills with relevance scores.",
+            inputSchema: {
+                type: "object",
+                properties: { query: { type: "string", description: "Task description to match" } },
+                required: ["query"],
+            },
+            execute: (a) => cliJson(["agent", "match", String(a.query)]),
+        },
+        {
+            name: "kb_search",
+            description: "Search knowledge notes (CJK full-text). Returns notes with title, body, tags, confidence.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    query: { type: "string", description: "Search query (Chinese supported)" },
+                    eval: { type: "boolean", description: "Enable decision-model semantic re-ranking" },
+                },
+                required: ["query"],
+            },
+            execute: (a) => {
+                const parts = ["kb", "search", String(a.query)];
+                if (a.eval)
+                    parts.push("--eval");
+                return cliJson(parts);
+            },
+        },
+        {
+            name: "claim_evaluate",
+            description: "Decision model evaluates a claim's confidence (score 0-5 → grade A/B/C/D).",
+            inputSchema: {
+                type: "object",
+                properties: { claim_id: { type: "string", description: "Claim ID to evaluate" } },
+                required: ["claim_id"],
+            },
+            execute: (a) => cliJson(["research", "claim", "evaluate", String(a.claim_id)]),
+        },
+        {
+            name: "tree_state",
+            description: "All trees with node states (locked/unlocked). Visualize the dependency graph.",
+            inputSchema: {
+                type: "object",
+                properties: { tree: { type: "string", description: "Optional tree name (omit for all)" } },
+            },
+            execute: (a) => cliJson(["node", "list", ...(a.tree ? [String(a.tree)] : [])]),
+        },
+        {
+            name: "produce_report",
+            description: "Assemble claims + evidence into a markdown report. Returns report ID and content.",
+            inputSchema: { type: "object", properties: {} },
+            execute: () => cliJson(["produce", "report"]),
+        },
+        {
+            name: "doctor",
+            description: "9-item workspace health check. Pass fix=true to auto-fix safe issues.",
+            inputSchema: {
+                type: "object",
+                properties: { fix: { type: "boolean", description: "Auto-fix dirty index + stale locks" } },
+            },
+            execute: (a) => cliJson(["doctor", ...(a.fix ? ["--fix"] : [])]),
+        },
+        {
+            name: "task_advance",
+            description: "Advance a task through the state machine: todo → doing → done (or roll back).",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    task_id: { type: "string", description: "Task artifact ID" },
+                    action: { type: "string", enum: ["doing", "done", "todo"], description: "Target status" },
+                },
+                required: ["task_id", "action"],
+            },
+            execute: (a) => cliJson(["task", String(a.action), String(a.task_id)]),
+        },
+    ];
+}
+/** Run the MCP server on stdio. */
+function serveMcp() {
+    const tools = buildTools();
+    const rl = readline.createInterface({ input: process.stdin });
+    const respond = (id, result) => {
+        process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id, result }) + "\n");
+    };
+    const respondErr = (id, code, message) => {
+        process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id, error: { code, message } }) + "\n");
+    };
+    rl.on("line", (line) => {
+        if (!line.trim())
+            return;
+        let msg;
+        try {
+            msg = JSON.parse(line);
+        }
+        catch {
+            return;
+        }
+        const { id, method, params } = msg;
+        switch (method) {
+            case "initialize":
+                respond(id, {
+                    protocolVersion: "2024-11-05",
+                    capabilities: { tools: {} },
+                    serverInfo: { name: "ygl-trees", version: "0.69.0" },
+                });
+                break;
+            case "tools/list":
+                respond(id, {
+                    tools: tools.map((t) => ({
+                        name: t.name,
+                        description: t.description,
+                        inputSchema: t.inputSchema,
+                    })),
+                });
+                break;
+            case "tools/call": {
+                const name = params?.name;
+                const tool = tools.find((t) => t.name === name);
+                if (!tool) {
+                    respondErr(id, -32602, `Unknown tool: ${name}`);
+                    break;
+                }
+                tool
+                    .execute(params?.arguments || {})
+                    .then((data) => respond(id, { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] }))
+                    .catch((e) => respond(id, {
+                    content: [{ type: "text", text: `Error: ${e?.message || e}` }],
+                    isError: true,
+                }));
+                break;
+            }
+            case "ping":
+                respond(id, {});
+                break;
+            default:
+                if (id !== undefined)
+                    respondErr(id, -32601, `Method not found: ${method}`);
+        }
+    });
+    process.stderr.write("[ygl-trees MCP] stdio server ready — 8 tools\n");
+}

package/llms.txt

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