@reqvire-org/ads 0.3.23 → 0.3.24

package/dist/config.mjs

@@ -18,7 +18,7 @@ export const defaultConfig = {
   boundaries: { styleWrites: [], componentVariables: [] },
   assets: { publicDirs: ["public/assets"], generatedPaths: ["dist", "dist-showcase", ".vite", ".ds"], generatedFiles: [], iconSource: null },
   oxlint: { plugins: [], rules: {}, overrides: [] },
-  mcp: { showcaseUrl: null, showcaseTitle: null, apps: [], previewWatch: null, previewManifest: null, mutationChecks: null, behaviorProfiles: {}, capture: {} },
+  mcp: { showcaseUrl: null, showcaseTitle: null, apps: [], previewWatch: null, previewManifest: null, mutationChecks: null, mutationCheckTimeoutMs: 60000, behaviorProfiles: {}, capture: {} },
 };
 
 export function isInside(parent, file) {
@@ -120,6 +120,7 @@ export function loadConfig(directory = process.cwd()) {
     if (profile.mode === "strict" && config.framework !== "react") throw new Error(`Behavior profile ${name}: React StrictMode requires framework react; use the configured framework's lifecycle tests instead.`);
   }
   if (config.mcp.mutationChecks !== null && (!Array.isArray(config.mcp.mutationChecks) || config.mcp.mutationChecks.length > 12 || new Set(config.mcp.mutationChecks).size !== config.mcp.mutationChecks.length || config.mcp.mutationChecks.some(name => typeof name !== "string" || !/^[a-zA-Z0-9][\w:.-]*$/.test(name)))) throw new Error("mcp.mutationChecks must be null or up to 12 unique package script names.");
+  if (!Number.isInteger(config.mcp.mutationCheckTimeoutMs) || config.mcp.mutationCheckTimeoutMs < 100 || config.mcp.mutationCheckTimeoutMs > 300000) throw new Error("mcp.mutationCheckTimeoutMs must be an integer from 100 to 300000. This budget applies to each registered project script, separately from behavior profiles.");
   if (config.mcp.previewManifest !== null) {
     const manifest = projectPath(root, config.mcp.previewManifest, "mcp.previewManifest");
     if (!isInside(path.join(root, ".ds"), manifest) || path.extname(manifest) !== ".json") throw new Error("mcp.previewManifest must name a generated JSON manifest inside .ds/.");

package/dist/mcp/mutations.mjs

@@ -109,7 +109,7 @@ function snapshot(options, destination) {
   return JSON.stringify(entries);
 }
 
-function checkCommand(command, args, cwd, signal, input, gate = {category:"architecture",phase:"patch-preparation"}) {
+function checkCommand(command, args, cwd, signal, input, gate = {category:"architecture",phase:"patch-preparation"}, timeoutMs = 60000) {
   return new Promise((resolve, reject) => {
     if (signal?.aborted) { reject(fail("mutation-cancelled", "Mutation cancelled before validation.",undefined,evidenceFailure("runner","mutation-execution","ADS_CANCELLED"))); return; }
     const child = spawn(command, args, { cwd, shell: false, detached: process.platform !== "win32", windowsHide: true, stdio: [input === undefined ? "ignore" : "pipe", "pipe", "pipe"],
@@ -126,13 +126,13 @@ function checkCommand(command, args, cwd, signal, input, gate = {category:"archi
     }
     const abort = () => { failure = fail("mutation-cancelled", "Mutation cancelled during validation."); kill(); };
     signal?.addEventListener("abort", abort, { once: true });
-    const timer = setTimeout(() => { failure = fail("mutation-check", "A mutation check exceeded 60 seconds."); kill(); }, 60000);
+    const timer = setTimeout(() => { failure = fail("mutation-check", `${path.basename(command)} ${args.join(" ")} exceeded its ${timeoutMs} ms command budget.`); failure.code="ADS_COMMAND_TIMEOUT"; kill(); }, timeoutMs);
     for (const stream of [child.stdout, child.stderr]) stream.on("data", chunk => { output = (output + chunk.toString()).slice(-12000); });
     child.once("error", error => { failure = error; });
     child.once("exit", kill); // Also clean up descendants of a finished launcher.
     child.once("close", code => {
       clearTimeout(timer); signal?.removeEventListener("abort", abort);
-      const detail={command:path.basename(command),args,elapsedMs:Date.now()-startedAt,exitCode:code};
+      const detail={command:path.basename(command),args,timeoutMs,elapsedMs:Date.now()-startedAt,exitCode:code};
       if (failure || code !== 0) {
         const error=failure??fail("mutation-check", `${path.basename(command)} ${args.join(" ")} failed (${code}).\n${output}`);
         error.diagnostic={...(error.diagnostic??{rule:"mutation-check",message:error.message}),...detail,output:output.slice(-4000),failure:evidenceFailure(failure?"runner":gate.category,gate.phase,failure?.code??(failure?"ADS_COMMAND_INTERRUPTED":"ADS_COMMAND_EXIT"),{certainty:"observed-boundary"})};
@@ -297,7 +297,7 @@ export function createMutationController(directory, { captures = createCaptureCo
           const brand = await generateBrandAssets(candidate);
           verified.push({ name: "brand assets", passed: true, skipped: !!brand.skipped });
         }
-        for (const check of extraChecks) verified.push(await checkCommand(check.command, check.args, candidate, signal, undefined, {category:"build",phase:`project-check:${check.args[1]}`}));
+        for (const check of extraChecks) verified.push(await checkCommand(check.command, check.args, candidate, signal, undefined, {category:"build",phase:`project-check:${check.args[1]}`}, candidateOptions.config.mcp.mutationCheckTimeoutMs));
         boundary=evidenceFailure("runner","behavior-verification","ADS_BEHAVIOR_SETUP");
         const behaviorUnits = affectedBehaviorUnits(candidateOptions, changes.map(change => change.path));
         if (behaviorUnits.length) {