@gitgov/core 1.0.0

package/dist/src/validation/cycle_validator.test.js

@@ -0,0 +1,182 @@
+import { isCycleRecord, validateCycleRecordDetailed, validateFullCycleRecord } from './cycle_validator';
+describe('CycleValidator Module', () => {
+    const validCyclePayload = {
+        id: '1754400000-cycle-sprint-q4-api-performance',
+        title: 'Sprint Q4 - API Performance',
+        status: 'active',
+        taskIds: ['1752274500-task-optimizar-endpoint-search', '1752360900-task-anadir-cache-a-redis'],
+        childCycleIds: ['1754500000-cycle-phase-1-optimization'],
+        tags: ['roadmap:q4', 'team:backend'],
+        notes: 'Objetivo: Reducir la latencia p95 de la API por debajo de 200ms.'
+    };
+    const invalidCyclePayloadWithoutId = {
+        title: 'Cycle without ID',
+        status: 'active',
+        taskIds: ['1752274500-task-test'],
+        tags: ['test']
+    };
+    describe('validateFullCycleRecord', () => {
+        const mockGetActorPublicKey = jest.fn().mockResolvedValue('mock-public-key');
+        const validRecord = {
+            header: {
+                version: '1.0',
+                type: 'cycle',
+                payloadChecksum: 'mock-checksum',
+                signatures: [{
+                        keyId: 'human:product-manager',
+                        role: 'author',
+                        signature: 'mock-signature',
+                        timestamp: 1754400000,
+                        timestamp_iso: '2025-08-12T12:00:00Z'
+                    }]
+            },
+            payload: validCyclePayload
+        };
+        beforeEach(() => {
+            mockGetActorPublicKey.mockClear();
+        });
+        it('[EARS-1] should throw SchemaValidationError for invalid payload', async () => {
+            const invalidRecord = {
+                ...validRecord,
+                payload: invalidCyclePayloadWithoutId
+            };
+            await expect(validateFullCycleRecord(invalidRecord, mockGetActorPublicKey))
+                .rejects.toThrow('CycleRecord payload failed schema validation');
+        });
+        it('[EARS-2] should throw error if embedded metadata validation fails', async () => {
+            // Mock embedded metadata validator to fail
+            jest.spyOn(require('./embedded_metadata_validator'), 'validateFullEmbeddedMetadataRecord')
+                .mockRejectedValue(new Error('Embedded metadata validation failed'));
+            const recordWithWrongChecksum = {
+                ...validRecord,
+                header: {
+                    ...validRecord.header,
+                    payloadChecksum: 'wrong-checksum'
+                }
+            };
+            await expect(validateFullCycleRecord(recordWithWrongChecksum, mockGetActorPublicKey))
+                .rejects.toThrow('Embedded metadata validation failed');
+        });
+        it('[EARS-3] should call validateFullEmbeddedMetadataRecord with correct parameters', async () => {
+            // Mock embedded metadata validator to succeed
+            const mockValidateEmbedded = jest.spyOn(require('./embedded_metadata_validator'), 'validateFullEmbeddedMetadataRecord')
+                .mockResolvedValue(undefined);
+            await validateFullCycleRecord(validRecord, mockGetActorPublicKey);
+            expect(mockValidateEmbedded).toHaveBeenCalledWith(validRecord, mockGetActorPublicKey);
+        });
+        it('[EARS-4] should complete without errors for a fully valid record', async () => {
+            // Calculate correct checksum and mock valid signature
+            const { calculatePayloadChecksum } = require('../crypto/checksum');
+            const actualChecksum = calculatePayloadChecksum(validRecord.payload);
+            const recordWithCorrectChecksum = {
+                ...validRecord,
+                header: {
+                    ...validRecord.header,
+                    payloadChecksum: actualChecksum
+                }
+            };
+            // Mock signature verification to return true
+            jest.spyOn(require('../crypto/signatures'), 'verifySignatures')
+                .mockResolvedValue(true);
+            await expect(validateFullCycleRecord(recordWithCorrectChecksum, mockGetActorPublicKey))
+                .resolves.not.toThrow();
+        });
+    });
+    describe('isCycleRecord', () => {
+        it('[EARS-5 & EARS-6] should correctly identify valid and invalid records', () => {
+            expect(isCycleRecord(validCyclePayload)).toBe(true);
+            expect(isCycleRecord(invalidCyclePayloadWithoutId)).toBe(false);
+        });
+        it('[EARS-7] should return false for non-object input', () => {
+            expect(isCycleRecord(null)).toBe(false);
+            expect(isCycleRecord(undefined)).toBe(false);
+            expect(isCycleRecord('string')).toBe(false);
+            expect(isCycleRecord(123)).toBe(false);
+        });
+        it('[EARS-8] should validate ID format (timestamp-cycle-slug)', () => {
+            const cycleWithInvalidId = {
+                ...validCyclePayload,
+                id: 'invalid-id-format'
+            };
+            expect(isCycleRecord(cycleWithInvalidId)).toBe(false);
+        });
+        it('[EARS-9] should validate status enum values', () => {
+            const cycleWithInvalidStatus = {
+                ...validCyclePayload,
+                status: 'invalid-status'
+            };
+            expect(isCycleRecord(cycleWithInvalidStatus)).toBe(false);
+        });
+        it('[EARS-10] should validate taskIds format when provided', () => {
+            const cycleWithInvalidTaskIds = {
+                ...validCyclePayload,
+                taskIds: ['invalid-task-id', '1752274500-task-valid']
+            };
+            expect(isCycleRecord(cycleWithInvalidTaskIds)).toBe(false);
+        });
+        it('[EARS-11] should validate childCycleIds format when provided', () => {
+            const cycleWithInvalidChildCycleIds = {
+                ...validCyclePayload,
+                childCycleIds: ['invalid-cycle-id', '1754500000-cycle-valid']
+            };
+            expect(isCycleRecord(cycleWithInvalidChildCycleIds)).toBe(false);
+        });
+    });
+    describe('validateCycleRecordDetailed', () => {
+        it('[EARS-12] should return success for valid CycleRecord', () => {
+            const result = validateCycleRecordDetailed(validCyclePayload);
+            expect(result.isValid).toBe(true);
+            expect(result.errors).toEqual([]);
+        });
+        it('[EARS-13] should return detailed errors for invalid CycleRecord', () => {
+            const result = validateCycleRecordDetailed(invalidCyclePayloadWithoutId);
+            expect(result.isValid).toBe(false);
+            expect(result.errors.length).toBeGreaterThan(0);
+            expect(result.errors[0]).toHaveProperty('field');
+            expect(result.errors[0]).toHaveProperty('message');
+            expect(result.errors[0]).toHaveProperty('value');
+        });
+        it('[EARS-14] should provide specific error details for each invalid field', () => {
+            const invalidCycle = {
+                id: 'invalid-format', // Wrong ID pattern
+                title: '', // Empty string
+                status: 'invalid-status', // Invalid status
+                taskIds: ['invalid-task-id'], // Invalid task ID format
+                childCycleIds: ['invalid-cycle-id'], // Invalid cycle ID format
+                tags: 'not-an-array' // Should be array
+            };
+            const result = validateCycleRecordDetailed(invalidCycle);
+            expect(result.isValid).toBe(false);
+            expect(result.errors.length).toBeGreaterThan(1); // Multiple errors
+        });
+        it('[EARS-15] should validate optional fields when provided', () => {
+            const cycleWithOptionalFields = {
+                ...validCyclePayload,
+                taskIds: ['1752274500-task-optimizar-endpoint-search'],
+                childCycleIds: ['1754500000-cycle-phase-1'],
+                tags: ['roadmap:q4', 'team:backend'],
+                notes: 'This cycle focuses on API performance improvements for Q4 objectives'
+            };
+            const result = validateCycleRecordDetailed(cycleWithOptionalFields);
+            expect(result.isValid).toBe(true);
+            expect(result.errors).toEqual([]);
+        });
+        it('[EARS-16] should return multiple errors for multiple invalid fields', () => {
+            const cycleWithMultipleInvalidFields = {
+                ...validCyclePayload,
+                id: 'invalid-id-format',
+                status: 'invalid-status',
+                taskIds: ['invalid-task-id', '1752274500-task-valid'],
+                childCycleIds: ['invalid-cycle-id', '1754500000-cycle-valid'],
+                tags: ['valid-tag', 'INVALID TAG WITH SPACES']
+            };
+            const result = validateCycleRecordDetailed(cycleWithMultipleInvalidFields);
+            expect(result.isValid).toBe(false);
+            expect(result.errors.length).toBeGreaterThan(1); // Multiple errors
+            expect(result.errors.some(err => err.field.includes('id'))).toBe(true);
+            expect(result.errors.some(err => err.field.includes('status'))).toBe(true);
+            expect(result.errors.some(err => err.field.includes('taskIds') || err.field.includes('childCycleIds') || err.field.includes('tags'))).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=cycle_validator.test.js.map

package/dist/src/validation/cycle_validator.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle_validator.test.js","sourceRoot":"","sources":["../../../src/validation/cycle_validator.test.ts"],"names":[],"mappings":"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"}

package/dist/src/validation/embedded_metadata_validator.d.ts

@@ -0,0 +1,26 @@
+import type { ValidateFunction } from "ajv";
+import type { EmbeddedMetadataRecord } from '../types/embedded.types';
+import type { GitGovRecordPayload } from '../types/common.types';
+import type { ValidationResult } from './errors';
+/**
+ * Schema-based validation for EmbeddedMetadata wrapper
+ */
+export declare function validateEmbeddedMetadataSchema(data: unknown): [boolean, ValidateFunction["errors"]];
+/**
+ * Type guard to check if data is a valid EmbeddedMetadataRecord
+ */
+export declare function isEmbeddedMetadataRecord<T extends GitGovRecordPayload>(data: unknown): data is EmbeddedMetadataRecord<T>;
+/**
+ * Detailed validation for EmbeddedMetadataRecord with formatted errors
+ */
+export declare function validateEmbeddedMetadataDetailed(data: unknown): ValidationResult;
+/**
+ * Full validation for EmbeddedMetadataRecord including schema, checksum, and signatures
+ */
+export declare function validateFullEmbeddedMetadataRecord<T extends GitGovRecordPayload>(record: EmbeddedMetadataRecord<T>, getActorPublicKey: (keyId: string) => Promise<string | null>): Promise<void>;
+/**
+ * Business rules validation for EmbeddedMetadata
+ * Validates conditional requirements based on header.type
+ */
+export declare function validateEmbeddedMetadataBusinessRules<T extends GitGovRecordPayload>(data: EmbeddedMetadataRecord<T>): ValidationResult;
+//# sourceMappingURL=embedded_metadata_validator.d.ts.map

package/dist/src/validation/embedded_metadata_validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded_metadata_validator.d.ts","sourceRoot":"","sources":["../../../src/validation/embedded_metadata_validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,KAAK,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAOjD;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,OAAO,GACZ,CAAC,OAAO,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAKvC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,mBAAmB,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,sBAAsB,CAAC,CAAC,CAAC,CAGxH;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAahF;AAED;;GAEG;AACH,wBAAsB,kCAAkC,CAAC,CAAC,SAAS,mBAAmB,EACpF,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,EACjC,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAC3D,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED;;;GAGG;AACH,wBAAgB,qCAAqC,CAAC,CAAC,SAAS,mBAAmB,EAAE,IAAI,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CA+DtI"}

package/dist/src/validation/embedded_metadata_validator.js

@@ -0,0 +1,122 @@
+import { SchemaValidationCache } from '../schemas/schema_cache';
+import { calculatePayloadChecksum } from '../crypto/checksum';
+import { verifySignatures } from '../crypto/signatures';
+import { DetailedValidationError, ChecksumMismatchError, SignatureVerificationError } from './common';
+import { Schemas } from '../schemas';
+/**
+ * Schema-based validation for EmbeddedMetadata wrapper
+ */
+export function validateEmbeddedMetadataSchema(data) {
+    const validator = SchemaValidationCache.getValidatorFromSchema(Schemas.EmbeddedMetadata);
+    const isValid = validator(data);
+    return [isValid, validator.errors];
+}
+/**
+ * Type guard to check if data is a valid EmbeddedMetadataRecord
+ */
+export function isEmbeddedMetadataRecord(data) {
+    const [isValid] = validateEmbeddedMetadataSchema(data);
+    return isValid;
+}
+/**
+ * Detailed validation for EmbeddedMetadataRecord with formatted errors
+ */
+export function validateEmbeddedMetadataDetailed(data) {
+    const [isValid, ajvErrors] = validateEmbeddedMetadataSchema(data);
+    const formattedErrors = ajvErrors?.map((error) => ({
+        field: error.instancePath || error.schemaPath,
+        message: error.message || 'Validation failed',
+        value: error.data
+    })) || [];
+    return {
+        isValid,
+        errors: formattedErrors
+    };
+}
+/**
+ * Full validation for EmbeddedMetadataRecord including schema, checksum, and signatures
+ */
+export async function validateFullEmbeddedMetadataRecord(record, getActorPublicKey) {
+    // 1. Schema Validation - validate the entire record structure
+    const [isValidSchema, errors] = validateEmbeddedMetadataSchema(record);
+    if (!isValidSchema) {
+        const formattedErrors = errors?.map(error => ({
+            field: error.instancePath || error.schemaPath,
+            message: error.message || 'Validation failed',
+            value: error.data
+        })) || [];
+        throw new DetailedValidationError('EmbeddedMetadata', formattedErrors);
+    }
+    // 2. Checksum Validation
+    const expectedChecksum = calculatePayloadChecksum(record.payload);
+    if (expectedChecksum !== record.header.payloadChecksum) {
+        throw new ChecksumMismatchError();
+    }
+    // 3. Signature Verification
+    const areSignaturesValid = await verifySignatures(record, getActorPublicKey);
+    if (!areSignaturesValid) {
+        throw new SignatureVerificationError();
+    }
+}
+/**
+ * Business rules validation for EmbeddedMetadata
+ * Validates conditional requirements based on header.type
+ */
+export function validateEmbeddedMetadataBusinessRules(data) {
+    const errors = [];
+    // Rule 1: If header.type is "custom", schemaUrl and schemaChecksum are required
+    if (data.header.type === 'custom') {
+        if (!data.header.schemaUrl) {
+            errors.push({
+                field: 'header.schemaUrl',
+                message: 'schemaUrl is required when header.type is "custom"',
+                value: data.header.schemaUrl
+            });
+        }
+        if (!data.header.schemaChecksum) {
+            errors.push({
+                field: 'header.schemaChecksum',
+                message: 'schemaChecksum is required when header.type is "custom"',
+                value: data.header.schemaChecksum
+            });
+        }
+    }
+    // Rule 2: Validate payloadChecksum format (SHA-256)
+    const sha256Pattern = /^[a-fA-F0-9]{64}$/;
+    if (!sha256Pattern.test(data.header.payloadChecksum)) {
+        errors.push({
+            field: 'header.payloadChecksum',
+            message: 'payloadChecksum must be a valid SHA-256 hash (64 hex characters)',
+            value: data.header.payloadChecksum
+        });
+    }
+    // Rule 3: Validate schemaChecksum format if present
+    if (data.header.schemaChecksum && !sha256Pattern.test(data.header.schemaChecksum)) {
+        errors.push({
+            field: 'header.schemaChecksum',
+            message: 'schemaChecksum must be a valid SHA-256 hash (64 hex characters)',
+            value: data.header.schemaChecksum
+        });
+    }
+    // Rule 4: Validate signatures array is not empty
+    if (!data.header.signatures || data.header.signatures.length === 0) {
+        errors.push({
+            field: 'header.signatures',
+            message: 'At least one signature is required',
+            value: data.header.signatures
+        });
+    }
+    // Rule 5: Validate audit field length if present
+    if (data.header.audit && (data.header.audit.length < 1 || data.header.audit.length > 3000)) {
+        errors.push({
+            field: 'header.audit',
+            message: 'audit field must be between 1 and 3000 characters',
+            value: data.header.audit
+        });
+    }
+    return {
+        isValid: errors.length === 0,
+        errors
+    };
+}
+//# sourceMappingURL=embedded_metadata_validator.js.map

package/dist/src/validation/embedded_metadata_validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded_metadata_validator.js","sourceRoot":"","sources":["../../../src/validation/embedded_metadata_validator.ts"],"names":[],"mappings":"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"}

package/dist/src/validation/embedded_metadata_validator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=embedded_metadata_validator.test.d.ts.map

package/dist/src/validation/embedded_metadata_validator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded_metadata_validator.test.d.ts","sourceRoot":"","sources":["../../../src/validation/embedded_metadata_validator.test.ts"],"names":[],"mappings":""}