@webpieces/nx-webpieces-rules 0.3.130 → 0.3.133

package/README.md

@@ -0,0 +1,66 @@
+# @webpieces/nx-webpieces-rules
+
+Nx inference plugin that auto-creates webpieces validation targets (architecture
+graph checks, code-size/style rules, and a per-project circular-import gate)
+without any manual `project.json` wiring.
+
+Add it to `nx.json`:
+
+```jsonc
+{
+  "plugins": ["@webpieces/nx-webpieces-rules"]
+}
+```
+
+## Circular file-import gate (`validate-no-file-import-cycles`)
+
+Each project gets a `validate-no-file-import-cycles` target that runs
+[`madge`](https://github.com/pahen/madge) over its TypeScript sources and fails
+on an import cycle. `madge` is bundled as a pinned dependency, so there is **no
+runtime `npx` fetch** (which previously corrupted CI npx caches).
+
+It is wired into the build: the `@nx/js:tsc` target default lists it in
+`dependsOn`, so `nx affected --target=ci` (→ `ci` → `build`) and
+`nx run-many --target=build` both run it.
+
+### Configuration
+
+On/off and a time-boxed grace window come from `webpieces.config.json` at the
+workspace root — the same source of truth as every other webpieces rule — under
+the rule key `no-file-import-cycles`:
+
+```jsonc
+{
+  "rules": {
+    "no-file-import-cycles": {
+      "mode": "ON",                            // "OFF" disables the gate everywhere
+      "ignoreModifiedUntilEpoch": 1771931925,  // epoch SECONDS — while now < epoch,
+                                               //   cycles are REPORTED but the build
+                                               //   PASSES; after it, the gate fails again
+      "ignoreTypeOnly": false                  // when true, ignore `import type`
+                                               //   re-export cycles (erased at compile
+                                               //   time, harmless at runtime)
+    }
+  }
+}
+```
+
+Semantics, mirroring the method/file-size dated-disable model:
+
+| Situation                                   | Result                          |
+| ------------------------------------------- | ------------------------------- |
+| `mode: "OFF"`                               | Skipped (passes), no madge run  |
+| Cycle found, no `ignoreModifiedUntilEpoch`  | **Fails**                       |
+| Cycle found, `now < ignoreModifiedUntilEpoch` | Reported but **passes** (warn) |
+| Cycle found, `now >= ignoreModifiedUntilEpoch` | **Fails** again               |
+| No cycle                                    | Passes                          |
+
+The grace window lets you turn a strict gate on against an existing codebase
+without an open-ended "off everywhere" escape hatch — the debt can't be silently
+forgotten because the gate starts failing again after the date.
+
+### Disabling at the Nx layer
+
+Setting `circularDeps.enabled: false` in the plugin options removes the target
+entirely (rather than toggling it via config). Prefer `mode: "OFF"` instead — it
+keeps the target present so any `dependsOn` references don't dangle.

package/executors.json

@@ -25,6 +25,11 @@
             "schema": "./src/executors/validate-no-skiplevel-deps/schema.json",
             "description": "Validate no project has redundant transitive dependencies"
         },
+        "validate-no-file-import-cycles": {
+            "implementation": "./src/executors/validate-no-file-import-cycles/executor",
+            "schema": "./src/executors/validate-no-file-import-cycles/schema.json",
+            "description": "Check a project for circular file imports with madge (config-driven on/off + grace window)"
+        },
         "validate-packagejson": {
             "implementation": "./src/executors/validate-packagejson/executor",
             "schema": "./src/executors/validate-packagejson/schema.json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/nx-webpieces-rules",
-  "version": "0.3.130",
+  "version": "0.3.133",
   "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,10 +18,11 @@
     "README.md"
   ],
   "dependencies": {
-    "@webpieces/ai-hook-rules": "0.3.130",
-    "@webpieces/code-rules": "0.3.130",
-    "@webpieces/eslint-rules": "0.3.130",
-    "@webpieces/rules-config": "0.3.130"
+    "@webpieces/ai-hook-rules": "0.3.133",
+    "@webpieces/code-rules": "0.3.133",
+    "@webpieces/eslint-rules": "0.3.133",
+    "@webpieces/rules-config": "0.3.133",
+    "madge": "8.0.0"
   },
   "peerDependencies": {
     "@nx/devkit": ">=18.0.0"

package/src/executors/validate-no-file-import-cycles/executor.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Validate No File Import Cycles Executor
+ *
+ * Per-project circular-dependency gate. Runs `madge` over the project's
+ * TypeScript sources and fails when an import cycle is found.
+ *
+ * Unlike the old `nx:run-commands` target (which shelled out to a runtime
+ * `npx madge` fetch — see NEEDED_CHANGES.md #1), this executor:
+ *   - invokes the madge it bundles as a dependency (deterministic, no network),
+ *   - is driven by webpieces.config.json like every other webpieces rule, so it
+ *     supports an on/off `mode` and a time-boxed `ignoreModifiedUntilEpoch`.
+ *
+ * Config (webpieces.config.json, rule key `no-file-import-cycles`):
+ *   "no-file-import-cycles": {
+ *       "mode": "ON",                       // "OFF" disables the gate everywhere
+ *       "ignoreModifiedUntilEpoch": 1771931925,  // epoch SECONDS; while now < epoch,
+ *                                            //   cycles are reported but the gate PASSES
+ *                                            //   (warn, don't fail). After it, fails again.
+ *       "ignoreTypeOnly": true              // ignore `import type` re-export cycles
+ *                                            //   (erased at compile time, harmless at runtime)
+ *   }
+ *
+ * Mirrors the dated-disable model already used for the method/file-size rules:
+ * the epoch is a grace window so a strict gate can be turned on against an
+ * existing codebase without an open-ended "off everywhere" escape hatch.
+ *
+ * Usage: nx run <project>:validate-no-file-import-cycles
+ */
+import type { ExecutorContext } from '@nx/devkit';
+export type ValidateNoFileImportCyclesMode = 'ON' | 'OFF';
+export interface ValidateNoFileImportCyclesOptions {
+}
+export interface ExecutorResult {
+    success: boolean;
+}
+export default function runExecutor(_options: ValidateNoFileImportCyclesOptions, context: ExecutorContext): Promise<ExecutorResult>;

package/src/executors/validate-no-file-import-cycles/executor.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * Validate No File Import Cycles Executor
+ *
+ * Per-project circular-dependency gate. Runs `madge` over the project's
+ * TypeScript sources and fails when an import cycle is found.
+ *
+ * Unlike the old `nx:run-commands` target (which shelled out to a runtime
+ * `npx madge` fetch — see NEEDED_CHANGES.md #1), this executor:
+ *   - invokes the madge it bundles as a dependency (deterministic, no network),
+ *   - is driven by webpieces.config.json like every other webpieces rule, so it
+ *     supports an on/off `mode` and a time-boxed `ignoreModifiedUntilEpoch`.
+ *
+ * Config (webpieces.config.json, rule key `no-file-import-cycles`):
+ *   "no-file-import-cycles": {
+ *       "mode": "ON",                       // "OFF" disables the gate everywhere
+ *       "ignoreModifiedUntilEpoch": 1771931925,  // epoch SECONDS; while now < epoch,
+ *                                            //   cycles are reported but the gate PASSES
+ *                                            //   (warn, don't fail). After it, fails again.
+ *       "ignoreTypeOnly": true              // ignore `import type` re-export cycles
+ *                                            //   (erased at compile time, harmless at runtime)
+ *   }
+ *
+ * Mirrors the dated-disable model already used for the method/file-size rules:
+ * the epoch is a grace window so a strict gate can be turned on against an
+ * existing codebase without an open-ended "off everywhere" escape hatch.
+ *
+ * Usage: nx run <project>:validate-no-file-import-cycles
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = runExecutor;
+const tslib_1 = require("tslib");
+const rules_config_1 = require("@webpieces/rules-config");
+const path = tslib_1.__importStar(require("path"));
+const RULE_NAME = 'no-file-import-cycles';
+function loadMadge() {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const mod = require('madge');
+    return mod.default ?? mod;
+}
+/**
+ * Decide whether the gate should still FAIL on cycles (true) or only warn
+ * (false), considering the ignoreModifiedUntilEpoch grace window. Logs a
+ * one-line explanation when the grace window is active.
+ */
+function isFailingActive(epoch) {
+    if (epoch === undefined)
+        return true;
+    const nowSeconds = Date.now() / 1000;
+    if (nowSeconds < epoch) {
+        const expires = new Date(epoch * 1000).toISOString().split('T')[0];
+        console.log(`\n⏳ no-file-import-cycles: ignoreModifiedUntilEpoch active (expires ${expires}).` +
+            '\n   Cycles will be reported but NOT fail the build until then.\n');
+        return false;
+    }
+    return true;
+}
+function buildMadgeOptions(ignoreTypeOnly) {
+    const options = { fileExtensions: ['ts', 'tsx'] };
+    if (ignoreTypeOnly) {
+        // dependency-tree's TS detective drops `import type {...}` edges with this flag.
+        options.detectiveOptions = {
+            ts: { skipTypeImports: true },
+            tsx: { skipTypeImports: true },
+        };
+    }
+    return options;
+}
+function reportCycles(projectName, cycles) {
+    console.error(`\n❌ Found ${cycles.length} circular import cycle(s) in ${projectName}:\n`);
+    cycles.forEach((cycle, i) => {
+        console.error(`  ${i + 1}. ${cycle.join(' → ')} → ${cycle[0]}`);
+    });
+    console.error('\nTo fix, break the cycle (extract a shared module, or use an interface).');
+    console.error('To time-box a known cycle, a human can set "ignoreModifiedUntilEpoch"');
+    console.error(`(epoch seconds) on the "${RULE_NAME}" rule in webpieces.config.json.`);
+    console.error(`To turn the gate off entirely, set "${RULE_NAME}".mode to "OFF".\n`);
+}
+async function runExecutor(_options, context) {
+    const shared = (0, rules_config_1.loadConfig)(context.root);
+    const rule = shared.rules.get(RULE_NAME);
+    if (rule && rule.isOff) {
+        console.log(`\n⏭️  Skipping ${RULE_NAME} (mode: OFF)\n`);
+        return { success: true };
+    }
+    const projectName = context.projectName ?? 'project';
+    const projectConfig = context.projectsConfigurations?.projects[projectName];
+    const projectRoot = projectConfig ? path.join(context.root, projectConfig.root) : context.root;
+    const epoch = rule?.options['ignoreModifiedUntilEpoch'];
+    const ignoreTypeOnly = rule?.options['ignoreTypeOnly'] ?? false;
+    console.log(`\n🔁 Checking import cycles in ${projectName} (madge)\n`);
+    const madge = loadMadge();
+    const result = await madge(projectRoot, buildMadgeOptions(ignoreTypeOnly));
+    const cycles = result.circular();
+    if (cycles.length === 0) {
+        console.log('✅ No circular import cycles found\n');
+        return { success: true };
+    }
+    reportCycles(projectName, cycles);
+    // Grace window active → report but pass; otherwise fail.
+    return { success: !isFailingActive(epoch) };
+}
+//# sourceMappingURL=executor.js.map

package/src/executors/validate-no-file-import-cycles/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../../../../../packages/tooling/nx-webpieces-rules/src/executors/validate-no-file-import-cycles/executor.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Validate No File Import Cycles Executor\n *\n * Per-project circular-dependency gate. Runs `madge` over the project's\n * TypeScript sources and fails when an import cycle is found.\n *\n * Unlike the old `nx:run-commands` target (which shelled out to a runtime\n * `npx madge` fetch — see NEEDED_CHANGES.md #1), this executor:\n *   - invokes the madge it bundles as a dependency (deterministic, no network),\n *   - is driven by webpieces.config.json like every other webpieces rule, so it\n *     supports an on/off `mode` and a time-boxed `ignoreModifiedUntilEpoch`.\n *\n * Config (webpieces.config.json, rule key `no-file-import-cycles`):\n *   \"no-file-import-cycles\": {\n *       \"mode\": \"ON\",                       // \"OFF\" disables the gate everywhere\n *       \"ignoreModifiedUntilEpoch\": 1771931925,  // epoch SECONDS; while now < epoch,\n *                                            //   cycles are reported but the gate PASSES\n *                                            //   (warn, don't fail). After it, fails again.\n *       \"ignoreTypeOnly\": true              // ignore `import type` re-export cycles\n *                                            //   (erased at compile time, harmless at runtime)\n *   }\n *\n * Mirrors the dated-disable model already used for the method/file-size rules:\n * the epoch is a grace window so a strict gate can be turned on against an\n * existing codebase without an open-ended \"off everywhere\" escape hatch.\n *\n * Usage: nx run <project>:validate-no-file-import-cycles\n */\n\nimport type { ExecutorContext } from '@nx/devkit';\nimport { loadConfig } from '@webpieces/rules-config';\nimport * as path from 'path';\n\nexport type ValidateNoFileImportCyclesMode = 'ON' | 'OFF';\n\nexport interface ValidateNoFileImportCyclesOptions {\n    // No options here — config comes from webpieces.config.json at runtime.\n}\n\nexport interface ExecutorResult {\n    success: boolean;\n}\n\nconst RULE_NAME = 'no-file-import-cycles';\n\n// madge ships no type declarations; describe the slice of its API we use.\n// webpieces-disable no-any-unknown -- minimal hand-typed surface for an untyped dependency\ninterface MadgeOptions {\n    fileExtensions: string[];\n    detectiveOptions?: Record<string, unknown>;\n}\ninterface MadgeInstance {\n    circular(): string[][];\n}\ntype MadgeFn = (target: string, options: MadgeOptions) => Promise<MadgeInstance>;\n\n// madge's CJS export is the callable itself; some bundlers wrap it under `.default`.\ninterface MadgeModuleExtras {\n    default?: MadgeFn;\n}\ntype MadgeModule = MadgeFn & MadgeModuleExtras;\n\nfunction loadMadge(): MadgeFn {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const mod: MadgeModule = require('madge');\n    return mod.default ?? mod;\n}\n\n/**\n * Decide whether the gate should still FAIL on cycles (true) or only warn\n * (false), considering the ignoreModifiedUntilEpoch grace window. Logs a\n * one-line explanation when the grace window is active.\n */\nfunction isFailingActive(epoch: number | undefined): boolean {\n    if (epoch === undefined) return true;\n    const nowSeconds = Date.now() / 1000;\n    if (nowSeconds < epoch) {\n        const expires = new Date(epoch * 1000).toISOString().split('T')[0];\n        console.log(\n            `\\n⏳ no-file-import-cycles: ignoreModifiedUntilEpoch active (expires ${expires}).` +\n                '\\n   Cycles will be reported but NOT fail the build until then.\\n',\n        );\n        return false;\n    }\n    return true;\n}\n\nfunction buildMadgeOptions(ignoreTypeOnly: boolean): MadgeOptions {\n    const options: MadgeOptions = { fileExtensions: ['ts', 'tsx'] };\n    if (ignoreTypeOnly) {\n        // dependency-tree's TS detective drops `import type {...}` edges with this flag.\n        options.detectiveOptions = {\n            ts: { skipTypeImports: true },\n            tsx: { skipTypeImports: true },\n        };\n    }\n    return options;\n}\n\nfunction reportCycles(projectName: string, cycles: string[][]): void {\n    console.error(`\\n❌ Found ${cycles.length} circular import cycle(s) in ${projectName}:\\n`);\n    cycles.forEach((cycle: string[], i: number) => {\n        console.error(`  ${i + 1}. ${cycle.join(' → ')} → ${cycle[0]}`);\n    });\n    console.error('\\nTo fix, break the cycle (extract a shared module, or use an interface).');\n    console.error('To time-box a known cycle, a human can set \"ignoreModifiedUntilEpoch\"');\n    console.error(`(epoch seconds) on the \"${RULE_NAME}\" rule in webpieces.config.json.`);\n    console.error(`To turn the gate off entirely, set \"${RULE_NAME}\".mode to \"OFF\".\\n`);\n}\n\nexport default async function runExecutor(\n    _options: ValidateNoFileImportCyclesOptions,\n    context: ExecutorContext,\n): Promise<ExecutorResult> {\n    const shared = loadConfig(context.root);\n    const rule = shared.rules.get(RULE_NAME);\n\n    if (rule && rule.isOff) {\n        console.log(`\\n⏭️  Skipping ${RULE_NAME} (mode: OFF)\\n`);\n        return { success: true };\n    }\n\n    const projectName = context.projectName ?? 'project';\n    const projectConfig = context.projectsConfigurations?.projects[projectName];\n    const projectRoot = projectConfig ? path.join(context.root, projectConfig.root) : context.root;\n\n    const epoch = rule?.options['ignoreModifiedUntilEpoch'] as number | undefined;\n    const ignoreTypeOnly = (rule?.options['ignoreTypeOnly'] as boolean | undefined) ?? false;\n\n    console.log(`\\n🔁 Checking import cycles in ${projectName} (madge)\\n`);\n\n    const madge = loadMadge();\n    const result = await madge(projectRoot, buildMadgeOptions(ignoreTypeOnly));\n    const cycles = result.circular();\n\n    if (cycles.length === 0) {\n        console.log('✅ No circular import cycles found\\n');\n        return { success: true };\n    }\n\n    reportCycles(projectName, cycles);\n\n    // Grace window active → report but pass; otherwise fail.\n    return { success: !isFailingActive(epoch) };\n}\n"]}

package/src/executors/validate-no-file-import-cycles/schema.json

@@ -0,0 +1,8 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "title": "Validate No File Import Cycles Executor",
+    "description": "Checks a project for circular file imports with madge. On/off and a time-boxed grace window come from webpieces.config.json (rule: no-file-import-cycles).",
+    "type": "object",
+    "properties": {},
+    "required": []
+}

package/src/plugin.js

@@ -488,22 +488,26 @@ function createHelpTarget() {
     };
 }
 /**
- * Create per-project circular dependency checking target
- * Runs on project root (.) to check ALL TypeScript files in the project
+ * Create per-project circular dependency checking target.
+ *
+ * Uses the `validate-no-file-import-cycles` executor (which bundles madge as a
+ * dependency) rather than a runtime `npx madge` fetch. The executor reads
+ * webpieces.config.json so the gate can be turned on/off (`mode`) and
+ * time-boxed (`ignoreModifiedUntilEpoch`) like every other webpieces rule.
+ *
+ * Note `projectRoot` is intentionally unused now — the executor derives the
+ * project root from the Nx context — but the param is kept for call-site
+ * symmetry with the rest of the per-project target factories.
  */
-function createCircularDepsTarget(projectRoot, targetName) {
+function createCircularDepsTarget(_projectRoot, _targetName) {
     return {
-        executor: 'nx:run-commands',
+        executor: '@webpieces/nx-webpieces-rules:validate-no-file-import-cycles',
         cache: true,
-        inputs: ['default'],
+        inputs: ['default', '{workspaceRoot}/webpieces.config.json'],
         outputs: [],
-        options: {
-            command: 'npx madge --circular --extensions ts,tsx .',
-            cwd: projectRoot,
-        },
         metadata: {
             technologies: ['madge'],
-            description: 'Check for circular dependencies using madge',
+            description: 'Check for circular file-import dependencies using madge',
         },
     };
 }

package/src/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../../../packages/tooling/nx-webpieces-rules/src/plugin.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Unified Nx Inference Plugin for @webpieces/nx-webpieces-rules\n *\n * This plugin automatically creates targets for:\n * 1. Workspace-level architecture validation (generate, visualize, validate-*)\n * 2. Per-project circular dependency checking\n *\n * Install with: nx add @webpieces/nx-webpieces-rules\n *\n * Usage:\n * Add to nx.json plugins array:\n * {\n *   \"plugins\": [\"@webpieces/nx-webpieces-rules\"]\n * }\n *\n * Then all targets appear automatically without manual project.json configuration.\n */\n\nimport { dirname, join } from 'path';\nimport { existsSync } from 'fs';\nimport type {\n    CreateNodesV2,\n    CreateNodesContextV2,\n    CreateNodesResultV2,\n    CreateNodesResult,\n    TargetConfiguration,\n} from '@nx/devkit';\n\n/**\n * Circular dependency checking options\n */\nexport interface CircularDepsOptions {\n    enabled?: boolean;\n    targetName?: string;\n    excludePatterns?: string[];\n}\n\n/**\n * Validation options for architecture checks\n */\nexport interface ValidationOptions {\n    noCycles?: boolean;\n    noSkipLevelDeps?: boolean;\n    architectureUnchanged?: boolean;\n    validatePackageJson?: boolean;\n    validateNewMethods?: boolean;\n    validateModifiedMethods?: boolean;\n    validateModifiedFiles?: boolean;\n    validateVersionsLocked?: boolean;\n    validateTsInSrc?: boolean;\n    validateNxWiring?: boolean;\n    newMethodsMaxLines?: number;\n    modifiedAndNewMethodsMaxLines?: number;\n    modifiedFilesMaxLines?: number;\n    /**\n     * Validation mode for method/file size limits:\n     * - STRICT: All limits enforced, disable comments ignored\n     * - NORMAL: Limits enforced, disable comments with dates work\n     * - OFF: Skip size validations entirely (for fast iteration)\n     */\n    validationMode?: 'STRICT' | 'NORMAL' | 'OFF';\n}\n\n/**\n * Feature flags for workspace targets\n */\nexport interface FeatureOptions {\n    generate?: boolean;\n    visualize?: boolean;\n}\n\n/**\n * Workspace-level configuration options\n */\nexport interface WorkspaceOptions {\n    enabled?: boolean;\n    targetPrefix?: string;\n    graphPath?: string;\n    validations?: ValidationOptions;\n    features?: FeatureOptions;\n}\n\n/**\n * Configuration for @webpieces/nx-webpieces-rules Nx plugin\n */\nexport interface ArchitecturePluginOptions {\n    circularDeps?: CircularDepsOptions;\n    workspace?: WorkspaceOptions;\n}\n\nconst DEFAULT_OPTIONS: Required<ArchitecturePluginOptions> = {\n    circularDeps: {\n        enabled: true,\n        targetName: 'validate-no-file-import-cycles',\n        excludePatterns: [],\n    },\n    workspace: {\n        enabled: true,\n        targetPrefix: 'arch:',\n        graphPath: 'architecture/dependencies.json',\n        validations: {\n            noCycles: true,\n            // Retired: the architecture graph is now auto-reduced in `generate`, so the\n            // committed graph can never contain a skip-level edge. Defaults off; the\n            // executor is a no-op kept for one release. See validate-no-skiplevel-deps.\n            noSkipLevelDeps: false,\n            architectureUnchanged: true,\n            validatePackageJson: true,\n            validateNewMethods: true,\n            validateModifiedMethods: true,\n            validateModifiedFiles: true,\n            validateVersionsLocked: true,\n            validateTsInSrc: true,\n            validateNxWiring: true,\n            newMethodsMaxLines: 30,\n            modifiedAndNewMethodsMaxLines: 80,\n            modifiedFilesMaxLines: 900,\n            validationMode: 'NORMAL',\n        },\n        features: {\n            generate: true,\n            visualize: true,\n        },\n    },\n};\n\nfunction normalizeOptions(\n    options: ArchitecturePluginOptions | undefined,\n): Required<ArchitecturePluginOptions> {\n    const circularDeps = {\n        ...DEFAULT_OPTIONS.circularDeps,\n        ...options?.circularDeps,\n    };\n\n    const workspace = {\n        ...DEFAULT_OPTIONS.workspace,\n        ...options?.workspace,\n        validations: {\n            ...DEFAULT_OPTIONS.workspace.validations,\n            ...options?.workspace?.validations,\n        },\n        features: {\n            ...DEFAULT_OPTIONS.workspace.features,\n            ...options?.workspace?.features,\n        },\n    };\n\n    return {\n        circularDeps,\n        workspace,\n    } as Required<ArchitecturePluginOptions>;\n}\n\nasync function createNodesFunction(\n    projectFiles: readonly string[],\n    options: ArchitecturePluginOptions | undefined,\n    context: CreateNodesContextV2,\n): Promise<CreateNodesResultV2> {\n    const opts = normalizeOptions(options);\n    const results: CreateNodesResultV2 = [];\n\n    // Add workspace-level architecture targets\n    addArchitectureProject(results, projectFiles, opts, context);\n\n    // Add per-project targets (circular-deps, ci)\n    addPerProjectTargets(results, projectFiles, opts, context);\n\n    return results;\n}\n\nfunction addArchitectureProject(\n    results: CreateNodesResultV2,\n    projectFiles: readonly string[],\n    opts: Required<ArchitecturePluginOptions>,\n    context: CreateNodesContextV2,\n): void {\n    if (!opts.workspace.enabled) return;\n\n    const archDirPath = join(context.workspaceRoot, 'architecture');\n    if (!existsSync(archDirPath)) return;\n\n    const workspaceTargets = createWorkspaceTargetsWithoutPrefix(opts);\n    if (Object.keys(workspaceTargets).length === 0) return;\n\n    const result: CreateNodesResult = {\n        projects: {\n            architecture: {\n                name: 'architecture',\n                root: 'architecture',\n                targets: workspaceTargets,\n            },\n        },\n    };\n\n    const firstProjectFile = projectFiles[0];\n    if (firstProjectFile) {\n        results.push([firstProjectFile, result] as const);\n    }\n}\n\nfunction addPerProjectTargets(\n    results: CreateNodesResultV2,\n    projectFiles: readonly string[],\n    opts: Required<ArchitecturePluginOptions>,\n    context: CreateNodesContextV2,\n): void {\n    // Track processed project roots to avoid duplicates when both files exist\n    const processedRoots = new Set<string>();\n\n    for (const projectFile of projectFiles) {\n        const isProjectJson = projectFile.endsWith('project.json');\n        const isPackageJson = projectFile.endsWith('package.json');\n\n        if (!isProjectJson && !isPackageJson) continue;\n\n        const projectRoot = dirname(projectFile);\n\n        // Skip root (workspace manifest, not a project)\n        if (projectRoot === '.') continue;\n\n        // Skip if we've already processed this project root\n        if (processedRoots.has(projectRoot)) continue;\n\n        // For package.json, skip if project.json also exists in same directory\n        // (prefer project.json - it will be processed separately)\n        if (isPackageJson) {\n            const projectJsonPath = join(context.workspaceRoot, projectRoot, 'project.json');\n            if (existsSync(projectJsonPath)) continue;\n        }\n\n        processedRoots.add(projectRoot);\n\n        const targets: Record<string, TargetConfiguration> = {};\n\n        // Add circular-deps target ONLY for project.json projects\n        // (package.json-only projects may not have TypeScript source)\n        if (isProjectJson && opts.circularDeps.enabled) {\n            if (!isExcluded(projectRoot, opts.circularDeps.excludePatterns!)) {\n                const targetName = opts.circularDeps.targetName!;\n                targets[targetName] = createCircularDepsTarget(projectRoot, targetName);\n            }\n        }\n\n        // Add ci target to ALL projects (both project.json and package.json)\n        targets['ci'] = createCiTarget();\n\n        if (Object.keys(targets).length === 0) continue;\n\n        const result: CreateNodesResult = {\n            projects: {\n                [projectRoot]: {\n                    targets,\n                },\n            },\n        };\n\n        results.push([projectFile, result] as const);\n    }\n}\n\n/**\n * Nx V2 Inference Plugin\n * Matches project.json and package.json files to create targets\n */\nexport const createNodesV2: CreateNodesV2<ArchitecturePluginOptions> = [\n    // Pattern to match project.json and package.json files\n    '**/{project,package}.json',\n\n    // Inference function\n    createNodesFunction,\n];\n\n/**\n * Build list of enabled validation target names for validate-complete dependency chain\n */\nfunction buildValidationTargetsList(\n    validations: Required<ArchitecturePluginOptions>['workspace']['validations'],\n): string[] {\n    const targets: string[] = [];\n    if (validations!.noCycles) targets.push('validate-no-architecture-cycles');\n    if (validations!.architectureUnchanged) targets.push('validate-architecture-unchanged');\n    if (validations!.noSkipLevelDeps) targets.push('validate-no-skiplevel-deps');\n    if (validations!.validatePackageJson) targets.push('validate-packagejson');\n    // Use combined validate-code instead of 3 separate targets\n    if (\n        validations!.validateNewMethods ||\n        validations!.validateModifiedMethods ||\n        validations!.validateModifiedFiles\n    ) {\n        targets.push('validate-code');\n    }\n    if (validations!.validateVersionsLocked) targets.push('validate-versions-locked');\n    if (validations!.validateTsInSrc) targets.push('validate-ts-in-src');\n    if (validations!.validateNxWiring) targets.push('validate-nx-wiring');\n    return targets;\n}\n\n/**\n * Create workspace-level architecture validation targets WITHOUT prefix\n * Used for virtual 'architecture' project\n */\nfunction createWorkspaceTargetsWithoutPrefix(\n    opts: Required<ArchitecturePluginOptions>,\n): Record<string, TargetConfiguration> {\n    const targets: Record<string, TargetConfiguration> = {};\n    const graphPath = opts.workspace.graphPath!;\n    const validations = opts.workspace.validations!;\n\n    // Add help target (always available)\n    targets['help'] = createHelpTarget();\n\n    if (opts.workspace.features!.generate) {\n        targets['generate'] = createGenerateTarget(graphPath);\n    }\n    if (opts.workspace.features!.visualize) {\n        targets['visualize'] = createVisualizeTargetWithoutPrefix(graphPath);\n    }\n    if (validations.noCycles) {\n        targets['validate-no-architecture-cycles'] = createValidateNoCyclesTarget();\n    }\n    if (validations.architectureUnchanged) {\n        targets['validate-architecture-unchanged'] = createValidateUnchangedTarget(graphPath);\n    }\n    if (validations.noSkipLevelDeps) {\n        targets['validate-no-skiplevel-deps'] = createValidateNoSkipLevelTarget();\n    }\n    if (validations.validatePackageJson) {\n        targets['validate-packagejson'] = createValidatePackageJsonTarget();\n    }\n    // Use combined validate-code instead of 3 separate targets\n    // Options come from webpieces.config.json at the workspace root\n    // (loaded via @webpieces/rules-config; same source of truth as @webpieces/ai-hook-rules)\n    if (\n        validations.validateNewMethods ||\n        validations.validateModifiedMethods ||\n        validations.validateModifiedFiles\n    ) {\n        targets['validate-code'] = createValidateCodeTarget();\n    }\n    if (validations.validateVersionsLocked) {\n        targets['validate-versions-locked'] = createValidateVersionsLockedTarget();\n    }\n    if (validations.validateTsInSrc) {\n        targets['validate-ts-in-src'] = createValidateTsInSrcTarget();\n    }\n    if (validations.validateNxWiring) {\n        targets['validate-nx-wiring'] = createValidateNxWiringTarget();\n    }\n\n    // Add validate-complete target that runs all enabled validations\n    const validationTargets = buildValidationTargetsList(validations);\n    if (validationTargets.length > 0) {\n        targets['validate-complete'] = createValidateCompleteTarget(validationTargets);\n    }\n\n    return targets;\n}\n\n/**\n * Create workspace-level architecture validation targets (DEPRECATED - keeping for backward compat)\n * Used when root project.json exists (old style with '.' project)\n */\nfunction createWorkspaceTargets(\n    opts: Required<ArchitecturePluginOptions>,\n): Record<string, TargetConfiguration> {\n    const targets: Record<string, TargetConfiguration> = {};\n    const prefix = opts.workspace.targetPrefix!;\n    const graphPath = opts.workspace.graphPath!;\n\n    // Add help target (always available)\n    targets[`${prefix}help`] = createHelpTarget();\n\n    if (opts.workspace.features!.generate) {\n        targets[`${prefix}generate`] = createGenerateTarget(graphPath);\n    }\n\n    if (opts.workspace.features!.visualize) {\n        targets[`${prefix}visualize`] = createVisualizeTarget(prefix, graphPath);\n    }\n\n    if (opts.workspace.validations!.noCycles) {\n        targets[`${prefix}validate-no-architecture-cycles`] = createValidateNoCyclesTarget();\n    }\n\n    if (opts.workspace.validations!.architectureUnchanged) {\n        targets[`${prefix}validate-architecture-unchanged`] =\n            createValidateUnchangedTarget(graphPath);\n    }\n\n    if (opts.workspace.validations!.noSkipLevelDeps) {\n        targets[`${prefix}validate-no-skiplevel-deps`] = createValidateNoSkipLevelTarget();\n    }\n\n    if (opts.workspace.validations!.validatePackageJson) {\n        targets[`${prefix}validate-packagejson`] = createValidatePackageJsonTarget();\n    }\n\n    // Use combined validate-code instead of 3 separate targets\n    // Options come from webpieces.config.json at the workspace root\n    // (loaded via @webpieces/rules-config; same source of truth as @webpieces/ai-hook-rules)\n    if (\n        opts.workspace.validations!.validateNewMethods ||\n        opts.workspace.validations!.validateModifiedMethods ||\n        opts.workspace.validations!.validateModifiedFiles\n    ) {\n        targets[`${prefix}validate-code`] = createValidateCodeTarget();\n    }\n\n    return targets;\n}\n\nfunction createGenerateTarget(graphPath: string): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:generate',\n        cache: false,\n        outputs: ['{workspaceRoot}/architecture/dependencies.json'],\n        options: { graphPath },\n        metadata: {\n            technologies: ['nx'],\n            description: 'Generate the architecture dependency graph from project.json files',\n        },\n    };\n}\n\nfunction createVisualizeTargetWithoutPrefix(graphPath: string): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:visualize',\n        dependsOn: ['generate'],\n        options: { graphPath },\n        metadata: {\n            technologies: ['nx'],\n            description: 'Generate visual representations of the architecture graph',\n        },\n    };\n}\n\nfunction createVisualizeTarget(prefix: string, graphPath: string): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:visualize',\n        dependsOn: [`${prefix}generate`],\n        options: { graphPath },\n        metadata: {\n            technologies: ['nx'],\n            description: 'Generate visual representations of the architecture graph',\n        },\n    };\n}\n\nfunction createValidateNoCyclesTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-no-architecture-cycles',\n        cache: true,\n        inputs: ['{workspaceRoot}/**/project.json', '{workspaceRoot}/architecture/dependencies.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate the architecture has no circular project dependencies',\n        },\n    };\n}\n\nfunction createValidateUnchangedTarget(graphPath: string): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-architecture-unchanged',\n        cache: false,\n        inputs: ['default', '{workspaceRoot}/architecture/dependencies.json'],\n        options: { graphPath },\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate the architecture matches the saved blessed graph',\n        },\n    };\n}\n\nfunction createValidateNoSkipLevelTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-no-skiplevel-deps',\n        cache: true,\n        inputs: ['{workspaceRoot}/**/project.json', '{workspaceRoot}/architecture/dependencies.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate no project has redundant transitive dependencies',\n        },\n    };\n}\n\nfunction createValidatePackageJsonTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-packagejson',\n        cache: true,\n        inputs: ['{workspaceRoot}/**/project.json', '{workspaceRoot}/**/package.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate package.json dependencies match project.json build dependencies',\n        },\n    };\n}\n\nfunction createValidateNewMethodsTarget(\n    maxLines: number,\n    mode: 'STRICT' | 'NORMAL' | 'OFF',\n): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-new-methods',\n        cache: false, // Don't cache - depends on git state\n        inputs: ['default'],\n        options: { max: maxLines, mode },\n        metadata: {\n            technologies: ['nx'],\n            description: `Validate new methods do not exceed ${maxLines} lines (only runs in affected mode)`,\n        },\n    };\n}\n\nfunction createValidateModifiedMethodsTarget(\n    maxLines: number,\n    mode: 'STRICT' | 'NORMAL' | 'OFF',\n): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-modified-methods',\n        cache: false, // Don't cache - depends on git state\n        inputs: ['default'],\n        options: { max: maxLines, mode },\n        metadata: {\n            technologies: ['nx'],\n            description: `Validate new and modified methods do not exceed ${maxLines} lines (encourages gradual cleanup)`,\n        },\n    };\n}\n\nfunction createValidateModifiedFilesTarget(\n    maxLines: number,\n    mode: 'STRICT' | 'NORMAL' | 'OFF',\n): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-modified-files',\n        cache: false, // Don't cache - depends on git state\n        inputs: ['default'],\n        options: { max: maxLines, mode },\n        metadata: {\n            technologies: ['nx'],\n            description: `Validate modified files do not exceed ${maxLines} lines (encourages keeping files small)`,\n        },\n    };\n}\n\n/**\n * Create combined validate-code target\n * Options come from webpieces.config.json at the workspace root\n * (loaded by the executor via @webpieces/rules-config — same source of truth as @webpieces/ai-hook-rules)\n */\nfunction createValidateCodeTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-code',\n        cache: false, // Don't cache - depends on git state\n        inputs: ['default', '{workspaceRoot}/webpieces.config.json'],\n        // No options here - they come from webpieces.config.json at runtime\n        metadata: {\n            technologies: ['nx'],\n            description: 'Combined validation for new methods, modified methods, and file sizes',\n        },\n    };\n}\n\nfunction createValidateVersionsLockedTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-versions-locked',\n        cache: true,\n        inputs: ['{workspaceRoot}/**/package.json'],\n        metadata: {\n            technologies: ['nx'],\n            description:\n                'Validate package.json versions are locked (no semver ranges) and consistent across projects',\n        },\n    };\n}\n\nfunction createValidateTsInSrcTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-ts-in-src',\n        cache: false,\n        inputs: ['default', '{workspaceRoot}/webpieces.config.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate all .ts files in projects are inside the src/ directory',\n        },\n    };\n}\n\nfunction createValidateNxWiringTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-nx-wiring',\n        cache: false, // Cheap; depends on nx.json + project graph, not worth caching\n        inputs: ['{workspaceRoot}/nx.json', '{workspaceRoot}/webpieces.config.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate the webpieces validators are wired into the build via nx.json dependsOn',\n        },\n    };\n}\n\nfunction createValidateCompleteTarget(validationTargets: string[]): TargetConfiguration {\n    return {\n        executor: 'nx:noop',\n        cache: true,\n        dependsOn: validationTargets,\n        metadata: {\n            technologies: ['nx'],\n            description: 'Run all architecture validations (cycles, unchanged, skip-level deps)',\n        },\n    };\n}\n\n/**\n * Create per-project ci target - Gradle-style composite target\n * Runs lint, build, and test in parallel\n * (with test depending on build via targetDefaults)\n *\n * NOTE: Type checking is done by the build target (@nx/js:tsc) during compilation.\n */\nfunction createCiTarget(): TargetConfiguration {\n    return {\n        executor: 'nx:noop',\n        cache: true,\n        dependsOn: ['lint', 'build', 'test'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Run all CI checks: lint, build, and test (Gradle-style composite target)',\n        },\n    };\n}\n\nfunction createHelpTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:help',\n        cache: false, // Never cache - always show help output\n        metadata: {\n            technologies: ['nx'],\n            description: 'Display help for @webpieces/nx-webpieces-rules commands and targets',\n        },\n    };\n}\n\n/**\n * Create per-project circular dependency checking target\n * Runs on project root (.) to check ALL TypeScript files in the project\n */\nfunction createCircularDepsTarget(projectRoot: string, targetName: string): TargetConfiguration {\n    return {\n        executor: 'nx:run-commands',\n        cache: true,\n        inputs: ['default'],\n        outputs: [] as string[],\n        options: {\n            command: 'npx madge --circular --extensions ts,tsx .',\n            cwd: projectRoot,\n        },\n        metadata: {\n            technologies: ['madge'],\n            description: 'Check for circular dependencies using madge',\n        },\n    };\n}\n\n/**\n * Check if a project should be excluded based on patterns\n */\nfunction isExcluded(projectRoot: string, excludePatterns: string[]): boolean {\n    if (excludePatterns.length === 0) {\n        return false;\n    }\n\n    // Simple glob matching (could be enhanced with minimatch if needed)\n    return excludePatterns.some((pattern) => {\n        // Convert glob pattern to regex\n        const regexPattern = pattern\n            .replace(/\\*\\*/g, '.*') // ** matches any path\n            .replace(/\\*/g, '[^/]*'); // * matches any string except /\n\n        const regex = new RegExp(`^${regexPattern}$`);\n        return regex.test(projectRoot);\n    });\n}\n\n/**\n * Export plugin as default for Nx\n */\nexport default { createNodesV2 };\n"]}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../../../packages/tooling/nx-webpieces-rules/src/plugin.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;AAEH,+BAAqC;AACrC,2BAAgC;AAuEhC,MAAM,eAAe,GAAwC;IACzD,YAAY,EAAE;QACV,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,gCAAgC;QAC5C,eAAe,EAAE,EAAE;KACtB;IACD,SAAS,EAAE;QACP,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,OAAO;QACrB,SAAS,EAAE,gCAAgC;QAC3C,WAAW,EAAE;YACT,QAAQ,EAAE,IAAI;YACd,4EAA4E;YAC5E,yEAAyE;YACzE,4EAA4E;YAC5E,eAAe,EAAE,KAAK;YACtB,qBAAqB,EAAE,IAAI;YAC3B,mBAAmB,EAAE,IAAI;YACzB,kBAAkB,EAAE,IAAI;YACxB,uBAAuB,EAAE,IAAI;YAC7B,qBAAqB,EAAE,IAAI;YAC3B,sBAAsB,EAAE,IAAI;YAC5B,eAAe,EAAE,IAAI;YACrB,gBAAgB,EAAE,IAAI;YACtB,kBAAkB,EAAE,EAAE;YACtB,6BAA6B,EAAE,EAAE;YACjC,qBAAqB,EAAE,GAAG;YAC1B,cAAc,EAAE,QAAQ;SAC3B;QACD,QAAQ,EAAE;YACN,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,IAAI;SAClB;KACJ;CACJ,CAAC;AAEF,SAAS,gBAAgB,CACrB,OAA8C;IAE9C,MAAM,YAAY,GAAG;QACjB,GAAG,eAAe,CAAC,YAAY;QAC/B,GAAG,OAAO,EAAE,YAAY;KAC3B,CAAC;IAEF,MAAM,SAAS,GAAG;QACd,GAAG,eAAe,CAAC,SAAS;QAC5B,GAAG,OAAO,EAAE,SAAS;QACrB,WAAW,EAAE;YACT,GAAG,eAAe,CAAC,SAAS,CAAC,WAAW;YACxC,GAAG,OAAO,EAAE,SAAS,EAAE,WAAW;SACrC;QACD,QAAQ,EAAE;YACN,GAAG,eAAe,CAAC,SAAS,CAAC,QAAQ;YACrC,GAAG,OAAO,EAAE,SAAS,EAAE,QAAQ;SAClC;KACJ,CAAC;IAEF,OAAO;QACH,YAAY;QACZ,SAAS;KAC2B,CAAC;AAC7C,CAAC;AAED,KAAK,UAAU,mBAAmB,CAC9B,YAA+B,EAC/B,OAA8C,EAC9C,OAA6B;IAE7B,MAAM,IAAI,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,2CAA2C;IAC3C,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAE7D,8CAA8C;IAC9C,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAE3D,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,SAAS,sBAAsB,CAC3B,OAA4B,EAC5B,YAA+B,EAC/B,IAAyC,EACzC,OAA6B;IAE7B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,OAAO;IAEpC,MAAM,WAAW,GAAG,IAAA,WAAI,EAAC,OAAO,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAChE,IAAI,CAAC,IAAA,eAAU,EAAC,WAAW,CAAC;QAAE,OAAO;IAErC,MAAM,gBAAgB,GAAG,mCAAmC,CAAC,IAAI,CAAC,CAAC;IACnE,IAAI,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAEvD,MAAM,MAAM,GAAsB;QAC9B,QAAQ,EAAE;YACN,YAAY,EAAE;gBACV,IAAI,EAAE,cAAc;gBACpB,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,gBAAgB;aAC5B;SACJ;KACJ,CAAC;IAEF,MAAM,gBAAgB,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IACzC,IAAI,gBAAgB,EAAE,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC,gBAAgB,EAAE,MAAM,CAAU,CAAC,CAAC;IACtD,CAAC;AACL,CAAC;AAED,SAAS,oBAAoB,CACzB,OAA4B,EAC5B,YAA+B,EAC/B,IAAyC,EACzC,OAA6B;IAE7B,0EAA0E;IAC1E,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IAEzC,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACrC,MAAM,aAAa,GAAG,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAC3D,MAAM,aAAa,GAAG,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAE3D,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa;YAAE,SAAS;QAE/C,MAAM,WAAW,GAAG,IAAA,cAAO,EAAC,WAAW,CAAC,CAAC;QAEzC,gDAAgD;QAChD,IAAI,WAAW,KAAK,GAAG;YAAE,SAAS;QAElC,oDAAoD;QACpD,IAAI,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC;YAAE,SAAS;QAE9C,uEAAuE;QACvE,0DAA0D;QAC1D,IAAI,aAAa,EAAE,CAAC;YAChB,MAAM,eAAe,GAAG,IAAA,WAAI,EAAC,OAAO,CAAC,aAAa,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;YACjF,IAAI,IAAA,eAAU,EAAC,eAAe,CAAC;gBAAE,SAAS;QAC9C,CAAC;QAED,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAEhC,MAAM,OAAO,GAAwC,EAAE,CAAC;QAExD,0DAA0D;QAC1D,8DAA8D;QAC9D,IAAI,aAAa,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC7C,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,eAAgB,CAAC,EAAE,CAAC;gBAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,UAAW,CAAC;gBACjD,OAAO,CAAC,UAAU,CAAC,GAAG,wBAAwB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;YAC5E,CAAC;QACL,CAAC;QAED,qEAAqE;QACrE,OAAO,CAAC,IAAI,CAAC,GAAG,cAAc,EAAE,CAAC;QAEjC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEhD,MAAM,MAAM,GAAsB;YAC9B,QAAQ,EAAE;gBACN,CAAC,WAAW,CAAC,EAAE;oBACX,OAAO;iBACV;aACJ;SACJ,CAAC;QAEF,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,MAAM,CAAU,CAAC,CAAC;IACjD,CAAC;AACL,CAAC;AAED;;;GAGG;AACU,QAAA,aAAa,GAA6C;IACnE,uDAAuD;IACvD,2BAA2B;IAE3B,qBAAqB;IACrB,mBAAmB;CACtB,CAAC;AAEF;;GAEG;AACH,SAAS,0BAA0B,CAC/B,WAA4E;IAE5E,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,WAAY,CAAC,QAAQ;QAAE,OAAO,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC3E,IAAI,WAAY,CAAC,qBAAqB;QAAE,OAAO,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACxF,IAAI,WAAY,CAAC,eAAe;QAAE,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC7E,IAAI,WAAY,CAAC,mBAAmB;QAAE,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC3E,2DAA2D;IAC3D,IACI,WAAY,CAAC,kBAAkB;QAC/B,WAAY,CAAC,uBAAuB;QACpC,WAAY,CAAC,qBAAqB,EACpC,CAAC;QACC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,WAAY,CAAC,sBAAsB;QAAE,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAClF,IAAI,WAAY,CAAC,eAAe;QAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACrE,IAAI,WAAY,CAAC,gBAAgB;QAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACtE,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,SAAS,mCAAmC,CACxC,IAAyC;IAEzC,MAAM,OAAO,GAAwC,EAAE,CAAC;IACxD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,SAAU,CAAC;IAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,WAAY,CAAC;IAEhD,qCAAqC;IACrC,OAAO,CAAC,MAAM,CAAC,GAAG,gBAAgB,EAAE,CAAC;IAErC,IAAI,IAAI,CAAC,SAAS,CAAC,QAAS,CAAC,QAAQ,EAAE,CAAC;QACpC,OAAO,CAAC,UAAU,CAAC,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,IAAI,CAAC,SAAS,CAAC,QAAS,CAAC,SAAS,EAAE,CAAC;QACrC,OAAO,CAAC,WAAW,CAAC,GAAG,kCAAkC,CAAC,SAAS,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;QACvB,OAAO,CAAC,iCAAiC,CAAC,GAAG,4BAA4B,EAAE,CAAC;IAChF,CAAC;IACD,IAAI,WAAW,CAAC,qBAAqB,EAAE,CAAC;QACpC,OAAO,CAAC,iCAAiC,CAAC,GAAG,6BAA6B,CAAC,SAAS,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC;QAC9B,OAAO,CAAC,4BAA4B,CAAC,GAAG,+BAA+B,EAAE,CAAC;IAC9E,CAAC;IACD,IAAI,WAAW,CAAC,mBAAmB,EAAE,CAAC;QAClC,OAAO,CAAC,sBAAsB,CAAC,GAAG,+BAA+B,EAAE,CAAC;IACxE,CAAC;IACD,2DAA2D;IAC3D,gEAAgE;IAChE,yFAAyF;IACzF,IACI,WAAW,CAAC,kBAAkB;QAC9B,WAAW,CAAC,uBAAuB;QACnC,WAAW,CAAC,qBAAqB,EACnC,CAAC;QACC,OAAO,CAAC,eAAe,CAAC,GAAG,wBAAwB,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,WAAW,CAAC,sBAAsB,EAAE,CAAC;QACrC,OAAO,CAAC,0BAA0B,CAAC,GAAG,kCAAkC,EAAE,CAAC;IAC/E,CAAC;IACD,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC;QAC9B,OAAO,CAAC,oBAAoB,CAAC,GAAG,2BAA2B,EAAE,CAAC;IAClE,CAAC;IACD,IAAI,WAAW,CAAC,gBAAgB,EAAE,CAAC;QAC/B,OAAO,CAAC,oBAAoB,CAAC,GAAG,4BAA4B,EAAE,CAAC;IACnE,CAAC;IAED,iEAAiE;IACjE,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,WAAW,CAAC,CAAC;IAClE,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,mBAAmB,CAAC,GAAG,4BAA4B,CAAC,iBAAiB,CAAC,CAAC;IACnF,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAC3B,IAAyC;IAEzC,MAAM,OAAO,GAAwC,EAAE,CAAC;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,YAAa,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,SAAU,CAAC;IAE5C,qCAAqC;IACrC,OAAO,CAAC,GAAG,MAAM,MAAM,CAAC,GAAG,gBAAgB,EAAE,CAAC;IAE9C,IAAI,IAAI,CAAC,SAAS,CAAC,QAAS,CAAC,QAAQ,EAAE,CAAC;QACpC,OAAO,CAAC,GAAG,MAAM,UAAU,CAAC,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,IAAI,CAAC,SAAS,CAAC,QAAS,CAAC,SAAS,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,MAAM,WAAW,CAAC,GAAG,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC7E,CAAC;IAED,IAAI,IAAI,CAAC,SAAS,CAAC,WAAY,CAAC,QAAQ,EAAE,CAAC;QACvC,OAAO,CAAC,GAAG,MAAM,iCAAiC,CAAC,GAAG,4BAA4B,EAAE,CAAC;IACzF,CAAC;IAED,IAAI,IAAI,CAAC,SAAS,CAAC,WAAY,CAAC,qBAAqB,EAAE,CAAC;QACpD,OAAO,CAAC,GAAG,MAAM,iCAAiC,CAAC;YAC/C,6BAA6B,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,IAAI,CAAC,SAAS,CAAC,WAAY,CAAC,eAAe,EAAE,CAAC;QAC9C,OAAO,CAAC,GAAG,MAAM,4BAA4B,CAAC,GAAG,+BAA+B,EAAE,CAAC;IACvF,CAAC;IAED,IAAI,IAAI,CAAC,SAAS,CAAC,WAAY,CAAC,mBAAmB,EAAE,CAAC;QAClD,OAAO,CAAC,GAAG,MAAM,sBAAsB,CAAC,GAAG,+BAA+B,EAAE,CAAC;IACjF,CAAC;IAED,2DAA2D;IAC3D,gEAAgE;IAChE,yFAAyF;IACzF,IACI,IAAI,CAAC,SAAS,CAAC,WAAY,CAAC,kBAAkB;QAC9C,IAAI,CAAC,SAAS,CAAC,WAAY,CAAC,uBAAuB;QACnD,IAAI,CAAC,SAAS,CAAC,WAAY,CAAC,qBAAqB,EACnD,CAAC;QACC,OAAO,CAAC,GAAG,MAAM,eAAe,CAAC,GAAG,wBAAwB,EAAE,CAAC;IACnE,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,SAAS,oBAAoB,CAAC,SAAiB;IAC3C,OAAO;QACH,QAAQ,EAAE,wCAAwC;QAClD,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,CAAC,gDAAgD,CAAC;QAC3D,OAAO,EAAE,EAAE,SAAS,EAAE;QACtB,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,oEAAoE;SACpF;KACJ,CAAC;AACN,CAAC;AAED,SAAS,kCAAkC,CAAC,SAAiB;IACzD,OAAO;QACH,QAAQ,EAAE,yCAAyC;QACnD,SAAS,EAAE,CAAC,UAAU,CAAC;QACvB,OAAO,EAAE,EAAE,SAAS,EAAE;QACtB,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,2DAA2D;SAC3E;KACJ,CAAC;AACN,CAAC;AAED,SAAS,qBAAqB,CAAC,MAAc,EAAE,SAAiB;IAC5D,OAAO;QACH,QAAQ,EAAE,yCAAyC;QACnD,SAAS,EAAE,CAAC,GAAG,MAAM,UAAU,CAAC;QAChC,OAAO,EAAE,EAAE,SAAS,EAAE;QACtB,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,2DAA2D;SAC3E;KACJ,CAAC;AACN,CAAC;AAED,SAAS,4BAA4B;IACjC,OAAO;QACH,QAAQ,EAAE,+DAA+D;QACzE,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,CAAC,iCAAiC,EAAE,gDAAgD,CAAC;QAC7F,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,gEAAgE;SAChF;KACJ,CAAC;AACN,CAAC;AAED,SAAS,6BAA6B,CAAC,SAAiB;IACpD,OAAO;QACH,QAAQ,EAAE,+DAA+D;QACzE,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,CAAC,SAAS,EAAE,gDAAgD,CAAC;QACrE,OAAO,EAAE,EAAE,SAAS,EAAE;QACtB,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,2DAA2D;SAC3E;KACJ,CAAC;AACN,CAAC;AAED,SAAS,+BAA+B;IACpC,OAAO;QACH,QAAQ,EAAE,0DAA0D;QACpE,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,CAAC,iCAAiC,EAAE,gDAAgD,CAAC;QAC7F,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,2DAA2D;SAC3E;KACJ,CAAC;AACN,CAAC;AAED,SAAS,+BAA+B;IACpC,OAAO;QACH,QAAQ,EAAE,oDAAoD;QAC9D,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,CAAC,iCAAiC,EAAE,iCAAiC,CAAC;QAC9E,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,0EAA0E;SAC1F;KACJ,CAAC;AACN,CAAC;AAED,SAAS,8BAA8B,CACnC,QAAgB,EAChB,IAAiC;IAEjC,OAAO;QACH,QAAQ,EAAE,oDAAoD;QAC9D,KAAK,EAAE,KAAK,EAAE,qCAAqC;QACnD,MAAM,EAAE,CAAC,SAAS,CAAC;QACnB,OAAO,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE;QAChC,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,sCAAsC,QAAQ,qCAAqC;SACnG;KACJ,CAAC;AACN,CAAC;AAED,SAAS,mCAAmC,CACxC,QAAgB,EAChB,IAAiC;IAEjC,OAAO;QACH,QAAQ,EAAE,yDAAyD;QACnE,KAAK,EAAE,KAAK,EAAE,qCAAqC;QACnD,MAAM,EAAE,CAAC,SAAS,CAAC;QACnB,OAAO,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE;QAChC,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,mDAAmD,QAAQ,qCAAqC;SAChH;KACJ,CAAC;AACN,CAAC;AAED,SAAS,iCAAiC,CACtC,QAAgB,EAChB,IAAiC;IAEjC,OAAO;QACH,QAAQ,EAAE,uDAAuD;QACjE,KAAK,EAAE,KAAK,EAAE,qCAAqC;QACnD,MAAM,EAAE,CAAC,SAAS,CAAC;QACnB,OAAO,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE;QAChC,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,yCAAyC,QAAQ,yCAAyC;SAC1G;KACJ,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAS,wBAAwB;IAC7B,OAAO;QACH,QAAQ,EAAE,6CAA6C;QACvD,KAAK,EAAE,KAAK,EAAE,qCAAqC;QACnD,MAAM,EAAE,CAAC,SAAS,EAAE,uCAAuC,CAAC;QAC5D,oEAAoE;QACpE,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,uEAAuE;SACvF;KACJ,CAAC;AACN,CAAC;AAED,SAAS,kCAAkC;IACvC,OAAO;QACH,QAAQ,EAAE,wDAAwD;QAClE,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,CAAC,iCAAiC,CAAC;QAC3C,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EACP,6FAA6F;SACpG;KACJ,CAAC;AACN,CAAC;AAED,SAAS,2BAA2B;IAChC,OAAO;QACH,QAAQ,EAAE,kDAAkD;QAC5D,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,CAAC,SAAS,EAAE,uCAAuC,CAAC;QAC5D,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,kEAAkE;SAClF;KACJ,CAAC;AACN,CAAC;AAED,SAAS,4BAA4B;IACjC,OAAO;QACH,QAAQ,EAAE,kDAAkD;QAC5D,KAAK,EAAE,KAAK,EAAE,+DAA+D;QAC7E,MAAM,EAAE,CAAC,yBAAyB,EAAE,uCAAuC,CAAC;QAC5E,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,kFAAkF;SAClG;KACJ,CAAC;AACN,CAAC;AAED,SAAS,4BAA4B,CAAC,iBAA2B;IAC7D,OAAO;QACH,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,iBAAiB;QAC5B,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,uEAAuE;SACvF;KACJ,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,SAAS,cAAc;IACnB,OAAO;QACH,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;QACpC,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,0EAA0E;SAC1F;KACJ,CAAC;AACN,CAAC;AAED,SAAS,gBAAgB;IACrB,OAAO;QACH,QAAQ,EAAE,oCAAoC;QAC9C,KAAK,EAAE,KAAK,EAAE,wCAAwC;QACtD,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,IAAI,CAAC;YACpB,WAAW,EAAE,qEAAqE;SACrF;KACJ,CAAC;AACN,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAS,wBAAwB,CAAC,YAAoB,EAAE,WAAmB;IACvE,OAAO;QACH,QAAQ,EAAE,8DAA8D;QACxE,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,CAAC,SAAS,EAAE,uCAAuC,CAAC;QAC5D,OAAO,EAAE,EAAc;QACvB,QAAQ,EAAE;YACN,YAAY,EAAE,CAAC,OAAO,CAAC;YACvB,WAAW,EAAE,yDAAyD;SACzE;KACJ,CAAC;AACN,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,WAAmB,EAAE,eAAyB;IAC9D,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,oEAAoE;IACpE,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QACpC,gCAAgC;QAChC,MAAM,YAAY,GAAG,OAAO;aACvB,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,sBAAsB;aAC7C,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,gCAAgC;QAE9D,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;GAEG;AACH,kBAAe,EAAE,aAAa,EAAb,qBAAa,EAAE,CAAC","sourcesContent":["/**\n * Unified Nx Inference Plugin for @webpieces/nx-webpieces-rules\n *\n * This plugin automatically creates targets for:\n * 1. Workspace-level architecture validation (generate, visualize, validate-*)\n * 2. Per-project circular dependency checking\n *\n * Install with: nx add @webpieces/nx-webpieces-rules\n *\n * Usage:\n * Add to nx.json plugins array:\n * {\n *   \"plugins\": [\"@webpieces/nx-webpieces-rules\"]\n * }\n *\n * Then all targets appear automatically without manual project.json configuration.\n */\n\nimport { dirname, join } from 'path';\nimport { existsSync } from 'fs';\nimport type {\n    CreateNodesV2,\n    CreateNodesContextV2,\n    CreateNodesResultV2,\n    CreateNodesResult,\n    TargetConfiguration,\n} from '@nx/devkit';\n\n/**\n * Circular dependency checking options\n */\nexport interface CircularDepsOptions {\n    enabled?: boolean;\n    targetName?: string;\n    excludePatterns?: string[];\n}\n\n/**\n * Validation options for architecture checks\n */\nexport interface ValidationOptions {\n    noCycles?: boolean;\n    noSkipLevelDeps?: boolean;\n    architectureUnchanged?: boolean;\n    validatePackageJson?: boolean;\n    validateNewMethods?: boolean;\n    validateModifiedMethods?: boolean;\n    validateModifiedFiles?: boolean;\n    validateVersionsLocked?: boolean;\n    validateTsInSrc?: boolean;\n    validateNxWiring?: boolean;\n    newMethodsMaxLines?: number;\n    modifiedAndNewMethodsMaxLines?: number;\n    modifiedFilesMaxLines?: number;\n    /**\n     * Validation mode for method/file size limits:\n     * - STRICT: All limits enforced, disable comments ignored\n     * - NORMAL: Limits enforced, disable comments with dates work\n     * - OFF: Skip size validations entirely (for fast iteration)\n     */\n    validationMode?: 'STRICT' | 'NORMAL' | 'OFF';\n}\n\n/**\n * Feature flags for workspace targets\n */\nexport interface FeatureOptions {\n    generate?: boolean;\n    visualize?: boolean;\n}\n\n/**\n * Workspace-level configuration options\n */\nexport interface WorkspaceOptions {\n    enabled?: boolean;\n    targetPrefix?: string;\n    graphPath?: string;\n    validations?: ValidationOptions;\n    features?: FeatureOptions;\n}\n\n/**\n * Configuration for @webpieces/nx-webpieces-rules Nx plugin\n */\nexport interface ArchitecturePluginOptions {\n    circularDeps?: CircularDepsOptions;\n    workspace?: WorkspaceOptions;\n}\n\nconst DEFAULT_OPTIONS: Required<ArchitecturePluginOptions> = {\n    circularDeps: {\n        enabled: true,\n        targetName: 'validate-no-file-import-cycles',\n        excludePatterns: [],\n    },\n    workspace: {\n        enabled: true,\n        targetPrefix: 'arch:',\n        graphPath: 'architecture/dependencies.json',\n        validations: {\n            noCycles: true,\n            // Retired: the architecture graph is now auto-reduced in `generate`, so the\n            // committed graph can never contain a skip-level edge. Defaults off; the\n            // executor is a no-op kept for one release. See validate-no-skiplevel-deps.\n            noSkipLevelDeps: false,\n            architectureUnchanged: true,\n            validatePackageJson: true,\n            validateNewMethods: true,\n            validateModifiedMethods: true,\n            validateModifiedFiles: true,\n            validateVersionsLocked: true,\n            validateTsInSrc: true,\n            validateNxWiring: true,\n            newMethodsMaxLines: 30,\n            modifiedAndNewMethodsMaxLines: 80,\n            modifiedFilesMaxLines: 900,\n            validationMode: 'NORMAL',\n        },\n        features: {\n            generate: true,\n            visualize: true,\n        },\n    },\n};\n\nfunction normalizeOptions(\n    options: ArchitecturePluginOptions | undefined,\n): Required<ArchitecturePluginOptions> {\n    const circularDeps = {\n        ...DEFAULT_OPTIONS.circularDeps,\n        ...options?.circularDeps,\n    };\n\n    const workspace = {\n        ...DEFAULT_OPTIONS.workspace,\n        ...options?.workspace,\n        validations: {\n            ...DEFAULT_OPTIONS.workspace.validations,\n            ...options?.workspace?.validations,\n        },\n        features: {\n            ...DEFAULT_OPTIONS.workspace.features,\n            ...options?.workspace?.features,\n        },\n    };\n\n    return {\n        circularDeps,\n        workspace,\n    } as Required<ArchitecturePluginOptions>;\n}\n\nasync function createNodesFunction(\n    projectFiles: readonly string[],\n    options: ArchitecturePluginOptions | undefined,\n    context: CreateNodesContextV2,\n): Promise<CreateNodesResultV2> {\n    const opts = normalizeOptions(options);\n    const results: CreateNodesResultV2 = [];\n\n    // Add workspace-level architecture targets\n    addArchitectureProject(results, projectFiles, opts, context);\n\n    // Add per-project targets (circular-deps, ci)\n    addPerProjectTargets(results, projectFiles, opts, context);\n\n    return results;\n}\n\nfunction addArchitectureProject(\n    results: CreateNodesResultV2,\n    projectFiles: readonly string[],\n    opts: Required<ArchitecturePluginOptions>,\n    context: CreateNodesContextV2,\n): void {\n    if (!opts.workspace.enabled) return;\n\n    const archDirPath = join(context.workspaceRoot, 'architecture');\n    if (!existsSync(archDirPath)) return;\n\n    const workspaceTargets = createWorkspaceTargetsWithoutPrefix(opts);\n    if (Object.keys(workspaceTargets).length === 0) return;\n\n    const result: CreateNodesResult = {\n        projects: {\n            architecture: {\n                name: 'architecture',\n                root: 'architecture',\n                targets: workspaceTargets,\n            },\n        },\n    };\n\n    const firstProjectFile = projectFiles[0];\n    if (firstProjectFile) {\n        results.push([firstProjectFile, result] as const);\n    }\n}\n\nfunction addPerProjectTargets(\n    results: CreateNodesResultV2,\n    projectFiles: readonly string[],\n    opts: Required<ArchitecturePluginOptions>,\n    context: CreateNodesContextV2,\n): void {\n    // Track processed project roots to avoid duplicates when both files exist\n    const processedRoots = new Set<string>();\n\n    for (const projectFile of projectFiles) {\n        const isProjectJson = projectFile.endsWith('project.json');\n        const isPackageJson = projectFile.endsWith('package.json');\n\n        if (!isProjectJson && !isPackageJson) continue;\n\n        const projectRoot = dirname(projectFile);\n\n        // Skip root (workspace manifest, not a project)\n        if (projectRoot === '.') continue;\n\n        // Skip if we've already processed this project root\n        if (processedRoots.has(projectRoot)) continue;\n\n        // For package.json, skip if project.json also exists in same directory\n        // (prefer project.json - it will be processed separately)\n        if (isPackageJson) {\n            const projectJsonPath = join(context.workspaceRoot, projectRoot, 'project.json');\n            if (existsSync(projectJsonPath)) continue;\n        }\n\n        processedRoots.add(projectRoot);\n\n        const targets: Record<string, TargetConfiguration> = {};\n\n        // Add circular-deps target ONLY for project.json projects\n        // (package.json-only projects may not have TypeScript source)\n        if (isProjectJson && opts.circularDeps.enabled) {\n            if (!isExcluded(projectRoot, opts.circularDeps.excludePatterns!)) {\n                const targetName = opts.circularDeps.targetName!;\n                targets[targetName] = createCircularDepsTarget(projectRoot, targetName);\n            }\n        }\n\n        // Add ci target to ALL projects (both project.json and package.json)\n        targets['ci'] = createCiTarget();\n\n        if (Object.keys(targets).length === 0) continue;\n\n        const result: CreateNodesResult = {\n            projects: {\n                [projectRoot]: {\n                    targets,\n                },\n            },\n        };\n\n        results.push([projectFile, result] as const);\n    }\n}\n\n/**\n * Nx V2 Inference Plugin\n * Matches project.json and package.json files to create targets\n */\nexport const createNodesV2: CreateNodesV2<ArchitecturePluginOptions> = [\n    // Pattern to match project.json and package.json files\n    '**/{project,package}.json',\n\n    // Inference function\n    createNodesFunction,\n];\n\n/**\n * Build list of enabled validation target names for validate-complete dependency chain\n */\nfunction buildValidationTargetsList(\n    validations: Required<ArchitecturePluginOptions>['workspace']['validations'],\n): string[] {\n    const targets: string[] = [];\n    if (validations!.noCycles) targets.push('validate-no-architecture-cycles');\n    if (validations!.architectureUnchanged) targets.push('validate-architecture-unchanged');\n    if (validations!.noSkipLevelDeps) targets.push('validate-no-skiplevel-deps');\n    if (validations!.validatePackageJson) targets.push('validate-packagejson');\n    // Use combined validate-code instead of 3 separate targets\n    if (\n        validations!.validateNewMethods ||\n        validations!.validateModifiedMethods ||\n        validations!.validateModifiedFiles\n    ) {\n        targets.push('validate-code');\n    }\n    if (validations!.validateVersionsLocked) targets.push('validate-versions-locked');\n    if (validations!.validateTsInSrc) targets.push('validate-ts-in-src');\n    if (validations!.validateNxWiring) targets.push('validate-nx-wiring');\n    return targets;\n}\n\n/**\n * Create workspace-level architecture validation targets WITHOUT prefix\n * Used for virtual 'architecture' project\n */\nfunction createWorkspaceTargetsWithoutPrefix(\n    opts: Required<ArchitecturePluginOptions>,\n): Record<string, TargetConfiguration> {\n    const targets: Record<string, TargetConfiguration> = {};\n    const graphPath = opts.workspace.graphPath!;\n    const validations = opts.workspace.validations!;\n\n    // Add help target (always available)\n    targets['help'] = createHelpTarget();\n\n    if (opts.workspace.features!.generate) {\n        targets['generate'] = createGenerateTarget(graphPath);\n    }\n    if (opts.workspace.features!.visualize) {\n        targets['visualize'] = createVisualizeTargetWithoutPrefix(graphPath);\n    }\n    if (validations.noCycles) {\n        targets['validate-no-architecture-cycles'] = createValidateNoCyclesTarget();\n    }\n    if (validations.architectureUnchanged) {\n        targets['validate-architecture-unchanged'] = createValidateUnchangedTarget(graphPath);\n    }\n    if (validations.noSkipLevelDeps) {\n        targets['validate-no-skiplevel-deps'] = createValidateNoSkipLevelTarget();\n    }\n    if (validations.validatePackageJson) {\n        targets['validate-packagejson'] = createValidatePackageJsonTarget();\n    }\n    // Use combined validate-code instead of 3 separate targets\n    // Options come from webpieces.config.json at the workspace root\n    // (loaded via @webpieces/rules-config; same source of truth as @webpieces/ai-hook-rules)\n    if (\n        validations.validateNewMethods ||\n        validations.validateModifiedMethods ||\n        validations.validateModifiedFiles\n    ) {\n        targets['validate-code'] = createValidateCodeTarget();\n    }\n    if (validations.validateVersionsLocked) {\n        targets['validate-versions-locked'] = createValidateVersionsLockedTarget();\n    }\n    if (validations.validateTsInSrc) {\n        targets['validate-ts-in-src'] = createValidateTsInSrcTarget();\n    }\n    if (validations.validateNxWiring) {\n        targets['validate-nx-wiring'] = createValidateNxWiringTarget();\n    }\n\n    // Add validate-complete target that runs all enabled validations\n    const validationTargets = buildValidationTargetsList(validations);\n    if (validationTargets.length > 0) {\n        targets['validate-complete'] = createValidateCompleteTarget(validationTargets);\n    }\n\n    return targets;\n}\n\n/**\n * Create workspace-level architecture validation targets (DEPRECATED - keeping for backward compat)\n * Used when root project.json exists (old style with '.' project)\n */\nfunction createWorkspaceTargets(\n    opts: Required<ArchitecturePluginOptions>,\n): Record<string, TargetConfiguration> {\n    const targets: Record<string, TargetConfiguration> = {};\n    const prefix = opts.workspace.targetPrefix!;\n    const graphPath = opts.workspace.graphPath!;\n\n    // Add help target (always available)\n    targets[`${prefix}help`] = createHelpTarget();\n\n    if (opts.workspace.features!.generate) {\n        targets[`${prefix}generate`] = createGenerateTarget(graphPath);\n    }\n\n    if (opts.workspace.features!.visualize) {\n        targets[`${prefix}visualize`] = createVisualizeTarget(prefix, graphPath);\n    }\n\n    if (opts.workspace.validations!.noCycles) {\n        targets[`${prefix}validate-no-architecture-cycles`] = createValidateNoCyclesTarget();\n    }\n\n    if (opts.workspace.validations!.architectureUnchanged) {\n        targets[`${prefix}validate-architecture-unchanged`] =\n            createValidateUnchangedTarget(graphPath);\n    }\n\n    if (opts.workspace.validations!.noSkipLevelDeps) {\n        targets[`${prefix}validate-no-skiplevel-deps`] = createValidateNoSkipLevelTarget();\n    }\n\n    if (opts.workspace.validations!.validatePackageJson) {\n        targets[`${prefix}validate-packagejson`] = createValidatePackageJsonTarget();\n    }\n\n    // Use combined validate-code instead of 3 separate targets\n    // Options come from webpieces.config.json at the workspace root\n    // (loaded via @webpieces/rules-config; same source of truth as @webpieces/ai-hook-rules)\n    if (\n        opts.workspace.validations!.validateNewMethods ||\n        opts.workspace.validations!.validateModifiedMethods ||\n        opts.workspace.validations!.validateModifiedFiles\n    ) {\n        targets[`${prefix}validate-code`] = createValidateCodeTarget();\n    }\n\n    return targets;\n}\n\nfunction createGenerateTarget(graphPath: string): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:generate',\n        cache: false,\n        outputs: ['{workspaceRoot}/architecture/dependencies.json'],\n        options: { graphPath },\n        metadata: {\n            technologies: ['nx'],\n            description: 'Generate the architecture dependency graph from project.json files',\n        },\n    };\n}\n\nfunction createVisualizeTargetWithoutPrefix(graphPath: string): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:visualize',\n        dependsOn: ['generate'],\n        options: { graphPath },\n        metadata: {\n            technologies: ['nx'],\n            description: 'Generate visual representations of the architecture graph',\n        },\n    };\n}\n\nfunction createVisualizeTarget(prefix: string, graphPath: string): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:visualize',\n        dependsOn: [`${prefix}generate`],\n        options: { graphPath },\n        metadata: {\n            technologies: ['nx'],\n            description: 'Generate visual representations of the architecture graph',\n        },\n    };\n}\n\nfunction createValidateNoCyclesTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-no-architecture-cycles',\n        cache: true,\n        inputs: ['{workspaceRoot}/**/project.json', '{workspaceRoot}/architecture/dependencies.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate the architecture has no circular project dependencies',\n        },\n    };\n}\n\nfunction createValidateUnchangedTarget(graphPath: string): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-architecture-unchanged',\n        cache: false,\n        inputs: ['default', '{workspaceRoot}/architecture/dependencies.json'],\n        options: { graphPath },\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate the architecture matches the saved blessed graph',\n        },\n    };\n}\n\nfunction createValidateNoSkipLevelTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-no-skiplevel-deps',\n        cache: true,\n        inputs: ['{workspaceRoot}/**/project.json', '{workspaceRoot}/architecture/dependencies.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate no project has redundant transitive dependencies',\n        },\n    };\n}\n\nfunction createValidatePackageJsonTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-packagejson',\n        cache: true,\n        inputs: ['{workspaceRoot}/**/project.json', '{workspaceRoot}/**/package.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate package.json dependencies match project.json build dependencies',\n        },\n    };\n}\n\nfunction createValidateNewMethodsTarget(\n    maxLines: number,\n    mode: 'STRICT' | 'NORMAL' | 'OFF',\n): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-new-methods',\n        cache: false, // Don't cache - depends on git state\n        inputs: ['default'],\n        options: { max: maxLines, mode },\n        metadata: {\n            technologies: ['nx'],\n            description: `Validate new methods do not exceed ${maxLines} lines (only runs in affected mode)`,\n        },\n    };\n}\n\nfunction createValidateModifiedMethodsTarget(\n    maxLines: number,\n    mode: 'STRICT' | 'NORMAL' | 'OFF',\n): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-modified-methods',\n        cache: false, // Don't cache - depends on git state\n        inputs: ['default'],\n        options: { max: maxLines, mode },\n        metadata: {\n            technologies: ['nx'],\n            description: `Validate new and modified methods do not exceed ${maxLines} lines (encourages gradual cleanup)`,\n        },\n    };\n}\n\nfunction createValidateModifiedFilesTarget(\n    maxLines: number,\n    mode: 'STRICT' | 'NORMAL' | 'OFF',\n): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-modified-files',\n        cache: false, // Don't cache - depends on git state\n        inputs: ['default'],\n        options: { max: maxLines, mode },\n        metadata: {\n            technologies: ['nx'],\n            description: `Validate modified files do not exceed ${maxLines} lines (encourages keeping files small)`,\n        },\n    };\n}\n\n/**\n * Create combined validate-code target\n * Options come from webpieces.config.json at the workspace root\n * (loaded by the executor via @webpieces/rules-config — same source of truth as @webpieces/ai-hook-rules)\n */\nfunction createValidateCodeTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-code',\n        cache: false, // Don't cache - depends on git state\n        inputs: ['default', '{workspaceRoot}/webpieces.config.json'],\n        // No options here - they come from webpieces.config.json at runtime\n        metadata: {\n            technologies: ['nx'],\n            description: 'Combined validation for new methods, modified methods, and file sizes',\n        },\n    };\n}\n\nfunction createValidateVersionsLockedTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-versions-locked',\n        cache: true,\n        inputs: ['{workspaceRoot}/**/package.json'],\n        metadata: {\n            technologies: ['nx'],\n            description:\n                'Validate package.json versions are locked (no semver ranges) and consistent across projects',\n        },\n    };\n}\n\nfunction createValidateTsInSrcTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-ts-in-src',\n        cache: false,\n        inputs: ['default', '{workspaceRoot}/webpieces.config.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate all .ts files in projects are inside the src/ directory',\n        },\n    };\n}\n\nfunction createValidateNxWiringTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-nx-wiring',\n        cache: false, // Cheap; depends on nx.json + project graph, not worth caching\n        inputs: ['{workspaceRoot}/nx.json', '{workspaceRoot}/webpieces.config.json'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Validate the webpieces validators are wired into the build via nx.json dependsOn',\n        },\n    };\n}\n\nfunction createValidateCompleteTarget(validationTargets: string[]): TargetConfiguration {\n    return {\n        executor: 'nx:noop',\n        cache: true,\n        dependsOn: validationTargets,\n        metadata: {\n            technologies: ['nx'],\n            description: 'Run all architecture validations (cycles, unchanged, skip-level deps)',\n        },\n    };\n}\n\n/**\n * Create per-project ci target - Gradle-style composite target\n * Runs lint, build, and test in parallel\n * (with test depending on build via targetDefaults)\n *\n * NOTE: Type checking is done by the build target (@nx/js:tsc) during compilation.\n */\nfunction createCiTarget(): TargetConfiguration {\n    return {\n        executor: 'nx:noop',\n        cache: true,\n        dependsOn: ['lint', 'build', 'test'],\n        metadata: {\n            technologies: ['nx'],\n            description: 'Run all CI checks: lint, build, and test (Gradle-style composite target)',\n        },\n    };\n}\n\nfunction createHelpTarget(): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:help',\n        cache: false, // Never cache - always show help output\n        metadata: {\n            technologies: ['nx'],\n            description: 'Display help for @webpieces/nx-webpieces-rules commands and targets',\n        },\n    };\n}\n\n/**\n * Create per-project circular dependency checking target.\n *\n * Uses the `validate-no-file-import-cycles` executor (which bundles madge as a\n * dependency) rather than a runtime `npx madge` fetch. The executor reads\n * webpieces.config.json so the gate can be turned on/off (`mode`) and\n * time-boxed (`ignoreModifiedUntilEpoch`) like every other webpieces rule.\n *\n * Note `projectRoot` is intentionally unused now — the executor derives the\n * project root from the Nx context — but the param is kept for call-site\n * symmetry with the rest of the per-project target factories.\n */\nfunction createCircularDepsTarget(_projectRoot: string, _targetName: string): TargetConfiguration {\n    return {\n        executor: '@webpieces/nx-webpieces-rules:validate-no-file-import-cycles',\n        cache: true,\n        inputs: ['default', '{workspaceRoot}/webpieces.config.json'],\n        outputs: [] as string[],\n        metadata: {\n            technologies: ['madge'],\n            description: 'Check for circular file-import dependencies using madge',\n        },\n    };\n}\n\n/**\n * Check if a project should be excluded based on patterns\n */\nfunction isExcluded(projectRoot: string, excludePatterns: string[]): boolean {\n    if (excludePatterns.length === 0) {\n        return false;\n    }\n\n    // Simple glob matching (could be enhanced with minimatch if needed)\n    return excludePatterns.some((pattern) => {\n        // Convert glob pattern to regex\n        const regexPattern = pattern\n            .replace(/\\*\\*/g, '.*') // ** matches any path\n            .replace(/\\*/g, '[^/]*'); // * matches any string except /\n\n        const regex = new RegExp(`^${regexPattern}$`);\n        return regex.test(projectRoot);\n    });\n}\n\n/**\n * Export plugin as default for Nx\n */\nexport default { createNodesV2 };\n"]}