@callidescope/nx 0.0.1

package/README.md

@@ -0,0 +1,1041 @@
+# 🔭🧬 Callidescope Nx
+
+**An Nx plugin that traces call stacks per project, following the Nx dependency graph.**
+
+Canonical documentation for call-stack tracing, configuration, depth and breadth analysis, and report formats is in the
+[`@callidescope/cli` README](https://github.com/Organizzolini/codebase/tree/main/packages/ic-suite/callidescope/callidescope-cli#readme).
+`@callidescope/cli` is Nx-free on purpose: it takes `--directories`, each one a path holding its own `tsconfig.json`, so it
+works in any TypeScript workspace whether or not Nx is anywhere near it. This
+package is the one place in the toolchain that knows Nx exists, and the only
+one that depends on `@nx/devkit`.
+
+It adds two things the core CLI cannot know about:
+
+- **A target on every project**, so the workspace's task runner does the
+  selecting — `nx affected`, `--projects=tag:…`, caching, and all.
+- **Dependency-aware scope**, so a run over one project is scoped to everything
+  that project depends on rather than to the project alone.
+
+## Install
+
+```bash
+npm install --save-dev @callidescope/nx
+```
+
+Register it in `nx.json`:
+
+```json
+{
+  "plugins": [
+    {
+      "plugin": "@callidescope/nx",
+      "options": {
+        "configurationPath": "configuration/callidescope.config.ts"
+      }
+    }
+  ]
+}
+```
+
+| Option | Meaning |
+| ------ | ------- |
+| `configurationPath` | Where the callidescope configuration lives. The conventional root filenames are searched when omitted |
+| `traceTargetName` | Name of the inferred trace target. `trace` when omitted |
+| `depthTargetName` | Name of the inferred depth target. `depth` when omitted |
+| `breadthTargetName` | Name of the inferred breadth target. `breadth` when omitted |
+| `gateTargetName` | Name of the inferred gate target. `gate` when omitted |
+
+The target names are short because they read better on the command line than
+repeating the tool's name on both sides of the colon. Rename any of them from
+the registration if a workspace already uses one.
+
+## Usage
+
+Four targets are inferred onto every project holding a `tsconfig.json`, so
+selection is Nx's job rather than a flag of this package's own:
+
+```bash
+nx run callidescope-nx:trace                      # one project, with its dependencies
+nx run-many -t trace                              # the workspace
+nx run-many -t trace --projects=tag:type:package  # a category
+nx affected -t trace                              # only what changed
+```
+
+```bash
+nx run callidescope-nx:depth --addresses="packages/ic-suite/callidescope/callidescope-nx/src/modules/projects/projects.service.ts#ProjectsService.resolveDependencyClosure"
+nx run callidescope-nx:breadth --addresses="src/foo.service.ts#FooService.bar"
+
+# Several at once, which is what a rename spanning a handful of them needs
+nx run callidescope-nx:depth --addresses="src/a.service.ts#A.b,src/c.service.ts#C.d"
+```
+
+| Target | Answers |
+| ------ | ------- |
+| `gate` | Whether anything in the project broke the limits it is held to |
+| `trace` | Every call stack in the project, and which ones broke a limit |
+| `depth` | Every stack above and below each callable — callers up to a root, callees down to a leaf |
+| `breadth` | Each callable's direct callers and callees, side by side |
+
+`depth` and `breadth` take the same `<file>#<qualified-name>` addresses the
+`callidescope` command does — the form every printed stack already uses — and
+the same comma-separated `--addresses` flag it takes them through. Through the
+plugin they resolve against the project and its dependencies rather than the
+whole workspace, which is both faster and the set the addresses belong to.
+
+**Every address must resolve, or the task prints nothing.** A report covering
+only the addresses that were understood, under a task Nx recorded as
+successful, is worse than a failed one; each unmatched address is named and
+the task fails. Under `--format=json` the report is always an array, whatever
+the address count, matching what the command line prints.
+
+Unlike the command line, a missing `--addresses` is **refused rather than
+prompted for**: a task runner has nobody to ask.
+
+### The gate
+
+`gate` is the one of the four a pipeline is meant to read an exit code from,
+and the only one that prints nothing but its findings — the stacks and callables that
+decided the verdict, rather than every stack in the project. `nx affected -t gate`
+therefore gates a branch by the projects it changed, and the task that fails is
+named after the project that regressed, which one workspace-wide task never
+could.
+
+**A dependency's breach is that dependency's gate's business.** The trace
+reaches into the projects a gate's project depends on, because a stack that
+stops at a package boundary measures the wrong thing — but the verdict covers
+only the projects the task was scoped to. This is the line the publishing side
+already draws, one step further along: measurement reaches into dependencies,
+publishing does not, and judging does not either. Nothing escapes a verdict,
+because `nx affected` selects a changed dependency too and its own gate names
+it. `trace` narrows its verdict the same way, so the two targets on one project
+can never disagree about whose regression it was; its report still shows the
+whole closure, since only the verdict narrows.
+
+**Depth is gated always, breadth wherever a limit exists.** Not two modes to be
+selected between: `maximumDepth` has a default, so every project has a number
+and is judged by it, while `maximumBreadth` has none at any level — so a project
+that declared no breadth limit is judged against `Infinity` and can produce no
+breadth finding at all.
+
+**A gate that opened none of the judged project's own files fails.** A project
+reporting zero files of its own is not a clean project — it is a project
+nothing looked at, and a green task there would say the opposite with nothing
+in the output to correct it. The `callidescope` command fails the same case for
+the same reason.
+
+**`trace` prints that same block and passes on it** — the one rule the two
+targets act on differently, and the only place their verdicts part. A project
+the configuration excludes reads nothing of its own by definition and is given
+no `gate` for exactly that reason, so failing its `trace` as well would leave
+the one target it has permanently red for being configured as it was asked to
+be, and a red task that is always red is one a reader learns to ignore. It
+still prints, because whether a project's own code was read is a fact about the
+run either way and a reader has to be able to see it. Everything else — a stack
+over a depth limit, a callable over a breadth limit, a run that read nothing at
+all — fails both.
+
+**Asked per judged project, not of the whole run**, because narrowing the
+verdict made those two different questions. A project with dependencies has a
+non-empty run whatever became of its own sources, so an `exclude` that
+over-matches — which a project's own `callidescope.config.*` may write — leaves
+it owning no report content, owning no finding, and passing green over code
+nothing read. Demonstrated: `packages/ic-suite/codometer/codometer-output` given
+`{"exclude": ["**"]}` of its own traces its dependency's 102 callables and
+contributes none, which is a green gate on the run-wide question and a red one
+on this. The projects that went unread are named back, since `--projects` may
+judge several.
+
+**Files rather than callables**, which is the weaker question and the right
+one. A project can hold files that declare no callable at all — one whose
+`tsconfig.json` names only its own configuration files and its tests is the
+shape, and this repository has five — and those files were read, so a verdict
+on them is a verdict on something. Asking for a callable fails all five for
+holding no functions, which is a finding about nothing. The cost, stated
+plainly: a project whose sources are excluded while a configuration file of its
+own survives counts as read.
+
+Two adjacent cases fail alongside it, each saying what happened rather than
+failing mutely: a run that read **nothing at all**, which is what an unread
+leaf project looks like, and an Nx selection that resolved to **no directory**.
+
+Its cache key names the project's own `callidescope.config.*` alongside the
+workspace configuration, so editing one project's limits re-runs that project's
+gate and no other project's. A dependency's sources are covered by `^default`,
+because a run measures its dependencies even though it does not judge them.
+
+Two projects are deliberately skipped by all four targets: the **workspace-root
+project**, whose targets would trace everything under one uncacheable task, and
+any project with **no `tsconfig.json`**, whose targets would be permanently
+empty. A project the configuration **excludes** — `exclude` or `excludeFrom` in
+the workspace file — additionally gets no `gate`: its own code is never traced,
+so a gate there would own no finding at all and report green for code it never
+read. It keeps the three that print something, `trace` included, which is what
+the unread exemption above is there to preserve: `packages/ic-suite/callidescope/callidescope-examples`
+is the case, and its stacks are still a report a reader can open.
+
+### Why the trace follows dependencies
+
+`nx run callidescope-cli:trace` traces `callidescope-cli` **and
+everything it depends on**, resolved transitively from the Nx project graph.
+
+A call stack runs downward — a command calls into the service it was injected
+with, which lives in a package it depends on — so a trace that stopped at a
+project's own boundary would measure the wrong thing.
+
+**A trace does not stop there without this plugin.**
+[`@callidescope/cli`](../callidescope-cli/README.md) builds a TypeScript
+program for every project the directories it was given transitively import, so
+a call into a dependency resolves to a real frame whether or not Nx is
+involved. Measured on this package,
+`callidescope --directories packages/ic-suite/callidescope/callidescope-nx` and
+`nx run callidescope-nx:trace` report the same 575 callables across 185 files
+in 7 projects.
+
+What the Nx graph decides is which projects the run is **scoped to** rather
+than merely reaches. This executor writes nothing anywhere — it renders one
+report and prints it — so the distinction costs nothing here, and widening the
+selection changes only which projects seed the closure. It is the command-line
+host that acts on it: a `--write` run there publishes a `## 🔭 Callidescope`
+section into a scoped project's `README.md` and leaves a reached one's to the
+run that is scoped to it. The graph also names dependencies no import closure
+can find — an implicit dependency, or an edge that exists only at run time.
+
+The two sets are not the same. The Nx graph gives `callidescope-nx` six
+projects; the import closure reaches seven, adding `codometer-configuration`,
+which this project's `tsconfig.json` pulls in through its own
+`codometer.config.ts` — a file the manifest has no reason to mention.
+
+Dependencies, never dependents: a project's dependents call _into_ it and add
+no frames below it.
+
+Pass `--withDependencies=false` to scope the run to the selected projects
+alone. The closure below them is built either way, so what changes is which
+projects the run calls its own — not how far a stack runs.
+
+### Executor options
+
+```bash
+nx run logger:trace --tags=type:package
+nx run logger:depth --addresses="a.ts#A.b" --projects=callidescope-cli
+```
+
+All three executors take the same scoping options.
+
+| Option | Meaning |
+| ------ | ------- |
+| `addresses` | `depth` and `breadth` only, and required: the callables to look up, comma-separated |
+| `projects` | Nx project names to resolve against, replacing the target's own project |
+| `tags` | Nx project tags, selecting every project carrying **any** of them |
+| `withDependencies` | Widen along the Nx dependency graph. `true` by default |
+| `format` | `markdown`, `mermaid`, or `json` |
+| `configurationPath` | Overrides the registered configuration path |
+
+`--projects` and `--tags` union rather than intersect, and a project reached
+both ways is still traced once. `--tags` matches **any** of the tags given,
+because Nx tag families are mutually exclusive on a single project — nothing is
+both `type:application` and `type:package`, so requiring all of them would
+select nothing.
+
+Prefer Nx's own `--projects=tag:…` on `run-many` for ordinary selection; these
+options exist for a target that wants to declare a fixed scope in its
+`project.json`.
+
+### Nothing resolves silently to less
+
+A project name the workspace does not have, or a tag no project carries, fails
+the task and names the workspace's actual vocabulary. Narrowing the run instead
+would let it pass while measuring less than it was asked to — and a report of
+what a run did cover cannot show you what it did not.
+
+## As a library
+
+The Nx-graph reading is a NestJS provider, for a host that would rather import
+it than run a task:
+
+```ts
+import { resolveProjectsService } from "@callidescope/nx";
+
+const projectsService = await resolveProjectsService();
+const graph = await projectsService.readProjectGraph();
+const names = projectsService.resolveDependencyClosure({
+  graph,
+  projectNames: ["callidescope-cli"],
+});
+const directories = projectsService.toDirectories({ graph, projectNames: names });
+```
+
+`readProjectGraph` is the only method that touches Nx at run time; every
+resolution rule takes the graph as an argument, so it can be exercised without
+a workspace to build one from.
+
+## Packages
+
+| Package | Role |
+| ------- | ---- |
+| [`@callidescope/nx`](.) | Nx plugin: per-project trace targets, resolved through the Nx graph |
+| [`@callidescope/cli`](../callidescope-cli/README.md) | Orchestrates a run: traces the workspace, plans what to check, and reports |
+| [`@callidescope/configuration`](../callidescope-configuration/README.md) | Reads `callidescope.config.ts` and resolves the limits |
+| [`@callidescope/graph`](../callidescope-graph/README.md) | Builds the call graph from traced source and measures depth and breadth |
+| [`@callidescope/output`](../callidescope-output/README.md) | Renders findings into markdown, mermaid, and JSON |
+
+## Test
+
+```bash
+nx run callidescope-nx:vitest
+```
+
+## Contributing
+
+```bash
+nx run callidescope-nx:lint-code --configuration=check
+```
+
+## License
+
+MIT — see [LICENSE](../../../../LICENSE).
+
+## 👔 Conformetry
+
+This project was generated from the [nestjs-service-project](../../../../configuration/conformetry-templates/nestjs-service-project) conformetry template.
+
+## 🕸️ Codependix
+
+Dependency graphs exported by [codependix](https://github.com/Organizzolini/codebase/tree/main/packages/ic-suite/codependix/codependix-cli), regenerated by `nx run codebase:codependix:write`.
+
+### Nx Neighborhood
+
+<!-- codependix:start name="codependix-nx-projects" -->
+```mermaid
+graph LR
+  callidescope_cli["callidescope-cli"]
+  callidescope_configuration["callidescope-configuration"]
+  callidescope_core["callidescope-core"]
+  callidescope_graph["callidescope-graph"]
+  callidescope_nx["callidescope-nx"]
+  callidescope_output["callidescope-output"]
+  logger["logger"]
+  callidescope_nx --> callidescope_cli
+  callidescope_nx --> callidescope_configuration
+  callidescope_nx --> callidescope_core
+  callidescope_nx --> callidescope_graph
+  callidescope_nx --> callidescope_output
+  callidescope_nx --> logger
+  classDef subject fill:#7c3aed,color:#fff,stroke:#4c1d95,stroke-width:2px
+  class callidescope_nx subject
+```
+<!-- codependix:end name="codependix-nx-projects" -->
+
+### NestJS Module Graph
+
+<!-- codependix:start name="codependix-nestjs-modules" -->
+```mermaid
+flowchart LR
+  AddressLookupModule
+  AddressModule
+  AddressReportModule
+  CallablesModule
+  CallidescopeModule
+  ClassesModule
+  ConfigurationFileModule
+  ConfigurationModule
+  DocumentationModule
+  EdgesModule
+  EntriesModule
+  FlagResolutionModule
+  GraphModule
+  InputModule
+  LoggerModule([LoggerModule])
+  MainModule
+  OptionsModule
+  OutputJsonModule
+  OutputMarkdownModule
+  PluginModule
+  ProgramModule
+  ProjectReportsModule
+  ProjectsModule
+  ReportFindingsModule
+  ReportModule
+  RunConfigurationModule
+  RunPlanModule
+  SignaturesModule
+  WorkspaceModule
+  WriteDestinationsModule
+  AddressLookupModule --> CallablesModule
+  AddressLookupModule --> CallidescopeModule
+  AddressLookupModule --> ConfigurationModule
+  AddressModule --> AddressLookupModule
+  AddressModule --> AddressReportModule
+  AddressModule --> GraphModule
+  AddressReportModule --> ReportModule
+  CallablesModule --> ProgramModule
+  CallablesModule --> WorkspaceModule
+  CallidescopeModule --> CallablesModule
+  CallidescopeModule --> ClassesModule
+  CallidescopeModule --> ConfigurationModule
+  CallidescopeModule --> EdgesModule
+  CallidescopeModule --> EntriesModule
+  CallidescopeModule --> GraphModule
+  CallidescopeModule --> OutputJsonModule
+  CallidescopeModule --> OutputMarkdownModule
+  CallidescopeModule --> ProgramModule
+  CallidescopeModule --> ProjectReportsModule
+  CallidescopeModule --> ReportFindingsModule
+  CallidescopeModule --> ReportModule
+  CallidescopeModule --> WorkspaceModule
+  CallidescopeModule --> WriteDestinationsModule
+  ConfigurationModule --> ConfigurationFileModule
+  ConfigurationModule --> InputModule
+  ConfigurationModule --> RunPlanModule
+  EdgesModule --> CallablesModule
+  EdgesModule --> ClassesModule
+  EdgesModule --> ProgramModule
+  EdgesModule --> WorkspaceModule
+  EntriesModule --> CallablesModule
+  GraphModule --> DocumentationModule
+  GraphModule --> EdgesModule
+  GraphModule --> SignaturesModule
+  MainModule --> AddressModule
+  MainModule --> PluginModule
+  PluginModule --> CallidescopeModule
+  PluginModule --> ConfigurationModule
+  PluginModule --> OptionsModule
+  PluginModule --> ProjectReportsModule
+  PluginModule --> ProjectsModule
+  PluginModule --> ReportModule
+  PluginModule --> RunConfigurationModule
+  PluginModule --> WorkspaceModule
+  ProgramModule --> WorkspaceModule
+  ProjectReportsModule --> GraphModule
+  ProjectReportsModule --> SignaturesModule
+  RunConfigurationModule --> ConfigurationModule
+  RunConfigurationModule --> OptionsModule
+  RunPlanModule --> FlagResolutionModule
+  WriteDestinationsModule --> OutputJsonModule
+  WriteDestinationsModule --> OutputMarkdownModule
+  WriteDestinationsModule --> ReportModule
+```
+
+_Rounded modules are global: every module can inject them, so their edges are left out._
+<!-- codependix:end name="codependix-nestjs-modules" -->
+
+### File Imports
+
+<!-- codependix:start name="codependix-file-imports" -->
+```mermaid
+graph LR
+  file_callidescope_config_ts["callidescope.config.ts"]
+  file_codependix_config_ts["codependix.config.ts"]
+  file_codometer_config_ts["codometer.config.ts"]
+  file_eslint_config_ts["eslint.config.ts"]
+  file_src_executors_address_types_ts["src/executors/address.types.ts"]
+  file_src_executors_breadth_executor_ts["src/executors/breadth/executor.ts"]
+  file_src_executors_breadth_executor_unit_test_ts["src/executors/breadth/executor.unit.test.ts"]
+  file_src_executors_depth_executor_ts["src/executors/depth/executor.ts"]
+  file_src_executors_depth_executor_unit_test_ts["src/executors/depth/executor.unit.test.ts"]
+  file_src_executors_gate_executor_integration_test_ts["src/executors/gate/executor.integration.test.ts"]
+  file_src_executors_gate_executor_ts["src/executors/gate/executor.ts"]
+  file_src_executors_gate_executor_types_ts["src/executors/gate/executor.types.ts"]
+  file_src_executors_gate_executor_unit_test_ts["src/executors/gate/executor.unit.test.ts"]
+  file_src_executors_trace_executor_ts["src/executors/trace/executor.ts"]
+  file_src_executors_trace_executor_types_ts["src/executors/trace/executor.types.ts"]
+  file_src_executors_trace_executor_unit_test_ts["src/executors/trace/executor.unit.test.ts"]
+  file_src_index_ts["src/index.ts"]
+  file_src_index_unit_test_ts["src/index.unit.test.ts"]
+  file_src_main_module_ts["src/main.module.ts"]
+  file_src_modules_address_address_constants_ts["src/modules/address/address.constants.ts"]
+  file_src_modules_address_address_module_ts["src/modules/address/address.module.ts"]
+  file_src_modules_address_address_service_ts["src/modules/address/address.service.ts"]
+  file_src_modules_address_address_service_unit_test_ts["src/modules/address/address.service.unit.test.ts"]
+  file_src_modules_address_address_types_ts["src/modules/address/address.types.ts"]
+  file_src_modules_address_address_utilities_ts["src/modules/address/address.utilities.ts"]
+  file_src_modules_address_address_utilities_unit_test_ts["src/modules/address/address.utilities.unit.test.ts"]
+  file_src_modules_options_options_constants_ts["src/modules/options/options.constants.ts"]
+  file_src_modules_options_options_module_ts["src/modules/options/options.module.ts"]
+  file_src_modules_options_options_service_ts["src/modules/options/options.service.ts"]
+  file_src_modules_options_options_service_unit_test_ts["src/modules/options/options.service.unit.test.ts"]
+  file_src_modules_options_options_types_ts["src/modules/options/options.types.ts"]
+  file_src_modules_plugin_plugin_context_utilities_ts["src/modules/plugin/plugin-context.utilities.ts"]
+  file_src_modules_plugin_plugin_context_utilities_unit_test_ts["src/modules/plugin/plugin-context.utilities.unit.test.ts"]
+  file_src_modules_plugin_plugin_constants_ts["src/modules/plugin/plugin.constants.ts"]
+  file_src_modules_plugin_plugin_module_ts["src/modules/plugin/plugin.module.ts"]
+  file_src_modules_plugin_plugin_service_ts["src/modules/plugin/plugin.service.ts"]
+  file_src_modules_plugin_plugin_service_unit_test_ts["src/modules/plugin/plugin.service.unit.test.ts"]
+  file_src_modules_plugin_plugin_types_ts["src/modules/plugin/plugin.types.ts"]
+  file_src_modules_plugin_plugin_utilities_ts["src/modules/plugin/plugin.utilities.ts"]
+  file_src_modules_projects_projects_constants_ts["src/modules/projects/projects.constants.ts"]
+  file_src_modules_projects_projects_module_ts["src/modules/projects/projects.module.ts"]
+  file_src_modules_projects_projects_service_ts["src/modules/projects/projects.service.ts"]
+  file_src_modules_projects_projects_service_unit_test_ts["src/modules/projects/projects.service.unit.test.ts"]
+  file_src_modules_projects_projects_types_ts["src/modules/projects/projects.types.ts"]
+  file_src_modules_run_configuration_run_configuration_constants_ts["src/modules/run-configuration/run-configuration.constants.ts"]
+  file_src_modules_run_configuration_run_configuration_module_ts["src/modules/run-configuration/run-configuration.module.ts"]
+  file_src_modules_run_configuration_run_configuration_service_ts["src/modules/run-configuration/run-configuration.service.ts"]
+  file_src_modules_run_configuration_run_configuration_service_unit_test_ts["src/modules/run-configuration/run-configuration.service.unit.test.ts"]
+  file_src_modules_run_configuration_run_configuration_types_ts["src/modules/run-configuration/run-configuration.types.ts"]
+  file_testing_mocks_ts["testing/mocks.ts"]
+  file_testing_setup_ts["testing/setup.ts"]
+  file_vite_config_ts["vite.config.ts"]
+  file_vitest_config_ts["vitest.config.ts"]
+  file_src_executors_breadth_executor_ts --> file_src_executors_address_types_ts
+  file_src_executors_breadth_executor_ts --> file_src_modules_address_address_utilities_ts
+  file_src_executors_breadth_executor_unit_test_ts --> file_src_executors_breadth_executor_ts
+  file_src_executors_breadth_executor_unit_test_ts --> file_src_modules_address_address_utilities_ts
+  file_src_executors_depth_executor_ts --> file_src_executors_address_types_ts
+  file_src_executors_depth_executor_ts --> file_src_modules_address_address_utilities_ts
+  file_src_executors_depth_executor_unit_test_ts --> file_src_executors_depth_executor_ts
+  file_src_executors_depth_executor_unit_test_ts --> file_src_modules_address_address_utilities_ts
+  file_src_executors_gate_executor_integration_test_ts --> file_src_executors_gate_executor_ts
+  file_src_executors_gate_executor_integration_test_ts --> file_src_executors_gate_executor_types_ts
+  file_src_executors_gate_executor_integration_test_ts --> file_src_modules_plugin_plugin_constants_ts
+  file_src_executors_gate_executor_integration_test_ts --> file_src_modules_projects_projects_service_ts
+  file_src_executors_gate_executor_ts --> file_src_executors_gate_executor_types_ts
+  file_src_executors_gate_executor_ts --> file_src_modules_plugin_plugin_context_utilities_ts
+  file_src_executors_gate_executor_ts --> file_src_modules_plugin_plugin_constants_ts
+  file_src_executors_gate_executor_ts --> file_src_modules_plugin_plugin_utilities_ts
+  file_src_executors_gate_executor_unit_test_ts --> file_src_executors_gate_executor_ts
+  file_src_executors_gate_executor_unit_test_ts --> file_src_modules_options_options_service_ts
+  file_src_executors_gate_executor_unit_test_ts --> file_src_modules_plugin_plugin_constants_ts
+  file_src_executors_gate_executor_unit_test_ts --> file_src_modules_plugin_plugin_service_ts
+  file_src_executors_gate_executor_unit_test_ts --> file_src_modules_plugin_plugin_types_ts
+  file_src_executors_trace_executor_ts --> file_src_executors_trace_executor_types_ts
+  file_src_executors_trace_executor_ts --> file_src_modules_plugin_plugin_context_utilities_ts
+  file_src_executors_trace_executor_ts --> file_src_modules_plugin_plugin_utilities_ts
+  file_src_executors_trace_executor_unit_test_ts --> file_src_executors_trace_executor_ts
+  file_src_executors_trace_executor_unit_test_ts --> file_src_modules_options_options_service_ts
+  file_src_executors_trace_executor_unit_test_ts --> file_src_modules_plugin_plugin_service_ts
+  file_src_executors_trace_executor_unit_test_ts --> file_src_modules_plugin_plugin_types_ts
+  file_src_index_ts --> file_src_modules_plugin_plugin_context_utilities_ts
+  file_src_index_ts --> file_src_modules_plugin_plugin_constants_ts
+  file_src_index_unit_test_ts --> file_src_index_ts
+  file_src_index_unit_test_ts --> file_src_modules_plugin_plugin_service_ts
+  file_src_index_unit_test_ts --> file_src_modules_plugin_plugin_types_ts
+  file_src_main_module_ts --> file_src_modules_address_address_module_ts
+  file_src_main_module_ts --> file_src_modules_plugin_plugin_module_ts
+  file_src_modules_address_address_module_ts --> file_src_modules_address_address_service_ts
+  file_src_modules_address_address_service_ts --> file_src_modules_address_address_types_ts
+  file_src_modules_address_address_service_unit_test_ts --> file_src_modules_address_address_service_ts
+  file_src_modules_address_address_utilities_ts --> file_src_executors_address_types_ts
+  file_src_modules_address_address_utilities_ts --> file_src_modules_plugin_plugin_context_utilities_ts
+  file_src_modules_address_address_utilities_ts --> file_src_modules_plugin_plugin_utilities_ts
+  file_src_modules_address_address_utilities_unit_test_ts --> file_src_modules_address_address_service_ts
+  file_src_modules_address_address_utilities_unit_test_ts --> file_src_modules_address_address_utilities_ts
+  file_src_modules_address_address_utilities_unit_test_ts --> file_src_modules_options_options_service_ts
+  file_src_modules_address_address_utilities_unit_test_ts --> file_src_modules_plugin_plugin_service_ts
+  file_src_modules_address_address_utilities_unit_test_ts --> file_src_modules_plugin_plugin_types_ts
+  file_src_modules_options_options_module_ts --> file_src_modules_options_options_service_ts
+  file_src_modules_options_options_service_ts --> file_src_modules_options_options_constants_ts
+  file_src_modules_options_options_service_ts --> file_src_modules_options_options_types_ts
+  file_src_modules_options_options_service_unit_test_ts --> file_src_modules_options_options_service_ts
+  file_src_modules_plugin_plugin_context_utilities_ts --> file_src_main_module_ts
+  file_src_modules_plugin_plugin_context_utilities_ts --> file_src_modules_address_address_service_ts
+  file_src_modules_plugin_plugin_context_utilities_ts --> file_src_modules_options_options_service_ts
+  file_src_modules_plugin_plugin_context_utilities_ts --> file_src_modules_plugin_plugin_constants_ts
+  file_src_modules_plugin_plugin_context_utilities_ts --> file_src_modules_plugin_plugin_service_ts
+  file_src_modules_plugin_plugin_context_utilities_ts --> file_src_modules_plugin_plugin_types_ts
+  file_src_modules_plugin_plugin_context_utilities_ts --> file_src_modules_projects_projects_service_ts
+  file_src_modules_plugin_plugin_context_utilities_unit_test_ts --> file_src_modules_address_address_service_ts
+  file_src_modules_plugin_plugin_context_utilities_unit_test_ts --> file_src_modules_options_options_service_ts
+  file_src_modules_plugin_plugin_context_utilities_unit_test_ts --> file_src_modules_plugin_plugin_context_utilities_ts
+  file_src_modules_plugin_plugin_context_utilities_unit_test_ts --> file_src_modules_plugin_plugin_service_ts
+  file_src_modules_plugin_plugin_context_utilities_unit_test_ts --> file_src_modules_projects_projects_service_ts
+  file_src_modules_plugin_plugin_module_ts --> file_src_modules_options_options_module_ts
+  file_src_modules_plugin_plugin_module_ts --> file_src_modules_plugin_plugin_service_ts
+  file_src_modules_plugin_plugin_module_ts --> file_src_modules_projects_projects_module_ts
+  file_src_modules_plugin_plugin_module_ts --> file_src_modules_run_configuration_run_configuration_module_ts
+  file_src_modules_plugin_plugin_service_ts --> file_src_modules_options_options_constants_ts
+  file_src_modules_plugin_plugin_service_ts --> file_src_modules_options_options_service_ts
+  file_src_modules_plugin_plugin_service_ts --> file_src_modules_options_options_types_ts
+  file_src_modules_plugin_plugin_service_ts --> file_src_modules_plugin_plugin_constants_ts
+  file_src_modules_plugin_plugin_service_ts --> file_src_modules_plugin_plugin_types_ts
+  file_src_modules_plugin_plugin_service_ts --> file_src_modules_projects_projects_service_ts
+  file_src_modules_plugin_plugin_service_ts --> file_src_modules_run_configuration_run_configuration_service_ts
+  file_src_modules_plugin_plugin_service_unit_test_ts --> file_src_modules_options_options_service_ts
+  file_src_modules_plugin_plugin_service_unit_test_ts --> file_src_modules_plugin_plugin_constants_ts
+  file_src_modules_plugin_plugin_service_unit_test_ts --> file_src_modules_plugin_plugin_service_ts
+  file_src_modules_plugin_plugin_service_unit_test_ts --> file_src_modules_plugin_plugin_types_ts
+  file_src_modules_plugin_plugin_service_unit_test_ts --> file_src_modules_projects_projects_service_ts
+  file_src_modules_plugin_plugin_service_unit_test_ts --> file_src_modules_run_configuration_run_configuration_service_ts
+  file_src_modules_plugin_plugin_types_ts --> file_src_modules_plugin_plugin_constants_ts
+  file_src_modules_plugin_plugin_utilities_ts --> file_src_modules_plugin_plugin_context_utilities_ts
+  file_src_modules_plugin_plugin_utilities_ts --> file_src_modules_plugin_plugin_types_ts
+  file_src_modules_projects_projects_module_ts --> file_src_modules_projects_projects_service_ts
+  file_src_modules_projects_projects_service_ts --> file_src_modules_projects_projects_types_ts
+  file_src_modules_projects_projects_service_unit_test_ts --> file_src_modules_projects_projects_service_ts
+  file_src_modules_run_configuration_run_configuration_module_ts --> file_src_modules_options_options_module_ts
+  file_src_modules_run_configuration_run_configuration_module_ts --> file_src_modules_run_configuration_run_configuration_service_ts
+  file_src_modules_run_configuration_run_configuration_service_ts --> file_src_modules_options_options_service_ts
+  file_src_modules_run_configuration_run_configuration_service_ts --> file_src_modules_run_configuration_run_configuration_constants_ts
+  file_src_modules_run_configuration_run_configuration_service_ts --> file_src_modules_run_configuration_run_configuration_types_ts
+  file_src_modules_run_configuration_run_configuration_service_unit_test_ts --> file_src_modules_options_options_service_ts
+  file_src_modules_run_configuration_run_configuration_service_unit_test_ts --> file_src_modules_run_configuration_run_configuration_service_ts
+```
+<!-- codependix:end name="codependix-file-imports" -->
+
+<!-- codometer:start -->
+
+## ⏲️ Codometer
+
+### Project
+
+![Lines of Code](https://img.shields.io/badge/Lines_of_Code-5826-22c55e?style=flat-square)
+![Repository Size](https://img.shields.io/badge/Repository_Size-215.51_kB-6b7280?style=flat-square)
+![Folders](https://img.shields.io/badge/Folders-13-4a4a4a?style=flat-square)
+![Source Files](https://img.shields.io/badge/Source_Files-53-3178c6?style=flat-square)
+
+### Measured Targets
+
+![Compiled JavaScript Size](https://img.shields.io/badge/Compiled_JavaScript_Size-9.81_kB_gzip-6b7280?style=flat-square)
+
+### TypeScript
+
+![TypeScript Files](https://img.shields.io/badge/TypeScript_Files-53-3178c6?style=flat-square)
+![Interfaces](https://img.shields.io/badge/Interfaces-19-0ea5e9?style=flat-square)
+![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-11-db2777?style=flat-square)
+![Doc Comments](https://img.shields.io/badge/Doc_Comments-167-6366f1?style=flat-square)
+![Static Methods](https://img.shields.io/badge/Static_Methods-0-166534?style=flat-square)
+
+### JavaScript
+
+![JavaScript Files](https://img.shields.io/badge/JavaScript_Files-0-f7df1e?style=flat-square)
+![Test Files](https://img.shields.io/badge/Test_Files-13-10b981?style=flat-square)
+![External Packages](https://img.shields.io/badge/External_Packages-17-8b5cf6?style=flat-square)
+![Classes](https://img.shields.io/badge/Classes-11-7c3aed?style=flat-square)
+![Functions](https://img.shields.io/badge/Functions-274-16a34a?style=flat-square)
+![Methods](https://img.shields.io/badge/Methods-56-15803d?style=flat-square)
+![Sync Functions](https://img.shields.io/badge/Sync_Functions-199-4ade80?style=flat-square)
+![Async Functions](https://img.shields.io/badge/Async_Functions-131-059669?style=flat-square)
+![Constants](https://img.shields.io/badge/Constants-168-dc2626?style=flat-square)
+![Imports](https://img.shields.io/badge/Imports-221-0284c7?style=flat-square)
+![Exported Symbols](https://img.shields.io/badge/Exported_Symbols-61-ea580c?style=flat-square)
+![Comments](https://img.shields.io/badge/Comments-319-64748b?style=flat-square)
+![Comment Lines](https://img.shields.io/badge/Comment_Lines-802-475569?style=flat-square)
+![TODO Comments](https://img.shields.io/badge/TODO_Comments-0-ca8a04?style=flat-square)
+
+### Python
+
+![Python Files](https://img.shields.io/badge/Python_Files-0-3776ab?style=flat-square)
+![Python Lines](https://img.shields.io/badge/Python_Lines-0-4b8bbe?style=flat-square)
+![Python Classes](https://img.shields.io/badge/Python_Classes-0-7c3aed?style=flat-square)
+![Python Functions](https://img.shields.io/badge/Python_Functions-0-16a34a?style=flat-square)
+![Python Protocols](https://img.shields.io/badge/Python_Protocols-0-0ea5e9?style=flat-square)
+![Python Constants](https://img.shields.io/badge/Python_Constants-0-dc2626?style=flat-square)
+![Python Imports](https://img.shields.io/badge/Python_Imports-0-0284c7?style=flat-square)
+![Python Decorators](https://img.shields.io/badge/Python_Decorators-0-db2777?style=flat-square)
+![Docstrings](https://img.shields.io/badge/Docstrings-0-6366f1?style=flat-square)
+![Docstring Lines](https://img.shields.io/badge/Docstring_Lines-0-818cf8?style=flat-square)
+![Python Comments](https://img.shields.io/badge/Python_Comments-0-64748b?style=flat-square)
+![Python Comment Lines](https://img.shields.io/badge/Python_Comment_Lines-0-475569?style=flat-square)
+
+### JSON
+
+![JSON Files](https://img.shields.io/badge/JSON_Files-9-a16207?style=flat-square)
+![JSON Lines](https://img.shields.io/badge/JSON_Lines-346-ca8a04?style=flat-square)
+![JSON Objects](https://img.shields.io/badge/JSON_Objects-85-7c3aed?style=flat-square)
+![JSON Arrays](https://img.shields.io/badge/JSON_Arrays-20-8b5cf6?style=flat-square)
+![JSON Properties](https://img.shields.io/badge/JSON_Properties-250-0284c7?style=flat-square)
+![JSON Strings](https://img.shields.io/badge/JSON_Strings-197-16a34a?style=flat-square)
+![JSON Numbers](https://img.shields.io/badge/JSON_Numbers-1-059669?style=flat-square)
+![JSON Booleans](https://img.shields.io/badge/JSON_Booleans-11-0ea5e9?style=flat-square)
+![JSON Nulls](https://img.shields.io/badge/JSON_Nulls-0-64748b?style=flat-square)
+![JSON Items](https://img.shields.io/badge/JSON_Items-55-475569?style=flat-square)
+![JSON Nodes](https://img.shields.io/badge/JSON_Nodes-314-dc2626?style=flat-square)
+![JSON Max Depth](https://img.shields.io/badge/JSON_Max_Depth-5-ea580c?style=flat-square)
+
+### YAML
+
+![YAML Files](https://img.shields.io/badge/YAML_Files-0-cb171e?style=flat-square)
+![YAML Lines](https://img.shields.io/badge/YAML_Lines-0-e34c26?style=flat-square)
+![YAML Documents](https://img.shields.io/badge/YAML_Documents-0-f97316?style=flat-square)
+![YAML Mappings](https://img.shields.io/badge/YAML_Mappings-0-7c3aed?style=flat-square)
+![YAML Sequences](https://img.shields.io/badge/YAML_Sequences-0-8b5cf6?style=flat-square)
+![YAML Keys](https://img.shields.io/badge/YAML_Keys-0-0284c7?style=flat-square)
+![YAML Scalars](https://img.shields.io/badge/YAML_Scalars-0-16a34a?style=flat-square)
+![YAML Anchors](https://img.shields.io/badge/YAML_Anchors-0-059669?style=flat-square)
+![YAML Aliases](https://img.shields.io/badge/YAML_Aliases-0-10b981?style=flat-square)
+![YAML Comments](https://img.shields.io/badge/YAML_Comments-0-64748b?style=flat-square)
+![YAML Max Depth](https://img.shields.io/badge/YAML_Max_Depth-0-ea580c?style=flat-square)
+
+### TOML
+
+![TOML Files](https://img.shields.io/badge/TOML_Files-0-9c4221?style=flat-square)
+![TOML Lines](https://img.shields.io/badge/TOML_Lines-0-b45309?style=flat-square)
+![TOML Tables](https://img.shields.io/badge/TOML_Tables-0-7c3aed?style=flat-square)
+![TOML Array Tables](https://img.shields.io/badge/TOML_Array_Tables-0-8b5cf6?style=flat-square)
+![TOML Keys](https://img.shields.io/badge/TOML_Keys-0-0284c7?style=flat-square)
+![TOML Arrays](https://img.shields.io/badge/TOML_Arrays-0-16a34a?style=flat-square)
+![TOML Comments](https://img.shields.io/badge/TOML_Comments-0-64748b?style=flat-square)
+
+### Shell
+
+![Shell Files](https://img.shields.io/badge/Shell_Files-0-89e051?style=flat-square)
+![Shell Lines](https://img.shields.io/badge/Shell_Lines-0-4eaa25?style=flat-square)
+![Shell Functions](https://img.shields.io/badge/Shell_Functions-0-16a34a?style=flat-square)
+![Shell Variables](https://img.shields.io/badge/Shell_Variables-0-0284c7?style=flat-square)
+![Shell Exports](https://img.shields.io/badge/Shell_Exports-0-ea580c?style=flat-square)
+![Shell Conditionals](https://img.shields.io/badge/Shell_Conditionals-0-7c3aed?style=flat-square)
+![Shell Loops](https://img.shields.io/badge/Shell_Loops-0-8b5cf6?style=flat-square)
+![Shell Pipelines](https://img.shields.io/badge/Shell_Pipelines-0-059669?style=flat-square)
+![Shebangs](https://img.shields.io/badge/Shebangs-0-6b7280?style=flat-square)
+![Shell Comments](https://img.shields.io/badge/Shell_Comments-0-64748b?style=flat-square)
+![Shell Comment Lines](https://img.shields.io/badge/Shell_Comment_Lines-0-475569?style=flat-square)
+
+### SQL
+
+![SQL Files](https://img.shields.io/badge/SQL_Files-0-e38c00?style=flat-square)
+![SQL Lines](https://img.shields.io/badge/SQL_Lines-0-f29111?style=flat-square)
+![SQL Statements](https://img.shields.io/badge/SQL_Statements-0-7c3aed?style=flat-square)
+![SQL Selects](https://img.shields.io/badge/SQL_Selects-0-16a34a?style=flat-square)
+![SQL Inserts](https://img.shields.io/badge/SQL_Inserts-0-22c55e?style=flat-square)
+![SQL Updates](https://img.shields.io/badge/SQL_Updates-0-0ea5e9?style=flat-square)
+![SQL Deletes](https://img.shields.io/badge/SQL_Deletes-0-dc2626?style=flat-square)
+![SQL Creates](https://img.shields.io/badge/SQL_Creates-0-0284c7?style=flat-square)
+![SQL Joins](https://img.shields.io/badge/SQL_Joins-0-8b5cf6?style=flat-square)
+![SQL CTEs](https://img.shields.io/badge/SQL_CTEs-0-059669?style=flat-square)
+![SQL Comments](https://img.shields.io/badge/SQL_Comments-0-64748b?style=flat-square)
+
+### HCL
+
+![HCL Files](https://img.shields.io/badge/HCL_Files-0-844fba?style=flat-square)
+![HCL Lines](https://img.shields.io/badge/HCL_Lines-0-a78bfa?style=flat-square)
+![HCL Blocks](https://img.shields.io/badge/HCL_Blocks-0-7c3aed?style=flat-square)
+![HCL Resources](https://img.shields.io/badge/HCL_Resources-0-0284c7?style=flat-square)
+![HCL Variables](https://img.shields.io/badge/HCL_Variables-0-16a34a?style=flat-square)
+![HCL Outputs](https://img.shields.io/badge/HCL_Outputs-0-059669?style=flat-square)
+![HCL Attributes](https://img.shields.io/badge/HCL_Attributes-0-0ea5e9?style=flat-square)
+![HCL Interpolations](https://img.shields.io/badge/HCL_Interpolations-0-db2777?style=flat-square)
+![HCL Comments](https://img.shields.io/badge/HCL_Comments-0-64748b?style=flat-square)
+
+### CSS
+
+![CSS Files](https://img.shields.io/badge/CSS_Files-0-264de4?style=flat-square)
+![CSS Lines](https://img.shields.io/badge/CSS_Lines-0-2965f1?style=flat-square)
+![CSS Rules](https://img.shields.io/badge/CSS_Rules-0-7c3aed?style=flat-square)
+![CSS Selectors](https://img.shields.io/badge/CSS_Selectors-0-8b5cf6?style=flat-square)
+![CSS Declarations](https://img.shields.io/badge/CSS_Declarations-0-0284c7?style=flat-square)
+![CSS At Rules](https://img.shields.io/badge/CSS_At_Rules-0-f97316?style=flat-square)
+![CSS Media Queries](https://img.shields.io/badge/CSS_Media_Queries-0-ea580c?style=flat-square)
+![CSS Custom Properties](https://img.shields.io/badge/CSS_Custom_Properties-0-16a34a?style=flat-square)
+![CSS Comments](https://img.shields.io/badge/CSS_Comments-0-64748b?style=flat-square)
+
+### Conventions
+
+![Module Files](https://img.shields.io/badge/Module_Files-6-7c3aed?style=flat-square)
+![Service Files](https://img.shields.io/badge/Service_Files-5-0284c7?style=flat-square)
+![Command Files](https://img.shields.io/badge/Command_Files-0-16a34a?style=flat-square)
+![Constants Files](https://img.shields.io/badge/Constants_Files-5-ea580c?style=flat-square)
+![Types Files](https://img.shields.io/badge/Types_Files-8-db2777?style=flat-square)
+![Utilities Files](https://img.shields.io/badge/Utilities_Files-3-0ea5e9?style=flat-square)
+![TypeORM Entities](https://img.shields.io/badge/TypeORM_Entities-0-059669?style=flat-square)
+![Unit Tests](https://img.shields.io/badge/Unit_Tests-12-ca8a04?style=flat-square)
+![Integration Tests](https://img.shields.io/badge/Integration_Tests-1-7c3aed?style=flat-square)
+![End To End Tests](https://img.shields.io/badge/End_To_End_Tests-0-0284c7?style=flat-square)
+![CSS Comment Budget](https://img.shields.io/badge/CSS_Comment_Budget-0-16a34a?style=flat-square)
+![HCL Comment Budget](https://img.shields.io/badge/HCL_Comment_Budget-0-ea580c?style=flat-square)
+![Python Comment Budget](https://img.shields.io/badge/Python_Comment_Budget-0-db2777?style=flat-square)
+![SQL Comment Budget](https://img.shields.io/badge/SQL_Comment_Budget-0-0ea5e9?style=flat-square)
+![TOML Comment Budget](https://img.shields.io/badge/TOML_Comment_Budget-0-059669?style=flat-square)
+![TypeScript Comment Budget](https://img.shields.io/badge/TypeScript_Comment_Budget-0-ca8a04?style=flat-square)
+![YAML Comment Budget](https://img.shields.io/badge/YAML_Comment_Budget-0-7c3aed?style=flat-square)
+![Shell Comment Budget](https://img.shields.io/badge/Shell_Comment_Budget-0-0284c7?style=flat-square)
+
+### Jupyter
+
+![Notebooks](https://img.shields.io/badge/Notebooks-0-f37626?style=flat-square)
+![Notebook Cells](https://img.shields.io/badge/Notebook_Cells-0-e8a33d?style=flat-square)
+![Code Cells](https://img.shields.io/badge/Code_Cells-0-3776ab?style=flat-square)
+![Markdown Cells](https://img.shields.io/badge/Markdown_Cells-0-083fa1?style=flat-square)
+![Raw Cells](https://img.shields.io/badge/Raw_Cells-0-9ca3af?style=flat-square)
+![Executed Cells](https://img.shields.io/badge/Executed_Cells-0-16a34a?style=flat-square)
+![Cell Outputs](https://img.shields.io/badge/Cell_Outputs-0-059669?style=flat-square)
+![Notebook Code Lines](https://img.shields.io/badge/Notebook_Code_Lines-0-4b8bbe?style=flat-square)
+![Notebook Classes](https://img.shields.io/badge/Notebook_Classes-0-7c3aed?style=flat-square)
+![Notebook Functions](https://img.shields.io/badge/Notebook_Functions-0-22c55e?style=flat-square)
+![Notebook Imports](https://img.shields.io/badge/Notebook_Imports-0-0284c7?style=flat-square)
+![Notebook Decorators](https://img.shields.io/badge/Notebook_Decorators-0-db2777?style=flat-square)
+![Notebook Prose Lines](https://img.shields.io/badge/Notebook_Prose_Lines-0-1f6feb?style=flat-square)
+![Notebook Headings](https://img.shields.io/badge/Notebook_Headings-0-a78bfa?style=flat-square)
+![Notebook Links](https://img.shields.io/badge/Notebook_Links-0-10b981?style=flat-square)
+![Notebook Images](https://img.shields.io/badge/Notebook_Images-0-34d399?style=flat-square)
+![Notebook Code Blocks](https://img.shields.io/badge/Notebook_Code_Blocks-0-dc2626?style=flat-square)
+![Notebook Properties](https://img.shields.io/badge/Notebook_Properties-0-ca8a04?style=flat-square)
+![Notebook Nodes](https://img.shields.io/badge/Notebook_Nodes-0-a16207?style=flat-square)
+![Notebook Max Depth](https://img.shields.io/badge/Notebook_Max_Depth-0-ea580c?style=flat-square)
+
+### Markdown
+
+![Markdown Files](https://img.shields.io/badge/Markdown_Files-1-083fa1?style=flat-square)
+![Markdown Lines](https://img.shields.io/badge/Markdown_Lines-256-1f6feb?style=flat-square)
+![H1](https://img.shields.io/badge/H1-1-7c3aed?style=flat-square)
+![H2](https://img.shields.io/badge/H2-7-8b5cf6?style=flat-square)
+![H3](https://img.shields.io/badge/H3-12-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-48-64748b?style=flat-square)
+![Lists](https://img.shields.io/badge/Lists-6-16a34a?style=flat-square)
+![List Items](https://img.shields.io/badge/List_Items-25-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-9-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-11-dc2626?style=flat-square)
+![Inline Code](https://img.shields.io/badge/Inline_Code-101-ef4444?style=flat-square)
+![Block Quotes](https://img.shields.io/badge/Block_Quotes-0-ca8a04?style=flat-square)
+![Thematic Breaks](https://img.shields.io/badge/Thematic_Breaks-0-a16207?style=flat-square)
+<!-- codometer:end -->
+
+<!-- callidescope:start -->
+
+## 🔭 Callidescope
+
+Call stacks traced through `packages/ic-suite/callidescope/callidescope-nx`, deepest first. Each frame shows what it takes, what it returns, and what its documentation says.
+
+| Measure | Value |
+| --- | --- |
+| Callables | 78 |
+| Files | 38 |
+| Calls traced | 109 |
+| Call stacks | 6 |
+| Deepest stack | 17 |
+| Stacks through recursion | 0 |
+| Unfollowable calls | 2 |
+
+### Limits
+
+What this project is judged against, as declared in its own `callidescope.config.ts`.
+
+| Limit | Value |
+| --- | --- |
+| `maximumDepth` | 17 |
+| `maximumBreadth` | 7 |
+
+### Call stacks (depth)
+
+**1. `breadthExecutor`** — depth ≥ 17 · orphan-root
+
+```text
+🚀 breadthExecutor(…): Promise<{ success: boolean; }> [packages/ic-suite/callidescope/callidescope-nx/src/executors/breadth/executor.ts:15]
+   ↳ Prints each named callable's direct callers and callees side by side — the two questions a rename or a refactor needs…
+  └─> runAddressExecutor(…): Promise<{ success: boolean; }> [packages/ic-suite/callidescope/callidescope-nx/src/modules/address/address.utilities.ts:19]
+     ↳ Runs the address lookups on behalf of the `depth` or `breadth` executor.
+    └─> AddressService.runDepth(args: LookupArguments): Promise<LookupResult> [packages/ic-suite/callidescope/callidescope-nx/src/modules/address/address.service.ts:154]
+       ↳ Prints every call stack above and below each callable.
+      └─> AddressService.locate(…): Promise<string | { identified: { address: string; id: string; }[]; workspace: LocatedWorkspace; }> [packages/ic-suite/callidescope/callidescope-nx/src/modules/address/address.service.ts:74]
+         ↳ Traces the selection, then matches every address against it.
+        └─> AddressLookupService.locate(options: AddressCommandOptions): Promise<LocatedWorkspace> [packages/ic-suite/callidescope/callidescope-cli/src/modules/address-lookup/address-lookup.service.ts:87]
+           ↳ Loads the configuration and traces the workspace, matching nothing yet.
+          └─> CallidescopeService.locate(args: TraceArguments): Promise<LocateOutcome> [packages/ic-suite/callidescope/callidescope-cli/src/modules/callidescope/callidescope.service.ts:394]
+             ↳ Collects every callable and assembles the graph over them, without running the analysis a full trace does.
+            └─> GraphAssemblyService.assemble(args: AssembleGraphArguments): AssembledGraph [packages/ic-suite/callidescope/callidescope-graph/src/modules/graph/graph-assembly.service.ts:43]
+               ↳ Builds the call graph and everything derived from it.
+              └─> EdgesService.build(args: BuildEdgesArguments): EdgeCollection [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/edges.service.ts:251]
+                 ↳ Builds every edge in the graph, and records the calls it could not.
+                └─> EdgesService.buildSiteEdges(…): { edges: CallEdge[]; unresolved: UnresolvedCall[]; } [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/edges.service.ts:59]
+                   ↳ Turns one call site into the edges and non-resolutions it produced.
+                  └─> EdgesService.resolveSite(…): ResolvedCallSite | undefined [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/edges.service.ts:226]
+                     ↳ Resolves one call site, choosing the right strategy for its shape.
+                    └─> SymbolResolutionService.resolve(…): ResolvedCallSite [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/symbol-resolution.service.ts:267]
+                       ↳ Resolves a call expression to every declaration it can reach.
+                      └─> SymbolResolutionService.resolveSymbol(…): ResolvedCallSite [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/symbol-resolution.service.ts:165]
+                         ↳ Resolves an already-identified callee symbol to its declarations.
+                        └─> SymbolResolutionService.resolveThroughHierarchy(…): ResolvedCallSite [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/symbol-resolution.service.ts:217]
+                           ↳ Expands an interface or abstract member to its implementations.
+                          └─> ClassesService.resolveImplementations(…): ImplementationLookup [packages/ic-suite/callidescope/callidescope-graph/src/modules/classes/classes.service.ts:204]
+                             ↳ Finds the concrete declarations one interface member resolves to.
+                            └─> ClassesService.flatMap(…)(this: undefined, candidate: ts.ClassDeclaration): ts.Declaration[] [packages/ic-suite/callidescope/callidescope-graph/src/modules/classes/classes.service.ts:232]
+                              └─> ClassesService.readMemberDeclarations(…): Declaration[] [packages/ic-suite/callidescope/callidescope-graph/src/modules/classes/classes.service.ts:148]
+                                 ↳ Reads one member's concrete declarations off a candidate class.
+                                └─> ClassesService.filter(…)(member: ts.PropertyDeclaration | ts.MethodDeclaration): boolean [packages/ic-suite/callidescope/callidescope-graph/src/modules/classes/classes.service.ts:162]
+```
+
+**2. `depthExecutor`** — depth ≥ 17 · orphan-root
+
+```text
+🚀 depthExecutor(…): Promise<{ success: boolean; }> [packages/ic-suite/callidescope/callidescope-nx/src/executors/depth/executor.ts:15]
+   ↳ Prints every call stack above and below each named callable — every caller chain up to a root, every callee chain down…
+  └─> runAddressExecutor(…): Promise<{ success: boolean; }> [packages/ic-suite/callidescope/callidescope-nx/src/modules/address/address.utilities.ts:19]
+     ↳ Runs the address lookups on behalf of the `depth` or `breadth` executor.
+    └─> AddressService.runDepth(args: LookupArguments): Promise<LookupResult> [packages/ic-suite/callidescope/callidescope-nx/src/modules/address/address.service.ts:154]
+       ↳ Prints every call stack above and below each callable.
+      └─> AddressService.locate(…): Promise<string | { identified: { address: string; id: string; }[]; workspace: LocatedWorkspace; }> [packages/ic-suite/callidescope/callidescope-nx/src/modules/address/address.service.ts:74]
+         ↳ Traces the selection, then matches every address against it.
+        └─> AddressLookupService.locate(options: AddressCommandOptions): Promise<LocatedWorkspace> [packages/ic-suite/callidescope/callidescope-cli/src/modules/address-lookup/address-lookup.service.ts:87]
+           ↳ Loads the configuration and traces the workspace, matching nothing yet.
+          └─> CallidescopeService.locate(args: TraceArguments): Promise<LocateOutcome> [packages/ic-suite/callidescope/callidescope-cli/src/modules/callidescope/callidescope.service.ts:394]
+             ↳ Collects every callable and assembles the graph over them, without running the analysis a full trace does.
+            └─> GraphAssemblyService.assemble(args: AssembleGraphArguments): AssembledGraph [packages/ic-suite/callidescope/callidescope-graph/src/modules/graph/graph-assembly.service.ts:43]
+               ↳ Builds the call graph and everything derived from it.
+              └─> EdgesService.build(args: BuildEdgesArguments): EdgeCollection [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/edges.service.ts:251]
+                 ↳ Builds every edge in the graph, and records the calls it could not.
+                └─> EdgesService.buildSiteEdges(…): { edges: CallEdge[]; unresolved: UnresolvedCall[]; } [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/edges.service.ts:59]
+                   ↳ Turns one call site into the edges and non-resolutions it produced.
+                  └─> EdgesService.resolveSite(…): ResolvedCallSite | undefined [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/edges.service.ts:226]
+                     ↳ Resolves one call site, choosing the right strategy for its shape.
+                    └─> SymbolResolutionService.resolve(…): ResolvedCallSite [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/symbol-resolution.service.ts:267]
+                       ↳ Resolves a call expression to every declaration it can reach.
+                      └─> SymbolResolutionService.resolveSymbol(…): ResolvedCallSite [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/symbol-resolution.service.ts:165]
+                         ↳ Resolves an already-identified callee symbol to its declarations.
+                        └─> SymbolResolutionService.resolveThroughHierarchy(…): ResolvedCallSite [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/symbol-resolution.service.ts:217]
+                           ↳ Expands an interface or abstract member to its implementations.
+                          └─> ClassesService.resolveImplementations(…): ImplementationLookup [packages/ic-suite/callidescope/callidescope-graph/src/modules/classes/classes.service.ts:204]
+                             ↳ Finds the concrete declarations one interface member resolves to.
+                            └─> ClassesService.flatMap(…)(this: undefined, candidate: ts.ClassDeclaration): ts.Declaration[] [packages/ic-suite/callidescope/callidescope-graph/src/modules/classes/classes.service.ts:232]
+                              └─> ClassesService.readMemberDeclarations(…): Declaration[] [packages/ic-suite/callidescope/callidescope-graph/src/modules/classes/classes.service.ts:148]
+                                 ↳ Reads one member's concrete declarations off a candidate class.
+                                └─> ClassesService.filter(…)(member: ts.PropertyDeclaration | ts.MethodDeclaration): boolean [packages/ic-suite/callidescope/callidescope-graph/src/modules/classes/classes.service.ts:162]
+```
+
+**3. `gateExecutor`** — depth ≥ 15 · orphan-root
+
+```text
+🚀 gateExecutor(…): Promise<{ success: boolean; }> [packages/ic-suite/callidescope/callidescope-nx/src/executors/gate/executor.ts:28]
+   ↳ Fails one project's task when its call stacks broke the limits it is held to.
+  └─> PluginService.runGate(args: RunGateArguments): Promise<RunTraceResult> [packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin.service.ts:427]
+     ↳ Traces the resolved directories and judges what it found against the limits every project in scope declared.
+    └─> CallidescopeService.trace(args: TraceArguments): Promise<TraceOutcome> [packages/ic-suite/callidescope/callidescope-cli/src/modules/callidescope/callidescope.service.ts:408]
+       ↳ Traces a workspace and returns everything the run found.
+      └─> CallidescopeService.analyze(…): AnalyzeOutcome [packages/ic-suite/callidescope/callidescope-cli/src/modules/callidescope/callidescope.service.ts:295]
+         ↳ Derives every finding from the collected callables.
+        └─> GraphAssemblyService.assemble(args: AssembleGraphArguments): AssembledGraph [packages/ic-suite/callidescope/callidescope-graph/src/modules/graph/graph-assembly.service.ts:43]
+           ↳ Builds the call graph and everything derived from it.
+          └─> EdgesService.build(args: BuildEdgesArguments): EdgeCollection [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/edges.service.ts:251]
+             ↳ Builds every edge in the graph, and records the calls it could not.
+            └─> EdgesService.buildSiteEdges(…): { edges: CallEdge[]; unresolved: UnresolvedCall[]; } [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/edges.service.ts:59]
+               ↳ Turns one call site into the edges and non-resolutions it produced.
+              └─> EdgesService.resolveSite(…): ResolvedCallSite | undefined [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/edges.service.ts:226]
+                 ↳ Resolves one call site, choosing the right strategy for its shape.
+                └─> SymbolResolutionService.resolve(…): ResolvedCallSite [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/symbol-resolution.service.ts:267]
+                   ↳ Resolves a call expression to every declaration it can reach.
+                  └─> SymbolResolutionService.resolveSymbol(…): ResolvedCallSite [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/symbol-resolution.service.ts:165]
+                     ↳ Resolves an already-identified callee symbol to its declarations.
+                    └─> SymbolResolutionService.resolveThroughHierarchy(…): ResolvedCallSite [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/symbol-resolution.service.ts:217]
+                       ↳ Expands an interface or abstract member to its implementations.
+                      └─> ClassesService.resolveImplementations(…): ImplementationLookup [packages/ic-suite/callidescope/callidescope-graph/src/modules/classes/classes.service.ts:204]
+                         ↳ Finds the concrete declarations one interface member resolves to.
+                        └─> ClassesService.flatMap(…)(this: undefined, candidate: ts.ClassDeclaration): ts.Declaration[] [packages/ic-suite/callidescope/callidescope-graph/src/modules/classes/classes.service.ts:232]
+                          └─> ClassesService.readMemberDeclarations(…): Declaration[] [packages/ic-suite/callidescope/callidescope-graph/src/modules/classes/classes.service.ts:148]
+                             ↳ Reads one member's concrete declarations off a candidate class.
+                            └─> ClassesService.filter(…)(member: ts.PropertyDeclaration | ts.MethodDeclaration): boolean [packages/ic-suite/callidescope/callidescope-graph/src/modules/classes/classes.service.ts:162]
+```
+
+<details>
+<summary>3 more call stacks</summary>
+
+**4. `traceExecutor`** — depth ≥ 15 · orphan-root
+
+```text
+🚀 traceExecutor(…): Promise<{ success: boolean; }> [packages/ic-suite/callidescope/callidescope-nx/src/executors/trace/executor.ts:25]
+   ↳ Traces one selection of Nx projects with callidescope.
+  └─> PluginService.runTrace(args: RunTraceArguments): Promise<RunTraceResult> [packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin.service.ts:472]
+     ↳ Traces the resolved directories and renders the report.
+    └─> CallidescopeService.trace(args: TraceArguments): Promise<TraceOutcome> [packages/ic-suite/callidescope/callidescope-cli/src/modules/callidescope/callidescope.service.ts:408]
+       ↳ Traces a workspace and returns everything the run found.
+      └─> CallidescopeService.analyze(…): AnalyzeOutcome [packages/ic-suite/callidescope/callidescope-cli/src/modules/callidescope/callidescope.service.ts:295]
+         ↳ Derives every finding from the collected callables.
+        └─> GraphAssemblyService.assemble(args: AssembleGraphArguments): AssembledGraph [packages/ic-suite/callidescope/callidescope-graph/src/modules/graph/graph-assembly.service.ts:43]
+           ↳ Builds the call graph and everything derived from it.
+          └─> EdgesService.build(args: BuildEdgesArguments): EdgeCollection [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/edges.service.ts:251]
+             ↳ Builds every edge in the graph, and records the calls it could not.
+            └─> EdgesService.buildSiteEdges(…): { edges: CallEdge[]; unresolved: UnresolvedCall[]; } [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/edges.service.ts:59]
+               ↳ Turns one call site into the edges and non-resolutions it produced.
+              └─> EdgesService.resolveSite(…): ResolvedCallSite | undefined [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/edges.service.ts:226]
+                 ↳ Resolves one call site, choosing the right strategy for its shape.
+                └─> SymbolResolutionService.resolve(…): ResolvedCallSite [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/symbol-resolution.service.ts:267]
+                   ↳ Resolves a call expression to every declaration it can reach.
+                  └─> SymbolResolutionService.resolveSymbol(…): ResolvedCallSite [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/symbol-resolution.service.ts:165]
+                     ↳ Resolves an already-identified callee symbol to its declarations.
+                    └─> SymbolResolutionService.resolveThroughHierarchy(…): ResolvedCallSite [packages/ic-suite/callidescope/callidescope-graph/src/modules/edges/symbol-resolution.service.ts:217]
+                       ↳ Expands an interface or abstract member to its implementations.
+                      └─> ClassesService.resolveImplementations(…): ImplementationLookup [packages/ic-suite/callidescope/callidescope-graph/src/modules/classes/classes.service.ts:204]
+                         ↳ Finds the concrete declarations one interface member resolves to.
+                        └─> ClassesService.flatMap(…)(this: undefined, candidate: ts.ClassDeclaration): ts.Declaration[] [packages/ic-suite/callidescope/callidescope-graph/src/modules/classes/classes.service.ts:232]
+                          └─> ClassesService.readMemberDeclarations(…): Declaration[] [packages/ic-suite/callidescope/callidescope-graph/src/modules/classes/classes.service.ts:148]
+                             ↳ Reads one member's concrete declarations off a candidate class.
+                            └─> ClassesService.filter(…)(member: ts.PropertyDeclaration | ts.MethodDeclaration): boolean [packages/ic-suite/callidescope/callidescope-graph/src/modules/classes/classes.service.ts:162]
+```
+
+**5. `anonymous`** — depth ≥ 8 · orphan-root
+
+```text
+🚀 anonymous(…): Promise<CreateNodesResultArray> [packages/ic-suite/callidescope/callidescope-nx/src/index.ts:59]
+  └─> PluginService.inferTargets(args: InferTargetsArguments): Promise<Map<string, InferredTargets>> [packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin.service.ts:333]
+     ↳ Infers this plugin's targets onto every project holding a `tsconfig.json`.
+    └─> PluginService.buildExclusionFilter(…): Promise<FileFilter> [packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin.service.ts:92]
+       ↳ Builds the predicate deciding which projects the workspace configuration keeps out of every trace.
+      └─> ConfigurationService.loadConfigurationFile(args?: LoadConfigurationArguments): Promise<LoadedCallidescopeConfiguration> [packages/ic-suite/callidescope/callidescope-configuration/src/modules/configuration/configuration.service.ts:87]
+         ↳ Loads a configuration, and says what the file itself declared and which file answered.
+        └─> ConfigurationFileService.loadConfigurationFile(args?: LoadConfigurationArguments): Promise<LoadedCallidescopeConfiguration> [packages/ic-suite/callidescope/callidescope-configuration/src/modules/configuration/configuration-file.service.ts:326]
+           ↳ Loads a configuration, and says what the file itself declared and which file answered.
+          └─> ConfigurationFileService.resolveConfigurationPath(configurationPath: string): string [packages/ic-suite/callidescope/callidescope-configuration/src/modules/configuration/configuration-file.service.ts:158]
+             ↳ Resolves a configuration path against the cwd, then the repository root.
+            └─> ConfigurationFileService.findRepositoryRoot(): string | undefined [packages/ic-suite/callidescope/callidescope-configuration/src/modules/configuration/configuration-file.service.ts:97]
+               ↳ Walks upward from the process cwd looking for the repository root.
+              └─> ConfigurationFileService.some(…)(marker: ".git" | "pnpm-workspace.yaml"): boolean [packages/ic-suite/callidescope/callidescope-configuration/src/modules/configuration/configuration-file.service.ts:102]
+```
+
+**6. `resolveProjectsService`** — depth 2 · orphan-root
+
+```text
+🚀 resolveProjectsService(): Promise<ProjectsService> [packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin-context.utilities.ts:39]
+   ↳ Resolves the service that reads the workspace's Nx project graph.
+  └─> resolvePluginContext(): Promise<INestApplicationContext> [packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin-context.utilities.ts:59]
+     ↳ Builds, or returns, this process's application context.
+```
+
+</details>
+
+### Breadth
+
+| Callable | Breadth | Calls directly | Location |
+| --- | --- | --- | --- |
+| `runAddressExecutor` | 7 | `filter(…)`, `resolveExecutorScope`, `resolveOptionsService`, `resolveAddressService`, `OptionsService.readFormat`, `AddressService.runDepth`, `AddressService.runBreadth` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/address/address.utilities.ts:19` |
+| `ProjectsService.resolveProjectNames` | 6 | `ProjectsService.readProjects`, `ProjectsService.map(…)`, `ProjectsService.resolveTaggedNames`, `ProjectsService.map(…)`, `ProjectsService.readTags`, `ProjectsService.toSorted(…)` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/projects/projects.service.ts:195` |
+| `OptionsService.readStringList` | 5 | `OptionsService.isUnknownArray`, `OptionsService.filter(…)`, `OptionsService.map(…)`, `OptionsService.flatMap(…)`, `OptionsService.filter(…)` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/options/options.service.ts:124` |
+
+<details>
+<summary>36 more callables</summary>
+
+| Callable | Breadth | Calls directly | Location |
+| --- | --- | --- | --- |
+| `PluginService.inferTargets` | 5 | `OptionsService.resolvePluginOptions`, `PluginService.buildExclusionFilter`, `PluginService.holdsProgram`, `PluginService.buildInferredTargets`, `PluginService.isExcludedProject` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin.service.ts:333` |
+| `PluginService.runGate` | 5 | `RunConfigurationService.load`, `CallidescopeService.trace`, `PluginService.judge`, `PluginService.explainVerdict`, `MarkdownReportService.renderFindings` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin.service.ts:427` |
+| `PluginService.runTrace` | 5 | `RunConfigurationService.load`, `CallidescopeService.trace`, `PluginService.judge`, `MarkdownReportService.renderRun`, `PluginService.explainVerdict` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin.service.ts:472` |
+| `resolveExecutorScope` | 5 | `resolveOptionsService`, `OptionsService.readStringList`, `resolvePluginService`, `PluginService.resolveTraceScope`, `PluginService.describeRefusedScope` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin.utilities.ts:24` |
+| `traceExecutor` | 5 | `resolveExecutorScope`, `resolveOptionsService`, `resolvePluginService`, `PluginService.runTrace`, `OptionsService.readFormat` | `packages/ic-suite/callidescope/callidescope-nx/src/executors/trace/executor.ts:25` |
+| `PluginService.resolveTraceScope` | 4 | `ProjectsService.readProjectGraph`, `ProjectsService.resolveProjectNames`, `ProjectsService.resolveDependencyClosure`, `ProjectsService.resolveDirectories` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin.service.ts:383` |
+| `anonymous` | 4 | `resolvePluginService`, `PluginService.inferTargets`, `filter(…)`, `map(…)` | `packages/ic-suite/callidescope/callidescope-nx/src/index.ts:59` |
+| `AddressService.runBreadth` | 3 | `AddressService.locate`, `BreadthService.describeDirectCalls`, `AddressReportService.renderBreadthReports` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/address/address.service.ts:110` |
+| `AddressService.runDepth` | 3 | `AddressService.locate`, `AddressReportService.renderDepthReports`, `AddressService.map(…)` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/address/address.service.ts:154` |
+| `ProjectsService.toDirectories` | 3 | `ProjectsService.map(…)`, `ProjectsService.readProjects`, `ProjectsService.toSorted(…)` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/projects/projects.service.ts:233` |
+| `RunConfigurationService.load` | 3 | `OptionsService.resolveConfigurationPath`, `RunConfigurationService.readNxConfiguration`, `ConfigurationService.loadConfigurationFile` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/run-configuration/run-configuration.service.ts:69` |
+| `gateExecutor` | 3 | `resolveExecutorScope`, `resolvePluginService`, `PluginService.runGate` | `packages/ic-suite/callidescope/callidescope-nx/src/executors/gate/executor.ts:28` |
+| `AddressService.identify` | 2 | `AddressLookupService.resolve`, `AddressLookupService.describeProblem` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/address/address.service.ts:47` |
+| `AddressService.locate` | 2 | `AddressLookupService.locate`, `AddressService.identify` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/address/address.service.ts:74` |
+| `AddressService.map(…)` | 2 | `AddressDepthService.buildDownwardStacks`, `AddressDepthService.buildUpwardStacks` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/address/address.service.ts:167` |
+| `OptionsService.readRegisteredConfigurationPath` | 2 | `OptionsService.isUnknownArray`, `OptionsService.readEntryConfigurationPath` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/options/options.service.ts:66` |
+| `OptionsService.resolveConfigurationPath` | 2 | `OptionsService.readRegisteredConfigurationPath`, `OptionsService.find(…)` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/options/options.service.ts:145` |
+| `ProjectsService.readTags` | 2 | `ProjectsService.toSorted(…)`, `ProjectsService.flatMap(…)` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/projects/projects.service.ts:37` |
+| `ProjectsService.resolveTaggedNames` | 2 | `ProjectsService.filter(…)`, `ProjectsService.map(…)` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/projects/projects.service.ts:53` |
+| `ProjectsService.readProjects` | 2 | `ProjectsService.toSorted(…)`, `ProjectsService.map(…)` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/projects/projects.service.ts:92` |
+| `ProjectsService.resolveDependencyClosure` | 2 | `ProjectsService.filter(…)`, `ProjectsService.toSorted(…)` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/projects/projects.service.ts:122` |
+| `ProjectsService.resolveDirectories` | 2 | `ProjectsService.resolveProjectNames`, `ProjectsService.toDirectories` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/projects/projects.service.ts:171` |
+| `PluginService.buildExclusionFilter` | 2 | `ConfigurationService.loadConfigurationFile`, `FileFilterService.buildFileFilter` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin.service.ts:92` |
+| `PluginService.judge` | 2 | `ProjectReportsService.findOwnedFindings`, `ProjectReportsService.findUnreadProjects` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin.service.ts:263` |
+| `OptionsService.readEntryConfigurationPath` | 1 | `OptionsService.readString` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/options/options.service.ts:42` |
+| `OptionsService.readFormat` | 1 | `OptionsService.find(…)` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/options/options.service.ts:109` |
+| `OptionsService.resolvePluginOptions` | 1 | `OptionsService.readString` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/options/options.service.ts:159` |
+| `reportUnreadProjects` | 1 | `map(…)` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin.constants.ts:72` |
+| `PluginService.explainVerdict` | 1 | `reportUnreadProjects` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin.service.ts:185` |
+| `PluginService.describeRefusedScope` | 1 | `PluginService.filter(…)` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin.service.ts:305` |
+| `resolveAddressService` | 1 | `resolvePluginContext` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin-context.utilities.ts:18` |
+| `resolveOptionsService` | 1 | `resolvePluginContext` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin-context.utilities.ts:25` |
+| `resolvePluginService` | 1 | `resolvePluginContext` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin-context.utilities.ts:32` |
+| `resolveProjectsService` | 1 | `resolvePluginContext` | `packages/ic-suite/callidescope/callidescope-nx/src/modules/plugin/plugin-context.utilities.ts:39` |
+| `breadthExecutor` | 1 | `runAddressExecutor` | `packages/ic-suite/callidescope/callidescope-nx/src/executors/breadth/executor.ts:15` |
+| `depthExecutor` | 1 | `runAddressExecutor` | `packages/ic-suite/callidescope/callidescope-nx/src/executors/depth/executor.ts:15` |
+
+</details>
+<!-- callidescope:end -->