fabriq

Overview ¶

Command fabriq is the data fabric's single binary: a Forge app wrapped in a CLI (forge/cli RunApp). The same image runs the long-lived worker and the one-shot operator commands, sharing one wiring path.

fabriq                    — serve (default): run the background plane
fabriq serve|start|run    — same, explicit
fabriq migrate up|down|status — grove migrations (advisory-locked)
fabriq inspect registry|state — dump entity specs / projection state
fabriq rebuild                — blue-green projection rebuild
fabriq reconcile              — drift reconciliation
fabriq info|health|extensions — Forge built-ins

The worker (serve) is a Forge RunnableExtension: leader-elected outbox relay, projection consumers, reconciler, document plane. Health and metrics come from Forge: /_/livez, /_/readyz, /_/health, plus /metrics.

Configuration is environment-first (the deployment injects a secret + configmap); --dsn overrides FABRIQ_POSTGRES_DSN for ad-hoc operator use.

FABRIQ_POSTGRES_DSN        (required to serve)
FABRIQ_REDIS_ADDR          (required to serve)
FABRIQ_FALKORDB_ADDR       (optional: graph projection)
FABRIQ_ELASTICSEARCH_ADDRS (optional, comma-separated: search projection)
FABRIQ_HTTP_ADDR           (default :8081)
FABRIQ_RECONCILE_INTERVAL  (Go duration; "0" disables)