@gitgov/core 1.0.0

package/dist/src/utils/id_generator.test.js

@@ -0,0 +1,100 @@
+import { generateActorId, generateTaskId, generateCycleId, generateExecutionId, generateChangelogId, generateFeedbackId, parseTimestampedId, parseActorId, isValidTimestampedId } from './id_generator';
+describe('ID Generators', () => {
+    describe('generateActorId', () => {
+        it('[EARS-1] should create a valid human ID', () => {
+            expect(generateActorId('human', 'Camilo Velandia')).toBe('human:camilo-velandia');
+        });
+        it('[EARS-1] should create a valid agent ID', () => {
+            expect(generateActorId('agent', 'Cursor Assistant')).toBe('agent:cursor-assistant');
+        });
+    });
+    describe('generateTaskId', () => {
+        it('[EARS-2] should create a valid task ID', () => {
+            expect(generateTaskId('Implement Auth Flow', 12345)).toBe('12345-task-implement-auth-flow');
+        });
+    });
+    describe('generateCycleId', () => {
+        it('[EARS-3] should create a valid cycle ID', () => {
+            expect(generateCycleId('Q4 Sprint 1', 54321)).toBe('54321-cycle-q4-sprint-1');
+        });
+    });
+    describe('generateExecutionId', () => {
+        it('[EARS-4] should create a valid execution ID', () => {
+            expect(generateExecutionId('Commit changes', 99999)).toBe('99999-exec-commit-changes');
+        });
+    });
+    describe('generateChangelogId', () => {
+        it('[EARS-5] should create a valid changelog ID for task entity', () => {
+            const entityId = '12345-task-implement-auth-flow';
+            expect(generateChangelogId('task', entityId, 88888)).toBe('88888-changelog-task-implement-auth-flow');
+        });
+        it('[EARS-5] should create a valid changelog ID for system entity', () => {
+            expect(generateChangelogId('system', 'payment-gateway', 88888)).toBe('88888-changelog-system-payment-gateway');
+        });
+        it('[EARS-5] should create a valid changelog ID for configuration entity', () => {
+            expect(generateChangelogId('configuration', 'database-config', 88888)).toBe('88888-changelog-configuration-database-config');
+        });
+        it('[EARS-5] should create a valid changelog ID for cycle entity', () => {
+            const entityId = '54321-cycle-sprint-1';
+            expect(generateChangelogId('cycle', entityId, 88888)).toBe('88888-changelog-cycle-sprint-1');
+        });
+        it('[EARS-5] should create a valid changelog ID for agent entity', () => {
+            expect(generateChangelogId('agent', 'cursor-assistant', 88888)).toBe('88888-changelog-agent-cursor-assistant');
+        });
+    });
+    describe('generateFeedbackId', () => {
+        it('[EARS-6] should create a valid feedback ID', () => {
+            expect(generateFeedbackId('Code Review Comments', 77777)).toBe('77777-feedback-code-review-comments');
+        });
+    });
+    describe('parseTimestampedId', () => {
+        it('[EARS-7] should parse a valid task ID', () => {
+            const parsed = parseTimestampedId('12345-task-implement-auth');
+            expect(parsed).toEqual({
+                timestamp: 12345,
+                prefix: 'task',
+                slug: 'implement-auth',
+            });
+        });
+        it('[EARS-7] should return null for invalid formats', () => {
+            expect(parseTimestampedId('invalid-id')).toBeNull();
+            expect(parseTimestampedId('123-task')).toBeNull();
+        });
+    });
+    describe('parseActorId', () => {
+        it('[EARS-8] should parse a valid human ID', () => {
+            const parsed = parseActorId('human:camilo-velandia');
+            expect(parsed).toEqual({
+                type: 'human',
+                slug: 'camilo-velandia',
+            });
+        });
+        it('[EARS-8] should parse a valid agent ID with scope', () => {
+            const parsed = parseActorId('agent:camilo:cursor:planner');
+            expect(parsed).toEqual({
+                type: 'agent',
+                slug: 'camilo:cursor:planner',
+            });
+        });
+        it('[EARS-8] should return null for invalid actor IDs', () => {
+            expect(parseActorId('invalid-id')).toBeNull();
+            expect(parseActorId('badtype:name')).toBeNull();
+        });
+    });
+    describe('isValidTimestampedId', () => {
+        it('[EARS-9] should return true for valid IDs', () => {
+            expect(isValidTimestampedId('12345-task-valid-slug')).toBe(true);
+            expect(isValidTimestampedId('54321-cycle-another-slug')).toBe(true);
+            expect(isValidTimestampedId('67890-exec-execution-slug')).toBe(true);
+            expect(isValidTimestampedId('11111-changelog-changelog-slug')).toBe(true);
+            expect(isValidTimestampedId('22222-feedback-feedback-slug')).toBe(true);
+        });
+        it('[EARS-10] should return false for invalid IDs', () => {
+            expect(isValidTimestampedId('123-badprefix-slug')).toBe(false);
+            expect(isValidTimestampedId('notatimestamp-task-slug')).toBe(false);
+            expect(isValidTimestampedId('12345-task-')).toBe(false);
+            expect(isValidTimestampedId('12345-task')).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=id_generator.test.js.map

package/dist/src/utils/id_generator.test.js.map

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

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

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

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

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

package/dist/src/utils/index.js

@@ -0,0 +1,3 @@
+export {};
+// Utils module - currently empty after removing path-utils
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";AAAA,2DAA2D"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"actor_validator.d.ts","sourceRoot":"","sources":["../../../src/validation/actor_validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAQjD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,OAAO,GACZ,CAAC,OAAO,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAIvC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,WAAW,CAGhE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAa3E;AAGD;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,YAAY,GAAG;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,EAC/C,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAC3D,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/src/validation/actor_validator.js

@@ -0,0 +1,48 @@
+import { SchemaValidationError } from "./common";
+import { SchemaValidationCache } from "../schemas/schema_cache";
+import { Schemas } from "../schemas";
+import { validateFullEmbeddedMetadataRecord } from './embedded_metadata_validator';
+// --- Schema Validation ---
+const actorSchema = Schemas.ActorRecord;
+export function validateActorRecordSchema(data) {
+    const validateSchema = SchemaValidationCache.getValidatorFromSchema(actorSchema);
+    const isValid = validateSchema(data);
+    return [isValid, validateSchema.errors];
+}
+export function isActorRecord(data) {
+    const validateSchema = SchemaValidationCache.getValidatorFromSchema(actorSchema);
+    return validateSchema(data);
+}
+/**
+ * Validates an ActorRecord and returns detailed validation result.
+ * Use this in factories and adapters for comprehensive error reporting.
+ */
+export function validateActorRecordDetailed(data) {
+    const [isValid, ajvErrors] = validateActorRecordSchema(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 an ActorRecord, including schema,
+ * checksum, and signature checks.
+ * @param record The full GitGovRecord containing the actor payload.
+ * @param getActorPublicKey A function to retrieve the public key for a given actor ID.
+ */
+export async function validateFullActorRecord(record, getActorPublicKey) {
+    // 1. Schema Validation
+    const [isValidSchema, errors] = validateActorRecordSchema(record.payload);
+    if (!isValidSchema) {
+        throw new SchemaValidationError(`ActorRecord payload failed schema validation: ${JSON.stringify(errors)}`);
+    }
+    // 2. Embedded Metadata Validation (header + wrapper)
+    await validateFullEmbeddedMetadataRecord(record, getActorPublicKey);
+}
+//# sourceMappingURL=actor_validator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"actor_validator.js","sourceRoot":"","sources":["../../../src/validation/actor_validator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AAEnF,4BAA4B;AAC5B,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;AAExC,MAAM,UAAU,yBAAyB,CACvC,IAAa;IAEb,MAAM,cAAc,GAAG,qBAAqB,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC;IACjF,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAY,CAAC;IAChD,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,MAAM,cAAc,GAAG,qBAAqB,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC;IACjF,OAAO,cAAc,CAAC,IAAI,CAAY,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAa;IACvD,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAE7D,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,uBAAuB,CAC3C,MAA+C,EAC/C,iBAA4D;IAE5D,uBAAuB;IACvB,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,yBAAyB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1E,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,qBAAqB,CAC7B,iDAAiD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAC1E,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,MAAM,kCAAkC,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AACtE,CAAC"}

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

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

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

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

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

@@ -0,0 +1,83 @@
+import { validateFullActorRecord, isActorRecord, validateActorRecordDetailed } from './actor_validator';
+import { SchemaValidationError } from './common';
+import { validateFullEmbeddedMetadataRecord } from './embedded_metadata_validator';
+// Mock the embedded metadata validator
+jest.mock('./embedded_metadata_validator');
+const mockedValidateEmbeddedMetadata = validateFullEmbeddedMetadataRecord;
+describe('ActorValidator Module', () => {
+    const validActorPayload = {
+        id: 'human:test', type: 'human', displayName: 'Test',
+        publicKey: 'key', roles: ['author'], status: 'active'
+    };
+    // Create an invalid payload by removing a required property
+    const { id, ...invalidPayloadWithoutId } = validActorPayload;
+    const getActorPublicKey = jest.fn(async (keyId) => {
+        if (keyId === 'human:test')
+            return 'key';
+        return null;
+    });
+    beforeEach(() => {
+        jest.clearAllMocks();
+        // Happy path default for embedded metadata validation
+        mockedValidateEmbeddedMetadata.mockResolvedValue(undefined);
+    });
+    describe('validateFullActorRecord', () => {
+        const baseRecord = {
+            header: {
+                version: '1.0', type: 'actor', payloadChecksum: 'valid_checksum',
+                signatures: [{ keyId: 'human:test', role: 'author', signature: 'sig', timestamp: 123, timestamp_iso: '' }]
+            },
+            payload: validActorPayload
+        };
+        it('[EARS-4] should complete without errors for a fully valid record', async () => {
+            await expect(validateFullActorRecord(baseRecord, getActorPublicKey)).resolves.not.toThrow();
+        });
+        it('[EARS-1] should throw SchemaValidationError if the payload is invalid', async () => {
+            const invalidRecord = { ...baseRecord, payload: { ...validActorPayload, id: 'invalid-id-format' } };
+            await expect(validateFullActorRecord(invalidRecord, getActorPublicKey)).rejects.toThrow(SchemaValidationError);
+        });
+        it('[EARS-2] should throw error if embedded metadata validation fails', async () => {
+            const embeddedError = new Error('Embedded metadata validation failed');
+            mockedValidateEmbeddedMetadata.mockRejectedValue(embeddedError);
+            await expect(validateFullActorRecord(baseRecord, getActorPublicKey)).rejects.toThrow('Embedded metadata validation failed');
+        });
+        it('[EARS-3] should call validateFullEmbeddedMetadataRecord with correct parameters', async () => {
+            await validateFullActorRecord(baseRecord, getActorPublicKey);
+            expect(mockedValidateEmbeddedMetadata).toHaveBeenCalledWith(baseRecord, getActorPublicKey);
+        });
+    });
+    describe('isActorRecord', () => {
+        it('[EARS-5 & EARS-6] should correctly identify valid and invalid records', () => {
+            expect(isActorRecord(validActorPayload)).toBe(true);
+            expect(isActorRecord(invalidPayloadWithoutId)).toBe(false);
+        });
+    });
+    describe('validateActorRecordDetailed', () => {
+        it('[EARS-7] should return success for valid ActorRecord', () => {
+            const result = validateActorRecordDetailed(validActorPayload);
+            expect(result.isValid).toBe(true);
+            expect(result.errors).toEqual([]);
+        });
+        it('[EARS-8] should return detailed errors for invalid ActorRecord', () => {
+            const result = validateActorRecordDetailed(invalidPayloadWithoutId);
+            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-9] should provide specific error details for each invalid field', () => {
+            const invalidActor = {
+                id: 'invalid-format', // Wrong ID pattern
+                type: 'robot', // Invalid type
+                displayName: '', // Empty string
+                publicKey: '', // Empty string
+                roles: [] // Empty array
+            };
+            const result = validateActorRecordDetailed(invalidActor);
+            expect(result.isValid).toBe(false);
+            expect(result.errors.length).toBeGreaterThan(1); // Multiple errors
+        });
+    });
+});
+//# sourceMappingURL=actor_validator.test.js.map

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

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

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

@@ -0,0 +1,30 @@
+import type { ValidateFunction } from "ajv";
+import type { AgentRecord } from "../types";
+import type { GitGovRecord } from "../types";
+import type { ValidationResult } from './errors';
+import type { ActorRecord } from "../types";
+export declare function validateAgentRecordSchema(data: unknown): [boolean, ValidateFunction["errors"]];
+export declare function isAgentRecord(data: unknown): data is AgentRecord;
+/**
+ * Validates an AgentRecord and returns detailed validation result.
+ * Use this in factories and adapters for comprehensive error reporting.
+ */
+export declare function validateAgentRecordDetailed(data: unknown): ValidationResult;
+/**
+ * Performs a complete validation of an AgentRecord, including schema,
+ * checksum, and signature checks.
+ * @param record The full GitGovRecord containing the agent payload.
+ * @param getActorPublicKey A function to retrieve the public key for a given actor ID.
+ */
+export declare function validateFullAgentRecord(record: GitGovRecord & {
+    payload: AgentRecord;
+}, getActorPublicKey: (keyId: string) => Promise<string | null>): Promise<void>;
+/**
+ * Validates that an AgentRecord has a valid relationship with its corresponding ActorRecord,
+ * including succession chain resolution for key rotation scenarios.
+ *
+ * @param agentRecord The AgentRecord to validate
+ * @param getEffectiveActor Function to get the effective ActorRecord (with succession resolution)
+ */
+export declare function validateAgentActorRelationship(agentRecord: AgentRecord, getEffectiveActor: (agentId: string) => Promise<ActorRecord | null>): Promise<void>;
+//# sourceMappingURL=agent_validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent_validator.d.ts","sourceRoot":"","sources":["../../../src/validation/agent_validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,OAAO,GACZ,CAAC,OAAO,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAIvC;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,WAAW,CAGhE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAa3E;AAGD;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,YAAY,GAAG;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,EAC/C,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAC3D,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAClD,WAAW,EAAE,WAAW,EACxB,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAClE,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/src/validation/agent_validator.js

@@ -0,0 +1,66 @@
+import { SchemaValidationError } from "./common";
+import { validateFullEmbeddedMetadataRecord } from './embedded_metadata_validator';
+import { SchemaValidationCache } from "../schemas/schema_cache";
+import { Schemas } from '../schemas';
+// --- Schema Validation ---
+export function validateAgentRecordSchema(data) {
+    const validateSchema = SchemaValidationCache.getValidatorFromSchema(Schemas.AgentRecord);
+    const isValid = validateSchema(data);
+    return [isValid, validateSchema.errors];
+}
+export function isAgentRecord(data) {
+    const validateSchema = SchemaValidationCache.getValidatorFromSchema(Schemas.AgentRecord);
+    return validateSchema(data);
+}
+/**
+ * Validates an AgentRecord and returns detailed validation result.
+ * Use this in factories and adapters for comprehensive error reporting.
+ */
+export function validateAgentRecordDetailed(data) {
+    const [isValid, ajvErrors] = validateAgentRecordSchema(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 an AgentRecord, including schema,
+ * checksum, and signature checks.
+ * @param record The full GitGovRecord containing the agent payload.
+ * @param getActorPublicKey A function to retrieve the public key for a given actor ID.
+ */
+export async function validateFullAgentRecord(record, getActorPublicKey) {
+    // 1. Schema Validation
+    const [isValidSchema, errors] = validateAgentRecordSchema(record.payload);
+    if (!isValidSchema) {
+        throw new SchemaValidationError(`AgentRecord payload failed schema validation: ${JSON.stringify(errors)}`);
+    }
+    // 2. Embedded Metadata Validation (header + wrapper)
+    await validateFullEmbeddedMetadataRecord(record, getActorPublicKey);
+}
+/**
+ * Validates that an AgentRecord has a valid relationship with its corresponding ActorRecord,
+ * including succession chain resolution for key rotation scenarios.
+ *
+ * @param agentRecord The AgentRecord to validate
+ * @param getEffectiveActor Function to get the effective ActorRecord (with succession resolution)
+ */
+export async function validateAgentActorRelationship(agentRecord, getEffectiveActor) {
+    const effectiveActor = await getEffectiveActor(agentRecord.id);
+    if (!effectiveActor) {
+        throw new SchemaValidationError(`No active ActorRecord found for AgentRecord ${agentRecord.id}. AgentRecord requires corresponding ActorRecord.`);
+    }
+    if (effectiveActor.type !== 'agent') {
+        throw new SchemaValidationError(`ActorRecord ${effectiveActor.id} must be of type 'agent' to support AgentRecord ${agentRecord.id}.`);
+    }
+    if (effectiveActor.status !== 'active') {
+        throw new SchemaValidationError(`ActorRecord succession chain for ${agentRecord.id} does not resolve to an active actor. Current effective actor: ${effectiveActor.id} (status: ${effectiveActor.status}).`);
+    }
+}
+//# sourceMappingURL=agent_validator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent_validator.js","sourceRoot":"","sources":["../../../src/validation/agent_validator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AAEnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGrC,4BAA4B;AAC5B,MAAM,UAAU,yBAAyB,CACvC,IAAa;IAEb,MAAM,cAAc,GAAG,qBAAqB,CAAC,sBAAsB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACzF,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAY,CAAC;IAChD,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,MAAM,cAAc,GAAG,qBAAqB,CAAC,sBAAsB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACzF,OAAO,cAAc,CAAC,IAAI,CAAY,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAa;IACvD,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAE7D,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,uBAAuB,CAC3C,MAA+C,EAC/C,iBAA4D;IAE5D,uBAAuB;IACvB,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,yBAAyB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1E,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,qBAAqB,CAC7B,iDAAiD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAC1E,CAAC;IACJ,CAAC;IAED,qDAAqD;IACrD,MAAM,kCAAkC,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,WAAwB,EACxB,iBAAmE;IAEnE,MAAM,cAAc,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAE/D,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,qBAAqB,CAC7B,+CAA+C,WAAW,CAAC,EAAE,mDAAmD,CACjH,CAAC;IACJ,CAAC;IAED,IAAI,cAAc,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACpC,MAAM,IAAI,qBAAqB,CAC7B,eAAe,cAAc,CAAC,EAAE,mDAAmD,WAAW,CAAC,EAAE,GAAG,CACrG,CAAC;IACJ,CAAC;IAED,IAAI,cAAc,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,IAAI,qBAAqB,CAC7B,oCAAoC,WAAW,CAAC,EAAE,kEAAkE,cAAc,CAAC,EAAE,aAAa,cAAc,CAAC,MAAM,IAAI,CAC5K,CAAC;IACJ,CAAC;AACH,CAAC"}

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

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

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

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

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

@@ -0,0 +1,73 @@
+import { validateFullAgentRecord, isAgentRecord } from './agent_validator';
+import { SchemaValidationError } from './common';
+import { validateFullEmbeddedMetadataRecord } from './embedded_metadata_validator';
+// Mock the embedded metadata validator
+jest.mock('./embedded_metadata_validator');
+const mockedValidateEmbeddedMetadata = validateFullEmbeddedMetadataRecord;
+describe('AgentValidator Module', () => {
+    const validAgentPayload = {
+        id: 'agent:test-agent',
+        guild: 'design',
+        status: 'active',
+        engine: { type: 'local', runtime: 'typescript', entrypoint: 'test.ts', function: 'run' },
+        triggers: [{ type: 'manual' }],
+        knowledge_dependencies: [],
+        prompt_engine_requirements: {}
+    };
+    // Create an invalid payload by removing a required property
+    const { id, ...invalidPayloadWithoutId } = validAgentPayload;
+    const getActorPublicKey = jest.fn(async (keyId) => {
+        if (keyId === 'agent:test-agent')
+            return 'key';
+        return null;
+    });
+    beforeEach(() => {
+        jest.clearAllMocks();
+        // Happy path default for embedded metadata validation
+        mockedValidateEmbeddedMetadata.mockResolvedValue(undefined);
+    });
+    describe('validateFullAgentRecord', () => {
+        const baseRecord = {
+            header: {
+                version: '1.0', type: 'agent', payloadChecksum: 'valid_checksum',
+                signatures: [{ keyId: 'agent:test-agent', role: 'author', signature: 'sig', timestamp: 123, timestamp_iso: '' }]
+            },
+            payload: validAgentPayload
+        };
+        it('[EARS-4] should complete without errors for a fully valid record', async () => {
+            await expect(validateFullAgentRecord(baseRecord, getActorPublicKey)).resolves.not.toThrow();
+        });
+        it('[EARS-1] should throw SchemaValidationError if the payload is invalid', async () => {
+            const invalidRecord = { ...baseRecord, payload: { ...validAgentPayload, id: 'invalid-id-format' } };
+            await expect(validateFullAgentRecord(invalidRecord, getActorPublicKey)).rejects.toThrow(SchemaValidationError);
+        });
+        it('[EARS-2] should throw error if embedded metadata validation fails', async () => {
+            const embeddedError = new Error('Embedded metadata validation failed');
+            mockedValidateEmbeddedMetadata.mockRejectedValue(embeddedError);
+            await expect(validateFullAgentRecord(baseRecord, getActorPublicKey)).rejects.toThrow('Embedded metadata validation failed');
+        });
+        it('[EARS-3] should call validateFullEmbeddedMetadataRecord with correct parameters', async () => {
+            await validateFullAgentRecord(baseRecord, getActorPublicKey);
+            expect(mockedValidateEmbeddedMetadata).toHaveBeenCalledWith(baseRecord, getActorPublicKey);
+        });
+    });
+    describe('isAgentRecord', () => {
+        it('[EARS-5 & EARS-6] should correctly identify valid and invalid records', () => {
+            expect(isAgentRecord(validAgentPayload)).toBe(true);
+            expect(isAgentRecord(invalidPayloadWithoutId)).toBe(false);
+        });
+        it('[EARS-7] should validate agent ID pattern', () => {
+            const invalidIdAgent = { ...validAgentPayload, id: 'human:test' }; // Wrong pattern
+            expect(isAgentRecord(invalidIdAgent)).toBe(false);
+        });
+        it('[EARS-8] should validate guild enum values', () => {
+            const invalidGuildAgent = { ...validAgentPayload, guild: 'invalid-guild' };
+            expect(isAgentRecord(invalidGuildAgent)).toBe(false);
+        });
+        it('[EARS-9] should validate engine structure', () => {
+            const invalidEngineAgent = { ...validAgentPayload, engine: { type: 'invalid' } };
+            expect(isAgentRecord(invalidEngineAgent)).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=agent_validator.test.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"changelog_validator.d.ts","sourceRoot":"","sources":["../../../src/validation/changelog_validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAe,MAAM,KAAK,CAAC;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAMjD;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,OAAO,GACZ,CAAC,OAAO,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAKvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,eAAe,CAGxE;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAoB/E;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,YAAY,GAAG;IAAE,OAAO,EAAE,eAAe,CAAA;CAAE,EACnD,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/src/validation/changelog_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 ChangelogRecord payload
+ */
+export function validateChangelogRecordSchema(data) {
+    const validator = SchemaValidationCache.getValidatorFromSchema(Schemas.ChangelogRecord);
+    const isValid = validator(data);
+    return [isValid, validator.errors];
+}
+/**
+ * Type guard to check if data is a valid ChangelogRecord
+ */
+export function isChangelogRecord(data) {
+    const [isValid] = validateChangelogRecordSchema(data);
+    return isValid;
+}
+/**
+ * Detailed validation with field-level error reporting
+ */
+export function validateChangelogRecordDetailed(data) {
+    const [isValid, errors] = validateChangelogRecordSchema(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 validateFullChangelogRecord(record, getPublicKey) {
+    // 1. Validate payload schema
+    const [isValid, errors] = validateChangelogRecordSchema(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('ChangelogRecord', formattedErrors);
+    }
+    // 2. Embedded Metadata Validation (header + wrapper)
+    await validateFullEmbeddedMetadataRecord(record, getPublicKey);
+}
+//# sourceMappingURL=changelog_validator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"changelog_validator.js","sourceRoot":"","sources":["../../../src/validation/changelog_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,6BAA6B,CAC3C,IAAa;IAEb,MAAM,SAAS,GAAG,qBAAqB,CAAC,sBAAsB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IACxF,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,iBAAiB,CAAC,IAAa;IAC7C,MAAM,CAAC,OAAO,CAAC,GAAG,6BAA6B,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAAC,IAAa;IAC3D,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,6BAA6B,CAAC,IAAI,CAAC,CAAC;IAE9D,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,2BAA2B,CAC/C,MAAmD,EACnD,YAAgD;IAEhD,6BAA6B;IAC7B,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,6BAA6B,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxE,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,iBAAiB,EAAE,eAAe,CAAC,CAAC;IACxE,CAAC;IAED,qDAAqD;IACrD,MAAM,kCAAkC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AACjE,CAAC"}

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

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

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

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