@pseolint/core 0.1.0 → 0.2.1

package/dist/telemetry/types.d.ts

@@ -0,0 +1,126 @@
+import { z } from "zod";
+/**
+ * Used to correlate a triage-feedback record back to the audit it belongs to.
+ * 16 lowercase hex chars = 64 bits of entropy.
+ */
+export declare const runIdSchema: z.ZodString;
+export declare const tokenUsageSchema: z.ZodObject<{
+    input: z.ZodNumber;
+    output: z.ZodNumber;
+}, z.core.$strict>;
+export declare const cacheStatsSchema: z.ZodObject<{
+    hits: z.ZodNumber;
+    total: z.ZodNumber;
+    bytesSavedEstimate: z.ZodNumber;
+}, z.core.$strict>;
+export declare const triageTelemetrySchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    skipReason: z.ZodOptional<z.ZodString>;
+    rootCauseCount: z.ZodNumber;
+    providerId: z.ZodString;
+    modelId: z.ZodString;
+    cacheHit: z.ZodBoolean;
+    tokenUsage: z.ZodObject<{
+        input: z.ZodNumber;
+        output: z.ZodNumber;
+    }, z.core.$strict>;
+    estimatedCostUsd: z.ZodOptional<z.ZodNumber>;
+    truncatedInput: z.ZodBoolean;
+}, z.core.$strict>;
+/** Audit run record — one per audit. */
+export declare const auditRecordSchema: z.ZodObject<{
+    type: z.ZodLiteral<"audit">;
+    schemaVersion: z.ZodLiteral<1>;
+    runId: z.ZodString;
+    timestamp: z.ZodString;
+    durationMs: z.ZodNumber;
+    score: z.ZodNumber;
+    pageCount: z.ZodNumber;
+    findingCount: z.ZodNumber;
+    rawFindingCount: z.ZodOptional<z.ZodNumber>;
+    templateDetected: z.ZodOptional<z.ZodBoolean>;
+    cacheStats: z.ZodOptional<z.ZodObject<{
+        hits: z.ZodNumber;
+        total: z.ZodNumber;
+        bytesSavedEstimate: z.ZodNumber;
+    }, z.core.$strict>>;
+    triage: z.ZodOptional<z.ZodObject<{
+        success: z.ZodBoolean;
+        skipReason: z.ZodOptional<z.ZodString>;
+        rootCauseCount: z.ZodNumber;
+        providerId: z.ZodString;
+        modelId: z.ZodString;
+        cacheHit: z.ZodBoolean;
+        tokenUsage: z.ZodObject<{
+            input: z.ZodNumber;
+            output: z.ZodNumber;
+        }, z.core.$strict>;
+        estimatedCostUsd: z.ZodOptional<z.ZodNumber>;
+        truncatedInput: z.ZodBoolean;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+/** Feedback record — one per triage feedback event. */
+export declare const feedbackRecordSchema: z.ZodObject<{
+    type: z.ZodLiteral<"feedback">;
+    schemaVersion: z.ZodLiteral<1>;
+    runId: z.ZodString;
+    timestamp: z.ZodString;
+    rating: z.ZodEnum<{
+        helpful: "helpful";
+        unhelpful: "unhelpful";
+        skipped: "skipped";
+    }>;
+}, z.core.$strict>;
+export declare const telemetryRecordSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"audit">;
+    schemaVersion: z.ZodLiteral<1>;
+    runId: z.ZodString;
+    timestamp: z.ZodString;
+    durationMs: z.ZodNumber;
+    score: z.ZodNumber;
+    pageCount: z.ZodNumber;
+    findingCount: z.ZodNumber;
+    rawFindingCount: z.ZodOptional<z.ZodNumber>;
+    templateDetected: z.ZodOptional<z.ZodBoolean>;
+    cacheStats: z.ZodOptional<z.ZodObject<{
+        hits: z.ZodNumber;
+        total: z.ZodNumber;
+        bytesSavedEstimate: z.ZodNumber;
+    }, z.core.$strict>>;
+    triage: z.ZodOptional<z.ZodObject<{
+        success: z.ZodBoolean;
+        skipReason: z.ZodOptional<z.ZodString>;
+        rootCauseCount: z.ZodNumber;
+        providerId: z.ZodString;
+        modelId: z.ZodString;
+        cacheHit: z.ZodBoolean;
+        tokenUsage: z.ZodObject<{
+            input: z.ZodNumber;
+            output: z.ZodNumber;
+        }, z.core.$strict>;
+        estimatedCostUsd: z.ZodOptional<z.ZodNumber>;
+        truncatedInput: z.ZodBoolean;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"feedback">;
+    schemaVersion: z.ZodLiteral<1>;
+    runId: z.ZodString;
+    timestamp: z.ZodString;
+    rating: z.ZodEnum<{
+        helpful: "helpful";
+        unhelpful: "unhelpful";
+        skipped: "skipped";
+    }>;
+}, z.core.$strict>], "type">;
+export type TokenUsage = z.infer<typeof tokenUsageSchema>;
+export type CacheStatsRecord = z.infer<typeof cacheStatsSchema>;
+export type TriageTelemetry = z.infer<typeof triageTelemetrySchema>;
+export type AuditRecord = z.infer<typeof auditRecordSchema>;
+export type FeedbackRecord = z.infer<typeof feedbackRecordSchema>;
+export type TelemetryRecord = z.infer<typeof telemetryRecordSchema>;
+/**
+ * Generate a 16-char lowercase hex runId. Used to correlate an audit record
+ * with any later feedback records for the same run.
+ */
+export declare function generateRunId(): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/telemetry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/telemetry/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,eAAO,MAAM,WAAW,aAAqC,CAAC;AAE9D,eAAO,MAAM,gBAAgB;;;kBAKlB,CAAC;AAEZ,eAAO,MAAM,gBAAgB;;;;kBAMlB,CAAC;AAEZ,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;kBAevB,CAAC;AAEZ,wCAAwC;AACxC,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAenB,CAAC;AAEZ,uDAAuD;AACvD,eAAO,MAAM,oBAAoB;;;;;;;;;;kBAQtB,CAAC;AAEZ,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAGhC,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAChE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}

package/dist/telemetry/types.js

@@ -0,0 +1,75 @@
+import crypto from "node:crypto";
+import { z } from "zod";
+/**
+ * Used to correlate a triage-feedback record back to the audit it belongs to.
+ * 16 lowercase hex chars = 64 bits of entropy.
+ */
+export const runIdSchema = z.string().regex(/^[0-9a-f]{16}$/);
+export const tokenUsageSchema = z
+    .object({
+    input: z.number().int().nonnegative(),
+    output: z.number().int().nonnegative(),
+})
+    .strict();
+export const cacheStatsSchema = z
+    .object({
+    hits: z.number().int().nonnegative(),
+    total: z.number().int().nonnegative(),
+    bytesSavedEstimate: z.number().int().nonnegative(),
+})
+    .strict();
+export const triageTelemetrySchema = z
+    .object({
+    /** Whether triage actually produced a result. False when fail-open skipped. */
+    success: z.boolean(),
+    /** Populated only when success=false. Short reason (kind: message). */
+    skipReason: z.string().optional(),
+    /** 0 when success=false. */
+    rootCauseCount: z.number().int().nonnegative(),
+    providerId: z.string(),
+    modelId: z.string(),
+    cacheHit: z.boolean(),
+    tokenUsage: tokenUsageSchema,
+    estimatedCostUsd: z.number().optional(),
+    truncatedInput: z.boolean(),
+})
+    .strict();
+/** Audit run record — one per audit. */
+export const auditRecordSchema = z
+    .object({
+    type: z.literal("audit"),
+    schemaVersion: z.literal(1),
+    runId: runIdSchema,
+    timestamp: z.string(), // ISO 8601
+    durationMs: z.number().int().nonnegative(),
+    score: z.number(),
+    pageCount: z.number().int().nonnegative(),
+    findingCount: z.number().int().nonnegative(),
+    rawFindingCount: z.number().int().nonnegative().optional(),
+    templateDetected: z.boolean().optional(),
+    cacheStats: cacheStatsSchema.optional(),
+    triage: triageTelemetrySchema.optional(),
+})
+    .strict();
+/** Feedback record — one per triage feedback event. */
+export const feedbackRecordSchema = z
+    .object({
+    type: z.literal("feedback"),
+    schemaVersion: z.literal(1),
+    runId: runIdSchema,
+    timestamp: z.string(),
+    rating: z.enum(["helpful", "unhelpful", "skipped"]),
+})
+    .strict();
+export const telemetryRecordSchema = z.discriminatedUnion("type", [
+    auditRecordSchema,
+    feedbackRecordSchema,
+]);
+/**
+ * Generate a 16-char lowercase hex runId. Used to correlate an audit record
+ * with any later feedback records for the same run.
+ */
+export function generateRunId() {
+    return crypto.randomBytes(8).toString("hex");
+}
+//# sourceMappingURL=types.js.map

package/dist/telemetry/types.js.map

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

package/dist/telemetry/writer.d.ts

@@ -0,0 +1,12 @@
+import { type TelemetryRecord } from "./types.js";
+/**
+ * Append a single telemetry record as one JSON line.
+ *
+ * Telemetry MUST NEVER throw to the caller — an audit must not fail because a
+ * log line could not be written. We swallow both I/O errors (expected, e.g.
+ * read-only filesystem, path clash) and schema errors (a programmer bug where
+ * an internal caller passed the wrong shape). Schema bugs log a single warning
+ * to stderr so they remain discoverable.
+ */
+export declare function appendTelemetryRecord(path: string, record: TelemetryRecord): Promise<void>;
+//# sourceMappingURL=writer.d.ts.map

package/dist/telemetry/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/telemetry/writer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAEzE;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/telemetry/writer.js

@@ -0,0 +1,38 @@
+import { appendFile, mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+import { telemetryRecordSchema } from "./types.js";
+/**
+ * Append a single telemetry record as one JSON line.
+ *
+ * Telemetry MUST NEVER throw to the caller — an audit must not fail because a
+ * log line could not be written. We swallow both I/O errors (expected, e.g.
+ * read-only filesystem, path clash) and schema errors (a programmer bug where
+ * an internal caller passed the wrong shape). Schema bugs log a single warning
+ * to stderr so they remain discoverable.
+ */
+export async function appendTelemetryRecord(path, record) {
+    let serialized;
+    try {
+        const parsed = telemetryRecordSchema.parse(record);
+        serialized = JSON.stringify(parsed) + "\n";
+    }
+    catch (err) {
+        // Programmer bug: invalid record shape. Warn once and bail — don't throw.
+        try {
+            // eslint-disable-next-line no-console
+            console.warn("[telemetry] refusing to write invalid record:", err instanceof Error ? err.message : String(err));
+        }
+        catch {
+            // stderr itself failed — nothing we can do.
+        }
+        return;
+    }
+    try {
+        await mkdir(dirname(path), { recursive: true });
+        await appendFile(path, serialized, "utf8");
+    }
+    catch {
+        // Silent failure — telemetry MUST NOT block an audit.
+    }
+}
+//# sourceMappingURL=writer.js.map

package/dist/telemetry/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../src/telemetry/writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAwB,MAAM,YAAY,CAAC;AAEzE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,IAAY,EACZ,MAAuB;IAEvB,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACnD,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,0EAA0E;QAC1E,IAAI,CAAC;YACH,sCAAsC;YACtC,OAAO,CAAC,IAAI,CACV,+CAA+C,EAC/C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACjD,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;QAC9C,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,sDAAsD;IACxD,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -59,6 +59,61 @@ export interface CategoryScores {
     schema: number;
     cannibal: number;
 }
+/** Options for HTTP caching during audits. */
+export interface CacheOptions {
+    /** Directory to store cache files. Default: `.pseolint/cache/`. */
+    dir?: string;
+    /** TTL for entries without ETag/Last-Modified validators. Default: 7 days. */
+    ttlMs?: number;
+}
+/** Cache stats reported at end of audit. */
+export interface CacheStats {
+    hits: number;
+    total: number;
+    bytesSavedEstimate: number;
+}
+/** Options for run state persistence. */
+export interface StateOptions {
+    /** Path to state file. Default: `.pseolint/state.json`. */
+    path?: string;
+    /** If true, audit only URLs with changed/new contentHash since prior state. */
+    since?: boolean;
+    /** If true, exit non-zero when a new rule ID fires on any URL vs prior state. */
+    exitOnRegression?: boolean;
+}
+/** Options for local-only telemetry JSONL output. */
+export interface TelemetryOptions {
+    /** Enable telemetry write at end of audit. Default: false. */
+    enabled?: boolean;
+    /** Path to JSONL file. Default: `.pseolint/telemetry.jsonl`. */
+    path?: string;
+    /** Show y/n/skip feedback prompt after triage on TTY. Default: true (when telemetry enabled). */
+    prompt?: boolean;
+    /** Non-interactive feedback rating — bypasses the prompt (useful in CI). */
+    feedback?: "helpful" | "unhelpful";
+}
+/** Options for AI triage post-processing. */
+export interface AiOptions {
+    enabled?: boolean;
+    /** Provider id, e.g. "anthropic" | "openai" | "google" | "ollama". Any string resolved against the adapter registry. */
+    provider?: string;
+    model?: string;
+    /** Only meaningful for Ollama. Ignored by cloud providers. */
+    endpoint?: string;
+    apiKey?: string;
+    maxInputTokens?: number;
+    maxOutputTokens?: number;
+    /** Max estimated USD cost per triage call. Call is refused pre-flight if exceeded. When undefined, no cap. */
+    maxCostUsd?: number;
+    /** Max estimated USD spent on successful triages per UTC day (read from telemetry). Requires telemetry.enabled. */
+    dailyBudgetUsd?: number;
+    /** Print one-line discovery hint when an AI key is detected but --ai is not set. Default: true. */
+    suggest?: boolean;
+    cache?: {
+        ttlMs?: number;
+        dir?: string;
+    } | false;
+}
 export interface AuditSummary {
     score: number;
     categoryScores: CategoryScores;
@@ -70,6 +125,14 @@ export interface AuditSummary {
     templateDetected?: boolean;
     /** Pre-enrichment finding count, for backward compatibility with CI scripts. */
     rawFindingCount?: number;
+    /** Cache statistics when caching is enabled. */
+    cacheStats?: CacheStats;
+    /** True when --exit-on-regression detected a new rule ID vs prior state. */
+    hasRegression?: boolean;
+    /** URLs that were skipped because their contentHash matched prior state. */
+    skippedUrls?: string[];
+    /** AI triage result when AI is enabled and call succeeded. */
+    triage?: import("./ai/types.js").TriageResult;
 }
 export interface PageGroupConfig {
     /** Glob pattern(s) to match page URLs/paths. */
@@ -118,6 +181,39 @@ export interface AuditOptions {
     };
     /** Override template auto-detection. When set, skips heuristic detection. */
     templateGenerated?: boolean;
+    /** Custom entity mask patterns. Merged with defaults (US states, ZIP codes). Set to empty array to disable defaults. */
+    entityPatterns?: Array<{
+        placeholder: string;
+        pattern: string;
+        flags?: string;
+    }>;
+    /** Source data records for data-binding verification. */
+    dataSource?: DataSourceOptions;
+    /** HTTP cache configuration. When omitted, caching is disabled. */
+    cache?: CacheOptions;
+    /** Sampling strategy when sampleSize < total pages. Default: "stratified". */
+    samplingStrategy?: SamplingStrategy;
+    /** Max samples per inferred URL template cluster. Caps per-cluster allocation. */
+    maxPerTemplate?: number;
+    /** Run state persistence. When omitted, no state is written. */
+    state?: StateOptions;
+    /** AI triage options. When omitted or `enabled: false`, no AI is invoked. */
+    ai?: AiOptions;
+    /** Local-only telemetry (JSONL) options. When omitted or `enabled: false`, no records are written. */
+    telemetry?: TelemetryOptions;
+}
+export type SamplingStrategy = "stratified" | "random";
+/** A single page's source data for data-source comparison. */
+export interface PageDataRecord {
+    /** URL or path pattern to match against audited pages. Supports globs. */
+    url: string;
+    /** Key-value data that should appear on the rendered page. */
+    data: Record<string, unknown>;
+}
+/** Options for data-source comparison rules. */
+export interface DataSourceOptions {
+    /** Path to JSON file or inline array of page data records. */
+    records: PageDataRecord[];
 }
 export interface EntityMaskPattern {
     placeholder: string;

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pseolint/core",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Programmatic SEO audit engine — 34 rules across 6 categories for SpamBrain risk detection",
   "license": "MIT",
   "author": "Ouranos Labs <contact@ouranos-labs.dev>",
@@ -33,14 +33,34 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "cheerio": "^1.2.0"
+    "ai": "^5.0.0",
+    "cheerio": "^1.2.0",
+    "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "playwright-core": ">=1.40.0"
+    "playwright-core": ">=1.40.0",
+    "@ai-sdk/anthropic": "^2.0.0",
+    "@ai-sdk/openai": "^2.0.0",
+    "@ai-sdk/google": "^2.0.0",
+    "@ai-sdk/mistral": "^2.0.0",
+    "@ai-sdk/groq": "^2.0.0",
+    "@ai-sdk/xai": "^2.0.0",
+    "@ai-sdk/cohere": "^2.0.0",
+    "ollama-ai-provider-v2": "^1.0.0"
   },
   "peerDependenciesMeta": {
-    "playwright-core": {
-      "optional": true
-    }
+    "playwright-core": { "optional": true },
+    "@ai-sdk/anthropic": { "optional": true },
+    "@ai-sdk/openai": { "optional": true },
+    "@ai-sdk/google": { "optional": true },
+    "@ai-sdk/mistral": { "optional": true },
+    "@ai-sdk/groq": { "optional": true },
+    "@ai-sdk/xai": { "optional": true },
+    "@ai-sdk/cohere": { "optional": true },
+    "ollama-ai-provider-v2": { "optional": true }
+  },
+  "devDependencies": {
+    "@ai-sdk/anthropic": "^2.0.0",
+    "ollama-ai-provider-v2": "^1.0.0"
   }
 }

package/dist/algorithms/entity-mask.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=entity-mask.test.d.ts.map

package/dist/algorithms/entity-mask.test.d.ts.map

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

package/dist/algorithms/entity-mask.test.js

@@ -1,23 +0,0 @@
-import { describe, expect, test } from "vitest";
-import { maskEntities } from "./entity-mask.js";
-describe("entity masking", () => {
-    test("replaces matched entities with placeholders", () => {
-        const input = "Form your California LLC in Los Angeles with zip 90210.";
-        const output = maskEntities(input, [
-            { placeholder: "[STATE]", pattern: /\bCalifornia\b/gi },
-            { placeholder: "[CITY]", pattern: /\bLos Angeles\b/gi },
-            { placeholder: "[ZIP]", pattern: /\b\d{5}\b/g }
-        ]);
-        expect(output).toContain("[STATE]");
-        expect(output).toContain("[CITY]");
-        expect(output).toContain("[ZIP]");
-        expect(output).not.toContain("California");
-        expect(output).not.toContain("90210");
-    });
-    test("replaces all occurrences even if regex is not global", () => {
-        const input = "California LLC filing in California has California-specific rules.";
-        const output = maskEntities(input, [{ placeholder: "[STATE]", pattern: /\bCalifornia\b/i }]);
-        expect(output).toBe("[STATE] LLC filing in [STATE] has [STATE]-specific rules.");
-    });
-});
-//# sourceMappingURL=entity-mask.test.js.map

package/dist/algorithms/entity-mask.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"entity-mask.test.js","sourceRoot":"","sources":["../../src/algorithms/entity-mask.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACvD,MAAM,KAAK,GAAG,yDAAyD,CAAC;QACxE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE;YACjC,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,EAAE;YACvD,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,mBAAmB,EAAE;YACvD,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;SAChD,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAChE,MAAM,KAAK,GAAG,oEAAoE,CAAC;QACnF,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC;QAE7F,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/algorithms/simhash.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=simhash.test.d.ts.map

package/dist/algorithms/simhash.test.d.ts.map

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

package/dist/algorithms/simhash.test.js

@@ -1,23 +0,0 @@
-import { describe, expect, test } from "vitest";
-import { hammingDistance, simHashFromText, similarityFromDistance } from "./simhash.js";
-describe("simhash", () => {
-    test("returns same fingerprint for identical text", () => {
-        const a = simHashFromText("california llc filing requirements and annual fees");
-        const b = simHashFromText("california llc filing requirements and annual fees");
-        expect(a).toBe(b);
-        expect(hammingDistance(a, b)).toBe(0);
-        expect(similarityFromDistance(0)).toBe(1);
-    });
-    test("returns lower similarity for different text", () => {
-        const a = simHashFromText("california llc filing requirements and annual fees");
-        const b = simHashFromText("best sourdough starter hydration and oven spring tips");
-        const distance = hammingDistance(a, b);
-        expect(distance).toBeGreaterThan(10);
-        expect(similarityFromDistance(distance)).toBeLessThan(0.85);
-    });
-    test("returns neutral fingerprint for empty input", () => {
-        const fingerprint = simHashFromText("   ");
-        expect(fingerprint).toBe(0n);
-    });
-});
-//# sourceMappingURL=simhash.test.js.map

package/dist/algorithms/simhash.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"simhash.test.js","sourceRoot":"","sources":["../../src/algorithms/simhash.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAExF,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,GAAG,eAAe,CAAC,oDAAoD,CAAC,CAAC;QAChF,MAAM,CAAC,GAAG,eAAe,CAAC,oDAAoD,CAAC,CAAC;QAEhF,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,MAAM,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,GAAG,eAAe,CAAC,oDAAoD,CAAC,CAAC;QAChF,MAAM,CAAC,GAAG,eAAe,CAAC,uDAAuD,CAAC,CAAC;QAEnF,MAAM,QAAQ,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvC,MAAM,CAAC,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QACrC,MAAM,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACvD,MAAM,WAAW,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/auditor.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=auditor.test.d.ts.map

package/dist/auditor.test.d.ts.map

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