$ python3 scripts/cli.py estado --json
{
  "plc": "opc.tcp://127.0.0.1:4840",
  "mode": "SIMULATOR",
  "last_scan_ms": 50.0,
  "uptime_s": 0.0
}

$ python3 scripts/cli.py tags motor.temp_C --json
{
  "tags": [
    {
      "name": "motor.temp_C",
      "value": 62.47086715698242,
      "unit": "°C",
      "timestamp": "2026-09-11T15:55:16.172664+00:00",
      "quality": 1
    }
  ]
}

$ python3 scripts/cli.py alarmas --json
{ "alarms": [] }   # all 10 monitored tags inside their thresholds

$ PYTHONPATH=src python3 -m plc_ai.data_gen --days 3   # generate history CSV
wrote 4320 rows -> data/historical/history.csv

$ python3 scripts/cli.py historico motor.temp_C --json
{
  "series": [
    {
      "tag": "motor.temp_C",
      "points": [
        {"t": "2026-09-09T15:50:00+00:00", "v": 62.47086728988105},
        {"t": "2026-09-09T16:00:00+00:00", "v": 64.58467365158069},
        ...   (432 points total for 3 days)
      ]
    }
  ]
}

$ python3 scripts/cli.py crear-ot --maquina motor --prioridad alta \
    --descripcion "Motor 3 temp high" --accion "Check cooling fan" --json
{ "id_ot": "e4077595", "maquina": "motor", "prioridad": "alta",
  "estado": "abierta", "accion": "Check cooling fan" }

$ python3 scripts/cli.py ot list --json
[ { "id_ot": "e4077595", "maquina": "motor", "prioridad": "alta",
    "estado": "cerrada", "resultado": "reparado" },
  { "id_ot": "3add8851", "maquina": "bomba", "prioridad": "media",
    "estado": "abierta" } ]

$ python3 scripts/cli.py ot close 3add8851 --resultado reparado \
    --observaciones "Seal replaced, no leak" --json
{ "id_ot": "3add8851", "estado": "cerrada", "resultado": "reparado" }

$ python3 scripts/cli.py export-csv --output cmms_export.csv
Exported 2 orders to cmms_export.csv
$ cat cmms_export.csv
id_ot,maquina,prioridad,estado,creada_en,cerrada_en,resultado
e4077595,motor,alta,cerrada,2026-09-11T15:46:51,2026-09-11T15:46:57,reparado
3add8851,bomba,media,cerrada,2026-09-11T15:46:52,2026-09-11T16:03:17,reparado

$ python3 scripts/cli.py scl generador --plantilla proteccion_termica \
    --objetivo "Protect conveyor motor from overheating" \
    --parametros '{"limite": 85, "histeresis": 3}' --json
{
  "scl": "// ------------------------------------------------------------------\n// FB_ProteccionTermica - thermal protection with hysteresis\n// GENERATED by plc-ai-agent (template). Review before download.\n// Objetivo: Protect conveyor motor from overheating\n// parametros: limite=85, histeresis=3\n// ------------------------------------------------------------------\nFUNCTION_BLOCK FB_ProteccionTermica\n\nVAR_INPUT\n    temp_actual : REAL;        // current measured temperature\n    temp_max : REAL;           // alarm trip threshold\n    temp_hyst : REAL;          // hysteresis band (e.g. 2.0)\n    hist_reset : BOOL;         // manual reset of the latched alarm\nEND_VAR\n\nVAR_OUTPUT\n    alarma : BOOL;             // latched high-temperature alarm\n    en_servicio : BOOL;        // TRUE while block is armed\nEND_VAR\n\nVAR\n    alarma_interna : BOOL;     // raw trip flag\nEND_VAR\n\nBEGIN\n    IF temp_actual > temp_max THEN\n        alarma_interna := TRUE;\n    ELSIF temp_actual < (temp_max - temp_hyst) THEN\n        alarma_interna := FALSE;\n    END_IF;\n    IF alarma_interna THEN\n        alarma := TRUE;\n    END_IF;\n    IF hist_reset THEN\n        alarma := FALSE;\n    END_IF;\n    en_servicio := TRUE;\nEND_FUNCTION_BLOCK",
  "advertencias": [
    "Code generated from template 'proteccion_termica': review the logic against the real machine before downloading to the PLC.",
    "The LLM selects the template and parameters; the generator produces exact SCL. The LLM never writes SCL freely (ADR-015)."
  ]
}

$ python3 scripts/cli.py scl validar data/fixtures/scl_good.scl --json
{ "valido": true, "errores": [], "warnings": [...] }

$ python3 scripts/cli.py scl validar data/fixtures/scl_bad.scl --json
{ "valido": false,
  "errores": [
    "unbalanced IF/END_IF (1 vs 0)",
    "missing ';' at end of assignment line: 'alarma := TRUE'",
    "found '=' where ':=' may be required: 'alarma = FALSE'"
  ], "warnings": [...] }

# Bridge URL not configured -> controlled error, never a crash
$ PYTHONPATH=src python3 -c "from plc_ai.openness import OpennessBridgeClient; \
  print(OpennessBridgeClient().health_check())"
{'ok': False, 'error': 'Openness bridge not configured'}

                ┌───────────────── Layer 1 · MONITORING ─────────────────┐
                │                                                         │
  S7-1500 ◄─────┤  OPC UA (port 4840)         asyncua simulator ◄────────┤
  (real PLC,    │       │                    (3 machines / 10 tags,       │
  native UA)    │       ▼                      deterministic, seed=42)    │
                │  OpcUaClient.read_tags()  ── value + unit + QUALITY     │
                │       │                                                 │
                │       ▼                                                 │
                │  MCP server (stdio)  ◄── ReAct agent (Ollama LOCAL)     │
                │  7 tools               qwen2.5-coder:7b, urllib-only    │
                └─────────────────────────────────────────────────────────┘
                                             │ selects template (+params)
                                             ▼
                ┌───────────────── Layer 2 · CODE GENERATION ─────────────┐
                │  generate_scl()  →  validate_scl()                      │
                │     (deterministic templates,   (IEC 61131-3 structural │
                │      LLM NEVER writes SCL freely)   validator)          │
                │      │                                                  │
                │      ▼  (optional, Windows only)                        │
                │  Openness bridge (HTTP/JSON) → TIA Portal → PLCSIM      │
                │      │                                                  │
                │      ▼                                                  │
                │  HUMAN REVIEW ──► download to controller (never auto)   │
                └─────────────────────────────────────────────────────────┘

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

pytest tests/ -q                       # 165 tests, no network, no LLM needed

# Diagnostics against the bundled simulator
python3 scripts/cli.py estado
python3 scripts/cli.py tags all
python3 scripts/cli.py alarmas
python3 scripts/cli.py historico motor.temp_C

# Generate history data for historico (example CSV also committed in data/fixtures/)
PYTHONPATH=src python3 -m plc_ai.data_gen --days 7

# Inside the Docker network where Ollama lives (see .env.example)
OLLAMA_HOST=ollama:11434 OLLAMA_MODEL=qwen2.5-coder:7b \
    python3 scripts/e2e_agent.py "Mide la temperatura del motor y si es
    alta, genera un bloque SCL de proteccion termica."

export PLC_USE_SIMULATOR=true
PYTHONPATH=src python3 -m plc_ai.mcp.server     # stdio