
 Usage: forge-doctor-data [OPTIONS] COMMAND [ARGS]...

 Deterministic diagnostics for data engineering projects.

+- Options -------------------------------------------------------------------+
| --version                                                                   |
| --install-completion            Install completion for the current shell.   |
| --show-completion               Show completion for the current shell, to   |
|                                 copy it or customize the installation.      |
| --help                -h        Show this message and exit.                 |
+-----------------------------------------------------------------------------+
+- Commands ------------------------------------------------------------------+
| portal         Serve the optional local portal over the real services       |
|                (127.0.0.1).                                                 |
| incident       Dependency-aware incident intelligence (offline).            |
| inspect        Domain inspection: `inspect <domain> ` (alias of `<domain>   |
|                inspect`).                                                   |
| reliability    End-to-end SLO & critical-path intelligence.                 |
+-----------------------------------------------------------------------------+
+- Estate & change -----------------------------------------------------------+
| advise         Rank findings into a cited action list.                      |
| compatibility  Detect runtimes and show Glue migration risks (knowledge     |
|                packs).                                                      |
| capabilities   Platform capability registry.                                |
| migrate        Migration intelligence.                                      |
| contract       Platform contract files.                                     |
| architecture   Architecture drift detection.                                |
| fleet          Fleet/estate intelligence across many repos. Bare:           |
|                Fleet/estate intelligence over a manifest of repositories.   |
| history        Recorded scan snapshots: list, diff, trend. Bare: List       |
|                recorded snapshots (scan --record).                          |
| optimize       Optimization candidates + multi-objective opportunities.     |
|                Bare: Enumerate optimization candidates (v1) when no         |
|                subcommand given.                                            |
| twin           Formal digital twin: validated platform snapshot.            |
| what-if        Evaluate a hypothetical change without executing it. Bare:   |
|                Evaluate --change target=value specs against the project.    |
| workspace      Discover and orchestrate sub-projects. Bare: Discover        |
|                sub-projects (pyproject.toml) under a workspace root.        |
+-----------------------------------------------------------------------------+
+- Scan & findings -----------------------------------------------------------+
| diff           Diff findings: NEW in <new> vs <old>, or in a 'base...head'  |
|                git range.                                                   |
| fix            Preview (or apply) deterministic safe fixes for findings.    |
| explain        Explain what a check looks for, when it is OK, and how to    |
|                fix it.                                                      |
| checks         List every registered check id, category and title.          |
| suppressions   Audit configured suppressions: ACTIVE / EXPIRED / UNUSED.    |
| diagnose       Fingerprint log errors against known signatures              |
|                (deterministic, offline).                                    |
| trace          Explain ONE finding: evidence, enclosing symbol, receiver    |
|                chain.                                                       |
| remediate      Print deterministic remediation plans for findings / root    |
|                causes.                                                      |
| root-cause     Correlate scan findings with runtime evidence into causal    |
|                clusters.                                                    |
| scan           Scan a project for data-engineering problems.                |
| repo           Run only repository checks.                                  |
| python         Run only python checks.                                      |
| dependencies   Run only dependencies checks.                                |
| git            Run only git checks.                                         |
| aws            Run only aws checks.                                         |
| docker         Run only docker checks.                                      |
| glue           Run only glue checks.                                        |
| ci             Run only ci checks.                                          |
| iac            Run only iac checks.                                         |
+-----------------------------------------------------------------------------+
+- Setup & integrations ------------------------------------------------------+
| export         Emit a portable handoff bundle: findings + graph +           |
|                capabilities + plans.                                        |
| hosts          Observe AI host CLIs and this project's integration with     |
|                them.                                                        |
| init           Scaffold a new Python project (pyproject, .gitignore,        |
|                README, src/, tests/).                                       |
| info           Quick project stats - files, languages, tooling - no checks  |
|                run.                                                         |
| mcp            Start a zero-dep MCP (JSON-RPC stdio) server for agent       |
|                integrations.                                                |
| lsp            Start a stdio LSP server (requires the optional 'lsp'        |
|                extra).                                                      |
| doctor         Self-check: config, plugins, cache dir, git, environment     |
|                health.                                                      |
| version        Print the installed Forge Doctor Data version.               |
| agent          Deterministic, budget-aware agent context.                   |
| install        Install Forge Doctor Data into a project, workspace or the   |
|                user home; manage the lifecycle (status, doctor, repair,     |
|                update, uninstall).                                          |
| cache          Inspect or clear the incremental analysis cache. Bare: Show  |
|                cache statistics for the project.                            |
| project        Project self-inspection: generated status and doc-drift      |
|                checks.                                                      |
+-----------------------------------------------------------------------------+
+- Platform intelligence -----------------------------------------------------+
| lineage        Static lineage: which jobs read/write which datasets.        |
| airflow        Airflow intelligence: inspect DAGs, tasks, sensors.          |
| analytical     Real-time OLAP engines: ClickHouse / Pinot / Druid           |
|                inspection.                                                  |
| bigquery       BigQuery intelligence: inspect the vendor model.             |
| catalog        Metadata catalogs: DataHub/OpenMetadata/Glue/Unity declared  |
|                estate.                                                      |
| cloud          Multi-cloud abstractions: vendor-neutral view over detected  |
|                services.                                                    |
| controlm       Control-M intelligence: inspect workflows-as-code.           |
| data-model     Cross-domain access-style inspection.                        |
| dbt            dbt intelligence: inspect the transformation model.          |
| dynamodb       DynamoDB intelligence.                                       |
| graph          Graph intelligence.                                          |
| iceberg        Iceberg intelligence: inspect, maintenance, compatibility.   |
| runtime        Offline runtime evidence (exported artifacts).               |
| lakeformation  Lake Formation governance intelligence.                      |
| schema         Schema extraction and diffing.                               |
| neptune        Neptune Database + Analytics intelligence.                   |
| parquet        Parquet intelligence: inspect.                               |
| platform       Canonical platform graph.                                    |
| emr            EMR deep intelligence (EC2/Serverless/EKS).                  |
| databricks     Databricks workspace/job/UC intelligence.                    |
| delta          Delta Lake feature and ops intelligence.                     |
| quality        Data quality: Deequ/GX/SodaCL/dbt suites, coverage, gate     |
|                wiring.                                                      |
| redshift       Redshift intelligence: inspect the vendor model.             |
| spark          Spark checks and runtime diagnosis. Bare: Run only spark     |
|                checks (default) or a runtime subcommand.                    |
| search         Search platforms: OpenSearch/Elasticsearch indices,          |
|                policies, domains.                                           |
| athena         Athena workgroup/query intelligence.                         |
| lambda         Lambda function/trigger intelligence.                        |
| snowflake      Snowflake intelligence: inspect the vendor model.            |
| stepfunctions  Step Functions intelligence.                                 |
| streaming      Streaming intelligence.                                      |
| kafka          Kafka/MSK deep intelligence.                                 |
| kinesis        Kinesis deep intelligence.                                   |
| flink          Flink deep intelligence.                                     |
| terraform      Terraform intelligence: inspect.                             |
| trino          Trino intelligence: inspect catalogs, coordinator, lineage.  |
+-----------------------------------------------------------------------------+
+- Quality gates & supply chain ----------------------------------------------+
| sbom           Emit a CycloneDX 1.5 SBOM: deps, plugins, knowledge packs,   |
|                images.                                                      |
| bench          Performance & scale benchmark.                               |
| collector      Validate normalized evidence bundles.                        |
| golden         Golden repositories - snapshot regression suites.            |
| lab            Forge Lab - reproducible scenarios with ground truth.        |
| contracts      Published artifact contracts (verify handoff bundles,        |
|                schemas).                                                    |
| ontology       Canonical platform vocabulary (entity/rel kinds, planes,     |
|                domains). Bare: Print the canonical vocabulary (entity       |
|                kinds, rel kinds, evidence                                   |
| knowledge      Knowledge-pack provenance. Bare: List all bundled knowledge  |
|                packs with provenance.                                       |
| plugins        Inspect and validate external plugins. Bare: List built-in   |
|                categories and discovered external plugins.                  |
| policy         Organization policy packs.                                   |
+-----------------------------------------------------------------------------+

 Start here: forge-doctor-data scan .  |  forge-doctor-data checks  |
 forge-doctor-data explain <CHECK-ID>

 Docs & issues: https://github.com/EdgarSocrates98/forge-doctor-data


