Johgee Open Irrigation

Asesoría de riego de código abierto y nativa de IA para jardines domésticos del Reino Unido.

v1 convierte lo que ya sabes — tipo de jardín, suelo, sol, cómo riegas, lluvia reciente y cómo se siente el suelo — en un plan explicable: milímetros, litros y tiempo de ejecución. No controla grifos, temporizadores ni hardware de riego. Tampoco confirma una prohibición de zumbido para tu calle.

Las recomendaciones numéricas provienen de un núcleo determinista versionado. Un modelo de lenguaje puede explicar esos datos. No debe cambiar milímetros, litros, runtime, estado de restricción, ids de variante ni fuentes.

Estado

El modo de datos públicos es dinámico a partir de D-01 (2026-08-23): un código postal puede usar el feed gratuito Global Spot de Met Office DataHub con caché mediante una cuadrícula regular. Si no se puede obtener el clima, la API recurre al autoinforme manual (nunca inventa milímetros). El estado de restricción permanece unknown; las indicaciones demente y aspersores siguen en fail-closed hasta la v3. fixture es solo de pruebas.

Related MCP server: UK Weather & Travel Outfit Recommender MCP Server

Qué puedes hacer hoy

• Llamar a POST /v1/recommendations con un manual_context (sin código postal).

• Enviar opcionalmente un código postal para obtener el clima bajo demanda; si no, el sistema usa el autoinforme.

• Probar la misma calculadora con las herramientas MCP compute_watering (manual, sin red) o get_watering_advice (postal opcional; clima si el servidor tiene clave de nivel gratuito).

• Abrir la página local de demostración: apps/public-web/watering-plan.html.

• Explorar las primeras páginas de conocimiento (HTML, JSON y JSON-LD) de interés.

Requisitos

• Node.js 22.23.2

• pnpm 11.5.2 (via Corepack)

El tiempo de ejecución exacto está registrado en .node-version y package.json.

Inicio rápido

corepack enable
pnpm install --frozen-lockfile
pnpm check
pnpm dev:api

La API atiende en http://localhost:8787. Prueba:

curl -sS http://localhost:8787/v1/recommendations \
  -H 'Content-Type: application/json' \
  -d '{
    "garden_type": "borders",
    "area_m2": 12,
    "soil_class": "loamy",
    "establishment": "established",
    "irrigation_method": "watering_can",
    "manual_context": { "recent_rainfall": "light", "soil_feel": "moist" }
  }'

La cabecera de respuesta debe ser X-Johgee-Data-Mode: manual. La cabecera fixture es solo de prueba.

Página local del planificador: web/public/watering-plan.html (conexión a la API local).

MCP

Crea el servidor stdio y conecta Cursor o Claude Desktop a él. No requiere clave API.

pnpm --filter @johgee/contracts build
pnpm --filter @johgee/irrigation-core build
pnpm --filter @johgee/ai-tools build

{
  "mcpServers": {
    "johgee": {
      "command": "node",
      "args": ["packages/ai-tools/dist/stdio.js"]
    }
  }
}

Herramientas:

• calculate_watering (manual, sin red)

• get_watering_advice (postal opcional; usa el clima si hay clave, si no, el mismo autoinforme)

Si la entrada es inválida, devuelve un problema estructurado. No se inventan cifras. Borrador de skill: packages/ai-tools/SKILL.md.

Una persona debería poder ejecutar la herramienta MCP en acerca de diez minutos haciendo un clon limpio: instalar, construir los tres paquetes y lanzar el servidor stdio.

Arquitectura

Shopify page / MCP client
        │
        ▼
  Public API (Hono)  ──  MCP stdio (@johgee/ai-tools)
        │                         │
        └────────────┬────────────┘
                     ▼
           irrigation-core
           (pure functions)

• Storefront: página de Shopify + sección de Tema (extensions/watering-planner).

• API pública: https://api.johgeeirrig.co.uk/v1 (CORS: storefront de Johgee).

• Núcleo: @johgee/irrigation-core — sin red, sin base de datos ni modelos externos.

• Enlaces de compartir anónimos caducan en 30 días; tokens se guardan en hash.

• Conocimiento: apps/public-web/knowledge, llms.txt, sitemap y robots.

Los códigos postales exactos no deben entrar en bases de datos, logs, trazas, almacenamiento local ni Git.

indirecto

Mapa del repositorio

apps/                     Local public-web demo
extensions/               Shopify Theme section
services/                 API
packages/                 Core, contracts, planner-ui, ai-tools, content
api/                      OpenAPI 3.1
schemas/                  JSON Schema
docs/                     Product, architecture, ADRs

Contribuciones

Ver CONTRIBUTING.md. También SECURITY.md y GOVERNANCE.md.

Licencia

El código propiedad de Johgee se distribuye bajo licencia MIT. Los datos y contenidos de terceras partes conservan sus propias condiciones y deben registrarse antes de usarse o redistribuirlos.

Fuente pública: github.com/hongzhizhuo/johgee-open-irrigation.