@conformetry/nx 0.0.39 → 0.0.41

package/CHANGELOG.md

@@ -1,3 +1,36 @@
+## 0.0.41 (2026-10-18)
+
+### 🚀 Features
+
+- **conformetry:** ✨ run configured generator hooks from the Nx plugin ([#1697](https://github.com/organizzolini/codebase/pull/1697), [#1683](https://github.com/organizzolini/codebase/issues/1683), [#1684](https://github.com/organizzolini/codebase/issues/1684), [#1685](https://github.com/organizzolini/codebase/issues/1685))
+- ⚠️  **conformetry:** ✨ expose the filesystem and configuration directory to hooks ([#1695](https://github.com/organizzolini/codebase/pull/1695), [#1679](https://github.com/organizzolini/codebase/issues/1679))
+
+### ⚠️  Breaking Changes
+
+- **conformetry:** ✨ expose the filesystem and configuration directory to hooks  ([#1695](https://github.com/organizzolini/codebase/pull/1695), [#1679](https://github.com/organizzolini/codebase/issues/1679))
+  `GenerationService.runGenerator` in the published
+  `@conformetry/generation` now requires `configurationDirectoryPath`, so
+  an embedder calling it must pass the absolute directory of its
+  configuration file; the title carries `!` so the squash releases it as
+  such.
+  - This is stacked on #1693.
+
+### 🧱 Updated Dependencies
+
+- Updated conformetry-configuration to 0.0.40
+- Updated conformetry-generation to 0.0.40
+- Updated conformetry-validation to 0.0.39
+- Updated conformetry-output to 0.0.39
+
+## 0.0.40 (2026-10-18)
+
+### 🧱 Updated Dependencies
+
+- Updated conformetry-configuration to 0.0.39
+- Updated conformetry-generation to 0.0.39
+- Updated conformetry-validation to 0.0.38
+- Updated conformetry-output to 0.0.38
+
 ## 0.0.39 (2026-10-18)
 
 ### 🧱 Updated Dependencies

package/README.md

@@ -159,9 +159,9 @@ Call stacks traced through `projects/ic-suite/conformetry/conformetry-nx`, deepe
 
 | Measure | Value |
 | --- | --- |
-| Callables | 129 |
+| Callables | 130 |
 | Files | 49 |
-| Calls traced | 165 |
+| Calls traced | 167 |
 | Call stacks | 8 |
 | Deepest stack | 15 |
 | Stacks through recursion | 0 |
@@ -183,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:409]
+  └─> PluginService.runValidation(args: RunValidationArguments): Promise<RunValidationResult> [projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:447]
      ↳ 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:264]
+      └─> ConfigurationService.matchInstances(…): ResolvedInstances [projects/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:257]
          ↳ 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.
@@ -215,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:348]
+  └─> PluginService.runGenerator(args: RunGeneratorArguments): Promise<string[]> [projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:402]
      ↳ 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:121]
+    └─> PluginService.assertPluginInSync(args: { configurationPath: string; workspaceRoot: string; }): Promise<void> [projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:122]
        ↳ 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:87]
+      └─> PluginService.assertEmittedPluginCurrent(args: { configurationPath: string; workspaceRoot: string; }): Promise<void> [projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:88]
          ↳ 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.
@@ -234,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:233]
+                        └─> ConfigurationService.isProjectScoped(group: ConformetryInstanceGroup): boolean [projects/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:226]
                            ↳ 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.
@@ -260,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:233]
+                    └─> ConfigurationService.isProjectScoped(group: ConformetryInstanceGroup): boolean [projects/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:226]
                        ↳ 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.
@@ -273,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:283]
+  └─> PluginService.inferTargets(args: InferTargetsArguments): Promise<Map<string, InferredTargets>> [projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:335]
      ↳ 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:223]
+        └─> ConfigurationService.findInstances(args: FindInstancesArguments): Instance[] [projects/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:216]
            ↳ 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.
@@ -310,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:233]
+                  └─> ConfigurationService.isProjectScoped(group: ConformetryInstanceGroup): boolean [projects/ic-suite/conformetry/conformetry-configuration/src/modules/configuration/configuration.service.ts:226]
                      ↳ 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.
@@ -350,12 +350,12 @@ 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:348` |
 | `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:32` |
+| `PluginService.runGenerator` | 7 | `PluginService.resolveOptions`, `PluginService.assertPluginInSync`, `PluginService.resolveGeneratorDefinition`, `AdapterService.createAdapters`, `OptionsService.resolveGeneratorInputs`, `GenerationService.runGenerator`, `PathsService.resolveGenerationPath` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:402` |
 
 <details>
-<summary>66 more callables</summary>
+<summary>67 more callables</summary>
 
 | Callable | Breadth | Calls directly | Location |
 | --- | --- | --- | --- |
@@ -363,17 +363,18 @@ What this project is judged against, as declared in its own `callidescope.config
 | `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` |
 | `PathsService.resolveAllowedDirectories` | 6 | `ConfigurationService.loadConformetryConfiguration`, `PathsService.flatMap(…)`, `PathsService.filter(…)`, `PathsService.find(…)`, `PathsService.some(…)`, `PathsService.map(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/paths/paths.service.ts:126` |
 | `PathsService.resolveGenerationPath` | 6 | `PathsService.resolveAllowedDirectories`, `PathsService.resolveExplicitDirectory`, `PathsService.resolveNewProjectPath`, `InstancesService.findProjectInstances`, `PathsService.requireModulePath`, `PathsService.resolveProjectParentPath` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/paths/paths.service.ts:365` |
-| `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:409` |
-| `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:283` |
+| `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:447` |
+| `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:335` |
 | `ScopeService.resolveScopedProjectNames` | 4 | `ScopeService.filter(…)`, `ScopeService.toSorted(…)`, `ScopeService.map(…)`, `ScopeService.filter(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/scope/scope.service.ts:135` |
 | `PathsService.resolveNewProjectPath` | 4 | `staticDirectoryPrefix`, `missingDirectoryError`, `PathsService.resolveTypeDirectoryPath`, `PathsService.assertDirectoryAllowed` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/paths/paths.service.ts:241` |
 | `ProjectsService.listWorkspaceProjects` | 4 | `ProjectsService.toSorted(…)`, `ProjectsService.map(…)`, `ProjectsService.listProjectConfigurationFiles`, `ProjectsService.readIgnoredPaths` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/projects/projects.service.ts:118` |
-| `PluginService.resolveTemplateInputs` | 4 | `ConfigurationService.loadConformetryConfiguration`, `PluginService.map(…)`, `PluginService.map(…)`, `buildTemplateHashCommand` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:234` |
+| `PluginService.resolveGeneratorDefinition` | 4 | `ConfigurationService.resolveConfigurationPath`, `ConfigurationService.loadConformetryConfiguration`, `PluginService.find(…)`, `PluginService.map(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:191` |
+| `PluginService.resolveTemplateInputs` | 4 | `ConfigurationService.loadConformetryConfiguration`, `PluginService.map(…)`, `PluginService.map(…)`, `buildTemplateHashCommand` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:286` |
 | `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:311` |
-| `PluginService.resolveOptions` | 3 | `OptionsService.readRegisteredConfigurationPath`, `PluginService.readNxConfiguration`, `OptionsService.resolvePluginOptions` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:193` |
+| `PluginService.resolveOptions` | 3 | `OptionsService.readRegisteredConfigurationPath`, `PluginService.readNxConfiguration`, `OptionsService.resolvePluginOptions` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:245` |
 | `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` |
@@ -386,9 +387,9 @@ What this project is judged against, as declared in its own `callidescope.config
 | `PathsService.resolveProjectParentPath` | 2 | `PathsService.resolveScopedDirectory`, `PathsService.resolveModuleParentPath` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/paths/paths.service.ts:281` |
 | `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:87` |
-| `PluginService.assertPluginInSync` | 2 | `PluginService.assertTemplatesExist`, `PluginService.assertEmittedPluginCurrent` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:121` |
-| `PluginService.resolveTemplates` | 2 | `ConfigurationService.loadConformetryConfiguration`, `PluginService.map(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:254` |
+| `PluginService.assertEmittedPluginCurrent` | 2 | `GeneratorService.emitPlugin`, `ProjectsService.listWorkspaceProjects` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:88` |
+| `PluginService.assertPluginInSync` | 2 | `PluginService.assertTemplatesExist`, `PluginService.assertEmittedPluginCurrent` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:122` |
+| `PluginService.resolveTemplates` | 2 | `ConfigurationService.loadConformetryConfiguration`, `PluginService.map(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:306` |
 | `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` |
@@ -417,8 +418,8 @@ What this project is judged against, as declared in its own `callidescope.config
 | `PathsService.resolveModuleParentPath` | 1 | `PathsService.toSorted(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/paths/paths.service.ts:187` |
 | `PathsService.resolveModulePath` | 1 | `PathsService.find(…)` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/paths/paths.service.ts:219` |
 | `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:137` |
-| `PluginService.map(…)` | 1 | `ConfigurationService.collectTemplate` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:263` |
+| `PluginService.assertTemplatesExist` | 1 | `ConfigurationService.loadConformetryConfiguration` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:138` |
+| `PluginService.map(…)` | 1 | `ConfigurationService.collectTemplate` | `projects/ic-suite/conformetry/conformetry-nx/src/modules/plugin/plugin.service.ts:315` |
 | `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` |
@@ -750,14 +751,14 @@ graph LR
 
 ### Project
 
-![Lines of Code](https://img.shields.io/badge/Lines_of_Code-6786-22c55e?style=flat-square)
-![Repository Size](https://img.shields.io/badge/Repository_Size-243.32_kB-6b7280?style=flat-square)
+![Lines of Code](https://img.shields.io/badge/Lines_of_Code-6979-22c55e?style=flat-square)
+![Repository Size](https://img.shields.io/badge/Repository_Size-251.20_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-69-3178c6?style=flat-square)
 
 ### Measured Targets
 
-![Compiled JavaScript Size](https://img.shields.io/badge/Compiled_JavaScript_Size-11.86_kB_gzip-6b7280?style=flat-square)
+![Compiled JavaScript Size](https://img.shields.io/badge/Compiled_JavaScript_Size-11.94_kB_gzip-6b7280?style=flat-square)
 
 ### TypeScript
 
@@ -766,7 +767,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-155-6366f1?style=flat-square)
+![Doc Comments](https://img.shields.io/badge/Doc_Comments-156-6366f1?style=flat-square)
 ![Static Methods](https://img.shields.io/badge/Static_Methods-0-166534?style=flat-square)
 
 ### JavaScript
@@ -775,15 +776,15 @@ graph LR
 ![Test Files](https://img.shields.io/badge/Test_Files-17-10b981?style=flat-square)
 ![External Packages](https://img.shields.io/badge/External_Packages-19-8b5cf6?style=flat-square)
 ![Classes](https://img.shields.io/badge/Classes-17-7c3aed?style=flat-square)
-![Functions](https://img.shields.io/badge/Functions-319-16a34a?style=flat-square)
-![Methods](https://img.shields.io/badge/Methods-94-15803d?style=flat-square)
-![Sync Functions](https://img.shields.io/badge/Sync_Functions-260-4ade80?style=flat-square)
-![Async Functions](https://img.shields.io/badge/Async_Functions-153-059669?style=flat-square)
-![Constants](https://img.shields.io/badge/Constants-301-dc2626?style=flat-square)
-![Imports](https://img.shields.io/badge/Imports-282-0284c7?style=flat-square)
+![Functions](https://img.shields.io/badge/Functions-325-16a34a?style=flat-square)
+![Methods](https://img.shields.io/badge/Methods-95-15803d?style=flat-square)
+![Sync Functions](https://img.shields.io/badge/Sync_Functions-261-4ade80?style=flat-square)
+![Async Functions](https://img.shields.io/badge/Async_Functions-159-059669?style=flat-square)
+![Constants](https://img.shields.io/badge/Constants-310-dc2626?style=flat-square)
+![Imports](https://img.shields.io/badge/Imports-285-0284c7?style=flat-square)
 ![Exported Symbols](https://img.shields.io/badge/Exported_Symbols-83-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-752-475569?style=flat-square)
+![Comments](https://img.shields.io/badge/Comments-344-64748b?style=flat-square)
+![Comment Lines](https://img.shields.io/badge/Comment_Lines-758-475569?style=flat-square)
 ![TODO Comments](https://img.shields.io/badge/TODO_Comments-0-ca8a04?style=flat-square)
 
 ### Python
@@ -939,23 +940,23 @@ 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-567-1f6feb?style=flat-square)
+![Markdown Lines](https://img.shields.io/badge/Markdown_Lines-600-1f6feb?style=flat-square)
 ![H1](https://img.shields.io/badge/H1-1-7c3aed?style=flat-square)
-![H2](https://img.shields.io/badge/H2-42-8b5cf6?style=flat-square)
-![H3](https://img.shields.io/badge/H3-56-a78bfa?style=flat-square)
+![H2](https://img.shields.io/badge/H2-44-8b5cf6?style=flat-square)
+![H3](https://img.shields.io/badge/H3-60-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-189-64748b?style=flat-square)
-![Lists](https://img.shields.io/badge/Lists-50-16a34a?style=flat-square)
-![List Items](https://img.shields.io/badge/List_Items-169-22c55e?style=flat-square)
+![Paragraphs](https://img.shields.io/badge/Paragraphs-201-64748b?style=flat-square)
+![Lists](https://img.shields.io/badge/Lists-55-16a34a?style=flat-square)
+![List Items](https://img.shields.io/badge/List_Items-181-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-23-059669?style=flat-square)
+![Links](https://img.shields.io/badge/Links-31-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)
+![Inline Code](https://img.shields.io/badge/Inline_Code-76-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 -->

package/dist/{bootstrap.utilities-DjU-tum6.js → bootstrap.utilities-D27Q12ga.js}

@@ -1,4 +1,4 @@
-import { g as e, h as t, i as n, n as r, t as i, x as a } from "./plugin-context.utilities-tWMUbdpG.js";
+import { g as e, h as t, i as n, n as r, t as i, x as a } from "./plugin-context.utilities-BpcJy_ln.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

package/dist/{plugin-context.utilities-tWMUbdpG.js → plugin-context.utilities-BpcJy_ln.js}

@@ -863,6 +863,18 @@ var X, Z = X = class PluginService {
 		let n = a.resolve(e, w);
 		if (t(n)) return JSON.parse(r(n, "utf8"));
 	}
+	async resolveGeneratorDefinition(e) {
+		let t = await this.configurationService.resolveConfigurationPath(e.configurationPath), n = await this.configurationService.loadConformetryConfiguration(t), r = n.find((t) => t.name === e.generatorName);
+		if (r === void 0) throw this.logger.error("🚫 Rejected an unknown generator", void 0, { generator: e.generatorName }), Error(`Unknown conformetry generator: ${e.generatorName}. Configured generators: ${n.map((e) => e.name).join(", ")}.`);
+		return {
+			configurationDirectoryPath: a.dirname(t),
+			definition: {
+				...r.hooks === void 0 ? {} : { hooks: r.hooks },
+				name: r.name,
+				templateDirectoryPath: a.resolve(e.workspaceRoot, r.templatePath)
+			}
+		};
+	}
 	resolveOptions(e) {
 		let t = this.optionsService.readRegisteredConfigurationPath(this.readNxConfiguration(e.workspaceRoot)), n = typeof e.options == "object" && e.options !== null ? { ...e.options } : {};
 		return this.optionsService.resolvePluginOptions({
@@ -919,31 +931,31 @@ var X, Z = X = class PluginService {
 			configurationPath: t.configurationPath,
 			workspaceRoot: e.workspaceRoot
 		});
-		let n = await this.configurationService.loadConformetryConfiguration(t.configurationPath), r = n.find((t) => t.name === e.generatorName);
-		if (r === void 0) throw this.logger.error("🚫 Rejected an unknown generator", void 0, { generator: e.generatorName }), Error(`Unknown conformetry generator: ${e.generatorName}. Configured generators: ${n.map((e) => e.name).join(", ")}.`);
-		let i = this.adapterService.createAdapters({
+		let { configurationDirectoryPath: n, definition: r } = await this.resolveGeneratorDefinition({
+			configurationPath: t.configurationPath,
+			generatorName: e.generatorName,
+			workspaceRoot: e.workspaceRoot
+		}), i = this.adapterService.createAdapters({
 			tree: e.tree,
 			workspaceRoot: e.workspaceRoot
-		}), o = this.optionsService.resolveGeneratorInputs(e.options), { generatedFilePaths: s } = await this.generationService.runGenerator({
-			definition: {
-				name: r.name,
-				templateDirectoryPath: a.resolve(e.workspaceRoot, r.templatePath)
-			},
+		}), a = this.optionsService.resolveGeneratorInputs(e.options), { generatedFilePaths: o } = await this.generationService.runGenerator({
+			configurationDirectoryPath: n,
+			definition: r,
 			filesystem: i.filesystem,
 			formatter: i.formatter,
-			inputs: o,
+			inputs: a,
 			instancePath: await this.pathsService.resolveGenerationPath({
 				configurationPath: t.configurationPath,
 				generatorName: e.generatorName,
-				inputs: o,
+				inputs: a,
 				tree: e.tree,
 				workspaceRoot: e.workspaceRoot
 			})
 		});
 		return this.logger.info("✨ Generated instance files", void 0, {
-			count: s.length,
+			count: o.length,
 			generator: e.generatorName
-		}), s;
+		}), o;
 	}
 	async runValidation(e) {
 		let t = this.resolveOptions({

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

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

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

@@ -1,4 +1,4 @@
-import { r as e } from "../../../plugin-context.utilities-tWMUbdpG.js";
+import { r as e } from "../../../plugin-context.utilities-BpcJy_ln.js";
 //#region projects/ic-suite/conformetry/conformetry-nx/src/executors/validate/executor.ts
 async function validateExecutor(t, n) {
 	let r = n.projectName;

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

@@ -1,4 +1,4 @@
-import { _ as e, b as t, i as n, n as r, t as i, x as a } from "../../../plugin-context.utilities-tWMUbdpG.js";
+import { _ as e, b as t, i as n, n as r, t as i, x as a } from "../../../plugin-context.utilities-BpcJy_ln.js";
 //#region projects/ic-suite/conformetry/conformetry-nx/src/generators/sync/generator.ts
 async function syncGenerator(a, o) {
 	let s = await i(), c = await r(), l = await n(), u = await s.emitPlugin({

package/dist/src/index.d.ts

@@ -867,6 +867,14 @@ export declare class PluginService {
     private assertTemplatesExist;
     /** Reads the workspace's `nx.json`, or nothing when there is none. */
     private readNxConfiguration;
+    /**
+     * Finds one configured generator and shapes it the way the runtime takes it.
+     *
+     * The configuration path is resolved once, the way the command line does
+     * it, so the file the definition is loaded from and the directory its hooks
+     * are anchored to are the same file whichever directory `nx g` ran from.
+     */
+    private resolveGeneratorDefinition;
     /**
      * Resolves this plugin's options against the workspace's registration.
      *
@@ -911,6 +919,8 @@ export declare class PluginService {
      *
      * Nothing is written to disk here — the tree records the writes and Nx
      * decides whether to flush them, which is what makes `--dry-run` honest.
+     * The configured hooks are handed the same tree-backed adapter, so a write
+     * through `context.filesystem` is previewed and flushed like any other.
      */
     runGenerator(args: RunGeneratorArguments): Promise<string[]>;
     /** Validates one project's instances and renders the report. */

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-tWMUbdpG.js";
-import { n as p, t as m } from "../bootstrap.utilities-DjU-tum6.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-BpcJy_ln.js";
+import { n as p, t as m } from "../bootstrap.utilities-D27Q12ga.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.38",
-    "@conformetry/generation": "0.0.38",
-    "@conformetry/output": "0.0.37",
-    "@conformetry/validation": "0.0.37",
+    "@conformetry/configuration": "0.0.40",
+    "@conformetry/generation": "0.0.40",
+    "@conformetry/output": "0.0.39",
+    "@conformetry/validation": "0.0.39",
     "@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.39"
+  "version": "0.0.41"
 }