@cyanheads/congressgov-mcp-server 0.4.2 → 0.4.3

package/AGENTS.md

@@ -1,7 +1,7 @@
 # Agent Protocol
 
 **Server:** congressgov-mcp-server
-**Version:** 0.4.2
+**Version:** 0.4.3
 **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.11.5`
 **Engines:** Bun ≥1.3.0, Node ≥24.0.0
 **MCP SDK:** `@modelcontextprotocol/sdk` ^1.30.0

package/CLAUDE.md

@@ -1,7 +1,7 @@
 # Agent Protocol
 
 **Server:** congressgov-mcp-server
-**Version:** 0.4.2
+**Version:** 0.4.3
 **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.11.5`
 **Engines:** Bun ≥1.3.0, Node ≥24.0.0
 **MCP SDK:** `@modelcontextprotocol/sdk` ^1.30.0

package/README.md

@@ -7,7 +7,7 @@
 
 <div align="center">
 
-[![Version](https://img.shields.io/badge/Version-0.4.2-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.30.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-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.14-blueviolet.svg?style=flat-square)](https://bun.sh/)
+[![Version](https://img.shields.io/badge/Version-0.4.3-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.30.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-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.14-blueviolet.svg?style=flat-square)](https://bun.sh/)
 
 </div>
 

package/dist/mcp-server/tools/definitions/enacted-laws.tool.d.ts

@@ -13,7 +13,7 @@ export declare const enactedLawsTool: import("@cyanheads/mcp-ts-core").ToolDefin
         priv: "priv";
         pub: "pub";
     }>>;
-    lawNumber: z.ZodOptional<z.ZodNumber>;
+    lawNumber: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
     limit: z.ZodDefault<z.ZodNumber>;
     offset: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{

package/dist/mcp-server/tools/definitions/enacted-laws.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enacted-laws.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/enacted-laws.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAajD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4E1B,CAAC"}
+{"version":3,"file":"enacted-laws.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/enacted-laws.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAejD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiF1B,CAAC"}

package/dist/mcp-server/tools/definitions/enacted-laws.tool.js

@@ -5,7 +5,7 @@
 import { tool, z } from '@cyanheads/mcp-ts-core';
 import { validationError } from '@cyanheads/mcp-ts-core/errors';
 import { formatLaws } from '../../../mcp-server/tools/format-helpers.js';
-import { buildEffectiveQuery, congressErrorContracts, listEnrichment, listOrDetail, notifyIfNoMatches, } from '../../../mcp-server/tools/tool-helpers.js';
+import { buildEffectiveQuery, congressErrorContracts, lawNumberIdentifier, listEnrichment, listOrDetail, notifyIfNoMatches, toLawNumber, } from '../../../mcp-server/tools/tool-helpers.js';
 import { getCongressApi } from '../../../services/congress-api/congress-api-service.js';
 export const enactedLawsTool = tool('congressgov_enacted_laws', {
     description: `Browse enacted public and private laws from Congress.gov by congress and law type ('pub' for public laws, 'priv' for private). 'list' filters by enactment status and law type — the discovery path 'bill_lookup' does not offer. 'get' returns the origin bill record (sponsor, actions, summaries, text), with the public/private law citation on the bill's 'laws' array (e.g. {"number":"118-2","type":"Public Law"}).`,
@@ -18,7 +18,7 @@ export const enactedLawsTool = tool('congressgov_enacted_laws', {
             .enum(['pub', 'priv'])
             .optional()
             .describe("Law type — 'pub' (public laws, general application, most common) or 'priv' (private laws, specific individuals or entities). Required for 'get'."),
-        lawNumber: z.number().int().positive().optional().describe("Law number. Required for 'get'."),
+        lawNumber: lawNumberIdentifier("Law number, as carried by a 'list' row's `laws[].number` — either the full citation ('118-90', rendered as 'Public Law 118-90') or the portion after the hyphen ('90'); the prefix is the congress and must match `congress`. Not the row's own `number`, which is the origin bill. Required for 'get'.").optional(),
         limit: z.number().int().min(1).max(250).default(20).describe('Results per page (1-250).'),
         offset: z.number().int().min(0).default(0).describe('Pagination offset.'),
     }),
@@ -43,17 +43,19 @@ export const enactedLawsTool = tool('congressgov_enacted_laws', {
         if (!input.lawType || !input.lawNumber) {
             throw validationError("The 'get' operation requires lawType ('pub' or 'priv') and lawNumber. Use 'list' to browse laws by congress.", { lawType: input.lawType, lawNumber: input.lawNumber });
         }
+        /** List rows carry the law number only inside the `{congress}-{number}` citation. */
+        const lawNumber = toLawNumber(input.lawNumber, input.congress);
         const result = await api.getLaw({
             congress: input.congress,
             lawType: input.lawType,
-            lawNumber: input.lawNumber,
+            lawNumber,
         }, ctx);
         ctx.log.info('Law retrieved', {
             congress: input.congress,
             lawType: input.lawType,
-            lawNumber: input.lawNumber,
+            lawNumber,
         });
-        ctx.enrich.echo(`${input.lawType === 'pub' ? 'Public' : 'Private'} Law ${input.congress}-${input.lawNumber}`);
+        ctx.enrich.echo(`${input.lawType === 'pub' ? 'Public' : 'Private'} Law ${input.congress}-${lawNumber}`);
         ctx.enrich.total(1);
         return result;
     },

package/dist/mcp-server/tools/definitions/enacted-laws.tool.js.map

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

package/dist/mcp-server/tools/format-helpers.d.ts

@@ -6,6 +6,18 @@
  * NOT reliably forwarded. These formatters render complete, structured
  * markdown so the LLM can reason about all returned data.
  *
+ * **Completeness invariant.** A record reaching a detail renderer is rendered
+ * whole: every upstream field appears, and no value is cut mid-string. A
+ * hand-built header may curate presentation, but it ends in `renderDetailRest`,
+ * and a curated collection row ends in `withUnnamedFields` — so a field neither
+ * one names still reaches the reader. The single deliberate exception is a
+ * `{count, url}` sub-resource reference, rendered as "N available": the URL is
+ * the upstream REST endpoint, and the tool's own operation is the callable path
+ * to those rows. Caps belong to pagination, which has a continuation path
+ * (`pagination.nextOffset`, surfaced in every list header) — a nested collection
+ * inside one record has none, so slicing it would drop data no follow-up call
+ * could recover.
+ *
  * See: https://github.com/cyanheads/mcp-ts-core/issues/19
  *
  * @module mcp-server/tools/format-helpers

package/dist/mcp-server/tools/format-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format-helpers.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/format-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,KAAK,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAk3ChD,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAUxE;AAqCD,2DAA2D;AAC3D,eAAO,MAAM,eAAe,WAlEhB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,EAkEkB,CAAC;AAkCpE,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,WArGlB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,EAqGuB,CAAC;AAEzE,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAoB1E;AAWD,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAkB7E;AAED,kDAAkD;AAClD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CASnF;AAED,mCAAmC;AACnC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAK7E;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAY9E;AAED,8FAA8F;AAC9F,eAAO,MAAM,UAAU,WAhMX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,EAgMiC,CAAC;AAEnF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAcxE;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAa9E"}
+{"version":3,"file":"format-helpers.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/format-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,KAAK,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAohDhD,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAUxE;AAqCD,2DAA2D;AAC3D,eAAO,MAAM,eAAe,WAlEhB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,EAkEkB,CAAC;AAkCpE,qDAAqD;AACrD,eAAO,MAAM,iBAAiB,WArGlB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,EAqGuB,CAAC;AAEzE,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAoB1E;AAWD,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAkB7E;AAED,kDAAkD;AAClD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CASnF;AAED,mCAAmC;AACnC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAK7E;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAY9E;AAED,8FAA8F;AAC9F,eAAO,MAAM,UAAU,WAhMX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,EAgMiC,CAAC;AAEnF;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAcxE;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAa9E"}

package/dist/mcp-server/tools/format-helpers.js

@@ -6,6 +6,18 @@
  * NOT reliably forwarded. These formatters render complete, structured
  * markdown so the LLM can reason about all returned data.
  *
+ * **Completeness invariant.** A record reaching a detail renderer is rendered
+ * whole: every upstream field appears, and no value is cut mid-string. A
+ * hand-built header may curate presentation, but it ends in `renderDetailRest`,
+ * and a curated collection row ends in `withUnnamedFields` — so a field neither
+ * one names still reaches the reader. The single deliberate exception is a
+ * `{count, url}` sub-resource reference, rendered as "N available": the URL is
+ * the upstream REST endpoint, and the tool's own operation is the callable path
+ * to those rows. Caps belong to pagination, which has a continuation path
+ * (`pagination.nextOffset`, surfaced in every list header) — a nested collection
+ * inside one record has none, so slicing it would drop data no follow-up call
+ * could recover.
+ *
  * See: https://github.com/cyanheads/mcp-ts-core/issues/19
  *
  * @module mcp-server/tools/format-helpers
@@ -41,20 +53,40 @@ function stripHtml(html, { inline = false } = {}) {
         .replace(/\n{3,}/g, '\n\n')
         .trim();
 }
+/**
+ * Wrap an emphasis span's content in Markdown markers with the span's own
+ * boundary whitespace kept *outside* them.
+ *
+ * Congress.gov summaries routinely place a space inside the tag
+ * (`<em>de minimis </em>treatment`, `an<em> de minimis</em> threshold`).
+ * Substituting the marker in place produces `*de minimis *treatment` — markers
+ * that no Markdown parser binds as emphasis, and altered visible spacing either
+ * way. A span with no non-whitespace content gets no markers at all.
+ */
+function wrapEmphasis(inner, marker) {
+    const core = inner.trim();
+    if (!core)
+        return inner;
+    const lead = inner.slice(0, inner.length - inner.trimStart().length);
+    const trail = inner.slice(inner.trimEnd().length);
+    return `${lead}${marker}${core}${marker}${trail}`;
+}
 /**
  * Convert upstream HTML (Congress.gov bill summaries are returned with `<p>`,
  * `<strong>`, `<em>`, anchor tags) into readable Markdown that preserves
  * paragraph and emphasis structure.
+ *
+ * Emphasis is matched as a whole span rather than tag-by-tag so boundary
+ * whitespace can be normalized (see `wrapEmphasis`) and an unclosed tag falls
+ * through to the generic strip instead of leaving a stray marker.
  */
 function htmlToMarkdown(html) {
     return html
         .replace(/<\s*br\s*\/?\s*>/gi, '\n')
         .replace(/<\s*\/p\s*>/gi, '\n\n')
         .replace(/<\s*p[^>]*>/gi, '')
-        .replace(/<\s*(strong|b)\s*>/gi, '**')
-        .replace(/<\s*\/\s*(strong|b)\s*>/gi, '**')
-        .replace(/<\s*(em|i)\s*>/gi, '*')
-        .replace(/<\s*\/\s*(em|i)\s*>/gi, '*')
+        .replace(/<\s*(?:strong|b)\s*>([\s\S]*?)<\s*\/\s*(?:strong|b)\s*>/gi, (_m, inner) => wrapEmphasis(inner, '**'))
+        .replace(/<\s*(?:em|i)\s*>([\s\S]*?)<\s*\/\s*(?:em|i)\s*>/gi, (_m, inner) => wrapEmphasis(inner, '*'))
         .replace(/<\s*a[^>]*href=["']([^"']*)["'][^>]*>([\s\S]*?)<\s*\/\s*a\s*>/gi, '[$2]($1)')
         .replace(/<[^>]*>/g, '')
         .replace(/&nbsp;/g, ' ')
@@ -167,7 +199,7 @@ function renderDetail(obj) {
             if (val.length === 0)
                 continue;
             lines.push(`\n**${key}** (${val.length}):`);
-            for (const item of val.slice(0, 20)) {
+            for (const item of val) {
                 if (typeof item === 'object' && item) {
                     lines.push(`- ${renderInline(item)}`);
                 }
@@ -175,8 +207,6 @@ function renderDetail(obj) {
                     lines.push(`- ${String(item)}`);
                 }
             }
-            if (val.length > 20)
-                lines.push(`- _...${val.length - 20} more_`);
         }
         else if (typeof val === 'object') {
             const nested = val;
@@ -264,12 +294,10 @@ function renderGenericItem(item, index) {
             }
             else {
                 lines.push(`**${key}:** ${val.length} items`);
-                for (const sub of val.slice(0, 5)) {
+                for (const sub of val) {
                     if (typeof sub === 'object' && sub !== null)
                         lines.push(`  - ${renderInline(sub)}`);
                 }
-                if (val.length > 5)
-                    lines.push(`  - _...${val.length - 5} more_`);
             }
         }
     }
@@ -288,26 +316,76 @@ const HEADING_FIELDS = new Set([
     'description',
     'question',
 ]);
-/** Compact inline render of a small object. */
+/**
+ * Compact one-line render of a small object. Compact but never lossy: values are
+ * carried in full and nested objects/arrays recurse, so no field or character is
+ * dropped at any depth.
+ */
 function renderInline(obj) {
+    return inlineFields(obj) || JSON.stringify(obj);
+}
+/** `key: value` pairs for one object level, recursing into nested values. */
+function inlineFields(obj) {
     const parts = [];
     for (const [key, val] of Object.entries(obj)) {
         if (val == null || val === '')
             continue;
         if (typeof val === 'string') {
-            const cleaned = stripHtml(val, { inline: true });
-            const preview = cleaned.length > 120 ? `${cleaned.slice(0, 117)}...` : cleaned;
-            parts.push(`${key}: ${preview}`);
+            parts.push(`${key}: ${stripHtml(val, { inline: true })}`);
         }
-        else if (typeof val === 'number' || typeof val === 'boolean')
+        else if (typeof val === 'number' || typeof val === 'boolean') {
             parts.push(`${key}: ${val}`);
+        }
+        else if (Array.isArray(val)) {
+            if (val.length === 0)
+                continue;
+            const items = val.map((item) => typeof item === 'object' && item
+                ? `{${inlineFields(item)}}`
+                : String(item));
+            parts.push(`${key}: [${items.join('; ')}]`);
+        }
+        else if (typeof val === 'object') {
+            const nested = inlineFields(val);
+            if (nested)
+                parts.push(`${key}: {${nested}}`);
+        }
     }
-    if (parts.length > 0)
-        return parts.join(', ');
-    const json = JSON.stringify(obj);
-    return json.length > 200 ? `${json.slice(0, 197)}...` : json;
+    return parts.join(', ');
+}
+/**
+ * A curated one-line render of a collection row, with any of the row's own
+ * fields the curation never named appended.
+ *
+ * The `renderDetailRest` fall-through only reaches a record's top level: a
+ * collection the header renders itself is skipped there, so a field its curated
+ * line omits would otherwise leave `content[]` while staying in
+ * `structuredContent` — the same loss for a term's `district` or a nominee's
+ * `url` that a dropped top-level field used to be.
+ */
+function withUnnamedFields(row, curated, named) {
+    const rest = {};
+    for (const [k, v] of Object.entries(row))
+        if (!named.has(k))
+            rest[k] = v;
+    const unnamed = inlineFields(rest);
+    return unnamed ? `${curated} — ${unnamed}` : curated;
 }
 // ── Domain-Specific Item Renderers ──────────────────────────────────
+/**
+ * Public/private law citations from a bill or law record's `laws[]`, e.g.
+ * "Public Law 118-90". Upstream `/law` rows mirror `/bill`, so the citation is
+ * the only field distinguishing an enacted law from the bill it came from — it
+ * has to reach both the list rows and the detail view.
+ */
+function lawCitations(item) {
+    const laws = item.laws;
+    if (!Array.isArray(laws) || laws.length === 0)
+        return;
+    const cites = laws
+        .map((law) => join([s(law, 'type'), s(law, 'number')], ' '))
+        .filter(Boolean);
+    return cites.length > 0 ? cites.join(', ') : undefined;
+}
 function renderBillItem(item, i) {
     const type = s(item, 'type')?.toUpperCase() ?? '';
     const number = s(item, 'number') ?? '';
@@ -322,6 +400,9 @@ function renderBillItem(item, i) {
     ]);
     if (meta)
         lines.push(meta);
+    const citation = lawCitations(item);
+    if (citation)
+        lines.push(`**Law:** ${citation}`);
     if (Array.isArray(item.sponsors) && item.sponsors.length > 0) {
         const sponsors = item.sponsors.map((sp) => {
             const name = s(sp, 'fullName') ?? s(sp, 'firstName') ?? '?';
@@ -759,7 +840,7 @@ function renderNominationDetail(item) {
     const nominees = item.nominees;
     if (Array.isArray(nominees) && nominees.length > 0) {
         lines.push(`\n**Nominees (${nominees.length}):**`);
-        for (const n of nominees.slice(0, 20)) {
+        for (const n of nominees) {
             const ord = s(n, 'ordinal');
             const count = s(n, 'nomineeCount');
             const org = s(n, 'organization');
@@ -770,10 +851,8 @@ function renderNominationDetail(item) {
                 org,
                 title,
             ].filter(Boolean);
-            lines.push(`- ${parts.join(' — ')}`);
+            lines.push(`- ${withUnnamedFields(n, parts.join(' — '), NOMINEE_ROW_KEYS)}`);
         }
-        if (nominees.length > 20)
-            lines.push(`- _...${nominees.length - 20} more_`);
     }
     else if (s(item, 'partNumber') === '00') {
         /** Parent nominations (partNumber=00) have no nominees array. Sub-resources
@@ -783,8 +862,29 @@ function renderNominationDetail(item) {
     const url = s(item, 'url');
     if (url)
         lines.push(`\n**URL:** ${url}`);
+    const rest = renderDetailRest(item, HEADER_NOMINATION_KEYS);
+    if (rest)
+        lines.push('', rest);
     return lines.join('\n');
 }
+const NOMINEE_ROW_KEYS = new Set(['ordinal', 'nomineeCount', 'organization', 'positionTitle']);
+const HEADER_NOMINATION_KEYS = new Set([
+    'citation',
+    'number',
+    'partNumber',
+    'nominationType',
+    'description',
+    'congress',
+    'receivedDate',
+    'authorityDate',
+    'updateDate',
+    'latestAction',
+    'actions',
+    'committees',
+    'hearings',
+    'nominees',
+    'url',
+]);
 /** Roll call vote detail — question, result, date, party totals. */
 function renderRollVoteDetail(item) {
     const roll = s(item, 'rollCallNumber');
@@ -826,8 +926,24 @@ function renderRollVoteDetail(item) {
     }
     if (sourceUrl)
         lines.push(`\n**Source Data URL:** ${sourceUrl}`);
+    const rest = renderDetailRest(item, HEADER_ROLL_VOTE_KEYS);
+    if (rest)
+        lines.push('', rest);
     return lines.join('\n');
 }
+const HEADER_ROLL_VOTE_KEYS = new Set([
+    'rollCallNumber',
+    'congress',
+    'sessionNumber',
+    'result',
+    'voteQuestion',
+    'voteType',
+    'startDate',
+    'updateDate',
+    'identifier',
+    'sourceDataURL',
+    'votePartyTotal',
+]);
 /** One member's position: "Warren Davidson (R-OH) → Nay". */
 function renderMemberVoteRow(r) {
     const first = s(r, 'firstName');
@@ -988,8 +1104,11 @@ function renderSenateVoteDetail(item) {
     if (amd) {
         const amdNum = s(amd, 'number');
         const to = s(amd, 'toDocumentNumber');
+        const toTitle = s(amd, 'toDocumentShortTitle');
         amendmentPurpose = s(amd, 'purpose');
-        const head = [amdNum, to ? `to ${to}` : undefined].filter(Boolean).join(' ');
+        const head = [amdNum, to ? `to ${to}` : undefined, toTitle ? `— ${toTitle}` : undefined]
+            .filter(Boolean)
+            .join(' ');
         if (head)
             lines.push(`\n**Amendment:** ${head}`);
         if (amendmentPurpose)
@@ -1000,8 +1119,34 @@ function renderSenateVoteDetail(item) {
     const docText = s(item, 'voteDocumentText');
     if (docText && docText !== amendmentPurpose && docText !== docTitle)
         lines.push(`\n${docText}`);
+    const rest = renderDetailRest(item, HEADER_SENATE_VOTE_KEYS);
+    if (rest)
+        lines.push('', rest);
     return lines.join('\n');
 }
+/**
+ * `chamber` is implicit in the "Senate Vote" heading; `voteResult` / `question`
+ * are the short forms of `voteResultText` / `voteQuestionText`, one of which the
+ * header always renders.
+ */
+const HEADER_SENATE_VOTE_KEYS = new Set([
+    'chamber',
+    'voteNumber',
+    'voteResult',
+    'voteResultText',
+    'question',
+    'voteQuestionText',
+    'voteTitle',
+    'congress',
+    'session',
+    'voteDate',
+    'majorityRequirement',
+    'count',
+    'partyTotals',
+    'document',
+    'amendment',
+    'voteDocumentText',
+]);
 /** Senate member voting positions for one roll call — mirrors the House members view. */
 function renderSenateVoteMembers(result) {
     const vote = (result.vote ?? {});
@@ -1072,18 +1217,9 @@ function renderBillDetail(item) {
     const actionText = s(item, 'latestAction', 'text');
     if (actionDate || actionText)
         lines.push(`**Latest Action:** ${[actionDate, actionText].filter(Boolean).join(' — ')}`);
-    const laws = item.laws;
-    if (Array.isArray(laws) && laws.length > 0) {
-        const cites = laws
-            .map((law) => {
-            const num = s(law, 'number');
-            const lawType = s(law, 'type');
-            return num && lawType ? `${lawType} ${num}` : (num ?? lawType);
-        })
-            .filter(Boolean);
-        if (cites.length)
-            lines.push(`**Law:** ${cites.join(', ')}`);
-    }
+    const citation = lawCitations(item);
+    if (citation)
+        lines.push(`**Law:** ${citation}`);
     const rest = renderDetailRest(item, HEADER_BILL_KEYS);
     if (rest)
         lines.push('', rest);
@@ -1175,8 +1311,7 @@ function renderMemberDetail(item) {
             : undefined;
     if (termsArr && termsArr.length > 0) {
         lines.push(`\n**Terms (${termsArr.length}):**`);
-        const recent = termsArr.slice(-5);
-        for (const term of recent) {
+        for (const term of termsArr) {
             const chamber = s(term, 'chamber');
             const start = s(term, 'startYear');
             const end = s(term, 'endYear');
@@ -1184,10 +1319,8 @@ function renderMemberDetail(item) {
             const stateName = s(term, 'stateName');
             const range = start && end ? `${start}–${end}` : start;
             const parts = [chamber, range, party, stateName].filter(Boolean);
-            lines.push(`- ${parts.join(', ')}`);
+            lines.push(`- ${withUnnamedFields(term, parts.join(', '), TERM_ROW_KEYS)}`);
         }
-        if (termsArr.length > 5)
-            lines.push(`- _...${termsArr.length - 5} earlier_`);
     }
     const partyHistory = item.partyHistory;
     if (Array.isArray(partyHistory) && partyHistory.length > 0) {
@@ -1198,19 +1331,20 @@ function renderMemberDetail(item) {
             const end = s(p, 'endYear');
             const range = start && end ? `${start}–${end}` : start;
             const parts = [partyName, range && `(${range})`].filter(Boolean);
-            lines.push(`- ${parts.join(' ')}`);
+            lines.push(`- ${withUnnamedFields(p, parts.join(' '), PARTY_HISTORY_ROW_KEYS)}`);
         }
     }
     const leadership = item.leadership;
     if (Array.isArray(leadership) && leadership.length > 0) {
         lines.push(`\n**Leadership Roles (${leadership.length}):**`);
-        for (const l of leadership.slice(0, 10)) {
+        for (const l of leadership) {
             const type = s(l, 'type');
             const congress = s(l, 'congress');
-            lines.push(`- ${[type, congress ? `Congress ${congress}` : undefined].filter(Boolean).join(' — ')}`);
+            const curated = [type, congress ? `Congress ${congress}` : undefined]
+                .filter(Boolean)
+                .join(' — ');
+            lines.push(`- ${withUnnamedFields(l, curated, LEADERSHIP_ROW_KEYS)}`);
         }
-        if (leadership.length > 10)
-            lines.push(`- _...${leadership.length - 10} more_`);
     }
     const subResources = [];
     for (const key of ['sponsoredLegislation', 'cosponsoredLegislation']) {
@@ -1225,8 +1359,33 @@ function renderMemberDetail(item) {
     const url = s(item, 'url');
     if (url)
         lines.push(`\n**URL:** ${url}`);
+    const rest = renderDetailRest(item, HEADER_MEMBER_KEYS);
+    if (rest)
+        lines.push('', rest);
     return lines.join('\n');
 }
+const TERM_ROW_KEYS = new Set(['chamber', 'startYear', 'endYear', 'partyName', 'stateName']);
+const PARTY_HISTORY_ROW_KEYS = new Set(['partyName', 'startYear', 'endYear']);
+const LEADERSHIP_ROW_KEYS = new Set(['type', 'congress']);
+const HEADER_MEMBER_KEYS = new Set([
+    'bioguideId',
+    'directOrderName',
+    'invertedOrderName',
+    'honorificName',
+    'partyName',
+    'currentParty',
+    'state',
+    'district',
+    'currentMember',
+    'birthYear',
+    'updateDate',
+    'terms',
+    'partyHistory',
+    'leadership',
+    'sponsoredLegislation',
+    'cosponsoredLegislation',
+    'url',
+]);
 /** Committee list item — name + key fields. Fuzzy-matched rows carry `approximate: true`. */
 function renderCommitteeListItem(item, i) {
     const name = s(item, 'name') ?? s(item, 'systemCode') ?? 'Committee';