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

package/src/lib/git.d.ts

@@ -0,0 +1,27 @@
+export declare const git: (options: {
+    root: string;
+    args: string[];
+}) => string;
+/** Runs a command whose output belongs on the terminal — a push, a fetch, a branch creation. */
+export declare const gitLoud: (options: {
+    root: string;
+    args: string[];
+}) => string;
+export declare const currentBranch: (root: string) => string;
+export declare const allBranches: (root: string) => string[];
+export declare const isDirty: (root: string) => boolean;
+export declare const localBranchExists: (options: {
+    root: string;
+    branch: string;
+}) => boolean;
+export declare const remoteBranchExists: (options: {
+    root: string;
+    remote: string;
+    branch: string;
+}) => boolean;
+/** `origin` when it exists, otherwise the only remote — a repo with several and no `origin` is ambiguous. */
+export declare const defaultRemote: (root: string) => string | undefined;
+export declare const remoteUrl: (options: {
+    root: string;
+    remote: string;
+}) => string;

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":";;;;AAUA,MAAM,UAAU,GAAG,KAAM,CAAC;AAE1B,oGAAoG;AAC7F,MAAM,cAAc,GAAG,CAAC,GAAW,EAA6B,EAAE;IACvE,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,0CAA0C,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAErE,IAAI,CAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAG,CAAC,CAAC,KAAI,GAAG,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjE,MAAM,UAAU,GAAG,mEAAmE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAErG,IAAI,CAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAG,CAAC,CAAC,KAAI,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7F,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAXW,QAAA,cAAc,kBAWzB;AAEK,MAAM,WAAW,GAAG,GAAG,EAAE,eAC9B,OAAA,CAAA,MAAA,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,0CAAE,IAAI,EAAE,MAAI,MAAA,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,0CAAE,IAAI,EAAE,CAAA,IAAI,SAAS,CAAA,EAAA,CAAC;AAD7E,QAAA,WAAW,eACkE;AAW1F,MAAM,mBAAmB,GAAG,eAAe,CAAC;AAC5C,wDAAwD;AAExD,MAAM,cAAc,GAAG,CAAC,GAAyB,EAAsB,EAAE;;IAAC,OAAA,CAAC;QACzE,GAAG,EAAE,MAAA,GAAG,CAAC,GAAG,mCAAI,CAAC;QACjB,KAAK,EAAE,MAAA,GAAG,CAAC,KAAK,mCAAI,EAAE;QACtB,YAAY,EAAE,MAAA,GAAG,CAAC,aAAa,mCAAI,EAAE;QACrC,YAAY,EAAE,MAAA,GAAG,CAAC,aAAa,mCAAI,EAAE;QACrC,GAAG,EAAE,MAAA,GAAG,CAAC,OAAO,mCAAI,EAAE;KACvB,CAAC,CAAA;CAAA,CAAC;AAEH,MAAM,OAAO,GAAG,CAAO,OAMtB,EAAE,EAAE;IACH,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IACvD,MAAM,IAAI,GAAG,WAAW,OAAO,CAAC,IAAI,oBAAoB,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9F,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,EAAE;QAC7C,MAAM,EAAE,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,KAAK;QACvB,OAAO,kBACL,eAAe,EAAE,KAAK,EACtB,MAAM,EAAE,kBAAkB,IACvB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CACxD;QACD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC;KACxC,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACb,8BAA8B,QAAQ,CAAC,MAAM,SAAS,OAAO,CAAC,OAAO,4DAA4D,CAClI,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,QAAQ,MAAM,aAAN,MAAM,cAAN,MAAM,GAAI,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC;IAChH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,SAAS,EAAE,CAAC;AAClH,CAAC,CAAA,CAAC;AAEF;;;GAGG;AACH,MAAM,iBAAiB,GAAG,CAAO,OAAkE,EAAE,EAAE;IACrG,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3C,MAAM,KAAK,GAAyB,EAAE,CAAC;IACvC,IAAI,IAAI,GAAuB,GAAG,CAAC;IAEnC,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;YAC3B,OAAO;YACP,KAAK;YACL,IAAI,EAAE,6CAA6C,MAAM,SAAS,IAAI,EAAE;SACzE,CAAC,CAAC;QAEH,KAAK,CAAC,IAAI,CAAC,GAAI,MAAM,CAAC,IAA+B,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC;QAC3E,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAA,CAAC;AAEF,uGAAuG;AAChG,MAAM,oBAAoB,GAAG,CAAO,OAI1C,EAAiC,EAAE;IAClC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC3C,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACjD,iBAAiB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,OAAO,EAAE,EAAE,CAAC;QACzE,iBAAiB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,OAAO,EAAE,EAAE,CAAC;KAC1E,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,UAAU,EAAE,GAAG,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAEhF,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AAC3D,CAAC,CAAA,CAAC;AAdW,QAAA,oBAAoB,wBAc/B;AAEK,MAAM,oBAAoB,GAAG,CAAO,OAK1C,EAAE,EAAE;IACH,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAEhD,MAAM,OAAO,CAAC;QACZ,OAAO;QACP,KAAK;QACL,IAAI,EAAE,mBAAmB,GAAG,EAAE;QAC9B,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE;KACxC,CAAC,CAAC;AACL,CAAC,CAAA,CAAC;AAfW,QAAA,oBAAoB,wBAe/B;AAEF;;;;GAIG;AACI,MAAM,qBAAqB,GAAG,CAAC,OAAgE,EAAE,EAAE,CACxG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,YAAY,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAD9D,QAAA,qBAAqB,yBACyC"}

package/src/lib/index.d.ts

@@ -2,6 +2,8 @@ export * from './config';
 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

@@ -5,6 +5,8 @@ tslib_1.__exportStar(require("./config"), exports);
 tslib_1.__exportStar(require("./filter"), exports);
 tslib_1.__exportStar(require("./frontmatter"), exports);
 tslib_1.__exportStar(require("./load-content"), exports);
+tslib_1.__exportStar(require("./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,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/migrate.d.ts

@@ -0,0 +1,6 @@
+import { RunOptions } from './sync';
+/**
+ * Converts a repo to the `AGENTS.md`-canonical layout and re-syncs. Safe to re-run: every step
+ * detects the migrated state and skips itself.
+ */
+export declare const migrate: (options: RunOptions) => number;

package/src/lib/migrate.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.migrate = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const config_1 = require("./config");
+const plan_1 = require("./plan");
+const render_1 = require("./render");
+const sync_1 = require("./sync");
+const CLAUDE_MD = 'CLAUDE.md';
+const AGENTS_MD = 'AGENTS.md';
+const CLAUDE_SKILLS = '.claude/skills';
+const AGENTS_SKILLS = '.agents/skills';
+const log = (message) => console.log(`  ${message}`);
+/**
+ * `AGENTS.md` becomes the canonical instruction file: whatever `CLAUDE.md` held moves to the top
+ * of `AGENTS.md`, and `CLAUDE.md` shrinks to the `@AGENTS.md` import Claude Code documents for
+ * exactly this setup.
+ */
+const migrateClaudeMd = (options) => {
+    const { root, dryRun } = options;
+    const claudePath = (0, path_1.join)(root, CLAUDE_MD);
+    const agentsPath = (0, path_1.join)(root, AGENTS_MD);
+    if ((0, plan_1.claudeMdImportsAgentsMd)(root)) {
+        log(`keep   ${CLAUDE_MD} — already imports ${AGENTS_MD}`);
+        return;
+    }
+    if (!(0, fs_1.existsSync)(claudePath)) {
+        log(`create ${CLAUDE_MD} — "@${AGENTS_MD}" import`);
+        if (!dryRun)
+            (0, fs_1.writeFileSync)(claudePath, `@${AGENTS_MD}\n`, 'utf8');
+        return;
+    }
+    const claudeContent = (0, fs_1.readFileSync)(claudePath, 'utf8').trim();
+    const agentsContent = (0, fs_1.existsSync)(agentsPath) ? (0, fs_1.readFileSync)(agentsPath, 'utf8').trim() : '';
+    const merged = [claudeContent, agentsContent].filter((part) => part.length > 0).join('\n\n');
+    log(`move   ${CLAUDE_MD} content into ${AGENTS_MD}`);
+    log(`write  ${CLAUDE_MD} — "@${AGENTS_MD}" import`);
+    if (dryRun)
+        return;
+    (0, fs_1.writeFileSync)(agentsPath, `${merged}\n`, 'utf8');
+    (0, fs_1.writeFileSync)(claudePath, `@${AGENTS_MD}\n`, 'utf8');
+};
+/**
+ * Hand-written skills move to the cross-tool `.agents/skills/` location; a symlink stays behind
+ * because Claude Code only scans `.claude/skills/` (and follows symlinks there). Generated
+ * `ethlete-` entries are left to `sync`, which owns them.
+ */
+const migrateSkills = (options) => {
+    const { root, dryRun } = options;
+    const claudeSkills = (0, path_1.join)(root, CLAUDE_SKILLS);
+    if (!(0, fs_1.existsSync)(claudeSkills))
+        return;
+    for (const entry of (0, fs_1.readdirSync)(claudeSkills)) {
+        const source = (0, path_1.join)(claudeSkills, entry);
+        if (entry.startsWith('ethlete-') || (0, fs_1.lstatSync)(source).isSymbolicLink() || !(0, fs_1.lstatSync)(source).isDirectory()) {
+            continue;
+        }
+        const destination = (0, path_1.join)(root, AGENTS_SKILLS, entry);
+        if ((0, fs_1.existsSync)(destination)) {
+            log(`skip   ${CLAUDE_SKILLS}/${entry} — ${AGENTS_SKILLS}/${entry} already exists`);
+            continue;
+        }
+        log(`move   ${CLAUDE_SKILLS}/${entry} → ${AGENTS_SKILLS}/${entry} (symlink stays behind)`);
+        if (dryRun)
+            continue;
+        (0, fs_1.mkdirSync)((0, path_1.dirname)(destination), { recursive: true });
+        (0, fs_1.renameSync)(source, destination);
+        try {
+            (0, fs_1.symlinkSync)((0, path_1.relative)((0, path_1.dirname)(source), destination), source, 'dir');
+        }
+        catch (error) {
+            (0, fs_1.renameSync)(destination, source);
+            log(`undo   ${CLAUDE_SKILLS}/${entry} — creating the symlink failed (${error.message})`);
+        }
+    }
+};
+const LAYOUT_NOTE = `## Agent file layout
+
+\`AGENTS.md\` is canonical; \`CLAUDE.md\` is just an \`@AGENTS.md\` import. Skills live in
+\`.agents/skills/<name>/\`; the entries in \`.claude/skills/\` are symlinks to them (Claude Code
+only scans there) - same file, not a duplicate. Edit and create skills under \`.agents/skills/\`,
+plus a symlink for new ones. \`ethlete-*\` skills and the marker block in this file are generated
+by \`npx ethlete-agents sync\` - never edit them by hand.`;
+const withoutMarkedBlock = (content) => {
+    const start = content.indexOf(render_1.START_MARKER);
+    const end = content.indexOf(render_1.END_MARKER);
+    if (start === -1 || end === -1 || end < start)
+        return content;
+    return content.slice(0, start) + content.slice(end + render_1.END_MARKER.length);
+};
+/**
+ * Without this note an agent that lists both skill directories reads the symlinked entries as
+ * duplicated files. Skipped when the repo's own `AGENTS.md` prose already explains the layout.
+ */
+const addLayoutNote = (options) => {
+    const { root, dryRun } = options;
+    const path = (0, path_1.join)(root, AGENTS_MD);
+    const existing = (0, fs_1.existsSync)(path) ? (0, fs_1.readFileSync)(path, 'utf8') : '';
+    if (withoutMarkedBlock(existing).includes(AGENTS_SKILLS)) {
+        log(`keep   ${AGENTS_MD} — already documents the ${AGENTS_SKILLS} layout`);
+        return;
+    }
+    log(`write  ${AGENTS_MD} — add the agent file layout note`);
+    if (dryRun)
+        return;
+    const start = existing.indexOf(render_1.START_MARKER);
+    const contents = start === -1
+        ? `${[existing.trimEnd(), LAYOUT_NOTE].filter((part) => part.length > 0).join('\n\n')}\n`
+        : `${existing.slice(0, start).trimEnd()}\n\n${LAYOUT_NOTE}\n\n${existing.slice(start)}`;
+    (0, fs_1.writeFileSync)(path, contents, 'utf8');
+};
+const migrateConfig = (options) => {
+    const { root, dryRun } = options;
+    const path = (0, path_1.join)(root, config_1.CONFIG_FILE_NAME);
+    const raw = (0, fs_1.existsSync)(path)
+        ? JSON.parse((0, fs_1.readFileSync)(path, 'utf8'))
+        : { targets: 'auto', vars: {}, exclude: [] };
+    const targets = raw['targets'];
+    const explicit = Array.isArray(targets) ? targets : undefined;
+    const missingCodex = explicit !== undefined && !explicit.includes('codex');
+    const missingFlag = raw['claudeMdImportsAgentsMd'] !== true;
+    if (!missingCodex && !missingFlag) {
+        log(`keep   ${config_1.CONFIG_FILE_NAME} — already migrated`);
+        return;
+    }
+    if (missingCodex && explicit)
+        raw['targets'] = [...explicit, 'codex'];
+    raw['claudeMdImportsAgentsMd'] = true;
+    log(`write  ${config_1.CONFIG_FILE_NAME} — codex target + claudeMdImportsAgentsMd`);
+    if (!dryRun)
+        (0, fs_1.writeFileSync)(path, `${JSON.stringify(raw, null, 2)}\n`, 'utf8');
+};
+/**
+ * Converts a repo to the `AGENTS.md`-canonical layout and re-syncs. Safe to re-run: every step
+ * detects the migrated state and skips itself.
+ */
+const migrate = (options) => {
+    const { root, dryRun = false } = options;
+    console.log(dryRun ? 'Migration plan (dry run):' : 'Migrating to the AGENTS.md + .agents/skills layout:');
+    migrateClaudeMd({ root, dryRun });
+    migrateSkills({ root, dryRun });
+    addLayoutNote({ root, dryRun });
+    migrateConfig({ root, dryRun });
+    if (dryRun) {
+        console.log('\nRe-run without --dry-run to apply, then a sync runs automatically.');
+        return 0;
+    }
+    console.log('\nRunning sync:');
+    const result = (0, sync_1.sync)(options);
+    console.log('\nDone. Commit the result. Note: the .claude/skills symlinks need symlink support on checkout (Windows: Developer Mode).');
+    return result;
+};
+exports.migrate = migrate;
+//# sourceMappingURL=migrate.js.map

package/src/lib/migrate.js.map

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

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;