agency-rules 0.4.1 → 0.5.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.5.0](https://github.com/deuriib/agency-rules/compare/v0.4.1...v0.5.0) (2026-10-31)
+
+
+### Features
+
+* **cli:** add 'list' command to display available rules ([15a7302](https://github.com/deuriib/agency-rules/commit/15a73025cd8ae1f90ab4a8602ac68817306aa128))
+
 ## [0.4.1](https://github.com/deuriib/agency-rules/compare/v0.4.0...v0.4.1) (2026-10-31)
 
 

package/README.md

@@ -4,7 +4,7 @@
 
 `agency-rules` compiles a single set of generic Markdown rules into the
 native formats expected by **Google Antigravity**, **pi-agent**,
-**oh-my-pi (omp)**, and **OpenCode** (via the `opencode-rules` plugin).
+**oh-my-pi (omp)**, and **OpenCode** (via the [opencode-rules]("https://github.com/frap129/opencode-rules") plugin).
 
 The whole pipeline — toolchain, environment, and tasks — is managed by
 [mise](https://mise.jdx.dev), so every collaborator and CI runner uses the
@@ -21,7 +21,7 @@ Every coding agent has its own rule format:
 | Google Antigravity | YAML frontmatter with `trigger` | `.agents/rules/*.md` |
 | pi-agent | Per-rule directory with `RULES.md` | `.pi/rules/<slug>/RULES.md` |
 | oh-my-pi (omp) | Markdown with frontmatter | `.omp/rules/*.{md,mdc}` |
-| OpenCode | Markdown via `opencode-rules` plugin | `.opencode/rules/*.md` |
+| OpenCode | Markdown via [opencode-rules]("https://github.com/frap129/opencode-rules") plugin | `.opencode/rules/*.md` |
 
 Writing the same rule four times is a maintenance nightmare. `agency-rules`
 lets you write it **once** in a neutral format and compile it to all four

package/bin/agency-rules.mjs

@@ -29,17 +29,18 @@ Write rules once. Run them in every harness.
   $ 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[32mlist\x1b[0m         List all available rules
+  \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 list
   $ agency-rules validate
-  $ agency-rules convert
   $ agency-rules convert --dry-run
   $ agency-rules install --scope user --harness opencode
 `);
@@ -47,6 +48,17 @@ Write rules once. Run them in every harness.
 
 const showCommandHelp = (cmd) => {
     const helps = {
+        list: `
+\x1b[36magency-rules list\x1b[0m
+List all available rules and their descriptions.
+
+\x1b[33mOptions:\x1b[0m
+  --json            Output the list in JSON format (useful for scripting)
+
+\x1b[33mExamples:\x1b[0m
+  $ agency-rules list
+  $ agency-rules list --json | jq '.'
+`,
         convert: `
 \x1b[36magency-rules convert\x1b[0m
 Compile rules/ into each harness's native format.
@@ -101,7 +113,7 @@ if (!command || command === 'help' || command === '--help' || command === '-h')
     process.exit(0);
 }
 
-if (!['convert', 'install', 'validate'].includes(command)) {
+if (!['list', 'convert', 'install', 'validate'].includes(command)) {
     console.error(`\x1b[31mError:\x1b[0m Unknown command '${command}'`);
     showHelp();
     process.exit(1);
@@ -114,7 +126,6 @@ if (process.argv.includes('--help') || process.argv.includes('-h')) {
 }
 
 // ── 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`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agency-rules",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Write rules once. Run them in every harness.",
   "type": "module",
   "license": "MIT",

package/scripts/list.mjs

@@ -0,0 +1,48 @@
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+import { readRules } from './lib/frontmatter.mjs';
+
+const { values: args } = parseArgs({
+    options: {
+        json: { type: 'boolean', default: false },
+    },
+});
+
+// Resolve paths (local vs package fallback)
+const PACKAGE_ROOT = resolve(import.meta.dirname, '..');
+const localRules = resolve(process.cwd(), 'rules');
+const RULES_DIR =
+    process.env.RULES_DIR || (existsSync(localRules) ? localRules : resolve(PACKAGE_ROOT, 'rules'));
+
+const rules = await readRules(RULES_DIR);
+
+if (rules.length === 0) {
+    console.error(`❌ No rules found in ${RULES_DIR}`);
+    process.exit(1);
+}
+
+// ── JSON Output ───────────────────────────────────────────────────────
+if (args.json) {
+    const output = rules.map((r) => ({
+        name: r.slug,
+        description: r.data.description || 'No description provided',
+        source: r.source,
+    }));
+    console.log(JSON.stringify(output, null, 2));
+    process.exit(0);
+}
+
+// ── Pretty Terminal Output ────────────────────────────────────────────
+// Find the longest name to align the columns perfectly
+const maxSlugLength = Math.max(...rules.map((r) => r.slug.length));
+
+console.log(`\n📚 \x1b[1mAvailable Rules\x1b[0m (${rules.length})\n`);
+
+for (const rule of rules) {
+    const paddedSlug = rule.slug.padEnd(maxSlugLength);
+    // Using Cyan for the rule name
+    console.log(`  \x1b[36m${paddedSlug}\x1b[0m  ${rule.data.description || 'No description'}`);
+}
+
+console.log('\n');