@conformetry/nx 0.0.29 → 0.0.30

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## 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 conformetry-configuration to 0.0.30
+- Updated conformetry-generation to 0.0.30
+- Updated conformetry-validation to 0.0.29
+- Updated conformetry-output to 0.0.29
+
 ## 0.0.29 (2026-10-15)
 
 ### 💅 Refactors

package/README.md

@@ -23,7 +23,7 @@ Register the plugin in `nx.json` and wire the bootstrap into `postinstall`:
     {
       "plugin": "@conformetry/nx",
       "options": {
-        "configurationPath": "configuration/conformetry.config.ts",
+        "configurationPath": "projects/configuration/conformetry.config.ts",
         "validateTargetName": "conformetry-validate"
       }
     }
@@ -36,6 +36,13 @@ Register the plugin in `nx.json` and wire the bootstrap into `postinstall`:
 { "scripts": { "postinstall": "conformetry-nx-bootstrap-generators" } }
 ```
 
+The `configurationPath` option is **required**: no default file is assumed and
+no filename is searched for. A plugin entry without it fails with a
+`ConfigurationPathRequiredError` from `@conformetry/configuration` naming the
+option, and so does the bootstrap, which reads it from `nx.json`. The executor
+and the `sync` generator take the same path as a `configuration` option, which
+wins over the registration when both are set.
+
 Then type your configuration as `ConformetryNxConfiguration` rather than
 `ConformetryConfiguration`, so instance groups are checked against what Nx can
 actually resolve:
@@ -97,7 +104,7 @@ nx affected --target=conformetry-validate --base=main
 
 | Executor option | Purpose |
 | --------------- | ------- |
-| `configurationPath` | Configuration file, workspace-root relative |
+| `configuration` | Configuration file, workspace-root relative. Taken from the `configurationPath` plugin option in `nx.json` when omitted; one of the two is required |
 | `languages` | Restrict the run to named validators; all run when omitted |
 
 ## Tag-scoped instances
@@ -152,13 +159,13 @@ Call stacks traced through `projects/ic-suite/conformetry/conformetry-nx`, deepe
 
 | Measure | Value |
 | --- | --- |
-| Callables | 115 |
+| Callables | 111 |
 | Files | 47 |
-| Calls traced | 139 |
+| Calls traced | 140 |
 | Call stacks | 8 |
 | Deepest stack | 15 |
 | Stacks through recursion | 0 |
-| Unfollowable calls | 1 |
+| Unfollowable calls | 0 |
 
 ### Limits
 
@@ -176,11 +183,11 @@ What this project is judged against, as declared in its own `callidescope.config
 ```text
 🚀 validateExecutor(…): Promise<{ success: boolean; }> [projects/ic-suite/conformetry/conformetry-nx/src/executors/validate/executor.ts:16]
    ↳ Validates one project's instances against their conformetry templates.
-  └─> PluginService.runValidation(args: RunValidationArguments): Promise<RunValidationResult> [projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:391]
+  └─> PluginService.runValidation(args: RunValidationArguments): Promise<RunValidationResult> [projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:399]
      ↳ Validates one project's instances and renders the report.
     └─> ValidationService.validate(args: RunValidationArguments): RunValidationResult [projects/ic-suite/conformetry/conformetry-validation/src/modules/validation/validation.service.ts:194]
        ↳ Validates every instance and returns the differences found.
-      └─> ConfigurationService.matchInstances(…): ResolvedInstances [projects/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:263]
+      └─> ConfigurationService.matchInstances(…): ResolvedInstances [projects/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:264]
          ↳ Resolves every instance to the template, or templates, that explain it.
         └─> InstanceDiscoveryService.matchInstances(…): ResolvedInstances [projects/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:123]
            ↳ Resolves every instance to the template, or templates, that explain it.
@@ -208,11 +215,11 @@ What this project is judged against, as declared in its own `callidescope.config
 ```text
 🚀 runConformetryGenerator(…): Promise<string[]> [projects/ic-suite/conformetry/conformetry-nx/src/index.ts:93]
    ↳ Runs one configured generator against an Nx tree.
-  └─> PluginService.runGenerator(args: RunGeneratorArguments): Promise<string[]> [projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:330]
+  └─> PluginService.runGenerator(args: RunGeneratorArguments): Promise<string[]> [projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:338]
      ↳ Runs one configured generator against an Nx tree.
-    └─> PluginService.assertPluginInSync(args: { configurationPath: string; workspaceRoot: string; }): Promise<void> [projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:118]
+    └─> PluginService.assertPluginInSync(args: { configurationPath: string; workspaceRoot: string; }): Promise<void> [projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:120]
        ↳ Fails fast when the plugin would run against a stale or broken setup.
-      └─> PluginService.assertEmittedPluginCurrent(args: { configurationPath: string; workspaceRoot: string; }): Promise<void> [projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:84]
+      └─> PluginService.assertEmittedPluginCurrent(args: { configurationPath: string; workspaceRoot: string; }): Promise<void> [projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:86]
          ↳ Fails when the emitted Nx plugin no longer matches the configuration. `generators.json` and its schemas are derived…
         └─> GeneratorService.emitPlugin(args: EmitPluginArguments): Promise<EmittedFile[]> [projects/ic-suite/conformetry/conformetry-nx/src/modules/generator/generator.service.ts:212]
            ↳ Returns every file the consumer's generator plugin consists of.
@@ -227,7 +234,7 @@ What this project is judged against, as declared in its own `callidescope.config
                        ↳ Returns whether a group applies to a project.
                       └─> ScopeService.isProjectGroup(group: ConformetryInstanceGroup): boolean [projects/ic-suite/conformetry/conformetry-nx/src/modules/scope/scope.service.ts:39]
                          ↳ Whether a group locates its instances by project tag.
-                        └─> ConfigurationService.isProjectScoped(group: ConformetryInstanceGroup): boolean [projects/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:232]
+                        └─> ConfigurationService.isProjectScoped(group: ConformetryInstanceGroup): boolean [projects/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:233]
                            ↳ Whether a group locates its instances inside the hosts its tags select.
                           └─> InstanceGroupService.isProjectScoped(group: ConformetryInstanceGroup): boolean [projects/ic-suite/conformetry/conformetry-configuration/src/modules/instance-group/instance-group.service.ts:42]
                              ↳ Whether a group locates its instances inside the hosts its tags select.
@@ -236,7 +243,7 @@ What this project is judged against, as declared in its own `callidescope.config
 **3. `runBootstrapCli`** — depth ≥ 12 · orphan-root
 
 ```text
-🚀 runBootstrapCli(workspaceRoot: string): Promise<void> [projects/ic-suite/conformetry/conformetry-nx/src/modules/generator/bootstrap.utilities.ts:74]
+🚀 runBootstrapCli(workspaceRoot: string): Promise<void> [projects/ic-suite/conformetry/conformetry-nx/src/modules/generator/bootstrap.utilities.ts:71]
    ↳ Bootstraps the plugin, warning rather than failing the install.
   └─> bootstrapPlugin(workspaceRoot: string): Promise<EmittedFile[]> [projects/ic-suite/conformetry/conformetry-nx/src/modules/generator/bootstrap.utilities.ts:39]
      ↳ Emits the generator plugin and puts it where Nx will find it.
@@ -253,7 +260,7 @@ What this project is judged against, as declared in its own `callidescope.config
                    ↳ Returns whether a group applies to a project.
                   └─> ScopeService.isProjectGroup(group: ConformetryInstanceGroup): boolean [projects/ic-suite/conformetry/conformetry-nx/src/modules/scope/scope.service.ts:39]
                      ↳ Whether a group locates its instances by project tag.
-                    └─> ConfigurationService.isProjectScoped(group: ConformetryInstanceGroup): boolean [projects/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:232]
+                    └─> ConfigurationService.isProjectScoped(group: ConformetryInstanceGroup): boolean [projects/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:233]
                        ↳ Whether a group locates its instances inside the hosts its tags select.
                       └─> InstanceGroupService.isProjectScoped(group: ConformetryInstanceGroup): boolean [projects/ic-suite/conformetry/conformetry-configuration/src/modules/instance-group/instance-group.service.ts:42]
                          ↳ Whether a group locates its instances inside the hosts its tags select.
@@ -266,12 +273,12 @@ What this project is judged against, as declared in its own `callidescope.config
 
 ```text
 🚀 anonymous(…): Promise<CreateNodesResultArray> [projects/ic-suite/conformetry/conformetry-nx/src/index.ts:49]
-  └─> PluginService.inferTargets(args: InferTargetsArguments): Promise<Map<string, InferredTargets>> [projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:265]
+  └─> PluginService.inferTargets(args: InferTargetsArguments): Promise<Map<string, InferredTargets>> [projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:273]
      ↳ Infers a validation target onto every project that holds at least one instance.
     └─> InstancesService.findProjectInstances(args: FindProjectInstancesArguments): Promise<Instance[]> [projects/ic-suite/conformetry/conformetry-nx/src/modules/instances/instances.service.ts:68]
        ↳ Expands every instance group that applies to a project, keeping only the instances that live inside it.
       └─> InstancesService.flatMap(…)(this: undefined, group: ConformetryInstanceGroup): Instance[] [projects/ic-suite/conformetry/conformetry-nx/src/modules/instances/instances.service.ts:84]
-        └─> ConfigurationService.findInstances(args: FindInstancesArguments): Instance[] [projects/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:222]
+        └─> ConfigurationService.findInstances(args: FindInstancesArguments): Instance[] [projects/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:223]
            ↳ Expands instance globs into the instances that exist.
           └─> InstanceDiscoveryService.findInstances(args: FindInstancesArguments): Instance[] [projects/ic-suite/conformetry/conformetry-configuration/src/modules/instance-discovery/instance-discovery.service.ts:118]
              ↳ Expands instance globs into the instances that exist.
@@ -288,7 +295,7 @@ What this project is judged against, as declared in its own `callidescope.config
 **5. `syncGenerator`** — depth ≥ 11 · orphan-root
 
 ```text
-🚀 syncGenerator(tree: Tree, options?: SyncGeneratorOptions): Promise<SyncGeneratorResult> [projects/ic-suite/conformetry/conformetry-nx/src/generators/sync/generator.ts:29]
+🚀 syncGenerator(tree: Tree, options?: SyncGeneratorOptions): Promise<SyncGeneratorResult> [projects/ic-suite/conformetry/conformetry-nx/src/generators/sync/generator.ts:32]
    ↳ Regenerates the workspace's conformetry generator plugin.
   └─> GeneratorService.emitPlugin(args: EmitPluginArguments): Promise<EmittedFile[]> [projects/ic-suite/conformetry/conformetry-nx/src/modules/generator/generator.service.ts:212]
      ↳ Returns every file the consumer's generator plugin consists of.
@@ -303,7 +310,7 @@ What this project is judged against, as declared in its own `callidescope.config
                  ↳ Returns whether a group applies to a project.
                 └─> ScopeService.isProjectGroup(group: ConformetryInstanceGroup): boolean [projects/ic-suite/conformetry/conformetry-nx/src/modules/scope/scope.service.ts:39]
                    ↳ Whether a group locates its instances by project tag.
-                  └─> ConfigurationService.isProjectScoped(group: ConformetryInstanceGroup): boolean [projects/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:232]
+                  └─> ConfigurationService.isProjectScoped(group: ConformetryInstanceGroup): boolean [projects/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:233]
                      ↳ Whether a group locates its instances inside the hosts its tags select.
                     └─> InstanceGroupService.isProjectScoped(group: ConformetryInstanceGroup): boolean [projects/ic-suite/conformetry/conformetry-configuration/src/modules/instance-group/instance-group.service.ts:42]
                        ↳ Whether a group locates its instances inside the hosts its tags select.
@@ -343,9 +350,9 @@ What this project is judged against, as declared in its own `callidescope.config
 
 | Callable | Breadth | Calls directly | Location |
 | --- | --- | --- | --- |
-| `PluginService.runGenerator` | 9 | `PluginService.resolveOptions`, `PluginService.assertPluginInSync`, `ConfigurationService.loadConformetryConfiguration`, `PluginService.find(…)`, `PluginService.map(…)`, `AdapterService.createAdapters`, `OptionsService.resolveGeneratorInputs`, `GenerationService.runGenerator`, `PathsService.resolveGenerationPath` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:330` |
+| `PluginService.runGenerator` | 9 | `PluginService.resolveOptions`, `PluginService.assertPluginInSync`, `ConfigurationService.loadConformetryConfiguration`, `PluginService.find(…)`, `PluginService.map(…)`, `AdapterService.createAdapters`, `OptionsService.resolveGeneratorInputs`, `GenerationService.runGenerator`, `PathsService.resolveGenerationPath` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:338` |
 | `bootstrapPlugin` | 9 | `resolveGeneratorService`, `resolveOptionsService`, `resolveProjectsService`, `GeneratorService.emitPlugin`, `OptionsService.resolveConfigurationPath`, `readNxConfiguration`, `ProjectsService.listWorkspaceProjects`, `writePlugin`, `linkPlugin` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/generator/bootstrap.utilities.ts:39` |
-| `syncGenerator` | 8 | `resolveGeneratorService`, `resolveOptionsService`, `resolveProjectsService`, `GeneratorService.emitPlugin`, `OptionsService.resolveConfigurationPath`, `readNxConfiguration`, `ProjectsService.listWorkspaceProjects`, `assign(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/generators/sync/generator.ts:29` |
+| `syncGenerator` | 8 | `resolveGeneratorService`, `resolveOptionsService`, `resolveProjectsService`, `GeneratorService.emitPlugin`, `OptionsService.resolveConfigurationPath`, `readNxConfiguration`, `ProjectsService.listWorkspaceProjects`, `assign(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/generators/sync/generator.ts:32` |
 
 <details>
 <summary>55 more callables</summary>
@@ -354,29 +361,30 @@ What this project is judged against, as declared in its own `callidescope.config
 | --- | --- | --- | --- |
 | `GeneratorService.emitPlugin` | 6 | `ConfigurationService.loadConformetryConfiguration`, `GeneratorService.toSorted(…)`, `GeneratorService.buildGeneratorsManifest`, `GeneratorService.map(…)`, `GeneratorService.map(…)`, `GeneratorService.stringify` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/generator/generator.service.ts:212` |
 | `InstancesService.findProjectInstances` | 6 | `ConfigurationService.loadConformetryConfiguration`, `InstancesService.filter(…)`, `InstancesService.flatMap(…)`, `InstancesService.flatMap(…)`, `InstancesService.flatMap(…)`, `InstancesService.filter(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/instances/instances.service.ts:68` |
-| `PluginService.runValidation` | 6 | `PluginService.resolveOptions`, `PluginService.assertPluginInSync`, `ValidationService.validate`, `InstancesService.findProjectInstances`, `PluginService.resolveTemplates`, `ReportingService.formatReport` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:391` |
+| `PluginService.runValidation` | 6 | `PluginService.resolveOptions`, `PluginService.assertPluginInSync`, `ValidationService.validate`, `InstancesService.findProjectInstances`, `PluginService.resolveTemplates`, `ReportingService.formatReport` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:399` |
 | `PathsService.resolveGenerationPath` | 5 | `PathsService.resolveNewProjectPath`, `InstancesService.findProjectInstances`, `PathsService.requireModulePath`, `PathsService.resolveScopedDirectory`, `PathsService.resolveModuleParentPath` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/paths/paths.service.ts:221` |
-| `PluginService.inferTargets` | 5 | `PluginService.resolveOptions`, `PluginService.resolveTemplateInputs`, `PluginService.filter(…)`, `ProjectsService.readProjectScope`, `InstancesService.findProjectInstances` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:265` |
+| `PluginService.inferTargets` | 5 | `PluginService.resolveOptions`, `PluginService.resolveTemplateInputs`, `PluginService.filter(…)`, `ProjectsService.readProjectScope`, `InstancesService.findProjectInstances` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:273` |
 | `ScopeService.resolveScopedProjectNames` | 4 | `ScopeService.filter(…)`, `ScopeService.toSorted(…)`, `ScopeService.map(…)`, `ScopeService.filter(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/scope/scope.service.ts:135` |
 | `ProjectsService.listWorkspaceProjects` | 4 | `ProjectsService.toSorted(…)`, `ProjectsService.map(…)`, `ProjectsService.listProjectConfigurationFiles`, `ProjectsService.readIgnoredPaths` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/projects/projects.service.ts:118` |
 | `anonymous` | 4 | `resolvePluginService`, `PluginService.inferTargets`, `filter(…)`, `map(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/index.ts:49` |
 | `ScopeService.resolveGroup` | 3 | `ScopeService.matchesProject`, `ScopeService.isProjectGroup`, `ScopeService.map(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/scope/scope.service.ts:75` |
 | `AdapterService.listDirectory` | 3 | `AdapterService.resolveTreePath`, `AdapterService.map(…)`, `AdapterService.map(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/adapter/adapter.service.ts:42` |
 | `PathsService.resolveScopedDirectory` | 3 | `ConfigurationService.loadConformetryConfiguration`, `PathsService.find(…)`, `ScopeService.resolveScopedDirectory` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/paths/paths.service.ts:167` |
-| `PluginService.resolveOptions` | 3 | `OptionsService.resolveConfigurationPath`, `PluginService.readNxConfiguration`, `OptionsService.resolvePluginOptions` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:189` |
-| `PluginService.resolveTemplateInputs` | 3 | `ConfigurationService.loadConformetryConfiguration`, `PluginService.map(…)`, `PluginService.map(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:219` |
+| `PluginService.resolveOptions` | 3 | `OptionsService.readRegisteredConfigurationPath`, `PluginService.readNxConfiguration`, `OptionsService.resolvePluginOptions` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:192` |
+| `PluginService.resolveTemplateInputs` | 3 | `ConfigurationService.loadConformetryConfiguration`, `PluginService.map(…)`, `PluginService.map(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:227` |
 | `ScopeService.matchesProject` | 2 | `ScopeService.isProjectGroup`, `ScopeService.every(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/scope/scope.service.ts:53` |
 | `ScopeService.resolveScopedDirectory` | 2 | `ScopeService.find(…)`, `ScopeService.findIndex(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/scope/scope.service.ts:109` |
 | `GeneratorService.buildSchema` | 2 | `GeneratorService.stringify`, `GeneratorService.buildSchemaProperties` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/generator/generator.service.ts:122` |
 | `GeneratorService.map(…)` | 2 | `GeneratorService.buildSchema`, `GeneratorService.resolveScopedProjectNames` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/generator/generator.service.ts:238` |
-| `OptionsService.readRegisteredConfigurationPath` | 2 | `OptionsService.isUnknownArray`, `OptionsService.readString` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/options/options.service.ts:38` |
-| `OptionsService.resolveConfigurationPath` | 2 | `OptionsService.readRegisteredConfigurationPath`, `OptionsService.find(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/options/options.service.ts:98` |
+| `OptionsService.readRegisteredConfigurationPath` | 2 | `OptionsService.isUnknownArray`, `OptionsService.readString` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/options/options.service.ts:51` |
+| `OptionsService.resolveConfigurationPath` | 2 | `ConfigurationService.requireConfigurationPath`, `OptionsService.readRegisteredConfigurationPath` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/options/options.service.ts:98` |
+| `OptionsService.resolvePluginOptions` | 2 | `ConfigurationService.requireConfigurationPath`, `OptionsService.readString` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/options/options.service.ts:145` |
 | `PathsService.resolveNewProjectPath` | 2 | `missingDirectoryError`, `PathsService.resolveTypeDirectoryPath` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/paths/paths.service.ts:140` |
 | `ProjectsService.readIgnoredPaths` | 2 | `ProjectsService.filter(…)`, `ProjectsService.map(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/projects/projects.service.ts:97` |
 | `ProjectsService.readProjectScope` | 2 | `ProjectsService.isUnknownArray`, `ProjectsService.filter(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/projects/projects.service.ts:134` |
-| `PluginService.assertEmittedPluginCurrent` | 2 | `GeneratorService.emitPlugin`, `ProjectsService.listWorkspaceProjects` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:84` |
-| `PluginService.assertPluginInSync` | 2 | `PluginService.assertTemplatesExist`, `PluginService.assertEmittedPluginCurrent` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:118` |
-| `PluginService.resolveTemplates` | 2 | `ConfigurationService.loadConformetryConfiguration`, `PluginService.map(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:236` |
+| `PluginService.assertEmittedPluginCurrent` | 2 | `GeneratorService.emitPlugin`, `ProjectsService.listWorkspaceProjects` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:86` |
+| `PluginService.assertPluginInSync` | 2 | `PluginService.assertTemplatesExist`, `PluginService.assertEmittedPluginCurrent` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:120` |
+| `PluginService.resolveTemplates` | 2 | `ConfigurationService.loadConformetryConfiguration`, `PluginService.map(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:244` |
 | `runConformetryGenerator` | 2 | `resolvePluginService`, `PluginService.runGenerator` | `projects/ic-suite/conformetry/conformetry-nx/src/index.ts:93` |
 | `validateExecutor` | 2 | `resolvePluginService`, `PluginService.runValidation` | `projects/ic-suite/conformetry/conformetry-nx/src/executors/validate/executor.ts:16` |
 | `ScopeService.isProjectGroup` | 1 | `ConfigurationService.isProjectScoped` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/scope/scope.service.ts:39` |
@@ -394,19 +402,18 @@ What this project is judged against, as declared in its own `callidescope.config
 | `InstancesService.flatMap(…)` | 1 | `ScopeService.resolveGroup` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/instances/instances.service.ts:79` |
 | `InstancesService.flatMap(…)` | 1 | `ConfigurationService.findInstances` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/instances/instances.service.ts:84` |
 | `InstancesService.filter(…)` | 1 | `InstancesService.isInsideProject` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/instances/instances.service.ts:97` |
-| `OptionsService.resolvePluginOptions` | 1 | `OptionsService.readString` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/options/options.service.ts:147` |
 | `PathsService.requireModulePath` | 1 | `PathsService.resolveModulePath` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/paths/paths.service.ts:57` |
 | `PathsService.resolveModuleParentPath` | 1 | `PathsService.toSorted(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/paths/paths.service.ts:86` |
 | `PathsService.resolveModulePath` | 1 | `PathsService.find(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/paths/paths.service.ts:118` |
 | `ProjectsService.map(…)` | 1 | `ProjectsService.readProjectScope` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/projects/projects.service.ts:124` |
-| `PluginService.assertTemplatesExist` | 1 | `ConfigurationService.loadConformetryConfiguration` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:134` |
-| `PluginService.map(…)` | 1 | `ConfigurationService.collectTemplate` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:245` |
+| `PluginService.assertTemplatesExist` | 1 | `ConfigurationService.loadConformetryConfiguration` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:136` |
+| `PluginService.map(…)` | 1 | `ConfigurationService.collectTemplate` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:253` |
 | `resolveGeneratorService` | 1 | `resolvePluginContext` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin-context.utilities.ts:18` |
 | `resolveOptionsService` | 1 | `resolvePluginContext` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin-context.utilities.ts:25` |
 | `resolvePluginService` | 1 | `resolvePluginContext` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin-context.utilities.ts:32` |
 | `resolveProjectsService` | 1 | `resolvePluginContext` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin-context.utilities.ts:39` |
-| `runBootstrapCli` | 1 | `bootstrapPlugin` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/generator/bootstrap.utilities.ts:74` |
-| `linkPlugin` | 1 | `leadsTo` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/generator/bootstrap.utilities.ts:116` |
+| `runBootstrapCli` | 1 | `bootstrapPlugin` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/generator/bootstrap.utilities.ts:71` |
+| `linkPlugin` | 1 | `leadsTo` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/generator/bootstrap.utilities.ts:113` |
 
 </details>
 <!-- callidescope:end -->
@@ -501,6 +508,7 @@ flowchart LR
   MainModule --> GeneratorModule
   MainModule --> PluginModule
   MarkdownModule --> ScoringModule
+  OptionsModule --> ConfigurationModule
   PathsModule --> ConfigurationModule
   PathsModule --> InstancesModule
   PathsModule --> ScopeModule
@@ -613,6 +621,7 @@ graph LR
   file_src_generators_sync_generator_ts --> file_src_modules_options_options_constants_ts
   file_src_generators_sync_generator_ts --> file_src_modules_plugin_plugin_context_utilities_ts
   file_src_generators_sync_generator_unit_test_ts --> file_src_generators_sync_generator_ts
+  file_src_generators_sync_generator_unit_test_ts --> file_src_modules_options_options_constants_ts
   file_src_generators_sync_generator_unit_test_ts --> file_src_modules_plugin_plugin_context_utilities_ts
   file_src_index_ts --> file_src_modules_plugin_plugin_context_utilities_ts
   file_src_index_ts --> file_src_modules_plugin_plugin_constants_ts
@@ -721,14 +730,14 @@ graph LR
 
 ### Project
 
-![Lines of Code](https://img.shields.io/badge/Lines_of_Code-6173-22c55e?style=flat-square)
-![Repository Size](https://img.shields.io/badge/Repository_Size-221.82_kB-6b7280?style=flat-square)
+![Lines of Code](https://img.shields.io/badge/Lines_of_Code-6219-22c55e?style=flat-square)
+![Repository Size](https://img.shields.io/badge/Repository_Size-223.53_kB-6b7280?style=flat-square)
 ![Folders](https://img.shields.io/badge/Folders-15-4a4a4a?style=flat-square)
 ![Source Files](https://img.shields.io/badge/Source_Files-65-3178c6?style=flat-square)
 
 ### Measured Targets
 
-![Compiled JavaScript Size](https://img.shields.io/badge/Compiled_JavaScript_Size-10.83_kB_gzip-6b7280?style=flat-square)
+![Compiled JavaScript Size](https://img.shields.io/badge/Compiled_JavaScript_Size-10.85_kB_gzip-6b7280?style=flat-square)
 
 ### TypeScript
 
@@ -737,7 +746,7 @@ graph LR
 ![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-17-db2777?style=flat-square)
-![Doc Comments](https://img.shields.io/badge/Doc_Comments-148-6366f1?style=flat-square)
+![Doc Comments](https://img.shields.io/badge/Doc_Comments-146-6366f1?style=flat-square)
 ![Static Methods](https://img.shields.io/badge/Static_Methods-0-166534?style=flat-square)
 
 ### JavaScript
@@ -746,15 +755,15 @@ graph LR
 ![Test Files](https://img.shields.io/badge/Test_Files-15-10b981?style=flat-square)
 ![External Packages](https://img.shields.io/badge/External_Packages-18-8b5cf6?style=flat-square)
 ![Classes](https://img.shields.io/badge/Classes-17-7c3aed?style=flat-square)
-![Functions](https://img.shields.io/badge/Functions-279-16a34a?style=flat-square)
-![Methods](https://img.shields.io/badge/Methods-86-15803d?style=flat-square)
+![Functions](https://img.shields.io/badge/Functions-284-16a34a?style=flat-square)
+![Methods](https://img.shields.io/badge/Methods-84-15803d?style=flat-square)
 ![Sync Functions](https://img.shields.io/badge/Sync_Functions-224-4ade80?style=flat-square)
-![Async Functions](https://img.shields.io/badge/Async_Functions-141-059669?style=flat-square)
-![Constants](https://img.shields.io/badge/Constants-280-dc2626?style=flat-square)
-![Imports](https://img.shields.io/badge/Imports-266-0284c7?style=flat-square)
-![Exported Symbols](https://img.shields.io/badge/Exported_Symbols-77-ea580c?style=flat-square)
-![Comments](https://img.shields.io/badge/Comments-343-64748b?style=flat-square)
-![Comment Lines](https://img.shields.io/badge/Comment_Lines-742-475569?style=flat-square)
+![Async Functions](https://img.shields.io/badge/Async_Functions-144-059669?style=flat-square)
+![Constants](https://img.shields.io/badge/Constants-282-dc2626?style=flat-square)
+![Imports](https://img.shields.io/badge/Imports-270-0284c7?style=flat-square)
+![Exported Symbols](https://img.shields.io/badge/Exported_Symbols-78-ea580c?style=flat-square)
+![Comments](https://img.shields.io/badge/Comments-332-64748b?style=flat-square)
+![Comment Lines](https://img.shields.io/badge/Comment_Lines-727-475569?style=flat-square)
 ![TODO Comments](https://img.shields.io/badge/TODO_Comments-0-ca8a04?style=flat-square)
 
 ### Python
@@ -910,20 +919,20 @@ graph LR
 ### Markdown
 
 ![Markdown Files](https://img.shields.io/badge/Markdown_Files-2-083fa1?style=flat-square)
-![Markdown Lines](https://img.shields.io/badge/Markdown_Lines-472-1f6feb?style=flat-square)
+![Markdown Lines](https://img.shields.io/badge/Markdown_Lines-485-1f6feb?style=flat-square)
 ![H1](https://img.shields.io/badge/H1-1-7c3aed?style=flat-square)
-![H2](https://img.shields.io/badge/H2-32-8b5cf6?style=flat-square)
-![H3](https://img.shields.io/badge/H3-44-a78bfa?style=flat-square)
+![H2](https://img.shields.io/badge/H2-33-8b5cf6?style=flat-square)
+![H3](https://img.shields.io/badge/H3-46-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-150-64748b?style=flat-square)
-![Lists](https://img.shields.io/badge/Lists-38-16a34a?style=flat-square)
-![List Items](https://img.shields.io/badge/List_Items-130-22c55e?style=flat-square)
+![Paragraphs](https://img.shields.io/badge/Paragraphs-155-64748b?style=flat-square)
+![Lists](https://img.shields.io/badge/Lists-40-16a34a?style=flat-square)
+![List Items](https://img.shields.io/badge/List_Items-135-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-20-059669?style=flat-square)
+![Links](https://img.shields.io/badge/Links-21-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-72-ef4444?style=flat-square)

package/dist/{bootstrap.utilities-CYl9__Vf.js → bootstrap.utilities-SrW64gG2.js}

@@ -1,26 +1,23 @@
-import { b as e, g as t, h as n, i as r, n as i, t as a } from "./plugin-context.utilities-nggdWdJp.js";
+import { g as e, h as t, i as n, n as r, t as i, x as a } from "./plugin-context.utilities-BKyER2ln.js";
 import { existsSync as o, lstatSync as s, mkdirSync as c, readFileSync as l, realpathSync as u, rmSync as d, symlinkSync as f, writeFileSync as p } from "node:fs";
 import m from "node:path";
 //#region projects/ic-suite/conformetry/conformetry-nx/src/modules/generator/bootstrap.utilities.ts
-async function bootstrapPlugin(e) {
-	let s = await a(), c = await i(), l = await r(), u = await s.emitPlugin({
-		configurationPath: c.resolveConfigurationPath({
-			exists: (t) => o(m.resolve(e, t)),
-			nxConfiguration: readNxConfiguration(e)
-		}),
-		outputPath: n,
-		packageName: t,
-		projects: l.listWorkspaceProjects(e)
+async function bootstrapPlugin(a) {
+	let o = await i(), s = await r(), c = await n(), l = await o.emitPlugin({
+		configurationPath: s.resolveConfigurationPath({ nxConfiguration: readNxConfiguration(a) }),
+		outputPath: t,
+		packageName: e,
+		projects: c.listWorkspaceProjects(a)
 	});
 	return writePlugin({
-		files: u,
-		workspaceRoot: e
-	}), linkPlugin(e), u;
+		files: l,
+		workspaceRoot: a
+	}), linkPlugin(a), l;
 }
 async function runBootstrapCli(e) {
 	try {
-		let t = await bootstrapPlugin(e);
-		console.info(`👔 Emitted the conformetry generator plugin to ${n}`, { count: t.length });
+		let n = await bootstrapPlugin(e);
+		console.info(`👔 Emitted the conformetry generator plugin to ${t}`, { count: n.length });
 	} catch (e) {
 		console.warn("👔 Skipped emitting the conformetry generator plugin"), console.warn(e instanceof Error ? e.message : e);
 	}
@@ -32,23 +29,23 @@ function leadsTo(e) {
 		return !o(e.linkPath);
 	}
 }
-function linkPlugin(e) {
-	let r = m.resolve(e, "node_modules", t), i = m.resolve(e, n);
+function linkPlugin(n) {
+	let r = m.resolve(n, "node_modules", e), i = m.resolve(n, t);
 	if (c(m.dirname(r), { recursive: !0 }), s(r, { throwIfNoEntry: !1 }) !== void 0 && !leadsTo({
 		linkPath: r,
 		outputPath: i
-	})) throw Error(`node_modules/${t} is an installed package, not a link to ${n}. Rename the emitted plugin via the sync generator's packageName option.`);
+	})) throw Error(`node_modules/${e} is an installed package, not a link to ${t}. Rename the emitted plugin via the sync generator's packageName option.`);
 	d(r, {
 		force: !0,
 		recursive: !0
 	}), f(m.relative(m.dirname(r), i), r, "dir");
 }
-function readNxConfiguration(t) {
-	let n = m.resolve(t, e);
-	if (o(n)) return JSON.parse(l(n, "utf8"));
+function readNxConfiguration(e) {
+	let t = m.resolve(e, a);
+	if (o(t)) return JSON.parse(l(t, "utf8"));
 }
 function writePlugin(e) {
-	d(m.resolve(e.workspaceRoot, n, "src"), {
+	d(m.resolve(e.workspaceRoot, t, "src"), {
 		force: !0,
 		recursive: !0
 	});

package/dist/{plugin-context.utilities-nggdWdJp.js → plugin-context.utilities-BKyER2ln.js}

@@ -8,29 +8,12 @@ import { ConfigurationModule as f, ConfigurationService as p, missingDirectoryEr
 import { GenerationModule as m, GenerationService as h } from "@conformetry/generation";
 import { ReportingModule as g, ReportingService as _ } from "@conformetry/output";
 import { ValidationModule as v, ValidationService as y } from "@conformetry/validation";
-import { formatFiles as ne, getProjects as b, readProjectConfiguration as re } from "@nx/devkit";
+import { formatFiles as ne, getProjects as b, readProjectConfiguration as x } from "@nx/devkit";
 //#region \0rolldown/runtime.js
-var ie = Object.defineProperty, __name = (e, t) => ie(e, "name", {
+var S = Object.defineProperty, __name = (e, t) => S(e, "name", {
 	value: t,
 	configurable: !0
-}), x = "@conformetry/nx", S = [
-	"conformetry.config.ts",
-	"conformetry.config.mts",
-	"conformetry.config.cts",
-	"conformetry.config.js",
-	"conformetry.config.mjs",
-	"conformetry.config.cjs",
-	"conformetry.config.json",
-	"conformetry.config.jsonc",
-	"conformetry.json",
-	"conformetry.jsonc",
-	".conformetryrc.ts",
-	".conformetryrc.js",
-	".conformetryrc.json",
-	"conformetryrc.ts",
-	"conformetryrc.js",
-	"conformetryrc.json"
-], C = "nx.json", ae = "conformetry-validate", oe = ["configurationPath", "validateTargetName"], se = /^(\p{Extended_Pictographic}️?(?:‍\p{Extended_Pictographic}️?)*)\s+/u, w = /^([A-Za-z]+)/, T = /* @__PURE__ */ new Set([
+}), re = "@conformetry/nx", C = "the \"configurationPath\" option of the @conformetry/nx plugin in nx.json", w = `the "configuration" option, or ${C},`, T = "nx.json", ie = ["configurationPath", "validateTargetName"], ae = /^(\p{Extended_Pictographic}️?(?:‍\p{Extended_Pictographic}️?)*)\s+/u, oe = /^([A-Za-z]+)/, se = /* @__PURE__ */ new Set([
 	"built",
 	"cut",
 	"found",
@@ -122,15 +105,15 @@ var D, O = class LoggerService extends s {
 	getConventionalMessageViolation(e) {
 		let t = e.emoji, n = e.text;
 		if (t === void 0) return `Log message must start with an emoji naming its subject, then a verb: "${n}"`;
-		let r = w.exec(n)?.[1];
+		let r = oe.exec(n)?.[1];
 		if (r === void 0 || !this.isConventionalVerb(r)) return `Log message must begin with a verb in present progressive or past tense, got "${r ?? ""}": "${t} ${n}"`;
 	}
 	isConventionalVerb(e) {
 		let t = e.toLowerCase();
-		return t.endsWith("ing") || t.endsWith("ed") || T.has(t);
+		return t.endsWith("ing") || t.endsWith("ed") || se.has(t);
 	}
 	parseMessage(e) {
-		let t = String(e), n = se.exec(t), r = n?.[1];
+		let t = String(e), n = ae.exec(t), r = n?.[1];
 		return r === void 0 ? {
 			emoji: void 0,
 			text: t
@@ -510,10 +493,17 @@ H = __decorate([u({
 //#endregion
 //#region projects/ic-suite/conformetry/conformetry-nx/src/modules/options/options.service.ts
 var U = class OptionsService {
-	constructor() {}
+	configurationService;
+	constructor(e) {
+		this.configurationService = e;
+	}
 	isUnknownArray(e) {
 		return Array.isArray(e);
 	}
+	readString(e) {
+		let t = e.options[e.key];
+		return typeof t == "string" && t !== "" ? t : void 0;
+	}
 	readRegisteredConfigurationPath(e) {
 		if (typeof e != "object" || !e) return;
 		let { plugins: t } = { ...e };
@@ -526,45 +516,37 @@ var U = class OptionsService {
 			}) : void 0;
 		}
 	}
-	readString(e) {
-		let t = e.options[e.key];
-		return typeof t == "string" && t !== "" ? t : void 0;
-	}
 	resolveConfigurationPath(e) {
-		return this.readRegisteredConfigurationPath(e.nxConfiguration) ?? S.find((t) => e.exists(t)) ?? S[0];
+		return this.configurationService.requireConfigurationPath(e.configuration ?? this.readRegisteredConfigurationPath(e.nxConfiguration), e.surface ?? "the \"configurationPath\" option of the @conformetry/nx plugin in nx.json");
 	}
 	resolveGeneratorInputs(e) {
 		if (typeof e != "object" || !e) return {};
 		let t = {};
-		for (let [n, r] of Object.entries({ ...e })) oe.includes(n) || typeof r != "string" || (t[n] = r);
+		for (let [n, r] of Object.entries({ ...e })) ie.includes(n) || typeof r != "string" || (t[n] = r);
 		return t;
 	}
-	resolvePluginOptions(e) {
-		if (typeof e != "object" || !e) return {
-			configurationPath: S[0],
-			validateTargetName: ae
-		};
-		let t = { ...e };
+	resolvePluginOptions(e, t = C) {
+		let n = typeof e == "object" && e ? { ...e } : {};
 		return {
-			configurationPath: this.readString({
+			configurationPath: this.configurationService.requireConfigurationPath(this.readString({
 				key: "configurationPath",
-				options: t
-			}) ?? S[0],
+				options: n
+			}), t),
 			validateTargetName: this.readString({
 				key: "validateTargetName",
-				options: t
+				options: n
 			}) ?? "conformetry-validate"
 		};
 	}
 };
-U = __decorate([l(), __decorateMetadata("design:paramtypes", [])], U);
+U = __decorate([l(), __decorateMetadata("design:paramtypes", [p === void 0 ? Object : p])], U);
 //#endregion
 //#region projects/ic-suite/conformetry/conformetry-nx/src/modules/options/options.module.ts
 var W = class OptionsModule {};
 W = __decorate([u({
 	controllers: [],
 	exports: [U],
-	imports: [],
+	imports: [f],
 	providers: [U]
 })], W);
 //#endregion
@@ -627,7 +609,7 @@ var G = class PathsService {
 			type: e.inputs[le],
 			workspaceRoot: e.workspaceRoot
 		});
-		let r = re(e.tree, n), i = a.resolve(e.workspaceRoot, r.root), o = await this.instancesService.findProjectInstances({
+		let r = x(e.tree, n), i = a.resolve(e.workspaceRoot, r.root), o = await this.instancesService.findProjectInstances({
 			configurationPath: e.configurationPath,
 			project: {
 				name: n,
@@ -767,18 +749,16 @@ var me = "**/{project.json,conformetry.config.*}", he = "project.json", Y = "__c
 		}
 	}
 	readNxConfiguration(e) {
-		let n = a.resolve(e, C);
+		let n = a.resolve(e, T);
 		if (t(n)) return JSON.parse(r(n, "utf8"));
 	}
 	resolveOptions(e) {
-		let n = this.optionsService.resolveConfigurationPath({
-			exists: (n) => t(a.resolve(e.workspaceRoot, n)),
-			nxConfiguration: this.readNxConfiguration(e.workspaceRoot)
-		}), r = typeof e.options == "object" && e.options !== null ? { ...e.options } : {};
+		let t = this.optionsService.readRegisteredConfigurationPath(this.readNxConfiguration(e.workspaceRoot)), n = typeof e.options == "object" && e.options !== null ? { ...e.options } : {};
 		return this.optionsService.resolvePluginOptions({
-			configurationPath: n,
-			...r
-		});
+			...t === void 0 ? {} : { configurationPath: t },
+			...n,
+			...e.configuration === void 0 ? {} : { configurationPath: e.configuration }
+		}, e.surface ?? "the \"configurationPath\" option of the @conformetry/nx plugin in nx.json");
 	}
 	async resolveTemplateInputs(e) {
 		let t = await this.configurationService.loadConformetryConfiguration(e.configurationPath);
@@ -807,7 +787,7 @@ var me = "**/{project.json,conformetry.config.*}", he = "project.json", Y = "__c
 				workspaceRoot: e.workspaceRoot
 			})).length !== 0 && r.set(a.root, { [t.validateTargetName]: {
 				cache: !0,
-				executor: `${x}:validate`,
+				executor: `${re}:validate`,
 				inputs: [
 					"default",
 					`{workspaceRoot}/${t.configurationPath}`,
@@ -856,7 +836,9 @@ var me = "**/{project.json,conformetry.config.*}", he = "project.json", Y = "__c
 	}
 	async runValidation(e) {
 		let t = this.resolveOptions({
+			...e.configuration === void 0 ? {} : { configuration: e.configuration },
 			options: e.options,
+			surface: w,
 			workspaceRoot: e.workspaceRoot
 		});
 		await this.assertPluginInSync({
@@ -970,4 +952,4 @@ async function resolvePluginContext() {
 	}), await e[Y];
 }
 //#endregion
-export { P as _, $ as a, C as b, me as c, H as d, V as f, F as g, N as h, resolveProjectsService as i, W as l, z as m, resolveOptionsService as n, Q as o, B as p, resolvePluginService as r, Z as s, resolveGeneratorService as t, U as u, j as v, __name as x, A as y };
+export { __name as S, P as _, $ as a, w as b, me as c, H as d, V as f, F as g, N as h, resolveProjectsService as i, W as l, z as m, resolveOptionsService as n, Q as o, B as p, resolvePluginService as r, Z as s, resolveGeneratorService as t, U as u, j as v, T as x, A as y };

package/dist/src/conformetry-nx.main.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as e } from "../bootstrap.utilities-CYl9__Vf.js";
+import { n as e } from "../bootstrap.utilities-SrW64gG2.js";
 //#region projects/ic-suite/conformetry/conformetry-nx/src/conformetry-nx.main.ts
 e(process.cwd());
 //#endregion

package/dist/src/executors/validate/executor.d.ts

@@ -15,8 +15,12 @@ export default validateExecutor;
 
 /** Options accepted by the conformetry validate executor. */
 declare interface ValidateExecutorOptions {
-    /** Where the conformetry configuration lives, workspace-root relative. */
-    readonly configurationPath?: string;
+    /**
+     * Where the conformetry configuration lives, workspace-root relative.
+     *
+     * Falls back to the plugin registration in `nx.json`.
+     */
+    readonly configuration?: string;
     /** Language names to restrict the run to; every language when absent. */
     readonly languages?: string[];
     /**

package/dist/src/executors/validate/executor.js

@@ -1,4 +1,4 @@
-import { r as e } from "../../../plugin-context.utilities-nggdWdJp.js";
+import { r as e } from "../../../plugin-context.utilities-BKyER2ln.js";
 //#region projects/ic-suite/conformetry/conformetry-nx/src/executors/validate/executor.ts
 async function validateExecutor(t, n) {
 	let r = n.projectName;
@@ -6,6 +6,7 @@ async function validateExecutor(t, n) {
 	let i = n.projectsConfigurations.projects[r];
 	if (i === void 0) throw Error(`Unknown project: ${r}.`);
 	let a = await (await e()).runValidation({
+		...t.configuration === void 0 ? {} : { configuration: t.configuration },
 		...t.languages === void 0 ? {} : { languageNames: t.languages },
 		options: t,
 		...t.threshold === void 0 ? {} : { threshold: t.threshold },

package/dist/src/generators/sync/generator.d.ts

@@ -13,8 +13,12 @@ export default syncGenerator;
 
 /** Options accepted by the conformetry sync generator. */
 declare interface SyncGeneratorOptions {
-    /** Path to the conformetry configuration, relative to the workspace root. */
-    readonly configurationPath?: string;
+    /**
+     * Path to the conformetry configuration, relative to the workspace root.
+     *
+     * Falls back to the plugin registration in `nx.json`.
+     */
+    readonly configuration?: string;
     /** Directory the generator plugin is emitted into. */
     readonly outputPath?: string;
     /** Package name the emitted plugin is addressed by. */

package/dist/src/generators/sync/generator.js

@@ -1,21 +1,22 @@
-import { _ as e, b as t, i as n, n as r, t as i } from "../../../plugin-context.utilities-nggdWdJp.js";
+import { _ as e, b as t, i as n, n as r, t as i, x as a } from "../../../plugin-context.utilities-BKyER2ln.js";
 //#region projects/ic-suite/conformetry/conformetry-nx/src/generators/sync/generator.ts
-async function syncGenerator(t, a) {
-	let o = await i(), s = await r(), c = await n(), l = await o.emitPlugin({
-		configurationPath: a?.configurationPath ?? s.resolveConfigurationPath({
-			exists: (e) => t.exists(e),
-			nxConfiguration: readNxConfiguration(t)
+async function syncGenerator(a, o) {
+	let s = await i(), c = await r(), l = await n(), u = await s.emitPlugin({
+		configurationPath: c.resolveConfigurationPath({
+			configuration: o?.configuration,
+			nxConfiguration: readNxConfiguration(a),
+			surface: t
 		}),
-		outputPath: a?.outputPath ?? ".conformetry/nx-generators",
-		packageName: a?.packageName ?? "conformetry",
-		projects: c.listWorkspaceProjects(t.root)
+		outputPath: o?.outputPath ?? ".conformetry/nx-generators",
+		packageName: o?.packageName ?? "conformetry",
+		projects: l.listWorkspaceProjects(a.root)
 	});
-	for (let e of l) t.write(e.filePath, e.content);
+	for (let e of u) a.write(e.filePath, e.content);
 	return Object.assign(() => {}, { outOfSyncMessage: e });
 }
 function readNxConfiguration(e) {
-	let n = e.read(t, "utf8");
-	if (n !== null) return JSON.parse(n);
+	let t = e.read(a, "utf8");
+	if (t !== null) return JSON.parse(t);
 }
 //#endregion
 export { syncGenerator as default };

package/dist/src/index.d.ts

@@ -661,30 +661,31 @@ export declare class OptionsModule {
  * from being built.
  */
 export declare class OptionsService {
-    constructor();
+    private readonly configurationService;
+    constructor(configurationService: ConfigurationService);
     /** Narrows an untrusted value to an array without widening it to `any`. */
     private isUnknownArray;
-    /** Reads this plugin's `configurationPath` out of an `nx.json`, if it names one. */
-    private readRegisteredConfigurationPath;
     /** Reads a string field from an untrusted record, or `undefined`. */
     private readString;
+    /** Reads this plugin's `configurationPath` out of an `nx.json`, if it names one. */
+    readRegisteredConfigurationPath(nxConfiguration: unknown): string | undefined;
     /**
-     * Resolves the configuration path a workspace means, without assuming one.
+     * Reads the configuration path the run was given, or refuses.
+     *
+     * The `configuration` option, when the caller has one, wins over the
+     * workspace's registration. Whether a path is required, and what the refusal
+     * says, belongs to the configuration layer; this only says which option the
+     * person was meant to set.
      *
      * Nx passes plugin options to `createNodes` and to executors, but not to a
      * global sync generator or to anything run outside Nx entirely, such as the
-     * install-time bootstrap. Those read the registration themselves rather than
-     * assuming a path, so a workspace that keeps its configuration somewhere
-     * other than the root is not silently read from nothing.
-     *
-     * With no registration, the conventional root filenames are tried in order.
-     * `exists` is supplied by the caller rather than reached for here, because
-     * the callers do not agree on what a filesystem is: two of them read disk
-     * and the sync generator reads an Nx `Tree`.
+     * install-time bootstrap. Those read the registration themselves. No path is
+     * assumed or searched for.
      */
     resolveConfigurationPath(args: {
-        exists: (candidatePath: string) => boolean;
+        configuration?: string | undefined;
         nxConfiguration: unknown;
+        surface?: string;
     }): string;
     /**
      * Extracts the generator inputs from an Nx options object.
@@ -698,12 +699,11 @@ export declare class OptionsService {
     /**
      * Resolves the effective plugin options from an untrusted value.
      *
-     * Falls back to the most conventional configuration filename rather than
-     * discovering which one is present, which needs a filesystem; callers that
-     * have one resolve the path with `resolveConfigurationPath` first and pass
-     * the result in.
+     * `configurationPath` is required and has no default; a missing one is
+     * refused by the configuration layer, naming `surface`. `validateTargetName`
+     * falls back to its default.
      */
-    resolvePluginOptions(options: unknown): ConformetryPluginOptions;
+    resolvePluginOptions(options: unknown, surface?: string): ConformetryPluginOptions;
 }
 
 /** A message split into the emoji the console shows and the prose telemetry stores. */
@@ -850,9 +850,10 @@ export declare class PluginService {
      *
      * Nx passes plugin options to `createNodes` but not to a generator or to an
      * inferred target's executor, which see only what the caller typed. Reading
-     * `nx.json` here rather than trusting a default is what lets a workspace keep
-     * its configuration somewhere other than the conventional path: the
-     * registration is the base, and anything Nx did pass wins over it.
+     * `nx.json` here is what supplies the path, which has no default: the
+     * registration is the base, anything Nx did pass wins over it, then the
+     * executor's `configuration` option wins over both. A path given by none is
+     * refused, by the configuration layer.
      */
     private resolveOptions;
     /**
@@ -998,6 +999,8 @@ declare interface RunGeneratorArguments {
 
 /** Arguments for validating one project. */
 declare interface RunValidationArguments {
+    /** The executor's `configuration` option, taking precedence over `nx.json`. */
+    readonly configuration?: string;
     readonly languageNames?: string[];
     readonly options: unknown;
     readonly project: ProjectScope;

package/dist/src/index.js

@@ -1,5 +1,5 @@
-import { a as e, c as t, d as n, f as r, l as i, m as a, o, p as s, r as c, s as l, u, v as d, y as f } from "../plugin-context.utilities-nggdWdJp.js";
-import { n as p, t as m } from "../bootstrap.utilities-CYl9__Vf.js";
+import { a as e, c as t, d as n, f as r, l as i, m as a, o, p as s, r as c, s as l, u, v as d, y as f } from "../plugin-context.utilities-BKyER2ln.js";
+import { n as p, t as m } from "../bootstrap.utilities-SrW64gG2.js";
 import h from "node:path";
 //#region projects/ic-suite/conformetry/conformetry-nx/src/index.ts
 var g = {

package/package.json

@@ -7,10 +7,10 @@
     "url": "https://github.com/organizzolini/codebase/issues"
   },
   "dependencies": {
-    "@conformetry/configuration": "0.0.29",
-    "@conformetry/generation": "0.0.29",
-    "@conformetry/output": "0.0.28",
-    "@conformetry/validation": "0.0.28",
+    "@conformetry/configuration": "0.0.30",
+    "@conformetry/generation": "0.0.30",
+    "@conformetry/output": "0.0.29",
+    "@conformetry/validation": "0.0.29",
     "@nestjs/common": "^11.1.21 || ^12.0.1",
     "@nestjs/core": "^11.1.21 || ^12.0.1",
     "@nx/devkit": "^23.0.0",
@@ -84,5 +84,5 @@
     "strict": true
   },
   "types": "./dist/src/index.d.ts",
-  "version": "0.0.29"
+  "version": "0.0.30"
 }

package/src/executors/validate/schema.json

@@ -2,8 +2,8 @@
   "$schema": "http://json-schema.org/schema",
   "description": "Validate a project's conformetry instances against their templates.",
   "properties": {
-    "configurationPath": {
-      "description": "Path to the conformetry configuration file, relative to the workspace root.",
+    "configuration": {
+      "description": "Path to the conformetry configuration file, relative to the workspace root. Falls back to the configurationPath option of the @conformetry/nx plugin in nx.json.",
       "type": "string"
     },
     "languages": {

package/src/generators/sync/schema.json

@@ -2,8 +2,8 @@
   "$schema": "http://json-schema.org/schema",
   "description": "Regenerate the workspace's conformetry generator plugin from the conformetry configuration.",
   "properties": {
-    "configurationPath": {
-      "description": "Path to the conformetry configuration file, relative to the workspace root.",
+    "configuration": {
+      "description": "Path to the conformetry configuration file, relative to the workspace root. Falls back to the configurationPath option of the @conformetry/nx plugin in nx.json.",
       "type": "string"
     },
     "outputPath": {