@specship/specship-win32-arm64 0.21.2 → 0.22.0

package/lib/dist/jira/regression-pack.d.ts

@@ -0,0 +1,547 @@
+/**
+ * Regression pack builder + upsert (JIRA-REGRESSION-DOC, REQ-JIRAREG-001).
+ *
+ * Reads the loaded spec set, filters to requirements whose acceptance-side
+ * link roll-up counts as implemented or verified (at least one implements-kind
+ * link on the requirement or one of its acceptance children reads implemented
+ * or verified), and expands each `REQ-*.A<N>` into a regression case grouped by
+ * a domain area. Domain-area derivation is REQ-JIRAREG-002's concern — this
+ * module files every case under the single `Uncategorised` placeholder area;
+ * `groupCasesByDomain` is a trivial passthrough so REQ-JIRAREG-002 has one
+ * seam to enrich later.
+ *
+ * The upsert side is a fingerprint-gated idempotent writer, mirroring
+ * `publish.ts`: one watermarked epic per project (found by label, never
+ * created twice), one Story per domain area (found by label), one Sub-task
+ * per case (found by label). Fingerprint drift on the rendered body drives
+ * create / update / skip.
+ *
+ * SECURITY (REQ-JIRA-009): only public keys + spec-derived text ever travel
+ * through here — no credential is handled or echoed.
+ */
+import type { Node, Spec, SpecLink, SpecLinkState } from '../types';
+import { type MilestoneJiraClient, type PostMilestoneResult, type PackRunEvidence } from './milestone-comment';
+/** One regression case — one acceptance criterion of an implemented spec. */
+export interface RegressionCase {
+    /** The requirement id, e.g. `REQ-FOO-001`. */
+    reqId: string;
+    /** The acceptance criterion id, e.g. `REQ-FOO-001.A2`. */
+    criterionId: string;
+    /** The criterion text (bullet body / title). */
+    criterionText: string;
+    /** The requirement spec's source path (repo-relative). */
+    specPath: string;
+    /**
+     * Behaviour tier derived from the requirement's behaviour surface
+     * (REQ-JIRAREG-004.A2): `'ui'` iff any linked or neighbour node is a
+     * component / lives in a front-end file, otherwise `'backend'`.
+     * `'unknown'` is retained for callers that construct cases without a
+     * graph in reach (fixtures, dry planners) — never emitted by
+     * {@link buildRegressionPack} which always resolves a concrete tier.
+     */
+    tier: 'ui' | 'backend' | 'unknown';
+    /**
+     * True when the criterion body is too vague to execute against, or leaks
+     * code-shaped tokens (paths, symbols) the black-box pack must not echo
+     * (REQ-JIRAREG-004.A3). The case is still emitted so the pack stays
+     * complete; the report drives a human rephrase pass.
+     */
+    needsRephrase?: boolean;
+    /** Free-text reason surfaced by {@link renderRephraseReport}. */
+    rephraseReason?: string;
+    /**
+     * Domain area label for THIS case row — the area under which the case files.
+     * A requirement with two domain facts produces two `RegressionCase` rows: an
+     * `executable` under the first area and a `crossref` under the second.
+     */
+    domainArea: string;
+    /**
+     * All domain areas the requirement links to (sorted by domain spec id).
+     * Same list on every case row derived from the requirement — useful for the
+     * cross-reference body pointing back at siblings.
+     */
+    areasAll: string[];
+    /**
+     * `'executable'` files as the primary case in the requirement's first area.
+     * `'crossref'` files as a pointer in each additional area — same spec, no
+     * duplicate steps — so a tester scanning either area finds the case.
+     */
+    kind: 'executable' | 'crossref';
+    /**
+     * When `kind === 'crossref'`, the criterion id of the executable sibling
+     * (always equals `criterionId` — the cross-ref carries the same source id;
+     * this field lets renderers name the pair without recomputing).
+     */
+    crossReferenceOf?: string;
+}
+export interface EpicPlan {
+    summary: string;
+    description: string;
+    label: string;
+}
+export interface StoryPlan {
+    domainArea: string;
+    summary: string;
+    description: string;
+    label: string;
+    cases: CasePlan[];
+}
+export interface CasePlan {
+    reqId: string;
+    criterionId: string;
+    summary: string;
+    description: string;
+    label: string;
+    specPath: string;
+    /** `'executable'` or `'crossref'` — cross-refs carry a different label prefix. */
+    kind: 'executable' | 'crossref';
+    /** Tier label attached alongside the case marker (REQ-JIRAREG-004.A2). */
+    tierLabel: string;
+}
+/** One requirement with no domain-fact linkage — REQ-JIRAREG-002.A2. */
+export interface DomainGap {
+    reqId: string;
+    specPath: string;
+}
+export interface RegressionPackModel {
+    epic: EpicPlan;
+    stories: StoryPlan[];
+    cases: CasePlan[];
+    /**
+     * Requirements that entered the pack with no domain-fact linkage. Rendered
+     * separately by {@link renderDomainGapReport} so the caller can prompt the
+     * `/specship:spec domain` capture flow (REQ-JIRAREG-002.A2).
+     */
+    domainGaps: DomainGap[];
+    /**
+     * Criteria the classifier flagged for human rephrase (REQ-JIRAREG-004.A3) —
+     * vague ("system works correctly") or leaking code-shaped tokens the
+     * black-box body must not echo. Rendered by {@link renderRephraseReport}.
+     */
+    rephraseFlags: RephraseFlag[];
+}
+/** One criterion flagged for rephrase (REQ-JIRAREG-004.A3). */
+export interface RephraseFlag {
+    criterionId: string;
+    specPath: string;
+    reason: string;
+}
+export interface UpsertContext {
+    projectKey: string;
+    /** JIRA issue-type name for the pack epic. Default `Epic`. */
+    epicIssueType?: string;
+    /** JIRA issue-type name for the domain area. Default `Story`. */
+    storyIssueType?: string;
+    /** JIRA issue-type name for a case. Default `Sub-task`. */
+    caseIssueType?: string;
+    /** Dry-run: build the plan, do zero JIRA writes. */
+    dryRun?: boolean;
+}
+export interface UpsertResult {
+    epicKey: string | null;
+    epicCreated: boolean;
+    storiesCreated: number;
+    storiesUpdated: number;
+    storiesSkipped: number;
+    casesCreated: number;
+    casesUpdated: number;
+    casesSkipped: number;
+    /**
+     * Cross-reference sub-tasks (secondary-area pointers, REQ-JIRAREG-002.A1) —
+     * counted separately from executable cases so a re-run's zero-write bar can
+     * be asserted per kind.
+     */
+    crossRefsCreated: number;
+    crossRefsUpdated: number;
+    crossRefsSkipped: number;
+    /**
+     * Cases newly marked obsolete on this run — REQ-JIRAREG-003.A3. A re-run
+     * that finds the same case already carrying the obsolete watermark + label
+     * does not re-count it (REQ-JIRAREG-003.A4).
+     */
+    casesObsoleted: number;
+    /** JIRA keys of cases marked obsolete on this run (in scan order). */
+    obsoletedCaseKeys: string[];
+    /** Extra pack-epic issue keys found under the same label (single-epic invariant). */
+    orphanedEpicKeys: string[];
+    /** Per-case JIRA keys, keyed on `<reqId>.<criterionSuffix>` for back-linking. */
+    caseKeysByCriterion: Record<string, string>;
+}
+export declare const REG_PACK_EPIC_LABEL = "specship-regression-pack";
+export declare const REG_PACK_DOMAIN_LABEL_PREFIX = "specship-regdomain-";
+export declare const REG_PACK_CASE_LABEL_PREFIX = "specship-regcase-";
+/**
+ * Cross-reference sub-tasks (REQ-JIRAREG-002.A1). Distinct prefix from the
+ * executable case label so a re-run finds the same cross-ref in the same area
+ * (idempotent) without conflating it with the primary case.
+ */
+export declare const REG_PACK_XREF_LABEL_PREFIX = "specship-regxref-";
+/**
+ * Stable marker label every regression case carries alongside its per-case
+ * slug label (REQ-JIRAREG-003). JIRA JQL cannot wildcard `labels`, so the
+ * orphan scan queries this fixed label to enumerate every case in the pack
+ * without touching the epic or area stories (which never carry it).
+ */
+export declare const REG_PACK_CASE_MARKER_LABEL = "specship-regcase";
+/**
+ * Board-filterable label attached to cases whose source criterion no longer
+ * exists in the spec set (REQ-JIRAREG-003.A3). A comment alone would be
+ * invisible in a JIRA filter — this label makes `labels = "specship-reg-obsolete"`
+ * a valid JQL query. Never removed automatically.
+ */
+export declare const REG_PACK_OBSOLETE_LABEL = "specship-reg-obsolete";
+/**
+ * Board-filterable tier labels (REQ-JIRAREG-004.A2) — testers can filter a
+ * board to just UI or just backend cases with a single label query. Attached
+ * to every executable + cross-ref case; the same tier is derived once per
+ * requirement so both rows in a two-area case carry the same label.
+ */
+export declare const REG_PACK_TIER_LABEL_UI = "specship-tier-ui";
+export declare const REG_PACK_TIER_LABEL_BACKEND = "specship-tier-backend";
+export declare const REG_PACK_EPIC_WATERMARK = "<!-- specship:regression-pack v1 -->";
+export declare const REG_PACK_STORY_WATERMARK = "<!-- specship:regression-pack:story v1 -->";
+export declare const REG_PACK_CASE_WATERMARK = "<!-- specship:regression-pack:case v1 -->";
+/**
+ * Stable prefix of the obsolete-marker comment (REQ-JIRAREG-003.A3). The
+ * per-run body carries a timestamp, but the idempotency key here does NOT
+ * include the timestamp — a re-run with the same `reason` finds the prior
+ * marker via `body.startsWith(prefix + reason + " -->")` and writes nothing
+ * (REQ-JIRAREG-003.A4).
+ */
+export declare const REG_PACK_OBSOLETE_WATERMARK_PREFIX = "<!-- specship:regobsolete v1";
+export interface BuilderSpecQueries {
+    getAllSpecs(): Spec[];
+    getSpecsByParent(parentId: string): Spec[];
+    getLinksBySpec(specId: string): SpecLink[];
+    /**
+     * Point lookup used by the domain-area walk (REQ-JIRAREG-002). Mirrors
+     * {@link SpecLinkResolver.getInheritedLinks}'s traversal — we need to
+     * resolve each declared spec id (via `parentId` / `metadata.depends_on`) to
+     * a `Spec` so its own dependency chain can be followed to the next hop.
+     */
+    getSpecById(id: string): Spec | undefined | null;
+    /**
+     * Optional graph accessor (REQ-JIRAREG-004.A2): the resolved code nodes a
+     * requirement + its acceptance children link to. Populated by the CLI /
+     * MCP wiring; absent in test fixtures unless a fixture opts in. When
+     * absent, {@link deriveCaseTier} falls back to `'backend'` (never spurious
+     * `'ui'`).
+     */
+    getLinkedNodesForReq?(reqId: string): Node[];
+    /**
+     * Optional graph accessor (REQ-JIRAREG-004.A2): 1-hop caller/callee
+     * neighbours of the given nodes. Widens tier detection so a backend
+     * handler that renders a linked UI component still classifies as UI.
+     */
+    getNeighbourNodes?(nodeIds: readonly string[]): Node[];
+}
+/** Stable fingerprint of a rendered body — mirrors publish.ts. */
+export declare function regressionContentFingerprint(summary: string, description: string): string;
+/**
+ * Read a stored fingerprint from an issue description, or `null` when absent.
+ * The fingerprint travels as `<!-- specship:regfp:<hex> -->` on its own line.
+ */
+export declare function readStoredFingerprint(description: string | undefined | null): string | null;
+/**
+ * Derive a case's tier from the requirement's behaviour surface
+ * (REQ-JIRAREG-004.A2). Delegates the UI/backend split to
+ * {@link computeBehaviourSurface} so the classification stays consistent
+ * with `/ss-behaviour`. A requirement with no linked nodes (or a
+ * fixture-mode sq without graph accessors) resolves to `'backend'` —
+ * never spurious UI.
+ */
+export declare function deriveCaseTier(req: Spec, sq: BuilderSpecQueries): 'ui' | 'backend';
+/**
+ * Classify a criterion body for A3: does it name an observable outcome, and
+ * does it stay in black-box vocabulary? Two failure modes both flag the case
+ * for human rephrase (never silently vague, never leaking file paths /
+ * symbols into the pack):
+ *
+ * 1. **Vague** — no observable verb ("returns", "renders", "MUST", …) and
+ *    no reference to a concrete artefact ("response", "row", …).
+ * 2. **Code-shaped** — the text names a file path (`src/…`), a `.ts` / `.tsx`
+ *    / `.js` / `.jsx` extension, or a backticked identifier
+ *    (CamelCase / snake_case). Black-box cases must not echo white-box
+ *    detail; the flag drives a rephrase pass.
+ *
+ * Deterministic and cheap on purpose — the goal is surfacing the flags,
+ * not scoring prose.
+ */
+export declare function classifyCriterion(text: string): {
+    observable: boolean;
+    reason?: string;
+};
+/**
+ * Render the executable steps + reference section for a case
+ * (REQ-JIRAREG-001.A3, REQ-JIRAREG-004.A1). Black-box body: Steps carry no
+ * file paths, no code symbols, and no `- Spec:` pointer — those are
+ * white-box detail belonging on the source spec, not on the tester's
+ * checklist. The tier lands as a header line (readable) AND as a JIRA label
+ * on the issue (board-filterable, see {@link tierLabel}).
+ */
+export declare function renderCaseSteps(rc: RegressionCase): string;
+/**
+ * Render a cross-reference sub-task body (REQ-JIRAREG-002.A1). Same source
+ * id, no duplicate steps — just a pointer at the executable sibling so a
+ * tester scanning this area finds it. The label is separate so the same
+ * criterion produces one issue per area, and a re-run stays idempotent.
+ */
+export declare function renderCrossReferenceBody(rc: RegressionCase, executableAreaLabel: string): string;
+/**
+ * Render the domain-gap report the caller prints after upsert
+ * (REQ-JIRAREG-002.A2). Empty when there are no gaps.
+ */
+/**
+ * Render the rephrase report (REQ-JIRAREG-004.A3). Empty when zero flags —
+ * the caller conditionally prints it after the pack upsert, mirroring the
+ * domain-gap report shape.
+ */
+export declare function renderRephraseReport(flags: RephraseFlag[]): string;
+export declare function renderDomainGapReport(gaps: DomainGap[]): string;
+/**
+ * Compute the domain areas each requirement inherits transitively, keyed on
+ * requirement id (REQ-JIRAREG-002.A1).
+ *
+ * Direction: domain facts declare `depends_on: REQ-...` (they point AT
+ * requirements, per DOMAIN-KNOWLEDGE-DOC), so a requirement's own spec-tier
+ * chain does NOT reach the domain facts that govern it. We walk in the
+ * OTHER direction — for each `domain` spec, follow its parent /
+ * `metadata.depends_on` chain outward and register that domain fact against
+ * every requirement it reaches.
+ *
+ * This mirrors {@link SpecLinkResolver.getInheritedLinks} — same BFS, same
+ * `sourceSpecIds` traversal, same depth cap ({@link INHERITED_LINK_MAX_DEPTH}).
+ * `sourceSpecIds` is imported from the resolver (single source of truth for
+ * "the spec-tier edges a spec has"), but the walk itself is reproduced here
+ * to keep the regression-pack module free of a `SpecLinkResolver` dependency
+ * (which would require threading `QueryBuilder` all the way through). Per the
+ * approval note, the mirror is deliberate; `BuilderSpecQueries` exposes only
+ * the point-lookup surface it needs (`getAllSpecs`, `getSpecById`) so the
+ * builder stays trivially fixture-able.
+ *
+ * Per-domain-fact BFS is cycle-guarded and depth-capped. Ordering of the
+ * output list is deterministic: domain spec ids sorted lex, deduped.
+ */
+export declare function computeDomainAreasByReqId(sq: BuilderSpecQueries): Map<string, Spec[]>;
+/**
+ * Group cases by their pre-computed `domainArea`. In REQ-JIRAREG-001 every
+ * case was `Uncategorised`; REQ-JIRAREG-002 fills in real domain-fact areas
+ * — same input shape, same output shape, richer bucketing.
+ */
+export declare function groupCasesByDomain(cases: RegressionCase[]): Map<string, RegressionCase[]>;
+/**
+ * Build a full regression pack plan from the loaded spec set (REQ-JIRAREG-001).
+ * Pure — no JIRA calls. Deterministic ordering: requirements sorted by id,
+ * criteria in the order they appear as `acceptance` children of the requirement.
+ */
+export declare function buildRegressionPack(sq: BuilderSpecQueries): RegressionPackModel;
+/** Structural client slice — just enough to run the upsert idempotently. */
+export interface RegressionPackJiraClient {
+    /**
+     * Return every issue in `projectKey` that carries `label`. Empty list on no
+     * match. Called with SpecShip's own labels — `specship-regression-pack`,
+     * `specship-regdomain-<slug>`, `specship-regcase-<slug>` — never user input.
+     */
+    searchIssuesByLabel(projectKey: string, label: string): Promise<Array<{
+        key: string;
+        summary: string;
+    }>>;
+    /**
+     * Fetch a single issue's summary + description + current parent key — for
+     * fingerprint compare AND parent-reassignment no-op decision
+     * (REQ-JIRAREG-002.A3). `parentKey` MAY be `undefined` when the issue has
+     * no parent (a top-level issue or one JIRA didn't return a parent for).
+     */
+    getIssue(key: string): Promise<{
+        ok: true;
+        issue: {
+            key: string;
+            summary: string;
+            description: string;
+            parentKey?: string;
+        };
+    }>;
+    createIssue(fields: {
+        projectKey: string;
+        issueType: string;
+        summary: string;
+        description?: string;
+        parentKey?: string;
+        labels?: string[];
+    }): Promise<{
+        key: string;
+        id: string;
+    }>;
+    /**
+     * Update an issue's summary, description, and/or parent (REQ-JIRAREG-002.A3
+     * needs parent reassignment when a case moves from Uncategorised to its new
+     * area). Callers pass only the fields that changed — a plain `parentKey`
+     * change with no body drift lands a `{ fields: { parent: { key } } }` PUT.
+     */
+    updateIssue(key: string, fields: {
+        summary?: string;
+        description?: string;
+        parentKey?: string;
+    }): Promise<void>;
+    /**
+     * Enumerate an issue's comments with ids (REQ-JIRAREG-003.A3). Used by the
+     * obsolete-marker upsert to check for a prior marker before writing.
+     */
+    listCommentsDetailed(key: string): Promise<Array<{
+        id: string;
+        body: string;
+    }>>;
+    /** Append a comment to an issue (REQ-JIRAREG-003.A3). */
+    addComment(key: string, body: string): Promise<{
+        id: string;
+    } | void>;
+    /**
+     * Add a label to an issue idempotently (REQ-JIRAREG-003.A3 + A4). Returns
+     * `{ added: false }` when the label is already present so a re-run is a
+     * zero-write. Implementations MUST NOT issue a PUT when the label is set.
+     */
+    addLabel(key: string, label: string): Promise<{
+        added: boolean;
+    }>;
+}
+/**
+ * Idempotent regression-pack upsert (REQ-JIRAREG-001, REQ-JIRAREG-003 skeleton).
+ * Walks the model epic → story → case; each level is keyed on its SpecShip
+ * label and its body is fingerprint-gated so a re-run without spec changes
+ * writes nothing new. Extra epics under the pack label are refused (single-epic
+ * invariant, A1) and reported as orphans; the caller decides how to surface.
+ */
+export declare function upsertRegressionPack(client: RegressionPackJiraClient, model: RegressionPackModel, ctx: UpsertContext): Promise<UpsertResult>;
+/**
+ * Enumerate case issues in the pack (via the fixed case marker label) that are
+ * not in `expectedKeys` — the caller's set of case keys just upserted from the
+ * current model. The result is deterministic (sorted lex on key) so re-runs
+ * report obsolete work in the same order.
+ */
+export declare function findOrphanedCases(client: RegressionPackJiraClient, projectKey: string, expectedKeys: Set<string>): Promise<Array<{
+    key: string;
+    summary: string;
+}>>;
+export type MarkObsoleteOutcome = {
+    action: 'obsoleted';
+    commentAdded: boolean;
+    labelAdded: boolean;
+} | {
+    action: 'skipped';
+};
+/**
+ * Mark a case obsolete on JIRA (REQ-JIRAREG-003.A3): attach a stable
+ * watermarked comment naming the reason AND add the board-filterable
+ * `specship-reg-obsolete` label. Both writes are idempotent — a re-run with
+ * the same reason finds the prior marker and adds nothing (A4).
+ *
+ * Never transitions the issue's workflow status (spec-driven correction:
+ * "no workflow transitions by default") and never deletes it — the run
+ * history and any prior evidence stay intact.
+ */
+export declare function markCaseObsolete(client: RegressionPackJiraClient, issueKey: string, reason: string): Promise<MarkObsoleteOutcome>;
+/** The four terminal outcomes a pack run can report per case. */
+export type RegressionRunStatus = 'passed' | 'failed' | 'unexecuted' | 'obsolete';
+/** Who / what executed the case. */
+export type RegressionRunExecutor = 'human' | 'agent';
+/** Optional behaviour-harness identifier for agent-executed cases. */
+export type RegressionRunHarness = 'behaviour-e2e' | 'manual';
+/** One case result recorded by a pack run (REQ-JIRAREG-005). */
+export interface RegressionRunResult {
+    /** JIRA case key (e.g. `PROJ-42`). */
+    caseKey: string;
+    /** Source acceptance criterion id (e.g. `REQ-FOO-001.A2`). */
+    criterionId: string;
+    status: RegressionRunStatus;
+    executor: RegressionRunExecutor;
+    /** Behaviour-harness id when the agent executed the case; omit for manual. */
+    harness?: RegressionRunHarness;
+    /**
+     * Stable run identifier. A single run identifier per suite pass keys the
+     * comment-upsert (one comment per case per runId). Omit only for a one-off
+     * ad-hoc record — the recorder synthesises a timestamped id in that case.
+     */
+    runId?: string;
+    /** Freeform evidence pointers (log lines, error strings — never credentials). */
+    evidence?: {
+        logRef?: string;
+        error?: string;
+    };
+}
+/** Prefix of the recorder-owned comment marker. Body carries the runId + status. */
+export declare const REG_PACK_RUN_MARKER_PREFIX = "<!-- specship:regression-run";
+/**
+ * Structural client slice for the recorder — a superset of the pack upsert
+ * client with the comment-edit + workflow-transition surface.
+ */
+export interface RunResultJiraClient extends MilestoneJiraClient {
+    transitionIssue(key: string, nameOrId: string): Promise<{
+        ok: true;
+        transitioned?: string;
+        skipped?: string;
+        reason?: string;
+    }>;
+}
+/**
+ * Minimal SpecQueries surface the recorder needs to upsert a `validates`
+ * spec-link pointing at the JIRA case as external evidence. Structural so
+ * tests can pass a fixture without wiring the full `SpecQueries` class.
+ */
+export interface RunResultSpecQueries {
+    getSpecById(id: string): Spec | undefined | null;
+    findLogicalLink(specId: string, targetFilePath: string, targetQualifiedName: string, kind: SpecLink['kind']): SpecLink | null;
+    upsertSpecLink(link: Omit<SpecLink, 'id'>): number;
+    updateSpecLinkState(id: number, state: SpecLinkState, driftAxis?: SpecLink['driftAxis'], updatedAt?: number): void;
+}
+export interface RecordRunResultDeps {
+    client: RunResultJiraClient;
+    /** Optional graph writer — omit to skip the spec-link write (comment-only). */
+    specQueries?: RunResultSpecQueries;
+    /** Injectable clock — tests pin the run timestamp. */
+    now?: () => number;
+    /** Workflow transition names to try; use the client's graceful-skip path. */
+    transitions?: {
+        passed?: string;
+        failed?: string;
+    };
+}
+export interface RecordRunResultOutcome {
+    pending: false;
+    status: RegressionRunStatus;
+    /** Whether a `validates`-kind spec_link row was upserted or updated. */
+    linked: boolean;
+    /** Comment upsert outcome. */
+    comment: 'created' | 'updated' | 'skipped';
+    /** Transition outcome — `skipped` covers workflow-graceful skips + unexecuted. */
+    transition: 'moved' | 'skipped';
+    /** Present when status === 'failed'; the triage hand-off shown in the comment. */
+    triageHint?: string;
+}
+/**
+ * Record a pack-run result on a case issue (REQ-JIRAREG-005).
+ *
+ * Idempotent by (caseKey, runId): a second call with the same pair edits the
+ * prior comment in place. Pass → `Done` transition + validates-link state
+ * `verified`. Fail → `In Review` + `broken` + a triage hint line. Unexecuted →
+ * comment only; the case's workflow status and any existing validates-link
+ * state stay untouched (A3). External-evidence links use `jira://<CASE-KEY>`
+ * as the `targetFilePath` — {@link SpecLinkResolver} refuses to re-resolve
+ * that prefix, so a code-graph sync never flips the state to orphaned.
+ */
+export declare function recordRunResult(deps: RecordRunResultDeps, result: RegressionRunResult): Promise<RecordRunResultOutcome>;
+export interface PackRunSummary {
+    runId: string;
+    results: RegressionRunResult[];
+    startedAt?: string;
+    finishedAt?: string;
+}
+/** Aggregate per-result counts + triage list from a run's recorded results. */
+export declare function summarizePackRun(summary: PackRunSummary): PackRunEvidence;
+/**
+ * Close a pack run: post (or edit-in-place) the single summary comment on the
+ * pack epic. The marker keys on the epic + kind — never on the runId — so a
+ * subsequent run's summary edits the prior comment rather than appending
+ * (REQ-JIRAREG-005.A4).
+ */
+export declare function finalizePackRun(client: MilestoneJiraClient, epicKey: string, summary: PackRunSummary): Promise<PostMilestoneResult>;
+//# sourceMappingURL=regression-pack.d.ts.map

package/lib/dist/jira/regression-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regression-pack.d.ts","sourceRoot":"","sources":["../../src/jira/regression-pack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAMpE,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAM7B,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;IACnC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;OAIG;IACH,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC;IAChC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC;IAChC,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB;;;;OAIG;IACH,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB;;;;OAIG;IACH,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B;AAED,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,qFAAqF;IACrF,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,iFAAiF;IACjF,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C;AAMD,eAAO,MAAM,mBAAmB,6BAA6B,CAAC;AAC9D,eAAO,MAAM,4BAA4B,wBAAwB,CAAC;AAClE,eAAO,MAAM,0BAA0B,sBAAsB,CAAC;AAC9D;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,sBAAsB,CAAC;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAE7D;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,0BAA0B,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AACzD,eAAO,MAAM,2BAA2B,0BAA0B,CAAC;AAMnE,eAAO,MAAM,uBAAuB,yCAAyC,CAAC;AAC9E,eAAO,MAAM,wBAAwB,+CAA+C,CAAC;AACrF,eAAO,MAAM,uBAAuB,8CAA8C,CAAC;AAEnF;;;;;;GAMG;AACH,eAAO,MAAM,kCAAkC,iCAAiC,CAAC;AAYjF,MAAM,WAAW,kBAAkB;IACjC,WAAW,IAAI,IAAI,EAAE,CAAC;IACtB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC;IAC3C,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;IAC3C;;;;;OAKG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;IACjD;;;;;;OAMG;IACH,oBAAoB,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC;IAC7C;;;;OAIG;IACH,iBAAiB,CAAC,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;CACxD;AA4DD,kEAAkE;AAClE,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAQzF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAI3F;AAWD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,CAWlF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAkBxF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,cAAc,GAAG,MAAM,CAqB1D;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,cAAc,EAClB,mBAAmB,EAAE,MAAM,GAC1B,MAAM,CAeR;AAuCD;;;GAGG;AACH;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,CAWlE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,CAW/D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,kBAAkB,GACrB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAoDrB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EAAE,GACtB,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAQ/B;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,kBAAkB,GACrB,mBAAmB,CA8IrB;AAMD,4EAA4E;AAC5E,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,mBAAmB,CACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACpD;;;;;OAKG;IACH,QAAQ,CACN,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;QACT,EAAE,EAAE,IAAI,CAAC;QACT,KAAK,EAAE;YACL,GAAG,EAAE,MAAM,CAAC;YACZ,OAAO,EAAE,MAAM,CAAC;YAChB,WAAW,EAAE,MAAM,CAAC;YACpB,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC,CAAC;IACH,WAAW,CAAC,MAAM,EAAE;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzC;;;;;OAKG;IACH,WAAW,CACT,GAAG,EAAE,MAAM,EACX,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACrE,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB;;;OAGG;IACH,oBAAoB,CAClB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IAChD,yDAAyD;IACzD,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACtE;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACnE;AAqFD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,wBAAwB,EAChC,KAAK,EAAE,mBAAmB,EAC1B,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,YAAY,CAAC,CA8GvB;AAMD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,wBAAwB,EAChC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAKlD;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,GACnE;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAE1B;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,wBAAwB,EAChC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,mBAAmB,CAAC,CAyB9B;AAMD,iEAAiE;AACjE,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,CAAC;AAElF,oCAAoC;AACpC,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,OAAO,CAAC;AAEtD,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG,eAAe,GAAG,QAAQ,CAAC;AAE9D,gEAAgE;AAChE,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,oFAAoF;AACpF,eAAO,MAAM,0BAA0B,iCAAiC,CAAC;AAMzE;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,eAAe,CACb,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpF;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;IACjD,eAAe,CACb,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,mBAAmB,EAAE,MAAM,EAC3B,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GACrB,QAAQ,GAAG,IAAI,CAAC;IACnB,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,MAAM,CAAC;IACnD,mBAAmB,CACjB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,aAAa,EACpB,SAAS,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,EACjC,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAAC;CACT;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,+EAA+E;IAC/E,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,6EAA6E;IAC7E,WAAW,CAAC,EAAE;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;IAC5B,wEAAwE;IACxE,MAAM,EAAE,OAAO,CAAC;IAChB,8BAA8B;IAC9B,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3C,kFAAkF;IAClF,UAAU,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA4BD;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,mBAAmB,EACzB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,sBAAsB,CAAC,CAyFjC;AAMD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe,CAoCzE;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAO9B"}