@gitgov/core 1.0.0

package/dist/src/schemas/schema_cache.js

@@ -0,0 +1,109 @@
+import Ajv from "ajv";
+import addFormats from "ajv-formats";
+import * as fs from "fs";
+import * as yaml from "js-yaml";
+// Direct import from generated schemas
+import { Schemas } from "./generated";
+/**
+ * Singleton cache for schema validators to avoid repeated I/O and AJV compilation.
+ * Improves performance by caching compiled validators for schema files.
+ */
+export class SchemaValidationCache {
+    static validators = new Map();
+    static schemaValidators = new Map();
+    static ajv = null;
+    /**
+     * Gets or creates a cached validator for the specified schema path.
+     * @param schemaPath Absolute path to the YAML schema file
+     * @returns Compiled AJV validator function
+     */
+    static getValidator(schemaPath) {
+        if (!this.validators.has(schemaPath)) {
+            // Initialize AJV instance if not already done
+            if (!this.ajv) {
+                this.ajv = new Ajv({ allErrors: true });
+                addFormats(this.ajv);
+            }
+            // Load and compile schema
+            const schemaContent = fs.readFileSync(schemaPath, "utf8");
+            const schema = yaml.load(schemaContent);
+            const validator = this.ajv.compile(schema);
+            this.validators.set(schemaPath, validator);
+        }
+        return this.validators.get(schemaPath);
+    }
+    /**
+     * Gets or creates a cached validator for a schema object.
+     * @param schema The schema object (already parsed YAML/JSON)
+     * @returns Compiled AJV validator function
+     */
+    static getValidatorFromSchema(schema) {
+        // Create a stable key from the schema object
+        const schemaKey = JSON.stringify(schema);
+        if (!this.schemaValidators.has(schemaKey)) {
+            // Initialize AJV instance if not already done
+            if (!this.ajv) {
+                this.ajv = new Ajv({ allErrors: true });
+                addFormats(this.ajv);
+                // Pre-load all schemas for reference resolution
+                this.preloadSchemas();
+            }
+            // Remove $id temporarily to avoid conflicts with preloaded schemas
+            // (This doesn't modify the original schema object)
+            const { $id, ...schemaWithoutId } = schema;
+            // Compile schema directly - AJV will resolve $ref using preloaded aliases
+            const validator = this.ajv.compile(schemaWithoutId);
+            this.schemaValidators.set(schemaKey, validator);
+        }
+        return this.schemaValidators.get(schemaKey);
+    }
+    /**
+     * Pre-loads referenced schema files for $ref resolution.
+     * Uses direct imports and dynamic iteration.
+     */
+    static preloadSchemas() {
+        if (!this.ajv)
+            return;
+        try {
+            // Map schema names to their expected ref aliases
+            const schemaRefMap = {
+                'ActorRecord': 'ref:actor_record_schema',
+                'AgentRecord': 'ref:agent_record_schema',
+                'ChangelogRecord': 'ref:changelog_record_schema',
+                'CycleRecord': 'ref:cycle_record_schema',
+                'ExecutionRecord': 'ref:execution_record_schema',
+                'FeedbackRecord': 'ref:feedback_record_schema',
+                'TaskRecord': 'ref:task_record_schema',
+                'WorkflowMethodologyRecord': 'ref:workflow_methodology_record_schema'
+            };
+            // Register schemas with correct aliases
+            Object.entries(Schemas).forEach(([name, schema]) => {
+                if (name !== 'EmbeddedMetadata' && schemaRefMap[name]) {
+                    const refName = schemaRefMap[name];
+                    this.ajv.addSchema(schema, refName);
+                }
+            });
+        }
+        catch {
+            // If preloading fails, continue without it
+        }
+    }
+    /**
+     * Clears the cache (useful for testing or schema updates).
+     */
+    static clearCache() {
+        this.validators.clear();
+        this.schemaValidators.clear();
+        this.ajv = null;
+    }
+    /**
+     * Gets cache statistics for monitoring.
+     */
+    static getCacheStats() {
+        return {
+            cachedSchemas: this.validators.size + this.schemaValidators.size,
+            schemasLoaded: Array.from(this.validators.keys())
+        };
+    }
+}
+//# sourceMappingURL=schema_cache.js.map

package/dist/src/schemas/schema_cache.js.map

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

package/dist/src/schemas/schema_cache.test.d.ts

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

package/dist/src/schemas/schema_cache.test.d.ts.map

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

package/dist/src/schemas/schema_cache.test.js

@@ -0,0 +1,163 @@
+import { SchemaValidationCache } from './schema_cache';
+import { Schemas } from './index';
+describe('SchemaValidationCache', () => {
+    beforeEach(() => {
+        // Clear cache before each test
+        SchemaValidationCache.clearCache();
+    });
+    afterEach(() => {
+        // Clean up after tests
+        SchemaValidationCache.clearCache();
+    });
+    it('[EARS-1] should cache validators and avoid recompilation', () => {
+        // First call should compile and cache
+        const validator1 = SchemaValidationCache.getValidatorFromSchema(Schemas.ActorRecord);
+        expect(validator1).toBeDefined();
+        expect(typeof validator1).toBe('function');
+        // Second call should return cached validator (same reference)
+        const validator2 = SchemaValidationCache.getValidatorFromSchema(Schemas.ActorRecord);
+        expect(validator2).toBe(validator1); // Same reference = cached
+    });
+    it('[EARS-2] should handle multiple different schemas', () => {
+        const actorValidator = SchemaValidationCache.getValidatorFromSchema(Schemas.ActorRecord);
+        const agentValidator = SchemaValidationCache.getValidatorFromSchema(Schemas.AgentRecord);
+        expect(actorValidator).toBeDefined();
+        expect(agentValidator).toBeDefined();
+        expect(actorValidator).not.toBe(agentValidator); // Different validators
+        // Note: getCacheStats() needs to be updated for schema objects
+        const stats = SchemaValidationCache.getCacheStats();
+        expect(stats.cachedSchemas).toBe(2);
+    });
+    it('[EARS-3] should validate ActorRecord correctly using cached validator', () => {
+        const validator = SchemaValidationCache.getValidatorFromSchema(Schemas.ActorRecord);
+        const validActor = {
+            id: 'human:test-user',
+            type: 'human',
+            displayName: 'Test User',
+            publicKey: 'test-public-key-base64',
+            roles: ['developer:backend']
+        };
+        const invalidActor = { id: 'invalid' }; // Missing required fields
+        expect(validator(validActor)).toBe(true);
+        expect(validator(invalidActor)).toBe(false);
+    });
+    it('[EARS-4] should validate AgentRecord correctly using cached validator', () => {
+        const validator = SchemaValidationCache.getValidatorFromSchema(Schemas.AgentRecord);
+        const validAgent = {
+            id: 'agent:test-agent',
+            guild: 'design',
+            engine: {
+                type: 'api',
+                model: 'gpt-4',
+                version: '1.0.0'
+            },
+            status: 'active',
+            triggers: []
+        };
+        const invalidAgent = { id: 'invalid' }; // Missing required fields
+        expect(validator(validAgent)).toBe(true);
+        expect(validator(invalidAgent)).toBe(false);
+    });
+    it('[EARS-6] should validate TaskRecord correctly using cached validator', () => {
+        const validator = SchemaValidationCache.getValidatorFromSchema(Schemas.TaskRecord);
+        const validTask = {
+            id: '1234567890-task-test-implementation',
+            title: 'Test Implementation Task',
+            status: 'draft',
+            priority: 'medium',
+            description: 'This is a test task for integration testing purposes.',
+            tags: ['test', 'integration']
+        };
+        const invalidTask = { id: 'invalid' }; // Missing required fields
+        expect(validator(validTask)).toBe(true);
+        expect(validator(invalidTask)).toBe(false);
+    });
+    it('[EARS-7] should validate ExecutionRecord correctly using cached validator', () => {
+        const validator = SchemaValidationCache.getValidatorFromSchema(Schemas.ExecutionRecord);
+        const validExecution = {
+            id: '1234567890-exec-test-execution',
+            taskId: '1234567890-task-test-implementation',
+            result: 'Test execution completed successfully with all requirements met.'
+        };
+        const invalidExecution = { id: 'invalid' }; // Missing required fields
+        expect(validator(validExecution)).toBe(true);
+        expect(validator(invalidExecution)).toBe(false);
+    });
+    it('[EARS-8] should validate ChangelogRecord correctly using cached validator', () => {
+        const validator = SchemaValidationCache.getValidatorFromSchema(Schemas.ChangelogRecord);
+        const validChangelog = {
+            id: '1234567890-changelog-test-entry',
+            entityType: 'task',
+            entityId: '1234567890-task-test-implementation',
+            changeType: 'completion',
+            title: 'Task Completion',
+            description: 'Task status changed from draft to review',
+            timestamp: 1234567890,
+            trigger: 'manual',
+            triggeredBy: 'human:test-user',
+            reason: 'Task completed successfully',
+            riskLevel: 'low'
+        };
+        const invalidChangelog = { id: 'invalid' }; // Missing required fields
+        expect(validator(validChangelog)).toBe(true);
+        expect(validator(invalidChangelog)).toBe(false);
+    });
+    it('[EARS-9] should validate FeedbackRecord correctly using cached validator', () => {
+        const validator = SchemaValidationCache.getValidatorFromSchema(Schemas.FeedbackRecord);
+        const validFeedback = {
+            id: '1234567890-feedback-test-comment',
+            entityType: 'task',
+            entityId: '1234567890-task-test-implementation',
+            type: 'suggestion',
+            status: 'open',
+            content: 'This is a test feedback comment for integration testing.'
+        };
+        const invalidFeedback = { id: 'invalid' }; // Missing required fields
+        expect(validator(validFeedback)).toBe(true);
+        expect(validator(invalidFeedback)).toBe(false);
+    });
+    it('[EARS-10] should validate CycleRecord correctly using cached validator', () => {
+        const validator = SchemaValidationCache.getValidatorFromSchema(Schemas.CycleRecord);
+        const validCycle = {
+            id: '1234567890-cycle-test-sprint',
+            status: 'active',
+            title: 'Test Sprint Cycle',
+            taskIds: []
+        };
+        const invalidCycle = { id: 'invalid' }; // Missing required fields
+        expect(validator(validCycle)).toBe(true);
+        expect(validator(invalidCycle)).toBe(false);
+    });
+    it('[EARS-11] should validate WorkflowMethodology correctly using cached validator', () => {
+        const validator = SchemaValidationCache.getValidatorFromSchema(Schemas.WorkflowMethodologyRecord);
+        const validWorkflow = {
+            version: '1.0.0',
+            name: 'Test Workflow',
+            state_transitions: {
+                'draft': {
+                    from: ['draft'],
+                    requires: {
+                        command: 'gitgov task submit'
+                    }
+                }
+            }
+        };
+        const invalidWorkflow = { version: 'invalid' }; // Missing required fields
+        expect(validator(validWorkflow)).toBe(true);
+        expect(validator(invalidWorkflow)).toBe(false);
+    });
+    // NOTE: EmbeddedMetadata test skipped due to unresolved $ref dependencies
+    // This will be handled when we create embedded_metadata_validator.ts
+    it('[EARS-5] should clear cache completely', () => {
+        // Load some validators
+        SchemaValidationCache.getValidatorFromSchema(Schemas.ActorRecord);
+        SchemaValidationCache.getValidatorFromSchema(Schemas.AgentRecord);
+        expect(SchemaValidationCache.getCacheStats().cachedSchemas).toBe(2);
+        // Clear cache
+        SchemaValidationCache.clearCache();
+        const stats = SchemaValidationCache.getCacheStats();
+        expect(stats.cachedSchemas).toBe(0);
+        expect(stats.schemasLoaded).toEqual([]);
+    });
+});
+//# sourceMappingURL=schema_cache.test.js.map

package/dist/src/schemas/schema_cache.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema_cache.test.js","sourceRoot":"","sources":["../../../src/schemas/schema_cache.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAUlC,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IAErC,UAAU,CAAC,GAAG,EAAE;QACd,+BAA+B;QAC/B,qBAAqB,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,uBAAuB;QACvB,qBAAqB,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,sCAAsC;QACtC,MAAM,UAAU,GAAG,qBAAqB,CAAC,sBAAsB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACrF,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QACjC,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAE3C,8DAA8D;QAC9D,MAAM,UAAU,GAAG,qBAAqB,CAAC,sBAAsB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACrF,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,0BAA0B;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,cAAc,GAAG,qBAAqB,CAAC,sBAAsB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACzF,MAAM,cAAc,GAAG,qBAAqB,CAAC,sBAAsB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAEzF,MAAM,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,uBAAuB;QAExE,+DAA+D;QAC/D,MAAM,KAAK,GAAG,qBAAqB,CAAC,aAAa,EAAE,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,SAAS,GAAG,qBAAqB,CAAC,sBAAsB,CAAc,OAAO,CAAC,WAAW,CAAC,CAAC;QAEjG,MAAM,UAAU,GAAG;YACjB,EAAE,EAAE,iBAAiB;YACrB,IAAI,EAAE,OAAO;YACb,WAAW,EAAE,WAAW;YACxB,SAAS,EAAE,wBAAwB;YACnC,KAAK,EAAE,CAAC,mBAAmB,CAAC;SAC7B,CAAC;QAEF,MAAM,YAAY,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,0BAA0B;QAElE,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,SAAS,GAAG,qBAAqB,CAAC,sBAAsB,CAAc,OAAO,CAAC,WAAW,CAAC,CAAC;QAEjG,MAAM,UAAU,GAAG;YACjB,EAAE,EAAE,kBAAkB;YACtB,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE;gBACN,IAAI,EAAE,KAAK;gBACX,KAAK,EAAE,OAAO;gBACd,OAAO,EAAE,OAAO;aACjB;YACD,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,EAAE;SACb,CAAC;QAEF,MAAM,YAAY,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,0BAA0B;QAElE,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,SAAS,GAAG,qBAAqB,CAAC,sBAAsB,CAAa,OAAO,CAAC,UAAU,CAAC,CAAC;QAE/F,MAAM,SAAS,GAAG;YAChB,EAAE,EAAE,qCAAqC;YACzC,KAAK,EAAE,0BAA0B;YACjC,MAAM,EAAE,OAAO;YACf,QAAQ,EAAE,QAAQ;YAClB,WAAW,EAAE,uDAAuD;YACpE,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC;SAC9B,CAAC;QAEF,MAAM,WAAW,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,0BAA0B;QAEjE,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,MAAM,SAAS,GAAG,qBAAqB,CAAC,sBAAsB,CAAkB,OAAO,CAAC,eAAe,CAAC,CAAC;QAEzG,MAAM,cAAc,GAAG;YACrB,EAAE,EAAE,gCAAgC;YACpC,MAAM,EAAE,qCAAqC;YAC7C,MAAM,EAAE,kEAAkE;SAC3E,CAAC;QAEF,MAAM,gBAAgB,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,0BAA0B;QAEtE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,MAAM,SAAS,GAAG,qBAAqB,CAAC,sBAAsB,CAAkB,OAAO,CAAC,eAAe,CAAC,CAAC;QAEzG,MAAM,cAAc,GAAG;YACrB,EAAE,EAAE,iCAAiC;YACrC,UAAU,EAAE,MAAM;YAClB,QAAQ,EAAE,qCAAqC;YAC/C,UAAU,EAAE,YAAY;YACxB,KAAK,EAAE,iBAAiB;YACxB,WAAW,EAAE,0CAA0C;YACvD,SAAS,EAAE,UAAU;YACrB,OAAO,EAAE,QAAQ;YACjB,WAAW,EAAE,iBAAiB;YAC9B,MAAM,EAAE,6BAA6B;YACrC,SAAS,EAAE,KAAK;SACjB,CAAC;QAEF,MAAM,gBAAgB,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,0BAA0B;QAEtE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,MAAM,SAAS,GAAG,qBAAqB,CAAC,sBAAsB,CAAiB,OAAO,CAAC,cAAc,CAAC,CAAC;QAEvG,MAAM,aAAa,GAAG;YACpB,EAAE,EAAE,kCAAkC;YACtC,UAAU,EAAE,MAAM;YAClB,QAAQ,EAAE,qCAAqC;YAC/C,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,0DAA0D;SACpE,CAAC;QAEF,MAAM,eAAe,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,0BAA0B;QAErE,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,SAAS,GAAG,qBAAqB,CAAC,sBAAsB,CAAc,OAAO,CAAC,WAAW,CAAC,CAAC;QAEjG,MAAM,UAAU,GAAG;YACjB,EAAE,EAAE,8BAA8B;YAClC,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,mBAAmB;YAC1B,OAAO,EAAE,EAAE;SACZ,CAAC;QAEF,MAAM,YAAY,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,0BAA0B;QAElE,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gFAAgF,EAAE,GAAG,EAAE;QACxF,MAAM,SAAS,GAAG,qBAAqB,CAAC,sBAAsB,CAA4B,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAE7H,MAAM,aAAa,GAAG;YACpB,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,eAAe;YACrB,iBAAiB,EAAE;gBACjB,OAAO,EAAE;oBACP,IAAI,EAAE,CAAC,OAAO,CAAC;oBACf,QAAQ,EAAE;wBACR,OAAO,EAAE,oBAAoB;qBAC9B;iBACF;aACF;SACF,CAAC;QAEF,MAAM,eAAe,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC,0BAA0B;QAE1E,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,0EAA0E;IAC1E,qEAAqE;IAErE,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,uBAAuB;QACvB,qBAAqB,CAAC,sBAAsB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAClE,qBAAqB,CAAC,sBAAsB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAElE,MAAM,CAAC,qBAAqB,CAAC,aAAa,EAAE,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpE,cAAc;QACd,qBAAqB,CAAC,UAAU,EAAE,CAAC;QAEnC,MAAM,KAAK,GAAG,qBAAqB,CAAC,aAAa,EAAE,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,2 @@
+export * from "./record_store";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/src/store/index.js

@@ -0,0 +1,2 @@
+export * from "./record_store";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/store/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/src/store/record_store.d.ts

@@ -0,0 +1,30 @@
+import { promises as fs } from 'fs';
+import type { GitGovRecord, GitGovRecordPayload, CustomRecord } from '../types';
+type StorablePayload = Exclude<GitGovRecordPayload, CustomRecord>;
+export interface FsDependencies {
+    mkdir: typeof fs.mkdir;
+    writeFile: typeof fs.writeFile;
+    readFile: typeof fs.readFile;
+    readdir: typeof fs.readdir;
+    unlink: typeof fs.unlink;
+    access: typeof fs.access;
+}
+export declare class RecordStore<T extends StorablePayload> {
+    private recordType;
+    private recordsDir;
+    private fs;
+    constructor(recordType: string, rootPath?: string, fsDeps?: FsDependencies);
+    private getRecordPath;
+    private ensureDirExists;
+    write(record: GitGovRecord & {
+        payload: T;
+    }): Promise<void>;
+    read(recordId: string): Promise<(GitGovRecord & {
+        payload: T;
+    }) | null>;
+    delete(recordId: string): Promise<void>;
+    list(): Promise<string[]>;
+    exists(recordId: string): Promise<boolean>;
+}
+export {};
+//# sourceMappingURL=record_store.d.ts.map

package/dist/src/store/record_store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record_store.d.ts","sourceRoot":"","sources":["../../../src/store/record_store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAa,MAAM,IAAI,CAAC;AAG/C,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEhF,KAAK,eAAe,GAAG,OAAO,CAAC,mBAAmB,EAAE,YAAY,CAAC,CAAC;AAGlE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC;IACvB,SAAS,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC;IAC/B,QAAQ,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC;IAC7B,OAAO,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC;IAC3B,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC;CAC1B;AAED,qBAAa,WAAW,CAAC,CAAC,SAAS,eAAe;IAChD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,EAAE,CAAiB;gBAGzB,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,GAAE,cAAmB;IAW7B,OAAO,CAAC,aAAa;YAKP,eAAe;IAIvB,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG;QAAE,OAAO,EAAE,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3D,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,YAAY,GAAG;QAAE,OAAO,EAAE,CAAC,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IAiBvE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAezB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CASjD"}

package/dist/src/store/record_store.js

@@ -0,0 +1,83 @@
+import { promises as fs, constants } from 'fs';
+import * as path from 'path';
+import { ConfigManager } from '../config_manager';
+export class RecordStore {
+    recordType;
+    recordsDir;
+    fs;
+    constructor(recordType, rootPath, fsDeps = fs) {
+        const foundRoot = rootPath || ConfigManager.findProjectRoot();
+        if (!foundRoot) {
+            throw new Error("Could not find project root. RecordStore requires a valid project root.");
+        }
+        this.recordType = recordType;
+        this.recordsDir = path.join(foundRoot, '.gitgov', this.recordType);
+        this.fs = fsDeps;
+    }
+    getRecordPath(recordId) {
+        const safeId = recordId.replace(/:/g, '_');
+        return path.join(this.recordsDir, `${safeId}.json`);
+    }
+    async ensureDirExists() {
+        await this.fs.mkdir(this.recordsDir, { recursive: true });
+    }
+    async write(record) {
+        await this.ensureDirExists();
+        const filePath = this.getRecordPath(record.payload.id);
+        const content = JSON.stringify(record, null, 2);
+        await this.fs.writeFile(filePath, content, 'utf-8');
+    }
+    async read(recordId) {
+        const filePath = this.getRecordPath(recordId);
+        try {
+            const content = await this.fs.readFile(filePath, 'utf-8');
+            const record = JSON.parse(content);
+            return record;
+        }
+        catch (e) {
+            const error = e;
+            if (error.code === 'ENOENT') {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async delete(recordId) {
+        const filePath = this.getRecordPath(recordId);
+        try {
+            await this.fs.unlink(filePath);
+        }
+        catch (e) {
+            const error = e;
+            if (error.code !== 'ENOENT') {
+                throw error;
+            }
+        }
+    }
+    async list() {
+        try {
+            const files = await this.fs.readdir(this.recordsDir, { withFileTypes: true });
+            return files
+                .filter(file => file.isFile() && file.name.endsWith('.json'))
+                .map(file => file.name.replace(/\.json$/, '').replace(/_/g, ':'));
+        }
+        catch (e) {
+            const error = e;
+            if (error.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
+        }
+    }
+    async exists(recordId) {
+        const filePath = this.getRecordPath(recordId);
+        try {
+            await this.fs.access(filePath, constants.F_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=record_store.js.map

package/dist/src/store/record_store.js.map

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

package/dist/src/store/record_store.test.d.ts

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

package/dist/src/store/record_store.test.d.ts.map

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