plainstamp 0.0.1

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,eAAe,EACf,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,eAAe,EACf,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAIrB,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEhF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,EAAE,CAEnE;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAK5C;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAGnE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,YAAY,EACnB,aAAa,EAAE,MAAM;;;;;IAKtB"}

package/dist/index.js

@@ -0,0 +1,37 @@
+export { lookup, generateDisclosureText, validateDisclosure, } from "./lookup.js";
+export { loadBundledRules, loadRulesFromPath } from "./rules-loader.js";
+export { computeCoverageMatrix, renderCoverageMarkdown, renderCoverageCsv, } from "./coverage.js";
+import { loadBundledRules } from "./rules-loader.js";
+import { lookup as lookupFn, validateDisclosure as validateFn } from "./lookup.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 function disclosuresFor(query) {
+    return lookupFn(loadBundledRules(), query);
+}
+/** Returns every distinct jurisdiction id present in the bundled rules. */
+export function listJurisdictions() {
+    const rules = loadBundledRules();
+    const set = new Set();
+    for (const r of rules.rules)
+        set.add(r.jurisdiction);
+    return [...set].sort();
+}
+/** Returns the rule whose id matches, or undefined. */
+export function getRuleById(id) {
+    const rules = loadBundledRules();
+    return rules.rules.find((r) => r.id === id);
+}
+/**
+ * Heuristic disclosure-text validator (substring check). NOT a legal-sufficiency
+ * determination. Returns one validation report per rule that applies to the
+ * provided query.
+ */
+export function validateDisclosureForQuery(query, candidateText) {
+    const rules = loadBundledRules();
+    const applicable = lookupFn(rules, query);
+    return applicable.map((m) => validateFn(m.rule, candidateText));
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,GAGlB,MAAM,eAAe,CAAC;AAavB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,MAAM,IAAI,QAAQ,EAAE,kBAAkB,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAGnF;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAmB;IAChD,OAAO,QAAQ,CAAC,gBAAgB,EAAE,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB;IAC/B,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK;QAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,WAAW,CAAC,EAAU;IACpC,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;IACjC,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,KAAmB,EACnB,aAAqB;IAErB,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC1C,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/lookup.d.ts

@@ -0,0 +1,42 @@
+import { type DisclosureRuleT, type LookupQueryT, type LookupResultT, type RuleSetT } from "./schema.js";
+/**
+ * Returns the rules that apply to a given (jurisdiction × channel × use_case)
+ * query, plus a generated disclosure-text result for each.
+ *
+ * Match semantics:
+ *   - jurisdiction: the rule's jurisdiction must equal the query jurisdiction,
+ *     or the rule's jurisdiction must be a less-specific prefix of the query
+ *     jurisdiction. Example: a query for "us-ca" matches rules with
+ *     jurisdiction "us-ca" (exact) and rules with jurisdiction "us" (parent).
+ *   - 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.
+ *
+ * Rules are returned in deterministic order: by severity (mandatory first),
+ * then by id (alphabetical).
+ */
+export declare function lookup(rules: RuleSetT, query: LookupQueryT): LookupResultT[];
+export declare function generateDisclosureText(rule: DisclosureRuleT): {
+    plain: string;
+    formal?: string | undefined;
+};
+/**
+ * Validates a candidate disclosure text against a rule's required elements.
+ *
+ * The check is heuristic. For each required element it derives a small set of
+ * keyword signals (id tokens, significant words from the element description
+ * and example) and checks whether any appear in the candidate (case-insensitive).
+ * An element with no signals found is reported as missing.
+ *
+ * This is a sanity check, NOT a legal-sufficiency determination. False
+ * negatives (rejecting compliant text) are possible and false positives
+ * (accepting non-compliant text) are possible. For high-stakes disclosures,
+ * verify against the cited regulator-published text and consult counsel.
+ */
+export declare function validateDisclosure(rule: DisclosureRuleT, candidate: string): {
+    rule_id: string;
+    passes: boolean;
+    missing_elements: string[];
+    warning: string;
+};
+//# sourceMappingURL=lookup.d.ts.map

package/dist/lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../src/lookup.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACd,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,GAAG,aAAa,EAAE,CAuB5E;AAoCD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAOA;AAiED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,eAAe,EACrB,SAAS,EAAE,MAAM,GAChB;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB,CAkBA"}

package/dist/lookup.js

@@ -0,0 +1,170 @@
+/**
+ * Returns the rules that apply to a given (jurisdiction × channel × use_case)
+ * query, plus a generated disclosure-text result for each.
+ *
+ * Match semantics:
+ *   - jurisdiction: the rule's jurisdiction must equal the query jurisdiction,
+ *     or the rule's jurisdiction must be a less-specific prefix of the query
+ *     jurisdiction. Example: a query for "us-ca" matches rules with
+ *     jurisdiction "us-ca" (exact) and rules with jurisdiction "us" (parent).
+ *   - 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.
+ *
+ * Rules are returned in deterministic order: by severity (mandatory first),
+ * then by id (alphabetical).
+ */
+export function lookup(rules, query) {
+    const matches = [];
+    for (const rule of rules.rules) {
+        const reasons = matchReasons(rule, query);
+        if (reasons.length === 0)
+            continue;
+        const generated = generateDisclosureText(rule);
+        matches.push({
+            rule,
+            applies_because: reasons,
+            generated_text: generated,
+        });
+    }
+    matches.sort((a, b) => {
+        const sevOrder = { mandatory: 0, recommended: 1, "best-practice": 2 };
+        const sevDiff = sevOrder[a.rule.severity] - sevOrder[b.rule.severity];
+        if (sevDiff !== 0)
+            return sevDiff;
+        return a.rule.id.localeCompare(b.rule.id);
+    });
+    return matches;
+}
+function matchReasons(rule, query) {
+    const reasons = [];
+    if (!matchesJurisdiction(rule.jurisdiction, query.jurisdiction))
+        return [];
+    reasons.push(rule.jurisdiction === query.jurisdiction
+        ? `jurisdiction exact match: ${rule.jurisdiction}`
+        : `jurisdiction parent match: rule covers '${rule.jurisdiction}', query is '${query.jurisdiction}'`);
+    if (!rule.channels.includes(query.channel))
+        return [];
+    reasons.push(`channel match: rule covers '${query.channel}'`);
+    const matchesGeneral = rule.use_cases.includes("general");
+    if (!rule.use_cases.includes(query.use_case) && !matchesGeneral)
+        return [];
+    reasons.push(rule.use_cases.includes(query.use_case)
+        ? `use case match: rule covers '${query.use_case}'`
+        : `use case match via 'general' (rule applies to general AI interactions)`);
+    return reasons;
+}
+/**
+ * A rule's jurisdiction matches a query jurisdiction if they're equal or if
+ * the rule's jurisdiction is a hyphen-bounded prefix of the query (so 'us'
+ * matches 'us-ca' but not 'us-coxx' — and certainly not 'usa').
+ */
+function matchesJurisdiction(rule, query) {
+    if (rule === query)
+        return true;
+    return query.startsWith(`${rule}-`);
+}
+export function generateDisclosureText(rule) {
+    return {
+        plain: rule.template.plain,
+        ...(rule.template.formal === undefined
+            ? {}
+            : { formal: rule.template.formal }),
+    };
+}
+const STOPWORDS = new Set([
+    "about",
+    "above",
+    "after",
+    "again",
+    "against",
+    "being",
+    "below",
+    "between",
+    "both",
+    "doing",
+    "during",
+    "each",
+    "from",
+    "further",
+    "have",
+    "here",
+    "into",
+    "more",
+    "most",
+    "must",
+    "other",
+    "over",
+    "same",
+    "should",
+    "some",
+    "such",
+    "than",
+    "that",
+    "their",
+    "them",
+    "these",
+    "they",
+    "this",
+    "those",
+    "through",
+    "under",
+    "until",
+    "what",
+    "when",
+    "where",
+    "which",
+    "while",
+    "with",
+    "would",
+    "your",
+]);
+function signalsFor(element) {
+    const signals = [];
+    for (const token of element.id.split("-")) {
+        if (token.length > 3)
+            signals.push(token.toLowerCase());
+    }
+    const collect = (text) => {
+        for (const word of text.toLowerCase().split(/[^a-z0-9]+/)) {
+            if (word.length > 4 && !STOPWORDS.has(word))
+                signals.push(word);
+        }
+    };
+    collect(element.description);
+    if (element.example !== undefined)
+        collect(element.example);
+    return [...new Set(signals)];
+}
+/**
+ * Validates a candidate disclosure text against a rule's required elements.
+ *
+ * The check is heuristic. For each required element it derives a small set of
+ * keyword signals (id tokens, significant words from the element description
+ * and example) and checks whether any appear in the candidate (case-insensitive).
+ * An element with no signals found is reported as missing.
+ *
+ * This is a sanity check, NOT a legal-sufficiency determination. False
+ * negatives (rejecting compliant text) are possible and false positives
+ * (accepting non-compliant text) are possible. For high-stakes disclosures,
+ * verify against the cited regulator-published text and consult counsel.
+ */
+export function validateDisclosure(rule, candidate) {
+    const lower = candidate.toLowerCase();
+    const missing = [];
+    for (const el of rule.required_elements) {
+        if (!el.required)
+            continue;
+        const signals = signalsFor(el);
+        const found = signals.some((s) => lower.includes(s));
+        if (!found)
+            missing.push(el.id);
+    }
+    return {
+        rule_id: rule.id,
+        passes: missing.length === 0,
+        missing_elements: missing,
+        warning: "Heuristic substring check. NOT a legal-sufficiency determination. For high-stakes disclosures, verify against the cited regulator-published text and consult counsel.",
+    };
+}
+//# sourceMappingURL=lookup.js.map

package/dist/lookup.js.map

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

package/dist/mcp-server.d.ts

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

package/dist/mcp-server.d.ts.map

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

package/dist/mcp-server.js

@@ -0,0 +1,199 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { disclosuresFor, getRuleById, listJurisdictions, loadBundledRules, validateDisclosureForQuery, } from "./index.js";
+import { Channel, LookupQuery, UseCase } from "./schema.js";
+import { z } from "zod";
+/**
+ * MCP server exposing the disclo lookup engine to autonomous agents.
+ *
+ * Tool surface:
+ *   - list_jurisdictions  -> returns supported jurisdiction ids
+ *   - list_rules          -> returns rule summaries (id, jurisdiction, severity, title)
+ *   - get_rule            -> returns a single rule with full citation and template
+ *   - lookup_disclosure   -> primary tool: applicable rules + generated text for a (jurisdiction, channel, use_case)
+ *   - validate_disclosure -> heuristic check that a candidate disclosure mentions a rule's required elements
+ */
+const server = new Server({
+    name: "plainstamp",
+    version: "0.0.1",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+const ValidateInput = LookupQuery.extend({
+    candidate_text: z.string().min(1),
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "list_jurisdictions",
+            description: "List all jurisdiction ids supported by the bundled rules. Use this first to discover what's covered before calling lookup_disclosure.",
+            inputSchema: {
+                type: "object",
+                properties: {},
+                additionalProperties: false,
+            },
+        },
+        {
+            name: "list_rules",
+            description: "List all bundled disclosure rules as compact summaries. Useful for browsing the rule database.",
+            inputSchema: {
+                type: "object",
+                properties: {},
+                additionalProperties: false,
+            },
+        },
+        {
+            name: "get_rule",
+            description: "Fetch a single disclosure rule by id, with full citation, required elements, templates, and last-verified date.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    rule_id: { type: "string" },
+                },
+                required: ["rule_id"],
+                additionalProperties: false,
+            },
+        },
+        {
+            name: "lookup_disclosure",
+            description: "Primary tool. Given a jurisdiction (e.g. 'us-ca' or 'eu'), a channel (e.g. 'live-chat', 'ai-generated-content'), and a use case (e.g. 'b2c-customer-support'), return every applicable disclosure rule plus a generated plain-language and formal disclosure text. Results are sorted with mandatory rules first.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    jurisdiction: {
+                        type: "string",
+                        description: "Lowercase jurisdiction id (ISO-style). Examples: 'us', 'us-ca', 'eu'.",
+                    },
+                    channel: {
+                        type: "string",
+                        enum: Channel.options,
+                    },
+                    use_case: {
+                        type: "string",
+                        enum: UseCase.options,
+                    },
+                },
+                required: ["jurisdiction", "channel", "use_case"],
+                additionalProperties: false,
+            },
+        },
+        {
+            name: "validate_disclosure",
+            description: "Heuristic substring check that a candidate disclosure text mentions the required elements of every rule that applies to the (jurisdiction, channel, use_case). Returns a per-rule pass/fail report. NOT a legal-sufficiency determination — for high-stakes disclosures, verify against the cited regulator-published text and consult counsel.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    jurisdiction: { type: "string" },
+                    channel: { type: "string", enum: Channel.options },
+                    use_case: { type: "string", enum: UseCase.options },
+                    candidate_text: { type: "string", minLength: 1 },
+                },
+                required: ["jurisdiction", "channel", "use_case", "candidate_text"],
+                additionalProperties: false,
+            },
+        },
+    ],
+}));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const { name, arguments: args } = req.params;
+    switch (name) {
+        case "list_jurisdictions": {
+            const ids = listJurisdictions();
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify({ jurisdictions: ids }, null, 2) },
+                ],
+            };
+        }
+        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,
+                channels: r.channels,
+                use_cases: r.use_cases,
+                last_verified: r.last_verified,
+            }));
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            schema_version: rules.schema_version,
+                            generated_at: rules.generated_at,
+                            rules: summaries,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        case "get_rule": {
+            const ruleId = z.object({ rule_id: z.string() }).parse(args).rule_id;
+            const rule = getRuleById(ruleId);
+            if (rule === undefined) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `unknown rule_id: ${ruleId}` }],
+                };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(rule, null, 2) }],
+            };
+        }
+        case "lookup_disclosure": {
+            const parsed = LookupQuery.parse(args);
+            const results = disclosuresFor(parsed);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            query: parsed,
+                            disclaimer: "Informational only. Not legal advice. Each rule cites its source; verify against the regulator-published text before relying on it.",
+                            count: results.length,
+                            results,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        case "validate_disclosure": {
+            const parsed = ValidateInput.parse(args);
+            const reports = validateDisclosureForQuery({
+                jurisdiction: parsed.jurisdiction,
+                channel: parsed.channel,
+                use_case: parsed.use_case,
+            }, parsed.candidate_text);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            query: {
+                                jurisdiction: parsed.jurisdiction,
+                                channel: parsed.channel,
+                                use_case: parsed.use_case,
+                            },
+                            disclaimer: "Heuristic substring check. NOT a legal-sufficiency determination.",
+                            reports,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        default:
+            return {
+                isError: true,
+                content: [{ type: "text", text: `unknown tool: ${name}` }],
+            };
+    }
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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

package/dist/rules-loader.d.ts

@@ -0,0 +1,10 @@
+import { type RuleSetT } from "./schema.js";
+/**
+ * Loads and validates the bundled seed rules. Throws on schema violation —
+ * an invalid rules file is a hard failure because the product's correctness
+ * depends on it.
+ */
+export declare function loadBundledRules(): RuleSetT;
+/** Loads rules from an arbitrary path. Useful for tests and for callers that maintain their own rules feed. */
+export declare function loadRulesFromPath(path: string): RuleSetT;
+//# sourceMappingURL=rules-loader.d.ts.map

package/dist/rules-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-loader.d.ts","sourceRoot":"","sources":["../src/rules-loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAW,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIrD;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,QAAQ,CAK3C;AAED,+GAA+G;AAC/G,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAIxD"}

package/dist/rules-loader.js

@@ -0,0 +1,23 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { RuleSet } from "./schema.js";
+const here = dirname(fileURLToPath(import.meta.url));
+/**
+ * Loads and validates the bundled seed rules. Throws on schema violation —
+ * an invalid rules file is a hard failure because the product's correctness
+ * depends on it.
+ */
+export function loadBundledRules() {
+    const path = join(here, "..", "rules", "seed.json");
+    const raw = readFileSync(path, "utf-8");
+    const parsed = JSON.parse(raw);
+    return RuleSet.parse(parsed);
+}
+/** Loads rules from an arbitrary path. Useful for tests and for callers that maintain their own rules feed. */
+export function loadRulesFromPath(path) {
+    const raw = readFileSync(path, "utf-8");
+    const parsed = JSON.parse(raw);
+    return RuleSet.parse(parsed);
+}
+//# sourceMappingURL=rules-loader.js.map

package/dist/rules-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-loader.js","sourceRoot":"","sources":["../src/rules-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAiB,MAAM,aAAa,CAAC;AAErD,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,+GAA+G;AAC/G,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}