@gitgov/core 1.0.0

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

@@ -0,0 +1,192 @@
+import { createFeedbackRecord } from '../../factories/feedback_factory';
+import { RecordStore } from '../../store';
+import { IdentityAdapter } from '../identity_adapter';
+/**
+ * FeedbackAdapter - The Communication Facilitator
+ *
+ * Implements Facade + Dependency Injection Pattern for testeable and configurable orchestration.
+ * Acts as Mediator between structured communication and data stores.
+ */
+export class FeedbackAdapter {
+    feedbackStore;
+    identity;
+    eventBus;
+    constructor(dependencies) {
+        this.feedbackStore = dependencies.feedbackStore;
+        this.identity = dependencies.identity;
+        this.eventBus = dependencies.eventBus;
+    }
+    /**
+     * [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.
+     */
+    async create(payload, actorId) {
+        // Input validation - Type-safe approach
+        const payloadWithEntityId = payload;
+        if (!payloadWithEntityId.entityId) {
+            throw new Error('RecordNotFoundError: entityId is required');
+        }
+        if (payloadWithEntityId.entityType && !['task', 'execution', 'changelog', 'feedback'].includes(payloadWithEntityId.entityType)) {
+            throw new Error('InvalidEntityTypeError: entityType must be task, execution, changelog, or feedback');
+        }
+        // Set default status to "open"
+        const enrichedPayload = {
+            ...payload,
+            status: 'open'
+        };
+        try {
+            // 1. Build the record with factory
+            const validatedPayload = await createFeedbackRecord(enrichedPayload);
+            // 2. Create unsigned record structure
+            const unsignedRecord = {
+                header: {
+                    version: '1.0',
+                    type: 'feedback',
+                    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.feedbackStore.write(signedRecord);
+            // 5. Emit event - responsibility ends here
+            this.eventBus.publish({
+                type: 'feedback.created',
+                timestamp: Date.now(),
+                source: 'feedback_adapter',
+                payload: {
+                    feedbackId: validatedPayload.id,
+                    entityType: validatedPayload.entityType,
+                    entityId: validatedPayload.entityId,
+                    type: validatedPayload.type,
+                    status: validatedPayload.status,
+                    content: validatedPayload.content,
+                    triggeredBy: actorId,
+                    assignee: validatedPayload.assignee
+                },
+            });
+            return validatedPayload;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('DetailedValidationError')) {
+                throw error;
+            }
+            throw error;
+        }
+    }
+    /**
+     * [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.
+     */
+    async resolve(feedbackId, actorId) {
+        // 1. Read the existing feedback
+        const existingRecord = await this.feedbackStore.read(feedbackId);
+        if (!existingRecord) {
+            throw new Error(`RecordNotFoundError: Feedback not found: ${feedbackId}`);
+        }
+        // 2. Check if already resolved
+        if (existingRecord.payload.status === 'resolved') {
+            throw new Error(`ProtocolViolationError: Feedback ${feedbackId} is already resolved`);
+        }
+        // 3. Update status to resolved
+        const updatedPayload = {
+            ...existingRecord.payload,
+            status: 'resolved'
+        };
+        try {
+            // 4. Create updated record structure
+            const updatedRecord = {
+                ...existingRecord,
+                payload: updatedPayload,
+            };
+            // 5. Sign the updated record
+            const signedRecord = await this.identity.signRecord(updatedRecord, actorId, 'resolver');
+            // 6. Persist the updated record
+            await this.feedbackStore.write(signedRecord);
+            // 7. Emit status changed event
+            this.eventBus.publish({
+                type: 'feedback.status.changed',
+                timestamp: Date.now(),
+                source: 'feedback_adapter',
+                payload: {
+                    feedbackId: updatedPayload.id,
+                    oldStatus: existingRecord.payload.status,
+                    newStatus: updatedPayload.status,
+                    triggeredBy: actorId,
+                    assignee: updatedPayload.assignee
+                },
+            });
+            return updatedPayload;
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    /**
+     * [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.
+     */
+    async getFeedback(feedbackId) {
+        const record = await this.feedbackStore.read(feedbackId);
+        return record ? record.payload : 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.
+     */
+    async getFeedbackByEntity(entityId) {
+        const ids = await this.feedbackStore.list();
+        const feedbacks = [];
+        for (const id of ids) {
+            const record = await this.feedbackStore.read(id);
+            if (record && record.payload.entityId === entityId) {
+                feedbacks.push(record.payload);
+            }
+        }
+        return feedbacks;
+    }
+    /**
+     * [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.
+     */
+    async getAllFeedback() {
+        const ids = await this.feedbackStore.list();
+        const feedbacks = [];
+        for (const id of ids) {
+            const record = await this.feedbackStore.read(id);
+            if (record) {
+                feedbacks.push(record.payload);
+            }
+        }
+        return feedbacks;
+    }
+}
+//# sourceMappingURL=index.js.map

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

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

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

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

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

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