driverge-mcp 0.0.0 → 0.0.1

package/dist/schema/assemble.d.ts

@@ -1,4 +1,36 @@
-import type { PdfAnalysis } from "../pdf/types.js";
-import type { DatasheetJson } from "./types.js";
+import type { InterfaceKind, PdfAnalysis } from "../pdf/types.js";
+import type { DatasheetJson, DeviceInterface, Extraction } from "./types.js";
+/**
+ * Classify how complete the deterministic extraction is (see wiki:
+ * graceful-degradation). An empty map is a *deferral* (host-AI-completable) rather
+ * than a failure whenever there's positive evidence of that interface — a detected
+ * section, or the kind classifier landing on it — and only `none` (a hard error)
+ * when there is no signal at all.
+ */
+export declare function deriveExtraction(iface: DeviceInterface, sections: {
+    registerPages: number[];
+    commandPages: number[];
+}, kind: InterfaceKind, busKnown: boolean): Extraction;
+/**
+ * Optional overrides for the host AI to steer assembly when its own reading of
+ * the datasheet disagrees with (or supplements) the deterministic detectors —
+ * see Session 10 / Contract A. Both are opt-in; omitting `opts` entirely is
+ * byte-identical to today's behavior.
+ */
+export interface AssembleOpts {
+    /**
+     * Manufacturer name to use as a "hint"-style fallback. Applied ONLY when
+     * detectManufacturer lands on the generic default (no confident vendor) — a
+     * confident detection always wins and the hint is silently ignored. When
+     * applied, manufacturerConfidence is pinned to 0.5 (a hint is more than
+     * nothing but less than a confident deterministic match).
+     */
+    manufacturerHint?: string;
+    /**
+     * Forces the interface kind used for BOTH buildInterface and
+     * deriveExtraction, overriding detectInterfaceKind's classification.
+     */
+    interfaceKindHint?: "register_map" | "command_set";
+}
 /** Assemble + validate the datasheet contract from a completed PDF analysis. */
-export declare function assembleDatasheet(analysis: PdfAnalysis): DatasheetJson;
+export declare function assembleDatasheet(analysis: PdfAnalysis, opts?: AssembleOpts): DatasheetJson;

package/dist/schema/assemble.js

@@ -4,40 +4,113 @@
 // command/protocol/CRC extraction) come together into the object handed to the
 // host AI by ref. See wiki: json-schema-as-contract, mcp-tool-usage-flow.
 import { extractCommands, extractProtocol } from "../pdf/command.js";
-import { detectInterfaceKind } from "../pdf/interface-kind.js";
+import { findGenericRegisterTable } from "../pdf/generic-register-table.js";
+import { detectInterfaceKind, detectSections } from "../pdf/interface-kind.js";
 import { detectManufacturer } from "../pdf/manufacturer.js";
+import { findMaximRegisterMap } from "../pdf/maxim-register-map.js";
 import { detectPart } from "../pdf/part.js";
+import { extractProseCommands } from "../pdf/prose-commands.js";
 import { findRegisterTable } from "../pdf/register-table.js";
+import { findStBitFields } from "../pdf/st-bit-layout.js";
+import { findTiRegisterMap } from "../pdf/ti-register-map.js";
 import { validateDatasheet } from "./validate.js";
 function buildInterface(pages, kind) {
     if (kind === "command_set") {
-        return { kind: "command_set", commands: extractCommands(pages) };
+        let commands = extractCommands(pages);
+        if (commands.length === 0)
+            commands = extractProseCommands(pages);
+        return { kind: "command_set", commands };
     }
-    // register_map (and "unknown", which we treat as register-first): fall back to
-    // a command set only if no register table is found but commands are present.
-    const table = findRegisterTable(pages);
-    if (!table && kind === "unknown") {
+    // register_map (and "unknown", treated register-first). Try the BME280/
+    // Microchip bit-table extractor, then the TI register-summary adapter, then the
+    // role-based generic extractor (raises the deterministic floor for unseen vendor
+    // table shapes — see generic-register-table). Each runs only when the prior found
+    // nothing, so the specialized adapters (and their goldens) are never affected.
+    let registers = findRegisterTable(pages)?.registers ?? [];
+    if (registers.length === 0) {
+        registers = findTiRegisterMap(pages)?.registers ?? [];
+    }
+    // Maxim's register-matrix shape (see maxim-register-map): tried after TI's
+    // summary-table adapter and before the role-based generic fallback, same
+    // slot pattern as every prior specialized adapter in this chain.
+    if (registers.length === 0) {
+        registers = findMaximRegisterMap(pages)?.registers ?? [];
+    }
+    if (registers.length === 0) {
+        registers = findGenericRegisterTable(pages)?.registers ?? [];
+        // Enrich with ST's two-stacked-table bit-layout format (see
+        // st-bit-layout): a name-only match against the generic table's rows, so
+        // non-ST datasheets (an empty map) leave the address-only registers
+        // untouched.
+        if (registers.length > 0) {
+            const stFields = findStBitFields(pages);
+            if (stFields.size > 0) {
+                for (const r of registers) {
+                    const bf = stFields.get(r.name);
+                    if (bf)
+                        r.bitFields = bf;
+                }
+            }
+        }
+    }
+    // Only reclassify as a command set when nothing register-like was found.
+    if (registers.length === 0 && kind === "unknown") {
         const commands = extractCommands(pages);
         if (commands.length > 0)
             return { kind: "command_set", commands };
     }
-    return { kind: "register_map", registers: table?.registers ?? [] };
+    return { kind: "register_map", registers };
+}
+/**
+ * Classify how complete the deterministic extraction is (see wiki:
+ * graceful-degradation). An empty map is a *deferral* (host-AI-completable) rather
+ * than a failure whenever there's positive evidence of that interface — a detected
+ * section, or the kind classifier landing on it — and only `none` (a hard error)
+ * when there is no signal at all.
+ */
+export function deriveExtraction(iface, sections, kind, busKnown) {
+    // An empty map defers (host-AI-completable) whenever there's ANY interface
+    // signal — a detected section, a concrete kind, or even a detected bus (a part
+    // with a known I2C/SPI bus almost certainly has registers/commands we just
+    // couldn't parse). Only a truly signal-less PDF is `none` (a hard error).
+    if (iface.kind === "register_map") {
+        if (iface.registers.length === 0) {
+            const detectedPages = sections.registerPages;
+            const deferred = detectedPages.length > 0 || kind === "register_map" || busKnown;
+            return { status: deferred ? "deferred" : "none", detectedPages };
+        }
+        const hasBits = iface.registers.some((r) => r.bitFields.length > 0);
+        return {
+            status: hasBits ? "complete" : "partial",
+            detectedPages: sections.registerPages,
+        };
+    }
+    if (iface.commands.length === 0) {
+        const detectedPages = sections.commandPages;
+        const deferred = detectedPages.length > 0 || kind === "command_set" || busKnown;
+        return { status: deferred ? "deferred" : "none", detectedPages };
+    }
+    return { status: "complete", detectedPages: sections.commandPages };
 }
 /** Assemble + validate the datasheet contract from a completed PDF analysis. */
-export function assembleDatasheet(analysis) {
+export function assembleDatasheet(analysis, opts) {
     const { pages } = analysis;
     const manufacturer = detectManufacturer(pages);
-    const kind = detectInterfaceKind(pages).kind;
+    const kind = opts?.interfaceKindHint ?? detectInterfaceKind(pages).kind;
+    const iface = buildInterface(pages, kind);
+    const protocol = extractProtocol(pages);
+    const manufacturerHint = manufacturer.manufacturer === "generic" ? opts?.manufacturerHint : undefined;
     const partial = {
         metadata: {
             part: detectPart(pages),
-            manufacturer: manufacturer.manufacturer,
-            manufacturerConfidence: manufacturer.confidence,
+            manufacturer: manufacturerHint ?? manufacturer.manufacturer,
+            manufacturerConfidence: manufacturerHint !== undefined ? 0.5 : manufacturer.confidence,
             pdfType: analysis.type,
             pageCount: analysis.pageCount,
         },
-        protocol: extractProtocol(pages),
-        interface: buildInterface(pages, kind),
+        protocol,
+        interface: iface,
+        extraction: deriveExtraction(iface, detectSections(pages), kind, protocol.bus !== "unknown"),
     };
     const validation = validateDatasheet({
         ...partial,

package/dist/schema/assemble.js.map

@@ -1 +1 @@
-{"version":3,"file":"assemble.js","sourceRoot":"","sources":["../../src/schema/assemble.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,2EAA2E;AAC3E,+EAA+E;AAC/E,0EAA0E;AAE1E,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,SAAS,cAAc,CAAC,KAAoB,EAAE,IAAY;IACxD,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;IACnE,CAAC;IACD,+EAA+E;IAC/E,6EAA6E;IAC7E,MAAM,KAAK,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,CAAC;AACrE,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,iBAAiB,CAAC,QAAqB;IACrD,MAAM,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC;IAC3B,MAAM,YAAY,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC;IAE7C,MAAM,OAAO,GAAG;QACd,QAAQ,EAAE;YACR,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC;YACvB,YAAY,EAAE,YAAY,CAAC,YAAY;YACvC,sBAAsB,EAAE,YAAY,CAAC,UAAU;YAC/C,OAAO,EAAE,QAAQ,CAAC,IAAI;YACtB,SAAS,EAAE,QAAQ,CAAC,SAAS;SAC9B;QACD,QAAQ,EAAE,eAAe,CAAC,KAAK,CAAC;QAChC,SAAS,EAAE,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC;KACvC,CAAC;IAEF,MAAM,UAAU,GAAG,iBAAiB,CAAC;QACnC,GAAG,OAAO;QACV,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;KACtD,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,CAAC;AACpC,CAAC"}
+{"version":3,"file":"assemble.js","sourceRoot":"","sources":["../../src/schema/assemble.ts"],"names":[],"mappings":"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"}

package/dist/schema/types.d.ts

@@ -1,5 +1,5 @@
 import type { PdfType, Register } from "../pdf/types.js";
-export type Bus = "I2C" | "SPI" | "UART" | "unknown";
+export type Bus = "I2C" | "SPI" | "UART" | "CAN" | "unknown";
 export interface DatasheetMetadata {
     part: string;
     manufacturer: string;
@@ -42,10 +42,30 @@ export interface ValidationResult {
     errors: string[];
     warnings: string[];
 }
+/**
+ * How complete the deterministic extraction of the interface is (see wiki:
+ * graceful-degradation). Drives whether an empty/incomplete map is a hard error
+ * or a host-AI-completable deferral.
+ *
+ * - `complete`  — registers with bit-field detail, or a clean command list.
+ * - `partial`   — ≥1 register but known-incomplete (e.g. an address-only list
+ *                 with no bit fields).
+ * - `deferred`  — a register/command section was DETECTED but not auto-extracted;
+ *                 the host AI completes it from the datasheet resource.
+ * - `none`      — no interface signal at all; a genuine parse failure.
+ */
+export type ExtractionStatus = "complete" | "partial" | "deferred" | "none";
+export interface Extraction {
+    status: ExtractionStatus;
+    /** 1-based pages where the register-map / command section was detected. */
+    detectedPages: number[];
+}
 /** The full parsed datasheet handed (by ref) to the host AI. */
 export interface DatasheetJson {
     metadata: DatasheetMetadata;
     protocol: Protocol;
     interface: DeviceInterface;
+    /** Extraction completeness; absent on legacy JSON (treated as `none`). */
+    extraction?: Extraction;
     validation: ValidationResult;
 }

package/dist/schema/validate.js

@@ -1,7 +1,10 @@
 // L5 — datasheet validator. Deterministic logic checks, per interface kind, that
 // gate malformed/incomplete JSON before it reaches the host AI (see wiki:
 // validate-before-sending-to-claude). Errors fail validation; warnings do not.
+import { registerWidth } from "../pdf/types.js";
 const HEX_ONLY = /^0x[0-9a-f]+$/i;
+const VALID_WIDTHS = new Set([8, 16, 32]);
+const detectedOn = (pages) => pages.length > 0 ? ` (page(s) ${pages.join(", ")})` : "";
 export function validateDatasheet(d) {
     const errors = [];
     const warnings = [];
@@ -9,28 +12,47 @@ export function validateDatasheet(d) {
         warnings.push("metadata.part is empty");
     if (d.protocol.bus === "unknown")
         warnings.push("protocol.bus is unknown");
+    const status = d.extraction?.status;
+    const pages = d.extraction?.detectedPages ?? [];
     if (d.interface.kind === "register_map") {
-        validateRegisters(d.interface.registers, errors);
+        validateRegisters(d.interface.registers, errors, warnings, status, pages);
     }
     else {
-        validateCommands(d.interface.commands, errors, warnings);
+        validateCommands(d.interface.commands, errors, warnings, status, pages);
     }
     return { valid: errors.length === 0, errors, warnings };
 }
-function validateRegisters(registers, errors) {
+function validateRegisters(registers, errors, warnings, status, pages) {
     if (registers.length === 0) {
-        errors.push("register_map has no registers");
+        // A detected-but-unparsed map is a host-AI-completable deferral, not a failure
+        // (see wiki: graceful-degradation); only a true no-signal map is an error.
+        if (status === "deferred") {
+            warnings.push(`register map detected${detectedOn(pages)} but not auto-extracted — the host AI must complete it from the datasheet resource`);
+        }
+        else {
+            errors.push("register_map has no registers");
+        }
         return;
     }
+    if (status === "partial") {
+        warnings.push("register map is partial — addresses extracted without bit-field detail; the host AI should add bit fields from the datasheet");
+    }
     const addressCount = new Map();
     for (const r of registers) {
         // Duplicate single addresses (ranges like "0x88…0xA1" are skipped here).
         if (HEX_ONLY.test(r.address)) {
             addressCount.set(r.address, (addressCount.get(r.address) ?? 0) + 1);
         }
-        const occupied = new Array(8).fill(false);
+        if (r.width !== undefined && !VALID_WIDTHS.has(r.width)) {
+            errors.push(`${r.name}: invalid register width ${r.width} (expected 8, 16, or 32)`);
+        }
+        const width = registerWidth(r);
+        const occupied = new Array(width).fill(false);
         for (const field of r.bitFields) {
-            if (field.msb < 0 || field.msb > 7 || field.lsb < 0 || field.lsb > 7) {
+            if (field.msb < 0 ||
+                field.msb > width - 1 ||
+                field.lsb < 0 ||
+                field.lsb > width - 1) {
                 errors.push(`${r.name}.${field.name}: bit index out of range (${field.msb}:${field.lsb})`);
                 continue;
             }
@@ -45,8 +67,8 @@ function validateRegisters(registers, errors) {
                 occupied[b] = true;
             }
         }
-        if (HEX_ONLY.test(r.reset) && Number.parseInt(r.reset, 16) > 0xff) {
-            errors.push(`${r.name}: reset ${r.reset} exceeds the 8-bit register width`);
+        if (HEX_ONLY.test(r.reset) && Number.parseInt(r.reset, 16) > 2 ** width - 1) {
+            errors.push(`${r.name}: reset ${r.reset} exceeds the ${width}-bit register width`);
         }
     }
     for (const [address, count] of addressCount) {
@@ -55,9 +77,14 @@ function validateRegisters(registers, errors) {
         }
     }
 }
-function validateCommands(commands, errors, warnings) {
+function validateCommands(commands, errors, warnings, status, pages) {
     if (commands.length === 0) {
-        errors.push("command_set has no commands");
+        if (status === "deferred") {
+            warnings.push(`command set detected${detectedOn(pages)} but not auto-extracted — the host AI must complete it from the datasheet resource`);
+        }
+        else {
+            errors.push("command_set has no commands");
+        }
         return;
     }
     const codeCount = new Map();

package/dist/schema/validate.js.map

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

package/dist/server.d.ts

@@ -5,3 +5,21 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
  * transport wiring so tests can drive it over an in-memory transport.
  */
 export declare function createServer(): McpServer;
+/**
+ * Whether `moduleUrl` (an `import.meta.url`) is the file Node was invoked to
+ * run directly (`argv1`), rather than a module some other entry point
+ * imported — e.g. the test suite importing server.ts as a library.
+ *
+ * A raw `fileURLToPath(moduleUrl) === argv1` string comparison (B1) breaks
+ * under a POSIX npm-bin symlink: `npx driverge`/a global install invokes the
+ * package's bin SYMLINK, so `argv1` is the symlink path, while
+ * `fileURLToPath(import.meta.url)` resolves to the module's REAL (symlink
+ * target) path — the two strings never match, so the installed CLI silently
+ * does nothing. Falling back to a `realpathSync(argv1)` comparison resolves
+ * the symlink to the same real path the module URL already has, so the direct
+ * string match still short-circuits the common case and only the symlink
+ * case pays for an extra syscall. `realpathSync` is wrapped in try/catch
+ * because `argv1` could point at a file that no longer exists (or never did)
+ * — in which case this is simply not that file, not a crash.
+ */
+export declare function isMainModule(moduleUrl: string, argv1: string | undefined): boolean;

package/dist/server.js

@@ -6,13 +6,30 @@
 // analyze_datasheet / generate_driver / validate_driver / validate_datasheet
 // tools, the datasheet + schema resources, and the generate-driver prompt.
 // See wiki: mcp-tool-usage-flow.
+import { readFileSync, realpathSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { registerDriverge } from "./mcp/register.js";
 const SERVER_NAME = "driverge-mcp";
-const SERVER_VERSION = "0.0.0";
+// Read the version from package.json rather than hardcoding it (Session 10 /
+// Contract B7), so it can't drift from what `npm` actually published. The
+// relative path resolves correctly from BOTH src/ (ts-node/vitest) and dist/
+// (the built, published layout) since both sit exactly one level under the
+// package root. Falls back to "0.0.0" if the file is somehow unreadable —
+// never crash the server over a version string.
+function readServerVersion() {
+    try {
+        const url = new URL("../package.json", import.meta.url);
+        const pkg = JSON.parse(readFileSync(fileURLToPath(url), "utf8"));
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+const SERVER_VERSION = readServerVersion();
 /**
  * Build a Driverge MCP server with its tools registered. Kept separate from the
  * transport wiring so tests can drive it over an in-memory transport.
@@ -36,10 +53,39 @@ async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }
+/**
+ * Whether `moduleUrl` (an `import.meta.url`) is the file Node was invoked to
+ * run directly (`argv1`), rather than a module some other entry point
+ * imported — e.g. the test suite importing server.ts as a library.
+ *
+ * A raw `fileURLToPath(moduleUrl) === argv1` string comparison (B1) breaks
+ * under a POSIX npm-bin symlink: `npx driverge`/a global install invokes the
+ * package's bin SYMLINK, so `argv1` is the symlink path, while
+ * `fileURLToPath(import.meta.url)` resolves to the module's REAL (symlink
+ * target) path — the two strings never match, so the installed CLI silently
+ * does nothing. Falling back to a `realpathSync(argv1)` comparison resolves
+ * the symlink to the same real path the module URL already has, so the direct
+ * string match still short-circuits the common case and only the symlink
+ * case pays for an extra syscall. `realpathSync` is wrapped in try/catch
+ * because `argv1` could point at a file that no longer exists (or never did)
+ * — in which case this is simply not that file, not a crash.
+ */
+export function isMainModule(moduleUrl, argv1) {
+    if (argv1 === undefined)
+        return false;
+    const modulePath = fileURLToPath(moduleUrl);
+    if (modulePath === argv1)
+        return true;
+    try {
+        return realpathSync(argv1) === modulePath;
+    }
+    catch {
+        return false;
+    }
+}
 // Start the stdio server only when this file is executed directly (via the
 // `driverge` bin), not when imported — e.g. by the test suite.
-const isDirectRun = process.argv[1] !== undefined &&
-    fileURLToPath(import.meta.url) === process.argv[1];
+const isDirectRun = isMainModule(import.meta.url, process.argv[1]);
 if (isDirectRun) {
     main().catch((error) => {
         console.error("driverge-mcp failed to start:", error);

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA,qCAAqC;AACrC,EAAE;AACF,+EAA+E;AAC/E,0EAA0E;AAC1E,6EAA6E;AAC7E,2EAA2E;AAC3E,iCAAiC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,WAAW,GAAG,cAAc,CAAC;AACnC,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;IAE7E,MAAM,CAAC,YAAY,CACjB,MAAM,EACN;QACE,KAAK,EAAE,MAAM;QACb,WAAW,EACT,8EAA8E;QAChF,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;KAChD,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACtB,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE;SACvE;KACF,CAAC,CACH,CAAC;IAEF,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAEzB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,2EAA2E;AAC3E,+DAA+D;AAC/D,MAAM,WAAW,GACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;IAC7B,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAErD,IAAI,WAAW,EAAE,CAAC;IAChB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC9B,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "driverge-mcp",
-  "version": "0.0.0",
+  "version": "0.0.1",
   "description": "MCP server that turns IC datasheet PDFs into embedded C/C++ drivers, driven by any MCP client.",
   "keywords": [
     "mcp",

package/schemas/datasheet.schema.json

@@ -24,7 +24,7 @@
       "required": ["bus"],
       "additionalProperties": false,
       "properties": {
-        "bus": { "enum": ["I2C", "SPI", "UART", "unknown"] },
+        "bus": { "enum": ["I2C", "SPI", "UART", "CAN", "unknown"] },
         "addresses": { "type": "array", "items": { "type": "string" } },
         "maxClockHz": { "type": "number", "minimum": 0 }
       }
@@ -60,6 +60,16 @@
         "errors": { "type": "array", "items": { "type": "string" } },
         "warnings": { "type": "array", "items": { "type": "string" } }
       }
+    },
+    "extraction": {
+      "type": "object",
+      "description": "How complete the deterministic extraction is. Optional (absent on legacy JSON, treated as `none`).",
+      "required": ["status", "detectedPages"],
+      "additionalProperties": false,
+      "properties": {
+        "status": { "enum": ["complete", "partial", "deferred", "none"] },
+        "detectedPages": { "type": "array", "items": { "type": "integer", "minimum": 1 } }
+      }
     }
   },
   "definitions": {
@@ -71,6 +81,10 @@
         "name": { "type": "string" },
         "address": { "type": "string" },
         "reset": { "type": "string" },
+        "width": {
+          "description": "Register width in bits; absent means 8. Bounds bit-field indices and the reset value (enforced by the L5 validator).",
+          "enum": [8, 16, 32]
+        },
         "bitFields": { "type": "array", "items": { "$ref": "#/definitions/bitField" } }
       }
     },
@@ -80,8 +94,8 @@
       "additionalProperties": false,
       "properties": {
         "name": { "type": "string" },
-        "msb": { "type": "integer", "minimum": 0, "maximum": 7 },
-        "lsb": { "type": "integer", "minimum": 0, "maximum": 7 }
+        "msb": { "type": "integer", "minimum": 0, "maximum": 31 },
+        "lsb": { "type": "integer", "minimum": 0, "maximum": 31 }
       }
     },
     "command": {