agency-rules 0.3.2 → 0.4.0

package/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.0](https://github.com/deuriib/agency-rules/compare/v0.3.2...v0.4.0) (2026-10-31)
+
+
+### Features
+
+* **cli:** expose agency-rules binary and router ([dfb6b95](https://github.com/deuriib/agency-rules/commit/dfb6b95b8b6d9ac6f4622479527f182d9c1e637c))
+
 ## [0.3.2](https://github.com/deuriib/agency-rules/compare/v0.3.1...v0.3.2) (2026-10-31)
 
 

package/README.md

@@ -29,6 +29,23 @@ with a single command, driven by a declarative contract (`tools.json`).
 
 ---
 
+## Global CLI Usage
+
+You can also use `agency-rules` directly via `npx` without cloning the repository:
+
+```bash
+# Validate rules
+npx agency-rules validate
+
+# Compile rules
+npx agency-rules convert
+
+# Install rules interactively
+npx agency-rules install
+```
+
+---
+
 ## Quick Start
 
 ```bash
@@ -140,6 +157,8 @@ See [CONTRIBUTING.md](CONTRIBUTING.md). Pull requests welcome.
 
 See [SECURITY.md](SECURITY.md) for responsible disclosure.
 
+![Repobeats analytics](https://repobeats.com/deuriib/agency-rules?theme=light&size=medium&period=30)
+
 ## License
 
 MIT — see [LICENSE](LICENSE).

package/bin/agency-rules.mjs

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+const command = process.argv[2];
+
+// ── Read version dynamically ──────────────────────────────────────────
+const getVersion = async () => {
+    try {
+        const pkgPath = resolve(import.meta.dirname, '..', 'package.json');
+        const pkg = JSON.parse(await readFile(pkgPath, 'utf8'));
+        return pkg.version || '0.0.0';
+    } catch {
+        return '0.0.0';
+    }
+};
+
+const version = await getVersion();
+
+// ── Help Menus ────────────────────────────────────────────────────────
+const showHelp = () => {
+    console.log(`
+\x1b[36magency-rules\x1b[0m v${version}
+Write rules once. Run them in every harness.
+
+\x1b[33mUsage:\x1b[0m
+  $ agency-rules <command> [options]
+
+\x1b[33mCommands:\x1b[0m
+  \x1b[32mconvert\x1b[0m     Compile rules/ into each harness's native format
+  \x1b[32minstall\x1b[0m     Install compiled artifacts into detected harnesses
+  \x1b[32mvalidate\x1b[0m    Validate each rule's frontmatter against the schema
+
+\x1b[33mGlobal Options:\x1b[0m
+  -h, --help      Show this help message
+  -v, --version   Show version number
+
+\x1b[33mExamples:\x1b[0m
+  $ agency-rules validate
+  $ agency-rules convert
+  $ agency-rules convert --dry-run
+  $ agency-rules install --scope user --harness opencode
+`);
+};
+
+const showCommandHelp = (cmd) => {
+    const helps = {
+        convert: `
+\x1b[36magency-rules convert\x1b[0m
+Compile rules/ into each harness's native format.
+
+\x1b[33mOptions:\x1b[0m
+  --dry-run         Preview which files would be written (no writes)
+  --harness <id>    Limit compilation to a specific harness (e.g., antigravity)
+
+\x1b[33mExamples:\x1b[0m
+  $ agency-rules convert
+  $ agency-rules convert --dry-run
+  $ agency-rules convert --harness pi-agent
+`,
+        install: `
+\x1b[36magency-rules install\x1b[0m
+Install compiled artifacts into detected harnesses.
+
+\x1b[33mOptions:\x1b[0m
+  --dry-run              Preview which files would be copied (no writes)
+  --scope <project|user> Install local to project or global to user (default: project)
+  --harness <id>         Install into a specific harness
+  --all                  Force installation for all harnesses, ignoring auto-detection
+
+\x1b[33mExamples:\x1b[0m
+  $ agency-rules install
+  $ agency-rules install --dry-run
+  $ agency-rules install --scope user
+  $ agency-rules install --harness opencode --scope project
+`,
+        validate: `
+\x1b[36magency-rules validate\x1b[0m
+Validate each rule's frontmatter against the schema.
+
+\x1b[33mOptions:\x1b[0m
+  (No specific options)
+
+\x1b[33mExamples:\x1b[0m
+  $ agency-rules validate
+`,
+    };
+    console.log(helps[cmd] || '');
+};
+
+// ── Global Flags ──────────────────────────────────────────────────────
+if (process.argv.includes('--version') || process.argv.includes('-v')) {
+    console.log(version);
+    process.exit(0);
+}
+
+if (!command || command === 'help' || command === '--help' || command === '-h') {
+    showHelp();
+    process.exit(0);
+}
+
+if (!['convert', 'install', 'validate'].includes(command)) {
+    console.error(`\x1b[31mError:\x1b[0m Unknown command '${command}'`);
+    showHelp();
+    process.exit(1);
+}
+
+// ── Command-specific Help ─────────────────────────────────────────────
+if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    showCommandHelp(command);
+    process.exit(0);
+}
+
+// ── Execute ───────────────────────────────────────────────────────────
+// Remove the command from argv so the downstream script's parseArgs works cleanly
+process.argv.splice(2, 1);
+
+const scriptPath = resolve(import.meta.dirname, '..', 'scripts', `${command}.mjs`);
+
+try {
+    await import(pathToFileURL(scriptPath).href);
+} catch (err) {
+    console.error(`\x1b[31m❌ Failed to execute '${command}':\x1b[0m`, err.message);
+    process.exit(1);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agency-rules",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "Write rules once. Run them in every harness.",
   "type": "module",
   "license": "MIT",
@@ -22,6 +22,9 @@
     "opencode",
     "oh-my-pi"
   ],
+  "bin": {
+    "agency-rules": "./bin/agency-rules.mjs"
+  },
   "engines": {
     "node": ">=20.12"
   },