@cyanheads/congressgov-mcp-server 0.3.31 → 0.4.0

package/dist/services/congress-mirror/congress-mirror-service.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview Congress bill mirror service — the read path over the local
+ * SQLite FTS index of Congress.gov bills. Built on the framework MirrorService:
+ * owns the store + ingester, exposes the mirror instance to the lifecycle CLI and
+ * the refresh scheduler, and translates the search tool's query grammar into an
+ * FTS5 `MATCH` + indexed filters. There is no live-API fallback — keyword search
+ * is the entire point — so a cold mirror is a readiness signal the caller turns
+ * into an empty result + notice, never a throw.
+ * @module services/congress-mirror/congress-mirror-service
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import { type Mirror } from '@cyanheads/mcp-ts-core/mirror';
+import { type MirrorApi } from './ingest.js';
+import type { SearchBillsFilters, SearchBillsPage } from './types.js';
+/** Options for constructing the mirror service. */
+export interface CongressMirrorOptions {
+    /** Congress numbers to mirror. */
+    congresses: number[];
+    /** API accessor override — defaults to the shared `CongressApiService` singleton. */
+    getApi?: () => MirrorApi;
+    /** Filesystem path to the SQLite mirror index. */
+    mirrorPath: string;
+}
+export declare class CongressMirrorService {
+    private readonly mirror;
+    constructor(options: CongressMirrorOptions);
+    /** The underlying mirror — exposed for the lifecycle CLI and the refresh scheduler. */
+    get mirrorInstance(): Mirror;
+    /** `true` once a full sync has ever completed (queryable even mid-refresh). */
+    ready(): Promise<boolean>;
+    /**
+     * Keyword-search the mirror. The query is tokenized and each token individually
+     * quoted before the FTS5 `MATCH` is built; an input with no searchable tokens
+     * yields an empty page rather than a thrown query. Optional exact-match filters
+     * ride the indexed columns; results are BM25-ranked.
+     */
+    search(filters: SearchBillsFilters, ctx: Context): Promise<SearchBillsPage>;
+}
+/** Initialize the mirror service. Call once in `createApp`'s `setup()` (when enabled). */
+export declare function initCongressMirror(options: CongressMirrorOptions): CongressMirrorService;
+/** Access the initialized mirror service. */
+export declare function getCongressMirror(): CongressMirrorService;
+/** Reset the singleton — test-only. */
+export declare function resetCongressMirror(): void;
+//# sourceMappingURL=congress-mirror-service.d.ts.map

package/dist/services/congress-mirror/congress-mirror-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"congress-mirror-service.d.ts","sourceRoot":"","sources":["../../../src/services/congress-mirror/congress-mirror-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAEL,KAAK,MAAM,EAIZ,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,KAAK,EAAoB,kBAAkB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAKxF,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,SAAS,CAAC;IACzB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;CACpB;AAwBD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,EAAE,qBAAqB;IAY1C,uFAAuF;IACvF,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,+EAA+E;IAC/E,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAIzB;;;;;OAKG;IACG,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;CAuClF;AAMD,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,qBAAqB,GAAG,qBAAqB,CAGxF;AAED,6CAA6C;AAC7C,wBAAgB,iBAAiB,IAAI,qBAAqB,CAOzD;AAED,uCAAuC;AACvC,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/services/congress-mirror/congress-mirror-service.js

@@ -0,0 +1,116 @@
+/**
+ * @fileoverview Congress bill mirror service — the read path over the local
+ * SQLite FTS index of Congress.gov bills. Built on the framework MirrorService:
+ * owns the store + ingester, exposes the mirror instance to the lifecycle CLI and
+ * the refresh scheduler, and translates the search tool's query grammar into an
+ * FTS5 `MATCH` + indexed filters. There is no live-API fallback — keyword search
+ * is the entire point — so a cold mirror is a readiness signal the caller turns
+ * into an empty result + notice, never a throw.
+ * @module services/congress-mirror/congress-mirror-service
+ */
+import { defineMirror, sqliteMirrorStore, } from '@cyanheads/mcp-ts-core/mirror';
+import { getCongressApi } from '../../services/congress-api/congress-api-service.js';
+import { createCongressBillIngester } from './ingest.js';
+import { toFtsMatch } from './normalize.js';
+import { billStoreSpec } from './schema.js';
+/** Max stored-summary characters surfaced as a search-result preview. */
+const SUMMARY_PREVIEW_LIMIT = 400;
+/** Project a raw mirror row into a search result, truncating the summary preview. */
+function toSearchResult(row) {
+    const summary = typeof row.summary === 'string' && row.summary.trim() !== '' ? row.summary : undefined;
+    const summaryPreview = summary
+        ? summary.length > SUMMARY_PREVIEW_LIMIT
+            ? `${summary.slice(0, SUMMARY_PREVIEW_LIMIT - 1).trimEnd()}…`
+            : summary
+        : undefined;
+    return {
+        billId: String(row.billId),
+        congress: Number(row.congress),
+        billType: String(row.billType),
+        billNumber: Number(row.billNumber),
+        title: typeof row.title === 'string' ? row.title : '',
+        ...(row.originChamber ? { originChamber: String(row.originChamber) } : {}),
+        ...(row.latestActionDate ? { latestActionDate: String(row.latestActionDate) } : {}),
+        ...(row.latestActionText ? { latestActionText: String(row.latestActionText) } : {}),
+        ...(summaryPreview ? { summaryPreview } : {}),
+    };
+}
+export class CongressMirrorService {
+    mirror;
+    constructor(options) {
+        const store = sqliteMirrorStore(billStoreSpec(options.mirrorPath));
+        this.mirror = defineMirror({
+            name: 'congress-bills',
+            store,
+            sync: createCongressBillIngester(options.getApi ?? (() => getCongressApi()), options.congresses),
+        });
+    }
+    /** The underlying mirror — exposed for the lifecycle CLI and the refresh scheduler. */
+    get mirrorInstance() {
+        return this.mirror;
+    }
+    /** `true` once a full sync has ever completed (queryable even mid-refresh). */
+    ready() {
+        return this.mirror.ready();
+    }
+    /**
+     * Keyword-search the mirror. The query is tokenized and each token individually
+     * quoted before the FTS5 `MATCH` is built; an input with no searchable tokens
+     * yields an empty page rather than a thrown query. Optional exact-match filters
+     * ride the indexed columns; results are BM25-ranked.
+     */
+    async search(filters, ctx) {
+        const match = toFtsMatch(filters.query);
+        if (match === '') {
+            return { items: [], total: 0, offset: filters.offset, limit: filters.limit };
+        }
+        const structured = [];
+        if (filters.congress !== undefined) {
+            structured.push({ column: 'congress', op: 'eq', value: filters.congress });
+        }
+        if (filters.billType) {
+            structured.push({ column: 'billType', op: 'eq', value: filters.billType });
+        }
+        if (filters.originChamber) {
+            structured.push({ column: 'originChamber', op: 'eq', value: filters.originChamber });
+        }
+        ctx.log.debug('Searching bill mirror', {
+            match,
+            filters: structured.length,
+            limit: filters.limit,
+            offset: filters.offset,
+        });
+        const result = await this.mirror.query({
+            match,
+            ...(structured.length > 0 ? { filters: structured } : {}),
+            sort: 'relevance',
+            limit: filters.limit,
+            offset: filters.offset,
+        });
+        return {
+            items: result.rows.map(toSearchResult),
+            total: result.total,
+            offset: filters.offset,
+            limit: filters.limit,
+        };
+    }
+}
+// --- Init/accessor pattern ---
+let _service;
+/** Initialize the mirror service. Call once in `createApp`'s `setup()` (when enabled). */
+export function initCongressMirror(options) {
+    _service = new CongressMirrorService(options);
+    return _service;
+}
+/** Access the initialized mirror service. */
+export function getCongressMirror() {
+    if (!_service) {
+        throw new Error('CongressMirrorService not initialized — call initCongressMirror() in setup().');
+    }
+    return _service;
+}
+/** Reset the singleton — test-only. */
+export function resetCongressMirror() {
+    _service = undefined;
+}
+//# sourceMappingURL=congress-mirror-service.js.map

package/dist/services/congress-mirror/congress-mirror-service.js.map

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

package/dist/services/congress-mirror/ingest.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @fileoverview The Congress bill ingester — the one irreducibly per-source part
+ * of the mirror. Merges two upstream Congress.gov sources into one row per bill:
+ * the bill list (`/bill/{congress}`, sorted by updateDate) supplies the skeleton
+ * (title, chamber, latest action, update date); the CRS summaries list
+ * (`/summaries/{congress}`) supplies the summary text. Both reuse the existing
+ * `CongressApiService` — no new HTTP-calling code, only merge/orchestration.
+ *
+ * Merge order matters: the framework upsert writes every declared column for each
+ * record, so a partial (summary-only) upsert would null the title. The summaries
+ * are therefore loaded into a per-congress map first, then attached as each full
+ * bill row is emitted. Summaries are fully re-walked every sync (not date-filtered)
+ * so a re-emitted bill never loses a previously-stored summary. The durable
+ * checkpoint is the bills' `updateDate` high-water mark; refresh re-scans bills
+ * from it inclusively (`sort=updateDate asc`), and the upsert makes the overlap
+ * harmless.
+ * @module services/congress-mirror/ingest
+ */
+import type { SyncGenerator } from '@cyanheads/mcp-ts-core/mirror';
+import type { CongressApiService } from '../../services/congress-api/congress-api-service.js';
+/** The two service methods the ingester needs — injectable so tests can mock the API. */
+export type MirrorApi = Pick<CongressApiService, 'listBills' | 'listSummaries'>;
+/**
+ * Build the Congress bill ingester. The returned generator walks the configured
+ * congresses; for each, it loads the summary map, then streams bill pages
+ * (`sort=updateDate asc`) as full merged rows, advancing the durable checkpoint
+ * to the max `updateDate` seen.
+ *
+ * @param getApi - Accessor for the Congress API service (injectable for tests).
+ * @param congresses - Congress numbers to mirror.
+ */
+export declare function createCongressBillIngester(getApi: () => MirrorApi, congresses: number[]): SyncGenerator;
+//# sourceMappingURL=ingest.d.ts.map

package/dist/services/congress-mirror/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../../src/services/congress-mirror/ingest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAGV,aAAa,EAEd,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAC;AAM1F,yFAAyF;AACzF,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,EAAE,WAAW,GAAG,eAAe,CAAC,CAAC;AA8GhF;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,SAAS,EACvB,UAAU,EAAE,MAAM,EAAE,GACnB,aAAa,CA+Cf"}

package/dist/services/congress-mirror/ingest.js

@@ -0,0 +1,179 @@
+/**
+ * @fileoverview The Congress bill ingester — the one irreducibly per-source part
+ * of the mirror. Merges two upstream Congress.gov sources into one row per bill:
+ * the bill list (`/bill/{congress}`, sorted by updateDate) supplies the skeleton
+ * (title, chamber, latest action, update date); the CRS summaries list
+ * (`/summaries/{congress}`) supplies the summary text. Both reuse the existing
+ * `CongressApiService` — no new HTTP-calling code, only merge/orchestration.
+ *
+ * Merge order matters: the framework upsert writes every declared column for each
+ * record, so a partial (summary-only) upsert would null the title. The summaries
+ * are therefore loaded into a per-congress map first, then attached as each full
+ * bill row is emitted. Summaries are fully re-walked every sync (not date-filtered)
+ * so a re-emitted bill never loses a previously-stored summary. The durable
+ * checkpoint is the bills' `updateDate` high-water mark; refresh re-scans bills
+ * from it inclusively (`sort=updateDate asc`), and the upsert makes the overlap
+ * harmless.
+ * @module services/congress-mirror/ingest
+ */
+import { logger } from '@cyanheads/mcp-ts-core/utils';
+import { htmlToPlainText } from './normalize.js';
+/** Congress.gov list endpoints cap the page size at 250 (confirmed live). */
+const PAGE_SIZE = 250;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+/** Read a non-empty string (or a stringified number) from a raw field. */
+function str(value) {
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        return trimmed === '' ? undefined : trimmed;
+    }
+    if (typeof value === 'number' && Number.isFinite(value))
+        return String(value);
+    return;
+}
+/** Read an integer from a raw field (number or numeric string). */
+function int(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return Math.trunc(value);
+    if (typeof value === 'string' && value.trim() !== '') {
+        const parsed = Number.parseInt(value.trim(), 10);
+        return Number.isNaN(parsed) ? undefined : parsed;
+    }
+    return;
+}
+/**
+ * Derive the composite primary key. Matches the existing
+ * `congress://bill/{congress}/{billType}/{billNumber}` resource addressing; the
+ * bill type is lowercased so both upstream sources key identically.
+ */
+function deriveBillId(congress, billType, billNumber) {
+    return `${congress}/${billType.toLowerCase()}/${billNumber}`;
+}
+/**
+ * The bill list emits date-only `updateDate` ("2026-06-30"); the API's
+ * `fromDateTime` filter wants full ISO 8601. Widen a date-only checkpoint to the
+ * start of that day so the inclusive re-scan catches same-day updates.
+ */
+function toFromDateTime(checkpoint) {
+    return /^\d{4}-\d{2}-\d{2}$/.test(checkpoint) ? `${checkpoint}T00:00:00Z` : checkpoint;
+}
+/**
+ * Page the CRS summaries list for one congress into a `billId → plain-text
+ * summary` map, keeping the latest version per bill (by summary update/action
+ * stamp). Summaries ship as HTML and are stripped to plain text before storage.
+ */
+async function buildSummaryMap(api, congress, signal) {
+    const latest = new Map();
+    let offset = 0;
+    while (!signal.aborted) {
+        const result = await api.listSummaries({ congress, limit: PAGE_SIZE, offset });
+        const rows = result.data;
+        if (rows.length === 0)
+            break;
+        for (const raw of rows) {
+            if (!isRecord(raw) || !isRecord(raw.bill))
+                continue;
+            const bill = raw.bill;
+            const c = int(bill.congress);
+            const billType = str(bill.type)?.toLowerCase();
+            const billNumber = int(bill.number);
+            if (c === undefined || billType === undefined || billNumber === undefined)
+                continue;
+            const text = typeof raw.text === 'string' ? htmlToPlainText(raw.text) : '';
+            if (!text)
+                continue;
+            const id = deriveBillId(c, billType, billNumber);
+            const stamp = str(raw.updateDate) ?? str(raw.actionDate) ?? '';
+            const existing = latest.get(id);
+            if (!existing || stamp >= existing.stamp)
+                latest.set(id, { text, stamp });
+        }
+        if (rows.length < PAGE_SIZE || result.pagination.nextOffset == null)
+            break;
+        offset += PAGE_SIZE;
+    }
+    const map = new Map();
+    for (const [id, value] of latest)
+        map.set(id, value.text);
+    return map;
+}
+/** Map one raw bill-list record to a full mirror row, joining the summary map. */
+function toBillRow(raw, fallbackCongress, summaries) {
+    const billType = str(raw.type)?.toLowerCase();
+    const billNumber = int(raw.number);
+    if (billType === undefined || billNumber === undefined)
+        return null;
+    const congress = int(raw.congress) ?? fallbackCongress;
+    const id = deriveBillId(congress, billType, billNumber);
+    const latestAction = isRecord(raw.latestAction) ? raw.latestAction : undefined;
+    return {
+        billId: id,
+        congress,
+        billType,
+        billNumber,
+        title: str(raw.title) ?? null,
+        summary: summaries.get(id) ?? null,
+        originChamber: str(raw.originChamber) ?? null,
+        latestActionDate: latestAction ? (str(latestAction.actionDate) ?? null) : null,
+        latestActionText: latestAction ? (str(latestAction.text) ?? null) : null,
+        updateDate: str(raw.updateDate) ?? null,
+    };
+}
+/**
+ * Build the Congress bill ingester. The returned generator walks the configured
+ * congresses; for each, it loads the summary map, then streams bill pages
+ * (`sort=updateDate asc`) as full merged rows, advancing the durable checkpoint
+ * to the max `updateDate` seen.
+ *
+ * @param getApi - Accessor for the Congress API service (injectable for tests).
+ * @param congresses - Congress numbers to mirror.
+ */
+export function createCongressBillIngester(getApi, congresses) {
+    return async function* sync({ mode, checkpoint, signal }) {
+        const api = getApi();
+        const fromDateTime = mode === 'refresh' && checkpoint ? toFromDateTime(checkpoint) : undefined;
+        let maxUpdate = checkpoint;
+        logger.info(`Congress bill mirror sync starting (mode=${mode}, congresses=${congresses.join(',')}${fromDateTime ? `, since=${fromDateTime}` : ''})`);
+        for (const congress of congresses) {
+            if (signal.aborted)
+                return;
+            const summaries = await buildSummaryMap(api, congress, signal);
+            logger.info(`Congress ${congress}: ${summaries.size} summaries loaded`);
+            let offset = 0;
+            let billsMirrored = 0;
+            while (!signal.aborted) {
+                const result = await api.listBills({
+                    congress,
+                    sort: 'updateDate asc',
+                    limit: PAGE_SIZE,
+                    offset,
+                    ...(fromDateTime ? { fromDateTime } : {}),
+                });
+                const rows = result.data;
+                if (rows.length === 0)
+                    break;
+                const records = [];
+                for (const raw of rows) {
+                    if (!isRecord(raw))
+                        continue;
+                    const record = toBillRow(raw, congress, summaries);
+                    if (!record)
+                        continue;
+                    records.push(record);
+                    const updated = typeof record.updateDate === 'string' ? record.updateDate : undefined;
+                    if (updated && (maxUpdate === undefined || updated > maxUpdate))
+                        maxUpdate = updated;
+                }
+                billsMirrored += records.length;
+                yield { records, ...(maxUpdate ? { checkpoint: maxUpdate } : {}) };
+                if (rows.length < PAGE_SIZE || result.pagination.nextOffset == null)
+                    break;
+                offset += PAGE_SIZE;
+            }
+            logger.info(`Congress ${congress}: ${billsMirrored} bills mirrored`);
+        }
+    };
+}
+//# sourceMappingURL=ingest.js.map

package/dist/services/congress-mirror/ingest.js.map

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

package/dist/services/congress-mirror/normalize.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileoverview Pure normalization helpers for the bill mirror — HTML→plain-text
+ * stripping (summaries ship as HTML; the FTS index and snippet surface want plain
+ * text) and FTS5 `MATCH` escaping (tokenize + individually quote so a stray `-`,
+ * an unbalanced quote, or an FTS5 reserved word can't break the query). No I/O.
+ * @module services/congress-mirror/normalize
+ */
+/**
+ * Strip HTML tags to plain text and decode the handful of entities Congress.gov
+ * emits in summary bodies. Block-ish tags collapse to spaces so adjacent words
+ * don't fuse (`</p><p>` → space), and whitespace is collapsed to single spaces —
+ * a discovery/snippet surface doesn't need paragraph structure, and flat text
+ * tokenizes more cleanly for FTS5.
+ */
+export declare function htmlToPlainText(html: string): string;
+/**
+ * Build an FTS5 `MATCH` expression from free-text input. Each token is stripped
+ * of embedded quotes and wrapped in double quotes, which neutralizes every FTS5
+ * operator (`-`, `*`, `:`, `NEAR`, `AND`, `OR`, `NOT`) so punctuation or a
+ * reserved word can't raise a SQLite syntax error. Tokens are AND-combined
+ * (implicit-AND across terms). Returns an empty string when the input has no
+ * searchable tokens — callers treat that as "no match", not a thrown query.
+ */
+export declare function toFtsMatch(input: string): string;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/services/congress-mirror/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/services/congress-mirror/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAcpD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQhD"}

package/dist/services/congress-mirror/normalize.js

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview Pure normalization helpers for the bill mirror — HTML→plain-text
+ * stripping (summaries ship as HTML; the FTS index and snippet surface want plain
+ * text) and FTS5 `MATCH` escaping (tokenize + individually quote so a stray `-`,
+ * an unbalanced quote, or an FTS5 reserved word can't break the query). No I/O.
+ * @module services/congress-mirror/normalize
+ */
+/**
+ * Strip HTML tags to plain text and decode the handful of entities Congress.gov
+ * emits in summary bodies. Block-ish tags collapse to spaces so adjacent words
+ * don't fuse (`</p><p>` → space), and whitespace is collapsed to single spaces —
+ * a discovery/snippet surface doesn't need paragraph structure, and flat text
+ * tokenizes more cleanly for FTS5.
+ */
+export function htmlToPlainText(html) {
+    return html
+        .replace(/<\s*br\s*\/?\s*>/gi, ' ')
+        .replace(/<\s*\/?(p|div|li|ul|ol|h[1-6]|tr|table)\b[^>]*>/gi, ' ')
+        .replace(/<[^>]*>/g, '')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&#039;/g, "'")
+        .replace(/&#39;/g, "'")
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/**
+ * Build an FTS5 `MATCH` expression from free-text input. Each token is stripped
+ * of embedded quotes and wrapped in double quotes, which neutralizes every FTS5
+ * operator (`-`, `*`, `:`, `NEAR`, `AND`, `OR`, `NOT`) so punctuation or a
+ * reserved word can't raise a SQLite syntax error. Tokens are AND-combined
+ * (implicit-AND across terms). Returns an empty string when the input has no
+ * searchable tokens — callers treat that as "no match", not a thrown query.
+ */
+export function toFtsMatch(input) {
+    return input
+        .trim()
+        .split(/\s+/)
+        .map((t) => t.replace(/"/g, '').trim())
+        .filter((t) => t.length > 0)
+        .map((t) => `"${t}"`)
+        .join(' AND ');
+}
+//# sourceMappingURL=normalize.js.map

package/dist/services/congress-mirror/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/services/congress-mirror/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI;SACR,OAAO,CAAC,oBAAoB,EAAE,GAAG,CAAC;SAClC,OAAO,CAAC,mDAAmD,EAAE,GAAG,CAAC;SACjE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK;SACT,IAAI,EAAE;SACN,KAAK,CAAC,KAAK,CAAC;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;SACtC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC;SACpB,IAAI,CAAC,OAAO,CAAC,CAAC;AACnB,CAAC"}

package/dist/services/congress-mirror/schema.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Mirror store schema for the Congress bill FTS index. A single
+ * MirrorService-owned table (`bills`) with an FTS5 index over `title` + `summary`
+ * and secondary indexes on the filterable columns. The primary key is the derived
+ * `billId` (`{congress}/{billType}/{billNumber}`) — a single column, matching the
+ * `congress://bill/{congress}/{billType}/{billNumber}` resource addressing.
+ * @module services/congress-mirror/schema
+ */
+import type { SqliteMirrorStoreSpec } from '@cyanheads/mcp-ts-core/mirror';
+/** Primary table name (the MirrorService-owned table). */
+export declare const BILLS_TABLE = "bills";
+/**
+ * The MirrorService primary-table spec. One row per bill, merged from the bill
+ * list (title, chamber, latest action, update date) and the CRS summaries list
+ * (summary text). `title` + `summary` are FTS-indexed; `congress`, `billType`,
+ * and `originChamber` back the exact-match search filters.
+ */
+export declare function billStoreSpec(path: string): SqliteMirrorStoreSpec;
+//# sourceMappingURL=schema.d.ts.map

package/dist/services/congress-mirror/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/services/congress-mirror/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,0DAA0D;AAC1D,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CA0BjE"}

package/dist/services/congress-mirror/schema.js

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview Mirror store schema for the Congress bill FTS index. A single
+ * MirrorService-owned table (`bills`) with an FTS5 index over `title` + `summary`
+ * and secondary indexes on the filterable columns. The primary key is the derived
+ * `billId` (`{congress}/{billType}/{billNumber}`) — a single column, matching the
+ * `congress://bill/{congress}/{billType}/{billNumber}` resource addressing.
+ * @module services/congress-mirror/schema
+ */
+/** Primary table name (the MirrorService-owned table). */
+export const BILLS_TABLE = 'bills';
+/**
+ * The MirrorService primary-table spec. One row per bill, merged from the bill
+ * list (title, chamber, latest action, update date) and the CRS summaries list
+ * (summary text). `title` + `summary` are FTS-indexed; `congress`, `billType`,
+ * and `originChamber` back the exact-match search filters.
+ */
+export function billStoreSpec(path) {
+    return {
+        path,
+        table: BILLS_TABLE,
+        primaryKey: 'billId',
+        version: 1,
+        columns: {
+            billId: 'TEXT',
+            congress: 'INTEGER',
+            billType: 'TEXT',
+            billNumber: 'INTEGER',
+            title: 'TEXT',
+            summary: 'TEXT',
+            originChamber: 'TEXT',
+            latestActionDate: 'TEXT',
+            latestActionText: 'TEXT',
+            updateDate: 'TEXT',
+        },
+        fts: ['title', 'summary'],
+        indexes: [
+            { columns: ['congress'] },
+            { columns: ['billType'] },
+            { columns: ['originChamber'] },
+            { columns: ['updateDate'] },
+        ],
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/services/congress-mirror/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/services/congress-mirror/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,0DAA0D;AAC1D,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,WAAW;QAClB,UAAU,EAAE,QAAQ;QACpB,OAAO,EAAE,CAAC;QACV,OAAO,EAAE;YACP,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,MAAM;YAChB,UAAU,EAAE,SAAS;YACrB,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,MAAM;YACf,aAAa,EAAE,MAAM;YACrB,gBAAgB,EAAE,MAAM;YACxB,gBAAgB,EAAE,MAAM;YACxB,UAAU,EAAE,MAAM;SACnB;QACD,GAAG,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;QACzB,OAAO,EAAE;YACP,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE;YACzB,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE;YACzB,EAAE,OAAO,EAAE,CAAC,eAAe,CAAC,EAAE;YAC9B,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC,EAAE;SAC5B;KACF,CAAC;AACJ,CAAC"}

package/dist/services/congress-mirror/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview Domain types for the Congress bill FTS mirror — the merged row
+ * shape, the search filters, and the search page envelope. The mirror row is the
+ * single-table projection of two upstream Congress.gov sources (the bill list and
+ * the CRS summaries list) keyed by a derived `billId`.
+ * @module services/congress-mirror/types
+ */
+import type { BillType } from '../../services/congress-api/types.js';
+/**
+ * One mirrored bill — a flat row keyed by the derived `billId`
+ * (`{congress}/{billType}/{billNumber}`). `title` comes from the bill list;
+ * `summary` from the CRS summaries list (HTML-stripped, latest version), nullable
+ * because CRS summarizes only a fraction of bills.
+ */
+export interface BillMirrorRow {
+    billId: string;
+    billNumber: number;
+    billType: string;
+    congress: number;
+    latestActionDate: string | null;
+    latestActionText: string | null;
+    originChamber: string | null;
+    summary: string | null;
+    title: string | null;
+    updateDate: string | null;
+}
+/** Filters accepted by the keyword search. */
+export interface SearchBillsFilters {
+    billType?: BillType | undefined;
+    congress?: number | undefined;
+    limit: number;
+    offset: number;
+    originChamber?: string | undefined;
+    query: string;
+}
+/** A single search result — a merged mirror row projected for display. */
+export interface SearchBillResult {
+    billId: string;
+    billNumber: number;
+    billType: string;
+    congress: number;
+    latestActionDate?: string;
+    latestActionText?: string;
+    originChamber?: string;
+    summaryPreview?: string;
+    title: string;
+}
+/** Search page returned by the mirror service. */
+export interface SearchBillsPage {
+    items: SearchBillResult[];
+    limit: number;
+    offset: number;
+    total: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/congress-mirror/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/congress-mirror/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,8CAA8C;AAC9C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0EAA0E;AAC1E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/services/congress-mirror/types.js

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Domain types for the Congress bill FTS mirror — the merged row
+ * shape, the search filters, and the search page envelope. The mirror row is the
+ * single-table projection of two upstream Congress.gov sources (the bill list and
+ * the CRS summaries list) keyed by a derived `billId`.
+ * @module services/congress-mirror/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/congress-mirror/types.js.map

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