@mailwoman/mcp 9.4.0 → 10.1.0

package/out/tools.js

@@ -2,38 +2,6 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   The MCP tool table — pure, transport-free. `server.ts` adapts this to the `@modelcontextprotocol/sdk`'s
- *   registration API; `cli.ts` builds the real `MCPToolDeps` from the mailwoman library. Kept separate so this
- *   file (the actual product surface) is testable without any MCP plumbing — `tools.test.ts` calls
- *   `buildToolTable` directly with stub deps.
- *
- *   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`).
- *   - `mailwoman_poi_search` — POI-intent extraction + (when a poi.db is wired) execution.
- *   - `mailwoman_overpass_export` — OverpassQL EXPORT emitter (`mailwoman/poi-overpass`) — "we print the query;
- *     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 (decision 6).
- *   - `mailwoman_filer_lookup` — 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` — 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({
@@ -166,7 +134,8 @@ const FilerFamilyInputSchema = z.object({
         "actually used."),
 });
 /**
- * Build the tool table for a concrete `MCPToolDeps` implementation. Pure — no transport, no I/O of its own.
+ * Builds the MCP tool table over the given dependencies, without opening a transport
+ * or performing I/O itself.
  */
 export function buildToolTable(deps) {
     return [

package/out/tools.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mailwoman/mcp",
-  "version": "9.4.0",
-  "description": "MCP server — mailwoman's spatial toolset for agents (parse, geocode, poi_search, overpass_export, layer_manifest).",
+  "version": "10.1.0",
+  "description": "MCP server — mailwoman's toolset for agents: address parsing and geocoding, POI search and Overpass export, layer manifests, plausibility checks, and FCC broadband and filer lookups.",
   "license": "AGPL-3.0-only OR LicenseRef-Commercial",
   "repository": {
     "type": "git",
@@ -9,7 +9,7 @@
     "directory": "packages/mcp"
   },
   "bin": {
-    "mailwoman-mcp": "./out/cli.js"
+    "mailwoman-mcp": "./out/cli/main.js"
   },
   "files": [
     "out/**/*.js",
@@ -17,18 +17,19 @@
     "out/**/*.d.ts",
     "out/**/*.d.ts.map",
     "README.md",
-    "*.ts",
-    "*.tsx",
-    "**/*.ts",
-    "**/*.tsx",
-    "!*.test.ts",
-    "!*.test.tsx",
+    "lib/**/*.ts",
+    "lib/**/*.tsx",
+    "cli/**/*.ts",
     "!**/*.test.ts",
-    "!**/*.test.tsx",
-    "!test/**"
+    "!**/*.test.tsx"
   ],
   "type": "module",
   "imports": {
+    "#cli/*": {
+      "types": "./out/cli/*.d.ts",
+      "node": "./out/cli/*.js",
+      "default": "./out/cli/*.js"
+    },
     "#*": {
       "types": "./out/*.d.ts",
       "node": "./out/*.js",
@@ -42,15 +43,15 @@
       "node": "./out/index.js",
       "default": "./out/index.js"
     },
-    "./layer-guards": {
-      "types": "./out/layer-guards.d.ts",
-      "node": "./out/layer-guards.js",
-      "default": "./out/layer-guards.js"
+    "./cli/*": {
+      "types": "./out/cli/*.d.ts",
+      "node": "./out/cli/*.js",
+      "default": "./out/cli/*.js"
     },
-    "./tools": {
-      "types": "./out/tools.d.ts",
-      "node": "./out/tools.js",
-      "default": "./out/tools.js"
+    "./*": {
+      "types": "./out/*.d.ts",
+      "node": "./out/*.js",
+      "default": "./out/*.js"
     }
   },
   "publishConfig": {
@@ -62,18 +63,23 @@
         "node": "./out/index.js",
         "default": "./out/index.js"
       },
-      "./layer-guards": {
-        "types": "./out/layer-guards.d.ts",
-        "node": "./out/layer-guards.js",
-        "default": "./out/layer-guards.js"
+      "./cli/*": {
+        "types": "./out/cli/*.d.ts",
+        "node": "./out/cli/*.js",
+        "default": "./out/cli/*.js"
       },
-      "./tools": {
-        "types": "./out/tools.d.ts",
-        "node": "./out/tools.js",
-        "default": "./out/tools.js"
+      "./*": {
+        "types": "./out/*.d.ts",
+        "node": "./out/*.js",
+        "default": "./out/*.js"
       }
     },
     "imports": {
+      "#cli/*": {
+        "types": "./out/cli/*.d.ts",
+        "node": "./out/cli/*.js",
+        "default": "./out/cli/*.js"
+      },
       "#*": {
         "types": "./out/*.d.ts",
         "node": "./out/*.js",
@@ -82,25 +88,18 @@
     }
   },
   "dependencies": {
-    "@mailwoman/bdc": "9.4.0",
-    "@mailwoman/core": "9.4.0",
-    "@mailwoman/filer": "9.4.0",
-    "@mailwoman/neural": "9.4.0",
-    "@mailwoman/neural-weights-en-us": "9.4.0",
-    "@mailwoman/poi-taxonomy": "9.4.0",
-    "@mailwoman/resolver": "9.4.0",
-    "@mailwoman/resolver-wof-sqlite": "9.4.0",
-    "@mailwoman/sqlite": "9.4.0",
+    "@mailwoman/bdc": "10.1.0",
+    "@mailwoman/core": "10.1.0",
+    "@mailwoman/filer": "10.1.0",
+    "@mailwoman/neural": "10.1.0",
+    "@mailwoman/neural-weights-en-us": "10.1.0",
+    "@mailwoman/poi-taxonomy": "10.1.0",
+    "@mailwoman/resolver": "10.1.0",
+    "@mailwoman/resolver-wof-sqlite": "10.1.0",
+    "@mailwoman/sqlite": "10.1.0",
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "mailwoman": "9.4.0",
+    "mailwoman": "10.1.0",
+    "path-ts": "^2.5.0",
     "zod": "^4.5.4"
-  },
-  "peerDependencies": {
-    "@mailwoman/resolver-wof-sqlite": "9.4.0"
-  },
-  "peerDependenciesMeta": {
-    "@mailwoman/resolver-wof-sqlite": {
-      "optional": true
-    }
   }
 }

package/lib/cli.ts

@@ -1,373 +0,0 @@
-#!/usr/bin/env node
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   `mailwoman-mcp` — boot the MCP server over stdio. Wires the real `MCPToolDeps` (`tools.ts`) from the mailwoman
- *   library: `createRuntimePipeline` for parse/POI-intent, `geocode-core`'s `geocodeAddress` for geocode,
- *   `mailwoman/poi-overpass`'s `emitOverpassQL` for the export tool, `@mailwoman/core/layers` for the layer
- *   manifest tool, and `@mailwoman/bdc`'s `filingLandscape`/`plausibilityCheck` for the two BDC tools.
- *
- *   Deps are LAZY: nothing here loads the neural weights or opens a gazetteer db at startup — an MCP client
- *   connects, lists tools, and may never call one (or may call only the layer-database tools, none of which touch the
- *   classifier). The shared classifier+resolver are built once, on the FIRST call to any tool that needs them, and
- *   cached for the process lifetime. `mailwoman_overpass_export` DOES need them despite never executing a query — it
- *   parses the input to find the subject and anchor before it can emit OverpassQL.
- *
- *   **Laziness moves the first failure into a tool call, so `loadCore` owns the friendly-failure messages** that
- *   `photon`/`nominatim`/`mailwoman serve` print at boot. Both are thrown, not printed: `server.ts` catches a handler
- *   throw and returns it as an `isError` tool result, so a thrown message reaches the agent where a `console.error` +
- *   `process.exit(1)` would just kill the transport mid-conversation. See `loadCore` for the two.
- *
- *   **Graceful layer-absent guards (decision 6).** Both BDC-backed tools treat a missing/unreadable
- *   database file as absence, never a raw `node:sqlite` throw ("unable to open database file"): `bdcFilingLandscape`
- *   requires bdc.db unconditionally, so a missing file becomes one friendly thrown `Error` naming the layer;
- *   `plausibilityCheck`'s `bdcDB`/`poi` deps are each OPTIONAL, so a missing/absent `bdc_database_path`/
- *   `poi_database_path` degrades to the SAME typed-abstain evidence entry (`{type:"abstain",
- *   reason:"requires_bdc_layer"|"requires_build_local_layer"}`) the scorer already produces for an omitted dep. The
- *   guards themselves (`assertBDCDatabaseExists`, `openBDCDatabaseIfPresent`, `openPlausibilityPOIDeps`) live in
- *   `./layer-guards.ts`, NOT here — they're pure, transport-independent logic with no need for the stdio connection
- *   this file opens at import time (which is exactly why THIS file can't be unit-tested directly; see
- *   `layer-guards.test.ts` for their branch coverage).
- *
- *   `mailwoman_filer_lookup` follows the SAME "requires the layer unconditionally" discipline as
- *   `mailwoman_bdc_filing_landscape` (`assertFilerDatabaseExists` + `openFilerDatabaseIfPresent`, mirroring
- *   `assertBDCDatabaseExists` + the BDC open) — `filerLookup` itself has no optional-dep abstain shape (criterion 4 makes
- *   it throw rather than answer unstamped), so a missing filer.db becomes one friendly thrown Error naming the layer.
- *
- *   `mailwoman_filer_family` follows the IDENTICAL discipline, reusing the same two guards — `familyRollup`
- *   has no optional-dep abstain shape either (it throws on a bad `familyID`/`nodeID` XOR or a pre-`filer_family`
- *   schema), so filer.db is required unconditionally here too. Its result — always `FamilyRollup[]`, never `null` or
- *   a bare object — is passed through untouched: this data is who-owns-whom, and a silent reshape here would be a
- *   fabricated relationship claim.
- *
- *   ```sh
- *   mailwoman-mcp                       # geocode/poi_search degrade gracefully with no poi.db wired
- *   mailwoman-mcp --poi-db poi.db       # mailwoman_poi_search additionally executes against poi.db
- *   ```
- */
-
-import { filingLandscape, plausibilityCheck, type BDCDatabase } from "@mailwoman/bdc"
-import type { PipelineResult } from "@mailwoman/core"
-import { pathExists } from "@mailwoman/core/fs/readers"
-import { readLayerManifest, type LayerContractDatabase } from "@mailwoman/core/layers"
-import type { Resolver } from "@mailwoman/core/resolver"
-import { parseArguments } from "@mailwoman/core/scripting/arguments"
-import { mailwomanDataRoot, wofExtractPaths } from "@mailwoman/core/utils"
-import { familyRollup } from "@mailwoman/filer/family-rollup"
-import { filerLookup } from "@mailwoman/filer/filer-lookup"
-import { toFRN, type FRN } from "@mailwoman/filer/frn"
-import { NeuralAddressClassifier, type ScriptRoutedClassifier } from "@mailwoman/neural"
-import { getPOICategory } from "@mailwoman/poi-taxonomy"
-import { emitOverpassQL } from "@mailwoman/poi-taxonomy/overpass"
-import { createWOFResolver } from "@mailwoman/resolver"
-import { DatabaseClient } from "@mailwoman/sqlite/client"
-import { createRuntimePipeline } from "mailwoman"
-import { geocodeAddress, RegionDatabaseProvider } from "mailwoman/geocode"
-import { buildNoGazetteerMessage, createResolverBackend, resolveCandidateDBPath } from "mailwoman/resolver-backend"
-
-import {
-	assertBDCDatabaseExists,
-	assertFilerDatabaseExists,
-	openBDCDatabaseIfPresent,
-	openFilerDatabaseIfPresent,
-	openPlausibilityPOIDeps,
-} from "#layer-guards"
-import { createMCPServer } from "#server"
-import type { MCPToolDeps } from "#tools"
-
-const { values } = parseArguments({
-	options: {
-		"poi-db": { type: "string" },
-	},
-	allowPositionals: true,
-})
-
-/**
- * `--poi-db` wires `mailwoman_poi_search` (and, via the same pipeline, `mailwoman_parse`'s `poi: true` path) to a real
- * `poi.db`. Absent → intent-only (parses the query, extracts the subject/anchor, never executes a lookup).
- */
-const poiDatabasePath = values["poi-db"]
-
-/**
- * The shared classifier + resolver, built exactly once on the first call that needs them (see the module header).
- * `NeuralAddressClassifier.loadFromWeights` auto-resolves the bundled `en-US` weights; the resolver backend prefers a
- * configured candidate gazetteer (`$MAILWOMAN_CANDIDATE_DB`) and otherwise falls back to the admin-only WOF extracts
- * already on the data root — same selection `nominatim`/`photon`'s CLIs make.
- */
-let corePromise:
-	| Promise<{
-			classifier: ScriptRoutedClassifier<NeuralAddressClassifier>
-			resolver: Resolver
-			databases: RegionDatabaseProvider
-	  }>
-	| undefined
-
-/**
- * The four tools that need {@link loadCore} — every path through `getPlainPipeline`/`getPoiPipeline`/`resolveGeocode`.
- * `mailwoman_layer_manifest`, `mailwoman_bdc_filing_landscape`, `mailwoman_filer_lookup` and `mailwoman_filer_family`
- * never call it, so they keep working when this fails; `mailwoman_plausibility_check` only reaches it when it geocodes.
- * Named in both guard messages below because an agent that just got one needs to know what it can still do.
- */
-const CORE_BACKED_TOOLS = "mailwoman_parse, mailwoman_geocode, mailwoman_poi_search, mailwoman_overpass_export"
-
-const CORE_FREE_TOOLS =
-	"mailwoman_layer_manifest, mailwoman_bdc_filing_landscape, mailwoman_filer_lookup, mailwoman_filer_family"
-
-function loadCore(): Promise<{
-	classifier: ScriptRoutedClassifier
-	resolver: Resolver
-	databases: RegionDatabaseProvider
-}> {
-	corePromise ??= (async () => {
-		const resolverMod = await import("@mailwoman/resolver-wof-sqlite")
-		const wofPaths: string[] = []
-
-		for (const extractPath of wofExtractPaths()) {
-			if (await pathExists(extractPath)) {
-				wofPaths.push(extractPath)
-			}
-		}
-
-		const candidateDB = await resolveCandidateDBPath()
-
-		// #1009 friendly-failure discipline, the MCP shape of it. `server.ts` turns a thrown Error into an
-		// `isError` tool result carrying `error.message`, so the message an agent reads IS whatever is thrown
-		// here — which made the raw internal `resolveExtracts: at least one extract is required` the first thing a
-		// stranger saw from `mailwoman_parse` on a fresh install (measured 2026-08-03 against a standalone
-		// `npm install @mailwoman/mcp`). Same preflight as `photon`/`nominatim`/`mailwoman serve`, and the same
-		// discovery: #1444 moved the `<data-root>/wof/candidate.db` convention fallback INTO
-		// `resolveCandidateDBPath`, so this bare call picks a pulled gazetteer up with nothing exported. The
-		// `MAILWOMAN_DATA_ROOT` in the client's `env` block is enough on its own.
-		if (!candidateDB && !wofPaths.length) {
-			throw new Error(
-				`${buildNoGazetteerMessage({
-					dataRoot: mailwomanDataRoot(),
-					docsPath: "/docs/developers/how-to/use-the-mcp-server",
-				})}\n\n  Needs it: ${CORE_BACKED_TOOLS}\n  Works without it: ${CORE_FREE_TOOLS}`
-			)
-		}
-
-		const backend = await createResolverBackend(resolverMod, { wofPaths, candidateDB })
-		const resolver = createWOFResolver(backend)
-
-		// Same discipline for the model weights. `@mailwoman/neural-weights-en-us` is a declared dependency of
-		// this package as of 2026-08-03 — before that a standalone `npm install @mailwoman/mcp` resolved
-		// nothing and every core-backed tool answered with `resolveWeights`' raw not-found text. The guard keeps
-		// that text (it already names the exact fix command) and adds what an agent mid-conversation needs next:
-		// which tools are down and which are not.
-		let classifier: ScriptRoutedClassifier<NeuralAddressClassifier>
-
-		try {
-			classifier = await NeuralAddressClassifier.loadRoutedFromWeights({ locale: "en-US" })
-		} catch (error) {
-			throw new Error(
-				`✗ ${error instanceof Error ? error.message : String(error)}\n\n` +
-					`  Needs it: ${CORE_BACKED_TOOLS}\n  Works without it: ${CORE_FREE_TOOLS}`
-			)
-		}
-
-		const databases = await RegionDatabaseProvider.create(resolverMod, mailwomanDataRoot())
-
-		return { classifier, resolver, databases }
-	})()
-
-	return corePromise
-}
-
-type Pipeline = (raw: string) => Promise<PipelineResult>
-
-let plainPipeline: Pipeline | undefined
-/**
- * Keyed by the poi.db path used to build it (`""` = intent-only, no db) — `mailwoman_poi_search` can be called with a
- * `poiDatabasePath` that differs from the server's `--poi-db`, in which case a fresh one-off pipeline is built and
- * cached under that path instead of reusing the default.
- */
-const poiPipelines = new Map<string, Pipeline>()
-
-async function getPlainPipeline(): Promise<Pipeline> {
-	if (!plainPipeline) {
-		const { classifier, resolver } = await loadCore()
-
-		plainPipeline = createRuntimePipeline({ classifier, resolver })
-	}
-
-	return plainPipeline
-}
-
-async function getPoiPipeline(dbPath: string | undefined): Promise<Pipeline> {
-	const key = dbPath ?? ""
-	const cached = poiPipelines.get(key)
-
-	if (cached) return cached
-	const { classifier, resolver } = await loadCore()
-
-	const pipeline = createRuntimePipeline({
-		classifier,
-		resolver,
-		poiQueryKind: dbPath ? { poiDatabasePath: dbPath } : true,
-	})
-
-	poiPipelines.set(key, pipeline)
-
-	return pipeline
-}
-
-/**
- * `plausibilityCheck`'s geocode dep — reuses the SAME shared classifier+resolver `deps.geocode` builds from (see the
- * module header's laziness note). `deriveGeocodeRegister`/the formatted register is the geocode dep's concern, so it is
- * wired at this CLI/MCP layer rather than inside `plausibility.ts`. The real return type (`GeocodeResult`) is
- * structurally assignable to `plausibility.ts`'s minimal `GeocodeLike` — no adapter needed.
- */
-async function resolveGeocode(address: string) {
-	const { classifier, resolver, databases } = await loadCore()
-
-	return geocodeAddress(address, { classifier, resolver, databases: databases.for })
-}
-
-const deps: MCPToolDeps = {
-	async parse(text, opts) {
-		const pipeline = opts?.poi ? await getPoiPipeline(poiDatabasePath) : await getPlainPipeline()
-
-		return pipeline(text)
-	},
-
-	async geocode(text) {
-		return resolveGeocode(text)
-	},
-
-	async poiSearch(q) {
-		const pipeline = await getPoiPipeline(q.poiDatabasePath ?? poiDatabasePath)
-		const result = await pipeline(q.query)
-
-		return result.poiIntent ?? { type: "abstain", reason: "not_poi_shaped" }
-	},
-
-	async overpassExport(query) {
-		// Intent-only is enough here — the export just needs the parsed subject/anchor, never executed results
-		// ("we print the query; we never run it", poi-overpass.ts). Reuses the server's wired poi pipeline (a
-		// real poi.db doesn't change the emitted OverpassQL) instead of forcing a second one-off pipeline.
-		const pipeline = await getPoiPipeline(poiDatabasePath)
-		const result = await pipeline(query)
-		const outcome = result.poiIntent
-
-		if (!outcome || outcome.type !== "intent") {
-			const reason = outcome?.type === "abstain" ? `: ${outcome.reason}` : ""
-
-			throw new Error(
-				`mailwoman_overpass_export: query is not POI-shaped (${outcome?.type ?? "no poi intent"}${reason})`
-			)
-		}
-
-		const { subject } = outcome.intent
-
-		// One tag per category the subject reaches, and only when EVERY member carries one: a union emitted from the
-		// subset that happens to have an `osmTag` is a narrower query than the POI branch ran.
-		const osmTags =
-			subject.kind === "category"
-				? subject.categoryIDs.map((id) => getPOICategory(id)?.osmTag).filter((tag) => tag !== undefined)
-				: []
-
-		return emitOverpassQL(
-			outcome.intent,
-			subject.kind === "category" && osmTags.length === subject.categoryIDs.length ? { osmTags } : {}
-		)
-	},
-
-	async layerManifest(databasePath) {
-		using db = new DatabaseClient<LayerContractDatabase>(databasePath, { readOnly: true })
-
-		const manifest = await readLayerManifest(db)
-
-		const coverage = await db
-			.selectFrom("layer_coverage")
-			.select((eb) => [
-				eb.fn.count<number>("h3_cell").as("surveyedCellCount"),
-				eb.fn.avg<number>("completeness").as("averageCompleteness"),
-				eb.fn.sum<number>("observed_rows").as("totalObservedRows"),
-			])
-			.executeTakeFirst()
-
-		return { manifest, coverage }
-	},
-
-	async bdcFilingLandscape(q) {
-		// Decision 6: `mailwoman_bdc_filing_landscape` requires bdc.db unconditionally (no optional-dep
-		// abstain shape exists for this tool), so a missing file becomes a friendly thrown Error naming the layer —
-		// never the raw `node:sqlite` "unable to open database file" message.
-		await assertBDCDatabaseExists("mailwoman_bdc_filing_landscape", q.databasePath)
-
-		using db = new DatabaseClient<BDCDatabase>(q.databasePath, { readOnly: true })
-
-		return filingLandscape(db, { geoids: q.geoids, h3Cells: q.h3Cells })
-	},
-
-	async plausibilityCheck(q) {
-		const bdcDB = await openBDCDatabaseIfPresent(q.bdcDatabasePath)
-		const poi = await openPlausibilityPOIDeps(q.poiDatabasePath)
-
-		try {
-			return await plausibilityCheck(
-				{
-					address: q.address,
-					point: q.point,
-					geoid: q.geoid,
-					technologyCode: q.technologyCode,
-					claimedDownloadMbps: q.claimedDownloadMbps,
-				},
-				{ bdcDB, poi, geocode: resolveGeocode }
-			)
-		} finally {
-			bdcDB?.destroy()
-			poi?.contractDB.destroy()
-		}
-	},
-
-	async filerLookup(q) {
-		// Decision 6 / criterion 4: filerLookup has no optional-dep abstain shape — it throws rather than
-		// answer unstamped — so filer.db is required unconditionally, same discipline as bdc.db is for
-		// mailwoman_bdc_filing_landscape.
-		await assertFilerDatabaseExists("mailwoman_filer_lookup", q.databasePath)
-
-		using db = (await openFilerDatabaseIfPresent(q.databasePath))!
-
-		let frn: FRN | undefined
-
-		if (q.frn !== undefined) {
-			const parsed = toFRN(q.frn)
-
-			if (!parsed) {
-				throw new Error(`mailwoman_filer_lookup: "${q.frn}" is not a valid FRN`)
-			}
-
-			frn = parsed
-		}
-
-		return await filerLookup(db, {
-			frn,
-			form499ID: q.form499ID,
-			bdcProviderID: q.bdcProviderID,
-			asOf: q.asOf,
-		})
-	},
-
-	async filerFamily(q) {
-		// Same discipline as mailwoman_filer_lookup — familyRollup has no optional-dep abstain shape
-		// either, so filer.db is required unconditionally.
-		await assertFilerDatabaseExists("mailwoman_filer_family", q.databasePath)
-
-		using db = (await openFilerDatabaseIfPresent(q.databasePath))!
-
-		return familyRollup(db, {
-			familyID: q.familyID,
-			nodeID: q.nodeID,
-			asOf: q.asOf,
-		})
-	},
-}
-
-const server = createMCPServer(deps)
-const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js")
-
-await server.connect(new StdioServerTransport())

package/out/cli.d.ts

@@ -1,51 +0,0 @@
-#!/usr/bin/env node
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   `mailwoman-mcp` — boot the MCP server over stdio. Wires the real `MCPToolDeps` (`tools.ts`) from the mailwoman
- *   library: `createRuntimePipeline` for parse/POI-intent, `geocode-core`'s `geocodeAddress` for geocode,
- *   `mailwoman/poi-overpass`'s `emitOverpassQL` for the export tool, `@mailwoman/core/layers` for the layer
- *   manifest tool, and `@mailwoman/bdc`'s `filingLandscape`/`plausibilityCheck` for the two BDC tools.
- *
- *   Deps are LAZY: nothing here loads the neural weights or opens a gazetteer db at startup — an MCP client
- *   connects, lists tools, and may never call one (or may call only the layer-database tools, none of which touch the
- *   classifier). The shared classifier+resolver are built once, on the FIRST call to any tool that needs them, and
- *   cached for the process lifetime. `mailwoman_overpass_export` DOES need them despite never executing a query — it
- *   parses the input to find the subject and anchor before it can emit OverpassQL.
- *
- *   **Laziness moves the first failure into a tool call, so `loadCore` owns the friendly-failure messages** that
- *   `photon`/`nominatim`/`mailwoman serve` print at boot. Both are thrown, not printed: `server.ts` catches a handler
- *   throw and returns it as an `isError` tool result, so a thrown message reaches the agent where a `console.error` +
- *   `process.exit(1)` would just kill the transport mid-conversation. See `loadCore` for the two.
- *
- *   **Graceful layer-absent guards (decision 6).** Both BDC-backed tools treat a missing/unreadable
- *   database file as absence, never a raw `node:sqlite` throw ("unable to open database file"): `bdcFilingLandscape`
- *   requires bdc.db unconditionally, so a missing file becomes one friendly thrown `Error` naming the layer;
- *   `plausibilityCheck`'s `bdcDB`/`poi` deps are each OPTIONAL, so a missing/absent `bdc_database_path`/
- *   `poi_database_path` degrades to the SAME typed-abstain evidence entry (`{type:"abstain",
- *   reason:"requires_bdc_layer"|"requires_build_local_layer"}`) the scorer already produces for an omitted dep. The
- *   guards themselves (`assertBDCDatabaseExists`, `openBDCDatabaseIfPresent`, `openPlausibilityPOIDeps`) live in
- *   `./layer-guards.ts`, NOT here — they're pure, transport-independent logic with no need for the stdio connection
- *   this file opens at import time (which is exactly why THIS file can't be unit-tested directly; see
- *   `layer-guards.test.ts` for their branch coverage).
- *
- *   `mailwoman_filer_lookup` follows the SAME "requires the layer unconditionally" discipline as
- *   `mailwoman_bdc_filing_landscape` (`assertFilerDatabaseExists` + `openFilerDatabaseIfPresent`, mirroring
- *   `assertBDCDatabaseExists` + the BDC open) — `filerLookup` itself has no optional-dep abstain shape (criterion 4 makes
- *   it throw rather than answer unstamped), so a missing filer.db becomes one friendly thrown Error naming the layer.
- *
- *   `mailwoman_filer_family` follows the IDENTICAL discipline, reusing the same two guards — `familyRollup`
- *   has no optional-dep abstain shape either (it throws on a bad `familyID`/`nodeID` XOR or a pre-`filer_family`
- *   schema), so filer.db is required unconditionally here too. Its result — always `FamilyRollup[]`, never `null` or
- *   a bare object — is passed through untouched: this data is who-owns-whom, and a silent reshape here would be a
- *   fabricated relationship claim.
- *
- *   ```sh
- *   mailwoman-mcp                       # geocode/poi_search degrade gracefully with no poi.db wired
- *   mailwoman-mcp --poi-db poi.db       # mailwoman_poi_search additionally executes against poi.db
- *   ```
- */
-export {};
-//# sourceMappingURL=cli.d.ts.map

package/out/cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../lib/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG"}