@gitgov/core 1.0.0

package/dist/src/adapters/execution_adapter/index.d.ts

@@ -0,0 +1,90 @@
+import { RecordStore } from '../../store';
+import { IdentityAdapter } from '../identity_adapter';
+import type { ExecutionRecord } from '../../types';
+import type { TaskRecord } from '../../types';
+import type { IEventStream } from '../../event_bus';
+/**
+ * ExecutionAdapter Dependencies - Facade + Dependency Injection Pattern
+ */
+export interface ExecutionAdapterDependencies {
+    executionStore: RecordStore<ExecutionRecord>;
+    identity: IdentityAdapter;
+    eventBus: IEventStream;
+    taskStore?: RecordStore<TaskRecord>;
+}
+/**
+ * ExecutionAdapter Interface - The Chronicler of the System
+ */
+export interface IExecutionAdapter {
+    /**
+     * Records a new execution event.
+     */
+    create(payload: Partial<ExecutionRecord>, actorId: string): Promise<ExecutionRecord>;
+    /**
+     * Gets a specific ExecutionRecord by its ID.
+     */
+    getExecution(executionId: string): Promise<ExecutionRecord | null>;
+    /**
+     * Gets all ExecutionRecords for a specific Task.
+     */
+    getExecutionsByTask(taskId: string): Promise<ExecutionRecord[]>;
+    /**
+     * Gets all ExecutionRecords in the system.
+     */
+    getAllExecutions(): Promise<ExecutionRecord[]>;
+}
+/**
+ * ExecutionAdapter - The Chronicler of the System
+ *
+ * Implements Facade + Dependency Injection Pattern for testeable and configurable orchestration.
+ * Acts as Mediator between execution logging and data stores.
+ */
+export declare class ExecutionAdapter implements IExecutionAdapter {
+    private executionStore;
+    private identity;
+    private eventBus;
+    private taskStore;
+    constructor(dependencies: ExecutionAdapterDependencies);
+    /**
+     * [EARS-1] Records a new execution event to create an immutable audit log.
+     *
+     * Description: Records a new execution event to create an immutable audit log.
+     * Implementation: Builds record with factory, signs with actorId, persists and emits event.
+     * Usage: Invoked by `gitgov exec add` to register work done by actors/agents.
+     * Returns: Complete and signed ExecutionRecord.
+     */
+    create(payload: Partial<ExecutionRecord>, actorId: string): Promise<ExecutionRecord>;
+    /**
+     * [EARS-4] Gets a specific ExecutionRecord by its ID for query.
+     *
+     * Description: Gets a specific ExecutionRecord by its ID for query.
+     * Implementation: Direct read from record store without modifications.
+     * Usage: Invoked by `gitgov exec show` to display execution details.
+     * Returns: ExecutionRecord found or null if it doesn't exist.
+     */
+    getExecution(executionId: string): Promise<ExecutionRecord | null>;
+    /**
+     * [EARS-6] Gets all ExecutionRecords associated with a specific Task.
+     *
+     * Description: Gets all ExecutionRecords associated with a specific Task.
+     * Implementation: Reads all records and filters by matching taskId.
+     * Usage: Invoked by `gitgov exec list` and MetricsAdapter for staleness calculations.
+     * Returns: Array of ExecutionRecords filtered for the task.
+     */
+    getExecutionsByTask(taskId: string): Promise<ExecutionRecord[]>;
+    /**
+     * [EARS-7] Gets all ExecutionRecords in the system for indexation.
+     *
+     * Description: Gets all ExecutionRecords in the system for complete indexation.
+     * Implementation: Complete read from record store without filters.
+     * Usage: Invoked by `gitgov exec list --all` and MetricsAdapter for general calculations.
+     * Returns: Complete array of all ExecutionRecords.
+     */
+    getAllExecutions(): Promise<ExecutionRecord[]>;
+    /**
+     * Helper method to determine if this is the first execution for a task
+     * Used for BacklogAdapter.handleExecutionCreated logic
+     */
+    private isFirstExecutionForTask;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/adapters/execution_adapter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/execution_adapter/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAyB,MAAM,iBAAiB,CAAC;AAG3E;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAE3C,cAAc,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;IAG7C,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,YAAY,CAAC;IAGvB,SAAS,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAErF;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAEnE;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAEhE;;OAEG;IACH,gBAAgB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CAChD;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,iBAAiB;IACxD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,SAAS,CAAsC;gBAE3C,YAAY,EAAE,4BAA4B;IAOtD;;;;;;;OAOG;IACG,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAuE1F;;;;;;;OAOG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAKxE;;;;;;;OAOG;IACG,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAcrE;;;;;;;OAOG;IACG,gBAAgB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAcpD;;;OAGG;YACW,uBAAuB;CAItC"}

package/dist/src/adapters/execution_adapter/index.js

@@ -0,0 +1,150 @@
+import { createExecutionRecord } from '../../factories/execution_factory';
+import { RecordStore } from '../../store';
+import { IdentityAdapter } from '../identity_adapter';
+/**
+ * ExecutionAdapter - The Chronicler of the System
+ *
+ * Implements Facade + Dependency Injection Pattern for testeable and configurable orchestration.
+ * Acts as Mediator between execution logging and data stores.
+ */
+export class ExecutionAdapter {
+    executionStore;
+    identity;
+    eventBus;
+    taskStore;
+    constructor(dependencies) {
+        this.executionStore = dependencies.executionStore;
+        this.identity = dependencies.identity;
+        this.eventBus = dependencies.eventBus;
+        this.taskStore = dependencies.taskStore; // Graceful degradation
+    }
+    /**
+     * [EARS-1] Records a new execution event to create an immutable audit log.
+     *
+     * Description: Records a new execution event to create an immutable audit log.
+     * Implementation: Builds record with factory, signs with actorId, persists and emits event.
+     * Usage: Invoked by `gitgov exec add` to register work done by actors/agents.
+     * Returns: Complete and signed ExecutionRecord.
+     */
+    async create(payload, actorId) {
+        // Input validation
+        if (!payload.taskId) {
+            throw new Error('DetailedValidationError: taskId is required');
+        }
+        if (!payload.result) {
+            throw new Error('DetailedValidationError: result is required');
+        }
+        if (payload.result && payload.result.length < 10) {
+            throw new Error('DetailedValidationError: result must be at least 10 characters');
+        }
+        // Optional: Validate taskId exists (graceful degradation)
+        if (this.taskStore) {
+            const taskExists = await this.taskStore.read(payload.taskId);
+            if (!taskExists) {
+                throw new Error(`RecordNotFoundError: Task not found: ${payload.taskId}`);
+            }
+        }
+        try {
+            // 1. Build the record with factory
+            const validatedPayload = await createExecutionRecord(payload);
+            // 2. Create unsigned record structure
+            const unsignedRecord = {
+                header: {
+                    version: '1.0',
+                    type: 'execution',
+                    payloadChecksum: 'will-be-calculated-by-signRecord',
+                    signatures: [{
+                            keyId: actorId,
+                            role: 'author',
+                            signature: 'placeholder',
+                            timestamp: Date.now(),
+                            timestamp_iso: new Date().toISOString()
+                        }]
+                },
+                payload: validatedPayload,
+            };
+            // 3. Sign the record
+            const signedRecord = await this.identity.signRecord(unsignedRecord, actorId, 'author');
+            // 4. Persist the record
+            await this.executionStore.write(signedRecord);
+            // 5. Emit event - responsibility ends here
+            this.eventBus.publish({
+                type: 'execution.created',
+                timestamp: Date.now(),
+                source: 'execution_adapter',
+                payload: {
+                    executionId: validatedPayload.id,
+                    taskId: validatedPayload.taskId,
+                    actorId,
+                    isFirstExecution: await this.isFirstExecutionForTask(validatedPayload.taskId)
+                },
+            });
+            return validatedPayload;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('DetailedValidationError')) {
+                throw error;
+            }
+            throw error;
+        }
+    }
+    /**
+     * [EARS-4] Gets a specific ExecutionRecord by its ID for query.
+     *
+     * Description: Gets a specific ExecutionRecord by its ID for query.
+     * Implementation: Direct read from record store without modifications.
+     * Usage: Invoked by `gitgov exec show` to display execution details.
+     * Returns: ExecutionRecord found or null if it doesn't exist.
+     */
+    async getExecution(executionId) {
+        const record = await this.executionStore.read(executionId);
+        return record ? record.payload : null;
+    }
+    /**
+     * [EARS-6] Gets all ExecutionRecords associated with a specific Task.
+     *
+     * Description: Gets all ExecutionRecords associated with a specific Task.
+     * Implementation: Reads all records and filters by matching taskId.
+     * Usage: Invoked by `gitgov exec list` and MetricsAdapter for staleness calculations.
+     * Returns: Array of ExecutionRecords filtered for the task.
+     */
+    async getExecutionsByTask(taskId) {
+        const ids = await this.executionStore.list();
+        const executions = [];
+        for (const id of ids) {
+            const record = await this.executionStore.read(id);
+            if (record && record.payload.taskId === taskId) {
+                executions.push(record.payload);
+            }
+        }
+        return executions;
+    }
+    /**
+     * [EARS-7] Gets all ExecutionRecords in the system for indexation.
+     *
+     * Description: Gets all ExecutionRecords in the system for complete indexation.
+     * Implementation: Complete read from record store without filters.
+     * Usage: Invoked by `gitgov exec list --all` and MetricsAdapter for general calculations.
+     * Returns: Complete array of all ExecutionRecords.
+     */
+    async getAllExecutions() {
+        const ids = await this.executionStore.list();
+        const executions = [];
+        for (const id of ids) {
+            const record = await this.executionStore.read(id);
+            if (record) {
+                executions.push(record.payload);
+            }
+        }
+        return executions;
+    }
+    /**
+     * Helper method to determine if this is the first execution for a task
+     * Used for BacklogAdapter.handleExecutionCreated logic
+     */
+    async isFirstExecutionForTask(taskId) {
+        const executions = await this.getExecutionsByTask(taskId);
+        return executions.length === 1; // Including the one we just created
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/adapters/execution_adapter/index.js.map

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

package/dist/src/adapters/feedback_adapter/feedback_adapter.test.d.ts

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

package/dist/src/adapters/feedback_adapter/feedback_adapter.test.d.ts.map

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

package/dist/src/adapters/feedback_adapter/feedback_adapter.test.js

@@ -0,0 +1,256 @@
+import { FeedbackAdapter } from './index';
+import { createFeedbackRecord } from '../../factories/feedback_factory';
+import { RecordStore } from '../../store';
+import { IdentityAdapter } from '../identity_adapter';
+import { publishEvent } from '../../event_bus';
+import { DetailedValidationError } from '../../validation/common';
+// Mock dependencies
+jest.mock('../../factories/feedback_factory');
+jest.mock('../../store');
+jest.mock('../identity_adapter');
+jest.mock('../../event_bus', () => ({
+    ...jest.requireActual('../../event_bus'),
+    publishEvent: jest.fn(),
+}));
+// Helper function to create properly typed mock feedback records
+function createMockFeedbackRecord(overrides = {}) {
+    return {
+        header: {
+            version: '1.0',
+            type: 'feedback',
+            payloadChecksum: 'mock-checksum',
+            signatures: [{
+                    keyId: 'mock-author',
+                    role: 'author',
+                    signature: 'mock-sig',
+                    timestamp: 123,
+                    timestamp_iso: '2025-01-01T00:00:00Z'
+                }]
+        },
+        payload: {
+            id: 'mock-feedback',
+            entityType: 'task',
+            entityId: 'task-123',
+            type: 'suggestion',
+            content: 'Mock feedback content',
+            status: 'open',
+            ...overrides
+        }
+    };
+}
+describe('FeedbackAdapter', () => {
+    let feedbackAdapter;
+    let mockFeedbackStore;
+    let mockIdentityAdapter;
+    let mockPublishEvent;
+    const mockPayload = {
+        entityType: 'task',
+        entityId: 'task-123',
+        type: 'suggestion',
+        content: 'This is a test feedback'
+    };
+    const mockActorId = 'human:developer';
+    const mockCreatedFeedbackPayload = {
+        id: '123-feedback-test',
+        entityType: 'task',
+        entityId: 'task-123',
+        type: 'suggestion',
+        content: 'This is a test feedback',
+        status: 'open'
+    };
+    const mockSignedRecord = createMockFeedbackRecord(mockCreatedFeedbackPayload);
+    beforeEach(() => {
+        jest.clearAllMocks();
+        // Mock store with proper typing
+        mockFeedbackStore = {
+            write: jest.fn().mockResolvedValue(undefined),
+            read: jest.fn().mockResolvedValue(null),
+            list: jest.fn().mockResolvedValue([]),
+            delete: jest.fn().mockResolvedValue(undefined),
+            exists: jest.fn().mockResolvedValue(false),
+        };
+        // Mock identity adapter
+        mockIdentityAdapter = {
+            signRecord: jest.fn(),
+        };
+        // Mock publish event
+        mockPublishEvent = publishEvent;
+        // Mock factory
+        createFeedbackRecord.mockResolvedValue(mockCreatedFeedbackPayload);
+        mockIdentityAdapter.signRecord.mockResolvedValue(mockSignedRecord);
+        // Create adapter with mocked dependencies
+        feedbackAdapter = new FeedbackAdapter({
+            feedbackStore: mockFeedbackStore,
+            identity: mockIdentityAdapter,
+            eventBus: {
+                publish: jest.fn(),
+                subscribe: jest.fn(),
+                unsubscribe: jest.fn(),
+                getSubscriptions: jest.fn(),
+                clearSubscriptions: jest.fn()
+            },
+            // No workflowMethodology for graceful degradation
+        });
+    });
+    describe('create', () => {
+        it('[EARS-1] should create, sign, write, and emit event for valid feedback', async () => {
+            const result = await feedbackAdapter.create(mockPayload, mockActorId);
+            expect(createFeedbackRecord).toHaveBeenCalledWith({
+                ...mockPayload,
+                status: 'open'
+            });
+            expect(mockIdentityAdapter.signRecord).toHaveBeenCalledWith(expect.objectContaining({
+                payload: mockCreatedFeedbackPayload
+            }), mockActorId, 'author');
+            expect(mockFeedbackStore.write).toHaveBeenCalledWith(mockSignedRecord);
+            // Note: Now using this.eventBus.publish instead of publishEvent
+            // The mock eventBus.publish should have been called
+            expect(result).toEqual(mockCreatedFeedbackPayload);
+        });
+        it('[EARS-2] should throw DetailedValidationError for invalid payload', async () => {
+            const validationError = new DetailedValidationError('Invalid payload', []);
+            createFeedbackRecord.mockRejectedValue(validationError);
+            await expect(feedbackAdapter.create({ entityId: 'invalid' }, mockActorId))
+                .rejects.toThrow('Invalid payload');
+            // Ensure no side effects occurred
+            expect(mockIdentityAdapter.signRecord).not.toHaveBeenCalled();
+            expect(mockFeedbackStore.write).not.toHaveBeenCalled();
+            expect(mockPublishEvent).not.toHaveBeenCalled();
+        });
+        it('[EARS-3] should throw RecordNotFoundError for missing entityId', async () => {
+            await expect(feedbackAdapter.create({}, mockActorId))
+                .rejects.toThrow('RecordNotFoundError: entityId is required');
+        });
+        it('[EARS-11] should throw InvalidEntityTypeError for invalid entityType', async () => {
+            const invalidPayload = { entityType: 'invalid', entityId: 'task-123', content: 'test' };
+            await expect(feedbackAdapter.create(invalidPayload, mockActorId))
+                .rejects.toThrow('InvalidEntityTypeError: entityType must be task, execution, changelog, or feedback');
+        });
+    });
+    describe('resolve', () => {
+        it('[EARS-4] should resolve feedback and emit status changed event', async () => {
+            const existingFeedback = createMockFeedbackRecord({
+                id: 'feedback-123',
+                status: 'open'
+            });
+            const resolvedFeedback = { ...existingFeedback.payload, status: 'resolved' };
+            mockFeedbackStore.read.mockResolvedValue(existingFeedback);
+            mockIdentityAdapter.signRecord.mockResolvedValue({
+                ...existingFeedback,
+                payload: resolvedFeedback
+            });
+            const result = await feedbackAdapter.resolve('feedback-123', mockActorId);
+            expect(mockFeedbackStore.read).toHaveBeenCalledWith('feedback-123');
+            expect(mockIdentityAdapter.signRecord).toHaveBeenCalledWith(expect.objectContaining({
+                payload: resolvedFeedback
+            }), mockActorId, 'resolver');
+            expect(mockFeedbackStore.write).toHaveBeenCalled();
+            // Note: Now using this.eventBus.publish instead of publishEvent
+            // The mock eventBus.publish should have been called
+            expect(result).toEqual(resolvedFeedback);
+        });
+        it('[EARS-5] should throw RecordNotFoundError for non-existent feedback', async () => {
+            mockFeedbackStore.read.mockResolvedValue(null);
+            await expect(feedbackAdapter.resolve('non-existent', mockActorId))
+                .rejects.toThrow('RecordNotFoundError: Feedback not found: non-existent');
+        });
+        it('[EARS-6] should throw error when resolving already resolved feedback', async () => {
+            const resolvedFeedback = createMockFeedbackRecord({
+                id: 'feedback-123',
+                status: 'resolved'
+            });
+            mockFeedbackStore.read.mockResolvedValue(resolvedFeedback);
+            await expect(feedbackAdapter.resolve('feedback-123', mockActorId))
+                .rejects.toThrow('ProtocolViolationError: Feedback feedback-123 is already resolved');
+        });
+    });
+    describe('getFeedback', () => {
+        it('[EARS-7] should return existing feedback record', async () => {
+            const mockRecord = createMockFeedbackRecord({ id: 'feedback-123' });
+            mockFeedbackStore.read.mockResolvedValue(mockRecord);
+            const result = await feedbackAdapter.getFeedback('feedback-123');
+            expect(mockFeedbackStore.read).toHaveBeenCalledWith('feedback-123');
+            expect(result).toEqual(mockRecord.payload);
+        });
+        it('[EARS-8] should return null for non-existent feedback', async () => {
+            mockFeedbackStore.read.mockResolvedValue(null);
+            const result = await feedbackAdapter.getFeedback('non-existent');
+            expect(result).toBeNull();
+        });
+    });
+    describe('getFeedbackByEntity', () => {
+        it('[EARS-9] should filter feedbacks by entity ID', async () => {
+            const feedback1 = createMockFeedbackRecord({ id: 'feedback-1', entityId: 'task-123' });
+            const feedback2 = createMockFeedbackRecord({ id: 'feedback-2', entityId: 'task-456' });
+            const feedback3 = createMockFeedbackRecord({ id: 'feedback-3', entityId: 'task-123' });
+            mockFeedbackStore.list.mockResolvedValue(['feedback-1', 'feedback-2', 'feedback-3']);
+            mockFeedbackStore.read
+                .mockResolvedValueOnce(feedback1)
+                .mockResolvedValueOnce(feedback2)
+                .mockResolvedValueOnce(feedback3);
+            const result = await feedbackAdapter.getFeedbackByEntity('task-123');
+            expect(result).toHaveLength(2);
+            expect(result[0]).toEqual(feedback1.payload);
+            expect(result[1]).toEqual(feedback3.payload);
+        });
+        it('should return empty array when no feedbacks found for entity', async () => {
+            mockFeedbackStore.list.mockResolvedValue([]);
+            const result = await feedbackAdapter.getFeedbackByEntity('task-nonexistent');
+            expect(result).toEqual([]);
+        });
+    });
+    describe('getAllFeedback', () => {
+        it('[EARS-10] should return all feedback records in the system', async () => {
+            const feedback1 = createMockFeedbackRecord({ id: 'feedback-1' });
+            const feedback2 = createMockFeedbackRecord({ id: 'feedback-2' });
+            mockFeedbackStore.list.mockResolvedValue(['feedback-1', 'feedback-2']);
+            mockFeedbackStore.read
+                .mockResolvedValueOnce(feedback1)
+                .mockResolvedValueOnce(feedback2);
+            const result = await feedbackAdapter.getAllFeedback();
+            expect(result).toHaveLength(2);
+            expect(result[0]).toEqual(feedback1.payload);
+            expect(result[1]).toEqual(feedback2.payload);
+        });
+        it('should return empty array when no feedbacks exist', async () => {
+            mockFeedbackStore.list.mockResolvedValue([]);
+            const result = await feedbackAdapter.getAllFeedback();
+            expect(result).toEqual([]);
+        });
+    });
+    describe('Performance Tests', () => {
+        it('[EARS-12] should execute in under 50ms for typical datasets', async () => {
+            // Create mock data for performance test
+            const feedbackIds = Array.from({ length: 100 }, (_, i) => `feedback-${i}`);
+            const mockFeedbacks = feedbackIds.map(id => createMockFeedbackRecord({ id, entityId: `task-${id}` }));
+            mockFeedbackStore.list.mockResolvedValue(feedbackIds);
+            mockFeedbacks.forEach(feedback => {
+                mockFeedbackStore.read.mockResolvedValueOnce(feedback);
+            });
+            const startTime = Date.now();
+            await feedbackAdapter.getAllFeedback();
+            const endTime = Date.now();
+            expect(endTime - startTime).toBeLessThan(50);
+        });
+    });
+    describe('Error Handling', () => {
+        it('should handle factory errors gracefully', async () => {
+            createFeedbackRecord.mockRejectedValue(new Error('Factory error'));
+            await expect(feedbackAdapter.create(mockPayload, mockActorId))
+                .rejects.toThrow('Factory error');
+        });
+        it('should handle identity errors gracefully', async () => {
+            mockIdentityAdapter.signRecord.mockRejectedValue(new Error('Signing failed'));
+            await expect(feedbackAdapter.create(mockPayload, mockActorId))
+                .rejects.toThrow('Signing failed');
+        });
+        it('should handle store errors gracefully in resolve', async () => {
+            const existingFeedback = createMockFeedbackRecord({ status: 'open' });
+            mockFeedbackStore.read.mockResolvedValue(existingFeedback);
+            mockFeedbackStore.write.mockRejectedValue(new Error('Store error'));
+            await expect(feedbackAdapter.resolve('feedback-123', mockActorId))
+                .rejects.toThrow('Store error');
+        });
+    });
+});
+//# sourceMappingURL=feedback_adapter.test.js.map

package/dist/src/adapters/feedback_adapter/feedback_adapter.test.js.map

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

package/dist/src/adapters/feedback_adapter/index.d.ts

@@ -0,0 +1,95 @@
+import { RecordStore } from '../../store';
+import { IdentityAdapter } from '../identity_adapter';
+import type { FeedbackRecord } from '../../types';
+import type { IEventStream } from '../../event_bus';
+/**
+ * FeedbackAdapter Dependencies - Facade + Dependency Injection Pattern
+ */
+export interface FeedbackAdapterDependencies {
+    feedbackStore: RecordStore<FeedbackRecord>;
+    identity: IdentityAdapter;
+    eventBus: IEventStream;
+}
+/**
+ * FeedbackAdapter Interface - The Communication Facilitator
+ */
+export interface IFeedbackAdapter {
+    /**
+     * Creates a new FeedbackRecord.
+     */
+    create(payload: Partial<FeedbackRecord>, actorId: string): Promise<FeedbackRecord>;
+    /**
+     * Resolves an existing FeedbackRecord.
+     */
+    resolve(feedbackId: string, actorId: string): Promise<FeedbackRecord>;
+    /**
+     * Gets a specific FeedbackRecord by its ID.
+     */
+    getFeedback(feedbackId: string): Promise<FeedbackRecord | null>;
+    /**
+     * Gets all FeedbackRecords for a specific entity.
+     */
+    getFeedbackByEntity(entityId: string): Promise<FeedbackRecord[]>;
+    /**
+     * Gets all FeedbackRecords in the system.
+     */
+    getAllFeedback(): Promise<FeedbackRecord[]>;
+}
+/**
+ * FeedbackAdapter - The Communication Facilitator
+ *
+ * Implements Facade + Dependency Injection Pattern for testeable and configurable orchestration.
+ * Acts as Mediator between structured communication and data stores.
+ */
+export declare class FeedbackAdapter implements IFeedbackAdapter {
+    private feedbackStore;
+    private identity;
+    private eventBus;
+    constructor(dependencies: FeedbackAdapterDependencies);
+    /**
+     * [EARS-1] Creates a new FeedbackRecord for structured communication between actors.
+     *
+     * Description: Creates a new FeedbackRecord for structured communication between actors.
+     * Implementation: Builds record with status: "open", signs with actorId, persists and emits event.
+     * Usage: Invoked by `gitgov feedback add` to create feedback, assignments, blocks.
+     * Returns: Complete and signed FeedbackRecord.
+     */
+    create(payload: Partial<FeedbackRecord>, actorId: string): Promise<FeedbackRecord>;
+    /**
+     * [EARS-4] Resolves an existing feedback changing its status to resolved.
+     *
+     * Description: Resolves an existing feedback changing its status to resolved.
+     * Implementation: Reads feedback, validates permissions (future), transitions state, signs and emits event.
+     * Usage: Invoked by `gitgov feedback resolve` to close conversations and blocks.
+     * Returns: Updated FeedbackRecord with new signature.
+     */
+    resolve(feedbackId: string, actorId: string): Promise<FeedbackRecord>;
+    /**
+     * [EARS-7] Gets a specific FeedbackRecord by its ID for query.
+     *
+     * Description: Gets a specific FeedbackRecord by its ID for query.
+     * Implementation: Direct read from record store without modifications.
+     * Usage: Invoked by `gitgov feedback show` to display feedback details.
+     * Returns: FeedbackRecord found or null if it doesn't exist.
+     */
+    getFeedback(feedbackId: string): Promise<FeedbackRecord | null>;
+    /**
+     * [EARS-9] Gets all FeedbackRecords associated with a specific entity.
+     *
+     * Description: Gets all FeedbackRecords associated with a specific entity.
+     * Implementation: Reads all records and filters by matching entityId.
+     * Usage: Invoked by `gitgov feedback list` to display feedback for a task/cycle.
+     * Returns: Array of FeedbackRecords filtered for the entity.
+     */
+    getFeedbackByEntity(entityId: string): Promise<FeedbackRecord[]>;
+    /**
+     * [EARS-10] Gets all FeedbackRecords in the system for indexation.
+     *
+     * Description: Gets all FeedbackRecords in the system for complete indexation.
+     * Implementation: Complete read from record store without filters.
+     * Usage: Invoked by `gitgov feedback list --all` and by MetricsAdapter for calculations.
+     * Returns: Complete array of all FeedbackRecords.
+     */
+    getAllFeedback(): Promise<FeedbackRecord[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/adapters/feedback_adapter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/feedback_adapter/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAoD,MAAM,iBAAiB,CAAC;AAGtG;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAE1C,aAAa,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IAG3C,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEnF;;OAEG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEtE;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAEhE;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAEjE;;OAEG;IACH,cAAc,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAC7C;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,aAAa,CAA8B;IACnD,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,QAAQ,CAAe;gBAEnB,YAAY,EAAE,2BAA2B;IAMrD;;;;;;;OAOG;IACG,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAsExF;;;;;;;OAOG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAmD3E;;;;;;;OAOG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAKrE;;;;;;;OAOG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IActE;;;;;;;OAOG;IACG,cAAc,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;CAalD"}