@cyanheads/federal-regulations-mcp-server 0.6.0 → 0.6.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +7 -5
- package/CLAUDE.md +7 -5
- package/README.md +33 -22
- package/changelog/0.6.x/0.6.1.md +29 -0
- package/changelog/0.6.x/0.6.2.md +37 -0
- package/changelog/template.md +10 -3
- package/dist/config/server-config.d.ts +6 -3
- package/dist/config/server-config.d.ts.map +1 -1
- package/dist/config/server-config.js +31 -4
- package/dist/config/server-config.js.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp-server/resources/definitions/cfr-section.resource.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/cfr-section.resource.js +7 -4
- package/dist/mcp-server/resources/definitions/cfr-section.resource.js.map +1 -1
- package/dist/mcp-server/resources/definitions/document.resource.d.ts.map +1 -1
- package/dist/mcp-server/resources/definitions/document.resource.js +2 -1
- package/dist/mcp-server/resources/definitions/document.resource.js.map +1 -1
- package/dist/mcp-server/resources/definitions/index.d.ts +12 -12
- package/dist/mcp-server/tools/definitions/agency-notice.d.ts +6 -0
- package/dist/mcp-server/tools/definitions/agency-notice.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/agency-notice.js +17 -0
- package/dist/mcp-server/tools/definitions/agency-notice.js.map +1 -0
- package/dist/mcp-server/tools/definitions/browse-cfr.tool.d.ts +41 -8
- package/dist/mcp-server/tools/definitions/browse-cfr.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/browse-cfr.tool.js +189 -40
- package/dist/mcp-server/tools/definitions/browse-cfr.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/find-comments.tool.d.ts +8 -3
- package/dist/mcp-server/tools/definitions/find-comments.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/find-comments.tool.js +78 -43
- package/dist/mcp-server/tools/definitions/find-comments.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/format-utils.d.ts +17 -0
- package/dist/mcp-server/tools/definitions/format-utils.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/format-utils.js +36 -1
- package/dist/mcp-server/tools/definitions/format-utils.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-cfr-section.tool.d.ts +1 -1
- package/dist/mcp-server/tools/definitions/get-cfr-section.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-cfr-section.tool.js +19 -15
- package/dist/mcp-server/tools/definitions/get-cfr-section.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-docket.tool.d.ts +67 -16
- package/dist/mcp-server/tools/definitions/get-docket.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-docket.tool.js +224 -56
- package/dist/mcp-server/tools/definitions/get-docket.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-document.tool.d.ts +12 -1
- package/dist/mcp-server/tools/definitions/get-document.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-document.tool.js +44 -20
- package/dist/mcp-server/tools/definitions/get-document.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts +217 -97
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-open-comments.tool.d.ts +2 -2
- package/dist/mcp-server/tools/definitions/list-open-comments.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/list-open-comments.tool.js +19 -17
- package/dist/mcp-server/tools/definitions/list-open-comments.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/presidential-schema.d.ts +17 -0
- package/dist/mcp-server/tools/definitions/presidential-schema.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/presidential-schema.js +31 -0
- package/dist/mcp-server/tools/definitions/presidential-schema.js.map +1 -0
- package/dist/mcp-server/tools/definitions/search-rules.tool.d.ts +36 -4
- package/dist/mcp-server/tools/definitions/search-rules.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-rules.tool.js +160 -32
- package/dist/mcp-server/tools/definitions/search-rules.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/size-limit.d.ts +50 -0
- package/dist/mcp-server/tools/definitions/size-limit.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/size-limit.js +93 -0
- package/dist/mcp-server/tools/definitions/size-limit.js.map +1 -0
- package/dist/services/ecfr/ecfr-service.d.ts +50 -6
- package/dist/services/ecfr/ecfr-service.d.ts.map +1 -1
- package/dist/services/ecfr/ecfr-service.js +128 -12
- package/dist/services/ecfr/ecfr-service.js.map +1 -1
- package/dist/services/ecfr/read-section.d.ts +12 -3
- package/dist/services/ecfr/read-section.d.ts.map +1 -1
- package/dist/services/ecfr/read-section.js +12 -5
- package/dist/services/ecfr/read-section.js.map +1 -1
- package/dist/services/ecfr/types.d.ts +68 -0
- package/dist/services/ecfr/types.d.ts.map +1 -1
- package/dist/services/ecfr/xml.d.ts.map +1 -1
- package/dist/services/ecfr/xml.js +2 -2
- package/dist/services/ecfr/xml.js.map +1 -1
- package/dist/services/ecfr-mirror/refresh-job.d.ts.map +1 -1
- package/dist/services/ecfr-mirror/refresh-job.js +6 -0
- package/dist/services/ecfr-mirror/refresh-job.js.map +1 -1
- package/dist/services/federal-register/agency-resolver.d.ts +20 -0
- package/dist/services/federal-register/agency-resolver.d.ts.map +1 -0
- package/dist/services/federal-register/agency-resolver.js +120 -0
- package/dist/services/federal-register/agency-resolver.js.map +1 -0
- package/dist/services/federal-register/federal-register-service.d.ts +4 -1
- package/dist/services/federal-register/federal-register-service.d.ts.map +1 -1
- package/dist/services/federal-register/federal-register-service.js +126 -32
- package/dist/services/federal-register/federal-register-service.js.map +1 -1
- package/dist/services/federal-register/gpo-text.d.ts +9 -0
- package/dist/services/federal-register/gpo-text.d.ts.map +1 -0
- package/dist/services/federal-register/gpo-text.js +92 -0
- package/dist/services/federal-register/gpo-text.js.map +1 -0
- package/dist/services/federal-register/types.d.ts +63 -5
- package/dist/services/federal-register/types.d.ts.map +1 -1
- package/dist/services/federal-register/types.js +10 -1
- package/dist/services/federal-register/types.js.map +1 -1
- package/dist/services/regulations-gov/regulations-gov-service.d.ts +21 -2
- package/dist/services/regulations-gov/regulations-gov-service.d.ts.map +1 -1
- package/dist/services/regulations-gov/regulations-gov-service.js +99 -22
- package/dist/services/regulations-gov/regulations-gov-service.js.map +1 -1
- package/dist/services/regulations-gov/types.d.ts +64 -16
- package/dist/services/regulations-gov/types.d.ts.map +1 -1
- package/dist/services/request-budget.d.ts +2 -2
- package/dist/services/request-budget.js +2 -2
- package/dist/services/script-notation.d.ts +4 -0
- package/dist/services/script-notation.d.ts.map +1 -0
- package/dist/services/script-notation.js +7 -0
- package/dist/services/script-notation.js.map +1 -0
- package/dist/services/upstream-failure.d.ts +5 -0
- package/dist/services/upstream-failure.d.ts.map +1 -1
- package/dist/services/upstream-failure.js +1 -0
- package/dist/services/upstream-failure.js.map +1 -1
- package/package.json +10 -10
- package/server.json +31 -3
- package/skills/federal-regulations-guide/SKILL.md +13 -7
package/AGENTS.md
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
# Developer Protocol
|
|
2
2
|
|
|
3
3
|
**Server:** federal-regulations-mcp-server
|
|
4
|
-
**Version:** 0.6.
|
|
5
|
-
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)
|
|
6
|
-
**Engines:** Bun ≥1.4.
|
|
4
|
+
**Version:** 0.6.2
|
|
5
|
+
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.22`
|
|
6
|
+
**Engines:** Bun ≥1.4.4, Node ≥24.0.0
|
|
7
7
|
**MCP SDK:** `@modelcontextprotocol/server` ^2.4.0
|
|
8
8
|
**Zod:** ^4.6.7
|
|
9
9
|
|
|
@@ -237,7 +237,9 @@ src/
|
|
|
237
237
|
regulations-gov/ # Regulations.gov v4 client (X-Api-Key) — dockets, comments
|
|
238
238
|
mcp-server/
|
|
239
239
|
tools/definitions/ # 7 regulations_* tools (search-rules, get-document, browse-cfr,
|
|
240
|
-
# get-cfr-section, get-docket, find-comments, list-open-comments)
|
|
240
|
+
# get-cfr-section, get-docket, find-comments, list-open-comments);
|
|
241
|
+
# size-limit.ts is the shared per_page / max_chars field, clamp, and notice;
|
|
242
|
+
# presidential-schema.ts the presidential output object shared by search-rules and get-document
|
|
241
243
|
resources/definitions/ # 2 resources (document, cfr-section)
|
|
242
244
|
scripts/
|
|
243
245
|
ecfr-mirror-init.ts # out-of-band mirror lifecycle (init / refresh / verify)
|
|
@@ -357,7 +359,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
|
|
|
357
359
|
|
|
358
360
|
## Bundling
|
|
359
361
|
|
|
360
|
-
`npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. `mcpb pack` reads `.mcpbignore`, not `.gitignore`, so every root path the bundle must not ship — source, tests, docs, caches, logs, agent docs, plugin manifests, gitignored local files — needs a root-anchored line there (`/docs/`, never `docs/`, which also strips `node_modules/*/docs/`); `lint:packaging` names each missing or unanchored line. Root `skills/` ships on purpose. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips four classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs (`framework-skills/`, `skills/`, `.claude/`, `.agents/`, `SKILL.md`); platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on; node-gyp build output beside a `binding.gyp` (`config.gypi`, Makefiles, `obj.target/`, `.deps/`, object files and debug symbols), which records the packing machine's paths — compiled `*.node` addons stay; and build-only package files — the framework's `changelog/`, `scripts/`, `templates
|
|
362
|
+
`npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. `mcpb pack` reads `.mcpbignore`, not `.gitignore`, so every root path the bundle must not ship — source, tests, docs, caches, logs, agent docs, plugin manifests, gitignored local files — needs a root-anchored line there (`/docs/`, never `docs/`, which also strips `node_modules/*/docs/`); `lint:packaging` names each missing or unanchored line. Root `skills/` ships on purpose. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips four classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs (`framework-skills/`, `skills/`, `.claude/`, `.agents/`, `AGENTS.md`, and `CLAUDE.md` at a package root, plus `SKILL.md` anywhere). The SDK’s nested runtime `skills/` stays in the bundle; platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on; node-gyp build output beside a `binding.gyp` (`config.gypi`, Makefiles, `obj.target/`, `.deps/`, object files and debug symbols), which records the packing machine's paths — compiled `*.node` addons stay; and build-only package files — the framework's `changelog/`, `scripts/`, `templates/` and config bases (`biome.json`, `vitest.config.base.mjs`, `config/tsconfig.base.json`), and `better-sqlite3`'s `deps/` and `src/` C sources. A server using DataCanvas therefore ships a portable bundle without the DuckDB native — `@duckdb/node-api` is an optional peer loaded lazily, so canvas tools report an actionable install hint and every other tool works normally. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
|
|
361
363
|
|
|
362
364
|
**Adding an env var requires both files:** `server.json` (registry discovery, `environmentVariables[]`) and `manifest.json` (bundle install UX, `mcp_config.env` + `user_config`). `lint:packaging` (run by `devcheck`) verifies the env var names match, that every `user_config` option is wired into `mcp_config.env` as `"X": "${user_config.X}"` (the host substitutes nothing else — `"${X}"` reaches the server as that literal string), and that an optional string option carries `"default": ""`.
|
|
363
365
|
|
package/CLAUDE.md
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
# Developer Protocol
|
|
2
2
|
|
|
3
3
|
**Server:** federal-regulations-mcp-server
|
|
4
|
-
**Version:** 0.6.
|
|
5
|
-
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)
|
|
6
|
-
**Engines:** Bun ≥1.4.
|
|
4
|
+
**Version:** 0.6.2
|
|
5
|
+
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.22`
|
|
6
|
+
**Engines:** Bun ≥1.4.4, Node ≥24.0.0
|
|
7
7
|
**MCP SDK:** `@modelcontextprotocol/server` ^2.4.0
|
|
8
8
|
**Zod:** ^4.6.7
|
|
9
9
|
|
|
@@ -237,7 +237,9 @@ src/
|
|
|
237
237
|
regulations-gov/ # Regulations.gov v4 client (X-Api-Key) — dockets, comments
|
|
238
238
|
mcp-server/
|
|
239
239
|
tools/definitions/ # 7 regulations_* tools (search-rules, get-document, browse-cfr,
|
|
240
|
-
# get-cfr-section, get-docket, find-comments, list-open-comments)
|
|
240
|
+
# get-cfr-section, get-docket, find-comments, list-open-comments);
|
|
241
|
+
# size-limit.ts is the shared per_page / max_chars field, clamp, and notice;
|
|
242
|
+
# presidential-schema.ts the presidential output object shared by search-rules and get-document
|
|
241
243
|
resources/definitions/ # 2 resources (document, cfr-section)
|
|
242
244
|
scripts/
|
|
243
245
|
ecfr-mirror-init.ts # out-of-band mirror lifecycle (init / refresh / verify)
|
|
@@ -357,7 +359,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
|
|
|
357
359
|
|
|
358
360
|
## Bundling
|
|
359
361
|
|
|
360
|
-
`npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. `mcpb pack` reads `.mcpbignore`, not `.gitignore`, so every root path the bundle must not ship — source, tests, docs, caches, logs, agent docs, plugin manifests, gitignored local files — needs a root-anchored line there (`/docs/`, never `docs/`, which also strips `node_modules/*/docs/`); `lint:packaging` names each missing or unanchored line. Root `skills/` ships on purpose. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips four classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs (`framework-skills/`, `skills/`, `.claude/`, `.agents/`, `SKILL.md`); platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on; node-gyp build output beside a `binding.gyp` (`config.gypi`, Makefiles, `obj.target/`, `.deps/`, object files and debug symbols), which records the packing machine's paths — compiled `*.node` addons stay; and build-only package files — the framework's `changelog/`, `scripts/`, `templates
|
|
362
|
+
`npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. `mcpb pack` reads `.mcpbignore`, not `.gitignore`, so every root path the bundle must not ship — source, tests, docs, caches, logs, agent docs, plugin manifests, gitignored local files — needs a root-anchored line there (`/docs/`, never `docs/`, which also strips `node_modules/*/docs/`); `lint:packaging` names each missing or unanchored line. Root `skills/` ships on purpose. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips four classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs (`framework-skills/`, `skills/`, `.claude/`, `.agents/`, `AGENTS.md`, and `CLAUDE.md` at a package root, plus `SKILL.md` anywhere). The SDK’s nested runtime `skills/` stays in the bundle; platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on; node-gyp build output beside a `binding.gyp` (`config.gypi`, Makefiles, `obj.target/`, `.deps/`, object files and debug symbols), which records the packing machine's paths — compiled `*.node` addons stay; and build-only package files — the framework's `changelog/`, `scripts/`, `templates/` and config bases (`biome.json`, `vitest.config.base.mjs`, `config/tsconfig.base.json`), and `better-sqlite3`'s `deps/` and `src/` C sources. A server using DataCanvas therefore ships a portable bundle without the DuckDB native — `@duckdb/node-api` is an optional peer loaded lazily, so canvas tools report an actionable install hint and every other tool works normally. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
|
|
361
363
|
|
|
362
364
|
**Adding an env var requires both files:** `server.json` (registry discovery, `environmentVariables[]`) and `manifest.json` (bundle install UX, `mcp_config.env` + `user_config`). `lint:packaging` (run by `devcheck`) verifies the env var names match, that every `user_config` option is wired into `mcp_config.env` as `"X": "${user_config.X}"` (the host substitutes nothing else — `"${X}"` reaches the server as that literal string), and that an optional string option carries `"default": ""`.
|
|
363
365
|
|
package/README.md
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
<h1>@cyanheads/federal-regulations-mcp-server</h1>
|
|
3
|
-
<p><b>Search and trace US federal rules across the Federal Register (proposed/final rules and
|
|
3
|
+
<p><b>Search and trace US federal rules across the Federal Register (proposed/final rules, notices, and presidential documents), the eCFR (codified, point-in-time CFR full text and amendment history, locally mirrored), and Regulations.gov (rulemaking dockets, document files, and public comments) via MCP. STDIO or Streamable HTTP.</b>
|
|
4
4
|
<div>7 Tools • 3 Resources</div>
|
|
5
5
|
</p>
|
|
6
6
|
</div>
|
|
7
7
|
|
|
8
8
|
<div align="center">
|
|
9
9
|
|
|
10
|
-
[](./CHANGELOG.md) [](./LICENSE) [](https://github.com/users/cyanheads/packages/container/package/federal-regulations-mcp-server) [](https://modelcontextprotocol.io/) [](https://www.npmjs.com/package/@cyanheads/federal-regulations-mcp-server) [](https://www.typescriptlang.org/) [](https://bun.sh/)
|
|
11
11
|
|
|
12
12
|
</div>
|
|
13
13
|
|
|
@@ -35,11 +35,11 @@ US federal regulations from the Federal Register, the eCFR, and Regulations.gov.
|
|
|
35
35
|
|
|
36
36
|
| Tool | Description |
|
|
37
37
|
|:---|:---|
|
|
38
|
-
| `regulations_search_rules` | Search Federal Register proposed rules, final rules, notices, and presidential documents by query, type, agency, date range, CFR part, docket number, and
|
|
39
|
-
| `regulations_get_document` | Fetch one Federal Register document by number, with the docket IDs, CFR parts, citation, comment count, and comment URL that chain into other tools |
|
|
40
|
-
| `regulations_browse_cfr` | List CFR titles, a title's chapters, or every section and appendix in a part,
|
|
38
|
+
| `regulations_search_rules` | Search Federal Register proposed rules, final rules, notices, and presidential documents by query, type, agency, date range, CFR part, docket number, RIN, significance, effective date, and executive order number, president, or signing date, or resolve a page cite to its document |
|
|
39
|
+
| `regulations_get_document` | Fetch one Federal Register document by number, with the docket IDs, CFR parts, citation, significance, comment count, and comment URL that chain into other tools |
|
|
40
|
+
| `regulations_browse_cfr` | List CFR titles, a title's chapters, or every section and appendix in a part, full-text-search the codified CFR, or list when a part's or section's text changed |
|
|
41
41
|
| `regulations_get_cfr_section` | Read codified CFR text for a section, whole part, or appendix, current or as of a past date |
|
|
42
|
-
| `regulations_get_docket` | Pull a rulemaking docket and its filed documents from Regulations.gov (key required) |
|
|
42
|
+
| `regulations_get_docket` | Pull a rulemaking docket and its filed documents from Regulations.gov, or read one document's files and attachments (key required) |
|
|
43
43
|
| `regulations_find_comments` | Fetch public comments on a document or docket, or one comment's full body and attachments (key required) |
|
|
44
44
|
| `regulations_list_open_comments` | List documents currently open for public comment, soonest closing first |
|
|
45
45
|
|
|
@@ -57,22 +57,27 @@ The two data resources mirror `regulations_get_document` and `regulations_get_cf
|
|
|
57
57
|
|
|
58
58
|
### `regulations_search_rules` <sub>tool</sub>
|
|
59
59
|
|
|
60
|
-
- Optional full-text `query`, filtered by `type` (`PRORULE` / `RULE` / `NOTICE` / `PRESDOCU`), `agencies` (Federal Register slugs
|
|
61
|
-
-
|
|
62
|
-
-
|
|
60
|
+
- Optional full-text `query`, filtered by `type` (`PRORULE` / `RULE` / `NOTICE` / `PRESDOCU`), `agencies` (Federal Register slugs, exact catalog names, or acronyms such as `EPA`), `published_after` / `published_before`, `cfr_title` + `cfr_part` (a part number or range such as `140-143`; `cfr_part` needs `cfr_title`, else `title_required_for_part`), `docket_id` (a docket number as the Federal Register prints it), `rin`, `significant` (the Federal Register's EO 12866 flag: `true` and `false` each match only documents with a determination), and `effective_after` / `effective_before`, all combined; `per_page` from 2 (default 20; above 100 serves 100 with a notice), `page` 1–50
|
|
61
|
+
- Agency matches are case-insensitive. A shared acronym resolves to its sole top-level agency when one exists (`DOE` → `energy-department`); otherwise `invalid_filter` lists candidate slugs. Rewrites appear in `notice`. `REGULATIONS_RESOLVE_AGENCIES=false` restores slug-only behavior; if the agency catalog is unavailable, the original filters go to the Federal Register
|
|
62
|
+
- Presidential documents narrow by `executive_order_number` (bare digits, `14192`), `presidential_document_type` (`executive_order`, `proclamation`, `memorandum`, `determination`, `notice`, `presidential_order`, `other`), `president` (a slug such as `donald-trump`), and a `signed_after` / `signed_before` window, which differs from the publication window because signing precedes publication. These filters beside a `type` that leaves out `PRESDOCU`, or `significant` beside them or beside `type` of `PRESDOCU` alone, fail with `type_conflict`
|
|
63
|
+
- `citation` (`"89 FR 49102"`) with `citation_date` (the date its source note prints beside it) returns the documents printed on that page, in page order, volume 59 (1994) onward, narrowed by any other filter. A cite missing its date, or combined with the publication date window, fails with `citation_incomplete`; a volume before 59 or a date from another year fails with `citation_out_of_range`. When no document spans the page, the notice gives that day's page range
|
|
64
|
+
- Each result carries `documentNumber`, `citation` / `startPage` / `endPage`, `agencies[].slug`, the printed `docketIds`, `regulationsGovDocketId` and `regulationsGovDocumentId`, `commentCount`, `commentUrl`, `commentsCloseOn` with `commentPeriodOpen` (open through 11:59 PM Eastern on the close date), `regulationIdNumbers`, `significant` (null when no determination is recorded), `presidential` (`type`, `number`, `signingDate`, and `president`; null unless the document is a presidential document), and `cfrReferences` for the follow-up tools. `totalPages` and `nextPage` page the results. The Federal Register serves 50 pages, so `truncated` marks a set larger than 50 × `per_page` (1,000 at the default, 5,000 at 100); narrow the date window rather than paging deeper. `totalCount` stops at 10,000, which means at least that many. A window whose start falls after its end (publication, signing, or effective) fails with `date_range_inverted`, and `invalid_filter` names a rejected parameter
|
|
63
65
|
|
|
64
66
|
---
|
|
65
67
|
|
|
66
68
|
### `regulations_get_document` <sub>tool</sub>
|
|
67
69
|
|
|
68
|
-
- `document_number` in any form the Federal Register issues: `2024-07773` from 2010 on, and older and correction numbers such as `98-1572`, `E9-25990`, or `C1-2009-30484`; `include_full_text` adds the plain-text body as one window of `max_chars` (default 64,000,
|
|
69
|
-
- Returns metadata plus the handles other tools take: the Regulations.gov `docketId` and `regulationsGovDocumentId`, the printed `docketIds`, `citation` / `startPage` / `endPage`, `commentCount`, `commentUrl`, `commentPeriodOpen`, and `cfrReferences`. With text, `fullTextLength` and `fullTextNextOffset` (present while text remains) page the body; a major final rule runs past a million characters
|
|
70
|
+
- `document_number` in any form the Federal Register issues: `2024-07773` from 2010 on, and older and correction numbers such as `98-1572`, `E9-25990`, or `C1-2009-30484`; `include_full_text` adds the plain-text body as one window of `max_chars` (default 64,000; above 200,000 serves 200,000 with a notice) starting at `offset`, and passing either of those implies it
|
|
71
|
+
- Returns metadata plus the handles other tools take: the Regulations.gov `docketId` and `regulationsGovDocumentId`, the printed `docketIds`, `citation` / `startPage` / `endPage`, `commentCount`, `commentUrl`, `commentPeriodOpen`, `significant`, `presidential` for a presidential document, and `cfrReferences`. With text, `fullTextLength` and `fullTextNextOffset` (present while text remains) page the body; a major final rule runs past a million characters
|
|
72
|
+
- `supportingDocumentsCount` is the upstream total (`null` when unknown), while `supportingDocuments` is the embedded list. A larger total produces a partial-list notice; follow the docket through `regulations_get_docket` with `document_types: ["Supporting & Related Material"]` to retrieve more (key required)
|
|
73
|
+
- Abstracts and full text render GPO subscripts as `_x`, superscripts as `^x`, and bullets as `•`. Full-text offsets count the rendered text, with line breaks and indentation preserved
|
|
70
74
|
|
|
71
75
|
---
|
|
72
76
|
|
|
73
77
|
### `regulations_browse_cfr` <sub>tool</sub>
|
|
74
78
|
|
|
75
|
-
- `mode: "structure"` lists the 50 titles, a title's top-level divisions, or, with `title` + `part`, every section and appendix in the part with its `subpart` and `subjectGroup`; `mode: "search"` full-text-searches the codified CFR and requires `query
|
|
79
|
+
- `mode: "structure"` lists the 50 titles, a title's top-level divisions, or, with `title` + `part`, every section and appendix in the part with its `subpart` and `subjectGroup`; `mode: "search"` full-text-searches the codified CFR and requires `query`; `mode: "versions"` lists the dates a part's or one section's text changed. `title`, `part` (needs `title`), and a point-in-time `date` scope structure and search, and `per_page` from 1 (default 20; above 50 serves 50 with a notice) pages search results, part listings, and versions
|
|
80
|
+
- Versions mode takes `title` with `part` (and optionally `section`, written as `regulations_get_cfr_section` accepts it) or with `changed_since` (`YYYY-MM-DD`: versions published by an eCFR issue on or after it, across the whole title when no `part` is given); any other scope fails with `versions_scope_required`, and a `section` citing another title fails with `conflicting_title`. `versions[]` rows carry `cfrCite`, `heading`, `part`, `subpart`, `date`, `issueDate`, `substantive`, and `removed`, in eCFR's order (by identifier, oldest first within each), and `latestAmendmentDate` covers the whole filtered set. Pass a row's `date` as `date` to `regulations_get_cfr_section` to read that version: a row dated before 2017-01-01 reads at 2017-01-01, and a removed row's date reads nothing
|
|
76
81
|
- Search rows carry `cfrCite`, `heading`, `hierarchyPath`, and `excerpt`, one per section. `source` (`mirror` / `live`) and `sourceScope` name the corpus that answered and what it covers, and `countBasis` says whether `totalCount` counts `sections` or `section_versions`; live search reaches eCFR's first 10,000 hits only (`page_out_of_window` past them)
|
|
77
82
|
|
|
78
83
|
---
|
|
@@ -80,7 +85,8 @@ The two data resources mirror `regulations_get_document` and `regulations_get_cf
|
|
|
80
85
|
### `regulations_get_cfr_section` <sub>tool</sub>
|
|
81
86
|
|
|
82
87
|
- One section (`title` + `part` + `section`), a whole part (`section` omitted), or one appendix (`appendix`, verbatim as `regulations_browse_cfr` emits it, e.g. `Appendix A-1 to Part 50`). `section` also takes cites as people write them (`"61"`, `"§ 141.61"`, `"141.61(c)"`) and the `cfrCite` the server returns (`"40 CFR 141.61"`, `"14 CFR 241 § 25"`; a cite naming another title fails with `conflicting_title`), `part` takes `"Part 141"`, and `date` reads text from 2017-01-01 through the title's up-to-date date
|
|
83
|
-
- Text comes back as one `bodyText` window (`max_chars` default 64,000,
|
|
88
|
+
- Text comes back as one `bodyText` window (`max_chars` default 64,000, above 200,000 serves 200,000 with a notice, from `offset`), paged by `bodyTextLength` and `bodyTextNextOffset`. A whole-part read adds a `sections[]` index with each section's `offset` and names its `appendices` without their text; `source` (`mirror` / `live`) reports provenance
|
|
89
|
+
- `hierarchyPath` runs from the title down to the location read. If eCFR cannot supply it, the read still answers, with only the cited levels (`Title 40 › Part 141 › § 141.61`), and `notice` says so
|
|
84
90
|
- A whole-part read also returns the part's `heading`, `authority`, `sourceNote`, and `notes`, and each `sections[]` entry carries the Authority or Source its subpart or subject group states for it
|
|
85
91
|
- Superscripts read `^x` and subscripts `_x` (`3 × 10^−8`, `CO_{2}e`), footnote markers `[n]`, and diacritics and overlines are combining marks (`x̄`)
|
|
86
92
|
|
|
@@ -88,23 +94,26 @@ The two data resources mirror `regulations_get_document` and `regulations_get_cf
|
|
|
88
94
|
|
|
89
95
|
### `regulations_get_docket` <sub>tool</sub> · key required
|
|
90
96
|
|
|
91
|
-
-
|
|
92
|
-
-
|
|
97
|
+
- Exactly one of `docket_id` (list mode) or `document_id` (detail mode): neither fails with `target_required`, both with `multiple_targets`, and `search_term` or `document_types` beside `document_id` with `filter_requires_list_mode`. IDs are case-insensitive
|
|
98
|
+
- List mode takes `docket_id`, the Regulations.gov docket ID (e.g. `EPA-HQ-OAR-2025-0194`) — `regulationsGovDocketId` on a search or open-comments row, `docketId` from `regulations_get_document`, not a printed `docketIds` entry. `search_term` keeps the documents whose text matches, ranked by relevance instead of newest first; `document_types` filters to `Proposed Rule`, `Rule`, `Notice`, `Supporting & Related Material`, or `Other`, and combines with it; `per_page` from 5 (default 25; above 250 serves 250 with a notice), `page` 1–40
|
|
99
|
+
- List mode returns the docket's metadata, `documentCount`, and `documents[]`, each with an `objectId` for `regulations_find_comments`, a `frDocNum` back to `regulations_get_document`, and `commentPeriodOpen` as Regulations.gov reports it. `totalPages` and `nextPage` page the documents; Regulations.gov serves 40 pages, so `truncated` marks a docket larger than 40 × `per_page` (10,000 at 250)
|
|
100
|
+
- Detail mode takes `document_id` (`documentId` from a listing, or `regulationsGovDocumentId` from `regulations_get_document`) and returns one `document` with `fileFormats` (the main file's download URLs), `attachments` in upload order with withheld ones kept, `pageCount`, `abstract`, and `restrictReasonType`. A document whose content is only in attachments, or that has no file at all, gets a notice saying so
|
|
93
101
|
|
|
94
102
|
---
|
|
95
103
|
|
|
96
104
|
### `regulations_find_comments` <sub>tool</sub> · key required
|
|
97
105
|
|
|
98
|
-
- Exactly one of `docket_id`, `document_object_id`, `fr_document_number`, or `comment_id`; list scopes take `per_page` 5
|
|
99
|
-
- `document_object_id` takes an object ID (`0900006485883ec6`) or a document ID (`EPA-HQ-OW-2022-0114-0027`). `fr_document_number` resolves to the Regulations.gov document carrying that exact number and answers `not_found` when none does
|
|
106
|
+
- Exactly one of `docket_id`, `document_object_id`, `fr_document_number`, or `comment_id`; list scopes take `per_page` from 5 (default 25; above 250 serves 250 with a notice) and `page` 1–40
|
|
107
|
+
- `document_object_id` takes an object ID (`0900006485883ec6`) or a document ID (`EPA-HQ-OW-2022-0114-0027`). `fr_document_number` resolves to the Regulations.gov document carrying that exact number and answers `not_found` when none does. Docket, document, and comment IDs are case-insensitive
|
|
108
|
+
- A `docket_id` that lists no comments is looked up: a docket Regulations.gov does not hold (a printed docket number such as `REG-101355-26`) answers `not_found`, and an existing docket answers an empty list with a notice
|
|
100
109
|
- Lists narrow by comment text with `search_term`, and each hit then carries `highlightedContent`, the matched passages. `posted_after` / `posted_before` set an inclusive posted-date window. A backwards window fails with `date_range_inverted`, and filters passed with `comment_id` fail with `filter_requires_list_mode`
|
|
101
|
-
- `mode` is `list` or `detail`. Lists return comment summaries without body text. `comment_id` returns the body, submitter, `receivedDate`, `postmarkDate`, `duplicateComments` (above 1 marks a mass-mail campaign record), and `attachments
|
|
110
|
+
- `mode` is `list` or `detail`. Lists return comment summaries without body text. `comment_id` returns the body, submitter, agency-supplied `subtype` and `category` (`null` when absent), `receivedDate`, `postmarkDate`, `duplicateComments` (above 1 marks a mass-mail campaign record), and `attachments` in upload order. `attachmentOnly: true` identifies attachments accompanied by an empty body or a recognized short cover note; substantive inline text stays false. An attachment whose file is withheld stays in the list with empty `formats` and its `restrictReasonType` (e.g. `Copyrighted`). Lists carry `totalPages` and `nextPage`; `truncated` marks a set larger than the 40 pages Regulations.gov serves reach (40 × `per_page`, 10,000 at 250), and posted-date windows take it one slice at a time
|
|
102
111
|
|
|
103
112
|
---
|
|
104
113
|
|
|
105
114
|
### `regulations_list_open_comments` <sub>tool</sub>
|
|
106
115
|
|
|
107
|
-
- Optional `query`, `type` (`PRORULE`, `RULE`, `NOTICE`; default `["PRORULE", "RULE"]`), `agencies` (
|
|
116
|
+
- Optional `query`, `type` (`PRORULE`, `RULE`, `NOTICE`; default `["PRORULE", "RULE"]`), `agencies` (slugs, exact catalog names, or acronyms, resolved as in `regulations_search_rules`), and `closing_before`; `per_page` from 1 (default 20; above 100 serves 100 with a notice)
|
|
108
117
|
- Rows sort by closing date, soonest first, and carry `commentsCloseOn`, `daysRemaining`, `documentNumber`, the printed `docketIds`, `regulationsGovDocketId` and `regulationsGovDocumentId`, `commentCount`, and `commentUrl`. `asOf` is today's date in Eastern time, so a document stays listed through its close day. `totalPages` and `nextPage` page the window; `truncated` means the Federal Register's 10,000-document limit was reached
|
|
109
118
|
- Keyless. `keyed` reports whether `REGULATIONS_GOV_API_KEY` is set, which `regulations_get_docket` and `regulations_find_comments` need to follow up on a row
|
|
110
119
|
|
|
@@ -120,7 +129,7 @@ The two data resources mirror `regulations_get_document` and `regulations_get_cf
|
|
|
120
129
|
### `regulations://cfr/{title}/{part}/{section}` <sub>resource</sub>
|
|
121
130
|
|
|
122
131
|
- Sections only, at the current date and the tool's default 64,000-character window; the `part` and `section` segments resolve the way the tool resolves them (`"Part 141"`; `"61"`, `"§ 141.61"`, `"40 CFR 141.61"`)
|
|
123
|
-
- `source` (`mirror` / `live`) reports provenance. `bodyTextNextOffset` marks a section longer than the window; read the rest through `regulations_get_cfr_section` with `offset`
|
|
132
|
+
- `source` (`mirror` / `live`) reports provenance, and `notice` says how a part or section written another way resolved and when `hierarchyPath` holds only the cited levels. `bodyTextNextOffset` marks a section longer than the window; read the rest through `regulations_get_cfr_section` with `offset`
|
|
124
133
|
|
|
125
134
|
## Features
|
|
126
135
|
|
|
@@ -138,7 +147,7 @@ Agent-friendly output:
|
|
|
138
147
|
|
|
139
148
|
- Provenance: `source: "mirror" | "live"` on every CFR read, plus a `sourceScope` line on search naming what the corpus covers
|
|
140
149
|
- Honest paging: `totalPages` and `nextPage` say how far a list goes, a page past the end names the last page instead of reading as "nothing matched", and matches beyond the Federal Register's 50 pages or Regulations.gov's 40 surface through `truncated` and `notice`, never as silently dropped rows
|
|
141
|
-
- Attachment-aware comments: `attachmentOnly` flags
|
|
150
|
+
- Attachment-aware comments: `attachmentOnly` flags attachments accompanied by an empty body or a recognized cover note. Download URLs are included when available
|
|
142
151
|
|
|
143
152
|
## Getting started
|
|
144
153
|
|
|
@@ -180,6 +189,8 @@ Set optional `REGULATIONS_GOV_API_KEY` to enable docket and comment tools; get a
|
|
|
180
189
|
| `ECFR_MIRROR_PATH` | Path to the eCFR SQLite mirror database. | `./data/ecfr-mirror.sqlite` |
|
|
181
190
|
| `ECFR_MIRROR_REFRESH_CRON` | Cron expression for an in-process mirror refresh (HTTP transport only), e.g. `0 4 * * 0`. Each run re-harvests every configured title in full. | none (no job) |
|
|
182
191
|
| `ECFR_MIRROR_TITLES` | Comma-separated CFR titles to mirror (e.g. `21,40`). Reads and searches outside the set, and all-titles searches, go to the live eCFR API. | all 50 titles |
|
|
192
|
+
| `REGULATIONS_CLAMP_LIMITS` | Serve a `per_page` or `max_chars` above its ceiling at the ceiling, with a notice. `false` advertises the ceiling as a schema maximum and rejects a larger value instead. | `true` |
|
|
193
|
+
| `REGULATIONS_RESOLVE_AGENCIES` | Resolve Federal Register agency names and acronyms to slugs. `false` sends agency values unchanged without a catalog lookup. | `true` |
|
|
183
194
|
| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http`. | `stdio` |
|
|
184
195
|
| `MCP_HTTP_PORT` | HTTP server port. | `3010` |
|
|
185
196
|
| `MCP_AUTH_MODE` | Authentication: `none`, `jwt`, or `oauth`. | `none` |
|
|
@@ -193,7 +204,7 @@ See [`.env.example`](./.env.example) for the full list of optional overrides.
|
|
|
193
204
|
|
|
194
205
|
### Local development
|
|
195
206
|
|
|
196
|
-
Requires Bun v1.4.
|
|
207
|
+
Requires Bun v1.4.4 or higher (or Node.js v24+).
|
|
197
208
|
|
|
198
209
|
```sh
|
|
199
210
|
git clone https://github.com/cyanheads/federal-regulations-mcp-server.git
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
---
|
|
2
|
+
summary: "Search executive orders and other presidential documents by number, president, and signing date, list a CFR section's amendment dates, search a docket's documents for file downloads, and clamp oversized page sizes instead of rejecting them."
|
|
3
|
+
breaking: false
|
|
4
|
+
security: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# 0.6.1 — 2026-10-29
|
|
8
|
+
|
|
9
|
+
## Added
|
|
10
|
+
|
|
11
|
+
- **`regulations_search_rules` filters** — `executive_order_number`, `presidential_document_type`, `president`, `signed_after`/`signed_before`, `significant`, and `effective_after`/`effective_before`. A combination that cannot match (an executive-order filter with `type: RULE`) answers `type_conflict` before any request (#66).
|
|
12
|
+
- **`significant` and `presidential`** — on `regulations_get_document`, search rows, and the `document` resource: `significant` is a boolean or null; `presidential` carries type, number, signing date, and president, and is null for non-presidential documents (#66).
|
|
13
|
+
- **`regulations_browse_cfr` `mode: "versions"`** — lists the dates a part's or one section's codified text changed (`section`, `changed_since`); each date reads through `regulations_get_cfr_section`'s `date` (#67).
|
|
14
|
+
- **`regulations_get_docket` `search_term`** — relevance-ranked document search within a docket (#68).
|
|
15
|
+
- **`regulations_get_docket` `document_id`** — detail mode returning the document's file download links (format, size, page count) and attachments (#68).
|
|
16
|
+
- **`REGULATIONS_CLAMP_LIMITS`** — `false` restores strict rejection of an over-ceiling `per_page` or `max_chars` (#70).
|
|
17
|
+
|
|
18
|
+
## Changed
|
|
19
|
+
|
|
20
|
+
- **`per_page` and `max_chars` ceilings** — a value above a tool's ceiling is served at the ceiling with a notice naming the requested and applied values, on all seven tools; it was rejected with a validation error (#70).
|
|
21
|
+
- **`regulations_search_rules` truncation guidance** — names the new filters.
|
|
22
|
+
- **Documentation** — the README, design doc, and published guide skill describe the new surface.
|
|
23
|
+
|
|
24
|
+
## Fixed
|
|
25
|
+
|
|
26
|
+
- **`regulations_find_comments` unknown docket** — a docket Regulations.gov does not hold answers `not_found`; it returned an empty success (#69).
|
|
27
|
+
- **Lowercase Regulations.gov IDs** — `regulations_get_docket`'s `docket_id` and `regulations_find_comments`' `comment_id` and `document_object_id` (a document ID) resolve a lowercase ID; they answered `not_found` (#69).
|
|
28
|
+
- **`regulations_get_cfr_section` hierarchy failure** — when eCFR's hierarchy lookup fails, the tool and the `cfr-section` resource return the text with a path built from the cited levels (`Title 40 › Part 141 › § 141.61`) and a notice; the path was a bare `Title 40` with no notice. The lookup gets one attempt of at most 8 seconds (#71).
|
|
29
|
+
- **`regulations_find_comments` attachments** — every attachment is listed in upload order (`docOrder`), including ones with no downloadable file (`formats: []` plus `restrictReasonType`, e.g. `Copyrighted`); those were dropped and the rest listed in the order Regulations.gov returned them (#73).
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
---
|
|
2
|
+
summary: "Search by agency name or acronym and see the upstream total for supporting documents."
|
|
3
|
+
breaking: false
|
|
4
|
+
security: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# 0.6.2 — 2026-11-13
|
|
8
|
+
|
|
9
|
+
## Added
|
|
10
|
+
|
|
11
|
+
- **Agency filters** in `regulations_search_rules` and `regulations_list_open_comments` accept exact Federal Register names and acronyms case-insensitively. Set `REGULATIONS_RESOLVE_AGENCIES=false` to use slugs only. ([#78](https://github.com/cyanheads/federal-regulations-mcp-server/issues/78))
|
|
12
|
+
- **Comment detail** includes the nullable Regulations.gov `subtype` and `category` fields. ([#77](https://github.com/cyanheads/federal-regulations-mcp-server/issues/77))
|
|
13
|
+
|
|
14
|
+
## Changed
|
|
15
|
+
|
|
16
|
+
- **Runtime requirements** raise the Bun minimum from 1.4.0 to 1.4.4.
|
|
17
|
+
- **Resource listings** preserve the display titles of the example CFR section and Federal Register document across the framework upgrade.
|
|
18
|
+
- **Development tooling** rejects invalid arguments to `devcheck` and `release:github`. An explicit `devcheck --only` selection can run opt-in checks.
|
|
19
|
+
|
|
20
|
+
## Fixed
|
|
21
|
+
|
|
22
|
+
- **Supporting documents** include the upstream total in document tool and resource results. The tool flags partial lists and directs callers to the docket when a docket ID is available. ([#75](https://github.com/cyanheads/federal-regulations-mcp-server/issues/75))
|
|
23
|
+
- **Comment detail** identifies recognized cover notes as attachment-only when attachments are present. ([#76](https://github.com/cyanheads/federal-regulations-mcp-server/issues/76))
|
|
24
|
+
- **Federal Register text** renders GPO subscripts, superscripts, and bullets in abstracts and full text. Full-text offsets count the rendered text. ([#82](https://github.com/cyanheads/federal-regulations-mcp-server/issues/82))
|
|
25
|
+
- **Startup configuration** loads `.env` before reading server settings and gives explicit environment variables precedence.
|
|
26
|
+
- **Scheduled eCFR mirror refresh** skips a run when another sync holds the mirror lease.
|
|
27
|
+
- **Desktop bundles** retain the MCP SDK's runtime Skills extension while removing agent documentation from dependency package roots.
|
|
28
|
+
|
|
29
|
+
## Dependencies
|
|
30
|
+
|
|
31
|
+
- `@cyanheads/mcp-ts-core` 0.13.18 → ^0.13.22
|
|
32
|
+
- `entities` ^8.1.0 → ^9.0.0
|
|
33
|
+
- `@biomejs/biome` 2.6.3 → 2.6.7
|
|
34
|
+
- `@types/node` 26.6.5 → 26.6.6
|
|
35
|
+
- `better-sqlite3` ^13.0.3 → ^13.1.1
|
|
36
|
+
- `tsc-alias` ^1.9.9 → ^1.9.10
|
|
37
|
+
- `vitest` ^5.0.5 → ^5.1.0
|
package/changelog/template.md
CHANGED
|
@@ -116,14 +116,21 @@ security: false
|
|
|
116
116
|
resolves to whatever real item already owns 42, and timeline previews pull
|
|
117
117
|
in that unrelated item's metadata.
|
|
118
118
|
|
|
119
|
+
Outside reporters: when the issue or PR came from outside the project
|
|
120
|
+
(`git-wrapup` step 5 says how to tell), thank its author in the same
|
|
121
|
+
parenthetical, profile linked by full URL for the same reason:
|
|
122
|
+
|
|
123
|
+
([#38](https://github.com/cyanheads/mcp-ts-core/issues/38), thanks [@octocat](https://github.com/octocat)!)
|
|
124
|
+
|
|
119
125
|
TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
|
|
120
126
|
via `gh release create --notes-from-tag`. It is a condensed digest of this
|
|
121
127
|
entry, never a copy, and its format is owned by the `release-and-publish`
|
|
122
128
|
skill (step 4, "Create the annotated tag"): a short subject line without the
|
|
123
129
|
version, flat headline bullets — no Keep-a-Changelog section headers, no
|
|
124
|
-
gates line — at most one deps line, issue backlinks
|
|
125
|
-
last. In release-PR mode the `git-wrapup`
|
|
126
|
-
PR body's `## Changes` and the tag copies
|
|
130
|
+
gates line — at most one deps line, issue backlinks with any outside-reporter
|
|
131
|
+
thanks, and the changelog link last. In release-PR mode the `git-wrapup`
|
|
132
|
+
skill authors those bullets as the PR body's `## Changes` and the tag copies
|
|
133
|
+
them.
|
|
127
134
|
-->
|
|
128
135
|
|
|
129
136
|
## Added
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
* @fileoverview Server-specific environment configuration for
|
|
3
3
|
* federal-regulations-mcp-server. Lazy-parsed Zod schema, separate from the
|
|
4
4
|
* framework's own config. Maps the three data-source base URLs, the optional
|
|
5
|
-
* Regulations.gov API key,
|
|
5
|
+
* Regulations.gov API key, the eCFR mirror settings, and whether an over-ceiling
|
|
6
|
+
* page size or text window is clamped or rejected.
|
|
6
7
|
*
|
|
7
8
|
* `REGULATIONS_GOV_API_KEY` is optional: the keyless core (Federal Register +
|
|
8
9
|
* eCFR tools) is a complete deployment without it. The two Regulations.gov tools
|
|
@@ -20,12 +21,14 @@ declare const ServerConfigSchema: z.ZodObject<{
|
|
|
20
21
|
ecfrMirrorPath: z.ZodDefault<z.ZodString>;
|
|
21
22
|
ecfrMirrorRefreshCron: z.ZodOptional<z.ZodString>;
|
|
22
23
|
ecfrMirrorTitles: z.ZodOptional<z.ZodString>;
|
|
24
|
+
clampLimits: z.ZodDefault<z.ZodCodec<z.ZodString, z.ZodBoolean>>;
|
|
25
|
+
resolveAgencies: z.ZodDefault<z.ZodCodec<z.ZodString, z.ZodBoolean>>;
|
|
23
26
|
}, z.core.$strip>;
|
|
24
27
|
export type ServerConfig = z.infer<typeof ServerConfigSchema>;
|
|
25
28
|
/**
|
|
26
29
|
* Lazily parse and cache the server config from the environment. Throws a
|
|
27
|
-
* `ConfigurationError`
|
|
28
|
-
* value fails validation.
|
|
30
|
+
* `ConfigurationError` when the environment file cannot be read or a
|
|
31
|
+
* configured value fails validation.
|
|
29
32
|
*/
|
|
30
33
|
export declare function getServerConfig(): ServerConfig;
|
|
31
34
|
export {};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAI3C,QAAA,MAAM,kBAAkB;;;;;;;;;;iBA2CtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,YAAY,CA2B9C"}
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
* @fileoverview Server-specific environment configuration for
|
|
3
3
|
* federal-regulations-mcp-server. Lazy-parsed Zod schema, separate from the
|
|
4
4
|
* framework's own config. Maps the three data-source base URLs, the optional
|
|
5
|
-
* Regulations.gov API key,
|
|
5
|
+
* Regulations.gov API key, the eCFR mirror settings, and whether an over-ceiling
|
|
6
|
+
* page size or text window is clamped or rejected.
|
|
6
7
|
*
|
|
7
8
|
* `REGULATIONS_GOV_API_KEY` is optional: the keyless core (Federal Register +
|
|
8
9
|
* eCFR tools) is a complete deployment without it. The two Regulations.gov tools
|
|
@@ -11,8 +12,10 @@
|
|
|
11
12
|
*
|
|
12
13
|
* @module config/server-config
|
|
13
14
|
*/
|
|
15
|
+
import process from 'node:process';
|
|
14
16
|
import { z } from '@cyanheads/mcp-ts-core';
|
|
15
17
|
import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
|
|
18
|
+
import { configurationError } from '@cyanheads/mcp-ts-core/errors';
|
|
16
19
|
const ServerConfigSchema = z.object({
|
|
17
20
|
/** api.data.gov key for the Regulations.gov leg. Absent = keyless-core deployment. */
|
|
18
21
|
regulationsGovApiKey: z
|
|
@@ -42,15 +45,37 @@ const ServerConfigSchema = z.object({
|
|
|
42
45
|
.string()
|
|
43
46
|
.optional()
|
|
44
47
|
.describe('Comma-separated CFR title numbers to scope the mirror to (e.g. "21,40"). Omit to mirror all 50 titles. A partial mirror still serves its baked titles from the index; cites outside the set fall through to the live eCFR API.'),
|
|
48
|
+
clampLimits: z
|
|
49
|
+
.stringbool()
|
|
50
|
+
.default(true)
|
|
51
|
+
.describe('Serve a per_page or max_chars above its ceiling at the ceiling, with a notice. false advertises and enforces the ceiling as a schema maximum instead.'),
|
|
52
|
+
resolveAgencies: z
|
|
53
|
+
.stringbool()
|
|
54
|
+
.default(true)
|
|
55
|
+
.describe('Accept Federal Register agency names and acronyms in addition to agency slugs.'),
|
|
45
56
|
});
|
|
46
57
|
let _config;
|
|
47
58
|
/**
|
|
48
59
|
* Lazily parse and cache the server config from the environment. Throws a
|
|
49
|
-
* `ConfigurationError`
|
|
50
|
-
* value fails validation.
|
|
60
|
+
* `ConfigurationError` when the environment file cannot be read or a
|
|
61
|
+
* configured value fails validation.
|
|
51
62
|
*/
|
|
52
63
|
export function getServerConfig() {
|
|
53
|
-
|
|
64
|
+
if (_config)
|
|
65
|
+
return _config;
|
|
66
|
+
// The mirror reads its path during import, before createApp loads .env.
|
|
67
|
+
// Native loading keeps variables supplied by the process environment.
|
|
68
|
+
try {
|
|
69
|
+
process.loadEnvFile();
|
|
70
|
+
}
|
|
71
|
+
catch (error) {
|
|
72
|
+
if (!(error instanceof Error && 'code' in error && error.code === 'ENOENT')) {
|
|
73
|
+
throw configurationError('Failed to load .env from the working directory.', undefined, {
|
|
74
|
+
cause: error,
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
_config = parseEnvConfig(ServerConfigSchema, {
|
|
54
79
|
regulationsGovApiKey: 'REGULATIONS_GOV_API_KEY',
|
|
55
80
|
federalRegisterBaseUrl: 'FEDERAL_REGISTER_BASE_URL',
|
|
56
81
|
ecfrBaseUrl: 'ECFR_BASE_URL',
|
|
@@ -58,6 +83,8 @@ export function getServerConfig() {
|
|
|
58
83
|
ecfrMirrorPath: 'ECFR_MIRROR_PATH',
|
|
59
84
|
ecfrMirrorRefreshCron: 'ECFR_MIRROR_REFRESH_CRON',
|
|
60
85
|
ecfrMirrorTitles: 'ECFR_MIRROR_TITLES',
|
|
86
|
+
clampLimits: 'REGULATIONS_CLAMP_LIMITS',
|
|
87
|
+
resolveAgencies: 'REGULATIONS_RESOLVE_AGENCIES',
|
|
61
88
|
});
|
|
62
89
|
return _config;
|
|
63
90
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,sFAAsF;IACtF,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,6EAA6E,CAAC;IAC1F,sBAAsB,EAAE,CAAC;SACtB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,wCAAwC,CAAC;SACjD,QAAQ,CAAC,mCAAmC,CAAC;IAChD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IAChG,qBAAqB,EAAE,CAAC;SACrB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,gCAAgC,CAAC;SACzC,QAAQ,CAAC,kCAAkC,CAAC;IAC/C,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,OAAO,CAAC,2BAA2B,CAAC;SACpC,QAAQ,CAAC,sDAAsD,CAAC;IACnE,qBAAqB,EAAE,CAAC;SACrB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,2JAA2J,CAC5J;IACH,gBAAgB,EAAE,CAAC;SAChB,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,gOAAgO,CACjO;IACH,WAAW,EAAE,CAAC;SACX,UAAU,EAAE;SACZ,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CACP,uJAAuJ,CACxJ;IACH,eAAe,EAAE,CAAC;SACf,UAAU,EAAE;SACZ,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,gFAAgF,CAAC;CAC9F,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,wEAAwE;IACxE,sEAAsE;IACtE,IAAI,CAAC;QACH,OAAO,CAAC,WAAW,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;YAC5E,MAAM,kBAAkB,CAAC,iDAAiD,EAAE,SAAS,EAAE;gBACrF,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,GAAG,cAAc,CAAC,kBAAkB,EAAE;QAC3C,oBAAoB,EAAE,yBAAyB;QAC/C,sBAAsB,EAAE,2BAA2B;QACnD,WAAW,EAAE,eAAe;QAC5B,qBAAqB,EAAE,0BAA0B;QACjD,cAAc,EAAE,kBAAkB;QAClC,qBAAqB,EAAE,0BAA0B;QACjD,gBAAgB,EAAE,oBAAoB;QACtC,WAAW,EAAE,0BAA0B;QACvC,eAAe,EAAE,8BAA8B;KAChD,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}
|
package/dist/index.js
CHANGED
|
@@ -32,7 +32,7 @@ await createApp({
|
|
|
32
32
|
resources: allResourceDefinitions,
|
|
33
33
|
skills: 'skills',
|
|
34
34
|
prompts: [],
|
|
35
|
-
instructions: "US federal regulatory law over three official sources. The Federal Register (regulations_search_rules, regulations_get_document, regulations_list_open_comments) and eCFR (regulations_browse_cfr, regulations_get_cfr_section) tools are keyless. The Regulations.gov tools (regulations_get_docket, regulations_find_comments) need REGULATIONS_GOV_API_KEY (free at https://api.data.gov/signup/) and return an actionable auth_required error without it; comment counts and Regulations.gov IDs on the Federal Register tools need no key. Trace a rule end to end: search_rules → get_document (yields docket ID + CFR parts) → find_comments → get_cfr_section, and back from a section's source-note cite with search_rules citation + citation_date.",
|
|
35
|
+
instructions: "US federal regulatory law over three official sources. The Federal Register (regulations_search_rules, regulations_get_document, regulations_list_open_comments) and eCFR (regulations_browse_cfr, regulations_get_cfr_section) tools are keyless. The Regulations.gov tools (regulations_get_docket, regulations_find_comments) need REGULATIONS_GOV_API_KEY (free at https://api.data.gov/signup/) and return an actionable auth_required error without it; comment counts and Regulations.gov IDs on the Federal Register tools need no key. Trace a rule end to end: search_rules → get_document (yields docket ID + CFR parts) → find_comments → get_cfr_section, and back from a section's source-note cite with search_rules citation + citation_date; browse_cfr versions mode lists when a section's text changed, and each row's date reads that version through get_cfr_section.",
|
|
36
36
|
setup(core) {
|
|
37
37
|
initFederalRegisterService(core.config, core.storage);
|
|
38
38
|
initEcfrService(core.config, core.storage);
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,yDAAyD,CAAC;AACrG,OAAO,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AAElG,MAAM,SAAS,CAAC;IACd,IAAI,EAAE,gCAAgC;IACtC,KAAK,EAAE,gCAAgC;IACvC,+EAA+E;IAC/E,wEAAwE;IACxE,yEAAyE;IACzE,2EAA2E;IAC3E,wEAAwE;IACxE,WAAW,EAAE,WAAW;IACxB,KAAK,EAAE,kBAAkB;IACzB,SAAS,EAAE,sBAAsB;IACjC,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,EAAE;IACX,YAAY,EACV
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AACjG,OAAO,EAAE,0BAA0B,EAAE,MAAM,yDAAyD,CAAC;AACrG,OAAO,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AAElG,MAAM,SAAS,CAAC;IACd,IAAI,EAAE,gCAAgC;IACtC,KAAK,EAAE,gCAAgC;IACvC,+EAA+E;IAC/E,wEAAwE;IACxE,yEAAyE;IACzE,2EAA2E;IAC3E,wEAAwE;IACxE,WAAW,EAAE,WAAW;IACxB,KAAK,EAAE,kBAAkB;IACzB,SAAS,EAAE,sBAAsB;IACjC,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,EAAE;IACX,YAAY,EACV,61BAA61B;IAC/1B,KAAK,CAAC,IAAI;QACR,0BAA0B,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACtD,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,yBAAyB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACrD,uEAAuE;QACvE,KAAK,qBAAqB,CACxB,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAC5B,eAAe,EAAE,CAAC,qBAAqB,CACxC,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,QAAQ;QACZ,MAAM,iBAAiB,EAAE,CAAC;QAC1B,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF,CAAC,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cfr-section.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/cfr-section.resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAMjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"cfr-section.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/cfr-section.resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAMjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;GAkG7B,CAAC"}
|
|
@@ -22,7 +22,7 @@ import { DEFAULT_WINDOW_CHARS, windowText } from '../../../services/text-window.
|
|
|
22
22
|
export const cfrSectionResource = resource('regulations://cfr/{title}/{part}/{section}', {
|
|
23
23
|
name: 'cfr-section',
|
|
24
24
|
title: 'CFR section (current)',
|
|
25
|
-
description: 'Codified text of a current CFR section by title/part/section (e.g. regulations://cfr/40/50/50.1). Mirrors regulations_get_cfr_section at the current date and its default 64,000-character window — mirror-backed with a live eCFR fallback. The part and section resolve as the tool resolves them ("Part 141"; "61", "§ 141.61", "141.61(c)", "40 CFR 141.61"); `part` and `section` name what was read and `notice` says how. When bodyTextNextOffset is present the section runs past the window — read on through regulations_get_cfr_section with that offset. Sections only; read an appendix through regulations_get_cfr_section with its `appendix` input.',
|
|
25
|
+
description: 'Codified text of a current CFR section by title/part/section (e.g. regulations://cfr/40/50/50.1). Mirrors regulations_get_cfr_section at the current date and its default 64,000-character window — mirror-backed with a live eCFR fallback. The part and section resolve as the tool resolves them ("Part 141"; "61", "§ 141.61", "141.61(c)", "40 CFR 141.61"); `part` and `section` name what was read and `notice` says how, and also when hierarchyPath holds only the cited levels because eCFR could not supply the rest. When bodyTextNextOffset is present the section runs past the window — read on through regulations_get_cfr_section with that offset. Sections only; read an appendix through regulations_get_cfr_section with its `appendix` input.',
|
|
26
26
|
mimeType: 'application/json',
|
|
27
27
|
params: z.object({
|
|
28
28
|
title: z
|
|
@@ -68,9 +68,11 @@ export const cfrSectionResource = resource('regulations://cfr/{title}/{part}/{se
|
|
|
68
68
|
throw ctx.fail('not_found', `No codified text found for ${sectionCite(titleNum, part, read.section)} as of ${read.date}${tried}.`, { title: titleNum, part, section, date: read.date });
|
|
69
69
|
}
|
|
70
70
|
const resolved = read.result.section ?? section;
|
|
71
|
-
const
|
|
71
|
+
const path = await getEcfrService().hierarchyPath(titleNum, { part, section: resolved }, read.result.date, ctx);
|
|
72
72
|
const cut = windowText(read.result.bodyText, { offset: 0, maxChars: DEFAULT_WINDOW_CHARS });
|
|
73
|
-
const notice = [describePartRewrite(written, part), read.rewrite]
|
|
73
|
+
const notice = [describePartRewrite(written, part), read.rewrite, path.notice]
|
|
74
|
+
.filter(Boolean)
|
|
75
|
+
.join(' ');
|
|
74
76
|
return {
|
|
75
77
|
cfrCite: sectionCite(titleNum, part, resolved),
|
|
76
78
|
title: titleNum,
|
|
@@ -78,7 +80,7 @@ export const cfrSectionResource = resource('regulations://cfr/{title}/{part}/{se
|
|
|
78
80
|
section: resolved,
|
|
79
81
|
appendix: null,
|
|
80
82
|
heading: read.result.heading,
|
|
81
|
-
hierarchyPath,
|
|
83
|
+
hierarchyPath: path.path,
|
|
82
84
|
date: read.result.date,
|
|
83
85
|
source: read.source,
|
|
84
86
|
bodyText: cut.text,
|
|
@@ -93,6 +95,7 @@ export const cfrSectionResource = resource('regulations://cfr/{title}/{part}/{se
|
|
|
93
95
|
{
|
|
94
96
|
uri: 'regulations://cfr/40/50/50.1',
|
|
95
97
|
name: 'Example CFR section (40 CFR 50.1)',
|
|
98
|
+
title: 'CFR section (current)',
|
|
96
99
|
mimeType: 'application/json',
|
|
97
100
|
},
|
|
98
101
|
],
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cfr-section.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/cfr-section.resource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE7E,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC,4CAA4C,EAAE;IACvF,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EACT,
|
|
1
|
+
{"version":3,"file":"cfr-section.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/cfr-section.resource.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"document.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/document.resource.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAOjE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"document.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/document.resource.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAOjE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;GAsD3B,CAAC"}
|
|
@@ -12,7 +12,7 @@ import { getFederalRegisterService } from '../../../services/federal-register/fe
|
|
|
12
12
|
export const documentResource = resource('regulations://document/{documentNumber}', {
|
|
13
13
|
name: 'federal-register-document',
|
|
14
14
|
title: 'Federal Register document',
|
|
15
|
-
description: 'A single Federal Register document by FR number: metadata, citation and pages, and the cross-source handles (Regulations.gov docket and document IDs, printed docket numbers, affected CFR parts, comment count and comment URL) that chain into the search, comment, and codified-text tools. Mirrors regulations_get_document (full text omitted).',
|
|
15
|
+
description: 'A single Federal Register document by FR number: metadata, citation and pages, EO 12866 significance, presidential-document identifiers (subtype, number, signing date, president), and the cross-source handles (Regulations.gov docket and document IDs, printed docket numbers, affected CFR parts, comment count and comment URL) that chain into the search, comment, and codified-text tools. Mirrors regulations_get_document (full text omitted).',
|
|
16
16
|
mimeType: 'application/json',
|
|
17
17
|
/**
|
|
18
18
|
* Validated as the template hands it over: the pattern admits only unreserved
|
|
@@ -48,6 +48,7 @@ export const documentResource = resource('regulations://document/{documentNumber
|
|
|
48
48
|
{
|
|
49
49
|
uri: 'regulations://document/2025-14555',
|
|
50
50
|
name: 'Example Federal Register document',
|
|
51
|
+
title: 'Federal Register document',
|
|
51
52
|
mimeType: 'application/json',
|
|
52
53
|
},
|
|
53
54
|
],
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"document.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/document.resource.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EACL,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yDAAyD,CAAC;AAEpG,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,yCAAyC,EAAE;IAClF,IAAI,EAAE,2BAA2B;IACjC,KAAK,EAAE,2BAA2B;IAClC,WAAW,EACT,
|
|
1
|
+
{"version":3,"file":"document.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/document.resource.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EACL,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,yDAAyD,CAAC;AAEpG,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,yCAAyC,EAAE;IAClF,IAAI,EAAE,2BAA2B;IACjC,KAAK,EAAE,2BAA2B;IAClC,WAAW,EACT,2bAA2b;IAC7b,QAAQ,EAAE,kBAAkB;IAC5B;;;;OAIG;IACH,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,cAAc,EAAE,gBAAgB,EAAE,CAAC,QAAQ,CACzC,2IAA2I,CAC5I;KACF,CAAC;IACF,MAAM,EAAE;QACN;YACE,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,gBAAgB,CAAC,QAAQ;YAC/B,IAAI,EAAE,uDAAuD;YAC7D,QAAQ,EACN,6HAA6H;SAChI;QACD;YACE,MAAM,EAAE,sBAAsB;YAC9B,IAAI,EAAE,gBAAgB,CAAC,kBAAkB;YACzC,IAAI,EAAE,2EAA2E;YACjF,QAAQ,EAAE,6EAA6E;SACxF;KACF;IAED,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,MAAM,OAAO,GAAG,yBAAyB,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,WAAW,CACtC,yBAAyB,CAAC,MAAM,CAAC,cAAc,CAAC,EAChD,SAAS,EACT,GAAG,CACJ,CAAC;QACF,6EAA6E;QAC7E,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QACX,SAAS,EAAE;YACT;gBACE,GAAG,EAAE,mCAAmC;gBACxC,IAAI,EAAE,mCAAmC;gBACzC,KAAK,EAAE,2BAA2B;gBAClC,QAAQ,EAAE,kBAAkB;aAC7B;SACF;KACF,CAAC;CACH,CAAC,CAAC"}
|