@vee-stack/delta-cli 2.0.3 → 2.0.5

package/dist/packages/domain/src/constitution/soc/index.js

@@ -0,0 +1,43 @@
+/**
+ * Delta Constitution - Separation of Concerns Rules Index
+ * @description SoC rules for all supported languages
+ * @version 1.0.0
+ */
+// TypeScript / Node.js Rules
+export { default as ts, SocRules as TSSocRules } from './ts.rules';
+// Language-agnostic exports
+export const SocAxis = {
+    name: 'Separation of Concerns',
+    description: 'Clear layer boundaries, import rules, locality of behavior',
+    weight: 20,
+    languages: ['typescript', 'javascript', 'node'],
+    principles: [
+        {
+            id: 'SOC-001',
+            name: '7-Layer Architecture',
+            description: 'Entry → Features → Contracts → Modules → Core → Lib → Infrastructure',
+        },
+        {
+            id: 'SOC-002',
+            name: 'Import Direction',
+            description: 'Dependencies flow downwards only',
+        },
+        {
+            id: 'SOC-003',
+            name: 'Feature Structure',
+            description: 'Standard structure: components/, hooks/, services/',
+        },
+        {
+            id: 'SOC-004',
+            name: 'Core Principles',
+            description: 'Core: No UI deps, No side effects, Stateless',
+        },
+        {
+            id: 'SOC-005',
+            name: 'Locality of Behavior',
+            description: 'All related code in one place',
+        },
+    ],
+};
+export default SocAxis;
+//# sourceMappingURL=index.js.map

package/dist/packages/domain/src/constitution/soc/ts.rules.js

@@ -0,0 +1,360 @@
+/**
+ * Delta Constitution - Separation of Concerns (SoC) Rules
+ * @description Layer boundaries and architectural separation standards
+ * @version 1.0.0
+ * @see docs/architecture/CONSTITUTION.md
+ */
+// =============================================================================
+// SEPARATION OF CONCERNS RULE DEFINITIONS
+// =============================================================================
+export const SocRules = {
+    version: '1.0.0',
+    lastUpdated: '2026-02-10',
+    // ============================================================================
+    // 1. LAYER ARCHITECTURE
+    // ============================================================================
+    layers: {
+        enabled: true,
+        required: true,
+        description: '7-layer architecture with clear boundaries',
+        definitions: [
+            {
+                id: 'L1',
+                name: 'Entry Points',
+                path: 'src/cli/, src/app/',
+                responsibility: 'CLI tools, web pages, API routes',
+                canImportFrom: ['features', 'modules'],
+                cannotImportFrom: ['core', 'lib', 'infrastructure'],
+                examples: ['Next.js pages', 'CLI commands', 'API routes'],
+            },
+            {
+                id: 'L2',
+                name: 'Features',
+                path: 'src/features/',
+                responsibility: 'UI components, hooks, feature services',
+                canImportFrom: ['contracts', 'types'],
+                cannotImportFrom: ['core', 'modules', 'lib'],
+                examples: ['auth/', 'dashboard/', 'upload/', 'projects/'],
+            },
+            {
+                id: 'L3',
+                name: 'Contracts',
+                path: 'src/contracts/',
+                responsibility: 'Public API interfaces between layers',
+                canImportFrom: ['types'],
+                cannotImportFrom: ['features', 'modules', 'core', 'implementation'],
+                examples: ['auth.contract.ts', 'upload.contract.ts'],
+            },
+            {
+                id: 'L4',
+                name: 'Modules',
+                path: 'src/modules/',
+                responsibility: 'Business logic, policies, orchestration',
+                canImportFrom: ['core', 'lib', 'security'],
+                cannotImportFrom: ['features', 'contracts', 'entry points'],
+                examples: ['auth/', 'analysis/', 'upload/', 'projects/'],
+            },
+            {
+                id: 'L5',
+                name: 'Core',
+                path: 'src/core/',
+                responsibility: 'Pure domain logic, stateless functions',
+                canImportFrom: ['lib', 'types'],
+                cannotImportFrom: ['features', 'modules', 'contracts', 'entry points'],
+                examples: ['analysis/', 'comparison/', 'parser/', 'documentation/'],
+            },
+            {
+                id: 'L6',
+                name: 'Library',
+                path: 'src/lib/',
+                responsibility: 'Infrastructure adapters, utilities',
+                canImportFrom: ['types'],
+                cannotImportFrom: ['core', 'modules', 'features'],
+                examples: ['parser/', 'logger/', 'cache/', 'db/'],
+            },
+            {
+                id: 'L7',
+                name: 'Infrastructure',
+                path: 'src/infrastructure/',
+                responsibility: 'External services, database, cache',
+                canImportFrom: ['lib', 'config'],
+                cannotImportFrom: ['core', 'modules', 'features', 'business logic'],
+                examples: ['db/', 'cache/', 'storage/'],
+            },
+        ],
+        security: {
+            id: 'L-Security',
+            name: 'Security',
+            path: 'src/security/',
+            responsibility: 'Cross-cutting security concerns',
+            scope: 'all layers',
+            examples: ['audit/', 'policy-enforcement/', 'rate-limit/'],
+        },
+    },
+    // ============================================================================
+    // 2. IMPORT RULES
+    // ============================================================================
+    importRules: {
+        enabled: true,
+        required: true,
+        description: 'Strict import direction and boundaries',
+        direction: 'downwards only',
+        matrix: {
+            'Entry Points': {
+                canImport: ['features', 'modules'],
+                cannotImport: ['core', 'lib', 'infrastructure'],
+            },
+            Features: { canImport: ['contracts', 'types'], cannotImport: ['core', 'modules', 'lib'] },
+            Contracts: {
+                canImport: ['types'],
+                cannotImport: ['features', 'modules', 'core', 'implementation'],
+            },
+            Modules: {
+                canImport: ['core', 'lib', 'security'],
+                cannotImport: ['features', 'contracts', 'entry points'],
+            },
+            Core: { canImport: ['lib', 'types'], cannotImport: ['features', 'modules', 'contracts'] },
+            Lib: { canImport: ['types'], cannotImport: ['core', 'modules', 'features'] },
+            Infrastructure: {
+                canImport: ['lib', 'config'],
+                cannotImport: ['core', 'modules', 'features'],
+            },
+            Security: { canImport: ['lib', 'types'], scope: 'cross-cutting' },
+        },
+        violations: [
+            {
+                id: 'SOC-IMPORT-001',
+                pattern: 'import { X } from "@/core/X" in Features',
+                severity: 'error',
+                message: 'Features cannot import directly from Core',
+            },
+            {
+                id: 'SOC-IMPORT-002',
+                pattern: 'import { X } from "@/modules/X" in Core',
+                severity: 'error',
+                message: 'Core cannot import from Modules',
+            },
+            {
+                id: 'SOC-IMPORT-003',
+                pattern: 'import { X } from "@/features/X" in Core/Modules',
+                severity: 'error',
+                message: 'Core/Modules cannot import from Features (UI)',
+            },
+        ],
+    },
+    // ============================================================================
+    // 3. FEATURE MODULE STRUCTURE
+    // ============================================================================
+    featureStructure: {
+        enabled: true,
+        required: true,
+        description: 'Standard structure for each Feature',
+        requiredDirectories: {
+            components: {
+                description: 'React components for this feature',
+                required: true,
+                pattern: '*.tsx',
+            },
+            hooks: {
+                description: 'Custom React hooks',
+                required: true,
+                pattern: 'use*.ts',
+            },
+            services: {
+                description: 'API services and business logic calls',
+                required: true,
+                pattern: '*.service.ts',
+            },
+        },
+        requiredFiles: {
+            'index.ts': {
+                description: 'Public API exports',
+                required: true,
+                content: 'Export components, hooks, services for external use',
+            },
+        },
+        example: `
+src/features/upload/
+├── components/
+│   ├── FileUploader.tsx
+│   ├── UploadProgress.tsx
+│   └── FilePreview.tsx
+├── hooks/
+│   ├── useUpload.ts
+│   └── useFileValidation.ts
+├── services/
+│   └── upload.service.ts
+└── index.ts
+    `,
+    },
+    // ============================================================================
+    // 4. CORE PRINCIPLES
+    // ============================================================================
+    corePrinciples: {
+        enabled: true,
+        required: true,
+        description: 'Core layer must be pure and stateless',
+        rules: [
+            {
+                id: 'SOC-CORE-001',
+                name: 'No UI Dependencies',
+                description: 'Core cannot import React, Next.js, or any UI libraries',
+                severity: 'error',
+                check: 'import detection in src/core/',
+            },
+            {
+                id: 'SOC-CORE-002',
+                name: 'No Side Effects',
+                description: 'Core functions must be pure (no console, no network, no fs)',
+                severity: 'error',
+                check: 'AST analysis for side effects',
+            },
+            {
+                id: 'SOC-CORE-003',
+                name: 'Stateless Functions',
+                description: 'No global state, no singletons, no mutable state',
+                severity: 'error',
+                forbidden: ['let global', 'var global', 'class.*state', 'singleton'],
+            },
+        ],
+    },
+    // ============================================================================
+    // 5. MODULE BOUNDARIES
+    // ============================================================================
+    moduleBoundaries: {
+        enabled: true,
+        required: true,
+        description: 'Each module is a closed boundary',
+        publicApi: {
+            location: 'index.ts',
+            pattern: 'Export only intended public API',
+            internal: 'All other files are internal',
+        },
+        structure: {
+            required: ['index.ts'],
+            optional: ['policies/', 'types.ts', 'constants.ts'],
+        },
+        rules: [
+            {
+                id: 'SOC-MODULE-001',
+                name: 'Public API Only',
+                description: 'Only index.ts exports are public',
+                severity: 'warning',
+            },
+            {
+                id: 'SOC-MODULE-002',
+                name: 'Policy Separation',
+                description: 'Policies must be in policies/ subdirectory',
+                severity: 'error',
+            },
+        ],
+    },
+    // ============================================================================
+    // 6. LOCALITY OF BEHAVIOR
+    // ============================================================================
+    localityOfBehavior: {
+        enabled: true,
+        required: true,
+        description: 'Everything related to a feature in one place',
+        principle: 'Co-location of related code',
+        requirements: {
+            features: 'All UI, hooks, services in src/features/[name]/',
+            modules: 'All business logic in src/modules/[name]/',
+            core: 'All domain logic in src/core/[name]/',
+            tests: 'Tests co-located or in __tests__/ subdirectory',
+        },
+        benefits: [
+            'Easy to find related code',
+            'Clear ownership',
+            'Simpler refactoring',
+            'Better code reviews',
+        ],
+    },
+};
+export function validateLayerImport(analysis) {
+    const { source, importPath } = analysis;
+    // Define layer order (higher = can import from lower)
+    const layerOrder = {
+        entry: 7,
+        features: 6,
+        contracts: 5,
+        modules: 4,
+        core: 3,
+        lib: 2,
+        infrastructure: 1,
+    };
+    const sourceLayer = Object.keys(layerOrder).find(layer => source.includes(layer));
+    const targetLayer = Object.keys(layerOrder).find(layer => importPath.includes(`/${layer}/`));
+    if (!sourceLayer || !targetLayer) {
+        return { valid: true }; // Cannot determine, assume valid
+    }
+    const sourceLevel = layerOrder[sourceLayer];
+    const targetLevel = layerOrder[targetLayer];
+    // Can only import from lower layers
+    if (targetLevel >= sourceLevel) {
+        return {
+            valid: false,
+            violation: `SOC-IMPORT: ${sourceLayer} cannot import from ${targetLayer} (same or higher layer)`,
+        };
+    }
+    // Specific layer rules
+    if (sourceLayer === 'features' && targetLayer === 'core') {
+        return {
+            valid: false,
+            violation: 'SOC-IMPORT-001: Features cannot import directly from Core (must use Contracts)',
+        };
+    }
+    if (sourceLayer === 'core' && targetLayer === 'modules') {
+        return {
+            valid: false,
+            violation: 'SOC-IMPORT-002: Core cannot import from Modules',
+        };
+    }
+    return { valid: true };
+}
+export function validateFeatureStructure(_featurePath, existingFiles) {
+    const required = ['index.ts', 'components/', 'hooks/', 'services/'];
+    const missing = required.filter(req => !existingFiles.some(file => file.includes(req)));
+    const violations = [];
+    // Check for business logic in features (should be in services only)
+    const hasBusinessLogic = existingFiles.some(f => f.includes('logic') && !f.includes('services/'));
+    if (hasBusinessLogic) {
+        violations.push('SOC-FEATURE-001: Business logic found outside services/ directory');
+    }
+    return {
+        valid: missing.length === 0 && violations.length === 0,
+        missing,
+        violations,
+    };
+}
+export function calculateSocScore(checks) {
+    const maxScore = 100;
+    let score = 0;
+    // Layer boundaries (40 points)
+    if (checks.respectsLayerBoundaries)
+        score += 20;
+    if (checks.noCrossLayerImports)
+        score += 20;
+    // Feature structure (20 points)
+    if (checks.hasCorrectFeatureStructure)
+        score += 15;
+    if (checks.hasLocalityOfBehavior)
+        score += 5;
+    // Core principles (20 points)
+    if (checks.coreHasNoUIDependencies)
+        score += 10;
+    if (checks.coreIsStateless)
+        score += 10;
+    // Module boundaries (20 points)
+    if (checks.hasPublicApiOnly)
+        score += 10;
+    if (checks.hasProperSeparation)
+        score += 10;
+    return {
+        score,
+        maxScore,
+        percentage: Math.round((score / maxScore) * 100),
+    };
+}
+export default SocRules;
+//# sourceMappingURL=ts.rules.js.map

package/dist/packages/domain/src/contracts/analysis.contract.js

@@ -0,0 +1,18 @@
+/**
+ * Analysis Contract v1
+ * @description Public API contract for Analysis Engine
+ * @version 1.0.0
+ *
+ * This contract defines the stable interface between:
+ * - Core Engine (analysis execution)
+ * - Modules (business logic)
+ * - API Layer (external interface)
+ *
+ * ⚠️  Breaking changes require v2 contract
+ */
+// =============================================================================
+// VERSION
+// =============================================================================
+/** Current contract version */
+export const ANALYSIS_CONTRACT_VERSION = '1.0.0';
+//# sourceMappingURL=analysis.contract.js.map

package/dist/packages/domain/src/contracts/index.js

@@ -0,0 +1,7 @@
+/**
+ * Domain Contracts
+ * @module packages/domain/contracts
+ */
+export * from './analysis.contract.js';
+export * from './projects.contract.js';
+//# sourceMappingURL=index.js.map

package/dist/packages/domain/src/contracts/projects.contract.js

@@ -0,0 +1,18 @@
+/**
+ * Projects Contract v1
+ * @description Public API contract for Project Management
+ * @version 1.0.0
+ *
+ * This contract defines the stable interface between:
+ * - Projects Module (business logic)
+ * - API Layer (external interface)
+ * - Client Applications (UI/dashboard)
+ *
+ * ⚠️  Breaking changes require v2 contract
+ */
+// =============================================================================
+// VERSION
+// =============================================================================
+/** Current contract version */
+export const PROJECTS_CONTRACT_VERSION = '1.0.0';
+//# sourceMappingURL=projects.contract.js.map

package/dist/packages/domain/src/control/registry/rules.registry.js

@@ -0,0 +1,29 @@
+/**
+ * Rules Registry
+ * @module packages/domain/control/registry/rules.registry
+ */
+class RulesRegistry {
+    rules = new Map();
+    register(definition) {
+        this.rules.set(definition.id, { name: definition.name, rule: definition.execute });
+    }
+    get(name) {
+        const entry = this.rules.get(name);
+        return entry?.rule;
+    }
+    getAll() {
+        return Array.from(this.rules.values()).map(entry => entry.rule);
+    }
+    has(name) {
+        return this.rules.has(name);
+    }
+    execute(name, input, policy) {
+        const rule = this.get(name);
+        if (!rule) {
+            return [];
+        }
+        return rule(input, policy);
+    }
+}
+export const rulesRegistry = new RulesRegistry();
+//# sourceMappingURL=rules.registry.js.map

package/dist/packages/domain/src/control/schemas/policies.js

@@ -0,0 +1,6 @@
+/**
+ * Policies Schemas
+ * @module packages/domain/control/schemas/policies
+ */
+export {};
+//# sourceMappingURL=policies.js.map

package/dist/packages/domain/src/core/analysis/discovery.js

@@ -0,0 +1,163 @@
+/**
+ * File Discovery Module
+ * Scans projects and discovers source files with intelligent filtering
+ */
+import { globby } from 'globby';
+import { promises as fs } from 'fs';
+import path from 'path';
+// Default exclusion patterns
+const DEFAULT_EXCLUDES = [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/.git/**',
+    '**/.svn/**',
+    '**/.hg/**',
+    '**/coverage/**',
+    '**/.next/**',
+    '**/.nuxt/**',
+    '**/out/**',
+    '**/.cache/**',
+    '**/vendor/**',
+    '**/*.min.js',
+    '**/*.min.css',
+    '**/*.map',
+    '**/bundle.*',
+    '**/chunk-*',
+];
+// Source file patterns
+const SOURCE_PATTERNS = [
+    '**/*.js',
+    '**/*.jsx',
+    '**/*.ts',
+    '**/*.tsx',
+    '**/*.mjs',
+    '**/*.cjs',
+    '**/*.vue',
+    '**/*.svelte',
+];
+/**
+ * Discover source files in a project
+ */
+export async function discoverFiles(options) {
+    const { rootDir, include = SOURCE_PATTERNS, exclude = [], maxFileSize = 10 * 1024 * 1024, // 10MB
+    maxTotalSize = 100 * 1024 * 1024, // 100MB
+    maxFiles = 1000, } = options;
+    const normalizedRoot = path.resolve(rootDir);
+    // Combine exclusion patterns
+    const allExcludes = [...DEFAULT_EXCLUDES, ...exclude];
+    // Find all matching files
+    const globbyOptions = {
+        cwd: normalizedRoot,
+        absolute: true,
+        onlyFiles: true,
+        ignore: allExcludes,
+        dot: true,
+    };
+    const allPaths = await globby(include, globbyOptions);
+    const files = [];
+    let totalSize = 0;
+    let skippedCount = 0;
+    let excludedCount = 0;
+    // Filter and collect file info
+    for (const filePath of allPaths) {
+        // Check max files limit
+        if (files.length >= maxFiles) {
+            break;
+        }
+        try {
+            const stats = await fs.stat(filePath);
+            // Skip directories (shouldn't happen with onlyFiles: true)
+            if (!stats.isFile()) {
+                excludedCount++;
+                continue;
+            }
+            // Check file size
+            if (stats.size > maxFileSize) {
+                skippedCount++;
+                continue;
+            }
+            // Check total size limit
+            if (totalSize + stats.size > maxTotalSize) {
+                break;
+            }
+            const relativePath = path.relative(normalizedRoot, filePath);
+            const extension = path.extname(filePath).toLowerCase();
+            files.push({
+                path: filePath,
+                relativePath,
+                size: stats.size,
+                extension,
+                mtime: stats.mtime,
+            });
+            totalSize += stats.size;
+        }
+        catch (error) {
+            // Skip files we can't stat
+            excludedCount++;
+        }
+    }
+    return {
+        files,
+        totalFound: allPaths.length,
+        excludedCount,
+        skippedCount,
+        totalSize,
+    };
+}
+/**
+ * Check if a path is a valid project root
+ */
+export async function isValidProjectRoot(projectPath) {
+    try {
+        const stats = await fs.stat(projectPath);
+        if (!stats.isDirectory()) {
+            return false;
+        }
+        // Check for common project indicators
+        const indicators = ['package.json', 'tsconfig.json', 'jsconfig.json', '.git', 'src'];
+        for (const indicator of indicators) {
+            try {
+                await fs.access(path.join(projectPath, indicator));
+                return true;
+            }
+            catch {
+                // Continue checking
+            }
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get project info from discovered files
+ */
+export function analyzeProjectTypes(files) {
+    const extensions = files.map(f => f.extension);
+    const uniqueExtensions = new Set(extensions);
+    const hasJavaScript = uniqueExtensions.has('.js') ||
+        uniqueExtensions.has('.jsx') ||
+        uniqueExtensions.has('.mjs') ||
+        uniqueExtensions.has('.cjs');
+    const hasTypeScript = uniqueExtensions.has('.ts') ||
+        uniqueExtensions.has('.tsx') ||
+        uniqueExtensions.has('.mts') ||
+        uniqueExtensions.has('.cts');
+    const hasReact = uniqueExtensions.has('.jsx') || uniqueExtensions.has('.tsx');
+    const hasVue = uniqueExtensions.has('.vue');
+    const hasSvelte = uniqueExtensions.has('.svelte');
+    const isNodeProject = uniqueExtensions.has('.js') || uniqueExtensions.has('.ts') || hasVue || hasSvelte;
+    const isESM = uniqueExtensions.has('.mjs') || uniqueExtensions.has('.mts');
+    return {
+        hasJavaScript,
+        hasTypeScript,
+        hasReact,
+        hasVue,
+        hasSvelte,
+        isNodeProject,
+        isESM,
+    };
+}
+//# sourceMappingURL=discovery.js.map