@ethlete/agent-rules 0.1.0-next.0

package/content/skills/verify-in-storybook/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: verify-in-storybook
+description: Visually/behaviorally verify a component change by driving its Storybook story headlessly with Playwright. Use whenever you change a UI component and need to confirm the rendered DOM, computed styles, animations, or interactions actually work - not just that it compiles.
+kind: skill
+scope: consumer
+vars: [storybookUrl, storybookStartCommand]
+---
+
+# Verify a component change in Storybook (headless Playwright)
+
+Storybook is the ground truth for component behaviour. Drive the real story in a
+headless browser and assert on the rendered DOM / computed styles, rather than
+trusting a build alone.
+
+## 1. Make sure Storybook is running
+
+It is usually already up. Check first - **do not blindly start a second
+instance**, it will hit an interactive port prompt and hang:
+
+```bash
+curl -s -o /dev/null -w "%{http_code}" {%storybookUrl%}/
+```
+
+- `200` → it's up, proceed.
+- anything else → start it in the background and wait for the port:
+  ```bash
+  {%storybookStartCommand%}
+  ```
+  Run it in the background and poll the curl above until it returns `200`
+  (a cold start can take 30–60s).
+
+## 2. Find the story ID
+
+Story IDs are derived from the story `title` + export name, e.g.
+`Components/Tabs/Inline` → `components-tabs-inline--default`. List them from the
+index:
+
+```bash
+curl -s {%storybookUrl%}/index.json \
+  | node -e "let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const j=JSON.parse(d);Object.values(j.entries).filter(s=>/YOURFILTER/i.test(s.title)).forEach(s=>console.log(s.id,'::',s.title,'::',s.name))})"
+```
+
+## 3. Open the story headlessly
+
+Render a single story in isolation via the **iframe URL** (no manager chrome):
+
+```
+{%storybookUrl%}/iframe.html?id=<story-id>&viewMode=story
+```
+
+## 4. Drive it with Playwright
+
+Playwright must be in the repo's devDependencies (`@playwright/test` /
+`playwright`). Write the script in a scratch directory, resolve Playwright from
+the repo's `node_modules`, and run it - {%resource:verify-template.mjs%} is a
+copy-paste starting point.
+
+Gotchas that will waste your time if you forget them:
+
+- **`playwright` is CommonJS.** In an `.mjs`, resolve it with `createRequire`
+  (as the template does) - a named `import { chromium } from 'playwright'` fails.
+- **Use `waitUntil: 'domcontentloaded'`**, never `networkidle` - Storybook's HMR
+  websocket keeps the connection open so `networkidle` times out forever.
+- **`waitForSelector` defaults to `state: 'visible'`.** Elements that are
+  correctly hidden (`visibility:hidden`, `opacity:0`, collapsed height, `inert`)
+  will never become "visible" and you'll get a misleading timeout. Use
+  `{ state: 'attached' }` when you intend to inspect a hidden element.
+- **Assert on the real signal.** Portal/`ng-content` text lands as text nodes, so
+  `childElementCount` is 0 even when content is present - check `el.textContent`.
+  Read computed styles with `getComputedStyle(el)` inside `page.$eval`.
+- After a click that triggers a CSS transition, `waitForTimeout(transitionMs + buffer)`
+  before reading final-state styles.
+
+## 5. Report
+
+State plainly what you drove and observed (collapsed→open→collapsed, tab switch,
+etc.) and whether it matched the expected behaviour. Keep the throwaway script in
+the scratch directory, not the repo.

package/content/skills/verify-in-storybook/verify-template.mjs

@@ -0,0 +1,42 @@
+// Headless Storybook verification template.
+// Copy into a scratch directory, adjust STORY_ID + the assertions, then run:
+//   node <scratch>/verify.mjs
+//
+// Playwright is CommonJS and lives in the repo's node_modules, so resolve it
+// through createRequire from the repo root rather than importing it by name.
+import { createRequire } from 'node:module';
+
+const require = createRequire(`${process.cwd()}/`);
+const { chromium } = require('playwright');
+
+const STORY_ID = 'components-button--default'; // <-- change me
+const url = `{%storybookUrl%}/iframe.html?viewMode=story&id=${STORY_ID}`;
+
+const browser = await chromium.launch(); // headless by default
+const page = await browser.newPage({ viewport: { width: 900, height: 700 } });
+
+// domcontentloaded, NOT networkidle (Storybook's HMR socket never goes idle)
+await page.goto(url, { waitUntil: 'domcontentloaded' });
+
+// state:'attached' so intentionally-hidden elements don't time out on 'visible'
+await page.waitForSelector('.et-some-component', { state: 'attached' });
+
+// Inspect rendered DOM + computed styles. textContent (not childElementCount)
+// is the reliable signal for ng-content / portal-projected text.
+const state = await page.$eval('.et-some-component', (el) => {
+  const cs = getComputedStyle(el);
+  return {
+    visibility: cs.visibility,
+    opacity: cs.opacity,
+    height: el.offsetHeight,
+    text: el.textContent.trim(),
+  };
+});
+console.log('state:', JSON.stringify(state));
+
+// Example interaction: click, wait out a CSS transition, re-read.
+// await page.click('.et-some-trigger');
+// await page.waitForTimeout(500); // >= transition duration
+// console.log('after:', JSON.stringify(await page.$eval('.et-some-component', ...)));
+
+await browser.close();

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@ethlete/agent-rules",
+  "version": "0.1.0-next.0",
+  "license": "MIT",
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "typings": "./src/index.d.ts",
+  "bin": {
+    "ethlete-agents": "./src/index.js"
+  },
+  "peerDependencies": {
+    "tslib": "2.8.1"
+  },
+  "types": "./src/index.d.ts"
+}

package/src/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export * from './lib';

package/src/index.js

@@ -0,0 +1,79 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const config_1 = require("./lib/config");
+const sync_1 = require("./lib/sync");
+const USAGE = `ethlete-agents — compile @ethlete agent rules and skills into your repo
+
+  ethlete-agents sync    Write the generated rules/skills for every detected agent
+  ethlete-agents check   Exit non-zero when the generated files are out of date (for CI)
+  ethlete-agents init    Write a starter ${config_1.CONFIG_FILE_NAME}
+
+Options
+  --targets <list>   Comma-separated subset of: ${config_1.AGENT_TARGETS.join(', ')}
+  --root <path>      Repo root to write into (default: current directory)
+  --dry-run          Print what sync would change without writing (sync only)
+`;
+const readFlag = (args, flag) => {
+    const index = args.indexOf(flag);
+    if (index === -1)
+        return undefined;
+    return args[index + 1];
+};
+const parseTargets = (args) => {
+    const raw = readFlag(args, '--targets');
+    if (!raw)
+        return undefined;
+    return raw.split(',').map((entry) => entry.trim());
+};
+const readVersion = () => {
+    const manifest = JSON.parse((0, fs_1.readFileSync)((0, path_1.join)(__dirname, '..', 'package.json'), 'utf8'));
+    return manifest.version;
+};
+const init = (root) => {
+    const path = (0, path_1.join)(root, config_1.CONFIG_FILE_NAME);
+    if ((0, fs_1.existsSync)(path)) {
+        console.error(`${config_1.CONFIG_FILE_NAME} already exists.`);
+        return 1;
+    }
+    const template = {
+        targets: (0, config_1.detectTargets)(root),
+        vars: {},
+        exclude: [],
+    };
+    (0, fs_1.writeFileSync)(path, `${JSON.stringify(template, null, 2)}\n`, 'utf8');
+    console.log(`Wrote ${config_1.CONFIG_FILE_NAME}. Fill in "vars" for your repo, then run \`ethlete-agents sync\`.`);
+    return 0;
+};
+const run = (argv) => {
+    var _a;
+    const command = argv[0];
+    const root = (_a = readFlag(argv, '--root')) !== null && _a !== void 0 ? _a : process.cwd();
+    const options = { root, version: readVersion(), targets: parseTargets(argv) };
+    switch (command) {
+        case 'sync':
+            return (0, sync_1.sync)(Object.assign(Object.assign({}, options), { dryRun: argv.includes('--dry-run') }));
+        case 'check':
+            return (0, sync_1.check)(options);
+        case 'init':
+            return init(root);
+        default:
+            console.log(USAGE);
+            return command === undefined || command === '--help' || command === '-h' ? 0 : 1;
+    }
+};
+tslib_1.__exportStar(require("./lib"), exports);
+// Guarded so the package can also be imported as a library without running the CLI.
+if (require.main === module) {
+    try {
+        process.exit(run(process.argv.slice(2)));
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../libs/agent-rules/src/index.ts"],"names":[],"mappings":"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"}

package/src/lib/config.d.ts

@@ -0,0 +1,21 @@
+import { ContentScope } from './frontmatter';
+export declare const AGENT_TARGETS: readonly ["claude", "codex", "cursor", "copilot"];
+export type AgentTarget = (typeof AGENT_TARGETS)[number];
+export declare const CONFIG_FILE_NAME = "ethlete-agents.config.json";
+export type SyncConfig = {
+    root: string;
+    targets: AgentTarget[];
+    /** Scopes to emit: a consumer repo wants `consumer` + `both`, the SDK repo only `both`. */
+    scopes: ContentScope[];
+    vars: Record<string, string | string[]>;
+    exclude: string[];
+};
+/**
+ * Emit for the agents a repo already uses. Everything falls back to Codex's `AGENTS.md`,
+ * which Cursor, Copilot and most other agents read as well.
+ */
+export declare const detectTargets: (root: string) => AgentTarget[];
+export declare const loadConfig: (options: {
+    root: string;
+    targetOverride?: AgentTarget[];
+}) => SyncConfig;

package/src/lib/config.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = exports.detectTargets = exports.CONFIG_FILE_NAME = exports.AGENT_TARGETS = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const load_content_1 = require("./load-content");
+exports.AGENT_TARGETS = ['claude', 'codex', 'cursor', 'copilot'];
+exports.CONFIG_FILE_NAME = 'ethlete-agents.config.json';
+const readRawConfig = (root) => {
+    const path = (0, path_1.join)(root, exports.CONFIG_FILE_NAME);
+    if (!(0, fs_1.existsSync)(path))
+        return {};
+    return JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
+};
+/**
+ * Emit for the agents a repo already uses. Everything falls back to Codex's `AGENTS.md`,
+ * which Cursor, Copilot and most other agents read as well.
+ */
+const detectTargets = (root) => {
+    const detected = [];
+    if ((0, fs_1.existsSync)((0, path_1.join)(root, '.claude')))
+        detected.push('claude');
+    if ((0, fs_1.existsSync)((0, path_1.join)(root, 'AGENTS.md')) || (0, fs_1.existsSync)((0, path_1.join)(root, '.codex')))
+        detected.push('codex');
+    if ((0, fs_1.existsSync)((0, path_1.join)(root, '.cursor')))
+        detected.push('cursor');
+    if ((0, fs_1.existsSync)((0, path_1.join)(root, '.github')))
+        detected.push('copilot');
+    return detected.length > 0 ? detected : ['codex'];
+};
+exports.detectTargets = detectTargets;
+const assertKnownTargets = (targets) => {
+    const unknown = targets.filter((target) => !exports.AGENT_TARGETS.includes(target));
+    if (unknown.length > 0) {
+        throw new Error(`Unknown target(s): ${unknown.join(', ')}. Known targets: ${exports.AGENT_TARGETS.join(', ')}.`);
+    }
+};
+const loadConfig = (options) => {
+    var _a, _b, _c;
+    const { root, targetOverride } = options;
+    const raw = readRawConfig(root);
+    const configured = raw.targets && raw.targets !== 'auto' ? raw.targets : undefined;
+    const targets = (_a = targetOverride !== null && targetOverride !== void 0 ? targetOverride : configured) !== null && _a !== void 0 ? _a : (0, exports.detectTargets)(root);
+    assertKnownTargets(targets);
+    return {
+        root,
+        targets,
+        scopes: raw.profile === 'sdk' ? ['both'] : ['consumer', 'both'],
+        vars: Object.assign(Object.assign({}, (0, load_content_1.loadDefaultVars)()), ((_b = raw.vars) !== null && _b !== void 0 ? _b : {})),
+        exclude: (_c = raw.exclude) !== null && _c !== void 0 ? _c : [],
+    };
+};
+exports.loadConfig = loadConfig;
+//# sourceMappingURL=config.js.map

package/src/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../libs/agent-rules/src/lib/config.ts"],"names":[],"mappings":"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"}

package/src/lib/filter.d.ts

@@ -0,0 +1,16 @@
+import { SyncConfig } from './config';
+import { ContentItem } from './load-content';
+export type SkippedItem = {
+    name: string;
+    reason: string;
+};
+export type FilterResult = {
+    kept: ContentItem[];
+    skipped: SkippedItem[];
+};
+/**
+ * A hoisted `node_modules` entry counts as installed even when the dependency is declared in a
+ * workspace package rather than at the root, so monorepo consumers are not silently filtered out.
+ */
+export declare const isPackageInstalled: (root: string, packageName: string) => boolean;
+export declare const filterContent: (items: ContentItem[], config: SyncConfig) => FilterResult;

package/src/lib/filter.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.filterContent = exports.isPackageInstalled = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * A hoisted `node_modules` entry counts as installed even when the dependency is declared in a
+ * workspace package rather than at the root, so monorepo consumers are not silently filtered out.
+ */
+const isPackageInstalled = (root, packageName) => {
+    if ((0, fs_1.existsSync)((0, path_1.join)(root, 'node_modules', ...packageName.split('/'))))
+        return true;
+    const manifestPath = (0, path_1.join)(root, 'package.json');
+    if (!(0, fs_1.existsSync)(manifestPath))
+        return false;
+    const manifest = JSON.parse((0, fs_1.readFileSync)(manifestPath, 'utf8'));
+    const declared = Object.assign(Object.assign(Object.assign({}, manifest.dependencies), manifest.devDependencies), manifest.peerDependencies);
+    return Object.prototype.hasOwnProperty.call(declared, packageName);
+};
+exports.isPackageInstalled = isPackageInstalled;
+const filterContent = (items, config) => {
+    const kept = [];
+    const skipped = [];
+    for (const item of items) {
+        const { name, scope, requires, vars } = item.frontmatter;
+        if (config.exclude.includes(name)) {
+            skipped.push({ name, reason: 'excluded by config' });
+            continue;
+        }
+        if (!config.scopes.includes(scope)) {
+            skipped.push({ name, reason: `scope "${scope}" is not emitted for this profile` });
+            continue;
+        }
+        const missingPackage = requires.find((packageName) => !(0, exports.isPackageInstalled)(config.root, packageName));
+        if (missingPackage) {
+            skipped.push({ name, reason: `requires ${missingPackage}, which is not installed` });
+            continue;
+        }
+        const missingVar = vars.find((varName) => config.vars[varName] === undefined);
+        if (missingVar) {
+            skipped.push({ name, reason: `needs the "${missingVar}" variable — set it in vars` });
+            continue;
+        }
+        kept.push(item);
+    }
+    return { kept, skipped };
+};
+exports.filterContent = filterContent;
+//# sourceMappingURL=filter.js.map

package/src/lib/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../../../libs/agent-rules/src/lib/filter.ts"],"names":[],"mappings":";;;AAAA,2BAA8C;AAC9C,+BAA4B;AAoB5B;;;GAGG;AACI,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAE,WAAmB,EAAE,EAAE;IACtE,IAAI,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,IAAI,EAAE,cAAc,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnF,MAAM,YAAY,GAAG,IAAA,WAAI,EAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAEhD,IAAI,CAAC,IAAA,eAAU,EAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC;IAE5C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,YAAY,EAAE,MAAM,CAAC,CAAoB,CAAC;IACnF,MAAM,QAAQ,iDACT,QAAQ,CAAC,YAAY,GACrB,QAAQ,CAAC,eAAe,GACxB,QAAQ,CAAC,gBAAgB,CAC7B,CAAC;IAEF,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AACrE,CAAC,CAAC;AAfW,QAAA,kBAAkB,sBAe7B;AAEK,MAAM,aAAa,GAAG,CAAC,KAAoB,EAAE,MAAkB,EAAgB,EAAE;IACtF,MAAM,IAAI,GAAkB,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;QAEzD,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;YACrD,SAAS;QACX,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACnC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,KAAK,mCAAmC,EAAE,CAAC,CAAC;YACnF,SAAS;QACX,CAAC;QAED,MAAM,cAAc,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAA,0BAAkB,EAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;QAErG,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,cAAc,0BAA0B,EAAE,CAAC,CAAC;YACrF,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC;QAE9E,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,UAAU,6BAA6B,EAAE,CAAC,CAAC;YACtF,SAAS;QACX,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC3B,CAAC,CAAC;AAnCW,QAAA,aAAa,iBAmCxB"}

package/src/lib/frontmatter.d.ts

@@ -0,0 +1,23 @@
+export declare const CONTENT_KINDS: readonly ["rule", "skill"];
+export declare const CONTENT_SCOPES: readonly ["consumer", "sdk", "both"];
+export type ContentKind = (typeof CONTENT_KINDS)[number];
+export type ContentScope = (typeof CONTENT_SCOPES)[number];
+export type Frontmatter = {
+    name: string;
+    description: string;
+    kind: ContentKind;
+    scope: ContentScope;
+    requires: string[];
+    paths: string[];
+    vars: string[];
+};
+export type ParsedDocument = {
+    frontmatter: Frontmatter;
+    body: string;
+};
+/**
+ * Reads the tiny subset of YAML the content files are allowed to use: single-line
+ * `key: value` pairs, inline `key: [a, b]` lists, and `- item` block lists. Anything
+ * else throws — silently mis-parsing an agent instruction is worse than failing the build.
+ */
+export declare const parseFrontmatter: (source: string, origin: string) => ParsedDocument;

package/src/lib/frontmatter.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseFrontmatter = exports.CONTENT_SCOPES = exports.CONTENT_KINDS = void 0;
+exports.CONTENT_KINDS = ['rule', 'skill'];
+exports.CONTENT_SCOPES = ['consumer', 'sdk', 'both'];
+const FENCE = '---';
+const KNOWN_KEYS = ['name', 'description', 'kind', 'scope', 'requires', 'paths', 'vars'];
+const LIST_KEYS = ['requires', 'paths', 'vars'];
+const unquote = (value) => {
+    const trimmed = value.trim();
+    const quoted = trimmed.length >= 2 &&
+        ((trimmed.startsWith("'") && trimmed.endsWith("'")) || (trimmed.startsWith('"') && trimmed.endsWith('"')));
+    return quoted ? trimmed.slice(1, -1) : trimmed;
+};
+const parseInlineList = (value) => {
+    const inner = value.trim().slice(1, -1).trim();
+    if (!inner)
+        return [];
+    return inner
+        .split(',')
+        .map(unquote)
+        .filter((entry) => entry.length > 0);
+};
+const splitBlock = (source, origin) => {
+    const normalized = source.replace(/\r\n/g, '\n');
+    const padded = normalized.endsWith('\n') ? normalized : `${normalized}\n`;
+    if (!padded.startsWith(`${FENCE}\n`)) {
+        throw new Error(`${origin}: missing the opening '---' frontmatter fence.`);
+    }
+    const end = padded.indexOf(`\n${FENCE}\n`, FENCE.length);
+    if (end === -1) {
+        throw new Error(`${origin}: the frontmatter block is never closed with '---'.`);
+    }
+    return {
+        head: padded.slice(FENCE.length + 1, end).split('\n'),
+        body: padded.slice(end + FENCE.length + 2).replace(/^\n+/, ''),
+    };
+};
+/**
+ * Reads the tiny subset of YAML the content files are allowed to use: single-line
+ * `key: value` pairs, inline `key: [a, b]` lists, and `- item` block lists. Anything
+ * else throws — silently mis-parsing an agent instruction is worse than failing the build.
+ */
+const parseFrontmatter = (source, origin) => {
+    var _a;
+    const { head, body } = splitBlock(source, origin);
+    const raw = {};
+    let listKey = null;
+    for (const line of head) {
+        if (!line.trim() || line.trim().startsWith('#'))
+            continue;
+        const item = /^\s*-\s+(.*)$/.exec(line);
+        if ((item === null || item === void 0 ? void 0 : item[1]) !== undefined) {
+            if (!listKey) {
+                throw new Error(`${origin}: list item "${line.trim()}" does not belong to a key.`);
+            }
+            raw[listKey].push(unquote(item[1]));
+            continue;
+        }
+        const separator = line.indexOf(':');
+        if (separator === -1) {
+            throw new Error(`${origin}: cannot parse frontmatter line "${line}".`);
+        }
+        const key = line.slice(0, separator).trim();
+        const value = line.slice(separator + 1).trim();
+        if (!KNOWN_KEYS.includes(key)) {
+            throw new Error(`${origin}: unknown frontmatter key "${key}". Known keys: ${KNOWN_KEYS.join(', ')}.`);
+        }
+        if (LIST_KEYS.includes(key) && !value) {
+            raw[key] = [];
+            listKey = key;
+            continue;
+        }
+        listKey = null;
+        raw[key] = value.startsWith('[') ? parseInlineList(value) : unquote(value);
+    }
+    const readText = (key) => {
+        const value = raw[key];
+        return typeof value === 'string' ? value : undefined;
+    };
+    const readList = (key) => {
+        const value = raw[key];
+        if (value === undefined)
+            return [];
+        return Array.isArray(value) ? value : [value];
+    };
+    const name = readText('name');
+    const description = readText('description');
+    const kind = readText('kind');
+    const scope = (_a = readText('scope')) !== null && _a !== void 0 ? _a : 'consumer';
+    if (!name)
+        throw new Error(`${origin}: frontmatter is missing "name".`);
+    if (!description)
+        throw new Error(`${origin}: frontmatter is missing "description".`);
+    if (!kind)
+        throw new Error(`${origin}: frontmatter is missing "kind".`);
+    if (!exports.CONTENT_KINDS.includes(kind)) {
+        throw new Error(`${origin}: kind "${kind}" must be one of ${exports.CONTENT_KINDS.join(', ')}.`);
+    }
+    if (!exports.CONTENT_SCOPES.includes(scope)) {
+        throw new Error(`${origin}: scope "${scope}" must be one of ${exports.CONTENT_SCOPES.join(', ')}.`);
+    }
+    return {
+        frontmatter: {
+            name,
+            description,
+            kind: kind,
+            scope: scope,
+            requires: readList('requires'),
+            paths: readList('paths'),
+            vars: readList('vars'),
+        },
+        body: body.trimEnd(),
+    };
+};
+exports.parseFrontmatter = parseFrontmatter;
+//# sourceMappingURL=frontmatter.js.map

package/src/lib/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../../../../libs/agent-rules/src/lib/frontmatter.ts"],"names":[],"mappings":"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"}

package/src/lib/index.d.ts

@@ -0,0 +1,9 @@
+export * from './config';
+export * from './filter';
+export * from './frontmatter';
+export * from './load-content';
+export * from './owned-paths';
+export * from './plan';
+export * from './render';
+export * from './sync';
+export * from './targets/shared';

package/src/lib/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./config"), exports);
+tslib_1.__exportStar(require("./filter"), exports);
+tslib_1.__exportStar(require("./frontmatter"), exports);
+tslib_1.__exportStar(require("./load-content"), exports);
+tslib_1.__exportStar(require("./owned-paths"), exports);
+tslib_1.__exportStar(require("./plan"), exports);
+tslib_1.__exportStar(require("./render"), exports);
+tslib_1.__exportStar(require("./sync"), exports);
+tslib_1.__exportStar(require("./targets/shared"), exports);
+//# sourceMappingURL=index.js.map

package/src/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/agent-rules/src/lib/index.ts"],"names":[],"mappings":";;;AAAA,mDAAyB;AACzB,mDAAyB;AACzB,wDAA8B;AAC9B,yDAA+B;AAC/B,wDAA8B;AAC9B,iDAAuB;AACvB,mDAAyB;AACzB,iDAAuB;AACvB,2DAAiC"}

package/src/lib/load-content.d.ts

@@ -0,0 +1,19 @@
+import { Frontmatter } from './frontmatter';
+export type ContentResource = {
+    /** File name as referenced from a body via `{{resource:…}}`. */
+    fileName: string;
+    absolutePath: string;
+};
+export type ContentItem = {
+    frontmatter: Frontmatter;
+    body: string;
+    sourcePath: string;
+    resources: ContentResource[];
+};
+/**
+ * The compiled CLI lives at `<pkg>/src/lib/`, the shipped markdown at `<pkg>/content/`.
+ * The same relative hop works from the TypeScript sources, so dev and published runs agree.
+ */
+export declare const resolveContentRoot: () => string;
+export declare const loadContent: (contentRoot?: string) => ContentItem[];
+export declare const loadDefaultVars: (contentRoot?: string) => Record<string, string | string[]>;