@gitgov/core 1.0.0

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

@@ -0,0 +1,167 @@
+import { validateFullExecutionRecord, isExecutionRecord, validateExecutionRecordDetailed } from './execution_validator';
+import { DetailedValidationError } from './common';
+// Mock dependencies
+jest.mock('../schemas/schema_cache');
+jest.mock('./embedded_metadata_validator');
+jest.mock('../config_manager');
+describe('ExecutionRecord Validator', () => {
+    const mockSchemaValidationCache = require('../schemas/schema_cache').SchemaValidationCache;
+    const mockValidateEmbeddedMetadata = require('./embedded_metadata_validator').validateFullEmbeddedMetadataRecord;
+    const mockConfigManager = require('../config_manager').ConfigManager;
+    const createMockSignature = () => ({
+        keyId: 'human:test',
+        role: 'author',
+        signature: 'mock-signature',
+        timestamp: 1752275500,
+        timestamp_iso: '2025-07-25T15:11:40Z'
+    });
+    const validRecord = {
+        id: '1752275500-exec-test-execution',
+        taskId: '1752274500-task-test-task',
+        result: 'Successfully implemented the feature'
+    };
+    beforeEach(() => {
+        jest.clearAllMocks();
+        mockConfigManager.findProjectRoot.mockReturnValue('/test/project');
+        mockValidateEmbeddedMetadata.mockResolvedValue(undefined);
+        // Default validator mock
+        const defaultValidator = jest.fn().mockReturnValue(true);
+        Object.defineProperty(defaultValidator, 'errors', {
+            value: null,
+            writable: true,
+            configurable: true
+        });
+        mockSchemaValidationCache.getValidatorFromSchema.mockReturnValue(defaultValidator);
+    });
+    describe('validateFullExecutionRecord', () => {
+        it('[EARS-1] should validate a complete ExecutionRecord successfully', async () => {
+            const mockRecord = {
+                header: {
+                    version: '1.0',
+                    type: 'execution',
+                    payloadChecksum: 'valid-checksum',
+                    signatures: [createMockSignature()]
+                },
+                payload: validRecord
+            };
+            const mockGetPublicKey = jest.fn().mockResolvedValue('mock-public-key');
+            await expect(validateFullExecutionRecord(mockRecord, mockGetPublicKey)).resolves.not.toThrow();
+        });
+        it('[EARS-2] should throw DetailedValidationError for invalid payload schema', async () => {
+            const invalidValidator = jest.fn().mockReturnValue(false);
+            Object.defineProperty(invalidValidator, 'errors', {
+                value: [{ instancePath: '/taskId', message: 'must not be empty', data: '' }],
+                writable: true,
+                configurable: true
+            });
+            mockSchemaValidationCache.getValidatorFromSchema.mockReturnValue(invalidValidator);
+            const invalidRecord = {
+                header: { version: '1.0', type: 'execution', payloadChecksum: 'valid-checksum', signatures: [createMockSignature()] },
+                payload: { id: 'invalid-id', taskId: '', result: '' }
+            };
+            const mockGetPublicKey = jest.fn().mockResolvedValue('mock-public-key');
+            await expect(validateFullExecutionRecord(invalidRecord, mockGetPublicKey)).rejects.toThrow(DetailedValidationError);
+        });
+        it('[EARS-3] should throw error if embedded metadata validation fails', async () => {
+            const mockRecord = {
+                header: { version: '1.0', type: 'execution', payloadChecksum: 'wrong-checksum', signatures: [createMockSignature()] },
+                payload: validRecord
+            };
+            const embeddedError = new Error('Embedded metadata validation failed');
+            mockValidateEmbeddedMetadata.mockRejectedValue(embeddedError);
+            const mockGetPublicKey = jest.fn().mockResolvedValue('mock-public-key');
+            await expect(validateFullExecutionRecord(mockRecord, mockGetPublicKey)).rejects.toThrow('Embedded metadata validation failed');
+        });
+        it('[EARS-4] should call validateFullEmbeddedMetadataRecord with correct parameters', async () => {
+            const mockRecord = {
+                header: { version: '1.0', type: 'execution', payloadChecksum: 'valid-checksum', signatures: [createMockSignature()] },
+                payload: validRecord
+            };
+            const mockGetPublicKey = jest.fn().mockResolvedValue('mock-public-key');
+            await validateFullExecutionRecord(mockRecord, mockGetPublicKey);
+            expect(mockValidateEmbeddedMetadata).toHaveBeenCalledWith(mockRecord, mockGetPublicKey);
+        });
+    });
+    describe('isExecutionRecord', () => {
+        it('[EARS-5] should return true for valid ExecutionRecord', () => {
+            expect(isExecutionRecord(validRecord)).toBe(true);
+        });
+        it('[EARS-6] should return false for invalid ExecutionRecord', () => {
+            const invalidValidator = jest.fn().mockReturnValue(false);
+            Object.defineProperty(invalidValidator, 'errors', {
+                value: [{ instancePath: '/id', message: 'invalid format' }],
+                writable: true,
+                configurable: true
+            });
+            mockSchemaValidationCache.getValidatorFromSchema.mockReturnValue(invalidValidator);
+            expect(isExecutionRecord({ id: 'invalid', taskId: '', result: '' })).toBe(false);
+        });
+    });
+    describe('validateExecutionRecordDetailed', () => {
+        it('[EARS-7] should return valid result for correct ExecutionRecord', () => {
+            const result = validateExecutionRecordDetailed(validRecord);
+            expect(result).toEqual({ isValid: true, errors: [] });
+        });
+        it('[EARS-8] should return detailed errors for invalid ExecutionRecord', () => {
+            const invalidValidator = jest.fn().mockReturnValue(false);
+            Object.defineProperty(invalidValidator, 'errors', {
+                value: [
+                    { instancePath: '/taskId', message: 'must match pattern', data: 'invalid-task-id' }
+                ],
+                writable: true,
+                configurable: true
+            });
+            mockSchemaValidationCache.getValidatorFromSchema.mockReturnValue(invalidValidator);
+            const result = validateExecutionRecordDetailed({ id: '1752275500-exec-test', taskId: 'invalid-task-id', result: '' });
+            expect(result.isValid).toBe(false);
+            expect(result.errors).toHaveLength(1);
+        });
+    });
+    describe('ExecutionRecord Type Enum Validation', () => {
+        describe('[EARS-26] type enum validation', () => {
+            it('should accept all valid type values', () => {
+                const validTypes = ['analysis', 'progress', 'blocker', 'completion', 'info', 'correction'];
+                validTypes.forEach(type => {
+                    const testRecord = { ...validRecord, type };
+                    expect(isExecutionRecord(testRecord)).toBe(true);
+                });
+            });
+            it('should reject invalid type values', () => {
+                const invalidValidator = jest.fn().mockReturnValue(false);
+                Object.defineProperty(invalidValidator, 'errors', {
+                    value: [{ instancePath: '/type', message: 'must be one of analysis, progress, blocker, completion, info, correction', data: 'invalid-type' }],
+                    writable: true,
+                    configurable: true
+                });
+                mockSchemaValidationCache.getValidatorFromSchema.mockReturnValue(invalidValidator);
+                const invalidRecord = { ...validRecord, type: 'invalid-type' };
+                expect(isExecutionRecord(invalidRecord)).toBe(false);
+            });
+            it('should provide detailed error for invalid type enum', () => {
+                const invalidValidator = jest.fn().mockReturnValue(false);
+                Object.defineProperty(invalidValidator, 'errors', {
+                    value: [{ instancePath: '/type', message: 'must be one of analysis, progress, blocker, completion, info, correction', data: 'wrong-type' }],
+                    writable: true,
+                    configurable: true
+                });
+                mockSchemaValidationCache.getValidatorFromSchema.mockReturnValue(invalidValidator);
+                const result = validateExecutionRecordDetailed({ ...validRecord, type: 'wrong-type' });
+                expect(result.isValid).toBe(false);
+                expect(result.errors).toEqual([{
+                        field: 'type',
+                        message: 'must be one of analysis, progress, blocker, completion, info, correction',
+                        value: 'wrong-type'
+                    }]);
+            });
+            it('should allow ExecutionRecord without type field (optional)', () => {
+                const recordWithoutType = {
+                    id: validRecord.id,
+                    taskId: validRecord.taskId,
+                    result: validRecord.result
+                };
+                expect(isExecutionRecord(recordWithoutType)).toBe(true);
+            });
+        });
+    });
+});
+//# sourceMappingURL=execution_validator.test.js.map

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

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

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

@@ -0,0 +1,23 @@
+import type { ValidateFunction } from "ajv";
+import type { FeedbackRecord } from '../types';
+import type { GitGovRecord } from '../types';
+import type { ValidationResult } from './errors';
+/**
+ * Schema-based validation for FeedbackRecord payload
+ */
+export declare function validateFeedbackRecordSchema(data: unknown): [boolean, ValidateFunction["errors"]];
+/**
+ * Type guard to check if data is a valid FeedbackRecord
+ */
+export declare function isFeedbackRecord(data: unknown): data is FeedbackRecord;
+/**
+ * Detailed validation with field-level error reporting
+ */
+export declare function validateFeedbackRecordDetailed(data: unknown): ValidationResult;
+/**
+ * Full validation including checksum and signature verification
+ */
+export declare function validateFullFeedbackRecord(record: GitGovRecord & {
+    payload: FeedbackRecord;
+}, getPublicKey: (keyId: string) => Promise<string>): Promise<void>;
+//# sourceMappingURL=feedback_validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feedback_validator.d.ts","sourceRoot":"","sources":["../../../src/validation/feedback_validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,KAAK,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAMjD;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,OAAO,GACZ,CAAC,OAAO,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAKvC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,cAAc,CAGtE;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAoB9E;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,YAAY,GAAG;IAAE,OAAO,EAAE,cAAc,CAAA;CAAE,EAClD,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/src/validation/feedback_validator.js

@@ -0,0 +1,58 @@
+import { SchemaValidationCache } from '../schemas/schema_cache';
+import { DetailedValidationError } from './common';
+import { validateFullEmbeddedMetadataRecord } from './embedded_metadata_validator';
+import { Schemas } from '../schemas';
+/**
+ * Schema-based validation for FeedbackRecord payload
+ */
+export function validateFeedbackRecordSchema(data) {
+    const validator = SchemaValidationCache.getValidatorFromSchema(Schemas.FeedbackRecord);
+    const isValid = validator(data);
+    return [isValid, validator.errors];
+}
+/**
+ * Type guard to check if data is a valid FeedbackRecord
+ */
+export function isFeedbackRecord(data) {
+    const [isValid] = validateFeedbackRecordSchema(data);
+    return isValid;
+}
+/**
+ * Detailed validation with field-level error reporting
+ */
+export function validateFeedbackRecordDetailed(data) {
+    const [isValid, errors] = validateFeedbackRecordSchema(data);
+    if (!isValid && errors) {
+        const formattedErrors = errors.map((error) => ({
+            field: error.instancePath?.replace('/', '') || error.params?.['missingProperty'] || 'root',
+            message: error.message || 'Unknown validation error',
+            value: error.data
+        }));
+        return {
+            isValid: false,
+            errors: formattedErrors
+        };
+    }
+    return {
+        isValid: true,
+        errors: []
+    };
+}
+/**
+ * Full validation including checksum and signature verification
+ */
+export async function validateFullFeedbackRecord(record, getPublicKey) {
+    // 1. Validate payload schema
+    const [isValid, errors] = validateFeedbackRecordSchema(record.payload);
+    if (!isValid) {
+        const formattedErrors = (errors || []).map((error) => ({
+            field: error.instancePath?.replace('/', '') || error.params?.['missingProperty'] || 'root',
+            message: error.message || 'Unknown validation error',
+            value: error.data
+        }));
+        throw new DetailedValidationError('FeedbackRecord', formattedErrors);
+    }
+    // 2. Embedded Metadata Validation (header + wrapper)
+    await validateFullEmbeddedMetadataRecord(record, getPublicKey);
+}
+//# sourceMappingURL=feedback_validator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feedback_validator.js","sourceRoot":"","sources":["../../../src/validation/feedback_validator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,IAAa;IAEb,MAAM,SAAS,GAAG,qBAAqB,CAAC,sBAAsB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACvF,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAEhC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,MAAM,CAAC,OAAO,CAAC,GAAG,4BAA4B,CAAC,IAAI,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,8BAA8B,CAAC,IAAa;IAC1D,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,4BAA4B,CAAC,IAAI,CAAC,CAAC;IAE7D,IAAI,CAAC,OAAO,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAkB,EAAE,EAAE,CAAC,CAAC;YAC1D,KAAK,EAAE,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,iBAAiB,CAAC,IAAI,MAAM;YAC1F,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,0BAA0B;YACpD,KAAK,EAAE,KAAK,CAAC,IAAI;SAClB,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,eAAe;SACxB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAAkD,EAClD,YAAgD;IAEhD,6BAA6B;IAC7B,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,4BAA4B,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,eAAe,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAkB,EAAE,EAAE,CAAC,CAAC;YAClE,KAAK,EAAE,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,iBAAiB,CAAC,IAAI,MAAM;YAC1F,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,0BAA0B;YACpD,KAAK,EAAE,KAAK,CAAC,IAAI;SAClB,CAAC,CAAC,CAAC;QACJ,MAAM,IAAI,uBAAuB,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;IACvE,CAAC;IAED,qDAAqD;IACrD,MAAM,kCAAkC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AACjE,CAAC"}

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

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

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

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

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

@@ -0,0 +1,131 @@
+import { validateFullFeedbackRecord, isFeedbackRecord, validateFeedbackRecordDetailed } from './feedback_validator';
+import { DetailedValidationError } from './common';
+// Mock dependencies
+jest.mock('../schemas/schema_cache');
+jest.mock('./embedded_metadata_validator');
+jest.mock('../config_manager');
+describe('FeedbackRecord Validator', () => {
+    const mockSchemaValidationCache = require('../schemas/schema_cache').SchemaValidationCache;
+    const mockValidateEmbeddedMetadata = require('./embedded_metadata_validator').validateFullEmbeddedMetadataRecord;
+    const mockConfigManager = require('../config_manager').ConfigManager;
+    const createMockSignature = () => ({
+        keyId: 'human:test',
+        role: 'author',
+        signature: 'mock-signature',
+        timestamp: 1752788100,
+        timestamp_iso: '2025-07-31T10:15:00Z'
+    });
+    const validRecord = {
+        id: '1752788100-feedback-blocking-issue',
+        entityType: 'task',
+        entityId: '1752274500-task-test-task',
+        type: 'blocking',
+        status: 'open',
+        content: 'This task has a blocking issue that needs resolution before proceeding'
+    };
+    beforeEach(() => {
+        jest.clearAllMocks();
+        mockConfigManager.findProjectRoot.mockReturnValue('/test/project');
+        mockValidateEmbeddedMetadata.mockResolvedValue(undefined);
+        // Default validator mock
+        const defaultValidator = jest.fn().mockReturnValue(true);
+        Object.defineProperty(defaultValidator, 'errors', {
+            value: null,
+            writable: true,
+            configurable: true
+        });
+        mockSchemaValidationCache.getValidatorFromSchema.mockReturnValue(defaultValidator);
+    });
+    describe('validateFullFeedbackRecord', () => {
+        it('[EARS-1] should validate a complete FeedbackRecord successfully', async () => {
+            const mockRecord = {
+                header: {
+                    version: '1.0',
+                    type: 'feedback',
+                    payloadChecksum: 'valid-checksum',
+                    signatures: [createMockSignature()]
+                },
+                payload: validRecord
+            };
+            const mockGetPublicKey = jest.fn().mockResolvedValue('mock-public-key');
+            await expect(validateFullFeedbackRecord(mockRecord, mockGetPublicKey)).resolves.not.toThrow();
+        });
+        it('[EARS-2] should throw DetailedValidationError for invalid payload schema', async () => {
+            const invalidValidator = jest.fn().mockReturnValue(false);
+            Object.defineProperty(invalidValidator, 'errors', {
+                value: [{ instancePath: '/entityType', message: 'must be one of allowed values', data: 'invalid' }],
+                writable: true,
+                configurable: true
+            });
+            mockSchemaValidationCache.getValidatorFromSchema.mockReturnValue(invalidValidator);
+            const invalidRecord = {
+                header: { version: '1.0', type: 'feedback', payloadChecksum: 'valid-checksum', signatures: [createMockSignature()] },
+                payload: { id: 'invalid-id', entityType: 'invalid', entityId: '', type: 'invalid', status: 'invalid', content: '' }
+            };
+            const mockGetPublicKey = jest.fn().mockResolvedValue('mock-public-key');
+            await expect(validateFullFeedbackRecord(invalidRecord, mockGetPublicKey)).rejects.toThrow(DetailedValidationError);
+        });
+        it('[EARS-3] should throw error if embedded metadata validation fails', async () => {
+            const mockRecord = {
+                header: { version: '1.0', type: 'feedback', payloadChecksum: 'wrong-checksum', signatures: [createMockSignature()] },
+                payload: validRecord
+            };
+            const embeddedError = new Error('Embedded metadata validation failed');
+            mockValidateEmbeddedMetadata.mockRejectedValue(embeddedError);
+            const mockGetPublicKey = jest.fn().mockResolvedValue('mock-public-key');
+            await expect(validateFullFeedbackRecord(mockRecord, mockGetPublicKey)).rejects.toThrow('Embedded metadata validation failed');
+        });
+        it('[EARS-4] should call validateFullEmbeddedMetadataRecord with correct parameters', async () => {
+            const mockRecord = {
+                header: { version: '1.0', type: 'feedback', payloadChecksum: 'valid-checksum', signatures: [createMockSignature()] },
+                payload: validRecord
+            };
+            const mockGetPublicKey = jest.fn().mockResolvedValue('mock-public-key');
+            await validateFullFeedbackRecord(mockRecord, mockGetPublicKey);
+            expect(mockValidateEmbeddedMetadata).toHaveBeenCalledWith(mockRecord, mockGetPublicKey);
+        });
+    });
+    describe('isFeedbackRecord', () => {
+        it('[EARS-5] should return true for valid FeedbackRecord', () => {
+            expect(isFeedbackRecord(validRecord)).toBe(true);
+        });
+        it('[EARS-6] should return false for invalid FeedbackRecord', () => {
+            const invalidValidator = jest.fn().mockReturnValue(false);
+            Object.defineProperty(invalidValidator, 'errors', {
+                value: [{ instancePath: '/id', message: 'invalid format' }],
+                writable: true,
+                configurable: true
+            });
+            mockSchemaValidationCache.getValidatorFromSchema.mockReturnValue(invalidValidator);
+            expect(isFeedbackRecord({ id: 'invalid', entityType: 'invalid', entityId: '', type: 'invalid', status: 'invalid', content: '' })).toBe(false);
+        });
+    });
+    describe('validateFeedbackRecordDetailed', () => {
+        it('[EARS-7] should return valid result for correct FeedbackRecord', () => {
+            const result = validateFeedbackRecordDetailed(validRecord);
+            expect(result).toEqual({ isValid: true, errors: [] });
+        });
+        it('[EARS-8] should return detailed errors for invalid FeedbackRecord', () => {
+            const invalidValidator = jest.fn().mockReturnValue(false);
+            Object.defineProperty(invalidValidator, 'errors', {
+                value: [
+                    { instancePath: '/entityType', message: 'must be one of allowed values', data: 'invalid-type' }
+                ],
+                writable: true,
+                configurable: true
+            });
+            mockSchemaValidationCache.getValidatorFromSchema.mockReturnValue(invalidValidator);
+            const result = validateFeedbackRecordDetailed({
+                id: '1752788100-feedback-test',
+                entityType: 'invalid-type',
+                entityId: 'task-1',
+                type: 'question',
+                status: 'open',
+                content: 'content'
+            });
+            expect(result.isValid).toBe(false);
+            expect(result.errors).toHaveLength(1);
+        });
+    });
+});
+//# sourceMappingURL=feedback_validator.test.js.map

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

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

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

@@ -0,0 +1,11 @@
+export * from './actor_validator';
+export * from './agent_validator';
+export * from './task_validator';
+export * from './cycle_validator';
+export * from './execution_validator';
+export * from './changelog_validator';
+export * from './feedback_validator';
+export * from './embedded_metadata_validator';
+export * from './workflow_methodology_validator';
+export type { ValidationResult } from './errors';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist/src/validation/index.js

@@ -0,0 +1,10 @@
+export * from './actor_validator';
+export * from './agent_validator';
+export * from './task_validator';
+export * from './cycle_validator';
+export * from './execution_validator';
+export * from './changelog_validator';
+export * from './feedback_validator';
+export * from './embedded_metadata_validator';
+export * from './workflow_methodology_validator';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC"}

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

@@ -0,0 +1,24 @@
+import type { ValidateFunction } from "ajv";
+import type { TaskRecord } from "../types";
+import type { GitGovRecord } from "../types";
+import type { ValidationResult } from './errors';
+export declare function validateTaskRecordSchema(data: unknown): [boolean, ValidateFunction["errors"]];
+/**
+ * Type guard to check if data is a valid TaskRecord.
+ */
+export declare function isTaskRecord(data: unknown): data is TaskRecord;
+/**
+ * Validates a TaskRecord and returns detailed validation result.
+ * Use this in factories and adapters for comprehensive error reporting.
+ */
+export declare function validateTaskRecordDetailed(data: unknown): ValidationResult;
+/**
+ * Performs a complete validation of a TaskRecord, including schema,
+ * checksum, and signature checks.
+ * @param record The full GitGovRecord containing the task payload.
+ * @param getActorPublicKey A function to retrieve the public key for a given actor ID.
+ */
+export declare function validateFullTaskRecord(record: GitGovRecord & {
+    payload: TaskRecord;
+}, getActorPublicKey: (keyId: string) => Promise<string | null>): Promise<void>;
+//# sourceMappingURL=task_validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task_validator.d.ts","sourceRoot":"","sources":["../../../src/validation/task_validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAM7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAIjD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,OAAO,GACZ,CAAC,OAAO,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAIvC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,UAAU,CAG9D;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAa1E;AAGD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,YAAY,GAAG;IAAE,OAAO,EAAE,UAAU,CAAA;CAAE,EAC9C,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAC3D,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/src/validation/task_validator.js

@@ -0,0 +1,50 @@
+import { SchemaValidationCache } from "../schemas/schema_cache";
+import { Schemas } from '../schemas';
+import { SchemaValidationError } from "./common";
+import { validateFullEmbeddedMetadataRecord } from './embedded_metadata_validator';
+// --- Schema Validation ---
+export function validateTaskRecordSchema(data) {
+    const validateSchema = SchemaValidationCache.getValidatorFromSchema(Schemas.TaskRecord);
+    const isValid = validateSchema(data);
+    return [isValid, validateSchema.errors];
+}
+/**
+ * Type guard to check if data is a valid TaskRecord.
+ */
+export function isTaskRecord(data) {
+    const validateSchema = SchemaValidationCache.getValidatorFromSchema(Schemas.TaskRecord);
+    return validateSchema(data);
+}
+/**
+ * Validates a TaskRecord and returns detailed validation result.
+ * Use this in factories and adapters for comprehensive error reporting.
+ */
+export function validateTaskRecordDetailed(data) {
+    const [isValid, ajvErrors] = validateTaskRecordSchema(data);
+    const formattedErrors = ajvErrors ? ajvErrors.map(error => ({
+        field: error.instancePath || error.schemaPath || 'root',
+        message: error.message || 'Validation failed',
+        value: error.data
+    })) : [];
+    return {
+        isValid,
+        errors: formattedErrors
+    };
+}
+// --- Full Validation Orchestrator ---
+/**
+ * Performs a complete validation of a TaskRecord, including schema,
+ * checksum, and signature checks.
+ * @param record The full GitGovRecord containing the task payload.
+ * @param getActorPublicKey A function to retrieve the public key for a given actor ID.
+ */
+export async function validateFullTaskRecord(record, getActorPublicKey) {
+    // 1. Schema Validation
+    const [isValidSchema, errors] = validateTaskRecordSchema(record.payload);
+    if (!isValidSchema) {
+        throw new SchemaValidationError(`TaskRecord payload failed schema validation: ${JSON.stringify(errors)}`);
+    }
+    // 2. Embedded Metadata Validation (header + wrapper)
+    await validateFullEmbeddedMetadataRecord(record, getActorPublicKey);
+}
+//# sourceMappingURL=task_validator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task_validator.js","sourceRoot":"","sources":["../../../src/validation/task_validator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EACL,qBAAqB,EACtB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AAEnF,4BAA4B;AAC5B,MAAM,UAAU,wBAAwB,CACtC,IAAa;IAEb,MAAM,cAAc,GAAG,qBAAqB,CAAC,sBAAsB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACxF,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAY,CAAC;IAChD,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,MAAM,cAAc,GAAG,qBAAqB,CAAC,sBAAsB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACxF,OAAO,cAAc,CAAC,IAAI,CAAY,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAa;IACtD,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;IAE5D,MAAM,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1D,KAAK,EAAE,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,UAAU,IAAI,MAAM;QACvD,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,mBAAmB;QAC7C,KAAK,EAAE,KAAK,CAAC,IAAI;KAClB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAET,OAAO;QACL,OAAO;QACP,MAAM,EAAE,eAAe;KACxB,CAAC;AACJ,CAAC;AAED,uCAAuC;AACvC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAA8C,EAC9C,iBAA4D;IAE5D,uBAAuB;IACvB,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,wBAAwB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzE,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,qBAAqB,CAC7B,gDAAgD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CACzE,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,MAAM,kCAAkC,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AACtE,CAAC"}

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

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

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

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