@vee-stack/delta-cli 2.0.3 → 2.0.5

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

@@ -0,0 +1,268 @@
+/**
+ * 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

@@ -0,0 +1,139 @@
+/**
+ * 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

@@ -0,0 +1,43 @@
+/**
+ * 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