@tea-agent/loop-agent 0.35.1-beta.0 → 0.35.1-beta.2

package/scripts/kb-graph-promote.mjs

@@ -1,164 +1,164 @@
-#!/usr/bin/env node
-/**
- * Promote knowledge/bootstrap/staging → formal trees (merge-new-only).
- * Never overwrites existing formal files. Does not call an LLM.
- */
-import fs from "node:fs";
-import path from "node:path";
-import process from "node:process";
-
-function parseArgs(argv) {
-	const out = {
-		root: process.cwd(),
-		from: "knowledge/bootstrap/staging",
-		dryRun: false,
-		json: true,
-	};
-	for (let i = 0; i < argv.length; i++) {
-		const a = argv[i];
-		if (a === "--root") out.root = path.resolve(argv[++i]);
-		else if (a === "--from") out.from = argv[++i];
-		else if (a === "--dry-run") out.dryRun = true;
-		else if (a === "--json") out.json = true;
-		else if (a === "--markdown") out.json = false;
-		else if (a === "-h" || a === "--help") {
-			console.log(
-				"Usage: node scripts/kb-graph-promote.mjs [--root <dir>] [--from <staging-rel>] [--dry-run] [--json|--markdown]",
-			);
-			process.exit(0);
-		} else {
-			throw new Error(`unknown argument: ${a}`);
-		}
-	}
-	return out;
-}
-
-function copyDirMergeNew(src, dest, dryRun, stats) {
-	if (!fs.existsSync(src)) return;
-	fs.mkdirSync(dest, { recursive: true });
-	for (const ent of fs.readdirSync(src, { withFileTypes: true })) {
-		const s = path.join(src, ent.name);
-		const d = path.join(dest, ent.name);
-		if (ent.isDirectory()) {
-			copyDirMergeNew(s, d, dryRun, stats);
-			continue;
-		}
-		if (fs.existsSync(d)) {
-			stats.skipped.push(path.relative(stats.root, d).split(path.sep).join("/"));
-			continue;
-		}
-		stats.copied.push(path.relative(stats.root, d).split(path.sep).join("/"));
-		if (!dryRun) {
-			fs.mkdirSync(path.dirname(d), { recursive: true });
-			fs.copyFileSync(s, d);
-		}
-	}
-}
-
-function featureIdFromProposalFile(fileName) {
-	if (!/^F-[A-Za-z0-9][A-Za-z0-9._-]*\.ya?ml$/.test(fileName)) {
-		throw new Error(`invalid feature link proposal filename: ${fileName}`);
-	}
-	const id = fileName.replace(/\.ya?ml$/, "");
-	if (id.includes("..")) {
-		throw new Error(`invalid feature link proposal filename: ${fileName}`);
-	}
-	return id;
-}
-
-function main() {
-	let args;
-	try {
-		args = parseArgs(process.argv.slice(2));
-	} catch (e) {
-		console.error(String(e?.message || e));
-		process.exit(2);
-	}
-	const root = args.root;
-	const staging = path.join(root, args.from);
-	if (!fs.existsSync(staging)) {
-		const err = {
-			ok: false,
-			error: `missing staging at ${args.from}`,
-		};
-		console.log(JSON.stringify(err, null, 2));
-		process.exit(1);
-	}
-
-	const stats = { root, copied: [], skipped: [] };
-	copyDirMergeNew(
-		path.join(staging, "domains"),
-		path.join(root, "knowledge/domains"),
-		args.dryRun,
-		stats,
-	);
-	copyDirMergeNew(
-		path.join(staging, "services"),
-		path.join(root, "knowledge/services"),
-		args.dryRun,
-		stats,
-	);
-	copyDirMergeNew(
-		path.join(staging, "modules"),
-		path.join(root, "knowledge/modules"),
-		args.dryRun,
-		stats,
-	);
-
-	const edgesSrc = path.join(staging, "edges.proposed.yaml");
-	const edgesManual = path.join(root, "knowledge/graph/edges.manual.yaml");
-	if (fs.existsSync(edgesSrc)) {
-		if (fs.existsSync(edgesManual)) {
-			stats.skipped.push("knowledge/graph/edges.manual.yaml");
-		} else {
-			stats.copied.push("knowledge/graph/edges.manual.yaml");
-			if (!args.dryRun) {
-				fs.mkdirSync(path.dirname(edgesManual), { recursive: true });
-				fs.copyFileSync(edgesSrc, edgesManual);
-			}
-		}
-	}
-
-	const linksDir = path.join(staging, "features-links.proposed");
-	if (fs.existsSync(linksDir)) {
-		for (const f of fs.readdirSync(linksDir)) {
-			if (!f.endsWith(".yaml") && !f.endsWith(".yml")) continue;
-			const id = featureIdFromProposalFile(f);
-			const featureDir = path.join(root, "features", id);
-			if (!fs.existsSync(featureDir)) continue;
-			const dest = path.join(featureDir, "knowledge-links.yaml");
-			const rel = `features/${id}/knowledge-links.yaml`;
-			if (fs.existsSync(dest)) {
-				stats.skipped.push(rel);
-			} else {
-				stats.copied.push(rel);
-				if (!args.dryRun) {
-					fs.mkdirSync(path.dirname(dest), { recursive: true });
-					fs.copyFileSync(path.join(linksDir, f), dest);
-				}
-			}
-		}
-	}
-
-	const result = {
-		ok: true,
-		dry_run: args.dryRun,
-		copied_count: stats.copied.length,
-		skipped_count: stats.skipped.length,
-		copied: stats.copied,
-		skipped_existing: stats.skipped,
-		policy: "merge-new-only",
-	};
-
-	if (args.json) {
-		console.log(JSON.stringify(result, null, 2));
-	} else {
-		console.log(`# kb-graph-promote${args.dryRun ? " (dry-run)" : ""}`);
-		console.log(`copied: ${result.copied_count}`);
-		console.log(`skipped_existing: ${result.skipped_count}`);
-		for (const c of stats.copied) console.log(`+ ${c}`);
-		for (const s of stats.skipped) console.log(`= ${s}`);
-	}
-}
-
-main();
+#!/usr/bin/env node
+/**
+ * Promote knowledge/bootstrap/staging → formal trees (merge-new-only).
+ * Never overwrites existing formal files. Does not call an LLM.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+
+function parseArgs(argv) {
+	const out = {
+		root: process.cwd(),
+		from: "knowledge/bootstrap/staging",
+		dryRun: false,
+		json: true,
+	};
+	for (let i = 0; i < argv.length; i++) {
+		const a = argv[i];
+		if (a === "--root") out.root = path.resolve(argv[++i]);
+		else if (a === "--from") out.from = argv[++i];
+		else if (a === "--dry-run") out.dryRun = true;
+		else if (a === "--json") out.json = true;
+		else if (a === "--markdown") out.json = false;
+		else if (a === "-h" || a === "--help") {
+			console.log(
+				"Usage: node scripts/kb-graph-promote.mjs [--root <dir>] [--from <staging-rel>] [--dry-run] [--json|--markdown]",
+			);
+			process.exit(0);
+		} else {
+			throw new Error(`unknown argument: ${a}`);
+		}
+	}
+	return out;
+}
+
+function copyDirMergeNew(src, dest, dryRun, stats) {
+	if (!fs.existsSync(src)) return;
+	fs.mkdirSync(dest, { recursive: true });
+	for (const ent of fs.readdirSync(src, { withFileTypes: true })) {
+		const s = path.join(src, ent.name);
+		const d = path.join(dest, ent.name);
+		if (ent.isDirectory()) {
+			copyDirMergeNew(s, d, dryRun, stats);
+			continue;
+		}
+		if (fs.existsSync(d)) {
+			stats.skipped.push(path.relative(stats.root, d).split(path.sep).join("/"));
+			continue;
+		}
+		stats.copied.push(path.relative(stats.root, d).split(path.sep).join("/"));
+		if (!dryRun) {
+			fs.mkdirSync(path.dirname(d), { recursive: true });
+			fs.copyFileSync(s, d);
+		}
+	}
+}
+
+function featureIdFromProposalFile(fileName) {
+	if (!/^F-[A-Za-z0-9][A-Za-z0-9._-]*\.ya?ml$/.test(fileName)) {
+		throw new Error(`invalid feature link proposal filename: ${fileName}`);
+	}
+	const id = fileName.replace(/\.ya?ml$/, "");
+	if (id.includes("..")) {
+		throw new Error(`invalid feature link proposal filename: ${fileName}`);
+	}
+	return id;
+}
+
+function main() {
+	let args;
+	try {
+		args = parseArgs(process.argv.slice(2));
+	} catch (e) {
+		console.error(String(e?.message || e));
+		process.exit(2);
+	}
+	const root = args.root;
+	const staging = path.join(root, args.from);
+	if (!fs.existsSync(staging)) {
+		const err = {
+			ok: false,
+			error: `missing staging at ${args.from}`,
+		};
+		console.log(JSON.stringify(err, null, 2));
+		process.exit(1);
+	}
+
+	const stats = { root, copied: [], skipped: [] };
+	copyDirMergeNew(
+		path.join(staging, "domains"),
+		path.join(root, "knowledge/domains"),
+		args.dryRun,
+		stats,
+	);
+	copyDirMergeNew(
+		path.join(staging, "services"),
+		path.join(root, "knowledge/services"),
+		args.dryRun,
+		stats,
+	);
+	copyDirMergeNew(
+		path.join(staging, "modules"),
+		path.join(root, "knowledge/modules"),
+		args.dryRun,
+		stats,
+	);
+
+	const edgesSrc = path.join(staging, "edges.proposed.yaml");
+	const edgesManual = path.join(root, "knowledge/graph/edges.manual.yaml");
+	if (fs.existsSync(edgesSrc)) {
+		if (fs.existsSync(edgesManual)) {
+			stats.skipped.push("knowledge/graph/edges.manual.yaml");
+		} else {
+			stats.copied.push("knowledge/graph/edges.manual.yaml");
+			if (!args.dryRun) {
+				fs.mkdirSync(path.dirname(edgesManual), { recursive: true });
+				fs.copyFileSync(edgesSrc, edgesManual);
+			}
+		}
+	}
+
+	const linksDir = path.join(staging, "features-links.proposed");
+	if (fs.existsSync(linksDir)) {
+		for (const f of fs.readdirSync(linksDir)) {
+			if (!f.endsWith(".yaml") && !f.endsWith(".yml")) continue;
+			const id = featureIdFromProposalFile(f);
+			const featureDir = path.join(root, "features", id);
+			if (!fs.existsSync(featureDir)) continue;
+			const dest = path.join(featureDir, "knowledge-links.yaml");
+			const rel = `features/${id}/knowledge-links.yaml`;
+			if (fs.existsSync(dest)) {
+				stats.skipped.push(rel);
+			} else {
+				stats.copied.push(rel);
+				if (!args.dryRun) {
+					fs.mkdirSync(path.dirname(dest), { recursive: true });
+					fs.copyFileSync(path.join(linksDir, f), dest);
+				}
+			}
+		}
+	}
+
+	const result = {
+		ok: true,
+		dry_run: args.dryRun,
+		copied_count: stats.copied.length,
+		skipped_count: stats.skipped.length,
+		copied: stats.copied,
+		skipped_existing: stats.skipped,
+		policy: "merge-new-only",
+	};
+
+	if (args.json) {
+		console.log(JSON.stringify(result, null, 2));
+	} else {
+		console.log(`# kb-graph-promote${args.dryRun ? " (dry-run)" : ""}`);
+		console.log(`copied: ${result.copied_count}`);
+		console.log(`skipped_existing: ${result.skipped_count}`);
+		for (const c of stats.copied) console.log(`+ ${c}`);
+		for (const s of stats.skipped) console.log(`= ${s}`);
+	}
+}
+
+main();