dsh-data-quality 0.2.0 → 0.3.1

package/SUMMARY.md

@@ -0,0 +1,147 @@
+# dsh-data-quality — Completion Summary
+
+Standalone DeepSeek Harness plugin repository (`dsh-data-quality`): deterministic TypeScript data profiling / cleaning / verification for the agent harness, built as the full three-layer capability seam (Service Definition / local Provider / three model tool Consumers) with durable report storage and adaptive session events.
+
+## Deliverables
+
+### Capability seam
+
+- **`ctx.dataQuality` Service Definition** (`src/service.ts`) — `DataQualityService extends Service`, registered under `dataQuality`. Exposes the frozen cross-plugin contract:
+  - `verifyCitations(request: CitationCheckRequest): Promise<CitationCheckResult>` — the byte-stable cross-plugin contract (§6.2 of the plugin spec), change only with an ecosystem migration.
+  - `profileDataset`, `cleanDataset`, `verifyDataset` — the internal report pipeline used by the tools.
+- **Local deterministic Provider** (`src/provider-local.ts`) — no I/O in the engines, no clock (injected `now` / `freshness`), no RNG; TypeScript `private` fields only (ECMA `#` fields throw on cordis' proxied service receiver).
+- **Consumers** (`src/tools/*.ts`) — `data_profile`, `data_clean`, `data_verify` `defineTool`s; all computation via the service; `workspaceOf(exec)` mirrors the official fs tools' session-cwd rule.
+
+### Engines (pure, deterministic)
+
+- `src/dataset.ts` — workspace-confined path resolution, size/row guards, hand-rolled CSV/TSV/JSON/JSONL parsers, deterministic systematic sampling, strict scalar parsers (`Cell = JsonValue`).
+- `src/profile.ts` — row/column counts, inferred types, missing rates, unique counts, numeric distribution (min/max/mean/median/p25/p75), IQR outlier counts, mixed-type suspicion notes, duplicate-row counts, text rendering.
+- `src/clean.ts` — six rule kinds, exactly the spec's list: `dedupe` (column group), `fill-missing` (constant/mean/median/forward), `coerce-type` (number/date/boolean with failure counts), `normalize-unit` (万/亿-style factor map), `trim`, `map-values` (enum mapping with `else: keep|missing`).
+- `src/verify.ts` — seven rule kinds, exactly the spec's list: `not-null`, `unique`, `range`, `regex`, `enum`, `cross-column`, `freshness` (date column vs `asOf`, default injected clock) — plus `checkCitations`/`parseLocator`/`walkLocator` and the four verification states (`verified` / `mismatch` / `not-found` / `unverifiable`).
+
+### Integration surfaces
+
+- `src/store.ts` — `data_quality` storage domain (zod record schema, version 1, table `reports`), deterministic report key `YYYYMMDDHHmmssSSS-<kind>-<8-hex-sha256>`.
+- `src/events.ts` — `data-quality/profile|clean|verify` in the `SessionEventMap` declaration merge. Adaptive append gate: known vocabulary → plain append; unknown vocabulary → probe the unbound `append` source for an `ignorable` marker and only then append with `{ ignorable: true }`; otherwise skip (the storage-domain report is always the durable copy). This is required because the rc.6 `Session.append` has no `ignorable` flag and no plugin event-registration surface exists, so an unknown appended type makes the persistence coordinator refuse the session log on restore.
+- `src/config.ts` — Schemastery schema + explicit `resolveConfig` (no hidden `?? default`); numeric bounds fail loud at mount.
+
+### Model tools (per plugin contract)
+
+| Tool | Input | Output |
+|---|---|---|
+| `data_profile` | dataset path, sample? | row/column counts, per-column cards (type, missing, unique, numeric stats, notes), duplicate rows, reportKey |
+| `data_clean` | dataset path, rules[], output path (optional, workspace-confined) | cleaned rows, per-rule audit log (affected rows), reportKey |
+| `data_verify` | dataset path, rules[], evidence cap | verdict `passed`, per-rule pass/fail with evidence rows, reportKey |
+
+## Configuration (cordis.yml `config`)
+
+| Key | Default | Notes |
+|---|---|---|
+| `enabled` | `true` | master switch |
+| `maxRows` | `200000` | row guard, fail loud |
+| `maxFileSizeMB` | `64` | file size guard, fail loud |
+| `defaultTolerance` | `1e-9` | numeric comparison relative tolerance |
+| `evidenceRowLimit` | `20` | evidence rows per failed verify rule |
+| `allowedExtensions` | `.csv .tsv .json .jsonl` | dataset file extensions |
+| `workspaceRoot` | `''` | service-level citation checks resolve here; tools resolve in the session workspace |
+| `storeReports` | `true` | persist reports to the `data_quality` storage domain |
+
+All knobs are documented in the five-language README configuration tables and mirrored in `cordis.patch.yml` with inline comments.
+
+## Acceptance
+
+### Gate chain — re-run green on the final tree (2026-08-20)
+
+```
+pnpm run typecheck                 PASS   tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit
+pnpm run typecheck:ci              PASS   tsc -p tsconfig.ci.json --noEmit (published 0.1.0-rc.6 peers)
+pnpm test                          PASS   112 tests / 8 files (clean 22, verify 28, dataset 25, plugin 10, citations 9, profile 8, events 6, config 4)
+pnpm run build                     PASS   lib/index.js 82.82 kB; fix-dts rewrote 11 files / 37 specifiers
+pnpm run verify:self-contained     PASS   all dependency specs resolve from the registry
+pnpm run verify:artifacts          PASS   syntax + ESM import + plugin face + no .ts leftovers + bundle patch present
+pnpm run verify:readme-sync        PASS   all 5 READMEs share section structure and config keys
+pnpm run pack:check                PASS   dsh-data-quality-0.1.0.tgz (lib/index.js + lib/types + cordis.patch.yml + READMEs + src)
+```
+
+`pnpm run test:coverage` thresholds (statements 90 / branches 80 / functions 90 / lines 90) pass.
+
+### Real composition smokes
+
+1. **Loader runner** (`node scripts/loader-runner.mjs .tmp/loader-smoke/cordis.yml fixtures`) — boots a real `Context` + vendored Loader with the Include builtin against the real storage seam (dsh-storage + dsh-storage-json + dsh-storage-domain), dsh-system-prompt, dsh-tools, and the BUILT `lib/index.js` bundle with `workspaceRoot` = fixtures dir. Keyless three-tool chain over the dirty fixture:
+
+   ```
+   DSH_LOADER_RESULT {"tools":["data_profile","data_clean","data_verify"],"profileRows":10,"profileColumns":6,"cleanOutputRows":8,"verifyPassed":false,"citationStatus":"verified"}
+   ```
+
+   profile 10 rows / 6 columns; clean (trim → dedupe → normalize-unit → coerce-type) drops 2 duplicate rows (8 out); verify `passed:false` is the correct verdict (the fixture's missing `holding_value` on FUND005 fails `range` — evidence flows); `verifyCitations` resolves a cited value from the CSV → `verified`.
+
+2. **dsh-test-drive isolated install matrix (preferred path, run 2026-08-20)** — programmatic drive of the dsh-test-drive pipeline (`D:\deepseek-harness\Project\Plugins\dsh-test-drive\`, real `LocalSubprocessRuntime` → real `dsh` CLI + pnpm) against this checkout:
+
+   ```
+   verdict: pass
+   install   pass   dsh plugin add <checkout> ok (exit 0, allowBuildsNeeded: false)
+   config    pass   patchEffective: true, layers: ["dsh-data-quality"], full bundle patch visible in --dump-config
+   smoke     boot-ok  booted without loader failures; MISSING_CREDENTIAL (no API key) proves the tree mounted
+   capability skipped  disabled by config and no per-drive spec (requires DEEPSEEK_API_KEY)
+   uninstall pass   dsh plugin remove ok (exit 0)
+   cleanup   pass   owned temp root quarantined and removed
+   isolation hostHomeTouched: false, tempDshHome/tempWorkspace/tempStore: true
+   ```
+
+3. **Real dsh CLI temp-profile install** (earlier session, recorded here): `dsh plugin --profile dq add @deepseek-ai/dsh-base@0.1.0-rc.6 @deepseek-ai/dsh-headless@0.1.0-rc.6 ./dsh-data-quality-0.1.0.tgz` → install succeeds; `--dump-config` shows the bundle patch merging the storage rows + `dsh-data-quality` row; keyless headless exits with `MISSING_CREDENTIAL` (a pending service would hang to timeout instead); `dsh plugin remove` reverts cleanly.
+
+## Commit history (13 commits, `main`)
+
+```
+d5e1c7b docs: record v0.1.0 release status
+d9201d2 chore(release): 0.1.0
+f2f95b7 fix: release script stamps a first release whose version is already set
+3261e77 chore: keep loader-runner output byproduct untracked
+433f9d4 docs: completion summary
+6f9c4e5 docs: five-language READMEs and repo policy files
+90ae5ed ci: ci/compat/release workflow trio
+daca96f build: self-contained prepare/verify/release scripts and loader-runner smoke
+8ad596d test: real-service vitest suite (112 specs) plus dirty-data fixtures
+2048c6e feat: data_profile/data_clean/data_verify tools and plugin entry with fail-loud config
+be634cd feat: ctx.dataQuality seam (frozen verifyCitations contract, local provider, storage domain, adaptive session events)
+0be188f feat: deterministic dataset layer and pure engines (profile/clean/verify)
+d6af7b6 chore: project scaffold (package manifest, tsconfig trio, build/test config)
+```
+
+## Deviations from the plugin spec (vetted, intentional)
+
+1. **Session events are adaptive, not unconditional.** The spec requires a `SessionEventMap` merge for model-visible content; that merge exists (`src/events.ts`). On rc.6 hosts the append surface has no `ignorable` flag and no plugin event-registration surface, so appending an unknown `data-quality/*` type would make the persistence coordinator refuse the session log on restore. The gate appends only when the host knows the vocabulary or supports the ignorable marker, and fails safe to skipping; the storage-domain report remains the durable record. (The original SUMMARY predated this refinement; the current code is authoritative.)
+2. **Rule names match the spec verbatim.** The six clean rules (`dedupe`, `fill-missing`, `coerce-type`, `normalize-unit`, `trim`, `map-values`) and seven verify rules (`not-null`, `unique`, `range`, `regex`, `enum`, `cross-column`, `freshness`) use the spec's kebab-case names. An earlier SUMMARY draft described an intermediate snake_case rule set; the shipped code never shipped those names.
+3. **Render shape is text, not a table.** The spec suggests a "generic + table render"; the tools use `generic` tools with a human-readable text summary in `output.render` (tables are ill-suited to the variable-width evidence rows). Semantics unchanged: canonical JSON in `output.schema`, human text in `output.render`.
+4. **`workspaceRoot` added for the service plane.** Tool calls always resolve inside the session workspace (spec). `verifyCitations` has no session, so a `workspaceRoot` config (default: process launch directory) anchors service-level checks; it is fixed at provider construction.
+5. **Extra config keys `enabled` / `storeReports`.** Both default on and are settable from cordis.yml — additions to, not replacements of, the spec's five keys.
+6. **`MAX_CELL_TEXT` (120 chars) is a display-safety invariant**, not a tunable; documented in AGENTS.md.
+7. **Push/publish did not happen in the development session.** The spec forbids push and publish here; `d9201d2`/`d5e1c7b` record the release session's stamp/status work, and the remote (`PerryLink/dsh-data-quality`) plus npm (`dsh-data-quality@0.1.0`, published 2026-08-19T13:54Z) were populated by that release session.
+
+## Repo & release state
+
+- 13 conventional commits on `main`, tag `v0.1.0`, working tree clean. Remote: `github.com/PerryLink/dsh-data-quality` (pushed by the release session).
+- npm registry: `dsh-data-quality@0.1.0` published 2026-08-19T13:54Z (`latest` = 0.1.0); the earlier "npm publish skipped (no NPM_TOKEN)" note is superseded — the release session closed that gap.
+- `dsh-data-quality-0.1.0.tgz` is gitignored and reproducible via `pnpm pack`.
+
+## Known limitations & follow-up suggestions
+
+- **Session events are best-effort on pre-rc.7 hosts**: on a host whose append lacks the `ignorable` marker, `data-quality/*` events are skipped rather than risking log-restore refusal; the storage-domain report remains the durable record. Revisit when the harness exposes a real plugin event-registration surface.
+- **No fuzzy/LLM-based cleaning**: rule semantics are strictly deterministic by design; a future `data_clean` rule kind could delegate fuzzy matching to an LLM tool as an opt-in.
+- **`workspaceRoot` is process-start-time**: the provider caches the resolved root at construction; a runtime configuration change requires remounting the plugin.
+- **Numeric parsing is strict**: locale-formatted numbers (`"1,234.56"`) and currency strings are text until `coerce-type`/`normalize-unit` run.
+- **Cross-column date comparison uses epoch fallback**: strings that do not parse as numbers fall back to `Date.parse`; unparseable pairs fall back to strict string equality (only for `==` / `!=`).
+- **Evidence rows are truncated** by `MAX_CELL_TEXT` (120 chars).
+
+## Project overview suggestion
+
+Add one row to the Project/Plugins overview roster: `dsh-data-quality` — `ctx.dataQuality` three-layer seam (deterministic profiling/cleaning/verification) with `data_profile` / `data_clean` / `data_verify` tools; v0.1.0 on npm since 2026-08-19.
+
+## Release-session handoff (PHASE2 §0.3 chain) — execution status
+
+The chain was executed (2026-08-20) as far as the session's capabilities allow:
+
+1. **Community feedback check** — DONE: GitHub API audit shows `PerryLink/dsh-data-quality` has 0 open/0 closed issues, 0 stars; no feedback to fold in before the next release.
+2. **Standard item B (community engineering)** — DONE: all 8 GitHub topics are set (`dsh`, `dsh-plugin`, `deepseek-harness`, `cordis`, `data-quality`, `data-cleaning`, `data-profiling`, `data-verification` — mirror of `package.json` keywords); five-language READMEs pass `verify:readme-sync`; `THIRD_PARTY_NOTICES.md` current. The Project/Plugins overview (`D:\deepseek-harness\Project\Plugins\README.md`) now lists `dsh-data-quality` under "已发布 GitHub + npm" (30 projects / 13 published).
+3. **Standard item A (ecosystem delivery)** — npm closed (`dsh-data-quality@0.1.0`, 2026-08-19T13:54Z). Ecosystem catalog submission is BLOCKED: community catalogs exist (`awesome-dsh-plugins/awesome-dsh-plugins` et al., none listing this plugin yet) but submitting requires GitHub write credentials — no `gh` CLI and no `GH_TOKEN`/`GITHUB_TOKEN` in this session; a release session with credentials should open the catalog PR.
+4. **Standard item C (publish upload)** — CLOSED for 0.1.0: tag `v0.1.0`, GitHub Release (2026-08-19T13:45Z), npm publish (2026-08-19T13:54Z). `main` synced to origin (`d669a19`). For the next version: `node scripts/release.mjs <x.y.z>` (stamps CHANGELOG, re-runs the gate, commits + tags, never pushes), then push — `release.yml` publishes to npm with provenance and creates the GitHub Release from the stamped CHANGELOG section (needs the `NPM_TOKEN` secret configured on the repo).

package/lib/index.js

@@ -1165,6 +1165,22 @@ function computeAccuracy(stats, table, declaredSchema) {
 	};
 }
 //#endregion
+//#region src/version.ts
+/**
+* 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. */
+const VERSION = "0.3.1";
+/**
+* Version of the persisted report schema. Bump it whenever a report's
+* canonical shape changes in a way old consumers cannot read (the durable
+* `data_quality` records keep their own `schemaVersion` so a future reader
+* can detect and reject an incompatible record instead of misreading it).
+*/
+const REPORT_SCHEMA_VERSION = 1;
+//#endregion
 //#region src/profile.ts
 /**
 * Deterministic dataset profiling: per-column type inference, missingness,
@@ -1345,6 +1361,7 @@ function profileTable(table, options) {
 		signal: options.signal
 	});
 	return {
+		schemaVersion: 1,
 		dataset: options.dataset,
 		rowCount: table.rows.length,
 		sampled: profiled.length !== table.rows.length,
@@ -1983,14 +2000,14 @@ function checkCitations(root, citations, defaultTolerance) {
 *
 * - Hosts whose known-type set already covers the vocabulary (a future harness
 *   that adopts these events) append plainly.
-* - Hosts with an `ignorable` append option (the master-build
-*   `Session.append(type, data, { ignorable: true })` contract) append with the
-*   marker, so builds that do not know the type skip the event on restore.
+* - Hosts with an `ignorable` append option (pre-0.1.2 rc builds) append with
+*   the marker, so builds that do not know the type skip the event on restore.
 * - 0.1.0-rc.6 and 0.1.0-rc.8 hosts have neither a registration surface nor an
 *   `ignorable` append option (rc.8's `Session.append` accepts surface metadata
-*   only, never the marker); appending an unknown type there would make the
-*   persistence coordinator refuse the session log on restore, so the append is
-*   skipped and the storage-domain report remains the durable copy.
+*   only, never the marker), and 0.1.2-alpha.1 removed the `ignorable` envelope
+*   entirely (42dc2a46c2) and fails closed on unknown types at read; on all of
+*   them the append is skipped and the storage-domain report remains the
+*   durable copy.
 * @module dsh-data-quality/events
 */
 /** The event type vocabulary this plugin appends. */
@@ -2003,10 +2020,10 @@ const DATA_QUALITY_EVENT_TYPES = [
 * Append one `data-quality/*` event when the host can carry it safely; skip
 * silently otherwise (the storage-domain report is always the durable copy).
 * The `ignorable` probe reads the UNBOUND method's source (a `.bind()` result
-* reports `[native code]`): the rc.6 and rc.8 builds contain no `ignorable`
-* handling while the master build references the flag by name; property names
-* survive minification, so the probe fails safe (skips) rather than corrupting
-* a log.
+* reports `[native code]`): the rc.6/rc.8 builds and 0.1.2-alpha.1 contain no
+* `ignorable` handling while pre-0.1.2 master builds referenced the flag by
+* name; property names survive minification, so the probe fails safe (skips)
+* rather than corrupting a log.
 * @param session - the calling session.
 * @param type - the event type.
 * @param data - the payload.
@@ -2540,6 +2557,10 @@ const COLUMN_PROFILE_SCHEMA = {
 const PROFILE_REPORT_SCHEMA = {
 	type: "object",
 	properties: {
+		schemaVersion: {
+			type: "number",
+			required: true
+		},
 		dataset: {
 			type: "string",
 			required: true
@@ -3537,6 +3558,168 @@ function defineVerifyTool(service) {
 	});
 }
 //#endregion
+//#region src/report-html.ts
+/** Escape text for safe embedding in an HTML document. */
+function escapeHtml(text) {
+	return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+}
+/** Render a 0..1 rate as a percentage string, or `—` when undetermined. */
+function pct(score) {
+	return score === null ? "—" : `${(score * 100).toFixed(1)}%`;
+}
+/** The shared document shell: inline CSS + inline JS, no external requests. */
+function shell(title, body, script) {
+	return [
+		"<!doctype html>",
+		"<html lang=\"en\">",
+		"<head>",
+		"<meta charset=\"utf-8\">",
+		`<title>${escapeHtml(title)}</title>`,
+		"<style>",
+		"  :root { --ink: #1a1f2e; --muted: #6b7280; --line: #e5e7eb; --accent: #0f766e; --fail: #b91c1c; --warn: #b45309; --pass: #15803d; }",
+		"  * { box-sizing: border-box; }",
+		"  body { margin: 0; padding: 24px; font: 14px/1.5 ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", sans-serif; color: var(--ink); background: #f8fafc; }",
+		"  header { margin-bottom: 20px; }",
+		"  h1 { font-size: 20px; margin: 0 0 4px; }",
+		"  .meta { color: var(--muted); font-size: 12px; }",
+		"  section { background: #fff; border: 1px solid var(--line); border-radius: 8px; padding: 16px 20px; margin-bottom: 16px; }",
+		"  h2 { font-size: 15px; margin: 0 0 12px; }",
+		"  table { border-collapse: collapse; width: 100%; font-size: 13px; }",
+		"  th, td { text-align: left; padding: 6px 10px; border-top: 1px solid var(--line); vertical-align: top; }",
+		"  th { color: var(--muted); font-weight: 600; }",
+		"  .score-cell { font-variant-numeric: tabular-nums; }",
+		"  .dim-fail { color: var(--fail); font-weight: 600; }",
+		"  .dim-warn { color: var(--warn); }",
+		"  .dim-pass { color: var(--pass); }",
+		"  .dim-undetermined { color: var(--muted); }",
+		"  button { cursor: pointer; font: inherit; }",
+		"</style>",
+		"</head>",
+		"<body>",
+		body,
+		"<script>",
+		script,
+		"<\/script>",
+		"</body>",
+		"</html>",
+		""
+	].join("\n");
+}
+/** The DAMA six-dimension scorecard section. */
+function scorecardSection(report) {
+	const rows = report.scorecard.dimensions.map((dimension) => {
+		const cls = dimension.score === null ? "dim-undetermined" : dimension.score >= .9 ? "dim-pass" : dimension.score >= .7 ? "dim-warn" : "dim-fail";
+		return `<tr><td>${escapeHtml(dimension.name)}</td><td class="score-cell ${cls}">${pct(dimension.score)}</td><td>${escapeHtml(dimension.note)}</td></tr>`;
+	}).join("\n");
+	const overall = report.scorecard.overall;
+	const weighted = report.scorecard.weightedOverall;
+	return [
+		"<section>",
+		"<h2>DAMA six-dimension quality scorecard</h2>",
+		"<table>",
+		"<thead><tr><th>Dimension</th><th>Score</th><th>Note</th></tr></thead>",
+		"<tbody>",
+		rows,
+		"</tbody>",
+		"</table>",
+		`<p class="meta" id="summary-text">overall ${pct(overall)} · weighted ${pct(weighted)}</p>`,
+		"</section>"
+	].join("\n");
+}
+/** The per-column profile summary table. */
+function columnsSection(report) {
+	return [
+		"<section>",
+		"<h2>Column profile</h2>",
+		"<table>",
+		"<thead><tr><th>Column</th><th>Type</th><th>Missing</th><th>Missing rate</th><th>Unique</th><th>Numeric distribution</th><th>Top values</th><th>Notes</th></tr></thead>",
+		"<tbody>",
+		report.columns.map((column) => {
+			const numeric = column.numeric;
+			const numericCell = numeric === void 0 ? "—" : `min ${numeric.min} · p25 ${numeric.p25} · median ${numeric.median} · p75 ${numeric.p75} · max ${numeric.max} · mean ${numeric.mean}${numeric.outliers > 0 ? ` · ${numeric.outliers} IQR outliers` : ""}`;
+			const top = column.topValues === void 0 ? "—" : column.topValues.map((entry) => `${escapeHtml(entry.value)} ×${entry.count}`).join(", ");
+			const notes = column.notes.length === 0 ? "" : `<p class="meta">${column.notes.map(escapeHtml).join("; ")}</p>`;
+			return [
+				"<tr>",
+				`<td>${escapeHtml(column.name)}</td>`,
+				`<td>${escapeHtml(column.inferredType)}</td>`,
+				`<td class="score-cell">${column.missing}</td>`,
+				`<td class="score-cell">${(column.missingRate * 100).toFixed(1)}%</td>`,
+				`<td class="score-cell">${column.unique}</td>`,
+				`<td>${numericCell}</td>`,
+				`<td>${top}</td>`,
+				`<td>${notes}</td>`,
+				"</tr>"
+			].join("");
+		}).join("\n"),
+		"</tbody>",
+		"</table>",
+		"</section>"
+	].join("\n");
+}
+/**
+* Render a profile report as a self-contained offline HTML document.
+* @param report - the profile report (already persisted/returned by data_profile).
+* @returns the complete single-file HTML.
+*/
+function renderProfileHtml(report) {
+	const body = [
+		"<header>",
+		`<h1>Data profile: ${escapeHtml(report.dataset)}</h1>`,
+		`<p class="meta">${report.rowCount} rows × ${report.columnCount} columns · generated ${new Date(report.generatedAt).toISOString()} · schema v1 · report ${report.reportKey ?? "(unpersisted)"}</p>`,
+		"<button id=\"copy-summary\" type=\"button\">Copy summary</button>",
+		"</header>",
+		scorecardSection(report),
+		columnsSection(report)
+	].join("\n");
+	const script = [
+		"const button = document.getElementById('copy-summary');",
+		"if (button) {",
+		"  button.addEventListener(\"click\", () => {",
+		"    const text = document.getElementById(\"summary-text\");",
+		"    if (text && navigator.clipboard) navigator.clipboard.writeText(text.textContent || \"\");",
+		"  });",
+		"}"
+	].join("\n");
+	return shell(`Data profile: ${report.dataset}`, body, script);
+}
+/** The per-rule cleaning summary table (for clean/clean-diff reports). */
+function cleaningSection(report) {
+	const rows = report.logs.map((log) => {
+		return `<tr><td>${escapeHtml(log.rule)}</td><td class="score-cell">${log.affectedRows}</td><td>${escapeHtml(log.detail)}</td></tr>`;
+	}).join("\n");
+	const removed = report.inputRows - report.outputRows;
+	return [
+		"<section>",
+		"<h2>Cleaning summary</h2>",
+		`<p class="meta" id="summary-text">input ${report.inputRows} rows · output ${report.outputRows} rows · removed ${removed} rows</p>`,
+		"<table>",
+		"<thead><tr><th>Rule</th><th>Affected rows</th><th>Detail</th></tr></thead>",
+		"<tbody>",
+		rows,
+		"</tbody>",
+		"</table>",
+		"</section>"
+	].join("\n");
+}
+/**
+* Render a clean report as a self-contained offline HTML document (the
+* per-rule cleaning summary table).
+* @param report - the clean report (logs + input/output row counts).
+* @param dataset - the dataset label for the document title.
+* @returns the complete single-file HTML.
+*/
+function renderCleanHtml(report, dataset) {
+	const body = [
+		"<header>",
+		`<h1>Cleaning report: ${escapeHtml(dataset)}</h1>`,
+		`<p class="meta">schema v1</p>`,
+		"</header>",
+		cleaningSection(report)
+	].join("\n");
+	return shell(`Cleaning report: ${dataset}`, body, "// no interactive behavior needed; everything renders without external requests\n");
+}
+//#endregion
 //#region src/tools/report.ts
 /**
 * The `data_report` model tool: read persisted profile/clean-diff reports
@@ -3552,6 +3735,12 @@ const REPORT_KINDS = [
 	"verify",
 	"citations"
 ];
+/** Render one stored report as a self-contained HTML document (profile/clean only). */
+function renderRecordHtml(record) {
+	if (record.kind === "profile") return renderProfileHtml(record.report);
+	if (record.kind === "clean" || record.kind === "clean-diff") return renderCleanHtml(record.report, record.dataset);
+	throw new Error(`data_report html format does not support kind "${record.kind}" (profile/clean only)`);
+}
 /** Project a stored report into the canonical value (the stored report is already lossless JSON). */
 function toView(record) {
 	return {
@@ -3592,6 +3781,11 @@ function defineReportTool(service) {
 				type: "string",
 				enum: [...REPORT_KINDS],
 				description: "Report kind to list (profile/clean/clean-diff/verify/citations)."
+			},
+			format: {
+				type: "string",
+				enum: ["json", "html"],
+				description: "Output format. json (default) returns the report envelope(s); html renders one report as a self-contained offline HTML document (requires key; profile/clean only)."
 			}
 		},
 		output: {
@@ -3633,25 +3827,39 @@ function defineReportTool(service) {
 							additionalProperties: false
 						},
 						required: true
+					},
+					html: {
+						type: "string",
+						description: "Self-contained offline HTML (present only when format: html)."
 					}
 				},
 				additionalProperties: false
 			},
-			render: (_args, value) => [{
-				type: "text",
-				text: renderReportText(value)
-			}]
+			render: (_args, value) => {
+				const view = value;
+				if (view.html !== void 0) return [{
+					type: "text",
+					text: view.html
+				}];
+				return [{
+					type: "text",
+					text: renderReportText(view)
+				}];
+			}
 		},
 		async execute(args, _exec) {
 			const hasKey = args.key !== void 0;
 			if (hasKey === (args.kind !== void 0)) throw new Error("data_report needs exactly one of key/kind");
+			const format = args.format ?? "json";
 			if (hasKey) {
 				const record = await service.getReport(args.key);
 				return {
 					key: args.key,
-					records: [toView(record)]
+					records: [toView(record)],
+					...format === "html" ? { html: renderRecordHtml(record) } : {}
 				};
 			}
+			if (format === "html") throw new Error("data_report html format requires key (exactly one report)");
 			const records = await service.listReports(args.kind);
 			return {
 				kind: args.kind,
@@ -3661,15 +3869,6 @@ function defineReportTool(service) {
 	});
 }
 //#endregion
-//#region src/version.ts
-/**
-* 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. */
-const VERSION = "0.2.0";
-//#endregion
 //#region src/index.ts
 const name = "data-quality";
 /** The four model tools and the durable report domain. */
@@ -3723,4 +3922,4 @@ async function apply(ctx, config = {}) {
 	}
 }
 //#endregion
-export { Config, DATA_QUALITY_EVENT_TYPES, DataQualityService, DatasetError, INDUSTRY_PRESETS, INDUSTRY_PRESET_IDS, LocalDataQualityService, MAX_CELL_TEXT, VERSION, VerifyExpectationError, appendDataQualityEvent, apply, applyCleanRules, checkCitations, computeCleanContract, computeCleanProfileDiff, computeScorecard, countDuplicateRows, dataQualityDomainSpec, dateFormatOf, detectDuplicateRows, detectEncoding, inject, isMissing, isValidReportKey, loadDocument, loadTable, name, numericProfile, parseBoolean, parseDate, parseDateCell, parseDelimited, parseJsonTable, parseLocator, parseNumeric, profileTable, readDatasetFile, renderProfileText, renderVerifyText, reportKeyOf, reportRecordSchema, resolveConfig, resolveIndustryPreset, resolveWorkspacePath, sampleRows, serializeDelimited, truncateCell, truncateRow, verifyExpectations, verifyTable };
+export { Config, DATA_QUALITY_EVENT_TYPES, DataQualityService, DatasetError, INDUSTRY_PRESETS, INDUSTRY_PRESET_IDS, LocalDataQualityService, MAX_CELL_TEXT, REPORT_SCHEMA_VERSION, VERSION, VerifyExpectationError, appendDataQualityEvent, apply, applyCleanRules, checkCitations, computeCleanContract, computeCleanProfileDiff, computeScorecard, countDuplicateRows, dataQualityDomainSpec, dateFormatOf, detectDuplicateRows, detectEncoding, inject, isMissing, isValidReportKey, loadDocument, loadTable, name, numericProfile, parseBoolean, parseDate, parseDateCell, parseDelimited, parseJsonTable, parseLocator, parseNumeric, profileTable, readDatasetFile, renderCleanHtml, renderProfileHtml, renderProfileText, renderVerifyText, reportKeyOf, reportRecordSchema, resolveConfig, resolveIndustryPreset, resolveWorkspacePath, sampleRows, serializeDelimited, truncateCell, truncateRow, verifyExpectations, verifyTable };

package/lib/types/events.d.ts

@@ -5,14 +5,14 @@
  *
  * - Hosts whose known-type set already covers the vocabulary (a future harness
  *   that adopts these events) append plainly.
- * - Hosts with an `ignorable` append option (the master-build
- *   `Session.append(type, data, { ignorable: true })` contract) append with the
- *   marker, so builds that do not know the type skip the event on restore.
+ * - Hosts with an `ignorable` append option (pre-0.1.2 rc builds) append with
+ *   the marker, so builds that do not know the type skip the event on restore.
  * - 0.1.0-rc.6 and 0.1.0-rc.8 hosts have neither a registration surface nor an
  *   `ignorable` append option (rc.8's `Session.append` accepts surface metadata
- *   only, never the marker); appending an unknown type there would make the
- *   persistence coordinator refuse the session log on restore, so the append is
- *   skipped and the storage-domain report remains the durable copy.
+ *   only, never the marker), and 0.1.2-alpha.1 removed the `ignorable` envelope
+ *   entirely (42dc2a46c2) and fails closed on unknown types at read; on all of
+ *   them the append is skipped and the storage-domain report remains the
+ *   durable copy.
  * @module dsh-data-quality/events
  */
 import { type Session } from '@deepseek-ai/dsh-session';
@@ -65,10 +65,10 @@ export type DataQualityEventType = (typeof DATA_QUALITY_EVENT_TYPES)[number];
  * Append one `data-quality/*` event when the host can carry it safely; skip
  * silently otherwise (the storage-domain report is always the durable copy).
  * The `ignorable` probe reads the UNBOUND method's source (a `.bind()` result
- * reports `[native code]`): the rc.6 and rc.8 builds contain no `ignorable`
- * handling while the master build references the flag by name; property names
- * survive minification, so the probe fails safe (skips) rather than corrupting
- * a log.
+ * reports `[native code]`): the rc.6/rc.8 builds and 0.1.2-alpha.1 contain no
+ * `ignorable` handling while pre-0.1.2 master builds referenced the flag by
+ * name; property names survive minification, so the probe fails safe (skips)
+ * rather than corrupting a log.
  * @param session - the calling session.
  * @param type - the event type.
  * @param data - the payload.

package/lib/types/events.js

@@ -5,14 +5,14 @@
  *
  * - Hosts whose known-type set already covers the vocabulary (a future harness
  *   that adopts these events) append plainly.
- * - Hosts with an `ignorable` append option (the master-build
- *   `Session.append(type, data, { ignorable: true })` contract) append with the
- *   marker, so builds that do not know the type skip the event on restore.
+ * - Hosts with an `ignorable` append option (pre-0.1.2 rc builds) append with
+ *   the marker, so builds that do not know the type skip the event on restore.
  * - 0.1.0-rc.6 and 0.1.0-rc.8 hosts have neither a registration surface nor an
  *   `ignorable` append option (rc.8's `Session.append` accepts surface metadata
- *   only, never the marker); appending an unknown type there would make the
- *   persistence coordinator refuse the session log on restore, so the append is
- *   skipped and the storage-domain report remains the durable copy.
+ *   only, never the marker), and 0.1.2-alpha.1 removed the `ignorable` envelope
+ *   entirely (42dc2a46c2) and fails closed on unknown types at read; on all of
+ *   them the append is skipped and the storage-domain report remains the
+ *   durable copy.
  * @module dsh-data-quality/events
  */
 import { KNOWN_SESSION_EVENT_TYPES } from '@deepseek-ai/dsh-session';
@@ -22,10 +22,10 @@ export const DATA_QUALITY_EVENT_TYPES = ['data-quality/profile', 'data-quality/c
  * Append one `data-quality/*` event when the host can carry it safely; skip
  * silently otherwise (the storage-domain report is always the durable copy).
  * The `ignorable` probe reads the UNBOUND method's source (a `.bind()` result
- * reports `[native code]`): the rc.6 and rc.8 builds contain no `ignorable`
- * handling while the master build references the flag by name; property names
- * survive minification, so the probe fails safe (skips) rather than corrupting
- * a log.
+ * reports `[native code]`): the rc.6/rc.8 builds and 0.1.2-alpha.1 contain no
+ * `ignorable` handling while pre-0.1.2 master builds referenced the flag by
+ * name; property names survive minification, so the probe fails safe (skips)
+ * rather than corrupting a log.
  * @param session - the calling session.
  * @param type - the event type.
  * @param data - the payload.

package/lib/types/index.d.ts

@@ -37,6 +37,8 @@ export { DatasetError, loadTable, loadDocument, readDatasetFile, detectEncoding,
 export { dataQualityDomainSpec, reportKeyOf, reportRecordSchema, isValidReportKey, type ReportRecord, type ReportStore, type StoredReport } from './store.js';
 export { DATA_QUALITY_EVENT_TYPES, appendDataQualityEvent, type DataQualityEventData, type DataQualityEventType } from './events.js';
 export { MAX_CELL_TEXT, truncateCell, truncateRow } from './present.js';
+export { renderProfileHtml, renderCleanHtml, type CleanReportHtml } from './report-html.js';
+export { REPORT_SCHEMA_VERSION } from './version.js';
 /**
  * Mount the seam: resolve config (fail loud), open the report domain, publish
  * `ctx.dataQuality`, and register the three tools. With `enabled: false` the

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

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

package/lib/types/index.js

@@ -39,6 +39,8 @@ export { DatasetError, loadTable, loadDocument, readDatasetFile, detectEncoding,
 export { dataQualityDomainSpec, reportKeyOf, reportRecordSchema, isValidReportKey } from "./store.js";
 export { DATA_QUALITY_EVENT_TYPES, appendDataQualityEvent } from "./events.js";
 export { MAX_CELL_TEXT, truncateCell, truncateRow } from "./present.js";
+export { renderProfileHtml, renderCleanHtml } from "./report-html.js";
+export { REPORT_SCHEMA_VERSION } from "./version.js";
 /**
  * Mount the seam: resolve config (fail loud), open the report domain, publish
  * `ctx.dataQuality`, and register the three tools. With `enabled: false` the

package/lib/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EAAU,aAAa,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAoB,MAAM,YAAY,CAAA;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,IAAI,GAAG,cAAc,CAAA;AAClC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;AAEhD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEnD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EACL,kBAAkB,GAOnB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,uBAAuB,EAAqB,MAAM,qBAAqB,CAAA;AAEhF,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAoD,MAAM,eAAe,CAAA;AAG/H,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AACtG,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AACvH,OAAO,EAAE,gBAAgB,EAAmF,MAAM,gBAAgB,CAAA;AAClI,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,qBAAqB,EAAuB,MAAM,cAAc,CAAA;AAChH,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAChE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EACL,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,SAAS,EACT,YAAY,EACZ,SAAS,EACT,aAAa,EACb,YAAY,EACZ,YAAY,GAQb,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAA0D,MAAM,YAAY,CAAA;AAC7J,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAwD,MAAM,aAAa,CAAA;AACpI,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AACvE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAwB,MAAM,kBAAkB,CAAA;AAC3F,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAEpD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,GAAY,EAAE,SAAiB,EAAE;IAC3D,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IACtC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;IACzC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAA;QAC3E,OAAM;IACR,CAAC;IAED,IAAI,KAA8B,CAAA;IAClC,IAAI,MAAwD,CAAA;IAC5D,IAAI,QAAQ,CAAC,YAAY,EAAE,CAAC;QAC1B,MAAM,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;QAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACvC,KAAK,GAAG;YACN,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;gBACpB,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;gBAC/B,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;gBAC9B,OAAO,GAAG,CAAA;YACZ,CAAC;YACD,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAC9B,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CACb,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;iBACnB,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC;iBAC5C,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;iBAClE,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;SAClD,CAAA;IACH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,uBAAuB,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;IACpF,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAA;IAC9C,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAA;IAC5C,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAA;IAC7C,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAA;IAC7C,MAAM,CAAC,IAAI,CAAC,oBAAoB,OAAO,6EAA6E,CAAC,CAAA;IAErH,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,CAAA;QACrB,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE;YAC1B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;QACtB,CAAC,CAAC,CAAA;IACJ,CAAC;AACH,CAAC"}

package/lib/types/profile.d.ts

@@ -55,6 +55,8 @@ export interface DuplicateDetection {
 }
 /** The full profile report (also the persisted and tool-returned value). */
 export interface ProfileReport {
+    /** The persisted-report schema version (see {@link REPORT_SCHEMA_VERSION}). */
+    readonly schemaVersion: number;
     readonly dataset: string;
     readonly rowCount: number;
     /** Whether column cards describe a systematic sample rather than every row. */