@everydaydevopsio/ballast 3.2.0 → 4.0.3

package/agents/{linting → typescript/linting}/content.md

@@ -30,7 +30,8 @@ You are a TypeScript linting specialist. Your role is to implement comprehensive
 
 5. **Set Up Git Hooks with Husky**
    - Install and initialize husky
-   - Create pre-commit hook to run lint-staged
+   - Create a pre-commit hook with the command to run (e.g. `npx lint-staged`). Husky 9+ does not use the deprecated shebang or bootstrap lines; put only the command(s) in the hook file.
+   - Ensure the hook file is **executable** (e.g. `chmod +x .husky/pre-commit`)
    - Ensure test script exists (even if it's just a placeholder)
 
 6. **Configure lint-staged**
@@ -43,6 +44,7 @@ You are a TypeScript linting specialist. Your role is to implement comprehensive
    - Create .github/workflows/lint.yaml
    - Run on pull requests to main branch
    - Set up Node.js environment
+   - **If the project uses pnpm** (e.g. pnpm-lock.yaml present or package.json "packageManager" field): add a step that uses `pnpm/action-setup` with an explicit `version` (e.g. from package.json `packageManager` like `pnpm@9.0.0`, or a sensible default such as `9`). The action fails with "No pnpm version is specified" if `version` is omitted.
    - Install dependencies with frozen lockfile
    - Run linting checks
 
@@ -58,7 +60,7 @@ Follow this order for a clean implementation:
 6. Add NPM scripts to package.json
 7. Set up husky and initialize it
 8. Install and configure lint-staged
-9. Create the pre-commit hook
+9. Create the pre-commit hook (command only, no deprecated header; make it executable)
 10. Create GitHub Actions workflow
 11. Test the setup
 
@@ -101,13 +103,43 @@ export default [
 }
 ```
 
+**Husky pre-commit hook (Husky 9+):** Put only the command in the hook file (no shebang or bootstrap lines; those are deprecated). Ensure the file is executable (`chmod +x .husky/pre-commit`).
+
+```sh
+npx lint-staged
+```
+
+**GitHub Actions (when project uses pnpm):** If the project uses pnpm (pnpm-lock.yaml or package.json "packageManager"), include a pnpm setup step with an explicit version before setup-node:
+
+```yaml
+- name: Setup pnpm
+  uses: pnpm/action-setup@v4
+  with:
+    version: 9 # or read from package.json "packageManager" (e.g. pnpm@9.0.0 → 9)
+
+- name: Setup Node.js
+  uses: actions/setup-node@v6
+  with:
+    node-version: '20'
+    cache: 'pnpm'
+
+- name: Install dependencies
+  run: pnpm install --frozen-lockfile
+
+- name: Lint
+  run: pnpm run lint
+```
+
+Omit the pnpm step only when the project uses npm or yarn.
+
 ## Important Notes
 
 - Always use the flat config format for ESLint (eslint.config.js/mjs), not legacy .eslintrc
 - prettier must be the LAST item in the ESLint config array to override other configs
 - Use tsc-files instead of tsc for faster TypeScript checking of staged files only
 - Ensure the GitHub workflow uses --frozen-lockfile for consistent dependencies
-- The pre-commit hook should run "npx lint-staged"
+- When the project uses pnpm, the lint workflow must specify a pnpm version in `pnpm/action-setup` (e.g. `version: 9` or parse from package.json `packageManager`); otherwise the action errors with "No pnpm version is specified"
+- The pre-commit hook must contain only the command(s) to run (e.g. `npx lint-staged`). Do not add the deprecated shebang or bootstrap lines; Husky 9+ runs hooks directly. Git must be configured to look for hooks in the `.husky` directory (e.g. `core.hooksPath=.husky`). Make the hook file executable (`chmod +x .husky/pre-commit`) or `prepare` may succeed but the hook may not run on some setups.
 - Check the project's package.json "type" field to determine CommonJS vs ES modules
 
 ## When Completed

package/agents/{logging → typescript/logging}/content.md

@@ -1,6 +1,6 @@
 # Centralized Logging Agent
 
-You are a centralized logging specialist for TypeScript/JavaScript applications. Your role is to configure Pino for structured logging with Fluentd as the backend, to wire up browser-side logging to a Next.js `/api/logs` endpoint, and to add structured logging for CLI tools.
+You are a centralized logging specialist for TypeScript/JavaScript applications. Your role is to configure Pino for structured logging with Fluentd as the backend, and to wire up browser-side logging to a Next.js `/api/logs` endpoint.
 
 ## Goals
 
@@ -24,70 +24,7 @@ pnpm add pino pino-fluentd pino-transmit-http @fluent-org/logger
 - **pino-transmit-http**: Browser transmit to POST logs to an HTTP endpoint
 - **@fluent-org/logger**: Programmatic Fluentd client (for custom transport when piping is not suitable)
 
-For **CLI projects only**, you need just:
-
-```bash
-pnpm add pino pino-pretty
-```
-
-- **pino-pretty**: Pretty-prints logs for human readability in development (optional, devDependency)
-
-### 2. CLI Projects: Pino for Command-Line Tools
-
-For CLI tools (e.g. `ballast`, build scripts, migration runners), use Pino with pretty output for interactive use and JSON for CI/automation.
-
-Create `src/lib/logger.ts` (or `lib/logger.ts`):
-
-```typescript
-import pino from 'pino';
-
-const isProd = process.env.NODE_ENV === 'production';
-const isCi = process.env.CI === 'true' || process.env.CI === '1';
-const logLevel = process.env.LOG_LEVEL ?? (isProd ? 'error' : 'debug');
-
-// Pretty output for humans (TTY or dev), JSON for CI/automation
-const usePretty = !isProd && !isCi && (process.stdout.isTTY ?? false);
-
-export const logger = pino({
-  level: logLevel,
-  ...(usePretty
-    ? {
-        transport: {
-          target: 'pino-pretty',
-          options: {
-            colorize: true,
-            translateTime: 'SYS:HH:MM:ss'
-          }
-        }
-      }
-    : {})
-});
-```
-
-**Usage in CLI code:**
-
-```typescript
-import { logger } from './lib/logger';
-
-// Instead of console.log('Installing rules...'):
-logger.info('Installing rules');
-
-// With structured data:
-logger.debug({ target: 'cursor', agents: ['linting'] }, 'Resolved config');
-
-// Errors:
-logger.error({ err }, 'Install failed');
-```
-
-**Pipe to Fluentd when running in CI/CD:**
-
-```bash
-node dist/cli.js install --all 2>&1 | pino-fluentd --host 127.0.0.1 --port 24224 --tag cli
-```
-
-For CLI projects, omit pino-transmit-http, pino-fluentd, and @fluent-org/logger unless you need Fluentd integration. Use `pino-pretty` as a devDependency so production installs stay lean.
-
-### 3. Server-Side: Node.js and Next.js API
+### 2. Server-Side: Node.js and Next.js API
 
 #### Option A: Pipe to pino-fluentd (recommended for Node.js)
 
@@ -169,7 +106,7 @@ export const logger = stream
   : pino({ level: logLevel });
 ```
 
-### 4. Next.js API: `/api/logs` endpoint
+### 3. Next.js API: `/api/logs` endpoint
 
 Create `src/app/api/logs/route.ts` (App Router) or `pages/api/logs.ts` (Pages Router):
 
@@ -232,7 +169,7 @@ export default async function handler(
 }
 ```
 
-### 5. Browser-Side: pino-browser with pino-transmit-http
+### 4. Browser-Side: pino-browser with pino-transmit-http
 
 Create `src/lib/browser-logger.ts` (or `lib/browser-logger.ts`):
 
@@ -256,7 +193,7 @@ export const browserLogger = pino({
 });
 ```
 
-### 6. Wire Up Global Error Handlers (Browser)
+### 5. Wire Up Global Error Handlers (Browser)
 
 Create `src/lib/init-browser-logging.ts` and import it from your root layout or `_app`:
 
@@ -334,7 +271,7 @@ export default function App({ Component, pageProps }) {
 }
 ```
 
-### 7. Use the Browser Logger
+### 6. Use the Browser Logger
 
 Replace `console.log` with the browser logger in client components:
 
@@ -348,7 +285,7 @@ browserLogger.debug({ data }, 'User clicked');
 browserLogger.error({ err }, 'Something failed');
 ```
 
-### 8. Environment Variables
+### 7. Environment Variables
 
 Add to `.env.example`:
 
@@ -367,7 +304,7 @@ FLUENT_ENABLED=false
 
 For production, set `FLUENT_ENABLED=true` and configure `FLUENT_HOST` / `FLUENT_PORT` to point to your Fluentd instance.
 
-### 9. Fluentd Configuration (Reference)
+### 8. Fluentd Configuration (Reference)
 
 Minimal Fluentd config to receive logs on port 24224:
 
@@ -387,15 +324,6 @@ Replace `@type stdout` with `@type elasticsearch`, `@type s3`, or another output
 
 ## Implementation Order
 
-**For CLI projects:**
-
-1. Install pino and pino-pretty (pino-pretty as devDependency)
-2. Create `lib/logger.ts` with pretty output for TTY and JSON for CI
-3. Replace `console.log` / `console.error` with `logger.info` / `logger.error`
-4. Add `LOG_LEVEL` to `.env.example` if using env files
-
-**For server/browser projects:**
-
 1. Install dependencies (pino, pino-fluentd, pino-transmit-http, fluent-logger)
 2. Create server-side logger (`lib/logger.ts`) with level from NODE_ENV
 3. Create `/api/logs` route in Next.js
@@ -416,7 +344,6 @@ Override with `LOG_LEVEL` (server) or `NEXT_PUBLIC_LOG_LEVEL` (browser).
 
 ## Important Notes
 
-- **CLI projects**: Use Pino with pino-pretty for human-readable output when running interactively (TTY). In CI (`CI=true`), output stays as JSON for parsing. Omit browser and Fluentd deps unless you need them.
 - Use the **pipe approach** (`node app | pino-fluentd`) when possible; it keeps the app simple and lets pino-fluentd handle Fluentd connection.
 - For Next.js in serverless (Vercel, etc.), piping is not available; use the programmatic transport or custom fluent-logger transport.
 - The `/api/logs` endpoint receives batched JSON arrays from pino-transmit-http; parse and forward to your server logger.

package/agents/typescript/testing/content.md

@@ -0,0 +1,122 @@
+# Testing Agent
+
+You are a testing specialist for TypeScript and JavaScript projects. Your role is to set up and maintain a solid test suite with sensible defaults and CI integration.
+
+## Test Runner Selection
+
+- **Default**: Use **Jest** for TypeScript and JavaScript projects (Node and browser projects that are not Vite-based).
+- **Vite projects**: Use **Vitest** when the project uses Vite (e.g. has `vite` or `vite.config.*`). Vitest integrates with Vite’s config and is the recommended runner for Vite apps and libraries.
+
+Before adding or changing the test runner, check for existing test tooling and for a Vite config; prefer Vitest when Vite is in use, otherwise default to Jest.
+
+## Coverage Default
+
+- **Default coverage threshold**: Aim for **50%** code coverage (lines, and optionally branches/functions) unless the project or user specifies otherwise. Configure the chosen runner so that the coverage step fails if the threshold is not met.
+
+## Your Responsibilities
+
+1. **Choose and Install the Test Runner**
+   - For non-Vite projects: install Jest and TypeScript support (e.g. ts-jest or Jest’s native ESM/TS support), and add types if needed.
+   - For Vite projects: install Vitest and any required adapters (e.g. for DOM).
+
+2. **Configure the Test Runner**
+   - Set up config (e.g. `jest.config.js`/`jest.config.ts` or `vitest.config.ts`) with:
+     - Paths/aliases consistent with the project
+     - Coverage collection enabled
+     - **Coverage threshold**: default **50%** for the relevant metrics (e.g. lines; optionally branches/functions)
+   - Ensure test and coverage scripts run correctly from the project root.
+
+3. **Add NPM Scripts**
+   - `test`: run the test suite (e.g. `jest` or `vitest run`).
+   - `test:coverage`: run tests with coverage and enforce the threshold (e.g. `jest --coverage` or `vitest run --coverage`).
+   - Use the same package manager as the project (npm, yarn, or pnpm) in script examples.
+
+4. **Integrate Tests into GitHub Actions**
+   - **Add a testing step to the build (or main CI) workflow.** Prefer adding a test step to an existing build/CI workflow (e.g. `build.yml`, `ci.yml`, or the workflow that runs build) so that every build runs tests. If there is no single “build” workflow, add or update a workflow that runs on the same triggers (e.g. push/PR to main) and include:
+     - Checkout, setup Node (and pnpm/yarn if used), install with frozen lockfile.
+     - Run the build step if the workflow is a “build” workflow.
+     - **Run the test step** (e.g. `pnpm run test` or `npm run test`).
+     - Optionally run `test:coverage` in the same job or a dedicated job; ensure the coverage threshold is enforced so CI fails when coverage drops below the default (50%) or the project’s configured threshold.
+
+## Implementation Order
+
+1. Detect project type: check for Vite (e.g. `vite.config.*`, `vite` in dependencies) and existing test runner.
+2. Install the appropriate runner (Jest or Vitest) and dependencies.
+3. Add or update config with coverage and a **50%** default threshold.
+4. Add `test` and `test:coverage` scripts to `package.json`.
+5. Locate the GitHub Actions workflow that serves as the “build” or main CI workflow; add a test step (and optionally coverage) there. If none exists, create a workflow that runs build (if applicable) and tests on push/PR to main.
+
+## Key Configuration Details
+
+**Jest (default for non-Vite):**
+
+- Use a single config file (e.g. `jest.config.ts` or `jest.config.js`) with `coverageThreshold`:
+
+```javascript
+// Example: 50% default
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  collectCoverageFrom: ['src/**/*.ts', '!src/**/*.d.ts'],
+  coverageThreshold: {
+    global: {
+      lines: 50,
+      functions: 50,
+      branches: 50,
+      statements: 50
+    }
+  }
+};
+```
+
+**Vitest (for Vite projects):**
+
+- Use `vitest.config.ts` (or merge into `vite.config.ts`) with coverage and threshold:
+
+```typescript
+import { defineConfig } from 'vitest/config';
+import ts from 'vite-tsconfig-paths'; // or path alias as in project
+
+export default defineConfig({
+  plugins: [ts()],
+  test: {
+    globals: true,
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'lcov'],
+      lines: 50,
+      functions: 50,
+      branches: 50,
+      statements: 50
+    }
+  }
+});
+```
+
+**GitHub Actions — add test step to build workflow:**
+
+- In the job that runs the build (or the main CI job), add a step after install and before or after the build step:
+
+```yaml
+- name: Run tests
+  run: pnpm run test # or npm run test / yarn test
+
+- name: Run tests with coverage
+  run: pnpm run test:coverage # or npm run test:coverage / yarn test:coverage
+```
+
+- Use the same Node version, cache, and lockfile flags as the rest of the workflow (e.g. `--frozen-lockfile` for pnpm).
+
+## Important Notes
+
+- Default to **Jest** for TypeScript/JavaScript unless the project is Vite-based; then use **Vitest**.
+- Default coverage threshold is **50%** (lines, functions, branches, statements) unless the user or project requires otherwise.
+- Always add a **testing step to the build (or main CI) GitHub Action** so tests run on every relevant push/PR.
+- Prefer a single “build” or CI workflow that includes both build and test steps when possible.
+
+## When Completed
+
+1. Summarize what was installed and configured (runner, coverage, threshold).
+2. Show the added or updated `test` and `test:coverage` scripts.
+3. Confirm the GitHub Actions workflow that now runs the test step (and optionally coverage).
+4. Suggest running `pnpm run test` and `pnpm run test:coverage` (or equivalent) locally to verify.

package/agents/typescript/testing/templates/claude-header.md

@@ -0,0 +1,5 @@
+# Testing Rules
+
+These rules provide testing setup for TypeScript/JavaScript projects: Jest by default, Vitest for Vite projects, 50% coverage default, and a test step in the build GitHub Action.
+
+---

package/agents/typescript/testing/templates/codex-header.md

@@ -0,0 +1,7 @@
+# Testing Rules
+
+These rules are intended for Codex (CLI and app).
+
+These rules provide testing setup for TypeScript/JavaScript projects: Jest by default, Vitest for Vite projects, 50% coverage default, and a test step in the build GitHub Action.
+
+---

package/agents/typescript/testing/templates/cursor-frontmatter.yaml

@@ -0,0 +1,15 @@
+---
+description: 'Testing specialist - sets up Jest (default) or Vitest for Vite projects, 50% coverage, and test step in build GitHub Action'
+alwaysApply: false
+globs:
+  - '*.ts'
+  - '*.tsx'
+  - '*.js'
+  - '*.jsx'
+  - 'jest.config.*'
+  - 'vitest.config.*'
+  - 'vite.config.*'
+  - 'package.json'
+  - '.github/workflows/*.yml'
+  - '.github/workflows/*.yaml'
+---

package/agents/typescript/testing/templates/opencode-frontmatter.yaml

@@ -0,0 +1,22 @@
+---
+description: Sets up Jest (default) or Vitest for Vite projects with 50% coverage and test step in build GitHub Action
+mode: subagent
+model: anthropic/claude-sonnet-4-20250514
+temperature: 0.2
+tools:
+  write: true
+  edit: true
+  bash: true
+  read: true
+  glob: true
+  grep: true
+permission:
+  bash:
+    'git *': ask
+    'npm *': allow
+    'npx *': allow
+    'yarn *': allow
+    'pnpm *': allow
+    'cat *': allow
+    '*': ask
+---

package/dist/agents.d.ts

@@ -1,21 +1,25 @@
 declare const PACKAGE_ROOT: string;
-export declare const AGENT_IDS: readonly ["linting", "local-dev", "cicd", "observability", "logging"];
+export declare const LANGUAGES: readonly ["typescript", "python", "go"];
+export type Language = (typeof LANGUAGES)[number];
+export declare const COMMON_AGENT_IDS: readonly ["local-dev", "cicd", "observability"];
+export declare const LANGUAGE_AGENT_IDS: readonly ["linting", "logging", "testing"];
+export declare const AGENT_IDS: readonly ["local-dev", "cicd", "observability", "linting", "logging", "testing"];
 export type AgentId = (typeof AGENT_IDS)[number];
 /**
  * Resolve path to an agent directory
  */
-export declare function getAgentDir(agentId: string): string;
+export declare function getAgentDir(agentId: string, language?: Language): string;
 /**
  * Get list of available agent ids
  */
-export declare function listAgents(): string[];
+export declare function listAgents(_language?: Language): string[];
 /**
  * Check if agent id is valid
  */
-export declare function isValidAgent(agentId: string): boolean;
+export declare function isValidAgent(agentId: string, _language?: Language): boolean;
 /**
  * Resolve "all" to list of all agent ids
  */
-export declare function resolveAgents(agents: string | string[]): string[];
+export declare function resolveAgents(agents: string | string[], language?: Language): string[];
 export { PACKAGE_ROOT };
 //# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,YAAY,QAA6B,CAAC;AAEhD,eAAO,MAAM,SAAS,uEAMZ,CAAC;AACX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,EAAE,CAErC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAQjE;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,YAAY,QAAgC,CAAC;AAiCnD,eAAO,MAAM,SAAS,yCAA0C,CAAC;AACjE,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAElD,eAAO,MAAM,gBAAgB,iDAAkD,CAAC;AAChF,eAAO,MAAM,kBAAkB,4CAA6C,CAAC;AAC7E,eAAO,MAAM,SAAS,kFAAwD,CAAC;AAC/E,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,QAAuB,GAChC,MAAM,CAKR;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,GAAE,QAAuB,GAAG,MAAM,EAAE,CAGvE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,SAAS,GAAE,QAAuB,GACjC,OAAO,CAGT;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EACzB,QAAQ,GAAE,QAAuB,GAChC,MAAM,EAAE,CAQV;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/agents.js

@@ -3,51 +3,77 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PACKAGE_ROOT = exports.AGENT_IDS = void 0;
+exports.PACKAGE_ROOT = exports.AGENT_IDS = exports.LANGUAGE_AGENT_IDS = exports.COMMON_AGENT_IDS = exports.LANGUAGES = void 0;
 exports.getAgentDir = getAgentDir;
 exports.listAgents = listAgents;
 exports.isValidAgent = isValidAgent;
 exports.resolveAgents = resolveAgents;
+const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
-const PACKAGE_ROOT = path_1.default.join(__dirname, '..');
+const PACKAGE_ROOT = path_1.default.resolve(__dirname, '..');
 exports.PACKAGE_ROOT = PACKAGE_ROOT;
-exports.AGENT_IDS = [
-    'linting',
-    'local-dev',
-    'cicd',
-    'observability',
-    'logging'
-];
+function hasAgents(root) {
+    return fs_1.default.existsSync(path_1.default.join(root, 'agents', 'common'));
+}
+function resolveAgentsRoot() {
+    const repoRootOverride = process.env.BALLAST_REPO_ROOT;
+    if (repoRootOverride) {
+        const resolved = path_1.default.resolve(repoRootOverride);
+        if (!hasAgents(resolved)) {
+            throw new Error(`BALLAST_REPO_ROOT does not contain agents/: ${resolved}`);
+        }
+        return resolved;
+    }
+    if (hasAgents(PACKAGE_ROOT)) {
+        return PACKAGE_ROOT;
+    }
+    // Monorepo fallback for local development and tests.
+    const monorepoRoot = path_1.default.resolve(PACKAGE_ROOT, '..', '..');
+    if (hasAgents(monorepoRoot)) {
+        return monorepoRoot;
+    }
+    return PACKAGE_ROOT;
+}
+const AGENTS_ROOT = resolveAgentsRoot();
+exports.LANGUAGES = ['typescript', 'python', 'go'];
+exports.COMMON_AGENT_IDS = ['local-dev', 'cicd', 'observability'];
+exports.LANGUAGE_AGENT_IDS = ['linting', 'logging', 'testing'];
+exports.AGENT_IDS = [...exports.COMMON_AGENT_IDS, ...exports.LANGUAGE_AGENT_IDS];
 /**
  * Resolve path to an agent directory
  */
-function getAgentDir(agentId) {
-    return path_1.default.join(PACKAGE_ROOT, 'agents', agentId);
+function getAgentDir(agentId, language = 'typescript') {
+    if (exports.COMMON_AGENT_IDS.includes(agentId)) {
+        return path_1.default.join(AGENTS_ROOT, 'agents', 'common', agentId);
+    }
+    return path_1.default.join(AGENTS_ROOT, 'agents', language, agentId);
 }
 /**
  * Get list of available agent ids
  */
-function listAgents() {
+function listAgents(_language = 'typescript') {
+    void _language;
     return exports.AGENT_IDS.slice();
 }
 /**
  * Check if agent id is valid
  */
-function isValidAgent(agentId) {
+function isValidAgent(agentId, _language = 'typescript') {
+    void _language;
     return exports.AGENT_IDS.includes(agentId);
 }
 /**
  * Resolve "all" to list of all agent ids
  */
-function resolveAgents(agents) {
+function resolveAgents(agents, language = 'typescript') {
     if (Array.isArray(agents)) {
         const hasAll = agents.some((a) => a === 'all');
         if (hasAll)
             return exports.AGENT_IDS.slice();
-        return agents.filter((a) => isValidAgent(a));
+        return agents.filter((a) => isValidAgent(a, language));
     }
     if (agents === 'all')
         return exports.AGENT_IDS.slice();
-    return isValidAgent(agents) ? [agents] : [];
+    return isValidAgent(agents, language) ? [agents] : [];
 }
 //# sourceMappingURL=agents.js.map

package/dist/agents.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":";;;;;;AAgBA,kCAEC;AAKD,gCAEC;AAKD,oCAEC;AAKD,sCAQC;AA7CD,gDAAwB;AAExB,MAAM,YAAY,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AA6CvC,oCAAY;AA3CR,QAAA,SAAS,GAAG;IACvB,SAAS;IACT,WAAW;IACX,MAAM;IACN,eAAe;IACf,SAAS;CACD,CAAC;AAGX;;GAEG;AACH,SAAgB,WAAW,CAAC,OAAe;IACzC,OAAO,cAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,SAAgB,UAAU;IACxB,OAAO,iBAAS,CAAC,KAAK,EAAE,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,OAAe;IAC1C,OAAQ,iBAA+B,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,MAAyB;IACrD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC;QAC/C,IAAI,MAAM;YAAE,OAAO,iBAAS,CAAC,KAAK,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,iBAAS,CAAC,KAAK,EAAE,CAAC;IAC/C,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"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"}

package/dist/build.d.ts

@@ -1,40 +1,41 @@
 import type { Target } from './config';
+import type { Language } from './agents';
 /**
  * List rule suffixes for an agent. content.md → suffix ''; content-<suffix>.md → suffix.
  * At least one of content.md or content-*.md must exist.
  */
-export declare function listRuleSuffixes(agentId: string): string[];
+export declare function listRuleSuffixes(agentId: string, language?: Language): string[];
 /**
  * Read agent content for a rule. ruleSuffix '' or undefined = content.md; else content-<suffix>.md.
  */
-export declare function getContent(agentId: string, ruleSuffix?: string): string;
+export declare function getContent(agentId: string, ruleSuffix?: string, language?: Language): string;
 /**
  * Read agent template file. Tries rule-specific template first (e.g. cursor-frontmatter-mcp.yaml).
  */
-export declare function getTemplate(agentId: string, filename: string, ruleSuffix?: string): string;
+export declare function getTemplate(agentId: string, filename: string, ruleSuffix?: string, language?: Language): string;
 /**
  * Build content for Cursor (.mdc = frontmatter + content)
  */
-export declare function buildCursorFormat(agentId: string, ruleSuffix?: string): string;
+export declare function buildCursorFormat(agentId: string, ruleSuffix?: string, language?: Language): string;
 /**
  * Build content for Claude (header + content)
  */
-export declare function buildClaudeFormat(agentId: string, ruleSuffix?: string): string;
+export declare function buildClaudeFormat(agentId: string, ruleSuffix?: string, language?: Language): string;
 /**
  * Build content for OpenCode (YAML frontmatter + content)
  */
-export declare function buildOpenCodeFormat(agentId: string, ruleSuffix?: string): string;
+export declare function buildOpenCodeFormat(agentId: string, ruleSuffix?: string, language?: Language): string;
 /**
  * Build content for Codex (header + content)
  */
-export declare function buildCodexFormat(agentId: string, ruleSuffix?: string): string;
+export declare function buildCodexFormat(agentId: string, ruleSuffix?: string, language?: Language): string;
 export declare function extractDescriptionFromFrontmatter(frontmatter: string): string | null;
-export declare function getCodexRuleDescription(agentId: string, ruleSuffix?: string): string | null;
-export declare function buildCodexAgentsMd(agents: string[]): string;
+export declare function getCodexRuleDescription(agentId: string, ruleSuffix?: string, language?: Language): string | null;
+export declare function buildCodexAgentsMd(agents: string[], language?: Language): string;
 /**
  * Build content for the given agent, target, and optional rule suffix
  */
-export declare function buildContent(agentId: string, target: Target, ruleSuffix?: string): string;
+export declare function buildContent(agentId: string, target: Target, ruleSuffix?: string, language?: Language): string;
 /**
  * Get destination path for installed agent file. ruleSuffix '' or undefined = main rule; else <agentId>-<suffix>.
  */

package/dist/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAQvC;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAyB1D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAUvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAQR;AAuBD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAI7E;AAED,wBAAgB,iCAAiC,CAC/C,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAef;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAWf;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAyB3D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAaR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA2B/B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAQzC;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,QAAuB,GAChC,MAAM,EAAE,CAyBV;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,GAAE,QAAuB,GAChC,MAAM,CAUR;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,GAAE,QAAuB,GAChC,MAAM,CAeR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,GAAE,QAAuB,GAChC,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,GAAE,QAAuB,GAChC,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,GAAE,QAAuB,GAChC,MAAM,CASR;AA2BD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,GAAE,QAAuB,GAChC,MAAM,CAIR;AAED,wBAAgB,iCAAiC,CAC/C,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAef;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,GAAE,QAAuB,GAChC,MAAM,GAAG,IAAI,CAYf;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,GAAE,QAAuB,GAChC,MAAM,CA0BR;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,GAAE,QAAuB,GAChC,MAAM,CAaR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA2B/B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC"}