@codependix/cli 0.0.29 → 0.0.31

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+## 0.0.31 (2026-10-16)
+
+### 🧱 Updated Dependencies
+
+- Updated codependix-configuration to 0.0.31
+- Updated codependix-boundaries to 0.0.30
+- Updated codependix-output to 0.0.30
+- Updated codependix-core to 0.0.29
+
+## 0.0.30 (2026-10-15)
+
+### 💅 Refactors
+
+- **callidescope,codependix,codometer,conformetry:** ♻️ require --config on every ic-suite command line ([#1598](https://github.com/organizzolini/codebase/pull/1598))
+
+### 🧱 Updated Dependencies
+
+- Updated codependix-configuration to 0.0.30
+- Updated codependix-boundaries to 0.0.29
+- Updated codependix-output to 0.0.29
+- Updated codependix-core to 0.0.28
+
 ## 0.0.29 (2026-10-15)
 
 ### 💅 Refactors

package/README.md

@@ -18,21 +18,22 @@ pnpm add --filter <project> --save-dev @codependix/cli
 ```
 
 ```bash
-codependix map --write
+codependix map --write --config projects/configuration/codependix.config.ts
 ```
 
 ## Usage
 
 One command, `map`, and no per-graph-type subcommand. Which graphs run for a
 project, where its export lands, and which rules judge it is entirely a
-function of the configuration file; see
+function of the configuration file, which every run names with `--config`
+because nothing searches for it and there is no default; see
 [`projects/configuration/codependix.config.ts`](../../../configuration/codependix.config.ts)
 for this repository's own.
 
 | Flag | Meaning |
 | ---- | ------- |
 | `--check [check]` | Fail on a comma-separated set drawn from `boundaries` and `reports` |
-| `--config [config]` | Path to a `codependix.config.ts`. Searched for upward from `--directory` when omitted |
+| `--config <config>` | **Required.** Path to the codependix configuration file. Omitting it fails the run, naming the flag; nothing is searched for |
 | `--dependencies` | Build `--check boundaries` over the dependencies of the projects `--projects` or `--tags` named, reporting their findings as notes (default). No effect without `--projects` or `--tags` |
 | `--no-dependencies` | Build `--check boundaries` over only the projects `--projects` or `--tags` named, not their dependencies. No effect without `--projects` or `--tags` |
 | `-d, --directory [directory]` | Workspace root whose Nx project graph this run reads. Defaults to the working directory |
@@ -414,6 +415,7 @@ graph LR
   file_src_index_unit_test_ts --> file_src_index_ts
   file_src_modules_map_map_command_integration_test_ts --> file_src_codependix_cli_module_ts
   file_src_modules_map_map_command_integration_test_ts --> file_src_modules_map_map_command_ts
+  file_src_modules_map_map_command_ts --> file_src_modules_map_map_constants_ts
   file_src_modules_map_map_command_unit_test_ts --> file_src_modules_map_map_command_ts
   file_src_modules_map_map_module_ts --> file_src_modules_map_map_command_ts
   file_src_modules_map_map_module_unit_test_ts --> file_src_modules_map_map_command_ts
@@ -441,7 +443,7 @@ Call stacks traced through `projects/ic-suite/codependix/codependix-cli`, deepes
 | --- | --- |
 | Callables | 48 |
 | Files | 19 |
-| Calls traced | 42 |
+| Calls traced | 44 |
 | Call stacks | 19 |
 | Deepest stack | 15 |
 | Stacks through recursion | 0 |
@@ -461,11 +463,11 @@ What this project is judged against, as declared in its own `callidescope.config
 **1. `MapCommand.run`** — depth ≥ 15 · decorated-method
 
 ```text
-🚀 MapCommand.run(_passedParameters: string[], options?: MapCommandOptions): Promise<void> [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:472]
+🚀 MapCommand.run(_passedParameters: string[], options?: MapCommandOptions): Promise<void> [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:479]
    ↳ Runs whatever the command line asked for: exports, boundaries, or both.
-  └─> MapCommand.runMode(…): Promise<void> [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:187]
+  └─> MapCommand.runMode(…): Promise<void> [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:193]
      ↳ Runs the passes a resolved mode selected, and reports what they found.
-    └─> MapCommand.runExports(context: GraphRunContext): Promise<MapRunResult> [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:168]
+    └─> MapCommand.runExports(context: GraphRunContext): Promise<MapRunResult> [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:174]
        ↳ Runs the export pass, warning when nothing was selected.
       └─> GraphRunService.run(context: GraphRunContext): Promise<MapRunResult> [projects/ic-suite/codependix/codependix-output/src/modules/graph-run/graph-run.service.ts:144]
          ↳ Runs every configured graph export against an already-resolved context.
@@ -494,7 +496,7 @@ What this project is judged against, as declared in its own `callidescope.config
 **2. `PathCommand.run`** — depth ≥ 12 · decorated-method
 
 ```text
-🚀 PathCommand.run(passedParameters: string[], options?: PathCommandOptions): Promise<void> [projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:214]
+🚀 PathCommand.run(passedParameters: string[], options?: PathCommandOptions): Promise<void> [projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:218]
    ↳ Runs the path query between two nodes across active graph levels.
   └─> PathQueryService.query(args: PathQueryArguments): Promise<CombinedPathResults> [projects/ic-suite/codependix/codependix-output/src/modules/path-query/path-query.service.ts:300]
      ↳ Queries every enabled graph type for a connecting path between two nodes.
@@ -520,9 +522,9 @@ What this project is judged against, as declared in its own `callidescope.config
 **3. `MapCommand.parseDirectory`** — depth 4 · decorated-method
 
 ```text
-🚀 MapCommand.parseDirectory(value: string | undefined): string [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:271]
+🚀 MapCommand.parseDirectory(value: string | undefined): string [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:278]
    ↳ Parses the directory whose Nx workspace this run reads.
-  └─> ConfigurationService.parsePathOption(value: string | undefined): string [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:298]
+  └─> ConfigurationService.parsePathOption(value: string | undefined): string [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:297]
      ↳ Parses a path option that falls back to the working directory.
     └─> InputService.parsePathOption(value: string | undefined): string [projects/ic-suite/codependix/codependix-configuration/src/modules/input/input.service.ts:87]
        ↳ Parses a path option that falls back to the working directory.
@@ -536,9 +538,9 @@ What this project is judged against, as declared in its own `callidescope.config
 **4. `MapCommand.parseExclude`** — depth 4 · decorated-method
 
 ```text
-🚀 MapCommand.parseExclude(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:287]
+🚀 MapCommand.parseExclude(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:294]
    ↳ Parses `--exclude`, a comma-separated list of globs overriding the configured `exclude`.
-  └─> ConfigurationService.parseCommaDelimitedOption(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:283]
+  └─> ConfigurationService.parseCommaDelimitedOption(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:282]
      ↳ Parses a comma-separated list option, dropping blank entries.
     └─> InputService.parseCommaDelimitedOption(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-configuration/src/modules/input/input.service.ts:54]
        ↳ Parses a comma-separated list option, dropping blank entries.
@@ -548,9 +550,9 @@ What this project is judged against, as declared in its own `callidescope.config
 **5. `MapCommand.parseInclude`** — depth 4 · decorated-method
 
 ```text
-🚀 MapCommand.parseInclude(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:326]
+🚀 MapCommand.parseInclude(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:333]
    ↳ Parses `--include`, a comma-separated list of globs overriding the configured `include`.
-  └─> ConfigurationService.parseCommaDelimitedOption(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:283]
+  └─> ConfigurationService.parseCommaDelimitedOption(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:282]
      ↳ Parses a comma-separated list option, dropping blank entries.
     └─> InputService.parseCommaDelimitedOption(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-configuration/src/modules/input/input.service.ts:54]
        ↳ Parses a comma-separated list option, dropping blank entries.
@@ -560,9 +562,9 @@ What this project is judged against, as declared in its own `callidescope.config
 **6. `PathCommand.parseDirectory`** — depth 4 · decorated-method
 
 ```text
-🚀 PathCommand.parseDirectory(value: string | undefined): string [projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:98]
+🚀 PathCommand.parseDirectory(value: string | undefined): string [projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:102]
    ↳ Parses the directory whose Nx workspace this run reads.
-  └─> ConfigurationService.parsePathOption(value: string | undefined): string [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:298]
+  └─> ConfigurationService.parsePathOption(value: string | undefined): string [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:297]
      ↳ Parses a path option that falls back to the working directory.
     └─> InputService.parsePathOption(value: string | undefined): string [projects/ic-suite/codependix/codependix-configuration/src/modules/input/input.service.ts:87]
        ↳ Parses a path option that falls back to the working directory.
@@ -573,9 +575,9 @@ What this project is judged against, as declared in its own `callidescope.config
 **7. `PathCommand.parseExclude`** — depth 4 · decorated-method
 
 ```text
-🚀 PathCommand.parseExclude(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:107]
+🚀 PathCommand.parseExclude(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:111]
    ↳ Parses `--exclude`, a comma-separated list of globs overriding the configured `exclude`.
-  └─> ConfigurationService.parseCommaDelimitedOption(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:283]
+  └─> ConfigurationService.parseCommaDelimitedOption(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:282]
      ↳ Parses a comma-separated list option, dropping blank entries.
     └─> InputService.parseCommaDelimitedOption(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-configuration/src/modules/input/input.service.ts:54]
        ↳ Parses a comma-separated list option, dropping blank entries.
@@ -585,9 +587,9 @@ What this project is judged against, as declared in its own `callidescope.config
 **8. `PathCommand.parseInclude`** — depth 4 · decorated-method
 
 ```text
-🚀 PathCommand.parseInclude(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:139]
+🚀 PathCommand.parseInclude(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:143]
    ↳ Parses `--include`, a comma-separated list of globs overriding the configured `include`.
-  └─> ConfigurationService.parseCommaDelimitedOption(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:283]
+  └─> ConfigurationService.parseCommaDelimitedOption(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:282]
      ↳ Parses a comma-separated list option, dropping blank entries.
     └─> InputService.parseCommaDelimitedOption(value: string | undefined): string[] [projects/ic-suite/codependix/codependix-configuration/src/modules/input/input.service.ts:54]
        ↳ Parses a comma-separated list option, dropping blank entries.
@@ -597,9 +599,9 @@ What this project is judged against, as declared in its own `callidescope.config
 **9. `MapCommand.parseConfig`** — depth 3 · decorated-method
 
 ```text
-🚀 MapCommand.parseConfig(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:248]
-   ↳ Parses the optional configuration path from command-line input.
-  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:293]
+🚀 MapCommand.parseConfig(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:254]
+   ↳ Parses the required configuration path from command-line input.
+  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:292]
      ↳ Trims an optional string option, treating blank as absent.
     └─> InputService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/input/input.service.ts:75]
        ↳ Trims an optional string option, treating blank as absent.
@@ -608,9 +610,9 @@ What this project is judged against, as declared in its own `callidescope.config
 **10. `MapCommand.parseFormat`** — depth 3 · decorated-method
 
 ```text
-🚀 MapCommand.parseFormat(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:311]
+🚀 MapCommand.parseFormat(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:318]
    ↳ Parses what `--format` prints to standard output.
-  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:293]
+  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:292]
      ↳ Trims an optional string option, treating blank as absent.
     └─> InputService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/input/input.service.ts:75]
        ↳ Trims an optional string option, treating blank as absent.
@@ -619,9 +621,9 @@ What this project is judged against, as declared in its own `callidescope.config
 **11. `MapCommand.parseJsonOutput`** — depth 3 · decorated-method
 
 ```text
-🚀 MapCommand.parseJsonOutput(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:339]
+🚀 MapCommand.parseJsonOutput(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:346]
    ↳ Parses `--json-output`, the path to write every active graph type's combined JSON data to, keyed by graph type name.
-  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:293]
+  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:292]
      ↳ Trims an optional string option, treating blank as absent.
     └─> InputService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/input/input.service.ts:75]
        ↳ Trims an optional string option, treating blank as absent.
@@ -630,9 +632,9 @@ What this project is judged against, as declared in its own `callidescope.config
 **12. `MapCommand.parseMarkdownOutput`** — depth 3 · decorated-method
 
 ```text
-🚀 MapCommand.parseMarkdownOutput(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:352]
+🚀 MapCommand.parseMarkdownOutput(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:359]
    ↳ Parses `--markdown-output`, the path to write every active graph type's combined, anchor-spliced Markdown diagram to.
-  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:293]
+  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:292]
      ↳ Trims an optional string option, treating blank as absent.
     └─> InputService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/input/input.service.ts:75]
        ↳ Trims an optional string option, treating blank as absent.
@@ -641,9 +643,9 @@ What this project is judged against, as declared in its own `callidescope.config
 **13. `MapCommand.parseProjects`** — depth 3 · decorated-method
 
 ```text
-🚀 MapCommand.parseProjects(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:431]
+🚀 MapCommand.parseProjects(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:438]
    ↳ Parses the projects a run exports for beyond `include`. **Widening, and narrowing.** A named project is added to…
-  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:293]
+  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:292]
      ↳ Trims an optional string option, treating blank as absent.
     └─> InputService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/input/input.service.ts:75]
        ↳ Trims an optional string option, treating blank as absent.
@@ -652,9 +654,9 @@ What this project is judged against, as declared in its own `callidescope.config
 **14. `MapCommand.parseTags`** — depth 3 · decorated-method
 
 ```text
-🚀 MapCommand.parseTags(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:444]
+🚀 MapCommand.parseTags(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:451]
    ↳ Parses the Nx tags a run exports for, matched exactly against a project's own tags.
-  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:293]
+  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:292]
      ↳ Trims an optional string option, treating blank as absent.
     └─> InputService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/input/input.service.ts:75]
        ↳ Trims an optional string option, treating blank as absent.
@@ -663,9 +665,9 @@ What this project is judged against, as declared in its own `callidescope.config
 **15. `MapCommand.parseWrite`** — depth 3 · decorated-method
 
 ```text
-🚀 MapCommand.parseWrite(value: boolean | undefined): boolean [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:454]
+🚀 MapCommand.parseWrite(value: boolean | undefined): boolean [projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:461]
    ↳ Parses the `--write` flag from command-line input.
-  └─> ConfigurationService.parseFlagOption(value: boolean | undefined): boolean [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:288]
+  └─> ConfigurationService.parseFlagOption(value: boolean | undefined): boolean [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:287]
      ↳ Parses a valueless boolean flag, which is present or it is not.
     └─> InputService.parseFlagOption(value: boolean | undefined): boolean [projects/ic-suite/codependix/codependix-configuration/src/modules/input/input.service.ts:70]
        ↳ Parses a valueless boolean flag, which is present or it is not.
@@ -674,9 +676,9 @@ What this project is judged against, as declared in its own `callidescope.config
 **16. `PathCommand.parseConfig`** — depth 3 · decorated-method
 
 ```text
-🚀 PathCommand.parseConfig(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:89]
-   ↳ Parses the optional configuration path from command-line input.
-  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:293]
+🚀 PathCommand.parseConfig(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:92]
+   ↳ Parses the required configuration path from command-line input.
+  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:292]
      ↳ Trims an optional string option, treating blank as absent.
     └─> InputService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/input/input.service.ts:75]
        ↳ Trims an optional string option, treating blank as absent.
@@ -685,9 +687,9 @@ What this project is judged against, as declared in its own `callidescope.config
 **17. `PathCommand.parseFormat`** — depth 3 · decorated-method
 
 ```text
-🚀 PathCommand.parseFormat(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:130]
+🚀 PathCommand.parseFormat(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:134]
    ↳ Parses what `--format` prints to standard output. Defaults to Markdown when the flag was left off entirely.
-  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:293]
+  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:292]
      ↳ Trims an optional string option, treating blank as absent.
     └─> InputService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/input/input.service.ts:75]
        ↳ Trims an optional string option, treating blank as absent.
@@ -696,9 +698,9 @@ What this project is judged against, as declared in its own `callidescope.config
 **18. `PathCommand.parseProjects`** — depth 3 · decorated-method
 
 ```text
-🚀 PathCommand.parseProjects(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:194]
+🚀 PathCommand.parseProjects(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:198]
    ↳ Parses the projects a query searches across beyond `include`.
-  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:293]
+  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:292]
      ↳ Trims an optional string option, treating blank as absent.
     └─> InputService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/input/input.service.ts:75]
        ↳ Trims an optional string option, treating blank as absent.
@@ -707,9 +709,9 @@ What this project is judged against, as declared in its own `callidescope.config
 **19. `PathCommand.parseTags`** — depth 3 · decorated-method
 
 ```text
-🚀 PathCommand.parseTags(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:204]
+🚀 PathCommand.parseTags(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:208]
    ↳ Parses the Nx tags a query searches across, matched exactly against project tags.
-  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:293]
+  └─> ConfigurationService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/configuration/configuration.service.ts:292]
      ↳ Trims an optional string option, treating blank as absent.
     └─> InputService.parseOptionalOption(value: string | undefined): string | undefined [projects/ic-suite/codependix/codependix-configuration/src/modules/input/input.service.ts:75]
        ↳ Trims an optional string option, treating blank as absent.
@@ -721,37 +723,37 @@ What this project is judged against, as declared in its own `callidescope.config
 
 | Callable | Breadth | Calls directly | Location |
 | --- | --- | --- | --- |
-| `MapCommand.runMode` | 7 | `MapCommand.resolveContext`, `ConfigurationService.touchesFiles`, `MapCommand.runExports`, `BoundaryCheckService.run`, `MapCommand.runCombinedOutput`, `ReportingService.reportPassOutcomes`, `ReportingService.reportSuccess` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:187` |
-| `PathCommand.run` | 5 | `PathCommand.validateInputs`, `RunContextService.build`, `PathQueryService.query`, `PathQueryService.render`, `ReportingService.reportFailure` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:214` |
-| `MapCommand.run` | 4 | `ConfigurationService.selectMode`, `CombinedOutputService.resolveFormat`, `MapCommand.runMode`, `ReportingService.reportFailure` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:472` |
+| `MapCommand.runMode` | 7 | `MapCommand.resolveContext`, `ConfigurationService.touchesFiles`, `MapCommand.runExports`, `BoundaryCheckService.run`, `MapCommand.runCombinedOutput`, `ReportingService.reportPassOutcomes`, `ReportingService.reportSuccess` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:193` |
+| `PathCommand.run` | 6 | `PathCommand.validateInputs`, `RunContextService.build`, `ConfigurationService.requireConfigurationPath`, `PathQueryService.query`, `PathQueryService.render`, `ReportingService.reportFailure` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:218` |
+| `MapCommand.resolveContext` | 4 | `RunContextService.build`, `ConfigurationService.requireConfigurationPath`, `ReportingService.reportUnmatchedSelection`, `RunContextService.findUnmatchedSelection` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:116` |
 
 <details>
 <summary>22 more callables</summary>
 
 | Callable | Breadth | Calls directly | Location |
 | --- | --- | --- | --- |
-| `MapCommand.resolveContext` | 3 | `RunContextService.build`, `ReportingService.reportUnmatchedSelection`, `RunContextService.findUnmatchedSelection` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:114` |
-| `MapCommand.runCombinedOutput` | 2 | `MapCommand.buildBoundaryReport`, `CombinedOutputService.run` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:135` |
-| `MapCommand.runExports` | 2 | `GraphRunService.run`, `ReportingService.reportEmptySelection` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:168` |
-| `MapCommand.buildBoundaryReport` | 1 | `MapCommand.map(…)` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:87` |
-| `MapCommand.parseConfig` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:248` |
-| `MapCommand.parseDirectory` | 1 | `ConfigurationService.parsePathOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:271` |
-| `MapCommand.parseExclude` | 1 | `ConfigurationService.parseCommaDelimitedOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:287` |
-| `MapCommand.parseFormat` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:311` |
-| `MapCommand.parseInclude` | 1 | `ConfigurationService.parseCommaDelimitedOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:326` |
-| `MapCommand.parseJsonOutput` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:339` |
-| `MapCommand.parseMarkdownOutput` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:352` |
-| `MapCommand.parseProjects` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:431` |
-| `MapCommand.parseTags` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:444` |
-| `MapCommand.parseWrite` | 1 | `ConfigurationService.parseFlagOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:454` |
-| `PathCommand.validateInputs` | 1 | `PathQueryService.resolveFormat` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:53` |
-| `PathCommand.parseConfig` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:89` |
-| `PathCommand.parseDirectory` | 1 | `ConfigurationService.parsePathOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:98` |
-| `PathCommand.parseExclude` | 1 | `ConfigurationService.parseCommaDelimitedOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:107` |
-| `PathCommand.parseFormat` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:130` |
-| `PathCommand.parseInclude` | 1 | `ConfigurationService.parseCommaDelimitedOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:139` |
-| `PathCommand.parseProjects` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:194` |
-| `PathCommand.parseTags` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:204` |
+| `MapCommand.run` | 4 | `ConfigurationService.selectMode`, `CombinedOutputService.resolveFormat`, `MapCommand.runMode`, `ReportingService.reportFailure` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:479` |
+| `MapCommand.runCombinedOutput` | 2 | `MapCommand.buildBoundaryReport`, `CombinedOutputService.run` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:141` |
+| `MapCommand.runExports` | 2 | `GraphRunService.run`, `ReportingService.reportEmptySelection` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:174` |
+| `MapCommand.buildBoundaryReport` | 1 | `MapCommand.map(…)` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:89` |
+| `MapCommand.parseConfig` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:254` |
+| `MapCommand.parseDirectory` | 1 | `ConfigurationService.parsePathOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:278` |
+| `MapCommand.parseExclude` | 1 | `ConfigurationService.parseCommaDelimitedOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:294` |
+| `MapCommand.parseFormat` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:318` |
+| `MapCommand.parseInclude` | 1 | `ConfigurationService.parseCommaDelimitedOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:333` |
+| `MapCommand.parseJsonOutput` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:346` |
+| `MapCommand.parseMarkdownOutput` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:359` |
+| `MapCommand.parseProjects` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:438` |
+| `MapCommand.parseTags` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:451` |
+| `MapCommand.parseWrite` | 1 | `ConfigurationService.parseFlagOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/map/map.command.ts:461` |
+| `PathCommand.validateInputs` | 1 | `PathQueryService.resolveFormat` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:56` |
+| `PathCommand.parseConfig` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:92` |
+| `PathCommand.parseDirectory` | 1 | `ConfigurationService.parsePathOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:102` |
+| `PathCommand.parseExclude` | 1 | `ConfigurationService.parseCommaDelimitedOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:111` |
+| `PathCommand.parseFormat` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:134` |
+| `PathCommand.parseInclude` | 1 | `ConfigurationService.parseCommaDelimitedOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:143` |
+| `PathCommand.parseProjects` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:198` |
+| `PathCommand.parseTags` | 1 | `ConfigurationService.parseOptionalOption` | `projects/ic-suite/codependix/codependix-cli/src/modules/path/path.command.ts:208` |
 
 </details>
 <!-- callidescope:end -->
@@ -762,14 +764,14 @@ What this project is judged against, as declared in its own `callidescope.config
 
 ### Project
 
-![Lines of Code](https://img.shields.io/badge/Lines_of_Code-4175-22c55e?style=flat-square)
-![Repository Size](https://img.shields.io/badge/Repository_Size-149.61_kB-6b7280?style=flat-square)
+![Lines of Code](https://img.shields.io/badge/Lines_of_Code-4332-22c55e?style=flat-square)
+![Repository Size](https://img.shields.io/badge/Repository_Size-155.19_kB-6b7280?style=flat-square)
 ![Folders](https://img.shields.io/badge/Folders-5-4a4a4a?style=flat-square)
 ![Source Files](https://img.shields.io/badge/Source_Files-31-3178c6?style=flat-square)
 
 ### Measured Targets
 
-![Compiled JavaScript Size](https://img.shields.io/badge/Compiled_JavaScript_Size-5.85_kB_gzip-6b7280?style=flat-square)
+![Compiled JavaScript Size](https://img.shields.io/badge/Compiled_JavaScript_Size-5.92_kB_gzip-6b7280?style=flat-square)
 
 ### TypeScript
 
@@ -778,7 +780,7 @@ What this project is judged against, as declared in its own `callidescope.config
 ![Generic Declarations](https://img.shields.io/badge/Generic_Declarations-0-0369a1?style=flat-square)
 ![Enums](https://img.shields.io/badge/Enums-0-f97316?style=flat-square)
 ![Decorators](https://img.shields.io/badge/Decorators-39-db2777?style=flat-square)
-![Doc Comments](https://img.shields.io/badge/Doc_Comments-43-6366f1?style=flat-square)
+![Doc Comments](https://img.shields.io/badge/Doc_Comments-45-6366f1?style=flat-square)
 ![Static Methods](https://img.shields.io/badge/Static_Methods-1-166534?style=flat-square)
 
 ### JavaScript
@@ -787,15 +789,15 @@ What this project is judged against, as declared in its own `callidescope.config
 ![Test Files](https://img.shields.io/badge/Test_Files-10-10b981?style=flat-square)
 ![External Packages](https://img.shields.io/badge/External_Packages-19-8b5cf6?style=flat-square)
 ![Classes](https://img.shields.io/badge/Classes-6-7c3aed?style=flat-square)
-![Functions](https://img.shields.io/badge/Functions-224-16a34a?style=flat-square)
+![Functions](https://img.shields.io/badge/Functions-232-16a34a?style=flat-square)
 ![Methods](https://img.shields.io/badge/Methods-46-15803d?style=flat-square)
-![Sync Functions](https://img.shields.io/badge/Sync_Functions-173-4ade80?style=flat-square)
-![Async Functions](https://img.shields.io/badge/Async_Functions-97-059669?style=flat-square)
-![Constants](https://img.shields.io/badge/Constants-152-dc2626?style=flat-square)
-![Imports](https://img.shields.io/badge/Imports-114-0284c7?style=flat-square)
-![Exported Symbols](https://img.shields.io/badge/Exported_Symbols-10-ea580c?style=flat-square)
-![Comments](https://img.shields.io/badge/Comments-136-64748b?style=flat-square)
-![Comment Lines](https://img.shields.io/badge/Comment_Lines-253-475569?style=flat-square)
+![Sync Functions](https://img.shields.io/badge/Sync_Functions-178-4ade80?style=flat-square)
+![Async Functions](https://img.shields.io/badge/Async_Functions-100-059669?style=flat-square)
+![Constants](https://img.shields.io/badge/Constants-158-dc2626?style=flat-square)
+![Imports](https://img.shields.io/badge/Imports-115-0284c7?style=flat-square)
+![Exported Symbols](https://img.shields.io/badge/Exported_Symbols-12-ea580c?style=flat-square)
+![Comments](https://img.shields.io/badge/Comments-138-64748b?style=flat-square)
+![Comment Lines](https://img.shields.io/badge/Comment_Lines-255-475569?style=flat-square)
 ![TODO Comments](https://img.shields.io/badge/TODO_Comments-0-ca8a04?style=flat-square)
 
 ### Python
@@ -951,20 +953,20 @@ What this project is judged against, as declared in its own `callidescope.config
 ### Markdown
 
 ![Markdown Files](https://img.shields.io/badge/Markdown_Files-2-083fa1?style=flat-square)
-![Markdown Lines](https://img.shields.io/badge/Markdown_Lines-513-1f6feb?style=flat-square)
+![Markdown Lines](https://img.shields.io/badge/Markdown_Lines-535-1f6feb?style=flat-square)
 ![H1](https://img.shields.io/badge/H1-1-7c3aed?style=flat-square)
-![H2](https://img.shields.io/badge/H2-33-8b5cf6?style=flat-square)
-![H3](https://img.shields.io/badge/H3-49-a78bfa?style=flat-square)
+![H2](https://img.shields.io/badge/H2-35-8b5cf6?style=flat-square)
+![H3](https://img.shields.io/badge/H3-52-a78bfa?style=flat-square)
 ![H4](https://img.shields.io/badge/H4-0-c4b5fd?style=flat-square)
 ![H5](https://img.shields.io/badge/H5-0-ddd6fe?style=flat-square)
 ![H6](https://img.shields.io/badge/H6-0-ede9fe?style=flat-square)
-![Paragraphs](https://img.shields.io/badge/Paragraphs-159-64748b?style=flat-square)
-![Lists](https://img.shields.io/badge/Lists-41-16a34a?style=flat-square)
-![List Items](https://img.shields.io/badge/List_Items-138-22c55e?style=flat-square)
+![Paragraphs](https://img.shields.io/badge/Paragraphs-168-64748b?style=flat-square)
+![Lists](https://img.shields.io/badge/Lists-44-16a34a?style=flat-square)
+![List Items](https://img.shields.io/badge/List_Items-147-22c55e?style=flat-square)
 ![Task List Items](https://img.shields.io/badge/Task_List_Items-0-4ade80?style=flat-square)
 ![Tables](https://img.shields.io/badge/Tables-2-0284c7?style=flat-square)
 ![Table Rows](https://img.shields.io/badge/Table_Rows-10-0ea5e9?style=flat-square)
-![Links](https://img.shields.io/badge/Links-27-059669?style=flat-square)
+![Links](https://img.shields.io/badge/Links-28-059669?style=flat-square)
 ![Images](https://img.shields.io/badge/Images-0-10b981?style=flat-square)
 ![Code Blocks](https://img.shields.io/badge/Code_Blocks-13-dc2626?style=flat-square)
 ![Inline Code](https://img.shields.io/badge/Inline_Code-78-ef4444?style=flat-square)

package/dist/{codependix-cli.module-D9-jrLaT.js → codependix-cli.module-n4u4tMtB.js}

@@ -201,7 +201,7 @@ B = __decorate([i(), o({
 })], B);
 //#endregion
 //#region projects/ic-suite/codependix/codependix-cli/src/codependix-cli.constants.ts
-var V = m.object({}), H, U = H = class MapCommand extends t {
+var V = m.object({}), H = "`--config` flag", U, W = U = class MapCommand extends t {
 	graphRunService;
 	boundaryCheckService;
 	combinedOutputService;
@@ -210,7 +210,7 @@ var V = m.object({}), H, U = H = class MapCommand extends t {
 	reportingService;
 	runContextService;
 	constructor(e, t, n, r, i, a, o) {
-		super(), this.graphRunService = e, this.boundaryCheckService = t, this.combinedOutputService = n, this.configurationService = r, this.logger = i, this.reportingService = a, this.runContextService = o, this.logger.setContext(H.name);
+		super(), this.graphRunService = e, this.boundaryCheckService = t, this.combinedOutputService = n, this.configurationService = r, this.logger = i, this.reportingService = a, this.runContextService = o, this.logger.setContext(U.name);
 	}
 	buildBoundaryReport(e) {
 		let { boundaryOutcome: t, context: n, options: r } = e, i = r.format !== void 0 || r.jsonOutput !== void 0 || r.markdownOutput !== void 0;
@@ -222,6 +222,7 @@ var V = m.object({}), H, U = H = class MapCommand extends t {
 	async resolveContext(e) {
 		let t = await this.runContextService.build({
 			...e,
+			configuration: this.configurationService.requireConfigurationPath(e.options.config, H),
 			workingDirectory: u.resolve(e.options.directory ?? process.cwd())
 		});
 		return this.reportingService.reportUnmatchedSelection(this.runContextService.findUnmatchedSelection(t)), t;
@@ -347,15 +348,16 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [String]),
 	__decorateMetadata("design:returntype", String)
-], U.prototype, "parseCheck", null), __decorate([
+], W.prototype, "parseCheck", null), __decorate([
 	n({
-		description: "Path to the codependix configuration file",
-		flags: "--config [config]"
+		description: "Path to the codependix configuration file (required)",
+		flags: "--config <config>",
+		required: !0
 	}),
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [Object]),
 	__decorateMetadata("design:returntype", Object)
-], U.prototype, "parseConfig", null), __decorate([
+], W.prototype, "parseConfig", null), __decorate([
 	n({
 		description: "Build --check boundaries over the dependencies of the projects --projects or --tags named, reporting their findings as notes (default). No effect without --projects or --tags",
 		flags: "--dependencies"
@@ -363,7 +365,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", []),
 	__decorateMetadata("design:returntype", Boolean)
-], U.prototype, "parseDependencies", null), __decorate([
+], W.prototype, "parseDependencies", null), __decorate([
 	n({
 		description: "Directory whose Nx workspace this run reads",
 		flags: "-d, --directory [directory]"
@@ -371,7 +373,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [Object]),
 	__decorateMetadata("design:returntype", String)
-], U.prototype, "parseDirectory", null), __decorate([
+], W.prototype, "parseDirectory", null), __decorate([
 	n({
 		description: "Comma-separated globs overriding the configured exclude. Refused when exclude was never configured",
 		flags: "--exclude [exclude]"
@@ -379,7 +381,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [Object]),
 	__decorateMetadata("design:returntype", Array)
-], U.prototype, "parseExclude", null), __decorate([
+], W.prototype, "parseExclude", null), __decorate([
 	n({
 		description: "Build, check, and write the fileImports graph type",
 		flags: "--file-imports"
@@ -387,7 +389,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", []),
 	__decorateMetadata("design:returntype", Boolean)
-], U.prototype, "parseFileImports", null), __decorate([
+], W.prototype, "parseFileImports", null), __decorate([
 	n({
 		description: `What to print to standard output, one of ${T.join(" and ")} (default: ${w}). A graph type prints only when this run also configured a workspace destination for it, even if its own toggle flag enabled it. A --check boundaries run adds its findings, under a boundaries key in json and a Boundaries section in markdown`,
 		flags: "-f, --format [format]"
@@ -395,7 +397,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [Object]),
 	__decorateMetadata("design:returntype", Object)
-], U.prototype, "parseFormat", null), __decorate([
+], W.prototype, "parseFormat", null), __decorate([
 	n({
 		description: "Comma-separated globs overriding the configured include. Refused when include was never configured",
 		flags: "--include [include]"
@@ -403,7 +405,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [Object]),
 	__decorateMetadata("design:returntype", Array)
-], U.prototype, "parseInclude", null), __decorate([
+], W.prototype, "parseInclude", null), __decorate([
 	n({
 		description: "Write every active graph type's data, combined into one JSON file at this path, keyed by graph type name. A type appears only when this run also configured a workspace destination for it. A --check boundaries run adds its findings under a boundaries key",
 		flags: "--json-output [jsonOutput]"
@@ -411,7 +413,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [Object]),
 	__decorateMetadata("design:returntype", Object)
-], U.prototype, "parseJsonOutput", null), __decorate([
+], W.prototype, "parseJsonOutput", null), __decorate([
 	n({
 		description: "Write every active graph type's rendered diagram, combined into one Markdown file at this path. A type appears only when this run also configured a workspace destination for it. A --check boundaries run adds its findings as a Boundaries section",
 		flags: "--markdown-output [markdownOutput]"
@@ -419,7 +421,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [Object]),
 	__decorateMetadata("design:returntype", Object)
-], U.prototype, "parseMarkdownOutput", null), __decorate([
+], W.prototype, "parseMarkdownOutput", null), __decorate([
 	n({
 		description: "Build, check, and write the nestjsModules graph type",
 		flags: "--nestjs-modules"
@@ -427,7 +429,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", []),
 	__decorateMetadata("design:returntype", Boolean)
-], U.prototype, "parseNestjsModules", null), __decorate([
+], W.prototype, "parseNestjsModules", null), __decorate([
 	n({
 		description: "Build --check boundaries over only the projects --projects or --tags named, not their dependencies. No effect without --projects or --tags",
 		flags: "--no-dependencies"
@@ -435,7 +437,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", []),
 	__decorateMetadata("design:returntype", Boolean)
-], U.prototype, "parseNoDependencies", null), __decorate([
+], W.prototype, "parseNoDependencies", null), __decorate([
 	n({
 		description: "Skip the fileImports graph type for this run",
 		flags: "--no-file-imports"
@@ -443,7 +445,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", []),
 	__decorateMetadata("design:returntype", Boolean)
-], U.prototype, "parseNoFileImports", null), __decorate([
+], W.prototype, "parseNoFileImports", null), __decorate([
 	n({
 		description: "Skip the nestjsModules graph type for this run",
 		flags: "--no-nestjs-modules"
@@ -451,7 +453,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", []),
 	__decorateMetadata("design:returntype", Boolean)
-], U.prototype, "parseNoNestjsModules", null), __decorate([
+], W.prototype, "parseNoNestjsModules", null), __decorate([
 	n({
 		description: "Skip the nxProjects graph type for this run",
 		flags: "--no-nx-projects"
@@ -459,7 +461,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", []),
 	__decorateMetadata("design:returntype", Boolean)
-], U.prototype, "parseNoNxProjects", null), __decorate([
+], W.prototype, "parseNoNxProjects", null), __decorate([
 	n({
 		description: "Build, check, and write the nxProjects graph type",
 		flags: "--nx-projects"
@@ -467,7 +469,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", []),
 	__decorateMetadata("design:returntype", Boolean)
-], U.prototype, "parseNxProjects", null), __decorate([
+], W.prototype, "parseNxProjects", null), __decorate([
 	n({
 		description: "Comma-separated project names or roots to export for, as globs, beyond those include already selects. Also narrows the Workspace Graph to the named set, and --check boundaries to failing only on findings charged to it",
 		flags: "--projects [projects]"
@@ -475,7 +477,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [Object]),
 	__decorateMetadata("design:returntype", Object)
-], U.prototype, "parseProjects", null), __decorate([
+], W.prototype, "parseProjects", null), __decorate([
 	n({
 		description: "Comma-separated Nx tags to export for, beyond what include already selects. Narrows the Workspace Graph and --check boundaries to the tagged projects, as --projects does",
 		flags: "--tags [tags]"
@@ -483,7 +485,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [Object]),
 	__decorateMetadata("design:returntype", Object)
-], U.prototype, "parseTags", null), __decorate([
+], W.prototype, "parseTags", null), __decorate([
 	n({
 		description: "Write every configured export",
 		flags: "--write"
@@ -491,7 +493,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [Object]),
 	__decorateMetadata("design:returntype", Boolean)
-], U.prototype, "parseWrite", null), U = H = __decorate([
+], W.prototype, "parseWrite", null), W = U = __decorate([
 	e({
 		description: "Map every configured dependency graph and export it",
 		name: "map"
@@ -506,13 +508,13 @@ __decorate([
 		M === void 0 ? Object : M,
 		v === void 0 ? Object : v
 	])
-], U);
+], W);
 //#endregion
 //#region projects/ic-suite/codependix/codependix-cli/src/modules/map/map.module.ts
-var W = class MapModule {};
-W = __decorate([o({
+var G = class MapModule {};
+G = __decorate([o({
 	controllers: [],
-	exports: [U],
+	exports: [W],
 	imports: [
 		h,
 		S,
@@ -521,22 +523,22 @@ W = __decorate([o({
 		j,
 		_
 	],
-	providers: [U]
-})], W);
+	providers: [W]
+})], G);
 //#endregion
 //#region projects/ic-suite/codependix/codependix-cli/src/modules/path/path.constants.ts
-var G = "The path command requires both <from> and <to> arguments, as in \"codependix path <from> <to>\".", K, q = K = class PathCommand extends t {
+var K = "The path command requires both <from> and <to> arguments, as in \"codependix path <from> <to>\".", q = "`--config` flag", J, Y = J = class PathCommand extends t {
 	configurationService;
 	logger;
 	pathQueryService;
 	reportingService;
 	runContextService;
 	constructor(e, t, n, r, i) {
-		super(), this.configurationService = e, this.logger = t, this.pathQueryService = n, this.reportingService = r, this.runContextService = i, this.logger.setContext(K.name);
+		super(), this.configurationService = e, this.logger = t, this.pathQueryService = n, this.reportingService = r, this.runContextService = i, this.logger.setContext(J.name);
 	}
 	validateInputs(e, t) {
 		let n = e[0], r = e[1];
-		if (!n || !r) return this.logger.error("🕸️ Rejected the command line", void 0, { reasons: [G] }), process.exitCode = 1, null;
+		if (!n || !r) return this.logger.error("🕸️ Rejected the command line", void 0, { reasons: [K] }), process.exitCode = 1, null;
 		let { errors: i, format: a } = this.pathQueryService.resolveFormat(t.format);
 		return i.length > 0 ? (this.logger.error("🕸️ Rejected the command line", void 0, { reasons: i }), process.exitCode = 1, null) : {
 			format: a,
@@ -588,6 +590,7 @@ var G = "The path command requires both <from> and <to> arguments, as in \"codep
 			let n = this.validateInputs(e, t);
 			if (!n) return;
 			let r = await this.runContextService.build({
+				configuration: this.configurationService.requireConfigurationPath(t.config, q),
 				mode: "check",
 				options: t,
 				workingDirectory: u.resolve(t.directory ?? process.cwd())
@@ -607,13 +610,14 @@ var G = "The path command requires both <from> and <to> arguments, as in \"codep
 };
 __decorate([
 	n({
-		description: "Path to the codependix configuration file",
-		flags: "--config [config]"
+		description: "Path to the codependix configuration file (required)",
+		flags: "--config <config>",
+		required: !0
 	}),
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [Object]),
 	__decorateMetadata("design:returntype", Object)
-], q.prototype, "parseConfig", null), __decorate([
+], Y.prototype, "parseConfig", null), __decorate([
 	n({
 		description: "Directory whose Nx workspace this run reads",
 		flags: "-d, --directory [directory]"
@@ -621,7 +625,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [Object]),
 	__decorateMetadata("design:returntype", String)
-], q.prototype, "parseDirectory", null), __decorate([
+], Y.prototype, "parseDirectory", null), __decorate([
 	n({
 		description: "Comma-separated globs overriding the configured exclude. Refused when exclude was never configured",
 		flags: "--exclude [exclude]"
@@ -629,7 +633,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [Object]),
 	__decorateMetadata("design:returntype", Array)
-], q.prototype, "parseExclude", null), __decorate([
+], Y.prototype, "parseExclude", null), __decorate([
 	n({
 		description: "Query the fileImports graph type",
 		flags: "--file-imports"
@@ -637,7 +641,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", []),
 	__decorateMetadata("design:returntype", Boolean)
-], q.prototype, "parseFileImports", null), __decorate([
+], Y.prototype, "parseFileImports", null), __decorate([
 	n({
 		description: `What to print to standard output, one of ${O.join(", ")} (default: ${w})`,
 		flags: "-f, --format [format]"
@@ -645,7 +649,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [Object]),
 	__decorateMetadata("design:returntype", Object)
-], q.prototype, "parseFormat", null), __decorate([
+], Y.prototype, "parseFormat", null), __decorate([
 	n({
 		description: "Comma-separated globs overriding the configured include. Refused when include was never configured",
 		flags: "--include [include]"
@@ -653,7 +657,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [Object]),
 	__decorateMetadata("design:returntype", Array)
-], q.prototype, "parseInclude", null), __decorate([
+], Y.prototype, "parseInclude", null), __decorate([
 	n({
 		description: "Query the nestjsModules graph type",
 		flags: "--nestjs-modules"
@@ -661,7 +665,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", []),
 	__decorateMetadata("design:returntype", Boolean)
-], q.prototype, "parseNestjsModules", null), __decorate([
+], Y.prototype, "parseNestjsModules", null), __decorate([
 	n({
 		description: "Skip the fileImports graph type for this query",
 		flags: "--no-file-imports"
@@ -669,7 +673,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", []),
 	__decorateMetadata("design:returntype", Boolean)
-], q.prototype, "parseNoFileImports", null), __decorate([
+], Y.prototype, "parseNoFileImports", null), __decorate([
 	n({
 		description: "Skip the nestjsModules graph type for this query",
 		flags: "--no-nestjs-modules"
@@ -677,7 +681,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", []),
 	__decorateMetadata("design:returntype", Boolean)
-], q.prototype, "parseNoNestjsModules", null), __decorate([
+], Y.prototype, "parseNoNestjsModules", null), __decorate([
 	n({
 		description: "Skip the nxProjects graph type for this query",
 		flags: "--no-nx-projects"
@@ -685,7 +689,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", []),
 	__decorateMetadata("design:returntype", Boolean)
-], q.prototype, "parseNoNxProjects", null), __decorate([
+], Y.prototype, "parseNoNxProjects", null), __decorate([
 	n({
 		description: "Query the nxProjects graph type",
 		flags: "--nx-projects"
@@ -693,7 +697,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", []),
 	__decorateMetadata("design:returntype", Boolean)
-], q.prototype, "parseNxProjects", null), __decorate([
+], Y.prototype, "parseNxProjects", null), __decorate([
 	n({
 		description: "Comma-separated project names or roots to search across, as globs, beyond those include already selects",
 		flags: "--projects [projects]"
@@ -701,7 +705,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [Object]),
 	__decorateMetadata("design:returntype", Object)
-], q.prototype, "parseProjects", null), __decorate([
+], Y.prototype, "parseProjects", null), __decorate([
 	n({
 		description: "Comma-separated Nx tags to search across, beyond what include already selects",
 		flags: "--tags [tags]"
@@ -709,7 +713,7 @@ __decorate([
 	__decorateMetadata("design:type", Function),
 	__decorateMetadata("design:paramtypes", [Object]),
 	__decorateMetadata("design:returntype", Object)
-], q.prototype, "parseTags", null), q = K = __decorate([
+], Y.prototype, "parseTags", null), Y = J = __decorate([
 	e({
 		arguments: "<from> <to>",
 		description: "Find the shortest connecting path between two nodes in codependix graphs",
@@ -723,25 +727,25 @@ __decorate([
 		M === void 0 ? Object : M,
 		v === void 0 ? Object : v
 	])
-], q);
+], Y);
 //#endregion
 //#region projects/ic-suite/codependix/codependix-cli/src/modules/path/path.module.ts
-var J = class PathModule {};
-J = __decorate([o({
+var X = class PathModule {};
+X = __decorate([o({
 	controllers: [],
-	exports: [q],
+	exports: [Y],
 	imports: [
 		b,
 		k,
 		j,
 		_
 	],
-	providers: [q]
-})], J);
+	providers: [Y]
+})], X);
 //#endregion
 //#region projects/ic-suite/codependix/codependix-cli/src/codependix-cli.module.ts
-var Y = class MainModule {};
-Y = __decorate([o({ imports: [
+var Z = class MainModule {};
+Z = __decorate([o({ imports: [
 	f.forRoot({
 		envFilePath: ".env",
 		isGlobal: !0,
@@ -749,8 +753,8 @@ Y = __decorate([o({ imports: [
 	}),
 	p,
 	B,
-	W,
-	J
-] })], Y);
+	G,
+	X
+] })], Z);
 //#endregion
-export { __name as a, z as i, W as n, U as r, Y as t };
+export { __name as a, z as i, G as n, W as r, Z as t };

package/dist/src/codependix-cli.main.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { i as e, t } from "../codependix-cli.module-D9-jrLaT.js";
+import { i as e, t } from "../codependix-cli.module-n4u4tMtB.js";
 import "reflect-metadata";
 import { CommandFactory as n } from "nest-commander";
 //#region projects/ic-suite/codependix/codependix-cli/src/codependix-cli.main.ts

package/dist/src/index.d.ts

@@ -433,7 +433,7 @@ export declare class MapCommand extends CommandRunner {
      * having been left off, which is how one flag came to gate two findings.
      */
     parseCheck(value: string): string;
-    /** Parses the optional configuration path from command-line input. */
+    /** Parses the required configuration path from command-line input. */
     parseConfig(value: string | undefined): string | undefined;
     /**
      * Builds `--projects`/`--tags` graphs over the named projects' dependency

package/dist/src/index.js

@@ -1 +1 @@
-export { t as MainModule, r as MapCommand, n as MapModule } from "../codependix-cli.module-D9-jrLaT.js";
+export { t as MainModule, r as MapCommand, n as MapModule } from "../codependix-cli.module-n4u4tMtB.js";

package/package.json

@@ -7,10 +7,10 @@
     "url": "https://github.com/organizzolini/codebase/issues"
   },
   "dependencies": {
-    "@codependix/boundaries": "0.0.28",
-    "@codependix/configuration": "0.0.29",
-    "@codependix/core": "0.0.27",
-    "@codependix/output": "0.0.28",
+    "@codependix/boundaries": "0.0.30",
+    "@codependix/configuration": "0.0.31",
+    "@codependix/core": "0.0.29",
+    "@codependix/output": "0.0.30",
     "@nestjs/common": "^11.1.21 || ^12.0.1",
     "@nestjs/config": "^12.0.0",
     "@nestjs/core": "^11.1.21 || ^12.0.1",
@@ -75,5 +75,5 @@
     "strict": true
   },
   "types": "./dist/src/index.d.ts",
-  "version": "0.0.29"
+  "version": "0.0.31"
 }