@gitgov/core 1.0.0

package/dist/src/factories/agent_factory.test.js

@@ -0,0 +1,199 @@
+import { createAgentRecord } from './agent_factory';
+import { DetailedValidationError } from '../validation/common';
+// Mock the validator to control test outcomes
+jest.mock('../validation/agent_validator', () => ({
+    validateAgentRecordDetailed: jest.fn(() => ({ isValid: true, errors: [] })),
+}));
+describe('createAgentRecord', () => {
+    beforeEach(() => {
+        // Reset mock to default success state before each test
+        const { validateAgentRecordDetailed } = require('../validation/agent_validator');
+        validateAgentRecordDetailed.mockReturnValue({ isValid: true, errors: [] });
+    });
+    it('[EARS-2 & EARS-3] should create a valid agent record with defaults', async () => {
+        const payload = {
+            id: 'agent:test-agent',
+            guild: 'design',
+            engine: {
+                type: 'local',
+                runtime: 'typescript',
+                entrypoint: 'packages/agents/test/index.ts',
+                function: 'runTestAgent'
+            },
+        };
+        const agent = await createAgentRecord(payload);
+        expect(agent.id).toBe('agent:test-agent');
+        expect(agent.status).toBe('active'); // Default status
+        expect(agent.guild).toBe('design');
+        expect(agent.engine.type).toBe('local');
+        expect(agent.triggers).toEqual([]); // Default empty array
+        expect(agent.knowledge_dependencies).toEqual([]); // Default empty array
+        expect(agent.prompt_engine_requirements).toEqual({}); // Default empty object
+    });
+    it('[EARS-1] should throw DetailedValidationError for invalid id (empty string)', async () => {
+        const { validateAgentRecordDetailed } = require('../validation/agent_validator');
+        validateAgentRecordDetailed.mockReturnValue({
+            isValid: false,
+            errors: [
+                { field: 'id', message: 'must match pattern "^agent:[a-z0-9:-]+$"', value: '' }
+            ]
+        });
+        const payload = {
+            guild: 'design',
+            engine: { type: 'local' },
+        };
+        await expect(createAgentRecord(payload)).rejects.toThrow(DetailedValidationError);
+    });
+    it('[EARS-1] should throw DetailedValidationError for invalid guild (default not in enum)', async () => {
+        const { validateAgentRecordDetailed } = require('../validation/agent_validator');
+        validateAgentRecordDetailed.mockReturnValue({
+            isValid: false,
+            errors: [
+                { field: 'guild', message: 'must be one of: design, intelligence, strategy, operations, quality', value: 'design' }
+            ]
+        });
+        const payload = {
+            id: 'agent:test-agent',
+            engine: { type: 'local' },
+        };
+        await expect(createAgentRecord(payload)).rejects.toThrow(DetailedValidationError);
+    });
+    it('[EARS-1] should throw DetailedValidationError for missing engine properties', async () => {
+        const { validateAgentRecordDetailed } = require('../validation/agent_validator');
+        validateAgentRecordDetailed.mockReturnValue({
+            isValid: false,
+            errors: [
+                { field: 'engine', message: 'must have required property based on type', value: { type: 'local' } }
+            ]
+        });
+        const payload = {
+            id: 'agent:test-agent',
+            guild: 'design',
+        };
+        await expect(createAgentRecord(payload)).rejects.toThrow(DetailedValidationError);
+    });
+    it('[EARS-5] should throw DetailedValidationError if the created record fails validation', async () => {
+        // Override the mock for this specific test
+        const { validateAgentRecordDetailed } = require('../validation/agent_validator');
+        validateAgentRecordDetailed.mockReturnValue({
+            isValid: false,
+            errors: [
+                { field: 'engine', message: 'invalid engine configuration', value: { type: 'local' } }
+            ]
+        });
+        const payload = {
+            id: 'agent:test-agent',
+            guild: 'design',
+            engine: { type: 'local' },
+        };
+        await expect(createAgentRecord(payload)).rejects.toThrow(DetailedValidationError);
+        // Restore the mock
+        validateAgentRecordDetailed.mockReturnValue({ isValid: true, errors: [] });
+    });
+    it('[EARS-6] should set default values for optional fields', async () => {
+        const payload = {
+            id: 'agent:minimal-agent',
+            guild: 'design',
+            engine: { type: 'local' },
+        };
+        const agent = await createAgentRecord(payload);
+        expect(agent.status).toBe('active'); // Default status
+        expect(agent.triggers).toEqual([]); // Default empty array
+        expect(agent.knowledge_dependencies).toEqual([]); // Default empty array
+        expect(agent.prompt_engine_requirements).toEqual({}); // Default empty object
+    });
+    it('[EARS-7] should preserve provided optional fields', async () => {
+        const payload = {
+            id: 'agent:complex-agent',
+            guild: 'intelligence',
+            engine: { type: 'api', url: 'https://api.example.com', method: 'POST' },
+            status: 'archived',
+            triggers: [{ type: 'manual' }],
+            knowledge_dependencies: ['blueprints/core'],
+            prompt_engine_requirements: { roles: ['analyst'], skills: ['research'] }
+        };
+        const agent = await createAgentRecord(payload);
+        expect(agent.status).toBe('archived'); // Custom status preserved
+        expect(agent.triggers).toEqual([{ type: 'manual' }]);
+        expect(agent.knowledge_dependencies).toEqual(['blueprints/core']);
+        expect(agent.prompt_engine_requirements).toEqual({ roles: ['analyst'], skills: ['research'] });
+    });
+    it('[EARS-8] should require explicit ID (no generation - must correspond to existing ActorRecord)', async () => {
+        const payload = {
+            guild: 'design',
+            engine: { type: 'local' },
+        };
+        const agent = await createAgentRecord(payload);
+        // AgentRecord uses empty string as default ID because it MUST correspond to an existing ActorRecord
+        // According to agent_protocol.md: "AgentRecord ID debe corresponder 1:1 con un ActorRecord existente"
+        expect(agent.id).toBe('');
+        expect(agent.guild).toBe('design');
+        expect(agent.engine.type).toBe('local');
+    });
+    describe('AgentRecord Specific Factory Operations (EARS 12-14)', () => {
+        it('[EARS-12] should throw DetailedValidationError when guild is missing', async () => {
+            const { validateAgentRecordDetailed } = require('../validation/agent_validator');
+            validateAgentRecordDetailed.mockReturnValue({
+                isValid: false,
+                errors: [
+                    { field: 'guild', message: 'must have required property guild', value: undefined }
+                ]
+            });
+            const payload = {
+                id: 'agent:test-agent',
+                engine: { type: 'local' }
+                // guild missing - should trigger validation error
+            };
+            await expect(createAgentRecord(payload)).rejects.toThrow(DetailedValidationError);
+            // Restore mock
+            validateAgentRecordDetailed.mockReturnValue({ isValid: true, errors: [] });
+        });
+        it('[EARS-13] should throw DetailedValidationError for invalid guild value', async () => {
+            const { validateAgentRecordDetailed } = require('../validation/agent_validator');
+            validateAgentRecordDetailed.mockReturnValue({
+                isValid: false,
+                errors: [
+                    { field: 'guild', message: 'must be one of design, intelligence, strategy, operations, quality', value: 'invalid-guild' }
+                ]
+            });
+            const payload = {
+                id: 'agent:test-agent',
+                guild: 'invalid-guild',
+                engine: { type: 'local' }
+            };
+            await expect(createAgentRecord(payload)).rejects.toThrow(DetailedValidationError);
+            // Restore mock
+            validateAgentRecordDetailed.mockReturnValue({ isValid: true, errors: [] });
+        });
+        it('[EARS-14] should throw DetailedValidationError when engine is missing', async () => {
+            const { validateAgentRecordDetailed } = require('../validation/agent_validator');
+            validateAgentRecordDetailed.mockReturnValue({
+                isValid: false,
+                errors: [
+                    { field: 'engine', message: 'must have required property engine', value: undefined }
+                ]
+            });
+            const payload = {
+                id: 'agent:test-agent',
+                guild: 'design'
+                // engine missing - should trigger validation error
+            };
+            await expect(createAgentRecord(payload)).rejects.toThrow(DetailedValidationError);
+            // Restore mock
+            validateAgentRecordDetailed.mockReturnValue({ isValid: true, errors: [] });
+        });
+        it('[EARS-13] should accept valid guild values', async () => {
+            const validGuilds = ['design', 'intelligence', 'strategy', 'operations', 'quality'];
+            for (const guild of validGuilds) {
+                const payload = {
+                    id: `agent:test-${guild}`,
+                    guild: guild,
+                    engine: { type: 'local' }
+                };
+                const agent = await createAgentRecord(payload);
+                expect(agent.guild).toBe(guild);
+            }
+        });
+    });
+});
+//# sourceMappingURL=agent_factory.test.js.map

package/dist/src/factories/agent_factory.test.js.map

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

package/dist/src/factories/changelog_factory.d.ts

@@ -0,0 +1,9 @@
+import type { ChangelogRecord } from '../types';
+/**
+ * Creates a complete ChangelogRecord with validation (Protocol v2)
+ *
+ * @param payload - Partial ChangelogRecord payload
+ * @returns Promise<ChangelogRecord> - The validated ChangelogRecord
+ */
+export declare function createChangelogRecord(payload: Partial<ChangelogRecord>): Promise<ChangelogRecord>;
+//# sourceMappingURL=changelog_factory.d.ts.map

package/dist/src/factories/changelog_factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog_factory.d.ts","sourceRoot":"","sources":["../../../src/factories/changelog_factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAKhD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAwCvG"}

package/dist/src/factories/changelog_factory.js

@@ -0,0 +1,46 @@
+import { generateChangelogId } from '../utils/id_generator';
+import { validateChangelogRecordDetailed } from '../validation/changelog_validator';
+import { DetailedValidationError } from '../validation/common';
+/**
+ * Creates a complete ChangelogRecord with validation (Protocol v2)
+ *
+ * @param payload - Partial ChangelogRecord payload
+ * @returns Promise<ChangelogRecord> - The validated ChangelogRecord
+ */
+export async function createChangelogRecord(payload) {
+    const timestamp = Math.floor(Date.now() / 1000);
+    // Generate ID if not provided
+    let id = payload.id;
+    if (!id && payload.entityType && payload.entityId) {
+        id = generateChangelogId(payload.entityType, payload.entityId, timestamp);
+    }
+    const changelog = {
+        // Required fields
+        id: id || '',
+        entityType: payload.entityType || 'task',
+        entityId: payload.entityId || '',
+        changeType: payload.changeType || 'completion',
+        title: payload.title || '',
+        description: payload.description || '',
+        timestamp: payload.timestamp || timestamp,
+        trigger: payload.trigger || 'manual',
+        triggeredBy: payload.triggeredBy || '',
+        reason: payload.reason || '',
+        riskLevel: payload.riskLevel || 'low',
+        // Optional fields (preserve if provided)
+        ...(payload.affectedSystems && { affectedSystems: payload.affectedSystems }),
+        ...(payload.usersAffected !== undefined && { usersAffected: payload.usersAffected }),
+        ...(payload.downtime !== undefined && { downtime: payload.downtime }),
+        ...(payload.files && { files: payload.files }),
+        ...(payload.commits && { commits: payload.commits }),
+        ...(payload.rollbackInstructions && { rollbackInstructions: payload.rollbackInstructions }),
+        ...(payload.references && { references: payload.references })
+    };
+    // Validate the complete changelog record
+    const validation = validateChangelogRecordDetailed(changelog);
+    if (!validation.isValid) {
+        throw new DetailedValidationError('ChangelogRecord', validation.errors);
+    }
+    return changelog;
+}
+//# sourceMappingURL=changelog_factory.js.map

package/dist/src/factories/changelog_factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog_factory.js","sourceRoot":"","sources":["../../../src/factories/changelog_factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAiC;IAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAEhD,8BAA8B;IAC9B,IAAI,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QAClD,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,SAAS,GAAoB;QACjC,kBAAkB;QAClB,EAAE,EAAE,EAAE,IAAI,EAAE;QACZ,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,MAAM;QACxC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,YAAY;QAC9C,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;QACtC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,SAAS;QACzC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,QAAQ;QACpC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;QACtC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;QAErC,yCAAyC;QACzC,GAAG,CAAC,OAAO,CAAC,eAAe,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;QAC5E,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,SAAS,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;QACpF,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrE,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;QAC9C,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QACpD,GAAG,CAAC,OAAO,CAAC,oBAAoB,IAAI,EAAE,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,EAAE,CAAC;QAC3F,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;KAC9D,CAAC;IAEF,yCAAyC;IACzC,MAAM,UAAU,GAAG,+BAA+B,CAAC,SAAS,CAAC,CAAC;IAC9D,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,uBAAuB,CAAC,iBAAiB,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAC1E,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/factories/changelog_factory.test.d.ts

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

package/dist/src/factories/changelog_factory.test.d.ts.map

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