/** * Accepted skips — each AC's acceptance from spec.md, its tasks and the * ledger's `accept-skip` events. * * A person may accept skipping a named check of an AC that cannot be run (no * license, no installation). The ledger keeps who, when, why and their * authorization (see core/tasks/ledger.ts). An accepted skip is never * verification: it does not tick the AC, does not count toward `acs.done`, * and leaves every other requirement of the AC as it was. * * met ticked in spec.md, or met by its tasks, with no waiver * mixed met the same way, plus at least one accepted skip * skipped-accepted not met, at least one accepted skip, and no task that * cites the AC is still open, claimed, blocked or stale * open anything else; its accepted skips are still listed * * The ledger has no per-check pass receipt, so "every remaining check is * waived" is read as "nothing that covers the AC is unresolved". An AC that * no task cites has nothing to check that against, so a skipped-accepted one * is marked `uncovered`: `ac accept-skip` refuses it without `--uncovered`, * and verify names it (a task may cite the AC in a form the parser ignores). * * @module core/tasks/accepted-skip */ import type { AcceptedSkip } from './ledger.js'; import type { TaskBoard } from './task-board.js'; import type { AcEntry } from './verify-runner.js'; export type AcAcceptance = 'met' | 'mixed' | 'skipped-accepted' | 'open'; /** One accepted skip as the JSON outputs show it (the AC is the parent). */ export type AcWaiver = Omit; export interface AcAcceptanceEntry extends AcEntry { acceptance: AcAcceptance; waivers: AcWaiver[]; /** Skipped-accepted with no task citing the AC: the waivers alone closed it. */ uncovered?: true; } /** How every surface labels a skipped-accepted AC. */ export declare const ACCEPTED_SKIP_LABEL = "Accepted skip (not verified)"; /** * Add `acceptance` and `waivers` to ACs already passed through deriveAcStatus. * `skips` defaults to the board's fold; pass the ledger's own list when there * is no board (an increment without tasks). */ export declare function deriveAcAcceptance(acs: AcEntry[], board: TaskBoard | null, skips?: AcceptedSkip[]): AcAcceptanceEntry[]; /** Whether an AC lets the increment close: met (alone or mixed) or skipped-accepted. */ export declare function acCloses(a: { done: boolean; acceptance?: AcAcceptance; }): boolean; /** ACs that still keep the increment from closing: neither met nor skipped-accepted. */ export declare function acsLeftToClose(acs: AcEntry[], board: TaskBoard | null): AcAcceptanceEntry[]; /** JSON shape of an AC for `task list --json` and `pickup --json`. */ export declare function acJson(a: AcAcceptanceEntry): { uncovered?: boolean | undefined; id: string; text: string; done: boolean; via: string; acceptance: AcAcceptance; tasks: { id: string; status: string; }[]; waivers: AcWaiver[]; }; //# sourceMappingURL=accepted-skip.d.ts.map