@ginkoai/cli 1.0.0

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

@@ -0,0 +1,225 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-19
+ * @tags: [document, naming, convention, sanitization]
+ * @related: [sequence-manager.ts, document-migrator.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [path]
+ */
+import * as path from 'path';
+/**
+ * Generates standardized document names following TYPE-###-description.md convention.
+ * Handles sanitization, collision detection, and ensures naming consistency.
+ */
+export class DocumentNamer {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Generate a standardized document name
+     */
+    async generateName(options) {
+        const { type, description, ensureUnique = true, customSequence } = options;
+        // Validate inputs
+        this.validateDocumentType(type);
+        this.validateDescription(description);
+        // Get sequence number
+        const sequenceNumber = customSequence !== undefined
+            ? customSequence
+            : await this.config.sequenceManager.getNext(type);
+        // Sanitize description
+        const sanitizedDescription = this.sanitizeDescription(description);
+        // Generate base filename
+        const baseFilename = this.formatFilename(type, sequenceNumber, sanitizedDescription);
+        let finalFilename = baseFilename;
+        let wasAdjusted = false;
+        let originalDescription;
+        // Check for uniqueness if required
+        if (ensureUnique) {
+            const adjustmentResult = await this.ensureUniqueness(type, baseFilename, sanitizedDescription, sequenceNumber);
+            finalFilename = adjustmentResult.filename;
+            wasAdjusted = adjustmentResult.wasAdjusted;
+            originalDescription = adjustmentResult.originalDescription;
+        }
+        // Generate full path
+        const fullPath = this.getFullPath(type, finalFilename);
+        return {
+            filename: finalFilename,
+            fullPath,
+            sequenceNumber,
+            wasAdjusted,
+            originalDescription
+        };
+    }
+    /**
+     * Parse an existing document name to extract components
+     */
+    parseDocumentName(filename) {
+        const match = filename.match(/^(ADR|PRD|SPRINT|STRATEGY)-(\d{3})-(.+)\.md$/);
+        if (!match) {
+            return null;
+        }
+        return {
+            type: match[1],
+            sequence: parseInt(match[2], 10),
+            description: match[3]
+        };
+    }
+    /**
+     * Check if a filename follows the standard naming convention
+     */
+    isStandardName(filename) {
+        return this.parseDocumentName(filename) !== null;
+    }
+    /**
+     * Generate a standard name from a non-standard filename
+     */
+    async standardizeName(type, originalFilename) {
+        // Extract description from original filename
+        const baseName = path.basename(originalFilename, '.md');
+        // Try to extract meaningful description
+        let description = baseName;
+        // Remove common prefixes that might exist
+        const prefixPatterns = [
+            new RegExp(`^${type}-?`, 'i'),
+            /^\d+-/,
+            /^[a-z]+-\d+-/i
+        ];
+        for (const pattern of prefixPatterns) {
+            description = description.replace(pattern, '');
+        }
+        // Clean up the description
+        description = description
+            .replace(/[-_]+/g, ' ')
+            .trim();
+        if (!description) {
+            description = 'untitled';
+        }
+        return this.generateName({
+            type,
+            description,
+            ensureUnique: true
+        });
+    }
+    /**
+     * Get the full path for a document type and filename
+     */
+    getFullPath(type, filename) {
+        const typeDirectories = {
+            'ADR': 'adr',
+            'PRD': 'PRD',
+            'SPRINT': 'sprints',
+            'STRATEGY': 'strategy'
+        };
+        const subDir = typeDirectories[type];
+        return path.join(this.config.docsRoot, subDir, filename);
+    }
+    /**
+     * Get the directory path for a document type
+     */
+    getTypeDirectory(type) {
+        const typeDirectories = {
+            'ADR': 'adr',
+            'PRD': 'PRD',
+            'SPRINT': 'sprints',
+            'STRATEGY': 'strategy'
+        };
+        return path.join(this.config.docsRoot, typeDirectories[type]);
+    }
+    /**
+     * Validate document type
+     */
+    validateDocumentType(type) {
+        const validTypes = ['ADR', 'PRD', 'SPRINT', 'STRATEGY'];
+        if (!validTypes.includes(type)) {
+            throw new Error(`Invalid document type: ${type}. Valid types are: ${validTypes.join(', ')}`);
+        }
+    }
+    /**
+     * Validate description
+     */
+    validateDescription(description) {
+        if (!description || typeof description !== 'string') {
+            throw new Error('Description is required and must be a string');
+        }
+        if (description.trim().length === 0) {
+            throw new Error('Description cannot be empty');
+        }
+        if (description.length > 100) {
+            throw new Error('Description too long (max 100 characters)');
+        }
+        // Check for invalid characters that could cause filesystem issues
+        const invalidChars = /[<>:"|?*\x00-\x1f]/;
+        if (invalidChars.test(description)) {
+            throw new Error('Description contains invalid characters');
+        }
+    }
+    /**
+     * Sanitize description for use in filename
+     */
+    sanitizeDescription(description) {
+        return description
+            .toLowerCase()
+            .trim()
+            // Replace spaces and underscores with hyphens
+            .replace(/[\s_]+/g, '-')
+            // Replace multiple hyphens with single hyphen
+            .replace(/-+/g, '-')
+            // Remove non-alphanumeric characters except hyphens
+            .replace(/[^a-z0-9-]/g, '')
+            // Remove leading and trailing hyphens
+            .replace(/^-+|-+$/g, '')
+            // Ensure we have something left
+            || 'untitled';
+    }
+    /**
+     * Format the complete filename
+     */
+    formatFilename(type, sequence, description) {
+        const paddedSequence = sequence.toString().padStart(3, '0');
+        return `${type}-${paddedSequence}-${description}.md`;
+    }
+    /**
+     * Ensure filename uniqueness by checking filesystem and adjusting if needed
+     */
+    async ensureUniqueness(type, baseFilename, sanitizedDescription, sequenceNumber) {
+        const fs = await import('fs-extra');
+        const fullPath = this.getFullPath(type, baseFilename);
+        // If file doesn't exist, we're good
+        if (!await fs.pathExists(fullPath)) {
+            return { filename: baseFilename, wasAdjusted: false };
+        }
+        // File exists, need to adjust
+        let attempt = 1;
+        let adjustedFilename;
+        let adjustedPath;
+        do {
+            const adjustedDescription = `${sanitizedDescription}-${attempt}`;
+            adjustedFilename = this.formatFilename(type, sequenceNumber, adjustedDescription);
+            adjustedPath = this.getFullPath(type, adjustedFilename);
+            attempt++;
+        } while (await fs.pathExists(adjustedPath) && attempt <= 100);
+        if (attempt > 100) {
+            throw new Error(`Could not generate unique filename for ${baseFilename} after 100 attempts`);
+        }
+        return {
+            filename: adjustedFilename,
+            wasAdjusted: true,
+            originalDescription: sanitizedDescription
+        };
+    }
+}
+/**
+ * Create a document namer instance
+ */
+export function createDocumentNamer(sequenceManager, docsRoot) {
+    return new DocumentNamer({
+        sequenceManager,
+        docsRoot,
+        strictMode: true
+    });
+}
+//# sourceMappingURL=document-namer.js.map

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

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

package/dist/core/documents/examples.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-19
+ * @tags: [document, examples, integration, demo]
+ * @related: [index.ts, document-namer.ts, document-migrator.ts]
+ * @priority: medium
+ * @complexity: low
+ * @dependencies: [all document management components]
+ */
+/**
+ * Example: Basic document naming
+ */
+export declare function exampleBasicNaming(ginkoRoot: string): Promise<{
+    adrResult: import("./document-namer.js").NameGenerationResult;
+    prdResult: import("./document-namer.js").NameGenerationResult;
+}>;
+/**
+ * Example: Complete project standardization
+ */
+export declare function exampleProjectStandardization(ginkoRoot: string): Promise<{
+    initialValidation: {
+        isCompliant: boolean;
+        nonCompliantFiles: string[];
+        issues: string[];
+    };
+    migrationResult: import("./document-migrator.js").MigrationResult | null;
+    finalValidation: {
+        isCompliant: boolean;
+        nonCompliantFiles: string[];
+        issues: string[];
+    };
+}>;
+/**
+ * Example: Advanced system usage with sequence management
+ */
+export declare function exampleAdvancedUsage(ginkoRoot: string): Promise<{
+    customResult: import("./document-namer.js").NameGenerationResult;
+    normalResult1: import("./document-namer.js").NameGenerationResult;
+    normalResult2: import("./document-namer.js").NameGenerationResult;
+    strategyResult: import("./document-namer.js").NameGenerationResult;
+    finalSequences: Record<import("./sequence-manager.js").DocumentType, number>;
+}>;
+/**
+ * Example: Error handling and edge cases
+ */
+export declare function exampleErrorHandling(ginkoRoot: string): Promise<{
+    specialCharsResult: import("./document-namer.js").NameGenerationResult;
+    parsedNames: {
+        name: string;
+        parsed: {
+            type: import("./sequence-manager.js").DocumentType;
+            sequence: number;
+            description: string;
+        } | null;
+    }[];
+}>;
+/**
+ * Example: CLI integration demonstration
+ */
+export declare function exampleCLIIntegration(ginkoRoot: string): Promise<{
+    migrationPlan: import("./document-migrator.js").MigrationResult;
+    newDocResult: import("./document-namer.js").NameGenerationResult;
+    validation: {
+        isCompliant: boolean;
+        nonCompliantFiles: string[];
+        issues: string[];
+    };
+}>;
+/**
+ * Run all examples
+ */
+export declare function runAllExamples(ginkoRoot: string): Promise<void>;
+//# sourceMappingURL=examples.d.ts.map

package/dist/core/documents/examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../../../src/core/documents/examples.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM;;;GAyBzD;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;GAqDpE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM;;;;;;GAsE3D;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;GAkE3D;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM;;;;;;;;GAmD5D;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,iBAuBrD"}

package/dist/core/documents/examples.js

@@ -0,0 +1,273 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-19
+ * @tags: [document, examples, integration, demo]
+ * @related: [index.ts, document-namer.ts, document-migrator.ts]
+ * @priority: medium
+ * @complexity: low
+ * @dependencies: [all document management components]
+ */
+import { createDocumentManagementSystem, createBasicDocumentNamer, validateDocumentNaming, standardizeProjectDocuments } from './index.js';
+/**
+ * Example: Basic document naming
+ */
+export async function exampleBasicNaming(ginkoRoot) {
+    console.log('=== Basic Document Naming Example ===');
+    const { namer } = await createBasicDocumentNamer(ginkoRoot);
+    // Generate standard document names
+    const adrResult = await namer.generateName({
+        type: 'ADR',
+        description: 'microservices architecture decision',
+        ensureUnique: true
+    });
+    const prdResult = await namer.generateName({
+        type: 'PRD',
+        description: 'user authentication system',
+        ensureUnique: true
+    });
+    console.log('Generated names:');
+    console.log(`- ADR: ${adrResult.filename}`);
+    console.log(`- PRD: ${prdResult.filename}`);
+    console.log(`- ADR Path: ${adrResult.fullPath}`);
+    console.log(`- PRD Path: ${prdResult.fullPath}`);
+    return { adrResult, prdResult };
+}
+/**
+ * Example: Complete project standardization
+ */
+export async function exampleProjectStandardization(ginkoRoot) {
+    console.log('=== Project Standardization Example ===');
+    // Step 1: Validate current state
+    console.log('1. Validating current document naming...');
+    const initialValidation = await validateDocumentNaming(ginkoRoot);
+    console.log(`- Compliant: ${initialValidation.isCompliant}`);
+    console.log(`- Non-compliant files: ${initialValidation.nonCompliantFiles.length}`);
+    if (initialValidation.nonCompliantFiles.length > 0) {
+        console.log('- Files to rename:');
+        initialValidation.nonCompliantFiles.forEach(file => console.log(`  - ${file}`));
+    }
+    // Step 2: Preview migration (dry run)
+    console.log('\n2. Previewing migration plan...');
+    const dryRunResult = await standardizeProjectDocuments(ginkoRoot, { dryRun: true });
+    console.log(`- Operations planned: ${dryRunResult.operations.length}`);
+    dryRunResult.operations.forEach(op => {
+        console.log(`  - ${op.originalFilename} → ${op.newFilename}`);
+    });
+    // Step 3: Execute migration
+    if (dryRunResult.operations.length > 0) {
+        console.log('\n3. Executing migration...');
+        const migrationResult = await standardizeProjectDocuments(ginkoRoot, {
+            updateReferences: true
+        });
+        console.log(`- Successful migrations: ${migrationResult.successfulMigrations}`);
+        console.log(`- References updated: ${migrationResult.referencesUpdated.length}`);
+        console.log(`- Backup created: ${migrationResult.backupDirectory}`);
+        if (migrationResult.errors.length > 0) {
+            console.log('- Errors:');
+            migrationResult.errors.forEach(error => {
+                console.log(`  - ${error.file}: ${error.error}`);
+            });
+        }
+    }
+    // Step 4: Final validation
+    console.log('\n4. Final validation...');
+    const finalValidation = await validateDocumentNaming(ginkoRoot);
+    console.log(`- Final compliance: ${finalValidation.isCompliant}`);
+    return {
+        initialValidation,
+        migrationResult: dryRunResult.operations.length > 0 ? await standardizeProjectDocuments(ginkoRoot) : null,
+        finalValidation
+    };
+}
+/**
+ * Example: Advanced system usage with sequence management
+ */
+export async function exampleAdvancedUsage(ginkoRoot) {
+    console.log('=== Advanced System Usage Example ===');
+    const system = await createDocumentManagementSystem({
+        ginkoRoot,
+        updateReferences: true,
+        startingNumbers: { ADR: 100, PRD: 200 }
+    });
+    await system.initialize();
+    console.log('1. Initial sequence numbers:');
+    const initialSequences = await system.sequenceManager.getAllSequences();
+    Object.entries(initialSequences).forEach(([type, number]) => {
+        console.log(`- ${type}: ${number}`);
+    });
+    console.log('\n2. Generating documents with custom sequences...');
+    // Generate document with custom sequence
+    const customResult = await system.documentNamer.generateName({
+        type: 'ADR',
+        description: 'special architecture decision',
+        customSequence: 999,
+        ensureUnique: true
+    });
+    console.log(`- Custom sequence document: ${customResult.filename}`);
+    // Generate normal sequence documents
+    const normalResult1 = await system.documentNamer.generateName({
+        type: 'ADR',
+        description: 'normal sequence document',
+        ensureUnique: true
+    });
+    const normalResult2 = await system.documentNamer.generateName({
+        type: 'PRD',
+        description: 'product requirements document',
+        ensureUnique: true
+    });
+    console.log(`- Normal ADR: ${normalResult1.filename}`);
+    console.log(`- Normal PRD: ${normalResult2.filename}`);
+    console.log('\n3. Current sequence numbers:');
+    const currentSequences = await system.sequenceManager.getAllSequences();
+    Object.entries(currentSequences).forEach(([type, number]) => {
+        console.log(`- ${type}: ${number}`);
+    });
+    // Demonstrate sequence management
+    console.log('\n4. Setting custom sequence for STRATEGY...');
+    await system.sequenceManager.setSequence('STRATEGY', 50);
+    const strategyResult = await system.documentNamer.generateName({
+        type: 'STRATEGY',
+        description: 'business strategy document',
+        ensureUnique: true
+    });
+    console.log(`- Strategy document: ${strategyResult.filename}`);
+    return {
+        customResult,
+        normalResult1,
+        normalResult2,
+        strategyResult,
+        finalSequences: await system.sequenceManager.getAllSequences()
+    };
+}
+/**
+ * Example: Error handling and edge cases
+ */
+export async function exampleErrorHandling(ginkoRoot) {
+    console.log('=== Error Handling Examples ===');
+    const { namer } = await createBasicDocumentNamer(ginkoRoot);
+    console.log('1. Testing invalid inputs...');
+    try {
+        await namer.generateName({
+            type: 'INVALID',
+            description: 'test',
+            ensureUnique: false
+        });
+    }
+    catch (error) {
+        console.log(`- Invalid document type error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+    try {
+        await namer.generateName({
+            type: 'ADR',
+            description: '',
+            ensureUnique: false
+        });
+    }
+    catch (error) {
+        console.log(`- Empty description error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+    try {
+        await namer.generateName({
+            type: 'ADR',
+            description: 'a'.repeat(101),
+            ensureUnique: false
+        });
+    }
+    catch (error) {
+        console.log(`- Long description error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+    console.log('\n2. Testing special characters handling...');
+    const specialCharsResult = await namer.generateName({
+        type: 'ADR',
+        description: 'Special!@#$%Characters & Spaces',
+        ensureUnique: false
+    });
+    console.log(`- Special chars sanitized: ${specialCharsResult.filename}`);
+    console.log('\n3. Testing name parsing...');
+    const testNames = [
+        'ADR-001-valid-name.md',
+        'PRD-042-another-valid.md',
+        'invalid-name.md',
+        'ADR-1-too-short.md',
+        'adr-001-lowercase.md'
+    ];
+    testNames.forEach(name => {
+        const parsed = namer.parseDocumentName(name);
+        console.log(`- "${name}" → ${parsed ? `${parsed.type}-${parsed.sequence}-${parsed.description}` : 'INVALID'}`);
+    });
+    return {
+        specialCharsResult,
+        parsedNames: testNames.map(name => ({ name, parsed: namer.parseDocumentName(name) }))
+    };
+}
+/**
+ * Example: CLI integration demonstration
+ */
+export async function exampleCLIIntegration(ginkoRoot) {
+    console.log('=== CLI Integration Example ===');
+    console.log('This demonstrates how the document management system');
+    console.log('would integrate with ginko CLI commands:');
+    console.log('\n1. `ginko rename --standardize` command simulation:');
+    const result = await standardizeProjectDocuments(ginkoRoot, { dryRun: true });
+    if (result.operations.length === 0) {
+        console.log('✅ All documents already follow standard naming convention');
+    }
+    else {
+        console.log('📋 Documents to be renamed:');
+        result.operations.forEach(op => {
+            console.log(`   ${op.originalFilename} → ${op.newFilename}`);
+        });
+        console.log('\nRun without --dry-run to execute the migration');
+    }
+    console.log('\n2. `ginko reflect` command integration:');
+    const system = await createDocumentManagementSystem({ ginkoRoot });
+    await system.initialize();
+    const newDocResult = await system.documentNamer.generateName({
+        type: 'ADR',
+        description: 'ai-powered-code-reflection',
+        ensureUnique: true
+    });
+    console.log(`   Generated name for new reflection: ${newDocResult.filename}`);
+    console.log(`   Full path: ${newDocResult.fullPath}`);
+    console.log('\n3. Document validation check:');
+    const validation = await validateDocumentNaming(ginkoRoot);
+    console.log(`   Project compliance: ${validation.isCompliant ? '✅ COMPLIANT' : '❌ NON-COMPLIANT'}`);
+    if (!validation.isCompliant) {
+        console.log(`   Non-compliant files: ${validation.nonCompliantFiles.length}`);
+        validation.nonCompliantFiles.slice(0, 3).forEach(file => {
+            console.log(`     - ${file}`);
+        });
+        if (validation.nonCompliantFiles.length > 3) {
+            console.log(`     ... and ${validation.nonCompliantFiles.length - 3} more`);
+        }
+    }
+    return {
+        migrationPlan: result,
+        newDocResult,
+        validation
+    };
+}
+/**
+ * Run all examples
+ */
+export async function runAllExamples(ginkoRoot) {
+    console.log('🚀 Document Management System Examples\n');
+    try {
+        await exampleBasicNaming(ginkoRoot);
+        console.log('\n' + '='.repeat(50) + '\n');
+        await exampleAdvancedUsage(ginkoRoot);
+        console.log('\n' + '='.repeat(50) + '\n');
+        await exampleErrorHandling(ginkoRoot);
+        console.log('\n' + '='.repeat(50) + '\n');
+        await exampleProjectStandardization(ginkoRoot);
+        console.log('\n' + '='.repeat(50) + '\n');
+        await exampleCLIIntegration(ginkoRoot);
+        console.log('\n✅ All examples completed successfully!');
+    }
+    catch (error) {
+        console.error('❌ Example failed:', error instanceof Error ? error.message : 'Unknown error');
+        throw error;
+    }
+}
+//# sourceMappingURL=examples.js.map

package/dist/core/documents/examples.js.map

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