dsh-data-quality 0.1.2 → 0.2.0

package/lib/types/config.d.ts

@@ -5,6 +5,15 @@
  * @module dsh-data-quality/config
  */
 import z from '@deepseek-ai/schemastery';
+/** Per-dimension scorecard weights (all optional; defaults fill to `1` = equal). */
+export interface ScorecardWeights {
+    completeness?: number;
+    uniqueness?: number;
+    validity?: number;
+    consistency?: number;
+    timeliness?: number;
+    accuracy?: number;
+}
 /** Raw plugin config — every field optional; {@link resolveConfig} supplies the defaults. */
 export interface Config {
     /** Master switch; `false` mounts nothing. */
@@ -23,6 +32,8 @@ export interface Config {
     workspaceRoot?: string;
     /** Persist reports to the `data_quality` storage domain. */
     storeReports?: boolean;
+    /** Per-dimension weights for the scorecard's weighted overall total (non-negative). */
+    scorecardWeights?: ScorecardWeights;
 }
 /** Fully resolved config handed to the runtime. */
 export interface ResolvedConfig {
@@ -34,6 +45,7 @@ export interface ResolvedConfig {
     readonly allowedExtensions: readonly string[];
     readonly workspaceRoot: string;
     readonly storeReports: boolean;
+    readonly scorecardWeights: Required<ScorecardWeights>;
 }
 /** Schemastery schema: the loader validates and fills defaults before `apply`. */
 export declare const Config: z<Config>;

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,6FAA6F;AAC7F,MAAM,WAAW,MAAM;IACrB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,2GAA2G;IAC3G,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;CAC/B;AAED,kFAAkF;AAClF,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAS3B,CAAA;AAgBF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,MAAW,GAAG,cAAc,CA8BjE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAeD,6FAA6F;AAC7F,MAAM,WAAW,MAAM;IACrB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,2GAA2G;IAC3G,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CACpC;AAED,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAA;CACtD;AAED,kFAAkF;AAClF,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAmB3B,CAAA;AAgBF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,MAAW,GAAG,cAAc,CAiCjE"}

package/lib/types/config.js

@@ -5,6 +5,17 @@
  * @module dsh-data-quality/config
  */
 import z from '@deepseek-ai/schemastery';
+/** The six scorecard dimension ids, in report order (kept in sync with `scorecard.ts`). */
+const SCORECARD_DIMENSIONS = ['completeness', 'uniqueness', 'validity', 'consistency', 'timeliness', 'accuracy'];
+/** Equal-weight defaults for {@link ScorecardWeights}. */
+const EQUAL_WEIGHTS = {
+    completeness: 1,
+    uniqueness: 1,
+    validity: 1,
+    consistency: 1,
+    timeliness: 1,
+    accuracy: 1,
+};
 /** Schemastery schema: the loader validates and fills defaults before `apply`. */
 export const Config = z.object({
     enabled: z.boolean().default(true),
@@ -15,6 +26,16 @@ export const Config = z.object({
     allowedExtensions: z.array(z.string()).default(['.csv', '.tsv', '.json', '.jsonl']),
     workspaceRoot: z.string().default(''),
     storeReports: z.boolean().default(true),
+    scorecardWeights: z
+        .object({
+        completeness: z.number().default(1),
+        uniqueness: z.number().default(1),
+        validity: z.number().default(1),
+        consistency: z.number().default(1),
+        timeliness: z.number().default(1),
+        accuracy: z.number().default(1),
+    })
+        .default(EQUAL_WEIGHTS),
 });
 /** Throw unless `value` is a positive safe integer. */
 function assertPositiveInt(name, value) {
@@ -52,6 +73,7 @@ export function resolveConfig(config = {}) {
     if (allowedExtensions.length === 0) {
         throw new TypeError('allowedExtensions must not be empty');
     }
+    const scorecardWeights = resolveScorecardWeights(config.scorecardWeights);
     return {
         enabled: config.enabled ?? true,
         maxRows,
@@ -61,6 +83,19 @@ export function resolveConfig(config = {}) {
         allowedExtensions,
         workspaceRoot: config.workspaceRoot ?? '',
         storeReports: config.storeReports ?? true,
+        scorecardWeights,
     };
 }
+/** Resolve scorecard weights, filling defaults and rejecting non-negative violations loudly. */
+function resolveScorecardWeights(weights = {}) {
+    const out = {};
+    for (const dimension of SCORECARD_DIMENSIONS) {
+        const value = weights[dimension] ?? 1;
+        if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {
+            throw new TypeError(`scorecardWeights.${dimension} must be a non-negative finite number, got ${String(value)}`);
+        }
+        out[dimension] = value;
+    }
+    return out;
+}
 //# sourceMappingURL=config.js.map

package/lib/types/config.js.map

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

package/lib/types/contract.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Delivery contract for `data_clean`: a deterministic pre-delivery validation
+ * summary (primary-key/type/dedupe row-count comparison plus uniqueness and
+ * non-null regression) and the clean before/after profile diff report. Pure —
+ * no I/O, no clock, no RNG; timestamps are injected.
+ * @module dsh-data-quality/contract
+ */
+import { type Table } from './dataset.js';
+import type { CleanResult, CleanRule } from './clean.js';
+import { type ProfileReport } from './profile.js';
+import type { ScorecardDimensionName } from './scorecard.js';
+/** The pre-delivery contract summary attached to a clean run. */
+export interface CleanContractSummary {
+    /** Row count before cleaning. */
+    readonly inputRows: number;
+    /** Row count after cleaning. */
+    readonly outputRows: number;
+    /** Rows removed across all rules. */
+    readonly removedRows: number;
+    /** Key columns of the first `dedupe` rule; `null` when no dedupe rule ran (uniqueness then covers full rows). */
+    readonly dedupeColumns: string[] | null;
+    /** Whether the uniqueness key is free of duplicates in the cleaned output. */
+    readonly uniqueKeys: boolean;
+    /** Remaining duplicate rows over the uniqueness key in the cleaned output. */
+    readonly remainingDuplicateRows: number;
+    /** Non-null regression: remaining missing cells in columns a `fill-missing` rule targeted. */
+    readonly remainingMissing: Array<{
+        readonly column: string;
+        readonly count: number;
+    }>;
+    /** Type regression: remaining non-conforming cells in columns a `coerce-type` rule targeted. */
+    readonly typeConformance: Array<{
+        readonly column: string;
+        readonly to: 'number' | 'date' | 'boolean';
+        readonly invalidCount: number;
+    }>;
+    /** Per-column decision trace: which strategies touched each column and how many rows they affected. */
+    readonly columnDecisions: Array<{
+        readonly column: string;
+        readonly decisions: Array<{
+            readonly strategy: string;
+            readonly affectedRows: number;
+        }>;
+    }>;
+}
+/** The clean before/after profile diff report (persisted under the `clean-diff` report kind). */
+export interface CleanProfileDiff {
+    readonly dataset: string;
+    /** Full profile of the input dataset. */
+    readonly before: ProfileReport;
+    /** Full profile of the cleaned output (including its scorecard). */
+    readonly after: ProfileReport;
+    readonly generatedAt: number;
+}
+/**
+ * Compute the pre-delivery contract summary from a cleaning run: dedupe
+ * before/after row counts, the dedupe key's uniqueness regression, and the
+ * non-null/type regressions over the columns the rules targeted.
+ * @param result - the cleaning outcome (input/output rows plus cleaned rows).
+ * @param rules - the ordered rules that produced `result`.
+ * @param options - optional abort signal.
+ * @returns the contract summary.
+ */
+export declare function computeCleanContract(result: CleanResult, rules: readonly CleanRule[], options?: {
+    signal?: AbortSignal | undefined;
+}): CleanContractSummary;
+/**
+ * Build the clean before/after profile diff: two full {@link ProfileReport}
+ * snapshots (input and cleaned output) under one envelope. Reuses the profile
+ * engine so the scorecard and duplicate detection stay consistent across the
+ * whole plugin.
+ * @param input - the input dataset.
+ * @param output - the cleaned dataset.
+ * @param options - dataset label, injected timestamp, optional weights, optional abort signal.
+ * @returns the diff report.
+ */
+export declare function computeCleanProfileDiff(input: Table, output: Table, options: {
+    dataset: string;
+    generatedAt: number;
+    scorecardWeights?: Readonly<Record<ScorecardDimensionName, number>> | undefined;
+    signal?: AbortSignal | undefined;
+}): CleanProfileDiff;
+//# sourceMappingURL=contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/contract.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAA8E,KAAK,KAAK,EAAE,MAAM,cAAc,CAAA;AACrH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACxD,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAA;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAE5D,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACnC,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,qCAAqC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,iHAAiH;IACjH,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACvC,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAA;IACvC,8FAA8F;IAC9F,QAAQ,CAAC,gBAAgB,EAAE,KAAK,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACrF,gGAAgG;IAChG,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACvI,uGAAuG;IACvG,QAAQ,CAAC,eAAe,EAAE,KAAK,CAAC;QAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;QACvB,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;YAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KACxF,CAAC,CAAA;CACH;AAED,iGAAiG;AACjG,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B;AAyBD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;CAAO,GACjD,oBAAoB,CAuCtB;AAsCD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,KAAK,EACb,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;CAAE,GACnK,gBAAgB,CAclB"}

package/lib/types/contract.js

@@ -0,0 +1,144 @@
+/**
+ * Delivery contract for `data_clean`: a deterministic pre-delivery validation
+ * summary (primary-key/type/dedupe row-count comparison plus uniqueness and
+ * non-null regression) and the clean before/after profile diff report. Pure —
+ * no I/O, no clock, no RNG; timestamps are injected.
+ * @module dsh-data-quality/contract
+ */
+import { isMissing, parseBoolean, parseDate, parseNumeric, throwIfAborted } from "./dataset.js";
+import { profileTable } from "./profile.js";
+/** Count missing cells in one column of the cleaned output. */
+function countMissing(rows, column, signal) {
+    let count = 0;
+    for (const [index, row] of rows.entries()) {
+        if (index % 1024 === 0)
+            throwIfAborted(signal);
+        if (isMissing(row[column]))
+            count += 1;
+    }
+    return count;
+}
+/** Count present cells in one column that still fail to parse as the requested type. */
+function countNonConforming(rows, column, to, signal) {
+    let count = 0;
+    for (const [index, row] of rows.entries()) {
+        if (index % 1024 === 0)
+            throwIfAborted(signal);
+        const cell = row[column];
+        if (isMissing(cell))
+            continue;
+        const conforms = to === 'number' ? parseNumeric(cell) !== undefined : to === 'date' ? parseDate(cell) !== undefined : parseBoolean(cell) !== undefined;
+        if (!conforms)
+            count += 1;
+    }
+    return count;
+}
+/**
+ * Compute the pre-delivery contract summary from a cleaning run: dedupe
+ * before/after row counts, the dedupe key's uniqueness regression, and the
+ * non-null/type regressions over the columns the rules targeted.
+ * @param result - the cleaning outcome (input/output rows plus cleaned rows).
+ * @param rules - the ordered rules that produced `result`.
+ * @param options - optional abort signal.
+ * @returns the contract summary.
+ */
+export function computeCleanContract(result, rules, options = {}) {
+    const dedupeRule = rules.find((rule) => rule.rule === 'dedupe');
+    const dedupeColumns = dedupeRule === undefined ? null : [...(dedupeRule.columns ?? result.columns)];
+    const keyColumns = dedupeColumns ?? result.columns;
+    const seen = new Set();
+    let remainingDuplicateRows = 0;
+    for (const [index, row] of result.rows.entries()) {
+        if (index % 1024 === 0)
+            throwIfAborted(options.signal);
+        const key = JSON.stringify(keyColumns.map((column) => row[column] ?? null));
+        if (seen.has(key)) {
+            remainingDuplicateRows += 1;
+        }
+        else {
+            seen.add(key);
+        }
+    }
+    const remainingMissing = rules
+        .filter((rule) => rule.rule === 'fill-missing')
+        .map((rule) => {
+        const fill = rule;
+        return { column: fill.column, count: countMissing(result.rows, fill.column, options.signal) };
+    });
+    const typeConformance = rules
+        .filter((rule) => rule.rule === 'coerce-type')
+        .map((rule) => {
+        const coerce = rule;
+        return { column: coerce.column, to: coerce.to, invalidCount: countNonConforming(result.rows, coerce.column, coerce.to, options.signal) };
+    });
+    const columnDecisions = traceColumnDecisions(result, rules);
+    return {
+        inputRows: result.inputRows,
+        outputRows: result.outputRows,
+        removedRows: result.inputRows - result.outputRows,
+        dedupeColumns,
+        uniqueKeys: remainingDuplicateRows === 0,
+        remainingDuplicateRows,
+        remainingMissing,
+        typeConformance,
+        columnDecisions,
+    };
+}
+/** The columns a single rule targets (single-column rules target one column; trim/dedupe may target many). */
+function ruleColumns(rule, allColumns) {
+    switch (rule.rule) {
+        case 'fill-missing':
+        case 'coerce-type':
+        case 'normalize-unit':
+        case 'map-values':
+            return [rule.column];
+        case 'trim':
+        case 'dedupe':
+            return [...(rule.columns ?? allColumns)];
+        default:
+            return [];
+    }
+}
+/** Build the per-column decision trace: strategies + affected rows, in dataset column order. */
+function traceColumnDecisions(result, rules) {
+    const byColumn = new Map();
+    for (const [index, rule] of rules.entries()) {
+        const log = result.logs[index];
+        if (log === undefined)
+            continue;
+        for (const column of ruleColumns(rule, result.columns)) {
+            const list = byColumn.get(column) ?? [];
+            list.push({ strategy: rule.rule, affectedRows: log.affectedRows });
+            byColumn.set(column, list);
+        }
+    }
+    return result.columns
+        .filter((column) => byColumn.has(column))
+        .map((column) => ({ column, decisions: byColumn.get(column) }));
+}
+/**
+ * Build the clean before/after profile diff: two full {@link ProfileReport}
+ * snapshots (input and cleaned output) under one envelope. Reuses the profile
+ * engine so the scorecard and duplicate detection stay consistent across the
+ * whole plugin.
+ * @param input - the input dataset.
+ * @param output - the cleaned dataset.
+ * @param options - dataset label, injected timestamp, optional weights, optional abort signal.
+ * @returns the diff report.
+ */
+export function computeCleanProfileDiff(input, output, options) {
+    const before = profileTable(input, {
+        dataset: options.dataset,
+        generatedAt: options.generatedAt,
+        scorecardWeights: options.scorecardWeights,
+        signal: options.signal,
+    });
+    const after = profileTable(output, {
+        dataset: options.dataset,
+        generatedAt: options.generatedAt,
+        scorecardWeights: options.scorecardWeights,
+        signal: options.signal,
+    });
+    return { dataset: options.dataset, before, after, generatedAt: options.generatedAt };
+}
+//# sourceMappingURL=contract.js.map

package/lib/types/contract.js.map

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

package/lib/types/dataset.d.ts

@@ -11,12 +11,21 @@ import type { ResolvedConfig } from './config.js';
 export type Cell = JsonValue;
 /** One dataset row keyed by column name. */
 export type Row = Record<string, Cell>;
+/** Detected file encoding metadata (BOM presence + UTF-8 validity). */
+export interface EncodingInfo {
+    /** `'utf-8'` when a UTF-8 byte-order mark was present, else `null`. */
+    readonly bom: 'utf-8' | null;
+    /** Whether the bytes decode as valid UTF-8 (no replacement characters forced). */
+    readonly validUtf8: boolean;
+}
 /** A tabular dataset: ordered columns plus rows. */
 export interface Table {
     /** Column names in file order. */
     readonly columns: string[];
     /** Rows, each carrying every declared column (missing cells are `null`). */
     readonly rows: Row[];
+    /** Detected file encoding; present only for tables loaded from a file. */
+    readonly encoding?: EncodingInfo;
 }
 /** The root form a document load returns (citation checking walks this). */
 export type DocumentRoot = {
@@ -55,13 +64,25 @@ export declare function pathFingerprint(datasetPath: string): string;
 /** Assert the abort signal has not fired; throws the signal reason otherwise. */
 export declare function throwIfAborted(signal: AbortSignal | undefined): void;
 /**
- * Read a dataset file under the size cap.
+ * Detect a UTF-8 byte-order mark and validate the byte sequence. Invalid
+ * UTF-8 is a data-quality finding the profile reports (`validUtf8: false`)
+ * rather than a structural error that blocks the read — the decoded text
+ * keeps U+FFFD replacement characters so the profile can still run.
+ * @param buffer - raw file bytes.
+ * @returns the encoding metadata.
+ */
+export declare function detectEncoding(buffer: Uint8Array): EncodingInfo;
+/**
+ * Read a dataset file under the size cap, detecting its encoding.
  * @param absolutePath - normalized absolute path (from {@link resolveWorkspacePath}).
  * @param config - resolved config (size cap).
  * @param signal - optional abort signal honored around the read.
- * @returns the UTF-8 text.
+ * @returns the decoded UTF-8 text plus its encoding metadata.
  */
-export declare function readDatasetText(absolutePath: string, config: ResolvedConfig, signal?: AbortSignal): Promise<string>;
+export declare function readDatasetFile(absolutePath: string, config: ResolvedConfig, signal?: AbortSignal): Promise<{
+    text: string;
+    encoding: EncodingInfo;
+}>;
 /**
  * Parse CSV/TSV text (RFC-4180-style: quoted fields, `""` escapes, CRLF/LF).
  * The first record is the header; short records pad with `null`, long records
@@ -119,6 +140,17 @@ export declare function sampleRows(rows: Row[], count: number): Row[];
 export declare function isMissing(cell: Cell | undefined): boolean;
 /** Strict full-string numeric parse (no thousands separators, no unit suffixes). */
 export declare function parseNumeric(cell: Cell | undefined): number | undefined;
+/** Deterministic date-format labels in {@link DATE_PATTERNS} order. */
+declare const DATE_FORMATS: readonly ["iso-date", "slash-date", "datetime"];
+/** The format label of a recognized date cell (source pattern, not the epoch). */
+export type DateFormat = (typeof DATE_FORMATS)[number];
+/** A recognized date cell: its parsed epoch plus the source format label. */
+export interface DateParse {
+    /** Epoch milliseconds (UTC). */
+    readonly epoch: number;
+    /** Which {@link DATE_PATTERNS} entry matched. */
+    readonly format: DateFormat;
+}
 /**
  * Deterministic date parse to epoch milliseconds. Accepts `YYYY-MM-DD`,
  * `YYYY/MM/DD`, and ISO-like datetimes (date-only forms read as UTC midnight).
@@ -128,6 +160,21 @@ export declare function parseNumeric(cell: Cell | undefined): number | undefined
  * @returns epoch milliseconds, or `undefined`.
  */
 export declare function parseDate(cell: Cell | undefined): number | undefined;
+/**
+ * Parse one date cell to its epoch plus source format label.
+ * @param cell - the cell to parse (`undefined` when the column is absent).
+ * @returns the parsed date, or `undefined` when the cell is not a recognized date.
+ */
+export declare function parseDateCell(cell: Cell | undefined): DateParse | undefined;
+/**
+ * The format label of a recognized date cell (`iso-date` / `slash-date` /
+ * `datetime`); `undefined` when the cell is not a recognized date. Used to
+ * measure a date column's format consistency.
+ * @param cell - the cell to inspect (`undefined` when the column is absent).
+ * @returns the source format label, or `undefined`.
+ */
+export declare function dateFormatOf(cell: Cell | undefined): DateFormat | undefined;
 /** Boolean parse: true/false/yes/no/1/0, case-insensitive. */
 export declare function parseBoolean(cell: Cell | undefined): boolean | undefined;
+export {};
 //# sourceMappingURL=dataset.d.ts.map

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

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

package/lib/types/dataset.js

@@ -8,6 +8,7 @@
 import { open, stat } from 'node:fs/promises';
 import path from 'node:path';
 import { createHash } from 'node:crypto';
+import { TextDecoder } from 'node:util';
 /** Raised for every user-facing dataset failure; `code` is stable for tests and tooling. */
 export class DatasetError extends Error {
     code;
@@ -60,13 +61,38 @@ export function throwIfAborted(signal) {
     }
 }
 /**
- * Read a dataset file under the size cap.
+ * Detect a UTF-8 byte-order mark and validate the byte sequence. Invalid
+ * UTF-8 is a data-quality finding the profile reports (`validUtf8: false`)
+ * rather than a structural error that blocks the read — the decoded text
+ * keeps U+FFFD replacement characters so the profile can still run.
+ * @param buffer - raw file bytes.
+ * @returns the encoding metadata.
+ */
+export function detectEncoding(buffer) {
+    const bom = buffer.length >= 3 && buffer[0] === 0xef && buffer[1] === 0xbb && buffer[2] === 0xbf ? 'utf-8' : null;
+    const body = bom === 'utf-8' ? buffer.subarray(3) : buffer;
+    let validUtf8 = true;
+    try {
+        new TextDecoder('utf-8', { fatal: true }).decode(body);
+    }
+    catch {
+        validUtf8 = false;
+    }
+    return { bom, validUtf8 };
+}
+/** Decode file bytes, stripping a UTF-8 BOM and preserving replacement characters for invalid bytes. */
+function decodeUtf8Text(buffer, encoding) {
+    const body = encoding.bom === 'utf-8' ? buffer.subarray(3) : buffer;
+    return new TextDecoder('utf-8').decode(body);
+}
+/**
+ * Read a dataset file under the size cap, detecting its encoding.
  * @param absolutePath - normalized absolute path (from {@link resolveWorkspacePath}).
  * @param config - resolved config (size cap).
  * @param signal - optional abort signal honored around the read.
- * @returns the UTF-8 text.
+ * @returns the decoded UTF-8 text plus its encoding metadata.
  */
-export async function readDatasetText(absolutePath, config, signal) {
+export async function readDatasetFile(absolutePath, config, signal) {
     throwIfAborted(signal);
     let info;
     try {
@@ -85,7 +111,9 @@ export async function readDatasetText(absolutePath, config, signal) {
     const handle = await open(absolutePath, 'r');
     try {
         throwIfAborted(signal);
-        return await handle.readFile('utf8');
+        const buffer = await handle.readFile();
+        const encoding = detectEncoding(buffer);
+        return { text: decodeUtf8Text(buffer, encoding), encoding };
     }
     finally {
         await handle.close();
@@ -273,14 +301,14 @@ function parseJsonLines(text) {
  * @returns the parsed table.
  */
 export async function loadTable(absolutePath, config, signal) {
-    const text = await readDatasetText(absolutePath, config, signal);
+    const { text, encoding } = await readDatasetFile(absolutePath, config, signal);
     const ext = path.extname(absolutePath).toLowerCase();
     throwIfAborted(signal);
     if (ext === '.csv')
-        return parseDelimited(text, ',', config, signal);
+        return { ...parseDelimited(text, ',', config, signal), encoding };
     if (ext === '.tsv')
-        return parseDelimited(text, '\t', config, signal);
-    return parseJsonTable(text, ext, config, signal);
+        return { ...parseDelimited(text, '\t', config, signal), encoding };
+    return { ...parseJsonTable(text, ext, config, signal), encoding };
 }
 /**
  * Load a dataset as a citation-checkable document root: CSV/TSV become
@@ -294,11 +322,11 @@ export async function loadTable(absolutePath, config, signal) {
 export async function loadDocument(absolutePath, config, signal) {
     const ext = path.extname(absolutePath).toLowerCase();
     if (ext === '.json') {
-        const text = await readDatasetText(absolutePath, config, signal);
+        const { text } = await readDatasetFile(absolutePath, config, signal);
         return { kind: 'json', value: parseJsonDocument(text) };
     }
     if (ext === '.jsonl') {
-        const text = await readDatasetText(absolutePath, config, signal);
+        const { text } = await readDatasetFile(absolutePath, config, signal);
         return { kind: 'json', value: parseJsonLines(text) };
     }
     const table = await loadTable(absolutePath, config, signal);
@@ -356,19 +384,14 @@ const DATE_PATTERNS = [
     /^(\d{4})\/(\d{1,2})\/(\d{1,2})$/u,
     /^(\d{4})-(\d{1,2})-(\d{1,2})[ T](\d{1,2}):(\d{2})(?::(\d{2}))?(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})?$/u,
 ];
-/**
- * Deterministic date parse to epoch milliseconds. Accepts `YYYY-MM-DD`,
- * `YYYY/MM/DD`, and ISO-like datetimes (date-only forms read as UTC midnight).
- * Calendar-invalid dates (e.g. 2025-13-40) reject. Returns `undefined` when
- * the cell is not a recognized date.
- * @param cell - the cell to parse (`undefined` when the column is absent).
- * @returns epoch milliseconds, or `undefined`.
- */
-export function parseDate(cell) {
+/** Deterministic date-format labels in {@link DATE_PATTERNS} order. */
+const DATE_FORMATS = ['iso-date', 'slash-date', 'datetime'];
+/** Parse one date cell to its epoch plus format; `undefined` when unrecognized. */
+function parseDateCellInternal(cell) {
     if (typeof cell !== 'string')
         return undefined;
     const text = cell.trim();
-    for (const pattern of DATE_PATTERNS) {
+    for (const [index, pattern] of DATE_PATTERNS.entries()) {
         const match = pattern.exec(text);
         if (match === null)
             continue;
@@ -384,10 +407,42 @@ export function parseDate(cell) {
         const check = new Date(epoch);
         if (check.getUTCMonth() !== month - 1 || check.getUTCDate() !== day)
             return undefined;
-        return epoch;
+        const format = DATE_FORMATS[index];
+        if (format === undefined)
+            return undefined;
+        return { epoch, format };
     }
     return undefined;
 }
+/**
+ * Deterministic date parse to epoch milliseconds. Accepts `YYYY-MM-DD`,
+ * `YYYY/MM/DD`, and ISO-like datetimes (date-only forms read as UTC midnight).
+ * Calendar-invalid dates (e.g. 2025-13-40) reject. Returns `undefined` when
+ * the cell is not a recognized date.
+ * @param cell - the cell to parse (`undefined` when the column is absent).
+ * @returns epoch milliseconds, or `undefined`.
+ */
+export function parseDate(cell) {
+    return parseDateCellInternal(cell)?.epoch;
+}
+/**
+ * Parse one date cell to its epoch plus source format label.
+ * @param cell - the cell to parse (`undefined` when the column is absent).
+ * @returns the parsed date, or `undefined` when the cell is not a recognized date.
+ */
+export function parseDateCell(cell) {
+    return parseDateCellInternal(cell);
+}
+/**
+ * The format label of a recognized date cell (`iso-date` / `slash-date` /
+ * `datetime`); `undefined` when the cell is not a recognized date. Used to
+ * measure a date column's format consistency.
+ * @param cell - the cell to inspect (`undefined` when the column is absent).
+ * @returns the source format label, or `undefined`.
+ */
+export function dateFormatOf(cell) {
+    return parseDateCellInternal(cell)?.format;
+}
 /** Boolean parse: true/false/yes/no/1/0, case-insensitive. */
 export function parseBoolean(cell) {
     if (typeof cell === 'boolean')