@ginkoai/cli 1.0.0

package/dist/core/config-backup/project-detector.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-20
+ * @tags: [project, detection, existing, integration, paths]
+ * @related: [config-loader.ts, init.ts, config.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra, path, glob]
+ */
+import { ProjectDetectionConfig, ConfigPromptOption } from '../../types/config.js';
+/**
+ * Detects existing project structure and recommends configuration
+ */
+export declare class ProjectDetector {
+    /**
+     * Analyze existing project structure
+     */
+    analyzeProject(projectRoot?: string): Promise<ProjectDetectionConfig>;
+    /**
+     * Generate configuration options for interactive setup
+     */
+    generateConfigOptions(projectRoot?: string): Promise<ConfigPromptOption[]>;
+    /**
+     * Check for existing document types
+     */
+    private hasExistingDocuments;
+    /**
+     * Find all existing document paths
+     */
+    private findExistingDocumentPaths;
+    /**
+     * Get file patterns for document types
+     */
+    private getDocumentPatterns;
+    /**
+     * Generate recommended configuration based on analysis
+     */
+    private generateRecommendedConfig;
+    /**
+     * Find the best existing ADR path
+     */
+    private findBestAdrPath;
+    /**
+     * Find the best existing PRD path
+     */
+    private findBestPrdPath;
+    /**
+     * Validate that a project can support ginko integration
+     */
+    validateProjectCompatibility(projectRoot?: string): Promise<{
+        compatible: boolean;
+        issues: string[];
+        recommendations: string[];
+    }>;
+}
+export declare const projectDetector: ProjectDetector;
+//# sourceMappingURL=project-detector.d.ts.map

package/dist/core/config-backup/project-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detector.d.ts","sourceRoot":"","sources":["../../../src/core/config-backup/project-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAe,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhG;;GAEG;AACH,qBAAa,eAAe;IAE1B;;OAEG;IACG,cAAc,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAsB1F;;OAEG;IACG,qBAAqB,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA4D/F;;OAEG;YACW,oBAAoB;IAalC;;OAEG;YACW,yBAAyB;IAsBvC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmC3B;;OAEG;YACW,yBAAyB;IAyDvC;;OAEG;YACW,eAAe;IAwB7B;;OAEG;YACW,eAAe;IAwB7B;;OAEG;IACG,4BAA4B,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAAC;QAC/E,UAAU,EAAE,OAAO,CAAC;QACpB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;CAkCH;AAGD,eAAO,MAAM,eAAe,iBAAwB,CAAC"}

package/dist/core/config-backup/project-detector.js

@@ -0,0 +1,310 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-20
+ * @tags: [project, detection, existing, integration, paths]
+ * @related: [config-loader.ts, init.ts, config.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra, path, glob]
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { glob } from 'glob';
+/**
+ * Detects existing project structure and recommends configuration
+ */
+export class ProjectDetector {
+    /**
+     * Analyze existing project structure
+     */
+    async analyzeProject(projectRoot = process.cwd()) {
+        const hasDocsFolder = await fs.pathExists(path.join(projectRoot, 'docs'));
+        const hasExistingAdr = await this.hasExistingDocuments(projectRoot, 'adr');
+        const hasExistingPrd = await this.hasExistingDocuments(projectRoot, 'prd');
+        const existingPaths = await this.findExistingDocumentPaths(projectRoot);
+        const recommendedConfig = await this.generateRecommendedConfig(projectRoot, {
+            hasDocsFolder,
+            hasExistingAdr,
+            hasExistingPrd,
+            existingPaths
+        });
+        return {
+            hasDocsFolder,
+            hasExistingAdr,
+            hasExistingPrd,
+            existingPaths,
+            recommendedConfig
+        };
+    }
+    /**
+     * Generate configuration options for interactive setup
+     */
+    async generateConfigOptions(projectRoot = process.cwd()) {
+        const analysis = await this.analyzeProject(projectRoot);
+        const options = [];
+        if (analysis.hasDocsFolder) {
+            // Option 1: Use existing docs structure
+            options.push({
+                name: 'Use existing docs/ folder structure (recommended)',
+                value: 'existing-docs',
+                description: 'Works with your current documentation layout'
+            });
+            // Option 2: Create ginko subdirectory
+            options.push({
+                name: 'Create docs/ginko/ subdirectory (safe)',
+                value: {
+                    paths: {
+                        docs: {
+                            root: 'docs/ginko',
+                            adr: '${docs.root}/adr',
+                            prd: '${docs.root}/PRD',
+                            sprints: '${docs.root}/sprints'
+                        }
+                    }
+                },
+                description: 'Avoids conflicts with existing documentation'
+            });
+        }
+        else {
+            // Option 1: Standard docs layout
+            options.push({
+                name: 'Create standard docs/ structure (recommended)',
+                value: 'standard-docs',
+                description: 'Creates docs/adr, docs/PRD, docs/sprints'
+            });
+        }
+        // Option 3: Custom paths
+        options.push({
+            name: 'Custom paths...',
+            value: 'custom',
+            description: 'Configure custom documentation paths'
+        });
+        // Option 4: Minimal setup
+        options.push({
+            name: 'Minimal setup (no documentation paths)',
+            value: {
+                features: {
+                    autoCapture: true,
+                    gitIntegration: true,
+                    aiEnhancement: true,
+                    documentNaming: false
+                }
+            },
+            description: 'Only session and context tracking'
+        });
+        return options;
+    }
+    /**
+     * Check for existing document types
+     */
+    async hasExistingDocuments(projectRoot, type) {
+        const patterns = this.getDocumentPatterns(type);
+        for (const pattern of patterns) {
+            const files = await glob(pattern, { cwd: projectRoot, ignore: ['node_modules/**'] });
+            if (files.length > 0) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Find all existing document paths
+     */
+    async findExistingDocumentPaths(projectRoot) {
+        const paths = [];
+        const commonPaths = [
+            'docs', 'documentation', 'doc',
+            'adr', 'adrs', 'architecture', 'decisions',
+            'prd', 'requirements', 'specs', 'specifications',
+            'sprints', 'iterations', 'planning'
+        ];
+        for (const pathName of commonPaths) {
+            const fullPath = path.join(projectRoot, pathName);
+            if (await fs.pathExists(fullPath)) {
+                const stat = await fs.stat(fullPath);
+                if (stat.isDirectory()) {
+                    paths.push(pathName);
+                }
+            }
+        }
+        return paths;
+    }
+    /**
+     * Get file patterns for document types
+     */
+    getDocumentPatterns(type) {
+        switch (type.toLowerCase()) {
+            case 'adr':
+                return [
+                    '**/adr/**/*.md',
+                    '**/adrs/**/*.md',
+                    '**/architecture/**/*.md',
+                    '**/decisions/**/*.md',
+                    '**/*adr*.md',
+                    '**/*decision*.md'
+                ];
+            case 'prd':
+                return [
+                    '**/prd/**/*.md',
+                    '**/prds/**/*.md',
+                    '**/requirements/**/*.md',
+                    '**/specs/**/*.md',
+                    '**/*prd*.md',
+                    '**/*requirement*.md',
+                    '**/*spec*.md'
+                ];
+            case 'sprint':
+                return [
+                    '**/sprints/**/*.md',
+                    '**/sprint/**/*.md',
+                    '**/iterations/**/*.md',
+                    '**/planning/**/*.md',
+                    '**/*sprint*.md',
+                    '**/*iteration*.md'
+                ];
+            default:
+                return [];
+        }
+    }
+    /**
+     * Generate recommended configuration based on analysis
+     */
+    async generateRecommendedConfig(projectRoot, analysis) {
+        const config = {
+            version: "1.0.0",
+            features: {
+                autoCapture: true,
+                gitIntegration: true,
+                aiEnhancement: true,
+                documentNaming: true,
+                crossPlatform: true
+            }
+        };
+        // Configure paths based on existing structure
+        if (analysis.hasDocsFolder) {
+            // Use existing docs folder
+            config.paths = {
+                docs: {
+                    root: 'docs',
+                    adr: analysis.hasExistingAdr ? await this.findBestAdrPath(projectRoot) : '${docs.root}/adr',
+                    prd: analysis.hasExistingPrd ? await this.findBestPrdPath(projectRoot) : '${docs.root}/PRD',
+                    sprints: '${docs.root}/sprints'
+                },
+                ginko: {
+                    root: '.ginko',
+                    context: '${ginko.root}/context',
+                    sessions: '${ginko.root}/sessions',
+                    backlog: '${ginko.root}/backlog',
+                    patterns: '${ginko.root}/patterns',
+                    bestPractices: '${ginko.root}/best-practices'
+                }
+            };
+        }
+        else {
+            // Standard setup
+            config.paths = {
+                docs: {
+                    root: 'docs',
+                    adr: '${docs.root}/adr',
+                    prd: '${docs.root}/PRD',
+                    sprints: '${docs.root}/sprints'
+                },
+                ginko: {
+                    root: '.ginko',
+                    context: '${ginko.root}/context',
+                    sessions: '${ginko.root}/sessions',
+                    backlog: '${ginko.root}/backlog',
+                    patterns: '${ginko.root}/patterns',
+                    bestPractices: '${ginko.root}/best-practices'
+                }
+            };
+        }
+        return config;
+    }
+    /**
+     * Find the best existing ADR path
+     */
+    async findBestAdrPath(projectRoot) {
+        const possiblePaths = [
+            'docs/adr',
+            'docs/adrs',
+            'docs/architecture',
+            'docs/decisions',
+            'adr',
+            'adrs',
+            'architecture/decisions'
+        ];
+        for (const pathStr of possiblePaths) {
+            const fullPath = path.join(projectRoot, pathStr);
+            if (await fs.pathExists(fullPath)) {
+                const files = await glob('**/*.md', { cwd: fullPath });
+                if (files.length > 0) {
+                    return pathStr;
+                }
+            }
+        }
+        return '${docs.root}/adr'; // Default
+    }
+    /**
+     * Find the best existing PRD path
+     */
+    async findBestPrdPath(projectRoot) {
+        const possiblePaths = [
+            'docs/PRD',
+            'docs/prd',
+            'docs/requirements',
+            'docs/specs',
+            'requirements',
+            'specs',
+            'specifications'
+        ];
+        for (const pathStr of possiblePaths) {
+            const fullPath = path.join(projectRoot, pathStr);
+            if (await fs.pathExists(fullPath)) {
+                const files = await glob('**/*.md', { cwd: fullPath });
+                if (files.length > 0) {
+                    return pathStr;
+                }
+            }
+        }
+        return '${docs.root}/PRD'; // Default
+    }
+    /**
+     * Validate that a project can support ginko integration
+     */
+    async validateProjectCompatibility(projectRoot = process.cwd()) {
+        const issues = [];
+        const recommendations = [];
+        // Check if it's a git repository
+        const gitDir = path.join(projectRoot, '.git');
+        if (!await fs.pathExists(gitDir)) {
+            issues.push('Not a git repository');
+            recommendations.push('Run: git init');
+        }
+        // Check for existing .ginko directory
+        const ginkoDir = path.join(projectRoot, '.ginko');
+        if (await fs.pathExists(ginkoDir)) {
+            issues.push('Ginko already initialized');
+            recommendations.push('Use ginko config to modify settings');
+        }
+        // Check write permissions
+        try {
+            const testFile = path.join(projectRoot, '.ginko-test');
+            await fs.writeFile(testFile, 'test');
+            await fs.remove(testFile);
+        }
+        catch (error) {
+            issues.push('No write permissions to project directory');
+            recommendations.push('Check directory permissions');
+        }
+        return {
+            compatible: issues.length === 0,
+            issues,
+            recommendations
+        };
+    }
+}
+// Export singleton instance
+export const projectDetector = new ProjectDetector();
+//# sourceMappingURL=project-detector.js.map

package/dist/core/config-backup/project-detector.js.map

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

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

@@ -0,0 +1,97 @@
+/**
+ * @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 { Document, DocumentResult, BatchDocumentResult, DocumentSearchCriteria, DocumentOptions, TemplateVariables } from '../../types/documents.js';
+/**
+ * Central document management orchestrator
+ */
+export declare class DocumentManager {
+    private static instance;
+    private markdownProcessor;
+    private fileSystem;
+    private templateEngine;
+    private constructor();
+    static getInstance(): DocumentManager;
+    /**
+     * Load document from file
+     */
+    loadDocument(filePath: string, options?: DocumentOptions): Promise<DocumentResult>;
+    /**
+     * Save document to file
+     */
+    saveDocument(document: Document, filePath?: string, options?: DocumentOptions): Promise<DocumentResult>;
+    /**
+     * Create document from template
+     */
+    createFromTemplate(templateName: string, variables?: TemplateVariables, outputPath?: string): DocumentResult;
+    /**
+     * Search for documents
+     */
+    searchDocuments(criteria: DocumentSearchCriteria, baseDir?: string): Promise<string[]>;
+    /**
+     * Load multiple documents
+     */
+    loadDocuments(filePaths: string[], options?: DocumentOptions): Promise<BatchDocumentResult>;
+    /**
+     * Validate document
+     */
+    validateDocument(document: Document): {
+        valid: boolean;
+        errors: string[];
+        warnings: string[];
+    };
+    /**
+     * Get document statistics
+     */
+    getDocumentStats(document: Document): {
+        wordCount: number;
+        characterCount: number;
+        lineCount: number;
+        hasMetadata: boolean;
+        links: Array<{
+            text: string;
+            url: string;
+            type: 'internal' | 'external';
+        }>;
+        toc?: Array<{
+            level: number;
+            title: string;
+            anchor: string;
+        }>;
+    };
+    /**
+     * Copy document
+     */
+    copyDocument(sourcePath: string, destPath: string, options?: DocumentOptions): Promise<DocumentResult>;
+    /**
+     * Move document
+     */
+    moveDocument(sourcePath: string, destPath: string, options?: DocumentOptions): Promise<DocumentResult>;
+    /**
+     * Delete document
+     */
+    deleteDocument(filePath: string): Promise<DocumentResult>;
+    private loadJsonDocument;
+    private loadYamlDocument;
+    private loadTextDocument;
+    private generateMarkdownContent;
+    private generateJsonContent;
+    private generateYamlContent;
+    private extractJsonMetadata;
+    /**
+     * Initialize template directories
+     */
+    initializeTemplateDirectories(dirs: string[]): Promise<number>;
+    /**
+     * Get available templates
+     */
+    getAvailableTemplates(): DocumentTemplate[];
+}
+//# sourceMappingURL=document-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-manager.d.ts","sourceRoot":"","sources":["../../../src/core/documents/document-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,QAAQ,EAER,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EAElB,MAAM,0BAA0B,CAAC;AAKlC;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkB;IACzC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,cAAc,CAAiB;IAEvC,OAAO;WAMO,WAAW,IAAI,eAAe;IAO5C;;OAEG;IACU,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAuCnG;;OAEG;IACU,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IA6ExH;;OAEG;IACI,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,iBAAiB,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc;IAqBnH;;OAEG;IACU,eAAe,CAAC,QAAQ,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAInG;;OAEG;IACU,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA6B5G;;OAEG;IACI,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;IAkCrG;;OAEG;IACI,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG;QAC3C,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,OAAO,CAAC;QACrB,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAAA;SAAE,CAAC,CAAC;QAC3E,GAAG,CAAC,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC/D;IAwBD;;OAEG;IACU,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAoBvH;;OAEG;IACU,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC;IAyBvH;;OAEG;IACU,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;YAkBxD,gBAAgB;YAuBhB,gBAAgB;YAwBhB,gBAAgB;IAsB9B,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACU,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAe3E;;OAEG;IACI,qBAAqB;CAG7B"}