@webpieces/nx-webpieces-rules 0.4.811 → 0.4.812

package/executors.json

@@ -153,12 +153,12 @@
         "openapi-generate": {
             "implementation": "./src/executors/openapi-generate/executor",
             "schema": "./src/executors/openapi-generate/schema.json",
-            "description": "Per-project: render the contracts to OpenAPI + mcp-tools.json into the build outputPath, with the consumer's own @webpieces/openapi-generator"
+            "description": "Per-project, inferred from the generate:openapi tag: render the contracts to OpenAPI + one mcp-<ContractClass>-tools.json per MCP contract into the compile target outputPath, with the consumer's own @webpieces/openapi-generator"
         },
         "docs-generate": {
             "implementation": "./src/executors/docs-generate/executor",
             "schema": "./src/executors/docs-generate/schema.json",
-            "description": "Per-project: render the static API reference site from a generated document into the build outputPath, with the consumer's own @webpieces/docs-site"
+            "description": "Per-project, inferred from the generate:docs-site tag: render the static API reference site from a generated document into <projectRoot>/<siteDir>, with the consumer's own @webpieces/docs-site"
         },
         "validate-nx-wiring": {
             "implementation": "./src/executors/validate-nx-wiring/executor",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/nx-webpieces-rules",
-  "version": "0.4.811",
+  "version": "0.4.812",
   "description": "Nx-specific webpieces validation rules and graph tooling. Bundles all @webpieces rule packages with Nx graph validators and an inference plugin.",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -18,12 +18,13 @@
     "README.md"
   ],
   "dependencies": {
-    "@webpieces/ai-hook-rules": "0.4.811",
-    "@webpieces/api-doc-model": "0.4.811",
-    "@webpieces/code-rules": "0.4.811",
-    "@webpieces/eslint-rules": "0.4.811",
-    "@webpieces/pr-gate": "0.4.811",
-    "@webpieces/rules-config": "0.4.811",
+    "@webpieces/ai-hook-rules": "0.4.812",
+    "@webpieces/api-doc-model": "0.4.812",
+    "@webpieces/code-rules": "0.4.812",
+    "@webpieces/core-util": "0.4.812",
+    "@webpieces/eslint-rules": "0.4.812",
+    "@webpieces/pr-gate": "0.4.812",
+    "@webpieces/rules-config": "0.4.812",
     "madge": "8.0.0"
   },
   "peerDependencies": {

package/src/executors/docs-generate/executor.d.ts

@@ -1,21 +1,21 @@
 /**
  * docs-generate Executor
  *
- * Renders the static API reference site from a document `openapi-generate` already wrote into the
- * project's build `outputPath`, and writes the site into `<outputPath>/<siteDir>` — build output,
- * published with the package, never committed.
+ * Renders the static API reference site from a document `openapi-generate` already wrote into the api
+ * library's build output, and writes the site into `<projectRoot>/<siteDir>` — a gitignored directory
+ * of the project, for HOSTING. It is deliberately not written into the package: a docs site is
+ * something you deploy, not something an npm consumer installs.
  *
- * Usage (project.json):
+ * Consumers do not declare this executor. The nx-webpieces-rules plugin INFERS the target on a project
+ * tagged `generate:docs-site` (which implies `generate:openapi`), with `dependsOn: ["openapi-generate"]`;
+ * project.json states only the options, under the same target name:
  *
  *   "docs-generate": {
- *     "executor": "@webpieces/nx-webpieces-rules:docs-generate",
- *     "dependsOn": ["openapi-generate"],
- *     "cache": true,
- *     "inputs": ["default", "^default"],
- *     "outputs": ["{workspaceRoot}/dist/<project>/docs-site"],
- *     "options": { "document": "public-openapi.json", "siteDir": "docs-site", "prose": "<project>/docs" }
+ *     "options": { "document": "public-openapi.json", "siteDir": "generated-docs", "prose": "<project>/docs" }
  *   }
  *
+ * and the repo's .gitignore carries `generated-docs/`.
+ *
  * `document` should be the PARTNER-facing document: a site built from `full-private-openapi.json`
  * publishes exactly the operations somebody decided not to publish. `prose` is optional because a site
  * with no prose pages is a legal site; `document` and `siteDir` are required and have no defaults.
@@ -24,13 +24,14 @@
  * version-checked; this plugin bundles no copy of it.
  */
 import type { ExecutorContext } from '@nx/devkit';
-import { ConsumerBinResolver, GeneratorRunner } from '@webpieces/pr-gate';
 import { RepoScratchDirs } from '@webpieces/rules-config';
 import { ExecutorResult } from '../../executor-result';
+import { ConsumerBinResolver } from '../../lib/api-docs/consumer-bin-resolver';
+import { GeneratorRunner } from '../../lib/api-docs/generator-runner';
 export interface DocsGenerateOptions {
-    /** A document name inside the build outputPath, e.g. `public-openapi.json`. Required. */
+    /** A document name inside the api library's build output, e.g. `public-openapi.json`. Required. */
     document?: string;
-    /** The site's directory name inside the build outputPath, e.g. `docs-site`. Required. */
+    /** The site's directory, relative to the project root, e.g. `generated-docs`. Required. */
     siteDir?: string;
     /** Workspace-relative directory holding `docs.manifest.json` and its markdown. Optional. */
     prose?: string;

package/src/executors/docs-generate/executor.js

@@ -2,21 +2,21 @@
 /**
  * docs-generate Executor
  *
- * Renders the static API reference site from a document `openapi-generate` already wrote into the
- * project's build `outputPath`, and writes the site into `<outputPath>/<siteDir>` — build output,
- * published with the package, never committed.
+ * Renders the static API reference site from a document `openapi-generate` already wrote into the api
+ * library's build output, and writes the site into `<projectRoot>/<siteDir>` — a gitignored directory
+ * of the project, for HOSTING. It is deliberately not written into the package: a docs site is
+ * something you deploy, not something an npm consumer installs.
  *
- * Usage (project.json):
+ * Consumers do not declare this executor. The nx-webpieces-rules plugin INFERS the target on a project
+ * tagged `generate:docs-site` (which implies `generate:openapi`), with `dependsOn: ["openapi-generate"]`;
+ * project.json states only the options, under the same target name:
  *
  *   "docs-generate": {
- *     "executor": "@webpieces/nx-webpieces-rules:docs-generate",
- *     "dependsOn": ["openapi-generate"],
- *     "cache": true,
- *     "inputs": ["default", "^default"],
- *     "outputs": ["{workspaceRoot}/dist/<project>/docs-site"],
- *     "options": { "document": "public-openapi.json", "siteDir": "docs-site", "prose": "<project>/docs" }
+ *     "options": { "document": "public-openapi.json", "siteDir": "generated-docs", "prose": "<project>/docs" }
  *   }
  *
+ * and the repo's .gitignore carries `generated-docs/`.
+ *
  * `document` should be the PARTNER-facing document: a site built from `full-private-openapi.json`
  * publishes exactly the operations somebody decided not to publish. `prose` is optional because a site
  * with no prose pages is a legal site; `document` and `siteDir` are required and have no defaults.
@@ -28,20 +28,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DocsGenerate = void 0;
 exports.default = runExecutor;
 const tslib_1 = require("tslib");
-const pr_gate_1 = require("@webpieces/pr-gate");
+const core_util_1 = require("@webpieces/core-util");
 const rules_config_1 = require("@webpieces/rules-config");
 const fs = tslib_1.__importStar(require("fs"));
 const path = tslib_1.__importStar(require("path"));
 const executor_result_1 = require("../../executor-result");
-const generator_target_1 = require("../../lib/generated-docs/generator-target");
+const consumer_bin_resolver_1 = require("../../lib/api-docs/consumer-bin-resolver");
+const generator_package_1 = require("../../lib/api-docs/generator-package");
+const generator_runner_1 = require("../../lib/api-docs/generator-runner");
+const generator_target_1 = require("../../lib/api-docs/generator-target");
 const toError_1 = require("../../toError");
-const RULE_NAME = 'docs-generate';
+const RULE_NAME = core_util_1.GeneratedApiDocsLayout.DOCS_TARGET;
 /** Everything except the process-facing reporting, so the suite drives it exactly as nx does. */
 class DocsGenerate {
     resolver;
     runner;
     scratch;
-    constructor(resolver = new pr_gate_1.ConsumerBinResolver(), runner = new pr_gate_1.GeneratorRunner(), scratch = new rules_config_1.RepoScratchDirs()) {
+    constructor(resolver = new consumer_bin_resolver_1.ConsumerBinResolver(), runner = new generator_runner_1.GeneratorRunner(), scratch = new rules_config_1.RepoScratchDirs()) {
         this.resolver = resolver;
         this.runner = runner;
         this.scratch = scratch;
@@ -49,16 +52,16 @@ class DocsGenerate {
     /** @returns the files written, absolute. Throws RuleFailError on every refusal. */
     run(options, context) {
         const target = generator_target_1.GeneratorTarget.of(RULE_NAME, context);
-        target.assertDependsOn('openapi-generate');
+        target.assertDependsOn(core_util_1.GeneratedApiDocsLayout.OPENAPI_TARGET);
         const document = target.requiredOption(options.document, 'document');
-        const siteDir = target.requiredOption(options.siteDir, 'siteDir');
-        const outDir = target.buildOutputDir();
-        const spec = path.join(outDir, document);
+        const siteOut = target.insideProject(target.requiredOption(options.siteDir, 'siteDir'), 'siteDir');
+        const documentsDir = target.documentsDir();
+        const spec = path.join(documentsDir, document);
         if (!fs.existsSync(spec)) {
             throw new rules_config_1.RuleFailError(RULE_NAME, `${path.relative(context.root, spec)} does not exist, so there is nothing to render. ` +
-                `openapi-generate writes only the documents the contracts' @ApiType(...) ask for.`, undefined, undefined, [new rules_config_1.Option(`Set options.document to a file openapi-generate writes into ${path.relative(context.root, outDir)}`, true)]);
+                `openapi-generate writes only the documents the contracts' @ApiType(...) ask for.`, undefined, undefined, [new rules_config_1.Option(`Set options.document to a file openapi-generate writes into ${path.relative(context.root, documentsDir)}`, true)]);
         }
-        const bin = this.resolver.resolve(new pr_gate_1.ConsumerBinRequest(RULE_NAME, pr_gate_1.DOCS_SITE, [path.join(context.root, target.projectRoot), context.root]));
+        const bin = this.resolver.resolve(new consumer_bin_resolver_1.ConsumerBinRequest(RULE_NAME, generator_package_1.DOCS_SITE, [path.join(context.root, target.projectRoot), context.root]));
         const staging = this.scratch.make(context.root, 'wp-docs-generate-');
         // webpieces-disable no-unmanaged-exceptions -- try/FINALLY only, nothing is caught: the staging
         // directory is removed however this ends, and every throw still reaches runExecutor below
@@ -72,8 +75,7 @@ class DocsGenerate {
                 throw new rules_config_1.RuleFailError(RULE_NAME, `${bin.packageName} ${bin.version} refused ${document}:\n${run.output}`);
             }
             // The site REPLACES the previous one: a page for an operation that no longer exists must not
-            // survive into the published package.
-            const siteOut = path.join(outDir, siteDir);
+            // survive into what gets hosted.
             fs.rmSync(siteOut, { recursive: true, force: true });
             const written = new generator_target_1.StagedOutput().publish(staging, siteOut);
             target.assertOutputsCover(written);

package/src/executors/docs-generate/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/docs-generate/executor.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * docs-generate Executor\n *\n * Renders the static API reference site from a document `openapi-generate` already wrote into the\n * project's build `outputPath`, and writes the site into `<outputPath>/<siteDir>` — build output,\n * published with the package, never committed.\n *\n * Usage (project.json):\n *\n *   \"docs-generate\": {\n *     \"executor\": \"@webpieces/nx-webpieces-rules:docs-generate\",\n *     \"dependsOn\": [\"openapi-generate\"],\n *     \"cache\": true,\n *     \"inputs\": [\"default\", \"^default\"],\n *     \"outputs\": [\"{workspaceRoot}/dist/<project>/docs-site\"],\n *     \"options\": { \"document\": \"public-openapi.json\", \"siteDir\": \"docs-site\", \"prose\": \"<project>/docs\" }\n *   }\n *\n * `document` should be the PARTNER-facing document: a site built from `full-private-openapi.json`\n * publishes exactly the operations somebody decided not to publish. `prose` is optional because a site\n * with no prose pages is a legal site; `document` and `siteDir` are required and have no defaults.\n *\n * The renderer is the CONSUMER's `@webpieces/docs-site`, resolved from its node_modules and\n * version-checked; this plugin bundles no copy of it.\n */\n\nimport type { ExecutorContext } from '@nx/devkit';\nimport { ConsumerBinRequest, ConsumerBinResolver, DOCS_SITE, GeneratorRunner } from '@webpieces/pr-gate';\nimport { Option, RepoScratchDirs, RuleFailError, renderRuleFailForHuman } from '@webpieces/rules-config';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { ExecutorResult } from '../../executor-result';\nimport { GeneratorTarget, StagedOutput } from '../../lib/generated-docs/generator-target';\nimport { toError } from '../../toError';\n\nexport interface DocsGenerateOptions {\n    /** A document name inside the build outputPath, e.g. `public-openapi.json`. Required. */\n    document?: string;\n    /** The site's directory name inside the build outputPath, e.g. `docs-site`. Required. */\n    siteDir?: string;\n    /** Workspace-relative directory holding `docs.manifest.json` and its markdown. Optional. */\n    prose?: string;\n}\n\nconst RULE_NAME = 'docs-generate';\n\n/** Everything except the process-facing reporting, so the suite drives it exactly as nx does. */\nexport class DocsGenerate {\n    constructor(\n        private readonly resolver: ConsumerBinResolver = new ConsumerBinResolver(),\n        private readonly runner: GeneratorRunner = new GeneratorRunner(),\n        private readonly scratch: RepoScratchDirs = new RepoScratchDirs(),\n    ) {}\n\n    /** @returns the files written, absolute. Throws RuleFailError on every refusal. */\n    run(options: DocsGenerateOptions, context: ExecutorContext): string[] {\n        const target = GeneratorTarget.of(RULE_NAME, context);\n        target.assertDependsOn('openapi-generate');\n        const document = target.requiredOption(options.document, 'document');\n        const siteDir = target.requiredOption(options.siteDir, 'siteDir');\n        const outDir = target.buildOutputDir();\n        const spec = path.join(outDir, document);\n        if (!fs.existsSync(spec)) {\n            throw new RuleFailError(\n                RULE_NAME,\n                `${path.relative(context.root, spec)} does not exist, so there is nothing to render. ` +\n                    `openapi-generate writes only the documents the contracts' @ApiType(...) ask for.`,\n                undefined,\n                undefined,\n                [new Option(`Set options.document to a file openapi-generate writes into ${path.relative(context.root, outDir)}`, true)],\n            );\n        }\n        const bin = this.resolver.resolve(new ConsumerBinRequest(\n            RULE_NAME, DOCS_SITE, [path.join(context.root, target.projectRoot), context.root]));\n\n        const staging = this.scratch.make(context.root, 'wp-docs-generate-');\n        // webpieces-disable no-unmanaged-exceptions -- try/FINALLY only, nothing is caught: the staging\n        // directory is removed however this ends, and every throw still reaches runExecutor below\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            const args = ['--spec', spec, '--out', staging];\n            if (options.prose !== undefined) args.push('--prose', path.resolve(context.root, options.prose));\n            const run = this.runner.run(bin, args, context.root);\n            if (!run.ok) {\n                throw new RuleFailError(RULE_NAME, `${bin.packageName} ${bin.version} refused ${document}:\\n${run.output}`);\n            }\n            // The site REPLACES the previous one: a page for an operation that no longer exists must not\n            // survive into the published package.\n            const siteOut = path.join(outDir, siteDir);\n            fs.rmSync(siteOut, { recursive: true, force: true });\n            const written = new StagedOutput().publish(staging, siteOut);\n            target.assertOutputsCover(written);\n            return written;\n        } finally {\n            fs.rmSync(staging, { recursive: true, force: true });\n        }\n    }\n}\n\n// webpieces-disable no-function-outside-class -- nx executor module: nx resolves a default-export function here\nexport default async function runExecutor(\n    options: DocsGenerateOptions,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- this IS the executor's single top-level handler\n    try {\n        const written = new DocsGenerate().run(options, context);\n        console.log(`wrote ${written.length} file(s) of the docs site for ${context.projectName ?? ''}`);\n        return new ExecutorResult(true);\n    } catch (err: unknown) {\n        const error = toError(err);\n        console.error(`❌ ${RULE_NAME}: ${error instanceof RuleFailError ? renderRuleFailForHuman(error) : error.message}`);\n        return new ExecutorResult(false);\n    }\n}\n"]}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/docs-generate/executor.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * docs-generate Executor\n *\n * Renders the static API reference site from a document `openapi-generate` already wrote into the api\n * library's build output, and writes the site into `<projectRoot>/<siteDir>` — a gitignored directory\n * of the project, for HOSTING. It is deliberately not written into the package: a docs site is\n * something you deploy, not something an npm consumer installs.\n *\n * Consumers do not declare this executor. The nx-webpieces-rules plugin INFERS the target on a project\n * tagged `generate:docs-site` (which implies `generate:openapi`), with `dependsOn: [\"openapi-generate\"]`;\n * project.json states only the options, under the same target name:\n *\n *   \"docs-generate\": {\n *     \"options\": { \"document\": \"public-openapi.json\", \"siteDir\": \"generated-docs\", \"prose\": \"<project>/docs\" }\n *   }\n *\n * and the repo's .gitignore carries `generated-docs/`.\n *\n * `document` should be the PARTNER-facing document: a site built from `full-private-openapi.json`\n * publishes exactly the operations somebody decided not to publish. `prose` is optional because a site\n * with no prose pages is a legal site; `document` and `siteDir` are required and have no defaults.\n *\n * The renderer is the CONSUMER's `@webpieces/docs-site`, resolved from its node_modules and\n * version-checked; this plugin bundles no copy of it.\n */\n\nimport type { ExecutorContext } from '@nx/devkit';\nimport { GeneratedApiDocsLayout } from '@webpieces/core-util';\nimport { Option, RepoScratchDirs, RuleFailError, renderRuleFailForHuman } from '@webpieces/rules-config';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { ExecutorResult } from '../../executor-result';\nimport { ConsumerBinRequest, ConsumerBinResolver } from '../../lib/api-docs/consumer-bin-resolver';\nimport { DOCS_SITE } from '../../lib/api-docs/generator-package';\nimport { GeneratorRunner } from '../../lib/api-docs/generator-runner';\nimport { GeneratorTarget, StagedOutput } from '../../lib/api-docs/generator-target';\nimport { toError } from '../../toError';\n\nexport interface DocsGenerateOptions {\n    /** A document name inside the api library's build output, e.g. `public-openapi.json`. Required. */\n    document?: string;\n    /** The site's directory, relative to the project root, e.g. `generated-docs`. Required. */\n    siteDir?: string;\n    /** Workspace-relative directory holding `docs.manifest.json` and its markdown. Optional. */\n    prose?: string;\n}\n\nconst RULE_NAME = GeneratedApiDocsLayout.DOCS_TARGET;\n\n/** Everything except the process-facing reporting, so the suite drives it exactly as nx does. */\nexport class DocsGenerate {\n    constructor(\n        private readonly resolver: ConsumerBinResolver = new ConsumerBinResolver(),\n        private readonly runner: GeneratorRunner = new GeneratorRunner(),\n        private readonly scratch: RepoScratchDirs = new RepoScratchDirs(),\n    ) {}\n\n    /** @returns the files written, absolute. Throws RuleFailError on every refusal. */\n    run(options: DocsGenerateOptions, context: ExecutorContext): string[] {\n        const target = GeneratorTarget.of(RULE_NAME, context);\n        target.assertDependsOn(GeneratedApiDocsLayout.OPENAPI_TARGET);\n        const document = target.requiredOption(options.document, 'document');\n        const siteOut = target.insideProject(target.requiredOption(options.siteDir, 'siteDir'), 'siteDir');\n        const documentsDir = target.documentsDir();\n        const spec = path.join(documentsDir, document);\n        if (!fs.existsSync(spec)) {\n            throw new RuleFailError(\n                RULE_NAME,\n                `${path.relative(context.root, spec)} does not exist, so there is nothing to render. ` +\n                    `openapi-generate writes only the documents the contracts' @ApiType(...) ask for.`,\n                undefined,\n                undefined,\n                [new Option(`Set options.document to a file openapi-generate writes into ${path.relative(context.root, documentsDir)}`, true)],\n            );\n        }\n        const bin = this.resolver.resolve(new ConsumerBinRequest(\n            RULE_NAME, DOCS_SITE, [path.join(context.root, target.projectRoot), context.root]));\n\n        const staging = this.scratch.make(context.root, 'wp-docs-generate-');\n        // webpieces-disable no-unmanaged-exceptions -- try/FINALLY only, nothing is caught: the staging\n        // directory is removed however this ends, and every throw still reaches runExecutor below\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            const args = ['--spec', spec, '--out', staging];\n            if (options.prose !== undefined) args.push('--prose', path.resolve(context.root, options.prose));\n            const run = this.runner.run(bin, args, context.root);\n            if (!run.ok) {\n                throw new RuleFailError(RULE_NAME, `${bin.packageName} ${bin.version} refused ${document}:\\n${run.output}`);\n            }\n            // The site REPLACES the previous one: a page for an operation that no longer exists must not\n            // survive into what gets hosted.\n            fs.rmSync(siteOut, { recursive: true, force: true });\n            const written = new StagedOutput().publish(staging, siteOut);\n            target.assertOutputsCover(written);\n            return written;\n        } finally {\n            fs.rmSync(staging, { recursive: true, force: true });\n        }\n    }\n}\n\n// webpieces-disable no-function-outside-class -- nx executor module: nx resolves a default-export function here\nexport default async function runExecutor(\n    options: DocsGenerateOptions,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- this IS the executor's single top-level handler\n    try {\n        const written = new DocsGenerate().run(options, context);\n        console.log(`wrote ${written.length} file(s) of the docs site for ${context.projectName ?? ''}`);\n        return new ExecutorResult(true);\n    } catch (err: unknown) {\n        const error = toError(err);\n        console.error(`❌ ${RULE_NAME}: ${error instanceof RuleFailError ? renderRuleFailForHuman(error) : error.message}`);\n        return new ExecutorResult(false);\n    }\n}\n"]}

package/src/executors/docs-generate/schema.json

@@ -1,16 +1,16 @@
 {
     "$schema": "http://json-schema.org/schema",
     "title": "Docs Generate Executor",
-    "description": "Render the static API reference site from a document openapi-generate wrote into the build outputPath, with the consumer's own @webpieces/docs-site, into <outputPath>/<siteDir>. The target must dependsOn openapi-generate and declare outputs covering the site.",
+    "description": "Inferred on a project tagged generate:docs-site. Render the static API reference site from a document openapi-generate wrote, with the consumer's own @webpieces/docs-site, into <projectRoot>/<siteDir> (gitignored, for hosting — not packed into the package).",
     "type": "object",
     "properties": {
         "document": {
             "type": "string",
-            "description": "The document inside the build outputPath to render, e.g. public-openapi.json. No default."
+            "description": "The document openapi-generate wrote to render, e.g. public-openapi.json. No default."
         },
         "siteDir": {
             "type": "string",
-            "description": "The site's directory name inside the build outputPath, e.g. docs-site. No default."
+            "description": "The site's directory relative to the project root, e.g. generated-docs. Emptied and rewritten on every run; gitignore it. No default."
         },
         "prose": {
             "type": "string",

package/src/executors/openapi-generate/executor.d.ts

@@ -1,33 +1,38 @@
 /**
  * openapi-generate Executor
  *
- * Renders a project's contracts to OpenAPI (and `mcp-tools.json`) INTO the project's own build
- * `outputPath`, so the documents are packed and published inside the api library's npm package: a
- * consumer installs the library and has the contract. They are build output — never committed.
+ * Renders a project's contracts to OpenAPI, plus ONE MCP tool catalog per contract
+ * (`mcp-<ContractClass>-tools.json`), INTO the outputPath of the target it dependsOn — the api
+ * library's compile step — so the documents are packed and published inside the api library's npm
+ * package: a consumer installs the library and has the contract. They are build output, never
+ * committed.
  *
- * Usage (project.json):
+ * Consumers do not declare this executor. The nx-webpieces-rules plugin INFERS the target on a project
+ * tagged `generate:openapi` (executor, cache, inputs, outputs); project.json states only what is the
+ * consumer's to decide, under the same target name:
  *
- *   "openapi-generate": {
- *     "executor": "@webpieces/nx-webpieces-rules:openapi-generate",
- *     "dependsOn": ["build"],
- *     "cache": true,
- *     "inputs": ["default", "^default"],
- *     "outputs": [
- *       "{workspaceRoot}/dist/<project>/*openapi.json",
- *       "{workspaceRoot}/dist/<project>/*openapi.yaml",
- *       "{workspaceRoot}/dist/<project>/mcp-tools.json"
- *     ],
- *     "options": { "manifest": "<project>/openapi.manifest.json", "format": "both" }
+ *   "tags": ["generate:openapi"],
+ *   "targets": {
+ *     "compile": { "executor": "@nx/js:tsc", "outputs": ["{options.outputPath}"],
+ *                  "options": { "outputPath": "dist/<project>", ... } },
+ *     "openapi-generate": {
+ *       "dependsOn": ["compile"],
+ *       "options": { "manifest": "<project>/openapi.manifest.json", "format": "both" }
+ *     },
+ *     "build": { "executor": "nx:noop", "dependsOn": ["compile", "openapi-generate"] }
  *   }
  *
- * `dependsOn: ["build"]` and `outputs` are CHECKED, not merely recommended — see GeneratorTarget. The
+ * The output directory is the outputPath of the ONE target `dependsOn` names (GeneratedApiDocsLayout
+ * in @webpieces/core-util — the same lookup the MCP server reads with), never a hardcoded target name
+ * and never an assumed dist/. `outputs` are CHECKED against what a run wrote — see GeneratorTarget. The
  * generator itself is the CONSUMER's `@webpieces/openapi-generator`, resolved from its node_modules and
- * version-checked; this plugin bundles no copy of it (see ConsumerBinResolver in @webpieces/pr-gate).
+ * version-checked; this plugin bundles no copy of it (see ConsumerBinResolver).
  */
 import type { ExecutorContext } from '@nx/devkit';
-import { ConsumerBinResolver, GeneratorRunner } from '@webpieces/pr-gate';
 import { RepoScratchDirs } from '@webpieces/rules-config';
 import { ExecutorResult } from '../../executor-result';
+import { ConsumerBinResolver } from '../../lib/api-docs/consumer-bin-resolver';
+import { GeneratorRunner } from '../../lib/api-docs/generator-runner';
 export interface OpenApiGenerateOptions {
     /** Workspace-relative path to the project's `openapi.manifest.json`. Required; no default. */
     manifest?: string;

package/src/executors/openapi-generate/executor.js

@@ -2,47 +2,54 @@
 /**
  * openapi-generate Executor
  *
- * Renders a project's contracts to OpenAPI (and `mcp-tools.json`) INTO the project's own build
- * `outputPath`, so the documents are packed and published inside the api library's npm package: a
- * consumer installs the library and has the contract. They are build output — never committed.
+ * Renders a project's contracts to OpenAPI, plus ONE MCP tool catalog per contract
+ * (`mcp-<ContractClass>-tools.json`), INTO the outputPath of the target it dependsOn — the api
+ * library's compile step — so the documents are packed and published inside the api library's npm
+ * package: a consumer installs the library and has the contract. They are build output, never
+ * committed.
  *
- * Usage (project.json):
+ * Consumers do not declare this executor. The nx-webpieces-rules plugin INFERS the target on a project
+ * tagged `generate:openapi` (executor, cache, inputs, outputs); project.json states only what is the
+ * consumer's to decide, under the same target name:
  *
- *   "openapi-generate": {
- *     "executor": "@webpieces/nx-webpieces-rules:openapi-generate",
- *     "dependsOn": ["build"],
- *     "cache": true,
- *     "inputs": ["default", "^default"],
- *     "outputs": [
- *       "{workspaceRoot}/dist/<project>/*openapi.json",
- *       "{workspaceRoot}/dist/<project>/*openapi.yaml",
- *       "{workspaceRoot}/dist/<project>/mcp-tools.json"
- *     ],
- *     "options": { "manifest": "<project>/openapi.manifest.json", "format": "both" }
+ *   "tags": ["generate:openapi"],
+ *   "targets": {
+ *     "compile": { "executor": "@nx/js:tsc", "outputs": ["{options.outputPath}"],
+ *                  "options": { "outputPath": "dist/<project>", ... } },
+ *     "openapi-generate": {
+ *       "dependsOn": ["compile"],
+ *       "options": { "manifest": "<project>/openapi.manifest.json", "format": "both" }
+ *     },
+ *     "build": { "executor": "nx:noop", "dependsOn": ["compile", "openapi-generate"] }
  *   }
  *
- * `dependsOn: ["build"]` and `outputs` are CHECKED, not merely recommended — see GeneratorTarget. The
+ * The output directory is the outputPath of the ONE target `dependsOn` names (GeneratedApiDocsLayout
+ * in @webpieces/core-util — the same lookup the MCP server reads with), never a hardcoded target name
+ * and never an assumed dist/. `outputs` are CHECKED against what a run wrote — see GeneratorTarget. The
  * generator itself is the CONSUMER's `@webpieces/openapi-generator`, resolved from its node_modules and
- * version-checked; this plugin bundles no copy of it (see ConsumerBinResolver in @webpieces/pr-gate).
+ * version-checked; this plugin bundles no copy of it (see ConsumerBinResolver).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenApiGenerate = void 0;
 exports.default = runExecutor;
 const tslib_1 = require("tslib");
-const pr_gate_1 = require("@webpieces/pr-gate");
+const core_util_1 = require("@webpieces/core-util");
 const rules_config_1 = require("@webpieces/rules-config");
 const fs = tslib_1.__importStar(require("fs"));
 const path = tslib_1.__importStar(require("path"));
 const executor_result_1 = require("../../executor-result");
-const generator_target_1 = require("../../lib/generated-docs/generator-target");
+const consumer_bin_resolver_1 = require("../../lib/api-docs/consumer-bin-resolver");
+const generator_package_1 = require("../../lib/api-docs/generator-package");
+const generator_runner_1 = require("../../lib/api-docs/generator-runner");
+const generator_target_1 = require("../../lib/api-docs/generator-target");
 const toError_1 = require("../../toError");
-const RULE_NAME = 'openapi-generate';
+const RULE_NAME = core_util_1.GeneratedApiDocsLayout.OPENAPI_TARGET;
 /** Everything except the process-facing reporting, so the suite drives it exactly as nx does. */
 class OpenApiGenerate {
     resolver;
     runner;
     scratch;
-    constructor(resolver = new pr_gate_1.ConsumerBinResolver(), runner = new pr_gate_1.GeneratorRunner(), scratch = new rules_config_1.RepoScratchDirs()) {
+    constructor(resolver = new consumer_bin_resolver_1.ConsumerBinResolver(), runner = new generator_runner_1.GeneratorRunner(), scratch = new rules_config_1.RepoScratchDirs()) {
         this.resolver = resolver;
         this.runner = runner;
         this.scratch = scratch;
@@ -50,11 +57,10 @@ class OpenApiGenerate {
     /** @returns the files written, absolute. Throws RuleFailError on every refusal. */
     run(options, context) {
         const target = generator_target_1.GeneratorTarget.of(RULE_NAME, context);
-        target.assertDependsOn('build');
+        const outDir = target.documentsDir();
         const manifest = target.requiredOption(options.manifest, 'manifest');
         const format = target.requiredOption(options.format, 'format');
-        const outDir = target.buildOutputDir();
-        const bin = this.resolver.resolve(new pr_gate_1.ConsumerBinRequest(RULE_NAME, pr_gate_1.OPENAPI_GENERATOR, [path.join(context.root, target.projectRoot), context.root]));
+        const bin = this.resolver.resolve(new consumer_bin_resolver_1.ConsumerBinRequest(RULE_NAME, generator_package_1.OPENAPI_GENERATOR, [path.join(context.root, target.projectRoot), context.root]));
         const staging = this.scratch.make(context.root, 'wp-openapi-generate-');
         // webpieces-disable no-unmanaged-exceptions -- try/FINALLY only, nothing is caught: the staging
         // directory is removed however this ends, and every throw still reaches runExecutor below

package/src/executors/openapi-generate/executor.js.map

@@ -1 +1 @@
-{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/openapi-generate/executor.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * openapi-generate Executor\n *\n * Renders a project's contracts to OpenAPI (and `mcp-tools.json`) INTO the project's own build\n * `outputPath`, so the documents are packed and published inside the api library's npm package: a\n * consumer installs the library and has the contract. They are build output — never committed.\n *\n * Usage (project.json):\n *\n *   \"openapi-generate\": {\n *     \"executor\": \"@webpieces/nx-webpieces-rules:openapi-generate\",\n *     \"dependsOn\": [\"build\"],\n *     \"cache\": true,\n *     \"inputs\": [\"default\", \"^default\"],\n *     \"outputs\": [\n *       \"{workspaceRoot}/dist/<project>/*openapi.json\",\n *       \"{workspaceRoot}/dist/<project>/*openapi.yaml\",\n *       \"{workspaceRoot}/dist/<project>/mcp-tools.json\"\n *     ],\n *     \"options\": { \"manifest\": \"<project>/openapi.manifest.json\", \"format\": \"both\" }\n *   }\n *\n * `dependsOn: [\"build\"]` and `outputs` are CHECKED, not merely recommended — see GeneratorTarget. The\n * generator itself is the CONSUMER's `@webpieces/openapi-generator`, resolved from its node_modules and\n * version-checked; this plugin bundles no copy of it (see ConsumerBinResolver in @webpieces/pr-gate).\n */\n\nimport type { ExecutorContext } from '@nx/devkit';\nimport {\n    ConsumerBinRequest, ConsumerBinResolver, GeneratorRunner, OPENAPI_GENERATOR,\n} from '@webpieces/pr-gate';\nimport { RepoScratchDirs, RuleFailError, renderRuleFailForHuman } from '@webpieces/rules-config';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { ExecutorResult } from '../../executor-result';\nimport { GeneratorTarget, StagedOutput } from '../../lib/generated-docs/generator-target';\nimport { toError } from '../../toError';\n\nexport interface OpenApiGenerateOptions {\n    /** Workspace-relative path to the project's `openapi.manifest.json`. Required; no default. */\n    manifest?: string;\n    /** `json`, `yaml` or `both`. Required; no default — it decides what the package ships. */\n    format?: string;\n}\n\nconst RULE_NAME = 'openapi-generate';\n\n/** Everything except the process-facing reporting, so the suite drives it exactly as nx does. */\nexport class OpenApiGenerate {\n    constructor(\n        private readonly resolver: ConsumerBinResolver = new ConsumerBinResolver(),\n        private readonly runner: GeneratorRunner = new GeneratorRunner(),\n        private readonly scratch: RepoScratchDirs = new RepoScratchDirs(),\n    ) {}\n\n    /** @returns the files written, absolute. Throws RuleFailError on every refusal. */\n    run(options: OpenApiGenerateOptions, context: ExecutorContext): string[] {\n        const target = GeneratorTarget.of(RULE_NAME, context);\n        target.assertDependsOn('build');\n        const manifest = target.requiredOption(options.manifest, 'manifest');\n        const format = target.requiredOption(options.format, 'format');\n        const outDir = target.buildOutputDir();\n        const bin = this.resolver.resolve(new ConsumerBinRequest(\n            RULE_NAME, OPENAPI_GENERATOR, [path.join(context.root, target.projectRoot), context.root]));\n\n        const staging = this.scratch.make(context.root, 'wp-openapi-generate-');\n        // webpieces-disable no-unmanaged-exceptions -- try/FINALLY only, nothing is caught: the staging\n        // directory is removed however this ends, and every throw still reaches runExecutor below\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            const run = this.runner.run(bin, [\n                '--manifest', path.resolve(context.root, manifest), '--out', staging, '--format', format,\n            ], context.root);\n            if (!run.ok) {\n                throw new RuleFailError(\n                    RULE_NAME,\n                    `${bin.packageName} ${bin.version} refused ${manifest}:\\n${run.output}`,\n                );\n            }\n            const written = new StagedOutput().publish(staging, outDir);\n            target.assertOutputsCover(written);\n            return written;\n        } finally {\n            fs.rmSync(staging, { recursive: true, force: true });\n        }\n    }\n}\n\n// webpieces-disable no-function-outside-class -- nx executor module: nx resolves a default-export function here\nexport default async function runExecutor(\n    options: OpenApiGenerateOptions,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- this IS the executor's single top-level handler\n    try {\n        const written = new OpenApiGenerate().run(options, context);\n        for (const file of written) console.log(`wrote ${path.relative(context.root, file)}`);\n        return new ExecutorResult(true);\n    } catch (err: unknown) {\n        const error = toError(err);\n        console.error(`❌ ${RULE_NAME}: ${error instanceof RuleFailError ? renderRuleFailForHuman(error) : error.message}`);\n        return new ExecutorResult(false);\n    }\n}\n"]}
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/openapi-generate/executor.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * openapi-generate Executor\n *\n * Renders a project's contracts to OpenAPI, plus ONE MCP tool catalog per contract\n * (`mcp-<ContractClass>-tools.json`), INTO the outputPath of the target it dependsOn — the api\n * library's compile step — so the documents are packed and published inside the api library's npm\n * package: a consumer installs the library and has the contract. They are build output, never\n * committed.\n *\n * Consumers do not declare this executor. The nx-webpieces-rules plugin INFERS the target on a project\n * tagged `generate:openapi` (executor, cache, inputs, outputs); project.json states only what is the\n * consumer's to decide, under the same target name:\n *\n *   \"tags\": [\"generate:openapi\"],\n *   \"targets\": {\n *     \"compile\": { \"executor\": \"@nx/js:tsc\", \"outputs\": [\"{options.outputPath}\"],\n *                  \"options\": { \"outputPath\": \"dist/<project>\", ... } },\n *     \"openapi-generate\": {\n *       \"dependsOn\": [\"compile\"],\n *       \"options\": { \"manifest\": \"<project>/openapi.manifest.json\", \"format\": \"both\" }\n *     },\n *     \"build\": { \"executor\": \"nx:noop\", \"dependsOn\": [\"compile\", \"openapi-generate\"] }\n *   }\n *\n * The output directory is the outputPath of the ONE target `dependsOn` names (GeneratedApiDocsLayout\n * in @webpieces/core-util — the same lookup the MCP server reads with), never a hardcoded target name\n * and never an assumed dist/. `outputs` are CHECKED against what a run wrote — see GeneratorTarget. The\n * generator itself is the CONSUMER's `@webpieces/openapi-generator`, resolved from its node_modules and\n * version-checked; this plugin bundles no copy of it (see ConsumerBinResolver).\n */\n\nimport type { ExecutorContext } from '@nx/devkit';\nimport { GeneratedApiDocsLayout } from '@webpieces/core-util';\nimport { RepoScratchDirs, RuleFailError, renderRuleFailForHuman } from '@webpieces/rules-config';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { ExecutorResult } from '../../executor-result';\nimport { ConsumerBinRequest, ConsumerBinResolver } from '../../lib/api-docs/consumer-bin-resolver';\nimport { OPENAPI_GENERATOR } from '../../lib/api-docs/generator-package';\nimport { GeneratorRunner } from '../../lib/api-docs/generator-runner';\nimport { GeneratorTarget, StagedOutput } from '../../lib/api-docs/generator-target';\nimport { toError } from '../../toError';\n\nexport interface OpenApiGenerateOptions {\n    /** Workspace-relative path to the project's `openapi.manifest.json`. Required; no default. */\n    manifest?: string;\n    /** `json`, `yaml` or `both`. Required; no default — it decides what the package ships. */\n    format?: string;\n}\n\nconst RULE_NAME = GeneratedApiDocsLayout.OPENAPI_TARGET;\n\n/** Everything except the process-facing reporting, so the suite drives it exactly as nx does. */\nexport class OpenApiGenerate {\n    constructor(\n        private readonly resolver: ConsumerBinResolver = new ConsumerBinResolver(),\n        private readonly runner: GeneratorRunner = new GeneratorRunner(),\n        private readonly scratch: RepoScratchDirs = new RepoScratchDirs(),\n    ) {}\n\n    /** @returns the files written, absolute. Throws RuleFailError on every refusal. */\n    run(options: OpenApiGenerateOptions, context: ExecutorContext): string[] {\n        const target = GeneratorTarget.of(RULE_NAME, context);\n        const outDir = target.documentsDir();\n        const manifest = target.requiredOption(options.manifest, 'manifest');\n        const format = target.requiredOption(options.format, 'format');\n        const bin = this.resolver.resolve(new ConsumerBinRequest(\n            RULE_NAME, OPENAPI_GENERATOR, [path.join(context.root, target.projectRoot), context.root]));\n\n        const staging = this.scratch.make(context.root, 'wp-openapi-generate-');\n        // webpieces-disable no-unmanaged-exceptions -- try/FINALLY only, nothing is caught: the staging\n        // directory is removed however this ends, and every throw still reaches runExecutor below\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions\n        try {\n            const run = this.runner.run(bin, [\n                '--manifest', path.resolve(context.root, manifest), '--out', staging, '--format', format,\n            ], context.root);\n            if (!run.ok) {\n                throw new RuleFailError(\n                    RULE_NAME,\n                    `${bin.packageName} ${bin.version} refused ${manifest}:\\n${run.output}`,\n                );\n            }\n            const written = new StagedOutput().publish(staging, outDir);\n            target.assertOutputsCover(written);\n            return written;\n        } finally {\n            fs.rmSync(staging, { recursive: true, force: true });\n        }\n    }\n}\n\n// webpieces-disable no-function-outside-class -- nx executor module: nx resolves a default-export function here\nexport default async function runExecutor(\n    options: OpenApiGenerateOptions,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- this IS the executor's single top-level handler\n    try {\n        const written = new OpenApiGenerate().run(options, context);\n        for (const file of written) console.log(`wrote ${path.relative(context.root, file)}`);\n        return new ExecutorResult(true);\n    } catch (err: unknown) {\n        const error = toError(err);\n        console.error(`❌ ${RULE_NAME}: ${error instanceof RuleFailError ? renderRuleFailForHuman(error) : error.message}`);\n        return new ExecutorResult(false);\n    }\n}\n"]}

package/src/executors/openapi-generate/schema.json

@@ -1,7 +1,7 @@
 {
     "$schema": "http://json-schema.org/schema",
     "title": "OpenAPI Generate Executor",
-    "description": "Render the project's contracts to OpenAPI (and mcp-tools.json) into the project's build outputPath, with the consumer's own @webpieces/openapi-generator. The target must dependsOn build and declare outputs covering what it writes.",
+    "description": "Inferred on a project tagged generate:openapi. Render the project's contracts to OpenAPI plus one mcp-<ContractClass>-tools.json per MCP contract, with the consumer's own @webpieces/openapi-generator, into the outputPath of the ONE target this target dependsOn (the compile step).",
     "type": "object",
     "properties": {
         "manifest": {
@@ -11,7 +11,7 @@
         "format": {
             "type": "string",
             "enum": ["json", "yaml", "both"],
-            "description": "Which serializations to write, and therefore publish. No default."
+            "description": "Which serializations of the OpenAPI documents to write, and therefore publish. No default."
         }
     },
     "required": ["manifest", "format"]

package/src/executors/validate-nx-wiring/executor.d.ts

@@ -18,6 +18,10 @@
  * fast compile-only step while `nx ci` runs the full gate. This executor therefore only
  * guards build ORDER (`^build`), not the validators — those are guaranteed by the plugin.
  *
+ * 3. Generated API documents (#1021) — a project tagged `generate:openapi` / `generate:docs-site` has the
+ *    `compile` → `openapi-generate` → `build` (nx:noop) shape, and every project depending on one has
+ *    `test` dependsOn `^build`. See GenerateWiring for why.
+ *
  * Conservative by design: only REQUIRES wiring on compile executors actually in use
  * (@nx/js:tsc, @angular/build:application). A repo that uses neither passes.
  *

package/src/executors/validate-nx-wiring/executor.js

@@ -19,6 +19,10 @@
  * fast compile-only step while `nx ci` runs the full gate. This executor therefore only
  * guards build ORDER (`^build`), not the validators — those are guaranteed by the plugin.
  *
+ * 3. Generated API documents (#1021) — a project tagged `generate:openapi` / `generate:docs-site` has the
+ *    `compile` → `openapi-generate` → `build` (nx:noop) shape, and every project depending on one has
+ *    `test` dependsOn `^build`. See GenerateWiring for why.
+ *
  * Conservative by design: only REQUIRES wiring on compile executors actually in use
  * (@nx/js:tsc, @angular/build:application). A repo that uses neither passes.
  *
@@ -31,6 +35,7 @@ exports.default = runExecutor;
 const tslib_1 = require("tslib");
 const devkit_1 = require("@nx/devkit");
 const rules_config_1 = require("@webpieces/rules-config");
+const generate_wiring_1 = require("../../lib/api-docs/generate-wiring");
 const fs = tslib_1.__importStar(require("fs"));
 const path = tslib_1.__importStar(require("path"));
 // Compile executors (and any per-project build override) must keep `^build` so build order
@@ -183,16 +188,22 @@ async function runExecutor(options, context) {
     console.log('\n🔌 Validating webpieces validators are wired into the build\n');
     const projectGraph = await (0, devkit_1.createProjectGraphAsync)();
     const projectsConfig = (0, devkit_1.readProjectsConfigurationFromProjectGraph)(projectGraph);
+    const generateWiring = new generate_wiring_1.GenerateWiring(projectsConfig.projects, projectGraph.dependencies);
+    const generateProblems = generateWiring.problems();
     const inUse = findCompileExecutorsInUse(projectsConfig, compileExecutors);
     const relevantExecutors = compileExecutors.filter((executorName) => inUse.has(executorName));
     if (relevantExecutors.length === 0) {
+        if (generateProblems.length > 0) {
+            generateWiring.report(generateProblems);
+            return { success: false };
+        }
         console.log('✅ No known compile executors in use — nothing to gate\n');
         return { success: true };
     }
     const targetDefaults = readTargetDefaults(context.root);
     const wiringProblems = findProblems(relevantExecutors, targetDefaults, requiredDeps);
     const gateProblems = findProjectGateProblems(projectsConfig, inUse, requiredDeps);
-    if (wiringProblems.length === 0 && gateProblems.length === 0) {
+    if (wiringProblems.length === 0 && gateProblems.length === 0 && generateProblems.length === 0) {
         console.log('✅ Validators are wired into the build (targetDefaults + every project)\n');
         return { success: true };
     }
@@ -200,6 +211,8 @@ async function runExecutor(options, context) {
         reportFailure(wiringProblems, requiredDeps);
     if (gateProblems.length > 0)
         reportProjectGateFailure(gateProblems);
+    if (generateProblems.length > 0)
+        generateWiring.report(generateProblems);
     return { success: false };
 }
 //# sourceMappingURL=executor.js.map