@shuji-bonji/pdf-spec-mcp 0.3.2 → 0.4.2

package/dist/tools/handlers.js

@@ -1,28 +1,45 @@
 /**
  * MCP Tool Handlers
+ *
+ * Adding a tool takes three edits:
+ *   1. a Zod shape + schema in utils/validation.ts
+ *   2. one entry in the definitions.ts registry
+ *   3. a handleXxx here, plus a line in toolHandlers
+ *
+ * Every handler parses its arguments with parseArgs before doing anything. The SDK also
+ * checks the published shape, but handlers are called directly in tests too, and parseArgs
+ * is what turns a bad argument into the family's structured VALIDATION_ERROR.
  */
-import { getSectionIndex, getSectionContent, searchSpec, getRequirements, getDefinitions, getTables, } from '../services/pdf-service.js';
-import { ensureRegistryInitialized, listSpecs, isSpecAvailable, getSpecInfo, } from '../services/pdf-registry.js';
+import { COVERAGE_GAPS } from '../config.js';
+import { NEXT_ACTIONS, ToolPrerequisiteError } from '../errors.js';
 import { compareVersions } from '../services/compare-service.js';
-import { ToolPrerequisiteError } from '../errors.js';
-import { validateSectionId, validateSearchQuery, validateMaxDepth, validateMaxResults, validateRequirementLevel, validateTermQuery, validateTableIndex, validateSpecId, validateCompareSection, } from '../utils/validation.js';
+import { ensureRegistryInitialized, getSpecInfo, isSpecAvailable, listSpecs, } from '../services/pdf-registry.js';
+import { getDefinitions, getRequirements, getSectionContent, getSectionIndex, getTables, searchSpec, } from '../services/pdf-service.js';
+import { CompareVersionsSchema, GetDefinitionsSchema, GetRequirementsSchema, GetSectionSchema, GetStructureSchema, GetTablesSchema, ListSpecsSchema, normalizeRequirementLevel, normalizeTerm, parseArgs, resolveMaxResults, SearchSpecSchema, } from '../utils/validation.js';
 // ========================================
 // list_specs
 // ========================================
-async function handleListSpecs(args) {
+async function handleListSpecs(rawArgs) {
+    const args = parseArgs(ListSpecsSchema, rawArgs);
     await ensureRegistryInitialized();
     const specs = listSpecs(args.category);
     return {
         totalSpecs: specs.length,
         specs,
+        // Reported unconditionally, including when a category filter is in play: the gaps are
+        // properties of the corpus, not of the current query.
+        coverage: {
+            note: 'These normative areas are outside this corpus. A search returning no hits for them ' +
+                'means "cannot answer", not "no such requirement".',
+            gaps: COVERAGE_GAPS,
+        },
     };
 }
 // ========================================
 // get_structure
 // ========================================
-async function handleGetStructure(args) {
-    const specId = validateSpecId(args.spec);
-    const maxDepth = validateMaxDepth(args.max_depth);
+async function handleGetStructure(rawArgs) {
+    const { spec: specId, max_depth: maxDepth } = parseArgs(GetStructureSchema, rawArgs);
     await ensureRegistryInitialized();
     const index = await getSectionIndex(specId);
     const sections = maxDepth ? pruneTree(index.tree, 0, maxDepth) : index.tree;
@@ -38,21 +55,19 @@ async function handleGetStructure(args) {
 // ========================================
 // get_section
 // ========================================
-async function handleGetSection(args) {
-    const specId = validateSpecId(args.spec);
-    validateSectionId(args.section);
+async function handleGetSection(rawArgs) {
+    const args = parseArgs(GetSectionSchema, rawArgs);
     await ensureRegistryInitialized();
-    return getSectionContent(args.section, specId);
+    return getSectionContent(args.section, args.spec);
 }
 // ========================================
 // search_spec
 // ========================================
-async function handleSearchSpec(args) {
-    const specId = validateSpecId(args.spec);
-    validateSearchQuery(args.query);
-    const maxResults = validateMaxResults(args.max_results);
+async function handleSearchSpec(rawArgs) {
+    const args = parseArgs(SearchSpecSchema, rawArgs);
+    const maxResults = resolveMaxResults(args.max_results);
     await ensureRegistryInitialized();
-    const hits = await searchSpec(args.query, maxResults, specId);
+    const hits = await searchSpec(args.query, maxResults, args.spec);
     return {
         query: args.query,
         totalResults: hits.length,
@@ -71,50 +86,54 @@ function pruneTree(entries, depth, maxDepth) {
 // ========================================
 // get_requirements
 // ========================================
-async function handleGetRequirements(args) {
-    const specId = validateSpecId(args.spec);
-    if (args.section !== undefined) {
-        validateSectionId(args.section);
-    }
-    const level = validateRequirementLevel(args.level);
+async function handleGetRequirements(rawArgs) {
+    const args = parseArgs(GetRequirementsSchema, rawArgs);
+    const level = normalizeRequirementLevel(args.level);
     await ensureRegistryInitialized();
-    return getRequirements(args.section, level, specId);
+    return getRequirements(args.section, level, args.spec);
 }
 // ========================================
 // get_definitions
 // ========================================
-async function handleGetDefinitions(args) {
-    const specId = validateSpecId(args.spec);
-    const term = validateTermQuery(args.term);
+async function handleGetDefinitions(rawArgs) {
+    const args = parseArgs(GetDefinitionsSchema, rawArgs);
     await ensureRegistryInitialized();
-    return getDefinitions(term, specId);
+    return getDefinitions(normalizeTerm(args.term), args.spec);
 }
 // ========================================
 // get_tables
 // ========================================
-async function handleGetTables(args) {
-    const specId = validateSpecId(args.spec);
-    validateSectionId(args.section);
-    const tableIndex = validateTableIndex(args.table_index);
+async function handleGetTables(rawArgs) {
+    const args = parseArgs(GetTablesSchema, rawArgs);
     await ensureRegistryInitialized();
-    return getTables(args.section, tableIndex, specId);
+    return getTables(args.section, args.table_index, args.spec);
 }
 // ========================================
 // compare_versions
 // ========================================
-async function handleCompareVersions(args) {
+async function handleCompareVersions(rawArgs) {
+    const args = parseArgs(CompareVersionsSchema, rawArgs);
     await ensureRegistryInitialized();
     // Prerequisite: both pdf17 and iso32000-2 must be available
     if (!isSpecAvailable('pdf17')) {
         throw new ToolPrerequisiteError('compare_versions requires PDF32000_2008.pdf in PDF_SPEC_DIR. ' +
-            'Download it from https://opensource.adobe.com/dc-acrobat-sdk-docs/pdfstandards/PDF32000_2008.pdf');
+            'Download it from https://opensource.adobe.com/dc-acrobat-sdk-docs/pdfstandards/PDF32000_2008.pdf', {
+            hint: 'compare_versions diffs PDF 1.7 against PDF 2.0, so both PDFs must be present.',
+            next_actions: [
+                NEXT_ACTIONS.downloadSpec('PDF32000_2008.pdf', 'https://opensource.adobe.com/dc-acrobat-sdk-docs/pdfstandards/PDF32000_2008.pdf'),
+            ],
+        });
     }
     if (!isSpecAvailable('iso32000-2')) {
         throw new ToolPrerequisiteError('compare_versions requires ISO_32000-2_sponsored-ec2.pdf in PDF_SPEC_DIR. ' +
-            'Download it from https://pdfa.org/resource/iso-32000-pdf/');
+            'Download it from https://pdfa.org/resource/iso-32000-pdf/', {
+            hint: 'compare_versions diffs PDF 1.7 against PDF 2.0, so both PDFs must be present.',
+            next_actions: [
+                NEXT_ACTIONS.downloadSpec('ISO_32000-2_sponsored_EC3.pdf', 'https://pdfa.org/resource/iso-32000-pdf/'),
+            ],
+        });
     }
-    const section = validateCompareSection(args.section);
-    return compareVersions(section);
+    return compareVersions(args.section);
 }
 // ========================================
 // Tool handler registry

package/dist/tools/handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/tools/handlers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../src/tools/handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EACL,yBAAyB,EACzB,WAAW,EACX,eAAe,EACf,SAAS,GACV,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,UAAU,GACX,MAAM,4BAA4B,CAAC;AAOpC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAEhC,2CAA2C;AAC3C,aAAa;AACb,2CAA2C;AAE3C,KAAK,UAAU,eAAe,CAAC,OAAgB;IAC7C,MAAM,IAAI,GAAG,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,yBAAyB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,QAAoC,CAAC,CAAC;IACnE,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,KAAK;QACL,sFAAsF;QACtF,sDAAsD;QACtD,QAAQ,EAAE;YACR,IAAI,EACF,qFAAqF;gBACrF,mDAAmD;YACrD,IAAI,EAAE,aAAa;SACpB;KACF,CAAC;AACJ,CAAC;AAED,2CAA2C;AAC3C,gBAAgB;AAChB,2CAA2C;AAE3C,KAAK,UAAU,kBAAkB,CAAC,OAAgB;IAChD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;IACrF,MAAM,yBAAyB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;IAE5E,mCAAmC;IACnC,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,IAAI,YAAY,CAAC,CAAC;IACrD,OAAO;QACL,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,4BAA4B;QACtD,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM;QACrC,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,2CAA2C;AAC3C,cAAc;AACd,2CAA2C;AAE3C,KAAK,UAAU,gBAAgB,CAAC,OAAgB;IAC9C,MAAM,IAAI,GAAG,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,yBAAyB,EAAE,CAAC;IAClC,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,2CAA2C;AAC3C,cAAc;AACd,2CAA2C;AAE3C,KAAK,UAAU,gBAAgB,CAAC,OAAgB;IAC9C,MAAM,IAAI,GAAG,SAAS,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,yBAAyB,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjE,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,YAAY,EAAE,IAAI,CAAC,MAAM;QACzB,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAAC,OAAuB,EAAE,KAAa,EAAE,QAAgB;IACzE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,GAAG,CAAC;QACJ,QAAQ,EAAE,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;KACjF,CAAC,CAAC,CAAC;AACN,CAAC;AAED,2CAA2C;AAC3C,mBAAmB;AACnB,2CAA2C;AAE3C,KAAK,UAAU,qBAAqB,CAAC,OAAgB;IACnD,MAAM,IAAI,GAAG,SAAS,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,yBAAyB,EAAE,CAAC;IAClC,OAAO,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC;AAED,2CAA2C;AAC3C,kBAAkB;AAClB,2CAA2C;AAE3C,KAAK,UAAU,oBAAoB,CAAC,OAAgB;IAClD,MAAM,IAAI,GAAG,SAAS,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IACtD,MAAM,yBAAyB,EAAE,CAAC;IAClC,OAAO,cAAc,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,2CAA2C;AAC3C,aAAa;AACb,2CAA2C;AAE3C,KAAK,UAAU,eAAe,CAAC,OAAgB;IAC7C,MAAM,IAAI,GAAG,SAAS,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IACjD,MAAM,yBAAyB,EAAE,CAAC;IAClC,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9D,CAAC;AAED,2CAA2C;AAC3C,mBAAmB;AACnB,2CAA2C;AAE3C,KAAK,UAAU,qBAAqB,CAAC,OAAgB;IACnD,MAAM,IAAI,GAAG,SAAS,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,yBAAyB,EAAE,CAAC;IAElC,4DAA4D;IAC5D,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,qBAAqB,CAC7B,+DAA+D;YAC7D,kGAAkG,EACpG;YACE,IAAI,EAAE,+EAA+E;YACrF,YAAY,EAAE;gBACZ,YAAY,CAAC,YAAY,CACvB,mBAAmB,EACnB,iFAAiF,CAClF;aACF;SACF,CACF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,qBAAqB,CAC7B,2EAA2E;YACzE,2DAA2D,EAC7D;YACE,IAAI,EAAE,+EAA+E;YACrF,YAAY,EAAE;gBACZ,YAAY,CAAC,YAAY,CACvB,+BAA+B,EAC/B,0CAA0C,CAC3C;aACF;SACF,CACF,CAAC;IACJ,CAAC;IAED,OAAO,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,2CAA2C;AAC3C,wBAAwB;AACxB,2CAA2C;AAE3C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,UAAU,EAAE,eAAe;IAC3B,aAAa,EAAE,kBAAkB;IACjC,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,gBAAgB;IAC7B,gBAAgB,EAAE,qBAAqB;IACvC,eAAe,EAAE,oBAAoB;IACrC,UAAU,EAAE,eAAe;IAC3B,gBAAgB,EAAE,qBAAqB;CAC/B,CAAC"}

package/dist/types/index.d.ts

@@ -15,13 +15,27 @@ export interface SpecInfo {
     outlineEntries: number | null;
     description: string;
 }
+/** A normative area the corpus does not cover (see config.ts COVERAGE_GAPS) */
+export interface CoverageGapInfo {
+    area: string;
+    standards: string[];
+    consequence: string;
+}
 /** list_specs result */
 export interface ListSpecsResult {
     totalSpecs: number;
     specs: SpecInfo[];
-}
-export interface ListSpecsArgs {
-    category?: string;
+    /**
+     * What this server cannot answer for.
+     *
+     * Reported alongside what it *can* answer, because a caller that only sees the corpus has
+     * no way to tell "no requirement" from "not in the corpus" — and list_specs is the tool
+     * an agent reaches for first.
+     */
+    coverage: {
+        note: string;
+        gaps: CoverageGapInfo[];
+    };
 }
 /** A matched section pair between two spec versions */
 export interface SectionMapping {
@@ -45,9 +59,6 @@ export interface CompareVersionsResult {
     added: UnmatchedSection[];
     removed: UnmatchedSection[];
 }
-export interface CompareVersionsArgs {
-    section?: string;
-}
 /** Outline entry from PDF bookmark tree */
 export interface OutlineEntry {
     title: string;
@@ -127,19 +138,6 @@ export interface SearchResult {
     totalResults: number;
     results: SearchHit[];
 }
-export interface GetStructureArgs {
-    spec?: string;
-    max_depth?: number;
-}
-export interface GetSectionArgs {
-    spec?: string;
-    section: string;
-}
-export interface SearchSpecArgs {
-    spec?: string;
-    query: string;
-    max_results?: number;
-}
 /** ISO normative requirement levels (lowercase per ISO/IEC Directives Part 2) */
 export type ISORequirementLevel = 'shall' | 'shall not' | 'should' | 'should not' | 'may';
 /** A single extracted normative requirement */
@@ -149,6 +147,17 @@ export interface Requirement {
     text: string;
     section: string;
     sectionTitle: string;
+    /** Where the sentence was found. Absent means prose (paragraph / list / note). */
+    source?: 'table';
+    /**
+     * Context for a requirement lifted out of a table, which its sentence alone loses.
+     *
+     * "The type of annotation ... shall be Highlight, Underline, ..." is unusable without
+     * knowing it constrains Table 182's `Subtype` entry. `text` stays verbatim so it can be
+     * quoted; the context rides alongside.
+     */
+    table?: string;
+    key?: string;
 }
 export interface RequirementsResult {
     filter: {
@@ -159,11 +168,6 @@ export interface RequirementsResult {
     statistics: Record<string, number>;
     requirements: Requirement[];
 }
-export interface GetRequirementsArgs {
-    spec?: string;
-    section?: string;
-    level?: string;
-}
 /** A term definition from Section 3 */
 export interface Definition {
     term: string;
@@ -177,10 +181,6 @@ export interface DefinitionsResult {
     searchTerm?: string;
     definitions: Definition[];
 }
-export interface GetDefinitionsArgs {
-    spec?: string;
-    term?: string;
-}
 /** A table extracted from a section with optional caption */
 export interface TableInfo {
     index: number;
@@ -194,11 +194,6 @@ export interface TablesResult {
     totalTables: number;
     tables: TableInfo[];
 }
-export interface GetTablesArgs {
-    spec?: string;
-    section: string;
-    table_index?: number;
-}
 export interface PageText {
     page: number;
     section: string;

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

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

package/dist/utils/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC;IACxB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,OAAO,GAAE,YAAiB;IAOtC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAa1B,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAa3B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIpB,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIvB,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,QAAQ,CAAC,CAAC,EAAE,CAAC;IACxB,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,OAAO,GAAE,YAAiB;IAOtC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAiB1B,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAa3B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIpB,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO;IAIvB,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/utils/cache.js

@@ -17,6 +17,10 @@ export class LRUCache {
         if (!this.cache.has(key)) {
             return undefined;
         }
+        // `has` above establishes the entry exists. The assertion cannot be replaced by
+        // `?.` or an `=== undefined` check: V is unconstrained, so a stored `undefined`
+        // is a legitimate value and must stay distinguishable from "absent".
+        // biome-ignore lint/style/noNonNullAssertion: guarded by the has() check above
         const value = this.cache.get(key);
         this.cache.delete(key);
         this.cache.set(key, value);

package/dist/utils/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,OAAO,QAAQ;IACX,KAAK,CAAY;IACR,OAAO,CAAS;IAChB,KAAK,CAAU;IACf,IAAI,CAAS;IAE9B,YAAY,UAAwB,EAAE;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IACzB,CAAC;IAED,GAAG,CAAC,GAAM;QACR,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,gBAAgB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,GAAG,CAAC,GAAM,EAAE,KAAQ;QAClB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACjD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,GAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,GAAM;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,OAAO,QAAQ;IACX,KAAK,CAAY;IACR,OAAO,CAAS;IAChB,KAAK,CAAU;IACf,IAAI,CAAS;IAE9B,YAAY,UAAwB,EAAE;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,UAAU,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IACzB,CAAC;IAED,GAAG,CAAC,GAAM;QACR,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,gFAAgF;QAChF,gFAAgF;QAChF,qEAAqE;QACrE,+EAA+E;QAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,gBAAgB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,GAAG,CAAC,GAAM,EAAE,KAAQ;QAClB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACjD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,GAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,GAAM;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;CACF"}

package/dist/utils/stdout-guard.d.ts

@@ -0,0 +1,24 @@
+/**
+ * stdout guard (side-effect only).
+ *
+ * MCP は stdout で JSON-RPC を喋るため、依存ライブラリが stdout へ書くと
+ * ストリームが壊れる。Node では **`console.log` と `console.info` が stdout**、
+ * `console.warn` / `console.error` は stderr に出る。
+ *
+ * 本リポジトリが依存する pdfjs-dist (v5) の実際の経路を確認した結果:
+ * - `warn()` → `console.warn` … **stderr。stdout は汚さない**
+ * - `info()` → `console.info` … **stdout**（既定 verbosity では出ないが、上がれば漏れる）
+ * - `deprecated()` → `console.log` … **stdout**（非推奨 API を踏むと無条件に出る）
+ *
+ * したがってガードすべき本命は `console.info` と `console.log` であり、
+ * `console.warn` の転送は保険（将来 pdfjs 側の実装が変わる / 他の依存が使う場合）。
+ * family の writer / verify は log と warn のみを塞いでおり info が素通りなので、
+ * こちらへ合わせるべき（別途 issue 化のこと）。
+ *
+ * エントリポイントの**最初の import** であること。ESM は import をトップレベル
+ * 文より先に巻き上げるため、index.ts にインラインで書くと依存モジュールの
+ * 評価後に実行されてしまう。独立モジュールに隔離し最初に import することで、
+ * 他のモジュールがロードされる前にガードが入ることを保証する。
+ */
+export {};
+//# sourceMappingURL=stdout-guard.d.ts.map

package/dist/utils/stdout-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdout-guard.d.ts","sourceRoot":"","sources":["../../src/utils/stdout-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG"}

package/dist/utils/stdout-guard.js

@@ -0,0 +1,27 @@
+/**
+ * stdout guard (side-effect only).
+ *
+ * MCP は stdout で JSON-RPC を喋るため、依存ライブラリが stdout へ書くと
+ * ストリームが壊れる。Node では **`console.log` と `console.info` が stdout**、
+ * `console.warn` / `console.error` は stderr に出る。
+ *
+ * 本リポジトリが依存する pdfjs-dist (v5) の実際の経路を確認した結果:
+ * - `warn()` → `console.warn` … **stderr。stdout は汚さない**
+ * - `info()` → `console.info` … **stdout**（既定 verbosity では出ないが、上がれば漏れる）
+ * - `deprecated()` → `console.log` … **stdout**（非推奨 API を踏むと無条件に出る）
+ *
+ * したがってガードすべき本命は `console.info` と `console.log` であり、
+ * `console.warn` の転送は保険（将来 pdfjs 側の実装が変わる / 他の依存が使う場合）。
+ * family の writer / verify は log と warn のみを塞いでおり info が素通りなので、
+ * こちらへ合わせるべき（別途 issue 化のこと）。
+ *
+ * エントリポイントの**最初の import** であること。ESM は import をトップレベル
+ * 文より先に巻き上げるため、index.ts にインラインで書くと依存モジュールの
+ * 評価後に実行されてしまう。独立モジュールに隔離し最初に import することで、
+ * 他のモジュールがロードされる前にガードが入ることを保証する。
+ */
+console.log = (...args) => console.error('[log]', ...args);
+console.info = (...args) => console.error('[info]', ...args);
+console.warn = (...args) => console.error('[warn]', ...args);
+export {};
+//# sourceMappingURL=stdout-guard.js.map

package/dist/utils/stdout-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdout-guard.js","sourceRoot":"","sources":["../../src/utils/stdout-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AACtE,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC;AACxE,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC"}

package/dist/utils/validation.d.ts

@@ -1,22 +1,104 @@
 /**
- * Input Validation Utilities
+ * Input Validation — Zod schemas as the single source of truth (A-4)
+ *
+ * Previously the same constraints were maintained twice: hand-written `assert` helpers
+ * here, and a hand-written JSON Schema in definitions.ts. They could drift — the published
+ * schema saying one thing while the runtime check enforced another. From this version the
+ * Zod schema is the one source both are derived from:
+ *   - the schema published to MCP (definitions.ts hands the shape to registerTool)
+ *   - the runtime check (handlers.ts parses with the same schema)
+ * Limits stay in config.ts (VALIDATION_LIMITS).
+ *
+ * Field descriptions live here too, so a tool's advertised argument and the check that
+ * enforces it cannot disagree.
  */
+import { z } from 'zod';
 import type { ISORequirementLevel } from '../types/index.js';
-export declare function validateSectionId(section: unknown): asserts section is string;
-export declare function validateSearchQuery(query: unknown): asserts query is string;
-export declare function validateMaxDepth(depth: unknown): number | undefined;
-export declare function validateMaxResults(max: unknown): number;
-export declare function validateRequirementLevel(level: unknown): ISORequirementLevel | undefined;
-export declare function validateTermQuery(term: unknown): string | undefined;
-export declare function validateTableIndex(index: unknown): number | undefined;
+export declare const REQUIREMENT_LEVELS: [ISORequirementLevel, ...ISORequirementLevel[]];
+export declare const listSpecsShape: {
+    category: z.ZodOptional<z.ZodString>;
+};
+export declare const ListSpecsSchema: z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const getStructureShape: {
+    spec: z.ZodOptional<z.ZodString>;
+    max_depth: z.ZodOptional<z.ZodNumber>;
+};
+export declare const GetStructureSchema: z.ZodObject<{
+    spec: z.ZodOptional<z.ZodString>;
+    max_depth: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const getSectionShape: {
+    spec: z.ZodOptional<z.ZodString>;
+    section: z.ZodString;
+};
+export declare const GetSectionSchema: z.ZodObject<{
+    spec: z.ZodOptional<z.ZodString>;
+    section: z.ZodString;
+}, z.core.$strip>;
+export declare const searchSpecShape: {
+    spec: z.ZodOptional<z.ZodString>;
+    query: z.ZodString;
+    max_results: z.ZodOptional<z.ZodNumber>;
+};
+export declare const SearchSpecSchema: z.ZodObject<{
+    spec: z.ZodOptional<z.ZodString>;
+    query: z.ZodString;
+    max_results: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const getRequirementsShape: {
+    spec: z.ZodOptional<z.ZodString>;
+    section: z.ZodOptional<z.ZodString>;
+    level: z.ZodOptional<z.ZodString>;
+};
+export declare const GetRequirementsSchema: z.ZodObject<{
+    spec: z.ZodOptional<z.ZodString>;
+    section: z.ZodOptional<z.ZodString>;
+    level: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const getDefinitionsShape: {
+    spec: z.ZodOptional<z.ZodString>;
+    term: z.ZodOptional<z.ZodString>;
+};
+export declare const GetDefinitionsSchema: z.ZodObject<{
+    spec: z.ZodOptional<z.ZodString>;
+    term: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const getTablesShape: {
+    spec: z.ZodOptional<z.ZodString>;
+    section: z.ZodString;
+    table_index: z.ZodOptional<z.ZodNumber>;
+};
+export declare const GetTablesSchema: z.ZodObject<{
+    spec: z.ZodOptional<z.ZodString>;
+    section: z.ZodString;
+    table_index: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const compareVersionsShape: {
+    section: z.ZodOptional<z.ZodString>;
+};
+export declare const CompareVersionsSchema: z.ZodObject<{
+    section: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 /**
- * Validate spec ID parameter.
- * Returns undefined if not provided (caller should use DEFAULT_SPEC_ID via resolveSpecId).
+ * Parse tool arguments, reporting failures as ValidationError.
+ *
+ * The SDK validates against the published shape too, but this stays the enforcement point:
+ * it is what runs for callers reaching a handler directly (unit tests included), and it
+ * turns a Zod failure into the same structured error as every other rejection.
  */
-export declare function validateSpecId(specId: unknown): string | undefined;
+export declare function parseArgs<T extends z.ZodType>(schema: T, args: unknown): z.infer<T>;
 /**
- * Validate section parameter for compare_versions.
- * Returns undefined if not provided (compare all sections).
+ * Normalise a requirement level.
+ *
+ * Kept out of the Zod schema as a plain enum so that case and stray whitespace are still
+ * forgiven ("SHALL " → "shall"), which the hand-written validator did and callers rely on.
+ * The published schema advertises the accepted values in its description.
  */
-export declare function validateCompareSection(section: unknown): string | undefined;
+export declare function normalizeRequirementLevel(level?: string): ISORequirementLevel | undefined;
+/** Default applied when max_results is omitted. */
+export declare function resolveMaxResults(max?: number): number;
+/** Trim a term the way the previous hand-written validator did. */
+export declare function normalizeTerm(term?: string): string | undefined;
 //# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAW7D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,MAAM,CAO7E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAU3E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAanE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAavD;AAUD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,GAAG,SAAS,CAYxF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAYnE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAMrE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CASlE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI3E"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAkC7D,eAAO,MAAM,kBAAkB,EAAE,CAAC,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAM9E,CAAC;AAUF,eAAO,MAAM,cAAc;;CAK1B,CAAC;AACF,eAAO,MAAM,eAAe;;iBAA2B,CAAC;AAExD,eAAO,MAAM,iBAAiB;;;CAS7B,CAAC;AACF,eAAO,MAAM,kBAAkB;;;iBAA8B,CAAC;AAE9D,eAAO,MAAM,eAAe;;;CAG3B,CAAC;AACF,eAAO,MAAM,gBAAgB;;;iBAA4B,CAAC;AAE1D,eAAO,MAAM,eAAe;;;;CAe3B,CAAC;AACF,eAAO,MAAM,gBAAgB;;;;iBAA4B,CAAC;AAE1D,eAAO,MAAM,oBAAoB;;;;CAOhC,CAAC;AACF,eAAO,MAAM,qBAAqB;;;;iBAAiC,CAAC;AAEpE,eAAO,MAAM,mBAAmB;;;CAS/B,CAAC;AACF,eAAO,MAAM,oBAAoB;;;iBAAgC,CAAC;AAElE,eAAO,MAAM,cAAc;;;;CAS1B,CAAC;AACF,eAAO,MAAM,eAAe;;;;iBAA2B,CAAC;AAExD,eAAO,MAAM,oBAAoB;;CAEhC,CAAC;AACF,eAAO,MAAM,qBAAqB;;iBAAiC,CAAC;AAMpE;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CASnF;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CASzF;AAED,mDAAmD;AACnD,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/D"}