driftdetect-core 0.4.1 → 0.4.2

package/dist/store/project-registry.d.ts

@@ -0,0 +1,241 @@
+/**
+ * Project Registry - Central index of all drift-initialized projects
+ *
+ * Maintains a global registry at ~/.drift/registry.json that tracks
+ * all projects where drift has been initialized. Enables multi-project
+ * workflows, project switching, and cross-project analysis.
+ *
+ * @requirements
+ * - Store project metadata in user home directory
+ * - Auto-register projects on drift init
+ * - Support project listing, switching, and removal
+ * - Track last accessed timestamps for MRU ordering
+ */
+import { EventEmitter } from 'node:events';
+/**
+ * Detected project framework/language
+ */
+export type ProjectFramework = 'react' | 'vue' | 'angular' | 'nextjs' | 'express' | 'fastapi' | 'django' | 'flask' | 'spring' | 'aspnet' | 'laravel' | 'rails' | 'unknown';
+/**
+ * Primary language of the project
+ */
+export type ProjectLanguage = 'typescript' | 'javascript' | 'python' | 'java' | 'csharp' | 'php' | 'ruby' | 'go' | 'rust' | 'mixed' | 'unknown';
+/**
+ * Project health status
+ */
+export type ProjectHealth = 'healthy' | 'warning' | 'critical' | 'unknown';
+/**
+ * Registered project entry
+ */
+export interface RegisteredProject {
+    /** Unique project identifier (UUID) */
+    id: string;
+    /** User-friendly project name */
+    name: string;
+    /** Absolute path to project root */
+    path: string;
+    /** Primary language */
+    language: ProjectLanguage;
+    /** Detected framework */
+    framework: ProjectFramework;
+    /** When project was first registered */
+    registeredAt: string;
+    /** When project was last accessed via drift */
+    lastAccessedAt: string;
+    /** Last scan timestamp */
+    lastScanAt?: string | undefined;
+    /** Pattern counts by status */
+    patternCounts?: {
+        discovered: number;
+        approved: number;
+        ignored: number;
+    } | undefined;
+    /** Overall health score (0-100) */
+    healthScore?: number | undefined;
+    /** Health status */
+    health?: ProjectHealth | undefined;
+    /** Custom tags for organization */
+    tags?: string[] | undefined;
+    /** Project description */
+    description?: string | undefined;
+    /** Git remote URL if available */
+    gitRemote?: string | undefined;
+    /** Whether project path still exists */
+    isValid?: boolean | undefined;
+}
+/**
+ * Registry file structure
+ */
+export interface ProjectRegistryFile {
+    version: string;
+    lastUpdated: string;
+    activeProjectId?: string | undefined;
+    projects: RegisteredProject[];
+}
+/**
+ * Registry configuration
+ */
+export interface ProjectRegistryConfig {
+    /** Custom registry path (default: ~/.drift/registry.json) */
+    registryPath?: string;
+    /** Auto-validate project paths on load */
+    validateOnLoad?: boolean;
+    /** Remove invalid projects automatically */
+    autoCleanup?: boolean;
+}
+/**
+ * Project registration options
+ */
+export interface ProjectRegistrationOptions {
+    /** Custom project name (default: directory name) */
+    name?: string | undefined;
+    /** Project description */
+    description?: string | undefined;
+    /** Custom tags */
+    tags?: string[] | undefined;
+    /** Override detected language */
+    language?: ProjectLanguage | undefined;
+    /** Override detected framework */
+    framework?: ProjectFramework | undefined;
+}
+/**
+ * Registry event types
+ */
+export type RegistryEventType = 'project:registered' | 'project:updated' | 'project:removed' | 'project:activated' | 'registry:loaded' | 'registry:saved';
+export interface RegistryEvent {
+    type: RegistryEventType;
+    timestamp: string;
+    projectId?: string | undefined;
+    projectName?: string | undefined;
+}
+/**
+ * Project Registry - Manages multi-project drift installations
+ */
+export declare class ProjectRegistry extends EventEmitter {
+    private readonly config;
+    private projects;
+    private activeProjectId?;
+    constructor(config?: ProjectRegistryConfig);
+    /**
+     * Initialize the registry (load from disk)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Ensure ~/.drift directory exists
+     */
+    private ensureRegistryDir;
+    /**
+     * Load registry from disk
+     */
+    load(): Promise<void>;
+    /**
+     * Save registry to disk
+     */
+    save(): Promise<void>;
+    /**
+     * Validate that a project path exists and has .drift folder
+     */
+    private validateProjectPath;
+    /**
+     * Register a new project
+     */
+    register(projectPath: string, options?: ProjectRegistrationOptions): Promise<RegisteredProject>;
+    /**
+     * Update project metadata
+     */
+    update(projectId: string, updates: Partial<Omit<RegisteredProject, 'id' | 'registeredAt'>>): Promise<RegisteredProject>;
+    /**
+     * Update last accessed timestamp
+     */
+    updateLastAccessed(projectId: string): Promise<RegisteredProject>;
+    /**
+     * Update pattern counts for a project
+     */
+    updatePatternCounts(projectId: string, counts: {
+        discovered: number;
+        approved: number;
+        ignored: number;
+    }): Promise<RegisteredProject>;
+    /**
+     * Update health score for a project
+     */
+    updateHealth(projectId: string, healthScore: number): Promise<RegisteredProject>;
+    /**
+     * Remove a project from registry
+     */
+    remove(projectId: string): Promise<boolean>;
+    /**
+     * Set the active project
+     */
+    setActive(projectId: string): Promise<RegisteredProject>;
+    /**
+     * Get the active project
+     */
+    getActive(): RegisteredProject | undefined;
+    /**
+     * Clear active project
+     */
+    clearActive(): Promise<void>;
+    /**
+     * Get a project by ID
+     */
+    get(projectId: string): RegisteredProject | undefined;
+    /**
+     * Find project by path
+     */
+    findByPath(projectPath: string): RegisteredProject | undefined;
+    /**
+     * Find project by name
+     */
+    findByName(name: string): RegisteredProject | undefined;
+    /**
+     * Get all projects
+     */
+    getAll(): RegisteredProject[];
+    /**
+     * Get projects sorted by last accessed (MRU)
+     */
+    getRecent(limit?: number): RegisteredProject[];
+    /**
+     * Get projects by language
+     */
+    getByLanguage(language: ProjectLanguage): RegisteredProject[];
+    /**
+     * Get projects by framework
+     */
+    getByFramework(framework: ProjectFramework): RegisteredProject[];
+    /**
+     * Get projects by tag
+     */
+    getByTag(tag: string): RegisteredProject[];
+    /**
+     * Get valid projects only
+     */
+    getValid(): RegisteredProject[];
+    /**
+     * Search projects by name or path
+     */
+    search(query: string): RegisteredProject[];
+    /**
+     * Get project count
+     */
+    get count(): number;
+    /**
+     * Validate all project paths
+     */
+    validateAll(): Promise<Map<string, boolean>>;
+    /**
+     * Remove all invalid projects
+     */
+    cleanup(): Promise<string[]>;
+    private emitEvent;
+}
+/**
+ * Get the global project registry instance
+ */
+export declare function getProjectRegistry(config?: ProjectRegistryConfig): Promise<ProjectRegistry>;
+/**
+ * Create a new project registry instance
+ */
+export declare function createProjectRegistry(config?: ProjectRegistryConfig): ProjectRegistry;
+//# sourceMappingURL=project-registry.d.ts.map

package/dist/store/project-registry.d.ts.map

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