@gitgov/core 1.0.0 → 1.0.2

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/indexer_adapter/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,eAAe,GAAG,mBAAmB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,cAAc,CAAC;IACnH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IAEvC,cAAc,EAAE,cAAc,CAAC;IAG/B,SAAS,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IACnC,UAAU,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IACrC,aAAa,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;IAC5C,cAAc,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;IAC9C,cAAc,CAAC,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;IAC9C,UAAU,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IAGtC,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAE;QACR,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;QACjD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;QAC1C,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,OAAO,EAAE,YAAY,GAAG,mBAAmB,GAAG,oBAAoB,CAAC;IACnE,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,aAAa,EAAE,kBAAkB,EAAE,CAAC;IACpC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC1C,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,mBAAmB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,aAAa,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAChD,YAAY,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAC1C,iBAAiB,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9C,wBAAwB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC3E,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvL,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC5F,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,cAAc,CAA2C;IACjE,OAAO,CAAC,cAAc,CAA2C;IACjE,OAAO,CAAC,UAAU,CAAuC;IACzD,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,SAAS,CAAS;gBAEd,YAAY,EAAE,0BAA0B;IAmBpD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,qBAAqB,CAAC;IA+GrD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAyB/C;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,eAAe,CAAC;IAiEnD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IA+BzC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAatC;;OAEG;YACW,YAAY;IAc1B;;OAEG;YACW,aAAa;IAc3B;;OAEG;YACW,aAAa;IAkB3B;;OAEG;YACW,eAAe;IAkB7B;;OAEG;YACW,iBAAiB;IAkB/B;;OAEG;YACW,iBAAiB;IAkB/B;;OAEG;YACW,cAAc;IAU5B;;OAEG;YACW,eAAe;IAS7B;;OAEG;YACW,gBAAgB;IAS9B;;OAEG;YACW,gBAAgB;IAS9B;;OAEG;IACG,wBAAwB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAwHhF;;;OAGG;IACG,oBAAoB,CACxB,IAAI,EAAE,UAAU,EAChB,cAAc,EAAE,UAAU,GACzB,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,kBAAkB,CAAC,kBAAkB,CAAC,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAwFrH;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAWjG;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAc3B"}