@generacy-ai/generacy 0.3.4 → 0.4.0

package/dist/cli/commands/cockpit/merge.js

@@ -0,0 +1,360 @@
+import { Command } from 'commander';
+import { getLogger } from '../../utils/logger.js';
+import { CockpitExit } from './exit.js';
+import { resolveIssueContext } from './resolver.js';
+import { classifyChecks } from './shared/required-checks.js';
+import { buildFailingCheckPayload, serializeFailingCheckJson, } from './shared/failing-check-json.js';
+function toPrCandidates(refs) {
+    return refs.map((r) => ({
+        number: r.number,
+        url: r.url,
+        isDraft: r.draft,
+        headRefName: r.headRefName,
+    }));
+}
+// Workflow labels (`waiting-for:*`, `completed:*`) are issue-scoped per the
+// #807-Q2 label protocol. runMerge reads `completed:validate` from
+// IssueStateResult.labels, never from PullRequestDetail.labels.
+const COMPLETED_VALIDATE_LABEL = 'completed:validate';
+/**
+ * FR-005 — Commander parser for `--pr <number>`. See contracts/pr-flag-cli.md §2.
+ * Throws `CockpitExit(2)` on any malformed input.
+ */
+export function parsePrFlag(input) {
+    const trimmed = input.trim();
+    if (trimmed.length === 0 || !/^\d+$/.test(trimmed)) {
+        throw new CockpitExit(2, `merge: --pr must be a positive integer, got: "${input}"`);
+    }
+    const n = Number.parseInt(trimmed, 10);
+    if (!Number.isSafeInteger(n) || n <= 0) {
+        throw new CockpitExit(2, `merge: --pr must be a positive integer, got: "${input}"`);
+    }
+    return n;
+}
+function parseIssueRef(repo, issue) {
+    const [owner, name] = repo.split('/');
+    if (!owner || !name) {
+        throw new Error(`runMerge: repo must be "owner/name", got: ${repo}`);
+    }
+    return { owner, repo: name, number: issue };
+}
+async function classifyAndDeleteBranch(ctx) {
+    const { gh, pr, issueRef, logger } = ctx;
+    if (pr.headRepositoryOwner != null &&
+        pr.headRepositoryOwner !== issueRef.owner) {
+        logger.info({ pr: pr.number, headRef: pr.head, headOwner: pr.headRepositoryOwner }, 'branch deletion skipped: cross-fork PR');
+        return 'merged (branch delete skipped: cross-fork PR)\n';
+    }
+    const repo = `${issueRef.owner}/${issueRef.repo}`;
+    const result = await gh.deleteHeadRef(repo, pr.head);
+    switch (result.outcome) {
+        case 'deleted':
+            return 'merged and branch deleted\n';
+        case 'already-gone':
+            logger.info({ pr: pr.number, headRef: pr.head }, 'branch was already deleted');
+            return 'merged (branch was already deleted)\n';
+        case 'delete-failed':
+            logger.warn({ pr: pr.number, repo, headRef: pr.head, stderr: result.stderr }, 'branch deletion failed');
+            return `merged (branch delete failed: ${result.stderr ?? ''})\n`;
+    }
+}
+/**
+ * Shared merge-tail helper. Fetches issue state, checks completed:validate,
+ * fetches required checks, classifies, merges, deletes branch. Extracted from
+ * runMerge for reuse by runMergeWithExplicitPr per contracts/pr-flag-cli.md §5.
+ */
+async function assertCompletedValidateAndMerge(input) {
+    const { gh, repo, issue, issueRef, prNumber, logger, exitPolicy, linkMethod, } = input;
+    const refuseExit = exitPolicy === 'pr-flag' ? 3 : 1;
+    const pr = await gh.getPullRequestDetail(repo, prNumber);
+    let issueState;
+    try {
+        issueState = await gh.fetchIssueState(repo, issue);
+    }
+    catch (err) {
+        logger.error({ issue, repo, err }, 'Failed to fetch issue state');
+        return {
+            exitCode: 1,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'unresolved',
+                pr: null,
+                issue: issueRef,
+            })),
+        };
+    }
+    if (issueState.state === 'CLOSED') {
+        logger.error({
+            issue,
+            repo,
+            state: issueState.state,
+            stateReason: issueState.stateReason,
+        }, 'Issue is CLOSED');
+        return {
+            exitCode: refuseExit,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'unresolved',
+                pr: { number: pr.number, url: pr.url },
+                issue: {
+                    ...issueRef,
+                    state: issueState.state,
+                    stateReason: issueState.stateReason,
+                },
+            })),
+        };
+    }
+    if (!issueState.labels.includes(COMPLETED_VALIDATE_LABEL)) {
+        logger.error({ issue, repo, missingLabel: COMPLETED_VALIDATE_LABEL }, 'Issue missing completed:validate label');
+        const prPayload = linkMethod !== undefined
+            ? { number: pr.number, url: pr.url, linkMethod }
+            : // `missing-label` builder invariant I-9 requires linkMethod. Use the
+                // dedicated pr-flag `missing-label` payload variant: since the shared
+                // builder requires linkMethod for `missing-label`, we synthesize a
+                // sentinel for the pr-flag path so both share the schema shape.
+                { number: pr.number, url: pr.url, linkMethod: 'closing-refs' };
+        return {
+            exitCode: refuseExit,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'missing-label',
+                pr: prPayload,
+                issue: issueRef,
+            })),
+        };
+    }
+    const [required, actualChecks] = await Promise.all([
+        gh.getRequiredCheckNames(repo, pr.base),
+        gh.getPullRequestCheckRuns(repo, pr.number),
+    ]);
+    if (required.source === 'fallback-pr-checks') {
+        logger.warn('required-check set derived from PR check list; token cannot read branch protection');
+    }
+    const noActual = actualChecks.length === 0;
+    const noRequired = required.source === 'branch-protection'
+        ? (required.names?.length ?? 0) === 0
+        : true;
+    if (noActual && noRequired) {
+        await gh.mergePullRequest(repo, pr.number, { squash: true });
+        logger.info({ pr: pr.number }, 'PR merged');
+        const deletionSuffix = await classifyAndDeleteBranch({
+            gh,
+            pr,
+            issueRef,
+            logger,
+        });
+        return {
+            exitCode: 0,
+            stdout: 'no checks configured and none required — proceeding on completed:validate\n' +
+                deletionSuffix,
+            prNumber: pr.number,
+        };
+    }
+    const { failingChecks, ok } = classifyChecks({ required, actual: actualChecks });
+    if (!ok) {
+        logger.error({ pr: pr.number, failing: failingChecks.length }, 'PR has failing or pending required checks');
+        const prPayload = linkMethod !== undefined
+            ? { number: pr.number, url: pr.url, linkMethod }
+            : { number: pr.number, url: pr.url, linkMethod: 'closing-refs' };
+        return {
+            exitCode: refuseExit,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'checks-failing',
+                pr: prPayload,
+                failingChecks,
+                issue: issueRef,
+            })),
+        };
+    }
+    await gh.mergePullRequest(repo, pr.number, { squash: true });
+    logger.info({ pr: pr.number }, 'PR merged');
+    const deletionSuffix = await classifyAndDeleteBranch({
+        gh,
+        pr,
+        issueRef,
+        logger,
+    });
+    return { exitCode: 0, stdout: deletionSuffix, prNumber: pr.number };
+}
+export async function runMerge(input) {
+    const { gh, issue, repo, logger } = input;
+    const issueRef = parseIssueRef(repo, issue);
+    const resolution = await gh.resolveIssueToPRRef(repo, issue);
+    if (resolution.kind === 'unresolved') {
+        logger.error({ issue, repo }, 'No PR resolved for issue');
+        return {
+            exitCode: 1,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'unresolved',
+                pr: null,
+                issue: issueRef,
+            })),
+        };
+    }
+    // #928 — the caller's `<issue>` argument is itself a PR node. Emit a
+    // typed refusal at exit-2 with guidance copy; the MCP envelope maps this
+    // reason to `class: 'wrong-kind'`. Closes #906 on the CLI at the same time.
+    if (resolution.kind === 'pr-number') {
+        logger.error({ issue, repo }, `#${issue} is a pull request, not an issue`);
+        return {
+            exitCode: 2,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'pr-number',
+                pr: null,
+                issue: issueRef,
+                hint: `#${issue} is a pull request; pass the issue number ` +
+                    `(e.g. the issue whose closing PR is #${issue}).`,
+            })),
+        };
+    }
+    if (resolution.kind === 'pr-is-draft') {
+        logger.error({
+            issue,
+            repo,
+            linkMethod: resolution.linkMethod,
+            candidates: resolution.candidates.map((c) => c.number),
+        }, 'Resolved PRs are drafts');
+        return {
+            exitCode: 1,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'pr-is-draft',
+                pr: null,
+                candidates: toPrCandidates(resolution.candidates),
+                linkMethod: resolution.linkMethod,
+                issue: issueRef,
+            })),
+        };
+    }
+    if (resolution.kind === 'ambiguous') {
+        logger.error({
+            issue,
+            repo,
+            linkMethod: resolution.linkMethod,
+            candidates: resolution.candidates.map((c) => c.number),
+        }, 'Multiple PRs resolved for issue');
+        return {
+            exitCode: 1,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'ambiguous-resolution',
+                pr: null,
+                candidates: toPrCandidates(resolution.candidates),
+                linkMethod: resolution.linkMethod,
+                issue: issueRef,
+            })),
+        };
+    }
+    // Exhaustiveness guard — after the branches above, resolution.kind is
+    // 'resolved'. Adding a new arm to PullRequestRefResolution surfaces here
+    // at build time.
+    const _exhaustive = resolution.kind;
+    void _exhaustive;
+    const prRef = resolution.ref;
+    const linkMethod = resolution.linkMethod;
+    // FR-004: log the resolved PR + tier BEFORE any subsequent gh call so a
+    // later failure never erases the evidence of which PR was targeted.
+    logger.info({ pr: prRef.number, linkMethod }, `resolved PR #${prRef.number} via ${linkMethod}`);
+    return assertCompletedValidateAndMerge({
+        gh,
+        repo,
+        issue,
+        issueRef,
+        prNumber: prRef.number,
+        logger,
+        exitPolicy: 'resolver',
+        linkMethod,
+    });
+}
+/**
+ * FR-005..FR-008 — `--pr <number>` escape hatch. Skips the tier-1/2/3 resolver
+ * chain but keeps every safety precondition. Gate order per contracts/pr-flag-cli.md §3.
+ */
+export async function runMergeWithExplicitPr(input) {
+    const { gh, issue, repo, prNumber, logger } = input;
+    const issueRef = parseIssueRef(repo, issue);
+    const pr = await gh.getPullRequestGraphqlDetail(repo, prNumber);
+    // Gate 1 — FR-006a linkage.
+    const declares = pr.closingIssuesReferences.some((l) => l.nameWithOwner === repo && l.number === issue);
+    if (!declares) {
+        const kind = pr.closingIssuesReferences.length === 0 ? 'empty-refs' : 'mismatch';
+        const message = kind === 'empty-refs'
+            ? `--pr ${prNumber} refused: PR #${prNumber} declares no closing issues. Add ${repo}#${issue} via the PR's Development sidebar link, then re-run.`
+            : `--pr ${prNumber} refused: PR #${prNumber} does not declare ${repo}#${issue} as a closing issue. Add ${repo}#${issue} via the PR's Development sidebar link, then re-run.`;
+        logger.error({ pr: prNumber, issue, repo, kind }, `--pr linkage refused: ${kind}`);
+        return {
+            exitCode: 3,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'pr-flag-linkage-refused',
+                pr: { number: prNumber, url: '' },
+                kind,
+                message,
+                issue: issueRef,
+            })),
+        };
+    }
+    // Gate 2 — FR-006b state classifier.
+    if (pr.state === 'MERGED') {
+        logger.info({ pr: prNumber }, `PR #${prNumber} already merged, no-op`);
+        return {
+            exitCode: 0,
+            stdout: `PR #${prNumber} already merged, no-op\n`,
+            prNumber,
+        };
+    }
+    if (pr.state === 'CLOSED') {
+        logger.error({ pr: prNumber }, 'PR is closed without merge');
+        return {
+            exitCode: 3,
+            stdout: serializeFailingCheckJson(buildFailingCheckPayload({
+                reason: 'pr-flag-closed-unmerged',
+                pr: { number: prNumber, url: '' },
+                message: `--pr ${prNumber} refused: PR #${prNumber} is closed without merge.`,
+                issue: issueRef,
+            })),
+        };
+    }
+    // state === 'OPEN' → continue.
+    // Gates 3 & 4 — delegate to shared tail with pr-flag exitPolicy.
+    return assertCompletedValidateAndMerge({
+        gh,
+        repo,
+        issue,
+        issueRef,
+        prNumber,
+        logger,
+        exitPolicy: 'pr-flag',
+    });
+}
+export function cockpitMergeCommand() {
+    const cmd = new Command('merge');
+    cmd
+        .description('Squash-merge the PR for <issue> iff it carries completed:validate and every required check is green')
+        .argument('<issue>', 'GitHub issue number')
+        .option('--repo <repo>', 'Owner/name (inferred from cwd if absent)')
+        .option('--pr <number>', 'Escape hatch — target this PR directly, skipping issue→PR resolution. ' +
+        '<issue> remains required as the authorization source for completed:validate. ' +
+        'Enforces linkage verification and all safety preconditions; never bypasses safety.', parsePrFlag)
+        .action(async (issueArg, opts) => {
+        const logger = getLogger();
+        const ctx = await resolveIssueContext({
+            issue: issueArg,
+            repo: opts.repo,
+        });
+        const result = opts.pr != null
+            ? await runMergeWithExplicitPr({
+                gh: ctx.gh,
+                issue: ctx.ref.number,
+                repo: ctx.repo,
+                prNumber: opts.pr,
+                logger,
+            })
+            : await runMerge({
+                gh: ctx.gh,
+                issue: ctx.ref.number,
+                repo: ctx.repo,
+                logger,
+            });
+        if (result.stdout.length > 0) {
+            process.stdout.write(result.stdout);
+        }
+        process.exit(result.exitCode);
+    });
+    return cmd;
+}
+//# sourceMappingURL=merge.js.map

package/dist/cli/commands/cockpit/merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.js","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/merge.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/cockpit/plan-dependency-extractor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Extracts declared cross-issue dependencies from a spec's `plan.md` file.
+ *
+ * v1 heuristic (contracts/plan-dependency-warning.md §Extractor):
+ *   - Trigger verbs: `must be merged`, `must merge first`, `depends on`, `depends-on`,
+ *     `requires`, `extends`, `blocked by`, `prerequisite`.
+ *   - Extract `#\d+` (bare) → `{ defaultOwner, defaultRepo, N }`
+ *   - Extract `[\w-]+/[\w-]+#\d+` → cross-repo
+ *   - Search the trigger line PLUS the immediately-following line (wrapping tolerance).
+ *   - Skip fenced code blocks (` ``` `) and inline code (backticks).
+ *   - De-duplicate by `owner/repo/number`, preserving first-occurrence order.
+ *
+ * `originatingText` is derived from the trigger line, bounded to 120 chars.
+ */
+export interface DependencyRef {
+    owner: string;
+    repo: string;
+    number: number;
+    /** The originating span from the plan.md line (bounded to 120 chars). */
+    originatingText: string;
+}
+/**
+ * Extract dependency refs from `plan.md` markdown.
+ *
+ * @param planMarkdown Raw markdown body.
+ * @param defaultOwner Owner for bare `#N` refs (typically the current issue's owner).
+ * @param defaultRepo Repo for bare `#N` refs (typically the current issue's repo).
+ */
+export declare function extractPlanDependencies(planMarkdown: string, defaultOwner: string, defaultRepo: string): DependencyRef[];
+//# sourceMappingURL=plan-dependency-extractor.d.ts.map

package/dist/cli/commands/cockpit/plan-dependency-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-dependency-extractor.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/plan-dependency-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,eAAe,EAAE,MAAM,CAAC;CACzB;AAsCD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,aAAa,EAAE,CAuFjB"}

package/dist/cli/commands/cockpit/plan-dependency-extractor.js

@@ -0,0 +1,135 @@
+/**
+ * Extracts declared cross-issue dependencies from a spec's `plan.md` file.
+ *
+ * v1 heuristic (contracts/plan-dependency-warning.md §Extractor):
+ *   - Trigger verbs: `must be merged`, `must merge first`, `depends on`, `depends-on`,
+ *     `requires`, `extends`, `blocked by`, `prerequisite`.
+ *   - Extract `#\d+` (bare) → `{ defaultOwner, defaultRepo, N }`
+ *   - Extract `[\w-]+/[\w-]+#\d+` → cross-repo
+ *   - Search the trigger line PLUS the immediately-following line (wrapping tolerance).
+ *   - Skip fenced code blocks (` ``` `) and inline code (backticks).
+ *   - De-duplicate by `owner/repo/number`, preserving first-occurrence order.
+ *
+ * `originatingText` is derived from the trigger line, bounded to 120 chars.
+ */
+const TRIGGER_VERBS = [
+    'must be merged',
+    'must merge first',
+    'depends on',
+    'depends-on',
+    'requires',
+    'extends',
+    'blocked by',
+    'prerequisite',
+];
+const CROSS_REPO_REF = /([A-Za-z0-9][\w-]*)\/([A-Za-z0-9][\w-]*)#(\d+)/g;
+const BARE_REF = /#(\d+)/g;
+const ORIGINATING_TEXT_MAX = 120;
+/**
+ * Strip inline code spans (`...`) from a line so bare-ref regex doesn't match inside them.
+ *
+ * Handles the simple case of paired backticks; unpaired backticks are preserved.
+ */
+function stripInlineCode(line) {
+    return line.replace(/`[^`\n]*`/g, '');
+}
+function boundOriginatingText(line) {
+    const trimmed = line.trim();
+    if (trimmed.length <= ORIGINATING_TEXT_MAX)
+        return trimmed;
+    return trimmed.slice(0, ORIGINATING_TEXT_MAX);
+}
+function lineHasTrigger(line) {
+    const lower = line.toLowerCase();
+    return TRIGGER_VERBS.some((v) => lower.includes(v));
+}
+/**
+ * Extract dependency refs from `plan.md` markdown.
+ *
+ * @param planMarkdown Raw markdown body.
+ * @param defaultOwner Owner for bare `#N` refs (typically the current issue's owner).
+ * @param defaultRepo Repo for bare `#N` refs (typically the current issue's repo).
+ */
+export function extractPlanDependencies(planMarkdown, defaultOwner, defaultRepo) {
+    const lines = planMarkdown.split('\n');
+    const results = [];
+    const seen = new Set();
+    let inFence = false;
+    for (let i = 0; i < lines.length; i++) {
+        const rawLine = lines[i];
+        const trimmed = rawLine.trim();
+        // Toggle fenced-code-block state on ``` boundaries.
+        if (trimmed.startsWith('```')) {
+            inFence = !inFence;
+            continue;
+        }
+        if (inFence)
+            continue;
+        if (!lineHasTrigger(rawLine))
+            continue;
+        // Wrap tolerance: also scan the following non-fence line (if any).
+        const triggerLine = stripInlineCode(rawLine);
+        let followingLine = '';
+        if (i + 1 < lines.length) {
+            const nextRaw = lines[i + 1];
+            // Stop before a fenced-code boundary.
+            if (!nextRaw.trim().startsWith('```')) {
+                followingLine = stripInlineCode(nextRaw);
+            }
+        }
+        const searchSpan = `${triggerLine}\n${followingLine}`;
+        const originatingText = boundOriginatingText(rawLine);
+        // Cross-repo mentions first (they consume the trailing `#N`).
+        const crossRepoMatches = [];
+        CROSS_REPO_REF.lastIndex = 0;
+        let m;
+        while ((m = CROSS_REPO_REF.exec(searchSpan)) !== null) {
+            const num = Number.parseInt(m[3], 10);
+            if (Number.isFinite(num) && num > 0) {
+                crossRepoMatches.push({
+                    owner: m[1],
+                    repo: m[2],
+                    number: num,
+                    matchStart: m.index,
+                    matchEnd: m.index + m[0].length,
+                });
+            }
+        }
+        for (const cr of crossRepoMatches) {
+            const key = `${cr.owner}/${cr.repo}#${cr.number}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                results.push({
+                    owner: cr.owner,
+                    repo: cr.repo,
+                    number: cr.number,
+                    originatingText,
+                });
+            }
+        }
+        // Bare `#N` — must not be part of a cross-repo match already consumed.
+        BARE_REF.lastIndex = 0;
+        while ((m = BARE_REF.exec(searchSpan)) !== null) {
+            const matchStart = m.index;
+            const matchEnd = matchStart + m[0].length;
+            const insideCrossRepo = crossRepoMatches.some((cr) => matchStart >= cr.matchStart && matchEnd <= cr.matchEnd);
+            if (insideCrossRepo)
+                continue;
+            const num = Number.parseInt(m[1], 10);
+            if (!Number.isFinite(num) || num <= 0)
+                continue;
+            const key = `${defaultOwner}/${defaultRepo}#${num}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            results.push({
+                owner: defaultOwner,
+                repo: defaultRepo,
+                number: num,
+                originatingText,
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=plan-dependency-extractor.js.map

package/dist/cli/commands/cockpit/plan-dependency-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-dependency-extractor.js","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/plan-dependency-extractor.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/cockpit/queue.d.ts

@@ -0,0 +1,85 @@
+/**
+ * `generacy cockpit queue <epic-ref> <phase>` — enqueue every eligible ref
+ * listed under the matched `### <phase>` heading in the epic body.
+ *
+ * Pipeline:
+ *   1. resolveEpic(epicRef) → matchPhaseHeading(phase).
+ *   2. Per ref in the matched phase: gh issue view → classifyRow → eligible or [SKIP: …].
+ *   3. Print preview; if !--yes, prompt; on confirm, assign + label best-effort.
+ */
+import { Command } from 'commander';
+import { loadCockpitConfig, type CommandRunner, type GhWrapper, type IssueRef, type ParsedPhase, type ResolvedEpic } from '@generacy-ai/cockpit';
+import { type DependencyRef } from './plan-dependency-extractor.js';
+export interface QueueOptions {
+    label?: string;
+    repo?: string;
+    assignee?: string;
+    yes?: boolean;
+}
+export type EligibilityStatus = {
+    kind: 'eligible';
+    workflowLabel: string;
+} | {
+    kind: 'skip';
+    reason: 'closed' | 'cross-repo' | 'already-labeled' | 'not-found';
+};
+export type MutationOutcome = {
+    kind: 'ok';
+} | {
+    kind: 'already';
+} | {
+    kind: 'error';
+    reason: string;
+};
+/** Warning state observed at queue time for a plan.md-declared dependency (#864). */
+export type DependencyWarningState = 'unresolved' | 'closed-unmerged';
+export interface DependencyWarning {
+    ref: DependencyRef;
+    state: DependencyWarningState;
+}
+export interface QueueRow {
+    ref: IssueRef;
+    title: string;
+    labels: string[];
+    assignees: string[];
+    eligibility: EligibilityStatus;
+    /**
+     * Present only when eligibility.kind === 'eligible', the phase heading matches
+     * /implement/i, and plan.md-declared prerequisites are not yet merged (#864).
+     */
+    dependencyWarnings?: DependencyWarning[];
+    assignResult?: MutationOutcome;
+    labelResult?: MutationOutcome;
+}
+export interface QueueResult {
+    epic: ResolvedEpic;
+    phase: ParsedPhase;
+    targetRepo: string;
+    workflowLabel: string;
+    assignee: string;
+    rows: QueueRow[];
+    confirmed: boolean;
+    exitCode: 0 | 1 | 2;
+}
+/**
+ * Fetches the raw `plan.md` for a given issue via the GitHub API.
+ * Returns `null` when the file (or spec directory) doesn't exist yet.
+ */
+export type PlanFetcher = (ref: IssueRef) => Promise<string | null>;
+export interface QueueCommandDeps {
+    runner?: CommandRunner;
+    gh?: GhWrapper;
+    cockpitGh?: GhWrapper;
+    loadConfig?: typeof loadCockpitConfig;
+    env?: NodeJS.ProcessEnv;
+    prompt?: (message: string) => Promise<boolean>;
+    stdout?: (line: string) => void;
+    stderr?: (line: string) => void;
+    /** Optional plan.md fetcher — defaults to a `gh api` call via `deps.runner`. */
+    fetchPlan?: PlanFetcher;
+}
+export declare function renderPreview(epic: ResolvedEpic, phase: ParsedPhase, targetRepo: string, workflowLabel: string, assignee: string, rows: QueueRow[]): string[];
+export declare function renderSummary(rows: QueueRow[]): string[];
+export declare function runQueue(epicRef: string | undefined, phaseArg: string | undefined, opts: QueueOptions, deps: QueueCommandDeps): Promise<QueueResult>;
+export declare function queueCommand(deps?: QueueCommandDeps): Command;
+//# sourceMappingURL=queue.d.ts.map

package/dist/cli/commands/cockpit/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/cockpit/queue.ts"],"names":[],"mappings":"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"}