git clone https://github.com/aniruddhaadak80/frostwatch.git
cd frostwatch
npm install
npm run dev

npm run typecheck && npm run lint && npm run test && npm run build
npm run verify:live    # real HTTP checks against the deployment

graph LR
  Browser["Browser<br/>server-rendered"] --> Pages["Next.js routes"]
  Agent["External agent"] -->|JSON-RPC 2.0| Mcp["/api/mcp"]
  Pages --> Services["Service layer"]
  Mcp --> Services
  Services --> Engine["engine.ts<br/>frost-risk@1.0.0"]
  Services --> Repo["Store interface"]
  Repo --> Neon["Neon Postgres<br/>production"]
  Repo --> Lite["SQLite<br/>local + tests"]
  Services --> Weather["weather.ts"]
  Weather --> OM["Open-Meteo"]
  Weather --> NWS["NOAA / NWS"]
  classDef data fill:#22d3ee,color:#04212b,stroke:#0e7490
  classDef ai fill:#a78bfa,color:#1e1035,stroke:#6d28d9
  classDef ok fill:#34d399,color:#04231a,stroke:#047857
  classDef ext fill:#fbbf24,color:#2b1d02,stroke:#b45309
  classDef inf fill:#94a3b8,color:#0b1220,stroke:#475569
  class OM,NWS ext
  class Engine ai
  class Neon,Lite,Repo ok
  class Browser,Agent,Pages,Mcp,Services,Weather inf

graph TB
  Req["Block coordinates"] --> Fetch["fetchForecast<br/>8s timeout, 2 retries"]
  Fetch --> Live{"HTTP 200 and<br/>usable hours?"}
  Live -->|yes| Norm["Normalise to HourPoint<br/>drop missing fields, never coerce"]
  Live -->|no| Sample["Bundled sample<br/>status = fallback"]
  Norm --> Src["status = live<br/>+ fetchedAt + sourceUrl + attribution"]
  Sample --> Src
  Src --> Engine2["assessFrostRisk"]
  Alerts["NWS active alerts"] --> Src
  classDef data fill:#22d3ee,color:#04212b,stroke:#0e7490
  classDef ok fill:#34d399,color:#04231a,stroke:#047857
  classDef risk fill:#fb7185,color:#2b0a0a,stroke:#be123c
  classDef ext fill:#fbbf24,color:#2b1d02,stroke:#b45309
  classDef ai fill:#a78bfa,color:#1e1035,stroke:#6d28d9
  class Norm,Src data
  class Live,Sample risk
  class Fetch,Alerts ext
  class Engine2 ai

graph TB
  In["Hourly points + threshold + crop stage"] --> Norm["Effective threshold =<br/>threshold − stage tolerance"]
  Norm --> M["minimum 40%"]
  Norm --> D["duration 20%"]
  Norm --> R["radiation 15%<br/>only when near freezing"]
  Norm --> W["wind 15%<br/>only when near freezing"]
  Norm --> T["wetness 10%"]
  M --> Sum["Σ score×weight ÷ 100"]
  D --> Sum
  R --> Sum
  W --> Sum
  T --> Sum
  Sum --> Band["band + recommendation"]
  Band --> Out["versioned result + itemised factors"]
  classDef ai fill:#a78bfa,color:#1e1035,stroke:#6d28d9
  classDef data fill:#22d3ee,color:#04212b,stroke:#0e7490
  classDef ok fill:#34d399,color:#04231a,stroke:#047857
  class In,Norm data
  class M,D,R,W,T,Sum,Band ai
  class Out ok

graph TB
  G["genesis = 96 zeroes"] --> E1["event 1<br/>create"]
  E1 --> S1["seal₁ = SHA-384(prevSeal ‖ canonicalJson(event₁))"]
  S1 --> E2["event 2<br/>decision"]
  E2 --> S2["seal₂ = SHA-384(seal₁ ‖ canonicalJson(event₂))"]
  S2 --> E3["event n …"]
  E3 --> Replay["replay: recompute every seal,<br/>report the FIRST broken seq"]
  Del["delete"] --> Tomb["tombstone row,<br/>never remove"]
  Tomb --> Replay
  classDef ok fill:#34d399,color:#04231a,stroke:#047857
  classDef risk fill:#fb7185,color:#2b0a0a,stroke:#be123c
  classDef inf fill:#94a3b8,color:#0b1220,stroke:#475569
  class S1,S2,Replay ok
  class Del,Tomb risk
  class G,E1,E2,E3 inf

graph LR
  A["Agent"] --> Init["initialize"]
  Init --> List["tools/list"]
  List --> Read["list_blocks<br/>list_sheets"]
  List --> An["assess_frost_risk"]
  List --> Mut["create_sheet<br/>update_sheet"]
  Read --> Same["Same service layer<br/>as the UI"]
  An --> Same
  Mut --> Same
  Same --> Store[("Postgres")]
  Err["Unknown tool"] --> Code["JSON-RPC -32601"]
  classDef ok fill:#34d399,color:#04231a,stroke:#047857
  classDef inf fill:#94a3b8,color:#0b1220,stroke:#475569
  classDef risk fill:#fb7185,color:#2b0a0a,stroke:#be123c
  class A,Init,List,Same,Store ok
  class Read,An,Mut inf
  class Err,Code risk

{
  "mcpServers": {
    "frostwatch": {
      "type": "http",
      "url": "https://frostwatch.vercel.app/api/mcp",
      "transport": "jsonrpc-2.0"
    }
  }
}

# Health, including the real store probe
curl -s https://frostwatch.vercel.app/api/health

# Live forecast + engine verdict for a real block
curl -s "https://frostwatch.vercel.app/api/forecast?block=blk-yakima"

# The engine on its own
curl -s -X POST https://frostwatch.vercel.app/api/engine \
  -H 'content-type: application/json' \
  -d '{"blockId":"blk-willamette"}'

BASE=https://frostwatch.vercel.app

# 1. create (the session cookie is what scopes ownership)
curl -s -c jar -b jar -X POST $BASE/api/sheets \
  -H 'content-type: application/json' \
  -d '{"blockId":"blk-yakima","nightOf":"2026-01-15","notes":"watching"}'

# 2. read back
curl -s -c jar -b jar $BASE/api/sheets/sh_xxxxxxxxxxxxxxxx

# 3. record a decision
curl -s -c jar -b jar -X PATCH $BASE/api/sheets/sh_xxxxxxxxxxxxxxxx \
  -H 'content-type: application/json' \
  -d '{"status":"protected","actor":"grower"}'

# 4. replay the audit chain
curl -s -c jar -b jar $BASE/api/integrity/sh_xxxxxxxxxxxxxxxx

# 5. export the brief
curl -s -c jar -b jar "$BASE/api/export?sheet=sh_xxxxxxxxxxxxxxxx" -o brief.md

# 6. retire (tombstone; the chain still replays)
curl -s -c jar -b jar -X DELETE $BASE/api/sheets/sh_xxxxxxxxxxxxxxxx

{ "error": { "code": "SHEET_EXISTS", "message": "a sheet already exists for this block and night" } }

graph LR
  Land["Land on /<br/>live scores"] --> Pick["Pick a block"]
  Pick --> Lab["/effort<br/>drag the threshold lamp"]
  Lab --> Rec["Record on a real sheet"]
  Rec --> Sheet["/sheets/id<br/>record the decision"]
  Sheet --> Verify["Replay the chain"]
  Verify --> Brief["/export<br/>download the brief"]
  Brief --> Agent["/agent<br/>same tools, JSON-RPC"]
  classDef ok fill:#34d399,color:#04231a,stroke:#047857
  classDef data fill:#22d3ee,color:#04212b,stroke:#0e7490
  class Land,Lab,Rec data
  class Sheet,Verify,Brief,Agent ok

graph LR
  Push["Push to main"] --> CI["CI<br/>typecheck lint test build"]
  CI --> Ver["Vercel production"]
  Ver --> Neon2[("Neon Postgres")]
  Ver --> Edge["Live routes"]
  Edge --> Check["verify:live<br/>17 real HTTP checks"]
  classDef ok fill:#34d399,color:#04231a,stroke:#047857
  classDef inf fill:#94a3b8,color:#0b1220,stroke:#475569
  class Push,CI,Ver,Edge,Check ok
  class Neon2 inf

graph LR
  A["Live forecast"] --> B["Deterministic engine"]
  B --> C["Sealed decisions"]
  C --> D["Agent tools"]
  classDef ok fill:#34d399,color:#04231a,stroke:#047857
  class A,B,C,D ok

graph TB
  Multi["Block-level history<br/>see how a block behaved across nights"]
  Team["Shared watch links<br/>a read-only token, no accounts"]
  Push["Threshold alerts<br/>email or webhook when a score crosses a band"]
  Multi --> Team --> Push
  classDef next fill:#22d3ee,color:#04212b,stroke:#0e7490
  class Multi,Team,Push next

graph LR
  Micro["Microclimate stations<br/>crowd-sourced sensor intake"]
  Model["Damage models<br/>what this cold actually cost the block"]
  Micro --> Model
  classDef later fill:#94a3b8,color:#0b1220,stroke:#475569
  class Micro,Model later