@velinussage/locus-agent-skill 0.1.48 → 0.1.51

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velinussage/locus-agent-skill",
-  "version": "0.1.48",
+  "version": "0.1.51",
   "description": "Install the general Locus agent skill, the media-to-market photo/video location workflow, the surrounding-area purchase workflow, and the property-tax protest workflow for free, x402-paid, and MPP/Tempo-paid property context.",
   "type": "module",
   "bin": {

package/skill/locus-agent-tools/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: locus-agent-tools
 preamble-tier: 1
-version: 1.75.0
+version: 1.78.0
 description: Use for cited US place records — starting from an address, county, or directly from 1-5 photos or a short video — including parcels, zoning, permits, flood, drought and water supply, regional market/living briefs, meetings, budgets, audits, county data series, changes over time, and dynamic MCP event polling or signed webhooks.
 triggers:
   - start property search from image
@@ -46,7 +46,7 @@ triggers:
   - real estate webhook notifications
 allowed-tools: Bash Read AskUserQuestion
 license: MIT
-contentHash: 4a04f3f0c225
+contentHash: 0318559b599b
 ---
 
 # Locus Agent Capabilities
@@ -233,6 +233,14 @@ npx agentcash@latest fetch https://api.locus.report/api/locus-flood-zone \
 
 Install the Locus skill separately with `npx @velinussage/locus-agent-skill@latest add`. Use the free Locus MCP or the `POST /api/<tool_name>` routes first.
 
+**GET fallback for POST-restricted agent sandboxes:** Sandboxed web-fetch environments that can only issue `GET` requests can call any read-only free tool via `GET https://api.locus.report/tools/call?name=<tool_name>&address=<url_encoded_address>` (or `&arguments=<url_encoded_json>`) and `GET https://api.locus.report/api/<free_tool_name>?address=<url_encoded_address>`. Write/participation tools (`locus_request_coverage`, `locus_agent_feedback`) and paid endpoints remain `POST`-only.
+
+**Community, subdivision, HOA/CC&R, age-restriction, and non-PII ownership structure (`/api/locus_subdivision_profile`, `/api/locus_hoa_context`, `/api/locus_age_restriction_context`, `locus_parcel_lookup`):**
+- `locus_parcel_lookup` exposes non-PII structural ownership and tenure fields derived from the county roll (`ownershipEntityClass: "individual_or_joint" | "trust_or_estate" | "llc_or_lp" | "corporation" | "hoa_or_common_area" | "government_or_nonprofit" | "unknown"`, `coOwnerPattern`, `deedInstrumentType`, `subdivisionName`, `lastTransferDate`, `yearsSinceLastTransfer`, and `tenureCohort`) without exposing natural-person owner names on free or stored replay artifacts. Recorded situs addresses are public land records in all 50 states (state Address Confidentiality Program statutes such as NC G.S. 15C-8(h) bar substitute addresses on recorded deeds), whereas off-site mailing street addresses are never republished (`mailingDiffersFromSitus: boolean` and 2-letter `mailingState` only).
+- `/api/locus_subdivision_profile` aggregates parcel-roll and polygon metrics across a recorded subdivision, PUD, or condo regime (unit/parcel count, ownership-class mix, absentee share, holding-period median and cohorts, year-built cohorts, assessed-value quartiles, and common-area parcels).
+- `/api/locus_hoa_context` returns 50-state + DC statutory common-interest community rules (declaration amendment thresholds/ceilings such as UCIOA/NC/TX/CO 67%, rental-cap grandfathering and floors such as FL § 720.306(1)(h) and CA Civ. Code §§ 4740–4741, covenant voting arithmetic for a given unit count, common-area HOA entities from the roll, keyless IRS Form 990 EO BMF nonprofit filings, and county Register of Deeds pointers).
+- `/api/locus_age_restriction_context` evaluates federal HOPA (`42 U.S.C. § 3607(b)(2)` / `24 CFR §§ 100.300–100.308`) and state 55+ housing registries/zoning overlays against tax-roll senior/homestead exemption flags, explicitly distinguishing legally age-restricted 55+/62+ communities from naturally occurring older demographics (NORCs such as Fearrington Village, NC).
+
 Read the live challenge and ask before every payment. Keep the settlement receipt.
 
 For broad requests, start with the current bundles in the top-agent manifest. For exact lanes, use the full catalog. A paid entry has a free underscore route only when it publishes `dualFreeTool` or a free `counterparts[]` entry. Paid-only atomics do not. Free executor names use underscores (`locus_zoning`); paid REST slugs use hyphens (`locus-zoning`). Execute the entry's exact `callName`.
@@ -392,13 +400,13 @@ Use the exact JSON shapes below as safe defaults. If a tool also accepts `latitu
 | The question | Tool | Exact arguments | What it returns |
 |---|---|---|---|
 | Which endpoints fit this place and intent? | `locus_suggest_workflow` | `{ "place": "600 E 4th St, Charlotte, NC", "intent": "homebuyer_due_diligence" }` | Ranked free/paid endpoint plan, estimated costs, scope, reasons, and place-availability hints. Planning only; confirm with coverage tools. |
-| Which tools will return data here? | `locus_lane_availability` | `{ "place": "600 E 4th St, Charlotte, NC" }` | Jurisdiction, `lanes.national/local/varies/notCovered/degraded`, paid buy signals, warnings. |
-| Is this city/county/ZIP in source coverage? | `locus_coverage_check` | `{ "place": "Raleigh, NC" }` | Resolved jurisdiction, supported/partial/discovery status, verified sources, missing source gaps. |
+| Which tools will return data here? | `locus_lane_availability` | `{ "place": "600 E 4th St, Charlotte, NC" }` | Jurisdiction, `lanes.national/local/varies/notCovered/degraded`, paid buy signals, warnings, and `officialPortalPointers` (vetted county/statewide GIS, assessor, and recorder links when local lanes are uncovered). |
+| Is this city/county/ZIP in source coverage? | `locus_coverage_check` | `{ "place": "Raleigh, NC" }` | Resolved jurisdiction, supported/partial/discovery status, verified sources, missing source gaps, and `officialPortalPointers` (official assessor, GIS, recorder, permits, zoning, and statewide parcel portals for uncovered counties). |
 | What is the whole coverage registry? | `locus_coverage_map` | `{}` | Registry-level coverage inventory for tools and jurisdictions. |
 | Request coverage for a missing place | `locus_request_coverage` | `{ "place": "Park County, MT" }` | Acknowledgement and demand signal. No records. |
 | What helped or was confusing | `locus_agent_feedback` | `{ "kind": "ux_gap", "target": "locus_lane_availability", "summary": "The varies bucket is easy to treat as available" }` | Product note only. Summary up to 1,000 characters. Set `target` (aliases `tool`, `toolName`). Also `POST /feedback`. |
-| Inspect official source cards | `locus_source_card_check` | `{ "place": "Raleigh, NC" }` or `{ "jurisdiction": "us-nc-raleigh" }` or `{ "cardId": "us-nc-durham:permits" }` | Source-card status, provenance, endpoint, verification method, timestamp. |
-| Verify a citation URL | `locus_verify_citation` | `{ "sourceUrl": "https://...", "recordId": "optional", "jurisdiction": "optional" }` | Whether a citation matches a known source card, with provenance context. |
+| Inspect official source cards | `locus_source_card_check` | `{ "place": "Raleigh, NC" }` or `{ "jurisdiction": "us-nc-raleigh" }` or `{ "cardId": "us-nc-durham:permits", "verifyUrl": true, "asOf": "2026-09-01" }` | Source-card status, provenance, endpoint, verification method, timestamp, and optional `citationVerification` (`liveCheck` + Internet Archive Wayback CDX `waybackSnapshot` fallback when `verifyUrl: true`). |
+| Verify a citation URL | `locus_verify_citation` | `{ "sourceUrl": "https://...", "recordId": "optional", "jurisdiction": "optional", "asOf": "2026-09-01", "includeWaybackSnapshot": true }` | Whether a citation matches a known source card, with provenance context, live static-page reachability (`liveCheck`), and nearest Wayback Machine CDX snapshot (`waybackSnapshot` with `archiveUrl` and `capturedAt`) for rotted statutory or portal URLs. |
 | What policy sources govern here? | `locus_policy_sources` | `{ "place": "Raleigh, NC" }` or `{ "place": "Raleigh, NC", "liveSearch": true }` | State, county, city policy-source list, legal geographies, source links, and optional operator-enabled Gov-Index pointer discovery (`govIndex`). |
 | Read aggregate coverage demand | `locus_coverage_demand` | `{}` | Aggregate requested-coverage demand, not place records. |
 | Discover dynamic MCP real-estate events | `locus_mcp_events_catalog` | `{}` | Public MCP Events catalog: event names, parameter/payload summaries, delivery modes (`poll`, `webhook`), auth rules, and `skill://locus/subscribing-to-locus-events` pointer. |
@@ -499,15 +507,15 @@ Dual-rail routes (a paid `/api/locus-<tool>` with a free `locus_<tool>` counterp
 | `POST /api/locus-cmbs-loan-context` | `$0.10` | Lender, investor, or commercial-property owner needs this exact property's filed CMBS loan context, maturity, top-three lease expirations, and special-servicer transfer with its SEC filing. Publicly registered ABS-EE trusts only. | Not loaded, unresolved, out-of-coverage, unavailable, or no match returns `charged:false`; no match does not establish no loan. No appraisal, loan verdict, or recommendation. |
 | `POST /api/locus-cmbs-maturity-wall` | `$0.25` | County-level public CMBS balance and loan maturity timing by property type and special-servicer transfer, from the filed reporting period. Accepts an exact address or a five-digit county FIPS. | Missing/unavailable snapshot or unresolved county returns `charged:false`; coverage excludes non-filing loans. Never a property-level credit conclusion. |
 | `POST /api/locus-practitioner-read` | `$0.29` | Agent wants what an experienced land and property analyst reads into the public records for one address: which patterns are present (repeat transfers, permit with no closeout, flood zone next to county claims history, zoning headroom, soil limits, enacted vs pending ordinance), the record that confirms each, and one plain-language summary. Optional `question` sets the audience. | Flat price on every call; an empty reading set is still paid. The response's `catalogue` block says how many readings are currently evaluated vs gated off pending a slot adapter (gate list with reasons in `readingsNotEvaluated`). Readings are framings to test with a named confirming record, never findings; no value, no safe/unsafe, nothing about a person. `partial` names the record Locus does not carry (deed type, parcel-level liens, panel revision history). Unresolved address, engine outage, or a prose guardrail failure returns `charged:false`. |
-| `POST /api/locus-power-water-evidence-pack` | `$0.05` | Agent needs pre-development proximity/context from HIFLD/EIA power, EPA public-water-system, and FCC broadband sources. | Missing substantive evidence suppresses charge. Never claims capacity, interconnection, service availability, timing, or cost. |
+| `POST /api/locus-power-water-evidence-pack` | `$0.05` | Agent needs pre-development proximity/context from HIFLD/EIA power, OpenStreetMap linear ROW corridors (`electricityEvidence.osmLinearCorridors`), EPA public-water-system, and FCC broadband sources. | Missing substantive evidence suppresses charge. Never claims capacity, interconnection, service availability, recorded easement, timing, or cost. |
 | `POST /api/locus-landslide-diligence` | `$0.05` | Agent needs separate USGS documented inventory history and exact source-native n10 model-cell evidence. | Unless both components answer, returns `charged:false`. Never a probability, parcel stability finding, engineering assessment, or safety label. |
-| `POST /api/locus-permit-closeout-check` | `$0.05` | Agent needs exact-subject permit status plus source-published closeout or occupancy-document evidence. Registry coverage: Raleigh, unincorporated Wake County, Durham, Austin, Seattle, Chicago, Los Angeles, and New York City. It accepts an address or up to 25 jurisdiction-scoped `parcelIds`. The coverage label is generated from the source registry. | Uncovered, uncertain, unavailable, unpublished, and no-exact-match states are charge-suppressed. Not condition, compliance, suite/use permission, or closing approval. |
+| `POST /api/locus-permit-closeout-check` | `$0.05` | Agent needs exact-subject permit status plus source-published closeout or occupancy-document evidence. Registry coverage: Raleigh, unincorporated Wake County, Durham, Austin, Seattle, Chicago, Los Angeles, New York City, Philadelphia, and San Diego. It accepts an address or up to 25 jurisdiction-scoped `parcelIds`. The coverage label is generated from the source registry. | Uncovered, uncertain, unavailable, unpublished, and no-exact-match states are charge-suppressed. Not condition, compliance, suite/use permission, or closing approval. |
 | `POST /api/locus-transaction-follow-up` | `$0.10` | Agent needs one explicit homebuyer, land-investor, developer-predevelopment, commercial-tenant, or renovation-planning packet with cited handoffs. Prefer the dedicated `locus-renovation-site-context` route for renovation work because it fixes the profile server-side. | Profile-specific component/group thresholds control chargeability. Assessor totals never establish above-grade or finished-basement area. The result is not a feasibility, condition, drainage-design, permit-requirement, cost, or valuation conclusion. Thin evidence is charge-free. |
 | `POST /api/locus-property-tax-protest-packet` | `$0.89` | Homeowner or representative contesting a property-tax assessment needs one shareable evidence packet (cited JSON + self-contained printable HTML/PDF) bundling same-roll assessment uniformity (`locus-assessment-position`), recorded comparable sales (`locus-comps-brief`), optional proposed-figure protest comparison (`locus-valuation-challenge`), statutory appeal deadline rules, and filing portal pointers. Eligible for Stripe MPP (`method="stripe"`), Tempo MPP (`method="tempo"`), and Base/Solana x402. | Fewer than two resolved constituent lanes return `charged:false`. Descriptive percentile and recorded sales only; never an over-assessment verdict or legal/tax advice. |
 | `POST /api/locus-before-you-sign-dossier` | `$1.19` | Homebuyer or buyer's agent under contract needs one complete pre-signing dossier (cited JSON + self-contained printable HTML/PDF) bundling subject parcel identity and roll value, the immediate surrounding parcel ring, FEMA flood zone and mandatory-purchase rule, EPA TRI/RCRA/SDWIS environmental proximity, recorded comparable sales, and local legislative context. Eligible for Stripe MPP (`method="stripe"`), Tempo MPP (`method="tempo"`), and Base/Solana x402. | Fewer than two resolved constituent lanes return `charged:false`. Never an inspection, appraisal, title opinion, or purchase recommendation. |
 | `POST /api/locus-escrow-insurance-dossier` | `$0.89` | Homeowner facing an escrow payment jump or homeowners insurance nonrenewal needs one two-track action dossier (cited JSON + self-contained printable HTML/PDF) bundling `locus-owner-action-brief` (exemptions, tax calendar, appeal window, LOMA screen), `locus-assessment-position`, `locus-insurance-context` (FEMA flood rule, NFIP/ACS figures, rebuild proxy), state nonrenewal notice and FAIR Plan pointers, and federal RESPA 12-month shortage rules. Eligible for Stripe MPP (`method="stripe"`), Tempo MPP (`method="tempo"`), and Base/Solana x402. | Fewer than two resolved constituent lanes return `charged:false`. Never an insurance quote, servicer error finding, or legal/financial advice. |
 | `POST /api/locus-seller-readiness-packet` | `$0.85` | Seller or listing agent preparing to list needs one pre-listing verification and permit closeout packet (cited JSON + self-contained printable HTML/PDF) bundling `locus-permit-closeout-check`, municipal permit portal rules, county assessor roll baseline, state seller property disclosure statute pointers, municipal code cases, FEMA flood-map revision notices, and special district levies. Eligible for Stripe MPP (`method="stripe"`), Tempo MPP (`method="tempo"`), and Base/Solana x402. | Fewer than two resolved constituent lanes return `charged:false`. Never a compliance certificate, legal disclosure opinion, or inspection substitute. |
-| `POST /api/locus-entitlement-brief` | `$0.25` | Developer, land buyer, or agent needs one pre-engineering land entitlement and LiDAR drainage dossier (cited JSON + `drainageSvg` + self-contained printable `reportHtml`) bundling subject parcel and surrounding parcel ring, zoning and overlays, physical site constraints (`locus_site_constraints`), LiDAR DEM Priority-Flood D8 flow routing and cut/fill earthwork across candidate pads (`locus_lidar_drainage_profile`), water/sewer/road/DOT infrastructure, nearby rezoning and board milestones (`locus_entitlement_activity`), and open specialist verification questions. Supports Tempo MPP (`method="tempo"`) and Base/Solana x402. | Fewer than three resolved constituent lanes return `charged:false`. Never a go/no-go verdict, approval-odds prediction, or engineering certification. |
+| `POST /api/locus-entitlement-brief` | `$0.25` | Developer, land buyer, or agent needs one pre-engineering land entitlement and LiDAR drainage dossier (cited JSON + `drainageSvg` + self-contained printable `reportHtml`) bundling subject parcel and surrounding parcel ring, zoning and overlays, physical site constraints and OSM linear ROW corridors (`locus_site_constraints`), LiDAR DEM Priority-Flood D8 flow routing and cut/fill earthwork across candidate pads (`locus_lidar_drainage_profile`), water/sewer/road/DOT infrastructure, nearby rezoning and board milestones (`locus_entitlement_activity`), and open specialist verification questions. Supports Tempo MPP (`method="tempo"`) and Base/Solana x402. | Fewer than three resolved constituent lanes return `charged:false`. Never a go/no-go verdict, approval-odds prediction, or engineering certification. |
 | `POST /api/locus-media-locate` | `$0.05` | Agent has 1-5 photos (`mediaId`/`mediaIds` from `locus_media_upload_init` or `imageBase64`/`imagesBase64`) and needs to triangulate the US region (city, county or metro) via two-model vision (`gemini-3.8-flash` + `gemini-4-argon`), OCR signs, area codes, highway shields, and plate rules, plus ready-to-call `nextTools` (`livingThere`, `buyingThere`, `whatChangedNearby`). | `charged:false` on `low_confidence` (Tier C scenic look-alikes still return exploratory `candidates` and `nextTools` for free), `refused` (interior, person, private residence close-up), or `non_us`. Region only; never a street address, home, or person. |
 | `POST /api/locus-video-locate` | `$0.10` | Same two-model vision triangulation and `nextTools` for a short uploaded video clip (MP4/MOV up to 60 s via `mediaId`, `mediaType: "video"`). | `charged:false` on clips over 60 s (`duration_exceeded`), multi-location compilations, `low_confidence`, `refused`, or `non_us`. |
 | `POST /api/locus-media-to-market` | `$0.15` | One-call photo-to-market bundle: runs `locus-media-locate` (1-5 photos) and, when located with confidence, runs `locus_region_brief` (market, HUD rents, FHFA HPI, schools, drought/wildfire/flood/air hazards, unemployment) plus `nextTools`. | `charged:false` unless both the locate gate (`>=0.60` Tier A/B) and brief coverage gate (`>=3` sections including `market` or `hpi`) pass. |
@@ -645,9 +653,9 @@ These work for geocodable US addresses at no cost. Some accept address directly.
 | Mapped wetland overlap/proximity | `locus_wetland_context` | `{ "address": "...", "radiusMeters": 1500 }` | FWS NWI mapped-wetland overlap and nearby polygon evidence. Never a delineation, jurisdictional determination, parcel boundary, or permit decision. |
 | Dated LiDAR availability | `locus_3dep_availability` | `{ "address": "..." }` | National collection dates, USGS project metadata and NC state raster override. Catalog recency does not establish raster vintage. |
 | Elevation and sampled terrain | `locus_terrain_profile` | `{ "address": "..." }` or `{ "latitude": 35.22, "longitude": -80.84 }` | USGS EPQS/3DEP elevation plus sampled cardinal terrain profile/slopes. Never a survey, drainage, grading, or engineering conclusion. |
-| Physical site constraints composite | `locus_site_constraints` | `{ "address": "...", "radiusMeters": 250 }` or `{ "latitude": 35.72, "longitude": -79.18 }` | Unifies USGS terrain slope/relief, FEMA NFHL floodway/SFHA, USFWS NWI mapped wetlands, USDA SSURGO hydric/septic/shrink-swell/water-table/bedrock limits, and Chatham County NC watershed/stream/river corridor buffers where applicable. National baseline; not a wetland delineation, survey, perc test, or buildability determination. |
+| Physical site constraints composite | `locus_site_constraints` | `{ "address": "...", "radiusMeters": 250 }` or `{ "latitude": 35.72, "longitude": -79.18 }` | Unifies USGS terrain slope/relief, FEMA NFHL floodway/SFHA, USFWS NWI mapped wetlands, USDA SSURGO hydric/septic/shrink-swell/water-table/bedrock limits, Chatham County NC watershed/stream/river corridor buffers where applicable, OpenStreetMap linear ROW corridors (`linearCorridors`: transmission/distribution lines, pipelines, railways, and telecom trunks with ODbL non-easement caveats), US DOT/FHWA National Bridge Inventory structures (`nationalBridgesNearby`: clearances and load postings, never condition ratings), and FAA Special Use Airspace (`specialUseAirspace`: Prohibited `P` and Restricted `R` zones). National baseline; not a wetland delineation, survey, easement search, perc test, flight authorization, or buildability determination. |
 | LiDAR DEM drainage routing, cut/fill earthwork & multi-pad comparison | `locus_lidar_drainage_profile` | `{ "address": "...", "padHalfSizeFt": 75, "includeDeliverables": true }` | Fetches NC OneMap 3-ft LiDAR DEM03 GeoTIFF where covered or USGS 3DEP Float32 GeoTIFF/grid nationally, then runs Barnes (2014) Priority-Flood depression filling, D8 steepest-descent flow routing, upstream off-pad catchment walk, depression/low-spot extraction, least-squares guidance-plane earthwork (cut/fill cubic yards for tilted vs level pad), multi-pad candidate comparison (Center/East/North), and SSURGO + neighboring soil fallback, plus optional `drainageSvg` and interactive `reportHtml`. Planning-grade screen only, not a stamped civil design. |
-| Transportation-noise proximity facts | `locus_noise_proximity` | `{ "address": "..." }` or `{ "latitude": 35.22, "longitude": -80.84 }` | Straight-line proximity to public-use airports and mapped major-road/rail centerlines. No decibel estimate or quiet/loud/safe/unsafe label. |
+| Transportation-noise proximity facts | `locus_noise_proximity` | `{ "address": "..." }` or `{ "latitude": 35.22, "longitude": -80.84 }` | Straight-line proximity to public-use airports, mapped major-road/rail centerlines, and FAA Prohibited/Restricted Special Use Airspace (`specialUseAirspace`). No decibel estimate or quiet/loud/safe/unsafe label. |
 | Nearby places and amenities | `locus_nearby_places` | `{ "address": "...", "radiusMeters": 800 }` | OpenStreetMap nearby amenities/places with categories, distance, and OSM provenance. |
 | Nearest emergency services and utilities | `locus_public_utilities` | `{ "address": "...", "radiusMeters": 5000 }` | Nearest mapped OpenStreetMap fire station, hospital/clinic, police, fire hydrant, electric substation, and water tower with straight-line distances and counts. Hydrants/infrastructure are often unnamed and still reported. Mapped facility distances only, never a fire-protection rating, insurance determination, or safety verdict. |
 | County Medicare fee-for-service spending | `locus_medicare_spending` | `{ "address": "..." }` | Latest/prior CMS county aggregate: Original Medicare fee-for-service beneficiary count, actual and standardized per-capita payment, and standardized year-over-year change. Not a provider price, individual bill, premium, care-quality/access measure, health inference, score, or property signal. |
@@ -656,9 +664,9 @@ These work for geocodable US addresses at no cost. Some accept address directly.
 | Aggregate traffic-crash context | `locus_traffic_crash_context` | `{ "address": "...", "radiiMeters": [200, 500, 1000], "lookbackYears": 3 }` | Small-cell-suppressed police-reported crash counts by official severity and mode. Registry coverage: Chicago all-reported, Virginia reportable-threshold, North Carolina nonmotorist and K+A subsets kept separate, Pikes Peak region PPACG reportable-threshold records for 2020-2024, plus nationwide FARS fatal-only fallback. No raw rows, examples, exact points, party details, score, forecast, or place verdict. |
 | Landslide history + susceptibility context | `locus_landslide_context` | `{ "address": "...", "searchRadiusMeters": 1000 }` or `{ "latitude": 35.78, "longitude": -78.64 }` | USGS v3 bounded inventory point/polygon records plus a separately labeled exact source-native n10 90-meter cell where the active snapshot publishes one. Top-level `status` (`complete` \| `partial` \| `unavailable`), `partial`, `degradedComponents`, `historyState`, and `susceptibilityState` keep inventory no-match, model out-of-footprint, stale/unavailable snapshot, and source failure distinct. The 0–81 model value is not probability or parcel engineering. |
 | FEMA NFIP flood-insurance claims (county) | `locus_nfip_claims` | `{ "address": "..." }` or `{ "latitude": 25.76, "longitude": -80.19 }` | FEMA OpenFEMA NFIP redacted flood-insurance claims aggregated to the county: total claim count, total paid, year range, and top rated flood zones. Redacted (no address/PII), county-level historical fact, never a prediction or risk score. |
-| Historical wildfire perimeters | `locus_wildfire_history` | `{ "address": "..." }` or `{ "latitude": 38.6, "longitude": -122.5 }` | WFIGS interagency historical wildfire perimeters within about 5 miles: incident name, category, acres, discovery year. Realized-event records (complements the modeled `locus_wildfire_risk`); most non-Western points return none, an honest `out_of_coverage`. |
+| Historical and active wildfire perimeters | `locus_wildfire_history` | `{ "address": "..." }` or `{ "latitude": 38.6, "longitude": -122.5 }` | WFIGS interagency historical wildfire perimeters (~5 miles) plus current NIFC interagency perimeters (`activePerimeters` within ~10 miles: incident name, unique fire ID, acres, percent contained, discovery/current date, and currency-checked InciWeb link where matched). Realized-event records (complements the modeled `locus_wildfire_risk`); most non-Western points return none, an honest `out_of_coverage`. |
 | Soil context and site constraints | `locus_soil_context` | `{ "address": "..." }` or `{ "latitude": 35.9, "longitude": -78.9 }` | USDA NRCS SSURGO soil suitability at a point: NRCS engineering ratings (Very/Somewhat/Not limited, with limiting features) for dwellings, septic absorption fields, and shallow excavations, plus drainage, hydric, slope, shrink-swell (linear extensibility), taxonomic order, and farmland class. Soil-map-unit-level screening context for septic/foundation/drainage/buildability, never a geotechnical, perc-test, permit, or safe/unsafe/buildable verdict. Developed/urban points often return `out_of_coverage` (no soil component). |
-| Data-center or large-development watch prompts | `locus_data_center_watch` | `{ "address": "..." }` or `{ "state": "NC", "county": "Wake County", "municipality": "Raleigh" }` | Bounded official-source query pack and lead-discovery prompts for large projects, data centers, utility/water/planning sources. |
+| Data-center or large-development watch prompts | `locus_data_center_watch` | `{ "address": "..." }` or `{ "state": "NC", "county": "Wake County", "municipality": "Raleigh" }` | Bounded official-source query pack and lead-discovery prompts for large projects, data centers, utility/water/planning sources, plus deterministic `mappedOsmDataCenters` proximity (ODbL 1.0 crowd-mapped observation, non-official) when a coordinate or address is resolved. |
 | Local ordinance and storefront-process leads | `locus_ordinance_leads` | `{ "address": "...", "topics": ["occupancy", "fee_schedule", "signage", "sidewalk_cafe", "published_review_timeline"] }` or `{ "place": "Raleigh, NC", "liveSearch": true }` | Jurisdiction-locked first-party query pack, reviewed process pointers, and optional operator-enabled Gov-Index pointer discovery (`govIndex`). Numeric fees/timelines require an exact dated official source; published timelines are guidance, not predictions. Leads only, no restricted code body, not legal advice. |
 | Coastal county catalog | `locus_coastal_county_catalog` | `{}` or `{ "county": "new-hanover-nc" }` | Catalog of supported coastal source packs, overlays, source leads, and limitations. |
 
@@ -701,13 +709,13 @@ Temporarily degraded national tools may appear in `lanes.degraded` when an upstr
 | Property-fraud alert pointer | `locus_fraud_alert_pointer` | `{ "place": "Miami-Dade County, FL" }` | Cited local, state, and national title-protection rows in that order. If no local row is registered, neutral county-recorder search guidance follows those rows; it does not claim that the county operates an alert. |
 | Program dates | `locus_program_windows` | `{ "place": "Berkeley, CA", "asOf": "2026-09-02", "withinDays": 120 }` | Exact dates from matching registry rows, split into upcoming and recently passed windows through deterministic date filtering. |
 | Special valuation screen | `locus_special_valuation_screen` | `{ "address": "..." }` | The parcel's public acreage and land-use code plus cited state special-valuation, historic-incentive, and solar-exemption rows. It does not determine program status for the parcel. |
-| Area reported-crime context | `locus_area_incidents` | `{ "address": "...", "radiusMeters": 1000, "lookbackDays": 365 }` | Area-level or citywide reported-incident context where wired, plus caveats. No safety verdict. |
+| Area reported-crime context | `locus_area_incidents` | `{ "address": "...", "radiusMeters": 1000, "lookbackDays": 365 }` | Area-level or citywide reported-incident context where wired, plus `agencyParticipationMask` (`reportingAgency`, `coverageScope`, `nonParticipatingAgenciesInBbox`, and `coverageGapStatement` so municipal feeds are never misread as county-wide coverage) and caveats. No safety verdict. |
 | Recent 311 service requests | `locus_service_requests` | `{ "address": "...", "radiusMeters": 1000, "lookbackDays": 365 }` | Recent San Diego Get It Done request type, status, dates, and public location from the synced city feed. A service request is a report, not a verified condition, code violation, responsible-party finding, or complete account of local activity. |
 | Contractor licence roster | `locus_contractor_license_check` | `{ "state": "WA", "licenseNumber": "<number from bid or permit>" }` | Exact-number lookup only; no name search or licensee names/addresses. Official status, type, effective/expiry dates and source update time where wired. No-match is not proof of being unlicensed; confirm the current record and trade with the board before hiring or relying on recent work. No hiring or workmanship verdict. |
 | Rental registration, short-term licensing, or building enforcement | `locus_rental_registration_check` | `{ "address": "1531 Belmont Ave, Seattle, WA 98122" }` | Exact-building rows with `recordScope` set to long-term registration, short-term license, or enforcement-only. Excludes owner/contact/unit/narrative fields. A no-match is limited to the named dataset, not a compliance finding. |
 | NYC deed and mortgage index | `locus_nyc_recording_history` | `{ "address": "..." }` or `{ "bbl": "3079740028", "limit": 25 }` | Bounded ACRIS Legals and Master document index, dates, source-published amounts, citations, query horizon, and verify-next questions. No party or unit data and no title conclusion. |
 | Government planning meeting pointers | `locus_government_meetings` | `{ "jurisdiction": "us-ca-modesto" }` or `{ "jurisdiction": "us-nc-wake" }` | Free bounded Modesto Planning Commission and Wake County Planning Board dates and official links. No item extraction, parcel match, or final decision. |
-| Property-topic government agenda leads (REST-only; not an MCP tool) | `locus-legistar-property-meetings` | Paid x402 `POST /api/locus-legistar-property-meetings` with `{ "jurisdiction": "us-nc-chatham" }` | Five verified Legistar jurisdictions: Chatham County, Chapel Hill, Mecklenburg County, Denver, Seattle. $0.05 on a substantive result; inspect the live challenge and get payment approval first. A 30-minute cached scan inspects up to 10 meetings and 25 items per meeting in the requested month and returns generic topic labels with official links, not raw titles. A lead is not a parcel match, complete agenda, current meeting status, or final decision. |
+| Property-topic government agenda leads (REST-only; not an MCP tool) | `locus-legistar-property-meetings` | Paid x402 `POST /api/locus-legistar-property-meetings` with `{ "jurisdiction": "us-nc-chatham" }` | 38 verified Legistar jurisdictions across 18 states (including Chatham County, Chapel Hill, Mecklenburg County, Denver, Seattle, NYC, San Francisco, Chicago, Philadelphia, Oakland, San Jose, Sacramento, Dallas, Phoenix, Minneapolis, Milwaukee, Madison, Columbus, Tampa, Baltimore, and others; check live schema for full enum). $0.05 on a substantive result; inspect the live challenge and get payment approval first. A 30-minute cached scan inspects up to 10 meetings and 25 items per meeting in the requested month and returns generic topic labels with official links, not raw titles. A lead is not a parcel match, complete agenda, current meeting status, or final decision. |
 | Local legislation preview | `locus_local_legislation` | `{ "address": "...", "ownerActions": ["registration_required"], "domains": ["property_tax"] }` | Recent property-relevant legislation preview, status labels, source attribution. Oklahoma City and Las Vegas use PII-safe PrimeGov source pointers: Locus omits unstructured provider titles and the calling agent opens the cited item before describing it. Optional filters select the one headline before the cap. Not legal advice. |
 | Dated changes around one place | `locus_ownership_loop` | `{ "address": "...", "radiusMeters": 1500, "state": "NC", "countyFips3": "183", "zip": "27601" }` | Composite dated-change bundle across available ownership, tax, flood, transfer, and local lanes. |
 | Coastal overlays | `locus_coastal_county_overlays` | `{ "address": "..." }` or `{ "latitude": 34.22, "longitude": -77.88, "county": "auto" }` | Coastal hazard overlays, parcel/address facts, zoning/flood/wetland/resiliency context for supported coastal counties. |

package/skill/locus-land-entitlement/SKILL.md

@@ -2,7 +2,7 @@
 name: locus-land-entitlement
 description: Use when a developer, land buyer, builder, or agent needs a pre-engineering land entitlement, rezoning, subdivision, physical site-constraint, LiDAR drainage/earthwork, or utility-reach screen for a US parcel or address from cited Locus records without turning public records into a go/no-go verdict.
 preamble-tier: 2
-version: 1.0.0
+version: 1.2.0
 triggers:
   - land entitlement
   - rezoning feasibility
@@ -30,6 +30,7 @@ Produce a cited, pre-engineering land entitlement and physical site-constraints
 - Emit a `"go / no-go"` verdict, `"buildable / unbuildable"` label, `"likely to be approved"` score, or approval-odds prediction.
 - Treat a GIS water/sewer district polygon (`locus_utility_service_check`) as a utility will-serve letter, tap allocation, or moratorium clearance.
 - Treat planning-grade LiDAR DEM D8 drainage or least-squares cut/fill yardage (`locus_lidar_drainage_profile`) as a stamped civil grading plan, stormwater model, or ALTA survey.
+- Treat OpenStreetMap linear right-of-way (ROW) corridor geometry (`linearCorridors` on `locus_site_constraints` and `locus-entitlement-brief`) as a recorded utility easement, title encumbering instrument, or 811 underground locate.
 - Expose individual applicant, developer, or property-owner names on free paths.
 
 ---
@@ -55,12 +56,14 @@ Produce a cited, pre-engineering land entitlement and physical site-constraints
    - Call `locus_ordinance_leads` when the user needs jurisdiction-locked UDO dimensional, buffer, or review-timeline pointers.
 4. **Physical Site Constraints Screen (free):**
    - Call `locus_site_constraints` (`radiusMeters: 250`).
-   - Synthesize the five physical layers side by side:
+   - Synthesize the physical and linear-corridor layers side by side:
      - **Terrain (`locus_terrain_profile`):** center elevation, relief feet, max directional slope %, and `terrainClass`.
      - **Flood (`locus_flood_zone`):** FEMA NFHL zone, `isRegulatoryFloodway`, and `sfha` status.
      - **Wetlands (`locus_wetland_context`):** USFWS NWI point overlap and nearby wetland polygon distances.
      - **Soils (`locus_soil_context`):** USDA SSURGO map unit, `hydricRating`, `drainageClass`, shrink-swell class, `annualMinimumWaterTableDepth`, `shallowestBedrockDepth`, and septic absorption field rating.
      - **Watershed & Stream Buffers:** in Chatham County, NC, report `Chatham_WPReferenceLayers` hits (Jordan Lake 50-ft buffers, perennial/intermittent stream buffers, 100-ft river corridor, USGS blue-line streams, and 2,500-ft public water hazard buffers).
+     - **Linear ROW Corridors (`linearCorridors`):** OpenStreetMap Overpass screen (`power_transmission_or_distribution`, `pipeline`, `railway`, `telecom_trunk`) with `nearestByCategory`, `within100mCount`, and `within250mCount` (substations and point towers are excluded so linear ROW encroachments stay distinct from `locus_public_utilities`). Always state the ODbL caveat: mapped centerlines are crowd-sourced observations, not recorded easements or 811 locates.
+     - **Bridges & Special-Use Airspace (`nationalBridgesNearby`, `specialUseAirspace`):** US DOT/FHWA National Bridge Inventory structures near the parcel (vertical clearance and posted load status; condition ratings are never requested) plus FAA Prohibited (`P`) and Restricted (`R`) Special Use Airspace zones (altitude floor/ceiling, controlling agency, hours of use; informational only, not LAANC or flight authorization).
 5. **LiDAR DEM Drainage Routing, Cut/Fill Earthwork & Multi-Pad Comparison (free):**
    - Call `locus_lidar_drainage_profile` (`padHalfSizeFt: 75`, `includeDeliverables: true`).
    - Present the deterministic terrain findings: