compose-agentsmd 3.4.3 → 3.5.0

package/agent-ruleset.schema.json

@@ -42,6 +42,20 @@
         "type": "string",
         "minLength": 1
       }
+    },
+    "budget": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "totalLines": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "moduleLines": {
+          "type": "integer",
+          "minimum": 1
+        }
+      }
     }
   }
 }

package/dist/compose-agents.js

@@ -18,6 +18,8 @@ const RULESET_SCHEMA_PATH = new URL("../agent-ruleset.schema.json", import.meta.
 const PACKAGE_JSON_PATH = new URL("../package.json", import.meta.url);
 const TOOL_RULES_PATH = new URL("../tools/tool-rules.md", import.meta.url);
 const USAGE_PATH = new URL("../tools/usage.txt", import.meta.url);
+const DEFAULT_TOTAL_BUDGET = 350;
+const DEFAULT_MODULE_BUDGET = 30;
 const readValueArg = (remaining, index, flag) => {
     const value = remaining[index + 1];
     if (!value) {
@@ -564,6 +566,23 @@ const composeRuleset = (rulesetPath, rootDir, options) => {
     const extraRules = Array.isArray(projectRuleset.extra) ? projectRuleset.extra : [];
     const directRulePaths = extraRules.map((rulePath) => resolveFrom(rulesetDir, rulePath));
     addRulePaths(directRulePaths, resolvedRules, seenRules);
+    const totalBudget = projectRuleset.budget?.totalLines ?? DEFAULT_TOTAL_BUDGET;
+    const moduleBudget = projectRuleset.budget?.moduleLines ?? DEFAULT_MODULE_BUDGET;
+    const normalizedGlobalRoot = normalizePath(path.resolve(globalRoot));
+    const globalRuleFiles = resolvedRules.filter((p) => normalizePath(p).startsWith(`${normalizedGlobalRoot}/`));
+    const moduleLineCounts = globalRuleFiles.map((filePath) => {
+        const content = fs.readFileSync(filePath, "utf8");
+        return { name: path.basename(filePath), lines: content.split("\n").length };
+    });
+    const totalLines = moduleLineCounts.reduce((sum, m) => sum + m.lines, 0);
+    const overBudgetModules = moduleLineCounts.filter((m) => m.lines > moduleBudget);
+    const budgetResult = {
+        totalLines,
+        totalBudget,
+        moduleBudget,
+        overBudgetModules,
+        exceeded: totalLines > totalBudget || overBudgetModules.length > 0
+    };
     const parts = resolvedRules.map((rulePath) => {
         const body = normalizeTrailingWhitespace(fs.readFileSync(rulePath, "utf8"));
         const sourcePath = formatRuleSourcePath(rulePath, rulesRoot, rulesetDir, projectRuleset.source, resolvedRef);
@@ -610,7 +629,8 @@ const composeRuleset = (rulesetPath, rootDir, options) => {
     return {
         output: composedOutputPath,
         outputs: composedFiles.map((file) => file.relativePath),
-        agentsMdDiff
+        agentsMdDiff,
+        budgetResult
     };
 };
 const printAgentsMdDiffIfPresent = (result) => {
@@ -631,6 +651,19 @@ const printAgentsMdDiffIfPresent = (result) => {
     }
     process.stdout.write("--- END DIFF ---\n");
 };
+const formatBudgetWarning = (result) => {
+    const totalInfo = result.totalLines > result.totalBudget
+        ? `: ${result.totalLines}/${result.totalBudget} lines`
+        : "";
+    const lines = [`⚠ Global rules budget exceeded${totalInfo}`];
+    if (result.overBudgetModules.length > 0) {
+        lines.push(`  Over-budget modules (>${result.moduleBudget} lines):`);
+        for (const mod of result.overBudgetModules) {
+            lines.push(`    ${mod.name}: ${mod.lines} lines`);
+        }
+    }
+    return `${lines.join("\n")}\n`;
+};
 const LOCAL_RULES_TEMPLATE = "# Local Rules\n\n- Add project-specific instructions here.\n";
 const buildInitRuleset = (args) => {
     const domains = normalizeListOption(args.domains, "--domains");
@@ -788,7 +821,8 @@ const initProject = async (args, rootDir, rulesetName) => {
             initialized: [normalizePath(path.relative(rootDir, rulesetPath))],
             localRules: extraToWrite.map((filePath) => normalizePath(path.relative(rootDir, filePath))),
             composed: composedOutput ? composedOutput.outputs : [],
-            dryRun: false
+            dryRun: false,
+            ...(composedOutput ? { budget: composedOutput.budgetResult } : {})
         }, null, 2) + "\n");
     }
     else if (!args.quiet) {
@@ -801,6 +835,9 @@ const initProject = async (args, rootDir, rulesetName) => {
         if (composedOutput) {
             process.stdout.write(`Composed AGENTS.md:\n${composedOutput.outputs.map((filePath) => `- ${filePath}`).join("\n")}\n`);
             printAgentsMdDiffIfPresent(composedOutput);
+            if (composedOutput.budgetResult.exceeded) {
+                process.stderr.write(formatBudgetWarning(composedOutput.budgetResult));
+            }
         }
     }
 };
@@ -887,11 +924,14 @@ const main = async () => {
             emitAgentsMdDiff: !args.quiet && !args.json
         });
         if (args.json) {
-            process.stdout.write(JSON.stringify({ composed: output.outputs, dryRun: !!args.dryRun }, null, 2) + "\n");
+            process.stdout.write(JSON.stringify({ composed: output.outputs, dryRun: !!args.dryRun, budget: output.budgetResult }, null, 2) + "\n");
         }
         else if (!args.quiet) {
             process.stdout.write(`Composed AGENTS.md:\n${output.outputs.map((filePath) => `- ${filePath}`).join("\n")}\n`);
             printAgentsMdDiffIfPresent(output);
+            if (output.budgetResult.exceeded) {
+                process.stderr.write(formatBudgetWarning(output.budgetResult));
+            }
         }
         return;
     }
@@ -905,7 +945,11 @@ const main = async () => {
         emitAgentsMdDiff: !args.quiet && !args.json
     }));
     if (args.json) {
-        process.stdout.write(JSON.stringify({ composed: outputs.flatMap((result) => result.outputs), dryRun: !!args.dryRun }, null, 2) + "\n");
+        process.stdout.write(JSON.stringify({
+            composed: outputs.flatMap((result) => result.outputs),
+            dryRun: !!args.dryRun,
+            budget: outputs[0].budgetResult
+        }, null, 2) + "\n");
     }
     else if (!args.quiet) {
         process.stdout.write(`Composed AGENTS.md:\n${outputs
@@ -915,6 +959,11 @@ const main = async () => {
         for (const result of outputs) {
             printAgentsMdDiffIfPresent(result);
         }
+        for (const result of outputs) {
+            if (result.budgetResult.exceeded) {
+                process.stderr.write(formatBudgetWarning(result.budgetResult));
+            }
+        }
     }
 };
 const run = async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "compose-agentsmd",
-  "version": "3.4.3",
+  "version": "3.5.0",
   "description": "CLI tools for composing per-project AGENTS.md files from modular rule sets",
   "license": "MIT",
   "repository": {