dsh-data-quality 0.1.0

package/lib/types/provider-local.js

@@ -0,0 +1,163 @@
+/**
+ * The local deterministic Provider of the `ctx.dataQuality` seam: orchestrates
+ * dataset loading, the pure engines, durable report persistence, and the
+ * adaptive `data-quality/*` session events. All computation is TypeScript in
+ * this process — no model arithmetic, no external processes.
+ * @module dsh-data-quality/provider-local
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { loadDocument, loadTable, resolveWorkspacePath, throwIfAborted } from "./dataset.js";
+import { applyCleanRules, serializeDelimited } from "./clean.js";
+import { profileTable } from "./profile.js";
+import { checkCitations, verifyTable } from "./verify.js";
+import { appendDataQualityEvent } from "./events.js";
+import { reportKeyOf } from "./store.js";
+import { truncateRow } from "./present.js";
+import { DataQualityService, } from "./service.js";
+/**
+ * The local deterministic `dataQuality` implementation. Mounted by the plugin
+ * entry; third-party plugins consume it through `ctx.dataQuality`.
+ */
+export class LocalDataQualityService extends DataQualityService {
+    config;
+    deps;
+    /**
+     * @param ctx - the plugin context.
+     * @param config - the resolved plugin config.
+     * @param deps - store handle plus the injected clock.
+     */
+    constructor(ctx, config, deps) {
+        super(ctx);
+        this.config = config;
+        this.deps = deps;
+    }
+    /** The absolute root for service-level calls without a session workspace. */
+    serviceRoot() {
+        return this.config.workspaceRoot !== '' ? path.resolve(this.config.workspaceRoot) : process.cwd();
+    }
+    /** Persist one report when persistence is on; returns the storage key. */
+    async persist(kind, dataset, report) {
+        const store = this.deps.store;
+        if (store === undefined)
+            return undefined;
+        const record = { kind, at: this.deps.now(), dataset, report };
+        const key = reportKeyOf(record);
+        await store.put({ ...record });
+        return key;
+    }
+    /** Emit the adaptive session event when the call carries a session. */
+    emitEvent(session, kind, dataset, reportKey, summary) {
+        if (session === undefined)
+            return;
+        appendDataQualityEvent(session, `data-quality/${kind}`, {
+            kind,
+            dataset,
+            ...(reportKey !== undefined ? { reportKey } : {}),
+            summary,
+        });
+    }
+    /** @inheritdoc DataQualityService.profileDataset */
+    async profileDataset(request) {
+        throwIfAborted(request.signal);
+        const absolute = resolveWorkspacePath(request.workspace, request.dataset, this.config);
+        const table = await loadTable(absolute, this.config, request.signal);
+        const report = profileTable(table, {
+            dataset: request.dataset,
+            sample: request.sample,
+            generatedAt: this.deps.now(),
+            signal: request.signal,
+        });
+        const reportKey = await this.persist('profile', request.dataset, report);
+        this.emitEvent(request.session, 'profile', request.dataset, reportKey, { rows: report.rowCount, columns: report.columnCount });
+        return { ...report, ...(reportKey !== undefined ? { reportKey } : {}) };
+    }
+    /** @inheritdoc DataQualityService.cleanDataset */
+    async cleanDataset(request) {
+        throwIfAborted(request.signal);
+        const absolute = resolveWorkspacePath(request.workspace, request.dataset, this.config);
+        const table = await loadTable(absolute, this.config, request.signal);
+        const result = applyCleanRules(table, request.rules, { signal: request.signal });
+        let writtenPath;
+        if (request.outputPath !== undefined) {
+            const outputAbsolute = resolveWorkspacePath(request.workspace, request.outputPath, this.config);
+            if (outputAbsolute === absolute) {
+                throw new Error(`outputPath ${JSON.stringify(request.outputPath)} would overwrite the input dataset; choose a different path`);
+            }
+            const ext = path.extname(outputAbsolute).toLowerCase();
+            const text = ext === '.csv' || ext === '.tsv'
+                ? serializeDelimited(result.columns, result.rows, ext === '.csv' ? ',' : '\t')
+                : ext === '.jsonl'
+                    ? `${result.rows.map((row) => JSON.stringify(row)).join('\n')}\n`
+                    : `${JSON.stringify(result.rows, null, 2)}\n`;
+            await mkdir(path.dirname(outputAbsolute), { recursive: true });
+            throwIfAborted(request.signal);
+            await writeFile(outputAbsolute, text, 'utf8');
+            writtenPath = request.outputPath;
+        }
+        const generatedAt = this.deps.now();
+        const reportKey = await this.persist('clean', request.dataset, {
+            dataset: request.dataset,
+            inputRows: result.inputRows,
+            outputRows: result.outputRows,
+            logs: result.logs,
+            ...(writtenPath !== undefined ? { outputPath: writtenPath } : {}),
+            generatedAt,
+        });
+        this.emitEvent(request.session, 'clean', request.dataset, reportKey, { rows: result.outputRows, columns: result.columns.length, rules: result.logs.length });
+        const previewRows = result.rows.slice(0, this.config.evidenceRowLimit).map((row) => truncateRow(row));
+        return {
+            dataset: request.dataset,
+            inputRows: result.inputRows,
+            outputRows: result.outputRows,
+            logs: result.logs,
+            preview: { columns: result.columns, rows: previewRows },
+            ...(writtenPath !== undefined ? { outputPath: writtenPath } : {}),
+            ...(reportKey !== undefined ? { reportKey } : {}),
+            generatedAt,
+        };
+    }
+    /** @inheritdoc DataQualityService.verifyDataset */
+    async verifyDataset(request) {
+        throwIfAborted(request.signal);
+        const absolute = resolveWorkspacePath(request.workspace, request.dataset, this.config);
+        const table = await loadTable(absolute, this.config, request.signal);
+        const outcome = verifyTable(table, request.rules, {
+            evidenceRowLimit: this.config.evidenceRowLimit,
+            now: this.deps.now,
+            signal: request.signal,
+        });
+        const report = { dataset: request.dataset, ...outcome };
+        const failedRules = report.rules.filter((rule) => !rule.passed).length;
+        const reportKey = await this.persist('verify', request.dataset, report);
+        this.emitEvent(request.session, 'verify', request.dataset, reportKey, {
+            rows: report.rowCount,
+            rules: report.rules.length,
+            failedRules,
+            passed: report.passed,
+        });
+        return { ...report, ...(reportKey !== undefined ? { reportKey } : {}) };
+    }
+    /** @inheritdoc DataQualityService.verifyCitations */
+    async verifyCitations(request) {
+        const absolute = resolveWorkspacePath(this.serviceRoot(), request.dataset, this.config);
+        const document = await loadDocument(absolute, this.config);
+        const result = checkCitations(document, request.citations, this.config.defaultTolerance);
+        const verified = result.results.filter((entry) => entry.status === 'verified').length;
+        const mismatched = result.results.filter((entry) => entry.status === 'mismatch').length;
+        const notFound = result.results.filter((entry) => entry.status === 'not-found').length;
+        const unverifiable = result.results.filter((entry) => entry.status === 'unverifiable').length;
+        await this.persist('citations', request.dataset, {
+            dataset: request.dataset,
+            checked: result.results.length,
+            verified,
+            mismatched,
+            notFound,
+            unverifiable,
+            results: result.results,
+            generatedAt: this.deps.now(),
+        });
+        return result;
+    }
+}
+//# sourceMappingURL=provider-local.js.map

package/lib/types/provider-local.js.map

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

package/lib/types/service.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Service Definition of the `dsh-data-quality` capability seam: the
+ * `ctx.dataQuality` surface other plugins may optionally consume, plus the
+ * internal request/report types the local Provider and the tool Consumers
+ * share. The {@link CitationCheckRequest} / {@link CitationCheckResult}
+ * citation contract is FROZEN for cross-plugin consumers — change it only
+ * with a coordinated ecosystem migration.
+ * @module dsh-data-quality/service
+ */
+import { Service, type Context } from '@deepseek-ai/cordis';
+import type { JsonValue, Session } from '@deepseek-ai/dsh-session';
+import type { CleanRule, CleanRuleLog } from './clean.js';
+import type { ProfileReport } from './profile.js';
+import type { VerifyReport, VerifyRule } from './verify.js';
+export interface CitationCheckRequest {
+    /** Workspace-relative path of the source dataset snapshot (CSV/JSON). */
+    dataset: string;
+    /** Citations to verify against the dataset. */
+    citations: Array<{
+        /** Stable id chosen by the caller, echoed back in results. */
+        id: string;
+        /** JSON-path-ish locator, e.g. "rows[3].nav" or "summary.annualReturn". */
+        path: string;
+        /** The value as cited in the document. */
+        value: number | string;
+        /** Optional relative tolerance for numeric comparison, e.g. 0.01 = 1%. */
+        tolerance?: number;
+    }>;
+}
+export interface CitationCheckResult {
+    results: Array<{
+        id: string;
+        status: 'verified' | 'mismatch' | 'not-found' | 'unverifiable';
+        /** Actual value found at path, when found. */
+        actual?: number | string;
+        /** Human-readable evidence note. */
+        note?: string;
+    }>;
+}
+/** Profile request through the service layer (tools pass the session workspace). */
+export interface ProfileRequest {
+    /** Workspace-relative dataset path. */
+    readonly dataset: string;
+    /** Optional deterministic systematic sample size for column cards. */
+    readonly sample?: number | undefined;
+    /** Absolute workspace root the dataset resolves inside. */
+    readonly workspace: string;
+    /** Calling session (receives the `data-quality/profile` event), when any. */
+    readonly session?: Session | undefined;
+    /** Cancellation from the tool call. */
+    readonly signal?: AbortSignal | undefined;
+}
+/** Clean request through the service layer. */
+export interface CleanRequest {
+    /** Workspace-relative dataset path. */
+    readonly dataset: string;
+    /** Non-empty declarative cleaning rule list, applied in order. */
+    readonly rules: readonly CleanRule[];
+    /** Workspace-relative output path; omitted = no disk write, preview only. */
+    readonly outputPath?: string | undefined;
+    /** Absolute workspace root the dataset resolves inside. */
+    readonly workspace: string;
+    /** Calling session (receives the `data-quality/clean` event), when any. */
+    readonly session?: Session | undefined;
+    /** Cancellation from the tool call. */
+    readonly signal?: AbortSignal | undefined;
+}
+/** Verify request through the service layer. */
+export interface VerifyRequest {
+    /** Workspace-relative dataset path. */
+    readonly dataset: string;
+    /** Non-empty declarative verification rule list. */
+    readonly rules: readonly VerifyRule[];
+    /** Absolute workspace root the dataset resolves inside. */
+    readonly workspace: string;
+    /** Calling session (receives the `data-quality/verify` event), when any. */
+    readonly session?: Session | undefined;
+    /** Cancellation from the tool call. */
+    readonly signal?: AbortSignal | undefined;
+}
+/** The value a clean run returns (tool canonical value minus presentation). */
+export interface CleanRunReport {
+    readonly dataset: string;
+    readonly inputRows: number;
+    readonly outputRows: number;
+    readonly logs: CleanRuleLog[];
+    /** First `evidenceRowLimit` cleaned rows for inspection (display-truncated). */
+    readonly preview: {
+        readonly columns: string[];
+        readonly rows: Array<Record<string, JsonValue>>;
+    };
+    /** Workspace-relative output path when the run wrote a file. */
+    readonly outputPath?: string;
+    /** Storage-domain key of the persisted report, when persistence is on. */
+    readonly reportKey?: string;
+    readonly generatedAt: number;
+}
+/** The value a verifyCitation call persists (report envelope kind `citations`). */
+export interface CitationCheckPersisted {
+    readonly dataset: string;
+    readonly checked: number;
+    readonly verified: number;
+    readonly mismatched: number;
+    readonly notFound: number;
+    readonly unverifiable: number;
+    readonly results: CitationCheckResult['results'];
+    readonly generatedAt: number;
+}
+/**
+ * The `ctx.dataQuality` service. The local Provider implements deterministic
+ * TypeScript computation; Consumers (the three tools and third-party plugins)
+ * never re-implement the math.
+ */
+export declare abstract class DataQualityService extends Service {
+    /**
+     * Register as `dataQuality` on the context.
+     * @param ctx - the plugin context.
+     */
+    constructor(ctx: Context);
+    /**
+     * Frozen cross-plugin contract: verify document citations against a dataset
+     * snapshot. The dataset resolves against the configured service workspace
+     * root (`workspaceRoot`, defaulting to the harness launch directory).
+     * @param request - dataset path plus citations.
+     * @returns one result per citation, ids echoed.
+     */
+    abstract verifyCitations(request: CitationCheckRequest): Promise<CitationCheckResult>;
+    /**
+     * Profile a workspace dataset (row/column counts, inferred types,
+     * missingness, cardinality, numeric distribution, suspected anomalies).
+     * @param request - dataset path, optional sample size, workspace root.
+     * @returns the profile report.
+     */
+    abstract profileDataset(request: ProfileRequest): Promise<ProfileReport>;
+    /**
+     * Apply declarative cleaning rules to a workspace dataset. The source file
+     * is never overwritten; without `outputPath` nothing touches the disk.
+     * @param request - dataset path, ordered rules, optional output path, workspace root.
+     * @returns the cleaned preview plus the per-rule audit log.
+     */
+    abstract cleanDataset(request: CleanRequest): Promise<CleanRunReport>;
+    /**
+     * Apply declarative verification rules to a workspace dataset. A failing
+     * dataset is a normal result (`passed: false`), never a thrown error.
+     * @param request - dataset path, rules, workspace root.
+     * @returns the verify report.
+     */
+    abstract verifyDataset(request: VerifyRequest): Promise<VerifyReport>;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /** Deterministic data profiling / cleaning / verification, when the dsh-data-quality bundle is mounted. */
+        dataQuality: DataQualityService;
+    }
+}
+/** Re-exports so consumers pull the whole seam vocabulary from one module. */
+export type { CleanResult, CleanRule, CleanRuleLog } from './clean.js';
+export type { ProfileReport } from './profile.js';
+export type { VerifyReport, VerifyRule } from './verify.js';
+//# sourceMappingURL=service.d.ts.map

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

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

package/lib/types/service.js

@@ -0,0 +1,25 @@
+/**
+ * Service Definition of the `dsh-data-quality` capability seam: the
+ * `ctx.dataQuality` surface other plugins may optionally consume, plus the
+ * internal request/report types the local Provider and the tool Consumers
+ * share. The {@link CitationCheckRequest} / {@link CitationCheckResult}
+ * citation contract is FROZEN for cross-plugin consumers — change it only
+ * with a coordinated ecosystem migration.
+ * @module dsh-data-quality/service
+ */
+import { Service } from '@deepseek-ai/cordis';
+/**
+ * The `ctx.dataQuality` service. The local Provider implements deterministic
+ * TypeScript computation; Consumers (the three tools and third-party plugins)
+ * never re-implement the math.
+ */
+export class DataQualityService extends Service {
+    /**
+     * Register as `dataQuality` on the context.
+     * @param ctx - the plugin context.
+     */
+    constructor(ctx) {
+        super(ctx, 'dataQuality');
+    }
+}
+//# sourceMappingURL=service.js.map

package/lib/types/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAgB,MAAM,qBAAqB,CAAA;AAuG3D;;;;GAIG;AACH,MAAM,OAAgB,kBAAmB,SAAQ,OAAO;IACtD;;;OAGG;IACH,YAAY,GAAY;QACtB,KAAK,CAAC,GAAG,EAAE,aAAa,CAAC,CAAA;IAC3B,CAAC;CAkCF"}

package/lib/types/store.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Durable report storage over the harness storage domain. The `data_quality`
+ * domain keeps one record per profile/clean/verify/citations run, keyed by an
+ * injected timestamp plus a path fingerprint, so reports survive a restart
+ * and stay queryable without touching the session log.
+ * @module dsh-data-quality/store
+ */
+import z from 'zod';
+/** Zod schema of one persisted report record (durable-boundary validation). */
+export declare const reportRecordSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        profile: "profile";
+        clean: "clean";
+        verify: "verify";
+        citations: "citations";
+    }>;
+    at: z.ZodNumber;
+    dataset: z.ZodString;
+    report: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+/** One persisted report record. */
+export interface ReportRecord {
+    readonly kind: 'profile' | 'clean' | 'verify' | 'citations';
+    /** Injected run timestamp (epoch ms). */
+    readonly at: number;
+    /** Workspace-relative dataset path as the caller gave it. */
+    readonly dataset: string;
+    /** The full run report (profile/clean/verify/citations shape by `kind`). */
+    readonly report: Record<string, unknown>;
+}
+/** The `dsh-data-quality` storage-domain declaration. */
+export declare const dataQualityDomainSpec: {
+    name: string;
+    version: number;
+    tables: {
+        reports: import("@deepseek-ai/dsh-storage-domain").DomainTableSpec<string, ReportRecord>;
+    };
+};
+/** Handle over the reports table with deterministic key construction. */
+export interface ReportStore {
+    /**
+     * Persist one run report.
+     * @param record - the report envelope (kind/dataset/at/report).
+     * @returns the storage key the record was written under.
+     */
+    put(record: ReportRecord): Promise<string>;
+    /**
+     * Read one persisted report.
+     * @param key - the key {@link put} returned.
+     * @returns the record, or `undefined` when absent.
+     */
+    get(key: string): ReportRecord | undefined;
+}
+/**
+ * Build the storage key for one run: `YYYYMMDDHHmmssSSS-<kind>-<pathFp>`.
+ * UTC digits keep the key timezone-independent and filename-safe everywhere.
+ * @param record - the report envelope.
+ * @returns the deterministic key.
+ */
+export declare function reportKeyOf(record: ReportRecord): string;
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,CAAC,MAAM,KAAK,CAAA;AAInB,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB;;;;;;;;;;iBAK7B,CAAA;AAEF,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,WAAW,CAAA;IAC3D,yCAAyC;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACzC;AAED,yDAAyD;AACzD,eAAO,MAAM,qBAAqB;;;;;;CAMhC,CAAA;AAEF,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC1C;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAA;CAC3C;AAOD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAMxD"}

package/lib/types/store.js

@@ -0,0 +1,42 @@
+/**
+ * Durable report storage over the harness storage domain. The `data_quality`
+ * domain keeps one record per profile/clean/verify/citations run, keyed by an
+ * injected timestamp plus a path fingerprint, so reports survive a restart
+ * and stay queryable without touching the session log.
+ * @module dsh-data-quality/store
+ */
+import z from 'zod';
+import { defineDomain, domainTable } from '@deepseek-ai/dsh-storage-domain';
+import { pathFingerprint } from "./dataset.js";
+/** Zod schema of one persisted report record (durable-boundary validation). */
+export const reportRecordSchema = z.object({
+    kind: z.enum(['profile', 'clean', 'verify', 'citations']),
+    at: z.number().int().nonnegative(),
+    dataset: z.string(),
+    report: z.record(z.string(), z.unknown()),
+});
+/** The `dsh-data-quality` storage-domain declaration. */
+export const dataQualityDomainSpec = defineDomain({
+    name: 'data_quality',
+    version: 1,
+    tables: {
+        reports: domainTable(reportRecordSchema),
+    },
+});
+/** Pad to two digits for the key timestamp. */
+function pad2(value) {
+    return String(value).padStart(2, '0');
+}
+/**
+ * Build the storage key for one run: `YYYYMMDDHHmmssSSS-<kind>-<pathFp>`.
+ * UTC digits keep the key timezone-independent and filename-safe everywhere.
+ * @param record - the report envelope.
+ * @returns the deterministic key.
+ */
+export function reportKeyOf(record) {
+    const date = new Date(record.at);
+    const stamp = `${date.getUTCFullYear()}${pad2(date.getUTCMonth() + 1)}${pad2(date.getUTCDate())}` +
+        `${pad2(date.getUTCHours())}${pad2(date.getUTCMinutes())}${pad2(date.getUTCSeconds())}${String(date.getUTCMilliseconds()).padStart(3, '0')}`;
+    return `${stamp}-${record.kind}-${pathFingerprint(record.dataset)}`;
+}
+//# sourceMappingURL=store.js.map

package/lib/types/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,CAAC,MAAM,KAAK,CAAA;AACnB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IACzD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;CAC1C,CAAC,CAAA;AAaF,yDAAyD;AACzD,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC;IAChD,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,CAAC;IACV,MAAM,EAAE;QACN,OAAO,EAAE,WAAW,CAAuB,kBAAkB,CAAC;KAC/D;CACF,CAAC,CAAA;AAkBF,+CAA+C;AAC/C,SAAS,IAAI,CAAC,KAAa;IACzB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AACvC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,MAAoB;IAC9C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAChC,MAAM,KAAK,GACT,GAAG,IAAI,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE;QACnF,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAA;IAC9I,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,IAAI,IAAI,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAA;AACrE,CAAC"}

package/lib/types/tools/clean.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The `data_clean` model tool: declarative cleaning rules through
+ * `ctx.dataQuality.cleanDataset`. The source file is never overwritten;
+ * without `outputPath` the run is preview-only.
+ * @module dsh-data-quality/tools/clean
+ */
+import type { DataQualityService } from '../service.js';
+/**
+ * Build the `data_clean` tool definition against a mounted service.
+ * @param service - the mounted ctx.dataQuality implementation.
+ * @returns the tool definition to register.
+ */
+export declare function defineCleanTool(service: DataQualityService): import("@deepseek-ai/dsh-tools").ToolDefinition;
+//# sourceMappingURL=clean.d.ts.map

package/lib/types/tools/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../../src/tools/clean.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAA6B,kBAAkB,EAAE,MAAM,eAAe,CAAA;AA0ElF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,kBAAkB,mDA8D1D"}