driverge-mcp 0.0.0

package/dist/pdf/register-table.js

@@ -0,0 +1,234 @@
+// L4a (register path) — reconstruct a register map table from positioned text.
+//
+// Two layouts are handled behind one entry point:
+//
+//   * BME280 (Bosch) style — a single-line header ("Register Name | Address |
+//     bit7..bit0 | Reset state") whose bit fields are written as `name[hi:lo]`
+//     spans. Field positions are recovered geometrically: each field's center is
+//     matched to the bit-column span (of the width implied by `[hi:lo]`) it best
+//     aligns with, which correctly handles reserved-bit gaps.
+//
+//   * MCP23017 (Microchip) style — a header stacked across three physical text
+//     lines ("Register"/"Name", "Address"/"(hex)", "bit 7".."bit 0",
+//     "POR/RST"/"value") that pdfjs emits as separate rows too far apart for the
+//     row clusterer to merge, so we merge the header *band* explicitly. Each
+//     register names every bit individually (IO7..IO0) rather than using spans,
+//     addresses are bare hex ("00") and resets are binary ("1111 1111"); both are
+//     normalized to the "0x.." forms the schema/validator expect.
+import { centerX, clusterRows } from "./table.js";
+const HEX = /0x[0-9A-Fa-f]+/;
+// Bare Microchip address cell: 1-2 hex digits, optional trailing "h" ("00", "1A").
+const BARE_HEX = /^([0-9A-Fa-f]{1,2})h?$/;
+// name[hi:lo] | name[n] | name<hi:lo> | name<n>
+const BITFIELD = /^(.+?)[<[](\d+)(?::(\d+))?[>\]]$/;
+// Max vertical span (px) of a header whose column labels stack over a few lines.
+const HEADER_BAND = 14;
+const norm = (s) => s.toLowerCase().replace(/\s+/g, "");
+function isHeader(row) {
+    const cells = row.items.map((it) => norm(it.str));
+    return (
+    // "Register Name" (BME280, one cell) or a split "Register" cell (Microchip).
+    (cells.includes("registername") || cells.includes("register")) &&
+        cells.includes("address") &&
+        cells.includes("bit7") &&
+        cells.includes("bit0"));
+}
+/**
+ * Find the header, merging a stacked multi-line header into one synthetic row.
+ * clusterRows already groups baselines within ~5px; here we additionally fold in
+ * up to two more nearby rows when a single cluster doesn't yet carry all the
+ * header tokens (the Microchip header lines sit ~5-6px apart, just past the row
+ * tolerance). Returns the merged header plus the y of the band's lowest line so
+ * the caller can exclude the folded-in sub-rows from the table body.
+ */
+function findHeaderBand(rows) {
+    for (let i = 0; i < rows.length; i++) {
+        let merged = [...rows[i].items];
+        let bandBottom = rows[i].y;
+        for (let k = 0; k < 3; k++) {
+            if (isHeader({ y: rows[i].y, items: merged })) {
+                const items = [...merged].sort((a, b) => a.x - b.x);
+                return { header: { y: rows[i].y, items }, bandBottom };
+            }
+            const next = rows[i + k + 1];
+            if (!next || rows[i].y - next.y > HEADER_BAND)
+                break;
+            merged = merged.concat(next.items);
+            bandBottom = next.y;
+        }
+    }
+    return undefined;
+}
+function columnsFromHeader(header) {
+    const bitCenters = [];
+    let nameCenter;
+    let addrCenter;
+    const resetCenters = [];
+    let perBit = false;
+    for (const it of header.items) {
+        const t = norm(it.str);
+        const bit = /^bit([0-7])$/.exec(t);
+        if (bit) {
+            bitCenters[Number(bit[1])] = centerX(it);
+        }
+        else if (t === "registername" || t === "register" || t === "name") {
+            // BME280 has one "Register Name" cell; Microchip stacks "Register"/"Name".
+            nameCenter ??= centerX(it);
+        }
+        else if (t === "address") {
+            addrCenter = centerX(it);
+        }
+        else if (t === "reset" || t === "state" || t === "resetstate") {
+            resetCenters.push(centerX(it));
+        }
+        else if (t === "por/rst" || t === "value") {
+            resetCenters.push(centerX(it));
+            perBit = true; // Microchip's reset header — signals the per-bit layout.
+        }
+    }
+    if (nameCenter === undefined ||
+        addrCenter === undefined ||
+        bitCenters[7] === undefined ||
+        bitCenters[0] === undefined) {
+        return undefined;
+    }
+    const resetCenter = resetCenters.length > 0
+        ? resetCenters.reduce((a, b) => a + b, 0) / resetCenters.length
+        : bitCenters[0] + 40;
+    return {
+        nameMax: (nameCenter + addrCenter) / 2,
+        addrMax: (addrCenter + bitCenters[7]) / 2,
+        bitMax: (bitCenters[0] + resetCenter) / 2,
+        bitCenters,
+        perBit,
+    };
+}
+function bitPosition(fieldCenter, width, bitCenters) {
+    let best = { msb: width - 1, lsb: 0, err: Infinity };
+    for (let msb = width - 1; msb <= 7; msb++) {
+        const lsb = msb - width + 1;
+        const hiC = bitCenters[msb];
+        const loC = bitCenters[lsb];
+        if (hiC === undefined || loC === undefined)
+            continue;
+        const spanCenter = (hiC + loC) / 2;
+        const err = Math.abs(fieldCenter - spanCenter);
+        if (err < best.err)
+            best = { msb, lsb, err };
+    }
+    return { msb: best.msb, lsb: best.lsb };
+}
+/** BME280 span layout: `name[hi:lo]` cells matched to bit-column spans. */
+function parseBitFields(cells, cols) {
+    const fields = [];
+    for (const cell of cells) {
+        const m = BITFIELD.exec(cell.str.trim());
+        if (!m)
+            continue; // lone "0"/"1" reserved markers and prose are ignored
+        const name = m[1].trim();
+        const hi = Number(m[2]);
+        const width = m[3] !== undefined ? hi - Number(m[3]) + 1 : 1;
+        if (!name || width < 1 || width > 8)
+            continue;
+        const pos = bitPosition(centerX(cell), width, cols.bitCenters);
+        fields.push({ name, msb: pos.msb, lsb: pos.lsb });
+    }
+    fields.sort((a, b) => b.msb - a.msb);
+    return fields;
+}
+/** Microchip per-bit layout: each named cell snaps to its nearest bit column. */
+function parseBitFieldsPerBit(cells, cols) {
+    const fields = [];
+    for (const cell of cells) {
+        const name = cell.str.trim();
+        // Skip unimplemented-bit dashes and lone reserved "0"/"1" markers.
+        if (!name || name === "—" || name === "-" || /^[01]$/.test(name))
+            continue;
+        const c = centerX(cell);
+        let idx = -1;
+        let err = Infinity;
+        for (let i = 0; i <= 7; i++) {
+            if (cols.bitCenters[i] === undefined)
+                continue;
+            const e = Math.abs(c - cols.bitCenters[i]);
+            if (e < err) {
+                err = e;
+                idx = i;
+            }
+        }
+        if (idx < 0)
+            continue;
+        fields.push({ name, msb: idx, lsb: idx });
+    }
+    fields.sort((a, b) => b.msb - a.msb);
+    return fields;
+}
+/** "00"/"1A" -> "0x00"/"0x1A". */
+function normalizeAddress(raw) {
+    const m = BARE_HEX.exec(raw);
+    return m ? `0x${m[1].toUpperCase().padStart(2, "0")}` : raw;
+}
+/** "1111 1111"/"0000 0000" -> "0xFF"/"0x00". */
+function normalizeReset(raw) {
+    const bits = raw.replace(/\s+/g, "");
+    if (/^[01]{8}$/.test(bits)) {
+        return `0x${Number.parseInt(bits, 2).toString(16).toUpperCase().padStart(2, "0")}`;
+    }
+    return raw;
+}
+/** Parse a register map table from a single page, if it holds one. */
+export function parseRegisterTable(page) {
+    const rows = clusterRows(page.items);
+    const band = findHeaderBand(rows);
+    if (!band)
+        return undefined;
+    const cols = columnsFromHeader(band.header);
+    if (!cols)
+        return undefined;
+    const below = rows
+        .filter((r) => r.y < band.bandBottom)
+        .sort((a, b) => b.y - a.y);
+    const registers = [];
+    for (const row of below) {
+        const name = row.items
+            .filter((it) => centerX(it) < cols.nameMax)
+            .map((it) => it.str)
+            .join(" ")
+            .replace(/\s+/g, " ")
+            .trim();
+        const rawAddress = row.items
+            .filter((it) => centerX(it) >= cols.nameMax && centerX(it) < cols.addrMax)
+            .map((it) => it.str)
+            .join("")
+            .trim();
+        // Leave the table body once a row has no recognizable address.
+        const addressOk = cols.perBit ? BARE_HEX.test(rawAddress) : HEX.test(rawAddress);
+        if (!addressOk)
+            break;
+        const rawReset = row.items
+            .filter((it) => centerX(it) >= cols.bitMax)
+            .map((it) => it.str)
+            .join(" ")
+            .trim();
+        const bitCells = row.items.filter((it) => centerX(it) >= cols.addrMax && centerX(it) < cols.bitMax);
+        registers.push({
+            name,
+            address: cols.perBit ? normalizeAddress(rawAddress) : rawAddress,
+            reset: cols.perBit ? normalizeReset(rawReset) : rawReset,
+            bitFields: cols.perBit
+                ? parseBitFieldsPerBit(bitCells, cols)
+                : parseBitFields(bitCells, cols),
+        });
+    }
+    return { page: page.index, registers };
+}
+/** Scan pages and return the first register map table found. */
+export function findRegisterTable(pages) {
+    for (const page of pages) {
+        const table = parseRegisterTable(page);
+        if (table && table.registers.length > 0)
+            return table;
+    }
+    return undefined;
+}
+//# sourceMappingURL=register-table.js.map

package/dist/pdf/register-table.js.map

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

package/dist/pdf/table.d.ts

@@ -0,0 +1,18 @@
+import type { PositionedText } from "./types.js";
+export interface TableRow {
+    /** Representative y (the top-most y of the cluster). */
+    y: number;
+    /** Row items, left-to-right. */
+    items: PositionedText[];
+}
+/**
+ * Group positioned text into rows. Items whose y is within `yTolerance` of an
+ * open row join it (datasheet rows often split a pixel or two across baselines).
+ * Rows come back top-to-bottom; items within a row left-to-right.
+ */
+export declare function clusterRows(items: PositionedText[], yTolerance?: number): TableRow[];
+/** Horizontal center of a positioned item. */
+export declare function centerX(it: {
+    x: number;
+    width: number;
+}): number;

package/dist/pdf/table.js

@@ -0,0 +1,33 @@
+// Generic table reconstruction over positioned text: cluster items into rows by
+// vertical proximity. Column assignment is caller-specific (see register-table).
+/**
+ * Group positioned text into rows. Items whose y is within `yTolerance` of an
+ * open row join it (datasheet rows often split a pixel or two across baselines).
+ * Rows come back top-to-bottom; items within a row left-to-right.
+ */
+export function clusterRows(items, yTolerance = 5) {
+    const sorted = items
+        .filter((it) => it.str.trim() !== "")
+        .sort((a, b) => b.y - a.y);
+    // Group by the gap to the *previous* item (not a fixed anchor), so a header
+    // like "Reset" / "state" split a few px apart still lands in one row.
+    const rows = [];
+    let prevY;
+    for (const it of sorted) {
+        if (rows.length > 0 && prevY !== undefined && prevY - it.y <= yTolerance) {
+            rows[rows.length - 1].items.push(it);
+        }
+        else {
+            rows.push({ y: it.y, items: [it] });
+        }
+        prevY = it.y;
+    }
+    for (const row of rows)
+        row.items.sort((a, b) => a.x - b.x);
+    return rows;
+}
+/** Horizontal center of a positioned item. */
+export function centerX(it) {
+    return it.x + it.width / 2;
+}
+//# sourceMappingURL=table.js.map

package/dist/pdf/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../src/pdf/table.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,iFAAiF;AAWjF;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,KAAuB,EACvB,UAAU,GAAG,CAAC;IAEd,MAAM,MAAM,GAAG,KAAK;SACjB,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;SACpC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7B,4EAA4E;IAC5E,sEAAsE;IACtE,MAAM,IAAI,GAAe,EAAE,CAAC;IAC5B,IAAI,KAAyB,CAAC;IAC9B,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC,IAAI,UAAU,EAAE,CAAC;YACzE,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC;IACf,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,IAAI;QAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,OAAO,CAAC,EAAgC;IACtD,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC;AAC7B,CAAC"}

package/dist/pdf/types.d.ts

@@ -0,0 +1,82 @@
+/** Overall classification of a datasheet PDF. */
+export type PdfType = "text_based" | "scanned" | "mixed";
+/** Per-page classification. */
+export type PageKind = "text" | "scanned" | "blank";
+/** A single positioned text run extracted from a page. */
+export interface PositionedText {
+    str: string;
+    /** X of the text origin, in PDF user-space units (origin bottom-left). */
+    x: number;
+    /** Y of the text origin, in PDF user-space units. */
+    y: number;
+    width: number;
+    height: number;
+}
+/** Everything extracted from one page. */
+export interface PageContent {
+    /** 1-based page number. */
+    index: number;
+    /** Whitespace-normalized concatenation of the page's text runs. */
+    text: string;
+    items: PositionedText[];
+    /** Whether the page paints a raster image (a "scanned" signal). */
+    hasImage: boolean;
+}
+/** Minimal per-page signal the classifier needs — kept PDF-free so it is pure. */
+export interface PageSignal {
+    textLength: number;
+    hasImage: boolean;
+}
+export interface PdfClassification {
+    type: PdfType;
+    pageKinds: PageKind[];
+}
+/** Label -> 1-based page numbers where that section was detected. */
+export type PageMap = Record<string, number[]>;
+/** One bit field within a register, positioned by absolute bit index. */
+export interface BitField {
+    name: string;
+    /** Most-significant bit index within the register (0-7). */
+    msb: number;
+    /** Least-significant bit index within the register (0-7). */
+    lsb: number;
+}
+/** A single register row reconstructed from a memory-map table. */
+export interface Register {
+    name: string;
+    /** Verbatim address cell, e.g. "0xF4" or a range like "0x88…0xA1". */
+    address: string;
+    /** Verbatim reset/default cell, e.g. "0x00", "0x60", "individual". */
+    reset: string;
+    bitFields: BitField[];
+}
+/** The register map extracted from one table. */
+export interface RegisterTable {
+    /** 1-based page the table was found on. */
+    page: number;
+    registers: Register[];
+}
+/** L3a — deterministic manufacturer detection result. */
+export interface ManufacturerDetection {
+    /** Vendor name, or "generic" when no confident match. */
+    manufacturer: string;
+    /** 0-1; 0 means generic fallback. */
+    confidence: number;
+    /** Which signals fired, e.g. ["copyright", "doc-number", "url"]. */
+    signals: string[];
+}
+/** L3b — control-interface classification. */
+export type InterfaceKind = "register_map" | "command_set" | "unknown";
+export interface InterfaceKindDetection {
+    kind: InterfaceKind;
+    confidence: number;
+    signals: string[];
+}
+/** Result of L1 + L2 over a whole PDF. */
+export interface PdfAnalysis {
+    type: PdfType;
+    pageCount: number;
+    pageMap: PageMap;
+    pages: PageContent[];
+    warnings: string[];
+}

package/dist/pdf/types.js

@@ -0,0 +1,3 @@
+// Shared types for the PDF parsing pipeline (L1 format detection + L2 page map).
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pdf/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/pdf/types.ts"],"names":[],"mappings":"AAAA,iFAAiF"}

package/dist/schema/assemble.d.ts

@@ -0,0 +1,4 @@
+import type { PdfAnalysis } from "../pdf/types.js";
+import type { DatasheetJson } from "./types.js";
+/** Assemble + validate the datasheet contract from a completed PDF analysis. */
+export declare function assembleDatasheet(analysis: PdfAnalysis): DatasheetJson;

package/dist/schema/assemble.js

@@ -0,0 +1,48 @@
+// Glue: run the L3/L4 extractors over an analyzed PDF and assemble the frozen
+// DatasheetJson contract, then validate it (L5). This is the single place the
+// scattered pipeline stages (manufacturer, interface-kind, register table,
+// 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 { detectManufacturer } from "../pdf/manufacturer.js";
+import { detectPart } from "../pdf/part.js";
+import { findRegisterTable } from "../pdf/register-table.js";
+import { validateDatasheet } from "./validate.js";
+function buildInterface(pages, kind) {
+    if (kind === "command_set") {
+        return { kind: "command_set", commands: extractCommands(pages) };
+    }
+    // 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") {
+        const commands = extractCommands(pages);
+        if (commands.length > 0)
+            return { kind: "command_set", commands };
+    }
+    return { kind: "register_map", registers: table?.registers ?? [] };
+}
+/** Assemble + validate the datasheet contract from a completed PDF analysis. */
+export function assembleDatasheet(analysis) {
+    const { pages } = analysis;
+    const manufacturer = detectManufacturer(pages);
+    const kind = detectInterfaceKind(pages).kind;
+    const partial = {
+        metadata: {
+            part: detectPart(pages),
+            manufacturer: manufacturer.manufacturer,
+            manufacturerConfidence: manufacturer.confidence,
+            pdfType: analysis.type,
+            pageCount: analysis.pageCount,
+        },
+        protocol: extractProtocol(pages),
+        interface: buildInterface(pages, kind),
+    };
+    const validation = validateDatasheet({
+        ...partial,
+        validation: { valid: true, errors: [], warnings: [] },
+    });
+    return { ...partial, validation };
+}
+//# sourceMappingURL=assemble.js.map

package/dist/schema/assemble.js.map

@@ -0,0 +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"}

package/dist/schema/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types.js";
+export { validateDatasheet } from "./validate.js";

package/dist/schema/index.js

@@ -0,0 +1,4 @@
+// Public surface of the datasheet JSON contract + validator.
+export * from "./types.js";
+export { validateDatasheet } from "./validate.js";
+//# sourceMappingURL=index.js.map

package/dist/schema/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/schema/types.d.ts

@@ -0,0 +1,51 @@
+import type { PdfType, Register } from "../pdf/types.js";
+export type Bus = "I2C" | "SPI" | "UART" | "unknown";
+export interface DatasheetMetadata {
+    part: string;
+    manufacturer: string;
+    /** 0-1 confidence from L3a manufacturer detection. */
+    manufacturerConfidence: number;
+    pdfType: PdfType;
+    pageCount: number;
+}
+export interface Protocol {
+    bus: Bus;
+    /** Bus addresses, e.g. ["0x76", "0x77"]. */
+    addresses?: string[];
+    maxClockHz?: number;
+}
+/** A command for a command-set device (see command-set-interface). */
+export interface Command {
+    name: string;
+    /** Hex command word, e.g. "0x2C06". */
+    code: string;
+    params?: string[];
+    /** Number of response words (each usually a data word + CRC). */
+    responseWords?: number;
+    crc?: {
+        poly: string;
+        init: string;
+        width: number;
+    };
+}
+export interface RegisterInterface {
+    kind: "register_map";
+    registers: Register[];
+}
+export interface CommandInterface {
+    kind: "command_set";
+    commands: Command[];
+}
+export type DeviceInterface = RegisterInterface | CommandInterface;
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/** The full parsed datasheet handed (by ref) to the host AI. */
+export interface DatasheetJson {
+    metadata: DatasheetMetadata;
+    protocol: Protocol;
+    interface: DeviceInterface;
+    validation: ValidationResult;
+}

package/dist/schema/types.js

@@ -0,0 +1,7 @@
+// The datasheet JSON contract — the frozen interface between the deterministic
+// parser and the host AI (see wiki: json-schema-as-contract). The `interface`
+// field is a discriminated union on `kind`, which is the primary strategy axis
+// (device-class-before-manufacturer). The JSON-Schema mirror lives at
+// schemas/datasheet.schema.json.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/schema/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/schema/types.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8EAA8E;AAC9E,+EAA+E;AAC/E,sEAAsE;AACtE,iCAAiC"}

package/dist/schema/validate.d.ts

@@ -0,0 +1,2 @@
+import type { DatasheetJson, ValidationResult } from "./types.js";
+export declare function validateDatasheet(d: DatasheetJson): ValidationResult;

package/dist/schema/validate.js

@@ -0,0 +1,84 @@
+// 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.
+const HEX_ONLY = /^0x[0-9a-f]+$/i;
+export function validateDatasheet(d) {
+    const errors = [];
+    const warnings = [];
+    if (!d.metadata.part)
+        warnings.push("metadata.part is empty");
+    if (d.protocol.bus === "unknown")
+        warnings.push("protocol.bus is unknown");
+    if (d.interface.kind === "register_map") {
+        validateRegisters(d.interface.registers, errors);
+    }
+    else {
+        validateCommands(d.interface.commands, errors, warnings);
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+function validateRegisters(registers, errors) {
+    if (registers.length === 0) {
+        errors.push("register_map has no registers");
+        return;
+    }
+    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);
+        for (const field of r.bitFields) {
+            if (field.msb < 0 || field.msb > 7 || field.lsb < 0 || field.lsb > 7) {
+                errors.push(`${r.name}.${field.name}: bit index out of range (${field.msb}:${field.lsb})`);
+                continue;
+            }
+            if (field.msb < field.lsb) {
+                errors.push(`${r.name}.${field.name}: msb < lsb (${field.msb}:${field.lsb})`);
+                continue;
+            }
+            for (let b = field.lsb; b <= field.msb; b++) {
+                if (occupied[b]) {
+                    errors.push(`${r.name}: bit ${b} claimed by more than one field`);
+                }
+                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`);
+        }
+    }
+    for (const [address, count] of addressCount) {
+        if (count > 1) {
+            errors.push(`duplicate register address ${address} (${count}x)`);
+        }
+    }
+}
+function validateCommands(commands, errors, warnings) {
+    if (commands.length === 0) {
+        errors.push("command_set has no commands");
+        return;
+    }
+    const codeCount = new Map();
+    for (const c of commands) {
+        if (!HEX_ONLY.test(c.code)) {
+            errors.push(`${c.name}: invalid command code "${c.code}"`);
+        }
+        else {
+            codeCount.set(c.code, (codeCount.get(c.code) ?? 0) + 1);
+        }
+        if (c.responseWords === undefined) {
+            warnings.push(`${c.name}: response length not declared`);
+        }
+        if (!c.crc) {
+            warnings.push(`${c.name}: CRC parameters missing`);
+        }
+    }
+    for (const [code, count] of codeCount) {
+        if (count > 1) {
+            errors.push(`duplicate command code ${code} (${count}x)`);
+        }
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/schema/validate.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * 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.
+ */
+export declare function createServer(): McpServer;