@vee-stack/delta-cli 2.0.8 → 2.0.10

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

@@ -1,268 +0,0 @@
-/**
- * Delta Constitution - Contracts Rules
- * @description Contract standards and API interface definitions
- * @version 1.0.0
- * @see docs/architecture/CONSTITUTION.md
- */
-// =============================================================================
-// CONTRACTS RULE DEFINITIONS
-// =============================================================================
-export const ContractsRules = {
-    version: '1.0.0',
-    lastUpdated: '2026-02-10',
-    // ============================================================================
-    // 1. CONTRACT REQUIREMENTS
-    // ============================================================================
-    requirements: {
-        enabled: true,
-        required: true,
-        description: 'Every Module must have a corresponding Contract',
-        requiredContracts: [
-            {
-                name: 'AuthContract',
-                file: 'src/contracts/auth.contract.ts',
-                module: 'src/modules/auth/',
-                features: ['src/features/auth/'],
-            },
-            {
-                name: 'UploadContract',
-                file: 'src/contracts/upload.contract.ts',
-                module: 'src/modules/upload/',
-                features: ['src/features/upload/'],
-            },
-            {
-                name: 'ProjectsContract',
-                file: 'src/contracts/projects.contract.ts',
-                module: 'src/modules/projects/',
-                features: ['src/features/projects/'],
-            },
-            {
-                name: 'AnalysisContract',
-                file: 'src/contracts/analysis.contract.ts',
-                module: 'src/modules/analysis/',
-                features: ['src/features/dashboard/'],
-            },
-        ],
-        rules: [
-            {
-                id: 'CONTRACT-001',
-                name: 'One Contract Per Module',
-                description: 'Every module must export a corresponding contract',
-                severity: 'error',
-            },
-            {
-                id: 'CONTRACT-002',
-                name: 'Features Use Contracts Only',
-                description: 'Features can only import from Contracts, not Modules directly',
-                severity: 'error',
-            },
-        ],
-    },
-    // ============================================================================
-    // 2. CONTRACT STRUCTURE
-    // ============================================================================
-    structure: {
-        enabled: true,
-        required: true,
-        description: 'Standard contract file structure',
-        requiredSections: {
-            header: {
-                description: 'JSDoc header with version and stability',
-                template: `
-/**
- * [Name] Contract v[version]
- * @description [Description]
- * @version [major].[minor].[patch]
- * @stability [stable|experimental|deprecated]
- */`,
-            },
-            inputContracts: {
-                description: 'Input interfaces and types',
-                naming: '[Action]Input',
-                example: 'InitUploadInput, UploadChunkInput',
-            },
-            outputContracts: {
-                description: 'Output interfaces and types',
-                naming: '[Action]Output or [Entity]',
-                example: 'UploadSession, UploadResult',
-            },
-            errorContracts: {
-                description: 'Error types and codes',
-                required: true,
-            },
-        },
-        example: `
-/**
- * Upload Contract v1.0.0
- * @description Public API for File Upload operations
- * @version 1.0.0
- * @stability stable
- */
-
-// Input Contracts
-export interface InitUploadInput {
-  filename: string;
-  fileSize: number;
-  // ...
-}
-
-// Output Contracts
-export interface UploadSession {
-  id: string;
-  status: 'initializing' | 'uploading' | 'completed';
-  // ...
-}
-
-// Error Contracts
-export interface UploadError {
-  code: string;
-  message: string;
-  statusCode: number;
-}
-    `,
-    },
-    // ============================================================================
-    // 3. VERSIONING
-    // ============================================================================
-    versioning: {
-        enabled: true,
-        required: true,
-        description: 'Semantic versioning for contracts',
-        scheme: 'semver',
-        rules: {
-            major: {
-                bump: 'Breaking changes',
-                examples: [
-                    'Removing or renaming interfaces',
-                    'Changing required fields',
-                    'Changing behavior significantly',
-                ],
-            },
-            minor: {
-                bump: 'New features, backwards compatible',
-                examples: ['Adding optional fields', 'Adding new interfaces', 'Extending functionality'],
-            },
-            patch: {
-                bump: 'Bug fixes, documentation',
-                examples: ['Fixing types', 'Documentation updates', 'Non-breaking corrections'],
-            },
-        },
-        stability: {
-            stable: 'Production ready, no breaking changes expected',
-            experimental: 'May change, not recommended for production',
-            deprecated: 'Will be removed in next major version',
-        },
-    },
-    // ============================================================================
-    // 4. INTERFACE DESIGN
-    // ============================================================================
-    interfaceDesign: {
-        enabled: true,
-        required: true,
-        description: 'Best practices for contract interfaces',
-        naming: {
-            inputs: '[Action]Input',
-            outputs: '[Action]Output or descriptive noun',
-            errors: '[Domain]Error',
-            enums: 'PascalCase',
-        },
-        requiredFields: {
-            id: 'Unique identifier for tracking',
-            timestamp: 'ISO 8601 timestamp',
-            userId: 'Actor who performed the action',
-        },
-        optionalFields: {
-            metadata: 'Additional context (key-value)',
-            tags: 'Labels for categorization',
-        },
-        documentation: {
-            required: true,
-            format: 'JSDoc',
-            content: 'Purpose, type, examples for each field',
-        },
-    },
-    // ============================================================================
-    // 5. VALIDATION
-    // ============================================================================
-    validation: {
-        enabled: true,
-        required: true,
-        description: 'Contract input validation requirements',
-        schemas: {
-            required: true,
-            tool: 'Zod',
-            location: 'Contracts must include Zod schemas',
-        },
-        runtime: {
-            description: 'Validate at runtime using Zod',
-            pattern: 'parse() or safeParse()',
-        },
-        compileTime: {
-            description: 'TypeScript types from Zod schemas',
-            pattern: 'z.infer<typeof Schema>',
-        },
-    },
-    // ============================================================================
-    // 6. BREAKING CHANGES
-    // ============================================================================
-    breakingChanges: {
-        enabled: true,
-        required: true,
-        description: 'Handling breaking changes in contracts',
-        policy: {
-            deprecation: 'Mark old contract as deprecated for 1 major version',
-            migration: 'Provide migration guide',
-            coexistence: 'Support both versions during transition period',
-        },
-        process: [
-            '1. Mark current contract as @deprecated',
-            '2. Create new contract with v[major+1]',
-            '3. Update all consumers gradually',
-            '4. Remove deprecated contract in next major release',
-        ],
-    },
-};
-export function validateContract(check) {
-    const violations = [];
-    let score = 100;
-    if (!check.hasVersion) {
-        violations.push('CONTRACT-STRUCT-001: Missing version in contract header');
-        score -= 15;
-    }
-    if (!check.hasStability) {
-        violations.push('CONTRACT-STRUCT-002: Missing stability annotation');
-        score -= 10;
-    }
-    if (!check.hasInputContracts) {
-        violations.push('CONTRACT-STRUCT-003: Missing input contracts');
-        score -= 20;
-    }
-    if (!check.hasOutputContracts) {
-        violations.push('CONTRACT-STRUCT-004: Missing output contracts');
-        score -= 20;
-    }
-    if (!check.hasErrorContracts) {
-        violations.push('CONTRACT-STRUCT-005: Missing error contracts');
-        score -= 15;
-    }
-    if (!check.hasZodSchemas) {
-        violations.push('CONTRACT-VALID-001: Missing Zod validation schemas');
-        score -= 20;
-    }
-    return {
-        valid: violations.length === 0,
-        violations,
-        score: Math.max(0, score),
-    };
-}
-export function checkContractCoverage(existingContracts, requiredContracts) {
-    const missing = requiredContracts.filter(required => !existingContracts.some(existing => existing.includes(required)));
-    const percentage = Math.round(((requiredContracts.length - missing.length) / requiredContracts.length) * 100);
-    return {
-        complete: missing.length === 0,
-        missing,
-        percentage,
-    };
-}
-export default ContractsRules;
-//# sourceMappingURL=ts.rules.js.map

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

@@ -1,139 +0,0 @@
-/**
- * Delta Constitution
- * @description The 7 Axes of Delta Architecture - Multi-language support
- * @version 1.0.0
- * @see docs/architecture/CONSTITUTION.md
- *
- * This module exports all constitutional rules for analyzing projects
- * against the Delta Architecture standards.
- */
-// =============================================================================
-// 7 AXES EXPORTS
-// =============================================================================
-export * as Security from './security';
-export * as Performance from './performance';
-export * as Soc from './soc';
-export * as Contracts from './contracts';
-export * as Maintainability from './maintainability';
-export * as Observability from './observability';
-// =============================================================================
-// 7 AXES METADATA
-// =============================================================================
-export const SevenAxes = [
-    {
-        name: 'Security',
-        weight: 25,
-        description: 'Policy-driven, Fail-Closed, Audit, Rate Limiting',
-        critical: true,
-    },
-    {
-        name: 'Performance',
-        weight: 20,
-        description: 'Lazy Loading, Caching, Code Splitting',
-        critical: false,
-    },
-    {
-        name: 'Separation of Concerns',
-        weight: 20,
-        description: 'Layer boundaries, import rules, locality',
-        critical: true,
-    },
-    {
-        name: 'Contracts',
-        weight: 15,
-        description: 'Type-safe, versioned interfaces',
-        critical: true,
-    },
-    {
-        name: 'Maintainability',
-        weight: 10,
-        description: 'Tests, Docs, Pure Functions',
-        critical: false,
-    },
-    {
-        name: 'Observability',
-        weight: 5,
-        description: 'Health Checks, Logging, Metrics',
-        critical: false,
-    },
-    {
-        name: 'Best Practices',
-        weight: 5,
-        description: 'Clean Architecture, Stateless Core',
-        critical: false,
-    },
-];
-// =============================================================================
-// SUPPORTED LANGUAGES
-// =============================================================================
-export const SupportedLanguages = [
-    {
-        code: 'ts',
-        name: 'TypeScript',
-        extension: '.ts',
-        runtime: 'Node.js',
-        status: 'stable',
-    },
-    {
-        code: 'js',
-        name: 'JavaScript',
-        extension: '.js',
-        runtime: 'Node.js',
-        status: 'stable',
-    },
-    // Future support:
-    // { code: 'py', name: 'Python', extension: '.py', runtime: 'CPython', status: 'planned' },
-    // { code: 'java', name: 'Java', extension: '.java', runtime: 'JVM', status: 'planned' },
-    // { code: 'cs', name: 'C#', extension: '.cs', runtime: '.NET', status: 'planned' },
-    // { code: 'go', name: 'Go', extension: '.go', runtime: 'Go', status: 'planned' },
-];
-// =============================================================================
-// CONSTITUTION VERSION
-// =============================================================================
-export const ConstitutionVersion = {
-    major: 1,
-    minor: 0,
-    patch: 0,
-    full: '1.0.0',
-    date: '2026-02-10',
-    status: 'stable',
-};
-export function calculateOverallScore(axisScores) {
-    const totalWeight = SevenAxes.reduce((sum, axis) => sum + axis.weight, 0);
-    let weightedScore = 0;
-    SevenAxes.forEach(axis => {
-        const score = axisScores[axis.name] || 0;
-        weightedScore += (score * axis.weight) / 100;
-    });
-    const percentage = Math.round((weightedScore / totalWeight) * 100);
-    const grade = percentage >= 90
-        ? 'A'
-        : percentage >= 80
-            ? 'B'
-            : percentage >= 70
-                ? 'C'
-                : percentage >= 60
-                    ? 'D'
-                    : 'F';
-    return { total: weightedScore, percentage, grade };
-}
-export function getRulesForLanguage(_language) {
-    // Language-specific rules can be loaded from axis subdirectories
-    // e.g., Security.ts, Performance.ts, etc.
-    return null;
-}
-export function isLanguageSupported(language) {
-    return SupportedLanguages.some(lang => lang.code === language.toLowerCase() || lang.name.toLowerCase() === language.toLowerCase());
-}
-// =============================================================================
-// DEFAULT EXPORT
-// =============================================================================
-export default {
-    version: ConstitutionVersion,
-    axes: SevenAxes,
-    languages: SupportedLanguages,
-    calculateOverallScore,
-    getRulesForLanguage,
-    isLanguageSupported,
-};
-//# sourceMappingURL=index.js.map

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

@@ -1,43 +0,0 @@
-/**
- * Delta Constitution - Maintainability Rules Index
- * @description Maintainability rules for all supported languages
- * @version 1.0.0
- */
-// TypeScript / Node.js Rules
-export { default as ts, MaintainabilityRules as TSMaintainabilityRules } from './ts.rules';
-// Language-agnostic exports
-export const MaintainabilityAxis = {
-    name: 'Maintainability',
-    description: 'Locality of Behavior, Tests, Docs, Pure Functions',
-    weight: 10,
-    languages: ['typescript', 'javascript', 'node'],
-    principles: [
-        {
-            id: 'MAINT-001',
-            name: 'Locality of Behavior',
-            description: 'All related code in one place',
-        },
-        {
-            id: 'MAINT-002',
-            name: 'Testing',
-            description: 'Unit ≥80%, Integration ≥60%, E2E ≥30% coverage',
-        },
-        {
-            id: 'MAINT-003',
-            name: 'Documentation',
-            description: 'JSDoc, READMEs, Blueprints for every layer',
-        },
-        {
-            id: 'MAINT-004',
-            name: 'Pure Functions',
-            description: 'Core uses pure functions only',
-        },
-        {
-            id: 'MAINT-005',
-            name: 'Code Quality',
-            description: 'Linting, formatting, complexity limits',
-        },
-    ],
-};
-export default MaintainabilityAxis;
-//# sourceMappingURL=index.js.map