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

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

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * The branch grammar as data: one config drives the parser, the validators, the CLI, the generated
+ * skill and `@ethlete/timetrack`'s correlation engine.
+ *
+ * Nothing in this folder may import `fs`, `path` or `process`, or take a dependency — it is
+ * reachable as `@ethlete/agent-rules/git-flow` and gets bundled into a browser webview.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveGitFlowConfig = exports.DEFAULT_GIT_FLOW_CONFIG = exports.GIT_FLOW_RULES = void 0;
+exports.GIT_FLOW_RULES = [
+    'unknown-type',
+    'missing-key',
+    'key-case',
+    'missing-subject',
+    'type-alias',
+    'deprecated-prefix',
+    'release-date',
+    'wrong-mr-target',
+    'protected-push',
+];
+exports.DEFAULT_GIT_FLOW_CONFIG = {
+    enforcement: 'advisory',
+    subPrefix: 'sub',
+    keyPattern: '[A-Z]{2,10}-\\d+',
+    keyPrefixes: [],
+    baseBranches: { development: 'next', production: 'main' },
+    types: ['feat', 'fix', 'refactor', 'chore', 'docs', 'perf', 'test', 'style', 'build', 'ci'],
+    typeAliases: { feature: 'feat', bugfix: 'fix' },
+    releasePrefix: 'release',
+    releasePattern: '\\d{4}\\.\\d{2}\\.\\d{2}',
+    hotfixPrefix: 'hotfix',
+    subjectCase: 'kebab',
+    deprecatedShapes: [{ match: '^dev-(?<subject>.+)$', kind: 'main-feature', renameTo: 'feat/<KEY>-<subject>' }],
+    severity: {
+        'unknown-type': 'warn',
+        'missing-key': 'warn',
+        'key-case': 'warn',
+        'missing-subject': 'warn',
+        'type-alias': 'warn',
+        'deprecated-prefix': 'warn',
+        'release-date': 'warn',
+        'wrong-mr-target': 'warn',
+        'protected-push': 'error',
+    },
+};
+/** Fills a repo's `gitFlow` config block out to a complete grammar. */
+const resolveGitFlowConfig = (raw) => (Object.assign(Object.assign(Object.assign({}, exports.DEFAULT_GIT_FLOW_CONFIG), raw), { baseBranches: Object.assign(Object.assign({}, exports.DEFAULT_GIT_FLOW_CONFIG.baseBranches), raw === null || raw === void 0 ? void 0 : raw.baseBranches), typeAliases: Object.assign(Object.assign({}, exports.DEFAULT_GIT_FLOW_CONFIG.typeAliases), raw === null || raw === void 0 ? void 0 : raw.typeAliases), severity: Object.assign(Object.assign({}, exports.DEFAULT_GIT_FLOW_CONFIG.severity), raw === null || raw === void 0 ? void 0 : raw.severity) }));
+exports.resolveGitFlowConfig = resolveGitFlowConfig;
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../../../libs/agent-rules/src/lib/git-flow/config.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEU,QAAA,cAAc,GAAG;IAC5B,cAAc;IACd,aAAa;IACb,UAAU;IACV,iBAAiB;IACjB,YAAY;IACZ,mBAAmB;IACnB,cAAc;IACd,iBAAiB;IACjB,gBAAgB;CACR,CAAC;AAiDE,QAAA,uBAAuB,GAAkB;IACpD,WAAW,EAAE,UAAU;IACvB,SAAS,EAAE,KAAK;IAChB,UAAU,EAAE,kBAAkB;IAC9B,WAAW,EAAE,EAAE;IACf,YAAY,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE;IACzD,KAAK,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;IAC3F,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE;IAC/C,aAAa,EAAE,SAAS;IACxB,cAAc,EAAE,0BAA0B;IAC1C,YAAY,EAAE,QAAQ;IACtB,WAAW,EAAE,OAAO;IACpB,gBAAgB,EAAE,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,sBAAsB,EAAE,CAAC;IAC7G,QAAQ,EAAE;QACR,cAAc,EAAE,MAAM;QACtB,aAAa,EAAE,MAAM;QACrB,UAAU,EAAE,MAAM;QAClB,iBAAiB,EAAE,MAAM;QACzB,YAAY,EAAE,MAAM;QACpB,mBAAmB,EAAE,MAAM;QAC3B,cAAc,EAAE,MAAM;QACtB,iBAAiB,EAAE,MAAM;QACzB,gBAAgB,EAAE,OAAO;KAC1B;CACF,CAAC;AAQF,uEAAuE;AAChE,MAAM,oBAAoB,GAAG,CAAC,GAAsB,EAAiB,EAAE,CAAC,+CAC1E,+BAAuB,GACvB,GAAG,KACN,YAAY,kCAAO,+BAAuB,CAAC,YAAY,GAAK,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,YAAY,GAC7E,WAAW,kCAAO,+BAAuB,CAAC,WAAW,GAAK,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,WAAW,GAC1E,QAAQ,kCAAO,+BAAuB,CAAC,QAAQ,GAAK,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,QAAQ,KACjE,CAAC;AANU,QAAA,oBAAoB,wBAM9B"}

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

@@ -0,0 +1,6 @@
+export * from './build';
+export * from './config';
+export * from './parse';
+export * from './rename';
+export * from './start';
+export * from './validate';

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./build"), exports);
+tslib_1.__exportStar(require("./config"), exports);
+tslib_1.__exportStar(require("./parse"), exports);
+tslib_1.__exportStar(require("./rename"), exports);
+tslib_1.__exportStar(require("./start"), exports);
+tslib_1.__exportStar(require("./validate"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../libs/agent-rules/src/lib/git-flow/index.ts"],"names":[],"mappings":";;;AAAA,kDAAwB;AACxB,mDAAyB;AACzB,kDAAwB;AACxB,mDAAyB;AACzB,kDAAwB;AACxB,qDAA2B"}

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

@@ -0,0 +1,49 @@
+import { GitFlowBranchKind, GitFlowConfig, GitFlowRule } from './config';
+export type GitFlowFinding = {
+    rule: GitFlowRule;
+    message: string;
+    /** The conforming spelling, when it can be derived without asking Jira for an issue key. */
+    suggestion?: string;
+};
+export type BranchParseResult = {
+    branch: string;
+    /** True only for a fully conforming name — an alias or a lowercase key still parses, but is not `ok`. */
+    ok: boolean;
+    kind: GitFlowBranchKind;
+    /** The normalized type segment (`feature/` resolves to `feat`). */
+    type?: string;
+    storyKey?: string;
+    taskKey?: string;
+    /** The most specific issue the branch names — what time should be logged against. */
+    issueKey?: string;
+    subject?: string;
+    /** The branch this one nests under, for a sub-feature or a release fix. */
+    parent?: string;
+    /** The branch matched a `deprecatedShapes` entry, so it should be excluded from adoption reports. */
+    deprecated: boolean;
+    expectedBase?: string;
+    expectedMrTargets: string[];
+    /** Set by `resolveThroughBase` when the story key came from the base branch rather than this name. */
+    inheritedFrom?: string;
+    suggestedName?: string;
+    findings: GitFlowFinding[];
+};
+export declare const stripRefPrefix: (ref: string) => string;
+/**
+ * Classifies a branch name against the grammar. Never throws: an unrecognised name comes back as
+ * `kind: 'unknown'` with findings, so the validator and timetrack's correlation engine can read
+ * the same result for different purposes.
+ */
+export declare const parseBranch: (options: {
+    branch: string;
+    config: GitFlowConfig;
+}) => BranchParseResult;
+/**
+ * Attributes a keyless branch through the branch it is based on. Reviewed branches land in an
+ * integration branch, so a flat name like `feat/logout-confirmation` usually has a parent that
+ * does carry the story key. Deterministic — no model involved.
+ */
+export declare const resolveThroughBase: (options: {
+    branch: BranchParseResult;
+    base: BranchParseResult;
+}) => BranchParseResult;

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

@@ -0,0 +1,274 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveThroughBase = exports.parseBranch = exports.stripRefPrefix = void 0;
+const build_1 = require("./build");
+const stripRefPrefix = (ref) => ref
+    .trim()
+    .replace(/^refs\/heads\//, '')
+    .replace(/^refs\/remotes\/[^/]+\//, '');
+exports.stripRefPrefix = stripRefPrefix;
+/**
+ * The key is only recognised anchored at the start of a segment. A trailing number is therefore
+ * never mistaken for one — `ratings-reveal-secondary-page-27` yields no key rather than a wrong
+ * one, and a confidently wrong attribution is worse than none.
+ */
+const parseSegment = (options) => {
+    const { segment, config, role } = options;
+    const match = new RegExp(`^(${config.keyPattern})(?:-(.*))?$`, 'i').exec(segment);
+    const rawKey = match === null || match === void 0 ? void 0 : match[1];
+    const known = config.keyPrefixes.length === 0 ||
+        config.keyPrefixes.some((prefix) => rawKey === null || rawKey === void 0 ? void 0 : rawKey.toUpperCase().startsWith(prefix.toUpperCase()));
+    if (!rawKey || !known) {
+        return {
+            subject: segment || undefined,
+            findings: [{ rule: 'missing-key', message: `"${segment}" carries no ${role} issue key.` }],
+        };
+    }
+    const key = rawKey.toUpperCase();
+    const subject = (match === null || match === void 0 ? void 0 : match[2]) || undefined;
+    const findings = [];
+    if (rawKey !== key) {
+        findings.push({ rule: 'key-case', message: `Issue key "${rawKey}" should be uppercase "${key}".` });
+    }
+    if (!subject) {
+        findings.push({ rule: 'missing-subject', message: `"${segment}" names ${key} but has no subject.` });
+    }
+    return { key, subject, findings };
+};
+const matchDeprecatedShape = (options) => {
+    var _a;
+    const { branch, config } = options;
+    for (const shape of config.deprecatedShapes) {
+        const match = new RegExp(shape.match).exec(branch);
+        if (match)
+            return { shape, groups: (_a = match.groups) !== null && _a !== void 0 ? _a : {} };
+    }
+    return undefined;
+};
+const renameSuggestion = (options) => {
+    var _a;
+    const { shape, groups } = options;
+    const key = groups['key'];
+    return shape.renameTo
+        .replace(/<subject>/g, (_a = groups['subject']) !== null && _a !== void 0 ? _a : '')
+        .replace(/<KEY>/g, key ? key.toUpperCase() : '<KEY>');
+};
+const targetsForKind = (options) => {
+    const { kind, config, parent, branch } = options;
+    const { development, production } = config.baseBranches;
+    switch (kind) {
+        case 'main-feature':
+            return { expectedBase: development, expectedMrTargets: [development] };
+        case 'sub-feature':
+        case 'release-fix':
+            return { expectedBase: parent, expectedMrTargets: parent ? [parent] : [] };
+        case 'release':
+            return { expectedBase: development, expectedMrTargets: [development, production] };
+        case 'hotfix':
+            return { expectedBase: production, expectedMrTargets: [production] };
+        case 'protected':
+            return { expectedMrTargets: branch === development ? [production] : [development] };
+        default:
+            return { expectedMrTargets: [] };
+    }
+};
+/**
+ * Classifies a branch name against the grammar. Never throws: an unrecognised name comes back as
+ * `kind: 'unknown'` with findings, so the validator and timetrack's correlation engine can read
+ * the same result for different purposes.
+ */
+const parseBranch = (options) => {
+    const { config } = options;
+    const branch = (0, exports.stripRefPrefix)(options.branch);
+    const segments = branch.split('/');
+    const unknown = (message) => ({
+        branch,
+        ok: false,
+        kind: 'unknown',
+        deprecated: false,
+        expectedMrTargets: [],
+        findings: [{ rule: 'unknown-type', message }],
+    });
+    if (!branch || segments.some((segment) => !segment))
+        return unknown(`"${options.branch}" is not a branch name.`);
+    if (branch === config.baseBranches.development || branch === config.baseBranches.production) {
+        return Object.assign({ branch, ok: true, kind: 'protected', deprecated: false, findings: [] }, targetsForKind({ kind: 'protected', config, branch }));
+    }
+    const deprecated = matchDeprecatedShape({ branch, config });
+    if (deprecated) {
+        const suggestion = renameSuggestion(deprecated);
+        return Object.assign({ branch, ok: false, kind: deprecated.shape.kind, subject: deprecated.groups['subject'], deprecated: true, suggestedName: suggestion, findings: [
+                {
+                    rule: 'deprecated-prefix',
+                    message: `"${branch}" uses a deprecated spelling; rename it to ${suggestion}.`,
+                    suggestion,
+                },
+            ] }, targetsForKind({ kind: deprecated.shape.kind, config }));
+    }
+    const [prefix, ...rest] = segments;
+    if (prefix === config.subPrefix)
+        return dropRedundantSuggestion(parseNested({ branch, segments: rest, config }));
+    if (prefix === config.releasePrefix)
+        return dropRedundantSuggestion(parseRelease({ branch, segments: rest, config }));
+    if (prefix === config.hotfixPrefix)
+        return dropRedundantSuggestion(parseHotfix({ branch, segments: rest, config }));
+    return dropRedundantSuggestion(parseFeature({ branch, prefix: prefix !== null && prefix !== void 0 ? prefix : '', segments: rest, config }));
+};
+exports.parseBranch = parseBranch;
+const unrecognised = (options) => ({
+    branch: options.branch,
+    ok: false,
+    kind: 'unknown',
+    deprecated: false,
+    expectedMrTargets: [],
+    findings: [{ rule: 'unknown-type', message: options.message }],
+});
+/**
+ * `sub/<parent path>/<KEY>-<subject>` — the nested shape. The parent's full name is inside the
+ * child's, so the merge request target needs no lookup; only two levels are allowed, so a parent
+ * that is itself nested is not a shape.
+ */
+const parseNested = (options) => {
+    var _a, _b, _c;
+    const { branch, segments, config } = options;
+    const leaf = segments[segments.length - 1];
+    const parent = segments.slice(0, -1).join('/');
+    if (!leaf || !parent) {
+        return unrecognised({ branch, message: `"${branch}" names no parent branch to nest under.` });
+    }
+    const parentParse = (0, exports.parseBranch)({ branch: parent, config });
+    const kind = nestedKindFor(parentParse);
+    if (!kind) {
+        return unrecognised({
+            branch,
+            message: `"${parent}" is not a branch anything can nest under — only a main feature or a release branch is.`,
+        });
+    }
+    const parts = parseSegment({ segment: leaf, config, role: kind === 'release-fix' ? 'bug' : 'task' });
+    const findings = [...parentParse.findings, ...parts.findings];
+    return Object.assign({ branch, ok: findings.length === 0, type: parentParse.type, kind, storyKey: parentParse.storyKey, taskKey: parts.key, issueKey: (_a = parts.key) !== null && _a !== void 0 ? _a : parentParse.storyKey, subject: parts.subject, parent, deprecated: false, findings, suggestedName: parts.key
+            ? (0, build_1.buildBranchName)({
+                spec: { kind, parent: (_b = parentParse.suggestedName) !== null && _b !== void 0 ? _b : parent, key: parts.key, subject: (_c = parts.subject) !== null && _c !== void 0 ? _c : '' },
+                config,
+            })
+            : undefined }, targetsForKind({ kind, config, parent }));
+};
+const nestedKindFor = (parent) => {
+    if (parent.kind === 'release')
+        return 'release-fix';
+    return parent.kind === 'main-feature' && !parent.deprecated ? 'sub-feature' : undefined;
+};
+/**
+ * The spelling the convention was originally written with, `<parent>/<KEY>-<subject>`. It parses so
+ * that `explain` and `repair` can say something useful about it, but it can never exist next to the
+ * parent it names — see `subPrefix`.
+ */
+const nestedTooDeep = (options) => {
+    var _a, _b;
+    const { branch, kind, parent, leaf, config, storyKey, type } = options;
+    const suggestion = leaf.key
+        ? (0, build_1.buildBranchName)({ spec: { kind, parent, key: leaf.key, subject: (_a = leaf.subject) !== null && _a !== void 0 ? _a : '' }, config })
+        : `${config.subPrefix}/${branch}`;
+    return Object.assign({ branch, ok: false, kind,
+        type,
+        storyKey, taskKey: leaf.key, issueKey: (_b = leaf.key) !== null && _b !== void 0 ? _b : storyKey, subject: leaf.subject, parent, deprecated: true, suggestedName: suggestion, findings: [
+            {
+                rule: 'deprecated-prefix',
+                message: `"${branch}" cannot exist while ${parent} does — git rejects a ref that is both a branch and a directory of branches. Use ${suggestion}.`,
+                suggestion,
+            },
+        ] }, targetsForKind({ kind, config, parent }));
+};
+const dropRedundantSuggestion = (result) => result.suggestedName === result.branch ? Object.assign(Object.assign({}, result), { suggestedName: undefined }) : result;
+const parseRelease = (options) => {
+    const { branch, segments, config } = options;
+    const [date, leaf, ...extra] = segments;
+    if (!date || extra.length > 0) {
+        return unrecognised({ branch, message: `"${branch}" is not a release or release-fix branch.` });
+    }
+    const findings = [];
+    if (!new RegExp(`^${config.releasePattern}$`).test(date)) {
+        findings.push({ rule: 'release-date', message: `"${date}" is not a release date (expected YYYY.MM.DD).` });
+    }
+    const parent = `${config.releasePrefix}/${date}`;
+    if (leaf === undefined) {
+        return Object.assign({ branch, ok: findings.length === 0, kind: 'release', deprecated: false, findings }, targetsForKind({ kind: 'release', config }));
+    }
+    return nestedTooDeep({
+        branch,
+        kind: 'release-fix',
+        parent,
+        leaf: parseSegment({ segment: leaf, config, role: 'bug' }),
+        config,
+    });
+};
+const parseHotfix = (options) => {
+    var _a;
+    const { branch, segments, config } = options;
+    const [leaf, ...extra] = segments;
+    if (!leaf || extra.length > 0) {
+        return {
+            branch,
+            ok: false,
+            kind: 'unknown',
+            deprecated: false,
+            expectedMrTargets: [],
+            findings: [{ rule: 'unknown-type', message: `"${branch}" is not a hotfix branch.` }],
+        };
+    }
+    const parts = parseSegment({ segment: leaf, config, role: 'bug' });
+    return Object.assign({ branch, ok: parts.findings.length === 0, kind: 'hotfix', taskKey: parts.key, issueKey: parts.key, subject: parts.subject, deprecated: false, findings: parts.findings, suggestedName: parts.key
+            ? (0, build_1.buildBranchName)({ spec: { kind: 'hotfix', key: parts.key, subject: (_a = parts.subject) !== null && _a !== void 0 ? _a : '' }, config })
+            : undefined }, targetsForKind({ kind: 'hotfix', config }));
+};
+const parseFeature = (options) => {
+    var _a;
+    const { branch, prefix, segments, config } = options;
+    const alias = config.typeAliases[prefix];
+    const type = config.types.includes(prefix) ? prefix : alias;
+    const [story, task, ...extra] = segments;
+    if (!type || !story || extra.length > 0) {
+        return unrecognised({
+            branch,
+            message: `"${branch}" matches no branch shape; expected <type>/<KEY>-<subject> with type one of ${config.types.join(', ')}.`,
+        });
+    }
+    const findings = [];
+    if (alias && prefix !== type) {
+        findings.push({ rule: 'type-alias', message: `"${prefix}/" is an alias; use "${type}/".` });
+    }
+    const storyParts = parseSegment({ segment: story, config, role: 'story' });
+    if (task === undefined) {
+        findings.push(...storyParts.findings);
+        return Object.assign({ branch, ok: findings.length === 0, kind: 'main-feature', type, storyKey: storyParts.key, issueKey: storyParts.key, subject: storyParts.subject, deprecated: false, findings, suggestedName: storyParts.key
+                ? (0, build_1.buildBranchName)({
+                    spec: { kind: 'main-feature', type, key: storyParts.key, subject: (_a = storyParts.subject) !== null && _a !== void 0 ? _a : '' },
+                    config,
+                })
+                : undefined }, targetsForKind({ kind: 'main-feature', config }));
+    }
+    return nestedTooDeep({
+        branch,
+        kind: 'sub-feature',
+        parent: `${prefix}/${story}`,
+        leaf: parseSegment({ segment: task, config, role: 'task' }),
+        config,
+        storyKey: storyParts.key,
+        type,
+    });
+};
+/**
+ * Attributes a keyless branch through the branch it is based on. Reviewed branches land in an
+ * integration branch, so a flat name like `feat/logout-confirmation` usually has a parent that
+ * does carry the story key. Deterministic — no model involved.
+ */
+const resolveThroughBase = (options) => {
+    var _a, _b;
+    const { branch, base } = options;
+    const inherited = (_a = base.storyKey) !== null && _a !== void 0 ? _a : base.taskKey;
+    if (branch.storyKey || !inherited)
+        return branch;
+    return Object.assign(Object.assign({}, branch), { storyKey: inherited, issueKey: (_b = branch.taskKey) !== null && _b !== void 0 ? _b : inherited, inheritedFrom: base.branch });
+};
+exports.resolveThroughBase = resolveThroughBase;
+//# sourceMappingURL=parse.js.map

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

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

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

@@ -0,0 +1,24 @@
+import { GitFlowConfig } from './config';
+export type ConformingName = {
+    ok: true;
+    name: string;
+} | {
+    ok: false;
+    /**
+     * `needs-key` is the only reason a caller can act on: file the issue, then ask again with the
+     * key it returned.
+     */
+    reason: 'already-conforms' | 'needs-key' | 'no-shape';
+};
+/**
+ * The conforming name a non-conforming branch should take, once an issue key exists for it.
+ *
+ * A candidate is returned only after it parses as fully conforming, so a rename always lands on a
+ * name the grammar accepts — `parseBranch`'s own `suggestedName` does not guarantee that for a
+ * nested branch whose leaf names no issue, and half a rename is worse than none.
+ */
+export declare const conformingNameFor: (options: {
+    branch: string;
+    key?: string;
+    config: GitFlowConfig;
+}) => ConformingName;

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

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.conformingNameFor = void 0;
+const build_1 = require("./build");
+const parse_1 = require("./parse");
+const KEY_PLACEHOLDER = '<KEY>';
+/**
+ * The spec that rebuilds a branch whose leaf carries no key at all, which is why `parseBranch` left
+ * `suggestedName` unset. Only the kinds the grammar can spell are here — an unrecognised name names
+ * no kind, and inventing one would rename the branch to something the user never chose.
+ */
+const specFor = (options) => {
+    var _a;
+    const { parse, key } = options;
+    const subject = (_a = parse.subject) !== null && _a !== void 0 ? _a : '';
+    switch (parse.kind) {
+        case 'main-feature':
+            return { kind: 'main-feature', type: parse.type, key, subject };
+        case 'hotfix':
+            return { kind: 'hotfix', key, subject };
+        case 'sub-feature':
+            return parse.parent ? { kind: 'sub-feature', parent: parse.parent, key, subject } : undefined;
+        case 'release-fix':
+            return parse.parent ? { kind: 'release-fix', parent: parse.parent, key, subject } : undefined;
+        default:
+            return undefined;
+    }
+};
+const candidatesFor = (options) => {
+    const { parse, key, config } = options;
+    const suggested = parse.suggestedName;
+    const candidates = [];
+    if (suggested && !suggested.includes(KEY_PLACEHOLDER))
+        candidates.push(suggested);
+    if (key) {
+        if (suggested === null || suggested === void 0 ? void 0 : suggested.includes(KEY_PLACEHOLDER))
+            candidates.push(suggested.replace(/<KEY>/g, key.toUpperCase()));
+        const spec = specFor({ parse, key: key.toUpperCase() });
+        if (spec)
+            candidates.push((0, build_1.buildBranchName)({ spec, config }));
+    }
+    return candidates;
+};
+/**
+ * The conforming name a non-conforming branch should take, once an issue key exists for it.
+ *
+ * A candidate is returned only after it parses as fully conforming, so a rename always lands on a
+ * name the grammar accepts — `parseBranch`'s own `suggestedName` does not guarantee that for a
+ * nested branch whose leaf names no issue, and half a rename is worse than none.
+ */
+const conformingNameFor = (options) => {
+    var _a;
+    const { key, config } = options;
+    const parse = (0, parse_1.parseBranch)({ branch: options.branch, config });
+    if (parse.ok)
+        return { ok: false, reason: 'already-conforms' };
+    for (const name of candidatesFor({ parse, key, config })) {
+        if (name !== parse.branch && (0, parse_1.parseBranch)({ branch: name, config }).ok)
+            return { ok: true, name };
+    }
+    if (key)
+        return { ok: false, reason: 'no-shape' };
+    // Whether a key would help is answered by trying one, using a prefix this repo accepts so the
+    // probe is not rejected by `keyPrefixes` for a reason the real key would not hit.
+    const probe = candidatesFor({ parse, key: `${(_a = config.keyPrefixes[0]) !== null && _a !== void 0 ? _a : 'KEY'}-1`, config });
+    const rebuildable = probe.some((name) => (0, parse_1.parseBranch)({ branch: name, config }).ok);
+    return { ok: false, reason: rebuildable ? 'needs-key' : 'no-shape' };
+};
+exports.conformingNameFor = conformingNameFor;
+//# sourceMappingURL=rename.js.map

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

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

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

@@ -0,0 +1,49 @@
+import { BranchNameSpec } from './build';
+import { GitFlowConfig } from './config';
+import { BranchParseResult } from './parse';
+export type StartPlan = {
+    branch: string;
+    /** The branch to create the new one from. Absent only when `problems` says why. */
+    base?: string;
+    mrTargets: string[];
+    parse: BranchParseResult;
+    /** Empty when the plan is safe to execute; every entry is a reason to refuse. */
+    problems: string[];
+};
+/**
+ * The plan a caller must show before it writes anything: the branch name, the base to branch from
+ * and the merge request target. Built through `buildBranchName` and then re-parsed, so a spec the
+ * grammar cannot express — a key the project's prefixes reject, a parent that is itself
+ * non-conforming — comes back as a problem instead of as a branch somebody has to delete again.
+ */
+export declare const planStart: (options: {
+    spec: BranchNameSpec;
+    config: GitFlowConfig;
+}) => StartPlan;
+/**
+ * The spec for a branch nesting under `parent`. Which of the two nested kinds it is follows from the
+ * parent alone, so no caller has to decide it: a release branch takes fixes, anything else takes
+ * sub-features.
+ */
+export declare const nestedSpecFor: (options: {
+    parent: string;
+    key: string;
+    subject: string;
+    config: GitFlowConfig;
+}) => BranchNameSpec;
+/**
+ * The branches a story's sub-features may nest under, out of a list of names.
+ *
+ * A sub-feature's parent is a branch name and not an issue, because the nested spelling keeps the
+ * parent's full path inside the child's — so this, and not a Jira lookup, is what says whether a
+ * Task can be started at all. A deprecated spelling is never a candidate: a child nested under a
+ * name that is about to be repaired would have to be renamed with it.
+ *
+ * More than one match is returned rather than resolved. Which of two feature branches a story means
+ * is not something a grammar can answer, and picking one would put the work on the wrong branch.
+ */
+export declare const featureBranchesFor: (options: {
+    branches: readonly string[];
+    storyKey: string;
+    config: GitFlowConfig;
+}) => string[];

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

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.featureBranchesFor = exports.nestedSpecFor = exports.planStart = void 0;
+const build_1 = require("./build");
+const parse_1 = require("./parse");
+/**
+ * The plan a caller must show before it writes anything: the branch name, the base to branch from
+ * and the merge request target. Built through `buildBranchName` and then re-parsed, so a spec the
+ * grammar cannot express — a key the project's prefixes reject, a parent that is itself
+ * non-conforming — comes back as a problem instead of as a branch somebody has to delete again.
+ */
+const planStart = (options) => {
+    const { spec, config } = options;
+    const branch = (0, build_1.buildBranchName)({ spec, config });
+    const parse = (0, parse_1.parseBranch)({ branch, config });
+    const problems = [
+        ...(parse.kind === spec.kind ? [] : [`"${branch}" parses as ${parse.kind}, not ${spec.kind}.`]),
+        ...parse.findings.map((finding) => finding.message),
+        ...(parse.expectedBase ? [] : [`"${branch}" has no base branch to branch from.`]),
+    ];
+    return { branch, base: parse.expectedBase, mrTargets: parse.expectedMrTargets, parse, problems };
+};
+exports.planStart = planStart;
+/**
+ * The spec for a branch nesting under `parent`. Which of the two nested kinds it is follows from the
+ * parent alone, so no caller has to decide it: a release branch takes fixes, anything else takes
+ * sub-features.
+ */
+const nestedSpecFor = (options) => {
+    const { parent, key, subject, config } = options;
+    const kind = (0, parse_1.parseBranch)({ branch: parent, config }).kind === 'release' ? 'release-fix' : 'sub-feature';
+    return { kind, parent, key, subject };
+};
+exports.nestedSpecFor = nestedSpecFor;
+/**
+ * The branches a story's sub-features may nest under, out of a list of names.
+ *
+ * A sub-feature's parent is a branch name and not an issue, because the nested spelling keeps the
+ * parent's full path inside the child's — so this, and not a Jira lookup, is what says whether a
+ * Task can be started at all. A deprecated spelling is never a candidate: a child nested under a
+ * name that is about to be repaired would have to be renamed with it.
+ *
+ * More than one match is returned rather than resolved. Which of two feature branches a story means
+ * is not something a grammar can answer, and picking one would put the work on the wrong branch.
+ */
+const featureBranchesFor = (options) => {
+    const { branches, config } = options;
+    const storyKey = options.storyKey.toUpperCase();
+    return [...new Set(branches.map(parse_1.stripRefPrefix))]
+        .filter((branch) => {
+        const parse = (0, parse_1.parseBranch)({ branch, config });
+        return parse.kind === 'main-feature' && !parse.deprecated && parse.storyKey === storyKey;
+    })
+        .sort();
+};
+exports.featureBranchesFor = featureBranchesFor;
+//# sourceMappingURL=start.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../../../../../libs/agent-rules/src/lib/git-flow/start.ts"],"names":[],"mappings":";;;AAAA,mCAA0D;AAE1D,mCAAyE;AAYzE;;;;;GAKG;AACI,MAAM,SAAS,GAAG,CAAC,OAAwD,EAAa,EAAE;IAC/F,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACjC,MAAM,MAAM,GAAG,IAAA,uBAAe,EAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,IAAA,mBAAW,EAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAE9C,MAAM,QAAQ,GAAG;QACf,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,eAAe,KAAK,CAAC,IAAI,SAAS,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAC/F,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;QACnD,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,sCAAsC,CAAC,CAAC;KAClF,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,YAAY,EAAE,SAAS,EAAE,KAAK,CAAC,iBAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACnG,CAAC,CAAC;AAZW,QAAA,SAAS,aAYpB;AAEF;;;;GAIG;AACI,MAAM,aAAa,GAAG,CAAC,OAK7B,EAAkB,EAAE;IACnB,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACjD,MAAM,IAAI,GAAG,IAAA,mBAAW,EAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC;IAExG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AACxC,CAAC,CAAC;AAVW,QAAA,aAAa,iBAUxB;AAEF;;;;;;;;;;GAUG;AACI,MAAM,kBAAkB,GAAG,CAAC,OAIlC,EAAE,EAAE;IACH,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAEhD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,sBAAc,CAAC,CAAC,CAAC;SAC9C,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAG,IAAA,mBAAW,EAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAE9C,OAAO,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC;IAC3F,CAAC,CAAC;SACD,IAAI,EAAE,CAAC;AACZ,CAAC,CAAC;AAfW,QAAA,kBAAkB,sBAe7B"}