@tea-agent/loop-agent 0.13.0-alpha.0 → 0.13.0-beta.0

package/scripts/kb-graph-incremental-prepare.sh

@@ -1,5 +1,5 @@
-#!/usr/bin/env bash
-# Incremental knowledge-graph update prepare (narrowed scope for bootstrap DAG).
-set -euo pipefail
-ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-exec node "${ROOT_DIR}/scripts/kb-graph-incremental-prepare.mjs" "$@"
+#!/usr/bin/env bash
+# Incremental knowledge-graph update prepare (narrowed scope for bootstrap DAG).
+set -euo pipefail
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+exec node "${ROOT_DIR}/scripts/kb-graph-incremental-prepare.mjs" "$@"

package/scripts/kb-graph-materialize.mjs

@@ -1,105 +1,105 @@
-#!/usr/bin/env node
-/**
- * Standalone B6-ish materialize: rebuild knowledge/graph/entities-index.yaml
- * and edges.yaml from formal trees + edges.manual.yaml.
- */
-import fs from "node:fs";
-import path from "node:path";
-import process from "node:process";
-
-function parseArgs(argv) {
-	let root = process.cwd();
-	for (let i = 0; i < argv.length; i++) {
-		if (argv[i] === "--root") root = path.resolve(argv[++i]);
-		else if (argv[i] === "-h" || argv[i] === "--help") {
-			console.log("Usage: node scripts/kb-graph-materialize.mjs [--root <dir>]");
-			process.exit(0);
-		}
-	}
-	return { root };
-}
-
-function walk(dir, acc = []) {
-	if (!fs.existsSync(dir)) return acc;
-	for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
-		const p = path.join(dir, ent.name);
-		if (ent.isDirectory()) walk(p, acc);
-		else acc.push(p);
-	}
-	return acc;
-}
-
-function main() {
-	const { root } = parseArgs(process.argv.slice(2));
-	const entities = [];
-	for (const base of ["knowledge/domains", "knowledge/services", "knowledge/modules"]) {
-		for (const f of walk(path.join(root, base))) {
-			if (!f.endsWith("meta.yaml") && !f.endsWith("meta.yml")) continue;
-			const rel = path.relative(root, f).split(path.sep).join("/");
-			const text = fs.readFileSync(f, "utf8");
-			const id = (text.match(/^id:\s*(\S+)/m) || [])[1];
-			const kind = (text.match(/^kind:\s*(\S+)/m) || [])[1] || "unknown";
-			if (id) entities.push({ kind, id, path: rel });
-		}
-	}
-	const featRoot = path.join(root, "features");
-	if (fs.existsSync(featRoot)) {
-		for (const name of fs.readdirSync(featRoot)) {
-			if (!/^F-/.test(name)) continue;
-			const dir = path.join(featRoot, name);
-			if (!fs.statSync(dir).isDirectory()) continue;
-			entities.push({ kind: "feature", id: name, path: `features/${name}/` });
-			const links = path.join(dir, "knowledge-links.yaml");
-			if (fs.existsSync(links)) {
-				entities.push({
-					kind: "knowledge-links",
-					id: `${name}:links`,
-					path: `features/${name}/knowledge-links.yaml`,
-				});
-			}
-		}
-	}
-
-	const graphDir = path.join(root, "knowledge/graph");
-	fs.mkdirSync(graphDir, { recursive: true });
-	const generatedAt = new Date().toISOString();
-	const indexBody = [
-		"# generated by kb-graph-materialize",
-		"schema_version: 1",
-		`generated_at: ${generatedAt}`,
-		"entities:",
-		...entities.flatMap((e) => [
-			`  - kind: ${e.kind}`,
-			`    id: ${e.id}`,
-			`    path: ${e.path}`,
-		]),
-		"",
-	].join("\n");
-	fs.writeFileSync(path.join(graphDir, "entities-index.yaml"), indexBody);
-
-	const manual = path.join(graphDir, "edges.manual.yaml");
-	const edgesOut = path.join(graphDir, "edges.yaml");
-	if (fs.existsSync(manual)) {
-		fs.copyFileSync(manual, edgesOut);
-	} else if (!fs.existsSync(edgesOut)) {
-		fs.writeFileSync(
-			edgesOut,
-			`schema_version: 1\nupdated_at: ${generatedAt}\nedges: []\n`,
-		);
-	}
-
-	console.log(
-		JSON.stringify(
-			{
-				ok: true,
-				entities: entities.length,
-				entities_index: "knowledge/graph/entities-index.yaml",
-				edges: "knowledge/graph/edges.yaml",
-			},
-			null,
-			2,
-		),
-	);
-}
-
-main();
+#!/usr/bin/env node
+/**
+ * Standalone B6-ish materialize: rebuild knowledge/graph/entities-index.yaml
+ * and edges.yaml from formal trees + edges.manual.yaml.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+
+function parseArgs(argv) {
+	let root = process.cwd();
+	for (let i = 0; i < argv.length; i++) {
+		if (argv[i] === "--root") root = path.resolve(argv[++i]);
+		else if (argv[i] === "-h" || argv[i] === "--help") {
+			console.log("Usage: node scripts/kb-graph-materialize.mjs [--root <dir>]");
+			process.exit(0);
+		}
+	}
+	return { root };
+}
+
+function walk(dir, acc = []) {
+	if (!fs.existsSync(dir)) return acc;
+	for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
+		const p = path.join(dir, ent.name);
+		if (ent.isDirectory()) walk(p, acc);
+		else acc.push(p);
+	}
+	return acc;
+}
+
+function main() {
+	const { root } = parseArgs(process.argv.slice(2));
+	const entities = [];
+	for (const base of ["knowledge/domains", "knowledge/services", "knowledge/modules"]) {
+		for (const f of walk(path.join(root, base))) {
+			if (!f.endsWith("meta.yaml") && !f.endsWith("meta.yml")) continue;
+			const rel = path.relative(root, f).split(path.sep).join("/");
+			const text = fs.readFileSync(f, "utf8");
+			const id = (text.match(/^id:\s*(\S+)/m) || [])[1];
+			const kind = (text.match(/^kind:\s*(\S+)/m) || [])[1] || "unknown";
+			if (id) entities.push({ kind, id, path: rel });
+		}
+	}
+	const featRoot = path.join(root, "features");
+	if (fs.existsSync(featRoot)) {
+		for (const name of fs.readdirSync(featRoot)) {
+			if (!/^F-/.test(name)) continue;
+			const dir = path.join(featRoot, name);
+			if (!fs.statSync(dir).isDirectory()) continue;
+			entities.push({ kind: "feature", id: name, path: `features/${name}/` });
+			const links = path.join(dir, "knowledge-links.yaml");
+			if (fs.existsSync(links)) {
+				entities.push({
+					kind: "knowledge-links",
+					id: `${name}:links`,
+					path: `features/${name}/knowledge-links.yaml`,
+				});
+			}
+		}
+	}
+
+	const graphDir = path.join(root, "knowledge/graph");
+	fs.mkdirSync(graphDir, { recursive: true });
+	const generatedAt = new Date().toISOString();
+	const indexBody = [
+		"# generated by kb-graph-materialize",
+		"schema_version: 1",
+		`generated_at: ${generatedAt}`,
+		"entities:",
+		...entities.flatMap((e) => [
+			`  - kind: ${e.kind}`,
+			`    id: ${e.id}`,
+			`    path: ${e.path}`,
+		]),
+		"",
+	].join("\n");
+	fs.writeFileSync(path.join(graphDir, "entities-index.yaml"), indexBody);
+
+	const manual = path.join(graphDir, "edges.manual.yaml");
+	const edgesOut = path.join(graphDir, "edges.yaml");
+	if (fs.existsSync(manual)) {
+		fs.copyFileSync(manual, edgesOut);
+	} else if (!fs.existsSync(edgesOut)) {
+		fs.writeFileSync(
+			edgesOut,
+			`schema_version: 1\nupdated_at: ${generatedAt}\nedges: []\n`,
+		);
+	}
+
+	console.log(
+		JSON.stringify(
+			{
+				ok: true,
+				entities: entities.length,
+				entities_index: "knowledge/graph/entities-index.yaml",
+				edges: "knowledge/graph/edges.yaml",
+			},
+			null,
+			2,
+		),
+	);
+}
+
+main();

package/scripts/kb-graph-materialize.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env bash
-set -euo pipefail
-ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-exec node "${ROOT_DIR}/scripts/kb-graph-materialize.mjs" "$@"
+#!/usr/bin/env bash
+set -euo pipefail
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+exec node "${ROOT_DIR}/scripts/kb-graph-materialize.mjs" "$@"

package/scripts/kb-graph-promote.mjs

@@ -1,153 +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 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 = f.replace(/\.ya?ml$/, "");
-			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();

package/scripts/kb-graph-promote.sh

@@ -1,4 +1,4 @@
-#!/usr/bin/env bash
-set -euo pipefail
-ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-exec node "${ROOT_DIR}/scripts/kb-graph-promote.mjs" "$@"
+#!/usr/bin/env bash
+set -euo pipefail
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+exec node "${ROOT_DIR}/scripts/kb-graph-promote.mjs" "$@"