json-controls

A clean, modular, LLM-authorable control system — UI as data. Refactor of the prior (FUBAR) AI implementation, grounded in the ~/code/samples survey.

Canonical model (serialization-agnostic, JSON or YAML):

control = { type, name, state{}, children[] }

- schema/control.schema.json — the canonical JSON Schema (single source; zod + pydantic conform; constrains LLM output). - schema/control-types.md — the control_type registry (IRC clone set). - examples/irc.control.{json,yaml} — gamja's IRC UI expressed as canonical controls (the first clone target). - fixtures/test-case-x.cassette.json — deterministic IRC replay cassette (timestamp+UUID round-trip). - PLAN.md — build plan + locked decisions + phases.

Status: Phase 1 complete (schema + registry + IRC config + cassette, jsonschema-validated). Next: JS runtime (ControlFactory + control_types) tested in jsdom, then a replay-WebSocket loop. Store decision (notes_db vs Postgres/Drizzle) is the Phase-4 gate.