ygl-trees 0.79.1 → 0.81.0

package/dist/bundle/bin.cjs

@@ -2313,6 +2313,12 @@ var TreeStore = class {
 	* + unlocked set + the caller's state bag. The eval API demands a context
 	* package — bare state fell into the gray band 6/8 in the material's
 	* routing test, so we ship everything the tree knows about this node.
+	*
+	* 0.80: the rel fabric joins the package — evidence/claim/kb summaries
+	* attached to the node (either direction) land in `attachments`, so a
+	* decided-by chain is visible to the eval model without manually
+	* re-carrying facts via --state (user finding: P 0.30 → 0.92 gap).
+	* Bounded: ≤12 rows, text clipped to 120 chars.
 	*/
 	evalContext(treeId, keyOrId, stateBag, context = "default") {
 		const n = this.nodeGet(treeId, keyOrId);
@@ -2336,7 +2342,7 @@ var TreeStore = class {
 			effect: c.effect
 		}));
 		const unlocked = [...this.unlockedSet(treeId, context)].map((id) => idToKey.get(id) || id);
-		return {
+		const pkg = {
 			node: {
 				key: n.key,
 				name: n.name,
@@ -2350,6 +2356,62 @@ var TreeStore = class {
 			unlocked,
 			state: stateBag
 		};
+		const attachments = this.relAttachments(String(n.id));
+		if (attachments.length) pkg.attachments = attachments;
+		return pkg;
+	}
+	/** 0.80: rel-fabric summaries for the eval context package (both directions). */
+	relAttachments(nodeId) {
+		const rows = this.db.all(`SELECT rel, src_type, src_id, dst_type, dst_id FROM relations
+       WHERE (src_type='node' AND src_id=?) OR (dst_type='node' AND dst_id=?)
+       ORDER BY rowid LIMIT 12`, [nodeId, nodeId]);
+		const clip = (v, n = 120) => String(v ?? "").slice(0, n);
+		return rows.map((r) => {
+			const srcIsMe = r.src_type === "node" && r.src_id === nodeId;
+			const type = String(srcIsMe ? r.dst_type : r.src_type);
+			const id = String(srcIsMe ? r.dst_id : r.src_id);
+			const base = {
+				rel: String(r.rel),
+				type,
+				id
+			};
+			const q = (sql) => this.db.get(sql, [id]);
+			if (type === "claim") {
+				const c = q("SELECT text, status, confidence FROM claims WHERE id=?");
+				if (c) return {
+					...base,
+					text: clip(c.text),
+					status: c.status,
+					confidence: c.confidence
+				};
+			} else if (type === "evidence") {
+				const e = q("SELECT quote FROM evidence WHERE id=?");
+				if (e) return {
+					...base,
+					quote: clip(e.quote)
+				};
+			} else if (type === "kb") {
+				const k = q("SELECT title FROM kb_notes WHERE id=?");
+				if (k) return {
+					...base,
+					title: clip(k.title, 80)
+				};
+			} else if (type === "source") {
+				const s = q("SELECT title FROM sources WHERE id=?");
+				if (s) return {
+					...base,
+					title: clip(s.title, 80)
+				};
+			} else if (type === "node") {
+				const nd = q("SELECT key, name FROM nodes WHERE id=?");
+				if (nd) return {
+					...base,
+					key: nd.key,
+					name: clip(nd.name, 80)
+				};
+			}
+			return base;
+		});
 	}
 	/** Every node whose required gates are currently satisfied. */
 	ready(treeId, context = "default", state = {}) {
@@ -4965,6 +5027,19 @@ function run$12(env, action, rest, args) {
 			return 0;
 		}
 		case "timeline": {
+			const actorF = String(args.flags.actor || "");
+			const sessionF = String(args.flags.session || "");
+			const conds = [];
+			const params = [];
+			if (actorF) {
+				conds.push("actor=?");
+				params.push(actorF);
+			}
+			if (sessionF) {
+				conds.push(`payload LIKE ?`);
+				params.push(`%"session":"${sessionF}"%`);
+			}
+			const where = conds.length ? ` WHERE ${conds.join(" AND ")}` : "";
 			const days = db.all(`
         SELECT date(ts) as day, COUNT(*) as events,
           SUM(CASE WHEN kind LIKE 'project%' THEN 1 ELSE 0 END) as projects,
@@ -4972,21 +5047,23 @@ function run$12(env, action, rest, args) {
           SUM(CASE WHEN kind LIKE 'claim%' THEN 1 ELSE 0 END) as claims,
           SUM(CASE WHEN kind LIKE 'kb%' THEN 1 ELSE 0 END) as kb,
           SUM(CASE WHEN kind LIKE 'node%' THEN 1 ELSE 0 END) as nodes
-        FROM events GROUP BY date(ts) ORDER BY day
-      `);
+        FROM events${where} GROUP BY date(ts) ORDER BY day
+      `, params);
 			if (!days.length) {
 				ok(ctx, "no events yet");
 				return 0;
 			}
+			const tail = conds.length ? db.all(`SELECT ts, actor, kind, entity_id FROM events${where} ORDER BY ts DESC LIMIT 20`, params) : [];
 			if (ctx.json) {
 				console.log(JSON.stringify({
 					timeline: days,
-					total: days.reduce((s2, d) => s2 + d.events, 0)
+					total: days.reduce((s2, d) => s2 + d.events, 0),
+					...tail.length ? { tail } : {}
 				}, null, 2));
 				return 0;
 			}
 			const maxEvents = Math.max(...days.map((d) => d.events));
-			head(ctx, "Workspace Timeline");
+			head(ctx, `Workspace Timeline${actorF ? ` · actor=${actorF}` : ""}${sessionF ? ` · session=${sessionF}` : ""}`);
 			let totalP = 0, totalS = 0, totalC = 0, totalK = 0, totalN = 0;
 			for (const d of days) {
 				totalP += d.projects;
@@ -5006,6 +5083,11 @@ function run$12(env, action, rest, args) {
 			}
 			out(ctx, "");
 			out(ctx, paint(C.dim, `  累计: ${totalP}项目 · ${totalS}来源 · ${totalC}断言 · ${totalK}知识 · ${totalN}节点变更`, ctx.color));
+			if (tail.length) {
+				out(ctx, "");
+				out(ctx, paint(C.dim, `  最近 ${tail.length} 条（按时间倒序）:`, ctx.color));
+				for (const t of tail) out(ctx, `  ${String(t.ts).slice(0, 19)}  ${String(t.actor).padEnd(12)} ${String(t.kind).padEnd(14)} ${String(t.entity_id || "")}`);
+			}
 			return 0;
 		}
 		case "workspace": {
@@ -6492,6 +6574,10 @@ init_writes();
 init_entities$1();
 /** Run a write through the TypeORM transactional write service and print
 *  with JSON discipline. Keeps every write command 6 lines. */
+/** 0.80: compact timestamp for session:// adjudication urls (yyyymmddhhmm). */
+function nowCompact() {
+	return (/* @__PURE__ */ new Date()).toISOString().replace(/[-:T]/g, "").slice(0, 12);
+}
 function runWrite(env, fn, human) {
 	const { ctx } = env;
 	return getOrm(env.db.path).then(fn).then((r) => {
@@ -6616,14 +6702,24 @@ function run$8(env, action, rest, args) {
 				bad(ctx, "flag needs a value: --title \"...\" / --url \"...\"  (bare flag was treated as boolean)");
 				return 2;
 			}
-			const title = String(titleRaw || "");
-			const url = String(urlRaw || "");
+			let title = String(titleRaw || "");
+			let url = String(urlRaw || "");
+			const adjRaw = args.flags.adjudication;
+			if (adjRaw === true) {
+				bad(ctx, "flag needs a value: --adjudication \"<裁决摘要>\"");
+				return 2;
+			}
+			if (adjRaw !== void 0 && adjRaw !== "") {
+				const adj = String(adjRaw);
+				if (!url) url = `session://adjudication/${nowCompact()}`;
+				if (!title) title = adj.slice(0, 60);
+			}
 			if (!title && !url) {
 				bad(ctx, "need --title and/or --url");
 				return 2;
 			}
-			if (url && !/^https?:\/\/|^file:\/\//.test(url)) {
-				bad(ctx, `--url must be http(s):// or file:// (got: "${require_text.clip(url, 30)}")`);
+			if (url && !/^[a-z][a-z0-9+.-]*:\/\//i.test(url)) {
+				bad(ctx, `--url must be <scheme>:// — https://, file://, session://, a2a:// … (got: "${require_text.clip(url, 30)}")`);
 				return 2;
 			}
 			const spec = {
@@ -6895,11 +6991,16 @@ function run$8(env, action, rest, args) {
 	if (sub === "claim") {
 		if (subAction === "add") {
 			if (rejectBare(ctx, args.flags, ["confidence", "text"])) return 2;
-			if (validateEnum(ctx, args.flags, "confidence", [
-				"A",
-				"B",
-				"C"
-			])) return 2;
+			{
+				const raw = String(args.flags.confidence ?? "");
+				if (raw !== "" && !/^[ABC]$/.test(raw)) {
+					const n = Number(raw.replace(/%$/, ""));
+					if (!Number.isFinite(n) || n < 0 || n > 100) {
+						bad(ctx, `--confidence must be A|B|C or a number 0-1 / 0-100(%) (got: "${require_text.clip(raw, 20)}")`);
+						return 2;
+					}
+				}
+			}
 			const text = rest.slice(1).join(" ") || String(args.flags.text || "");
 			if (!text) {
 				bad(ctx, "missing claim text: research claim add \"<text>\"");
@@ -7331,151 +7432,480 @@ function run$7(env, action, rest, args) {
 	}
 }
 //#endregion
-//#region packages/research/produce/src/produce-cmds.ts
-/** 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__ */ require_rolldown_runtime.__exportAll({ run: () => run$6 });
+//#region packages/ops/tools/src/rels.ts
+var rels_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
+	REL_TYPES: () => REL_TYPES,
+	RelError: () => RelError,
+	relAdd: () => relAdd,
+	relRm: () => relRm,
+	resolveId: () => resolveId,
+	resolveRef: () => resolveRef,
+	run: () => run$6
+});
 init_fmt();
 require_text.init_text();
 init_orm();
-init_writes();
-function run$6(env, action, rest, args) {
-	const { ctx, store } = env;
-	if (env.group === "task") {
-		const map = {
-			add: "task-add",
-			list: "task-list",
-			doing: "task-status",
-			done: "task-status",
-			todo: "task-status"
+const REL_TYPES = [
+	"node",
+	"claim",
+	"evidence",
+	"source",
+	"query",
+	"kb",
+	"artifact",
+	"task",
+	"skill"
+];
+/** Resolve one `<type>:<ref>` against the database → { type, id, display }.
+*  Throws RelError(code) on unknown type / missing row. */
+var RelError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.code = code;
+	}
+};
+const DISPLAY = {
+	node: (db, ref) => {
+		const [treeName, key] = ref.includes("/") ? [ref.slice(0, ref.indexOf("/")), ref.slice(ref.indexOf("/") + 1)] : [null, ref];
+		const cur = treeName || db.metaGet("current_tree") || "";
+		if (!cur) throw new RelError(1, `no current tree — qualify as node:<tree>/${key} or run 'ygl-trees tree use <name>' first`);
+		const rows = db.all("SELECT n.id, n.key, n.name FROM nodes n JOIN trees t ON t.id=n.tree_id WHERE (t.name=? OR t.id=?) AND (n.key=? OR n.id=?)", [
+			cur,
+			cur,
+			key,
+			key
+		]);
+		if (!rows.length) throw new RelError(1, `node not found: ${ref}${treeName ? "" : ` (searched current tree '${cur}' — qualify as node:<tree>/${key} for another tree)`}`);
+		return {
+			id: String(rows[0].id),
+			display: String(rows[0].name || rows[0].key)
+		};
+	},
+	claim: (db, ref) => {
+		const r = db.get("SELECT id, text FROM claims WHERE id=? LIMIT 1", [ref]);
+		if (!r) throw new RelError(1, `claim not found: ${ref}`);
+		return {
+			id: String(r.id),
+			display: String(r.text).slice(0, 60)
+		};
+	},
+	evidence: (db, ref) => {
+		const r = db.get("SELECT id, quote FROM evidence WHERE id=? LIMIT 1", [ref]);
+		if (!r) throw new RelError(1, `evidence not found: ${ref}`);
+		return {
+			id: String(r.id),
+			display: String(r.quote).slice(0, 60)
+		};
+	},
+	source: (db, ref) => {
+		const r = db.get("SELECT id, title FROM sources WHERE id=? LIMIT 1", [ref]);
+		if (!r) throw new RelError(1, `source not found: ${ref}`);
+		return {
+			id: String(r.id),
+			display: String(r.title)
+		};
+	},
+	query: (db, ref) => {
+		const r = db.get("SELECT id, text FROM queries WHERE id=? LIMIT 1", [ref]);
+		if (!r) throw new RelError(1, `query not found: ${ref}`);
+		return {
+			id: String(r.id),
+			display: String(r.text).slice(0, 60)
+		};
+	},
+	kb: (db, ref) => {
+		const r = db.get("SELECT id, title FROM kb_notes WHERE id=? OR title=? LIMIT 1", [ref, ref]);
+		if (!r) throw new RelError(1, `kb note not found: ${ref}`);
+		return {
+			id: String(r.id),
+			display: String(r.title)
+		};
+	},
+	artifact: (db, ref) => {
+		const r = db.get("SELECT id, title FROM artifacts WHERE id=? OR title=? LIMIT 1", [ref, ref]);
+		if (!r) throw new RelError(1, `artifact not found: ${ref}`);
+		return {
+			id: String(r.id),
+			display: String(r.title)
+		};
+	},
+	task: (db, ref) => {
+		const r = db.get("SELECT id, title FROM artifacts WHERE kind='task' AND (id=? OR title=?) LIMIT 1", [ref, ref]);
+		if (!r) throw new RelError(1, `task not found: ${ref}`);
+		return {
+			id: String(r.id),
+			display: String(r.title)
+		};
+	},
+	skill: (db, ref) => {
+		const r = db.get("SELECT name, description FROM skills WHERE name=? LIMIT 1", [ref]);
+		if (!r) throw new RelError(1, `skill not found: ${ref}`);
+		return {
+			id: String(r.name),
+			display: String(r.name)
 		};
-		if (!action || !map[action]) {
-			bad(ctx, "usage: task add \"<title>\" [--note ...] | list [--status todo|doing|done] | todo|doing|done <id>");
-			return 2;
-		}
-		if (map[action] === "task-status") rest = [rest[0], action];
-		action = map[action];
 	}
-	let project;
+};
+function resolveRef(env, ref) {
+	const i = ref.indexOf(":");
+	if (i < 1) throw new RelError(2, `bad reference '${ref}' — want <type>:<ref> where type ∈ ${REL_TYPES.join("|")}`);
+	const type = ref.slice(0, i);
+	const ident = ref.slice(i + 1);
+	const fn = DISPLAY[type];
+	if (!fn) throw new RelError(2, `unknown reference type '${type}' — want ${REL_TYPES.join("|")}`);
+	const r = fn(env.db, ident);
+	return {
+		type,
+		id: r.id,
+		display: r.display
+	};
+}
+/** Reverse lookup: type+id → display (for the webui related section). */
+function resolveId(env, type, id) {
+	const fn = DISPLAY[type];
+	if (!fn) return id;
 	try {
-		project = store.projectResolve(args.flags.p ? String(args.flags.p) : void 0);
-	} catch (e) {
-		bad(ctx, e.message);
-		return 1;
+		return fn(env.db, id).display;
+	} catch {
+		return id;
 	}
-	const pid = project.id;
-	const readBody = () => {
-		if (args.flags.body) return String(args.flags.body);
-		if (args.flags.f) return node_fs.readFileSync(String(args.flags.f), "utf8");
-		return "";
-	};
-	switch (action) {
-		case "outline": {
-			const claims = store.claimList(pid);
-			const lines = [`# ${project.name}`, ""];
-			if (project.question) lines.push(`> ${project.question}`, "");
-			lines.push("## 结论要点", "");
-			if (!claims.length) lines.push("_（尚无 claim，先跑 research claim add）_", "");
-			claims.forEach((c, i) => {
-				const mark = c.status === "supported" ? "[已证实]" : c.status === "refuted" ? "[已推翻]" : c.status === "contested" ? "[存争议]" : "[待验证]";
-				lines.push(`${i + 1}. ${mark} ${c.text}`);
-			});
-			lines.push("", "## 证据基础", "");
-			const ev = store.evidenceList(pid);
-			if (!ev.length) lines.push("_（尚无 evidence）_", "");
-			ev.forEach((e, i) => lines.push(`- [${i + 1}] ${e.source}：${require_text.clip(e.quote, 80)}`));
-			const content = lines.join("\n");
-			return getOrm(env.db.path).then((ds) => artifactAdd(ds, pid, "outline", `${project.name} outline`, content)).then((r) => {
-				if (ctx.json) console.log(JSON.stringify(r.row, null, 2));
-				else {
-					ok(ctx, `outline generated: ${r.row.id} (v${r.version})`);
-					out(ctx, content);
-				}
-				return 0;
-			}).catch((e) => {
-				bad(ctx, e?.message || String(e));
-				return 1;
-			});
-		}
-		case "section": {
-			const title = rest[0] || String(args.flags.title || "");
-			const body = readBody();
-			if (!title || !body) {
-				bad(ctx, "usage: produce section <title> --body|-f <file>");
-				return 2;
-			}
-			return getOrm(env.db.path).then((ds) => artifactAdd(ds, pid, "section", title, body)).then((r) => {
-				if (ctx.json) console.log(JSON.stringify(r.row, null, 2));
-				else ok(ctx, `section saved: ${r.row.id} (v${r.version})`);
-				return 0;
-			}).catch((e) => {
-				bad(ctx, e?.message || String(e));
-				return 1;
-			});
-		}
-		case "spec": {
-			const title = rest[0] || String(args.flags.title || "");
-			const body = readBody();
-			if (args.flags["design-type"] !== void 0) {
-				bad(ctx, "--design-type belongs to 'produce design' (spec does not take it; if this is a design decision, use: produce design <title> --design-type decision)");
-				return 2;
-			}
-			if (!title || !body) {
-				bad(ctx, "usage: produce spec <title> --body|-f <file>");
-				return 2;
-			}
-			return getOrm(env.db.path).then((ds) => artifactAdd(ds, pid, "spec", title, body)).then((r) => {
-				if (ctx.json) console.log(JSON.stringify(r.row, null, 2));
-				else ok(ctx, `spec saved: ${r.row.id} (v${r.version})`);
-				return 0;
-			}).catch((e) => {
-				bad(ctx, e?.message || String(e));
-				return 1;
-			});
-		}
-		case "design": {
-			const title = rest[0] || String(args.flags.title || "");
-			const body = readBody();
-			const designType = String(args.flags["design-type"] || "arch");
-			if (!title || !body) {
-				bad(ctx, "usage: produce design <title> --body|-f <file> [--design-type ui-ux|arch|decision]");
-				return 2;
+}
+async function relAdd(env, srcRef, dstRef, rel = "related") {
+	const src = resolveRef(env, srcRef);
+	const dst = resolveRef(env, dstRef);
+	return (await getOrm(env.db.path)).transaction(async (mgr) => {
+		const ex = await mgr.query(`SELECT id FROM relations WHERE src_type=? AND src_id=? AND dst_type=? AND dst_id=? AND rel=?`, [
+			src.type,
+			src.id,
+			dst.type,
+			dst.id,
+			rel
+		]);
+		if (ex.length) return {
+			row: (await mgr.query(`SELECT * FROM relations WHERE id=?`, [ex[0].id]))[0],
+			duplicate: true
+		};
+		const id = require_text.shortId([
+			"rel",
+			src.id,
+			dst.id,
+			rel
+		], 10);
+		await mgr.query(`INSERT INTO relations(id,src_type,src_id,dst_type,dst_id,rel,weight,created) VALUES(?,?,?,?,?,?,1,?)`, [
+			id,
+			src.type,
+			src.id,
+			dst.type,
+			dst.id,
+			rel,
+			require_text.nowIso()
+		]);
+		await mgr.query(`INSERT INTO events(id,ts,actor,kind,entity,entity_id,payload) VALUES(?,?,?,?,?,?,?)`, [
+			require_text.shortId([
+				"ev",
+				"rel.add",
+				id
+			], 12),
+			require_text.nowIso(),
+			"cli",
+			"rel.add",
+			"relation",
+			id,
+			JSON.stringify({
+				src: `${src.type}:${src.id}`,
+				dst: `${dst.type}:${dst.id}`,
+				rel
+			})
+		]);
+		return {
+			row: (await mgr.query(`SELECT * FROM relations WHERE id=?`, [id]))[0],
+			duplicate: false
+		};
+	});
+}
+async function relRm(env, srcRef, dstRef, rel = "related") {
+	const src = resolveRef(env, srcRef);
+	const dst = resolveRef(env, dstRef);
+	await (await getOrm(env.db.path)).transaction(async (mgr) => {
+		if (!(await mgr.query(`SELECT id FROM relations WHERE src_type=? AND src_id=? AND dst_type=? AND dst_id=? AND rel=?`, [
+			src.type,
+			src.id,
+			dst.type,
+			dst.id,
+			rel
+		])).length) throw new RelError(1, `relation not found: ${srcRef} → ${dstRef} (${rel})`);
+		await mgr.query(`DELETE FROM relations WHERE src_type=? AND src_id=? AND dst_type=? AND dst_id=? AND rel=?`, [
+			src.type,
+			src.id,
+			dst.type,
+			dst.id,
+			rel
+		]);
+	});
+}
+function run$6(env, action, rest, args) {
+	const { ctx } = env;
+	if (action === "add") {
+		const [a, b] = rest;
+		if (!a || !b) {
+			bad(ctx, "usage: rel add <type>:<ref> <type>:<ref> [--rel <type>]");
+			return 2;
+		}
+		const rel = String(args.flags.rel || "related");
+		return (async () => {
+			try {
+				const r = await relAdd(env, a, b, rel);
+				if (ctx.json) {
+					console.log(JSON.stringify({
+						id: r.row.id,
+						src: `${r.row.src_type}:${r.row.src_id}`,
+						dst: `${r.row.dst_type}:${r.row.dst_id}`,
+						rel: r.row.rel,
+						duplicate: r.duplicate
+					}));
+					return 0;
+				}
+				if (r.duplicate) out(ctx, paint(C.yellow, `  ⚠ duplicate: ${a} ${rel} ${b} (already linked)`, ctx.color));
+				else ok(ctx, `linked: ${a} ${paint(C.dim, `—${rel}→`, ctx.color)} ${b}`);
+				return 0;
+			} catch (e) {
+				if (e instanceof RelError) {
+					bad(ctx, e.message);
+					return e.code;
+				}
+				throw e;
 			}
-			if (![
-				"ui-ux",
-				"arch",
-				"decision"
-			].includes(designType)) {
-				bad(ctx, "--design-type must be one of ui-ux|arch|decision");
-				return 2;
+		})();
+	}
+	if (action === "rm") {
+		const [a, b] = rest;
+		if (!a || !b) {
+			bad(ctx, "usage: rel rm <type>:<ref> <type>:<ref> [--rel <type>]");
+			return 2;
+		}
+		const rel = String(args.flags.rel || "related");
+		return (async () => {
+			try {
+				await relRm(env, a, b, rel);
+				if (ctx.json) console.log(JSON.stringify({ removed: `${a} -${rel}-> ${b}` }));
+				else ok(ctx, `unlinked: ${a} (${rel}) ${b}`);
+				return 0;
+			} catch (e) {
+				if (e instanceof RelError) {
+					bad(ctx, e.message);
+					return e.code;
+				}
+				throw e;
 			}
-			return getOrm(env.db.path).then((ds) => artifactAdd(ds, pid, "design", title, body, "markdown", JSON.stringify({ design_type: designType }))).then((r) => {
+		})();
+	}
+	if (action === "list" || action === "") {
+		const outRows = (() => {
+			const params = [];
+			let where = "1=1";
+			const srcF = String(args.flags.src || "");
+			const dstF = String(args.flags.dst || "");
+			const relF = String(args.flags.rel || "");
+			if (srcF) {
+				const s = resolveRef(env, srcF);
+				where += " AND src_type=? AND src_id=?";
+				params.push(s.type, s.id);
+			}
+			if (dstF) {
+				const d = resolveRef(env, dstF);
+				where += " AND dst_type=? AND dst_id=?";
+				params.push(d.type, d.id);
+			}
+			if (relF) {
+				where += " AND rel=?";
+				params.push(relF);
+			}
+			return env.db.all(`SELECT * FROM relations WHERE ${where} ORDER BY rowid DESC LIMIT 200`, params);
+		})().map((r) => ({
+			src: `${r.src_type}:${r.src_id}`,
+			dst: `${r.dst_type}:${r.dst_id}`,
+			rel: r.rel,
+			src_display: resolveId(env, r.src_type, r.src_id),
+			dst_display: resolveId(env, r.dst_type, r.dst_id)
+		}));
+		if (ctx.json) {
+			console.log(JSON.stringify(outRows, null, 2));
+			return 0;
+		}
+		head(ctx, `Relations (${outRows.length})`);
+		table(ctx, outRows, [
+			"src",
+			"rel",
+			"dst"
+		], [
+			"src_display",
+			"rel",
+			"dst_display"
+		]);
+		return 0;
+	}
+	bad(ctx, "usage: rel [add|rm|list] ...  (see ygl-trees help)");
+	return 2;
+}
+//#endregion
+//#region packages/research/produce/src/produce-cmds.ts
+/** 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__ */ require_rolldown_runtime.__exportAll({ run: () => run$5 });
+init_fmt();
+require_text.init_text();
+init_orm();
+init_writes();
+function run$5(env, action, rest, args) {
+	const { ctx, store } = env;
+	if (env.group === "task") {
+		const map = {
+			add: "task-add",
+			list: "task-list",
+			doing: "task-status",
+			done: "task-status",
+			todo: "task-status"
+		};
+		if (!action || !map[action]) {
+			bad(ctx, "usage: task add \"<title>\" [--note ...] | list [--status todo|doing|done] | todo|doing|done <id>");
+			return 2;
+		}
+		if (map[action] === "task-status") rest = [rest[0], action];
+		action = map[action];
+	}
+	let project;
+	try {
+		project = store.projectResolve(args.flags.p ? String(args.flags.p) : void 0);
+	} catch (e) {
+		bad(ctx, e.message);
+		return 1;
+	}
+	const pid = project.id;
+	const readBody = () => {
+		if (args.flags.body) return String(args.flags.body);
+		if (args.flags.f) return node_fs.readFileSync(String(args.flags.f), "utf8");
+		return "";
+	};
+	switch (action) {
+		case "outline": {
+			const claims = store.claimList(pid);
+			const lines = [`# ${project.name}`, ""];
+			if (project.question) lines.push(`> ${project.question}`, "");
+			lines.push("## 结论要点", "");
+			if (!claims.length) lines.push("_（尚无 claim，先跑 research claim add）_", "");
+			claims.forEach((c, i) => {
+				const mark = c.status === "supported" ? "[已证实]" : c.status === "refuted" ? "[已推翻]" : c.status === "contested" ? "[存争议]" : "[待验证]";
+				lines.push(`${i + 1}. ${mark} ${c.text}`);
+			});
+			lines.push("", "## 证据基础", "");
+			const ev = store.evidenceList(pid);
+			if (!ev.length) lines.push("_（尚无 evidence）_", "");
+			ev.forEach((e, i) => lines.push(`- [${i + 1}] ${e.source}：${require_text.clip(e.quote, 80)}`));
+			const content = lines.join("\n");
+			return getOrm(env.db.path).then((ds) => artifactAdd(ds, pid, "outline", `${project.name} outline`, content)).then((r) => {
 				if (ctx.json) console.log(JSON.stringify(r.row, null, 2));
-				else ok(ctx, `design saved: ${r.row.id} (v${r.version}) [${designType}]`);
+				else {
+					ok(ctx, `outline generated: ${r.row.id} (v${r.version})`);
+					out(ctx, content);
+				}
 				return 0;
 			}).catch((e) => {
 				bad(ctx, e?.message || String(e));
 				return 1;
 			});
 		}
-		case "task-add": {
-			if (rejectBare(ctx, args.flags, ["note"])) return 2;
-			const title = rest.join(" ");
-			if (!title) {
-				bad(ctx, "usage: task add \"<title>\" [--note ...]");
+		case "section": {
+			const title = rest[0] || String(args.flags.title || "");
+			const body = readBody();
+			if (!title || !body) {
+				bad(ctx, "usage: produce section <title> --body|-f <file>");
 				return 2;
 			}
-			const note = String(args.flags.note || "");
-			return getOrm(env.db.path).then((ds) => taskAdd(ds, pid, title, note)).then((row) => {
-				if (ctx.json) console.log(JSON.stringify(row, null, 2));
-				else ok(ctx, `task added: ${row.id}  ${title}`);
+			return getOrm(env.db.path).then((ds) => artifactAdd(ds, pid, "section", title, body)).then((r) => {
+				if (ctx.json) console.log(JSON.stringify(r.row, null, 2));
+				else ok(ctx, `section saved: ${r.row.id} (v${r.version})`);
+				return 0;
+			}).catch((e) => {
+				bad(ctx, e?.message || String(e));
+				return 1;
+			});
+		}
+		case "spec": {
+			const title = rest[0] || String(args.flags.title || "");
+			const body = readBody();
+			if (args.flags["design-type"] !== void 0) {
+				bad(ctx, "--design-type belongs to 'produce design' (spec does not take it; if this is a design decision, use: produce design <title> --design-type decision)");
+				return 2;
+			}
+			if (!title || !body) {
+				bad(ctx, "usage: produce spec <title> --body|-f <file>");
+				return 2;
+			}
+			return getOrm(env.db.path).then((ds) => artifactAdd(ds, pid, "spec", title, body)).then((r) => {
+				if (ctx.json) console.log(JSON.stringify(r.row, null, 2));
+				else ok(ctx, `spec saved: ${r.row.id} (v${r.version})`);
+				return 0;
+			}).catch((e) => {
+				bad(ctx, e?.message || String(e));
+				return 1;
+			});
+		}
+		case "design": {
+			const title = rest[0] || String(args.flags.title || "");
+			const body = readBody();
+			const designType = String(args.flags["design-type"] || "arch");
+			if (!title || !body) {
+				bad(ctx, "usage: produce design <title> --body|-f <file> [--design-type ui-ux|arch|decision]");
+				return 2;
+			}
+			if (![
+				"ui-ux",
+				"arch",
+				"decision"
+			].includes(designType)) {
+				bad(ctx, "--design-type must be one of ui-ux|arch|decision");
+				return 2;
+			}
+			return getOrm(env.db.path).then((ds) => artifactAdd(ds, pid, "design", title, body, "markdown", JSON.stringify({ design_type: designType }))).then((r) => {
+				if (ctx.json) console.log(JSON.stringify(r.row, null, 2));
+				else ok(ctx, `design saved: ${r.row.id} (v${r.version}) [${designType}]`);
 				return 0;
 			}).catch((e) => {
 				bad(ctx, e?.message || String(e));
 				return 1;
 			});
 		}
+		case "task-add": {
+			if (rejectBare(ctx, args.flags, ["note", "node"])) return 2;
+			const title = rest.join(" ");
+			if (!title) {
+				bad(ctx, "usage: task add \"<title>\" [--note ...] [--node <tree>/<key>]");
+				return 2;
+			}
+			const note = String(args.flags.note || "");
+			const nodeRef = args.flags.node !== void 0 ? String(args.flags.node) : "";
+			return getOrm(env.db.path).then((ds) => taskAdd(ds, pid, title, note)).then((row) => {
+				if (!nodeRef) {
+					if (ctx.json) console.log(JSON.stringify(row, null, 2));
+					else ok(ctx, `task added: ${row.id}  ${title}`);
+					return 0;
+				}
+				return relAdd(env, `node:${nodeRef}`, `task:${row.id}`, "tracked-by").then((r) => {
+					if (ctx.json) console.log(JSON.stringify({
+						...row,
+						node: nodeRef,
+						relation: "tracked-by"
+					}, null, 2));
+					else ok(ctx, `task added: ${row.id}  ${title}  (tracked-by node:${nodeRef})`);
+					return 0;
+				});
+			}).catch((e) => {
+				bad(ctx, e?.message || String(e));
+				return e instanceof RelError && e.code === 2 ? 2 : 1;
+			});
+		}
 		case "task-list": {
 			const rows = store.db.all("SELECT id, title, meta, created FROM artifacts WHERE project_id=? AND kind='task' ORDER BY created DESC", [pid]).map((r) => {
 				let meta = {};
@@ -8010,6 +8440,41 @@ async function condAdd(ds, treeId, keyOrId, o) {
 		return (await mgr.query(`SELECT * FROM node_conditions WHERE id=?`, [id]))[0];
 	});
 }
+/** 0.81: `node cond rm <key> --name <n>` — remove one condition by natural
+* key. Throws "node not found" / "condition not found: <name> (node X has:
+* ...)" (named, per frozen contract ④). Mirrors condAdd: transactional +
+* event (node.cond-rm) + markDirty. */
+async function condRemove(ds, treeId, keyOrId, name) {
+	return ds.transaction(async (mgr) => {
+		const n = await mgr.query(`SELECT id FROM nodes WHERE tree_id=? AND (key=? OR id=?)`, [
+			treeId,
+			keyOrId,
+			keyOrId
+		]);
+		if (!n.length) throw new Error(`node not found: ${keyOrId}`);
+		const existing = await mgr.query(`SELECT * FROM node_conditions WHERE node_id=? AND name=?`, [n[0].id, name]);
+		if (!existing.length) {
+			const have = (await mgr.query(`SELECT name FROM node_conditions WHERE node_id=?`, [n[0].id])).map((r) => r.name).join(", ") || "(none)";
+			throw new Error(`condition not found: ${name} (node ${keyOrId} has: ${have})`);
+		}
+		const row = existing[0];
+		await mgr.query(`DELETE FROM node_conditions WHERE id=?`, [row.id]);
+		await markDirty(mgr, treeId);
+		await logEvent(mgr, "node.cond-rm", row.id, {
+			tree: treeId,
+			node: keyOrId,
+			name,
+			kind: row.kind,
+			op: row.op,
+			required: !!row.required,
+			effect: row.effect
+		});
+		return {
+			...row,
+			removed: true
+		};
+	});
+}
 async function stateSet(ds, treeId, keyOrId, status, context = "default", level = 0) {
 	return ds.transaction(async (mgr) => {
 		const n = await mgr.query(`SELECT id FROM nodes WHERE tree_id=? AND (key=? OR id=?)`, [
@@ -8240,12 +8705,12 @@ 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__ */ require_rolldown_runtime.__exportAll({ run: () => run$5 });
+var cmds_exports$1 = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run$4 });
 init_fmt();
 init_orm();
 init_eval();
 require_text.init_text();
-function run$5(env, action, rest, args) {
+function run$4(env, action, rest, args) {
 	const { ctx, db } = env;
 	const trees = new TreeStore(db);
 	const sel = args.flags.t ? String(args.flags.t) : void 0;
@@ -8429,10 +8894,25 @@ function run$5(env, action, rest, args) {
 			});
 		}
 		if (sub === "cond") {
-			if (!key) {
-				bad(ctx, "usage: node cond <key> --name <cond> [--kind ..] [--op >=|==|<=|!=|has] [--value n] [--op eval [--value q] | eval-choice --options k=d,.. --answer k | eval-score --levels a,b,.. --min-score n] [--optional] [--effect gate|cost_mul] [--weight n]");
+			let cKey = key;
+			const cAct = key === "add" ? "add" : key === "rm" || key === "remove" ? "rm" : "";
+			if (cAct) cKey = rest[1];
+			if (cAct === "rm") {
+				const name = flagStr("name");
+				if (!cKey || !name) {
+					bad(ctx, "usage: node cond rm <key> --name <cond>");
+					return 2;
+				}
+				return runTreeWrite((ds) => condRemove(ds, tid, cKey, name), (r) => {
+					ok(ctx, `condition removed: ${cKey} · ${name}  (was ${r.required ? "必检" : "可选"}/${r.effect})`);
+					return 0;
+				});
+			}
+			if (!cKey) {
+				bad(ctx, "usage: node cond [add|rm] <key> --name <cond> [--kind ..] [--op >=|==|<=|!=|has] [--value n] [--op eval [--value q] | eval-choice --options k=d,.. --answer k | eval-score --levels a,b,.. --min-score n] [--optional] [--effect gate|cost_mul] [--weight n]");
 				return 2;
 			}
+			const k = cKey;
 			if (rejectBare(ctx, args.flags, [
 				"name",
 				"value",
@@ -8457,7 +8937,7 @@ function run$5(env, action, rest, args) {
 			if (validateEnum(ctx, args.flags, "effect", ["gate", "cost_mul"])) return 2;
 			const name = flagStr("name");
 			if (!name) {
-				table(ctx, trees.condList(tid, key), [
+				table(ctx, trees.condList(tid, k), [
 					"id",
 					"name",
 					"kind",
@@ -8513,7 +8993,7 @@ function run$5(env, action, rest, args) {
 					value = packEvalScoreSpec(q, levels, min);
 				}
 			}
-			return runTreeWrite((ds) => condAdd(ds, tid, key, {
+			return runTreeWrite((ds) => condAdd(ds, tid, k, {
 				name,
 				kind: flagStr("kind", "flag"),
 				expr: flagStr("expr") || void 0,
@@ -8523,7 +9003,7 @@ function run$5(env, action, rest, args) {
 				effect: flagStr("effect", "gate"),
 				weight: flagNum("weight", 1)
 			}), (c) => {
-				ack(ctx, c, `condition added: ${key} · ${c.name}  [${c.required ? "必检" : "可选"}/${c.effect}]`);
+				ack(ctx, c, `condition added: ${k} · ${c.name}  [${c.required ? "必检" : "可选"}/${c.effect}]`);
 				return 0;
 			});
 		}
@@ -9005,6 +9485,14 @@ function run$5(env, action, rest, args) {
 			return 0;
 		}
 		if (sub === "list" || sub === void 0) {
+			for (const f of Object.keys(args.flags || {})) if (![
+				"t",
+				"json",
+				"no-color"
+			].includes(f)) {
+				bad(ctx, `unknown flag --${f} for 'node list' — tree selection is '-t <tree>' (positional <tree> also works)`);
+				return 2;
+			}
 			table(ctx, trees.nodeList(tid), [
 				"key",
 				"name",
@@ -9235,12 +9723,12 @@ function loadStateFile(args, shared) {
 //#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__ */ require_rolldown_runtime.__exportAll({ run: () => run$4 });
+var skill_cmds_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run$3 });
 init_fmt();
 require_text.init_text();
 init_orm();
 init_writes();
-function run$4(env, action, rest, args) {
+function run$3(env, action, rest, args) {
 	const { ctx, store } = env;
 	const name = rest[0];
 	const need = (v, what) => {
@@ -9342,7 +9830,7 @@ function run$4(env, action, rest, args) {
 		case "add": {
 			const n = args.flags.name ? String(args.flags.name) : "";
 			const file = args.flags.f ? String(args.flags.f) : "";
-			if (file) return run$4(env, "import", [file], args);
+			if (file) return run$3(env, "import", [file], args);
 			if (!need(n, "--name")) return 2;
 			const body = args.flags.body ? String(args.flags.body) : args.flags["body-file"] ? node_fs.readFileSync(String(args.flags["body-file"]), "utf8") : "";
 			const spec = {
@@ -9570,12 +10058,13 @@ 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__ */ require_rolldown_runtime.__exportAll({ run: () => run$3 });
+var cmds_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run$2 });
 init_fmt();
 require_text.init_text();
+init_eventbus();
 init_orm();
 init_writes();
-function run$3(env, action, rest, args) {
+function run$2(env, action, rest, args) {
 	const { ctx, store } = env;
 	const readBody = () => {
 		if (args.flags.body) return String(args.flags.body);
@@ -9708,493 +10197,215 @@ function run$3(env, action, rest, args) {
 				"conf",
 				"reuse",
 				"updated"
-			], [
-				"id",
-				"title",
-				"tags",
-				"confidence",
-				"reuse",
-				"updated"
-			], "kb add --title ... --body ... | kb import <dir>");
-			return 0;
-		case "rm":
-		case "remove": {
-			const id = rest[0];
-			if (!id) {
-				bad(ctx, "usage: kb rm <id>");
-				return 2;
-			}
-			const note = store.kbGet(id);
-			if (!note) {
-				bad(ctx, `note not found: ${id}`);
-				return 1;
-			}
-			store.db.run("DELETE FROM kb_fts WHERE id=?", [id]);
-			store.db.run("DELETE FROM kb_notes WHERE id=?", [id]);
-			ok(ctx, `note removed: ${id}  ${String(note.title || "").slice(0, 40)}`);
-			return 0;
-		}
-		case "show": {
-			const n = store.kbGet(rest[0]);
-			if (!n) {
-				bad(ctx, `note not found: ${rest[0]}`);
-				return 1;
-			}
-			if (ctx.json) {
-				console.log(JSON.stringify(n, null, 2));
-				return 0;
-			}
-			head(ctx, n.title);
-			show(ctx, {
-				id: n.id,
-				tags: n.tags || "-",
-				confidence: n.confidence,
-				reuse: n.reuse,
-				origin: n.origin || "-"
-			});
-			out(ctx, "");
-			out(ctx, n.body);
-			const links = store.kbLinks(n.id);
-			if (links.length) {
-				out(ctx, paint(C.bold, "\n  links", ctx.color));
-				for (const l of links) out(ctx, `  - ${l.rel}: ${l.other}`);
-			}
-			return 0;
-		}
-		case "link": {
-			const a = store.kbGet(rest[0]);
-			const b = store.kbGet(rest[1]);
-			if (!a || !b) {
-				bad(ctx, "both notes must exist");
-				return 1;
-			}
-			store.kbLink(a.id, b.id, String(args.flags.rel || "related"));
-			ok(ctx, `linked ${a.title} --${args.flags.rel || "related"}--> ${b.title}`);
-			return 0;
-		}
-		case "ingest": {
-			if (!rest[0]) {
-				bad(ctx, "usage: kb ingest <artifactId> [--force]");
-				return 2;
-			}
-			const forceKb = args.flags.force === true || args.flags.force === "true";
-			return getOrm(env.db.path).then((ds) => kbIngestArtifact(ds, rest[0], forceKb)).then((r) => {
-				writeResult(ctx, r, (row) => `artifact ingested into kb: ${row.id}  ${require_text.clip(row.title, 50)}`);
-				return 0;
-			}).catch((e) => {
-				bad(ctx, e?.message || String(e));
-				return 1;
-			});
-		}
-		case "promote": {
-			if (!rest[0]) {
-				bad(ctx, "usage: kb promote <noteId> [--name <skill>]");
-				return 2;
-			}
-			const note = store.kbGet(rest[0]);
-			if (!note) {
-				bad(ctx, `kb note not found: ${rest[0]}`);
-				return 1;
-			}
-			const name = args.flags.name ? String(args.flags.name) : note.title;
-			return getOrm(env.db.path).then((ds) => skillUpsert(ds, {
-				name,
-				description: deriveL1(note.body || "", note.title),
-				body: note.body,
-				tags: note.tags,
-				origin: `kb:${note.id}`
-			})).then((s) => {
-				ok(ctx, `promoted to skill: ${s.name}`);
-				out(ctx, paint(C.dim, `  L1: ${require_text.clip(String(s.description), 100)}`, ctx.color));
-				return 0;
-			}).catch((e) => {
-				bad(ctx, e?.message || String(e));
-				return 1;
-			});
-		}
-		case "import": {
-			const target = rest[0];
-			if (!target) {
-				bad(ctx, "usage: kb import <dir|file.md> [--tags ..]");
-				return 2;
-			}
-			let st;
-			try {
-				st = node_fs.statSync(target);
-			} catch {
-				bad(ctx, `not found: ${target}`);
-				return 1;
-			}
-			const files = [];
-			if (st.isFile()) files.push(target);
-			else for (const f of node_fs.readdirSync(target, { recursive: true })) if (String(f).toLowerCase().endsWith(".md")) files.push(node_path.join(target, String(f)));
-			if (!files.length) {
-				bad(ctx, `no .md files under ${target}`);
-				return 1;
-			}
-			files.sort();
-			const MAX_FILE_BYTES = 1048576;
-			const skipped = [];
-			const importable = files.filter((f) => {
-				const sz = node_fs.statSync(f).size;
-				if (sz > MAX_FILE_BYTES && !args.flags.force) {
-					skipped.push({
-						file: f,
-						size: `${(sz / 1024 / 1024).toFixed(1)}MB`
-					});
-					return false;
-				}
-				return true;
-			});
-			if (skipped.length && !ctx.json) {
-				out(ctx, paint(C.yellow, `  ! skipped ${skipped.length} file(s) >1MB (--force to include):`, ctx.color));
-				for (const sk of skipped) out(ctx, paint(C.dim, `    ${sk.file}  (${sk.size})`, ctx.color));
-			}
-			if (!importable.length) {
-				bad(ctx, `all ${files.length} file(s) exceeded 1MB limit — use --force to import anyway`);
-				return 1;
-			}
-			const items = importable.map((f) => {
-				const raw = node_fs.readFileSync(f, "utf8");
-				const { meta, body } = require_text.parseFrontmatter(raw);
-				const heading = /^#\s+(.+)\s*$/m.exec(body)?.[1]?.trim();
-				return {
-					title: meta.title || meta.name || heading || node_path.basename(f, ".md"),
-					body,
-					tags: meta.tags || String(args.flags.tags || ""),
-					source_url: meta.url || "",
-					confidence: meta.confidence || "B",
-					origin: `import:${f}`
-				};
-			});
-			return getOrm(env.db.path).then((ds) => kbImportBulk(ds, items)).then((r) => {
-				if (ctx.json) console.log(JSON.stringify({
-					added: r.added,
-					duplicates: r.dups,
-					files: files.length,
-					target
-				}, null, 2));
-				else ok(ctx, `kb import: ${r.added} added, ${r.dups} duplicate(s) kept — ${files.length} file(s) from ${target}`);
-				return 0;
-			}).catch((e) => {
-				bad(ctx, e?.message || String(e));
-				return 1;
-			});
-		}
-		case "":
-			out(ctx, paint(C.dim, "  kb: add | import <dir|file> | search | list | show | link | ingest <artifactId> | promote <noteId>", ctx.color));
-			return 0;
-		default:
-			bad(ctx, `unknown kb action: ${action}`);
-			return 2;
-	}
-}
-//#endregion
-//#region packages/ops/tools/src/rels.ts
-var rels_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
-	REL_TYPES: () => REL_TYPES,
-	RelError: () => RelError,
-	relAdd: () => relAdd,
-	relRm: () => relRm,
-	resolveId: () => resolveId,
-	resolveRef: () => resolveRef,
-	run: () => run$2
-});
-init_fmt();
-require_text.init_text();
-init_orm();
-const REL_TYPES = [
-	"node",
-	"claim",
-	"evidence",
-	"source",
-	"query",
-	"kb",
-	"artifact",
-	"skill"
-];
-/** Resolve one `<type>:<ref>` against the database → { type, id, display }.
-*  Throws RelError(code) on unknown type / missing row. */
-var RelError = class extends Error {
-	code;
-	constructor(code, message) {
-		super(message);
-		this.code = code;
-	}
-};
-const DISPLAY = {
-	node: (db, ref) => {
-		const [treeName, key] = ref.includes("/") ? [ref.slice(0, ref.indexOf("/")), ref.slice(ref.indexOf("/") + 1)] : [null, ref];
-		const cur = treeName || db.metaGet("current_tree") || "";
-		const rows = db.all("SELECT n.id, n.key, n.name FROM nodes n JOIN trees t ON t.id=n.tree_id WHERE (t.name=? OR t.id=?) AND (n.key=? OR n.id=?)", [
-			cur,
-			cur,
-			key,
-			key
-		]);
-		if (!rows.length) throw new RelError(1, `node not found: ${ref}`);
-		return {
-			id: String(rows[0].id),
-			display: String(rows[0].name || rows[0].key)
-		};
-	},
-	claim: (db, ref) => {
-		const r = db.get("SELECT id, text FROM claims WHERE id=? LIMIT 1", [ref]);
-		if (!r) throw new RelError(1, `claim not found: ${ref}`);
-		return {
-			id: String(r.id),
-			display: String(r.text).slice(0, 60)
-		};
-	},
-	evidence: (db, ref) => {
-		const r = db.get("SELECT id, quote FROM evidence WHERE id=? LIMIT 1", [ref]);
-		if (!r) throw new RelError(1, `evidence not found: ${ref}`);
-		return {
-			id: String(r.id),
-			display: String(r.quote).slice(0, 60)
-		};
-	},
-	source: (db, ref) => {
-		const r = db.get("SELECT id, title FROM sources WHERE id=? LIMIT 1", [ref]);
-		if (!r) throw new RelError(1, `source not found: ${ref}`);
-		return {
-			id: String(r.id),
-			display: String(r.title)
-		};
-	},
-	query: (db, ref) => {
-		const r = db.get("SELECT id, text FROM queries WHERE id=? LIMIT 1", [ref]);
-		if (!r) throw new RelError(1, `query not found: ${ref}`);
-		return {
-			id: String(r.id),
-			display: String(r.text).slice(0, 60)
-		};
-	},
-	kb: (db, ref) => {
-		const r = db.get("SELECT id, title FROM kb_notes WHERE id=? OR title=? LIMIT 1", [ref, ref]);
-		if (!r) throw new RelError(1, `kb note not found: ${ref}`);
-		return {
-			id: String(r.id),
-			display: String(r.title)
-		};
-	},
-	artifact: (db, ref) => {
-		const r = db.get("SELECT id, title FROM artifacts WHERE id=? OR title=? LIMIT 1", [ref, ref]);
-		if (!r) throw new RelError(1, `artifact not found: ${ref}`);
-		return {
-			id: String(r.id),
-			display: String(r.title)
-		};
-	},
-	skill: (db, ref) => {
-		const r = db.get("SELECT name, description FROM skills WHERE name=? LIMIT 1", [ref]);
-		if (!r) throw new RelError(1, `skill not found: ${ref}`);
-		return {
-			id: String(r.name),
-			display: String(r.name)
-		};
-	}
-};
-function resolveRef(env, ref) {
-	const i = ref.indexOf(":");
-	if (i < 1) throw new RelError(2, `bad reference '${ref}' — want <type>:<ref> where type ∈ ${REL_TYPES.join("|")}`);
-	const type = ref.slice(0, i);
-	const ident = ref.slice(i + 1);
-	const fn = DISPLAY[type];
-	if (!fn) throw new RelError(2, `unknown reference type '${type}' — want ${REL_TYPES.join("|")}`);
-	const r = fn(env.db, ident);
-	return {
-		type,
-		id: r.id,
-		display: r.display
-	};
-}
-/** Reverse lookup: type+id → display (for the webui related section). */
-function resolveId(env, type, id) {
-	const fn = DISPLAY[type];
-	if (!fn) return id;
-	try {
-		return fn(env.db, id).display;
-	} catch {
-		return id;
-	}
-}
-async function relAdd(env, srcRef, dstRef, rel = "related") {
-	const src = resolveRef(env, srcRef);
-	const dst = resolveRef(env, dstRef);
-	return (await getOrm(env.db.path)).transaction(async (mgr) => {
-		const ex = await mgr.query(`SELECT id FROM relations WHERE src_type=? AND src_id=? AND dst_type=? AND dst_id=? AND rel=?`, [
-			src.type,
-			src.id,
-			dst.type,
-			dst.id,
-			rel
-		]);
-		if (ex.length) return {
-			row: (await mgr.query(`SELECT * FROM relations WHERE id=?`, [ex[0].id]))[0],
-			duplicate: true
-		};
-		const id = require_text.shortId([
-			"rel",
-			src.id,
-			dst.id,
-			rel
-		], 10);
-		await mgr.query(`INSERT INTO relations(id,src_type,src_id,dst_type,dst_id,rel,weight,created) VALUES(?,?,?,?,?,?,1,?)`, [
-			id,
-			src.type,
-			src.id,
-			dst.type,
-			dst.id,
-			rel,
-			require_text.nowIso()
-		]);
-		await mgr.query(`INSERT INTO events(id,ts,actor,kind,entity,entity_id,payload) VALUES(?,?,?,?,?,?,?)`, [
-			require_text.shortId([
-				"ev",
-				"rel.add",
-				id
-			], 12),
-			require_text.nowIso(),
-			"cli",
-			"rel.add",
-			"relation",
-			id,
-			JSON.stringify({
-				src: `${src.type}:${src.id}`,
-				dst: `${dst.type}:${dst.id}`,
-				rel
-			})
-		]);
-		return {
-			row: (await mgr.query(`SELECT * FROM relations WHERE id=?`, [id]))[0],
-			duplicate: false
-		};
-	});
-}
-async function relRm(env, srcRef, dstRef, rel = "related") {
-	const src = resolveRef(env, srcRef);
-	const dst = resolveRef(env, dstRef);
-	await (await getOrm(env.db.path)).transaction(async (mgr) => {
-		if (!(await mgr.query(`SELECT id FROM relations WHERE src_type=? AND src_id=? AND dst_type=? AND dst_id=? AND rel=?`, [
-			src.type,
-			src.id,
-			dst.type,
-			dst.id,
-			rel
-		])).length) throw new RelError(1, `relation not found: ${srcRef} → ${dstRef} (${rel})`);
-		await mgr.query(`DELETE FROM relations WHERE src_type=? AND src_id=? AND dst_type=? AND dst_id=? AND rel=?`, [
-			src.type,
-			src.id,
-			dst.type,
-			dst.id,
-			rel
-		]);
-	});
-}
-function run$2(env, action, rest, args) {
-	const { ctx } = env;
-	if (action === "add") {
-		const [a, b] = rest;
-		if (!a || !b) {
-			bad(ctx, "usage: rel add <type>:<ref> <type>:<ref> [--rel <type>]");
-			return 2;
-		}
-		const rel = String(args.flags.rel || "related");
-		return (async () => {
+			], [
+				"id",
+				"title",
+				"tags",
+				"confidence",
+				"reuse",
+				"updated"
+			], "kb add --title ... --body ... | kb import <dir>");
+			return 0;
+		case "rm":
+		case "remove": {
+			const id = rest[0];
+			if (!id) {
+				bad(ctx, "usage: kb rm <id>");
+				return 2;
+			}
+			const note = store.kbGet(id);
+			if (!note) {
+				bad(ctx, `note not found: ${id}`);
+				return 1;
+			}
+			store.db.run("DELETE FROM kb_fts WHERE id=?", [id]);
+			store.db.run("DELETE FROM kb_notes WHERE id=?", [id]);
 			try {
-				const r = await relAdd(env, a, b, rel);
-				if (ctx.json) {
-					console.log(JSON.stringify({
-						id: r.row.id,
-						src: `${r.row.src_type}:${r.row.src_id}`,
-						dst: `${r.row.dst_type}:${r.row.dst_id}`,
-						rel: r.row.rel,
-						duplicate: r.duplicate
-					}));
-					return 0;
-				}
-				if (r.duplicate) out(ctx, paint(C.yellow, `  ⚠ duplicate: ${a} ${rel} ${b} (already linked)`, ctx.color));
-				else ok(ctx, `linked: ${a} ${paint(C.dim, `—${rel}→`, ctx.color)} ${b}`);
+				const ev = {
+					id: `ev${Date.now().toString(36)}${Math.random().toString(36).slice(2, 6)}`,
+					ts: (/* @__PURE__ */ new Date()).toISOString(),
+					actor: process.env.YGL_SESSION || "cli",
+					kind: "kb.rm",
+					entity: "kb_note",
+					entity_id: id,
+					payload: JSON.stringify({ title: String(note.title || "") }),
+					level: "info"
+				};
+				store.db.run("INSERT INTO events(id,ts,actor,kind,entity,entity_id,payload,level) VALUES(?,?,?,?,?,?,?,?)", [
+					ev.id,
+					ev.ts,
+					ev.actor,
+					ev.kind,
+					ev.entity,
+					ev.entity_id,
+					ev.payload,
+					ev.level
+				]);
+				emitEvent({
+					kind: "kb.rm",
+					entity: "kb_note",
+					entityId: id,
+					payload: JSON.stringify({ title: String(note.title || "") }),
+					ts: ev.ts
+				});
+			} catch {}
+			ok(ctx, `note removed: ${id}  ${String(note.title || "").slice(0, 40)}`);
+			return 0;
+		}
+		case "show": {
+			const n = store.kbGet(rest[0]);
+			if (!n) {
+				bad(ctx, `note not found: ${rest[0]}`);
+				return 1;
+			}
+			if (ctx.json) {
+				console.log(JSON.stringify(n, null, 2));
 				return 0;
-			} catch (e) {
-				if (e instanceof RelError) {
-					bad(ctx, e.message);
-					return e.code;
-				}
-				throw e;
 			}
-		})();
-	}
-	if (action === "rm") {
-		const [a, b] = rest;
-		if (!a || !b) {
-			bad(ctx, "usage: rel rm <type>:<ref> <type>:<ref> [--rel <type>]");
-			return 2;
+			head(ctx, n.title);
+			show(ctx, {
+				id: n.id,
+				tags: n.tags || "-",
+				confidence: n.confidence,
+				reuse: n.reuse,
+				origin: n.origin || "-"
+			});
+			out(ctx, "");
+			out(ctx, n.body);
+			const links = store.kbLinks(n.id);
+			if (links.length) {
+				out(ctx, paint(C.bold, "\n  links", ctx.color));
+				for (const l of links) out(ctx, `  - ${l.rel}: ${l.other}`);
+			}
+			return 0;
 		}
-		const rel = String(args.flags.rel || "related");
-		return (async () => {
-			try {
-				await relRm(env, a, b, rel);
-				if (ctx.json) console.log(JSON.stringify({ removed: `${a} -${rel}-> ${b}` }));
-				else ok(ctx, `unlinked: ${a} (${rel}) ${b}`);
+		case "link": {
+			const a = store.kbGet(rest[0]);
+			const b = store.kbGet(rest[1]);
+			if (!a || !b) {
+				bad(ctx, "both notes must exist");
+				return 1;
+			}
+			store.kbLink(a.id, b.id, String(args.flags.rel || "related"));
+			ok(ctx, `linked ${a.title} --${args.flags.rel || "related"}--> ${b.title}`);
+			return 0;
+		}
+		case "ingest": {
+			if (!rest[0]) {
+				bad(ctx, "usage: kb ingest <artifactId> [--force]");
+				return 2;
+			}
+			const forceKb = args.flags.force === true || args.flags.force === "true";
+			return getOrm(env.db.path).then((ds) => kbIngestArtifact(ds, rest[0], forceKb)).then((r) => {
+				writeResult(ctx, r, (row) => `artifact ingested into kb: ${row.id}  ${require_text.clip(row.title, 50)}`);
 				return 0;
-			} catch (e) {
-				if (e instanceof RelError) {
-					bad(ctx, e.message);
-					return e.code;
-				}
-				throw e;
+			}).catch((e) => {
+				bad(ctx, e?.message || String(e));
+				return 1;
+			});
+		}
+		case "promote": {
+			if (!rest[0]) {
+				bad(ctx, "usage: kb promote <noteId> [--name <skill>]");
+				return 2;
 			}
-		})();
-	}
-	if (action === "list" || action === "") {
-		const outRows = (() => {
-			const params = [];
-			let where = "1=1";
-			const srcF = String(args.flags.src || "");
-			const dstF = String(args.flags.dst || "");
-			const relF = String(args.flags.rel || "");
-			if (srcF) {
-				const s = resolveRef(env, srcF);
-				where += " AND src_type=? AND src_id=?";
-				params.push(s.type, s.id);
+			const note = store.kbGet(rest[0]);
+			if (!note) {
+				bad(ctx, `kb note not found: ${rest[0]}`);
+				return 1;
 			}
-			if (dstF) {
-				const d = resolveRef(env, dstF);
-				where += " AND dst_type=? AND dst_id=?";
-				params.push(d.type, d.id);
+			const name = args.flags.name ? String(args.flags.name) : note.title;
+			return getOrm(env.db.path).then((ds) => skillUpsert(ds, {
+				name,
+				description: deriveL1(note.body || "", note.title),
+				body: note.body,
+				tags: note.tags,
+				origin: `kb:${note.id}`
+			})).then((s) => {
+				ok(ctx, `promoted to skill: ${s.name}`);
+				out(ctx, paint(C.dim, `  L1: ${require_text.clip(String(s.description), 100)}`, ctx.color));
+				return 0;
+			}).catch((e) => {
+				bad(ctx, e?.message || String(e));
+				return 1;
+			});
+		}
+		case "import": {
+			const target = rest[0];
+			if (!target) {
+				bad(ctx, "usage: kb import <dir|file.md> [--tags ..]");
+				return 2;
 			}
-			if (relF) {
-				where += " AND rel=?";
-				params.push(relF);
+			let st;
+			try {
+				st = node_fs.statSync(target);
+			} catch {
+				bad(ctx, `not found: ${target}`);
+				return 1;
 			}
-			return env.db.all(`SELECT * FROM relations WHERE ${where} ORDER BY rowid DESC LIMIT 200`, params);
-		})().map((r) => ({
-			src: `${r.src_type}:${r.src_id}`,
-			dst: `${r.dst_type}:${r.dst_id}`,
-			rel: r.rel,
-			src_display: resolveId(env, r.src_type, r.src_id),
-			dst_display: resolveId(env, r.dst_type, r.dst_id)
-		}));
-		if (ctx.json) {
-			console.log(JSON.stringify(outRows, null, 2));
-			return 0;
+			const files = [];
+			if (st.isFile()) files.push(target);
+			else for (const f of node_fs.readdirSync(target, { recursive: true })) if (String(f).toLowerCase().endsWith(".md")) files.push(node_path.join(target, String(f)));
+			if (!files.length) {
+				bad(ctx, `no .md files under ${target}`);
+				return 1;
+			}
+			files.sort();
+			const MAX_FILE_BYTES = 1048576;
+			const skipped = [];
+			const importable = files.filter((f) => {
+				const sz = node_fs.statSync(f).size;
+				if (sz > MAX_FILE_BYTES && !args.flags.force) {
+					skipped.push({
+						file: f,
+						size: `${(sz / 1024 / 1024).toFixed(1)}MB`
+					});
+					return false;
+				}
+				return true;
+			});
+			if (skipped.length && !ctx.json) {
+				out(ctx, paint(C.yellow, `  ! skipped ${skipped.length} file(s) >1MB (--force to include):`, ctx.color));
+				for (const sk of skipped) out(ctx, paint(C.dim, `    ${sk.file}  (${sk.size})`, ctx.color));
+			}
+			if (!importable.length) {
+				bad(ctx, `all ${files.length} file(s) exceeded 1MB limit — use --force to import anyway`);
+				return 1;
+			}
+			const items = importable.map((f) => {
+				const raw = node_fs.readFileSync(f, "utf8");
+				const { meta, body } = require_text.parseFrontmatter(raw);
+				const heading = /^#\s+(.+)\s*$/m.exec(body)?.[1]?.trim();
+				return {
+					title: meta.title || meta.name || heading || node_path.basename(f, ".md"),
+					body,
+					tags: meta.tags || String(args.flags.tags || ""),
+					source_url: meta.url || "",
+					confidence: meta.confidence || "B",
+					origin: `import:${f}`
+				};
+			});
+			return getOrm(env.db.path).then((ds) => kbImportBulk(ds, items)).then((r) => {
+				if (ctx.json) console.log(JSON.stringify({
+					added: r.added,
+					duplicates: r.dups,
+					files: files.length,
+					target
+				}, null, 2));
+				else ok(ctx, `kb import: ${r.added} added, ${r.dups} duplicate(s) kept — ${files.length} file(s) from ${target}`);
+				return 0;
+			}).catch((e) => {
+				bad(ctx, e?.message || String(e));
+				return 1;
+			});
 		}
-		head(ctx, `Relations (${outRows.length})`);
-		table(ctx, outRows, [
-			"src",
-			"rel",
-			"dst"
-		], [
-			"src_display",
-			"rel",
-			"dst_display"
-		]);
-		return 0;
+		case "":
+			out(ctx, paint(C.dim, "  kb: add | import <dir|file> | search | list | show | link | ingest <artifactId> | promote <noteId>", ctx.color));
+			return 0;
+		default:
+			bad(ctx, `unknown kb action: ${action}`);
+			return 2;
 	}
-	bad(ctx, "usage: rel [add|rm|list] ...  (see ygl-trees help)");
-	return 2;
 }
 //#endregion
 //#region packages/ops/tools/src/webui.ts
@@ -11383,17 +11594,20 @@ function run(env, action, rest, args) {
 			{
 				kind: "kb.add",
 				table: "kb_notes",
-				label: "kb"
+				label: "kb",
+				rm: "kb.rm"
 			},
 			{
 				kind: "source.add",
 				table: "sources",
-				label: "source"
+				label: "source",
+				rm: "source.rm"
 			},
 			{
 				kind: "evidence.add",
 				table: "evidence",
-				label: "evidence"
+				label: "evidence",
+				rm: "evidence.rm"
 			}
 		];
 		const phantoms = [];
@@ -11401,13 +11615,14 @@ function run(env, action, rest, args) {
 			const rows = db.all(`SELECT e.entity_id id, e.ts FROM events e
           WHERE e.kind='${spec.kind}'
             AND e.ts >= datetime('now', '-2 days')
-            AND NOT EXISTS (SELECT 1 FROM ${spec.table} t WHERE t.id = e.entity_id)`);
+            AND NOT EXISTS (SELECT 1 FROM ${spec.table} t WHERE t.id = e.entity_id)
+            AND NOT EXISTS (SELECT 1 FROM events r WHERE r.kind='${spec.rm}' AND r.entity_id = e.entity_id)`);
 			for (const r of rows) phantoms.push(`${spec.label} ${r.id} (${String(r.ts).slice(0, 16)})`);
 		}
 		checks.push({
 			name: "write_integrity",
-			status: phantoms.length ? "fail" : "pass",
-			detail: phantoms.length ? `${phantoms.length} phantom write event(s) in last 48h: ${phantoms.slice(0, 3).join(", ")}${phantoms.length > 3 ? " …" : ""} — event logged but row missing (rollback or different workspace; check receipts' workspace line)` : "recent write events all match stored rows"
+			status: phantoms.length ? "warn" : "pass",
+			detail: phantoms.length ? `${phantoms.length} unexplained write event(s) in last 48h: ${phantoms.slice(0, 3).join(", ")}${phantoms.length > 3 ? " …" : ""} — row missing without an rm event (deleted pre-0.81 or via db sql? otherwise: rollback / different workspace — check receipts' workspace line)` : "recent write events all match stored rows"
 		});
 	}
 	const failed = checks.filter((c) => c.status === "fail").length;