compose-agentsmd 3.2.1 → 3.2.4

package/README.md

@@ -134,4 +134,11 @@ npm install
 npm run lint
 npm run build
 npm test
-```
+```
+
+## Overview
+This repository contains the compose-agentsmd project.
+
+## Requirements and Configuration
+- No required environment variables are documented.
+

package/dist/compose-agents.js

@@ -16,6 +16,13 @@ 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 readValueArg = (remaining, index, flag) => {
+    const value = remaining[index + 1];
+    if (!value) {
+        throw new Error(`Missing value for ${flag}`);
+    }
+    return value;
+};
 const parseArgs = (argv) => {
     const args = {};
     const knownCommands = new Set(["edit-rules", "apply-rules", "init"]);
@@ -38,28 +45,19 @@ const parseArgs = (argv) => {
             continue;
         }
         if (arg === "--root") {
-            const value = remaining[i + 1];
-            if (!value) {
-                throw new Error("Missing value for --root");
-            }
+            const value = readValueArg(remaining, i, "--root");
             args.root = value;
             i += 1;
             continue;
         }
         if (arg === "--ruleset") {
-            const value = remaining[i + 1];
-            if (!value) {
-                throw new Error("Missing value for --ruleset");
-            }
+            const value = readValueArg(remaining, i, "--ruleset");
             args.ruleset = value;
             i += 1;
             continue;
         }
         if (arg === "--ruleset-name") {
-            const value = remaining[i + 1];
-            if (!value) {
-                throw new Error("Missing value for --ruleset-name");
-            }
+            const value = readValueArg(remaining, i, "--ruleset-name");
             args.rulesetName = value;
             i += 1;
             continue;
@@ -73,19 +71,13 @@ const parseArgs = (argv) => {
             continue;
         }
         if (arg === "--source") {
-            const value = remaining[i + 1];
-            if (!value) {
-                throw new Error("Missing value for --source");
-            }
+            const value = readValueArg(remaining, i, "--source");
             args.source = value;
             i += 1;
             continue;
         }
         if (arg === "--domains") {
-            const value = remaining[i + 1];
-            if (!value) {
-                throw new Error("Missing value for --domains");
-            }
+            const value = readValueArg(remaining, i, "--domains");
             args.domains = [...(args.domains ?? []), ...value.split(",").map((entry) => entry.trim())];
             i += 1;
             continue;
@@ -95,10 +87,7 @@ const parseArgs = (argv) => {
             continue;
         }
         if (arg === "--extra") {
-            const value = remaining[i + 1];
-            if (!value) {
-                throw new Error("Missing value for --extra");
-            }
+            const value = readValueArg(remaining, i, "--extra");
             args.extra = [...(args.extra ?? []), ...value.split(",").map((entry) => entry.trim())];
             i += 1;
             continue;
@@ -108,10 +97,7 @@ const parseArgs = (argv) => {
             continue;
         }
         if (arg === "--output") {
-            const value = remaining[i + 1];
-            if (!value) {
-                throw new Error("Missing value for --output");
-            }
+            const value = readValueArg(remaining, i, "--output");
             args.output = value;
             i += 1;
             continue;
@@ -506,12 +492,27 @@ const resolveRulesRoot = (rulesetDir, source, refresh) => {
     }
     return { rulesRoot: resolveLocalRulesRoot(rulesetDir, source) };
 };
+const formatRuleSourcePath = (rulePath, rulesRoot, rulesetDir, source, resolvedRef) => {
+    // Check if this rule is from the resolved rulesRoot (GitHub or local source)
+    const isFromSource = rulePath.startsWith(rulesRoot);
+    if (isFromSource && source.startsWith("github:")) {
+        // GitHub source rule
+        const parsed = parseGithubSource(source);
+        const cacheRepoRoot = path.dirname(rulesRoot);
+        const relativePath = normalizePath(path.relative(cacheRepoRoot, rulePath));
+        const refToUse = resolvedRef ?? parsed.ref;
+        return `github:${parsed.owner}/${parsed.repo}@${refToUse}/${relativePath}`;
+    }
+    // For local rules (either from local source or extra), use path relative to project root
+    const result = normalizePath(path.relative(rulesetDir, rulePath));
+    return result;
+};
 const composeRuleset = (rulesetPath, rootDir, options) => {
     const rulesetDir = path.dirname(rulesetPath);
     const projectRuleset = readProjectRuleset(rulesetPath);
     const outputFileName = projectRuleset.output ?? DEFAULT_OUTPUT;
     const outputPath = resolveFrom(rulesetDir, outputFileName);
-    const { rulesRoot } = resolveRulesRoot(rulesetDir, projectRuleset.source, options.refresh ?? false);
+    const { rulesRoot, resolvedRef } = resolveRulesRoot(rulesetDir, projectRuleset.source, options.refresh ?? false);
     const globalRoot = path.join(rulesRoot, "global");
     const domainsRoot = path.join(rulesRoot, "domains");
     const resolvedRules = [];
@@ -529,7 +530,8 @@ const composeRuleset = (rulesetPath, rootDir, options) => {
     addRulePaths(directRulePaths, resolvedRules, seenRules);
     const parts = resolvedRules.map((rulePath) => {
         const body = normalizeTrailingWhitespace(fs.readFileSync(rulePath, "utf8"));
-        return `Source: ${normalizePath(rulePath)}\n\n${body}`;
+        const sourcePath = formatRuleSourcePath(rulePath, rulesRoot, rulesetDir, projectRuleset.source, resolvedRef);
+        return `Source: ${sourcePath}\n\n${body}`;
     });
     const lintHeader = "<!-- markdownlint-disable MD025 -->";
     const toolRules = normalizeTrailingWhitespace(TOOL_RULES);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "compose-agentsmd",
-  "version": "3.2.1",
+  "version": "3.2.4",
   "description": "CLI tools for composing per-project AGENTS.md files from modular rule sets",
   "license": "MIT",
   "repository": {
@@ -44,7 +44,7 @@
     "node": ">=20"
   },
   "devDependencies": {
-    "@types/node": "^25.0.10",
+    "@types/node": "^25.1.0",
     "typescript": "^5.7.3"
   },
   "dependencies": {

package/tools/tool-rules.md

@@ -2,6 +2,7 @@
 - Before starting any work, run `compose-agentsmd` from the project root.
 - To update shared rules, run `compose-agentsmd edit-rules`, edit the workspace rules, then run `compose-agentsmd apply-rules`.
 - Do not edit `AGENTS.md` directly; update the source rules and regenerate.
+- These tool rules live in tools/tool-rules.md in the compose-agentsmd repository; do not duplicate them in global rule modules.
 - When updating rules, include a colorized diff-style summary in the final response. Use `git diff --stat` first, then include the raw ANSI-colored output of `git diff --color=always` (no sanitizing or reformatting), and limit the output to the rule files that changed.
 - Also provide a short, copy-pasteable command the user can run to view the diff in the same format. Use absolute paths so it works regardless of the current working directory, and scope it to the changed rule files.
 - If a diff is provided, a separate detailed summary is not required. If a diff is not possible, include a detailed summary of what changed (added/removed/modified items).