@ethlete/agent-rules 0.1.0-next.3 → 0.1.0-next.30

package/src/lib/output-style-command.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.outputStyleCommand = void 0;
+const output_style_1 = require("./output-style");
+const FLAGS_WITH_VALUE = ['--config-dir'];
+const positionalArgs = (args) => args.filter((entry, index) => { var _a; return !entry.startsWith('--') && !FLAGS_WITH_VALUE.includes((_a = args[index - 1]) !== null && _a !== void 0 ? _a : ''); });
+const flagValue = (args, flag) => {
+    const index = args.indexOf(flag);
+    return index === -1 ? undefined : args[index + 1];
+};
+const usage = () => `ethlete-agents output-style — install an Ethlete output style into Claude Code
+
+An output style replaces Claude Code's own answer style for every session, so it is written
+into the machine's Claude config rather than into a repository.
+
+  output-style [name]     Install the style and switch Claude Code to it
+                          (default: ${output_style_1.DEFAULT_OUTPUT_STYLE})
+
+Options
+  --no-activate        Write the file, but leave "outputStyle" in settings.json alone
+  --remove             Delete the style file and stop using it
+  --force              Overwrite (or delete) a style file this command did not write
+  --dry-run            Print what would change without writing
+  --config-dir <path>  Claude's config directory (default: $CLAUDE_CONFIG_DIR, else ~/.claude)
+
+Ships: ${(0, output_style_1.availableOutputStyles)().join(', ') || 'nothing'}
+
+Claude Code only. Codex has no output-style mechanism - everything it is told comes from
+AGENTS.md, which \`ethlete-agents sync\` already writes.
+`;
+const describe = (file) => `  ${file.action.padEnd(6)} ${file.path}`;
+const outputStyleCommand = (options) => {
+    const { argv } = options;
+    if (argv.includes('--help') || argv.includes('-h')) {
+        console.log(usage());
+        return 0;
+    }
+    const plan = (0, output_style_1.planOutputStyle)({
+        name: positionalArgs(argv)[0],
+        configDir: flagValue(argv, '--config-dir'),
+        activate: !argv.includes('--no-activate'),
+        remove: argv.includes('--remove'),
+        force: argv.includes('--force'),
+    });
+    console.log(`Style   ${plan.name}`);
+    console.log(`Config  ${plan.configDir}`);
+    if (plan.conflict) {
+        console.error(plan.conflict);
+        return 1;
+    }
+    if (plan.files.length === 0) {
+        console.log(argv.includes('--remove') ? 'It is not installed here.' : 'Already installed and in use.');
+        return 0;
+    }
+    plan.files.forEach((file) => console.log(describe(file)));
+    if (argv.includes('--dry-run')) {
+        console.log(`\n${plan.files.length} file(s) would change. Re-run without --dry-run to apply.`);
+        return 0;
+    }
+    (0, output_style_1.applyOutputStylePlan)(plan);
+    if (argv.includes('--remove')) {
+        console.log('\nRemoved. A session that is already open keeps the style until it restarts.');
+        return 0;
+    }
+    console.log(`\nInstalled. Start a new session, or run \`/output-style ${plan.name}\`, to use it.`);
+    return 0;
+};
+exports.outputStyleCommand = outputStyleCommand;
+//# sourceMappingURL=output-style-command.js.map

package/src/lib/output-style-command.js.map

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

package/src/lib/output-style.d.ts

@@ -0,0 +1,38 @@
+export declare const DEFAULT_OUTPUT_STYLE = "ste-clarity";
+/** Claude Code reads `~/.claude`, or `CLAUDE_CONFIG_DIR` when it is set; an explicit path wins over both. */
+export declare const resolveClaudeConfigDir: (override?: string) => string;
+export declare const availableOutputStyles: (contentRoot?: string) => string[];
+/** `contents` is `null` exactly when the action is `remove`. */
+export type PlannedOutputStyleFile = {
+    path: string;
+    action: 'create' | 'update' | 'remove';
+    contents: string | null;
+};
+export type OutputStylePlan = {
+    name: string;
+    configDir: string;
+    stylePath: string;
+    settingsPath: string;
+    /** The style Claude Code is set to now, before this plan is applied. */
+    activeStyle: string | null;
+    files: PlannedOutputStyleFile[];
+    /** Set when the installed file is not this command's own; nothing is planned until `force`. */
+    conflict: string | null;
+};
+export type OutputStyleOptions = {
+    name?: string;
+    configDir?: string;
+    /** Also point `outputStyle` in `settings.json` at the style (default). */
+    activate?: boolean;
+    remove?: boolean;
+    /** Overwrite or delete a style file this command did not write. */
+    force?: boolean;
+    contentRoot?: string;
+};
+/**
+ * What an install (or a `remove`) would write into Claude Code's user config, without touching
+ * disk. A style file that someone else wrote is reported as a conflict rather than overwritten -
+ * the name is a plain file name, so a hand-written style can carry it.
+ */
+export declare const planOutputStyle: (options?: OutputStyleOptions) => OutputStylePlan;
+export declare const applyOutputStylePlan: (plan: OutputStylePlan) => void;

package/src/lib/output-style.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyOutputStylePlan = exports.planOutputStyle = exports.availableOutputStyles = exports.resolveClaudeConfigDir = exports.DEFAULT_OUTPUT_STYLE = void 0;
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const load_content_1 = require("./load-content");
+exports.DEFAULT_OUTPUT_STYLE = 'ste-clarity';
+const CONTENT_DIR = 'output-styles';
+const MARKER_PREFIX = '<!-- @ethlete/agent-rules output style';
+const marker = (name) => `${MARKER_PREFIX} "${name}" — installed by \`ethlete-agents output-style\`. Re-run it to update; edits here are overwritten. -->`;
+/** Claude Code reads `~/.claude`, or `CLAUDE_CONFIG_DIR` when it is set; an explicit path wins over both. */
+const resolveClaudeConfigDir = (override) => { var _a; return (override === null || override === void 0 ? void 0 : override.trim()) || ((_a = process.env['CLAUDE_CONFIG_DIR']) === null || _a === void 0 ? void 0 : _a.trim()) || (0, path_1.join)((0, os_1.homedir)(), '.claude'); };
+exports.resolveClaudeConfigDir = resolveClaudeConfigDir;
+const availableOutputStyles = (contentRoot = (0, load_content_1.resolveContentRoot)()) => {
+    const dir = (0, path_1.join)(contentRoot, CONTENT_DIR);
+    if (!(0, fs_1.existsSync)(dir))
+        return [];
+    return (0, fs_1.readdirSync)(dir)
+        .filter((entry) => entry.endsWith('.md'))
+        .map((entry) => entry.slice(0, -'.md'.length))
+        .sort();
+};
+exports.availableOutputStyles = availableOutputStyles;
+const FRONTMATTER = /^(---\n[\s\S]*?\n---)\n?([\s\S]*)$/;
+/**
+ * The marker sits after the frontmatter, never before it: Claude Code only reads a style's `name`
+ * and `description` when the file opens with the fence.
+ */
+const withMarker = (raw, name) => {
+    var _a;
+    const source = raw.replace(/\r\n/g, '\n').trim();
+    const parts = FRONTMATTER.exec(source);
+    if (!parts)
+        return `${marker(name)}\n\n${source}\n`;
+    return `${parts[1]}\n\n${marker(name)}\n\n${((_a = parts[2]) !== null && _a !== void 0 ? _a : '').trim()}\n`;
+};
+/**
+ * Two files count as the same style when they hold the same text in any layout, so a copy that
+ * predates the marker is still recognised as this command's own. Whitespace and the width of a
+ * table's separator row are both layout: Prettier pads both, and neither changes what Claude reads.
+ */
+const normalize = (contents) => contents
+    .split('\n')
+    .filter((line) => !line.startsWith(MARKER_PREFIX))
+    .join(' ')
+    .replace(/-{3,}/g, '---')
+    .replace(/\s+/g, ' ')
+    .trim();
+const readShippedStyle = (name, contentRoot) => {
+    const path = (0, path_1.join)(contentRoot, CONTENT_DIR, `${name}.md`);
+    if (!(0, fs_1.existsSync)(path)) {
+        const known = (0, exports.availableOutputStyles)(contentRoot);
+        throw new Error(`Unknown output style "${name}". This package ships: ${known.join(', ') || 'none'}.`);
+    }
+    return (0, fs_1.readFileSync)(path, 'utf8');
+};
+const readSettings = (path) => {
+    const raw = (0, fs_1.existsSync)(path) ? (0, fs_1.readFileSync)(path, 'utf8') : '';
+    try {
+        return JSON.parse(raw.trim() || '{}');
+    }
+    catch (_a) {
+        throw new Error(`${path} is not valid JSON. Fix the file, then run this again.`);
+    }
+};
+const withOutputStyle = (settings, name) => {
+    const next = Object.assign({}, settings);
+    if (name)
+        next.outputStyle = name;
+    else
+        delete next.outputStyle;
+    return `${JSON.stringify(next, null, 2)}\n`;
+};
+/**
+ * What an install (or a `remove`) would write into Claude Code's user config, without touching
+ * disk. A style file that someone else wrote is reported as a conflict rather than overwritten -
+ * the name is a plain file name, so a hand-written style can carry it.
+ */
+const planOutputStyle = (options = {}) => {
+    var _a, _b;
+    const name = ((_a = options.name) === null || _a === void 0 ? void 0 : _a.trim()) || exports.DEFAULT_OUTPUT_STYLE;
+    if (!/^[A-Za-z0-9][\w.-]*$/.test(name)) {
+        throw new Error(`Invalid output style name "${name}". Use letters, digits, ".", "_" and "-".`);
+    }
+    const configDir = (0, exports.resolveClaudeConfigDir)(options.configDir);
+    const stylePath = (0, path_1.join)(configDir, CONTENT_DIR, `${name}.md`);
+    const settingsPath = (0, path_1.join)(configDir, 'settings.json');
+    const settings = readSettings(settingsPath);
+    const activeStyle = typeof settings.outputStyle === 'string' ? settings.outputStyle : null;
+    const installed = (0, fs_1.existsSync)(stylePath) ? (0, fs_1.readFileSync)(stylePath, 'utf8') : null;
+    const contentRoot = (_b = options.contentRoot) !== null && _b !== void 0 ? _b : (0, load_content_1.resolveContentRoot)();
+    const shipped = options.remove && !(0, exports.availableOutputStyles)(contentRoot).includes(name)
+        ? null
+        : withMarker(readShippedStyle(name, contentRoot), name);
+    const ours = installed === null ||
+        installed.includes(MARKER_PREFIX) ||
+        (shipped !== null && normalize(installed) === normalize(shipped));
+    const plan = { name, configDir, stylePath, settingsPath, activeStyle };
+    if (!ours && !options.force) {
+        const verb = options.remove ? 'delete' : 'overwrite';
+        return Object.assign(Object.assign({}, plan), { files: [], conflict: `${stylePath} was not written by this command. Pass --force to ${verb} it, or rename your own style.` });
+    }
+    const files = [];
+    const settingsAction = (0, fs_1.existsSync)(settingsPath) ? 'update' : 'create';
+    if (options.remove) {
+        if (installed !== null)
+            files.push({ path: stylePath, action: 'remove', contents: null });
+        if (activeStyle === name) {
+            files.push({ path: settingsPath, action: settingsAction, contents: withOutputStyle(settings, null) });
+        }
+        return Object.assign(Object.assign({}, plan), { files, conflict: null });
+    }
+    if (shipped !== null && installed !== shipped) {
+        files.push({ path: stylePath, action: installed === null ? 'create' : 'update', contents: shipped });
+    }
+    if (options.activate !== false && activeStyle !== name) {
+        files.push({ path: settingsPath, action: settingsAction, contents: withOutputStyle(settings, name) });
+    }
+    return Object.assign(Object.assign({}, plan), { files, conflict: null });
+};
+exports.planOutputStyle = planOutputStyle;
+const applyOutputStylePlan = (plan) => {
+    for (const file of plan.files) {
+        if (file.contents === null) {
+            (0, fs_1.rmSync)(file.path, { force: true });
+            continue;
+        }
+        (0, fs_1.mkdirSync)((0, path_1.dirname)(file.path), { recursive: true });
+        (0, fs_1.writeFileSync)(file.path, file.contents, 'utf8');
+    }
+};
+exports.applyOutputStylePlan = applyOutputStylePlan;
+//# sourceMappingURL=output-style.js.map

package/src/lib/output-style.js.map

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

package/src/lib/owned-paths.js

@@ -5,7 +5,7 @@ const fs_1 = require("fs");
 const path_1 = require("path");
 // `.agents/ethlete` and `.github/instructions/ethlete-*` are no longer emitted, but stay owned so
 // a sync prunes them from repos generated by older versions.
-const OWNED_DIRECTORIES = ['.agents/ethlete', '.claude/rules/ethlete', '.claude/hooks/ethlete'];
+const OWNED_DIRECTORIES = ['.agents/ethlete', '.claude/rules/ethlete', '.claude/hooks/ethlete', '.codex/hooks/ethlete'];
 const OWNED_PARENTS = [
     { dir: '.agents/skills', match: (entry) => entry.startsWith('ethlete-') },
     { dir: '.claude/skills', match: (entry) => entry.startsWith('ethlete-') },
@@ -15,12 +15,32 @@ const OWNED_PARENTS = [
         match: (entry) => entry.startsWith('ethlete-') && entry.endsWith('.instructions.md'),
     },
 ];
+/**
+ * Files that exist only to register hooks: once the last generated entry is removed the merge
+ * leaves `{}` behind, which is ours to clean up. Any hand-written entry keeps the file non-empty
+ * and therefore unowned.
+ */
+const OWNED_WHEN_EMPTY = ['.codex/hooks.json'];
+const isEmptyObject = (absolute) => {
+    if (!(0, fs_1.existsSync)(absolute))
+        return false;
+    try {
+        const parsed = JSON.parse((0, fs_1.readFileSync)(absolute, 'utf8'));
+        return typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed) && Object.keys(parsed).length === 0;
+    }
+    catch (_a) {
+        return false;
+    }
+};
 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())
+        const stats = (0, fs_1.lstatSync)(absolute);
+        if (stats.isSymbolicLink())
+            return [];
+        if (stats.isDirectory())
             return walk(root, absolute);
         return [(0, path_1.relative)(root, absolute).split(path_1.sep).join('/')];
     });
@@ -41,9 +61,13 @@ const collectOwnedPaths = (root) => {
             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}`]));
+            const stats = (0, fs_1.lstatSync)(absolute);
+            if (stats.isSymbolicLink())
+                continue;
+            owned.push(...(stats.isDirectory() ? walk(root, absolute) : [`${parent.dir}/${entry}`]));
         }
     }
+    owned.push(...OWNED_WHEN_EMPTY.filter((path) => isEmptyObject((0, path_1.join)(root, path))));
     return owned;
 };
 exports.collectOwnedPaths = collectOwnedPaths;

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

@@ -1 +1 @@
-{"version":3,"file":"owned-paths.js","sourceRoot":"","sources":["../../../../../libs/agent-rules/src/lib/owned-paths.ts"],"names":[],"mappings":";;;AAAA,2BAAuD;AACvD,+BAA2C;AAE3C,kGAAkG;AAClG,6DAA6D;AAC7D,MAAM,iBAAiB,GAAG,CAAC,iBAAiB,EAAE,uBAAuB,EAAE,uBAAuB,CAAC,CAAC;AAChG,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,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"}
+{"version":3,"file":"owned-paths.js","sourceRoot":"","sources":["../../../../../libs/agent-rules/src/lib/owned-paths.ts"],"names":[],"mappings":";;;AAAA,2BAAsE;AACtE,+BAA2C;AAE3C,kGAAkG;AAClG,6DAA6D;AAC7D,MAAM,iBAAiB,GAAG,CAAC,iBAAiB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,sBAAsB,CAAC,CAAC;AACxH,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,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;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,CAAC,mBAAmB,CAAC,CAAC;AAE/C,MAAM,aAAa,GAAG,CAAC,QAAgB,EAAE,EAAE;IACzC,IAAI,CAAC,IAAA,eAAU,EAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAExC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAY,CAAC;QAErE,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IACrH,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,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;QAC1C,MAAM,KAAK,GAAG,IAAA,cAAS,EAAC,QAAQ,CAAC,CAAC;QAElC,IAAI,KAAK,CAAC,cAAc,EAAE;YAAE,OAAO,EAAE,CAAC;QACtC,IAAI,KAAK,CAAC,WAAW,EAAE;YAAE,OAAO,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAErD,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;YAC7C,MAAM,KAAK,GAAG,IAAA,cAAS,EAAC,QAAQ,CAAC,CAAC;YAElC,IAAI,KAAK,CAAC,cAAc,EAAE;gBAAE,SAAS;YAErC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,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;QAC3F,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAA,WAAI,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAElF,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAvBW,QAAA,iBAAiB,qBAuB5B"}

package/src/lib/package-runner.d.ts

@@ -0,0 +1,4 @@
+export declare const detectPackageRunner: (root: string) => "yarn" | "pnpm exec" | "bunx" | "npx";
+export declare const readScripts: (root: string) => Set<string> | undefined;
+export declare const detectCommandVars: (root: string) => Record<string, string>;
+export declare const followPackageManager: (root: string, vars: Record<string, string | string[]>) => any;

package/src/lib/package-runner.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.followPackageManager = exports.detectCommandVars = exports.readScripts = exports.detectPackageRunner = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const RUNNERS = { yarn: 'yarn', pnpm: 'pnpm exec', bun: 'bunx', npm: 'npx' };
+const LOCKFILES = [
+    ['yarn.lock', 'yarn'],
+    ['pnpm-lock.yaml', 'pnpm'],
+    ['bun.lock', 'bun'],
+    ['bun.lockb', 'bun'],
+    ['package-lock.json', 'npm'],
+];
+const readManifest = (root) => {
+    const path = (0, path_1.join)(root, 'package.json');
+    if (!(0, fs_1.existsSync)(path))
+        return undefined;
+    try {
+        return JSON.parse((0, fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch (_a) {
+        return undefined;
+    }
+};
+const declaredManager = (root) => {
+    var _a;
+    const packageManager = (_a = readManifest(root)) === null || _a === void 0 ? void 0 : _a.packageManager;
+    if (typeof packageManager !== 'string')
+        return undefined;
+    return Object.keys(RUNNERS).find((name) => packageManager.startsWith(`${name}@`));
+};
+const detectPackageManagerName = (root) => { var _a, _b, _c; return (_c = (_a = declaredManager(root)) !== null && _a !== void 0 ? _a : (_b = LOCKFILES.find(([fileName]) => (0, fs_1.existsSync)((0, path_1.join)(root, fileName)))) === null || _b === void 0 ? void 0 : _b[1]) !== null && _c !== void 0 ? _c : 'npm'; };
+const detectPackageRunner = (root) => RUNNERS[detectPackageManagerName(root)];
+exports.detectPackageRunner = detectPackageRunner;
+const readScripts = (root) => {
+    const manifest = readManifest(root);
+    if (!manifest)
+        return undefined;
+    return new Set(manifest.scripts && typeof manifest.scripts === 'object' ? Object.keys(manifest.scripts) : []);
+};
+exports.readScripts = readScripts;
+const SCRIPT_RUNNERS = {
+    yarn: 'yarn run',
+    pnpm: 'pnpm run',
+    bun: 'bun run',
+    npm: 'npm run',
+};
+const detectCommandVars = (root) => {
+    var _a, _b, _c, _d;
+    const manager = detectPackageManagerName(root);
+    const manifest = readManifest(root);
+    const scripts = (_a = (0, exports.readScripts)(root)) !== null && _a !== void 0 ? _a : new Set();
+    const script = (name, ...args) => [SCRIPT_RUNNERS[manager], name, ...(args.length && manager === 'npm' ? ['--'] : []), ...args].join(' ');
+    const hasNx = Boolean((_c = (_b = manifest === null || manifest === void 0 ? void 0 : manifest.devDependencies) === null || _b === void 0 ? void 0 : _b['nx']) !== null && _c !== void 0 ? _c : (_d = manifest === null || manifest === void 0 ? void 0 : manifest.dependencies) === null || _d === void 0 ? void 0 : _d['nx']) || (0, fs_1.existsSync)((0, path_1.join)(root, 'nx.json'));
+    const vars = {};
+    if (scripts.has('lint')) {
+        vars['lintCommand'] = script('lint');
+        vars['lintFixCommand'] = script('lint', '--fix');
+    }
+    else if (hasNx) {
+        vars['lintCommand'] = `${RUNNERS[manager]} nx lint <project>`;
+        vars['lintFixCommand'] = `${RUNNERS[manager]} nx lint <project> --fix`;
+    }
+    if (scripts.has('storybook'))
+        vars['storybookStartCommand'] = script('storybook');
+    return vars;
+};
+exports.detectCommandVars = detectCommandVars;
+const NPM_COMMAND = /^npm run (\S+)(?: -- (.*))?$/;
+const followPackageManager = (root, vars) => {
+    const manager = detectPackageManagerName(root);
+    if (manager === 'npm')
+        return vars;
+    return Object.fromEntries(Object.entries(vars).map(([name, value]) => {
+        if (typeof value !== 'string')
+            return [name, value];
+        const script = NPM_COMMAND.exec(value);
+        if (script)
+            return [name, [SCRIPT_RUNNERS[manager], script[1], script[2]].filter(Boolean).join(' ')];
+        if (value.startsWith('npx '))
+            return [name, `${RUNNERS[manager]} ${value.slice(4)}`];
+        return [name, value];
+    }));
+};
+exports.followPackageManager = followPackageManager;
+//# sourceMappingURL=package-runner.js.map

package/src/lib/package-runner.js.map

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

package/src/lib/plain-text.d.ts

@@ -0,0 +1,9 @@
+/**
+ * One line as a terminal prints it literally.
+ *
+ * A Jira summary, a stand-in name and an error message all reach the terminal as somebody typed them.
+ * An escape sequence in one of them can clear the screen, move the cursor or redraw a line that has
+ * already been printed, so output could be made to say something the app never answered. Every control
+ * character apart from tab and newline is printed as its own escaped form instead.
+ */
+export declare const plain: (text: string) => string;

package/src/lib/plain-text.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.plain = void 0;
+/** Tab and newline are the only control characters a printed line may hold. */
+const isControl = (code) => (code < 0x20 ? code !== 0x09 && code !== 0x0a : code >= 0x7f && code <= 0x9f);
+/**
+ * One line as a terminal prints it literally.
+ *
+ * A Jira summary, a stand-in name and an error message all reach the terminal as somebody typed them.
+ * An escape sequence in one of them can clear the screen, move the cursor or redraw a line that has
+ * already been printed, so output could be made to say something the app never answered. Every control
+ * character apart from tab and newline is printed as its own escaped form instead.
+ */
+const plain = (text) => [...text]
+    .map((character) => {
+    var _a;
+    const code = (_a = character.codePointAt(0)) !== null && _a !== void 0 ? _a : 0;
+    return isControl(code) ? `\\x${code.toString(16).padStart(2, '0')}` : character;
+})
+    .join('');
+exports.plain = plain;
+//# sourceMappingURL=plain-text.js.map

package/src/lib/plain-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plain-text.js","sourceRoot":"","sources":["../../../../../libs/agent-rules/src/lib/plain-text.ts"],"names":[],"mappings":";;;AAAA,+EAA+E;AAC/E,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC;AAElH;;;;;;;GAOG;AACI,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE,CACpC,CAAC,GAAG,IAAI,CAAC;KACN,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE;;IACjB,MAAM,IAAI,GAAG,MAAA,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,mCAAI,CAAC,CAAC;IAE3C,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAClF,CAAC,CAAC;KACD,IAAI,CAAC,EAAE,CAAC,CAAC;AAPD,QAAA,KAAK,SAOJ"}

package/src/lib/plan.d.ts

@@ -1,17 +1,18 @@
 import { SyncConfig } from './config';
 import { SkippedItem } from './filter';
+import { ContentItem } from './load-content';
 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;
-    }[];
     /** Config/repo mismatches that won't fail the run but will silently lose content if ignored. */
     warnings: string[];
 };
+export declare const assertResolvedContentReferences: (options: {
+    items: ContentItem[];
+    kept: ContentItem[];
+    skipped: SkippedItem[];
+}) => void;
 /** `@AGENTS.md` on its own line (the documented import syntax), or a symlink pointing at it. */
 export declare const claudeMdImportsAgentsMd: (root: string) => boolean;
 /**
@@ -20,5 +21,4 @@ export declare const claudeMdImportsAgentsMd: (root: string) => boolean;
  */
 export declare const buildPlan: (options: {
     config: SyncConfig;
-    version: string;
 }) => SyncPlan;