@ethlete/agent-rules 0.1.0-next.5 → 0.1.0-next.7

package/src/lib/git-flow-repair.d.ts

@@ -0,0 +1,17 @@
+import { SyncConfig } from './config';
+export type RepairRequest = {
+    root: string;
+    config: SyncConfig;
+    ref?: string;
+    to?: string;
+    key?: string;
+    skipMrCheck: boolean;
+    assumeYes: boolean;
+    dryRun: boolean;
+};
+/**
+ * Renames a non-conforming branch and moves the merge requests aimed at it. Everything that can be
+ * checked is checked before the first mutation, and the order of the mutations is chosen so a
+ * failure leaves the old branch and every merge request intact.
+ */
+export declare const gitFlowRepair: (request: RepairRequest) => Promise<1 | 0>;

package/src/lib/git-flow-repair.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gitFlowRepair = void 0;
+const tslib_1 = require("tslib");
+const git_1 = require("./git");
+const git_flow_1 = require("./git-flow");
+const gitlab_1 = require("./gitlab");
+const prompt_1 = require("./prompt");
+const KEY_PLACEHOLDER = '<KEY>';
+const resolveNewName = (options) => {
+    const { branch, to, key, config } = options;
+    if (to)
+        return to;
+    const parse = (0, git_flow_1.parseBranch)({ branch, config: config.gitFlow });
+    if (!parse.suggestedName) {
+        throw new Error(parse.ok
+            ? `${branch} already conforms — nothing to repair.`
+            : `No conforming name can be derived from ${branch}. Pass --to <branch>.`);
+    }
+    if (!parse.suggestedName.includes(KEY_PLACEHOLDER))
+        return parse.suggestedName;
+    if (!key) {
+        throw new Error(`${branch} carries no issue key, so the new name needs one: \`git-flow repair ${branch} --key FIP-1234\` (or --to <branch>).`);
+    }
+    return parse.suggestedName.replace(KEY_PLACEHOLDER, key.toUpperCase());
+};
+const readRemoteState = (options) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const { root, branch, skipMrCheck } = options;
+    const remote = (0, git_1.defaultRemote)(root);
+    if (!remote || !(0, git_1.remoteBranchExists)({ root, remote, branch }))
+        return { pushed: false };
+    if (skipMrCheck)
+        return { pushed: true, remote, retarget: [] };
+    const project = (0, gitlab_1.parseRemoteUrl)((0, git_1.remoteUrl)({ root, remote }));
+    const token = (0, gitlab_1.gitLabToken)();
+    if (!project || !token) {
+        throw new Error([
+            `${branch} is pushed to ${remote}, so open merge requests may point at it and must be retargeted.`,
+            project
+                ? 'Set GITLAB_TOKEN to a token with the "api" scope, or pass --no-mr-check if you know none do.'
+                : `The ${remote} URL is not a recognisable GitLab remote. Pass --no-mr-check if no merge request points at ${branch}.`,
+        ].join('\n'));
+    }
+    const mergeRequests = yield (0, gitlab_1.openMergeRequestsFor)({ project, token, branch });
+    const blocking = (0, gitlab_1.blockingMergeRequests)({ mergeRequests, branch });
+    if (blocking.length > 0) {
+        throw new Error([
+            `${branch} is the source branch of ${blocking.length} open merge request(s):`,
+            ...blocking.map((mr) => `  !${mr.iid}  ${mr.title}  ${mr.url}`),
+            'GitLab cannot move a merge request to a different source branch, and closing it would lose its discussion.',
+            'Merge or close it first, then repair the branch.',
+        ].join('\n'));
+    }
+    return {
+        pushed: true,
+        remote,
+        retarget: mergeRequests.filter((mr) => mr.targetBranch === branch),
+        api: { project, token },
+    };
+});
+const describeSteps = (options) => {
+    const { branch, newName, remote } = options;
+    const steps = [`git branch -m ${branch} ${newName}`];
+    if (remote.pushed) {
+        steps.push(`git push -u ${remote.remote} ${newName}`);
+        steps.push(...remote.retarget.map((mr) => `retarget !${mr.iid} to ${newName}`));
+        steps.push(`git push ${remote.remote} --delete ${branch}`);
+    }
+    return steps;
+};
+/**
+ * Renames a non-conforming branch and moves the merge requests aimed at it. Everything that can be
+ * checked is checked before the first mutation, and the order of the mutations is chosen so a
+ * failure leaves the old branch and every merge request intact.
+ */
+const gitFlowRepair = (request) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const { root, config, dryRun } = request;
+    const branch = (_a = request.ref) !== null && _a !== void 0 ? _a : (0, git_1.currentBranch)(root);
+    const newName = resolveNewName({ branch, to: request.to, key: request.key, config });
+    const parsed = (0, git_flow_1.parseBranch)({ branch: newName, config: config.gitFlow });
+    if (!parsed.ok) {
+        console.error(`${newName} does not conform either:`);
+        parsed.findings.forEach((finding) => console.error(`  ${finding.rule}   ${finding.message}`));
+        return 1;
+    }
+    if (!(0, git_1.localBranchExists)({ root, branch })) {
+        console.error(`${branch} does not exist locally — check it out first, then repair it.`);
+        return 1;
+    }
+    if ((0, git_1.localBranchExists)({ root, branch: newName })) {
+        console.error(`${newName} already exists locally.`);
+        return 1;
+    }
+    const remote = yield readRemoteState({ root, branch, skipMrCheck: request.skipMrCheck });
+    if (remote.pushed && (0, git_1.remoteBranchExists)({ root, remote: remote.remote, branch: newName })) {
+        console.error(`${newName} already exists on ${remote.remote}.`);
+        return 1;
+    }
+    const steps = describeSteps({ branch, newName, remote });
+    console.log('Repair');
+    console.log(`  from      ${branch}`);
+    console.log(`  to        ${newName}`);
+    console.log(`  remote    ${remote.pushed ? `${remote.remote} (pushed)` : 'not pushed'}`);
+    if (remote.pushed && !remote.api)
+        console.log('  warn      merge requests were not checked (--no-mr-check)');
+    if (remote.pushed) {
+        remote.retarget.forEach((mr) => console.log(`  retarget  !${mr.iid}  ${mr.title}`));
+    }
+    console.log('\nSteps');
+    steps.forEach((step, index) => console.log(`  ${index + 1}. ${step}`));
+    if (dryRun) {
+        console.log('\nDry run — nothing was changed.');
+        return 0;
+    }
+    if (!(yield (0, prompt_1.confirm)({ question: `\nRename ${branch} to ${newName}?`, assumeYes: request.assumeYes }))) {
+        console.log('Nothing was changed.');
+        return 1;
+    }
+    (0, git_1.git)({ root, args: ['branch', '-m', branch, newName] });
+    if (!remote.pushed) {
+        console.log(`\nRenamed to ${newName}.`);
+        return 0;
+    }
+    (0, git_1.gitLoud)({ root, args: ['push', '-u', remote.remote, newName] });
+    const { api } = remote;
+    for (const mergeRequest of remote.retarget) {
+        if (!api)
+            break;
+        try {
+            yield (0, gitlab_1.retargetMergeRequest)({ project: api.project, token: api.token, iid: mergeRequest.iid, target: newName });
+            console.log(`Retargeted !${mergeRequest.iid} to ${newName}.`);
+        }
+        catch (error) {
+            console.error(`\nFailed to retarget !${mergeRequest.iid}: ${error instanceof Error ? error.message : error}`);
+            console.error([
+                `${branch} still exists on ${remote.remote}, so nothing is broken — but the rename is half done.`,
+                `Retarget the remaining merge request(s) to ${newName} by hand, then run:`,
+                `  git push ${remote.remote} --delete ${branch}`,
+                `Or undo: git branch -m ${newName} ${branch} && git push ${remote.remote} --delete ${newName}`,
+            ].join('\n'));
+            return 1;
+        }
+    }
+    (0, git_1.gitLoud)({ root, args: ['push', remote.remote, '--delete', branch] });
+    console.log(`\nRenamed to ${newName} on ${remote.remote}.`);
+    return 0;
+});
+exports.gitFlowRepair = gitFlowRepair;
+//# sourceMappingURL=git-flow-repair.js.map

package/src/lib/git-flow-repair.js.map

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

package/src/lib/git-flow-start.d.ts

@@ -0,0 +1,20 @@
+import { SyncConfig } from './config';
+export type StartRequest = {
+    root: string;
+    config: SyncConfig;
+    key?: string;
+    subject?: string;
+    type?: string;
+    parent?: string;
+    hotfix: boolean;
+    releaseDate?: string;
+    push: boolean;
+    assumeYes: boolean;
+    dryRun: boolean;
+};
+/**
+ * The prospective flow: an issue key in, a correctly named branch off the correct base out. Shares
+ * `planStart` with `@ethlete/timetrack`'s ticket → branch flow, so the two cannot name a branch
+ * differently.
+ */
+export declare const gitFlowStart: (request: StartRequest) => Promise<1 | 0>;

package/src/lib/git-flow-start.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gitFlowStart = void 0;
+const tslib_1 = require("tslib");
+const git_1 = require("./git");
+const git_flow_1 = require("./git-flow");
+const jira_1 = require("./jira");
+const prompt_1 = require("./prompt");
+/**
+ * A Task's parent Story must already have its feature branch, because that branch is what the
+ * sub-feature nests under and is based on. A Story whose branch still uses a deprecated spelling
+ * therefore has to be repaired before anything can nest under it — the name is the parent path.
+ */
+const findParentBranch = (options) => {
+    const { root, storyKey, config } = options;
+    const matches = (0, git_1.allBranches)(root).filter((branch) => {
+        const parse = (0, git_flow_1.parseBranch)({ branch, config });
+        return parse.kind === 'main-feature' && !parse.deprecated && parse.storyKey === storyKey;
+    });
+    if (matches.length === 0) {
+        throw new Error([
+            `No feature branch found for the parent story ${storyKey}.`,
+            `Create it first with \`ethlete-agents git-flow start ${storyKey}\`, or pass --of <branch>.`,
+            "If it exists under a deprecated name, `git-flow repair` it first — a sub-feature nests under its parent's full name.",
+        ].join('\n'));
+    }
+    if (matches.length > 1) {
+        throw new Error(`${storyKey} has more than one feature branch: ${matches.join(', ')}. Pass --of <branch>.`);
+    }
+    return matches[0];
+};
+const specForParent = (options) => {
+    const { parent, key, subject, config } = options;
+    const kind = (0, git_flow_1.parseBranch)({ branch: parent, config }).kind === 'release' ? 'release-fix' : 'sub-feature';
+    return { kind, parent, key, subject };
+};
+const resolveSubject = (options) => {
+    const { issue, settings } = options;
+    if (issue.subject)
+        return { subject: issue.subject, subjectSource: `${settings.subjectField}` };
+    return {
+        subject: issue.summary,
+        subjectSource: settings.subjectField
+            ? `the summary — ${settings.subjectField} is empty on ${issue.key}`
+            : 'the summary — set jira.subjectField to use the story subject field instead',
+    };
+};
+const resolve = (request) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const { root, config, subject, type, parent, hotfix, releaseDate } = request;
+    if (releaseDate)
+        return { spec: { kind: 'release', date: releaseDate }, subjectSource: '—' };
+    if (!request.key)
+        throw new Error('Pass an issue key, e.g. `git-flow start FIP-2177`.');
+    const key = request.key.toUpperCase();
+    if (subject) {
+        if (hotfix)
+            return { spec: { kind: 'hotfix', key, subject }, subjectSource: '--subject' };
+        if (parent) {
+            return { spec: specForParent({ parent, key, subject, config: config.gitFlow }), subjectSource: '--subject' };
+        }
+        return { spec: { kind: 'main-feature', type, key, subject }, subjectSource: '--subject' };
+    }
+    const issue = yield (0, jira_1.fetchJiraIssue)({
+        key,
+        credentials: (0, jira_1.resolveJiraCredentials)({ root, settings: config.jira }),
+        settings: config.jira,
+    });
+    const resolvedSubject = resolveSubject({ issue, settings: config.jira });
+    const resolvedType = type !== null && type !== void 0 ? type : (_a = config.jira.typeByIssueType) === null || _a === void 0 ? void 0 : _a[issue.issueType];
+    const shared = { key, subject: resolvedSubject.subject };
+    if (hotfix)
+        return { spec: Object.assign({ kind: 'hotfix' }, shared), issue, subjectSource: resolvedSubject.subjectSource };
+    const parentBranch = parent !== null && parent !== void 0 ? parent : (issue.parentKey ? findParentBranch({ root, storyKey: issue.parentKey, config: config.gitFlow }) : undefined);
+    if (parentBranch) {
+        return {
+            spec: specForParent(Object.assign(Object.assign({ parent: parentBranch }, shared), { config: config.gitFlow })),
+            issue,
+            subjectSource: resolvedSubject.subjectSource,
+        };
+    }
+    return {
+        spec: Object.assign({ kind: 'main-feature', type: resolvedType }, shared),
+        issue,
+        subjectSource: resolvedSubject.subjectSource,
+    };
+});
+const describePlan = (options) => {
+    const { plan, baseRef } = options;
+    const { issue, spec, subjectSource } = options.resolved;
+    const lines = [`  branch    ${plan.branch}`, `  from      ${baseRef}`, `  merges to ${plan.mrTargets.join(' or ')}`];
+    if (issue)
+        lines.unshift(`  issue     ${issue.key}  ${issue.issueType}${issue.summary ? ` — ${issue.summary}` : ''}`);
+    if (spec.kind !== 'release')
+        lines.push(`  subject   from ${subjectSource}`);
+    return lines;
+};
+/**
+ * The prospective flow: an issue key in, a correctly named branch off the correct base out. Shares
+ * `planStart` with `@ethlete/timetrack`'s ticket → branch flow, so the two cannot name a branch
+ * differently.
+ */
+const gitFlowStart = (request) => tslib_1.__awaiter(void 0, void 0, void 0, function* () {
+    const { root, config, push, dryRun } = request;
+    const resolved = yield resolve(request);
+    const plan = (0, git_flow_1.planStart)({ spec: resolved.spec, config: config.gitFlow });
+    if (plan.problems.length > 0) {
+        console.error(`Cannot name a conforming branch for this issue:`);
+        plan.problems.forEach((problem) => console.error(`  ${problem}`));
+        return 1;
+    }
+    const base = plan.base;
+    const remote = (0, git_1.defaultRemote)(root);
+    const baseOnRemote = remote ? (0, git_1.remoteBranchExists)({ root, remote, branch: base }) : false;
+    const baseRef = baseOnRemote ? `${remote}/${base}` : base;
+    console.log(`Plan`);
+    describePlan({ plan, resolved, baseRef }).forEach((line) => console.log(line));
+    if ((0, git_1.localBranchExists)({ root, branch: plan.branch })) {
+        console.error(`\n${plan.branch} already exists — \`git switch ${plan.branch}\`.`);
+        return 1;
+    }
+    if (!baseOnRemote && !(0, git_1.localBranchExists)({ root, branch: base })) {
+        console.error(`\nThe base branch ${base} exists neither locally nor on ${remote !== null && remote !== void 0 ? remote : 'any remote'}.`);
+        return 1;
+    }
+    if ((0, git_1.isDirty)(root)) {
+        console.error('\nThe working tree has uncommitted changes — commit or stash them first.');
+        return 1;
+    }
+    if (dryRun) {
+        console.log('\nDry run — nothing was created.');
+        return 0;
+    }
+    if (!(yield (0, prompt_1.confirm)({ question: `\nCreate ${plan.branch} from ${baseRef}?`, assumeYes: request.assumeYes }))) {
+        console.log('Nothing was created.');
+        return 1;
+    }
+    if (remote && baseOnRemote)
+        (0, git_1.gitLoud)({ root, args: ['fetch', remote, base] });
+    (0, git_1.gitLoud)({ root, args: ['switch', '-c', plan.branch, '--no-track', baseRef] });
+    if (push && remote)
+        (0, git_1.gitLoud)({ root, args: ['push', '-u', remote, plan.branch] });
+    console.log(`\nOn ${(0, git_1.currentBranch)(root)}. Open the merge request against ${plan.mrTargets[0]}.`);
+    return 0;
+});
+exports.gitFlowStart = gitFlowStart;
+//# sourceMappingURL=git-flow-start.js.map

package/src/lib/git-flow-start.js.map

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

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":"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"}

package/src/lib/jira.d.ts

@@ -0,0 +1,28 @@
+import { JiraSettings } from './config';
+export type JiraCredentials = {
+    host: string;
+    email: string;
+    token: string;
+};
+export type JiraIssue = {
+    key: string;
+    summary: string;
+    issueType: string;
+    /** The parent issue, when the instance reports one — a Task under its Story. */
+    parentKey?: string;
+    /** The configured subject field's value, when the instance has one and this issue sets it. */
+    subject?: string;
+};
+/**
+ * The host may also be committed in `ethlete-agents.config.json` (it is not a secret); the email and
+ * token may only come from the environment or the gitignored local config.
+ */
+export declare const resolveJiraCredentials: (options: {
+    root: string;
+    settings: JiraSettings;
+}) => JiraCredentials;
+export declare const fetchJiraIssue: (options: {
+    key: string;
+    credentials: JiraCredentials;
+    settings: JiraSettings;
+}) => Promise<JiraIssue>;