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

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

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./build"), exports);
+__exportStar(require("./config"), exports);
+__exportStar(require("./parse"), exports);
+__exportStar(require("./rename"), exports);
+__exportStar(require("./start"), exports);
+__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,0CAAwB;AACxB,2CAAyB;AACzB,0CAAwB;AACxB,2CAAyB;AACzB,0CAAwB;AACxB,6CAA2B"}

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,300 @@
+"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;
+const hasKeyPrefix = (options) => {
+    var _a;
+    const key = (_a = options.key) === null || _a === void 0 ? void 0 : _a.toUpperCase();
+    const prefix = options.prefix.toUpperCase();
+    return !!(key === null || key === void 0 ? void 0 : key.startsWith(prefix)) && !/[A-Z0-9]/.test(key.charAt(prefix.length));
+};
+/**
+ * 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) => {
+    var _a, _b;
+    const { segment, config, role } = options;
+    const match = new RegExp(`^(?<etKey>${config.keyPattern})(?:-(?<etSubject>.*))?$`, 'i').exec(segment);
+    const rawKey = (_a = match === null || match === void 0 ? void 0 : match.groups) === null || _a === void 0 ? void 0 : _a['etKey'];
+    const known = config.keyPrefixes.length === 0
+        ? !!rawKey && rawKey === rawKey.toUpperCase()
+        : config.keyPrefixes.some((prefix) => hasKeyPrefix({ key: rawKey, prefix }));
+    if (!rawKey || !known) {
+        return {
+            subject: segment || undefined,
+            findings: [{ rule: 'missing-key', message: `"${segment}" carries no ${role} issue key.` }],
+        };
+    }
+    const key = rawKey.toUpperCase();
+    const subject = ((_b = match === null || match === void 0 ? void 0 : match.groups) === null || _b === void 0 ? void 0 : _b['etSubject']) || 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 deprecatedKey = (options) => {
+    const { groups, config } = options;
+    const subject = groups['subject'];
+    if (groups['key'])
+        return { key: groups['key'].toUpperCase(), subject };
+    if (!subject)
+        return { subject };
+    const parts = parseSegment({ segment: subject, config, role: 'story' });
+    return parts.key ? { key: parts.key, subject: parts.subject } : { subject };
+};
+const renameSuggestion = (options) => {
+    const { shape, groups } = options;
+    const key = groups['key'];
+    return shape.renameTo
+        .replace(/<subject>/g, () => { var _a; return (_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 keyed = deprecatedKey({ groups: deprecated.groups, config });
+        const suggestion = renameSuggestion({
+            shape: deprecated.shape,
+            groups: Object.assign(Object.assign({}, deprecated.groups), { key: keyed.key, subject: keyed.subject }),
+        });
+        const keys = deprecated.shape.kind === 'main-feature'
+            ? { storyKey: keyed.key, issueKey: keyed.key }
+            : { taskKey: keyed.key, issueKey: keyed.key };
+        return Object.assign(Object.assign(Object.assign({ branch, ok: false, kind: deprecated.shape.kind }, keys), { subject: keyed.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 = Object.prototype.hasOwnProperty.call(config.typeAliases, prefix)
+        ? config.typeAliases[prefix]
+        : undefined;
+    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"}