@ginkoai/cli 1.0.0

package/dist/core/documents/document-manager.js

@@ -0,0 +1,441 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-22
+ * @tags: [documents, manager, orchestration, markdown, templates, filesystem]
+ * @related: [markdown-processor.ts, file-system.ts, template-engine.ts, ../../types/documents.ts]
+ * @priority: critical
+ * @complexity: high
+ * @dependencies: [fs-extra, path, gray-matter, marked]
+ */
+import * as path from 'path';
+import { MarkdownProcessor } from './markdown-processor.js';
+import { DocumentFileSystem } from './file-system.js';
+import { TemplateEngine } from './template-engine.js';
+/**
+ * Central document management orchestrator
+ */
+export class DocumentManager {
+    static instance;
+    markdownProcessor;
+    fileSystem;
+    templateEngine;
+    constructor() {
+        this.markdownProcessor = MarkdownProcessor.getInstance();
+        this.fileSystem = DocumentFileSystem.getInstance();
+        this.templateEngine = TemplateEngine.getInstance();
+    }
+    static getInstance() {
+        if (!DocumentManager.instance) {
+            DocumentManager.instance = new DocumentManager();
+        }
+        return DocumentManager.instance;
+    }
+    /**
+     * Load document from file
+     */
+    async loadDocument(filePath, options = {}) {
+        try {
+            const absolutePath = this.fileSystem.getAbsolutePath(filePath);
+            const format = this.fileSystem.getDocumentFormat(absolutePath);
+            if (!format) {
+                return {
+                    success: false,
+                    error: `Unsupported file format: ${path.extname(filePath)}`
+                };
+            }
+            switch (format) {
+                case 'md':
+                    return await this.markdownProcessor.parseFile(absolutePath, options);
+                case 'json':
+                    return await this.loadJsonDocument(absolutePath, options);
+                case 'yaml':
+                    return await this.loadYamlDocument(absolutePath, options);
+                case 'txt':
+                    return await this.loadTextDocument(absolutePath, options);
+                default:
+                    return {
+                        success: false,
+                        error: `Unsupported document format: ${format}`
+                    };
+            }
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to load document: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * Save document to file
+     */
+    async saveDocument(document, filePath, options = {}) {
+        try {
+            const targetPath = filePath || document.path;
+            if (!targetPath) {
+                return {
+                    success: false,
+                    error: 'No file path specified'
+                };
+            }
+            const absolutePath = this.fileSystem.getAbsolutePath(targetPath);
+            const format = document.format || this.fileSystem.getDocumentFormat(absolutePath);
+            if (!format) {
+                return {
+                    success: false,
+                    error: `Cannot determine document format for: ${targetPath}`
+                };
+            }
+            let content;
+            switch (format) {
+                case 'md':
+                    content = this.generateMarkdownContent(document);
+                    break;
+                case 'json':
+                    content = this.generateJsonContent(document);
+                    break;
+                case 'yaml':
+                    content = this.generateYamlContent(document);
+                    break;
+                case 'txt':
+                    content = document.content;
+                    break;
+                default:
+                    return {
+                        success: false,
+                        error: `Unsupported document format: ${format}`
+                    };
+            }
+            const writeResult = await this.fileSystem.writeFile(absolutePath, content, options);
+            if (!writeResult.success) {
+                return {
+                    success: false,
+                    error: writeResult.error
+                };
+            }
+            // Update document path and metadata
+            const updatedDocument = {
+                ...document,
+                path: absolutePath,
+                metadata: {
+                    ...document.metadata,
+                    updated: new Date()
+                }
+            };
+            return {
+                success: true,
+                document: updatedDocument
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to save document: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * Create document from template
+     */
+    createFromTemplate(templateName, variables, outputPath) {
+        try {
+            const result = this.templateEngine.generateDocument(templateName, variables);
+            if (!result.success || !result.document) {
+                return result;
+            }
+            if (outputPath) {
+                result.document.path = this.fileSystem.getAbsolutePath(outputPath);
+            }
+            return result;
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to create document from template: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * Search for documents
+     */
+    async searchDocuments(criteria, baseDir) {
+        return await this.fileSystem.findFiles(criteria, baseDir);
+    }
+    /**
+     * Load multiple documents
+     */
+    async loadDocuments(filePaths, options = {}) {
+        const results = [];
+        let processed = 0;
+        let failed = 0;
+        const errors = [];
+        for (const filePath of filePaths) {
+            const result = await this.loadDocument(filePath, options);
+            results.push(result);
+            if (result.success) {
+                processed++;
+            }
+            else {
+                failed++;
+                if (result.error) {
+                    errors.push(`${filePath}: ${result.error}`);
+                }
+            }
+        }
+        return {
+            success: failed === 0,
+            processed,
+            failed,
+            results,
+            errors
+        };
+    }
+    /**
+     * Validate document
+     */
+    validateDocument(document) {
+        const errors = [];
+        const warnings = [];
+        // Basic validation
+        if (!document.content || document.content.trim() === '') {
+            errors.push('Document content is empty');
+        }
+        if (!document.format) {
+            errors.push('Document format is not specified');
+        }
+        // Format-specific validation
+        if (document.format === 'md') {
+            const markdownValidation = this.markdownProcessor.validateMarkdown(document.content);
+            errors.push(...markdownValidation.errors);
+            warnings.push(...markdownValidation.warnings);
+            // Validate frontmatter if present
+            if (document.raw) {
+                const frontmatterValidation = this.markdownProcessor.validateFrontmatter(document.metadata);
+                errors.push(...frontmatterValidation.errors);
+                warnings.push(...frontmatterValidation.warnings);
+            }
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings
+        };
+    }
+    /**
+     * Get document statistics
+     */
+    getDocumentStats(document) {
+        const content = document.content;
+        const wordCount = content.split(/\s+/).filter(word => word.length > 0).length;
+        const characterCount = content.length;
+        const lineCount = content.split('\n').length;
+        const hasMetadata = Object.keys(document.metadata).length > 0;
+        const stats = {
+            wordCount,
+            characterCount,
+            lineCount,
+            hasMetadata,
+            links: []
+        };
+        // Extract links and TOC for markdown
+        if (document.format === 'md') {
+            stats.links = this.markdownProcessor.extractLinks(content);
+            stats.toc = this.markdownProcessor.extractTableOfContents(content);
+        }
+        return stats;
+    }
+    /**
+     * Copy document
+     */
+    async copyDocument(sourcePath, destPath, options = {}) {
+        try {
+            const sourceDoc = await this.loadDocument(sourcePath, options);
+            if (!sourceDoc.success || !sourceDoc.document) {
+                return sourceDoc;
+            }
+            // Update metadata
+            sourceDoc.document.metadata.created = new Date();
+            sourceDoc.document.metadata.updated = new Date();
+            return await this.saveDocument(sourceDoc.document, destPath, options);
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to copy document: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * Move document
+     */
+    async moveDocument(sourcePath, destPath, options = {}) {
+        try {
+            const copyResult = await this.copyDocument(sourcePath, destPath, options);
+            if (!copyResult.success) {
+                return copyResult;
+            }
+            // Delete source file
+            const deleteResult = await this.fileSystem.deleteFile(sourcePath);
+            if (!deleteResult.success) {
+                return {
+                    success: false,
+                    error: `Failed to delete source file: ${deleteResult.error}`
+                };
+            }
+            return copyResult;
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to move document: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * Delete document
+     */
+    async deleteDocument(filePath) {
+        try {
+            const result = await this.fileSystem.deleteFile(filePath);
+            return {
+                success: result.success,
+                error: result.error
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to delete document: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    // Private helper methods
+    async loadJsonDocument(filePath, options) {
+        try {
+            const content = await import('fs-extra').then(fs => fs.readFile(filePath, options.encoding || 'utf8'));
+            const jsonData = JSON.parse(content);
+            return {
+                success: true,
+                document: {
+                    path: filePath,
+                    format: 'json',
+                    metadata: this.extractJsonMetadata(jsonData),
+                    content: JSON.stringify(jsonData, null, 2),
+                    raw: content
+                }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to parse JSON: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    async loadYamlDocument(filePath, options) {
+        try {
+            const content = await import('fs-extra').then(fs => fs.readFile(filePath, options.encoding || 'utf8'));
+            // For now, treat YAML as plain text
+            // In the future, we could add yaml parsing if needed
+            return {
+                success: true,
+                document: {
+                    path: filePath,
+                    format: 'yaml',
+                    metadata: {},
+                    content,
+                    raw: content
+                }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to load YAML: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    async loadTextDocument(filePath, options) {
+        try {
+            const content = await import('fs-extra').then(fs => fs.readFile(filePath, options.encoding || 'utf8'));
+            return {
+                success: true,
+                document: {
+                    path: filePath,
+                    format: 'txt',
+                    metadata: {},
+                    content,
+                    raw: content
+                }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: `Failed to load text document: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    generateMarkdownContent(document) {
+        if (document.metadata && Object.keys(document.metadata).length > 0) {
+            return this.markdownProcessor.generateMarkdown(document.metadata, document.content);
+        }
+        return document.content;
+    }
+    generateJsonContent(document) {
+        const jsonData = {
+            metadata: document.metadata,
+            content: document.content
+        };
+        return JSON.stringify(jsonData, null, 2);
+    }
+    generateYamlContent(document) {
+        // For now, just return content as-is
+        // In the future, we could add proper YAML serialization
+        return document.content;
+    }
+    extractJsonMetadata(jsonData) {
+        const metadata = {};
+        if (jsonData.metadata) {
+            return jsonData.metadata;
+        }
+        // Extract common fields
+        if (jsonData.title)
+            metadata.title = jsonData.title;
+        if (jsonData.description)
+            metadata.description = jsonData.description;
+        if (jsonData.author)
+            metadata.author = jsonData.author;
+        if (jsonData.created)
+            metadata.created = new Date(jsonData.created);
+        if (jsonData.updated)
+            metadata.updated = new Date(jsonData.updated);
+        if (jsonData.version)
+            metadata.version = jsonData.version;
+        return metadata;
+    }
+    /**
+     * Initialize template directories
+     */
+    async initializeTemplateDirectories(dirs) {
+        let totalLoaded = 0;
+        for (const dir of dirs) {
+            try {
+                const loaded = await this.templateEngine.loadTemplatesFromDirectory(dir);
+                totalLoaded += loaded;
+            }
+            catch (error) {
+                console.error(`Failed to load templates from ${dir}:`, error);
+            }
+        }
+        return totalLoaded;
+    }
+    /**
+     * Get available templates
+     */
+    getAvailableTemplates() {
+        return this.templateEngine.listTemplates();
+    }
+}
+//# sourceMappingURL=document-manager.js.map

package/dist/core/documents/document-manager.js.map

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

package/dist/core/documents/document-migrator.d.ts

@@ -0,0 +1,138 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-19
+ * @tags: [document, migration, rename, references, atomic]
+ * @related: [document-namer.ts, sequence-manager.ts]
+ * @priority: high
+ * @complexity: high
+ * @dependencies: [fs-extra, path, glob]
+ */
+import { DocumentType, SequenceManager } from './sequence-manager.js';
+import { DocumentNamer } from './document-namer.js';
+/**
+ * Configuration for document migration
+ */
+export interface DocumentMigratorConfig {
+    /** Document namer for generating new names */
+    documentNamer: DocumentNamer;
+    /** Sequence manager for tracking numbers */
+    sequenceManager: SequenceManager;
+    /** Root directory containing docs */
+    docsRoot: string;
+    /** Whether to update references in other documents */
+    updateReferences?: boolean;
+    /** Backup directory for original files */
+    backupDir?: string;
+}
+/**
+ * A single file migration operation
+ */
+export interface MigrationOperation {
+    /** Original file path */
+    originalPath: string;
+    /** New file path after migration */
+    newPath: string;
+    /** Original filename */
+    originalFilename: string;
+    /** New filename */
+    newFilename: string;
+    /** Document type */
+    type: DocumentType;
+    /** Migration reason */
+    reason: string;
+    /** Whether this is a safe operation */
+    isSafe: boolean;
+}
+/**
+ * Result of a migration preview or execution
+ */
+export interface MigrationResult {
+    /** Operations that were planned/executed */
+    operations: MigrationOperation[];
+    /** Files that had references updated */
+    referencesUpdated: string[];
+    /** Total files processed */
+    totalFiles: number;
+    /** Files that were successfully migrated */
+    successfulMigrations: number;
+    /** Errors encountered */
+    errors: Array<{
+        file: string;
+        error: string;
+    }>;
+    /** Whether any changes were made */
+    hasChanges: boolean;
+    /** Backup directory if created */
+    backupDirectory?: string;
+}
+/**
+ * Reference found in a document
+ */
+export interface DocumentReference {
+    /** File containing the reference */
+    filePath: string;
+    /** Line number (1-based) */
+    lineNumber: number;
+    /** Full line content */
+    lineContent: string;
+    /** Original filename being referenced */
+    referencedFile: string;
+    /** Type of reference (link, relative path, etc.) */
+    referenceType: 'markdown-link' | 'relative-path' | 'absolute-path';
+}
+/**
+ * Migrates documents to standardized naming convention and updates references.
+ * Provides safe atomic operations with rollback capability.
+ */
+export declare class DocumentMigrator {
+    private config;
+    constructor(config: DocumentMigratorConfig);
+    /**
+     * Scan directories and generate a migration plan
+     */
+    generateMigrationPlan(): Promise<MigrationResult>;
+    /**
+     * Execute migration plan with atomic operations
+     */
+    executeMigration(dryRun?: boolean): Promise<MigrationResult>;
+    /**
+     * Find all references to files that will be migrated
+     */
+    findAllReferences(operations: MigrationOperation[]): Promise<DocumentReference[]>;
+    /**
+     * Find references to a specific file in a line of text
+     */
+    private findReferencesInLine;
+    /**
+     * Update references in files
+     */
+    private updateReferences;
+    /**
+     * Create backup of files before migration
+     */
+    private createBackup;
+    /**
+     * Execute a single migration operation
+     */
+    private executeOperation;
+    /**
+     * Rollback migration using backup
+     */
+    private rollback;
+    /**
+     * Validate migration safety
+     */
+    validateMigration(): Promise<{
+        isValid: boolean;
+        issues: string[];
+    }>;
+}
+/**
+ * Create a document migrator instance
+ */
+export declare function createDocumentMigrator(documentNamer: DocumentNamer, sequenceManager: SequenceManager, docsRoot: string, options?: {
+    updateReferences?: boolean;
+    backupDir?: string;
+}): DocumentMigrator;
+//# sourceMappingURL=document-migrator.d.ts.map

package/dist/core/documents/document-migrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-migrator.d.ts","sourceRoot":"","sources":["../../../src/core/documents/document-migrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAwB,MAAM,qBAAqB,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,aAAa,EAAE,aAAa,CAAC;IAC7B,4CAA4C;IAC5C,eAAe,EAAE,eAAe,CAAC;IACjC,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,IAAI,EAAE,YAAY,CAAC;IACnB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,wCAAwC;IACxC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,yBAAyB;IACzB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,oCAAoC;IACpC,UAAU,EAAE,OAAO,CAAC;IACpB,kCAAkC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,aAAa,EAAE,eAAe,GAAG,eAAe,GAAG,eAAe,CAAC;CACpE;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAyB;gBAE3B,MAAM,EAAE,sBAAsB;IAI1C;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,eAAe,CAAC;IA2DvD;;OAEG;IACG,gBAAgB,CAAC,MAAM,GAAE,OAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAsEzE;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA+BvF;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAiD5B;;OAEG;YACW,gBAAgB;IAmD9B;;OAEG;YACW,YAAY;IAkB1B;;OAEG;YACW,gBAAgB;IAQ9B;;OAEG;YACW,QAAQ;IAiBtB;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAqC3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,aAAa,EAC5B,eAAe,EAAE,eAAe,EAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D,gBAAgB,CAQlB"}