dsh-data-quality 0.1.0

package/lib/types/verify.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Declarative verification rules over a parsed {@link Table} (not-null,
+ * unique, range, regex, enum, cross-column, freshness) plus the frozen
+ * citation-checking semantics for `ctx.dataQuality.verifyCitations`. Pure and
+ * deterministic: the freshness clock is injected, numeric comparison never
+ * uses raw `===`, and evidence rows are capped by config.
+ * @module dsh-data-quality/verify
+ */
+import { type Cell, type DocumentRoot, type Table } from './dataset.js';
+import type { CitationCheckRequest, CitationCheckResult } from './service.js';
+/** One declarative verification rule (discriminated on `rule`). */
+export type VerifyRule = {
+    readonly rule: 'not-null';
+    readonly column: string;
+} | {
+    readonly rule: 'unique';
+    readonly columns: readonly string[];
+} | {
+    readonly rule: 'range';
+    readonly column: string;
+    readonly min?: number;
+    readonly max?: number;
+} | {
+    readonly rule: 'regex';
+    readonly column: string;
+    readonly pattern: string;
+    readonly flags?: string;
+} | {
+    readonly rule: 'enum';
+    readonly column: string;
+    readonly values: readonly string[];
+} | {
+    readonly rule: 'cross-column';
+    readonly left: string;
+    readonly op: '<' | '<=' | '==' | '!=' | '>=' | '>';
+    readonly rightColumn?: string;
+    readonly value?: number | string;
+} | {
+    readonly rule: 'freshness';
+    readonly column: string;
+    readonly maxAgeDays: number;
+    readonly asOf?: string;
+};
+/** Raised for invalid rules; `message` names the rule index and reason. */
+export declare class VerifyRuleError extends Error {
+    readonly ruleIndex: number;
+    /**
+     * @param ruleIndex - index of the offending rule in the request array.
+     * @param message - actionable human-readable detail.
+     */
+    constructor(ruleIndex: number, message: string);
+}
+/** One failing row's evidence (capped per rule by `evidenceRowLimit`). */
+export interface VerifyEvidenceRow {
+    /** 0-based data row index. */
+    readonly rowIndex: number;
+    /** Only the columns the rule inspected. */
+    readonly values: Record<string, Cell>;
+}
+/** One rule's outcome. */
+export interface VerifyRuleResult {
+    readonly ruleIndex: number;
+    readonly rule: VerifyRule['rule'];
+    readonly passed: boolean;
+    /** Rows the predicate rejected. */
+    readonly failedCount: number;
+    /** Rows the predicate ran over. */
+    readonly checkedCount: number;
+    /** First `evidenceRowLimit` failing rows. */
+    readonly evidence: VerifyEvidenceRow[];
+}
+/** The full verify report (also the persisted and tool-returned value). */
+export interface VerifyReport {
+    readonly dataset: string;
+    readonly passed: boolean;
+    readonly rowCount: number;
+    readonly rules: VerifyRuleResult[];
+    /** Storage-domain key of the persisted report, when persistence is on (set by the provider). */
+    readonly reportKey?: string;
+    /** Injected generation timestamp (epoch ms). */
+    readonly generatedAt: number;
+}
+/**
+ * Apply verification rules over a parsed table. A missing cell fails every
+ * rule that reads it. The overall `passed` is the conjunction of rule passes;
+ * a failing dataset is a normal result, never a thrown error.
+ * @param table - the parsed dataset.
+ * @param rules - non-empty rule list.
+ * @param options - evidence cap, injected clock for `freshness`, abort signal.
+ * @returns the verify report (without the dataset label; the caller adds it).
+ */
+export declare function verifyTable(table: Table, rules: readonly VerifyRule[], options: {
+    evidenceRowLimit: number;
+    now: () => number;
+    signal?: AbortSignal | undefined;
+}): Omit<VerifyReport, 'dataset'>;
+/** Human-readable verify summary for the tool's Native render. */
+export declare function renderVerifyText(report: VerifyReport): string;
+/** One parsed locator segment: an object key plus optional array indices. */
+interface LocatorSegment {
+    readonly key: string | undefined;
+    readonly indices: readonly number[];
+}
+/**
+ * Parse a JSON-path-ish locator (`rows[3].nav`, `summary.annualReturn`,
+ * `[0].value`) into walk segments. Throws on unparsable input.
+ * @param locator - the citation's path string.
+ * @returns ordered walk segments.
+ */
+export declare function parseLocator(locator: string): LocatorSegment[];
+/**
+ * The frozen citation-checking semantics: locate each citation's `path` in the
+ * dataset document, then compare. Numbers compare with relative `tolerance`
+ * (falling back to `defaultTolerance`); strings compare exactly. A missing
+ * location is `not-found`; an incomparable actual/cited type pair is
+ * `unverifiable`.
+ * @param root - the loaded dataset document.
+ * @param citations - citations to check.
+ * @param defaultTolerance - configured fallback relative tolerance.
+ * @returns one result per citation, ids echoed.
+ */
+export declare function checkCitations(root: DocumentRoot, citations: CitationCheckRequest['citations'], defaultTolerance: number): CitationCheckResult;
+export {};
+//# sourceMappingURL=verify.d.ts.map

package/lib/types/verify.d.ts.map

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

package/lib/types/verify.js

@@ -0,0 +1,391 @@
+/**
+ * Declarative verification rules over a parsed {@link Table} (not-null,
+ * unique, range, regex, enum, cross-column, freshness) plus the frozen
+ * citation-checking semantics for `ctx.dataQuality.verifyCitations`. Pure and
+ * deterministic: the freshness clock is injected, numeric comparison never
+ * uses raw `===`, and evidence rows are capped by config.
+ * @module dsh-data-quality/verify
+ */
+import { isMissing, parseDate, parseNumeric, throwIfAborted } from "./dataset.js";
+/** Raised for invalid rules; `message` names the rule index and reason. */
+export class VerifyRuleError extends Error {
+    ruleIndex;
+    /**
+     * @param ruleIndex - index of the offending rule in the request array.
+     * @param message - actionable human-readable detail.
+     */
+    constructor(ruleIndex, message) {
+        super(message);
+        this.ruleIndex = ruleIndex;
+        this.name = 'VerifyRuleError';
+    }
+}
+/** Assert `column` exists. */
+function requireColumn(columns, column, ruleIndex) {
+    if (!columns.includes(column)) {
+        throw new VerifyRuleError(ruleIndex, `rule ${ruleIndex}: unknown column ${JSON.stringify(column)} (columns: ${columns.join(', ')})`);
+    }
+}
+/** The trimmed string form used for regex/enum/cross-column string comparison. */
+function textOf(cell) {
+    if (typeof cell === 'string')
+        return cell.trim();
+    if (cell === null || cell === undefined)
+        return '';
+    if (typeof cell === 'object')
+        return JSON.stringify(cell);
+    return String(cell);
+}
+/** Run one per-row predicate and collect capped evidence. */
+function evaluate(table, ruleIndex, ruleName, columns, predicate, evidenceRowLimit, signal) {
+    let failedCount = 0;
+    const evidence = [];
+    for (const [rowIndex, row] of table.rows.entries()) {
+        if (rowIndex % 1024 === 0)
+            throwIfAborted(signal);
+        if (predicate(row))
+            continue;
+        failedCount += 1;
+        if (evidence.length < evidenceRowLimit) {
+            const values = {};
+            for (const column of columns)
+                values[column] = row[column] ?? null;
+            evidence.push({ rowIndex, values });
+        }
+    }
+    return {
+        ruleIndex,
+        rule: ruleName,
+        passed: failedCount === 0,
+        failedCount,
+        checkedCount: table.rows.length,
+        evidence,
+    };
+}
+const CROSS_OPS = ['<', '<=', '==', '!=', '>=', '>'];
+/**
+ * Apply verification rules over a parsed table. A missing cell fails every
+ * rule that reads it. The overall `passed` is the conjunction of rule passes;
+ * a failing dataset is a normal result, never a thrown error.
+ * @param table - the parsed dataset.
+ * @param rules - non-empty rule list.
+ * @param options - evidence cap, injected clock for `freshness`, abort signal.
+ * @returns the verify report (without the dataset label; the caller adds it).
+ */
+export function verifyTable(table, rules, options) {
+    if (rules.length === 0) {
+        throw new VerifyRuleError(0, 'rules must be a non-empty array');
+    }
+    const results = [];
+    for (const [ruleIndex, rule] of rules.entries()) {
+        throwIfAborted(options.signal);
+        let result;
+        switch (rule.rule) {
+            case 'not-null': {
+                requireColumn(table.columns, rule.column, ruleIndex);
+                result = evaluate(table, ruleIndex, rule.rule, [rule.column], (row) => !isMissing(row[rule.column]), options.evidenceRowLimit, options.signal);
+                break;
+            }
+            case 'unique': {
+                if (rule.columns.length === 0) {
+                    throw new VerifyRuleError(ruleIndex, `rule ${ruleIndex}: unique requires at least one column`);
+                }
+                for (const column of rule.columns)
+                    requireColumn(table.columns, column, ruleIndex);
+                const counts = new Map();
+                for (const row of table.rows) {
+                    const key = JSON.stringify(rule.columns.map((column) => row[column] ?? null));
+                    counts.set(key, (counts.get(key) ?? 0) + 1);
+                }
+                result = evaluate(table, ruleIndex, rule.rule, rule.columns, (row) => (counts.get(JSON.stringify(rule.columns.map((column) => row[column] ?? null))) ?? 0) === 1, options.evidenceRowLimit, options.signal);
+                break;
+            }
+            case 'range': {
+                requireColumn(table.columns, rule.column, ruleIndex);
+                if (rule.min === undefined && rule.max === undefined) {
+                    throw new VerifyRuleError(ruleIndex, `rule ${ruleIndex}: range requires at least one of min/max`);
+                }
+                result = evaluate(table, ruleIndex, rule.rule, [rule.column], (row) => {
+                    const value = parseNumeric(row[rule.column]);
+                    if (value === undefined)
+                        return false;
+                    if (rule.min !== undefined && value < rule.min)
+                        return false;
+                    if (rule.max !== undefined && value > rule.max)
+                        return false;
+                    return true;
+                }, options.evidenceRowLimit, options.signal);
+                break;
+            }
+            case 'regex': {
+                requireColumn(table.columns, rule.column, ruleIndex);
+                let pattern;
+                try {
+                    pattern = new RegExp(rule.pattern, rule.flags ?? '');
+                }
+                catch (error) {
+                    throw new VerifyRuleError(ruleIndex, `rule ${ruleIndex}: invalid regex ${JSON.stringify(rule.pattern)}: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                result = evaluate(table, ruleIndex, rule.rule, [rule.column], (row) => {
+                    const cell = row[rule.column];
+                    if (isMissing(cell))
+                        return false;
+                    pattern.lastIndex = 0;
+                    return pattern.test(textOf(cell));
+                }, options.evidenceRowLimit, options.signal);
+                break;
+            }
+            case 'enum': {
+                requireColumn(table.columns, rule.column, ruleIndex);
+                if (rule.values.length === 0) {
+                    throw new VerifyRuleError(ruleIndex, `rule ${ruleIndex}: enum requires a non-empty values array`);
+                }
+                const allowed = new Set(rule.values);
+                result = evaluate(table, ruleIndex, rule.rule, [rule.column], (row) => {
+                    const cell = row[rule.column];
+                    if (isMissing(cell))
+                        return false;
+                    return allowed.has(textOf(cell));
+                }, options.evidenceRowLimit, options.signal);
+                break;
+            }
+            case 'cross-column': {
+                requireColumn(table.columns, rule.left, ruleIndex);
+                if (!CROSS_OPS.includes(rule.op)) {
+                    throw new VerifyRuleError(ruleIndex, `rule ${ruleIndex}: unsupported op ${JSON.stringify(rule.op)}`);
+                }
+                const hasColumn = rule.rightColumn !== undefined;
+                const hasValue = rule.value !== undefined;
+                if (hasColumn === hasValue) {
+                    throw new VerifyRuleError(ruleIndex, `rule ${ruleIndex}: cross-column needs exactly one of rightColumn/value`);
+                }
+                if (hasColumn)
+                    requireColumn(table.columns, rule.rightColumn, ruleIndex);
+                const columns = hasColumn ? [rule.left, rule.rightColumn] : [rule.left];
+                result = evaluate(table, ruleIndex, rule.rule, columns, (row) => {
+                    const left = row[rule.left];
+                    const right = hasColumn ? row[rule.rightColumn] : rule.value;
+                    if (isMissing(left) || isMissing(right))
+                        return false;
+                    const leftNum = parseNumeric(left);
+                    const rightNum = parseNumeric(right);
+                    if (leftNum !== undefined && rightNum !== undefined) {
+                        switch (rule.op) {
+                            case '<': return leftNum < rightNum;
+                            case '<=': return leftNum <= rightNum;
+                            case '>': return leftNum > rightNum;
+                            case '>=': return leftNum >= rightNum;
+                            case '==': return Math.abs(leftNum - rightNum) <= 1e-12 * Math.max(Math.abs(leftNum), Math.abs(rightNum), 1);
+                            case '!=': return Math.abs(leftNum - rightNum) > 1e-12 * Math.max(Math.abs(leftNum), Math.abs(rightNum), 1);
+                        }
+                    }
+                    // Date fallback: both sides date-parseable compares epochs (the startDate < endDate case).
+                    const leftDate = parseDate(left);
+                    const rightDate = parseDate(right);
+                    if (leftDate !== undefined && rightDate !== undefined) {
+                        switch (rule.op) {
+                            case '<': return leftDate < rightDate;
+                            case '<=': return leftDate <= rightDate;
+                            case '>': return leftDate > rightDate;
+                            case '>=': return leftDate >= rightDate;
+                            case '==': return leftDate === rightDate;
+                            case '!=': return leftDate !== rightDate;
+                        }
+                    }
+                    // String fallback: only equality operators are defined.
+                    const leftText = textOf(left);
+                    const rightText = textOf(right);
+                    if (rule.op === '==')
+                        return leftText === rightText;
+                    if (rule.op === '!=')
+                        return leftText !== rightText;
+                    return false;
+                }, options.evidenceRowLimit, options.signal);
+                break;
+            }
+            case 'freshness': {
+                requireColumn(table.columns, rule.column, ruleIndex);
+                if (!Number.isFinite(rule.maxAgeDays) || rule.maxAgeDays <= 0) {
+                    throw new VerifyRuleError(ruleIndex, `rule ${ruleIndex}: freshness maxAgeDays must be a positive number, got ${String(rule.maxAgeDays)}`);
+                }
+                let asOf;
+                if (rule.asOf !== undefined) {
+                    const parsed = parseDate(rule.asOf);
+                    if (parsed === undefined) {
+                        throw new VerifyRuleError(ruleIndex, `rule ${ruleIndex}: freshness asOf is not a recognized date: ${JSON.stringify(rule.asOf)}`);
+                    }
+                    asOf = parsed;
+                }
+                else {
+                    asOf = options.now();
+                }
+                const maxAgeMs = rule.maxAgeDays * 86_400_000;
+                result = evaluate(table, ruleIndex, rule.rule, [rule.column], (row) => {
+                    const epoch = parseDate(row[rule.column]);
+                    if (epoch === undefined)
+                        return false;
+                    return asOf - epoch <= maxAgeMs;
+                }, options.evidenceRowLimit, options.signal);
+                break;
+            }
+            default:
+                throw new VerifyRuleError(ruleIndex, `rule ${ruleIndex}: unknown rule type ${JSON.stringify(rule.rule)}`);
+        }
+        results.push(result);
+    }
+    return {
+        passed: results.every((result) => result.passed),
+        rowCount: table.rows.length,
+        rules: results,
+        generatedAt: options.now(),
+    };
+}
+/** Human-readable verify summary for the tool's Native render. */
+export function renderVerifyText(report) {
+    const lines = [];
+    lines.push(`Verification of ${report.dataset}: ${report.passed ? 'PASSED' : 'FAILED'} (${report.rowCount} rows, ${report.rules.length} rules)`);
+    for (const rule of report.rules) {
+        lines.push(`- [${rule.passed ? 'pass' : 'FAIL'}] rule ${rule.ruleIndex} (${rule.rule}): ${rule.failedCount}/${rule.checkedCount} row(s) failed`);
+        for (const row of rule.evidence) {
+            const cells = Object.entries(row.values).map(([column, value]) => `${column}=${JSON.stringify(value)}`).join(', ');
+            lines.push(`    row ${row.rowIndex}: ${cells}`);
+        }
+        if (rule.failedCount > rule.evidence.length) {
+            lines.push(`    … and ${rule.failedCount - rule.evidence.length} more failing row(s)`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Parse a JSON-path-ish locator (`rows[3].nav`, `summary.annualReturn`,
+ * `[0].value`) into walk segments. Throws on unparsable input.
+ * @param locator - the citation's path string.
+ * @returns ordered walk segments.
+ */
+export function parseLocator(locator) {
+    if (locator.trim() === '')
+        throw new Error('citation path must not be empty');
+    const segments = [];
+    for (const part of locator.split('.')) {
+        const match = /^([A-Za-z0-9_$-]*)((?:\[\d+\])*)$/u.exec(part);
+        if (match === null || (match[1] === '' && match[2] === '')) {
+            throw new Error(`unparsable citation path segment ${JSON.stringify(part)} in ${JSON.stringify(locator)}`);
+        }
+        const indices = [...(match[2] ?? '').matchAll(/\[(\d+)\]/gu)].map((index) => Number(index[1]));
+        segments.push({ key: match[1] === '' ? undefined : match[1], indices });
+    }
+    return segments;
+}
+/** Sentinel for a failed locator walk (distinguishable from an actual `undefined` value). */
+const NOT_FOUND = Symbol('not-found');
+/** Walk the document root along the parsed locator; returns {@link NOT_FOUND} when any step misses. */
+function walkLocator(root, segments) {
+    let current = root.kind === 'table' ? { columns: root.columns, rows: root.rows } : root.value;
+    for (const segment of segments) {
+        if (segment.key !== undefined) {
+            if (typeof current !== 'object' || current === null || Array.isArray(current))
+                return NOT_FOUND;
+            if (!Object.prototype.hasOwnProperty.call(current, segment.key))
+                return NOT_FOUND;
+            current = current[segment.key];
+        }
+        for (const index of segment.indices) {
+            if (!Array.isArray(current) || index >= current.length)
+                return NOT_FOUND;
+            current = current[index];
+        }
+    }
+    return current;
+}
+/** Relative-tolerance numeric comparison (never raw `===` on floats). */
+function numericClose(actual, cited, tolerance) {
+    return Math.abs(actual - cited) <= tolerance * Math.max(Math.abs(actual), Math.abs(cited), Number.MIN_VALUE);
+}
+/** Display form of a located value for evidence notes (`undefined` when it cannot be rendered). */
+function displayActual(located) {
+    if (typeof located === 'string')
+        return located;
+    if (typeof located === 'number' || typeof located === 'boolean')
+        return String(located);
+    if (located === null)
+        return 'null';
+    const rendered = JSON.stringify(located);
+    return typeof rendered === 'string' ? rendered : undefined;
+}
+/**
+ * The frozen citation-checking semantics: locate each citation's `path` in the
+ * dataset document, then compare. Numbers compare with relative `tolerance`
+ * (falling back to `defaultTolerance`); strings compare exactly. A missing
+ * location is `not-found`; an incomparable actual/cited type pair is
+ * `unverifiable`.
+ * @param root - the loaded dataset document.
+ * @param citations - citations to check.
+ * @param defaultTolerance - configured fallback relative tolerance.
+ * @returns one result per citation, ids echoed.
+ */
+export function checkCitations(root, citations, defaultTolerance) {
+    const results = [];
+    for (const citation of citations) {
+        let located;
+        try {
+            located = walkLocator(root, parseLocator(citation.path));
+        }
+        catch (error) {
+            results.push({
+                id: citation.id,
+                status: 'not-found',
+                note: `path ${JSON.stringify(citation.path)} is not a valid locator: ${error instanceof Error ? error.message : String(error)}`,
+            });
+            continue;
+        }
+        if (located === NOT_FOUND) {
+            results.push({ id: citation.id, status: 'not-found', note: `nothing found at ${JSON.stringify(citation.path)}` });
+            continue;
+        }
+        if (typeof citation.value === 'number') {
+            const actualNumber = typeof located === 'number' ? located : parseNumeric(located);
+            if (actualNumber === undefined) {
+                const display = displayActual(located);
+                results.push({
+                    id: citation.id,
+                    status: 'unverifiable',
+                    ...(display !== undefined ? { actual: display } : {}),
+                    note: `value at ${JSON.stringify(citation.path)} is not numeric and cannot be compared to ${citation.value}`,
+                });
+                continue;
+            }
+            const tolerance = citation.tolerance ?? defaultTolerance;
+            if (numericClose(actualNumber, citation.value, tolerance)) {
+                results.push({ id: citation.id, status: 'verified', actual: actualNumber, note: `within relative tolerance ${tolerance}` });
+            }
+            else {
+                results.push({
+                    id: citation.id,
+                    status: 'mismatch',
+                    actual: actualNumber,
+                    note: `cited ${citation.value} differs from actual ${actualNumber} beyond relative tolerance ${tolerance}`,
+                });
+            }
+            continue;
+        }
+        // Cited a string: exact comparison against a string actual only.
+        if (typeof located === 'string') {
+            if (located === citation.value) {
+                results.push({ id: citation.id, status: 'verified', actual: located });
+            }
+            else {
+                results.push({ id: citation.id, status: 'mismatch', actual: located, note: `cited ${JSON.stringify(citation.value)} != actual ${JSON.stringify(located)}` });
+            }
+            continue;
+        }
+        const display = displayActual(located);
+        results.push({
+            id: citation.id,
+            status: 'unverifiable',
+            ...(display !== undefined ? { actual: display } : {}),
+            note: `value at ${JSON.stringify(citation.path)} is ${typeof located}, not comparable to cited string`,
+        });
+    }
+    return { results };
+}
+//# sourceMappingURL=verify.js.map

package/lib/types/verify.js.map

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

package/lib/types/version.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Plugin version, kept in one place so `scripts/release.mjs` can stamp it and
+ * reports can name their generator.
+ * @module dsh-data-quality/version
+ */
+/** The package version reported in persisted reports. */
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/lib/types/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yDAAyD;AACzD,eAAO,MAAM,OAAO,UAAU,CAAA"}

package/lib/types/version.js

@@ -0,0 +1,8 @@
+/**
+ * Plugin version, kept in one place so `scripts/release.mjs` can stamp it and
+ * reports can name their generator.
+ * @module dsh-data-quality/version
+ */
+/** The package version reported in persisted reports. */
+export const VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/lib/types/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yDAAyD;AACzD,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAA"}