agentplugged 1.3.0 → 2.0.0

package/dist/bin.js

@@ -1,13 +1,12 @@
 #!/usr/bin/env node
-//#region src/bin.ts
+// src/bin.ts
 const REQUIRED_MAJOR = 24;
 const current = process.versions.node;
 if (Number(current.split(".")[0]) < REQUIRED_MAJOR) {
-	process.stderr.write(`agentplugged needs Node.js ${REQUIRED_MAJOR} or later; this is Node.js ${current}.\nagentplugged a besoin de Node.js ${REQUIRED_MAJOR} ou plus récent ; celui-ci est en ${current}.\n`);
+	process.stderr.write(`agentplugged needs Node.js ${REQUIRED_MAJOR} or later; this is Node.js ${current}. Install the current version from https://nodejs.org, then run the command again.\nagentplugged a besoin de Node.js ${REQUIRED_MAJOR} ou plus récent ; celui-ci est en ${current}. Installe la version actuelle depuis https://nodejs.org, puis relance la commande.\n`);
 	process.exitCode = 1;
 } else import("./cli.js").catch((error) => {
 	process.stderr.write(`${error instanceof Error ? error.stack : error}\n`);
 	process.exitCode = 1;
 });
-//#endregion
 export {};

package/dist/boundary-rules.js

@@ -0,0 +1 @@
+export { t as boundariesOf, n as boundaryMode } from "./boundary-rules2.js";

package/dist/boundary-rules2.js

@@ -0,0 +1,52 @@
+import { Bo as BoundarySettingsSchema } from "./hash.js";
+import { It as readDocumentFiles, jt as DOCUMENT_PATHS, lf as methodSection, ws as architectureDecisions } from "./agent-commands.js";
+import { Mo as parseDocumentFile, Uc as readMainMethod, f as boundariesFromDecisions } from "./map-update.js";
+// ../../packages/core/dist/code-map/boundary-rules.js
+/**
+* The boundaries of a product: the rules its architecture decisions state, and what the code does
+* with them. Both the decisions and the creator's setting are read on the main branch, the
+* version the creator validated: an agent that edits a decision, or `method.yaml`, in its own
+* story lifts nothing until the creator merges it. Without a main branch to read, there are no
+* rules: nothing is enforced on a text nobody validated.
+*/
+/** Most documents read from the main branch in one go. */
+const MAX_DOCUMENTS = 60;
+/** The architecture decisions as the main branch holds them (empty without a main branch). */
+async function validatedDecisions(context) {
+	const reader = context.mainBranch;
+	if (reader === void 0) return [];
+	const paths = /* @__PURE__ */ new Set();
+	const committed = await context.docsBase?.read("HEAD", DOCUMENT_PATHS).catch(() => void 0);
+	if (committed?.found === true) for (const file of committed.files) paths.add(file.path);
+	for (const file of await readDocumentFiles(context.files, true).catch(() => [])) paths.add(file.path);
+	const files = [];
+	for (const path of [...paths].sort().slice(0, MAX_DOCUMENTS)) {
+		const read = await reader.read(path).catch(() => void 0);
+		if (read?.found === true && read.text !== void 0) files.push({
+			path,
+			text: read.text
+		});
+	}
+	return architectureDecisions(files, files.map((file) => parseDocumentFile(file.path, file.text)));
+}
+/** What a crossing does, as the creator set it on the main branch (`report` without a setting). */
+async function boundaryMode(context) {
+	if (context.mainBranch === void 0) return "report";
+	try {
+		const read = await readMainMethod(context.mainBranch);
+		if (!read.found || read.text === void 0) return "report";
+		const section = methodSection(read.text, "boundaries", BoundarySettingsSchema);
+		return section !== void 0 && section !== "invalid" && section.on_cross === "refuse" ? "refuse" : "report";
+	} catch {
+		return "report";
+	}
+}
+/** The boundary rules the validated decisions state, anchored on the modules of `map`. */
+async function boundariesOf(context, map) {
+	try {
+		return boundariesFromDecisions(await validatedDecisions(context), map.modules);
+	} catch {
+		return [];
+	}
+}
+export { boundaryMode as n, boundariesOf as t };

package/dist/cli.js

@@ -2,7 +2,7 @@ import "./launcher-env.js";
 import { readFileSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
-//#region src/cli.ts
+// src/cli.ts
 /** The CLI, loaded by `bin.ts` once the Node.js version is known to be supported. */
 const manifest = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
 if (process.argv[2] === "mcp" && process.env["AGENTPLUGGED_ENGINE_CHILD"] !== "1") {
@@ -18,13 +18,18 @@ if (process.argv[2] === "mcp" && process.env["AGENTPLUGGED_ENGINE_CHILD"] !== "1
 		selfEntry: fileURLToPath(new URL("./bin.js", import.meta.url))
 	});
 } else {
+	const entry = fileURLToPath(new URL("./bin.js", import.meta.url));
+	const { DEV_ENGINE_VERSION, isDevEngineEntry } = await import("./dist2.js");
+	const dev = process.env.AGENTPLUGGED_ENGINE_AS_PUBLISHED !== "1" && isDevEngineEntry(entry);
 	const { main } = await import("./main.js");
 	process.exitCode = await main({
 		argv: process.argv.slice(2),
 		cwd: process.cwd(),
 		env: process.env,
-		engineVersion: manifest.version,
+		engineVersion: dev ? DEV_ENGINE_VERSION : manifest.version,
+		...dev ? { devEngineEntry: entry.replaceAll("\\", "/") } : {},
 		installedEngineVersion: async () => {
+			if (dev) return DEV_ENGINE_VERSION;
 			try {
 				return JSON.parse(await readFile(new URL("../package.json", import.meta.url), "utf8")).version;
 			} catch {
@@ -40,5 +45,4 @@ if (process.argv[2] === "mcp" && process.env["AGENTPLUGGED_ENGINE_CHILD"] !== "1
 		interactive: process.stdin.isTTY === true && process.stdout.isTTY === true
 	});
 }
-//#endregion
 export {};

package/dist/commit-documents.js

@@ -0,0 +1,81 @@
+import { Vs as ErrorCode } from "./hash.js";
+import { B as AgentPluggedError, H as unavailable, q as METHOD_DIR } from "./map-cache.js";
+import { jt as DOCUMENT_PATHS } from "./agent-commands.js";
+// ../../packages/core/dist/docs/commit-documents.js
+/** The most paths one commit takes. */
+const COMMIT_PATHS_MAX = 50;
+/** A control character (a line break included): never part of a path, a name or an address. */
+const CONTROL = { test: (value) => [...value].some((char) => {
+	const code = char.charCodeAt(0);
+	return code < 32 || code === 127;
+}) };
+const EMAIL = /^[^\s@<>"',;:\\]{1,64}@[^\s@<>"',;:\\]{1,190}\.[^\s@<>"',;:\\]{2,63}$/;
+function invalid(reason) {
+	return new AgentPluggedError(ErrorCode.INVALID_ARGUMENTS, "error.invalid_arguments", { reason });
+}
+/** A document path as the commit takes it: inside the documents' folders, nothing that climbs. */
+function documentPathOf(word) {
+	const path = word.replaceAll("\\", "/").replace(/^\.\//, "");
+	if (CONTROL.test(path) || path.length > 300) return void 0;
+	if (path.split("/").some((segment) => segment === "" || segment === "." || segment === "..")) return;
+	return DOCUMENT_PATHS.some((dir) => path.startsWith(`${dir}/`)) ? path : void 0;
+}
+/** The commit message of the documents recorded, one line. */
+function messageOf(paths) {
+	const names = paths.map((path) => path.slice(path.lastIndexOf("/") + 1));
+	return names.length <= 3 ? `Docs: ${names.join(", ")}` : `Docs: ${names.slice(0, 3).join(", ")} and ${names.length - 3} more`;
+}
+/** Records the documents named. Never pushes. */
+async function commitDocuments(context, words) {
+	const workspace = context.storyWorkspace;
+	if (workspace?.commitPaths === void 0 || workspace.gitIdentity === void 0) return unavailable("recording documents");
+	const paths = [];
+	for (const word of words) {
+		const path = documentPathOf(word);
+		if (path === void 0) return invalid(`docs commit ${word} (a file under ${METHOD_DIR}/docs, epics or stories)`);
+		if (!paths.includes(path)) paths.push(path);
+	}
+	if (paths.length === 0 || paths.length > COMMIT_PATHS_MAX) return invalid(`docs commit <path…> (1 to ${COMMIT_PATHS_MAX} files)`);
+	for (const path of paths) if (!await context.files.exists(path)) return invalid(`docs commit ${path} (no such file)`);
+	const identity = await workspace.gitIdentity();
+	const missing = [...identity.name === void 0 ? ["name"] : [], ...identity.email === void 0 ? ["email"] : []];
+	if (missing.length > 0) return new AgentPluggedError(ErrorCode.GIT_IDENTITY_MISSING, "error.git_identity_missing", { missing: missing.join(", ") }, { next: "tell the creator in one sentence; never ask for an approval nor borrow an identity" });
+	const outcome = await workspace.commitPaths({
+		paths,
+		message: messageOf(paths)
+	});
+	if (!outcome.ok) return new AgentPluggedError(ErrorCode.UNEXPECTED, "error.unexpected", { reason: `the documents were not recorded (${outcome.reason}): ${outcome.message}` });
+	if (context.docsBase !== void 0) {
+		const read = await context.docsBase.read("HEAD", DOCUMENT_PATHS);
+		if (read.found) {
+			const held = new Set(read.files.map((file) => file.path));
+			const absent = paths.filter((path) => path.toLowerCase().endsWith(".md") && !held.has(path));
+			if (absent.length > 0) return new AgentPluggedError(ErrorCode.UNEXPECTED, "error.unexpected", { reason: `not recorded, Git ignores ${absent.join(", ")}` });
+		}
+	}
+	return { recorded: {
+		paths,
+		commit: outcome.commit
+	} };
+}
+/**
+* Sets who signs the commits of this product, for this repository only (never the global
+* configuration): the creator's name and email address, in the words they gave.
+*/
+async function setGitIdentity(context, words) {
+	const workspace = context.storyWorkspace;
+	if (workspace?.setGitIdentity === void 0) return unavailable("setting the Git identity");
+	const [rawName, rawEmail, ...extra] = words;
+	const name = rawName?.trim() ?? "";
+	const email = rawEmail?.trim() ?? "";
+	if (extra.length > 0 || name === "" || name.length > 100 || name.startsWith("-") || email.startsWith("-") || CONTROL.test(name) || /[<>]/.test(name) || !EMAIL.test(email)) return invalid("docs identity \"<name>\" \"<email>\" (a name and an email address)");
+	await workspace.setGitIdentity({
+		name,
+		email
+	});
+	return { identity: {
+		name,
+		email
+	} };
+}
+export { commitDocuments, setGitIdentity };