@cyanheads/congressgov-mcp-server 0.3.32 → 0.4.0

package/AGENTS.md

@@ -1,7 +1,7 @@
 # Agent Protocol
 
 **Server:** congressgov-mcp-server
-**Version:** 0.3.32
+**Version:** 0.4.0
 **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.10`
 **Engines:** Bun ≥1.3.0, Node ≥24.0.0
 **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
@@ -42,6 +42,10 @@ Tailor suggestions to what's actually missing or stale — don't recite the full
 |:--------|:---------|:------------|
 | `CONGRESS_API_KEY` | No | Optional. Defaults to `DEMO_KEY` (30 req/hr). Own key from [api.data.gov](https://api.data.gov/signup/): 5,000 req/hr. |
 | `CONGRESS_API_BASE_URL` | No | Defaults to `https://api.congress.gov/v3` |
+| `CONGRESS_MIRROR_ENABLED` | No | Enable the local bill search mirror and `congressgov_search_bills`. Defaults to `false`. |
+| `CONGRESS_MIRROR_PATH` | No | Filesystem path to the SQLite mirror index. Defaults to `.mirror/bills.sqlite3`. |
+| `CONGRESS_MIRROR_REFRESH_CRON` | No | Cron schedule for the in-process mirror refresh (HTTP transport only). Unset runs `mirror:refresh` manually. |
+| `CONGRESS_MIRROR_CONGRESSES` | No | Comma-separated congress numbers to mirror (e.g. `118,119`). Defaults to the current congress plus the prior one. |
 
 ---
 
@@ -60,7 +64,7 @@ Tailor suggestions to what's actually missing or stale — don't recite the full
 
 ## MCP Surface
 
-### Tools (10)
+### Tools (11)
 
 | Name | Description |
 |:-----|:------------|
@@ -74,6 +78,7 @@ Tailor suggestions to what's actually missing or stale — don't recite the full
 | `congressgov_crs_reports` | Browse and retrieve nonpartisan CRS policy analysis reports |
 | `congressgov_committee_reports` | Browse and retrieve committee reports accompanying legislation |
 | `congressgov_daily_record` | Browse daily Congressional Record — floor speeches, debates, proceedings |
+| `congressgov_search_bills` | Keyword-search bill titles/summaries via the opt-in local FTS mirror — off by default |
 
 ### Resources (5)
 
@@ -105,6 +110,12 @@ src/
     congress-api/
       congress-api-service.ts           # API client — auth, pagination, rate limiting
       types.ts                          # API response types
+    congress-mirror/
+      congress-mirror-service.ts        # Mirror read path — FTS5 search, ready(), sync accessor
+      ingest.ts                         # Bill list + CRS summaries sync generator
+      normalize.ts                      # HTML→plain-text, FTS5 MATCH escaping
+      schema.ts                         # SQLite mirror store spec (bills table, FTS index)
+      types.ts                          # Mirror row, search filters, search page types
     senate-lis/
       senate-vote-service.ts            # Senate LIS XML client — fetch, retry, not-found
       parse.ts                          # pure XML → domain parsers (fast-xml-parser)
@@ -121,6 +132,7 @@ src/
       crs-reports.tool.ts             # congressgov_crs_reports
       committee-reports.tool.ts        # congressgov_committee_reports
       daily-record.tool.ts            # congressgov_daily_record
+      search-bills.tool.ts            # congressgov_search_bills (opt-in — disabledTool() when the mirror is off)
     resources/definitions/
       current-congress.resource.ts     # congress://current
       bill-types.resource.ts           # congress://bill-types
@@ -130,13 +142,18 @@ src/
     prompts/definitions/
       bill-analysis.prompt.ts          # congressgov_bill_analysis
       legislative-research.prompt.ts   # congressgov_legislative_research
+scripts/
+  _mirror-context.ts                    # Shared bootstrap for the mirror lifecycle CLI scripts
+  congress-mirror-init.ts               # mirror:init — full out-of-band mirror build
+  congress-mirror-refresh.ts            # mirror:refresh — incremental mirror refresh
+  congress-mirror-verify.ts             # mirror:verify — readiness + integrity check
 ```
 
 ---
 
 ## Services
 
-Two services. `CongressApiService` backs nine tools and the House branch of `congressgov_roll_votes`; `SenateVoteService` backs only the Senate branch of `congressgov_roll_votes` (the Congress.gov API exposes no Senate vote namespace).
+Three services. `CongressApiService` backs nine tools and the House branch of `congressgov_roll_votes`; `SenateVoteService` backs only the Senate branch of `congressgov_roll_votes` (the Congress.gov API exposes no Senate vote namespace); `CongressMirrorService` backs `congressgov_search_bills` only.
 
 **`CongressApiService`** — wraps the Congress.gov REST API v3:
 - API key via `X-Api-Key` header (never logged; kept out of the URL so it can't leak in upstream error messages)
@@ -151,6 +168,10 @@ Two services. `CongressApiService` backs nine tools and the House branch of `con
 - The host returns HTTP 200 with an HTML page for unknown congress/session/vote, so "not found" is detected from the body, not the status code
 - Party totals are derived from the roster (the feed publishes none)
 
+**`CongressMirrorService`** — local SQLite FTS5 mirror of bill title + CRS summary text, backing `congressgov_search_bills` only:
+- Opt-in via `CONGRESS_MIRROR_ENABLED` (off by default); built out-of-band via the `mirror:init`/`mirror:refresh` scripts, never on server startup
+- No live-API fallback — ingests through the existing `CongressApiService`, and a mirror that hasn't finished its initial build returns an empty result with a notice, not an error
+
 **Usage in tools:**
 ```ts
 import { getCongressApi } from '@/services/congress-api/congress-api-service.js';

package/CLAUDE.md

@@ -1,7 +1,7 @@
 # Agent Protocol
 
 **Server:** congressgov-mcp-server
-**Version:** 0.3.32
+**Version:** 0.4.0
 **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.10`
 **Engines:** Bun ≥1.3.0, Node ≥24.0.0
 **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
@@ -42,6 +42,10 @@ Tailor suggestions to what's actually missing or stale — don't recite the full
 |:--------|:---------|:------------|
 | `CONGRESS_API_KEY` | No | Optional. Defaults to `DEMO_KEY` (30 req/hr). Own key from [api.data.gov](https://api.data.gov/signup/): 5,000 req/hr. |
 | `CONGRESS_API_BASE_URL` | No | Defaults to `https://api.congress.gov/v3` |
+| `CONGRESS_MIRROR_ENABLED` | No | Enable the local bill search mirror and `congressgov_search_bills`. Defaults to `false`. |
+| `CONGRESS_MIRROR_PATH` | No | Filesystem path to the SQLite mirror index. Defaults to `.mirror/bills.sqlite3`. |
+| `CONGRESS_MIRROR_REFRESH_CRON` | No | Cron schedule for the in-process mirror refresh (HTTP transport only). Unset runs `mirror:refresh` manually. |
+| `CONGRESS_MIRROR_CONGRESSES` | No | Comma-separated congress numbers to mirror (e.g. `118,119`). Defaults to the current congress plus the prior one. |
 
 ---
 
@@ -60,7 +64,7 @@ Tailor suggestions to what's actually missing or stale — don't recite the full
 
 ## MCP Surface
 
-### Tools (10)
+### Tools (11)
 
 | Name | Description |
 |:-----|:------------|
@@ -74,6 +78,7 @@ Tailor suggestions to what's actually missing or stale — don't recite the full
 | `congressgov_crs_reports` | Browse and retrieve nonpartisan CRS policy analysis reports |
 | `congressgov_committee_reports` | Browse and retrieve committee reports accompanying legislation |
 | `congressgov_daily_record` | Browse daily Congressional Record — floor speeches, debates, proceedings |
+| `congressgov_search_bills` | Keyword-search bill titles/summaries via the opt-in local FTS mirror — off by default |
 
 ### Resources (5)
 
@@ -105,6 +110,12 @@ src/
     congress-api/
       congress-api-service.ts           # API client — auth, pagination, rate limiting
       types.ts                          # API response types
+    congress-mirror/
+      congress-mirror-service.ts        # Mirror read path — FTS5 search, ready(), sync accessor
+      ingest.ts                         # Bill list + CRS summaries sync generator
+      normalize.ts                      # HTML→plain-text, FTS5 MATCH escaping
+      schema.ts                         # SQLite mirror store spec (bills table, FTS index)
+      types.ts                          # Mirror row, search filters, search page types
     senate-lis/
       senate-vote-service.ts            # Senate LIS XML client — fetch, retry, not-found
       parse.ts                          # pure XML → domain parsers (fast-xml-parser)
@@ -121,6 +132,7 @@ src/
       crs-reports.tool.ts             # congressgov_crs_reports
       committee-reports.tool.ts        # congressgov_committee_reports
       daily-record.tool.ts            # congressgov_daily_record
+      search-bills.tool.ts            # congressgov_search_bills (opt-in — disabledTool() when the mirror is off)
     resources/definitions/
       current-congress.resource.ts     # congress://current
       bill-types.resource.ts           # congress://bill-types
@@ -130,13 +142,18 @@ src/
     prompts/definitions/
       bill-analysis.prompt.ts          # congressgov_bill_analysis
       legislative-research.prompt.ts   # congressgov_legislative_research
+scripts/
+  _mirror-context.ts                    # Shared bootstrap for the mirror lifecycle CLI scripts
+  congress-mirror-init.ts               # mirror:init — full out-of-band mirror build
+  congress-mirror-refresh.ts            # mirror:refresh — incremental mirror refresh
+  congress-mirror-verify.ts             # mirror:verify — readiness + integrity check
 ```
 
 ---
 
 ## Services
 
-Two services. `CongressApiService` backs nine tools and the House branch of `congressgov_roll_votes`; `SenateVoteService` backs only the Senate branch of `congressgov_roll_votes` (the Congress.gov API exposes no Senate vote namespace).
+Three services. `CongressApiService` backs nine tools and the House branch of `congressgov_roll_votes`; `SenateVoteService` backs only the Senate branch of `congressgov_roll_votes` (the Congress.gov API exposes no Senate vote namespace); `CongressMirrorService` backs `congressgov_search_bills` only.
 
 **`CongressApiService`** — wraps the Congress.gov REST API v3:
 - API key via `X-Api-Key` header (never logged; kept out of the URL so it can't leak in upstream error messages)
@@ -151,6 +168,10 @@ Two services. `CongressApiService` backs nine tools and the House branch of `con
 - The host returns HTTP 200 with an HTML page for unknown congress/session/vote, so "not found" is detected from the body, not the status code
 - Party totals are derived from the roster (the feed publishes none)
 
+**`CongressMirrorService`** — local SQLite FTS5 mirror of bill title + CRS summary text, backing `congressgov_search_bills` only:
+- Opt-in via `CONGRESS_MIRROR_ENABLED` (off by default); built out-of-band via the `mirror:init`/`mirror:refresh` scripts, never on server startup
+- No live-API fallback — ingests through the existing `CongressApiService`, and a mirror that hasn't finished its initial build returns an empty result with a notice, not an error
+
 **Usage in tools:**
 ```ts
 import { getCongressApi } from '@/services/congress-api/congress-api-service.js';

package/Dockerfile

@@ -71,6 +71,19 @@ RUN if [ "$OTEL_ENABLED" = "true" ]; then \
 # Copy the compiled application code from the build stage
 COPY --from=build /usr/src/app/dist ./dist
 
+# Copy the mirror lifecycle scripts (mirror:init / mirror:refresh / mirror:verify)
+# and the shared context shim they import, then emit a runtime tsconfig so Bun
+# resolves the @/ path alias against the compiled ./dist (the source ./src never
+# reaches the runtime image). Same `bun run mirror:*` commands work in dev and the
+# image; run `docker exec <container> bun run mirror:init` to build the index.
+# See the api-mirror skill for the full recipe.
+COPY --from=build /usr/src/app/scripts/congress-mirror-init.ts \
+                  /usr/src/app/scripts/congress-mirror-refresh.ts \
+                  /usr/src/app/scripts/congress-mirror-verify.ts \
+                  /usr/src/app/scripts/_mirror-context.ts \
+                  ./scripts/
+RUN echo '{"compilerOptions":{"baseUrl":".","paths":{"@/*":["./dist/*"]}}}' > tsconfig.json
+
 # The 'oven/bun' image already provides a non-root user named 'bun'.
 # We will use this existing user for enhanced security.
 

package/README.md

@@ -1,13 +1,13 @@
 <div align="center">
   <h1>@cyanheads/congressgov-mcp-server</h1>
   <p><b>Access U.S. congressional data - bills, votes, members, committees - through MCP. STDIO & Streamable HTTP.</b>
-  <div>10 Tools • 5 Resources • 2 Prompts</div>
+  <div>11 Tools • 5 Resources • 2 Prompts</div>
   </p>
 </div>
 
 <div align="center">
 
-[![Version](https://img.shields.io/badge/Version-0.3.32-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/congressgov-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/congressgov-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/congressgov-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.2-blueviolet.svg?style=flat-square)](https://bun.sh/)
+[![Version](https://img.shields.io/badge/Version-0.4.0-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/congressgov-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/congressgov-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/congressgov-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.2-blueviolet.svg?style=flat-square)](https://bun.sh/)
 
 </div>
 
@@ -29,7 +29,7 @@
 
 ## Tools
 
-Ten read-only tools for querying U.S. legislative data:
+Eleven read-only tools for querying U.S. legislative data:
 
 | Tool | Description |
 |:---|:---|
@@ -43,6 +43,7 @@ Ten read-only tools for querying U.S. legislative data:
 | `congressgov_crs_reports` | Browse and retrieve nonpartisan CRS policy analysis reports |
 | `congressgov_committee_reports` | Browse and retrieve committee reports accompanying legislation |
 | `congressgov_daily_record` | Browse the daily Congressional Record — floor speeches, debates, and proceedings |
+| `congressgov_search_bills` | Keyword-search bill titles and CRS summaries via a local full-text mirror (opt-in, off by default) |
 
 ### `congressgov_bill_lookup`
 
@@ -112,6 +113,16 @@ Browse the daily Congressional Record — floor speeches, debates, and legislati
 - Browse volumes by congress number
 - Retrieve specific issue articles
 
+---
+
+### `congressgov_search_bills`
+
+Keyword-search bill titles and CRS summaries against a local full-text mirror — the discovery path the Congress.gov API itself lacks.
+
+- **Opt-in:** off by default. Requires `CONGRESS_MIRROR_ENABLED=true` and a locally built index (`bun run mirror:init`) — until then the tool is visible but not callable
+- Narrow with `congress`, `billType`, and `originChamber` filters
+- Returns BM25-ranked matches with each bill's derived id, ready for a follow-up `congressgov_bill_lookup` call
+
 ## Resources
 
 | URI Pattern | Description |
@@ -271,7 +282,7 @@ docker run -e CONGRESS_API_KEY=your-api-key -p 3010:3010 congressgov-mcp-server
 
 | Directory | Purpose |
 |:---|:---|
-| `src/mcp-server/tools/definitions/` | Tool definitions (`*.tool.ts`). Ten Congress.gov tools. |
+| `src/mcp-server/tools/definitions/` | Tool definitions (`*.tool.ts`). Eleven Congress.gov tools. |
 | `src/mcp-server/resources/definitions/` | Resource definitions. Congress, bill, member, and committee resources. |
 | `src/mcp-server/prompts/definitions/` | Prompt definitions. Bill analysis and legislative research prompts. |
 | `src/services/congress-api/` | Congress.gov API client — auth, pagination, rate limiting. |

package/dist/config/server-config.d.ts

@@ -3,11 +3,26 @@
  * @module config/server-config
  */
 import { z } from '@cyanheads/mcp-ts-core';
+/** Default on-disk location of the SQLite bill FTS mirror. */
+export declare const DEFAULT_MIRROR_PATH = ".mirror/bills.sqlite3";
+/**
+ * Congress number covering a given date. The 1st U.S. Congress convened in 1789
+ * and each Congress spans two years, so `floor((year - 1789) / 2) + 1` yields the
+ * ordinal (2025–2026 → 119). Used to seed the default mirror window when
+ * `CONGRESS_MIRROR_CONGRESSES` is unset.
+ */
+export declare function currentCongressNumber(date?: Date): number;
 declare const ServerConfigSchema: z.ZodObject<{
     apiKey: z.ZodDefault<z.ZodString>;
     baseUrl: z.ZodDefault<z.ZodString>;
+    mirrorEnabled: z.ZodPreprocess<z.ZodCodec<z.ZodString, z.ZodBoolean>>;
+    mirrorPath: z.ZodDefault<z.ZodString>;
+    mirrorRefreshCron: z.ZodPreprocess<z.ZodOptional<z.ZodString>>;
+    congresses: z.ZodPreprocess<z.ZodArray<z.ZodNumber>>;
 }, z.core.$strip>;
 export type ServerConfig = z.infer<typeof ServerConfigSchema>;
 export declare function getServerConfig(): ServerConfig;
+/** Reset the cached config — test-only. */
+export declare function resetServerConfig(): void;
 export {};
 //# sourceMappingURL=server-config.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,QAAA,MAAM,kBAAkB;;;iBAYtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,wBAAgB,eAAe,IAAI,YAAY,CAM9C"}
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAErE;AAoBD,QAAA,MAAM,kBAAkB;;;;;;;iBA0CtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,wBAAgB,eAAe,IAAI,YAAY,CAU9C;AAED,2CAA2C;AAC3C,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/config/server-config.js

@@ -4,6 +4,34 @@
  */
 import { z } from '@cyanheads/mcp-ts-core';
 import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
+/** Default on-disk location of the SQLite bill FTS mirror. */
+export const DEFAULT_MIRROR_PATH = '.mirror/bills.sqlite3';
+/**
+ * Congress number covering a given date. The 1st U.S. Congress convened in 1789
+ * and each Congress spans two years, so `floor((year - 1789) / 2) + 1` yields the
+ * ordinal (2025–2026 → 119). Used to seed the default mirror window when
+ * `CONGRESS_MIRROR_CONGRESSES` is unset.
+ */
+export function currentCongressNumber(date = new Date()) {
+    return Math.floor((date.getUTCFullYear() - 1789) / 2) + 1;
+}
+/**
+ * Parse `CONGRESS_MIRROR_CONGRESSES` — a comma-separated list of congress numbers
+ * ("118,119") — into a positive-integer array. Unset/empty falls back to the
+ * current congress plus the one prior (the realistic "what's this recent bill
+ * about" search window); a fully malformed value resolves to an empty array,
+ * which the `.min(1)` guard rejects loudly at startup.
+ */
+function parseCongresses(value) {
+    if (typeof value === 'string' && value.trim() !== '') {
+        return value
+            .split(',')
+            .map((s) => Number.parseInt(s.trim(), 10))
+            .filter((n) => Number.isInteger(n) && n > 0);
+    }
+    const current = currentCongressNumber();
+    return [current, current - 1];
+}
 const ServerConfigSchema = z.object({
     apiKey: z
         .string()
@@ -14,13 +42,50 @@ const ServerConfigSchema = z.object({
         .url()
         .default('https://api.congress.gov/v3')
         .describe('Congress.gov API base URL'),
+    /**
+     * Master switch for the local bill FTS mirror + `congressgov_search_bills`.
+     * Off by default so the standard deploy stays config-free and the live-API
+     * tools are unaffected. Unset/empty/malformed resolves to `false`.
+     */
+    mirrorEnabled: z
+        .preprocess((v) => (v === undefined || v === null || v === '' ? 'false' : v), z.stringbool())
+        .describe('Enable the local bill search mirror and the congressgov_search_bills tool.'),
+    /** Filesystem path to the SQLite mirror index file (matches the Dockerfile `.mirror` dir). */
+    mirrorPath: z
+        .string()
+        .min(1)
+        .default(DEFAULT_MIRROR_PATH)
+        .describe('Filesystem path to the SQLite bill mirror index.'),
+    /**
+     * Cron expression for the in-process incremental refresh (HTTP transport only).
+     * Unset means no in-process schedule — run `bun run mirror:refresh` out-of-band.
+     */
+    mirrorRefreshCron: z
+        .preprocess((v) => (v === '' || v === null ? undefined : v), z.string().min(1).optional())
+        .describe('Cron schedule for the in-process mirror refresh (HTTP only; omit to run manually).'),
+    /**
+     * Congresses to mirror. Defaults to the current congress plus the one prior.
+     * Comma-separated env value (e.g. "118,119"); widening the window is a config
+     * change, not a redesign.
+     */
+    congresses: z
+        .preprocess(parseCongresses, z.array(z.number().int().positive()).min(1))
+        .describe('Congress numbers included in the mirror (default: current + 1 prior).'),
 });
 let _config;
 export function getServerConfig() {
     _config ??= parseEnvConfig(ServerConfigSchema, {
         apiKey: 'CONGRESS_API_KEY',
         baseUrl: 'CONGRESS_API_BASE_URL',
+        mirrorEnabled: 'CONGRESS_MIRROR_ENABLED',
+        mirrorPath: 'CONGRESS_MIRROR_PATH',
+        mirrorRefreshCron: 'CONGRESS_MIRROR_REFRESH_CRON',
+        congresses: 'CONGRESS_MIRROR_CONGRESSES',
     });
     return _config;
 }
+/** Reset the cached config — test-only. */
+export function resetServerConfig() {
+    _config = undefined;
+}
 //# sourceMappingURL=server-config.js.map

package/dist/config/server-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,OAAO,CAAC,UAAU,CAAC;SACnB,QAAQ,CACP,+FAA+F,CAChG;IACH,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,6BAA6B,CAAC;SACtC,QAAQ,CAAC,2BAA2B,CAAC;CACzC,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,uBAAuB;KACjC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -4,6 +4,8 @@
  * @module index
  */
 import { createApp } from '@cyanheads/mcp-ts-core';
+import { logger, schedulerService } from '@cyanheads/mcp-ts-core/utils';
+import { getServerConfig } from './config/server-config.js';
 import { billAnalysisPrompt } from './mcp-server/prompts/definitions/bill-analysis.prompt.js';
 import { legislativeResearchPrompt } from './mcp-server/prompts/definitions/legislative-research.prompt.js';
 import { billResource } from './mcp-server/resources/definitions/bill.resource.js';
@@ -20,8 +22,10 @@ import { dailyRecordTool } from './mcp-server/tools/definitions/daily-record.too
 import { enactedLawsTool } from './mcp-server/tools/definitions/enacted-laws.tool.js';
 import { memberLookupTool } from './mcp-server/tools/definitions/member-lookup.tool.js';
 import { rollVotesTool } from './mcp-server/tools/definitions/roll-votes.tool.js';
+import { searchBillsTool } from './mcp-server/tools/definitions/search-bills.tool.js';
 import { senateNominationsTool } from './mcp-server/tools/definitions/senate-nominations.tool.js';
 import { initCongressApi } from './services/congress-api/congress-api-service.js';
+import { getCongressMirror, initCongressMirror, } from './services/congress-mirror/congress-mirror-service.js';
 import { initSenateVoteService } from './services/senate-lis/senate-vote-service.js';
 const REPO_ROOT = 'https://github.com/cyanheads/congressgov-mcp-server';
 /**
@@ -46,6 +50,7 @@ await createApp({
         withSource(crsReportsTool, 'tools', 'crs-reports.tool.ts'),
         withSource(committeeReportsTool, 'tools', 'committee-reports.tool.ts'),
         withSource(dailyRecordTool, 'tools', 'daily-record.tool.ts'),
+        withSource(searchBillsTool, 'tools', 'search-bills.tool.ts'),
     ],
     resources: [
         withSource(currentCongressResource, 'resources', 'current-congress.resource.ts'),
@@ -58,15 +63,38 @@ await createApp({
         withSource(billAnalysisPrompt, 'prompts', 'bill-analysis.prompt.ts'),
         withSource(legislativeResearchPrompt, 'prompts', 'legislative-research.prompt.ts'),
     ],
-    instructions: `Use the congressgov_* tools to access U.S. legislative data via the Congress.gov API v3: bills, enacted laws, members, committees, roll call votes, presidential nominations, CRS reports, and the daily Congressional Record. There is no keyword search — browse by congress number, bill/report type, date range, chamber, state, and district. Bills are addressed by congress + billType + billNumber (e.g. 118/hr/1234), members by bioguideId, committees by chamber-prefix codes. congressgov_roll_votes serves both chambers via its 'chamber' parameter — House votes come from the Congress.gov API, Senate votes from the Senate's official LIS feed.`,
+    instructions: `Use the congressgov_* tools to access U.S. legislative data via the Congress.gov API v3: bills, enacted laws, members, committees, roll call votes, presidential nominations, CRS reports, and the daily Congressional Record. The Congress.gov API itself has no keyword search — browse by congress number, bill/report type, date range, chamber, state, and district. An optional local FTS mirror adds congressgov_search_bills (keyword search over bill titles and summaries) when CONGRESS_MIRROR_ENABLED is set; off by default, the tool is visible but not callable. Bills are addressed by congress + billType + billNumber (e.g. 118/hr/1234), members by bioguideId, committees by chamber-prefix codes. congressgov_roll_votes serves both chambers via its 'chamber' parameter — House votes come from the Congress.gov API, Senate votes from the Senate's official LIS feed.`,
     landing: {
         repoRoot: REPO_ROOT,
         tagline: 'U.S. legislative data — bills, votes, members, committees — via MCP.',
         requireAuth: false,
     },
-    setup() {
+    setup(core) {
         initCongressApi();
         initSenateVoteService();
+        /**
+         * The bill FTS mirror is opt-in (off by default). When enabled, wire the
+         * service; a full init runs out-of-band via `mirror:init` (never on startup).
+         * The in-process incremental refresh is scheduled only under HTTP transport
+         * (a long-lived process owns the cron) and only when a cron is configured —
+         * stdio operators run `mirror:refresh` out-of-band.
+         */
+        const config = getServerConfig();
+        if (config.mirrorEnabled) {
+            initCongressMirror({ mirrorPath: config.mirrorPath, congresses: config.congresses });
+            if (core.config.mcpTransportType === 'http' && config.mirrorRefreshCron) {
+                void scheduleMirrorRefresh(config.mirrorRefreshCron);
+            }
+        }
     },
 });
+/** Register and start the in-process incremental mirror refresh job. */
+async function scheduleMirrorRefresh(cron) {
+    await schedulerService.schedule('congress-bills-refresh', cron, async (jobCtx) => {
+        logger.info('Starting scheduled Congress bill mirror refresh', jobCtx);
+        const result = await getCongressMirror().mirrorInstance.runSync({ mode: 'refresh' });
+        logger.info(`Scheduled Congress bill mirror refresh complete: ${result.recordsApplied} records applied (total ${result.total})`, jobCtx);
+    }, 'Incremental refresh of the local Congress bill FTS mirror from Congress.gov.');
+    schedulerService.start('congress-bills-refresh');
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mcp-server/tools/definitions/search-bills.tool.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview congressgov_search_bills — keyword search over the local bill FTS
+ * mirror, the discovery path the Congress.gov API structurally lacks. Queries the
+ * embedded SQLite + FTS5 index (title + summary), not the live API, so it has no
+ * live fallback: a mirror that has not finished its initial build returns an empty
+ * result with an enrichment notice rather than a thrown error. Gated behind
+ * CONGRESS_MIRROR_ENABLED via disabledTool() — visible-but-uncallable when the
+ * mirror is off (the default).
+ * @module mcp-server/tools/definitions/search-bills
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+/**
+ * Gated behind the mirror master switch. When the mirror is off (the default) the
+ * tool renders on the landing page as present-but-uncallable with a hint, and is
+ * skipped during MCP registration so clients can't call a guaranteed-empty search.
+ */
+export declare const searchBillsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    query: z.ZodString;
+    congress: z.ZodOptional<z.ZodNumber>;
+    billType: z.ZodOptional<z.ZodEnum<{
+        hr: "hr";
+        s: "s";
+        hjres: "hjres";
+        sjres: "sjres";
+        hconres: "hconres";
+        sconres: "sconres";
+        hres: "hres";
+        sres: "sres";
+    }>>;
+    originChamber: z.ZodOptional<z.ZodEnum<{
+        House: "House";
+        Senate: "Senate";
+    }>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{}, z.core.$loose>>;
+    pagination: z.ZodObject<{
+        count: z.ZodNumber;
+        nextOffset: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>;
+}, z.core.$loose>, undefined, {
+    effectiveQuery: z.ZodString;
+    totalCount: z.ZodNumber;
+    notice: z.ZodOptional<z.ZodString>;
+}>;
+//# sourceMappingURL=search-bills.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-bills.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-bills.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-bills.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAsB,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAsG/D;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKtB,CAAC"}

package/dist/mcp-server/tools/definitions/search-bills.tool.js

@@ -0,0 +1,99 @@
+/**
+ * @fileoverview congressgov_search_bills — keyword search over the local bill FTS
+ * mirror, the discovery path the Congress.gov API structurally lacks. Queries the
+ * embedded SQLite + FTS5 index (title + summary), not the live API, so it has no
+ * live fallback: a mirror that has not finished its initial build returns an empty
+ * result with an enrichment notice rather than a thrown error. Gated behind
+ * CONGRESS_MIRROR_ENABLED via disabledTool() — visible-but-uncallable when the
+ * mirror is off (the default).
+ * @module mcp-server/tools/definitions/search-bills
+ */
+import { disabledTool, tool, z } from '@cyanheads/mcp-ts-core';
+import { getServerConfig } from '../../../config/server-config.js';
+import { formatSearchBills } from '../../../mcp-server/tools/format-helpers.js';
+import { buildEffectiveQuery, listEnrichment, listOutput, } from '../../../mcp-server/tools/tool-helpers.js';
+import { BILL_TYPE_CODES } from '../../../services/congress-api/types.js';
+import { getCongressMirror } from '../../../services/congress-mirror/congress-mirror-service.js';
+const searchBillsDef = tool('congressgov_search_bills', {
+    description: `Keyword-search U.S. bills by title and CRS summary text — the discovery path the Congress.gov API itself lacks (it has no keyword search). Backed by a local full-text index over a bounded congress window; title and summary are indexed, but policy area and full bill text are not. Returns BM25-ranked matches, each with the bill's derived id (congress/billType/billNumber) for follow-up congressgov_bill_lookup calls and a truncated summary preview. Narrow with the optional congress, billType, and originChamber filters. Searches the local mirror, not the live API — if the mirror has not finished its initial build it returns an empty result with a notice, not an error.`,
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        query: z
+            .string()
+            .min(1)
+            .describe('Free-text keywords matched against bill titles and summaries (e.g. "semiconductor export controls"). Tokens are AND-combined.'),
+        congress: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe('Restrict to a single congress (e.g. 119). Omit to search the whole mirrored window.'),
+        billType: z
+            .enum(BILL_TYPE_CODES)
+            .optional()
+            .describe('Restrict to a bill type (hr, s, hjres, sjres, hconres, sconres, hres, sres).'),
+        originChamber: z
+            .enum(['House', 'Senate'])
+            .optional()
+            .describe('Restrict to the originating chamber.'),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(20)
+            .describe('Results per page (1–100, default 20).'),
+        offset: z.number().int().min(0).default(0).describe('Pagination offset.'),
+    }),
+    output: listOutput,
+    enrichment: listEnrichment,
+    format: formatSearchBills,
+    async handler(input, ctx) {
+        const service = getCongressMirror();
+        ctx.enrich.echo(buildEffectiveQuery('bill search', {
+            query: input.query,
+            congress: input.congress,
+            billType: input.billType,
+            originChamber: input.originChamber,
+        }));
+        /** No live-API fallback — a mirror that never completed an initial sync is an
+         * empty result plus a notice pointing at the refresh, never a throw. */
+        if (!(await service.ready())) {
+            ctx.enrich.total(0);
+            ctx.enrich.notice('The bill search mirror has not finished its initial build yet, so no results are available. Build it with the mirror:init script (or wait for the scheduled refresh) and retry.');
+            return { data: [], pagination: { count: 0, nextOffset: null } };
+        }
+        const page = await service.search({
+            query: input.query,
+            congress: input.congress,
+            billType: input.billType,
+            originChamber: input.originChamber,
+            limit: input.limit,
+            offset: input.offset,
+        }, ctx);
+        ctx.log.info('Bill search complete', { query: input.query, matches: page.total });
+        ctx.enrich.total(page.total);
+        if (page.items.length === 0) {
+            ctx.enrich.notice(`No bills matched "${input.query}". Try broader or fewer keywords, or remove the congress/billType/originChamber filters.`);
+        }
+        const nextOffset = page.offset + page.items.length < page.total ? page.offset + page.items.length : null;
+        /** The shared list envelope carries `data` as passthrough records; the typed
+         * search results widen cleanly to that shape. */
+        return {
+            data: page.items,
+            pagination: { count: page.total, nextOffset },
+        };
+    },
+});
+/**
+ * Gated behind the mirror master switch. When the mirror is off (the default) the
+ * tool renders on the landing page as present-but-uncallable with a hint, and is
+ * skipped during MCP registration so clients can't call a guaranteed-empty search.
+ */
+export const searchBillsTool = getServerConfig().mirrorEnabled
+    ? searchBillsDef
+    : disabledTool(searchBillsDef, {
+        reason: 'The local bill search mirror is turned off in this deployment.',
+        hint: 'CONGRESS_MIRROR_ENABLED=true',
+    });
+//# sourceMappingURL=search-bills.tool.js.map

package/dist/mcp-server/tools/definitions/search-bills.tool.js.map

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