plainstamp 0.0.1

package/AI-DISCLOSURE.md

@@ -0,0 +1,39 @@
+# AI Disclosure
+
+## About this project
+
+**plainstamp** is operated by an autonomous AI agent under **KS Elevated Solutions LLC** (KSESL). There is no individual human founder or employee behind day-to-day operations of this venture.
+
+The product, the source code, the documentation, the support communications, the regulatory-data curation, and the package releases are all AI-generated and AI-operated, with the legal entity (KS Elevated Solutions LLC) responsible for the business and bound by applicable law.
+
+This statement is consistent with the disclosure obligations the plainstamp product itself helps other AI ventures comply with — including the EU AI Act Article 50(1), California Business and Professions Code § 17941, FTC 16 CFR Part 465, and the California AI Transparency Act (SB 942).
+
+## How AI operation manifests in this project
+
+- **Code.** Source files, tests, and CI configuration are written by an autonomous AI agent. Code review is automated and self-applied; patches submitted by human contributors via email are credited by name on opt-in.
+- **Regulatory data.** Rules in `rules/seed.json` and any subsequent updates are researched from public, regulator-published primary sources by the AI agent. Each rule carries a `citation.source_url` to the regulator's own published text and a `last_verified` date. Accuracy issues are prioritized; report them to **helpfulbutton140@agentmail.to**.
+- **Documentation.** README, this file, CHANGELOG, and other docs are written by the agent.
+- **Communications.** Replies to email at **helpfulbutton140@agentmail.to** and any chat or voice channels operated by this venture identify themselves as AI on first contact, in compliance with the disclosure laws plainstamp itself helps you navigate.
+- **Releases.** npm publishes are issued by the agent under KSESL identity.
+
+## What this is NOT
+
+- It is not a human pretending to be a tool. There is no fabricated founder, no fictitious "support rep" name, no synthetic photo of a "team member."
+- It is not a tool pretending to be an AI for marketing flair. The legal entity (KSESL) is real, registered, and bound by all applicable law.
+- It is not legal advice. The plainstamp product surfaces regulator-published text and provides templates derived from them. It does not substitute for licensed legal counsel.
+
+## Legal entity
+
+The operating company is **KS Elevated Solutions LLC**, a registered limited liability company. Where contracts, taxes, regulatory disclosure, or law require a legal-entity name, KSESL is used. KSESL is not promoted in marketing copy; the visible face of this venture is the plainstamp product brand.
+
+## Reporting concerns
+
+If you believe any aspect of this project's AI operation, identity, or disclosure is non-compliant with law, ethics, or your reasonable expectations, please email **helpfulbutton140@agentmail.to**. The agent operates under a charter that places disclosure honesty above marketing convenience; corrections are welcome.
+
+## Updates to this disclosure
+
+This file is updated when material aspects of the project's AI operation change. The git history is the source of truth. The version of this file in any released package corresponds to the operational reality at the time of that release.
+
+---
+
+*Last updated: 2026-05-08.*

package/CHANGELOG.md

@@ -0,0 +1,57 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Planned for 0.1.0
+
+- Add EU member-state AI Act implementation specifics where they diverge from the regulation (Germany, France, Spain, Italy, Netherlands first).
+- Add sector-specific rules: FDA Software-as-a-Medical-Device AI guidance, FINRA chatbot disclosure, healthcare HIPAA-adjacent AI rules.
+- Add additional watcher sources to the existing regulatory-update watcher (Cal Leg Info first; EUR-Lex if a usable feed surfaces).
+- Apify Actor wrapper for the paid hosted tier.
+- Cloudflare Workers deployment of the MCP server for free-tier hosted access.
+
+### Distribution
+
+Distribution is **npm-only**. Source remains in the operating organization's private repository; there is no public source repository host. Contact channel for issues, accuracy reports, security reports, and contribution proposals is **helpfulbutton140@agentmail.to** (see `README.md`, `docs/CONTRIBUTING.md`, `docs/SECURITY.md`).
+
+### Added since 0.0.1
+
+- Brand committed: working slug `disclo` retired in favor of `plainstamp` after a namespace availability check (github.com/disclo is taken by an unrelated $6.75M-funded HR/workforce SaaS).
+- Colorado AI Act (SB 24-205) — consumer-interaction disclosure; effective 2026-06-30 after a delay from 2026-02-01.
+- Utah AI Policy Act (SB 149) as amended by SB 226 (2025) and extended by SB 332 — GenAI disclosure in regulated occupations; trigger is "asked OR high-risk."
+- Texas TRAIGA (HB 149) — government-agency AI disclosure (effective 2026-01-01).
+- Texas TRAIGA (HB 149) — healthcare-provider AI disclosure (effective 2026-01-01).
+- New York AI Companion Models law (NY GBL Art. 47, A6767) — non-human notification at start of interaction and at least every three hours; specific substantive text required; crisis-protocol obligation; $15,000/day civil penalty (effective 2025-11-05).
+- Illinois Human Rights Act — AI in employment (HB 3773) — notice and substantive non-discrimination obligations when AI is used to influence or facilitate covered employment decisions (effective 2026-01-01). Adds new `employment-decisions` use case to the schema.
+- Regulatory-update watcher prototype at `src/watcher/` with the Federal Register source plugged in (Rules + Proposed Rules matching configurable search terms; defaults to "artificial intelligence", "automated decision", "algorithmic"). Persists per-source state to a JSON file, emits a digest of new articles since last run, fails per-source rather than aborting the whole run. Bin: `plainstamp-watcher`. 7 unit tests on the diff and orchestrator.
+- NYC Local Law 144 (Administrative Code §§ 20-870 through 20-873) — AEDT bias-audit, public summary, and 10-business-days candidate notice. Adds a third jurisdiction segment to the schema (`us-ny-nyc`); jurisdiction regex extended to allow up to two hyphen-separated nesting levels.
+- EU AI Act Article 50(2) rule notes updated with Omnibus VII context: 2026-05-07 provisional agreement reduces the transparency-solutions grace period from 6 months to 3 months (new compliance deadline 2026-12-02) and postpones AI regulatory sandbox deadlines to 2027-08-02. Re-verify before final adoption.
+- California AB 2013 (Generative AI Training Data Transparency Act) — developers of generative AI systems made publicly available to Californians (including any system released on or after 2022-01-01) must post a high-level summary of training datasets on their website covering the 12 statute-enumerated categories. Effective 2026-01-01. Enforced via California's Unfair Competition Law. The rule's channels are `about-page` and `terms-of-service` — it's a website-disclosure rule, not a per-interaction message obligation.
+- Maryland Labor & Employment § 3-717 (HB 1202, 2020) — facial-recognition services during pre-employment interviews require a written consent waiver from the applicant, with four required content elements (name, interview date, consent statement, read-acknowledgment). Effective 2020-10-01. Channel `video-avatar` + use case `employment-decisions`.
+- Coverage matrix: `plainstamp coverage` (CLI) and `computeCoverageMatrix` / `renderCoverageMarkdown` / `renderCoverageCsv` (library) compute and render a jurisdiction × use-case rule-count matrix. Helps users see at-a-glance what plainstamp covers and where gaps are. Three output formats: markdown (default), csv, json (with rule_ids per cell).
+- Rule count 5 → 14. Test count 13 → 51, all passing.
+
+## [0.0.1] — 2026-05-08
+
+Initial Phase-0 release. Local-only build; not yet published to a public registry.
+
+### Added
+
+- Rule schema (Zod) covering jurisdiction, channels, use cases, severity, required elements, citation, templates, effective date, and last-verified date.
+- Bundled seed rules:
+  - California bot disclosure (B&P § 17941).
+  - EU AI Act Article 50(1) — chatbot disclosure.
+  - EU AI Act Article 50(2) — AI-generated content labeling.
+  - FTC fake reviews/testimonials (16 CFR Part 465).
+  - California AI Transparency Act (SB 942).
+- Lookup engine with parent-jurisdiction inheritance (a `us-ca` query also matches federal `us` rules) and `general` use-case matching.
+- Heuristic disclosure validator (substring match against rule keywords; not a legal-sufficiency check).
+- MCP server exposing five tools: `list_jurisdictions`, `list_rules`, `get_rule`, `lookup_disclosure`, `validate_disclosure`.
+- CLI: `plainstamp list-jurisdictions`, `plainstamp list-rules`, `plainstamp get-rule`, `plainstamp lookup`, `plainstamp validate`.
+- TypeScript library exporting `disclosuresFor`, `validateDisclosureForQuery`, `getRuleById`, `listJurisdictions`, plus the underlying schema types.
+- 13/13 unit tests passing (Node native test runner). Coverage includes rule schema validation, lookup matching, severity sorting, jurisdiction inheritance, validator heuristics, and citation/element invariants on every seed rule.
+- README, AI-DISCLOSURE, LICENSE (MIT).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KS Elevated Solutions LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,179 @@
+# plainstamp
+
+> AI disclosure compliance, as a library and an MCP server.
+>
+> Generates legally-grounded disclosure text for every (jurisdiction × channel × use-case) an AI-powered product can encounter. Each rule cites its regulator-published source. Updates track regulatory changes.
+
+> **Informational only — not legal advice.** plainstamp surfaces the published text of real regulations and provides templates derived from them, with citation back to the regulator's own published source. It is not a substitute for legal counsel. For high-stakes disclosures, verify against the cited text and consult an attorney.
+
+> **Operated by an autonomous AI agent under KS Elevated Solutions LLC.** See [AI-DISCLOSURE.md](AI-DISCLOSURE.md).
+
+## What it does
+
+```
+input  →   jurisdiction (e.g. "us-ca", "eu")
+           channel       (e.g. "live-chat", "ai-generated-image")
+           use_case      (e.g. "b2c-customer-support", "b2c-marketing")
+
+output →   list of applicable regulatory rules, each with:
+             • the regulator-published citation (statute, section, source URL)
+             • required disclosure elements
+             • a generated plain-language template
+             • a generated formal-language template
+             • a last-verified date
+```
+
+## Install
+
+```bash
+npm install plainstamp
+# or
+pnpm add plainstamp
+```
+
+Requires Node.js 22 or later.
+
+## CLI
+
+```bash
+# What jurisdictions are covered?
+npx plainstamp list-jurisdictions
+
+# Which rules apply to a California live-chat agent doing B2C support?
+npx plainstamp lookup --jurisdiction us-ca --channel live-chat --use-case b2c-customer-support
+
+# Get a single rule with its full citation.
+npx plainstamp get-rule us-ca-bot-disclosure-17941
+
+# Heuristic check: does this candidate disclosure mention the required elements?
+npx plainstamp validate \
+  --jurisdiction us-ca \
+  --channel live-chat \
+  --use-case b2c-customer-support \
+  --text "You are chatting with an automated AI assistant, not a human."
+
+# Coverage matrix (jurisdiction × use-case rule counts)
+npx plainstamp coverage                     # markdown table (default)
+npx plainstamp coverage --format csv        # machine-readable CSV
+npx plainstamp coverage --format json       # full structure with rule_ids per cell
+```
+
+All output is JSON. Pipe through `jq` for filtering.
+
+## MCP server
+
+plainstamp ships with an MCP server that exposes the same lookups as tools, designed to be called from autonomous agents at runtime.
+
+### Tools
+
+| Tool | Purpose |
+|---|---|
+| `list_jurisdictions` | Discover supported jurisdiction ids. |
+| `list_rules` | Browse rule summaries (id, jurisdiction, severity, title). |
+| `get_rule` | Fetch a single rule with full citation and templates. |
+| `lookup_disclosure` | Primary tool — applicable rules + generated text for a query. |
+| `validate_disclosure` | Heuristic check that a candidate disclosure mentions a rule's required elements. |
+
+### Connect from Claude Desktop / Claude Code
+
+Add to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "plainstamp": {
+      "command": "npx",
+      "args": ["-y", "plainstamp", "mcp"]
+    }
+  }
+}
+```
+
+### Connect from any MCP client
+
+The server speaks the standard MCP stdio transport. Spawn `npx plainstamp mcp` (or run `node dist/mcp-server.js` from a checkout) and connect to its stdin/stdout.
+
+## Library
+
+```ts
+import { disclosuresFor, validateDisclosureForQuery } from "plainstamp";
+
+// Get applicable rules and generated text for a query.
+const results = disclosuresFor({
+  jurisdiction: "eu",
+  channel: "ai-generated-image",
+  use_case: "b2c-marketing",
+});
+
+for (const r of results) {
+  console.log(r.rule.short_title);
+  console.log("  citation:", r.rule.citation.source_url);
+  console.log("  required:", r.generated_text.plain);
+}
+
+// Heuristic check on a candidate disclosure.
+const reports = validateDisclosureForQuery(
+  {
+    jurisdiction: "us-ca",
+    channel: "live-chat",
+    use_case: "b2c-customer-support",
+  },
+  "You are chatting with an automated AI assistant, not a human.",
+);
+```
+
+## How matching works
+
+- **Jurisdiction.** A rule whose jurisdiction equals the query, or whose jurisdiction is a hyphen-bounded prefix of it. So a query for `us-ca` matches both `us-ca`-specific rules AND federal-`us` rules. A query for `us` does NOT match `us-ca`-specific rules — federal-only.
+- **Channel.** The rule's `channels` list must include the query channel.
+- **Use case.** The rule's `use_cases` list must include the query use case, OR include the universal `general` use case.
+- **Severity.** Results are sorted with `mandatory` rules first, then `recommended`, then `best-practice`.
+
+## Coverage
+
+| Rule | Jurisdiction | Effective | Last verified |
+|---|---|---|---|
+| California bot disclosure (B&P § 17941) | us-ca | 2019-07-01 | 2026-05-08 |
+| EU AI Act Article 50(1) — chatbot disclosure | eu | 2026-08-02 | 2026-05-08 |
+| EU AI Act Article 50(2) — AI-generated content labeling | eu | 2026-08-02 | 2026-05-08 |
+| FTC fake reviews/testimonials (16 CFR Part 465) | us | 2024-10-21 | 2026-05-08 |
+| California AI Transparency Act (SB 942) | us-ca | 2026-01-01 | 2026-05-08 |
+| Colorado AI Act (SB 24-205) — consumer disclosure | us-co | 2026-06-30 | 2026-05-08 |
+| Utah AI Policy Act (SB 149, as amended by SB 226 / SB 332) | us-ut | 2024-05-01 | 2026-05-08 |
+| Texas TRAIGA (HB 149) — government agency | us-tx | 2026-01-01 | 2026-05-08 |
+| Texas TRAIGA (HB 149) — healthcare provider | us-tx | 2026-01-01 | 2026-05-08 |
+| New York AI Companion Models (NY GBL Art. 47, A6767) | us-ny | 2025-11-05 | 2026-05-08 |
+| Illinois Human Rights Act — AI in employment (HB 3773) | us-il | 2026-01-01 | 2026-05-08 |
+| NYC Local Law 144 — Automated Employment Decision Tools | us-ny-nyc | 2023-07-05 | 2026-05-08 |
+| California AB 2013 — Generative AI Training Data Transparency | us-ca | 2026-01-01 | 2026-05-08 |
+| Maryland LE § 3-717 — facial recognition in interviews (HB 1202) | us-md | 2020-10-01 | 2026-05-08 |
+
+Coverage will expand to EU member-state implementations and sector-specific rules (healthcare, financial services). See [`CHANGELOG.md`](CHANGELOG.md).
+
+## Disclaimers
+
+1. **Not legal advice.** plainstamp provides templates and citations to public regulatory text. It is informational tooling, not a substitute for legal counsel.
+2. **Conservative bias.** When a rule's applicability is ambiguous, plainstamp errs toward over-disclosure. Many disclosure regimes have a "reasonable person" standard; disclosing by default is almost always safer than not.
+3. **Heuristic validator.** `validate_disclosure` does substring matching against rule keywords. It can produce false negatives (rejecting compliant text) and false positives (accepting non-compliant text). Use it as a smoke test, not a sufficiency determination.
+4. **Last-verified dates matter.** Each rule carries a `last_verified` date. Regulations change; do not rely on a rule whose `last_verified` is more than a quarter old without checking the cited source URL.
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+## Contact
+
+This venture is operated by an autonomous AI agent. The contact channel for accuracy reports, bug reports, security issues, and contribution proposals is:
+
+**helpfulbutton140@agentmail.to**
+
+The inbox is monitored by the agent. Replies are AI-generated and identify themselves as such on first contact (per `AI-DISCLOSURE.md`). Human contributors who want attribution are credited by name on opt-in.
+
+## Reporting accuracy issues
+
+Rule accuracy is the product. If a rule's text, citation, or applicability is wrong, email **helpfulbutton140@agentmail.to** with:
+- The rule id (e.g. `us-ca-bot-disclosure-17941`)
+- The specific element disputed
+- A link to the regulator-published text supporting the correction
+
+Accuracy reports are prioritized.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+import { parseArgs } from "node:util";
+import { disclosuresFor, getRuleById, listJurisdictions, loadBundledRules, validateDisclosureForQuery, computeCoverageMatrix, renderCoverageMarkdown, renderCoverageCsv, } from "./index.js";
+import { Channel, UseCase } from "./schema.js";
+const help = `
+plainstamp — AI disclosure compliance lookup
+
+Usage:
+  plainstamp mcp                                    # start MCP server (stdio)
+  plainstamp list-jurisdictions
+  plainstamp list-rules
+  plainstamp get-rule <rule-id>
+  plainstamp lookup --jurisdiction <id> --channel <ch> --use-case <uc>
+  plainstamp validate --jurisdiction <id> --channel <ch> --use-case <uc> --text "<candidate disclosure>"
+  plainstamp coverage [--format json|markdown|csv]   # rule coverage matrix
+
+Channels:    ${Channel.options.join(", ")}
+Use cases:   ${UseCase.options.join(", ")}
+
+Output is JSON. This tool is informational and does not provide legal advice;
+every rule cites its regulator-published source for verification.
+`.trim();
+const subcommand = process.argv[2];
+const rest = process.argv.slice(3);
+if (subcommand === undefined || subcommand === "--help" || subcommand === "-h") {
+    console.log(help);
+    process.exit(subcommand === undefined ? 1 : 0);
+}
+switch (subcommand) {
+    case "mcp": {
+        await import("./mcp-server.js");
+        break;
+    }
+    case "coverage": {
+        const { values } = parseArgs({
+            args: rest,
+            options: { format: { type: "string" } },
+            strict: true,
+        });
+        const matrix = computeCoverageMatrix(loadBundledRules());
+        const fmt = values.format ?? "markdown";
+        if (fmt === "json") {
+            console.log(JSON.stringify(matrix, null, 2));
+        }
+        else if (fmt === "csv") {
+            console.log(renderCoverageCsv(matrix));
+        }
+        else if (fmt === "markdown") {
+            console.log(renderCoverageMarkdown(matrix));
+        }
+        else {
+            console.error(`unknown --format: ${fmt}. Use json, markdown, or csv.`);
+            process.exit(2);
+        }
+        break;
+    }
+    case "list-jurisdictions": {
+        console.log(JSON.stringify({ jurisdictions: listJurisdictions() }, null, 2));
+        break;
+    }
+    case "list-rules": {
+        const rules = loadBundledRules();
+        const summaries = rules.rules.map((r) => ({
+            id: r.id,
+            jurisdiction: r.jurisdiction,
+            severity: r.severity,
+            short_title: r.short_title,
+        }));
+        console.log(JSON.stringify(summaries, null, 2));
+        break;
+    }
+    case "get-rule": {
+        const ruleId = rest[0];
+        if (ruleId === undefined) {
+            console.error("usage: plainstamp get-rule <rule-id>");
+            process.exit(2);
+        }
+        const rule = getRuleById(ruleId);
+        if (rule === undefined) {
+            console.error(`unknown rule id: ${ruleId}`);
+            process.exit(1);
+        }
+        console.log(JSON.stringify(rule, null, 2));
+        break;
+    }
+    case "lookup": {
+        const { values } = parseArgs({
+            args: rest,
+            options: {
+                jurisdiction: { type: "string" },
+                channel: { type: "string" },
+                "use-case": { type: "string" },
+            },
+            strict: true,
+        });
+        if (!values.jurisdiction || !values.channel || !values["use-case"]) {
+            console.error("usage: plainstamp lookup --jurisdiction <id> --channel <ch> --use-case <uc>");
+            process.exit(2);
+        }
+        const results = disclosuresFor({
+            jurisdiction: values.jurisdiction,
+            channel: Channel.parse(values.channel),
+            use_case: UseCase.parse(values["use-case"]),
+        });
+        console.log(JSON.stringify({
+            disclaimer: "Informational only. Not legal advice. Each rule cites its source.",
+            count: results.length,
+            results,
+        }, null, 2));
+        break;
+    }
+    case "validate": {
+        const { values } = parseArgs({
+            args: rest,
+            options: {
+                jurisdiction: { type: "string" },
+                channel: { type: "string" },
+                "use-case": { type: "string" },
+                text: { type: "string" },
+            },
+            strict: true,
+        });
+        if (!values.jurisdiction ||
+            !values.channel ||
+            !values["use-case"] ||
+            !values.text) {
+            console.error("usage: plainstamp validate --jurisdiction <id> --channel <ch> --use-case <uc> --text \"<candidate disclosure>\"");
+            process.exit(2);
+        }
+        const reports = validateDisclosureForQuery({
+            jurisdiction: values.jurisdiction,
+            channel: Channel.parse(values.channel),
+            use_case: UseCase.parse(values["use-case"]),
+        }, values.text);
+        console.log(JSON.stringify({
+            disclaimer: "Heuristic substring check. NOT a legal-sufficiency determination.",
+            reports,
+        }, null, 2));
+        break;
+    }
+    default: {
+        console.error(`unknown subcommand: ${subcommand}\n`);
+        console.error(help);
+        process.exit(2);
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/coverage.d.ts

@@ -0,0 +1,48 @@
+import type { RuleSetT } from "./schema.js";
+/**
+ * Coverage matrix: how many rules apply to each (jurisdiction × use_case)
+ * combination, summed across all channels. Higher counts mean better coverage;
+ * empty cells are gaps the rule set doesn't yet address.
+ *
+ * Returned data is plain JSON. Renderers (markdown, csv, etc.) live in the CLI.
+ */
+export interface CoverageCell {
+    /** Number of rules in the bundle that match this (jurisdiction × use_case). */
+    count: number;
+    /** The severity badges present, deduplicated. */
+    severities: Array<"mandatory" | "recommended" | "best-practice">;
+    /** Rule ids that contribute to this cell. */
+    rule_ids: string[];
+}
+export interface CoverageMatrix {
+    jurisdictions: string[];
+    use_cases: readonly string[];
+    /** matrix[jurisdiction][use_case] = CoverageCell */
+    matrix: Record<string, Record<string, CoverageCell>>;
+    totals: {
+        rules: number;
+        jurisdictions: number;
+        use_cases: number;
+    };
+}
+/**
+ * Computes the coverage matrix from a rule set. A rule "covers"
+ * (jurisdiction, use_case) iff:
+ *   - its jurisdiction equals the row jurisdiction, AND
+ *   - its use_cases list includes the column use_case (or the universal `general`).
+ *
+ * NOTE: this matrix uses *exact* jurisdiction equality, NOT the parent-prefix
+ * cascading that `lookup()` does. The reason: the matrix is meant to show where
+ * rules ORIGINATE, not where they apply via inheritance. To see where a query
+ * for `us-ny-nyc` would land (which inherits us-ny and us rules), use `lookup()`.
+ */
+export declare function computeCoverageMatrix(rules: RuleSetT): CoverageMatrix;
+/**
+ * Renders the coverage matrix as a markdown table. Cells show rule count;
+ * `.` means zero coverage. A short legend below names the channels (which
+ * the matrix collapses across).
+ */
+export declare function renderCoverageMarkdown(m: CoverageMatrix): string;
+/** Renders as CSV; same shape as markdown but machine-friendly. */
+export declare function renderCoverageCsv(m: CoverageMatrix): string;
+//# sourceMappingURL=coverage.d.ts.map

package/dist/coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../src/coverage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,aAAa,CAAC;AAG7D;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,UAAU,EAAE,KAAK,CAAC,WAAW,GAAG,aAAa,GAAG,eAAe,CAAC,CAAC;IACjE,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACrD,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,QAAQ,GAAG,cAAc,CAmCrE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CA2BhE;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAU3D"}

package/dist/coverage.js

@@ -0,0 +1,96 @@
+import { Channel, UseCase } from "./schema.js";
+/**
+ * Computes the coverage matrix from a rule set. A rule "covers"
+ * (jurisdiction, use_case) iff:
+ *   - its jurisdiction equals the row jurisdiction, AND
+ *   - its use_cases list includes the column use_case (or the universal `general`).
+ *
+ * NOTE: this matrix uses *exact* jurisdiction equality, NOT the parent-prefix
+ * cascading that `lookup()` does. The reason: the matrix is meant to show where
+ * rules ORIGINATE, not where they apply via inheritance. To see where a query
+ * for `us-ny-nyc` would land (which inherits us-ny and us rules), use `lookup()`.
+ */
+export function computeCoverageMatrix(rules) {
+    const useCases = UseCase.options;
+    const byJur = new Map();
+    for (const rule of rules.rules) {
+        const list = byJur.get(rule.jurisdiction) ?? [];
+        list.push(rule);
+        byJur.set(rule.jurisdiction, list);
+    }
+    const jurisdictions = [...byJur.keys()].sort();
+    const matrix = {};
+    for (const jur of jurisdictions) {
+        matrix[jur] = {};
+        for (const uc of useCases) {
+            const matches = (byJur.get(jur) ?? []).filter((r) => r.use_cases.includes(uc) || r.use_cases.includes("general"));
+            matrix[jur][uc] = {
+                count: matches.length,
+                severities: [...new Set(matches.map((r) => r.severity))],
+                rule_ids: matches.map((r) => r.id).sort(),
+            };
+        }
+    }
+    return {
+        jurisdictions,
+        use_cases: useCases,
+        matrix,
+        totals: {
+            rules: rules.rules.length,
+            jurisdictions: jurisdictions.length,
+            use_cases: useCases.length,
+        },
+    };
+}
+/**
+ * Renders the coverage matrix as a markdown table. Cells show rule count;
+ * `.` means zero coverage. A short legend below names the channels (which
+ * the matrix collapses across).
+ */
+export function renderCoverageMarkdown(m) {
+    const colHeaders = m.use_cases.map((uc) => shortenUseCase(uc));
+    const lines = [];
+    lines.push(`# plainstamp coverage matrix (${m.totals.rules} rules across ${m.totals.jurisdictions} jurisdictions × ${m.totals.use_cases} use cases)`);
+    lines.push("");
+    lines.push(`| jurisdiction | ${colHeaders.join(" | ")} |`);
+    lines.push(`|---|${m.use_cases.map(() => "---").join("|")}|`);
+    for (const jur of m.jurisdictions) {
+        const row = m.use_cases.map((uc) => {
+            const c = m.matrix[jur]?.[uc];
+            return c === undefined || c.count === 0 ? "." : String(c.count);
+        });
+        lines.push(`| **${jur}** | ${row.join(" | ")} |`);
+    }
+    lines.push("");
+    lines.push(`Cell value = number of bundled rules whose jurisdiction equals the row AND whose use-cases include the column (or 'general'). Channels are collapsed across; use \`plainstamp lookup --jurisdiction X --channel Y --use-case Z\` for channel-specific results.`);
+    lines.push("");
+    lines.push(`Channels covered by the rule set: ${Channel.options.join(", ")}.`);
+    return lines.join("\n");
+}
+/** Renders as CSV; same shape as markdown but machine-friendly. */
+export function renderCoverageCsv(m) {
+    const header = ["jurisdiction", ...m.use_cases].join(",");
+    const rows = m.jurisdictions.map((jur) => {
+        const cells = m.use_cases.map((uc) => {
+            const c = m.matrix[jur]?.[uc];
+            return c === undefined ? 0 : c.count;
+        });
+        return [jur, ...cells].join(",");
+    });
+    return [header, ...rows].join("\n");
+}
+function shortenUseCase(uc) {
+    // Compact column headers for terminal-friendly output.
+    return uc
+        .replace("b2c-customer-support", "b2c-cs")
+        .replace("b2b-customer-support", "b2b-cs")
+        .replace("b2c-marketing", "b2c-mkt")
+        .replace("b2b-marketing", "b2b-mkt")
+        .replace("b2c-sales", "b2c-sls")
+        .replace("b2b-sales", "b2b-sls")
+        .replace("civic-or-electoral", "civic")
+        .replace("financial-services", "finance")
+        .replace("legal-services", "legal")
+        .replace("employment-decisions", "employ");
+}
+//# sourceMappingURL=coverage.js.map

package/dist/coverage.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+export { lookup, generateDisclosureText, validateDisclosure, } from "./lookup.js";
+export { loadBundledRules, loadRulesFromPath } from "./rules-loader.js";
+export { computeCoverageMatrix, renderCoverageMarkdown, renderCoverageCsv, type CoverageMatrix, type CoverageCell, } from "./coverage.js";
+export type { DisclosureRuleT, RuleSetT, LookupQueryT, LookupResultT, ChannelT, UseCaseT, SeverityT, JurisdictionIdT, DisclosureElementT, } from "./schema.js";
+import type { LookupQueryT, LookupResultT, DisclosureRuleT } from "./schema.js";
+/**
+ * High-level convenience: load the bundled rules and look up disclosures for
+ * a query. For long-running processes that issue many lookups, prefer caching
+ * the rule set with `loadBundledRules()` once.
+ */
+export declare function disclosuresFor(query: LookupQueryT): LookupResultT[];
+/** Returns every distinct jurisdiction id present in the bundled rules. */
+export declare function listJurisdictions(): string[];
+/** Returns the rule whose id matches, or undefined. */
+export declare function getRuleById(id: string): DisclosureRuleT | undefined;
+/**
+ * Heuristic disclosure-text validator (substring check). NOT a legal-sufficiency
+ * determination. Returns one validation report per rule that applies to the
+ * provided query.
+ */
+export declare function validateDisclosureForQuery(query: LookupQueryT, candidateText: string): {
+    rule_id: string;
+    passes: boolean;
+    missing_elements: string[];
+    warning: string;
+}[];
+//# sourceMappingURL=index.d.ts.map