plainstamp 0.0.1

package/dist/watcher/cli.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+/**
+ * plainstamp-watcher — runs all configured regulatory-update sources,
+ * compares against persisted state, and emits a JSON digest of new articles
+ * to stdout.
+ *
+ * Usage:
+ *   plainstamp-watcher [--state path/to/watcher-state.json] [--dry-run]
+ *
+ * Defaults: state file at <cwd>/watcher-state.json. Designed to be run
+ * periodically (cron, GitHub Actions, etc.) — each run records what it saw,
+ * and only newly-appeared articles are emitted.
+ */
+import { parseArgs } from "node:util";
+import { join } from "node:path";
+import { runWatcher } from "./index.js";
+import { federalRegisterSource } from "./sources/federal-register.js";
+import { rulesCitationsUrlMonitor } from "./sources/url-monitor.js";
+const { values } = parseArgs({
+    options: {
+        state: { type: "string" },
+        "dry-run": { type: "boolean" },
+    },
+    strict: true,
+});
+const statePath = values.state ?? join(process.cwd(), "watcher-state.json");
+const sources = [
+    federalRegisterSource({ searchTerm: "artificial intelligence" }),
+    federalRegisterSource({ searchTerm: "automated decision" }),
+    federalRegisterSource({ searchTerm: "algorithmic" }),
+    rulesCitationsUrlMonitor(),
+];
+const report = await runWatcher({
+    sources,
+    statePath,
+    ...(values["dry-run"] === true ? { dryRun: true } : {}),
+});
+const totalNew = report.sources.reduce((n, s) => n + s.new_articles.length, 0);
+console.log(JSON.stringify({
+    run_at: report.run_at,
+    state_path: statePath,
+    dry_run: values["dry-run"] === true,
+    total_new_articles: totalNew,
+    sources: report.sources,
+}, null, 2));
+process.exit(report.sources.some((s) => !s.ok) ? 1 : 0);
+//# sourceMappingURL=cli.js.map

package/dist/watcher/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/watcher/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE;QACP,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;KAC/B;IACD,MAAM,EAAE,IAAI;CACb,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,oBAAoB,CAAC,CAAC;AAE5E,MAAM,OAAO,GAAG;IACd,qBAAqB,CAAC,EAAE,UAAU,EAAE,yBAAyB,EAAE,CAAC;IAChE,qBAAqB,CAAC,EAAE,UAAU,EAAE,oBAAoB,EAAE,CAAC;IAC3D,qBAAqB,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;IACpD,wBAAwB,EAAE;CAC3B,CAAC;AAEF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;IAC9B,OAAO;IACP,SAAS;IACT,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;CACxD,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CACpC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,EACnC,CAAC,CACF,CAAC;AAEF,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;IACE,MAAM,EAAE,MAAM,CAAC,MAAM;IACrB,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,KAAK,IAAI;IACnC,kBAAkB,EAAE,QAAQ;IAC5B,OAAO,EAAE,MAAM,CAAC,OAAO;CACxB,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;AAEF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/watcher/index.d.ts

@@ -0,0 +1,23 @@
+import type { Article, RunReport, Source, SourceRunReport, WatcherState } from "./types.js";
+/**
+ * Computes the new articles for a source — those whose ids do not appear in
+ * `seen`. Returns the articles in fetched-order. Pure function; safe to test.
+ */
+export declare function diffArticles(fetched: Article[], seen: string[]): Article[];
+/**
+ * Runs all sources, computes the diff against persisted state, returns a
+ * report, and updates the state file with the union of (previously seen) ∪
+ * (newly fetched ids). Source fetch failures are caught and reported per-
+ * source; one failing source does not abort the run.
+ */
+export declare function runWatcher(opts: {
+    sources: Source[];
+    statePath: string;
+    /** If true, do NOT persist the new state (useful for dry-run inspection). */
+    dryRun?: boolean;
+}): Promise<RunReport>;
+export type { Article, Source, RunReport, SourceRunReport, WatcherState };
+export { readState, writeState } from "./state-store.js";
+export { federalRegisterSource } from "./sources/federal-register.js";
+export { urlMonitorSource, rulesCitationsUrlMonitor, hashContent, } from "./sources/url-monitor.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/watcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,SAAS,EACT,MAAM,EACN,eAAe,EACf,YAAY,EACb,MAAM,YAAY,CAAC;AAGpB;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAO1E;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC,SAAS,CAAC,CAiDrB;AAED,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,WAAW,GACZ,MAAM,0BAA0B,CAAC"}

package/dist/watcher/index.js

@@ -0,0 +1,71 @@
+import { readState, writeState } from "./state-store.js";
+/**
+ * Computes the new articles for a source — those whose ids do not appear in
+ * `seen`. Returns the articles in fetched-order. Pure function; safe to test.
+ */
+export function diffArticles(fetched, seen) {
+    const seenSet = new Set(seen);
+    const out = [];
+    for (const a of fetched) {
+        if (!seenSet.has(a.id))
+            out.push(a);
+    }
+    return out;
+}
+/**
+ * Runs all sources, computes the diff against persisted state, returns a
+ * report, and updates the state file with the union of (previously seen) ∪
+ * (newly fetched ids). Source fetch failures are caught and reported per-
+ * source; one failing source does not abort the run.
+ */
+export async function runWatcher(opts) {
+    const state = readState(opts.statePath);
+    const now = new Date().toISOString();
+    const sourceReports = [];
+    for (const source of opts.sources) {
+        const prev = state.sources[source.id] ?? { seen: [], lastRunAt: null };
+        let articles = [];
+        let errMsg;
+        try {
+            articles = await source.fetch();
+        }
+        catch (err) {
+            errMsg = err.message;
+        }
+        if (errMsg !== undefined) {
+            sourceReports.push({
+                source_id: source.id,
+                description: source.description,
+                ok: false,
+                error: errMsg,
+                new_articles: [],
+                total_seen: prev.seen.length,
+            });
+            continue;
+        }
+        const newArticles = diffArticles(articles, prev.seen);
+        sourceReports.push({
+            source_id: source.id,
+            description: source.description,
+            ok: true,
+            new_articles: newArticles,
+            total_seen: prev.seen.length + newArticles.length,
+        });
+        if (!opts.dryRun) {
+            const merged = new Set(prev.seen);
+            for (const a of articles)
+                merged.add(a.id);
+            state.sources[source.id] = {
+                seen: [...merged],
+                lastRunAt: now,
+            };
+        }
+    }
+    if (!opts.dryRun)
+        writeState(opts.statePath, state);
+    return { run_at: now, sources: sourceReports };
+}
+export { readState, writeState } from "./state-store.js";
+export { federalRegisterSource } from "./sources/federal-register.js";
+export { urlMonitorSource, rulesCitationsUrlMonitor, hashContent, } from "./sources/url-monitor.js";
+//# sourceMappingURL=index.js.map

package/dist/watcher/index.js.map

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

package/dist/watcher/sources/federal-register.d.ts

@@ -0,0 +1,13 @@
+import type { Source } from "../types.js";
+/**
+ * Federal Register source. Fetches recent rules and proposed rules matching
+ * a search term (default: "artificial intelligence"). The Federal Register
+ * search is permissive — results often include items only tangentially
+ * related — so the orchestrator should treat new articles as candidates for
+ * review rather than guaranteed plainstamp-relevant updates.
+ */
+export declare function federalRegisterSource(opts?: {
+    searchTerm?: string;
+    perPage?: number;
+}): Source;
+//# sourceMappingURL=federal-register.d.ts.map

package/dist/watcher/sources/federal-register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federal-register.d.ts","sourceRoot":"","sources":["../../../src/watcher/sources/federal-register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,MAAM,EAAE,MAAM,aAAa,CAAC;AAmBnD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAsCT"}

package/dist/watcher/sources/federal-register.js

@@ -0,0 +1,44 @@
+const ENDPOINT = "https://www.federalregister.gov/api/v1/articles.json";
+/**
+ * Federal Register source. Fetches recent rules and proposed rules matching
+ * a search term (default: "artificial intelligence"). The Federal Register
+ * search is permissive — results often include items only tangentially
+ * related — so the orchestrator should treat new articles as candidates for
+ * review rather than guaranteed plainstamp-relevant updates.
+ */
+export function federalRegisterSource(opts) {
+    const term = opts?.searchTerm ?? "artificial intelligence";
+    const perPage = opts?.perPage ?? 20;
+    const id = `federal-register-${term.replace(/[^a-z0-9]+/gi, "-").toLowerCase()}`;
+    return {
+        id,
+        description: `Federal Register articles (Rules and Proposed Rules) matching "${term}"`,
+        async fetch() {
+            const url = new URL(ENDPOINT);
+            url.searchParams.set("conditions[term]", term);
+            url.searchParams.append("conditions[type][]", "RULE");
+            url.searchParams.append("conditions[type][]", "PRORULE");
+            url.searchParams.set("per_page", String(perPage));
+            url.searchParams.set("order", "newest");
+            const res = await fetch(url.toString());
+            if (!res.ok) {
+                throw new Error(`Federal Register API returned HTTP ${res.status} for ${url.toString()}`);
+            }
+            const json = (await res.json());
+            return json.results.map((r) => ({
+                id: r.document_number,
+                title: r.title,
+                url: r.html_url,
+                publishedAt: r.publication_date,
+                ...(r.abstract !== null && r.abstract !== undefined
+                    ? { summary: r.abstract }
+                    : {}),
+                ...(r.agencies !== undefined
+                    ? { agencies: r.agencies.map((a) => a.name) }
+                    : {}),
+                extra: { type: r.type },
+            }));
+        },
+    };
+}
+//# sourceMappingURL=federal-register.js.map

package/dist/watcher/sources/federal-register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"federal-register.js","sourceRoot":"","sources":["../../../src/watcher/sources/federal-register.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG,sDAAsD,CAAC;AAiBxE;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAGrC;IACC,MAAM,IAAI,GAAG,IAAI,EAAE,UAAU,IAAI,yBAAyB,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC;IACpC,MAAM,EAAE,GAAG,oBAAoB,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;IAEjF,OAAO;QACL,EAAE;QACF,WAAW,EAAE,kEAAkE,IAAI,GAAG;QACtF,KAAK,CAAC,KAAK;YACT,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC9B,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;YAC/C,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;YACtD,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAAC;YACzD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YAClD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAExC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;YACxC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CACb,sCAAsC,GAAG,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,EAAE,CACzE,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAe,CAAC;YAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9B,EAAE,EAAE,CAAC,CAAC,eAAe;gBACrB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,GAAG,EAAE,CAAC,CAAC,QAAQ;gBACf,WAAW,EAAE,CAAC,CAAC,gBAAgB;gBAC/B,GAAG,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS;oBACjD,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;oBACzB,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS;oBAC1B,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE;oBAC7C,CAAC,CAAC,EAAE,CAAC;gBACP,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;aACxB,CAAC,CAAC,CAAC;QACN,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/watcher/sources/url-monitor.d.ts

@@ -0,0 +1,33 @@
+import type { Source } from "../types.js";
+/**
+ * Generic URL-monitor source. Fetches a list of URLs, computes a content
+ * hash for each, and emits an article per URL whose id is `${url}#${hash}`.
+ * When a URL's content changes, the hash changes, and the new id appears as
+ * a "new article" in the diff against persisted state.
+ *
+ * Use this for tracking regulator-published source pages that don't have a
+ * dedicated API or RSS feed. Failures fetching individual URLs are isolated
+ * — one bad URL does not abort the run.
+ */
+export declare function urlMonitorSource(opts: {
+    id: string;
+    description: string;
+    urls: string[];
+    /** Optional fetch shim for testing. Defaults to global fetch. */
+    fetcher?: typeof fetch;
+}): Source;
+/**
+ * Convenience: a source that monitors every bundled rule's `citation.source_url`.
+ * When any cited statute or regulation page changes content, the next watcher
+ * run surfaces the URL as a "new" article and the agent flags the corresponding
+ * rule's `last_verified` as potentially stale.
+ *
+ * Deduplicates URLs (the same source_url could be cited by multiple rules; we
+ * fetch each unique URL once).
+ */
+export declare function rulesCitationsUrlMonitor(opts?: {
+    fetcher?: typeof fetch;
+}): Source;
+/** Internal: SHA-256 content hash truncated to 16 hex chars (64 bits) — collision-resistant for change detection at this scale. */
+export declare function hashContent(text: string): string;
+//# sourceMappingURL=url-monitor.d.ts.map

package/dist/watcher/sources/url-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-monitor.d.ts","sourceRoot":"","sources":["../../../src/watcher/sources/url-monitor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAW,MAAM,EAAE,MAAM,aAAa,CAAC;AAGnD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB,GAAG,MAAM,CA6BT;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,CAAC,EAAE;IAC9C,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB,GAAG,MAAM,CAUT;AAED,mIAAmI;AACnI,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/watcher/sources/url-monitor.js

@@ -0,0 +1,67 @@
+import { createHash } from "node:crypto";
+import { loadBundledRules } from "../../rules-loader.js";
+/**
+ * Generic URL-monitor source. Fetches a list of URLs, computes a content
+ * hash for each, and emits an article per URL whose id is `${url}#${hash}`.
+ * When a URL's content changes, the hash changes, and the new id appears as
+ * a "new article" in the diff against persisted state.
+ *
+ * Use this for tracking regulator-published source pages that don't have a
+ * dedicated API or RSS feed. Failures fetching individual URLs are isolated
+ * — one bad URL does not abort the run.
+ */
+export function urlMonitorSource(opts) {
+    const fetcher = opts.fetcher ?? fetch;
+    const today = () => new Date().toISOString().slice(0, 10);
+    return {
+        id: opts.id,
+        description: opts.description,
+        async fetch() {
+            const articles = [];
+            for (const url of opts.urls) {
+                try {
+                    const res = await fetcher(url, { redirect: "follow" });
+                    if (!res.ok)
+                        continue;
+                    const text = await res.text();
+                    const hash = hashContent(text);
+                    articles.push({
+                        id: `${url}#${hash}`,
+                        title: url,
+                        url,
+                        publishedAt: today(),
+                        extra: { content_hash: hash, content_length: text.length },
+                    });
+                }
+                catch {
+                    // Transient fetch failure — skip this URL for this run, try again next time.
+                }
+            }
+            return articles;
+        },
+    };
+}
+/**
+ * Convenience: a source that monitors every bundled rule's `citation.source_url`.
+ * When any cited statute or regulation page changes content, the next watcher
+ * run surfaces the URL as a "new" article and the agent flags the corresponding
+ * rule's `last_verified` as potentially stale.
+ *
+ * Deduplicates URLs (the same source_url could be cited by multiple rules; we
+ * fetch each unique URL once).
+ */
+export function rulesCitationsUrlMonitor(opts) {
+    const rules = loadBundledRules();
+    const urls = [...new Set(rules.rules.map((r) => r.citation.source_url))];
+    return urlMonitorSource({
+        id: "rules-citation-urls",
+        description: "Hash-based change detection on every bundled rule's citation source URL. Surfaces a new article when any cited regulator-published page's content has changed since the last successful run.",
+        urls,
+        ...(opts?.fetcher !== undefined ? { fetcher: opts.fetcher } : {}),
+    });
+}
+/** Internal: SHA-256 content hash truncated to 16 hex chars (64 bits) — collision-resistant for change detection at this scale. */
+export function hashContent(text) {
+    return createHash("sha256").update(text).digest("hex").slice(0, 16);
+}
+//# sourceMappingURL=url-monitor.js.map

package/dist/watcher/sources/url-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-monitor.js","sourceRoot":"","sources":["../../../src/watcher/sources/url-monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAMhC;IACC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC;IACtC,MAAM,KAAK,GAAG,GAAW,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAElE,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,KAAK,CAAC,KAAK;YACT,MAAM,QAAQ,GAAc,EAAE,CAAC;YAC/B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,CAAC;oBACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;oBACvD,IAAI,CAAC,GAAG,CAAC,EAAE;wBAAE,SAAS;oBACtB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;oBAC9B,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;oBAC/B,QAAQ,CAAC,IAAI,CAAC;wBACZ,EAAE,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE;wBACpB,KAAK,EAAE,GAAG;wBACV,GAAG;wBACH,WAAW,EAAE,KAAK,EAAE;wBACpB,KAAK,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,MAAM,EAAE;qBAC3D,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,6EAA6E;gBAC/E,CAAC;YACH,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAExC;IACC,MAAM,KAAK,GAAG,gBAAgB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACzE,OAAO,gBAAgB,CAAC;QACtB,EAAE,EAAE,qBAAqB;QACzB,WAAW,EACT,8LAA8L;QAChM,IAAI;QACJ,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClE,CAAC,CAAC;AACL,CAAC;AAED,mIAAmI;AACnI,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/dist/watcher/state-store.d.ts

@@ -0,0 +1,9 @@
+import type { WatcherState } from "./types.js";
+/**
+ * Reads the watcher state from `path`. If the file does not exist, returns a
+ * fresh empty state. The state file is plain JSON — the agent can read it
+ * directly to inspect what has been seen across runs.
+ */
+export declare function readState(path: string): WatcherState;
+export declare function writeState(path: string, state: WatcherState): void;
+//# sourceMappingURL=state-store.d.ts.map

package/dist/watcher/state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../../src/watcher/state-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAYpD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAGlE"}

package/dist/watcher/state-store.js

@@ -0,0 +1,23 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+/**
+ * Reads the watcher state from `path`. If the file does not exist, returns a
+ * fresh empty state. The state file is plain JSON — the agent can read it
+ * directly to inspect what has been seen across runs.
+ */
+export function readState(path) {
+    if (!existsSync(path)) {
+        return { schema_version: 1, sources: {} };
+    }
+    const raw = readFileSync(path, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (parsed.schema_version !== 1) {
+        throw new Error(`Unknown watcher-state schema_version: ${parsed.schema_version}. Expected 1.`);
+    }
+    return parsed;
+}
+export function writeState(path, state) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(state, null, 2) + "\n", "utf-8");
+}
+//# sourceMappingURL=state-store.js.map

package/dist/watcher/state-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.js","sourceRoot":"","sources":["../../src/watcher/state-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC5C,CAAC;IACD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IAC/C,IAAI,MAAM,CAAC,cAAc,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,yCAAyC,MAAM,CAAC,cAAc,eAAe,CAC9E,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAmB;IAC1D,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC"}

package/dist/watcher/types.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Regulatory-update watcher types.
+ *
+ * The watcher polls public regulator feeds for new AI-relevant rules, compares
+ * what it sees against a persisted "last seen" snapshot, and emits a digest
+ * of new documents. This is the moat for plainstamp — the bundled rules in
+ * `rules/seed.json` need ongoing maintenance, and this watcher surfaces the
+ * documents that may justify a rule addition or `last_verified` bump.
+ *
+ * Sources are pluggable. Each source exposes a stable id, a fetch function
+ * that returns a list of `Article`s, and a description for human auditors.
+ */
+export interface Article {
+    /** Stable identifier the source uses for this document (e.g. Federal Register `document_number`). */
+    id: string;
+    /** Human-readable title of the document. */
+    title: string;
+    /** Publisher's canonical URL for the document. */
+    url: string;
+    /** YYYY-MM-DD publication date. */
+    publishedAt: string;
+    /** Free-form summary the source provides (abstract, summary, first paragraph, etc.). */
+    summary?: string;
+    /** Names of the issuing agencies / publishers, where the source provides them. */
+    agencies?: string[];
+    /** Anything else the source returns that an auditor might want to inspect. */
+    extra?: Record<string, unknown>;
+}
+export interface Source {
+    /** Stable id used as the key in the state store. Lowercase kebab-case. */
+    id: string;
+    /** Human-readable description for the audit log. */
+    description: string;
+    /** Fetches recent articles from the regulator. May throw on transient network failure; the orchestrator catches and skips. */
+    fetch: () => Promise<Article[]>;
+}
+export interface SourceState {
+    /** IDs of articles seen in prior runs. */
+    seen: string[];
+    /** Timestamp of the last successful run for this source. */
+    lastRunAt: string | null;
+}
+export interface WatcherState {
+    schema_version: 1;
+    sources: Record<string, SourceState>;
+}
+export interface SourceRunReport {
+    source_id: string;
+    description: string;
+    ok: boolean;
+    error?: string;
+    new_articles: Article[];
+    total_seen: number;
+}
+export interface RunReport {
+    run_at: string;
+    sources: SourceRunReport[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/watcher/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,OAAO;IACtB,qGAAqG;IACrG,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,MAAM;IACrB,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,8HAA8H;IAC9H,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,4DAA4D;IAC5D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,CAAC,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B"}

package/dist/watcher/types.js

@@ -0,0 +1,14 @@
+/**
+ * Regulatory-update watcher types.
+ *
+ * The watcher polls public regulator feeds for new AI-relevant rules, compares
+ * what it sees against a persisted "last seen" snapshot, and emits a digest
+ * of new documents. This is the moat for plainstamp — the bundled rules in
+ * `rules/seed.json` need ongoing maintenance, and this watcher surfaces the
+ * documents that may justify a rule addition or `last_verified` bump.
+ *
+ * Sources are pluggable. Each source exposes a stable id, a fetch function
+ * that returns a list of `Article`s, and a description for human auditors.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/watcher/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/watcher/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "plainstamp",
+  "version": "0.0.1",
+  "description": "AI disclosure compliance assistant — generates legally-grounded AI disclosure text per (jurisdiction × channel × use-case) and tracks regulatory updates. Operated by an autonomous AI agent under KS Elevated Solutions LLC.",
+  "type": "module",
+  "license": "MIT",
+  "author": "plainstamp (operated by KS Elevated Solutions LLC)",
+  "bugs": {
+    "email": "helpfulbutton140@agentmail.to"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "plainstamp": "dist/cli.js",
+    "plainstamp-watcher": "dist/watcher/cli.js"
+  },
+  "files": [
+    "dist",
+    "rules",
+    "README.md",
+    "AI-DISCLOSURE.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "tsx --test \"src/**/*.test.ts\"",
+    "test:watch": "tsx --test --watch \"src/**/*.test.ts\"",
+    "lint": "tsc --noEmit",
+    "mcp": "node dist/mcp-server.js",
+    "cli": "node dist/cli.js",
+    "prepublishOnly": "npm run lint && npm run test && npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai-disclosure",
+    "compliance",
+    "ccpa",
+    "eu-ai-act",
+    "ftc",
+    "agent",
+    "autonomous-ai"
+  ]
+}