| metadata-path | Path to an SFDX project root, force-app source directory, or unzipped metadata folder. | yes | — |
| output-dir | Where the graph, clusters, and SVG outputs land. | no | .busbar/artifacts/dependency-graph |
| emit-graph | Emit the full dependency graph as JSON (nodes + typed edges). | no | true |
| graph-path | Relative-to-output-dir filename for the graph JSON. | no | graph.json |
| emit-clusters | Cluster components into packages and emit clusters JSON. | no | true |
| clusters-path | Relative-to-output-dir filename for the clusters JSON. | no | clusters.json |
| min-cluster-size | Minimum components per cluster. | no | 3 |
| max-cluster-size | Maximum components per cluster. | no | 100 |
| target-packages | Target number of clusters (used for clustering heuristics and Voronoi paneling). | no | 8 |
| emit-svg | Emit a Voronoi-style SVG of the clustered packages. | no | true |
| svg-path | Relative-to-output-dir filename for the SVG. | no | packages.svg |
| svg-width | SVG width in pixels. | no | 1600 |
| svg-height | SVG height in pixels. | no | 1000 |
| commit | Commit the generated files back to the current branch. | no | false |
| commit-message | Commit message used when commit=true. | no | chore(deps): refresh dependency graph |
| git-user-name | git user.name for the commit. | no | busbar-bot |
| git-user-email | git user.email for the commit. | no | bot@busbar.agency |
| comment-pr | Post a summary comment on pull_request events. | no | true |
| upload-artifact | Upload outputs as a workflow artifact. | no | true |
| artifact-name | Artifact name when upload-artifact=true. | no | dependency-graph |
| version | Release tag of the sf-dependency-graph binary. Falls back to env.BUSBAR_ACTION_VERSION, then "latest". | no | "" |
| binary-repo | GitHub repo hosting prebuilt binary releases. Falls back to env.BUSBAR_ACTION_REPO, then busbar-actions/actions-dist. | no | "" |