@dragonshorn-studios/elyseum-cli 1.0.12 → 1.1.1

package/dist/core/errors.d.ts

@@ -0,0 +1,30 @@
+import { ExitCode } from "./exit-codes";
+/**
+ * Base class for every deliberate CLI failure. Commands throw these; the
+ * entry point turns them into stderr messages plus the documented exit code.
+ */
+export declare abstract class CliError extends Error {
+    abstract readonly exitCode: ExitCode;
+    abstract readonly actionable: string;
+}
+export declare class InvalidConfigError extends CliError {
+    readonly exitCode: 2;
+    readonly actionable: string;
+    constructor(validationSummary: string);
+}
+export declare class MissingGitError extends CliError {
+    readonly exitCode: 3;
+    readonly actionable: string;
+    constructor(dir: string);
+}
+export declare class MissingLcovError extends CliError {
+    readonly exitCode: 4;
+    readonly actionable: string;
+    constructor(path: string);
+}
+export declare class CalculationFailure extends CliError {
+    readonly exitCode: 5;
+    readonly actionable: string;
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEpD;;;GAGG;AACH,8BAAsB,QAAS,SAAQ,KAAK;IAC1C,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IACrC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CACtC;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,QAAQ,CAAC,QAAQ,IAA6B;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,iBAAiB,EAAE,MAAM;CAItC;AAED,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,QAAQ,CAAC,QAAQ,IAA0B;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,GAAG,EAAE,MAAM;CAKxB;AAED,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,QAAQ,CAAC,QAAQ,IAA2B;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,IAAI,EAAE,MAAM;CAIzB;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,QAAQ,CAAC,QAAQ,IAAgC;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,MAAM;CAI5B"}

package/dist/core/exit-codes.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Documented exit-code contract for elyseum-cli. These codes are part of
+ * the CLI's public contract (README "Exit codes"); they never change within
+ * a major version.
+ */
+export declare const EXIT_CODES: {
+    /** Success, or a warning-only condition. */
+    readonly SUCCESS: 0;
+    /** A configured quality gate was not met. */
+    readonly QUALITY_GATE_FAILED: 1;
+    /** The configuration file (or CLI arguments) are invalid. */
+    readonly INVALID_CONFIG: 2;
+    /** A git repository is required but was not found. */
+    readonly MISSING_GIT: 3;
+    /** The LCOV report file was not found. */
+    readonly MISSING_LCOV: 4;
+    /** Any other calculation or runtime error. */
+    readonly CALCULATION_ERROR: 5;
+};
+export type ExitCode = (typeof EXIT_CODES)[keyof typeof EXIT_CODES];
+//# sourceMappingURL=exit-codes.d.ts.map

package/dist/core/exit-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/core/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,UAAU;IACrB,4CAA4C;;IAE5C,6CAA6C;;IAE7C,6DAA6D;;IAE7D,sDAAsD;;IAEtD,0CAA0C;;IAE1C,8CAA8C;;CAEtC,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC"}

package/dist/core/git-diff.d.ts

@@ -0,0 +1,80 @@
+import { LcovRecord } from "./lcov";
+export interface ChangedFile {
+    path: string;
+    /** Present when the diff is computed from git; absent for whole-file lists. */
+    lines?: number;
+    type?: "add" | "modify" | "remove";
+    /** Present when the diff is computed from git; absent for whole-file lists. */
+    diff?: {
+        hunks: {
+            newStart: number;
+            newLines: number;
+            lines?: string[];
+        }[];
+    };
+}
+export interface DiffFacts {
+    headSha: string;
+    baseSha: string;
+}
+/** Normalizes a leading slash so LCOV paths and diff paths compare equal. */
+export declare function normalizePath(path: string): string;
+/**
+ * Lines the diff adds that can carry coverage: added (+) lines, or — when a
+ * hunk carries no per-line annotations (new files) — every new line in the
+ * hunk. Removed lines, context lines, and comment/blank additions are
+ * excluded. Pure.
+ */
+export declare function extractChangedLineNumbers(hunks: {
+    newStart: number;
+    newLines: number;
+    lines?: string[];
+}[], coverableLineNumbers: Set<number>): Set<number>;
+/**
+ * Comment-only or blank additions cannot carry coverage; counting them as
+ * uncovered would punish documentation. Pure.
+ */
+export declare function isCommentLine(line: string): boolean;
+/** Pure diff-coverage aggregation over changed files and LCOV records. */
+export declare function calculateDiffCoverage(files: ChangedFile[], coverage: LcovRecord[], facts: DiffFacts): {
+    headSha: string;
+    baseSha: string;
+    lines: {
+        total: number;
+        covered: number;
+        percent: number;
+    };
+    functions: {
+        total: number;
+        covered: number;
+        percent: number;
+    };
+    branches: {
+        total: number;
+        covered: number;
+        percent: number;
+    };
+    files: {
+        file: string;
+        lines: {
+            total: number;
+            covered: number;
+            percent: number;
+        };
+        functions: {
+            total: number;
+            covered: number;
+            percent: number;
+        };
+        branches: {
+            total: number;
+            covered: number;
+            percent: number;
+        };
+    }[];
+};
+/** Throws MissingGitError when the working directory is not a git checkout. */
+export declare function assertGitRepository(dir: string): Promise<void>;
+/** Walks head vs base and returns changed files with their unified diffs. */
+export declare function getChangedFiles(dir: string, head: string, base: string): Promise<ChangedFile[]>;
+//# sourceMappingURL=git-diff.d.ts.map

package/dist/core/git-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-diff.d.ts","sourceRoot":"","sources":["../../src/core/git-diff.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAW,MAAM,QAAQ,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACnC,+EAA+E;IAC/E,IAAI,CAAC,EAAE;QACL,KAAK,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;SAAE,EAAE,CAAC;KACnE,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,EACjE,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,GAChC,GAAG,CAAC,MAAM,CAAC,CAuCb;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQnD;AAED,0EAA0E;AAC1E,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,WAAW,EAAE,EACpB,QAAQ,EAAE,UAAU,EAAE,EACtB,KAAK,EAAE,SAAS,GACf;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9D,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3D,SAAS,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/D,QAAQ,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/D,EAAE,CAAC;CACL,CAwIA;AAED,+EAA+E;AAC/E,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASpE;AAED,6EAA6E;AAC7E,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,EAAE,CAAC,CA4DxB"}

package/dist/core/lcov.d.ts

@@ -0,0 +1,56 @@
+import { CoverageDetail, CoverageFile } from "../types/coverage-result";
+/**
+ * Pure coverage math. Total coverage percentages are finite by definition:
+ * a zero denominator means "nothing to cover", which is 100% covered —
+ * never NaN.
+ */
+export declare function percent(covered: number, total: number): number;
+/** LCOV record as produced by lcov-parse, typed loosely on purpose. */
+export interface LcovRecord {
+    file: string;
+    lines: {
+        found: number;
+        hit: number;
+        details: LineDetail[];
+    };
+    functions: {
+        found: number;
+        hit: number;
+        details: FunctionDetail[];
+    };
+    branches: {
+        found: number;
+        hit: number;
+        details: BranchDetail[];
+    };
+}
+export interface LineDetail {
+    line: number;
+    hit: number;
+}
+export interface FunctionDetail {
+    name: string;
+    line: number;
+    hit: number;
+}
+export interface BranchDetail {
+    block: number;
+    branch: number;
+    line: number;
+    taken: number;
+}
+/**
+ * Reads and parses an LCOV report. A missing file is an actionable
+ * MissingLcovError; a malformed file is a calculation error.
+ */
+export declare function readLcovReport(path: string): Promise<LcovRecord[]>;
+/**
+ * Aggregates parsed LCOV records into the total coverage result. Pure.
+ */
+export declare function calculateTotalCoverage(records: LcovRecord[]): {
+    lines: CoverageDetail;
+    functions: CoverageDetail;
+    branches: CoverageDetail;
+    files: CoverageFile[];
+};
+//# sourceMappingURL=lcov.d.ts.map

package/dist/core/lcov.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lcov.d.ts","sourceRoot":"","sources":["../../src/core/lcov.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExE;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAC7D,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC;IACrE,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,YAAY,EAAE,CAAA;KAAE,CAAC;CACnE;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAiBxE;AAGD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG;IAC7D,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,EAAE,cAAc,CAAC;IAC1B,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB,CA6CA"}

package/dist/core/quality-gate.d.ts

@@ -0,0 +1,15 @@
+export type QualityGateOutcome = "passed" | "warning" | "failed";
+export interface QualityGateThresholds {
+    /** Warn band ceiling: percent < gate warns; percent >= gate passes.
+     *  Undefined means no warn band. */
+    gate?: number;
+    /** Fail ceiling, inclusive: percent <= fail fails. Undefined disables
+     *  the fail path (the gate alone can only warn). */
+    fail?: number;
+}
+/**
+ * Pure quality-gate evaluation: the changed-line coverage percentage against
+ * the configured thresholds. Absent thresholds mean the gate is disabled.
+ */
+export declare function evaluateQualityGate(percent: number, thresholds: QualityGateThresholds): QualityGateOutcome;
+//# sourceMappingURL=quality-gate.d.ts.map

package/dist/core/quality-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-gate.d.ts","sourceRoot":"","sources":["../../src/core/quality-gate.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IACpC;wCACoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;wDACoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,qBAAqB,GAChC,kBAAkB,CAgBpB"}