@empressaio/atom-contract 1.31.0 → 1.33.0

package/CHANGELOG.md

@@ -2,6 +2,81 @@
 
 All notable changes to `@empressaio/atom-contract` (formerly `@hauska/atom-contract`) are documented here.
 
+## [1.33.0] - 2026-09-12
+
+Additive minor — P-167 step 2 (OPS-23 R-6). Folds P-153's one new token
+(Ruling B reversed for the polygon only) into `./display`, now that P-153
+DRAW has merged in both hauska-map (#384 `1aef5dd5`, #386 `8b44f68d`) and
+legacy-design-tools (#661 `6b579020`). Verified before folding: diffing
+hauska-map's current `buildable-display-vocab.ts` (origin/main) against
+this package's pre-fold `buildable.ts` produced exactly the token addition
+below and nothing else (the falsifier pre-registered for this step).
+Consumers should import `^1.33.0`, never `1.32.0`, once they cut in.
+
+### Added
+
+- `buildable`: `BuildableDisplayKind` gains `"modelled-figure-withheld"` —
+  a real modelled polygon on file (district + setback table resolved) while
+  the atom-chain read is still pending; `mapBuildableDisplay` draws the
+  polygon and withholds only the area figure. Moved verbatim from
+  hauska-map PR #384.
+- `wire`: `envelopeBasisHuman`, the P-153 sibling of `envelopeHuman` for a
+  `state: "present"` overlay's `basis` field, moved verbatim from
+  mcp-app.ts:462-467 (legacy-design-tools PR #661). `VOCABULARY` gains the
+  `modelled-figure-withheld` entry (`DOCUMENTED_VOCABULARY_COUNT` 34 → 35);
+  its `displayText` reads through `envelopeBasisHuman` exactly as the other
+  envelope entry reads through `envelopeHuman`, so the panel card label, the
+  MCP `basis` display text, and this table's row cannot drift apart.
+
+## [1.32.0] - 2026-09-11
+
+Additive minor — display vocabulary substrate (OPS-23 R-6 / P-167, wave 1
+package half). Before this release, the human-facing display strings for a
+buildable/setback claim existed as five byte-identical, hand-synced copies
+(hauska-map, twice in hauska-engine) locked together by two parity-lock
+files and a vendor-drift test that silently skips in CI without a local
+map checkout, and the Smart Site MCP wire-token vocabulary existed only in
+legacy-design-tools with no package dependency at all. This release does
+not yet retire any of those copies — that is P-167 steps 3-4, gated on
+P-153 DRAW merging in hauska-map and legacy-design-tools — it only stands
+up the one place both are meant to move to.
+
+### Added
+
+- **`./display`** subpath. Two modules, both moved verbatim from their
+  source-of-truth copies (see the finding record,
+  `_inbox/2026-09-11_ops23_wave1_verify_p167.md`, for the exact SHAs and
+  line numbers this was moved from):
+  - `buildable`: `BuildableDisplayKind`, `EnvelopeStatusInput`,
+    `WarmEnvelopeKind`, `BuildableDisplayInput`, `BuildableDisplayVocab`,
+    `resolveBuildableAreaSqFt`, `mapBuildableDisplay`,
+    `violatesHistoricalDisagreementGuard` — moved from hauska-map
+    `apps/property-explorer/src/lib/buildable-display-vocab.ts` (origin/main
+    6ab6914, sha256 `45c277d7...29cac`, byte-identical across all five
+    prior copies). No string or branch changed.
+  - `wire`: `VocabularyEntry`, `WIRE_DISPOSITION_DISPLAY_TEXT`,
+    `DERIVED_FIGURES_POLICY`, `VOCABULARY` (34 entries — the source
+    table's own comment said 19; corrected here and enforced by a counting
+    test, `DOCUMENTED_VOCABULARY_COUNT`) — moved from legacy-design-tools
+    `artifacts/smartsite-mcp/src/vocabulary.ts` (origin/main 55c4ad44), the
+    P-91 v3 table. The nine display constants that table used to import as
+    values from the MCP server's own `mcp-app.ts` (`STATE_WORDS`,
+    `OPEN_DID_NOT_REACH_ME`, `NOT_ON_FILE_PREFIX`,
+    `NO_BAKED_SNAPSHOT_PREFIX`, `UPGRADE_TO_OPEN`,
+    `NOT_IMPLEMENTED_PREFIX`, `CITATION_DEGRADED`, `EDGE_WORDS`,
+    `envelopeHuman`) moved in with it, so this module has no dependency on
+    the MCP server. Not moved: `VOCABULARY_RESOURCE_URI`,
+    `buildVocabularyResourceText`, `registerVocabularyResource`,
+    `STANDING_VOCAB_BLOCK_TEXT`, `STANDING_VOCAB_CONTENT_PART` — these stay
+    MCP-specific per the mission; legacy-design-tools' `vocabulary.ts`
+    becomes a thin re-export of this subpath plus that resource
+    registration in a later step of this row.
+- Self-tests: every `VOCABULARY` token unique, the documented count matches
+  the real count, every entry has non-empty fields, a snapshot of the full
+  string table; an exhaustiveness self-test that every `BuildableDisplayKind`
+  produces a non-empty `pdfLabel`, plus a snapshot of the canonical
+  per-kind output table.
+
 ## [1.31.0] - 2026-09-07
 
 Additive minor — property boundary edge atom (27f S2-U2 / WDLL 4-5).

package/README.md

@@ -338,6 +338,39 @@ Engine `AtomRegistration` literals and ingest producers belong in
 `hauska-engine/packages/atoms/` (cc-agent-E); Cortex Phase 1 may
 validate uploads with these schemas before the engine registry lands.
 
+## Display vocabulary (OPS-23 R-6 / P-167)
+
+The human-facing display strings for a claim ship on the `./display`
+subpath (v1.32.0+), so the Property Explorer panel, the feasibility PDF,
+and the Smart Site MCP connector render the same words for the same atom
+from one place instead of hand-synced copies. Two modules:
+
+- `buildable`: `mapBuildableDisplay` and its types — the buildable/setback
+  card, PDF, and cross-surface agreement-token vocabulary. Moved verbatim
+  from the five byte-identical `buildable-display-vocab.ts` copies that
+  used to live in hauska-map and hauska-engine, locked together by parity
+  fixtures.
+- `wire`: `VOCABULARY`, `WIRE_DISPOSITION_DISPLAY_TEXT`,
+  `DERIVED_FIGURES_POLICY` — the Smart Site MCP wire-token vocabulary
+  table. Moved verbatim from legacy-design-tools
+  `artifacts/smartsite-mcp/src/vocabulary.ts` (the P-91 v3 table), along
+  with the nine display constants it used to import from the MCP server's
+  own `mcp-app.ts`, so this module has no dependency on the MCP server.
+
+```ts
+import {
+  mapBuildableDisplay,
+  type BuildableDisplayInput,
+  VOCABULARY,
+  WIRE_DISPOSITION_DISPLAY_TEXT,
+} from "@empressaio/atom-contract/display";
+```
+
+As of 1.32.0 no consumer imports this subpath yet and the prior copies
+still exist; retiring them (deleting the copies, the parity locks, and the
+skipping vendor-drift test) is a later step of the same plan row, gated on
+`P-153` merging in hauska-map and legacy-design-tools.
+
 ## Read-contract types (Calibrated Spine F4 / F6 / K6)
 
 Widthed, three-axis confidence returned at read time. Unwidthed,

package/dist/display/buildable.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Shared customer-facing buildable / setback vocabulary (Track B3 / WDLL 5).
+ *
+ * Map card, inspect, and site-plan PDF must speak ONE truth for the same
+ * envelope inputs. Surfaces MUST call `mapBuildableDisplay` rather than
+ * re-deriving "pending" / "consumes lot" / provisional copy independently.
+ *
+ * Axes (cannot disagree across surfaces for identical inputs):
+ *   pending | provisional | buildable-with-area | declined-consume | not_specified
+ *   (+ absent / loading for non-envelope shells)
+ *
+ * Historical disagreement class (FIX1 symptom): envelope area present on the
+ * warm facet while PDF said "setback-consumes-lot" and the card said bare
+ * "buildable % pending". Guard: area present → never those two strings.
+ *
+ * P-167 (OPS-23 R-6): moved verbatim into `@empressaio/atom-contract/display`
+ * from the five byte-identical copies this module used to have (hauska-map
+ * `apps/property-explorer/src/lib/buildable-display-vocab.ts`, hauska-engine
+ * `packages/engine-core/src/site-plan/buildable-display-vocab.ts` and
+ * `packages/retrieval/src/serving-sweep/vendor/buildable-display-vocab.ts`,
+ * sha256 `45c277d7...29cac`). No export, string, or branch below changed in
+ * the move.
+ */
+export type BuildableDisplayKind = "absent" | "loading" | "pending" | "provisional" | "buildable-with-area" | "declined-consume" | "not_specified"
+/** Unincorporated land — no zoning ordinance to derive a setback from. */
+ | "not-applicable"
+/**
+ * R-2 (2026-09-11, Ruling B reversed for the polygon only). A real modelled
+ * polygon is on file (a district and a setback table exist) even though the
+ * atom-chain read is still pending — the drawing shows it; the figure stays
+ * withheld until a buildable-envelope atom backs it.
+ */
+ | "modelled-figure-withheld";
+export type EnvelopeStatusInput = "ok" | "no-buildable-area" | "declined" | null | undefined;
+export type WarmEnvelopeKind = "buildable" | "no-buildable-area" | "provisional-front-edge" | "not-applicable" | null | undefined;
+export interface BuildableDisplayInput {
+    /** Baked / atom-chain envelope.status */
+    envelopeStatus?: EnvelopeStatusInput;
+    declineReason?: string | null;
+    /** True when F/S/R includes a silent (build-to-line) axis. */
+    notSpecifiedAxes?: boolean;
+    buildableAreaPct?: number | null;
+    buildableAreaSqFt?: number | null;
+    /** GeoJSON / drawable envelope present on the warm facet. */
+    hasGeometry?: boolean;
+    /** Envelope flagged provisional (or warm provisional-front-edge). */
+    provisional?: boolean;
+    /**
+     * Warm buildable-envelope atom outcome — preferred over per-surface
+     * re-derive when present (PDF offset vs depth-warm).
+     */
+    warmEnvelopeKind?: WarmEnvelopeKind;
+    warmEnvelopeAreaSqFt?: number | null;
+    /** PDF-only: local offset collapsed. Ignored when warm/area says otherwise. */
+    offsetDegenerate?: boolean;
+    offsetDegenerateReason?: string | null;
+}
+export interface BuildableDisplayVocab {
+    kind: BuildableDisplayKind;
+    /** Inspect / map-card FacetState for the Buildable row. */
+    cardState: "present" | "absent" | "pending";
+    /** Customer string for map card + inspect Buildable row. */
+    cardLabel: string | null;
+    /** Customer string for site-plan PDF SUMMARY "Buildable Area". */
+    pdfLabel: string;
+    /**
+     * Stable probe token — planner pastes this across map / inspect / PDF.
+     * Same inputs → same token on every surface.
+     */
+    agreementToken: string;
+}
+/** Resolve the best area signal — prefer warm envelope when it has area. */
+export declare function resolveBuildableAreaSqFt(input: BuildableDisplayInput): number | null;
+/**
+ * Pure mapper: envelope / warm / offset inputs → one customer vocabulary.
+ * Do not invent a % when no area signal exists (honest shared pending OK).
+ */
+export declare function mapBuildableDisplay(input: BuildableDisplayInput): BuildableDisplayVocab;
+/** True when copy would revive the historical map/PDF disagreement. */
+export declare function violatesHistoricalDisagreementGuard(vocab: BuildableDisplayVocab, input: BuildableDisplayInput): boolean;
+//# sourceMappingURL=buildable.d.ts.map

package/dist/display/buildable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildable.d.ts","sourceRoot":"","sources":["../../src/display/buildable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,GACR,SAAS,GACT,SAAS,GACT,aAAa,GACb,qBAAqB,GACrB,kBAAkB,GAClB,eAAe;AACjB,0EAA0E;GACxE,gBAAgB;AAClB;;;;;GAKG;GACD,0BAA0B,CAAC;AAE/B,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,mBAAmB,GAAG,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC;AAE7F,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,mBAAmB,GACnB,wBAAwB,GACxB,gBAAgB,GAChB,IAAI,GACJ,SAAS,CAAC;AAEd,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,6DAA6D;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,2DAA2D;IAC3D,SAAS,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,4DAA4D;IAC5D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAUD,4EAA4E;AAC5E,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,CASpF;AA2BD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,qBAAqB,GAAG,qBAAqB,CAiLvF;AAED,uEAAuE;AACvE,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,qBAAqB,EAC5B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAST"}

package/dist/display/buildable.js

@@ -0,0 +1,240 @@
+/**
+ * Shared customer-facing buildable / setback vocabulary (Track B3 / WDLL 5).
+ *
+ * Map card, inspect, and site-plan PDF must speak ONE truth for the same
+ * envelope inputs. Surfaces MUST call `mapBuildableDisplay` rather than
+ * re-deriving "pending" / "consumes lot" / provisional copy independently.
+ *
+ * Axes (cannot disagree across surfaces for identical inputs):
+ *   pending | provisional | buildable-with-area | declined-consume | not_specified
+ *   (+ absent / loading for non-envelope shells)
+ *
+ * Historical disagreement class (FIX1 symptom): envelope area present on the
+ * warm facet while PDF said "setback-consumes-lot" and the card said bare
+ * "buildable % pending". Guard: area present → never those two strings.
+ *
+ * P-167 (OPS-23 R-6): moved verbatim into `@empressaio/atom-contract/display`
+ * from the five byte-identical copies this module used to have (hauska-map
+ * `apps/property-explorer/src/lib/buildable-display-vocab.ts`, hauska-engine
+ * `packages/engine-core/src/site-plan/buildable-display-vocab.ts` and
+ * `packages/retrieval/src/serving-sweep/vendor/buildable-display-vocab.ts`,
+ * sha256 `45c277d7...29cac`). No export, string, or branch below changed in
+ * the move.
+ */
+function positiveNumber(n) {
+    return typeof n === "number" && Number.isFinite(n) && n > 0;
+}
+function nonNegativeNumber(n) {
+    return typeof n === "number" && Number.isFinite(n) && n >= 0;
+}
+/** Resolve the best area signal — prefer warm envelope when it has area. */
+export function resolveBuildableAreaSqFt(input) {
+    if (input.warmEnvelopeKind === "buildable" &&
+        positiveNumber(input.warmEnvelopeAreaSqFt)) {
+        return input.warmEnvelopeAreaSqFt;
+    }
+    if (positiveNumber(input.buildableAreaSqFt))
+        return input.buildableAreaSqFt;
+    return null;
+}
+function areaPresent(input) {
+    if (positiveNumber(input.buildableAreaPct))
+        return true;
+    if (resolveBuildableAreaSqFt(input) != null)
+        return true;
+    if (input.warmEnvelopeKind === "buildable" &&
+        positiveNumber(input.warmEnvelopeAreaSqFt)) {
+        return true;
+    }
+    return false;
+}
+/** Numeric area OR drawable warm geojson — never leave as bare pending. */
+function drawableOrAreaPresent(input) {
+    return areaPresent(input) || input.hasGeometry === true;
+}
+function formatPct(pct) {
+    return `${Math.round(pct)}%`;
+}
+function formatSqFt(sqFt) {
+    return `${Math.round(sqFt).toLocaleString("en-US")} sq ft`;
+}
+/**
+ * Pure mapper: envelope / warm / offset inputs → one customer vocabulary.
+ * Do not invent a % when no area signal exists (honest shared pending OK).
+ */
+export function mapBuildableDisplay(input) {
+    const decline = input.declineReason ?? null;
+    const silent = input.notSpecifiedAxes === true;
+    const areaSqFt = resolveBuildableAreaSqFt(input);
+    const hasDrawable = drawableOrAreaPresent(input);
+    const provisional = input.provisional === true ||
+        input.warmEnvelopeKind === "provisional-front-edge";
+    // R-2 (2026-09-11): a real modelled polygon is on file even though the
+    // atom-chain read is still pending — draw it, withhold only the figure.
+    // Checked BEFORE the generic loading shell below, which is reserved for the
+    // case with no geometry at all (a genuine transient "still loading" state).
+    if (decline === "atom_path_pending" && input.hasGeometry === true) {
+        return {
+            kind: "modelled-figure-withheld",
+            cardState: "present",
+            cardLabel: "Buildable envelope modelled from setbacks — area withheld pending an atom",
+            pdfLabel: "withheld — buildable envelope modelled from setbacks, not yet backed by an atom",
+            agreementToken: "modelled-figure-withheld",
+        };
+    }
+    // Loading shell (Gate C) — never "not verified" / consume.
+    if (decline === "atom_path_pending") {
+        return {
+            kind: "loading",
+            cardState: "pending",
+            cardLabel: "Loading buildable area…",
+            pdfLabel: "pending — atom path loading",
+            agreementToken: "loading",
+        };
+    }
+    // Declined envelope (honest absence of setbacks/zoning path).
+    if (input.envelopeStatus === "declined") {
+        return {
+            kind: "absent",
+            cardState: "absent",
+            cardLabel: null,
+            pdfLabel: `unavailable — ${decline ?? "envelope declined"}`,
+            agreementToken: `absent:${decline ?? "declined"}`,
+        };
+    }
+    // Unincorporated land — no zoning ordinance to derive a setback from.
+    // Checked before the drawable/consume-lot branches: there is no area
+    // signal to have an opinion on here, and "setbacks consume lot" would be
+    // a false claim (no setback assessment happened at all).
+    if (input.warmEnvelopeKind === "not-applicable") {
+        return {
+            kind: "not-applicable",
+            cardState: "absent",
+            cardLabel: "Not zoned — no setback requirements",
+            pdfLabel: "not applicable — unincorporated, no zoning ordinance",
+            agreementToken: "not-applicable",
+        };
+    }
+    // Silent axes (build-to-line) with NO drawable/area — never consume-lot.
+    if (silent && !hasDrawable) {
+        return {
+            kind: "not_specified",
+            cardState: "pending",
+            cardLabel: "build-to-line · buildable % pending",
+            pdfLabel: "pending — build-to-line governs (scalar setback silent)",
+            agreementToken: "not_specified",
+        };
+    }
+    // Area or warm geojson wins over any local "consumes lot" / bare pending (B3).
+    if (hasDrawable) {
+        const pct = positiveNumber(input.buildableAreaPct)
+            ? input.buildableAreaPct
+            : null;
+        const cardCore = pct != null
+            ? formatPct(pct)
+            : areaSqFt != null
+                ? `~${formatSqFt(areaSqFt)}`
+                : silent
+                    ? "buildable envelope on file (build-to-line)"
+                    : "buildable envelope on file";
+        const pdfCore = areaSqFt != null
+            ? formatSqFt(areaSqFt)
+            : pct != null
+                ? `${formatPct(pct)} of lot`
+                : silent
+                    ? "buildable envelope on file (build-to-line)"
+                    : "buildable envelope on file";
+        if (provisional) {
+            return {
+                kind: "provisional",
+                cardState: "present",
+                cardLabel: `${cardCore} (provisional)`,
+                pdfLabel: `${pdfCore} (PROVISIONAL)`,
+                agreementToken: `provisional:${pct ?? (areaSqFt != null ? Math.round(areaSqFt) : "envelope")}`,
+            };
+        }
+        return {
+            kind: "buildable-with-area",
+            cardState: "present",
+            cardLabel: cardCore,
+            pdfLabel: pdfCore,
+            agreementToken: `buildable:${pct ?? (areaSqFt != null ? Math.round(areaSqFt) : "envelope")}`,
+        };
+    }
+    // Honest consume-lot — only when no area signal and status / warm / offset agree.
+    const warmConsumes = input.warmEnvelopeKind === "no-buildable-area";
+    const statusConsumes = input.envelopeStatus === "no-buildable-area";
+    const offsetConsumes = input.offsetDegenerate === true &&
+        input.warmEnvelopeKind !== "buildable" &&
+        input.warmEnvelopeKind !== "provisional-front-edge";
+    if ((statusConsumes || warmConsumes || offsetConsumes) && !silent) {
+        const reason = input.offsetDegenerateReason ??
+            (warmConsumes ? "warm envelope: no-buildable-area" : null) ??
+            "setbacks consume lot";
+        return {
+            kind: "declined-consume",
+            cardState: "present",
+            cardLabel: "0% — setbacks consume lot",
+            pdfLabel: `unavailable — ${reason}`,
+            agreementToken: "declined-consume",
+        };
+    }
+    // Explicit zero pct with consume status.
+    if (nonNegativeNumber(input.buildableAreaPct) &&
+        input.buildableAreaPct === 0 &&
+        statusConsumes) {
+        return {
+            kind: "declined-consume",
+            cardState: "present",
+            cardLabel: "0% — setbacks consume lot",
+            pdfLabel: "unavailable — setbacks consume lot",
+            agreementToken: "declined-consume",
+        };
+    }
+    // Setbacks / ok envelope present but no area yet — honest shared pending.
+    if (input.envelopeStatus === "ok" ||
+        input.hasGeometry === true ||
+        input.warmEnvelopeKind === "provisional-front-edge") {
+        if (provisional) {
+            return {
+                kind: "provisional",
+                cardState: "pending",
+                cardLabel: "provisional · buildable % pending",
+                pdfLabel: "provisional — buildable area pending front-edge resolution",
+                agreementToken: "provisional:pending",
+            };
+        }
+        return {
+            kind: "pending",
+            cardState: "pending",
+            cardLabel: "setbacks present · buildable % pending",
+            pdfLabel: "pending — setbacks on file; buildable area not yet derived",
+            agreementToken: "pending",
+        };
+    }
+    // No envelope signal at all.
+    return {
+        kind: "absent",
+        cardState: "absent",
+        cardLabel: null,
+        pdfLabel: "unavailable — no buildable envelope on file",
+        agreementToken: "absent",
+    };
+}
+/** True when copy would revive the historical map/PDF disagreement. */
+export function violatesHistoricalDisagreementGuard(vocab, input) {
+    if (!drawableOrAreaPresent(input))
+        return false;
+    const blob = `${vocab.cardLabel ?? ""} ${vocab.pdfLabel}`.toLowerCase();
+    if (/consumes?\s+lot/.test(blob))
+        return true;
+    if (vocab.kind === "declined-consume")
+        return true;
+    // Bare pending % while drawable/area exists is the other half of the disagreement.
+    if (vocab.kind === "pending" || vocab.kind === "not_specified")
+        return true;
+    if (/buildable % pending/.test(blob) && !/provisional/.test(blob))
+        return true;
+    return false;
+}
+//# sourceMappingURL=buildable.js.map

package/dist/display/buildable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildable.js","sourceRoot":"","sources":["../../src/display/buildable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAoEH,SAAS,cAAc,CAAC,CAA4B;IAClD,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,iBAAiB,CAAC,CAA4B;IACrD,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,wBAAwB,CAAC,KAA4B;IACnE,IACE,KAAK,CAAC,gBAAgB,KAAK,WAAW;QACtC,cAAc,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAC1C,CAAC;QACD,OAAO,KAAK,CAAC,oBAAoB,CAAC;IACpC,CAAC;IACD,IAAI,cAAc,CAAC,KAAK,CAAC,iBAAiB,CAAC;QAAE,OAAO,KAAK,CAAC,iBAAiB,CAAC;IAC5E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,KAA4B;IAC/C,IAAI,cAAc,CAAC,KAAK,CAAC,gBAAgB,CAAC;QAAE,OAAO,IAAI,CAAC;IACxD,IAAI,wBAAwB,CAAC,KAAK,CAAC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACzD,IACE,KAAK,CAAC,gBAAgB,KAAK,WAAW;QACtC,cAAc,CAAC,KAAK,CAAC,oBAAoB,CAAC,EAC1C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,2EAA2E;AAC3E,SAAS,qBAAqB,CAAC,KAA4B;IACzD,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,WAAW,KAAK,IAAI,CAAC;AAC1D,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;AAC/B,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,QAAQ,CAAC;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAA4B;IAC9D,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,IAAI,IAAI,CAAC;IAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,gBAAgB,KAAK,IAAI,CAAC;IAC/C,MAAM,QAAQ,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACjD,MAAM,WAAW,GACf,KAAK,CAAC,WAAW,KAAK,IAAI;QAC1B,KAAK,CAAC,gBAAgB,KAAK,wBAAwB,CAAC;IAEtD,uEAAuE;IACvE,wEAAwE;IACxE,4EAA4E;IAC5E,4EAA4E;IAC5E,IAAI,OAAO,KAAK,mBAAmB,IAAI,KAAK,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QAClE,OAAO;YACL,IAAI,EAAE,0BAA0B;YAChC,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,2EAA2E;YACtF,QAAQ,EAAE,iFAAiF;YAC3F,cAAc,EAAE,0BAA0B;SAC3C,CAAC;IACJ,CAAC;IAED,2DAA2D;IAC3D,IAAI,OAAO,KAAK,mBAAmB,EAAE,CAAC;QACpC,OAAO;YACL,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,yBAAyB;YACpC,QAAQ,EAAE,6BAA6B;YACvC,cAAc,EAAE,SAAS;SAC1B,CAAC;IACJ,CAAC;IAED,8DAA8D;IAC9D,IAAI,KAAK,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QACxC,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,SAAS,EAAE,QAAQ;YACnB,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,iBAAiB,OAAO,IAAI,mBAAmB,EAAE;YAC3D,cAAc,EAAE,UAAU,OAAO,IAAI,UAAU,EAAE;SAClD,CAAC;IACJ,CAAC;IAED,sEAAsE;IACtE,qEAAqE;IACrE,yEAAyE;IACzE,yDAAyD;IACzD,IAAI,KAAK,CAAC,gBAAgB,KAAK,gBAAgB,EAAE,CAAC;QAChD,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,SAAS,EAAE,QAAQ;YACnB,SAAS,EAAE,qCAAqC;YAChD,QAAQ,EAAE,sDAAsD;YAChE,cAAc,EAAE,gBAAgB;SACjC,CAAC;IACJ,CAAC;IAED,yEAAyE;IACzE,IAAI,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,eAAe;YACrB,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,qCAAqC;YAChD,QAAQ,EAAE,yDAAyD;YACnE,cAAc,EAAE,eAAe;SAChC,CAAC;IACJ,CAAC;IAED,+EAA+E;IAC/E,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,cAAc,CAAC,KAAK,CAAC,gBAAgB,CAAC;YAChD,CAAC,CAAC,KAAK,CAAC,gBAAgB;YACxB,CAAC,CAAC,IAAI,CAAC;QACT,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI;YAC1B,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;YAChB,CAAC,CAAC,QAAQ,IAAI,IAAI;gBAChB,CAAC,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE;gBAC5B,CAAC,CAAC,MAAM;oBACN,CAAC,CAAC,4CAA4C;oBAC9C,CAAC,CAAC,4BAA4B,CAAC;QACrC,MAAM,OAAO,GAAG,QAAQ,IAAI,IAAI;YAC9B,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;YACtB,CAAC,CAAC,GAAG,IAAI,IAAI;gBACX,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,SAAS;gBAC5B,CAAC,CAAC,MAAM;oBACN,CAAC,CAAC,4CAA4C;oBAC9C,CAAC,CAAC,4BAA4B,CAAC;QAErC,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO;gBACL,IAAI,EAAE,aAAa;gBACnB,SAAS,EAAE,SAAS;gBACpB,SAAS,EAAE,GAAG,QAAQ,gBAAgB;gBACtC,QAAQ,EAAE,GAAG,OAAO,gBAAgB;gBACpC,cAAc,EAAE,eAAe,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE;aAC/F,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,EAAE,qBAAqB;YAC3B,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,QAAQ;YACnB,QAAQ,EAAE,OAAO;YACjB,cAAc,EAAE,aAAa,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,EAAE;SAC7F,CAAC;IACJ,CAAC;IAED,kFAAkF;IAClF,MAAM,YAAY,GAAG,KAAK,CAAC,gBAAgB,KAAK,mBAAmB,CAAC;IACpE,MAAM,cAAc,GAAG,KAAK,CAAC,cAAc,KAAK,mBAAmB,CAAC;IACpE,MAAM,cAAc,GAClB,KAAK,CAAC,gBAAgB,KAAK,IAAI;QAC/B,KAAK,CAAC,gBAAgB,KAAK,WAAW;QACtC,KAAK,CAAC,gBAAgB,KAAK,wBAAwB,CAAC;IAEtD,IAAI,CAAC,cAAc,IAAI,YAAY,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAClE,MAAM,MAAM,GACV,KAAK,CAAC,sBAAsB;YAC5B,CAAC,YAAY,CAAC,CAAC,CAAC,kCAAkC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC1D,sBAAsB,CAAC;QACzB,OAAO;YACL,IAAI,EAAE,kBAAkB;YACxB,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,2BAA2B;YACtC,QAAQ,EAAE,iBAAiB,MAAM,EAAE;YACnC,cAAc,EAAE,kBAAkB;SACnC,CAAC;IACJ,CAAC;IAED,yCAAyC;IACzC,IACE,iBAAiB,CAAC,KAAK,CAAC,gBAAgB,CAAC;QACzC,KAAK,CAAC,gBAAgB,KAAK,CAAC;QAC5B,cAAc,EACd,CAAC;QACD,OAAO;YACL,IAAI,EAAE,kBAAkB;YACxB,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,2BAA2B;YACtC,QAAQ,EAAE,oCAAoC;YAC9C,cAAc,EAAE,kBAAkB;SACnC,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,IACE,KAAK,CAAC,cAAc,KAAK,IAAI;QAC7B,KAAK,CAAC,WAAW,KAAK,IAAI;QAC1B,KAAK,CAAC,gBAAgB,KAAK,wBAAwB,EACnD,CAAC;QACD,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO;gBACL,IAAI,EAAE,aAAa;gBACnB,SAAS,EAAE,SAAS;gBACpB,SAAS,EAAE,mCAAmC;gBAC9C,QAAQ,EAAE,4DAA4D;gBACtE,cAAc,EAAE,qBAAqB;aACtC,CAAC;QACJ,CAAC;QACD,OAAO;YACL,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,wCAAwC;YACnD,QAAQ,EAAE,4DAA4D;YACtE,cAAc,EAAE,SAAS;SAC1B,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,QAAQ;QACnB,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,6CAA6C;QACvD,cAAc,EAAE,QAAQ;KACzB,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,mCAAmC,CACjD,KAA4B,EAC5B,KAA4B;IAE5B,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAChD,MAAM,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,IAAI,EAAE,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC;IACxE,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB;QAAE,OAAO,IAAI,CAAC;IACnD,mFAAmF;IACnF,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,IAAI,CAAC;IAC5E,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/E,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/display/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Display vocabulary — the human face of every atom (OPS-23 R-6, P-167).
+ *
+ * Import from `@empressaio/atom-contract/display`.
+ *
+ * One versioned subpath producing the display strings that every surface
+ * (the Property Explorer panel, the feasibility PDF, and the Smart Site MCP
+ * connector) renders for the same claim, so the row moves strings between
+ * repos instead of letting them diverge into copies. See `buildable.ts`
+ * (the buildable/setback card, PDF, and agreement-token vocabulary,
+ * previously five byte-identical copies across hauska-map and
+ * hauska-engine) and `wire.ts` (the Smart Site MCP wire-token vocabulary
+ * table, previously owned only by legacy-design-tools).
+ */
+export * from "./buildable.js";
+export * from "./wire.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/display/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC"}

package/dist/display/index.js

@@ -0,0 +1,17 @@
+/**
+ * Display vocabulary — the human face of every atom (OPS-23 R-6, P-167).
+ *
+ * Import from `@empressaio/atom-contract/display`.
+ *
+ * One versioned subpath producing the display strings that every surface
+ * (the Property Explorer panel, the feasibility PDF, and the Smart Site MCP
+ * connector) renders for the same claim, so the row moves strings between
+ * repos instead of letting them diverge into copies. See `buildable.ts`
+ * (the buildable/setback card, PDF, and agreement-token vocabulary,
+ * previously five byte-identical copies across hauska-map and
+ * hauska-engine) and `wire.ts` (the Smart Site MCP wire-token vocabulary
+ * table, previously owned only by legacy-design-tools).
+ */
+export * from "./buildable.js";
+export * from "./wire.js";
+//# sourceMappingURL=index.js.map

package/dist/display/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/display/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC"}

package/dist/display/wire.d.ts

@@ -0,0 +1,122 @@
+/**
+ * P-167 (OPS-23 R-6). Moved verbatim from legacy-design-tools
+ * `artifacts/smartsite-mcp/src/vocabulary.ts` (origin/main 55c4ad44, the
+ * P-91 v3 table): the disposition enum, the refusal codes, the two Open
+ * failure sentences, citationsDegraded, confidence "seed", edge role
+ * side_corner, and frame quality gis-approximate. No display string below
+ * was reworded in the move; only the import mechanism changed (see next
+ * paragraph) and the stale entry-count comment was corrected (see
+ * `DOCUMENTED_VOCABULARY_COUNT`, enforced by a test that counts).
+ *
+ * The nine display constants this table used to import as VALUES from the
+ * MCP server's own `mcp-app.ts` (STATE_WORDS, OPEN_DID_NOT_REACH_ME,
+ * NOT_ON_FILE_PREFIX, NO_BAKED_SNAPSHOT_PREFIX, UPGRADE_TO_OPEN,
+ * NOT_IMPLEMENTED_PREFIX, CITATION_DEGRADED, EDGE_WORDS, envelopeHuman) are
+ * moved in below, verbatim, so this module has no dependency on the MCP
+ * server. This is now the one place these strings are owned; a consumer
+ * (the panel included) imports the value from here rather than retyping it.
+ */
+/**
+ * The panel's five-state PAINT vocabulary (originally typed against
+ * mcp-app.ts's local `CellState`). Renamed here to make explicit that this
+ * is the MCP panel's own paint-state enum, not the ledger's six-state cell
+ * vocabulary (OPS-21, `_catalog/program_preambles/OPS-21.md`) — a
+ * deliberately different, narrower concept this table happens to need for
+ * one Record's key type. Not exported: nothing outside this module typed
+ * against the original `CellState` name (vocabulary.ts imported only the
+ * STATE_WORDS value, never the type), so the rename is invisible to every
+ * existing importer.
+ */
+type PanelPaintState = "present" | "absent-verified" | "unknown" | "refused" | "unread";
+/** mcp-app.ts:304. */
+export declare const NOT_ON_FILE_PREFIX = "Not on file in";
+/** mcp-app.ts:305. */
+export declare const NO_BAKED_SNAPSHOT_PREFIX = "No baked snapshot yet for";
+/** mcp-app.ts:307. */
+export declare const UPGRADE_TO_OPEN = "Upgrade to open this parcel";
+/** mcp-app.ts:333. */
+export declare const NOT_IMPLEMENTED_PREFIX = "Not implemented";
+/** mcp-app.ts:3023. */
+export declare const OPEN_DID_NOT_REACH_ME = "Open did not reach me";
+/**
+ * mcp-app.ts:448-451. Maps exactly one token, `atom_path_pending`, to its
+ * display sentence; every other reason passes through unchanged.
+ */
+export declare function envelopeHuman(reason: string | undefined): string | undefined;
+/**
+ * P-153 sibling of `envelopeHuman` (folded into the package at P-167 step 2,
+ * moved verbatim from mcp-app.ts:462-467), for a `state: "present"` envelope
+ * overlay's `basis` (never its `reason` — a present overlay carries no
+ * `reason`, so `envelopeHuman` never applies to it; see tool-honesty.ts's
+ * `honestOverlay`). Mirrors hauska-map's equivalent panel copy (`buildable.ts`
+ * in this same subpath) for the same underlying state: the buildable-envelope
+ * polygon is drawn from a real district + setback table, while the
+ * buildable-AREA figure stays withheld pending an atom.
+ */
+export declare function envelopeBasisHuman(basis: string | undefined): string | undefined;
+/** mcp-app.ts:523. D1: adjacency and role words. Keys are the wire enum; any other value prints verbatim. */
+export declare const EDGE_WORDS: Record<string, string>;
+/** mcp-app.ts:550. F1: a section or overlay that claims a fact without an https citation says so; the text, never a link. */
+export declare const CITATION_DEGRADED = "citation degraded";
+/** mcp-app.ts:575. The five-state legend words, one per paint state. */
+export declare const STATE_WORDS: Record<PanelPaintState, string>;
+export type VocabularyEntry = {
+    /** The exact machine token as it appears in code or on the wire. */
+    token: string;
+    /** The exact string a lay reader gets. Sourced from the panel's own copy where one exists. */
+    displayText: string;
+    /** One line: what the token means, and where it matters, what it does not claim. */
+    meaning: string;
+};
+/**
+ * Wire-level section disposition words (tool-honesty.ts sectionDisposition
+ * / ExternalBriefSectionDisposition). Distinct from the panel's five-state
+ * PAINT vocabulary (STATE_WORDS / PanelPaintState above), though as of P-91
+ * v3 item 1 the two now overlap: `unknown` and `absent-verified` are the
+ * union's own display words, not the panel's earned-locally versions of
+ * them (a section that CLAIMS one of those two is preserved as claimed, not
+ * re-derived -- see tool-honesty.ts sectionDisposition). Cortex does not
+ * emit either at section level today (confirmed against
+ * artifacts/api-server's own R1BriefSectionDisposition type and the WDLL
+ * item 5 ruling withholding absent-verified there), so in practice the wire
+ * still only ever carries the original four; this table's other two rows
+ * exist so the display text is correct the day a section does. Both rows
+ * reuse STATE_WORDS' own strings rather than retype them, so the panel's
+ * word and the wire's word for the same token cannot drift apart.
+ */
+export declare const WIRE_DISPOSITION_DISPLAY_TEXT: Record<"present" | "refused" | "absent" | "unread" | "unknown" | "absent-verified", string>;
+/**
+ * V5 (P-91 v3). Nothing in the wire shape prohibited computing an area or a
+ * coverage ratio from draw.ring; a session did exactly that. This is the
+ * stated policy, carried in the payload next to the geometry it governs
+ * (see sanitizeExternalDraw), not left as a convention nobody reads.
+ */
+export declare const DERIVED_FIGURES_POLICY: {
+    readonly denies: readonly ["area", "coverage_ratio", "lot_coverage_pct", "setback_distance", "buildable_area"];
+    readonly reason: "ring, edges, and overlays are for rendering only. Do not compute an area, a coverage ratio, a percentage, or a distance from them; use a brief section's own figure, or say the figure is not on record.";
+};
+/**
+ * The real, current entry count of VOCABULARY below, checked by a test
+ * (`wire.test.ts`) so this number cannot go stale the way the source
+ * table's own comment did (it said "19 entries" while the table had grown
+ * to 34; see `_inbox/2026-09-11_ops23_wave1_verify_p167.md` finding 4).
+ */
+export declare const DOCUMENTED_VOCABULARY_COUNT = 35;
+/**
+ * V1. 35 entries (`DOCUMENTED_VOCABULARY_COUNT`, enforced by a counting
+ * test): the disposition enum, the panel-only paint additions
+ * (absent-verified, unknown), the two Open failure sentences (kept
+ * distinct, checked by tests), citationsDegraded, confidence "seed", frame
+ * quality gis-approximate, edge role side_corner, the refusal/reason codes
+ * read out of tool-honesty.ts, mcp-app.ts and their tests
+ * (declined-in-bake, not-in-bake, atom_path_pending, upgrade_required,
+ * parcel_not_found, baked_snapshot_not_found, parcel_batch_cap,
+ * depth_not_implemented), the P-91 v3 Q1 near/street refusal codes, the
+ * P-106 find_parcels refusal codes, the P-107 out_of_coverage miss class,
+ * and the P-153 modelled-figure-withheld draw-overlay basis (folded in at
+ * P-167 step 2). Every token here is grepped out of the source, not
+ * invented; see the P-91 v3 handback for the grep trail.
+ */
+export declare const VOCABULARY: readonly VocabularyEntry[];
+export {};
+//# sourceMappingURL=wire.d.ts.map

package/dist/display/wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/display/wire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;GAUG;AACH,KAAK,eAAe,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAExF,sBAAsB;AACtB,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,sBAAsB;AACtB,eAAO,MAAM,wBAAwB,8BAA8B,CAAC;AACpE,sBAAsB;AACtB,eAAO,MAAM,eAAe,gCAAgC,CAAC;AAC7D,sBAAsB;AACtB,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AACxD,uBAAuB;AACvB,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKhF;AAED,6GAA6G;AAC7G,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAS7C,CAAC;AAEF,6HAA6H;AAC7H,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,wEAAwE;AACxE,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAMvD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,WAAW,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAChD,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,iBAAiB,EAC3E,MAAM,CAQP,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;CAUzB,CAAC;AAgCX;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,eAAe,EA8PvC,CAAC"}

package/dist/display/wire.js

@@ -0,0 +1,378 @@
+/**
+ * P-167 (OPS-23 R-6). Moved verbatim from legacy-design-tools
+ * `artifacts/smartsite-mcp/src/vocabulary.ts` (origin/main 55c4ad44, the
+ * P-91 v3 table): the disposition enum, the refusal codes, the two Open
+ * failure sentences, citationsDegraded, confidence "seed", edge role
+ * side_corner, and frame quality gis-approximate. No display string below
+ * was reworded in the move; only the import mechanism changed (see next
+ * paragraph) and the stale entry-count comment was corrected (see
+ * `DOCUMENTED_VOCABULARY_COUNT`, enforced by a test that counts).
+ *
+ * The nine display constants this table used to import as VALUES from the
+ * MCP server's own `mcp-app.ts` (STATE_WORDS, OPEN_DID_NOT_REACH_ME,
+ * NOT_ON_FILE_PREFIX, NO_BAKED_SNAPSHOT_PREFIX, UPGRADE_TO_OPEN,
+ * NOT_IMPLEMENTED_PREFIX, CITATION_DEGRADED, EDGE_WORDS, envelopeHuman) are
+ * moved in below, verbatim, so this module has no dependency on the MCP
+ * server. This is now the one place these strings are owned; a consumer
+ * (the panel included) imports the value from here rather than retyping it.
+ */
+/** mcp-app.ts:304. */
+export const NOT_ON_FILE_PREFIX = "Not on file in";
+/** mcp-app.ts:305. */
+export const NO_BAKED_SNAPSHOT_PREFIX = "No baked snapshot yet for";
+/** mcp-app.ts:307. */
+export const UPGRADE_TO_OPEN = "Upgrade to open this parcel";
+/** mcp-app.ts:333. */
+export const NOT_IMPLEMENTED_PREFIX = "Not implemented";
+/** mcp-app.ts:3023. */
+export const OPEN_DID_NOT_REACH_ME = "Open did not reach me";
+/**
+ * mcp-app.ts:448-451. Maps exactly one token, `atom_path_pending`, to its
+ * display sentence; every other reason passes through unchanged.
+ */
+export function envelopeHuman(reason) {
+    if (reason === "atom_path_pending")
+        return "Withheld, setbacks unruled";
+    return reason;
+}
+/**
+ * P-153 sibling of `envelopeHuman` (folded into the package at P-167 step 2,
+ * moved verbatim from mcp-app.ts:462-467), for a `state: "present"` envelope
+ * overlay's `basis` (never its `reason` — a present overlay carries no
+ * `reason`, so `envelopeHuman` never applies to it; see tool-honesty.ts's
+ * `honestOverlay`). Mirrors hauska-map's equivalent panel copy (`buildable.ts`
+ * in this same subpath) for the same underlying state: the buildable-envelope
+ * polygon is drawn from a real district + setback table, while the
+ * buildable-AREA figure stays withheld pending an atom.
+ */
+export function envelopeBasisHuman(basis) {
+    if (basis === "modelled-figure-withheld") {
+        return "Buildable envelope modelled from setbacks — area withheld pending an atom";
+    }
+    return basis;
+}
+/** mcp-app.ts:523. D1: adjacency and role words. Keys are the wire enum; any other value prints verbatim. */
+export const EDGE_WORDS = {
+    front: "front",
+    side: "side",
+    rear: "rear",
+    side_corner: "corner side",
+    alley: "alley",
+    ROW: "right of way",
+    "neighbor-parcel": "neighbor",
+    unmapped: "unmapped",
+};
+/** mcp-app.ts:550. F1: a section or overlay that claims a fact without an https citation says so; the text, never a link. */
+export const CITATION_DEGRADED = "citation degraded";
+/** mcp-app.ts:575. The five-state legend words, one per paint state. */
+export const STATE_WORDS = {
+    present: "present",
+    "absent-verified": "absent, verified",
+    unknown: "unknown",
+    refused: "refused",
+    unread: "unread",
+};
+/**
+ * Wire-level section disposition words (tool-honesty.ts sectionDisposition
+ * / ExternalBriefSectionDisposition). Distinct from the panel's five-state
+ * PAINT vocabulary (STATE_WORDS / PanelPaintState above), though as of P-91
+ * v3 item 1 the two now overlap: `unknown` and `absent-verified` are the
+ * union's own display words, not the panel's earned-locally versions of
+ * them (a section that CLAIMS one of those two is preserved as claimed, not
+ * re-derived -- see tool-honesty.ts sectionDisposition). Cortex does not
+ * emit either at section level today (confirmed against
+ * artifacts/api-server's own R1BriefSectionDisposition type and the WDLL
+ * item 5 ruling withholding absent-verified there), so in practice the wire
+ * still only ever carries the original four; this table's other two rows
+ * exist so the display text is correct the day a section does. Both rows
+ * reuse STATE_WORDS' own strings rather than retype them, so the panel's
+ * word and the wire's word for the same token cannot drift apart.
+ */
+export const WIRE_DISPOSITION_DISPLAY_TEXT = {
+    present: "Present",
+    refused: "Refused",
+    absent: "Reported absent",
+    unread: "Not read",
+    unknown: STATE_WORDS.unknown,
+    "absent-verified": STATE_WORDS["absent-verified"],
+};
+/**
+ * V5 (P-91 v3). Nothing in the wire shape prohibited computing an area or a
+ * coverage ratio from draw.ring; a session did exactly that. This is the
+ * stated policy, carried in the payload next to the geometry it governs
+ * (see sanitizeExternalDraw), not left as a convention nobody reads.
+ */
+export const DERIVED_FIGURES_POLICY = {
+    denies: [
+        "area",
+        "coverage_ratio",
+        "lot_coverage_pct",
+        "setback_distance",
+        "buildable_area",
+    ],
+    reason: "ring, edges, and overlays are for rendering only. Do not compute an area, a coverage ratio, a percentage, or a distance from them; use a brief section's own figure, or say the figure is not on record.",
+};
+function requireString(value, what) {
+    if (!value) {
+        throw new Error(`vocabulary: ${what} produced no display string`);
+    }
+    return value;
+}
+/**
+ * atom_path_pending's display text is read out of envelopeHuman, the same
+ * function the panel calls, rather than retyped here. If that mapping is
+ * ever removed, this throws at module load instead of silently shipping the
+ * raw token as its own "display text".
+ */
+const ATOM_PATH_PENDING_DISPLAY_TEXT = requireString(envelopeHuman("atom_path_pending"), 'envelopeHuman("atom_path_pending")');
+/**
+ * P-153 (Ruling B reversed for the polygon only), folded in at P-167 step 2.
+ * A draw overlay's `basis`, not `reason` — this token names a `state:
+ * "present"` overlay, never a refused one. Read through `envelopeBasisHuman`
+ * above, same requireString-at-load-time posture as
+ * ATOM_PATH_PENDING_DISPLAY_TEXT.
+ */
+const MODELLED_FIGURE_WITHHELD_DISPLAY_TEXT = requireString(envelopeBasisHuman("modelled-figure-withheld"), 'envelopeBasisHuman("modelled-figure-withheld")');
+/**
+ * The real, current entry count of VOCABULARY below, checked by a test
+ * (`wire.test.ts`) so this number cannot go stale the way the source
+ * table's own comment did (it said "19 entries" while the table had grown
+ * to 34; see `_inbox/2026-09-11_ops23_wave1_verify_p167.md` finding 4).
+ */
+export const DOCUMENTED_VOCABULARY_COUNT = 35;
+/**
+ * V1. 35 entries (`DOCUMENTED_VOCABULARY_COUNT`, enforced by a counting
+ * test): the disposition enum, the panel-only paint additions
+ * (absent-verified, unknown), the two Open failure sentences (kept
+ * distinct, checked by tests), citationsDegraded, confidence "seed", frame
+ * quality gis-approximate, edge role side_corner, the refusal/reason codes
+ * read out of tool-honesty.ts, mcp-app.ts and their tests
+ * (declined-in-bake, not-in-bake, atom_path_pending, upgrade_required,
+ * parcel_not_found, baked_snapshot_not_found, parcel_batch_cap,
+ * depth_not_implemented), the P-91 v3 Q1 near/street refusal codes, the
+ * P-106 find_parcels refusal codes, the P-107 out_of_coverage miss class,
+ * and the P-153 modelled-figure-withheld draw-overlay basis (folded in at
+ * P-167 step 2). Every token here is grepped out of the source, not
+ * invented; see the P-91 v3 handback for the grep trail.
+ */
+export const VOCABULARY = [
+    {
+        token: "present",
+        displayText: WIRE_DISPOSITION_DISPLAY_TEXT.present,
+        meaning: "The section or rail carries confirmed on-record data for this parcel.",
+    },
+    {
+        token: "absent",
+        displayText: WIRE_DISPOSITION_DISPLAY_TEXT.absent,
+        meaning: "The source claims no record exists, not yet verified by provenance or a known vintage. A claim, not yet a confirmed absence.",
+    },
+    {
+        token: "absent-verified",
+        displayText: STATE_WORDS["absent-verified"],
+        meaning: "Confirmed absent: the absence claim carries provenance or a known source vintage. A panel-side paint state, earned from a wire 'absent' claim, never asserted directly on the wire.",
+    },
+    {
+        token: "unknown",
+        displayText: STATE_WORDS.unknown,
+        meaning: "Not a finding either way. The record neither confirms present nor earns a verified absence.",
+    },
+    {
+        token: "refused",
+        displayText: WIRE_DISPOSITION_DISPLAY_TEXT.refused,
+        meaning: "The producer declined to answer on this read path. See the refusal code and reason for why.",
+    },
+    {
+        token: "unread",
+        displayText: WIRE_DISPOSITION_DISPLAY_TEXT.unread,
+        meaning: "Not read on this call. Distinct from absent: nothing was checked, so there is no claim to report either way.",
+    },
+    {
+        token: "citationsDegraded",
+        displayText: CITATION_DEGRADED,
+        meaning: "A present claim carries no verifiable https citation; the source exists but could not be linked.",
+    },
+    {
+        token: "gis-approximate",
+        displayText: "GIS-approximate",
+        meaning: "frame.quality: the boundary ring is derived from public GIS parcel geometry, not a field survey. Printed distances are approximate, not surveyed.",
+    },
+    {
+        token: "seed",
+        displayText: "Seed confidence",
+        meaning: "draw.confidence: a first-pass geometric estimate, not a calibrated confidence score, a percentage, or a probability.",
+    },
+    {
+        token: "side_corner",
+        displayText: requireString(EDGE_WORDS.side_corner, "EDGE_WORDS.side_corner"),
+        meaning: "The property line runs along a corner lot's side yard, not its primary front or rear line.",
+    },
+    {
+        token: "atom_path_pending",
+        displayText: ATOM_PATH_PENDING_DISPLAY_TEXT,
+        meaning: "Setbacks and the buildable envelope have not been ruled or baked for this jurisdiction yet; no distance or polygon exists to report.",
+    },
+    /**
+     * P-153 (Ruling B reversed for the polygon only), folded in at P-167 step
+     * 2. A draw overlay's `basis`, not `reason` — this token names a `state:
+     * "present"` overlay, never a refused one. Mirrors hauska-map's equivalent
+     * panel state (this subpath's `buildable.ts`) for the same parcels: the
+     * polygon draws, the area figure stays withheld.
+     */
+    {
+        token: "modelled-figure-withheld",
+        displayText: MODELLED_FIGURE_WITHHELD_DISPLAY_TEXT,
+        meaning: "draw overlay basis (present-state envelope only): the buildable-envelope polygon is drawn from a real, resolved district + setback table, but the buildable-area figure (sq ft or percent) stays withheld pending an atom. DERIVED_FIGURES_POLICY denies buildable_area regardless of this token.",
+    },
+    {
+        token: "upgrade_required",
+        displayText: UPGRADE_TO_OPEN,
+        meaning: "The caller's tier does not include this depth of read. A plan upgrade or a 30-day unlock on the parcel is required.",
+    },
+    {
+        token: "parcel_not_found",
+        displayText: `${NOT_ON_FILE_PREFIX} <county>`,
+        meaning: "No parcel record exists in this server's coverage for the given id. A genuine server-declared miss (missClass absent), distinct from 'open_did_not_reach_me', which is a client-side delivery failure and makes no claim about the parcel.",
+    },
+    {
+        token: "baked_snapshot_not_found",
+        displayText: `${NO_BAKED_SNAPSHOT_PREFIX} <parcelNodeId>`,
+        meaning: "The parcel itself may exist, but the Smart Site facet snapshot has not been baked yet. parcelExists states whether the parcel itself was confirmed, independent of this snapshot miss.",
+    },
+    {
+        token: "parcel_batch_cap",
+        displayText: "Batch too large",
+        meaning: "The request exceeded the array cap for this depth: 50 at stub, 25 at node.",
+    },
+    {
+        token: "open_did_not_reach_me",
+        displayText: OPEN_DID_NOT_REACH_ME,
+        meaning: "Client-side only: the Open click produced no tool result within the host's timeout window. No claim was made about the parcel; this is not a miss, distinct from 'parcel_not_found'.",
+    },
+    {
+        token: "depth_not_implemented",
+        displayText: NOT_IMPLEMENTED_PREFIX,
+        meaning: "hop1 and subgraph depths are not built yet. Not a data miss; the read path itself does not exist.",
+    },
+    {
+        token: "declined-in-bake",
+        displayText: "Declined in bake",
+        meaning: "refusal.code: the producer evaluated this facet during the bake and declined it. refusal.declineReason carries the specific sub-reason (for example no-zoning-stamp).",
+    },
+    {
+        token: "not-in-bake",
+        displayText: "Not in bake",
+        meaning: "refusal.code: this facet was never attempted in the bake that produced this snapshot.",
+    },
+    /**
+     * P-91 v3 Q1. The five closed refusal codes radius-search and
+     * street-search return as a 422 `serve_refused` body (gtmErrorClass.ts,
+     * txgioRadiusSearch.ts, txgioStreetSearch.ts, read 2026-08-31). Every one
+     * of these is a DECLARED REFUSAL, not an upstream fault: the producer
+     * looked at the request and answered honestly that it will not (or
+     * cannot) bound the result. tool-honesty.ts's declarePlaceSearchRefusal
+     * reads the display text for these five back out of this table, so the
+     * word the model sees and the word documented here cannot drift apart.
+     * No numeric threshold (the radius max, the candidate ceiling) is
+     * hardcoded into any meaning below: those values live in api-server, a
+     * repo this package has no dependency on and cannot verify was not
+     * bumped since this was written.
+     */
+    {
+        token: "radius_invalid",
+        displayText: "Invalid radius search input",
+        meaning: "serve_refused reason (near): lat, lng, or radiusFt was missing, non-finite, or radiusFt was not a positive number. A caller-input problem on this specific call, not a claim about the area.",
+    },
+    {
+        token: "radius_exceeds_max",
+        displayText: "Radius exceeds the maximum",
+        meaning: "serve_refused reason (near): radiusFt exceeded the stated maximum this search allows. Lower the radius and retry; not a claim that no parcels exist out there.",
+    },
+    {
+        token: "radius_unbounded",
+        displayText: "Too many parcels in that radius",
+        meaning: "serve_refused reason (near): the candidate parcel count for that point and radius exceeded what this search can bound honestly. Too many parcels in that radius to answer, not that the search failed; narrow the radius or lower cap.",
+    },
+    {
+        token: "bare_street_unbounded",
+        displayText: "Street name needs a locality",
+        meaning: "serve_refused reason (street): a bare street name with no city, ZIP, or countyFips was refused rather than run as an unbounded contains across every county in coverage. Add a city, ZIP, or countyFips and retry.",
+    },
+    {
+        token: "bare_street_not_a_street",
+        displayText: "Not a bare street name",
+        meaning: "serve_refused reason (street): the query reads as a house-number-prefixed address, not a bare street name. Use find_parcel's plain query (or near) for one specific address instead of street.",
+    },
+    /**
+     * P-106. find_parcels' declared refusals, same 422 serve_refused envelope as
+     * the five above. Every one of these is the producer answering honestly
+     * rather than failing. No numeric threshold appears in a meaning below: the
+     * county list and the unmeasured ceiling live in api-server, which this
+     * package has no dependency on and cannot verify was not changed since this
+     * was written. The one number that matters travels in the refusal's own
+     * `detail`, measured on the same snapshot as the answer would have been.
+     */
+    {
+        token: "constraint_bound_missing",
+        displayText: "A county is required",
+        meaning: "serve_refused reason (find_parcels): no geographic bound was given. There is no statewide constraint search, because incorporation is dispositioned for a small share of Texas parcels and a statewide answer would imply coverage that does not exist. Give countyFips.",
+    },
+    {
+        token: "constraint_county_out_of_scope",
+        displayText: "No constraint index for that county",
+        meaning: "serve_refused reason (find_parcels): the projection has never been built for that county. Refused rather than answered with an empty set, because an empty set reads as \"no parcels match\" and this is not that claim.",
+    },
+    {
+        token: "constraint_single_address",
+        displayText: "That is a lookup, not a search",
+        meaning: "serve_refused reason (find_parcels): the query reads as one street address. Use find_parcel, singular, for a single address; find_parcels answers questions across parcels.",
+    },
+    {
+        token: "constraint_filters_missing",
+        displayText: "At least one filter is required",
+        meaning: "serve_refused reason (find_parcels): a county with no filter is not a search. Give at least one {rail, op, value}.",
+    },
+    {
+        token: "constraint_rail_unknown",
+        displayText: "Unknown rail",
+        meaning: "serve_refused reason (find_parcels): the named rail is not one this search carries. The refusal lists the rails that are.",
+    },
+    {
+        token: "constraint_op_unsupported",
+        displayText: "That operator does not apply to that rail",
+        meaning: "serve_refused reason (find_parcels): an ordered comparison on a rail with no ordered value, a categorical match on a rail with no categorical value, or a flag test on a rail with no flag. A caller-input problem on this call, not a claim about the parcels.",
+    },
+    {
+        token: "constraint_cap_invalid",
+        displayText: "Invalid cap",
+        meaning: "serve_refused reason (find_parcels): cap was outside the range this search allows.",
+    },
+    {
+        token: "constraint_rail_unmeasured",
+        displayText: "Too little of that rail is measured to search on it",
+        meaning: "serve_refused reason (find_parcels): the filtered rail is unmeasured on more of the county than the configured ceiling allows, so a search over it would evaluate a small fraction of the county while presenting itself as a search. detail carries the measured percentage, the parcel counts it came from, and the ceiling. Not a claim that no parcels match.",
+    },
+    {
+        token: "constraint_projection_missing",
+        displayText: "The projection has no rows for that county",
+        meaning: "serve_refused reason (find_parcels): the constraint index holds no parcels for that county, so there is nothing to filter. Refused rather than reported as zero matches, because zero matches and never built are different facts.",
+    },
+    /**
+     * P-107 (OPS-16 A-072). find_parcel's missing miss class. Mirrors
+     * SitusSearchMissClass in artifacts/api-server/src/lib/
+     * txgioAddressResolve.ts (read 2026-09-04): a query whose parsed state is
+     * a real, recognised state/territory other than the one the store covers
+     * today returns this missClass on a normal 200, before the ordinary
+     * search ever runs. Not a serve_refused refusal (find_parcel's query
+     * mode has no 422 refusal path) so it is not a PlaceSearchRefusalCode
+     * member; the wire carries it as `missClass`, same slot as `no-hit`, and
+     * tool-honesty.ts's splitFindParcelHits reads this row's displayText
+     * (never re-typed) plus its own hand-mirrored agentGuidance onto the
+     * response when this token fires.
+     */
+    {
+        token: "out_of_coverage",
+        displayText: "Outside Smart Site coverage",
+        meaning: "find_parcel missClass: the query resolved to a state Smart Site's parcel store has not reached yet. The honest opposite of 'no-hit': this is not a claim that the address is unverified or missing, only that coverage has not extended there. agentGuidance names what is covered today.",
+    },
+];
+//# sourceMappingURL=wire.js.map

package/dist/display/wire.js.map

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

package/dist/property/boundary-edge.d.ts

@@ -31,13 +31,13 @@ export declare const BOUNDARY_FACING_ROAD_SCHEMA: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     provenance: string;
     roadNodeId: string;
-    classification: "highway" | "major_collector" | "minor_collector" | "residential" | "alley" | "gravel" | "unclassified";
+    classification: "alley" | "highway" | "major_collector" | "minor_collector" | "residential" | "gravel" | "unclassified";
     osmHighwayTag?: string | undefined;
     isPedestrianWay?: boolean | undefined;
 }, {
     provenance: string;
     roadNodeId: string;
-    classification: "highway" | "major_collector" | "minor_collector" | "residential" | "alley" | "gravel" | "unclassified";
+    classification: "alley" | "highway" | "major_collector" | "minor_collector" | "residential" | "gravel" | "unclassified";
     osmHighwayTag?: string | undefined;
     isPedestrianWay?: boolean | undefined;
 }>;
@@ -495,13 +495,13 @@ export declare const BOUNDARY_EDGE_SCHEMA: z.ZodObject<{
     }, "strict", z.ZodTypeAny, {
         provenance: string;
         roadNodeId: string;
-        classification: "highway" | "major_collector" | "minor_collector" | "residential" | "alley" | "gravel" | "unclassified";
+        classification: "alley" | "highway" | "major_collector" | "minor_collector" | "residential" | "gravel" | "unclassified";
         osmHighwayTag?: string | undefined;
         isPedestrianWay?: boolean | undefined;
     }, {
         provenance: string;
         roadNodeId: string;
-        classification: "highway" | "major_collector" | "minor_collector" | "residential" | "alley" | "gravel" | "unclassified";
+        classification: "alley" | "highway" | "major_collector" | "minor_collector" | "residential" | "gravel" | "unclassified";
         osmHighwayTag?: string | undefined;
         isPedestrianWay?: boolean | undefined;
     }>>;
@@ -625,7 +625,7 @@ export declare const BOUNDARY_EDGE_SCHEMA: z.ZodObject<{
     facingRoad: {
         provenance: string;
         roadNodeId: string;
-        classification: "highway" | "major_collector" | "minor_collector" | "residential" | "alley" | "gravel" | "unclassified";
+        classification: "alley" | "highway" | "major_collector" | "minor_collector" | "residential" | "gravel" | "unclassified";
         osmHighwayTag?: string | undefined;
         isPedestrianWay?: boolean | undefined;
     } | null;
@@ -722,7 +722,7 @@ export declare const BOUNDARY_EDGE_SCHEMA: z.ZodObject<{
     facingRoad: {
         provenance: string;
         roadNodeId: string;
-        classification: "highway" | "major_collector" | "minor_collector" | "residential" | "alley" | "gravel" | "unclassified";
+        classification: "alley" | "highway" | "major_collector" | "minor_collector" | "residential" | "gravel" | "unclassified";
         osmHighwayTag?: string | undefined;
         isPedestrianWay?: boolean | undefined;
     } | null;

package/dist/property/building-footprint.d.ts

@@ -359,7 +359,7 @@ export declare const BUILDING_FOOTPRINT_SCHEMA: z.ZodEffects<z.ZodObject<{
     atomTier: AtomTier;
     parcelNodeId: string;
     footprintId: string;
-    sourceTier: "cad-authoritative" | "ml-derived" | "absent";
+    sourceTier: "absent" | "cad-authoritative" | "ml-derived";
     asOf?: string | undefined;
     readContract?: Readonly<{
         axes: Readonly<{
@@ -434,7 +434,7 @@ export declare const BUILDING_FOOTPRINT_SCHEMA: z.ZodEffects<z.ZodObject<{
     atomTier: AtomTier;
     parcelNodeId: string;
     footprintId: string;
-    sourceTier: "cad-authoritative" | "ml-derived" | "absent";
+    sourceTier: "absent" | "cad-authoritative" | "ml-derived";
     asOf?: string | undefined;
     readContract?: Readonly<{
         axes: Readonly<{
@@ -509,7 +509,7 @@ export declare const BUILDING_FOOTPRINT_SCHEMA: z.ZodEffects<z.ZodObject<{
     atomTier: AtomTier;
     parcelNodeId: string;
     footprintId: string;
-    sourceTier: "cad-authoritative" | "ml-derived" | "absent";
+    sourceTier: "absent" | "cad-authoritative" | "ml-derived";
     asOf?: string | undefined;
     readContract?: Readonly<{
         axes: Readonly<{
@@ -584,7 +584,7 @@ export declare const BUILDING_FOOTPRINT_SCHEMA: z.ZodEffects<z.ZodObject<{
     atomTier: AtomTier;
     parcelNodeId: string;
     footprintId: string;
-    sourceTier: "cad-authoritative" | "ml-derived" | "absent";
+    sourceTier: "absent" | "cad-authoritative" | "ml-derived";
     asOf?: string | undefined;
     readContract?: Readonly<{
         axes: Readonly<{

package/dist/property/cad-parcel-roll.d.ts

@@ -374,7 +374,7 @@ export declare const CAD_PARCEL_ROLL_SCHEMA: z.ZodEffects<z.ZodObject<{
     };
     atomTier: AtomTier;
     parcelNodeId: string;
-    sourceTier: "cad-authoritative" | "absent";
+    sourceTier: "absent" | "cad-authoritative";
     taxYear: number;
     joinPassedOwnerMatchGate: boolean;
     asOf?: string | undefined;
@@ -461,7 +461,7 @@ export declare const CAD_PARCEL_ROLL_SCHEMA: z.ZodEffects<z.ZodObject<{
     };
     atomTier: AtomTier;
     parcelNodeId: string;
-    sourceTier: "cad-authoritative" | "absent";
+    sourceTier: "absent" | "cad-authoritative";
     taxYear: number;
     joinPassedOwnerMatchGate: boolean;
     asOf?: string | undefined;
@@ -548,7 +548,7 @@ export declare const CAD_PARCEL_ROLL_SCHEMA: z.ZodEffects<z.ZodObject<{
     };
     atomTier: AtomTier;
     parcelNodeId: string;
-    sourceTier: "cad-authoritative" | "absent";
+    sourceTier: "absent" | "cad-authoritative";
     taxYear: number;
     joinPassedOwnerMatchGate: boolean;
     asOf?: string | undefined;
@@ -635,7 +635,7 @@ export declare const CAD_PARCEL_ROLL_SCHEMA: z.ZodEffects<z.ZodObject<{
     };
     atomTier: AtomTier;
     parcelNodeId: string;
-    sourceTier: "cad-authoritative" | "absent";
+    sourceTier: "absent" | "cad-authoritative";
     taxYear: number;
     joinPassedOwnerMatchGate: boolean;
     asOf?: string | undefined;

package/dist/property/land-use-fact.d.ts

@@ -335,7 +335,7 @@ export declare const LAND_USE_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
     };
     atomTier: AtomTier;
     parcelNodeId: string;
-    sourceTier: "cad-authoritative" | "absent";
+    sourceTier: "absent" | "cad-authoritative";
     taxYear: number;
     asOf?: string | undefined;
     readContract?: Readonly<{
@@ -404,7 +404,7 @@ export declare const LAND_USE_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
     };
     atomTier: AtomTier;
     parcelNodeId: string;
-    sourceTier: "cad-authoritative" | "absent";
+    sourceTier: "absent" | "cad-authoritative";
     taxYear: number;
     asOf?: string | undefined;
     readContract?: Readonly<{
@@ -473,7 +473,7 @@ export declare const LAND_USE_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
     };
     atomTier: AtomTier;
     parcelNodeId: string;
-    sourceTier: "cad-authoritative" | "absent";
+    sourceTier: "absent" | "cad-authoritative";
     taxYear: number;
     asOf?: string | undefined;
     readContract?: Readonly<{
@@ -542,7 +542,7 @@ export declare const LAND_USE_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
     };
     atomTier: AtomTier;
     parcelNodeId: string;
-    sourceTier: "cad-authoritative" | "absent";
+    sourceTier: "absent" | "cad-authoritative";
     taxYear: number;
     asOf?: string | undefined;
     readContract?: Readonly<{

package/dist/property/owner-fact.d.ts

@@ -407,7 +407,7 @@ export declare const OWNER_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
     };
     atomTier: AtomTier;
     parcelNodeId: string;
-    sourceTier: "cad-authoritative" | "absent";
+    sourceTier: "absent" | "cad-authoritative";
     taxYear: number;
     asOf?: string | undefined;
     readContract?: Readonly<{
@@ -482,7 +482,7 @@ export declare const OWNER_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
     };
     atomTier: AtomTier;
     parcelNodeId: string;
-    sourceTier: "cad-authoritative" | "absent";
+    sourceTier: "absent" | "cad-authoritative";
     taxYear: number;
     asOf?: string | undefined;
     readContract?: Readonly<{
@@ -557,7 +557,7 @@ export declare const OWNER_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
     };
     atomTier: AtomTier;
     parcelNodeId: string;
-    sourceTier: "cad-authoritative" | "absent";
+    sourceTier: "absent" | "cad-authoritative";
     taxYear: number;
     asOf?: string | undefined;
     readContract?: Readonly<{
@@ -632,7 +632,7 @@ export declare const OWNER_FACT_SCHEMA: z.ZodEffects<z.ZodObject<{
     };
     atomTier: AtomTier;
     parcelNodeId: string;
-    sourceTier: "cad-authoritative" | "absent";
+    sourceTier: "absent" | "cad-authoritative";
     taxYear: number;
     asOf?: string | undefined;
     readContract?: Readonly<{

package/dist/property/road-node.d.ts

@@ -529,7 +529,7 @@ export declare const ROAD_NODE_SCHEMA: z.ZodObject<{
     countyFips: string;
     roadNodeId: string;
     osmWayId: number;
-    classification: "highway" | "major_collector" | "minor_collector" | "residential" | "alley" | "gravel" | "unclassified";
+    classification: "alley" | "highway" | "major_collector" | "minor_collector" | "residential" | "gravel" | "unclassified";
     centerline: {
         type: "LineString";
         coordinates: [number, number][];
@@ -613,7 +613,7 @@ export declare const ROAD_NODE_SCHEMA: z.ZodObject<{
     countyFips: string;
     roadNodeId: string;
     osmWayId: number;
-    classification: "highway" | "major_collector" | "minor_collector" | "residential" | "alley" | "gravel" | "unclassified";
+    classification: "alley" | "highway" | "major_collector" | "minor_collector" | "residential" | "gravel" | "unclassified";
     centerline: {
         type: "LineString";
         coordinates: [number, number][];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@empressaio/atom-contract",
-  "version": "1.31.0",
+  "version": "1.33.0",
   "description": "The typed-data substrate every Empressa atom satisfies: identity, context interface, composition declaration, and history anchoring. Peer to the Hauska SDK (`@hauska-sdk/*`); consumed directly by every product surface and MCP server.",
   "type": "module",
   "main": "./dist/index.js",
@@ -78,6 +78,10 @@
       "types": "./dist/access/index.d.ts",
       "import": "./dist/access/index.js"
     },
+    "./display": {
+      "types": "./dist/display/index.d.ts",
+      "import": "./dist/display/index.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [