kibi-cli 0.18.1 → 1.0.1

package/dist/public/verification-receipt.js

@@ -1,4 +1,9 @@
+import { createHash } from "node:crypto";
 export const VERIFICATION_RECEIPT_VERSION = "kibi.verification-receipt.v1";
+// implements REQ-kibi-verification-evidence-contract
+export const VERIFICATION_RECEIPT_V2_VERSION = "kibi.verification-receipt.v2";
+// implements REQ-kibi-verification-evidence-contract
+export const VERIFICATION_CONTRACT_VERSION = "kibi.verification-contract.v1";
 export const VERIFICATION_RECEIPT_MAX_AGE_SECONDS = 7 * 24 * 60 * 60;
 export const VERIFICATION_RECEIPT_OUTCOMES = [
     "passed",
@@ -6,8 +11,10 @@ export const VERIFICATION_RECEIPT_OUTCOMES = [
     "errored",
     "cancelled",
     "skipped",
+    "timed_out",
+    "interrupted",
 ];
-export const VERIFICATION_RECEIPT_SCHEMA = {
+const VERIFICATION_RECEIPT_V1_SCHEMA = {
     type: "object",
     required: [
         "version",
@@ -42,6 +49,84 @@ export const VERIFICATION_RECEIPT_SCHEMA = {
     },
     additionalProperties: false,
 };
+// implements REQ-kibi-verification-evidence-contract
+export const VERIFICATION_CONTRACT_SCHEMA = {
+    type: "object",
+    required: [
+        "version",
+        "runner",
+        "command_argv",
+        "required_case_symbols",
+        "required_projects",
+        "success_policy",
+    ],
+    properties: {
+        version: { type: "string", const: VERIFICATION_CONTRACT_VERSION },
+        runner: { type: "string", minLength: 1 },
+        command_argv: {
+            type: "array",
+            minItems: 1,
+            items: { type: "string", minLength: 1 },
+        },
+        required_case_symbols: {
+            type: "array",
+            items: { type: "string", minLength: 1 },
+            uniqueItems: true,
+        },
+        required_projects: {
+            type: "array",
+            items: { type: "string", minLength: 1 },
+            uniqueItems: true,
+        },
+        success_policy: {
+            type: "string",
+            const: "all_required_cases_first_attempt",
+        },
+    },
+    additionalProperties: false,
+};
+const VERIFICATION_RECEIPT_V2_SCHEMA = {
+    ...VERIFICATION_RECEIPT_V1_SCHEMA,
+    required: [
+        ...VERIFICATION_RECEIPT_V1_SCHEMA.required,
+        "command_argv",
+        "contract_hash",
+        "case_results",
+    ],
+    properties: {
+        ...VERIFICATION_RECEIPT_V1_SCHEMA.properties,
+        version: { type: "string", const: VERIFICATION_RECEIPT_V2_VERSION },
+        command_argv: {
+            type: "array",
+            minItems: 1,
+            items: { type: "string", minLength: 1 },
+        },
+        contract_hash: { type: "string", pattern: "^[a-f0-9]{64}$" },
+        case_results: {
+            type: "array",
+            minItems: 1,
+            maxItems: 1000,
+            items: {
+                type: "object",
+                required: ["symbol_id", "project", "outcome", "retries", "duration_ms"],
+                properties: {
+                    symbol_id: { type: "string", minLength: 1 },
+                    project: { type: "string", minLength: 1 },
+                    outcome: {
+                        type: "string",
+                        enum: ["passed", "failed", "timed_out", "skipped", "interrupted"],
+                    },
+                    retries: { type: "integer", minimum: 0 },
+                    duration_ms: { type: "integer", minimum: 0 },
+                },
+                additionalProperties: false,
+            },
+        },
+    },
+};
+export const VERIFICATION_RECEIPT_SCHEMA = {
+    oneOf: [VERIFICATION_RECEIPT_V1_SCHEMA, VERIFICATION_RECEIPT_V2_SCHEMA],
+};
 function timestamp(value) {
     if (typeof value !== "string")
         return null;
@@ -70,9 +155,8 @@ export function verificationReceiptHistoryErrors(testId, verificationScope, rece
         if (receipt.test_id !== testId) {
             errors.push(`${prefix}.test_id must equal '${testId}'`);
         }
-        if (typeof verificationScope === "string" &&
-            receipt.scope !== verificationScope) {
-            errors.push(`${prefix}.scope must equal the test verification_scope '${verificationScope}'`);
+        if (!["unit", "integration", "end_to_end"].includes(receipt.scope)) {
+            errors.push(`${prefix}.scope must be a supported verification scope`);
         }
         const startedAt = timestamp(receipt.started_at);
         const finishedAt = timestamp(receipt.finished_at);
@@ -90,6 +174,85 @@ export function verificationReceiptHistoryErrors(testId, verificationScope, rece
         }
         if (finishedAt !== null)
             previousFinishedAt = finishedAt;
+        if (receipt.version === VERIFICATION_RECEIPT_V2_VERSION) {
+            if (!Array.isArray(receipt.command_argv) ||
+                receipt.command_argv.length === 0 ||
+                receipt.command_argv.some((argument) => typeof argument !== "string" || argument.trim() === "")) {
+                errors.push(`${prefix}.command_argv must be a non-empty argv of strings`);
+            }
+            if (typeof receipt.contract_hash !== "string" ||
+                !/^[a-f0-9]{64}$/.test(receipt.contract_hash)) {
+                errors.push(`${prefix}.contract_hash must be a SHA-256 hex digest`);
+            }
+            const caseResults = receipt.case_results;
+            if (!Array.isArray(caseResults) || caseResults.length === 0) {
+                errors.push(`${prefix}.case_results must contain at least one contracted case`);
+            }
+            else {
+                const seenCases = new Set();
+                for (const [caseIndex, caseResult] of caseResults.entries()) {
+                    if (!caseResult ||
+                        typeof caseResult !== "object" ||
+                        Array.isArray(caseResult)) {
+                        errors.push(`${prefix}.case_results[${caseIndex}] must be an object`);
+                        continue;
+                    }
+                    const row = caseResult;
+                    if (typeof row.symbol_id !== "string" ||
+                        row.symbol_id.trim() === "" ||
+                        typeof row.project !== "string" ||
+                        row.project.trim() === "") {
+                        errors.push(`${prefix}.case_results[${caseIndex}] requires non-empty symbol_id and project`);
+                    }
+                    if (![
+                        "passed",
+                        "failed",
+                        "timed_out",
+                        "skipped",
+                        "interrupted",
+                    ].includes(String(row.outcome))) {
+                        errors.push(`${prefix}.case_results[${caseIndex}].outcome is not a supported result`);
+                    }
+                    const key = `${String(row.project ?? "")}\0${String(row.symbol_id ?? "")}`;
+                    if (seenCases.has(key))
+                        errors.push(`${prefix}.case_results duplicates '${key.replace("\0", "/")}'`);
+                    seenCases.add(key);
+                    if (typeof row.retries !== "number" ||
+                        !Number.isInteger(row.retries) ||
+                        row.retries < 0)
+                        errors.push(`${prefix}.case_results[${caseIndex}].retries must be a non-negative integer`);
+                    if (typeof row.duration_ms !== "number" ||
+                        !Number.isInteger(row.duration_ms) ||
+                        row.duration_ms < 0)
+                        errors.push(`${prefix}.case_results[${caseIndex}].duration_ms must be a non-negative integer`);
+                }
+            }
+        }
+    }
+    return errors;
+}
+// implements REQ-kibi-verification-evidence-contract
+export function verificationReceiptCurrentBindingErrors(testId, verificationScope, receipt, contract) {
+    const errors = [];
+    if (receipt.test_id !== testId) {
+        errors.push(`verification receipt test_id must equal '${testId}'`);
+    }
+    if (typeof verificationScope !== "string") {
+        errors.push("verification_scope is required for current receipt evidence");
+    }
+    else if (receipt.scope !== verificationScope) {
+        errors.push(`verification receipt scope must equal the current verification_scope '${verificationScope}'`);
+    }
+    if (contract !== undefined) {
+        if (receipt.version !== VERIFICATION_RECEIPT_V2_VERSION) {
+            errors.push("the current verification_contract requires a kibi.verification-receipt.v2");
+        }
+        else if (typeof receipt.contract_hash === "string") {
+            const expectedHash = verificationContractHash(contract);
+            if (receipt.contract_hash !== expectedHash) {
+                errors.push("verification receipt contract_hash does not match the current verification_contract");
+            }
+        }
     }
     return errors;
 }
@@ -105,6 +268,10 @@ function canonicalJson(value) {
     }
     return JSON.stringify(value);
 }
+// implements REQ-kibi-verification-evidence-contract
+export function verificationContractHash(contract) {
+    return createHash("sha256").update(canonicalJson(contract)).digest("hex");
+}
 export function appendOnlyVerificationReceiptHistoryErrors(previous, next) {
     if (previous.length === 0)
         return [];

package/dist/relationships/shards.d.ts

@@ -35,6 +35,22 @@ export declare function readShard(shardPath: string): RelationshipRecord[];
  * Creates parent directories if needed.
  */
 export declare function writeShard(shardPath: string, records: RelationshipRecord[]): void;
+export type RelationshipSelector = Readonly<{
+    type: string;
+    from: string;
+    to: string;
+}>;
+export type RemovedRelationshipRecords = Readonly<{
+    selector: RelationshipSelector;
+    shardPaths: readonly string[];
+    sources: readonly string[];
+    removed: boolean;
+}>;
+/**
+ * Remove exact legacy-shard relationships using an atomic temp-file rename.
+ * The caller is responsible for retracting the compiled RDF edge afterwards.
+ */
+export declare function removeRelationshipsFromShards(kbRoot: string, selectors: readonly RelationshipSelector[]): RemovedRelationshipRecords[];
 /**
  * Appends a relationship to the appropriate shard.
  * Returns the shard path and record ID.

package/dist/relationships/shards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shards.d.ts","sourceRoot":"","sources":["../../src/relationships/shards.ts"],"names":[],"mappings":"AAuBA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAsFjE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kBAAkB,EAAE,GAC5B,IAAI,CAoBN;AAqCD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,GAC3C;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CA4BzC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAUnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAUlE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,kBAAkB,EAAE,EAC7B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAC1B,kBAAkB,EAAE,CAKtB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,MAAM,CAMR;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAE1B,QAAQ,EAAE,kBAAkB,EAAE,EAC9B,QAAQ,EAAE,kBAAkB,EAAE,GAC7B,kBAAkB,EAAE,CAgCtB"}
+{"version":3,"file":"shards.d.ts","sourceRoot":"","sources":["../../src/relationships/shards.ts"],"names":[],"mappings":"AAwBA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAsFjE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kBAAkB,EAAE,GAC5B,IAAI,CAoBN;AAwBD,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC,CAAC;AAEH;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,oBAAoB,EAAE,GACzC,0BAA0B,EAAE,CAwD9B;AAqCD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,GAC3C;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAwCzC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAUnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAUlE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,kBAAkB,EAAE,EAC7B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAC1B,kBAAkB,EAAE,CAKtB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,MAAM,CAMR;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAE1B,QAAQ,EAAE,kBAAkB,EAAE,EAC9B,QAAQ,EAAE,kBAAkB,EAAE,GAC7B,kBAAkB,EAAE,CAgCtB"}

package/dist/relationships/shards.js

@@ -19,6 +19,7 @@ import * as crypto from "node:crypto";
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { load as parseYAML } from "js-yaml";
+import { parseDocument } from "yaml";
 /**
  * Gets the path to the relationships directory for a given KB root.
  */
@@ -132,7 +133,80 @@ export function writeShard(shardPath, records) {
         unique.push(record);
     }
     const yamlContent = serializeToYAML(unique);
-    fs.writeFileSync(shardPath, yamlContent, "utf8");
+    atomicWriteText(shardPath, yamlContent);
+}
+/**
+ * Publish one canonical shard replacement atomically. Relationship shards are
+ * authored source, so a torn write must never leave a half-valid YAML file
+ * for the next sync or Git operation.
+ */
+function atomicWriteText(targetPath, body) {
+    const temporary = `${targetPath}.kibi-write-${process.pid}-${Date.now()}-${Math.random()
+        .toString(16)
+        .slice(2)}`;
+    try {
+        fs.writeFileSync(temporary, body, { encoding: "utf8", mode: 0o600 });
+        fs.renameSync(temporary, targetPath);
+    }
+    catch (error) {
+        try {
+            if (fs.existsSync(temporary))
+                fs.unlinkSync(temporary);
+        }
+        catch {
+            // Preserve the original publication failure.
+        }
+        throw error;
+    }
+}
+/**
+ * Remove exact legacy-shard relationships using an atomic temp-file rename.
+ * The caller is responsible for retracting the compiled RDF edge afterwards.
+ */
+export function removeRelationshipsFromShards(kbRoot, selectors) {
+    const wanted = new Set(selectors.map((selector) => `${selector.type}\0${selector.from}\0${selector.to}`));
+    const removed = new Map();
+    for (const shardPath of listShards(kbRoot)) {
+        const records = readShard(shardPath);
+        const matching = records.filter((record) => wanted.has(`${record.type}\0${record.from}\0${record.to}`));
+        if (matching.length === 0)
+            continue;
+        // Patch the YAML sequence in place so comments, ordering, and unrelated
+        // records survive a relationship deletion. The compiled store is never
+        // the mutation target; this shard remains the canonical source artifact.
+        const document = parseDocument(fs.readFileSync(shardPath, "utf8"));
+        const sequence = document.get("relationships", true);
+        if (!sequence || typeof sequence !== "object" || !("items" in sequence)) {
+            throw new Error(`Invalid shard file: missing 'relationships' array at ${shardPath}`);
+        }
+        const items = sequence.items;
+        for (let index = items.length - 1; index >= 0; index -= 1) {
+            const item = items[index];
+            if (!item || typeof item !== "object" || !("get" in item))
+                continue;
+            const get = item.get.bind(item);
+            if (wanted.has(`${String(get("type"))}\0${String(get("from"))}\0${String(get("to"))}`)) {
+                document.deleteIn(["relationships", index]);
+            }
+        }
+        atomicWriteText(shardPath, document.toString());
+        for (const record of matching) {
+            const key = `${record.type}\0${record.from}\0${record.to}`;
+            const entry = removed.get(key) ?? { paths: [], sources: [] };
+            entry.paths.push(shardPath);
+            entry.sources.push(record.source);
+            removed.set(key, entry);
+        }
+    }
+    return selectors.map((selector) => {
+        const entry = removed.get(`${selector.type}\0${selector.from}\0${selector.to}`);
+        return {
+            selector,
+            shardPaths: entry?.paths ?? [],
+            sources: entry?.sources ?? [],
+            removed: entry !== undefined,
+        };
+    });
 }
 /**
  * Serializes records to YAML format.
@@ -185,7 +259,18 @@ export function appendRelationship(kbRoot, relationship) {
             ...relationship,
             id: recordId,
         };
-        writeShard(shardPath, [...existing, newRecord]);
+        if (fs.existsSync(shardPath)) {
+            const document = parseDocument(fs.readFileSync(shardPath, "utf8"));
+            const sequence = document.get("relationships", true);
+            if (!sequence || typeof sequence !== "object" || !("items" in sequence)) {
+                throw new Error(`Invalid shard file: missing 'relationships' array at ${shardPath}`);
+            }
+            sequence.items.push(newRecord);
+            atomicWriteText(shardPath, document.toString());
+        }
+        else {
+            writeShard(shardPath, [newRecord]);
+        }
     }
     return { shardPath, recordId };
 }

package/dist/report/brand.d.ts

@@ -0,0 +1,19 @@
+export declare const KIBI_BRAND: {
+    readonly carbon: "#1d1e23";
+    readonly deepCarbon: "#111318";
+    readonly panel: "#191c22";
+    readonly ice: "#a2d3f4";
+    readonly signal: "#3e8ed6";
+    readonly snow: "#f4f8fb";
+    readonly mist: "#aab8c2";
+    readonly rail: "#34434f";
+    readonly success: "#63c99a";
+    readonly warning: "#f2b84b";
+    readonly danger: "#f07178";
+};
+export declare function renderKibiLogo(className?: string): string;
+export declare function renderKibiWordmark(className?: string): string;
+export declare function renderKibiFaviconSvg(): string;
+export declare function renderKibiFaviconDataUri(): string;
+export declare function renderKibiBadge(message: string, statusColor: string): string;
+//# sourceMappingURL=brand.d.ts.map

package/dist/report/brand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../../src/report/brand.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU;;;;;;;;;;;;CAYb,CAAC;AAmBX,wBAAgB,cAAc,CAAC,SAAS,SAAK,GAAG,MAAM,CAErD;AAGD,wBAAgB,kBAAkB,CAAC,SAAS,SAAK,GAAG,MAAM,CAEzD;AAGD,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAGD,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD;AAgDD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CA+B5E"}

package/dist/report/brand.js

@@ -0,0 +1,112 @@
+export const KIBI_BRAND = {
+    carbon: "#1d1e23",
+    deepCarbon: "#111318",
+    panel: "#191c22",
+    ice: "#a2d3f4",
+    signal: "#3e8ed6",
+    snow: "#f4f8fb",
+    mist: "#aab8c2",
+    rail: "#34434f",
+    success: "#63c99a",
+    warning: "#f2b84b",
+    danger: "#f07178",
+};
+// Visible path/ellipse markup from assets/logo.svg and assets/wordmark.svg.
+// Packed reports stay self-contained; the e2e fingerprint compares these marks
+// to the canonical files, so keep the geometry in lockstep with those assets.
+const LOGO_BODY = `<path d="M59.403564453125,0.548828125C67.20257568359375,-0.47119140625,80.16162109375,0.2437744140625,88.4605712890625,0.24078369140625L146.50048828125,0.227783203125L214.8255615234375,0.23577880859375C240.16748046875,0.2437744140625,262.236572265625,-2.67620849609375,283.3775634765625,14.2947998046875C311.0205078125,36.48480224609375,307.6495361328125,66.8988037109375,307.671630859375,98.5548095703125L307.6895751953125,162.74783325195312L307.66552734375,217.54684448242188C307.6585693359375,226.07479858398438,307.653564453125,234.5628662109375,307.504638671875,243.0877685546875C306.8895263671875,278.2227783203125,283.66259765625,304.5137939453125,248.32958984375,308.1297607421875C240.6875,308.9278564453125,226.1695556640625,308.5008544921875,217.8525390625,308.4927978515625L161.468505859375,308.4508056640625L93.9794921875,308.5028076171875C68.57257080078125,308.5147705078125,46.83258056640625,311.5418701171875,25.39654541015625,295.0338134765625C-2.66644287109375,273.423828125,0.13555908203125,245.0108642578125,0.10955810546875,213.40182495117188L0.0855712890625,154.30581665039062L0.10357666015625,95.5968017578125C0.112548828125,81.48980712890625,-0.62841796875,66.85577392578125,1.7275390625,52.96478271484375C6.78955078125,23.11376953125,30.14154052734375,3.88580322265625,59.403564453125,0.548828125Z" fill="${KIBI_BRAND.carbon}"/><ellipse cx="113.3257670641164" cy="150.86303791579667" rx="51.325767064116405" ry="51.52454059083652" fill="${KIBI_BRAND.ice}"/><path d="M228.05255126953125,197.78256225585938L227.611572265625,165.51681518554688L156.5028076171875,165.69512939453125L95.43316650390625,165.28231811523438L95.4334716796875,135.09622192382812L156.503173828125,135.26748657226562L227.535888671875,135.08938598632812L227.53631591796875,101.200927734375L252.20697021484375,101.20071411132812L252.20599365234375,197.78225708007812" fill="${KIBI_BRAND.ice}"/>`;
+const WORDMARK_BODY = `<ellipse cx="337.16000366210943" cy="30.99999999999997" rx="20.000000000000057" ry="19.99999999999997" fill="${KIBI_BRAND.signal}"/><path d="M381.8653869628906,49.212493896484375L381.6935119628906,36.688079833984375L353.9847106933594,36.757293701171875L330.1878356933594,36.5970458984375L330.1879577636719,24.8798828125L353.9848327636719,24.94635009765625L381.6640319824219,24.877227783203125L381.6641540527344,11.722930908203125L391.2775573730469,11.72283935546875L391.2771301269531,49.212371826171875" fill="${KIBI_BRAND.signal}"/><path d="M0,155.33001708984375L0,22.1300048828125L19.6199951171875,22.1300048828125L19.6199951171875,102.58999633789062L20.519989013671875,102.58999633789062L35.100006103515625,87.6500244140625L61.20001220703125,62.45001220703125L84.42001342773438,62.45001220703125L46.800018310546875,98.989990234375L88.55999755859375,155.33001708984375L64.98001098632812,155.33001708984375L32.579986572265625,110.1500244140625L19.6199951171875,122.21002197265625L19.6199951171875,155.33001708984375L0,155.33001708984375L0,155.33001708984375M110.33999633789062,155.33001708984375L110.33999633789062,139.49002075195312L132.01998901367188,139.49002075195312L132.01998901367188,78.28997802734375L100.33999633789062,78.28997802734375L100.33999633789062,62.45001220703125L151.63998413085938,62.45001220703125L151.63998413085938,139.49002075195312L171.33999633789062,139.49002075195312L171.33999633789062,155.33001708984375L110.33999633789062,155.33001708984375L110.33999633789062,155.33001708984375M194.3800048828125,155.33001708984375L194.3800048828125,22.1300048828125L214,22.1300048828125L214.08001708984375,70L215.16000366210938,70C221.16000366210938,65,220.16000366210938,66,224.16000366210938,64C229.1324462890625,61.513824462890625,236.32000732421875,60.28997802734375,243.16000366210938,60.28997802734375L243.16000366210938,60.28997802734375C254.08004760742188,60.28997802734375,262.7799987792969,64.3699951171875,269.2599792480469,72.52999877929688C275.7399597167969,80.69000244140625,278.9800109863281,92.80999755859375,278.9800109863281,108.8900146484375L278.9800109863281,108.8900146484375C278.9800109863281,124.97000122070312,275.7399597167969,137.08999633789062,269.2599792480469,145.25C262.7799987792969,153.41000366210938,254.08004760742188,157.49002075195312,243.16000366210938,157.49002075195312L243.16000366210938,157.49002075195312C236.32000732421875,157.49002075195312,227.92709350585938,156.8602294921875,223.16000366210938,154C218.16000366210938,151,219.16000366210938,152,215.16000366210938,147L215.16000366210938,147L214.08001708984375,147L214,155.33001708984375L194.3800048828125,155.33001708984375L194.3800048828125,155.33001708984375M235.05999755859375,141.47000122070312L235.05999755859375,141.47000122070312C242.5,141.47000122070312,248.23001098632812,139.19000244140625,252.24996948242188,134.6300048828125C256.2699890136719,130.07000732421875,258.2799987792969,124.010009765625,258.2799987792969,116.45001220703125L258.2799987792969,116.45001220703125L258.2799987792969,101.33001708984375C258.2799987792969,93.77001953125,256.2699890136719,87.71002197265625,252.24996948242188,83.1500244140625C248.23001098632812,78.59002685546875,242.5,76.30999755859375,235.05999755859375,76.30999755859375L235.05999755859375,76.30999755859375C232.18002319335938,76.30999755859375,229.48001098632812,76.66998291015625,226.95999145507812,77.3900146484375C224.44000244140625,78.1099853515625,222.22000122070312,79.19000244140625,220.30001831054688,80.6300048828125C218.3800048828125,82.07000732421875,216.85000610351562,83.84002685546875,215.70999145507812,85.94000244140625C214.57000732421875,88.03997802734375,214,90.52999877929688,214,93.41000366210938L214,93.41000366210938L214,124.3699951171875C214,127.25,214.57000732421875,129.74002075195312,215.70999145507812,131.83999633789062C216.85000610351562,133.94000244140625,218.3800048828125,135.70999145507812,220.30001831054688,137.14999389648438C222.22000122070312,138.58999633789062,224.44000244140625,139.67001342773438,226.95999145507812,140.3900146484375C229.48001098632812,141.11001586914062,232.18002319335938,141.47000122070312,235.05999755859375,141.47000122070312L235.05999755859375,141.47000122070312M306.3399963378906,155.33001708984375L306.3399963378906,139.49002075195312L328.0199890136719,139.49002075195312L328.0199890136719,78.28997802734375L296.3399963378906,78.28997802734375L296.3399963378906,62.45001220703125L347.6399841308594,62.45001220703125L347.6399841308594,139.49002075195312L367.3399963378906,139.49002075195312L367.3399963378906,155.33001708984375L306.3399963378906,155.33001708984375L306.3399963378906,155.33001708984375" fill="${KIBI_BRAND.ice}"/><ellipse cx="141.66000366210938" cy="31.5" rx="12.5" ry="12.5" fill="${KIBI_BRAND.ice}"/>`;
+function xml(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&apos;");
+}
+// implements REQ-kibi-branded-health-report
+export function renderKibiLogo(className = "") {
+    return `<svg${className ? ` class="${xml(className)}"` : ""} viewBox="0 0 308 309" role="img" aria-label="Kibi logo">${LOGO_BODY}</svg>`;
+}
+// implements REQ-kibi-branded-health-report
+export function renderKibiWordmark(className = "") {
+    return `<svg${className ? ` class="${xml(className)}"` : ""} viewBox="-2 10 395 148" role="img" aria-label="Kibi">${WORDMARK_BODY}</svg>`;
+}
+// implements REQ-kibi-branded-health-report
+export function renderKibiFaviconSvg() {
+    return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 308 309">${LOGO_BODY}</svg>`;
+}
+// implements REQ-kibi-branded-health-report
+export function renderKibiFaviconDataUri() {
+    return `data:image/svg+xml;utf8,${encodeURIComponent(renderKibiFaviconSvg())}`;
+}
+const BADGE_HEIGHT = 20;
+const BADGE_LABEL = "kibi";
+const BADGE_FONT = "DejaVu Sans,Verdana,Geneva,sans-serif";
+const BADGE_LOGO = 14;
+const BADGE_LOGO_LEFT = 5;
+const BADGE_LOGO_GAP = 3;
+const BADGE_TEXT_PAD = 8;
+const BADGE_LABEL_FILL = "#555";
+const BADGE_TEXT_FILL = "#fff";
+const BADGE_TEXT_SHADOW = "#010101";
+const BADGE_LOGO_BODY = LOGO_BODY.replaceAll(`fill="${KIBI_BRAND.carbon}"`, `fill="${BADGE_LABEL_FILL}"`);
+function badgeTextWidth(text) {
+    let width = 0;
+    for (const char of text) {
+        if (char === " ")
+            width += 4;
+        else if (char === "%")
+            width += 9;
+        else
+            width += 7;
+    }
+    return Math.ceil(width);
+}
+function badgeLabelWidth(label) {
+    return (BADGE_LOGO_LEFT +
+        BADGE_LOGO +
+        BADGE_LOGO_GAP +
+        badgeTextWidth(label) +
+        BADGE_TEXT_PAD);
+}
+function badgeMessageWidth(message) {
+    return BADGE_TEXT_PAD + badgeTextWidth(message) + BADGE_TEXT_PAD;
+}
+function badgeCaption(x, text) {
+    const safe = xml(text);
+    return `<text x="${x}" y="15" fill="${BADGE_TEXT_SHADOW}" fill-opacity=".3">${safe}</text>
+    <text x="${x}" y="14" fill="${BADGE_TEXT_FILL}">${safe}</text>`;
+}
+// implements REQ-kibi-branded-health-report
+export function renderKibiBadge(message, statusColor) {
+    const accessible = `Kibi requirement health: ${message}`;
+    const labelWidth = badgeLabelWidth(BADGE_LABEL);
+    const messageWidth = badgeMessageWidth(message);
+    const width = labelWidth + messageWidth;
+    const logoX = BADGE_LOGO_LEFT;
+    const logoY = (BADGE_HEIGHT - BADGE_LOGO) / 2;
+    const labelTextX = BADGE_LOGO_LEFT +
+        BADGE_LOGO +
+        BADGE_LOGO_GAP +
+        badgeTextWidth(BADGE_LABEL) / 2;
+    const messageTextX = labelWidth + messageWidth / 2;
+    return `<svg xmlns="http://www.w3.org/2000/svg" role="img" aria-label="${xml(accessible)}" width="${width}" height="${BADGE_HEIGHT}" viewBox="0 0 ${width} ${BADGE_HEIGHT}">
+  <title>${xml(accessible)}</title>
+  <linearGradient id="kibi-badge-s" x2="0" y2="100%">
+    <stop offset="0" stop-color="#bbb" stop-opacity=".1"/>
+    <stop offset="1" stop-opacity=".1"/>
+  </linearGradient>
+  <clipPath id="kibi-badge"><rect width="${width}" height="${BADGE_HEIGHT}" rx="3" fill="#fff"/></clipPath>
+  <g clip-path="url(#kibi-badge)">
+    <rect width="${labelWidth}" height="${BADGE_HEIGHT}" fill="${BADGE_LABEL_FILL}"/>
+    <rect x="${labelWidth}" width="${messageWidth}" height="${BADGE_HEIGHT}" fill="${xml(statusColor)}"/>
+    <rect width="${width}" height="${BADGE_HEIGHT}" fill="url(#kibi-badge-s)"/>
+  </g>
+  <g fill="${BADGE_TEXT_FILL}" text-anchor="middle" font-family="${BADGE_FONT}" font-size="11">
+    ${badgeCaption(labelTextX, BADGE_LABEL)}
+    ${badgeCaption(messageTextX, message)}
+  </g>
+  <svg x="${logoX}" y="${logoY}" width="${BADGE_LOGO}" height="${BADGE_LOGO}" viewBox="0 0 308 309" aria-hidden="true">${BADGE_LOGO_BODY}</svg>
+</svg>`;
+}

package/dist/report/html-report.d.ts

@@ -0,0 +1,19 @@
+import { type ReportRepository } from "./repository.js";
+type UnknownRecord = Readonly<Record<string, unknown>>;
+export declare const REPORT_CSP = "default-src 'none'; img-src data:; style-src 'unsafe-inline'; script-src 'unsafe-inline'";
+export declare const KIBI_GETTING_STARTED_URL = "https://github.com/Looted/kibi/blob/develop/docs/install.md";
+export type HtmlReportCoverage = Readonly<{
+    summary: UnknownRecord;
+    rows: readonly UnknownRecord[];
+    meta?: UnknownRecord;
+}>;
+export type HtmlReportInput = Readonly<{
+    requirements: HtmlReportCoverage;
+    symbols: HtmlReportCoverage;
+    branch: string;
+    generatedAt: Date;
+    repository?: ReportRepository;
+}>;
+export declare function renderHtmlReport(input: HtmlReportInput): string;
+export {};
+//# sourceMappingURL=html-report.d.ts.map

package/dist/report/html-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-report.d.ts","sourceRoot":"","sources":["../../src/report/html-report.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,KAAK,gBAAgB,EAMtB,MAAM,iBAAiB,CAAC;AAEzB,KAAK,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAGvD,eAAO,MAAM,UAAU,6FACqE,CAAC;AAG7F,eAAO,MAAM,wBAAwB,gEAC0B,CAAC;AAEhE,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IAC/B,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,YAAY,EAAE,kBAAkB,CAAC;IACjC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,IAAI,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B,CAAC,CAAC;AA8lBH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAke/D"}