@webpieces/nx-webpieces-rules 0.0.1

package/src/executors/validate-code/schema.json

@@ -0,0 +1,287 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "title": "Validate Code Executor",
+    "description": "Combined validation for new methods, modified methods, and file sizes. Configure via targetDefaults in nx.json for runtime options (no cache issues).",
+    "type": "object",
+    "properties": {
+        "methodMaxLimit": {
+            "type": "object",
+            "description": "Configuration for method line limit validation",
+            "properties": {
+                "limit": {
+                    "type": "number",
+                    "description": "Maximum lines allowed for methods",
+                    "default": 80
+                },
+                "mode": {
+                    "type": "string",
+                    "description": "OFF: skip validation. NEW_METHODS: only new methods in diff. NEW_AND_MODIFIED_METHODS: new methods + methods with changes. MODIFIED_FILES: all methods in modified files.",
+                    "default": "NEW_AND_MODIFIED_METHODS"
+                },
+                "disableAllowed": {
+                    "type": "boolean",
+                    "description": "Whether disable comments work. When false, no escape hatch (like old STRICT mode).",
+                    "default": true
+                },
+                "ignoreModifiedUntilEpoch": {
+                    "type": "number",
+                    "description": "Epoch seconds. Until this time, skip modified-method validation (new methods still enforced). When expired, normal mode resumes. Omit when not needed."
+                }
+            }
+        },
+        "fileMaxLimit": {
+            "type": "object",
+            "description": "Configuration for file line limit validation",
+            "properties": {
+                "limit": {
+                    "type": "number",
+                    "description": "Maximum lines for modified files",
+                    "default": 900
+                },
+                "mode": {
+                    "type": "string",
+                    "description": "OFF: skip validation. MODIFIED_FILES: all code in modified files.",
+                    "default": "MODIFIED_FILES"
+                },
+                "disableAllowed": {
+                    "type": "boolean",
+                    "description": "Whether disable comments work. When false, no escape hatch (like old STRICT mode).",
+                    "default": true
+                },
+                "ignoreModifiedUntilEpoch": {
+                    "type": "number",
+                    "description": "Epoch seconds. Until this time, skip modified-file validation. When expired, normal mode resumes. Omit when not needed."
+                }
+            }
+        },
+        "requireReturnType": {
+            "type": "object",
+            "description": "Configuration for return type validation",
+            "properties": {
+                "mode": {
+                    "type": "string",
+                    "description": "OFF: skip return type validation. NEW_METHODS: only new methods in diff. NEW_AND_MODIFIED_METHODS: new methods + methods with changes. MODIFIED_FILES: all methods in modified files.",
+                    "default": "OFF"
+                },
+                "disableAllowed": {
+                    "type": "boolean",
+                    "description": "Whether disable comments work. When false, no escape hatch.",
+                    "default": true
+                },
+                "ignoreModifiedUntilEpoch": {
+                    "type": "number",
+                    "description": "Epoch seconds. Until this time, skip validation entirely. When expired, normal mode resumes. Omit when not needed."
+                }
+            }
+        },
+        "noInlineTypeLiterals": {
+            "type": "object",
+            "description": "Configuration for no-inline-types validation",
+            "properties": {
+                "mode": {
+                    "type": "string",
+                    "description": "OFF: skip validation. NEW_METHODS: only new methods. NEW_AND_MODIFIED_METHODS: new + modified methods. MODIFIED_FILES: all in modified files. Disallows inline type literals like { x: number } - use named types instead.",
+                    "default": "OFF"
+                },
+                "disableAllowed": {
+                    "type": "boolean",
+                    "description": "Whether disable comments work. When false, no escape hatch.",
+                    "default": true
+                },
+                "ignoreModifiedUntilEpoch": {
+                    "type": "number",
+                    "description": "Epoch seconds. Until this time, skip validation entirely. When expired, normal mode resumes. Omit when not needed."
+                }
+            }
+        },
+        "noAnyUnknown": {
+            "type": "object",
+            "description": "Configuration for no-any-unknown validation",
+            "properties": {
+                "mode": {
+                    "type": "string",
+                    "description": "OFF: skip validation. MODIFIED_CODE: only changed lines in diff. MODIFIED_FILES: all in modified files. Disallows `any` and `unknown` TypeScript keywords.",
+                    "default": "OFF"
+                },
+                "disableAllowed": {
+                    "type": "boolean",
+                    "description": "Whether disable comments work. When false, no escape hatch.",
+                    "default": true
+                },
+                "ignoreModifiedUntilEpoch": {
+                    "type": "number",
+                    "description": "Epoch seconds. Until this time, skip validation entirely. When expired, normal mode resumes. Omit when not needed."
+                }
+            }
+        },
+        "noImplicitAny": {
+            "type": "object",
+            "description": "Configuration for no-implicit-any validation (TS7006/7005/7018/etc via the TypeScript compiler).",
+            "properties": {
+                "mode": {
+                    "type": "string",
+                    "description": "OFF: skip validation. MODIFIED_CODE: only implicit-any on changed lines. MODIFIED_FILES: all implicit-any in modified files.",
+                    "default": "OFF"
+                },
+                "disableAllowed": {
+                    "type": "boolean",
+                    "description": "Whether // webpieces-disable no-implicit-any comments work. When false, no escape hatch.",
+                    "default": true
+                },
+                "ignoreModifiedUntilEpoch": {
+                    "type": "number",
+                    "description": "Epoch seconds. Until this time, skip validation entirely. When expired, normal mode resumes. Omit when not needed."
+                }
+            }
+        },
+        "validateDtos": {
+            "type": "object",
+            "description": "Validate DTO fields match Prisma Dbo model fields. Prevents AI from inventing field names.",
+            "properties": {
+                "mode": {
+                    "type": "string",
+                    "description": "OFF: skip validation. MODIFIED_CLASS: only validate Dto classes with changed lines. MODIFIED_FILES: validate all Dtos in modified files.",
+                    "default": "OFF"
+                },
+                "disableAllowed": {
+                    "type": "boolean",
+                    "description": "Whether @deprecated field exemption works. When false, all fields must match.",
+                    "default": true
+                },
+                "prismaSchemaPath": {
+                    "type": "string",
+                    "description": "Relative path from workspace root to schema.prisma"
+                },
+                "dtoSourcePaths": {
+                    "type": "array",
+                    "items": { "type": "string" },
+                    "description": "Array of directories (relative to workspace root) containing Dto files"
+                },
+                "ignoreModifiedUntilEpoch": {
+                    "type": "number",
+                    "description": "Epoch seconds. Until this time, skip DTO validation entirely. When expired, normal mode resumes. Omit when not needed."
+                }
+            }
+        },
+        "prismaConverter": {
+            "type": "object",
+            "description": "Validate Prisma converter methods follow scalable patterns: correct Dbo parameter, no async, no standalone functions, Dto creation only in converter directories.",
+            "properties": {
+                "mode": {
+                    "type": "string",
+                    "description": "OFF: skip validation. NEW_AND_MODIFIED_METHODS: validate new/modified methods in converters + changed lines in non-converters. MODIFIED_FILES: validate all methods in modified files.",
+                    "default": "OFF"
+                },
+                "disableAllowed": {
+                    "type": "boolean",
+                    "description": "Whether disable comments work. When false, no escape hatch.",
+                    "default": true
+                },
+                "schemaPath": {
+                    "type": "string",
+                    "description": "Relative path from workspace root to schema.prisma"
+                },
+                "convertersPaths": {
+                    "type": "array",
+                    "items": { "type": "string" },
+                    "description": "Array of directories (relative to workspace root) containing converter files"
+                },
+                "enforcePaths": {
+                    "type": "array",
+                    "items": { "type": "string" },
+                    "description": "Array of directory prefixes (relative to workspace root) to scope validation to. When set, only files under these paths are checked. When empty/omitted, all changed files are checked."
+                },
+                "ignoreModifiedUntilEpoch": {
+                    "type": "number",
+                    "description": "Epoch seconds. Until this time, skip prisma-converter validation entirely. When expired, normal mode resumes. Omit when not needed."
+                }
+            }
+        },
+        "noDestructure": {
+            "type": "object",
+            "description": "Validate no destructuring patterns are used. Destructuring hurts code traceability.",
+            "properties": {
+                "mode": {
+                    "type": "string",
+                    "description": "OFF: skip validation. MODIFIED_CODE: only changed lines in diff. MODIFIED_FILES: all in modified files. Disallows destructuring patterns.",
+                    "default": "OFF"
+                },
+                "disableAllowed": {
+                    "type": "boolean",
+                    "description": "Whether disable comments work. When false, no escape hatch.",
+                    "default": true
+                },
+                "ignoreModifiedUntilEpoch": {
+                    "type": "number",
+                    "description": "Epoch seconds. Until this time, skip validation entirely. When expired, normal mode resumes. Omit when not needed."
+                }
+            }
+        },
+        "catchErrorPattern": {
+            "type": "object",
+            "description": "Validate catch blocks follow standardized pattern: catch (err: unknown) { const error = toError(err); }",
+            "properties": {
+                "mode": {
+                    "type": "string",
+                    "description": "OFF: skip validation. MODIFIED_CODE: only catch blocks on changed lines. MODIFIED_FILES: all catch blocks in modified files.",
+                    "default": "OFF"
+                },
+                "disableAllowed": {
+                    "type": "boolean",
+                    "description": "Whether disable comments work. When false, no escape hatch.",
+                    "default": true
+                },
+                "ignoreModifiedUntilEpoch": {
+                    "type": "number",
+                    "description": "Epoch seconds. Until this time, skip validation entirely. When expired, normal mode resumes. Omit when not needed."
+                }
+            }
+        },
+        "noUnmanagedExceptions": {
+            "type": "object",
+            "description": "Validate try/catch blocks are not used outside chokepoints. Exceptions should bubble to filters/globalErrorHandlers.",
+            "properties": {
+                "mode": {
+                    "type": "string",
+                    "description": "OFF: skip validation. MODIFIED_CODE: only changed lines in diff. MODIFIED_FILES: all in modified files. Disallows try/catch blocks.",
+                    "default": "OFF"
+                },
+                "disableAllowed": {
+                    "type": "boolean",
+                    "description": "Whether disable comments work. When false, no escape hatch.",
+                    "default": true
+                },
+                "ignoreModifiedUntilEpoch": {
+                    "type": "number",
+                    "description": "Epoch seconds. Until this time, skip validation entirely. When expired, normal mode resumes. Omit when not needed."
+                }
+            }
+        },
+        "noDirectApiInResolver": {
+            "type": "object",
+            "description": "Validate resolvers use services (not APIs) and components subscribe to service observables (not route.snapshot.data).",
+            "properties": {
+                "mode": {
+                    "type": "string",
+                    "description": "OFF: skip validation. MODIFIED_CODE: only changed lines in diff. NEW_AND_MODIFIED_METHODS: violations in new/modified method/route scopes. MODIFIED_FILES: all in modified files.",
+                    "default": "OFF"
+                },
+                "disableAllowed": {
+                    "type": "boolean",
+                    "description": "Whether disable comments work. When false, no escape hatch.",
+                    "default": true
+                },
+                "ignoreModifiedUntilEpoch": {
+                    "type": "number",
+                    "description": "Epoch seconds. Until this time, skip validation entirely. When expired, normal mode resumes. Omit when not needed."
+                },
+                "enforcePaths": {
+                    "type": "array",
+                    "items": { "type": "string" },
+                    "description": "Array of directory prefixes (relative to workspace root) to scope validation to. When set, only files under these paths are checked. When empty/omitted, all changed files are checked."
+                }
+            }
+        }
+    },
+    "required": []
+}

package/src/executors/validate-dtos/executor.ts

@@ -0,0 +1,11 @@
+import type { ExecutorContext } from '@nx/devkit';
+import { ExecutorResult } from '../../executor-result';
+import { validateDtos } from '@webpieces/code-rules';
+
+export default async function runExecutor(
+    // webpieces-disable no-any-unknown -- options are passed through to code-rules validators
+    options: Record<string, unknown>,
+    context: ExecutorContext,
+): Promise<ExecutorResult> {
+    return validateDtos(options, context.root);
+}

package/src/executors/validate-dtos/schema.json

@@ -0,0 +1,33 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "title": "Validate DTOs Executor",
+    "description": "Validate DTO fields match Prisma Dbo model fields. Ensures AI agents don't invent field names.",
+    "type": "object",
+    "properties": {
+        "mode": {
+            "type": "string",
+            "enum": ["OFF", "MODIFIED_CLASS", "MODIFIED_FILES"],
+            "description": "OFF: skip validation. MODIFIED_CLASS: only validate Dto classes with changed lines. MODIFIED_FILES: validate all Dtos in modified files.",
+            "default": "OFF"
+        },
+        "prismaSchemaPath": {
+            "type": "string",
+            "description": "Relative path from workspace root to schema.prisma"
+        },
+        "dtoSourcePaths": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Array of directories (relative to workspace root) containing Dto files"
+        },
+        "disableAllowed": {
+            "type": "boolean",
+            "description": "Whether @deprecated field exemption works. When false, all fields must match.",
+            "default": true
+        },
+        "ignoreModifiedUntilEpoch": {
+            "type": "number",
+            "description": "Epoch seconds. Until this time, skip DTO validation entirely. When expired, normal mode resumes. Omit when not needed."
+        }
+    },
+    "required": []
+}

package/src/executors/validate-eslint-sync/executor.ts

@@ -0,0 +1,87 @@
+import type { ExecutorContext } from '@nx/devkit';
+import { readFileSync } from 'fs';
+import { join } from 'path';
+import { createHash } from 'crypto';
+
+export interface ValidateEslintSyncOptions {}
+
+export interface ExecutorResult {
+    success: boolean;
+}
+
+function calculateHash(content: string): string {
+    return createHash('sha256').update(content).digest('hex');
+}
+
+function normalizeContent(content: string): string {
+    // Normalize line endings and trim whitespace
+    return content.replace(/\r\n/g, '\n').trim();
+}
+
+export default async function validateEslintSyncExecutor(
+    options: ValidateEslintSyncOptions,
+    context: ExecutorContext
+): Promise<ExecutorResult> {
+    const workspaceRoot = context.root;
+
+    const templatePath = join(workspaceRoot, 'packages/tooling/nx-webpieces-rules/templates/eslint.webpieces.config.mjs');
+    const workspacePath = join(workspaceRoot, 'eslint.webpieces.config.mjs');
+
+    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
+    try {
+        const templateContent = readFileSync(templatePath, 'utf-8');
+        const workspaceContent = readFileSync(workspacePath, 'utf-8');
+
+        const templateRules = extractRulesSection(templateContent);
+        const workspaceRules = extractRulesSection(workspaceContent);
+
+        const templateHash = calculateHash(normalizeContent(templateRules));
+        const workspaceHash = calculateHash(normalizeContent(workspaceRules));
+
+        if (templateHash !== workspaceHash) {
+            printValidationError(templatePath, workspacePath);
+            return { success: false };
+        }
+
+        console.log('✅ ESLint configuration sync validated - rules match!');
+        return { success: true };
+
+    } catch (err: unknown) {
+        // Error occurred during validation - log and fail
+        // eslint-disable-next-line @webpieces/catch-error-pattern
+        console.error('❌ Error validating ESLint sync:', err);
+        return { success: false };
+    }
+}
+
+function printValidationError(templatePath: string, workspacePath: string): void {
+    console.error('');
+    console.error('❌ ESLint configuration sync validation FAILED');
+    console.error('');
+    console.error('The @webpieces ESLint rules must be identical in both files:');
+    console.error(`  1. ${templatePath}`);
+    console.error(`  2. ${workspacePath}`);
+    console.error('');
+    console.error('These files must have identical rules sections so that:');
+    console.error('  - External clients get the same rules we use internally');
+    console.error('  - We "eat our own dog food" - same rules for everyone');
+    console.error('');
+    console.error('To fix:');
+    console.error('  1. Modify the rules in ONE file (recommend: templates/eslint.webpieces.config.mjs)');
+    console.error('  2. Copy the rules section to the other file');
+    console.error('  3. Keep import statements different (template uses npm, workspace uses loadWorkspaceRules)');
+    console.error('');
+    console.error('Customization for webpieces workspace goes in: eslint.config.mjs');
+    console.error('');
+}
+
+function extractRulesSection(content: string): string {
+    // Extract everything between "export default [" and the final "];"
+    // This includes the rules configuration
+    const match = content.match(/export default \[([\s\S]*)\];/);
+    if (!match) {
+        throw new Error('Could not extract rules section - export default not found');
+    }
+
+    return match[1].trim();
+}

package/src/executors/validate-eslint-sync/schema.json

@@ -0,0 +1,7 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "title": "Validate ESLint Sync Executor",
+    "description": "Validates that workspace and template eslint.webpieces.config.mjs files have identical rules",
+    "type": "object",
+    "properties": {}
+}

package/src/executors/validate-modified-files/executor.ts

@@ -0,0 +1,11 @@
+import type { ExecutorContext } from '@nx/devkit';
+import { ExecutorResult } from '../../executor-result';
+import { validateModifiedFiles } from '@webpieces/code-rules';
+
+export default async function runExecutor(
+    // webpieces-disable no-any-unknown -- options are passed through to code-rules validators
+    options: Record<string, unknown>,
+    context: ExecutorContext,
+): Promise<ExecutorResult> {
+    return validateModifiedFiles(options, context.root);
+}

package/src/executors/validate-modified-files/schema.json

@@ -0,0 +1,25 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "title": "Validate Modified Files Executor",
+    "description": "Validates that modified files don't exceed a maximum line count. Encourages keeping files small and focused.",
+    "type": "object",
+    "properties": {
+        "limit": {
+            "type": "number",
+            "description": "Maximum number of lines allowed for modified files",
+            "default": 900
+        },
+        "mode": {
+            "type": "string",
+            "enum": ["OFF", "MODIFIED_FILES"],
+            "description": "OFF: skip validation. MODIFIED_FILES: validate all code in modified files.",
+            "default": "MODIFIED_FILES"
+        },
+        "disableAllowed": {
+            "type": "boolean",
+            "description": "Whether disable comments work. When false, no escape hatch (like old STRICT mode).",
+            "default": true
+        }
+    },
+    "required": []
+}

package/src/executors/validate-modified-methods/executor.ts

@@ -0,0 +1,11 @@
+import type { ExecutorContext } from '@nx/devkit';
+import { ExecutorResult } from '../../executor-result';
+import { validateModifiedMethods } from '@webpieces/code-rules';
+
+export default async function runExecutor(
+    // webpieces-disable no-any-unknown -- options are passed through to code-rules validators
+    options: Record<string, unknown>,
+    context: ExecutorContext,
+): Promise<ExecutorResult> {
+    return validateModifiedMethods(options, context.root);
+}

package/src/executors/validate-modified-methods/schema.json

@@ -0,0 +1,25 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "title": "Validate Modified Methods Executor",
+    "description": "Validates that modified methods don't exceed a maximum line count. Encourages gradual cleanup of legacy long methods.",
+    "type": "object",
+    "properties": {
+        "limit": {
+            "type": "number",
+            "description": "Maximum lines allowed for modified methods",
+            "default": 80
+        },
+        "mode": {
+            "type": "string",
+            "enum": ["OFF", "NEW_METHODS", "NEW_AND_MODIFIED_METHODS", "MODIFIED_FILES"],
+            "description": "OFF: skip validation. NEW_AND_MODIFIED_METHODS: new methods + methods with changes. MODIFIED_FILES: all methods in modified files.",
+            "default": "NEW_AND_MODIFIED_METHODS"
+        },
+        "disableAllowed": {
+            "type": "boolean",
+            "description": "Whether disable comments work. When false, no escape hatch (like old STRICT mode).",
+            "default": true
+        }
+    },
+    "required": []
+}

package/src/executors/validate-new-methods/executor.ts

@@ -0,0 +1,11 @@
+import type { ExecutorContext } from '@nx/devkit';
+import { ExecutorResult } from '../../executor-result';
+import { validateNewMethods } from '@webpieces/code-rules';
+
+export default async function runExecutor(
+    // webpieces-disable no-any-unknown -- options are passed through to code-rules validators
+    options: Record<string, unknown>,
+    context: ExecutorContext,
+): Promise<ExecutorResult> {
+    return validateNewMethods(options, context.root);
+}

package/src/executors/validate-new-methods/schema.json

@@ -0,0 +1,25 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "title": "Validate New Methods Executor",
+    "description": "Validates that newly added methods don't exceed a maximum line count. Only runs in affected mode (when NX_BASE is set).",
+    "type": "object",
+    "properties": {
+        "limit": {
+            "type": "number",
+            "description": "Maximum lines allowed for new methods",
+            "default": 80
+        },
+        "mode": {
+            "type": "string",
+            "enum": ["OFF", "NEW_METHODS", "NEW_AND_MODIFIED_METHODS", "MODIFIED_FILES"],
+            "description": "OFF: skip validation. NEW_METHODS: only new methods in diff. NEW_AND_MODIFIED_METHODS: new methods + methods with changes. MODIFIED_FILES: all methods in modified files.",
+            "default": "NEW_AND_MODIFIED_METHODS"
+        },
+        "disableAllowed": {
+            "type": "boolean",
+            "description": "Whether disable comments work. When false, no escape hatch.",
+            "default": true
+        }
+    },
+    "required": []
+}

package/src/executors/validate-no-any-unknown/executor.ts

@@ -0,0 +1,11 @@
+import type { ExecutorContext } from '@nx/devkit';
+import { ExecutorResult } from '../../executor-result';
+import { validateNoAnyUnknown } from '@webpieces/code-rules';
+
+export default async function runExecutor(
+    // webpieces-disable no-any-unknown -- options are passed through to code-rules validators
+    options: Record<string, unknown>,
+    context: ExecutorContext,
+): Promise<ExecutorResult> {
+    return validateNoAnyUnknown(options, context.root);
+}

package/src/executors/validate-no-any-unknown/schema.json

@@ -0,0 +1,24 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "title": "Validate No Any Unknown Executor",
+    "description": "Validates that `any` and `unknown` TypeScript keywords are not used. Uses LINE-BASED detection for git diff filtering.",
+    "type": "object",
+    "properties": {
+        "mode": {
+            "type": "string",
+            "enum": ["OFF", "MODIFIED_CODE", "MODIFIED_FILES"],
+            "description": "OFF: skip validation. MODIFIED_CODE: only changed lines in diff. MODIFIED_FILES: all in modified files. Disallows `any` and `unknown` TypeScript keywords.",
+            "default": "OFF"
+        },
+        "disableAllowed": {
+            "type": "boolean",
+            "description": "Whether disable comments work. When false, no escape hatch.",
+            "default": true
+        },
+        "ignoreModifiedUntilEpoch": {
+            "type": "number",
+            "description": "Epoch seconds. Until this time, skip validation entirely. When expired, normal mode resumes. Omit when not needed."
+        }
+    },
+    "required": []
+}

package/src/executors/validate-no-architecture-cycles/executor.ts

@@ -0,0 +1,63 @@
+/**
+ * Validate No Architecture Cycles Executor
+ *
+ * Validates that the architecture dependency graph has no circular dependencies.
+ * This is a fast check that only validates acyclicity at the project level.
+ *
+ * Usage:
+ * nx run architecture:validate-no-architecture-cycles
+ */
+
+import type { ExecutorContext } from '@nx/devkit';
+import { generateGraph } from '../../lib/graph-generator';
+import { sortGraphTopologically } from '../../lib/graph-sorter';
+import { toError } from '../../toError';
+
+export interface ValidateNoCyclesOptions {
+    // No options needed
+}
+
+export interface ExecutorResult {
+    success: boolean;
+}
+
+export default async function runExecutor(
+    _options: ValidateNoCyclesOptions,
+    _context: ExecutorContext
+): Promise<ExecutorResult> {
+    console.log('\n🔄 Validating No Circular Dependencies\n');
+
+    // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
+    try {
+        // Step 1: Generate current graph from project.json files
+        console.log('📊 Generating dependency graph from project.json files...');
+        const rawGraph = await generateGraph();
+
+        // Step 2: Topological sort (validates acyclic)
+        console.log('🔄 Checking for cycles (topological sort)...');
+        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions
+        try {
+            sortGraphTopologically(rawGraph);
+            console.log('✅ No circular dependencies detected!');
+
+            // Print summary
+            const projectCount = Object.keys(rawGraph).length;
+            console.log(`\n📈 Summary: ${projectCount} projects, all acyclic`);
+
+            return { success: true };
+        } catch (err: unknown) {
+            const error = toError(err);
+            console.error('❌ Circular dependency detected!');
+            console.error(error.message);
+            console.error('\nTo fix:');
+            console.error('  1. Review the cycle above');
+            console.error('  2. Break the cycle by refactoring dependencies');
+            console.error('  3. Run this check again');
+            return { success: false };
+        }
+    } catch (err: unknown) {
+        const error = toError(err);
+        console.error('❌ Cycle validation failed:', error.message);
+        return { success: false };
+    }
+}

package/src/executors/validate-no-architecture-cycles/schema.json

@@ -0,0 +1,8 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "title": "Validate No Cycles Executor",
+    "description": "Validates that the architecture graph has no circular dependencies",
+    "type": "object",
+    "properties": {},
+    "required": []
+}