@ginkoai/cli 1.0.0 → 1.4.1

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

@@ -1,441 +0,0 @@
-/**
- * @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

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

@@ -1,138 +0,0 @@
-/**
- * @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

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