@gitgov/core 1.0.0

package/dist/src/factories/task_factory.js

@@ -0,0 +1,30 @@
+import { validateTaskRecordDetailed } from "../validation/task_validator";
+import { DetailedValidationError } from "../validation/common";
+import { generateTaskId } from "../utils/id_generator";
+/**
+ * Creates a new, fully-formed TaskRecord with validation.
+ */
+export async function createTaskRecord(payload) {
+    // Generate timestamp for ID if not provided
+    const timestamp = Math.floor(Date.now() / 1000);
+    // Build task with defaults for optional fields
+    const task = {
+        id: payload.id || generateTaskId(payload.title || '', timestamp),
+        title: payload.title || '',
+        status: payload.status || 'draft',
+        priority: payload.priority || 'medium',
+        description: payload.description || '',
+        tags: payload.tags || [],
+        cycleIds: payload.cycleIds,
+        references: payload.references,
+        notes: payload.notes,
+        ...payload,
+    };
+    // Use validator to check complete schema with detailed errors
+    const validation = validateTaskRecordDetailed(task);
+    if (!validation.isValid) {
+        throw new DetailedValidationError('TaskRecord', validation.errors);
+    }
+    return task;
+}
+//# sourceMappingURL=task_factory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task_factory.js","sourceRoot":"","sources":["../../../src/factories/task_factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAA4B;IAE5B,4CAA4C;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAEhD,+CAA+C;IAC/C,MAAM,IAAI,GAAe;QACvB,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,cAAc,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,EAAE,SAAS,CAAC;QAChE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,OAAO;QACjC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,QAAQ;QACtC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;QACtC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;QACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,GAAG,OAAO;KACG,CAAC;IAEhB,8DAA8D;IAC9D,MAAM,UAAU,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,uBAAuB,CAAC,YAAY,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

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

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

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

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

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

@@ -0,0 +1,197 @@
+import { createTaskRecord } from './task_factory';
+import { DetailedValidationError } from '../validation/common';
+// Manual mock for validateTaskRecordDetailed
+jest.mock('../validation/task_validator', () => ({
+    validateTaskRecordDetailed: jest.fn()
+        .mockReturnValue({ isValid: true, errors: [] }),
+}));
+describe('createTaskRecord', () => {
+    beforeEach(() => {
+        // Reset mock to default success state before each test
+        const { validateTaskRecordDetailed } = require('../validation/task_validator');
+        validateTaskRecordDetailed.mockReturnValue({ isValid: true, errors: [] });
+    });
+    it('[EARS-2 & EARS-3] should create a valid task record with defaults and a generated ID', async () => {
+        const payload = {
+            title: 'Implement user authentication',
+            description: 'Create a complete user authentication system with JWT tokens',
+            priority: 'high',
+            tags: ['skill:typescript', 'area:backend'],
+        };
+        const task = await createTaskRecord(payload);
+        expect(task.id).toMatch(/^\d{10}-task-implement-user-authentication$/); // ID is generated
+        expect(task.status).toBe('draft'); // Default status
+        expect(task.priority).toBe('high');
+        expect(task.title).toBe('Implement user authentication');
+        expect(task.description).toBe('Create a complete user authentication system with JWT tokens');
+        expect(task.tags).toEqual(['skill:typescript', 'area:backend']);
+    });
+    it('[EARS-1] should throw DetailedValidationError for missing/invalid fields', async () => {
+        const { validateTaskRecordDetailed } = require('../validation/task_validator');
+        validateTaskRecordDetailed.mockReturnValue({
+            isValid: false,
+            errors: [
+                { field: 'title', message: 'must be a non-empty string', value: '' },
+                { field: 'description', message: 'must be at least 10 characters', value: 'short' }
+            ]
+        });
+        const payload = {
+            title: '',
+            description: 'short',
+        };
+        await expect(createTaskRecord(payload)).rejects.toThrow(DetailedValidationError);
+    });
+    it('[EARS-4] should use a provided ID instead of generating one', async () => {
+        const payload = {
+            id: '1752274500-task-custom-task-id',
+            title: 'Custom Task',
+            description: 'A task with a custom ID',
+            priority: 'medium',
+            tags: ['custom'],
+        };
+        const task = await createTaskRecord(payload);
+        expect(task.id).toBe('1752274500-task-custom-task-id');
+    });
+    it('[EARS-5] should throw DetailedValidationError if the created record fails validation', async () => {
+        const { validateTaskRecordDetailed } = require('../validation/task_validator');
+        validateTaskRecordDetailed.mockReturnValue({
+            isValid: false,
+            errors: [
+                { field: 'status', message: 'must be one of: draft, review, ready, active, done, archived, paused, discarded', value: 'invalid-status' }
+            ]
+        });
+        const payload = {
+            title: 'Valid Title',
+            description: 'Valid description that is long enough',
+            status: 'invalid-status',
+        };
+        await expect(createTaskRecord(payload)).rejects.toThrow(DetailedValidationError);
+    });
+    it('[EARS-6] should set default values for optional fields', async () => {
+        const payload = {
+            title: 'Minimal Task',
+            description: 'A task with minimal required fields',
+        };
+        const task = await createTaskRecord(payload);
+        expect(task.status).toBe('draft');
+        expect(task.priority).toBe('medium');
+        expect(task.tags).toEqual([]);
+        expect(task.cycleIds).toBeUndefined();
+        expect(task.references).toBeUndefined();
+        expect(task.notes).toBeUndefined();
+    });
+    it('[EARS-7] should preserve provided optional fields', async () => {
+        const payload = {
+            title: 'Complex Task',
+            description: 'A task with all optional fields provided',
+            cycleIds: ['1752274500-cycle-sprint-1'],
+            references: ['file:packages/core/src/auth.ts', 'url:https://jwt.io'],
+            notes: 'This task requires careful attention to security',
+        };
+        const task = await createTaskRecord(payload);
+        expect(task.cycleIds).toEqual(['1752274500-cycle-sprint-1']);
+        expect(task.references).toEqual(['file:packages/core/src/auth.ts', 'url:https://jwt.io']);
+        expect(task.notes).toBe('This task requires careful attention to security');
+    });
+    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 Task for ID Generation',
+            description: 'Testing timestamp-based ID generation',
+        };
+        const task = await createTaskRecord(payload);
+        const afterTimestamp = Math.floor(Date.now() / 1000);
+        // Extract timestamp from generated ID
+        const idParts = task.id.split('-');
+        const extractedTimestamp = parseInt(idParts[0] || '0');
+        expect(extractedTimestamp).toBeGreaterThanOrEqual(beforeTimestamp);
+        expect(extractedTimestamp).toBeLessThanOrEqual(afterTimestamp);
+        expect(task.id).toMatch(/^\d{10}-task-test-task-for-id-generation$/);
+    });
+    describe('TaskRecord Specific Factory Operations (EARS 15-18)', () => {
+        it('[EARS-15] should throw DetailedValidationError for invalid status', async () => {
+            const { validateTaskRecordDetailed } = require('../validation/task_validator');
+            validateTaskRecordDetailed.mockReturnValue({
+                isValid: false,
+                errors: [
+                    { field: 'status', message: 'must be one of draft, review, ready, active, done, archived', value: 'invalid-status' }
+                ]
+            });
+            const payload = {
+                title: 'Test Task',
+                description: 'Test description for validation',
+                status: 'invalid-status'
+            };
+            await expect(createTaskRecord(payload)).rejects.toThrow(DetailedValidationError);
+            // Restore mock
+            validateTaskRecordDetailed.mockReturnValue({ isValid: true, errors: [] });
+        });
+        it('[EARS-16] should throw DetailedValidationError for invalid priority', async () => {
+            const { validateTaskRecordDetailed } = require('../validation/task_validator');
+            validateTaskRecordDetailed.mockReturnValue({
+                isValid: false,
+                errors: [
+                    { field: 'priority', message: 'must be one of low, medium, high, urgent', value: 'invalid-priority' }
+                ]
+            });
+            const payload = {
+                title: 'Test Task',
+                description: 'Test description for validation',
+                priority: 'invalid-priority'
+            };
+            await expect(createTaskRecord(payload)).rejects.toThrow(DetailedValidationError);
+            // Restore mock
+            validateTaskRecordDetailed.mockReturnValue({ isValid: true, errors: [] });
+        });
+        it('[EARS-17] should apply default empty array for tags when not provided', async () => {
+            const payload = {
+                title: 'Task Without Tags',
+                description: 'Testing default tags behavior'
+                // tags not provided - should default to []
+            };
+            const task = await createTaskRecord(payload);
+            expect(task.tags).toEqual([]); // Default empty array
+        });
+        it('[EARS-18] should throw DetailedValidationError for title shorter than 3 characters', async () => {
+            const { validateTaskRecordDetailed } = require('../validation/task_validator');
+            validateTaskRecordDetailed.mockReturnValue({
+                isValid: false,
+                errors: [
+                    { field: 'title', message: 'must be at least 3 characters', value: 'hi' }
+                ]
+            });
+            const payload = {
+                title: 'hi', // Too short
+                description: 'Test description for validation'
+            };
+            await expect(createTaskRecord(payload)).rejects.toThrow(DetailedValidationError);
+            // Restore mock
+            validateTaskRecordDetailed.mockReturnValue({ isValid: true, errors: [] });
+        });
+        it('[EARS-15] should accept valid status values', async () => {
+            const validStatuses = ['draft', 'review', 'ready', 'active', 'done', 'archived'];
+            for (const status of validStatuses) {
+                const payload = {
+                    title: `Test Task ${status}`,
+                    description: 'Test description for status validation',
+                    status: status
+                };
+                const task = await createTaskRecord(payload);
+                expect(task.status).toBe(status);
+            }
+        });
+        it('[EARS-16] should accept valid priority values', async () => {
+            const validPriorities = ['low', 'medium', 'high', 'urgent'];
+            for (const priority of validPriorities) {
+                const payload = {
+                    title: `Test Task ${priority}`,
+                    description: 'Test description for priority validation',
+                    priority: priority
+                };
+                const task = await createTaskRecord(payload);
+                expect(task.priority).toBe(priority);
+            }
+        });
+    });
+});
+//# sourceMappingURL=task_factory.test.js.map

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

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

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

@@ -0,0 +1,11 @@
+import type { WorkflowMethodologyRecord } from "../types";
+/**
+ * Creates a new, fully-formed WorkflowMethodologyConfig with validation.
+ * Follows the same pattern as createTaskRecord, createActorRecord, etc.
+ */
+export declare function createWorkflowMethodologyConfig(payload: Partial<WorkflowMethodologyRecord>): Promise<WorkflowMethodologyRecord>;
+/**
+ * Creates a default GitGovernance workflow methodology configuration
+ */
+export declare function createDefaultWorkflowMethodologyConfig(): Promise<WorkflowMethodologyRecord>;
+//# sourceMappingURL=workflow_methodology_factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow_methodology_factory.d.ts","sourceRoot":"","sources":["../../../src/factories/workflow_methodology_factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAO1D;;;GAGG;AACH,wBAAsB,+BAA+B,CACnD,OAAO,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAC1C,OAAO,CAAC,yBAAyB,CAAC,CAkDpC;AAED;;GAEG;AACH,wBAAsB,sCAAsC,IAAI,OAAO,CAAC,yBAAyB,CAAC,CAmHjG"}

package/dist/src/factories/workflow_methodology_factory.js

@@ -0,0 +1,173 @@
+import { validateWorkflowMethodologyConfigDetailed, validateWorkflowMethodologyConfigBusinessRules } from "../validation/workflow_methodology_validator";
+import { DetailedValidationError } from "../validation/common";
+/**
+ * Creates a new, fully-formed WorkflowMethodologyConfig with validation.
+ * Follows the same pattern as createTaskRecord, createActorRecord, etc.
+ */
+export async function createWorkflowMethodologyConfig(payload) {
+    // Build config with defaults for optional fields
+    const config = {
+        version: payload.version || '1.0.0',
+        name: payload.name || 'Custom Methodology',
+        description: payload.description,
+        state_transitions: payload.state_transitions || {
+            review: {
+                from: ['draft'],
+                requires: {
+                    command: 'gitgov task submit',
+                    signatures: {
+                        '__default__': {
+                            role: 'submitter',
+                            capability_roles: ['author'],
+                            min_approvals: 1
+                        }
+                    }
+                }
+            }
+        },
+        custom_rules: payload.custom_rules,
+        view_configs: payload.view_configs || {
+            'kanban-4col': {
+                columns: {
+                    'Draft': ['draft'],
+                    'In Progress': ['review', 'ready', 'active'],
+                    'Done': ['done', 'archived']
+                },
+                theme: 'minimal',
+                layout: 'horizontal'
+            }
+        },
+        ...payload,
+    };
+    // Use validator to check schema compliance with detailed errors
+    const schemaValidation = validateWorkflowMethodologyConfigDetailed(config);
+    if (!schemaValidation.isValid) {
+        throw new DetailedValidationError('WorkflowMethodologyConfig', schemaValidation.errors);
+    }
+    // Use business rules validator for additional validation
+    const businessRulesValidation = validateWorkflowMethodologyConfigBusinessRules(config);
+    if (!businessRulesValidation.isValid) {
+        throw new DetailedValidationError('WorkflowMethodologyConfig (Business Rules)', businessRulesValidation.errors);
+    }
+    return config;
+}
+/**
+ * Creates a default GitGovernance workflow methodology configuration
+ */
+export async function createDefaultWorkflowMethodologyConfig() {
+    return createWorkflowMethodologyConfig({
+        version: '1.0.0',
+        name: 'GitGovernance Default Methodology',
+        description: 'Standard GitGovernance workflow with quality gates and agent collaboration',
+        state_transitions: {
+            review: {
+                from: ['draft'],
+                requires: {
+                    command: 'gitgov task submit',
+                    signatures: {
+                        '__default__': {
+                            role: 'submitter',
+                            capability_roles: ['author'],
+                            min_approvals: 1
+                        }
+                    }
+                }
+            },
+            ready: {
+                from: ['review'],
+                requires: {
+                    command: 'gitgov task approve',
+                    signatures: {
+                        '__default__': {
+                            role: 'approver',
+                            capability_roles: ['approver:product'],
+                            min_approvals: 1
+                        },
+                        'design': {
+                            role: 'approver',
+                            capability_roles: ['approver:design'],
+                            min_approvals: 1
+                        },
+                        'quality': {
+                            role: 'approver',
+                            capability_roles: ['approver:quality'],
+                            min_approvals: 1
+                        }
+                    }
+                }
+            },
+            active: {
+                from: ['ready'],
+                requires: {
+                    event: 'first_execution_record_created',
+                    custom_rules: ['task_must_have_valid_assignment_for_executor']
+                }
+            },
+            done: {
+                from: ['active'],
+                requires: {
+                    command: 'gitgov task complete',
+                    signatures: {
+                        '__default__': {
+                            role: 'approver',
+                            capability_roles: ['approver:quality'],
+                            min_approvals: 1
+                        }
+                    }
+                }
+            },
+            archived: {
+                from: ['done'],
+                requires: {
+                    event: 'changelog_record_created'
+                }
+            },
+            paused: {
+                from: ['active', 'review'],
+                requires: {
+                    event: 'feedback_blocking_created'
+                }
+            }
+        },
+        custom_rules: {
+            'task_must_have_valid_assignment_for_executor': {
+                description: 'Task must have a valid assignment before execution can begin',
+                validation: 'assignment_required'
+            },
+            'task_must_be_in_active_sprint': {
+                description: 'Task must belong to an active sprint cycle',
+                validation: 'sprint_capacity'
+            },
+            'epic_promotion_required': {
+                description: 'Complex tasks must be promoted to epic with child cycles',
+                validation: 'epic_complexity'
+            }
+        },
+        view_configs: {
+            'kanban-4col': {
+                columns: {
+                    'Draft': ['draft'],
+                    'In Progress': ['review', 'ready', 'active'],
+                    'Review': ['done'],
+                    'Done': ['archived']
+                },
+                theme: 'minimal',
+                layout: 'horizontal'
+            },
+            'kanban-7col': {
+                columns: {
+                    'Draft': ['draft'],
+                    'Review': ['review'],
+                    'Ready': ['ready'],
+                    'Active': ['active'],
+                    'Done': ['done'],
+                    'Archived': ['archived'],
+                    'Blocked': ['paused']
+                },
+                theme: 'corporate',
+                layout: 'vertical'
+            }
+        }
+    });
+}
+//# sourceMappingURL=workflow_methodology_factory.js.map

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

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

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

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

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

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