compose-agentsmd 3.0.0 → 3.1.0

package/README.md

@@ -85,6 +85,8 @@ Remote sources are cached under `~/.agentsmd/cache/<owner>/<repo>/<ref>/`. Use `
 - `--ruleset-name <name>`: override the ruleset filename (default: `agent-ruleset.json`)
 - `--refresh`: refresh cached remote rules
 - `--clear-cache`: remove cached remote rules and exit
+- `--version` / `-V`: show version and exit
+- `--verbose` / `-v`: show verbose diagnostics
 - `edit-rules`: prepare or locate a writable rules workspace
 - `apply-rules`: push workspace changes (if GitHub source) and regenerate rules with refresh
 

package/dist/compose-agents.js

@@ -9,6 +9,7 @@ const DEFAULT_OUTPUT = "AGENTS.md";
 const DEFAULT_CACHE_ROOT = path.join(os.homedir(), ".agentsmd", "cache");
 const DEFAULT_WORKSPACE_ROOT = path.join(os.homedir(), ".agentsmd", "workspace");
 const RULESET_SCHEMA_PATH = new URL("../agent-ruleset.schema.json", import.meta.url);
+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 parseArgs = (argv) => {
@@ -24,6 +25,14 @@ const parseArgs = (argv) => {
             args.help = true;
             continue;
         }
+        if (arg === "--version" || arg === "-V") {
+            args.version = true;
+            continue;
+        }
+        if (arg === "--verbose" || arg === "-v") {
+            args.verbose = true;
+            continue;
+        }
         if (arg === "--root") {
             const value = remaining[i + 1];
             if (!value) {
@@ -67,6 +76,8 @@ const normalizeTrailingWhitespace = (content) => content.replace(/\s+$/u, "");
 const normalizePath = (filePath) => filePath.replace(/\\/g, "/");
 const isNonEmptyString = (value) => typeof value === "string" && value.trim() !== "";
 const usage = normalizeTrailingWhitespace(fs.readFileSync(USAGE_PATH, "utf8"));
+const packageJson = JSON.parse(fs.readFileSync(PACKAGE_JSON_PATH, "utf8"));
+const getVersion = () => packageJson.version ?? "unknown";
 const rulesetSchema = JSON.parse(fs.readFileSync(RULESET_SCHEMA_PATH, "utf8"));
 const TOOL_RULES = normalizeTrailingWhitespace(fs.readFileSync(TOOL_RULES_PATH, "utf8"));
 const ajv = new Ajv({ allErrors: true, strict: false });
@@ -400,6 +411,10 @@ const ensureSingleRuleset = (rulesetFiles, rootDir, rulesetName) => {
 };
 const main = () => {
     const args = parseArgs(process.argv.slice(2));
+    if (args.version) {
+        process.stdout.write(`${getVersion()}\n`);
+        return;
+    }
     if (args.help) {
         process.stdout.write(`${usage}\n`);
         return;
@@ -413,6 +428,15 @@ const main = () => {
     const rulesetName = args.rulesetName || DEFAULT_RULESET_NAME;
     const rulesetFiles = getRulesetFiles(rootDir, args.ruleset, rulesetName);
     const command = args.command ?? "compose";
+    const logVerbose = (message) => {
+        if (args.verbose) {
+            process.stdout.write(`${message}\n`);
+        }
+    };
+    logVerbose("Verbose:");
+    logVerbose(`- Root: ${rootDir}`);
+    logVerbose(`- Ruleset name: ${rulesetName}`);
+    logVerbose(`- Ruleset files:\n${rulesetFiles.map((file) => `  - ${normalizePath(path.relative(rootDir, file))}`).join("\n")}`);
     if (command === "edit-rules") {
         const rulesetPath = ensureSingleRuleset(rulesetFiles, rootDir, rulesetName);
         const rulesetDir = path.dirname(rulesetPath);

package/package.json

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

package/tools/tool-rules.md

@@ -1,4 +1,5 @@
 # Tool Rules (compose-agentsmd)
 - 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.
+- Do not edit `AGENTS.md` directly; update the source rules and regenerate.
+- When updating rules, include a detailed summary of what changed (added/removed/modified items) in the final response.

package/tools/usage.txt

@@ -1,6 +1,9 @@
-Usage: compose-agentsmd [edit-rules|apply-rules] [--root <path>] [--ruleset <path>] [--ruleset-name <name>] [--refresh] [--clear-cache]
+Usage: compose-agentsmd [edit-rules|apply-rules] [--root <path>] [--ruleset <path>] [--ruleset-name <name>] [--refresh] [--clear-cache] [--version|-V] [--verbose|-v] [--help|-h]
 
 Options:
+  --help, -h           Show help and exit
+  --version, -V        Show version and exit
+  --verbose, -v        Show verbose diagnostics
   --root <path>         Project root directory (default: current working directory)
   --ruleset <path>      Only compose a single ruleset file
   --ruleset-name <name> Ruleset filename in the project root (default: agent-ruleset.json)