@lovelybunch/core 1.0.3

package/dist/unified-storage.js

@@ -0,0 +1,199 @@
+import { FileStorageAdapter } from './storage.js';
+import { MarkdownStorageAdapter } from './markdown-storage.js';
+import { migrationManager } from './migration.js';
+/**
+ * Unified storage adapter that automatically detects and handles both JSON and Markdown formats
+ * Provides backward compatibility during the migration period
+ */
+export class UnifiedStorageAdapter {
+    jsonStorage;
+    markdownStorage;
+    preferredFormat;
+    constructor(basePath = '.gait', preferredFormat = 'markdown') {
+        this.jsonStorage = new FileStorageAdapter(basePath);
+        this.markdownStorage = new MarkdownStorageAdapter(basePath);
+        this.preferredFormat = preferredFormat;
+    }
+    async init() {
+        // Initialize both storage adapters
+        await this.jsonStorage.init();
+        await this.markdownStorage.init();
+    }
+    async saveProposal(proposal) {
+        // Save using preferred format
+        if (this.preferredFormat === 'markdown') {
+            await this.markdownStorage.saveProposal(proposal);
+        }
+        else {
+            await this.jsonStorage.saveProposal(proposal);
+        }
+    }
+    async loadProposal(id) {
+        // Try to load from both formats, preferring the configured format
+        if (this.preferredFormat === 'markdown') {
+            // Try markdown first, then JSON as fallback
+            const markdownProposal = await this.markdownStorage.loadProposal(id);
+            if (markdownProposal) {
+                return markdownProposal;
+            }
+            return await this.jsonStorage.loadProposal(id);
+        }
+        else {
+            // Try JSON first, then markdown as fallback
+            const jsonProposal = await this.jsonStorage.loadProposal(id);
+            if (jsonProposal) {
+                return jsonProposal;
+            }
+            return await this.markdownStorage.loadProposal(id);
+        }
+    }
+    async loadAllProposals() {
+        // Load from both formats and merge, avoiding duplicates
+        const [jsonProposals, markdownProposals] = await Promise.all([
+            this.jsonStorage.loadAllProposals(),
+            this.markdownStorage.loadAllProposals()
+        ]);
+        // Create a map to avoid duplicates (prefer the configured format)
+        const proposalMap = new Map();
+        // Add proposals from non-preferred format first
+        const nonPreferredProposals = this.preferredFormat === 'markdown' ? jsonProposals : markdownProposals;
+        const preferredProposals = this.preferredFormat === 'markdown' ? markdownProposals : jsonProposals;
+        nonPreferredProposals.forEach(proposal => {
+            proposalMap.set(proposal.id, proposal);
+        });
+        // Add proposals from preferred format (will overwrite duplicates)
+        preferredProposals.forEach(proposal => {
+            proposalMap.set(proposal.id, proposal);
+        });
+        return Array.from(proposalMap.values());
+    }
+    async deleteProposal(id) {
+        // Delete from both formats to ensure cleanup
+        const [jsonDeleted, markdownDeleted] = await Promise.all([
+            this.jsonStorage.deleteProposal(id),
+            this.markdownStorage.deleteProposal(id)
+        ]);
+        return jsonDeleted || markdownDeleted;
+    }
+    async saveConfig(config) {
+        // Config is always saved as JSON for now
+        await this.jsonStorage.saveConfig(config);
+    }
+    async loadConfig() {
+        return await this.jsonStorage.loadConfig();
+    }
+    async isInitialized() {
+        return await this.jsonStorage.isInitialized();
+    }
+    getBasePath() {
+        return this.jsonStorage.getBasePath();
+    }
+    /**
+     * Get the current storage format being used
+     */
+    async getCurrentFormat() {
+        return await migrationManager.detectCurrentFormat();
+    }
+    /**
+     * Set the preferred format for new proposals
+     */
+    setPreferredFormat(format) {
+        this.preferredFormat = format;
+    }
+    /**
+     * Get the preferred format
+     */
+    getPreferredFormat() {
+        return this.preferredFormat;
+    }
+    /**
+     * Auto-migrate to preferred format if needed
+     */
+    async autoMigrate(options = {}) {
+        const currentFormat = await this.getCurrentFormat();
+        // No migration needed if already using preferred format or no proposals exist
+        if (currentFormat === this.preferredFormat || currentFormat === 'none') {
+            return true;
+        }
+        // Don't auto-migrate mixed format without force
+        if (currentFormat === 'mixed' && !options.force) {
+            return false;
+        }
+        try {
+            if (this.preferredFormat === 'markdown') {
+                const result = await migrationManager.migrateToMarkdown({
+                    backupOriginals: true,
+                    dryRun: false
+                });
+                return result.success;
+            }
+            else {
+                const result = await migrationManager.migrateToJson({
+                    backupOriginals: true,
+                    dryRun: false
+                });
+                return result.success;
+            }
+        }
+        catch (error) {
+            console.error('Auto-migration failed:', error);
+            return false;
+        }
+    }
+    /**
+     * Get storage statistics
+     */
+    async getStorageStats() {
+        const stats = await migrationManager.getMigrationStats();
+        return {
+            ...stats,
+            preferredFormat: this.preferredFormat
+        };
+    }
+    /**
+     * Validate storage integrity
+     */
+    async validateStorage() {
+        const issues = [];
+        const duplicates = [];
+        try {
+            const [jsonProposals, markdownProposals] = await Promise.all([
+                this.jsonStorage.loadAllProposals(),
+                this.markdownStorage.loadAllProposals()
+            ]);
+            // Check for duplicates
+            const jsonIds = new Set(jsonProposals.map(p => p.id));
+            const markdownIds = new Set(markdownProposals.map(p => p.id));
+            for (const id of jsonIds) {
+                if (markdownIds.has(id)) {
+                    duplicates.push(id);
+                }
+            }
+            if (duplicates.length > 0) {
+                issues.push(`Found ${duplicates.length} duplicate proposals across formats: ${duplicates.join(', ')}`);
+            }
+            // Validate each proposal can be loaded
+            const allProposals = await this.loadAllProposals();
+            for (const proposal of allProposals) {
+                if (!proposal.id || !proposal.intent || !proposal.author) {
+                    issues.push(`Proposal ${proposal.id || 'unknown'} is missing required fields`);
+                }
+            }
+            return {
+                valid: issues.length === 0,
+                issues,
+                duplicates
+            };
+        }
+        catch (error) {
+            return {
+                valid: false,
+                issues: [`Storage validation failed: ${error}`],
+                duplicates: []
+            };
+        }
+    }
+}
+// Export a singleton instance with markdown as preferred format
+export const unifiedStorage = new UnifiedStorageAdapter('.gait', 'markdown');
+//# sourceMappingURL=unified-storage.js.map

package/dist/unified-storage.js.map

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

package/dist/validation.d.ts

@@ -0,0 +1,62 @@
+import type { ChangeProposal, Author, PlanStep, Evidence, FeatureFlag, Experiment } from '@lovelybunch/types';
+export interface ValidationError {
+    field: string;
+    message: string;
+    severity: 'error' | 'warning';
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationError[];
+}
+/**
+ * Comprehensive validation utilities for GAIT data structures
+ */
+export declare class ValidationManager {
+    /**
+     * Validate a Change Proposal
+     */
+    validateChangeProposal(proposal: ChangeProposal): ValidationResult;
+    /**
+     * Validate an Author
+     */
+    validateAuthor(author: Author): ValidationResult;
+    /**
+     * Validate a Plan Step
+     */
+    validatePlanStep(step: PlanStep, index: number): ValidationResult;
+    /**
+     * Validate Evidence
+     */
+    validateEvidence(evidence: Evidence, index: number): ValidationResult;
+    /**
+     * Validate Feature Flag
+     */
+    validateFeatureFlag(flag: FeatureFlag, index: number): ValidationResult;
+    /**
+     * Validate Experiment
+     */
+    validateExperiment(experiment: Experiment, index: number): ValidationResult;
+    /**
+     * Validate YAML frontmatter structure
+     */
+    validateYamlFrontmatter(frontmatter: any): ValidationResult;
+    /**
+     * Validate markdown content structure
+     */
+    validateMarkdownContent(content: string): ValidationResult;
+    /**
+     * Helper method to validate email format
+     */
+    private isValidEmail;
+    /**
+     * Helper method to validate ISO date format
+     */
+    private isValidISODate;
+    /**
+     * Format validation results for display
+     */
+    formatValidationResults(result: ValidationResult): string;
+}
+export declare const validationManager: ValidationManager;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEvG,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAE5B;;OAEG;IACH,sBAAsB,CAAC,QAAQ,EAAE,cAAc,GAAG,gBAAgB;IA4HlE;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB;IA2ChD;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAoDjE;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB;IA4CrE;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB;IAqEvE;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB;IA8D3E;;OAEG;IACH,uBAAuB,CAAC,WAAW,EAAE,GAAG,GAAG,gBAAgB;IA6C3D;;OAEG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB;IA+C1D;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,uBAAuB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM;CAyB1D;AAGD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}