Skip to content

xlflow graph dependencies ​

Inspect confirmed project-local dependencies in exported VBA source.

Usage ​

bash
xlflow graph dependencies
xlflow graph dependencies --module Billing
xlflow graph dependencies --path src/modules --json

Options and arguments ​

OptionDescriptionDefault
--module <name>Case-insensitive exact source-module filter; retains its outbound dependencies.all modules
--path <dir-or-file>Restrict the configured source scan.configured source roots
--jsonReturn nodes, typed edges, evidence, and uncertainty in the xlflow envelope.false

JSON output ​

The top-level graph payload has target: "dependencies", nodes, edges, and uncertain_edges. Confirmed edge kinds are calls, uses_type, constructs, and implements. Module call edges aggregate all contributing procedure call locations under evidence.

When to use this command ​

Use graph dependencies to understand static project-local coupling before a refactor, architecture review, or targeted testing pass.

Prerequisites ​

Run it from an xlflow project with exported VBA source. Excel and a workbook session are not required.

What this command reads and changes ​

The command reads configured VBA source files, parses them once, and does not modify source files, workbooks, or session state.

Effect on source-of-truth state ​

This is read-only. Use returned evidence locations to decide which source files to inspect or change, then follow the normal source-to-workbook workflow if needed.

Common workflows ​

Start with xlflow graph dependencies --json, filter a high-interest module with --module, then use xlflow impact Module.Procedure for a focused caller/callee view.

Common failures ​

Calls and project type references that cannot resolve to exactly one visible declaration remain uncertain; do not treat them as confirmed dependencies.

Released under the MIT License.