@oga-mcp/server 1.0.0

package/dist/methodology-data.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Methodology snippets per dimension. Baked into the MCP server so
+ * `methodology_for` returns instant explanations without a network round-trip.
+ *
+ * Source of truth: https://www.onegoodarea.com/methodology
+ * Update this file when the methodology page changes — the engine version
+ * is stamped on every API response so a stale snippet here just means the
+ * MCP description lags real scoring by a release.
+ */
+export interface DimensionMethodology {
+    dimension: string;
+    intents: string[];
+    source: string;
+    summary: string;
+    weights: Record<string, number>;
+}
+export declare const METHODOLOGY: DimensionMethodology[];
+export declare const ENGINE: {
+    readonly version: "2.0.2";
+    readonly released: "2026-05-14";
+    readonly changelog: readonly [{
+        readonly version: "2.0.2";
+        readonly date: "2026-05-14";
+        readonly summary: "OpenStreetMap reliability hardening — Overpass timeout doubled, retry-once-with-jitter, errors now logged via logger.warn(). Resolves city-centre Transport NONE-confidence on Manchester/Birmingham/Edinburgh/Cardiff/York. Scoring formulas byte-identical to v2.0.1.";
+    }, {
+        readonly version: "2.0.1";
+        readonly date: "2026-05-14";
+        readonly summary: "Variance-aware property confidence rubric: HIGH now requires both >=50 transactions AND <=15% absolute YoY change. Resolves over-confident scores in central York and similar low-volume postcodes. No scoring formula changes.";
+    }, {
+        readonly version: "2.0.0";
+        readonly date: "2026-04-26";
+        readonly summary: "Confidence scoring per dimension. Engine version stamp on every response. Source attribution per signal. Confidence reasons explain WHY each dimension's data quality is what it is.";
+    }, {
+        readonly version: "1.x";
+        readonly date: "pre 2026-04-26";
+        readonly summary: "Initial deterministic scoring engine. 7 public datasets integrated. 4 preset compositions (formerly intents). LSOA-level scoring. JSON API.";
+    }];
+};
+/** Match a user's dimension query against the canonical names (case-insensitive, partial match). */
+export declare function findDimension(query: string): DimensionMethodology | null;

package/dist/methodology-data.js

@@ -0,0 +1,179 @@
+/**
+ * Methodology snippets per dimension. Baked into the MCP server so
+ * `methodology_for` returns instant explanations without a network round-trip.
+ *
+ * Source of truth: https://www.onegoodarea.com/methodology
+ * Update this file when the methodology page changes — the engine version
+ * is stamped on every API response so a stale snippet here just means the
+ * MCP description lags real scoring by a release.
+ */
+export const METHODOLOGY = [
+    {
+        dimension: "Safety & Crime",
+        intents: ["moving", "research"],
+        source: "Police.uk (last 3 months street-level crime data)",
+        summary: "Penalises rising crime, rewards falling crime, weights violent crime concentration. Benchmarked against the area's urban/suburban/rural classification so rural postcodes are not unfairly penalised against city-centre baselines.",
+        weights: { moving: 25, business: 15, investing: 15, research: 20 },
+    },
+    {
+        dimension: "Schools & Education",
+        intents: ["moving"],
+        source: "Ofsted inspection ratings (England), Estyn (Wales), Education Scotland (planned)",
+        summary: "School and educational facility density nearby with diminishing-returns curve. One Outstanding-rated school within 1.5km matters more than many middling ones further away.",
+        weights: { moving: 20, business: 0, investing: 10, research: 20 },
+    },
+    {
+        dimension: "Transport & Commute",
+        intents: ["moving", "business", "research"],
+        source: "OpenStreetMap (rail stations, bus stops, road network)",
+        summary: "Rail and bus connectivity combined into a single accessibility score. Benchmarked against area type so a rural postcode with 1 train station ranks higher than a city-centre postcode with 1 train station.",
+        weights: { moving: 20, business: 15, investing: 15, research: 20 },
+    },
+    {
+        dimension: "Daily Amenities",
+        intents: ["moving", "research"],
+        source: "OpenStreetMap (food/drink, healthcare, shops, parks/leisure, retail)",
+        summary: "Weighted composite across education, food and drink, healthcare, retail, and green spaces. Each category normalised against area-type benchmarks to avoid penalising rural areas with fewer amenities by absolute count.",
+        weights: { moving: 15, business: 0, investing: 10, research: 20 },
+    },
+    {
+        dimension: "Cost of Living",
+        intents: ["moving"],
+        source: "HM Land Registry sold prices (primary), IMD 2025 deprivation data (fallback)",
+        summary: "Uses Land Registry sold prices as the primary input. Scored as a ratio of local median to national median. Falls back to IMD deprivation deciles when Land Registry data is unavailable for the postcode area.",
+        weights: { moving: 20, business: 0, investing: 0, research: 0 },
+    },
+    {
+        dimension: "Foot Traffic & Demand",
+        intents: ["business"],
+        source: "OpenStreetMap (commercial activity density), transport connectivity",
+        summary: "Transport connectivity combined with commercial activity density. Strong rail, bus, and retail presence indicates higher natural footfall. Used by retail, F&B, and hospitality site-selection teams.",
+        weights: { business: 30 },
+    },
+    {
+        dimension: "Competition Density",
+        intents: ["business"],
+        source: "OpenStreetMap (existing commercial venues by category)",
+        summary: "Counts existing similar venues nearby. Lower density = less competitive saturation. Doesn't differentiate by venue size or quality — purely a density metric.",
+        weights: { business: 20 },
+    },
+    {
+        dimension: "Local Spending Power",
+        intents: ["business"],
+        source: "HM Land Registry, IMD 2025",
+        summary: "Combines property values with deprivation scores to estimate disposable income in the area. Higher spending power supports premium retail and F&B.",
+        weights: { business: 20 },
+    },
+    {
+        dimension: "Commercial Costs",
+        intents: ["business"],
+        source: "HM Land Registry (residential as proxy until commercial data lands)",
+        summary: "Estimates rent and leasehold cost using residential prices as a proxy. Inverted scoring: high cost = low score. Replace with commercial rent data when AR-134 (address-level) ships.",
+        weights: { business: 15 },
+    },
+    {
+        dimension: "Price Growth",
+        intents: ["investing"],
+        source: "HM Land Registry (5-year price history)",
+        summary: "Year-on-year median price growth over 5 years. Smoothed to avoid single-quarter spikes. Used by buy-to-let and build-to-rent operators to forecast capital appreciation.",
+        weights: { investing: 25 },
+    },
+    {
+        dimension: "Rental Yield",
+        intents: ["investing"],
+        source: "HM Land Registry (sold prices), VOA/Rightmove proxies (rent estimates)",
+        summary: "Annual gross rental income as a percentage of capital value. London-weighted benchmarks vs national. Below 4% = soft, 4-6% = market, above 6% = strong yield play.",
+        weights: { investing: 25 },
+    },
+    {
+        dimension: "Regeneration & Infrastructure",
+        intents: ["investing"],
+        source: "OpenStreetMap (construction/development markers), IMD 2025 (infrastructure indicators)",
+        summary: "Signals of imminent regeneration: new construction nearby, transport upgrades, low IMD score with rising property prices. Forward-looking indicator for capital appreciation.",
+        weights: { investing: 20 },
+    },
+    {
+        dimension: "Tenant Demand",
+        intents: ["investing"],
+        source: "IMD 2025, Police.uk (proxy via local density and stability)",
+        summary: "Estimates rental demand from population density, employment proxies via IMD, and historic crime stability. Weak proxy until address-level demographic data lands.",
+        weights: { investing: 15 },
+    },
+    {
+        dimension: "Risk Factors",
+        intents: ["investing"],
+        source: "Environment Agency (flood zones), Police.uk (crime stability)",
+        summary: "Flood risk zones, active flood warnings, crime trend volatility. Inverted scoring: more risk = lower score.",
+        weights: { investing: 15 },
+    },
+    {
+        dimension: "Transport Links",
+        intents: ["research"],
+        source: "OpenStreetMap",
+        summary: "Same as Transport & Commute but presented as a neutral baseline metric for the research intent (no decision-side weighting).",
+        weights: { research: 20 },
+    },
+    {
+        dimension: "Amenities & Services",
+        intents: ["research"],
+        source: "OpenStreetMap",
+        summary: "Same composite as Daily Amenities but presented neutrally for the research intent.",
+        weights: { research: 20 },
+    },
+    {
+        dimension: "Demographics & Economy",
+        intents: ["research"],
+        source: "IMD 2025 (England), WIMD 2019 (Wales), SIMD 2020 (Scotland)",
+        summary: "Official deprivation indices. Maps decile ranking to a 0-100 score that reflects the socioeconomic profile of the neighbourhood. Decile 1 = most deprived, decile 10 = least deprived.",
+        weights: { research: 20 },
+    },
+    {
+        dimension: "Environment & Quality",
+        intents: ["research"],
+        source: "Environment Agency, OpenStreetMap (green space)",
+        summary: "Combines flood risk zones, active flood warnings, and green space availability. Areas with no flood risk and good park access score highest.",
+        weights: { research: 20 },
+    },
+];
+/* AR-364: bumped to v2.0.2 (the live engine version). The MCP's static
+   snapshot is intentionally a fallback — the score_postcode tool already
+   echoes the live engine_version from each response. A future story
+   (S3) should make engine_version read the live value from the /me
+   startup call rather than this constant. */
+export const ENGINE = {
+    version: "2.0.2",
+    released: "2026-05-14",
+    changelog: [
+        {
+            version: "2.0.2",
+            date: "2026-05-14",
+            summary: "OpenStreetMap reliability hardening — Overpass timeout doubled, retry-once-with-jitter, errors now logged via logger.warn(). Resolves city-centre Transport NONE-confidence on Manchester/Birmingham/Edinburgh/Cardiff/York. Scoring formulas byte-identical to v2.0.1.",
+        },
+        {
+            version: "2.0.1",
+            date: "2026-05-14",
+            summary: "Variance-aware property confidence rubric: HIGH now requires both >=50 transactions AND <=15% absolute YoY change. Resolves over-confident scores in central York and similar low-volume postcodes. No scoring formula changes.",
+        },
+        {
+            version: "2.0.0",
+            date: "2026-04-26",
+            summary: "Confidence scoring per dimension. Engine version stamp on every response. Source attribution per signal. Confidence reasons explain WHY each dimension's data quality is what it is.",
+        },
+        {
+            version: "1.x",
+            date: "pre 2026-04-26",
+            summary: "Initial deterministic scoring engine. 7 public datasets integrated. 4 preset compositions (formerly intents). LSOA-level scoring. JSON API.",
+        },
+    ],
+};
+/** Match a user's dimension query against the canonical names (case-insensitive, partial match). */
+export function findDimension(query) {
+    const q = query.toLowerCase().trim();
+    // Exact match first
+    const exact = METHODOLOGY.find((d) => d.dimension.toLowerCase() === q);
+    if (exact)
+        return exact;
+    // Substring match (e.g. "safety" matches "Safety & Crime")
+    return METHODOLOGY.find((d) => d.dimension.toLowerCase().includes(q)) ?? null;
+}
+//# sourceMappingURL=methodology-data.js.map

package/dist/methodology-data.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+/**
+ * OneGoodArea MCP server — entry point.
+ *
+ * Exposes the OneGoodArea engine as MCP tools so Claude Desktop / Cursor /
+ * any MCP-compatible client can score UK areas inline.
+ *
+ * Auth: reads OOGA_API_KEY from env (the customer's API key from
+ * https://www.onegoodarea.com/dashboard). Keys start with `oga_`.
+ *
+ * Base URL: defaults to https://onegoodarea.onrender.com (the live API).
+ * Override via OOGA_API_BASE env (useful for local dev against
+ * `cd apps/api && npm run dev`).
+ *
+ * Run via npx: `npx @oga-mcp/server`
+ *
+ * Claude Desktop config example:
+ *   {
+ *     "mcpServers": {
+ *       "onegoodarea": {
+ *         "command": "npx",
+ *         "args": ["-y", "@oga-mcp/server"],
+ *         "env": { "OOGA_API_KEY": "oga_..." }
+ *       }
+ *     }
+ *   }
+ */
+export {};

package/dist/server.js

@@ -0,0 +1,173 @@
+#!/usr/bin/env node
+/**
+ * OneGoodArea MCP server — entry point.
+ *
+ * Exposes the OneGoodArea engine as MCP tools so Claude Desktop / Cursor /
+ * any MCP-compatible client can score UK areas inline.
+ *
+ * Auth: reads OOGA_API_KEY from env (the customer's API key from
+ * https://www.onegoodarea.com/dashboard). Keys start with `oga_`.
+ *
+ * Base URL: defaults to https://onegoodarea.onrender.com (the live API).
+ * Override via OOGA_API_BASE env (useful for local dev against
+ * `cd apps/api && npm run dev`).
+ *
+ * Run via npx: `npx @oga-mcp/server`
+ *
+ * Claude Desktop config example:
+ *   {
+ *     "mcpServers": {
+ *       "onegoodarea": {
+ *         "command": "npx",
+ *         "args": ["-y", "@oga-mcp/server"],
+ *         "env": { "OOGA_API_KEY": "oga_..." }
+ *       }
+ *     }
+ *   }
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { OogaApiClient } from "./api-client.js";
+import { scorePostcodeToolDef, scorePostcodeToolName, parseScorePostcodeArgs, executeScorePostcode, } from "./tools/score-postcode.js";
+import { comparePostcodesToolDef, comparePostcodesToolName, parseComparePostcodesArgs, executeComparePostcodes, } from "./tools/compare-postcodes.js";
+import { methodologyForToolDef, methodologyForToolName, parseMethodologyForArgs, executeMethodologyFor, } from "./tools/methodology-for.js";
+import { engineVersionToolDef, engineVersionToolName, executeEngineVersion, } from "./tools/engine-version.js";
+import { getAreaSignalsToolDef, getAreaSignalsToolName, parseGetAreaSignalsArgs, executeGetAreaSignals, } from "./tools/get-area-signals.js";
+import { getSignalsByCategoryToolDef, getSignalsByCategoryToolName, parseGetSignalsByCategoryArgs, executeGetSignalsByCategory, } from "./tools/get-signals-by-category.js";
+import { findAreasToolDef, findAreasToolName, parseFindAreasArgs, executeFindAreas, } from "./tools/find-areas.js";
+import { findPeersToolDef, findPeersToolName, parseFindPeersArgs, executeFindPeers, } from "./tools/find-peers.js";
+import { watchPortfolioToolDef, watchPortfolioToolName, parseWatchPortfolioArgs, executeWatchPortfolio, } from "./tools/watch-portfolio.js";
+import { getPortfolioChangesToolDef, getPortfolioChangesToolName, parseGetPortfolioChangesArgs, executeGetPortfolioChanges, } from "./tools/get-portfolio-changes.js";
+import { areaBriefToolDef, areaBriefToolName, parseAreaBriefArgs, executeAreaBrief, } from "./tools/area-brief.js";
+const SERVER_VERSION = "1.0.0";
+function readApiKey() {
+    const key = process.env.OOGA_API_KEY;
+    if (!key) {
+        process.stderr.write("[oga-mcp] Missing OOGA_API_KEY env var. Get one at https://www.onegoodarea.com/dashboard\n");
+        process.exit(1);
+    }
+    if (!key.startsWith("oga_")) {
+        process.stderr.write(`[oga-mcp] OOGA_API_KEY looks malformed (expected to start with 'oga_'). Got prefix: ${key.slice(0, 4)}\n`);
+        process.exit(1);
+    }
+    return key;
+}
+async function checkMcpAccess(client) {
+    // Skip the entitlement check if explicitly disabled (e.g. for local dev
+    // before the /v1/me endpoint is deployed). Production should never
+    // set this — it's a developer escape hatch.
+    if (process.env.OOGA_SKIP_ENTITLEMENT_CHECK === "1") {
+        process.stderr.write("[oga-mcp] OOGA_SKIP_ENTITLEMENT_CHECK=1 — skipping /me check\n");
+        return;
+    }
+    let me;
+    try {
+        me = await client.me();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`[oga-mcp] Could not verify entitlement at /v1/me: ${msg}\n`);
+        process.stderr.write(`[oga-mcp] Check OOGA_API_KEY is valid and OOGA_API_BASE is reachable.\n`);
+        process.exit(1);
+    }
+    if (!me.mcp_access) {
+        process.stderr.write(`[oga-mcp] Your plan (${me.plan_name}) does not include MCP access.\n` +
+            `[oga-mcp] MCP is included free on Growth (£1,499/mo) and Enterprise tiers.\n` +
+            `[oga-mcp] On Sandbox / Starter / Build / Scale you can purchase the £29/mo MCP add-on.\n` +
+            `[oga-mcp] Upgrade or add MCP at https://www.onegoodarea.com/pricing\n`);
+        process.exit(1);
+    }
+    process.stderr.write(`[oga-mcp] Entitlement OK · plan: ${me.plan_name} · engine: ${me.engine_version}\n`);
+}
+async function main() {
+    const apiKey = readApiKey();
+    const baseUrl = process.env.OOGA_API_BASE;
+    const client = new OogaApiClient({ apiKey, baseUrl });
+    // Fail fast if customer's plan doesn't include MCP access.
+    await checkMcpAccess(client);
+    const server = new Server({
+        name: "onegoodarea",
+        version: SERVER_VERSION,
+    }, {
+        capabilities: { tools: {} },
+    });
+    // 11 tools: score_postcode, compare_postcodes, get_area_signals,
+    // get_signals_by_category, find_areas, find_peers, watch_portfolio,
+    // get_portfolio_changes, area_brief (network); methodology_for,
+    // engine_version (static lookup, no network).
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [
+            scorePostcodeToolDef,
+            comparePostcodesToolDef,
+            getAreaSignalsToolDef,
+            getSignalsByCategoryToolDef,
+            findAreasToolDef,
+            findPeersToolDef,
+            watchPortfolioToolDef,
+            getPortfolioChangesToolDef,
+            areaBriefToolDef,
+            methodologyForToolDef,
+            engineVersionToolDef,
+        ],
+    }));
+    // Dispatch on tool name. Each tool owns its own arg parsing + execution.
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        const { name, arguments: args } = req.params;
+        if (name === scorePostcodeToolName) {
+            const parsed = parseScorePostcodeArgs(args);
+            return executeScorePostcode(client, parsed);
+        }
+        if (name === comparePostcodesToolName) {
+            const parsed = parseComparePostcodesArgs(args);
+            return executeComparePostcodes(client, parsed);
+        }
+        if (name === getAreaSignalsToolName) {
+            const parsed = parseGetAreaSignalsArgs(args);
+            return executeGetAreaSignals(client, parsed);
+        }
+        if (name === getSignalsByCategoryToolName) {
+            const parsed = parseGetSignalsByCategoryArgs(args);
+            return executeGetSignalsByCategory(client, parsed);
+        }
+        if (name === findAreasToolName) {
+            const parsed = parseFindAreasArgs(args);
+            return executeFindAreas(client, parsed);
+        }
+        if (name === findPeersToolName) {
+            const parsed = parseFindPeersArgs(args);
+            return executeFindPeers(client, parsed);
+        }
+        if (name === watchPortfolioToolName) {
+            const parsed = parseWatchPortfolioArgs(args);
+            return executeWatchPortfolio(client, parsed);
+        }
+        if (name === getPortfolioChangesToolName) {
+            const parsed = parseGetPortfolioChangesArgs(args);
+            return executeGetPortfolioChanges(client, parsed);
+        }
+        if (name === areaBriefToolName) {
+            const parsed = parseAreaBriefArgs(args);
+            return executeAreaBrief(client, parsed);
+        }
+        if (name === methodologyForToolName) {
+            const parsed = parseMethodologyForArgs(args);
+            return executeMethodologyFor(parsed);
+        }
+        if (name === engineVersionToolName) {
+            return executeEngineVersion();
+        }
+        return {
+            content: [{ type: "text", text: `Unknown tool: ${name}` }],
+            isError: true,
+        };
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write(`[oga-mcp] v${SERVER_VERSION} listening on stdio (api: ${baseUrl ?? "https://onegoodarea.onrender.com"})\n`);
+}
+main().catch((err) => {
+    process.stderr.write(`[oga-mcp] Fatal: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/area-brief-audiences.d.ts

@@ -0,0 +1,40 @@
+/**
+ * AR-369: AUDIENCES config for `area_brief`. The marquee composite tool
+ * shapes its output by audience: lender, insurer, retailer, investor.
+ *
+ * Each entry says:
+ *   - which scoring preset to call /v1/score?explain=true with
+ *   - which dimension labels to emphasise in the brief
+ *   - which raw signal keys to highlight, grouped by section
+ *
+ * Server-side narrative policy: nothing here invents prose. Every
+ * "highlight" is just selection — which real field from the response
+ * renders in which section. The score's `summary`, `recommendations`,
+ * per-dimension `reasoning` + `confidence_reason` all come from the
+ * engine; the audience config decides *which* of them surface.
+ */
+import type { Preset } from "../api-client.js";
+export type Audience = "lender" | "insurer" | "retailer" | "investor";
+export declare const AUDIENCES: Audience[];
+export interface BriefSection {
+    /** Section heading shown in the markdown output. */
+    title: string;
+    /** Dimension labels (from the score response) to render in this section,
+        in order. Labels match what the engine emits in `dimensions[].label`. */
+    dimensions: string[];
+    /** Raw signal keys (from the /v1/area catalog) to render in this section,
+        in order. */
+    signals: string[];
+}
+export interface AudienceConfig {
+    audience: Audience;
+    /** Display label for the brief header. */
+    label: string;
+    /** One-line description of who this brief is for. */
+    framing: string;
+    /** Which scoring preset feeds the overall verdict. */
+    preset: Preset;
+    /** Ordered sections after the verdict block. */
+    sections: BriefSection[];
+}
+export declare function getAudienceConfig(audience: Audience): AudienceConfig;

package/dist/tools/area-brief-audiences.js

@@ -0,0 +1,131 @@
+/**
+ * AR-369: AUDIENCES config for `area_brief`. The marquee composite tool
+ * shapes its output by audience: lender, insurer, retailer, investor.
+ *
+ * Each entry says:
+ *   - which scoring preset to call /v1/score?explain=true with
+ *   - which dimension labels to emphasise in the brief
+ *   - which raw signal keys to highlight, grouped by section
+ *
+ * Server-side narrative policy: nothing here invents prose. Every
+ * "highlight" is just selection — which real field from the response
+ * renders in which section. The score's `summary`, `recommendations`,
+ * per-dimension `reasoning` + `confidence_reason` all come from the
+ * engine; the audience config decides *which* of them surface.
+ */
+export const AUDIENCES = ["lender", "insurer", "retailer", "investor"];
+/** Lender (residential mortgage origination): preset=moving. Focused on
+    affordability, borrower-side risk, and long-term value retention. */
+const LENDER = {
+    audience: "lender",
+    label: "Lender brief",
+    framing: "Residential mortgage origination — affordability, borrower-side risk, and long-term value retention.",
+    preset: "moving",
+    sections: [
+        {
+            title: "Affordability & cost",
+            dimensions: ["Cost of Living"],
+            signals: ["property.median_price", "property.price_change_pct", "property.transaction_count"],
+        },
+        {
+            title: "Borrower-side risk",
+            dimensions: ["Safety", "Safety & Crime"],
+            signals: ["crime.total_12m", "crime.monthly_rate", "environment.flood_areas_nearby", "environment.active_flood_warnings"],
+        },
+        {
+            title: "Long-term value drivers",
+            dimensions: ["Transport", "Transport & Commute", "Schools", "Schools & Education"],
+            signals: ["schools.rated_count", "schools.good_or_outstanding_pct", "transport.stations", "transport.bus_stops"],
+        },
+    ],
+};
+/** Insurer (property risk underwriting): preset=investing (still risk-aware).
+    Focused on physical hazards + crime + building stock signals. */
+const INSURER = {
+    audience: "insurer",
+    label: "Insurer brief",
+    framing: "Property risk underwriting — physical hazards, crime profile, and replacement-cost signals.",
+    preset: "investing",
+    sections: [
+        {
+            title: "Physical hazard",
+            dimensions: ["Risk Factors"],
+            signals: ["environment.flood_areas_nearby", "environment.active_flood_warnings"],
+        },
+        {
+            title: "Crime profile",
+            dimensions: ["Safety", "Safety & Crime"],
+            signals: ["crime.total_12m", "crime.monthly_rate"],
+        },
+        {
+            title: "Building stock & market signals",
+            dimensions: ["Price Growth"],
+            signals: ["property.median_price", "property.transaction_count", "property.price_change_pct"],
+        },
+    ],
+};
+/** Retailer (commercial site selection): preset=business. Focused on
+    catchment demand, competition, access, and commercial costs. */
+const RETAILER = {
+    audience: "retailer",
+    label: "Retailer brief",
+    framing: "Commercial site selection — catchment demand, competition, access, and commercial costs.",
+    preset: "business",
+    sections: [
+        {
+            title: "Footfall & spending power",
+            dimensions: ["Foot Traffic", "Local Spending Power", "Spending Power"],
+            signals: ["amenities.total", "amenities.restaurants_cafes", "amenities.shops"],
+        },
+        {
+            title: "Competition",
+            dimensions: ["Competition", "Competition Density"],
+            signals: ["amenities.shops", "amenities.pubs_bars", "amenities.restaurants_cafes"],
+        },
+        {
+            title: "Access",
+            dimensions: ["Transport", "Transport Access"],
+            signals: ["transport.stations", "transport.bus_stops"],
+        },
+        {
+            title: "Commercial costs",
+            dimensions: ["Commercial Costs"],
+            signals: ["property.median_price"],
+        },
+    ],
+};
+/** Investor (residential investment): preset=investing. Focused on yield,
+    growth, demand pressure, and risk discount. */
+const INVESTOR = {
+    audience: "investor",
+    label: "Investor brief",
+    framing: "Residential investment — yield, growth, demand pressure, and risk discount.",
+    preset: "investing",
+    sections: [
+        {
+            title: "Yield & growth",
+            dimensions: ["Price Growth", "Rental Yield"],
+            signals: ["property.median_price", "property.price_change_pct", "property.transaction_count"],
+        },
+        {
+            title: "Demand pressure",
+            dimensions: ["Tenant Demand", "Regeneration", "Regeneration & Infrastructure"],
+            signals: ["amenities.total", "transport.stations", "transport.bus_stops"],
+        },
+        {
+            title: "Risk discount",
+            dimensions: ["Risk Factors"],
+            signals: ["crime.total_12m", "environment.flood_areas_nearby", "environment.active_flood_warnings"],
+        },
+    ],
+};
+const BY_AUDIENCE = {
+    lender: LENDER,
+    insurer: INSURER,
+    retailer: RETAILER,
+    investor: INVESTOR,
+};
+export function getAudienceConfig(audience) {
+    return BY_AUDIENCE[audience];
+}
+//# sourceMappingURL=area-brief-audiences.js.map

package/dist/tools/area-brief-audiences.js.map

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

package/dist/tools/area-brief-format.d.ts

@@ -0,0 +1,15 @@
+/**
+ * AR-369: Render an audience-shaped brief from a real AreaProfile +
+ * ScoreResponse (?explain=true). Server-side-narrative policy:
+ *
+ *   - The `summary`, `dimensions[].reasoning`, `dimensions[].confidence_reason`,
+ *     `recommendations[]`, and `data_sources[]` come straight from
+ *     /v1/score?explain=true (server-composed in AR-363).
+ *   - The per-signal `confidence_reason`, `value`, `unit`, `percentile`,
+ *     `source`, `observed_period` come straight from /v1/area (engine output).
+ *   - This module SELECTS which of those fields render in which section
+ *     based on the AudienceConfig. It does NOT invent prose.
+ */
+import type { OogaAreaProfile, OogaScoreResponse } from "../api-client.js";
+import type { AudienceConfig } from "./area-brief-audiences.js";
+export declare function formatAreaBriefAsText(audience: AudienceConfig, profile: OogaAreaProfile, score: OogaScoreResponse): string;