@gitgov/core 1.0.0 → 1.0.2

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

@@ -1,192 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

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

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

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