@mailwoman/mcp 8.3.0 → 8.5.0

package/out/layer-guards.js

@@ -0,0 +1,89 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Decision 6 (2b task 7) layer-absent guards — pulled out of `cli.ts` into their own importable module (task 7
+ *   fix round 1 review finding) so the branching itself has direct unit coverage (`layer-guards.test.ts`), not just
+ *   "the tool handler passes an abstain through" (`tools.test.ts`'s stub-level dispatch tests). `cli.ts`
+ *   top-level-`await`s a real stdio transport connection at import time, so IT can't be imported by vitest — these
+ *   three functions have no such dependency (pure existence-check + open, or a thrown Error), so they live here and
+ *   `cli.ts` just calls them.
+ *
+ *   - `openBDCDatabaseIfPresent` / `openPlausibilityPOIDeps` — `mailwoman_plausibility_check`'s `bdcDB`/`poi` deps
+ *     (`PlausibilityDeps`) are each OPTIONAL, so a missing/absent path degrades to `undefined`, which
+ *     `plausibilityCheck` (`@mailwoman/bdc`) already turns into a typed abstain evidence entry
+ *     (`{type:"abstain", reason:"requires_bdc_layer"|"requires_build_local_layer"}`) — never a raw sqlite throw.
+ *   - `assertBDCDatabaseExists` — `mailwoman_bdc_filing_landscape` requires bdc.db unconditionally (no optional-dep
+ *     abstain shape exists for that tool), so a missing file becomes one friendly thrown `Error` naming the layer
+ *     instead of the raw `node:sqlite` "unable to open database file" message.
+ *   - `openFilerDatabaseIfPresent` / `assertFilerDatabaseExists` (3a task 7) — the SAME pairing, for filer.db.
+ *     `mailwoman_filer_lookup` requires filer.db unconditionally (mirrors `mailwoman_bdc_filing_landscape`'s own
+ *     "requires the layer" discipline — `filerLookup` itself has no optional-dep abstain shape either, since gate
+ *     4 makes it throw rather than answer unstamped), so `cli.ts` pairs `assertFilerDatabaseExists` (the friendly
+ *     throw) with `openFilerDatabaseIfPresent` (the actual open) the same way `bdcFilingLandscape`'s handler does.
+ */
+import { existsSync } from "node:fs";
+import { DatabaseSync } from "node:sqlite";
+import { DatabaseClient } from "@mailwoman/core/kysley/client";
+/**
+ * Open a bdc.db, or return `undefined` when `databasePath` is unset or the file is missing — NEVER a raw sqlite throw.
+ * See the module header.
+ */
+export function openBDCDatabaseIfPresent(databasePath) {
+    if (!databasePath || !existsSync(databasePath))
+        return undefined;
+    return new DatabaseClient({ database: new DatabaseSync(databasePath, { readOnly: true }) });
+}
+/**
+ * Same graceful discipline as {@link openBDCDatabaseIfPresent}, for the poi.db side of `plausibilityCheck`'s deps —
+ * `undefined` here becomes the `{type:"abstain", reason:"requires_build_local_layer"}` entry `plausibilityCheck`
+ * already produces when a claimed technology's physical-plant categories can't be searched. `POILookup` is dynamically
+ * imported (matching `cli.ts`'s existing `resolver-wof-sqlite` laziness) since it's only ever needed when a caller
+ * actually wires a poi.db. `lookup` and `contractDB` share ONE `DatabaseSync` handle (the AGENTS.md "one connection,
+ * shared" convention) — a real poi.db's rows and its `layer_manifest`/`layer_coverage` tables live in the same file in
+ * production, so disposing `contractDB` (which closes the shared handle) is enough; `POILookup` never owns it
+ * (constructed with `{database}`, not `{databasePath}` — see `poi-lookup.ts`), so it never double-closes.
+ */
+export async function openPlausibilityPOIDeps(databasePath) {
+    if (!databasePath || !existsSync(databasePath))
+        return undefined;
+    const { POILookup } = await import("@mailwoman/resolver-wof-sqlite/poi-lookup");
+    const database = new DatabaseSync(databasePath, { readOnly: true });
+    return {
+        lookup: new POILookup({ database }),
+        contractDB: new DatabaseClient({ database }),
+    };
+}
+/**
+ * Throws a friendly Error naming the layer when `databasePath` doesn't exist — `mailwoman_bdc_filing_landscape`'s guard
+ * (decision 6b). `toolName` is threaded through so the message matches whichever tool calls this (today: only
+ * `mailwoman_bdc_filing_landscape`).
+ */
+export function assertBDCDatabaseExists(toolName, databasePath) {
+    if (!existsSync(databasePath)) {
+        throw new Error(`${toolName}: bdc.db not found at "${databasePath}"`);
+    }
+}
+/**
+ * Open a filer.db, or return `undefined` when `databasePath` is unset or the file is missing — NEVER a raw sqlite throw
+ * (3a task 7, mirroring {@link openBDCDatabaseIfPresent}). Used by `cli.ts`'s `mailwoman_filer_lookup` handler after
+ * {@link assertFilerDatabaseExists} has already confirmed the file is present.
+ */
+export function openFilerDatabaseIfPresent(databasePath) {
+    if (!databasePath || !existsSync(databasePath))
+        return undefined;
+    return new DatabaseClient({ database: new DatabaseSync(databasePath, { readOnly: true }) });
+}
+/**
+ * Throws a friendly Error naming the layer when `databasePath` doesn't exist — `mailwoman_filer_lookup`'s guard (3a
+ * task 7, mirroring {@link assertBDCDatabaseExists}). `filerLookup` itself has no optional-dep abstain shape (gate 4
+ * makes it throw rather than answer unstamped), so filer.db is required unconditionally, same as bdc.db is for
+ * `mailwoman_bdc_filing_landscape`.
+ */
+export function assertFilerDatabaseExists(toolName, databasePath) {
+    if (!existsSync(databasePath)) {
+        throw new Error(`${toolName}: filer.db not found at "${databasePath}"`);
+    }
+}
+//# sourceMappingURL=layer-guards.js.map

package/out/layer-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer-guards.js","sourceRoot":"","sources":["../layer-guards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG1C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAI9D;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,YAAgC;IACxE,IAAI,CAAC,YAAY,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,SAAS,CAAA;IAEhE,OAAO,IAAI,cAAc,CAAc,EAAE,QAAQ,EAAE,IAAI,YAAY,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAA;AACzG,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,YAAgC;IAC7E,IAAI,CAAC,YAAY,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,SAAS,CAAA;IAEhE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAA;IAC/E,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;IAEnE,OAAO;QACN,MAAM,EAAE,IAAI,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;QACnC,UAAU,EAAE,IAAI,cAAc,CAAwB,EAAE,QAAQ,EAAE,CAAC;KACnE,CAAA;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB,EAAE,YAAoB;IAC7E,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,0BAA0B,YAAY,GAAG,CAAC,CAAA;IACtE,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACzC,YAAgC;IAEhC,IAAI,CAAC,YAAY,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,SAAS,CAAA;IAEhE,OAAO,IAAI,cAAc,CAAgB,EAAE,QAAQ,EAAE,IAAI,YAAY,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAA;AAC3G,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB,EAAE,YAAoB;IAC/E,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,4BAA4B,YAAY,GAAG,CAAC,CAAA;IACxE,CAAC;AACF,CAAC"}

package/out/server.d.ts

@@ -12,9 +12,9 @@ import { type MCPToolDeps } from "./tools.ts";
 /**
  * Build an `McpServer` with every `tools.ts` tool registered. A handler's returned value is JSON-stringified into a
  * single `text` content block — every tool here answers with structured data (parse trees, geocode results, search
- * hits), so a plain JSON text block is the simplest faithful rendering; none of the five tools need images, resource
- * links, or other MCP content kinds. A thrown error becomes an `isError` tool result instead of a protocol-level
- * failure, so a bad address / missing db surfaces to the agent as a normal (if unsuccessful) tool call.
+ * hits), so a plain JSON text block is the simplest faithful rendering; none of the tools need images, resource links,
+ * or other MCP content kinds. A thrown error becomes an `isError` tool result instead of a protocol-level failure, so a
+ * bad address / missing db surfaces to the agent as a normal (if unsuccessful) tool call.
  */
 export declare function createMCPServer(deps: MCPToolDeps): McpServer;
 //# sourceMappingURL=server.d.ts.map

package/out/server.js

@@ -19,9 +19,9 @@ const MCP_SERVER_VERSION = "7.1.0";
 /**
  * Build an `McpServer` with every `tools.ts` tool registered. A handler's returned value is JSON-stringified into a
  * single `text` content block — every tool here answers with structured data (parse trees, geocode results, search
- * hits), so a plain JSON text block is the simplest faithful rendering; none of the five tools need images, resource
- * links, or other MCP content kinds. A thrown error becomes an `isError` tool result instead of a protocol-level
- * failure, so a bad address / missing db surfaces to the agent as a normal (if unsuccessful) tool call.
+ * hits), so a plain JSON text block is the simplest faithful rendering; none of the tools need images, resource links,
+ * or other MCP content kinds. A thrown error becomes an `isError` tool result instead of a protocol-level failure, so a
+ * bad address / missing db surfaces to the agent as a normal (if unsuccessful) tool call.
  */
 export function createMCPServer(deps) {
     const server = new McpServer({ name: "mailwoman", version: MCP_SERVER_VERSION });

package/out/tools.d.ts

@@ -8,7 +8,9 @@
  *   file (the actual product surface) is testable without any MCP plumbing — `tools.test.ts` calls
  *   `buildToolTable` directly with stub deps.
  *
- *   Five tools, one per capability the exotic-POI arc's other packages expose to a human/CLI caller:
+ *   One tool per capability the exotic-POI/BDC arcs' other packages expose to a human/CLI caller — see
+ *   `buildToolTable`'s return value for the authoritative, current list (this comment intentionally states no count,
+ *   so it can't go stale as tools are added):
  *
  *   - `mailwoman_parse` — the runtime pipeline's parse (optionally POI-aware).
  *   - `mailwoman_geocode` — the street-level geocode cascade (`mailwoman/geocode-core`).
@@ -17,6 +19,21 @@
  *     we never run it".
  *   - `mailwoman_layer_manifest` — read a spatial-layer database's provenance manifest + coverage summary
  *     (`@mailwoman/core/layers`).
+ *   - `mailwoman_bdc_filing_landscape` — read a bdc.db layer's provider/technology/speed-bucket filing census over a
+ *     set of census blocks or H3 cells (`@mailwoman/bdc`'s `filingLandscape`).
+ *   - `mailwoman_plausibility_check` — score one claimed broadband-service assertion against BDC filing evidence and
+ *     nearby telecom infrastructure (`@mailwoman/bdc`'s `plausibilityCheck`), returning a positive-evidence-only bundle
+ *     with an always-present `coverage_confidence`. A missing/absent `bdc_database_path`/`poi_database_path` degrades
+ *     to a typed abstain entry in the bundle, never a throw (2b task 7, decision 6).
+ *   - `mailwoman_filer_lookup` (3a task 7) — read the FCC filer identity crosswalk (`@mailwoman/filer`'s
+ *     `filerLookup`) for one identifier (FRN, Form 499 ID, or BDC provider ID): every OTHER identifier it shares an
+ *     authoritative edge with, its current attributes, its authoritative entity cluster, and any inferred links —
+ *     reported separately, never merged into the cluster. `as_of` is always present (defaults to today).
+ *   - `mailwoman_filer_family` (3b task 9) — read a corporate family's membership (`@mailwoman/filer/sdk`'s
+ *     `familyRollup`) from a filer.db layer database, given a `family_id` or a `node_id`. Distinct from an entity
+ *     cluster (same filer, different identifiers) — a corporate family spans several DIFFERENT filers under a
+ *     holding/parent/subsidiary/management relationship. The handler passes `familyRollup`'s result through
+ *     unchanged: no reshaping, filtering, or summarizing of who-owns-whom data.
  */
 import { z } from "zod";
 /**
@@ -33,6 +50,36 @@ export interface MCPToolDeps {
     }) => Promise<unknown>;
     overpassExport: (query: string) => Promise<string>;
     layerManifest: (databasePath: string) => Promise<unknown>;
+    bdcFilingLandscape: (q: {
+        databasePath: string;
+        geoids?: string[];
+        h3Cells?: number[];
+    }) => Promise<unknown>;
+    plausibilityCheck: (q: {
+        bdcDatabasePath?: string;
+        poiDatabasePath?: string;
+        address?: string;
+        point?: {
+            type: "Point";
+            coordinates: [number, number];
+        };
+        geoid?: string;
+        technologyCode: number;
+        claimedDownloadMbps: number;
+    }) => Promise<unknown>;
+    filerLookup: (q: {
+        databasePath: string;
+        frn?: string;
+        form499ID?: string;
+        bdcProviderID?: number;
+        asOf?: string;
+    }) => Promise<unknown>;
+    filerFamily: (q: {
+        databasePath: string;
+        familyID?: string;
+        nodeID?: string;
+        asOf?: string;
+    }) => Promise<unknown>;
 }
 /**
  * One MCP tool. `inputSchema` is a plain Zod object (not `any` — this repo's oxlint config errors on

package/out/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACnE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3C,SAAS,EAAE,CAAC,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/E,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAClD,aAAa,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACzD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;IACvC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5D;AA2CD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,EAAE,CAqE9D"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACnE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3C,SAAS,EAAE,CAAC,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/E,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAClD,aAAa,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACzD,kBAAkB,EAAE,CAAC,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5G,iBAAiB,EAAE,CAAC,CAAC,EAAE;QACtB,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,eAAe,CAAC,EAAE,MAAM,CAAA;QACxB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,KAAK,CAAC,EAAE;YAAE,IAAI,EAAE,OAAO,CAAC;YAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;SAAE,CAAA;QACxD,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,cAAc,EAAE,MAAM,CAAA;QACtB,mBAAmB,EAAE,MAAM,CAAA;KAC3B,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACtB,WAAW,EAAE,CAAC,CAAC,EAAE;QAChB,YAAY,EAAE,MAAM,CAAA;QACpB,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,IAAI,CAAC,EAAE,MAAM,CAAA;KACb,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACtB,WAAW,EAAE,CAAC,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACjH;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAA;IACvC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5D;AA+KD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,EAAE,CAwJ9D"}

package/out/tools.js

@@ -8,7 +8,9 @@
  *   file (the actual product surface) is testable without any MCP plumbing — `tools.test.ts` calls
  *   `buildToolTable` directly with stub deps.
  *
- *   Five tools, one per capability the exotic-POI arc's other packages expose to a human/CLI caller:
+ *   One tool per capability the exotic-POI/BDC arcs' other packages expose to a human/CLI caller — see
+ *   `buildToolTable`'s return value for the authoritative, current list (this comment intentionally states no count,
+ *   so it can't go stale as tools are added):
  *
  *   - `mailwoman_parse` — the runtime pipeline's parse (optionally POI-aware).
  *   - `mailwoman_geocode` — the street-level geocode cascade (`mailwoman/geocode-core`).
@@ -17,6 +19,21 @@
  *     we never run it".
  *   - `mailwoman_layer_manifest` — read a spatial-layer database's provenance manifest + coverage summary
  *     (`@mailwoman/core/layers`).
+ *   - `mailwoman_bdc_filing_landscape` — read a bdc.db layer's provider/technology/speed-bucket filing census over a
+ *     set of census blocks or H3 cells (`@mailwoman/bdc`'s `filingLandscape`).
+ *   - `mailwoman_plausibility_check` — score one claimed broadband-service assertion against BDC filing evidence and
+ *     nearby telecom infrastructure (`@mailwoman/bdc`'s `plausibilityCheck`), returning a positive-evidence-only bundle
+ *     with an always-present `coverage_confidence`. A missing/absent `bdc_database_path`/`poi_database_path` degrades
+ *     to a typed abstain entry in the bundle, never a throw (2b task 7, decision 6).
+ *   - `mailwoman_filer_lookup` (3a task 7) — read the FCC filer identity crosswalk (`@mailwoman/filer`'s
+ *     `filerLookup`) for one identifier (FRN, Form 499 ID, or BDC provider ID): every OTHER identifier it shares an
+ *     authoritative edge with, its current attributes, its authoritative entity cluster, and any inferred links —
+ *     reported separately, never merged into the cluster. `as_of` is always present (defaults to today).
+ *   - `mailwoman_filer_family` (3b task 9) — read a corporate family's membership (`@mailwoman/filer/sdk`'s
+ *     `familyRollup`) from a filer.db layer database, given a `family_id` or a `node_id`. Distinct from an entity
+ *     cluster (same filer, different identifiers) — a corporate family spans several DIFFERENT filers under a
+ *     holding/parent/subsidiary/management relationship. The handler passes `familyRollup`'s result through
+ *     unchanged: no reshaping, filtering, or summarizing of who-owns-whom data.
  */
 import { z } from "zod";
 const ParseInputSchema = z.object({
@@ -51,6 +68,103 @@ const LayerManifestInputSchema = z.object({
         .min(1)
         .describe("Path to a mailwoman spatial-layer database (poi.db, an address-points shard, etc.)."),
 });
+const BDCFilingLandscapeInputSchema = z.object({
+    database_path: z
+        .string()
+        .min(1)
+        .describe("Path to a bdc.db layer database (FCC Broadband Data Collection availability)."),
+    geoids: z
+        .array(z.string())
+        .min(1)
+        .optional()
+        .describe("15-character census block GEOIDs to query. Provide exactly one of `geoids` or `h3_cells` — never both, never neither, never empty."),
+    h3_cells: z
+        .array(z.number())
+        .min(1)
+        .optional()
+        .describe("Resolution-9 short H3 cell integers (the bdc.db availability spine) to query directly. Provide exactly " +
+        "one of `geoids` or `h3_cells` — never both, never neither, never empty."),
+});
+const PlausibilityCheckPointInputSchema = z.object({
+    type: z.literal("Point").describe('GeoJSON geometry type — always "Point".'),
+    coordinates: z
+        .tuple([z.number(), z.number()])
+        .describe("[longitude, latitude] pair, GeoJSON coordinate order (longitude first)."),
+});
+const PlausibilityCheckInputSchema = z.object({
+    bdc_database_path: z
+        .string()
+        .optional()
+        .describe("Path to a bdc.db layer database (FCC Broadband Data Collection availability). Omit — or point at a file " +
+        "that doesn't exist — to abstain on filing evidence rather than error."),
+    poi_database_path: z
+        .string()
+        .optional()
+        .describe("Path to a poi.db layer database carrying the telecom-infrastructure categories (`telecom_exchange`, " +
+        "`tower_comms`, etc.). Omit — or point at a file that doesn't exist — to abstain on physical-plant " +
+        "evidence rather than error."),
+    address: z
+        .string()
+        .optional()
+        .describe("The claimed service location as a free-text postal address, geocoded via the server's runtime pipeline " +
+        "when `point` isn't also given. At least one of `address`, `point`, or `geoid` is required."),
+    point: PlausibilityCheckPointInputSchema.optional().describe("The claimed service location as a GeoJSON Point, bypassing geocoding. At least one of `address`, `point`, " +
+        "or `geoid` is required."),
+    geoid: z
+        .string()
+        .optional()
+        .describe("15-character census block GEOID for the claimed service location — the exact, native filing-evidence " +
+        "path (no h3-cell approximation). May be supplied alongside `point`/`address` (geoid drives filing " +
+        "evidence; the point drives physical-plant evidence independently). At least one of `address`, " +
+        "`point`, or `geoid` is required."),
+    technology_code: z
+        .number()
+        .describe("FCC BDC technology code for the claimed service, e.g. 50 = optical carrier fiber (BroadbandTechnologyCode)."),
+    claimed_download_mbps: z.number().describe("The claimed downstream speed in Mbps."),
+});
+const FilerLookupInputSchema = z.object({
+    database_path: z.string().min(1).describe("Path to a filer.db layer database (FCC filer identity crosswalk)."),
+    frn: z
+        .string()
+        .optional()
+        .describe("The zero-padded 10-digit FCC Registration Number to look up, e.g. '0001753557'. Provide exactly one of " +
+        "`frn`, `form499_id`, or `bdc_provider_id` — never more than one, never none."),
+    form499_id: z
+        .string()
+        .optional()
+        .describe("The FCC Form 499 filer ID to look up. Provide exactly one of `frn`, `form499_id`, or `bdc_provider_id` — " +
+        "never more than one, never none."),
+    bdc_provider_id: z
+        .number()
+        .optional()
+        .describe("The FCC BDC provider_id to look up. Provide exactly one of `frn`, `form499_id`, or `bdc_provider_id` — " +
+        "never more than one, never none."),
+    as_of: z
+        .string()
+        .optional()
+        .describe("ISO date (YYYY-MM-DD) to scope the lookup as-of — only relationships valid on or before this date, and not " +
+        "yet closed by it, are included. Defaults to today; the result always states the date actually used."),
+});
+const FilerFamilyInputSchema = z.object({
+    database_path: z.string().min(1).describe("Path to a filer.db layer database (FCC filer identity crosswalk)."),
+    family_id: z
+        .string()
+        .optional()
+        .describe("The canonicalized family_id to roll up, e.g. as returned by mailwoman_filer_lookup's `families` field. " +
+        "Provide exactly one of `family_id` or `node_id` — never both, never neither."),
+    node_id: z
+        .string()
+        .optional()
+        .describe("A filer-graph node_id (e.g. 'frn:0001753557') to resolve EVERY corporate family it currently belongs to " +
+        "— a node may legitimately belong to more than one (e.g. a different holding company vs. management " +
+        "company). Provide exactly one of `family_id` or `node_id` — never both, never neither."),
+    as_of: z
+        .string()
+        .optional()
+        .describe("ISO date (YYYY-MM-DD) to scope the rollup as-of — only family memberships valid on or before this date, " +
+        "and not yet closed by it, are included. Defaults to today; each returned family states the date " +
+        "actually used."),
+});
 /**
  * Build the tool table for a concrete `MCPToolDeps` implementation. Pure — no transport, no I/O of its own.
  */
@@ -112,6 +226,80 @@ export function buildToolTable(deps) {
                 return deps.layerManifest(databasePath);
             },
         },
+        {
+            name: "mailwoman_bdc_filing_landscape",
+            description: "Read the FCC Broadband Data Collection (BDC) provider/technology/speed-bucket filing census over a set " +
+                "of census blocks (`geoids`) or H3 cells (`h3_cells`) from a bdc.db layer database. Returns the source " +
+                "vintage, how many queried blocks were surveyed vs. unknown (never surveyed), and the filing summary. " +
+                "Provide exactly one of `geoids` or `h3_cells`.",
+            inputSchema: BDCFilingLandscapeInputSchema,
+            handler: async (args) => {
+                const { database_path, geoids, h3_cells } = BDCFilingLandscapeInputSchema.parse(args);
+                return deps.bdcFilingLandscape({ databasePath: database_path, geoids, h3Cells: h3_cells });
+            },
+        },
+        {
+            name: "mailwoman_plausibility_check",
+            description: "Score one claimed broadband-service assertion (technology + speed at a location) against the FCC BDC " +
+                "filing census and nearby telecom infrastructure, returning an evidence bundle: filings that corroborate " +
+                "(or don't), nearby physical plant, and a coverage_confidence reflecting survey completeness. NEVER " +
+                "returns a verdict stronger than 'no supporting evidence found' — absence of evidence degrades " +
+                "confidence, it never disproves the claim. Provide at least one of `address`, `point`, or `geoid`.",
+            inputSchema: PlausibilityCheckInputSchema,
+            handler: async (args) => {
+                const { bdc_database_path, poi_database_path, address, point, geoid, technology_code, claimed_download_mbps } = PlausibilityCheckInputSchema.parse(args);
+                return deps.plausibilityCheck({
+                    bdcDatabasePath: bdc_database_path,
+                    poiDatabasePath: poi_database_path,
+                    address,
+                    point,
+                    geoid,
+                    technologyCode: technology_code,
+                    claimedDownloadMbps: claimed_download_mbps,
+                });
+            },
+        },
+        {
+            name: "mailwoman_filer_lookup",
+            description: "Look up the FCC filer identity crosswalk for one identifier (FRN, Form 499 filer ID, or BDC provider_id) " +
+                "from a filer.db layer database: every OTHER identifier it shares an authoritative edge with (never " +
+                "collapsed — a provider_id carrying multiple FRNs reports all of them), its current attributes, its " +
+                "authoritative entity cluster, and any inferred links reported SEPARATELY with their score — never merged " +
+                "into the cluster. Scoped `as_of` a date (defaults to today, always present in the result). Provide " +
+                "exactly one of `frn`, `form499_id`, or `bdc_provider_id`.",
+            inputSchema: FilerLookupInputSchema,
+            handler: async (args) => {
+                const { database_path, frn, form499_id, bdc_provider_id, as_of } = FilerLookupInputSchema.parse(args);
+                return deps.filerLookup({
+                    databasePath: database_path,
+                    frn,
+                    form499ID: form499_id,
+                    bdcProviderID: bdc_provider_id,
+                    asOf: as_of,
+                });
+            },
+        },
+        {
+            name: "mailwoman_filer_family",
+            description: "Read a corporate family's full membership from a filer.db layer database — a holding/parent/subsidiary/" +
+                "management tree spanning several DIFFERENT filers, distinct from an entity cluster (same filer, " +
+                "different identifiers). Given `family_id`, returns that one family's members; given `node_id`, " +
+                "resolves EVERY family that node currently belongs to (a node MAY belong to more than one). Each " +
+                "returned family reports its members with relationship, source, and assertion (`authoritative` — the " +
+                "source document states the membership — vs `inferred` — a name match concluded it, with its " +
+                "match_score), a deduped distinct_member_count, and its known display names. Provide exactly one of " +
+                "`family_id` or `node_id`.",
+            inputSchema: FilerFamilyInputSchema,
+            handler: async (args) => {
+                const { database_path, family_id, node_id, as_of } = FilerFamilyInputSchema.parse(args);
+                return deps.filerFamily({
+                    databasePath: database_path,
+                    familyID: family_id,
+                    nodeID: node_id,
+                    asOf: as_of,
+                });
+            },
+        },
     ];
 }
 //# sourceMappingURL=tools.js.map

package/out/tools.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mailwoman/mcp",
-  "version": "8.3.0",
+  "version": "8.5.0",
   "description": "MCP server — mailwoman's spatial toolset for agents (parse, geocode, poi_search, overpass_export, layer_manifest).",
   "license": "AGPL-3.0-only OR LicenseRef-Commercial",
   "repository": {
@@ -45,17 +45,19 @@
     }
   },
   "dependencies": {
-    "@mailwoman/core": "8.3.0",
-    "@mailwoman/neural": "8.3.0",
-    "@mailwoman/poi-taxonomy": "8.3.0",
-    "@mailwoman/resolver": "8.3.0",
-    "@mailwoman/resolver-wof-sqlite": "8.3.0",
+    "@mailwoman/bdc": "8.5.0",
+    "@mailwoman/core": "8.5.0",
+    "@mailwoman/filer": "8.5.0",
+    "@mailwoman/neural": "8.5.0",
+    "@mailwoman/poi-taxonomy": "8.5.0",
+    "@mailwoman/resolver": "8.5.0",
+    "@mailwoman/resolver-wof-sqlite": "8.5.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "mailwoman": "8.3.0",
+    "mailwoman": "8.5.0",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@mailwoman/resolver-wof-sqlite": "8.3.0"
+    "@mailwoman/resolver-wof-sqlite": "8.5.0"
   },
   "peerDependenciesMeta": {
     "@mailwoman/resolver-wof-sqlite": {

package/server.ts

@@ -24,9 +24,9 @@ const MCP_SERVER_VERSION = "7.1.0"
 /**
  * Build an `McpServer` with every `tools.ts` tool registered. A handler's returned value is JSON-stringified into a
  * single `text` content block — every tool here answers with structured data (parse trees, geocode results, search
- * hits), so a plain JSON text block is the simplest faithful rendering; none of the five tools need images, resource
- * links, or other MCP content kinds. A thrown error becomes an `isError` tool result instead of a protocol-level
- * failure, so a bad address / missing db surfaces to the agent as a normal (if unsuccessful) tool call.
+ * hits), so a plain JSON text block is the simplest faithful rendering; none of the tools need images, resource links,
+ * or other MCP content kinds. A thrown error becomes an `isError` tool result instead of a protocol-level failure, so a
+ * bad address / missing db surfaces to the agent as a normal (if unsuccessful) tool call.
  */
 export function createMCPServer(deps: MCPToolDeps): McpServer {
 	const server = new McpServer({ name: "mailwoman", version: MCP_SERVER_VERSION })