agency-rules 0.1.0 → 0.3.2

package/CHANGELOG.md

@@ -5,6 +5,49 @@ 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.3.2](https://github.com/deuriib/agency-rules/compare/v0.3.1...v0.3.2) (2026-10-31)
+
+
+### Bug Fixes
+
+* **ci:** completely remove NODE_AUTH_TOKEN to enforce OIDC ([59b966d](https://github.com/deuriib/agency-rules/commit/59b966dbdf29502b127f5b271de42f9ca56687f9))
+* **ci:** completely remove NODE_AUTH_TOKEN to enforce OIDC ([a8229a7](https://github.com/deuriib/agency-rules/commit/a8229a7fc912f26b34dec9a2735a659ce63d12a9))
+
+## [0.3.1](https://github.com/deuriib/agency-rules/compare/v0.3.0...v0.3.1) (2026-10-31)
+
+
+### Bug Fixes
+
+* **ci:** resolve npm E404 by enforcing OIDC trusted publishing ([4266f4a](https://github.com/deuriib/agency-rules/commit/4266f4afd6a933c1835973e52ce09b4e620221a4))
+
+## [0.3.0](https://github.com/deuriib/agency-rules/compare/v0.2.0...v0.3.0) (2026-10-31)
+
+
+### Features
+
+* **skills:** add writing-rules skill for rule authoring ([41b99d7](https://github.com/deuriib/agency-rules/commit/41b99d7416fa52463303fc150e237fbc26ba90e1))
+
+
+### Bug Fixes
+
+* **ci:** correct labels config file extension ([51617c6](https://github.com/deuriib/agency-rules/commit/51617c68abcf95b13040b1cfeadcbf52013ff9d4))
+* **ci:** use node 24 for npm trusted publishing ([cf49055](https://github.com/deuriib/agency-rules/commit/cf4905539693f5a1d38ed902abc5a5c7c32d1635))
+
+## [0.2.0](https://github.com/deuriib/agency-rules/compare/v0.1.0...v0.2.0) (2026-10-31)
+
+
+### Features
+
+* bootstrap agency-rules with mise and four harness renderers ([c1bf3c9](https://github.com/deuriib/agency-rules/commit/c1bf3c9f078d84f578f2e37633dcc87fc98f3831))
+* **install:** add interactive mode and harness/scope parameters ([e1996be](https://github.com/deuriib/agency-rules/commit/e1996bec3da5a34db23c06181dcb0071b35f5eff))
+* **rules:** enforce conventional commits standard ([53f78b9](https://github.com/deuriib/agency-rules/commit/53f78b97a8669db60b7ac2110f10d9ad5658df39))
+
+
+### Bug Fixes
+
+* **ci:** add missing mise sidecar for biome ([ded656e](https://github.com/deuriib/agency-rules/commit/ded656e16acc862ef975069459bc8dd324adc051))
+* **install:** resolve biome linting errors and formatting ([04f4fee](https://github.com/deuriib/agency-rules/commit/04f4feeabcd2667d66b95865d0b7dd687cdd4798))
+
 ## [Unreleased]
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agency-rules",
-  "version": "0.1.0",
+  "version": "0.3.2",
   "description": "Write rules once. Run them in every harness.",
   "type": "module",
   "license": "MIT",
@@ -13,8 +13,18 @@
     "url": "https://github.com/deuriib/agency-rules/issues"
   },
   "homepage": "https://github.com/deuriib/agency-rules#readme",
-  "keywords": ["ai", "agents", "rules", "antigravity", "pi-agent", "opencode", "oh-my-pi"],
-  "engines": { "node": ">=20.12" },
+  "keywords": [
+    "ai",
+    "agents",
+    "rules",
+    "antigravity",
+    "pi-agent",
+    "opencode",
+    "oh-my-pi"
+  ],
+  "engines": {
+    "node": ">=20.12"
+  },
   "files": [
     "scripts/",
     "tools.json",

package/scripts/convert.mjs

@@ -1,4 +1,4 @@
-import { access, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 import { parseArgs } from 'node:util';
 import { readRules } from './lib/frontmatter.mjs';

package/scripts/install.mjs

@@ -1,22 +1,19 @@
-import { access, copyFile, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { copyFile, mkdir, readFile, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
+import { stdin as input, stdout as output } from 'node:process';
+import { createInterface } from 'node:readline/promises';
 import { parseArgs } from 'node:util';
 import { detectHarnesses, expandHome, pathExists } from './lib/detect.mjs';
 
 const { values: args } = parseArgs({
     options: {
-        scope: { type: 'string', default: 'project' },
+        scope: { type: 'string' },
         harness: { type: 'string' },
         all: { type: 'boolean', default: false },
         'dry-run': { type: 'boolean', default: false },
     },
 });
 
-if (!['project', 'user'].includes(args.scope)) {
-    console.error(`❌ Invalid --scope: ${args.scope} (use "project" or "user")`);
-    process.exit(1);
-}
-
 const dryRun = args['dry-run'];
 const tag = dryRun ? '[dry-run]' : '     ';
 const log = (msg) => console.log(`  ${tag} ${msg}`);
@@ -24,27 +21,75 @@ const log = (msg) => console.log(`  ${tag} ${msg}`);
 const INTEGRATIONS_DIR = process.env.INTEGRATIONS_DIR || 'integrations';
 const tools = JSON.parse(await readFile('tools.json', 'utf8'));
 
+let finalScope = args.scope;
+let finalHarness = args.harness;
+
+// ── Interactive Mode (si no se pasan parámetros y es una terminal) ─────
+if (input.isTTY && ((!finalHarness && !args.all) || !finalScope)) {
+    const rl = createInterface({ input, output });
+
+    if (!finalHarness && !args.all) {
+        console.log('\n🎯 Select a harness to install into:');
+        const keys = Object.keys(tools.harnesses);
+        keys.forEach((k, i) => {
+            console.log(`  ${i + 1}) ${k} (${tools.harnesses[k].label})`);
+        });
+        console.log(`  ${keys.length + 1}) Detect automatically`);
+        console.log(`  ${keys.length + 2}) All harnesses`);
+
+        const answer = await rl.question(`\nChoice [1-${keys.length + 2}] (default: detect): `);
+        const num = parseInt(answer.trim(), 10);
+
+        if (!Number.isNaN(num) && num >= 1 && num <= keys.length) {
+            finalHarness = keys[num - 1];
+        } else if (num === keys.length + 2 || answer.trim().toLowerCase() === 'all') {
+            args.all = true;
+        }
+    }
+
+    if (!finalScope) {
+        console.log('\n🌍 Select installation scope:');
+        console.log('  1) project (local to this repo)');
+        console.log('  2) user (global for your user)');
+
+        const answer = await rl.question('\nChoice [1-2] (default: 1): ');
+        finalScope =
+            answer.trim() === '2' || answer.trim().toLowerCase() === 'user' ? 'user' : 'project';
+    }
+
+    rl.close();
+    console.log('');
+}
+
+// Fallback si no se seleccionó nada
+if (!finalScope) finalScope = 'project';
+
+if (!['project', 'user'].includes(finalScope)) {
+    console.error(`❌ Invalid --scope: ${finalScope} (use "project" or "user")`);
+    process.exit(1);
+}
+
 let targets;
-if (args.harness) {
-    if (!tools.harnesses[args.harness]) {
-        console.error(`❌ Unknown harness: ${args.harness}`);
+if (finalHarness) {
+    if (!tools.harnesses[finalHarness]) {
+        console.error(`❌ Unknown harness: ${finalHarness}`);
         process.exit(1);
     }
-    targets = [args.harness];
+    targets = [finalHarness];
 } else if (args.all) {
     targets = Object.keys(tools.harnesses);
 } else {
     targets = await detectHarnesses(tools);
     if (targets.length === 0) {
-        console.warn(
-            `⚠️  No harness detected. Pass --harness <id> or --all to force.${dryRun ? '' : ''}`,
-        );
+        console.warn('⚠️  No harness detected. Pass --harness <id> or --all to force.');
         process.exit(0);
     }
 }
 
 console.log(
-    `🔍 Targets: ${targets.join(', ')} (scope: ${args.scope})${dryRun ? ' — dry-run, no changes will be made' : ''}\n`,
+    `🔍 Targets: ${targets.join(', ')} (scope: ${finalScope})${
+        dryRun ? ' — dry-run, no changes will be made' : ''
+    }\n`,
 );
 
 let copied = 0;
@@ -64,9 +109,9 @@ for (const id of targets) {
     }
 
     const manifest = JSON.parse(await readFile(join(srcDir, '_manifest.json'), 'utf8'));
-    const destTemplate = harness.dest[args.scope];
+    const destTemplate = harness.dest[finalScope];
     if (!destTemplate) {
-        console.warn(`⚠️  ${id}: no dest for scope "${args.scope}"`);
+        console.warn(`⚠️  ${id}: no dest for scope "${finalScope}"`);
         skippedHarnesses++;
         continue;
     }
@@ -84,7 +129,7 @@ for (const id of targets) {
     }
 
     if (harness.plugin) {
-        const changed = await handlePlugin(id, harness.plugin, args.scope, dryRun, log);
+        const changed = await handlePlugin(id, harness.plugin, finalScope, dryRun, log);
         if (changed) pluginChanges++;
     }
 }
@@ -93,7 +138,7 @@ console.log(
     dryRun
         ? `\n🔎 Dry-run: would copy ${copied} file(s) across ${targets.length - skippedHarnesses} harness(es).` +
               (pluginChanges ? ` Would update ${pluginChanges} plugin config(s).` : '') +
-              ` Nothing was written.`
+              ' Nothing was written.'
         : `\n🎉 Installed ${copied} file(s) across ${targets.length - skippedHarnesses} harness(es).` +
               (pluginChanges ? ` Updated ${pluginChanges} plugin config(s).` : ''),
 );
@@ -104,7 +149,7 @@ if (dryRun && skippedHarnesses > 0) {
     );
 }
 
-// ── Plugin registration ────────────────────────────────────────────────
+// ── Plugin registration ──────────────────────────────────────────────
 async function handlePlugin(id, plugin, scope, dry, logFn) {
     const configPath =
         scope === 'user'
@@ -135,7 +180,7 @@ async function handlePlugin(id, plugin, scope, dry, logFn) {
     if (!dry) {
         config.plugin.push(plugin.entry);
         await mkdir(dirname(configPath), { recursive: true });
-        await writeFile(configPath, JSON.stringify(config, null, 2) + '\n');
+        await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`);
     }
 
     return true;

package/scripts/lib/detect.mjs

@@ -3,30 +3,33 @@ import { homedir } from 'node:os';
 import { join } from 'node:path';
 
 export function expandHome(p) {
-  if (p === '~') return homedir();
-  if (p.startsWith('~/')) return join(homedir(), p.slice(2));
-  return p;
+    if (p === '~') return homedir();
+    if (p.startsWith('~/')) return join(homedir(), p.slice(2));
+    return p;
 }
 
 export async function pathExists(p) {
-  try {
-    await access(expandHome(p));
-    return true;
-  } catch {
-    return false;
-  }
+    try {
+        await access(expandHome(p));
+        return true;
+    } catch {
+        return false;
+    }
 }
 
 export async function detectHarnesses(tools) {
-  const detected = [];
-  for (const [id, harness] of Object.entries(tools.harnesses)) {
-    const dirs = harness.detect?.dirs ?? [];
-    const files = harness.detect?.files ?? [];
-    let found = false;
-    for (const p of [...dirs, ...files]) {
-      if (await pathExists(p)) { found = true; break; }
+    const detected = [];
+    for (const [id, harness] of Object.entries(tools.harnesses)) {
+        const dirs = harness.detect?.dirs ?? [];
+        const files = harness.detect?.files ?? [];
+        let found = false;
+        for (const p of [...dirs, ...files]) {
+            if (await pathExists(p)) {
+                found = true;
+                break;
+            }
+        }
+        if (found) detected.push(id);
     }
-    if (found) detected.push(id);
-  }
-  return detected;
+    return detected;
 }

package/scripts/lib/frontmatter.mjs

@@ -1,5 +1,5 @@
 import { readdir, readFile } from 'node:fs/promises';
-import { join, relative, basename } from 'node:path';
+import { basename, join, relative } from 'node:path';
 import matter from 'gray-matter';
 
 /**
@@ -10,28 +10,28 @@ import matter from 'gray-matter';
  * filename as fallback. Files starting with `_` are skipped.
  */
 export async function readRules(dir) {
-  const entries = await readdir(dir, { recursive: true, withFileTypes: true });
-  const rules = [];
+    const entries = await readdir(dir, { recursive: true, withFileTypes: true });
+    const rules = [];
 
-  for (const entry of entries) {
-    if (!entry.isFile()) continue;
-    if (!entry.name.endsWith('.md')) continue;
-    if (entry.name.startsWith('_')) continue;
+    for (const entry of entries) {
+        if (!entry.isFile()) continue;
+        if (!entry.name.endsWith('.md')) continue;
+        if (entry.name.startsWith('_')) continue;
 
-    const parent = entry.parentPath ?? entry.path;
-    const filePath = join(parent, entry.name);
-    const raw = await readFile(filePath, 'utf8');
-    const parsed = matter(raw);
-    const filename = basename(filePath, '.md');
-    const slug = typeof parsed.data?.name === 'string' ? parsed.data.name : filename;
+        const parent = entry.parentPath ?? entry.path;
+        const filePath = join(parent, entry.name);
+        const raw = await readFile(filePath, 'utf8');
+        const parsed = matter(raw);
+        const filename = basename(filePath, '.md');
+        const slug = typeof parsed.data?.name === 'string' ? parsed.data.name : filename;
 
-    rules.push({
-      slug,
-      source: relative(dir, filePath),
-      data: parsed.data ?? {},
-      body: (parsed.content ?? '').trim(),
-    });
-  }
+        rules.push({
+            slug,
+            source: relative(dir, filePath),
+            data: parsed.data ?? {},
+            body: (parsed.content ?? '').trim(),
+        });
+    }
 
-  return rules.sort((a, b) => a.slug.localeCompare(b.slug));
+    return rules.sort((a, b) => a.slug.localeCompare(b.slug));
 }

package/scripts/lib/renderers/_util.mjs

@@ -2,7 +2,7 @@ import { stringify as yamlStringify } from 'yaml';
 
 /** Wraps YAML frontmatter + body in a Markdown document. */
 export function wrap(data, body) {
-  const fm = yamlStringify(data).trimEnd();
-  const content = (body ?? '').trim();
-  return `---\n${fm}\n---\n\n${content}\n`;
+    const fm = yamlStringify(data).trimEnd();
+    const content = (body ?? '').trim();
+    return `---\n${fm}\n---\n\n${content}\n`;
 }

package/scripts/lib/renderers/antigravity.mjs

@@ -10,21 +10,21 @@ import { wrap } from './_util.mjs';
  *   5. nothing                       → manual
  */
 export function renderAntigravity(rule, _harness) {
-  const d = rule.data;
-  let trigger = d.trigger;
+    const d = rule.data;
+    let trigger = d.trigger;
 
-  if (!trigger) {
-    if (d.alwaysApply === true) trigger = 'always_on';
-    else if (d.globs) trigger = 'glob';
-    else if (d.description) trigger = 'model_decision';
-    else trigger = 'manual';
-  }
+    if (!trigger) {
+        if (d.alwaysApply === true) trigger = 'always_on';
+        else if (d.globs) trigger = 'glob';
+        else if (d.description) trigger = 'model_decision';
+        else trigger = 'manual';
+    }
 
-  const fm = { trigger };
-  if (trigger === 'glob' && d.globs) {
-    fm.globs = Array.isArray(d.globs) ? d.globs.join(',') : d.globs;
-  }
-  if (d.description) fm.description = d.description;
+    const fm = { trigger };
+    if (trigger === 'glob' && d.globs) {
+        fm.globs = Array.isArray(d.globs) ? d.globs.join(',') : d.globs;
+    }
+    if (d.description) fm.description = d.description;
 
-  return wrap(fm, rule.body);
+    return wrap(fm, rule.body);
 }

package/scripts/lib/renderers/index.mjs

@@ -1,12 +1,12 @@
 import { renderAntigravity } from './antigravity.mjs';
-import { renderPiAgent } from './pi-agent.mjs';
 import { renderOhMyPi } from './oh-my-pi.mjs';
 import { renderOpencode } from './opencode.mjs';
+import { renderPiAgent } from './pi-agent.mjs';
 
 /** Maps `format` from tools.json → renderer function. */
 export const renderers = {
-  'md-yaml-trigger': renderAntigravity,
-  'md-rules-dir': renderPiAgent,
-  'md-or-mdc': renderOhMyPi,
-  'md-plugin': renderOpencode,
+    'md-yaml-trigger': renderAntigravity,
+    'md-rules-dir': renderPiAgent,
+    'md-or-mdc': renderOhMyPi,
+    'md-plugin': renderOpencode,
 };

package/scripts/lib/renderers/oh-my-pi.mjs

@@ -5,12 +5,12 @@ import { wrap } from './_util.mjs';
  * `alwaysApply` in the frontmatter. Accepts .md or .mdc; we emit .md.
  */
 export function renderOhMyPi(rule, _harness) {
-  const d = rule.data;
-  const fm = {
-    name: d.name,
-    description: d.description,
-  };
-  if (d.globs !== undefined) fm.globs = d.globs;
-  if (d.alwaysApply !== undefined) fm.alwaysApply = d.alwaysApply;
-  return wrap(fm, rule.body);
+    const d = rule.data;
+    const fm = {
+        name: d.name,
+        description: d.description,
+    };
+    if (d.globs !== undefined) fm.globs = d.globs;
+    if (d.alwaysApply !== undefined) fm.alwaysApply = d.alwaysApply;
+    return wrap(fm, rule.body);
 }

package/scripts/lib/renderers/opencode.mjs

@@ -5,9 +5,9 @@ import { wrap } from './_util.mjs';
  * (used for matching) and optional `globs`/`match` controls.
  */
 export function renderOpencode(rule, _harness) {
-  const d = rule.data;
-  const fm = { description: d.description };
-  if (d.globs !== undefined) fm.globs = d.globs;
-  if (d.match !== undefined) fm.match = d.match;
-  return wrap(fm, rule.body);
+    const d = rule.data;
+    const fm = { description: d.description };
+    if (d.globs !== undefined) fm.globs = d.globs;
+    if (d.match !== undefined) fm.match = d.match;
+    return wrap(fm, rule.body);
 }

package/scripts/lib/renderers/pi-agent.mjs

@@ -5,13 +5,13 @@ import { wrap } from './_util.mjs';
  * frontmatter carrying `name`, `description`, and optionally `tools`.
  */
 export function renderPiAgent(rule, _harness) {
-  const d = rule.data;
-  const fm = {
-    name: d.name,
-    description: d.description,
-  };
-  if (Array.isArray(d.tools) && d.tools.length > 0) {
-    fm.tools = d.tools;
-  }
-  return wrap(fm, rule.body);
+    const d = rule.data;
+    const fm = {
+        name: d.name,
+        description: d.description,
+    };
+    if (Array.isArray(d.tools) && d.tools.length > 0) {
+        fm.tools = d.tools;
+    }
+    return wrap(fm, rule.body);
 }

package/scripts/validate.mjs

@@ -12,41 +12,41 @@ const validate = ajv.compile(schema);
 const rules = await readRules(RULES_DIR);
 
 if (rules.length === 0) {
-  console.error(`❌ No rules found in ${RULES_DIR}`);
-  process.exit(1);
+    console.error(`❌ No rules found in ${RULES_DIR}`);
+    process.exit(1);
 }
 
 const seen = new Set();
 let failures = 0;
 
 for (const rule of rules) {
-  const errors = [];
+    const errors = [];
 
-  if (seen.has(rule.slug)) {
-    errors.push({ instancePath: '/name', message: `duplicate rule name "${rule.slug}"` });
-  }
-  seen.add(rule.slug);
+    if (seen.has(rule.slug)) {
+        errors.push({ instancePath: '/name', message: `duplicate rule name "${rule.slug}"` });
+    }
+    seen.add(rule.slug);
 
-  if (!validate(rule.data)) {
-    for (const e of validate.errors ?? []) {
-      errors.push(e);
+    if (!validate(rule.data)) {
+        for (const e of validate.errors ?? []) {
+            errors.push(e);
+        }
     }
-  }
 
-  if (errors.length > 0) {
-    failures++;
-    console.error(`❌ ${rule.source}`);
-    for (const e of errors) {
-      console.error(`   ${e.instancePath || '/'} ${e.message}`);
+    if (errors.length > 0) {
+        failures++;
+        console.error(`❌ ${rule.source}`);
+        for (const e of errors) {
+            console.error(`   ${e.instancePath || '/'} ${e.message}`);
+        }
+    } else {
+        console.log(`✅ ${rule.source}`);
     }
-  } else {
-    console.log(`✅ ${rule.source}`);
-  }
 }
 
 if (failures > 0) {
-  console.error(`\n💥 ${failures}/${rules.length} rule(s) failed validation.`);
-  process.exit(1);
+    console.error(`\n💥 ${failures}/${rules.length} rule(s) failed validation.`);
+    process.exit(1);
 }
 
 console.log(`\n🎉 ${rules.length} rule(s) validated successfully.`);