@gitgov/core 1.0.0

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

@@ -0,0 +1,214 @@
+import { RecordStore } from '../../store';
+import { MetricsAdapter } from '../metrics_adapter';
+import type { TaskRecord } from '../../types';
+import type { CycleRecord } from '../../types';
+import type { FeedbackRecord } from '../../types';
+import type { ExecutionRecord } from '../../types';
+import type { ChangelogRecord } from '../../types';
+import type { ActorRecord } from '../../types';
+import type { SystemStatus, ProductivityMetrics, CollaborationMetrics } from '../metrics_adapter';
+import type { ActivityEvent } from '../../event_bus';
+export type AllRecords = {
+    tasks: TaskRecord[];
+    cycles: CycleRecord[];
+    feedback: FeedbackRecord[];
+    executions: ExecutionRecord[];
+    changelogs: ChangelogRecord[];
+    actors: ActorRecord[];
+};
+/**
+ * Enhanced Task Record with calculated activity metadata
+ * Used by Dashboard for intelligent sorting and display
+ */
+export type EnrichedTaskRecord = TaskRecord & {
+    lastUpdated: number;
+    lastActivityType: 'task_modified' | 'feedback_received' | 'execution_added' | 'changelog_created' | 'task_created';
+    recentActivity?: string;
+};
+/**
+ * IndexerAdapter Dependencies - Facade + Dependency Injection Pattern
+ */
+export type IndexerAdapterDependencies = {
+    metricsAdapter: MetricsAdapter;
+    taskStore: RecordStore<TaskRecord>;
+    cycleStore: RecordStore<CycleRecord>;
+    feedbackStore?: RecordStore<FeedbackRecord>;
+    executionStore?: RecordStore<ExecutionRecord>;
+    changelogStore?: RecordStore<ChangelogRecord>;
+    actorStore?: RecordStore<ActorRecord>;
+    cacheStrategy?: "json" | "sqlite" | "dual";
+    cachePath?: string;
+};
+/**
+ * Return types specific to the adapter
+ */
+export type IndexData = {
+    metadata: {
+        generatedAt: string;
+        lastCommitHash: string;
+        integrityStatus: "valid" | "warnings" | "errors";
+        recordCounts: Record<string, number>;
+        cacheStrategy: "json" | "sqlite" | "dual";
+        generationTime: number;
+    };
+    metrics: SystemStatus & ProductivityMetrics & CollaborationMetrics;
+    activityHistory: ActivityEvent[];
+    tasks: TaskRecord[];
+    enrichedTasks: EnrichedTaskRecord[];
+    cycles: CycleRecord[];
+    actors: ActorRecord[];
+};
+export type IntegrityReport = {
+    status: "valid" | "warnings" | "errors";
+    recordsScanned: number;
+    errorsFound: IntegrityError[];
+    warningsFound: IntegrityWarning[];
+    validationTime: number;
+    checksumFailures: number;
+    signatureFailures: number;
+};
+export type IndexGenerationReport = {
+    success: boolean;
+    recordsProcessed: number;
+    metricsCalculated: number;
+    generationTime: number;
+    cacheSize: number;
+    cacheStrategy: "json" | "sqlite" | "dual";
+    errors: string[];
+    performance: {
+        readTime: number;
+        calculationTime: number;
+        writeTime: number;
+    };
+};
+export type IntegrityError = {
+    type: 'schema_violation' | 'checksum_failure' | 'signature_invalid';
+    recordId: string;
+    message: string;
+};
+export type IntegrityWarning = {
+    type: 'missing_reference' | 'deprecated_field' | 'performance_issue';
+    recordId: string;
+    message: string;
+};
+/**
+ * IndexerAdapter Interface - The Cache Engine
+ */
+export interface IIndexerAdapter {
+    generateIndex(): Promise<IndexGenerationReport>;
+    getIndexData(): Promise<IndexData | null>;
+    validateIntegrity(): Promise<IntegrityReport>;
+    calculateActivityHistory(allRecords: AllRecords): Promise<ActivityEvent[]>;
+    calculateLastUpdated(task: TaskRecord, relatedRecords: AllRecords): Promise<{
+        lastUpdated: number;
+        lastActivityType: EnrichedTaskRecord['lastActivityType'];
+        recentActivity: string;
+    }>;
+    enrichTaskRecord(task: TaskRecord, relatedRecords: AllRecords): Promise<EnrichedTaskRecord>;
+    isIndexUpToDate(): Promise<boolean>;
+    invalidateCache(): Promise<void>;
+}
+/**
+ * FileIndexerAdapter - Phase 1 Implementation
+ *
+ * File-based cache implementation using .gitgov/index.json
+ * Optimized for teams with <500 records
+ */
+export declare class FileIndexerAdapter implements IIndexerAdapter {
+    private metricsAdapter;
+    private taskStore;
+    private cycleStore;
+    private feedbackStore;
+    private executionStore;
+    private changelogStore;
+    private actorStore;
+    private cacheStrategy;
+    private cachePath;
+    constructor(dependencies: IndexerAdapterDependencies);
+    /**
+     * [EARS-1] Generates complete index from raw Records with MetricsAdapter integration
+     */
+    generateIndex(): Promise<IndexGenerationReport>;
+    /**
+     * [EARS-2] Gets data from local cache for fast CLI queries
+     */
+    getIndexData(): Promise<IndexData | null>;
+    /**
+     * [EARS-4] Validates integrity of Records without regenerating cache
+     */
+    validateIntegrity(): Promise<IntegrityReport>;
+    /**
+     * [EARS-5] Checks if index is up to date by comparing timestamps
+     */
+    isIndexUpToDate(): Promise<boolean>;
+    /**
+     * [EARS-6] Invalidates local cache by removing cache files
+     */
+    invalidateCache(): Promise<void>;
+    /**
+     * Reads all tasks from taskStore
+     */
+    private readAllTasks;
+    /**
+     * Reads all cycles from cycleStore
+     */
+    private readAllCycles;
+    /**
+     * Reads all actors from actorStore (graceful degradation)
+     */
+    private readAllActors;
+    /**
+     * Reads all feedback from feedbackStore (graceful degradation)
+     */
+    private readAllFeedback;
+    /**
+     * Reads all executions from executionStore (graceful degradation)
+     */
+    private readAllExecutions;
+    /**
+     * Reads all changelogs from changelogStore (graceful degradation)
+     */
+    private readAllChangelogs;
+    /**
+     * Writes cache data to file (Phase 1: JSON)
+     */
+    private writeCacheFile;
+    /**
+     * Checks if cache file exists
+     */
+    private cacheFileExists;
+    /**
+     * Gets cache file size in bytes
+     */
+    private getCacheFileSize;
+    /**
+     * Gets current git commit hash (simplified)
+     */
+    private getGitCommitHash;
+    /**
+     * [EARS-19] Calculates activity history from Record timestamps for dashboard activity streams
+     */
+    calculateActivityHistory(allRecords: AllRecords): Promise<ActivityEvent[]>;
+    /**
+     * [EARS-21] Calculate lastUpdated timestamp and activity type for a task
+     * Considers task file modification time and related records timestamps
+     */
+    calculateLastUpdated(task: TaskRecord, relatedRecords: AllRecords): Promise<{
+        lastUpdated: number;
+        lastActivityType: EnrichedTaskRecord['lastActivityType'];
+        recentActivity: string;
+    }>;
+    /**
+     * [EARS-22] Enrich a TaskRecord with activity metadata
+     */
+    enrichTaskRecord(task: TaskRecord, relatedRecords: AllRecords): Promise<EnrichedTaskRecord>;
+    /**
+     * Format timestamp as human-readable time ago
+     */
+    private formatTimeAgo;
+    /**
+     * Extracts timestamp from ID (format: {timestamp}-{type}-{slug})
+     */
+    private getTimestampFromId;
+}
+//# sourceMappingURL=index.d.ts.map

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

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