@gitgov/core 1.0.0

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

@@ -0,0 +1,368 @@
+import { createChangelogRecord } from './changelog_factory';
+import { generateChangelogId } from '../utils/id_generator';
+import { DetailedValidationError } from '../validation/common';
+// Mock the validator
+jest.mock('../validation/changelog_validator', () => ({
+    validateChangelogRecordDetailed: jest.fn()
+}));
+// Mock ID generator
+jest.mock('../utils/id_generator', () => ({
+    generateChangelogId: jest.fn()
+}));
+describe('ChangelogRecord Factory', () => {
+    const mockValidateChangelogRecordDetailed = require('../validation/changelog_validator').validateChangelogRecordDetailed;
+    const mockGenerateChangelogId = generateChangelogId;
+    beforeEach(() => {
+        jest.clearAllMocks();
+        // Default successful validation
+        mockValidateChangelogRecordDetailed.mockReturnValue({
+            isValid: true,
+            errors: []
+        });
+        // Default ID generation
+        mockGenerateChangelogId.mockReturnValue('1752707800-changelog-task-test-task');
+    });
+    describe('createChangelogRecord', () => {
+        it('[EARS-1] should create a valid ChangelogRecord with all required fields', async () => {
+            const payload = {
+                entityType: 'task',
+                entityId: '1752274500-task-test-task',
+                changeType: 'completion',
+                title: 'Test Task Completion',
+                description: 'Successfully completed the test task with all requirements',
+                triggeredBy: 'human:developer',
+                reason: 'All acceptance criteria met and code review passed',
+                files: ['src/test.ts', 'docs/test.md'],
+                commits: ['abc123', 'def456']
+            };
+            const result = await createChangelogRecord(payload);
+            expect(result).toEqual({
+                id: '1752707800-changelog-task-test-task',
+                entityType: 'task',
+                entityId: '1752274500-task-test-task',
+                changeType: 'completion',
+                title: 'Test Task Completion',
+                description: 'Successfully completed the test task with all requirements',
+                timestamp: expect.any(Number),
+                trigger: 'manual',
+                triggeredBy: 'human:developer',
+                reason: 'All acceptance criteria met and code review passed',
+                riskLevel: 'low',
+                files: ['src/test.ts', 'docs/test.md'],
+                commits: ['abc123', 'def456']
+            });
+            expect(mockValidateChangelogRecordDetailed).toHaveBeenCalledWith(result);
+        });
+        it('[EARS-2] should apply default values for missing optional fields', async () => {
+            const payload = {
+                entityType: 'task',
+                entityId: '1752274500-task-test-task',
+                title: 'Test Task Completion',
+                description: 'Successfully completed the test task',
+                triggeredBy: 'human:developer',
+                reason: 'Task completed successfully'
+            };
+            const result = await createChangelogRecord(payload);
+            expect(result).toEqual({
+                id: '1752707800-changelog-task-test-task',
+                entityType: 'task',
+                entityId: '1752274500-task-test-task',
+                changeType: 'completion',
+                title: 'Test Task Completion',
+                description: 'Successfully completed the test task',
+                timestamp: expect.any(Number),
+                trigger: 'manual',
+                triggeredBy: 'human:developer',
+                reason: 'Task completed successfully',
+                riskLevel: 'low'
+            });
+            expect(mockGenerateChangelogId).toHaveBeenCalledWith('task', '1752274500-task-test-task', expect.any(Number));
+        });
+        it('[EARS-3] should preserve provided ID when specified', async () => {
+            const payload = {
+                id: '1752707900-changelog-task-custom-id',
+                entityType: 'task',
+                entityId: '1752274500-task-test-task',
+                changeType: 'completion',
+                title: 'Custom ID Test',
+                description: 'Successfully completed the test task',
+                triggeredBy: 'human:developer',
+                reason: 'Custom test case'
+            };
+            const result = await createChangelogRecord(payload);
+            expect(result.id).toBe('1752707900-changelog-task-custom-id');
+            expect(mockGenerateChangelogId).not.toHaveBeenCalled();
+        });
+        it('[EARS-4] should generate ID from entityType and entityId when ID is not provided', async () => {
+            const payload = {
+                entityType: 'task',
+                entityId: '1752274500-task-implement-auth',
+                changeType: 'completion',
+                title: 'Authentication Implementation Completed',
+                description: 'Authentication system implemented successfully',
+                triggeredBy: 'human:developer',
+                reason: 'All auth requirements completed'
+            };
+            mockGenerateChangelogId.mockReturnValue('1752707800-changelog-task-implement-auth');
+            const result = await createChangelogRecord(payload);
+            expect(result.id).toBe('1752707800-changelog-task-implement-auth');
+            expect(mockGenerateChangelogId).toHaveBeenCalledWith('task', '1752274500-task-implement-auth', expect.any(Number));
+        });
+        it('[EARS-5] should throw DetailedValidationError when validation fails', async () => {
+            const payload = {
+                entityType: 'task',
+                entityId: 'invalid-entity-id',
+                changeType: 'completion',
+                title: 'Test',
+                description: 'Test description',
+                triggeredBy: 'human:developer',
+                reason: 'Test reason'
+            };
+            const validationErrors = [
+                { field: 'entityId', message: 'must match pattern', value: payload.entityId }
+            ];
+            mockValidateChangelogRecordDetailed.mockReturnValue({
+                isValid: false,
+                errors: validationErrors
+            });
+            await expect(createChangelogRecord(payload)).rejects.toThrow(DetailedValidationError);
+            await expect(createChangelogRecord(payload)).rejects.toThrow('ChangelogRecord');
+        });
+        it('[EARS-6] should preserve all provided fields in the output', async () => {
+            const payload = {
+                id: '1752707900-changelog-task-preserve-fields',
+                entityType: 'task',
+                entityId: '1752274500-task-test-task',
+                changeType: 'update',
+                title: 'Task Update',
+                description: 'Updating task configuration',
+                timestamp: 1752707900,
+                trigger: 'automated',
+                triggeredBy: 'agent:system',
+                reason: 'Automated update process',
+                riskLevel: 'medium',
+                files: ['src/updated.ts'],
+                commits: ['xyz789'],
+                usersAffected: 10
+            };
+            const result = await createChangelogRecord(payload);
+            expect(result).toEqual(payload);
+            expect(mockValidateChangelogRecordDetailed).toHaveBeenCalledWith(payload);
+        });
+        it('[EARS-7] should handle empty files array', async () => {
+            const payload = {
+                entityType: 'task',
+                entityId: '1752274500-task-test-task',
+                changeType: 'completion',
+                title: 'Test Task Completion',
+                description: 'Successfully completed the test task',
+                triggeredBy: 'human:developer',
+                reason: 'Task completed',
+                files: []
+            };
+            const result = await createChangelogRecord(payload);
+            expect(result.files).toEqual([]);
+        });
+        it('[EARS-8] should use current timestamp when none provided', async () => {
+            const payload = {
+                entityType: 'task',
+                entityId: '1752274500-task-test-task',
+                changeType: 'completion',
+                title: 'Timestamp Test',
+                description: 'Testing timestamp generation',
+                triggeredBy: 'human:developer',
+                reason: 'Testing timestamp functionality'
+            };
+            const beforeTime = Math.floor(Date.now() / 1000);
+            await createChangelogRecord(payload);
+            const afterTime = Math.floor(Date.now() / 1000);
+            expect(mockGenerateChangelogId).toHaveBeenCalledWith('task', '1752274500-task-test-task', expect.any(Number));
+            const calledTimestamp = mockGenerateChangelogId.mock.calls[0][2];
+            expect(calledTimestamp).toBeGreaterThanOrEqual(beforeTime);
+            expect(calledTimestamp).toBeLessThanOrEqual(afterTime);
+        });
+        describe('ChangelogRecord Specific Factory Operations (EARS 29-37)', () => {
+            it('[EARS-29] should generate ID with timestamp-changelog-entityType-slug format', async () => {
+                const payload = {
+                    entityType: 'task',
+                    entityId: '1752274500-task-implement-feature',
+                    changeType: 'completion',
+                    title: 'Feature Implementation Completed',
+                    description: 'Successfully implemented the requested feature',
+                    triggeredBy: 'human:developer',
+                    reason: 'All requirements completed'
+                };
+                mockGenerateChangelogId.mockReturnValue('1752707800-changelog-task-implement-feature');
+                const result = await createChangelogRecord(payload);
+                expect(result.id).toBe('1752707800-changelog-task-implement-feature');
+                expect(mockGenerateChangelogId).toHaveBeenCalledWith('task', '1752274500-task-implement-feature', expect.any(Number));
+            });
+            it('[EARS-30] should use entityId directly for system entities', async () => {
+                const payload = {
+                    entityType: 'system',
+                    entityId: 'payment-gateway',
+                    changeType: 'hotfix',
+                    title: 'Payment Gateway Hotfix',
+                    description: 'Fixed critical payment processing issue',
+                    triggeredBy: 'human:on-call',
+                    reason: 'Critical production issue'
+                };
+                mockGenerateChangelogId.mockReturnValue('1752707800-changelog-system-payment-gateway');
+                const result = await createChangelogRecord(payload);
+                expect(result.id).toBe('1752707800-changelog-system-payment-gateway');
+                expect(mockGenerateChangelogId).toHaveBeenCalledWith('system', 'payment-gateway', expect.any(Number));
+            });
+            it('[EARS-31] should use entityId directly for configuration entities', async () => {
+                const payload = {
+                    entityType: 'configuration',
+                    entityId: 'database-config',
+                    changeType: 'update',
+                    title: 'Database Configuration Update',
+                    description: 'Updated connection pool settings',
+                    triggeredBy: 'human:devops',
+                    reason: 'Performance optimization'
+                };
+                mockGenerateChangelogId.mockReturnValue('1752707800-changelog-configuration-database-config');
+                const result = await createChangelogRecord(payload);
+                expect(result.id).toBe('1752707800-changelog-configuration-database-config');
+                expect(mockGenerateChangelogId).toHaveBeenCalledWith('configuration', 'database-config', expect.any(Number));
+            });
+            it('[EARS-32] should extract slug from timestamped entityId for task/cycle/agent', async () => {
+                const testCases = [
+                    { entityType: 'task', entityId: '1752274500-task-implement-auth', expectedSlug: 'implement-auth' },
+                    { entityType: 'cycle', entityId: '1752300000-cycle-sprint-q4', expectedSlug: 'sprint-q4' },
+                    { entityType: 'agent', entityId: 'agent:cursor-assistant', expectedSlug: 'cursor-assistant' }
+                ];
+                for (const testCase of testCases) {
+                    const payload = {
+                        entityType: testCase.entityType,
+                        entityId: testCase.entityId,
+                        changeType: 'update',
+                        title: `${testCase.entityType} Update`,
+                        description: `Updated ${testCase.entityType}`,
+                        triggeredBy: 'human:developer',
+                        reason: 'Regular update'
+                    };
+                    mockGenerateChangelogId.mockReturnValue(`1752707800-changelog-${testCase.entityType}-${testCase.expectedSlug}`);
+                    const result = await createChangelogRecord(payload);
+                    expect(result.id).toBe(`1752707800-changelog-${testCase.entityType}-${testCase.expectedSlug}`);
+                    expect(mockGenerateChangelogId).toHaveBeenCalledWith(testCase.entityType, testCase.entityId, expect.any(Number));
+                }
+            });
+            it('[EARS-33] should apply sensible defaults for required fields', async () => {
+                const payload = {
+                    entityType: 'task',
+                    entityId: '1752274500-task-test-task',
+                    title: 'Test Changelog',
+                    description: 'Testing default values application',
+                    triggeredBy: 'human:developer',
+                    reason: 'Testing defaults'
+                };
+                const result = await createChangelogRecord(payload);
+                expect(result.changeType).toBe('completion'); // Default
+                expect(result.trigger).toBe('manual'); // Default
+                expect(result.riskLevel).toBe('low'); // Default
+                expect(result.timestamp).toEqual(expect.any(Number)); // Generated timestamp
+            });
+            it('[EARS-34] should preserve all provided optional fields', async () => {
+                const payload = {
+                    entityType: 'task',
+                    entityId: '1752274500-task-test-task',
+                    changeType: 'hotfix',
+                    title: 'Critical Hotfix',
+                    description: 'Emergency fix for production issue',
+                    timestamp: 1752707900,
+                    trigger: 'emergency',
+                    triggeredBy: 'human:on-call',
+                    reason: 'Production down',
+                    riskLevel: 'critical',
+                    affectedSystems: ['api-gateway', 'auth-service'],
+                    usersAffected: 1000,
+                    downtime: 300,
+                    files: ['src/auth.ts', 'src/gateway.ts'],
+                    commits: ['abc123', 'def456'],
+                    rollbackInstructions: 'Revert commits and restart services',
+                    references: {
+                        tasks: ['1752274500-task-test-task'],
+                        executions: ['1752707800-exec-hotfix']
+                    }
+                };
+                const result = await createChangelogRecord(payload);
+                // All optional fields should be preserved exactly
+                expect(result.affectedSystems).toEqual(['api-gateway', 'auth-service']);
+                expect(result.usersAffected).toBe(1000);
+                expect(result.downtime).toBe(300);
+                expect(result.files).toEqual(['src/auth.ts', 'src/gateway.ts']);
+                expect(result.commits).toEqual(['abc123', 'def456']);
+                expect(result.rollbackInstructions).toBe('Revert commits and restart services');
+                expect(result.references).toEqual({
+                    tasks: ['1752274500-task-test-task'],
+                    executions: ['1752707800-exec-hotfix']
+                });
+            });
+            it('[EARS-35] should throw DetailedValidationError for high riskLevel without rollbackInstructions', async () => {
+                const validationErrors = [
+                    { field: 'root', message: 'rollbackInstructions is required when riskLevel is high', value: { riskLevel: 'high' } }
+                ];
+                mockValidateChangelogRecordDetailed.mockReturnValue({
+                    isValid: false,
+                    errors: validationErrors
+                });
+                const payload = {
+                    entityType: 'task',
+                    entityId: '1752274500-task-test-task',
+                    changeType: 'update',
+                    title: 'High Risk Update',
+                    description: 'Major system update with high risk',
+                    triggeredBy: 'human:developer',
+                    reason: 'System upgrade',
+                    riskLevel: 'high'
+                    // rollbackInstructions missing
+                };
+                await expect(createChangelogRecord(payload)).rejects.toThrow(DetailedValidationError);
+            });
+            it('[EARS-36] should throw DetailedValidationError for critical riskLevel without rollbackInstructions', async () => {
+                const validationErrors = [
+                    { field: 'root', message: 'rollbackInstructions is required when riskLevel is critical', value: { riskLevel: 'critical' } }
+                ];
+                mockValidateChangelogRecordDetailed.mockReturnValue({
+                    isValid: false,
+                    errors: validationErrors
+                });
+                const payload = {
+                    entityType: 'system',
+                    entityId: 'payment-gateway',
+                    changeType: 'hotfix',
+                    title: 'Critical System Fix',
+                    description: 'Emergency fix for critical system failure',
+                    triggeredBy: 'human:on-call',
+                    reason: 'System down',
+                    riskLevel: 'critical'
+                    // rollbackInstructions missing
+                };
+                await expect(createChangelogRecord(payload)).rejects.toThrow(DetailedValidationError);
+            });
+            it('[EARS-37] should throw DetailedValidationError for completion changeType without references.tasks', async () => {
+                const validationErrors = [
+                    { field: 'root', message: 'references.tasks is required when changeType is completion', value: { changeType: 'completion' } }
+                ];
+                mockValidateChangelogRecordDetailed.mockReturnValue({
+                    isValid: false,
+                    errors: validationErrors
+                });
+                const payload = {
+                    entityType: 'task',
+                    entityId: '1752274500-task-test-task',
+                    changeType: 'completion',
+                    title: 'Task Completion',
+                    description: 'Task has been completed',
+                    triggeredBy: 'human:developer',
+                    reason: 'All work finished'
+                    // references.tasks missing for completion
+                };
+                await expect(createChangelogRecord(payload)).rejects.toThrow(DetailedValidationError);
+            });
+        });
+    });
+});
+//# sourceMappingURL=changelog_factory.test.js.map

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

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

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

@@ -0,0 +1,6 @@
+import type { CycleRecord } from "../types";
+/**
+ * Creates a new, fully-formed CycleRecord with validation.
+ */
+export declare function createCycleRecord(payload: Partial<CycleRecord>): Promise<CycleRecord>;
+//# sourceMappingURL=cycle_factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cycle_factory.d.ts","sourceRoot":"","sources":["../../../src/factories/cycle_factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAK5C;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAC5B,OAAO,CAAC,WAAW,CAAC,CAuBtB"}

package/dist/src/factories/cycle_factory.js

@@ -0,0 +1,28 @@
+import { validateCycleRecordDetailed } from "../validation/cycle_validator";
+import { DetailedValidationError } from "../validation/common";
+import { generateCycleId } from "../utils/id_generator";
+/**
+ * Creates a new, fully-formed CycleRecord with validation.
+ */
+export async function createCycleRecord(payload) {
+    // Generate timestamp for ID if not provided
+    const timestamp = Math.floor(Date.now() / 1000);
+    // Build cycle with defaults for optional fields
+    const cycle = {
+        id: payload.id || generateCycleId(payload.title || '', timestamp),
+        title: payload.title || '',
+        status: payload.status || 'planning',
+        taskIds: payload.taskIds || [], // EARS-21: Default empty array
+        childCycleIds: payload.childCycleIds,
+        tags: payload.tags,
+        notes: payload.notes,
+        ...payload,
+    };
+    // Use validator to check complete schema with detailed errors
+    const validation = validateCycleRecordDetailed(cycle);
+    if (!validation.isValid) {
+        throw new DetailedValidationError('CycleRecord', validation.errors);
+    }
+    return cycle;
+}
+//# sourceMappingURL=cycle_factory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cycle_factory.js","sourceRoot":"","sources":["../../../src/factories/cycle_factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAA6B;IAE7B,4CAA4C;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAEhD,gDAAgD;IAChD,MAAM,KAAK,GAAgB;QACzB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,eAAe,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,SAAS,CAAC;QACjE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,UAAU;QACpC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,EAAE,+BAA+B;QAC/D,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,OAAO;KACI,CAAC;IAEjB,8DAA8D;IAC9D,MAAM,UAAU,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,uBAAuB,CAAC,aAAa,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

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

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

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

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

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

@@ -0,0 +1,175 @@
+import { createCycleRecord } from './cycle_factory';
+import { DetailedValidationError } from '../validation/common';
+// Manual mock for validateCycleRecordDetailed
+jest.mock('../validation/cycle_validator', () => ({
+    validateCycleRecordDetailed: jest.fn()
+        .mockReturnValue({ isValid: true, errors: [] }),
+}));
+describe('createCycleRecord', () => {
+    beforeEach(() => {
+        // Reset mock to default success state before each test
+        const { validateCycleRecordDetailed } = require('../validation/cycle_validator');
+        validateCycleRecordDetailed.mockReturnValue({ isValid: true, errors: [] });
+    });
+    it('[EARS-2 & EARS-3] should create a valid cycle record with defaults and a generated ID', async () => {
+        const payload = {
+            title: 'Sprint Q4 API Performance',
+            taskIds: ['1752274500-task-optimizar-endpoint', '1752360900-task-cache-redis'],
+            tags: ['roadmap:q4', 'team:backend'],
+        };
+        const cycle = await createCycleRecord(payload);
+        expect(cycle.id).toMatch(/^\d{10}-cycle-sprint-q4-api-performance$/); // ID is generated
+        expect(cycle.status).toBe('planning'); // Default status
+        expect(cycle.title).toBe('Sprint Q4 API Performance');
+        expect(cycle.taskIds).toEqual(['1752274500-task-optimizar-endpoint', '1752360900-task-cache-redis']);
+        expect(cycle.tags).toEqual(['roadmap:q4', 'team:backend']);
+    });
+    it('[EARS-1] should throw DetailedValidationError for missing/invalid fields', async () => {
+        const { validateCycleRecordDetailed } = require('../validation/cycle_validator');
+        validateCycleRecordDetailed.mockReturnValue({
+            isValid: false,
+            errors: [
+                { field: 'title', message: 'must be a non-empty string', value: '' },
+                { field: 'status', message: 'must be one of: planning, active, completed, archived', value: 'invalid' }
+            ]
+        });
+        const payload = {
+            title: '',
+            status: 'invalid',
+        };
+        await expect(createCycleRecord(payload)).rejects.toThrow(DetailedValidationError);
+    });
+    it('[EARS-4] should use a provided ID instead of generating one', async () => {
+        const payload = {
+            id: '1754400000-cycle-custom-cycle-id',
+            title: 'Custom Cycle',
+            status: 'active',
+            tags: ['custom'],
+        };
+        const cycle = await createCycleRecord(payload);
+        expect(cycle.id).toBe('1754400000-cycle-custom-cycle-id');
+    });
+    it('[EARS-5] should throw DetailedValidationError if the created record fails validation', async () => {
+        const { validateCycleRecordDetailed } = require('../validation/cycle_validator');
+        validateCycleRecordDetailed.mockReturnValue({
+            isValid: false,
+            errors: [
+                { field: 'taskIds', message: 'items must match pattern', value: ['invalid-task-id'] }
+            ]
+        });
+        const payload = {
+            title: 'Valid Title',
+            status: 'active',
+            taskIds: ['invalid-task-id'],
+        };
+        await expect(createCycleRecord(payload)).rejects.toThrow(DetailedValidationError);
+    });
+    it('[EARS-6] should set default values for optional fields', async () => {
+        const payload = {
+            title: 'Minimal Cycle',
+        };
+        const cycle = await createCycleRecord(payload);
+        expect(cycle.status).toBe('planning');
+        expect(cycle.taskIds).toEqual([]); // EARS-21: Default empty array
+        expect(cycle.childCycleIds).toBeUndefined();
+        expect(cycle.tags).toBeUndefined();
+        expect(cycle.notes).toBeUndefined();
+    });
+    it('[EARS-7] should preserve provided optional fields', async () => {
+        const payload = {
+            title: 'Complex Cycle',
+            status: 'active',
+            taskIds: ['1752274500-task-task1', '1752360900-task-task2'],
+            childCycleIds: ['1754500000-cycle-child1'],
+            tags: ['roadmap:q4', 'team:backend'],
+            notes: 'This cycle requires careful coordination between teams'
+        };
+        const cycle = await createCycleRecord(payload);
+        expect(cycle.status).toBe('active');
+        expect(cycle.taskIds).toEqual(['1752274500-task-task1', '1752360900-task-task2']);
+        expect(cycle.childCycleIds).toEqual(['1754500000-cycle-child1']);
+        expect(cycle.tags).toEqual(['roadmap:q4', 'team:backend']);
+        expect(cycle.notes).toBe('This cycle requires careful coordination between teams');
+    });
+    it('[EARS-8] should generate ID with current timestamp when title is provided', async () => {
+        const beforeTimestamp = Math.floor(Date.now() / 1000);
+        const payload = {
+            title: 'Test Cycle for ID Generation',
+        };
+        const cycle = await createCycleRecord(payload);
+        const afterTimestamp = Math.floor(Date.now() / 1000);
+        // Extract timestamp from generated ID
+        const idParts = cycle.id.split('-');
+        const extractedTimestamp = parseInt(idParts[0] || '0');
+        expect(extractedTimestamp).toBeGreaterThanOrEqual(beforeTimestamp);
+        expect(extractedTimestamp).toBeLessThanOrEqual(afterTimestamp);
+        expect(cycle.id).toMatch(/^\d{10}-cycle-test-cycle-for-id-generation$/);
+    });
+    describe('CycleRecord Specific Factory Operations (EARS 19-21)', () => {
+        it('[EARS-19] should throw DetailedValidationError for invalid status', async () => {
+            const { validateCycleRecordDetailed } = require('../validation/cycle_validator');
+            validateCycleRecordDetailed.mockReturnValue({
+                isValid: false,
+                errors: [
+                    { field: 'status', message: 'must be one of planning, active, completed, archived', value: 'invalid-status' }
+                ]
+            });
+            const payload = {
+                title: 'Test Cycle',
+                status: 'invalid-status'
+            };
+            await expect(createCycleRecord(payload)).rejects.toThrow(DetailedValidationError);
+            // Restore mock
+            validateCycleRecordDetailed.mockReturnValue({ isValid: true, errors: [] });
+        });
+        it('[EARS-20] should throw DetailedValidationError for invalid taskIds pattern', async () => {
+            const { validateCycleRecordDetailed } = require('../validation/cycle_validator');
+            validateCycleRecordDetailed.mockReturnValue({
+                isValid: false,
+                errors: [
+                    { field: 'taskIds', message: 'items must match task ID pattern', value: ['invalid-task-id', '1752274500-task-valid'] }
+                ]
+            });
+            const payload = {
+                title: 'Test Cycle',
+                taskIds: ['invalid-task-id', '1752274500-task-valid']
+            };
+            await expect(createCycleRecord(payload)).rejects.toThrow(DetailedValidationError);
+            // Restore mock
+            validateCycleRecordDetailed.mockReturnValue({ isValid: true, errors: [] });
+        });
+        it('[EARS-21] should apply default empty array for taskIds when not provided', async () => {
+            const payload = {
+                title: 'Cycle Without Tasks'
+                // taskIds not provided - should default to []
+            };
+            const cycle = await createCycleRecord(payload);
+            expect(cycle.taskIds).toEqual([]); // Default empty array
+        });
+        it('[EARS-19] should accept valid status values', async () => {
+            const validStatuses = ['planning', 'active', 'completed', 'archived'];
+            for (const status of validStatuses) {
+                const payload = {
+                    title: `Test Cycle ${status}`,
+                    status: status
+                };
+                const cycle = await createCycleRecord(payload);
+                expect(cycle.status).toBe(status);
+            }
+        });
+        it('[EARS-20] should accept valid taskIds with correct pattern', async () => {
+            const validTaskIds = [
+                '1752274500-task-implement-feature',
+                '1752360900-task-write-tests',
+                '1752400000-task-deploy-service'
+            ];
+            const payload = {
+                title: 'Cycle With Valid Tasks',
+                taskIds: validTaskIds
+            };
+            const cycle = await createCycleRecord(payload);
+            expect(cycle.taskIds).toEqual(validTaskIds);
+        });
+    });
+});
+//# sourceMappingURL=cycle_factory.test.js.map

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

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

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

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