@ethlete/agent-rules 0.1.0-next.1 → 0.1.0-next.10

package/src/lib/git.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.remoteUrl = exports.defaultRemote = exports.remoteBranchExists = exports.localBranchExists = exports.isDirty = exports.allBranches = exports.currentBranch = exports.gitLoud = exports.git = void 0;
+const child_process_1 = require("child_process");
+const git_flow_1 = require("./git-flow");
+const git = (options) => (0, child_process_1.execFileSync)('git', options.args, { cwd: options.root, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'] }).trim();
+exports.git = git;
+/** Runs a command whose output belongs on the terminal — a push, a fetch, a branch creation. */
+const gitLoud = (options) => (0, child_process_1.execFileSync)('git', options.args, { cwd: options.root, encoding: 'utf8', stdio: ['ignore', 'inherit', 'inherit'] });
+exports.gitLoud = gitLoud;
+const currentBranch = (root) => (0, exports.git)({ root, args: ['rev-parse', '--abbrev-ref', 'HEAD'] });
+exports.currentBranch = currentBranch;
+const allBranches = (root) => {
+    const refs = (0, exports.git)({ root, args: ['for-each-ref', '--format=%(refname)', 'refs/heads', 'refs/remotes'] });
+    const names = refs
+        .split('\n')
+        .filter((ref) => ref && !ref.endsWith('/HEAD'))
+        .map(git_flow_1.stripRefPrefix);
+    return [...new Set(names)].sort();
+};
+exports.allBranches = allBranches;
+const isDirty = (root) => (0, exports.git)({ root, args: ['status', '--porcelain'] }).length > 0;
+exports.isDirty = isDirty;
+const refExists = (options) => {
+    try {
+        (0, exports.git)({ root: options.root, args: ['rev-parse', '--verify', '--quiet', options.ref] });
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+};
+const localBranchExists = (options) => refExists({ root: options.root, ref: `refs/heads/${options.branch}` });
+exports.localBranchExists = localBranchExists;
+const remoteBranchExists = (options) => (0, exports.git)({ root: options.root, args: ['ls-remote', '--heads', options.remote, options.branch] }).length > 0;
+exports.remoteBranchExists = remoteBranchExists;
+/** `origin` when it exists, otherwise the only remote — a repo with several and no `origin` is ambiguous. */
+const defaultRemote = (root) => {
+    const remotes = (0, exports.git)({ root, args: ['remote'] })
+        .split('\n')
+        .filter(Boolean);
+    if (remotes.includes('origin'))
+        return 'origin';
+    return remotes.length === 1 ? remotes[0] : undefined;
+};
+exports.defaultRemote = defaultRemote;
+const remoteUrl = (options) => (0, exports.git)({ root: options.root, args: ['remote', 'get-url', options.remote] });
+exports.remoteUrl = remoteUrl;
+//# sourceMappingURL=git.js.map

package/src/lib/git.js.map

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

package/src/lib/gitlab.d.ts

@@ -0,0 +1,35 @@
+export type GitLabProject = {
+    host: string;
+    project: string;
+};
+export type GitLabMergeRequest = {
+    iid: number;
+    title: string;
+    sourceBranch: string;
+    targetBranch: string;
+    url: string;
+};
+/** `git@host:group/sub/project.git`, `ssh://git@host:2222/group/project.git` and the https form. */
+export declare const parseRemoteUrl: (url: string) => GitLabProject | undefined;
+export declare const gitLabToken: () => string | undefined;
+/** Open merge requests whose source **or** target is the branch — both block a rename, differently. */
+export declare const openMergeRequestsFor: (options: {
+    project: GitLabProject;
+    token: string;
+    branch: string;
+}) => Promise<GitLabMergeRequest[]>;
+export declare const retargetMergeRequest: (options: {
+    project: GitLabProject;
+    token: string;
+    iid: number;
+    target: string;
+}) => Promise<void>;
+/**
+ * The GitLab API can change a merge request's target branch but never its source branch, so an open
+ * merge request *from* the branch cannot survive a rename — it has to be closed and reopened, which
+ * loses its discussion. `repair` reports these and refuses rather than doing that to someone.
+ */
+export declare const blockingMergeRequests: (options: {
+    mergeRequests: GitLabMergeRequest[];
+    branch: string;
+}) => GitLabMergeRequest[];

package/src/lib/gitlab.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.blockingMergeRequests = exports.retargetMergeRequest = exports.openMergeRequestsFor = exports.gitLabToken = exports.parseRemoteUrl = void 0;
+const tslib_1 = require("tslib");
+const TIMEOUT_MS = 15000;
+/** `git@host:group/sub/project.git`, `ssh://git@host:2222/group/project.git` and the https form. */
+const parseRemoteUrl = (url) => {
+    const trimmed = url.trim();
+    const scp = /^[^@/\s]+@([^:/\s]+):(.+?)(?:\.git)?\/?$/.exec(trimmed);
+    if ((scp === null || scp === void 0 ? void 0 : scp[1]) && scp[2])
+        return { host: scp[1], project: scp[2] };
+    const withScheme = /^[a-z+]+:\/\/(?:[^@/]+@)?([^/:\s]+)(?::\d+)?\/(.+?)(?:\.git)?\/?$/.exec(trimmed);
+    if ((withScheme === null || withScheme === void 0 ? void 0 : withScheme[1]) && withScheme[2])
+        return { host: withScheme[1], project: withScheme[2] };
+    return undefined;
+};
+exports.parseRemoteUrl = parseRemoteUrl;
+const gitLabToken = () => { var _a, _b; return ((_a = process.env['GITLAB_TOKEN']) === null || _a === void 0 ? void 0 : _a.trim()) || ((_b = process.env['CI_JOB_TOKEN']) === null || _b === void 0 ? void 0 : _b.trim()) || undefined; };
+exports.gitLabToken = gitLabToken;
+const TARGET_BRANCH_FIELD = 'target_branch';
+/* eslint-enable @typescript-eslint/naming-convention */
+const toMergeRequest = (raw) => {
+    var _a, _b, _c, _d, _e;
+    return ({
+        iid: (_a = raw.iid) !== null && _a !== void 0 ? _a : 0,
+        title: (_b = raw.title) !== null && _b !== void 0 ? _b : '',
+        sourceBranch: (_c = raw.source_branch) !== null && _c !== void 0 ? _c : '',
+        targetBranch: (_d = raw.target_branch) !== null && _d !== void 0 ? _d : '',
+        url: (_e = raw.web_url) !== null && _e !== void 0 ? _e : '',
+    });
+};
+const request = (options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const { project, token, path, method, body } = options;
+    const base = `https://${project.host}/api/v4/projects/${encodeURIComponent(project.project)}`;
+    const response = yield fetch(`${base}${path}`, {
+        method: method !== null && method !== void 0 ? method : 'GET',
+        headers: Object.assign({ 'private-token': token, accept: 'application/json' }, (body ? { 'content-type': 'application/json' } : {})),
+        body: body ? JSON.stringify(body) : undefined,
+        signal: AbortSignal.timeout(TIMEOUT_MS),
+    });
+    if (response.status === 401 || response.status === 403) {
+        throw new Error(`GitLab rejected the token (${response.status}) for ${project.project}. GITLAB_TOKEN needs the "api" scope and Developer access.`);
+    }
+    if (!response.ok) {
+        throw new Error(`GitLab responded ${response.status} ${response.statusText} for ${method !== null && method !== void 0 ? method : 'GET'} ${path}.`);
+    }
+    return { body: (yield response.json()), nextPage: response.headers.get('x-next-page') || undefined };
+});
+/**
+ * Follows `x-next-page` rather than reading the first page only: a rename that silently skipped a
+ * merge request on page two would leave exactly the half-finished state `repair` must never produce.
+ */
+const listMergeRequests = (options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const { project, token, filter } = options;
+    const found = [];
+    let page = '1';
+    while (page) {
+        const result = yield request({
+            project,
+            token,
+            path: `/merge_requests?state=opened&per_page=100&${filter}&page=${page}`,
+        });
+        found.push(...result.body.map(toMergeRequest));
+        page = result.nextPage;
+    }
+    return found;
+});
+/** Open merge requests whose source **or** target is the branch — both block a rename, differently. */
+const openMergeRequestsFor = (options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const { project, token, branch } = options;
+    const encoded = encodeURIComponent(branch);
+    const [fromBranch, intoBranch] = yield Promise.all([
+        listMergeRequests({ project, token, filter: `source_branch=${encoded}` }),
+        listMergeRequests({ project, token, filter: `target_branch=${encoded}` }),
+    ]);
+    const byIid = new Map([...fromBranch, ...intoBranch].map((mr) => [mr.iid, mr]));
+    return [...byIid.values()].sort((a, b) => a.iid - b.iid);
+});
+exports.openMergeRequestsFor = openMergeRequestsFor;
+const retargetMergeRequest = (options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const { project, token, iid, target } = options;
+    yield request({
+        project,
+        token,
+        path: `/merge_requests/${iid}`,
+        method: 'PUT',
+        body: { [TARGET_BRANCH_FIELD]: target },
+    });
+});
+exports.retargetMergeRequest = retargetMergeRequest;
+/**
+ * The GitLab API can change a merge request's target branch but never its source branch, so an open
+ * merge request *from* the branch cannot survive a rename — it has to be closed and reopened, which
+ * loses its discussion. `repair` reports these and refuses rather than doing that to someone.
+ */
+const blockingMergeRequests = (options) => options.mergeRequests.filter((mr) => mr.sourceBranch === options.branch);
+exports.blockingMergeRequests = blockingMergeRequests;
+//# sourceMappingURL=gitlab.js.map

package/src/lib/gitlab.js.map

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

package/src/lib/index.d.ts

@@ -3,6 +3,7 @@ export * from './filter';
 export * from './frontmatter';
 export * from './load-content';
 export * from './migrate';
+export * from './output-style';
 export * from './owned-paths';
 export * from './plan';
 export * from './render';

package/src/lib/index.js

@@ -6,6 +6,7 @@ tslib_1.__exportStar(require("./filter"), exports);
 tslib_1.__exportStar(require("./frontmatter"), exports);
 tslib_1.__exportStar(require("./load-content"), exports);
 tslib_1.__exportStar(require("./migrate"), exports);
+tslib_1.__exportStar(require("./output-style"), exports);
 tslib_1.__exportStar(require("./owned-paths"), exports);
 tslib_1.__exportStar(require("./plan"), exports);
 tslib_1.__exportStar(require("./render"), exports);

package/src/lib/index.js.map

@@ -1 +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,oDAA0B;AAC1B,wDAA8B;AAC9B,iDAAuB;AACvB,mDAAyB;AACzB,iDAAuB;AACvB,2DAAiC"}
+{"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,oDAA0B;AAC1B,yDAA+B;AAC/B,wDAA8B;AAC9B,iDAAuB;AACvB,mDAAyB;AACzB,iDAAuB;AACvB,2DAAiC"}

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

@@ -0,0 +1,3 @@
+export declare const outputStyleCommand: (options: {
+    argv: string[];
+}) => 1 | 0;

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,126 @@
+"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;
+    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 shipped = withMarker(readShippedStyle(name, (_b = options.contentRoot) !== null && _b !== void 0 ? _b : (0, load_content_1.resolveContentRoot)()), name);
+    const ours = installed === null || installed.includes(MARKER_PREFIX) || 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 (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,6 +15,23 @@ 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 [];
@@ -44,6 +61,7 @@ const collectOwnedPaths = (root) => {
             owned.push(...((0, fs_1.statSync)(absolute).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":"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"}

package/src/lib/plan.d.ts

@@ -20,5 +20,4 @@ export declare const claudeMdImportsAgentsMd: (root: string) => boolean;
  */
 export declare const buildPlan: (options: {
     config: SyncConfig;
-    version: string;
 }) => SyncPlan;