ygl-trees 0.75.0 → 0.76.0

package/dist/bundle/bin.cjs

@@ -10,12 +10,13 @@ let node_fs = require("node:fs");
 node_fs = require_rolldown_runtime.__toESM(node_fs);
 let node_crypto = require("node:crypto");
 let _deepseek_ai_cordis = require("@deepseek-ai/cordis");
+require("reflect-metadata");
+let typeorm = require("typeorm");
 let _deepseek_ai_cordis_plugin_timer = require("@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 node_events = require("node:events");
 let _deepseek_ai_schemastery = require("@deepseek-ai/schemastery");
 _deepseek_ai_schemastery = require_rolldown_runtime.__toESM(_deepseek_ai_schemastery);
 //#region packages/core/text/src/text.ts
@@ -778,16 +779,20 @@ CREATE UNIQUE INDEX IF NOT EXISTS uq_skill_refs ON skill_refs(skill_id, path);
 }));
 //#endregion
 //#region packages/core/text/src/fmt.ts
-init_db();
-const C = {
-	reset: "\x1B[0m",
-	bold: "\x1B[1m",
-	dim: "\x1B[2m",
-	red: "\x1B[31m",
-	green: "\x1B[32m",
-	yellow: "\x1B[33m",
-	cyan: "\x1B[36m"
-};
+var fmt_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
+	C: () => C,
+	ack: () => ack,
+	bad: () => bad,
+	dump: () => dump,
+	head: () => head,
+	ok: () => ok,
+	out: () => out,
+	paint: () => paint,
+	show: () => show,
+	table: () => table,
+	warn: () => warn,
+	writeResult: () => writeResult
+});
 function paint(code, s, on) {
 	return on ? `${code}${s}${C.reset}` : s;
 }
@@ -797,6 +802,9 @@ function out(ctx, msg = "") {
 function ok(ctx, msg) {
 	out(ctx, paint(C.green, `  ✓ ${msg}`, ctx.color));
 }
+function warn(ctx, msg) {
+	out(ctx, paint(C.yellow, `  ! ${msg}`, ctx.color));
+}
 /**
 * Failure report. In --json mode stdout is the MACHINE channel, so a failure
 * must still be parseable there: a single `{"error": "..."}` object (the exit
@@ -858,6 +866,10 @@ function show(ctx, obj, title) {
 		out(ctx, `  ${paint(C.dim, k.padEnd(width), ctx.color)}  ${val}`);
 	}
 }
+function dump(ctx, data) {
+	if (ctx.json) console.log(JSON.stringify(data, null, 2));
+	else console.log(typeof data === "string" ? data : JSON.stringify(data, null, 2));
+}
 /**
 * Write-path result printer with JSON discipline: under --json the ONLY
 * stdout is one JSON object (duplicate or new, duplicates carry
@@ -881,8 +893,22 @@ function ack(ctx, payload, msg) {
 	if (ctx.json) console.log(JSON.stringify(payload, null, 2));
 	else ok(ctx, msg);
 }
+var C;
+var init_fmt = require_rolldown_runtime.__esmMin((() => {
+	C = {
+		reset: "\x1B[0m",
+		bold: "\x1B[1m",
+		dim: "\x1B[2m",
+		red: "\x1B[31m",
+		green: "\x1B[32m",
+		yellow: "\x1B[33m",
+		cyan: "\x1B[36m"
+	};
+}));
 //#endregion
 //#region packages/core/database/src/types.ts
+init_db();
+init_fmt();
 const BOOLEAN_FLAGS = /* @__PURE__ */ new Set([
 	"json",
 	"no-color",
@@ -946,397 +972,917 @@ function bool(args, key) {
 	return v === true || v === "true" || v === "1";
 }
 //#endregion
-//#region packages/core/database/src/plugin.ts
-/**
-* DatabasePlugin — provides ctx.database (DatabaseService).
-* This is the entry point that apps compose via ctx.plugin().
-*
-* @module @ygl/core-database/plugin
-*/
-var DatabaseService = class extends _deepseek_ai_cordis.Service {
-	db;
-	constructor(ctx, dbFile) {
-		super(ctx, "database");
-		const lock = process.env.YGL_TEST !== "1" && process.env.YGL_SERVE !== "1";
-		this.db = new DB(dbFile, { lock });
-	}
-};
-function apply$3(ctx, config) {
-	new DatabaseService(ctx, config.file);
+//#region \0@oxc-project+runtime@0.154.0/helpers/esm/decorateMetadata.js
+function __decorateMetadata(k, v) {
+	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
+var init_decorateMetadata = require_rolldown_runtime.__esmMin((() => {}));
 //#endregion
-//#region packages/web/app/src/index.ts
-/**
-* WebAppPlugin — provides ctx.webApp: serves the built React client
-* (apps/web/dist, workspace knowledge — never user config) over the
-* dashboard server. Pattern follows DSH packages/bundle/web-app: the app
-* entry builds with vite, this runtime-glue plugin resolves the dist and
-* hands static-file serving to whoever owns the HTTP surface.
-*
-* @module @ygl/web-app
-*/
-/** Resolve the built client dist (workspace knowledge). Pure: safe to call
-*  from short-lived CLI processes without betting on async plugin timing.
-*
-*  Probe by REPO MARKER, not by counting levels from __dirname: under the
-*  tsdown single-file build __dirname collapses to dist/bundle, so any
-*  fixed-depth relative path misses. Walking up to the repo root (the dir
-*  holding ygl.bundle.json) works from every layout — tsc tree, bundle,
-*  and a run straight from src/. */
-function resolveDistRoot(from = __dirname) {
-	const candidates = [];
-	let dir = from;
-	for (let i = 0; i < 6; i++, dir = node_path.dirname(dir)) {
-		candidates.push(node_path.join(dir, "apps", "web", "dist"));
-		if (node_fs.existsSync(node_path.join(dir, "ygl.bundle.json"))) break;
-	}
-	candidates.push(node_path.resolve(process.cwd(), "apps", "web", "dist"));
-	for (const candidate of candidates) if (node_fs.existsSync(node_path.join(candidate, "index.html"))) return candidate;
-	return null;
-}
-const MIME = {
-	".html": "text/html; charset=utf-8",
-	".js": "text/javascript; charset=utf-8",
-	".mjs": "text/javascript; charset=utf-8",
-	".css": "text/css; charset=utf-8",
-	".json": "application/json",
-	".svg": "image/svg+xml",
-	".png": "image/png",
-	".ico": "image/x-icon",
-	".woff2": "font/woff2",
-	".map": "application/json"
-};
-/** URL → dist 静态文件（SPA 回落 index.html；路径遍历安全）。纯函数。 */
-function openStatic(urlPath) {
-	const root = resolveDistRoot();
-	if (!root) return null;
-	const clean = urlPath.split("?")[0].replace(/^\/+/, "");
-	let file = node_path.resolve(root, clean === "" ? "index.html" : clean);
-	if (!file.startsWith(root)) file = node_path.join(root, "index.html");
-	if (!node_fs.existsSync(file) || node_fs.statSync(file).isDirectory()) {
-		file = node_path.join(root, "index.html");
-		if (!node_fs.existsSync(file)) return null;
-	}
-	const ext = node_path.extname(file).toLowerCase();
-	return {
-		body: node_fs.readFileSync(file),
-		mime: MIME[ext] || "application/octet-stream"
-	};
-}
-var WebAppService = class extends _deepseek_ai_cordis.Service {
-	constructor(ctx) {
-		super(ctx, "webApp");
-	}
-	/** Whether a built client exists to serve. */
-	available() {
-		return resolveDistRoot() !== null;
-	}
-	/** Delegates to the pure resolver — short-lived CLI callers may use the
-	*  standalone openStatic() without waiting on plugin timing. */
-	open(urlPath) {
-		return openStatic(urlPath);
-	}
-};
-function apply$2(ctx) {
-	new WebAppService(ctx);
+//#region \0@oxc-project+runtime@0.154.0/helpers/esm/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.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 = require_rolldown_runtime.__esmMin((() => {}));
 //#endregion
-//#region packages/techtree/eval/src/eval.ts
+//#region packages/research/pipeline/src/entities.ts
 /**
-* Decision-model boolean evaluator — spec R8 (docs/spec.md).
-*
-* Speaks the Vercel AI Gateway v4 evaluation-model protocol (TypeSafe jev):
-* deterministic P(true) judgments, 1-2s/call, native CJK, collapses toward
-* the gray band instead of hard-answering on thin evidence. Material:
-* F:/Users/Administrator/Downloads/vercel-ai-gateway-eval-api.md.
+* Research-domain entities — a typed snapshot of schema v5.
 *
-* Offline-safe by design: callers map "no token / network failure" to a
-* PENDING gate outcome (never a hard fail) — the evaluator is an
-* enhancement, not a dependency.
+* Contract with the schema authority:
+*  - `synchronize` is ALWAYS false; migrations stay on the PRAGMA
+*    user_version track (src/db.ts). If SCHEMA_SQL changes, these
+*    entities must be updated in the same commit.
+*  - Column names are explicit snake_case to match the database exactly.
+*  - FTS5 virtual tables and PRAGMA paths are OUT of entity scope; they
+*    stay raw SQL in store.ts (see docs/plan.md TypeORM boundaries).
 */
-/** Normalize a configured api_base: a bare host gets the standard v4
-*  evaluation-model path appended; a full endpoint is used as-is.
-*  Config priority is composed by the CALLER (cmds layer):
-*  config(decision_model_llm_api_base) > this default. */
-function resolveEndpoint(base) {
-	const v = String(base || "").trim().replace(/\/+$/, "");
-	if (!v) return GATEWAY_URL;
-	if (/\/v4\/ai\/evaluation-model$/.test(v)) return v;
-	return `${v}/v4/ai/evaluation-model`;
-}
-/** Token resolution: env first, then ~/.vercel.ai-gateway.env (token=...).
-*  Set YGL_EVAL_OFFLINE=1 to force the offline path (tests/demos on
-*  machines that DO have a token file — keeps them deterministic). */
-function evalToken() {
-	if (process.env.YGL_EVAL_OFFLINE) return "";
-	if (process.env.AI_GATEWAY_API_KEY) return process.env.AI_GATEWAY_API_KEY;
-	try {
-		const m = /^token\s*=\s*(\S+)/m.exec(node_fs.readFileSync(node_path.join(node_os.homedir(), ".vercel.ai-gateway.env"), "utf8"));
-		if (m) return m[1];
-	} catch {}
-	return "";
-}
-/** One boolean question about a state. Retries 429/529 with exponential
-*  backoff (<=3); 400/401 and malformed answers return without retry;
-*  60s timeout per attempt. `endpoint` defaults to the Vercel gateway —
-*  callers pass the config-resolved value (decision_model_llm_api_base
-*  has priority over the default). */
-async function evalBoolean(state, question, token, endpoint = GATEWAY_URL) {
-	if (!token) return {
-		ok: false,
-		error: NO_TOKEN
-	};
-	const r = await postEval(state, { q: {
-		type: "boolean",
-		instructions: question
-	} }, token, endpoint);
-	if (!r.ok) return {
-		ok: false,
-		error: r.error
-	};
-	const p = r.answers.q?.probability;
-	if (typeof p !== "number") return {
-		ok: false,
-		error: "malformed answer: no boolean probability"
+var Project, Query, Source, QuerySource, Evidence, Claim, ClaimEvidence, RESEARCH_ENTITIES;
+var init_entities$1 = require_rolldown_runtime.__esmMin((() => {
+	init_decorateMetadata();
+	init_decorate();
+	Project = class Project {
+		id;
+		name;
+		question;
+		inclusion;
+		exclusion;
+		status;
+		created;
+		updated;
+		queries;
+		claims;
+		sources;
 	};
-	return {
-		ok: true,
-		p,
-		usage: r.usage
+	__decorate([(0, typeorm.PrimaryColumn)({
+		name: "id",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Project.prototype, "id", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "name",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Project.prototype, "name", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "question",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Project.prototype, "question", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "inclusion",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Project.prototype, "inclusion", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "exclusion",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Project.prototype, "exclusion", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "status",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Project.prototype, "status", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "created",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Project.prototype, "created", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "updated",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Project.prototype, "updated", void 0);
+	__decorate([(0, typeorm.OneToMany)(() => Query, (q) => q.project, { createForeignKeyConstraints: false }), __decorateMetadata("design:type", Array)], Project.prototype, "queries", void 0);
+	__decorate([(0, typeorm.OneToMany)(() => Claim, (c) => c.project, { createForeignKeyConstraints: false }), __decorateMetadata("design:type", Array)], Project.prototype, "claims", void 0);
+	__decorate([(0, typeorm.OneToMany)(() => Source, (s) => s.project, { createForeignKeyConstraints: false }), __decorateMetadata("design:type", Array)], Project.prototype, "sources", void 0);
+	Project = __decorate([(0, typeorm.Entity)({ name: "projects" })], Project);
+	Query = class Query {
+		id;
+		projectId;
+		text;
+		engine;
+		status;
+		note;
+		contentHash;
+		created;
+		project;
+		querySources;
 	};
-}
-function parseEvalSpec(value) {
-	const s = String(value ?? "").trim();
-	if (s.startsWith("{")) try {
-		const j = JSON.parse(s);
-		if (j && typeof j.q === "string") return j;
-	} catch {}
-	return { q: s };
-}
-function packEvalChoiceSpec(q, options, answer) {
-	return JSON.stringify({
-		q,
-		options,
-		answer
-	});
-}
-function packEvalScoreSpec(q, levels, min) {
-	return JSON.stringify({
-		q,
-		levels,
-		min
-	});
-}
-async function postEval(state, questions, token, endpoint) {
-	const url = resolveEndpoint(endpoint);
-	const body = JSON.stringify({
-		state,
-		questions
-	});
-	for (let attempt = 0;; attempt++) try {
-		const res = await fetch(url, {
-			method: "POST",
-			headers: {
-				Authorization: `Bearer ${token}`,
-				"Content-Type": "application/json",
-				"ai-model-id": MODEL_ID,
-				"ai-evaluation-model-specification-version": "4",
-				"ai-gateway-protocol-version": "0.0.1",
-				"ai-gateway-auth-method": "api-key"
-			},
-			body,
-			signal: AbortSignal.timeout(6e4)
-		});
-		if (res.status === 429 || res.status === 529) {
-			if (attempt >= 3) return {
-				ok: false,
-				error: `HTTP ${res.status} after ${attempt + 1} attempts`
-			};
-			await new Promise((r) => setTimeout(r, 500 * 2 ** attempt));
-			continue;
-		}
-		if (!res.ok) return {
-			ok: false,
-			error: `HTTP ${res.status} (protocol/auth error — no retry)`
-		};
-		const j = await res.json();
-		if (!j?.answers) return {
-			ok: false,
-			error: "malformed response: no answers"
-		};
-		return {
-			ok: true,
-			answers: j.answers,
-			usage: j.usage ?? void 0
-		};
-	} catch (e) {
-		const msg = String(e?.message || e);
-		if (attempt < 3 && /timeout|abort|network|fetch failed|ECONN/i.test(msg)) {
-			await new Promise((r) => setTimeout(r, 500 * 2 ** attempt));
-			continue;
-		}
-		return {
-			ok: false,
-			error: msg
-		};
-	}
-}
-async function evalChoice(state, question, options, token, endpoint = GATEWAY_URL) {
-	if (!token) return {
-		ok: false,
-		error: NO_TOKEN
-	};
-	const criteria = {};
-	for (const [k, v] of Object.entries(options)) criteria[k] = v || null;
-	const r = await postEval(state, { q: {
-		type: "choice",
-		instructions: question,
-		criteria
-	} }, token, endpoint);
-	if (!r.ok) return {
-		ok: false,
-		error: r.error
+	__decorate([(0, typeorm.PrimaryColumn)({
+		name: "id",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Query.prototype, "id", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "project_id",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Query.prototype, "projectId", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "text",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Query.prototype, "text", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "engine",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Query.prototype, "engine", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "status",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Query.prototype, "status", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "note",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Query.prototype, "note", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "content_hash",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Query.prototype, "contentHash", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "created",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Query.prototype, "created", void 0);
+	__decorate([
+		(0, typeorm.ManyToOne)(() => Project, (p) => p.queries, { createForeignKeyConstraints: false }),
+		(0, typeorm.JoinColumn)({ name: "project_id" }),
+		__decorateMetadata("design:type", typeof Project === "undefined" ? Object : Project)
+	], Query.prototype, "project", void 0);
+	__decorate([(0, typeorm.OneToMany)(() => QuerySource, (qs) => qs.query, { createForeignKeyConstraints: false }), __decorateMetadata("design:type", Array)], Query.prototype, "querySources", void 0);
+	Query = __decorate([(0, typeorm.Entity)({ name: "queries" })], Query);
+	Source = class Source {
+		id;
+		projectId;
+		url;
+		title;
+		urlHash;
+		contentHash;
+		abstract;
+		content;
+		engine;
+		relevance;
+		confidence;
+		tags;
+		retrievedAt;
+		created;
+		project;
+		querySources;
 	};
-	const a = r.answers.q ?? {};
-	if (typeof a.choice !== "string" || !a.probabilities) return {
-		ok: false,
-		error: "malformed answer: no choice/probabilities"
+	__decorate([(0, typeorm.PrimaryColumn)({
+		name: "id",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Source.prototype, "id", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "project_id",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Source.prototype, "projectId", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "url",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Source.prototype, "url", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "title",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Source.prototype, "title", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "url_hash",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Source.prototype, "urlHash", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "content_hash",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Source.prototype, "contentHash", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "abstract",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Source.prototype, "abstract", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "content",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Source.prototype, "content", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "engine",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Source.prototype, "engine", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "relevance",
+		type: "integer"
+	}), __decorateMetadata("design:type", Number)], Source.prototype, "relevance", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "confidence",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Source.prototype, "confidence", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "tags",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Source.prototype, "tags", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "retrieved_at",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Source.prototype, "retrievedAt", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "created",
+		type: "text",
+		nullable: true
+	}), __decorateMetadata("design:type", String)], Source.prototype, "created", void 0);
+	__decorate([
+		(0, typeorm.ManyToOne)(() => Project, (p) => p.sources, { createForeignKeyConstraints: false }),
+		(0, typeorm.JoinColumn)({ name: "project_id" }),
+		__decorateMetadata("design:type", typeof Project === "undefined" ? Object : Project)
+	], Source.prototype, "project", void 0);
+	__decorate([(0, typeorm.OneToMany)(() => QuerySource, (qs) => qs.source, { createForeignKeyConstraints: false }), __decorateMetadata("design:type", Array)], Source.prototype, "querySources", void 0);
+	Source = __decorate([(0, typeorm.Entity)({ name: "sources" })], Source);
+	QuerySource = class QuerySource {
+		queryId;
+		sourceId;
+		note;
+		created;
+		query;
+		source;
 	};
-	return {
-		ok: true,
-		choice: a.choice,
-		probabilities: a.probabilities,
-		usage: r.usage
+	__decorate([(0, typeorm.PrimaryColumn)({
+		name: "query_id",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], QuerySource.prototype, "queryId", void 0);
+	__decorate([(0, typeorm.PrimaryColumn)({
+		name: "source_id",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], QuerySource.prototype, "sourceId", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "note",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], QuerySource.prototype, "note", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "created",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], QuerySource.prototype, "created", void 0);
+	__decorate([
+		(0, typeorm.ManyToOne)(() => Query, (q) => q.querySources, { createForeignKeyConstraints: false }),
+		(0, typeorm.JoinColumn)({ name: "query_id" }),
+		__decorateMetadata("design:type", typeof Query === "undefined" ? Object : Query)
+	], QuerySource.prototype, "query", void 0);
+	__decorate([
+		(0, typeorm.ManyToOne)(() => Source, (s) => s.querySources, { createForeignKeyConstraints: false }),
+		(0, typeorm.JoinColumn)({ name: "source_id" }),
+		__decorateMetadata("design:type", typeof Source === "undefined" ? Object : Source)
+	], QuerySource.prototype, "source", void 0);
+	QuerySource = __decorate([(0, typeorm.Entity)({ name: "query_sources" })], QuerySource);
+	Evidence = class Evidence {
+		id;
+		projectId;
+		sourceId;
+		quote;
+		note;
+		locator;
+		contentHash;
+		created;
+		project;
+		source;
+		claimEvidence;
 	};
-}
-/** Tri-state on the EXPECTED answer's probability — same thresholds and
-*  gray-band philosophy as boolean P(true). */
-function mapChoiceOutcome(r, answer, high = .7, low = .4) {
-	if (!r.ok || !r.probabilities) return {
-		outcome: "pending",
-		reason: r.error || "no probabilities"
-	};
-	const p = r.probabilities[answer];
-	if (typeof p !== "number") return {
-		outcome: "pending",
-		reason: `expected answer '${answer}' not in distribution`
-	};
-	const base = {
-		p,
-		choice: r.choice
+	__decorate([(0, typeorm.PrimaryColumn)({
+		name: "id",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Evidence.prototype, "id", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "project_id",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Evidence.prototype, "projectId", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "source_id",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Evidence.prototype, "sourceId", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "quote",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Evidence.prototype, "quote", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "note",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Evidence.prototype, "note", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "locator",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Evidence.prototype, "locator", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "content_hash",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Evidence.prototype, "contentHash", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "created",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Evidence.prototype, "created", void 0);
+	__decorate([
+		(0, typeorm.ManyToOne)(() => Project, void 0, { createForeignKeyConstraints: false }),
+		(0, typeorm.JoinColumn)({ name: "project_id" }),
+		__decorateMetadata("design:type", typeof Project === "undefined" ? Object : Project)
+	], Evidence.prototype, "project", void 0);
+	__decorate([
+		(0, typeorm.ManyToOne)(() => Source, void 0, { createForeignKeyConstraints: false }),
+		(0, typeorm.JoinColumn)({ name: "source_id" }),
+		__decorateMetadata("design:type", typeof Source === "undefined" ? Object : Source)
+	], Evidence.prototype, "source", void 0);
+	__decorate([(0, typeorm.OneToMany)(() => ClaimEvidence, (ce) => ce.evidence, { createForeignKeyConstraints: false }), __decorateMetadata("design:type", Array)], Evidence.prototype, "claimEvidence", void 0);
+	Evidence = __decorate([(0, typeorm.Entity)({ name: "evidence" })], Evidence);
+	Claim = class Claim {
+		id;
+		projectId;
+		text;
+		status;
+		confidence;
+		contentHash;
+		created;
+		updated;
+		project;
+		claimEvidence;
 	};
-	if (p >= high) return {
-		outcome: "pass",
-		...base
+	__decorate([(0, typeorm.PrimaryColumn)({
+		name: "id",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Claim.prototype, "id", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "project_id",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Claim.prototype, "projectId", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "text",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Claim.prototype, "text", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "status",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Claim.prototype, "status", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "confidence",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Claim.prototype, "confidence", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "content_hash",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Claim.prototype, "contentHash", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "created",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Claim.prototype, "created", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "updated",
+		type: "text",
+		nullable: true
+	}), __decorateMetadata("design:type", String)], Claim.prototype, "updated", void 0);
+	__decorate([
+		(0, typeorm.ManyToOne)(() => Project, (p) => p.claims, { createForeignKeyConstraints: false }),
+		(0, typeorm.JoinColumn)({ name: "project_id" }),
+		__decorateMetadata("design:type", typeof Project === "undefined" ? Object : Project)
+	], Claim.prototype, "project", void 0);
+	__decorate([(0, typeorm.OneToMany)(() => ClaimEvidence, (ce) => ce.claim, { createForeignKeyConstraints: false }), __decorateMetadata("design:type", Array)], Claim.prototype, "claimEvidence", void 0);
+	Claim = __decorate([(0, typeorm.Entity)({ name: "claims" })], Claim);
+	ClaimEvidence = class ClaimEvidence {
+		claimId;
+		evidenceId;
+		stance;
+		claim;
+		evidence;
 	};
-	if (p <= low) return {
-		outcome: "fail",
-		...base
+	__decorate([(0, typeorm.PrimaryColumn)({
+		name: "claim_id",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], ClaimEvidence.prototype, "claimId", void 0);
+	__decorate([(0, typeorm.PrimaryColumn)({
+		name: "evidence_id",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], ClaimEvidence.prototype, "evidenceId", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "stance",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], ClaimEvidence.prototype, "stance", void 0);
+	__decorate([
+		(0, typeorm.ManyToOne)(() => Claim, (c) => c.claimEvidence, { createForeignKeyConstraints: false }),
+		(0, typeorm.JoinColumn)({ name: "claim_id" }),
+		__decorateMetadata("design:type", typeof Claim === "undefined" ? Object : Claim)
+	], ClaimEvidence.prototype, "claim", void 0);
+	__decorate([
+		(0, typeorm.ManyToOne)(() => Evidence, void 0, { createForeignKeyConstraints: false }),
+		(0, typeorm.JoinColumn)({ name: "evidence_id" }),
+		__decorateMetadata("design:type", typeof Evidence === "undefined" ? Object : Evidence)
+	], ClaimEvidence.prototype, "evidence", void 0);
+	ClaimEvidence = __decorate([(0, typeorm.Entity)({ name: "claim_evidence" })], ClaimEvidence);
+	RESEARCH_ENTITIES = [
+		Project,
+		Query,
+		Source,
+		QuerySource,
+		Evidence,
+		Claim,
+		ClaimEvidence
+	];
+}));
+//#endregion
+//#region packages/core/database/src/entities.ts
+/** 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 = require_rolldown_runtime.__esmMin((() => {
+	init_decorateMetadata();
+	init_decorate();
+	Event = class Event {
+		id;
+		ts;
+		actor;
+		kind;
+		entity;
+		entityId;
+		payload;
+		/** v7 telemetry severity: info | warn | error (spec R10.2) */
+		level;
 	};
-	return {
-		outcome: "pending",
-		...base,
-		reason: `gray band ${low}<P<${high} (process state)`
+	__decorate([(0, typeorm.PrimaryColumn)({
+		name: "id",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Event.prototype, "id", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "ts",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Event.prototype, "ts", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "actor",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Event.prototype, "actor", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "kind",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Event.prototype, "kind", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "entity",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Event.prototype, "entity", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "entity_id",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Event.prototype, "entityId", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "payload",
+		type: "text"
+	}), __decorateMetadata("design:type", String)], Event.prototype, "payload", void 0);
+	__decorate([(0, typeorm.Column)({
+		name: "level",
+		type: "text",
+		default: "info"
+	}), __decorateMetadata("design:type", String)], Event.prototype, "level", void 0);
+	Event = __decorate([(0, typeorm.Entity)({ name: "events" })], Event);
+	CORE_ENTITIES = [Event];
+}));
+//#endregion
+//#region packages/core/database/src/orm.ts
+/**
+* Lazy TypeORM DataSource over the SAME SQLite file the CLI works on.
+*
+* Boundaries (see docs/plan.md "TypeORM boundaries"):
+*  - `synchronize` is permanently false — schema authority stays with
+*    SCHEMA_SQL + PRAGMA user_version migrations in src/db.ts. Entities in
+*    src/entities/ are a typed snapshot; change them in the same commit as
+*    SCHEMA_SQL.
+*  - TypeORM is a QUERY layer here, not a migration layer. FTS5 MATCH /
+*    bm25 loops, PRAGMA paths and the PG sync/migrate machinery stay raw
+*    SQL on the DB class.
+*  - CLI commands using the ORM must return a Promise (main() awaits) so
+*    the DataSource settles before the wasm DB closes.
+*/
+var orm_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
+	closeOrm: () => closeOrm,
+	getOrm: () => getOrm
+});
+async function getOrm(dbFile) {
+	if (cached && cached.file === dbFile) return cached.ds;
+	const ds = new typeorm.DataSource({
+		type: "better-sqlite3",
+		database: dbFile,
+		synchronize: false,
+		entities: [...RESEARCH_ENTITIES, ...CORE_ENTITIES]
+	});
+	await ds.initialize();
+	await ds.query("PRAGMA synchronous=NORMAL");
+	cached = {
+		file: dbFile,
+		ds
 	};
+	return ds;
 }
-async function evalScore(state, question, levels, token, endpoint = GATEWAY_URL) {
-	if (!token) return {
-		ok: false,
-		error: NO_TOKEN
-	};
-	const r = await postEval(state, { q: {
-		type: "score",
-		instructions: question,
-		criteria: levels
+/** Destroy the cached DataSource (tests/scratch dirs cannot be removed on
+*  Windows while a better-sqlite3 handle keeps the file open — EPERM). */
+async function closeOrm() {
+	if (cached) {
+		try {
+			await cached.ds.destroy();
+		} catch {}
+		cached = null;
+	}
+}
+var cached;
+var init_orm = require_rolldown_runtime.__esmMin((() => {
+	init_entities$1();
+	init_entities();
+	cached = null;
+}));
+//#endregion
+//#region packages/core/database/src/plugin.ts
+/**
+* DatabasePlugin — provides ctx.database (DatabaseService).
+* This is the entry point that apps compose via ctx.plugin().
+*
+* @module @ygl/core-database/plugin
+*/
+var DatabaseService = class extends _deepseek_ai_cordis.Service {
+	db;
+	disposed = false;
+	constructor(ctx, dbFile) {
+		super(ctx, "database");
+		const lock = process.env.YGL_TEST !== "1" && process.env.YGL_SERVE !== "1";
+		this.db = new DB(dbFile, { lock });
+	}
+	/** Lifecycle: Cordis calls this when the Context is disposed — the
+	*  "Services stop with Context, resources auto-clean" promise made real.
+	*  Closes the SQLite handle AND the cached ORM DataSource. */
+	stop() {
+		if (this.disposed) return;
+		this.disposed = true;
+		try {
+			const { closeOrm } = (init_orm(), require_rolldown_runtime.__toCommonJS(orm_exports));
+			closeOrm().catch(() => {});
+		} catch {}
+		try {
+			this.db.close();
+		} catch {}
+	}
+};
+function apply$3(ctx, config) {
+	new DatabaseService(ctx, config.file);
+}
+//#endregion
+//#region packages/web/app/src/index.ts
+/**
+* WebAppPlugin — provides ctx.webApp: serves the built React client
+* (apps/web/dist, workspace knowledge — never user config) over the
+* dashboard server. Pattern follows DSH packages/bundle/web-app: the app
+* entry builds with vite, this runtime-glue plugin resolves the dist and
+* hands static-file serving to whoever owns the HTTP surface.
+*
+* @module @ygl/web-app
+*/
+/** Resolve the built client dist (workspace knowledge). Pure: safe to call
+*  from short-lived CLI processes without betting on async plugin timing.
+*
+*  Probe by REPO MARKER, not by counting levels from __dirname: under the
+*  tsdown single-file build __dirname collapses to dist/bundle, so any
+*  fixed-depth relative path misses. Walking up to the repo root (the dir
+*  holding ygl.bundle.json) works from every layout — tsc tree, bundle,
+*  and a run straight from src/. */
+function resolveDistRoot(from = __dirname) {
+	const candidates = [];
+	let dir = from;
+	for (let i = 0; i < 6; i++, dir = node_path.dirname(dir)) {
+		candidates.push(node_path.join(dir, "apps", "web", "dist"));
+		if (node_fs.existsSync(node_path.join(dir, "ygl.bundle.json"))) break;
+	}
+	candidates.push(node_path.resolve(process.cwd(), "apps", "web", "dist"));
+	for (const candidate of candidates) if (node_fs.existsSync(node_path.join(candidate, "index.html"))) return candidate;
+	return null;
+}
+const MIME = {
+	".html": "text/html; charset=utf-8",
+	".js": "text/javascript; charset=utf-8",
+	".mjs": "text/javascript; charset=utf-8",
+	".css": "text/css; charset=utf-8",
+	".json": "application/json",
+	".svg": "image/svg+xml",
+	".png": "image/png",
+	".ico": "image/x-icon",
+	".woff2": "font/woff2",
+	".map": "application/json"
+};
+/** URL → dist 静态文件（SPA 回落 index.html；路径遍历安全）。纯函数。 */
+function openStatic(urlPath) {
+	const root = resolveDistRoot();
+	if (!root) return null;
+	const clean = urlPath.split("?")[0].replace(/^\/+/, "");
+	let file = node_path.resolve(root, clean === "" ? "index.html" : clean);
+	if (!file.startsWith(root)) file = node_path.join(root, "index.html");
+	if (!node_fs.existsSync(file) || node_fs.statSync(file).isDirectory()) {
+		file = node_path.join(root, "index.html");
+		if (!node_fs.existsSync(file)) return null;
+	}
+	const ext = node_path.extname(file).toLowerCase();
+	return {
+		body: node_fs.readFileSync(file),
+		mime: MIME[ext] || "application/octet-stream"
+	};
+}
+var WebAppService = class extends _deepseek_ai_cordis.Service {
+	constructor(ctx) {
+		super(ctx, "webApp");
+	}
+	/** Whether a built client exists to serve. */
+	available() {
+		return resolveDistRoot() !== null;
+	}
+	/** Delegates to the pure resolver — short-lived CLI callers may use the
+	*  standalone openStatic() without waiting on plugin timing. */
+	open(urlPath) {
+		return openStatic(urlPath);
+	}
+};
+function apply$2(ctx) {
+	new WebAppService(ctx);
+}
+//#endregion
+//#region packages/techtree/eval/src/eval.ts
+/**
+* Decision-model boolean evaluator — spec R8 (docs/spec.md).
+*
+* Speaks the Vercel AI Gateway v4 evaluation-model protocol (TypeSafe jev):
+* deterministic P(true) judgments, 1-2s/call, native CJK, collapses toward
+* the gray band instead of hard-answering on thin evidence. Material:
+* F:/Users/Administrator/Downloads/vercel-ai-gateway-eval-api.md.
+*
+* Offline-safe by design: callers map "no token / network failure" to a
+* PENDING gate outcome (never a hard fail) — the evaluator is an
+* enhancement, not a dependency.
+*/
+/** Normalize a configured api_base: a bare host gets the standard v4
+*  evaluation-model path appended; a full endpoint is used as-is.
+*  Config priority is composed by the CALLER (cmds layer):
+*  config(decision_model_llm_api_base) > this default. */
+function resolveEndpoint(base) {
+	const v = String(base || "").trim().replace(/\/+$/, "");
+	if (!v) return GATEWAY_URL;
+	if (/\/v4\/ai\/evaluation-model$/.test(v)) return v;
+	return `${v}/v4/ai/evaluation-model`;
+}
+/** Token resolution: env first, then ~/.vercel.ai-gateway.env (token=...).
+*  Set YGL_EVAL_OFFLINE=1 to force the offline path (tests/demos on
+*  machines that DO have a token file — keeps them deterministic). */
+function evalToken() {
+	if (process.env.YGL_EVAL_OFFLINE) return "";
+	if (process.env.AI_GATEWAY_API_KEY) return process.env.AI_GATEWAY_API_KEY;
+	try {
+		const m = /^token\s*=\s*(\S+)/m.exec(node_fs.readFileSync(node_path.join(node_os.homedir(), ".vercel.ai-gateway.env"), "utf8"));
+		if (m) return m[1];
+	} catch {}
+	return "";
+}
+/** One boolean question about a state. Retries 429/529 with exponential
+*  backoff (<=3); 400/401 and malformed answers return without retry;
+*  60s timeout per attempt. `endpoint` defaults to the Vercel gateway —
+*  callers pass the config-resolved value (decision_model_llm_api_base
+*  has priority over the default). */
+async function evalBoolean(state, question, token, endpoint = GATEWAY_URL) {
+	if (!token) return {
+		ok: false,
+		error: NO_TOKEN
+	};
+	const r = await postEval(state, { q: {
+		type: "boolean",
+		instructions: question
 	} }, token, endpoint);
 	if (!r.ok) return {
 		ok: false,
 		error: r.error
 	};
-	const a = r.answers.q ?? {};
-	if (typeof a.score !== "number" || !a.probabilities) return {
+	const p = r.answers.q?.probability;
+	if (typeof p !== "number") return {
 		ok: false,
-		error: "malformed answer: no score/probabilities"
+		error: "malformed answer: no boolean probability"
 	};
 	return {
 		ok: true,
-		score: a.score,
-		probabilities: a.probabilities,
+		p,
 		usage: r.usage
 	};
 }
-/** Tri-state on the ordinal scale: score >= min → pass; score <= min-1 →
-*  fail; the ±1 band around the threshold is the gray zone (the score
-*  counterpart of boolean's (0.4, 0.7) process state). */
-function mapScoreOutcome(r, min) {
-	if (!r.ok || r.score === void 0) return {
-		outcome: "pending",
-		reason: r.error || "no score"
-	};
-	const s = r.score;
-	if (s >= min) return {
-		outcome: "pass",
-		score: s
-	};
-	if (s <= min - 1) return {
-		outcome: "fail",
-		score: s
-	};
-	return {
-		outcome: "pending",
-		score: s,
-		reason: `gray band [${min - 1}, ${min}) around expected level ${min}`
-	};
+function parseEvalSpec(value) {
+	const s = String(value ?? "").trim();
+	if (s.startsWith("{")) try {
+		const j = JSON.parse(s);
+		if (j && typeof j.q === "string") return j;
+	} catch {}
+	return { q: s };
 }
-async function evalMixed(state, questions, token, endpoint = GATEWAY_URL) {
-	if (!questions.length) return {
-		ok: true,
-		results: []
-	};
-	if (!token) return {
-		ok: false,
-		error: NO_TOKEN
-	};
-	const qmap = {};
-	questions.forEach((q, i) => {
-		if (q.type === "boolean") qmap[`q${i}`] = {
-			type: "boolean",
-			instructions: q.question
-		};
-		else if (q.type === "choice") {
-			const criteria = {};
-			for (const [k, v] of Object.entries(q.options)) criteria[k] = v || null;
-			qmap[`q${i}`] = {
-				type: "choice",
-				instructions: q.question,
-				criteria
-			};
-		} else qmap[`q${i}`] = {
-			type: "score",
-			instructions: q.question,
-			criteria: q.levels
-		};
+function packEvalChoiceSpec(q, options, answer) {
+	return JSON.stringify({
+		q,
+		options,
+		answer
 	});
-	const r = await postEval(state, qmap, token, endpoint);
-	if (!r.ok) return {
-		ok: false,
-		error: r.error
-	};
-	const results = [];
-	for (let i = 0; i < questions.length; i++) {
-		const a = r.answers[`q${i}`] ?? {};
-		const t = questions[i].type;
-		if (t === "boolean") {
-			if (typeof a.probability !== "number") return {
-				ok: false,
-				error: `malformed answer q${i}: no boolean probability`
-			};
-			results.push({
-				ok: true,
-				type: "boolean",
-				p: a.probability
-			});
-		} else if (t === "choice") {
+}
+function packEvalScoreSpec(q, levels, min) {
+	return JSON.stringify({
+		q,
+		levels,
+		min
+	});
+}
+async function postEval(state, questions, token, endpoint) {
+	const url = resolveEndpoint(endpoint);
+	const body = JSON.stringify({
+		state,
+		questions
+	});
+	for (let attempt = 0;; attempt++) try {
+		const res = await fetch(url, {
+			method: "POST",
+			headers: {
+				Authorization: `Bearer ${token}`,
+				"Content-Type": "application/json",
+				"ai-model-id": MODEL_ID,
+				"ai-evaluation-model-specification-version": "4",
+				"ai-gateway-protocol-version": "0.0.1",
+				"ai-gateway-auth-method": "api-key"
+			},
+			body,
+			signal: AbortSignal.timeout(6e4)
+		});
+		if (res.status === 429 || res.status === 529) {
+			if (attempt >= 3) return {
+				ok: false,
+				error: `HTTP ${res.status} after ${attempt + 1} attempts`
+			};
+			await new Promise((r) => setTimeout(r, 500 * 2 ** attempt));
+			continue;
+		}
+		if (!res.ok) return {
+			ok: false,
+			error: `HTTP ${res.status} (protocol/auth error — no retry)`
+		};
+		const j = await res.json();
+		if (!j?.answers) return {
+			ok: false,
+			error: "malformed response: no answers"
+		};
+		return {
+			ok: true,
+			answers: j.answers,
+			usage: j.usage ?? void 0
+		};
+	} catch (e) {
+		const msg = String(e?.message || e);
+		if (attempt < 3 && /timeout|abort|network|fetch failed|ECONN/i.test(msg)) {
+			await new Promise((r) => setTimeout(r, 500 * 2 ** attempt));
+			continue;
+		}
+		return {
+			ok: false,
+			error: msg
+		};
+	}
+}
+async function evalChoice(state, question, options, token, endpoint = GATEWAY_URL) {
+	if (!token) return {
+		ok: false,
+		error: NO_TOKEN
+	};
+	const criteria = {};
+	for (const [k, v] of Object.entries(options)) criteria[k] = v || null;
+	const r = await postEval(state, { q: {
+		type: "choice",
+		instructions: question,
+		criteria
+	} }, token, endpoint);
+	if (!r.ok) return {
+		ok: false,
+		error: r.error
+	};
+	const a = r.answers.q ?? {};
+	if (typeof a.choice !== "string" || !a.probabilities) return {
+		ok: false,
+		error: "malformed answer: no choice/probabilities"
+	};
+	return {
+		ok: true,
+		choice: a.choice,
+		probabilities: a.probabilities,
+		usage: r.usage
+	};
+}
+/** Tri-state on the EXPECTED answer's probability — same thresholds and
+*  gray-band philosophy as boolean P(true). */
+function mapChoiceOutcome(r, answer, high = .7, low = .4) {
+	if (!r.ok || !r.probabilities) return {
+		outcome: "pending",
+		reason: r.error || "no probabilities"
+	};
+	const p = r.probabilities[answer];
+	if (typeof p !== "number") return {
+		outcome: "pending",
+		reason: `expected answer '${answer}' not in distribution`
+	};
+	const base = {
+		p,
+		choice: r.choice
+	};
+	if (p >= high) return {
+		outcome: "pass",
+		...base
+	};
+	if (p <= low) return {
+		outcome: "fail",
+		...base
+	};
+	return {
+		outcome: "pending",
+		...base,
+		reason: `gray band ${low}<P<${high} (process state)`
+	};
+}
+async function evalScore(state, question, levels, token, endpoint = GATEWAY_URL) {
+	if (!token) return {
+		ok: false,
+		error: NO_TOKEN
+	};
+	const r = await postEval(state, { q: {
+		type: "score",
+		instructions: question,
+		criteria: levels
+	} }, token, endpoint);
+	if (!r.ok) return {
+		ok: false,
+		error: r.error
+	};
+	const a = r.answers.q ?? {};
+	if (typeof a.score !== "number" || !a.probabilities) return {
+		ok: false,
+		error: "malformed answer: no score/probabilities"
+	};
+	return {
+		ok: true,
+		score: a.score,
+		probabilities: a.probabilities,
+		usage: r.usage
+	};
+}
+/** Tri-state on the ordinal scale: score >= min → pass; score <= min-1 →
+*  fail; the ±1 band around the threshold is the gray zone (the score
+*  counterpart of boolean's (0.4, 0.7) process state). */
+function mapScoreOutcome(r, min) {
+	if (!r.ok || r.score === void 0) return {
+		outcome: "pending",
+		reason: r.error || "no score"
+	};
+	const s = r.score;
+	if (s >= min) return {
+		outcome: "pass",
+		score: s
+	};
+	if (s <= min - 1) return {
+		outcome: "fail",
+		score: s
+	};
+	return {
+		outcome: "pending",
+		score: s,
+		reason: `gray band [${min - 1}, ${min}) around expected level ${min}`
+	};
+}
+async function evalMixed(state, questions, token, endpoint = GATEWAY_URL) {
+	if (!questions.length) return {
+		ok: true,
+		results: []
+	};
+	if (!token) return {
+		ok: false,
+		error: NO_TOKEN
+	};
+	const qmap = {};
+	questions.forEach((q, i) => {
+		if (q.type === "boolean") qmap[`q${i}`] = {
+			type: "boolean",
+			instructions: q.question
+		};
+		else if (q.type === "choice") {
+			const criteria = {};
+			for (const [k, v] of Object.entries(q.options)) criteria[k] = v || null;
+			qmap[`q${i}`] = {
+				type: "choice",
+				instructions: q.question,
+				criteria
+			};
+		} else qmap[`q${i}`] = {
+			type: "score",
+			instructions: q.question,
+			criteria: q.levels
+		};
+	});
+	const r = await postEval(state, qmap, token, endpoint);
+	if (!r.ok) return {
+		ok: false,
+		error: r.error
+	};
+	const results = [];
+	for (let i = 0; i < questions.length; i++) {
+		const a = r.answers[`q${i}`] ?? {};
+		const t = questions[i].type;
+		if (t === "boolean") {
+			if (typeof a.probability !== "number") return {
+				ok: false,
+				error: `malformed answer q${i}: no boolean probability`
+			};
+			results.push({
+				ok: true,
+				type: "boolean",
+				p: a.probability
+			});
+		} else if (t === "choice") {
 			if (typeof a.choice !== "string" || !a.probabilities) return {
 				ok: false,
 				error: `malformed answer q${i}: no choice/probabilities`
@@ -3257,695 +3803,229 @@ CREATE TABLE artifacts (
   version integer NOT NULL DEFAULT 1, created text NOT NULL,
   meta text NOT NULL DEFAULT '');
 CREATE TABLE kb_notes (
-  id text PRIMARY KEY, title text NOT NULL, body text NOT NULL DEFAULT '',
-  source_url text DEFAULT '', origin text DEFAULT '', tags text DEFAULT '',
-  confidence text NOT NULL DEFAULT 'B', reuse integer NOT NULL DEFAULT 0,
-  content_hash text NOT NULL DEFAULT '', created text NOT NULL, updated text NOT NULL,
-  UNIQUE (content_hash));
-CREATE TABLE kb_links (
-  from_id text NOT NULL REFERENCES kb_notes(id) ON DELETE CASCADE,
-  to_id text NOT NULL REFERENCES kb_notes(id) ON DELETE CASCADE,
-  rel text NOT NULL DEFAULT 'related', PRIMARY KEY (from_id, to_id, rel));
-CREATE TABLE trees (
-  id text PRIMARY KEY, project_id text REFERENCES projects(id) ON DELETE CASCADE,
-  name text NOT NULL UNIQUE, note text DEFAULT '', created text NOT NULL);
-CREATE TABLE nodes (
-  id text PRIMARY KEY, tree_id text NOT NULL REFERENCES trees(id) ON DELETE CASCADE,
-  key text NOT NULL, name text NOT NULL, kind text NOT NULL DEFAULT 'tech',
-  tier integer NOT NULL DEFAULT 0, cost double precision NOT NULL DEFAULT 0,
-  cost_unit text DEFAULT '', payload text DEFAULT '', tags text DEFAULT '',
-  created text NOT NULL, UNIQUE (tree_id, key));
-CREATE TABLE node_edges (
-  id text PRIMARY KEY, tree_id text NOT NULL REFERENCES trees(id) ON DELETE CASCADE,
-  parent_id text NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
-  child_id text NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
-  rel text NOT NULL DEFAULT 'prereq', mode text NOT NULL DEFAULT 'AND',
-  required integer NOT NULL DEFAULT 1, min_level integer NOT NULL DEFAULT 1,
-  weight double precision NOT NULL DEFAULT 1, note text DEFAULT '',
-  UNIQUE (parent_id, child_id, rel));
-CREATE TABLE node_closure (
-  tree_id text NOT NULL, ancestor text NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
-  descendant text NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
-  depth integer NOT NULL, PRIMARY KEY (ancestor, descendant));
-CREATE TABLE node_conditions (
-  id text PRIMARY KEY, node_id text NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
-  name text NOT NULL, kind text NOT NULL DEFAULT 'flag', expr text NOT NULL DEFAULT '',
-  op text NOT NULL DEFAULT '>=', value text NOT NULL DEFAULT '',
-  required integer NOT NULL DEFAULT 1, effect text NOT NULL DEFAULT 'gate',
-  weight double precision NOT NULL DEFAULT 1, note text DEFAULT '');
-CREATE TABLE node_state (
-  tree_id text NOT NULL REFERENCES trees(id) ON DELETE CASCADE,
-  context text NOT NULL DEFAULT 'default', node_id text NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
-  status text NOT NULL DEFAULT 'locked', level integer NOT NULL DEFAULT 0,
-  progress double precision NOT NULL DEFAULT 0, updated text NOT NULL,
-  PRIMARY KEY (tree_id, context, node_id));
-CREATE TABLE node_index (
-  tree_id text PRIMARY KEY REFERENCES trees(id) ON DELETE CASCADE,
-  topo_order text NOT NULL DEFAULT '', tiers text NOT NULL DEFAULT '',
-  in_degree text NOT NULL DEFAULT '', built_at text NOT NULL, dirty integer NOT NULL DEFAULT 1);
-CREATE TABLE relations (
-  id text PRIMARY KEY, src_type text NOT NULL, src_id text NOT NULL,
-  dst_type text NOT NULL, dst_id text NOT NULL, rel text NOT NULL DEFAULT 'related',
-  weight double precision NOT NULL DEFAULT 1,
-  UNIQUE (src_type, src_id, dst_type, dst_id, rel));
-CREATE TABLE jobs (
-  id text PRIMARY KEY, title text NOT NULL, command text NOT NULL,
-  every_minutes integer DEFAULT 0, at text DEFAULT '', enabled integer NOT NULL DEFAULT 1,
-  runs integer NOT NULL DEFAULT 0, last_run text DEFAULT '',
-  status text NOT NULL DEFAULT 'pending', created text NOT NULL);
-CREATE TABLE runs (
-  id text PRIMARY KEY, job_id text NOT NULL REFERENCES jobs(id) ON DELETE CASCADE,
-  started text NOT NULL, finished text DEFAULT '', rc integer, output text DEFAULT '');
-CREATE TABLE events (
-  id text PRIMARY KEY, ts text NOT NULL, actor text NOT NULL DEFAULT 'cli', kind text NOT NULL,
-  entity text DEFAULT '', entity_id text DEFAULT '', payload text DEFAULT '',
-  level text NOT NULL DEFAULT 'info');
-`;
-const MIGRATE_INDEXES = `
-CREATE INDEX IF NOT EXISTS idx_sources_project  ON sources(project_id);
-CREATE INDEX IF NOT EXISTS idx_evidence_project ON evidence(project_id);
-CREATE INDEX IF NOT EXISTS idx_claims_project   ON claims(project_id);
-CREATE INDEX IF NOT EXISTS idx_artifacts_proj   ON artifacts(project_id);
-CREATE INDEX IF NOT EXISTS idx_events_ts        ON events(ts);
-CREATE INDEX IF NOT EXISTS idx_jobs_enabled     ON jobs(enabled);
-CREATE INDEX IF NOT EXISTS idx_nodes_tree       ON nodes(tree_id);
-CREATE INDEX IF NOT EXISTS idx_nodes_tier       ON nodes(tree_id, tier);
-CREATE INDEX IF NOT EXISTS idx_edge_child       ON node_edges(child_id);
-CREATE INDEX IF NOT EXISTS idx_edge_parent      ON node_edges(parent_id);
-CREATE INDEX IF NOT EXISTS idx_edge_req         ON node_edges(child_id, required);
-CREATE INDEX IF NOT EXISTS idx_closure_desc     ON node_closure(descendant);
-CREATE INDEX IF NOT EXISTS idx_closure_anc      ON node_closure(ancestor);
-CREATE INDEX IF NOT EXISTS idx_cond_node        ON node_conditions(node_id);
-CREATE INDEX IF NOT EXISTS idx_cond_req         ON node_conditions(node_id, required);
-CREATE INDEX IF NOT EXISTS idx_state_ctx        ON node_state(tree_id, context);
-CREATE INDEX IF NOT EXISTS idx_state_status     ON node_state(tree_id, context, status);
-`;
-/**
-* One-time migration of the whole library into a standalone PG database.
-* Atomic (single transaction: DDL + data + verification), refuses a non-
-* empty target unless `fresh` drops the existing tables first. After
-* migration the CLI keeps working on SQLite only — no dual writes.
-*/
-async function migrateToPg(db, url, fresh = false) {
-	let pg;
-	try {
-		pg = require("pg");
-	} catch {
-		throw new Error("pg driver not installed — run: pnpm add pg (optional dependency)");
-	}
-	const typeErrors = preflightTypeCheck(db);
-	if (typeErrors.length) {
-		const lines = typeErrors.slice(0, 5).map((e) => `  ${e.table}.${e.column} rowid=${e.rowid}: value "${e.value}" is not a valid INTEGER`);
-		throw new Error(`pre-flight type check failed (${typeErrors.length} issue(s)) — fix these before migrating:\n${lines.join("\n")}${typeErrors.length > 5 ? `\n  ...and ${typeErrors.length - 5} more` : ""}\n  hint: ygl-trees db sql "UPDATE <table> SET <column>=<int> WHERE rowid=<rowid>"`);
-	}
-	const client = new pg.Client({ connectionString: url });
-	await client.connect();
-	try {
-		const verNum = Number((await client.query("SHOW server_version_num")).rows[0].server_version_num);
-		const ver = (await client.query("SELECT version()")).rows[0].version;
-		const fulltext = verNum >= 12e4 ? "tsvector+GIN" : "ngram-only(pg<12)";
-		if (!fresh) {
-			for (const t of MIRROR_TABLES) if ((await client.query(`SELECT 1 AS hit FROM information_schema.tables WHERE table_name=$1`, [t])).rowCount) {
-				const n = (await client.query(`SELECT count(*)::int n FROM "${t}"`)).rows[0].n;
-				if (n > 0) throw new Error(`target already contains data (table ${t}, ${n} rows) — migration is one-time; use --fresh to drop and recreate, or 'db sync pg' for a refreshable mirror`);
-			}
-		} else for (const t of [...MIRROR_TABLES].reverse()) await client.query(`DROP TABLE IF EXISTS "${t}" CASCADE`);
-		await client.query("BEGIN");
-		try {
-			await client.query(MIGRATE_DDL);
-			await client.query(MIGRATE_INDEXES);
-			for (const t of Object.keys(NGRAM_INPUT)) {
-				await client.query(`ALTER TABLE "${t}" ADD COLUMN IF NOT EXISTS ngram text NOT NULL DEFAULT ''`);
-				if (verNum >= 12e4) {
-					await client.query(`ALTER TABLE "${t}" ADD COLUMN IF NOT EXISTS ngram_tsv tsvector
-               GENERATED ALWAYS AS (to_tsvector('simple', regexp_replace(coalesce(ngram,''), '[/\\._:,&+()]+', ' ', 'g'))) STORED`);
-					await client.query(`CREATE INDEX IF NOT EXISTS "${t}_tsv" ON "${t}" USING GIN (ngram_tsv)`);
-				}
-			}
-			for (const t of MIRROR_TABLES) {
-				const src = db.all(`PRAGMA table_info(${t})`).map((c) => c.name).sort();
-				const dst = (await client.query(`SELECT column_name FROM information_schema.columns WHERE table_name=$1`, [t])).rows.map((r) => r.column_name);
-				const want = new Set(src);
-				if (Object.keys(NGRAM_INPUT).includes(t)) {
-					want.add("ngram");
-					if (verNum >= 12e4) want.add("ngram_tsv");
-				}
-				const got = new Set(dst);
-				if ([...want].filter((c) => !got.has(c)).length || got.size !== want.size) throw new Error(`schema drift on ${t}: migrate DDL out of date (want [${[...want]}]; got [${dst}]) — update MIGRATE_DDL`);
-			}
-			const result = [];
-			for (const t of MIRROR_TABLES) {
-				const rows = await copyTable(client, db, t);
-				const n = (await client.query(`SELECT count(*)::int n FROM "${t}"`)).rows[0].n;
-				if (n !== rows) throw new Error(`count mismatch on ${t}: copied ${rows}, found ${n}`);
-				result.push({
-					table: t,
-					rows
-				});
-			}
-			await client.query("COMMIT");
-			return {
-				tables: result,
-				server_version: ver,
-				constraints: {
-					fk: (await client.query(`SELECT count(*)::int n FROM information_schema.table_constraints WHERE constraint_type='FOREIGN KEY'`)).rows[0].n,
-					unique: (await client.query(`SELECT count(*)::int n FROM information_schema.table_constraints WHERE constraint_type='UNIQUE'`)).rows[0].n
-				},
-				fulltext
-			};
-		} catch (e) {
-			await client.query("ROLLBACK");
-			throw e;
-		}
-	} finally {
-		await client.end();
-	}
-}
-/** Pre-flight: scan INTEGER columns for non-integer values (SQLite weak
-*  typing allows REAL into INTEGER; PG rejects at migration time with no
-*  context). Returns actionable errors with table.column+rowid. */
-function preflightTypeCheck(db) {
-	const issues = [];
-	const tables = db.all("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE '%_fts%' AND name NOT LIKE '%_config%' AND name NOT LIKE '%_content%' AND name NOT LIKE '%_data%' AND name NOT LIKE '%_docsize%' AND name NOT LIKE '%_idx%' AND name != 'meta'");
-	for (const t of tables) {
-		const cols = db.all(`PRAGMA table_info(${t.name})`);
-		for (const c of cols) {
-			if (c.type !== "INTEGER") continue;
-			const bad = db.all(`SELECT rowid, ${c.name} AS v FROM ${t.name} WHERE typeof(${c.name}) NOT IN ('integer','null') LIMIT 5`);
-			for (const row of bad) issues.push({
-				table: t.name,
-				column: c.name,
-				rowid: row.rowid,
-				value: String(row.v)
-			});
-		}
-	}
-	return issues;
-}
-//#endregion
-//#region \0@oxc-project+runtime@0.154.0/helpers/esm/decorateMetadata.js
-function __decorateMetadata(k, v) {
-	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-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) {
-	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.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 = require_rolldown_runtime.__esmMin((() => {}));
-//#endregion
-//#region packages/research/pipeline/src/entities.ts
-/**
-* Research-domain entities — a typed snapshot of schema v5.
-*
-* Contract with the schema authority:
-*  - `synchronize` is ALWAYS false; migrations stay on the PRAGMA
-*    user_version track (src/db.ts). If SCHEMA_SQL changes, these
-*    entities must be updated in the same commit.
-*  - Column names are explicit snake_case to match the database exactly.
-*  - FTS5 virtual tables and PRAGMA paths are OUT of entity scope; they
-*    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 = require_rolldown_runtime.__esmMin((() => {
-	init_decorateMetadata();
-	init_decorate();
-	Project = class Project {
-		id;
-		name;
-		question;
-		inclusion;
-		exclusion;
-		status;
-		created;
-		updated;
-		queries;
-		claims;
-		sources;
-	};
-	__decorate([(0, typeorm.PrimaryColumn)({
-		name: "id",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Project.prototype, "id", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "name",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Project.prototype, "name", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "question",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Project.prototype, "question", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "inclusion",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Project.prototype, "inclusion", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "exclusion",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Project.prototype, "exclusion", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "status",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Project.prototype, "status", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "created",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Project.prototype, "created", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "updated",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Project.prototype, "updated", void 0);
-	__decorate([(0, typeorm.OneToMany)(() => Query, (q) => q.project, { createForeignKeyConstraints: false }), __decorateMetadata("design:type", Array)], Project.prototype, "queries", void 0);
-	__decorate([(0, typeorm.OneToMany)(() => Claim, (c) => c.project, { createForeignKeyConstraints: false }), __decorateMetadata("design:type", Array)], Project.prototype, "claims", void 0);
-	__decorate([(0, typeorm.OneToMany)(() => Source, (s) => s.project, { createForeignKeyConstraints: false }), __decorateMetadata("design:type", Array)], Project.prototype, "sources", void 0);
-	Project = __decorate([(0, typeorm.Entity)({ name: "projects" })], Project);
-	Query = class Query {
-		id;
-		projectId;
-		text;
-		engine;
-		status;
-		note;
-		contentHash;
-		created;
-		project;
-		querySources;
-	};
-	__decorate([(0, typeorm.PrimaryColumn)({
-		name: "id",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Query.prototype, "id", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "project_id",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Query.prototype, "projectId", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "text",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Query.prototype, "text", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "engine",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Query.prototype, "engine", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "status",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Query.prototype, "status", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "note",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Query.prototype, "note", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "content_hash",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Query.prototype, "contentHash", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "created",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Query.prototype, "created", void 0);
-	__decorate([
-		(0, typeorm.ManyToOne)(() => Project, (p) => p.queries, { createForeignKeyConstraints: false }),
-		(0, typeorm.JoinColumn)({ name: "project_id" }),
-		__decorateMetadata("design:type", typeof Project === "undefined" ? Object : Project)
-	], Query.prototype, "project", void 0);
-	__decorate([(0, typeorm.OneToMany)(() => QuerySource, (qs) => qs.query, { createForeignKeyConstraints: false }), __decorateMetadata("design:type", Array)], Query.prototype, "querySources", void 0);
-	Query = __decorate([(0, typeorm.Entity)({ name: "queries" })], Query);
-	Source = class Source {
-		id;
-		projectId;
-		url;
-		title;
-		urlHash;
-		contentHash;
-		abstract;
-		content;
-		engine;
-		relevance;
-		confidence;
-		tags;
-		retrievedAt;
-		created;
-		project;
-		querySources;
-	};
-	__decorate([(0, typeorm.PrimaryColumn)({
-		name: "id",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Source.prototype, "id", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "project_id",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Source.prototype, "projectId", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "url",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Source.prototype, "url", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "title",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Source.prototype, "title", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "url_hash",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Source.prototype, "urlHash", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "content_hash",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Source.prototype, "contentHash", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "abstract",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Source.prototype, "abstract", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "content",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Source.prototype, "content", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "engine",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Source.prototype, "engine", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "relevance",
-		type: "integer"
-	}), __decorateMetadata("design:type", Number)], Source.prototype, "relevance", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "confidence",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Source.prototype, "confidence", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "tags",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Source.prototype, "tags", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "retrieved_at",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Source.prototype, "retrievedAt", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "created",
-		type: "text",
-		nullable: true
-	}), __decorateMetadata("design:type", String)], Source.prototype, "created", void 0);
-	__decorate([
-		(0, typeorm.ManyToOne)(() => Project, (p) => p.sources, { createForeignKeyConstraints: false }),
-		(0, typeorm.JoinColumn)({ name: "project_id" }),
-		__decorateMetadata("design:type", typeof Project === "undefined" ? Object : Project)
-	], Source.prototype, "project", void 0);
-	__decorate([(0, typeorm.OneToMany)(() => QuerySource, (qs) => qs.source, { createForeignKeyConstraints: false }), __decorateMetadata("design:type", Array)], Source.prototype, "querySources", void 0);
-	Source = __decorate([(0, typeorm.Entity)({ name: "sources" })], Source);
-	QuerySource = class QuerySource {
-		queryId;
-		sourceId;
-		note;
-		created;
-		query;
-		source;
-	};
-	__decorate([(0, typeorm.PrimaryColumn)({
-		name: "query_id",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], QuerySource.prototype, "queryId", void 0);
-	__decorate([(0, typeorm.PrimaryColumn)({
-		name: "source_id",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], QuerySource.prototype, "sourceId", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "note",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], QuerySource.prototype, "note", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "created",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], QuerySource.prototype, "created", void 0);
-	__decorate([
-		(0, typeorm.ManyToOne)(() => Query, (q) => q.querySources, { createForeignKeyConstraints: false }),
-		(0, typeorm.JoinColumn)({ name: "query_id" }),
-		__decorateMetadata("design:type", typeof Query === "undefined" ? Object : Query)
-	], QuerySource.prototype, "query", void 0);
-	__decorate([
-		(0, typeorm.ManyToOne)(() => Source, (s) => s.querySources, { createForeignKeyConstraints: false }),
-		(0, typeorm.JoinColumn)({ name: "source_id" }),
-		__decorateMetadata("design:type", typeof Source === "undefined" ? Object : Source)
-	], QuerySource.prototype, "source", void 0);
-	QuerySource = __decorate([(0, typeorm.Entity)({ name: "query_sources" })], QuerySource);
-	Evidence = class Evidence {
-		id;
-		projectId;
-		sourceId;
-		quote;
-		note;
-		locator;
-		contentHash;
-		created;
-		project;
-		source;
-		claimEvidence;
-	};
-	__decorate([(0, typeorm.PrimaryColumn)({
-		name: "id",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Evidence.prototype, "id", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "project_id",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Evidence.prototype, "projectId", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "source_id",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Evidence.prototype, "sourceId", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "quote",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Evidence.prototype, "quote", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "note",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Evidence.prototype, "note", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "locator",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Evidence.prototype, "locator", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "content_hash",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Evidence.prototype, "contentHash", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "created",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Evidence.prototype, "created", void 0);
-	__decorate([
-		(0, typeorm.ManyToOne)(() => Project, void 0, { createForeignKeyConstraints: false }),
-		(0, typeorm.JoinColumn)({ name: "project_id" }),
-		__decorateMetadata("design:type", typeof Project === "undefined" ? Object : Project)
-	], Evidence.prototype, "project", void 0);
-	__decorate([
-		(0, typeorm.ManyToOne)(() => Source, void 0, { createForeignKeyConstraints: false }),
-		(0, typeorm.JoinColumn)({ name: "source_id" }),
-		__decorateMetadata("design:type", typeof Source === "undefined" ? Object : Source)
-	], Evidence.prototype, "source", void 0);
-	__decorate([(0, typeorm.OneToMany)(() => ClaimEvidence, (ce) => ce.evidence, { createForeignKeyConstraints: false }), __decorateMetadata("design:type", Array)], Evidence.prototype, "claimEvidence", void 0);
-	Evidence = __decorate([(0, typeorm.Entity)({ name: "evidence" })], Evidence);
-	Claim = class Claim {
-		id;
-		projectId;
-		text;
-		status;
-		confidence;
-		contentHash;
-		created;
-		updated;
-		project;
-		claimEvidence;
-	};
-	__decorate([(0, typeorm.PrimaryColumn)({
-		name: "id",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Claim.prototype, "id", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "project_id",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Claim.prototype, "projectId", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "text",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Claim.prototype, "text", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "status",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Claim.prototype, "status", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "confidence",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Claim.prototype, "confidence", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "content_hash",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Claim.prototype, "contentHash", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "created",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Claim.prototype, "created", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "updated",
-		type: "text",
-		nullable: true
-	}), __decorateMetadata("design:type", String)], Claim.prototype, "updated", void 0);
-	__decorate([
-		(0, typeorm.ManyToOne)(() => Project, (p) => p.claims, { createForeignKeyConstraints: false }),
-		(0, typeorm.JoinColumn)({ name: "project_id" }),
-		__decorateMetadata("design:type", typeof Project === "undefined" ? Object : Project)
-	], Claim.prototype, "project", void 0);
-	__decorate([(0, typeorm.OneToMany)(() => ClaimEvidence, (ce) => ce.claim, { createForeignKeyConstraints: false }), __decorateMetadata("design:type", Array)], Claim.prototype, "claimEvidence", void 0);
-	Claim = __decorate([(0, typeorm.Entity)({ name: "claims" })], Claim);
-	ClaimEvidence = class ClaimEvidence {
-		claimId;
-		evidenceId;
-		stance;
-		claim;
-		evidence;
-	};
-	__decorate([(0, typeorm.PrimaryColumn)({
-		name: "claim_id",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], ClaimEvidence.prototype, "claimId", void 0);
-	__decorate([(0, typeorm.PrimaryColumn)({
-		name: "evidence_id",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], ClaimEvidence.prototype, "evidenceId", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "stance",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], ClaimEvidence.prototype, "stance", void 0);
-	__decorate([
-		(0, typeorm.ManyToOne)(() => Claim, (c) => c.claimEvidence, { createForeignKeyConstraints: false }),
-		(0, typeorm.JoinColumn)({ name: "claim_id" }),
-		__decorateMetadata("design:type", typeof Claim === "undefined" ? Object : Claim)
-	], ClaimEvidence.prototype, "claim", void 0);
-	__decorate([
-		(0, typeorm.ManyToOne)(() => Evidence, void 0, { createForeignKeyConstraints: false }),
-		(0, typeorm.JoinColumn)({ name: "evidence_id" }),
-		__decorateMetadata("design:type", typeof Evidence === "undefined" ? Object : Evidence)
-	], ClaimEvidence.prototype, "evidence", void 0);
-	ClaimEvidence = __decorate([(0, typeorm.Entity)({ name: "claim_evidence" })], ClaimEvidence);
-	RESEARCH_ENTITIES = [
-		Project,
-		Query,
-		Source,
-		QuerySource,
-		Evidence,
-		Claim,
-		ClaimEvidence
-	];
-}));
-//#endregion
-//#region packages/core/database/src/entities.ts
-/** 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 = require_rolldown_runtime.__esmMin((() => {
-	init_decorateMetadata();
-	init_decorate();
-	Event = class Event {
-		id;
-		ts;
-		actor;
-		kind;
-		entity;
-		entityId;
-		payload;
-		/** v7 telemetry severity: info | warn | error (spec R10.2) */
-		level;
-	};
-	__decorate([(0, typeorm.PrimaryColumn)({
-		name: "id",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Event.prototype, "id", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "ts",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Event.prototype, "ts", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "actor",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Event.prototype, "actor", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "kind",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Event.prototype, "kind", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "entity",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Event.prototype, "entity", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "entity_id",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Event.prototype, "entityId", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "payload",
-		type: "text"
-	}), __decorateMetadata("design:type", String)], Event.prototype, "payload", void 0);
-	__decorate([(0, typeorm.Column)({
-		name: "level",
-		type: "text",
-		default: "info"
-	}), __decorateMetadata("design:type", String)], Event.prototype, "level", void 0);
-	Event = __decorate([(0, typeorm.Entity)({ name: "events" })], Event);
-	CORE_ENTITIES = [Event];
-}));
-//#endregion
-//#region packages/core/database/src/orm.ts
+  id text PRIMARY KEY, title text NOT NULL, body text NOT NULL DEFAULT '',
+  source_url text DEFAULT '', origin text DEFAULT '', tags text DEFAULT '',
+  confidence text NOT NULL DEFAULT 'B', reuse integer NOT NULL DEFAULT 0,
+  content_hash text NOT NULL DEFAULT '', created text NOT NULL, updated text NOT NULL,
+  UNIQUE (content_hash));
+CREATE TABLE kb_links (
+  from_id text NOT NULL REFERENCES kb_notes(id) ON DELETE CASCADE,
+  to_id text NOT NULL REFERENCES kb_notes(id) ON DELETE CASCADE,
+  rel text NOT NULL DEFAULT 'related', PRIMARY KEY (from_id, to_id, rel));
+CREATE TABLE trees (
+  id text PRIMARY KEY, project_id text REFERENCES projects(id) ON DELETE CASCADE,
+  name text NOT NULL UNIQUE, note text DEFAULT '', created text NOT NULL);
+CREATE TABLE nodes (
+  id text PRIMARY KEY, tree_id text NOT NULL REFERENCES trees(id) ON DELETE CASCADE,
+  key text NOT NULL, name text NOT NULL, kind text NOT NULL DEFAULT 'tech',
+  tier integer NOT NULL DEFAULT 0, cost double precision NOT NULL DEFAULT 0,
+  cost_unit text DEFAULT '', payload text DEFAULT '', tags text DEFAULT '',
+  created text NOT NULL, UNIQUE (tree_id, key));
+CREATE TABLE node_edges (
+  id text PRIMARY KEY, tree_id text NOT NULL REFERENCES trees(id) ON DELETE CASCADE,
+  parent_id text NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
+  child_id text NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
+  rel text NOT NULL DEFAULT 'prereq', mode text NOT NULL DEFAULT 'AND',
+  required integer NOT NULL DEFAULT 1, min_level integer NOT NULL DEFAULT 1,
+  weight double precision NOT NULL DEFAULT 1, note text DEFAULT '',
+  UNIQUE (parent_id, child_id, rel));
+CREATE TABLE node_closure (
+  tree_id text NOT NULL, ancestor text NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
+  descendant text NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
+  depth integer NOT NULL, PRIMARY KEY (ancestor, descendant));
+CREATE TABLE node_conditions (
+  id text PRIMARY KEY, node_id text NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
+  name text NOT NULL, kind text NOT NULL DEFAULT 'flag', expr text NOT NULL DEFAULT '',
+  op text NOT NULL DEFAULT '>=', value text NOT NULL DEFAULT '',
+  required integer NOT NULL DEFAULT 1, effect text NOT NULL DEFAULT 'gate',
+  weight double precision NOT NULL DEFAULT 1, note text DEFAULT '');
+CREATE TABLE node_state (
+  tree_id text NOT NULL REFERENCES trees(id) ON DELETE CASCADE,
+  context text NOT NULL DEFAULT 'default', node_id text NOT NULL REFERENCES nodes(id) ON DELETE CASCADE,
+  status text NOT NULL DEFAULT 'locked', level integer NOT NULL DEFAULT 0,
+  progress double precision NOT NULL DEFAULT 0, updated text NOT NULL,
+  PRIMARY KEY (tree_id, context, node_id));
+CREATE TABLE node_index (
+  tree_id text PRIMARY KEY REFERENCES trees(id) ON DELETE CASCADE,
+  topo_order text NOT NULL DEFAULT '', tiers text NOT NULL DEFAULT '',
+  in_degree text NOT NULL DEFAULT '', built_at text NOT NULL, dirty integer NOT NULL DEFAULT 1);
+CREATE TABLE relations (
+  id text PRIMARY KEY, src_type text NOT NULL, src_id text NOT NULL,
+  dst_type text NOT NULL, dst_id text NOT NULL, rel text NOT NULL DEFAULT 'related',
+  weight double precision NOT NULL DEFAULT 1,
+  UNIQUE (src_type, src_id, dst_type, dst_id, rel));
+CREATE TABLE jobs (
+  id text PRIMARY KEY, title text NOT NULL, command text NOT NULL,
+  every_minutes integer DEFAULT 0, at text DEFAULT '', enabled integer NOT NULL DEFAULT 1,
+  runs integer NOT NULL DEFAULT 0, last_run text DEFAULT '',
+  status text NOT NULL DEFAULT 'pending', created text NOT NULL);
+CREATE TABLE runs (
+  id text PRIMARY KEY, job_id text NOT NULL REFERENCES jobs(id) ON DELETE CASCADE,
+  started text NOT NULL, finished text DEFAULT '', rc integer, output text DEFAULT '');
+CREATE TABLE events (
+  id text PRIMARY KEY, ts text NOT NULL, actor text NOT NULL DEFAULT 'cli', kind text NOT NULL,
+  entity text DEFAULT '', entity_id text DEFAULT '', payload text DEFAULT '',
+  level text NOT NULL DEFAULT 'info');
+`;
+const MIGRATE_INDEXES = `
+CREATE INDEX IF NOT EXISTS idx_sources_project  ON sources(project_id);
+CREATE INDEX IF NOT EXISTS idx_evidence_project ON evidence(project_id);
+CREATE INDEX IF NOT EXISTS idx_claims_project   ON claims(project_id);
+CREATE INDEX IF NOT EXISTS idx_artifacts_proj   ON artifacts(project_id);
+CREATE INDEX IF NOT EXISTS idx_events_ts        ON events(ts);
+CREATE INDEX IF NOT EXISTS idx_jobs_enabled     ON jobs(enabled);
+CREATE INDEX IF NOT EXISTS idx_nodes_tree       ON nodes(tree_id);
+CREATE INDEX IF NOT EXISTS idx_nodes_tier       ON nodes(tree_id, tier);
+CREATE INDEX IF NOT EXISTS idx_edge_child       ON node_edges(child_id);
+CREATE INDEX IF NOT EXISTS idx_edge_parent      ON node_edges(parent_id);
+CREATE INDEX IF NOT EXISTS idx_edge_req         ON node_edges(child_id, required);
+CREATE INDEX IF NOT EXISTS idx_closure_desc     ON node_closure(descendant);
+CREATE INDEX IF NOT EXISTS idx_closure_anc      ON node_closure(ancestor);
+CREATE INDEX IF NOT EXISTS idx_cond_node        ON node_conditions(node_id);
+CREATE INDEX IF NOT EXISTS idx_cond_req         ON node_conditions(node_id, required);
+CREATE INDEX IF NOT EXISTS idx_state_ctx        ON node_state(tree_id, context);
+CREATE INDEX IF NOT EXISTS idx_state_status     ON node_state(tree_id, context, status);
+`;
 /**
-* Lazy TypeORM DataSource over the SAME SQLite file the CLI works on.
-*
-* Boundaries (see docs/plan.md "TypeORM boundaries"):
-*  - `synchronize` is permanently false — schema authority stays with
-*    SCHEMA_SQL + PRAGMA user_version migrations in src/db.ts. Entities in
-*    src/entities/ are a typed snapshot; change them in the same commit as
-*    SCHEMA_SQL.
-*  - TypeORM is a QUERY layer here, not a migration layer. FTS5 MATCH /
-*    bm25 loops, PRAGMA paths and the PG sync/migrate machinery stay raw
-*    SQL on the DB class.
-*  - CLI commands using the ORM must return a Promise (main() awaits) so
-*    the DataSource settles before the wasm DB closes.
+* One-time migration of the whole library into a standalone PG database.
+* Atomic (single transaction: DDL + data + verification), refuses a non-
+* empty target unless `fresh` drops the existing tables first. After
+* migration the CLI keeps working on SQLite only — no dual writes.
 */
-var orm_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
-	closeOrm: () => closeOrm,
-	getOrm: () => getOrm
-});
-async function getOrm(dbFile) {
-	if (cached && cached.file === dbFile) return cached.ds;
-	const ds = new typeorm.DataSource({
-		type: "better-sqlite3",
-		database: dbFile,
-		synchronize: false,
-		entities: [...RESEARCH_ENTITIES, ...CORE_ENTITIES]
-	});
-	await ds.initialize();
-	await ds.query("PRAGMA synchronous=NORMAL");
-	cached = {
-		file: dbFile,
-		ds
-	};
-	return ds;
-}
-/** Destroy the cached DataSource (tests/scratch dirs cannot be removed on
-*  Windows while a better-sqlite3 handle keeps the file open — EPERM). */
-async function closeOrm() {
-	if (cached) {
+async function migrateToPg(db, url, fresh = false) {
+	let pg;
+	try {
+		pg = require("pg");
+	} catch {
+		throw new Error("pg driver not installed — run: pnpm add pg (optional dependency)");
+	}
+	const typeErrors = preflightTypeCheck(db);
+	if (typeErrors.length) {
+		const lines = typeErrors.slice(0, 5).map((e) => `  ${e.table}.${e.column} rowid=${e.rowid}: value "${e.value}" is not a valid INTEGER`);
+		throw new Error(`pre-flight type check failed (${typeErrors.length} issue(s)) — fix these before migrating:\n${lines.join("\n")}${typeErrors.length > 5 ? `\n  ...and ${typeErrors.length - 5} more` : ""}\n  hint: ygl-trees db sql "UPDATE <table> SET <column>=<int> WHERE rowid=<rowid>"`);
+	}
+	const client = new pg.Client({ connectionString: url });
+	await client.connect();
+	try {
+		const verNum = Number((await client.query("SHOW server_version_num")).rows[0].server_version_num);
+		const ver = (await client.query("SELECT version()")).rows[0].version;
+		const fulltext = verNum >= 12e4 ? "tsvector+GIN" : "ngram-only(pg<12)";
+		if (!fresh) {
+			for (const t of MIRROR_TABLES) if ((await client.query(`SELECT 1 AS hit FROM information_schema.tables WHERE table_name=$1`, [t])).rowCount) {
+				const n = (await client.query(`SELECT count(*)::int n FROM "${t}"`)).rows[0].n;
+				if (n > 0) throw new Error(`target already contains data (table ${t}, ${n} rows) — migration is one-time; use --fresh to drop and recreate, or 'db sync pg' for a refreshable mirror`);
+			}
+		} else for (const t of [...MIRROR_TABLES].reverse()) await client.query(`DROP TABLE IF EXISTS "${t}" CASCADE`);
+		await client.query("BEGIN");
 		try {
-			await cached.ds.destroy();
-		} catch {}
-		cached = null;
+			await client.query(MIGRATE_DDL);
+			await client.query(MIGRATE_INDEXES);
+			for (const t of Object.keys(NGRAM_INPUT)) {
+				await client.query(`ALTER TABLE "${t}" ADD COLUMN IF NOT EXISTS ngram text NOT NULL DEFAULT ''`);
+				if (verNum >= 12e4) {
+					await client.query(`ALTER TABLE "${t}" ADD COLUMN IF NOT EXISTS ngram_tsv tsvector
+               GENERATED ALWAYS AS (to_tsvector('simple', regexp_replace(coalesce(ngram,''), '[/\\._:,&+()]+', ' ', 'g'))) STORED`);
+					await client.query(`CREATE INDEX IF NOT EXISTS "${t}_tsv" ON "${t}" USING GIN (ngram_tsv)`);
+				}
+			}
+			for (const t of MIRROR_TABLES) {
+				const src = db.all(`PRAGMA table_info(${t})`).map((c) => c.name).sort();
+				const dst = (await client.query(`SELECT column_name FROM information_schema.columns WHERE table_name=$1`, [t])).rows.map((r) => r.column_name);
+				const want = new Set(src);
+				if (Object.keys(NGRAM_INPUT).includes(t)) {
+					want.add("ngram");
+					if (verNum >= 12e4) want.add("ngram_tsv");
+				}
+				const got = new Set(dst);
+				if ([...want].filter((c) => !got.has(c)).length || got.size !== want.size) throw new Error(`schema drift on ${t}: migrate DDL out of date (want [${[...want]}]; got [${dst}]) — update MIGRATE_DDL`);
+			}
+			const result = [];
+			for (const t of MIRROR_TABLES) {
+				const rows = await copyTable(client, db, t);
+				const n = (await client.query(`SELECT count(*)::int n FROM "${t}"`)).rows[0].n;
+				if (n !== rows) throw new Error(`count mismatch on ${t}: copied ${rows}, found ${n}`);
+				result.push({
+					table: t,
+					rows
+				});
+			}
+			await client.query("COMMIT");
+			return {
+				tables: result,
+				server_version: ver,
+				constraints: {
+					fk: (await client.query(`SELECT count(*)::int n FROM information_schema.table_constraints WHERE constraint_type='FOREIGN KEY'`)).rows[0].n,
+					unique: (await client.query(`SELECT count(*)::int n FROM information_schema.table_constraints WHERE constraint_type='UNIQUE'`)).rows[0].n
+				},
+				fulltext
+			};
+		} catch (e) {
+			await client.query("ROLLBACK");
+			throw e;
+		}
+	} finally {
+		await client.end();
 	}
 }
-var cached;
-var init_orm = require_rolldown_runtime.__esmMin((() => {
-	init_entities$1();
-	init_entities();
-	cached = null;
+/** Pre-flight: scan INTEGER columns for non-integer values (SQLite weak
+*  typing allows REAL into INTEGER; PG rejects at migration time with no
+*  context). Returns actionable errors with table.column+rowid. */
+function preflightTypeCheck(db) {
+	const issues = [];
+	const tables = db.all("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE '%_fts%' AND name NOT LIKE '%_config%' AND name NOT LIKE '%_content%' AND name NOT LIKE '%_data%' AND name NOT LIKE '%_docsize%' AND name NOT LIKE '%_idx%' AND name != 'meta'");
+	for (const t of tables) {
+		const cols = db.all(`PRAGMA table_info(${t.name})`);
+		for (const c of cols) {
+			if (c.type !== "INTEGER") continue;
+			const bad = db.all(`SELECT rowid, ${c.name} AS v FROM ${t.name} WHERE typeof(${c.name}) NOT IN ('integer','null') LIMIT 5`);
+			for (const row of bad) issues.push({
+				table: t.name,
+				column: c.name,
+				rowid: row.rowid,
+				value: String(row.v)
+			});
+		}
+	}
+	return issues;
+}
+//#endregion
+//#region packages/core/text/src/eventbus.ts
+/**
+* Cross-domain event bus — connects logEvent writes to real-time consumers.
+*
+* Architecture: a process-wide EventEmitter singleton. Write services call
+* `emitEvent()` after logEvent persists to the events table; consumers
+* (webui SSE, user plugins, future watchers) subscribe with `onEvent()`.
+*
+* This makes "ctx.on reactivity" real without requiring a full Cordis
+* event system — a lightweight bridge that the webui and plugins can use.
+*
+* @module @ygl/core-text/eventbus
+*/
+var eventbus_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
+	emitEvent: () => emitEvent,
+	onEvent: () => onEvent,
+	onEventKind: () => onEventKind
+});
+/** Publish a cross-domain event (called after events table write). */
+function emitEvent(evt) {
+	bus.emit("ygl", evt);
+	bus.emit(`ygl:${evt.kind}`, evt);
+}
+/** Subscribe to all events. Returns an unsubscribe function. */
+function onEvent(handler) {
+	bus.on("ygl", handler);
+	return () => bus.off("ygl", handler);
+}
+/** Subscribe to a specific kind (e.g. "node.unlock"). Returns unsubscribe. */
+function onEventKind(kind, handler) {
+	bus.on(`ygl:${kind}`, handler);
+	return () => bus.off(`ygl:${kind}`, handler);
+}
+var bus;
+var init_eventbus = require_rolldown_runtime.__esmMin((() => {
+	bus = new node_events.EventEmitter();
+	bus.setMaxListeners(50);
 }));
 //#endregion
 //#region packages/research/pipeline/src/writes.ts
@@ -3988,6 +4068,16 @@ async function logEvent$1(mgr, kind, entity, entityId, payload, level = "info")
 		payload: p,
 		level
 	});
+	try {
+		const { emitEvent } = (init_eventbus(), require_rolldown_runtime.__toCommonJS(eventbus_exports));
+		emitEvent({
+			kind,
+			entity,
+			entityId,
+			payload: String(payload),
+			ts: (/* @__PURE__ */ new Date()).toISOString()
+		});
+	} catch {}
 }
 async function queryAdd(ds, projectId, text, engine = "", force = false) {
 	const hash = contentHash(text, force);
@@ -4587,6 +4677,7 @@ var init_writes = require_rolldown_runtime.__esmMin((() => {
 //#endregion
 //#region packages/ops/tools/src/db-cmds.ts
 var db_cmds_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run$12 });
+init_fmt();
 init_db();
 /**
 * Cold-start: import the built-in skills that ship with this package, so a
@@ -4607,7 +4698,14 @@ async function autoImportBuiltinSkills(env, dbFile) {
 			}
 		}
 	}
-	if (!skillsDir) return 0;
+	if (!skillsDir) {
+		const { out: outFn, paint: paintFn, C: Cf } = (init_fmt(), require_rolldown_runtime.__toCommonJS(fmt_exports));
+		if (env.ctx && !env.ctx.json) {
+			outFn(env.ctx, paintFn(Cf.yellow, "  ! built-in skills: 0 found (skills/ not shipped or not in package)", env.ctx.color));
+			outFn(env.ctx, paintFn(Cf.dim, "    this is a packaging bug — skills/ should be in the npm tarball", env.ctx.color));
+		}
+		return 0;
+	}
 	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));
@@ -4645,6 +4743,7 @@ function run$12(env, action, rest, args) {
 			ok(ctx, `database:        ${file}`);
 			autoImportBuiltinSkills(env, file).then(async (n) => {
 				if (n > 0) ok(ctx, `built-in skills:  ${n} imported (agent match ready)`);
+				else warn(ctx, "built-in skills:  0 imported — skills/ directory not found in package");
 				try {
 					const { closeOrm } = (init_orm(), require_rolldown_runtime.__toCommonJS(orm_exports));
 					await closeOrm();
@@ -5282,6 +5381,7 @@ function configReset(db, key) {
 //#endregion
 //#region packages/ops/tools/src/config-cmds.ts
 var config_cmds_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run$11 });
+init_fmt();
 function run$11(env, action, rest, args) {
 	const { ctx, db } = env;
 	switch (action) {
@@ -5368,6 +5468,7 @@ function run$11(env, action, rest, args) {
 /** 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__ */ require_rolldown_runtime.__exportAll({ run: () => run$10 });
+init_fmt();
 init_text();
 init_orm();
 init_writes();
@@ -5575,6 +5676,7 @@ var agent_cmds_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	buildBrief: () => buildBrief,
 	run: () => run$9
 });
+init_fmt();
 init_text();
 /** Build the brief payload (where am I / what exists / what next).
 *  Shared by the `agent brief` command and the WebUI dashboard. */
@@ -5939,11 +6041,7 @@ function run$9(env, action, rest, args) {
 }
 //#endregion
 //#region packages/core/text/src/flagcheck.ts
-/**
-* Flag validation helpers (0.54): the cold-user audits found that bare flags
-* (parser returns boolean true) were silently stored as "true" strings, and
-* enum flags accepted arbitrary values. These helpers centralize the checks.
-*/
+init_fmt();
 /**
 * Reject bare flags (given without a value → parser yields boolean true).
 * Returns true if any flag failed (caller should `return 2`).
@@ -6121,6 +6219,7 @@ var init_eval_enhance = require_rolldown_runtime.__esmMin((() => {
 *  `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__ */ require_rolldown_runtime.__exportAll({ run: () => run$8 });
+init_fmt();
 init_text();
 init_orm();
 init_writes();
@@ -6697,6 +6796,7 @@ function run$8(env, action, rest, args) {
 //#endregion
 //#region packages/research/produce/src/project-cmds.ts
 var project_cmds_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run$7 });
+init_fmt();
 init_orm();
 init_writes();
 init_entities$1();
@@ -6835,6 +6935,7 @@ function run$7(env, action, rest, args) {
 *  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 });
+init_fmt();
 init_text();
 init_orm();
 init_writes();
@@ -7151,6 +7252,16 @@ async function logEvent(mgr, kind, entityId, payload, level = "info") {
 		body,
 		level
 	]);
+	try {
+		const { emitEvent } = (init_eventbus(), require_rolldown_runtime.__toCommonJS(eventbus_exports));
+		emitEvent({
+			kind,
+			entity: "node",
+			entityId,
+			payload: String(body),
+			ts: (/* @__PURE__ */ new Date()).toISOString()
+		});
+	} catch {}
 }
 async function reaches(mgr, treeId, fromId, toId) {
 	return (await mgr.query(`SELECT 1 AS hit FROM node_closure WHERE tree_id=? AND ancestor=? AND descendant=? AND depth>0`, [
@@ -7725,6 +7836,7 @@ async function importTree(ds, spec, opts = {}) {
 *   ygl-trees node export [--out file]  portable JSON
 */
 var cmds_exports$1 = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run$5 });
+init_fmt();
 init_orm();
 init_eval();
 init_text();
@@ -8571,6 +8683,7 @@ function parseState(args) {
 /** 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 });
+init_fmt();
 init_text();
 init_orm();
 init_writes();
@@ -8888,6 +9001,7 @@ function wrap(text, indent = 4) {
 /** 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 });
+init_fmt();
 init_text();
 init_orm();
 init_writes();
@@ -9200,6 +9314,7 @@ var rels_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	resolveRef: () => resolveRef,
 	run: () => run$2
 });
+init_fmt();
 init_text();
 init_orm();
 const REL_TYPES = [
@@ -9504,6 +9619,7 @@ var webui_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
 	nodeDetail: () => nodeDetail,
 	run: () => run$1
 });
+init_fmt();
 init_orm();
 function run$1(env, action, rest, args) {
 	if (action === "serve") return serve(env, args);
@@ -10319,6 +10435,15 @@ function createDashboardServer(env) {
 		const h = setInterval(tick, 1500);
 		if (typeof h.unref === "function") h.unref();
 	}
+	let unsubBus = null;
+	try {
+		const { onEvent } = (init_eventbus(), require_rolldown_runtime.__toCommonJS(eventbus_exports));
+		unsubBus = onEvent((evt) => {
+			if (!sseClients.size) return;
+			push("data", gatherData(env));
+			push(evt.kind.replace(/\//g, "-"), evt);
+		});
+	} catch {}
 	const server = http.createServer((req, res) => {
 		const u = new URL(req.url || "/", "http://127.0.0.1");
 		const url = u.pathname;
@@ -10416,7 +10541,15 @@ function createDashboardServer(env) {
 		sseClients.clear();
 	};
 	server.on("close", dropLive);
-	server.closeLive = dropLive;
+	server.closeLive = () => {
+		dropLive();
+		if (unsubBus) {
+			try {
+				unsubBus();
+			} catch {}
+			unsubBus = null;
+		}
+	};
 	return server;
 }
 /** Live dashboard: blocks until SIGINT/SIGTERM, then resolves so the CLI can
@@ -10475,6 +10608,7 @@ function serve(env, args) {
 //#endregion
 //#region packages/ops/tools/src/doctor.ts
 var doctor_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({ run: () => run });
+init_fmt();
 init_eval();
 init_db();
 init_plugins();
@@ -10713,6 +10847,7 @@ const DOMAIN_MODULES = {
 * Composition happens in profile-boot; no domain logic here.
 */
 init_db();
+init_fmt();
 const HOME = process.env.YGL_HOME || node_path.join(node_os.homedir(), ".ygl-trees");
 const PLUGINS = {
 	database: {
@@ -11174,6 +11309,9 @@ async function main(argv) {
 		return 1;
 	}).finally(() => {
 		try {
+			if (booted?.ctx?.database?.stop) booted.ctx.database.stop();
+		} catch {}
+		if (!booted?.ctx?.database) try {
 			db?.close();
 		} catch {}
 	});