Metadata-Version: 2.4
Name: quality-graph-cli
Version: 0.1.9
Summary: Provider-driven Quality Graph command-line application
Project-URL: Homepage, https://quality-graph.xyz/
Project-URL: Documentation, https://quality-graph.xyz/
License-Expression: MIT
Requires-Python: >=3.12
Requires-Dist: quality-graph-core==0.1.9
Description-Content-Type: text/markdown

# qg

Provider-driven command-line application for Quality Graph projects.

The CLI discovers providers through the `qg.providers` entry-point group. Install it together
with the GitHub provider using
`uv tool install quality-graph-cli==0.1.8 --with quality-graph-github==0.1.8`.

Initialize a repository with its default branch, generate the provider-owned files, and list
those paths for repository tooling:

```bash
qg init \
  --default-branch main \
  --runtime-action alchemmist/quality-graph@<release-commit-sha>
qg generate
qg generated-files
qg validate
```

The graph declaration can select the generated workflow projections per node:

```yaml
nodes:
  lint:
    events: [pull-request, push]
    run: make lint
  diff-check:
    events: [pull-request]
    run: make diff-check
```

Nodes without `events` run for both supported events. See the
[configuration reference](../../docs/configuration.md) for dependency projection rules.
