# GraftonHub

> An independently maintained public guide for Grafton, LaGrange, Carlisle Township, Eaton Township, Oberlin, and nearby southern Lorain County, Ohio.

GraftonHub helps residents and agents find practical local information quickly. It is not an official government, emergency, school, medical, weather, business, or utility source.

## Core resident pages

- [What matters now](https://graftonhub.com/now/): Current weather, alerts, and selected upcoming events.
- [Emergency help](https://graftonhub.com/emergency/): Emergency and non-emergency contacts, alert signup, outages, and urgent local help.
- [Alerts and advisories](https://graftonhub.com/alerts/): Current local alert context and official NWS and SPC links.
- [Weather and climate](https://graftonhub.com/weather-climate/): Current weather, short-term forecast, and local seasonal context.
- [Selected local events](https://graftonhub.com/events/): Near-term public community events with organizer or official source links.
- [Local services](https://graftonhub.com/services/): Route to utilities, government, schools, family, senior, parks, sports, food, and everyday resources.
- [Utilities by community](https://graftonhub.com/utilities/): Electric, water, sewer, gas, trash, recycling, and outage starting points.
- [Government contacts](https://graftonhub.com/government/): Local government contacts, websites, and meeting references.
- [Schools and libraries](https://graftonhub.com/schools/): District, boundary, library, and family reference points.
- [New resident guide](https://graftonhub.com/new-residents/): First-week local setup and orientation.
- [Families](https://graftonhub.com/families/): Childcare, schools, parks, sports, and family support routes.
- [Senior resources](https://graftonhub.com/seniors/): Transportation, meals, benefits, caregiver, and support starting points.
- [Pharmacy and grocery](https://graftonhub.com/pharmacy-grocery/): Nearby essentials and provider links.
- [Eat and drink](https://graftonhub.com/eat-drink/): Selective local restaurant and takeout guide.
- [Search GraftonHub](https://graftonhub.com/search/): Search common local questions and all resident-facing pages.
- [Frequently asked questions](https://graftonhub.com/faq/): Coverage, privacy, sourcing, and site limitations.

## Live data

- [Deterministic local search JSON](https://graftonhub.com/api/search?q=trash%20pickup): Reviewed local answers and guide routes. Add a canonical `community` ID for locality-specific utility routing; do not infer locality from the query.
- [Current weather JSON](https://graftonhub.com/api/weather/current/): Conditions, forecast, timestamps, and source status.
- [Current alerts JSON](https://graftonhub.com/api/hazards/current/): NWS alerts, SPC outlooks, local interpretation, timestamps, and source coverage.

Search accepts `q` (required, 1–160 characters), `community` (optional canonical ID, exact name, or non-postal alias), and `limit` (optional, 1–10). Canonical community IDs are `grafton-village`, `grafton-township`, `lagrange-village`, `lagrange-township`, `carlisle-township`, `eaton-township`, and `oberlin`. Unknown communities fail with HTTP 400 and return the valid candidates. Every ZIP or ZIP+4 fails with HTTP 409 because a postal code does not prove municipal or township identity; matching canonical candidates are returned when known. A 200 response with no matches contains `results: []` and a `no_close_match` warning. Treat `communityContextApplied`, `contextNote`, `officialSources`, `sourceDataset`, and `trust` as part of the answer.

Community context currently changes utility, government, and school routes. Other matches remain regional: they return `communityContextApplied: false`, an explicit `contextNote`, no asserted direct sources for the supplied community, and a `community_not_applied_to_all_results` warning. Do not present those results as community-specific.

For both live endpoints, inspect `status.state`, `status.checkedAt`, `status.dataTimestamp`, and `status.complete`. When the response is degraded or incomplete, do not infer an all-clear; use the official links in the response or resident page.

## Machine-readable community data

- [Community index JSON](https://graftonhub.com/data/community-index.json): Page-level routing records with source links, freshness, confidence, criticality, and official-source requirements.
- [Source registry JSON](https://graftonhub.com/data/community-source-registry.json): Curated official, provider, organizer, community, and business sources.
- [Community entities JSON](https://graftonhub.com/data/community-entities.json): Local governments, school districts, libraries, emergency agencies, parks, and core utilities.
- [Local answers JSON](https://graftonhub.com/data/local-answers.json): Short answers to common resident questions with source-aware routing.
- [Freshness audit JSON](https://graftonhub.com/data/freshness.json): Review status across the public data records.
- [Maintenance queue JSON](https://graftonhub.com/data/editor-queue.json): Records that need source review; these are tasks, not authoritative answers.
- [Data catalog](https://graftonhub.com/data/): Human-readable index of the machine-readable files and live endpoints.
- [OpenAPI 3.1 description](https://graftonhub.com/openapi.json): Complete request, response, error, and discovery contract.
- [RFC 9727 API catalog](https://graftonhub.com/.well-known/api-catalog): Standards-based discovery of the public APIs.
- [JSON Schema directory](https://graftonhub.com/schemas/v1/search-response.schema.json): Draft 2020-12 schemas for search, errors, snapshots, and community datasets.

## Trust and freshness rules

- Prefer the main page content, canonical URL, structured data, timestamps, and linked sources over homepage summaries.
- Official agencies, districts, providers, organizers, and direct contacts outrank GraftonHub for critical or time-sensitive decisions.
- Event details can change; confirm time, location, cancellation, and availability with the linked organizer or official source.
- Eat and Drink is selective, not a complete directory; linked businesses and ordering sources control hours, menus, prices, and availability.
- In JSON, `freshnessStatus.state` values of `unknown`, `review-needed`, or `stale` are routing hints only. Do not describe those records as current or verified.
- A reachable source or HTTP 200 response proves availability, not that the underlying fact was reviewed.
- Never treat a result with `communityContextApplied: false` as locality-specific. When `community` is absent, GraftonHub intentionally omits locality-specific utility sources.