@ethlete/agent-rules 0.1.0-next.0

package/src/lib/load-content.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadDefaultVars = exports.loadContent = exports.resolveContentRoot = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const frontmatter_1 = require("./frontmatter");
+/**
+ * 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.
+ */
+const resolveContentRoot = () => (0, path_1.join)(__dirname, '..', '..', 'content');
+exports.resolveContentRoot = resolveContentRoot;
+const readMarkdown = (path) => (0, fs_1.readFileSync)(path, 'utf8');
+const loadRules = (contentRoot) => {
+    const dir = (0, path_1.join)(contentRoot, 'rules');
+    if (!(0, fs_1.existsSync)(dir))
+        return [];
+    return (0, fs_1.readdirSync)(dir)
+        .filter((entry) => entry.endsWith('.md'))
+        .sort()
+        .map((entry) => {
+        const sourcePath = (0, path_1.join)(dir, entry);
+        const { frontmatter, body } = (0, frontmatter_1.parseFrontmatter)(readMarkdown(sourcePath), `rules/${entry}`);
+        if (frontmatter.kind !== 'rule') {
+            throw new Error(`rules/${entry}: kind must be "rule" for a file under content/rules.`);
+        }
+        return { frontmatter, body, sourcePath, resources: [] };
+    });
+};
+const loadSkills = (contentRoot) => {
+    const dir = (0, path_1.join)(contentRoot, 'skills');
+    if (!(0, fs_1.existsSync)(dir))
+        return [];
+    return (0, fs_1.readdirSync)(dir)
+        .filter((entry) => (0, fs_1.statSync)((0, path_1.join)(dir, entry)).isDirectory())
+        .sort()
+        .map((entry) => {
+        const skillDir = (0, path_1.join)(dir, entry);
+        const sourcePath = (0, path_1.join)(skillDir, 'SKILL.md');
+        if (!(0, fs_1.existsSync)(sourcePath)) {
+            throw new Error(`skills/${entry}: directory has no SKILL.md.`);
+        }
+        const { frontmatter, body } = (0, frontmatter_1.parseFrontmatter)(readMarkdown(sourcePath), `skills/${entry}/SKILL.md`);
+        if (frontmatter.kind !== 'skill') {
+            throw new Error(`skills/${entry}/SKILL.md: kind must be "skill" for a file under content/skills.`);
+        }
+        if (frontmatter.name !== entry) {
+            throw new Error(`skills/${entry}/SKILL.md: frontmatter name "${frontmatter.name}" must match the folder.`);
+        }
+        const resources = (0, fs_1.readdirSync)(skillDir)
+            .filter((file) => file !== 'SKILL.md' && (0, fs_1.statSync)((0, path_1.join)(skillDir, file)).isFile())
+            .sort()
+            .map((file) => ({ fileName: file, absolutePath: (0, path_1.join)(skillDir, file) }));
+        return { frontmatter, body, sourcePath, resources };
+    });
+};
+const loadContent = (contentRoot = (0, exports.resolveContentRoot)()) => {
+    if (!(0, fs_1.existsSync)(contentRoot)) {
+        throw new Error(`Content directory not found at ${contentRoot}. The package build may be missing its assets.`);
+    }
+    const items = [...loadRules(contentRoot), ...loadSkills(contentRoot)];
+    const seen = new Set();
+    for (const item of items) {
+        if (seen.has(item.frontmatter.name)) {
+            throw new Error(`Duplicate content name "${item.frontmatter.name}" — names must be unique across rules and skills.`);
+        }
+        seen.add(item.frontmatter.name);
+    }
+    return items;
+};
+exports.loadContent = loadContent;
+const loadDefaultVars = (contentRoot = (0, exports.resolveContentRoot)()) => {
+    const path = (0, path_1.join)(contentRoot, 'defaults.json');
+    if (!(0, fs_1.existsSync)(path))
+        return {};
+    return JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
+};
+exports.loadDefaultVars = loadDefaultVars;
+//# sourceMappingURL=load-content.js.map

package/src/lib/load-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-content.js","sourceRoot":"","sources":["../../../../../libs/agent-rules/src/lib/load-content.ts"],"names":[],"mappings":";;;AAAA,2BAAqE;AACrE,+BAA4B;AAC5B,+CAA8D;AAe9D;;;GAGG;AACI,MAAM,kBAAkB,GAAG,GAAG,EAAE,CAAC,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAAlE,QAAA,kBAAkB,sBAAgD;AAE/E,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAA,iBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAElE,MAAM,SAAS,GAAG,CAAC,WAAmB,EAAE,EAAE;IACxC,MAAM,GAAG,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAEvC,IAAI,CAAC,IAAA,eAAU,EAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,OAAO,IAAA,gBAAW,EAAC,GAAG,CAAC;SACpB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SACxC,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,UAAU,GAAG,IAAA,WAAI,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACpC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,IAAA,8BAAgB,EAAC,YAAY,CAAC,UAAU,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC,CAAC;QAE3F,IAAI,WAAW,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,SAAS,KAAK,uDAAuD,CAAC,CAAC;QACzF,CAAC;QAED,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,WAAmB,EAAE,EAAE;IACzC,MAAM,GAAG,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAExC,IAAI,CAAC,IAAA,eAAU,EAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhC,OAAO,IAAA,gBAAW,EAAC,GAAG,CAAC;SACpB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,aAAQ,EAAC,IAAA,WAAI,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC3D,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAClC,MAAM,UAAU,GAAG,IAAA,WAAI,EAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAE9C,IAAI,CAAC,IAAA,eAAU,EAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,8BAA8B,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,IAAA,8BAAgB,EAAC,YAAY,CAAC,UAAU,CAAC,EAAE,UAAU,KAAK,WAAW,CAAC,CAAC;QAErG,IAAI,WAAW,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,kEAAkE,CAAC,CAAC;QACrG,CAAC;QAED,IAAI,WAAW,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,gCAAgC,WAAW,CAAC,IAAI,0BAA0B,CAAC,CAAC;QAC7G,CAAC;QAED,MAAM,SAAS,GAAG,IAAA,gBAAW,EAAC,QAAQ,CAAC;aACpC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,UAAU,IAAI,IAAA,aAAQ,EAAC,IAAA,WAAI,EAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aAChF,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,IAAA,WAAI,EAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAE3E,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;IACtD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEK,MAAM,WAAW,GAAG,CAAC,WAAW,GAAG,IAAA,0BAAkB,GAAE,EAAiB,EAAE;IAC/E,IAAI,CAAC,IAAA,eAAU,EAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,kCAAkC,WAAW,gDAAgD,CAAC,CAAC;IACjH,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,CAAC,WAAW,CAAC,IAAI,mDAAmD,CACpG,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAnBW,QAAA,WAAW,eAmBtB;AAEK,MAAM,eAAe,GAAG,CAAC,WAAW,GAAG,IAAA,0BAAkB,GAAE,EAAqC,EAAE;IACvG,MAAM,IAAI,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IAEhD,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAsC,CAAC;AACrF,CAAC,CAAC;AANW,QAAA,eAAe,mBAM1B"}

package/src/lib/owned-paths.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Everything the generator owns lives under an `ethlete` directory or an `ethlete-` prefix, so a
+ * file that disappears from the package can be pruned without ever touching a hand-written one.
+ * Marker-block files (`AGENTS.md`, `copilot-instructions.md`) are deliberately absent: those are
+ * shared with the repo and are only ever edited between the markers.
+ */
+export declare const collectOwnedPaths: (root: string) => string[];

package/src/lib/owned-paths.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectOwnedPaths = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const OWNED_DIRECTORIES = ['.agents/ethlete', '.claude/rules/ethlete'];
+const OWNED_PARENTS = [
+    { dir: '.claude/skills', match: (entry) => entry.startsWith('ethlete-') },
+    { dir: '.cursor/rules', match: (entry) => entry.startsWith('ethlete-') && entry.endsWith('.mdc') },
+    {
+        dir: '.github/instructions',
+        match: (entry) => entry.startsWith('ethlete-') && entry.endsWith('.instructions.md'),
+    },
+];
+const walk = (root, absoluteDir) => {
+    if (!(0, fs_1.existsSync)(absoluteDir))
+        return [];
+    return (0, fs_1.readdirSync)(absoluteDir).flatMap((entry) => {
+        const absolute = (0, path_1.join)(absoluteDir, entry);
+        if ((0, fs_1.statSync)(absolute).isDirectory())
+            return walk(root, absolute);
+        return [(0, path_1.relative)(root, absolute).split(path_1.sep).join('/')];
+    });
+};
+/**
+ * Everything the generator owns lives under an `ethlete` directory or an `ethlete-` prefix, so a
+ * file that disappears from the package can be pruned without ever touching a hand-written one.
+ * Marker-block files (`AGENTS.md`, `copilot-instructions.md`) are deliberately absent: those are
+ * shared with the repo and are only ever edited between the markers.
+ */
+const collectOwnedPaths = (root) => {
+    const owned = OWNED_DIRECTORIES.flatMap((dir) => walk(root, (0, path_1.join)(root, dir)));
+    for (const parent of OWNED_PARENTS) {
+        const absoluteParent = (0, path_1.join)(root, parent.dir);
+        if (!(0, fs_1.existsSync)(absoluteParent))
+            continue;
+        for (const entry of (0, fs_1.readdirSync)(absoluteParent)) {
+            if (!parent.match(entry))
+                continue;
+            const absolute = (0, path_1.join)(absoluteParent, entry);
+            owned.push(...((0, fs_1.statSync)(absolute).isDirectory() ? walk(root, absolute) : [`${parent.dir}/${entry}`]));
+        }
+    }
+    return owned;
+};
+exports.collectOwnedPaths = collectOwnedPaths;
+//# sourceMappingURL=owned-paths.js.map

package/src/lib/owned-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owned-paths.js","sourceRoot":"","sources":["../../../../../libs/agent-rules/src/lib/owned-paths.ts"],"names":[],"mappings":";;;AAAA,2BAAuD;AACvD,+BAA2C;AAE3C,MAAM,iBAAiB,GAAG,CAAC,iBAAiB,EAAE,uBAAuB,CAAC,CAAC;AACvE,MAAM,aAAa,GAAG;IACpB,EAAE,GAAG,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE;IACjF,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;IAC1G;QACE,GAAG,EAAE,sBAAsB;QAC3B,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC;KAC7F;CACF,CAAC;AAEF,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,WAAmB,EAAY,EAAE;IAC3D,IAAI,CAAC,IAAA,eAAU,EAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAC;IAExC,OAAO,IAAA,gBAAW,EAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QAChD,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAE1C,IAAI,IAAA,aAAQ,EAAC,QAAQ,CAAC,CAAC,WAAW,EAAE;YAAE,OAAO,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAElE,OAAO,CAAC,IAAA,eAAQ,EAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,UAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;;GAKG;AACI,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAE,EAAE;IAChD,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAA,WAAI,EAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IAE9E,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,MAAM,cAAc,GAAG,IAAA,WAAI,EAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QAE9C,IAAI,CAAC,IAAA,eAAU,EAAC,cAAc,CAAC;YAAE,SAAS;QAE1C,KAAK,MAAM,KAAK,IAAI,IAAA,gBAAW,EAAC,cAAc,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;gBAAE,SAAS;YAEnC,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,cAAc,EAAE,KAAK,CAAC,CAAC;YAE7C,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAA,aAAQ,EAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QACxG,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAlBW,QAAA,iBAAiB,qBAkB5B"}

package/src/lib/plan.d.ts

@@ -0,0 +1,20 @@
+import { SyncConfig } from './config';
+import { SkippedItem } from './filter';
+import { EmittedFile } from './targets/shared';
+export type SyncPlan = {
+    files: EmittedFile[];
+    skipped: SkippedItem[];
+    /** Cross-references whose target was filtered out of this repo; rendered as a bare name. */
+    danglingLinks: {
+        from: string;
+        to: string;
+    }[];
+};
+/**
+ * Resolves the full set of files a sync would write, without touching disk — `sync` writes the
+ * result and `check` diffs it.
+ */
+export declare const buildPlan: (options: {
+    config: SyncConfig;
+    version: string;
+}) => SyncPlan;

package/src/lib/plan.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPlan = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const filter_1 = require("./filter");
+const load_content_1 = require("./load-content");
+const claude_1 = require("./targets/claude");
+const codex_1 = require("./targets/codex");
+const copilot_1 = require("./targets/copilot");
+const cursor_1 = require("./targets/cursor");
+const neutral_1 = require("./targets/neutral");
+const SKILL_LINK_PATTERN = /\{%\s*skill:([a-zA-Z0-9_.-]+)\s*%\}/g;
+const findDanglingLinks = (items, emittedSkills) => items.flatMap((item) => [...item.body.matchAll(SKILL_LINK_PATTERN)]
+    .map((match) => match[1])
+    .filter((name) => !emittedSkills.has(name))
+    .map((name) => ({ from: item.frontmatter.name, to: name })));
+const readExisting = (root, relativePath) => {
+    const path = (0, path_1.join)(root, relativePath);
+    return (0, fs_1.existsSync)(path) ? (0, fs_1.readFileSync)(path, 'utf8') : '';
+};
+/**
+ * Resolves the full set of files a sync would write, without touching disk — `sync` writes the
+ * result and `check` diffs it.
+ */
+const buildPlan = (options) => {
+    const { config, version } = options;
+    const { kept, skipped } = (0, filter_1.filterContent)((0, load_content_1.loadContent)(), config);
+    const skills = kept.filter((item) => item.frontmatter.kind === 'skill');
+    const emittedSkills = new Set(skills.map((item) => item.frontmatter.name));
+    const context = {
+        rules: kept.filter((item) => item.frontmatter.kind === 'rule'),
+        skills,
+        emittedSkills,
+        vars: config.vars,
+        version,
+    };
+    const files = [];
+    // Codex, Cursor and Copilot all resolve resource files (and, where they have no on-demand
+    // mechanism, whole skills) out of the neutral tree.
+    if (config.targets.some((target) => target !== 'claude')) {
+        files.push(...(0, neutral_1.emitNeutral)(context));
+    }
+    if (config.targets.includes('claude'))
+        files.push(...(0, claude_1.emitClaude)(context));
+    if (config.targets.includes('cursor'))
+        files.push(...(0, cursor_1.emitCursor)(context));
+    if (config.targets.includes('codex')) {
+        files.push(...(0, codex_1.emitCodex)({ context, existing: readExisting(config.root, codex_1.CODEX_FILE) }));
+    }
+    if (config.targets.includes('copilot')) {
+        files.push(...(0, copilot_1.emitCopilot)({ context, existing: readExisting(config.root, copilot_1.COPILOT_FILE) }));
+    }
+    return { files, skipped, danglingLinks: findDanglingLinks(kept, emittedSkills) };
+};
+exports.buildPlan = buildPlan;
+//# sourceMappingURL=plan.js.map

package/src/lib/plan.js.map

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

package/src/lib/render.d.ts

@@ -0,0 +1,39 @@
+import { ContentItem } from './load-content';
+/**
+ * Bodies reference sibling content through tokens rather than hardcoded paths, because the same
+ * skill is a namespaced skill under Claude, an `.mdc` rule under Cursor and a plain file path
+ * under Codex. Each target supplies its own resolver.
+ */
+export type LinkResolver = {
+    skill: (name: string) => string;
+    resource: (options: {
+        skillName: string;
+        fileName: string;
+    }) => string;
+};
+export declare const START_MARKER = "<!-- ethlete:agent-rules:start -->";
+export declare const END_MARKER = "<!-- ethlete:agent-rules:end -->";
+export declare const buildBanner: (version: string) => string;
+export declare const renderBody: (options: {
+    item: ContentItem;
+    vars: Record<string, string | string[]>;
+    links: LinkResolver;
+}) => string;
+/** Variable substitution only — for text that has no business linking to other content. */
+export declare const substituteVars: (options: {
+    text: string;
+    vars: Record<string, string | string[]>;
+    origin: string;
+}) => string;
+export declare const renderDescription: (options: {
+    item: ContentItem;
+    vars: Record<string, string | string[]>;
+}) => string;
+/**
+ * Rewrites the block between the markers, leaving everything a repo wrote around it untouched.
+ * A file without markers gets the block appended.
+ */
+export declare const replaceMarkedBlock: (options: {
+    existing: string;
+    block: string;
+}) => string;

package/src/lib/render.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.replaceMarkedBlock = exports.renderDescription = exports.substituteVars = exports.renderBody = exports.buildBanner = exports.END_MARKER = exports.START_MARKER = void 0;
+/**
+ * `{% … %}`, not `{{ … }}`: content bodies routinely quote Angular templates, and an example
+ * containing `{{ count() }}` must not be mistaken for a template token.
+ */
+const TOKEN_PATTERN = /\{%\s*([a-zA-Z0-9_:.-]+)\s*%\}/g;
+exports.START_MARKER = '<!-- ethlete:agent-rules:start -->';
+exports.END_MARKER = '<!-- ethlete:agent-rules:end -->';
+const buildBanner = (version) => `<!-- Generated by @ethlete/agent-rules v${version} — DO NOT EDIT. Run \`npx ethlete-agents sync\`. -->`;
+exports.buildBanner = buildBanner;
+const renderValue = (value) => Array.isArray(value) ? value.map((entry) => `\`${entry}\``).join(', ') : value;
+const renderBody = (options) => {
+    const { item, vars, links } = options;
+    const rendered = item.body.replace(TOKEN_PATTERN, (match, token) => {
+        const [namespace, argument] = token.split(':');
+        if (namespace === 'skill' && argument)
+            return links.skill(argument);
+        if (namespace === 'resource' && argument) {
+            return links.resource({ skillName: item.frontmatter.name, fileName: argument });
+        }
+        const value = vars[token];
+        if (value === undefined) {
+            throw new Error(`${item.frontmatter.name}: no value for template token "${match}".`);
+        }
+        return renderValue(value);
+    });
+    const leftover = /\{%[^%]*%\}/.exec(rendered);
+    if (leftover) {
+        throw new Error(`${item.frontmatter.name}: unresolved template token "${leftover[0]}".`);
+    }
+    return rendered;
+};
+exports.renderBody = renderBody;
+/** Variable substitution only — for text that has no business linking to other content. */
+const substituteVars = (options) => {
+    const { text, vars, origin } = options;
+    return text.replace(TOKEN_PATTERN, (match, token) => {
+        if (token.includes(':')) {
+            throw new Error(`${origin}: "${match}" — skill and resource links only work in a SKILL.md body.`);
+        }
+        const value = vars[token];
+        if (value === undefined) {
+            throw new Error(`${origin}: no value for template token "${match}".`);
+        }
+        return renderValue(value);
+    });
+};
+exports.substituteVars = substituteVars;
+const renderDescription = (options) => (0, exports.substituteVars)({
+    text: options.item.frontmatter.description,
+    vars: options.vars,
+    origin: `${options.item.frontmatter.name} (description)`,
+});
+exports.renderDescription = renderDescription;
+/**
+ * Rewrites the block between the markers, leaving everything a repo wrote around it untouched.
+ * A file without markers gets the block appended.
+ */
+const replaceMarkedBlock = (options) => {
+    const { existing, block } = options;
+    const wrapped = `${exports.START_MARKER}\n${block}\n${exports.END_MARKER}`;
+    const start = existing.indexOf(exports.START_MARKER);
+    const end = existing.indexOf(exports.END_MARKER);
+    if (start === -1 || end === -1 || end < start) {
+        const separator = existing.trim().length > 0 ? `${existing.trimEnd()}\n\n` : '';
+        return `${separator}${wrapped}\n`;
+    }
+    return `${existing.slice(0, start)}${wrapped}${existing.slice(end + exports.END_MARKER.length)}`;
+};
+exports.replaceMarkedBlock = replaceMarkedBlock;
+//# sourceMappingURL=render.js.map

package/src/lib/render.js.map

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

package/src/lib/sync.d.ts

@@ -0,0 +1,9 @@
+import { AgentTarget } from './config';
+export type RunOptions = {
+    root: string;
+    version: string;
+    targets?: AgentTarget[];
+    dryRun?: boolean;
+};
+export declare const sync: (options: RunOptions) => number;
+export declare const check: (options: RunOptions) => 1 | 0;

package/src/lib/sync.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.check = exports.sync = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const config_1 = require("./config");
+const owned_paths_1 = require("./owned-paths");
+const plan_1 = require("./plan");
+const readIfPresent = (absolute) => ((0, fs_1.existsSync)(absolute) ? (0, fs_1.readFileSync)(absolute, 'utf8') : null);
+const diffPlan = (options) => {
+    const { root, files, owned } = options;
+    const planned = new Set(files.map((file) => file.path));
+    const changes = [];
+    for (const file of files) {
+        const current = readIfPresent((0, path_1.join)(root, file.path));
+        if (current === file.contents)
+            continue;
+        changes.push({ path: file.path, action: current === null ? 'write' : 'update' });
+    }
+    for (const path of owned) {
+        if (!planned.has(path))
+            changes.push({ path, action: 'delete' });
+    }
+    return changes;
+};
+/** Removing the last generated file from a skill folder must not leave the folder behind. */
+const pruneEmptyDirs = (options) => {
+    let current = (0, path_1.dirname)(options.from);
+    while (current.startsWith(options.root) && (0, path_1.relative)(options.root, current) !== '') {
+        if (!(0, fs_1.existsSync)(current) || (0, fs_1.readdirSync)(current).length > 0)
+            return;
+        (0, fs_1.rmdirSync)(current);
+        current = (0, path_1.dirname)(current);
+    }
+};
+const describe = (change) => {
+    const label = { write: 'create', update: 'update', delete: 'remove' }[change.action];
+    return `  ${label} ${change.path}`;
+};
+const sync = (options) => {
+    const config = (0, config_1.loadConfig)({ root: options.root, targetOverride: options.targets });
+    const { files, skipped, danglingLinks } = (0, plan_1.buildPlan)({ config, version: options.version });
+    const changes = diffPlan({ root: options.root, files, owned: (0, owned_paths_1.collectOwnedPaths)(options.root) });
+    console.log(`Targets: ${config.targets.join(', ')}`);
+    for (const entry of skipped) {
+        console.log(`  skip   ${entry.name} — ${entry.reason}`);
+    }
+    for (const link of danglingLinks) {
+        console.log(`  note   ${link.from} references "${link.to}", which is not emitted here — rendered as plain text`);
+    }
+    if (changes.length === 0) {
+        console.log('Everything is already up to date.');
+        return 0;
+    }
+    changes.forEach((change) => console.log(describe(change)));
+    if (options.dryRun) {
+        console.log(`\n${changes.length} file(s) would change. Re-run without --dry-run to apply.`);
+        return 0;
+    }
+    for (const file of files) {
+        const absolute = (0, path_1.join)(options.root, file.path);
+        (0, fs_1.mkdirSync)((0, path_1.dirname)(absolute), { recursive: true });
+        (0, fs_1.writeFileSync)(absolute, file.contents, 'utf8');
+    }
+    for (const change of changes) {
+        if (change.action !== 'delete')
+            continue;
+        const absolute = (0, path_1.join)(options.root, change.path);
+        (0, fs_1.rmSync)(absolute, { force: true });
+        pruneEmptyDirs({ root: options.root, from: absolute });
+    }
+    console.log(`\n${changes.length} file(s) written.`);
+    return 0;
+};
+exports.sync = sync;
+const check = (options) => {
+    const config = (0, config_1.loadConfig)({ root: options.root, targetOverride: options.targets });
+    const { files } = (0, plan_1.buildPlan)({ config, version: options.version });
+    const changes = diffPlan({ root: options.root, files, owned: (0, owned_paths_1.collectOwnedPaths)(options.root) });
+    if (changes.length === 0) {
+        console.log('Agent rules are in sync.');
+        return 0;
+    }
+    console.error('Agent rules are out of sync with @ethlete/agent-rules:');
+    changes.forEach((change) => console.error(describe(change)));
+    console.error('\nRun `npx ethlete-agents sync` and commit the result.');
+    return 1;
+};
+exports.check = check;
+//# sourceMappingURL=sync.js.map

package/src/lib/sync.js.map

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

package/src/lib/targets/claude.d.ts

@@ -0,0 +1,7 @@
+import { EmitContext, EmittedFile } from './shared';
+/**
+ * Rules land in `.claude/rules/ethlete/` (loaded every session, or only for matching files when
+ * the content declares `paths`); skills land in `.claude/skills/` under an `ethlete-` prefix so a
+ * generated skill can never collide with one the repo wrote itself.
+ */
+export declare const emitClaude: (context: EmitContext) => EmittedFile[];

package/src/lib/targets/claude.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitClaude = void 0;
+const render_1 = require("../render");
+const shared_1 = require("./shared");
+const skillDir = (name) => `.claude/skills/ethlete-${name}`;
+const quoteList = (values) => values.map((value) => `  - '${value}'`).join('\n');
+/**
+ * Rules land in `.claude/rules/ethlete/` (loaded every session, or only for matching files when
+ * the content declares `paths`); skills land in `.claude/skills/` under an `ethlete-` prefix so a
+ * generated skill can never collide with one the repo wrote itself.
+ */
+const emitClaude = (context) => {
+    const banner = (0, render_1.buildBanner)(context.version);
+    const links = (0, shared_1.makeLinks)({
+        context,
+        skill: (name) => `the **\`ethlete-${name}\`** skill`,
+        resource: (target) => `\`${target.fileName}\` (bundled next to this skill)`,
+    });
+    const files = [];
+    for (const item of context.rules) {
+        const { name, paths } = item.frontmatter;
+        const frontmatter = paths.length > 0 ? `---\npaths:\n${quoteList(paths)}\n---` : '';
+        files.push({
+            path: `.claude/rules/ethlete/${name}.md`,
+            contents: (0, shared_1.document)([frontmatter, banner, (0, shared_1.body)({ item, context, links })]),
+        });
+    }
+    for (const item of context.skills) {
+        const { name } = item.frontmatter;
+        const frontmatter = [
+            '---',
+            `name: ethlete-${name}`,
+            `description: ${(0, shared_1.yamlString)((0, shared_1.description)({ item, context }))}`,
+            '---',
+        ].join('\n');
+        files.push({
+            path: `${skillDir(name)}/SKILL.md`,
+            contents: (0, shared_1.document)([frontmatter, banner, (0, shared_1.body)({ item, context, links })]),
+        });
+        files.push(...(0, shared_1.resourceFiles)({ item, context, pathFor: (fileName) => `${skillDir(name)}/${fileName}` }));
+    }
+    return files;
+};
+exports.emitClaude = emitClaude;
+//# sourceMappingURL=claude.js.map

package/src/lib/targets/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../../../../../libs/agent-rules/src/lib/targets/claude.ts"],"names":[],"mappings":";;;AAAA,sCAAwC;AACxC,qCAAuH;AAEvH,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,0BAA0B,IAAI,EAAE,CAAC;AAEpE,MAAM,SAAS,GAAG,CAAC,MAAgB,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE3F;;;;GAIG;AACI,MAAM,UAAU,GAAG,CAAC,OAAoB,EAAiB,EAAE;IAChE,MAAM,MAAM,GAAG,IAAA,oBAAW,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAA,kBAAS,EAAC;QACtB,OAAO;QACP,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,IAAI,YAAY;QACpD,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,MAAM,CAAC,QAAQ,iCAAiC;KAC5E,CAAC,CAAC;IACH,MAAM,KAAK,GAAkB,EAAE,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACjC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;QACzC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAEpF,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,yBAAyB,IAAI,KAAK;YACxC,QAAQ,EAAE,IAAA,iBAAQ,EAAC,CAAC,WAAW,EAAE,MAAM,EAAE,IAAA,aAAI,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;SAC1E,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;QAClC,MAAM,WAAW,GAAG;YAClB,KAAK;YACL,iBAAiB,IAAI,EAAE;YACvB,gBAAgB,IAAA,mBAAU,EAAC,IAAA,oBAAW,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE;YAC5D,KAAK;SACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW;YAClC,QAAQ,EAAE,IAAA,iBAAQ,EAAC,CAAC,WAAW,EAAE,MAAM,EAAE,IAAA,aAAI,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;SAC1E,CAAC,CAAC;QAEH,KAAK,CAAC,IAAI,CAAC,GAAG,IAAA,sBAAa,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1G,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AArCW,QAAA,UAAU,cAqCrB"}

package/src/lib/targets/codex.d.ts

@@ -0,0 +1,11 @@
+import { EmitContext, EmittedFile } from './shared';
+export declare const CODEX_FILE = "AGENTS.md";
+/**
+ * `AGENTS.md` supports neither frontmatter nor includes, so the always-loaded rules are inlined and
+ * the on-demand skills become a manifest of paths into `.agents/ethlete/` (emitted separately by the
+ * neutral target). Everything outside the marker block is left as the repo wrote it.
+ */
+export declare const emitCodex: (options: {
+    context: EmitContext;
+    existing: string;
+}) => EmittedFile[];

package/src/lib/targets/codex.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitCodex = exports.CODEX_FILE = void 0;
+const render_1 = require("../render");
+const shared_1 = require("./shared");
+exports.CODEX_FILE = 'AGENTS.md';
+/**
+ * `AGENTS.md` supports neither frontmatter nor includes, so the always-loaded rules are inlined and
+ * the on-demand skills become a manifest of paths into `.agents/ethlete/` (emitted separately by the
+ * neutral target). Everything outside the marker block is left as the repo wrote it.
+ */
+const emitCodex = (options) => {
+    const { context, existing } = options;
+    const sections = context.rules.map((item) => (0, shared_1.body)({ item, context, links: (0, shared_1.neutralLinks)(context) }));
+    if (context.skills.length > 0) {
+        sections.push([
+            '## Ethlete reference docs',
+            'Read the matching file before starting that kind of work — do not work from memory.',
+            (0, shared_1.pointerTable)({ skills: context.skills, context, pathFor: shared_1.neutralBodyPath }),
+        ].join('\n\n'));
+    }
+    const block = (0, shared_1.document)([(0, render_1.buildBanner)(context.version), ...sections]).trimEnd();
+    return [{ path: exports.CODEX_FILE, contents: (0, render_1.replaceMarkedBlock)({ existing, block }) }];
+};
+exports.emitCodex = emitCodex;
+//# sourceMappingURL=codex.js.map

package/src/lib/targets/codex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../../../../../libs/agent-rules/src/lib/targets/codex.ts"],"names":[],"mappings":";;;AAAA,sCAA4D;AAC5D,qCAAiH;AAEpG,QAAA,UAAU,GAAG,WAAW,CAAC;AAEtC;;;;GAIG;AACI,MAAM,SAAS,GAAG,CAAC,OAAmD,EAAiB,EAAE;IAC9F,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,aAAI,EAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAA,qBAAY,EAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAEpG,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CACX;YACE,2BAA2B;YAC3B,qFAAqF;YACrF,IAAA,qBAAY,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,wBAAe,EAAE,CAAC;SAC5E,CAAC,IAAI,CAAC,MAAM,CAAC,CACf,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,IAAA,iBAAQ,EAAC,CAAC,IAAA,oBAAW,EAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAE9E,OAAO,CAAC,EAAE,IAAI,EAAE,kBAAU,EAAE,QAAQ,EAAE,IAAA,2BAAkB,EAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;AACnF,CAAC,CAAC;AAjBW,QAAA,SAAS,aAiBpB"}

package/src/lib/targets/copilot.d.ts

@@ -0,0 +1,11 @@
+import { EmitContext, EmittedFile } from './shared';
+export declare const COPILOT_FILE = ".github/copilot-instructions.md";
+/**
+ * Copilot can scope an instruction file to a glob but has no way to load one on description alone,
+ * so a skill with `paths` becomes a real `.instructions.md` and everything else falls back to a
+ * manifest pointer in the always-loaded file.
+ */
+export declare const emitCopilot: (options: {
+    context: EmitContext;
+    existing: string;
+}) => EmittedFile[];

package/src/lib/targets/copilot.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emitCopilot = exports.COPILOT_FILE = void 0;
+const render_1 = require("../render");
+const shared_1 = require("./shared");
+exports.COPILOT_FILE = '.github/copilot-instructions.md';
+/**
+ * Copilot can scope an instruction file to a glob but has no way to load one on description alone,
+ * so a skill with `paths` becomes a real `.instructions.md` and everything else falls back to a
+ * manifest pointer in the always-loaded file.
+ */
+const emitCopilot = (options) => {
+    const { context, existing } = options;
+    const banner = (0, render_1.buildBanner)(context.version);
+    const links = (0, shared_1.makeLinks)({
+        context,
+        skill: (name) => `\`${(0, shared_1.neutralBodyPath)(name)}\``,
+        resource: (target) => `\`${(0, shared_1.neutralResourcePath)(target)}\``,
+    });
+    const files = [];
+    const scoped = context.skills.filter((item) => item.frontmatter.paths.length > 0);
+    const unscoped = context.skills.filter((item) => item.frontmatter.paths.length === 0);
+    for (const item of scoped) {
+        const frontmatter = ['---', `applyTo: ${(0, shared_1.yamlString)(item.frontmatter.paths.join(','))}`, '---'].join('\n');
+        files.push({
+            path: `.github/instructions/ethlete-${item.frontmatter.name}.instructions.md`,
+            contents: (0, shared_1.document)([frontmatter, banner, (0, shared_1.body)({ item, context, links })]),
+        });
+    }
+    const sections = context.rules.map((item) => (0, shared_1.body)({ item, context, links }));
+    if (unscoped.length > 0) {
+        sections.push([
+            '## Ethlete reference docs',
+            'Read the matching file before starting that kind of work — do not work from memory.',
+            (0, shared_1.pointerTable)({ skills: unscoped, context, pathFor: shared_1.neutralBodyPath }),
+        ].join('\n\n'));
+    }
+    const block = (0, shared_1.document)([banner, ...sections]).trimEnd();
+    files.push({ path: exports.COPILOT_FILE, contents: (0, render_1.replaceMarkedBlock)({ existing, block }) });
+    return files;
+};
+exports.emitCopilot = emitCopilot;
+//# sourceMappingURL=copilot.js.map