recon_gen.cli

recon-gen CLI — top-level command surface.

The CLI is organized around the artifacts the tool produces:

schema apply | clean | test data apply | refresh | clean | hash | etl-example | test json apply | clean | test | probe docs apply | serve | clean | test | export | screenshot audit apply | clean | test # Phase U dashboards # Phase X.2 (rename of serve app2 apply) studio # Phase X.4

Every artifact’s apply/clean defaults to emit (print SQL to stdout, write JSON to out/, build site to site/, render Markdown source for the audit report). Pass --execute to actually run the destructive thing (connect to the DB, deploy to AWS, write the PDF). The docs, dashboards, and studio commands have no --execute because building a static site / running a server IS the operation.

Per-artifact files: schema.py, data.py, json.py, docs.py, audit.py, dashboards.py, studio.py. Shared helpers: _helpers.py (Click options) + _html_serve.py (the shared dashboards/studio uvicorn loop). Per-app JSON-emit helpers: _app_builders.py.

Modules

audit

recon-gen audit — PDF reconciliation report.

dashboards

recon-gen dashboards — self-hosted HTMX/d3 dashboard server.

data

recon-gen data — per-prefix demo seed data.

docs

recon-gen docs — mkdocs handbook site for an L2 instance.

json

recon-gen json — QuickSight dashboard JSON for all four apps.

schema

recon-gen schema — per-prefix DDL for an L2 instance.

studio

recon-gen studio — implementation tools (X.4 SPEC).