@ginkoai/cli 1.0.0

package/dist/core/config/path-resolver.d.ts

@@ -0,0 +1,151 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-19
+ * @tags: [path, resolver, variables, substitution, cross-platform]
+ * @related: [config-schema.ts, config-loader.ts]
+ * @priority: critical
+ * @complexity: high
+ * @dependencies: [path, os]
+ */
+/**
+ * Path Resolution with Variable Substitution
+ * Supports ${variable} syntax with cross-platform compatibility
+ * Implements ADR-028 First-Use Experience Enhancement Architecture
+ */
+export interface ResolverContext {
+    /** Base variables available for substitution */
+    variables: Record<string, string>;
+    /** Environment variables (process.env) */
+    env: Record<string, string | undefined>;
+    /** Platform information */
+    platform: {
+        type: 'windows' | 'macos' | 'linux';
+        separator: string;
+        homeDir: string;
+    };
+}
+export interface ResolutionResult {
+    /** Resolved path */
+    resolved: string;
+    /** Original template path */
+    original: string;
+    /** Variables that were substituted */
+    substituted: Array<{
+        variable: string;
+        value: string;
+    }>;
+    /** Variables that were not found */
+    missing: string[];
+    /** Whether resolution was successful */
+    success: boolean;
+    /** Any errors encountered */
+    errors: string[];
+}
+export declare class CircularReferenceError extends Error {
+    constructor(variable: string, path: string[]);
+}
+export declare class VariableNotFoundError extends Error {
+    constructor(variable: string, availableVars: string[]);
+}
+/**
+ * PathResolver handles variable substitution in configuration paths
+ */
+export declare class PathResolver {
+    private context;
+    private resolutionCache;
+    constructor(context: ResolverContext);
+    /**
+     * Create a PathResolver with platform detection
+     */
+    static create(variables?: Record<string, string>): PathResolver;
+    /**
+     * Detect the current platform
+     */
+    static detectPlatform(): 'windows' | 'macos' | 'linux';
+    /**
+     * Resolve a path with variable substitution
+     */
+    resolve(pathTemplate: string): ResolutionResult;
+    /**
+     * Resolve multiple paths at once
+     */
+    resolveMultiple(pathTemplates: Record<string, string>): Record<string, ResolutionResult>;
+    /**
+     * Internal resolution logic
+     */
+    private doResolve;
+    /**
+     * Extract variables from a path template
+     */
+    private extractVariables;
+    /**
+     * Get the value of a variable with recursive resolution
+     */
+    private getVariableValue;
+    /**
+     * Check if a string contains variables
+     */
+    private hasVariables;
+    /**
+     * Normalize path for the current platform
+     */
+    private normalizePath;
+    /**
+     * Escape special regex characters
+     */
+    private escapeRegex;
+    /**
+     * Generate cache key for path template
+     */
+    private getCacheKey;
+    /**
+     * Update the resolver context
+     */
+    updateContext(newVariables: Record<string, string>): void;
+    /**
+     * Get all available variables
+     */
+    getAvailableVariables(): string[];
+    /**
+     * Validate that all variables in a path can be resolved
+     */
+    validatePath(pathTemplate: string): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Get resolution statistics
+     */
+    getStats(): {
+        cacheSize: number;
+        availableVariables: number;
+        platformInfo: typeof this.context.platform;
+    };
+    /**
+     * Clear the resolution cache
+     */
+    clearCache(): void;
+}
+/**
+ * Utility functions for path resolution
+ */
+export declare namespace PathResolverUtils {
+    /**
+     * Check if a path template is valid (contains only supported variable syntax)
+     */
+    function isValidTemplate(pathTemplate: string): boolean;
+    /**
+     * Extract all unique variables from a set of path templates
+     */
+    function extractAllVariables(pathTemplates: Record<string, string>): string[];
+    /**
+     * Create a dependency graph of variables
+     */
+    function createDependencyGraph(pathTemplates: Record<string, string>): Record<string, string[]>;
+    /**
+     * Detect potential circular references in path templates
+     */
+    function detectCircularReferences(pathTemplates: Record<string, string>): string[];
+}
+//# sourceMappingURL=path-resolver.d.ts.map

package/dist/core/config/path-resolver.d.ts.map

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

package/dist/core/config/path-resolver.js

@@ -0,0 +1,343 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-09-19
+ * @tags: [path, resolver, variables, substitution, cross-platform]
+ * @related: [config-schema.ts, config-loader.ts]
+ * @priority: critical
+ * @complexity: high
+ * @dependencies: [path, os]
+ */
+import * as path from 'path';
+import * as os from 'os';
+export class CircularReferenceError extends Error {
+    constructor(variable, path) {
+        super(`Circular reference detected: ${variable} -> ${path.join(' -> ')}`);
+        this.name = 'CircularReferenceError';
+    }
+}
+export class VariableNotFoundError extends Error {
+    constructor(variable, availableVars) {
+        super(`Variable '${variable}' not found. Available: ${availableVars.join(', ')}`);
+        this.name = 'VariableNotFoundError';
+    }
+}
+/**
+ * PathResolver handles variable substitution in configuration paths
+ */
+export class PathResolver {
+    context;
+    resolutionCache = new Map();
+    constructor(context) {
+        this.context = context;
+    }
+    /**
+     * Create a PathResolver with platform detection
+     */
+    static create(variables = {}) {
+        const platform = {
+            type: PathResolver.detectPlatform(),
+            separator: path.sep,
+            homeDir: os.homedir()
+        };
+        const context = {
+            variables: {
+                // Built-in variables
+                'platform.home': platform.homeDir,
+                'platform.sep': platform.separator,
+                'platform.type': platform.type,
+                // User-provided variables
+                ...variables
+            },
+            env: process.env,
+            platform
+        };
+        return new PathResolver(context);
+    }
+    /**
+     * Detect the current platform
+     */
+    static detectPlatform() {
+        switch (process.platform) {
+            case 'win32': return 'windows';
+            case 'darwin': return 'macos';
+            default: return 'linux';
+        }
+    }
+    /**
+     * Resolve a path with variable substitution
+     */
+    resolve(pathTemplate) {
+        // Check cache first
+        const cacheKey = this.getCacheKey(pathTemplate);
+        if (this.resolutionCache.has(cacheKey)) {
+            return this.resolutionCache.get(cacheKey);
+        }
+        const result = this.doResolve(pathTemplate);
+        // Cache successful resolutions
+        if (result.success) {
+            this.resolutionCache.set(cacheKey, result);
+        }
+        return result;
+    }
+    /**
+     * Resolve multiple paths at once
+     */
+    resolveMultiple(pathTemplates) {
+        const results = {};
+        for (const [key, template] of Object.entries(pathTemplates)) {
+            results[key] = this.resolve(template);
+        }
+        return results;
+    }
+    /**
+     * Internal resolution logic
+     */
+    doResolve(pathTemplate, visited = new Set()) {
+        const result = {
+            resolved: pathTemplate,
+            original: pathTemplate,
+            substituted: [],
+            missing: [],
+            success: true,
+            errors: []
+        };
+        try {
+            // Find all variables in the template
+            const variables = this.extractVariables(pathTemplate);
+            if (variables.length === 0) {
+                // No variables to substitute, normalize the path
+                result.resolved = this.normalizePath(pathTemplate);
+                return result;
+            }
+            // Check for circular references
+            for (const variable of variables) {
+                if (visited.has(variable)) {
+                    throw new CircularReferenceError(variable, Array.from(visited));
+                }
+            }
+            let resolvedPath = pathTemplate;
+            // Substitute each variable
+            for (const variable of variables) {
+                const value = this.getVariableValue(variable, visited);
+                if (value === undefined) {
+                    result.missing.push(variable);
+                    result.success = false;
+                    continue;
+                }
+                const pattern = new RegExp(`\\$\\{${this.escapeRegex(variable)}\\}`, 'g');
+                resolvedPath = resolvedPath.replace(pattern, value);
+                result.substituted.push({ variable, value });
+            }
+            if (result.success) {
+                result.resolved = this.normalizePath(resolvedPath);
+            }
+        }
+        catch (error) {
+            result.success = false;
+            result.errors.push(error instanceof Error ? error.message : 'Unknown error');
+        }
+        return result;
+    }
+    /**
+     * Extract variables from a path template
+     */
+    extractVariables(pathTemplate) {
+        const variablePattern = /\$\{([^}]+)\}/g;
+        const variables = [];
+        let match;
+        while ((match = variablePattern.exec(pathTemplate)) !== null) {
+            variables.push(match[1]);
+        }
+        return variables;
+    }
+    /**
+     * Get the value of a variable with recursive resolution
+     */
+    getVariableValue(variable, visited) {
+        // Check environment variables first
+        if (variable.startsWith('env.')) {
+            const envVar = variable.substring(4);
+            return this.context.env[envVar];
+        }
+        // Check context variables
+        const value = this.context.variables[variable];
+        if (value === undefined) {
+            return undefined;
+        }
+        // If the value contains variables, resolve them recursively
+        if (this.hasVariables(value)) {
+            const newVisited = new Set([...visited, variable]);
+            const result = this.doResolve(value, newVisited);
+            return result.success ? result.resolved : undefined;
+        }
+        return value;
+    }
+    /**
+     * Check if a string contains variables
+     */
+    hasVariables(str) {
+        return /\$\{[^}]+\}/.test(str);
+    }
+    /**
+     * Normalize path for the current platform
+     */
+    normalizePath(pathStr) {
+        // Convert path separators to platform-specific
+        let normalized = pathStr.replace(/[\/\\]/g, path.sep);
+        // Resolve relative paths
+        normalized = path.resolve(normalized);
+        return normalized;
+    }
+    /**
+     * Escape special regex characters
+     */
+    escapeRegex(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+    /**
+     * Generate cache key for path template
+     */
+    getCacheKey(pathTemplate) {
+        // Include variables in cache key to handle context changes
+        const varsHash = JSON.stringify(this.context.variables);
+        return `${pathTemplate}:${varsHash}`;
+    }
+    /**
+     * Update the resolver context
+     */
+    updateContext(newVariables) {
+        this.context.variables = { ...this.context.variables, ...newVariables };
+        this.resolutionCache.clear(); // Clear cache when context changes
+    }
+    /**
+     * Get all available variables
+     */
+    getAvailableVariables() {
+        return [
+            ...Object.keys(this.context.variables),
+            ...Object.keys(this.context.env).map(key => `env.${key}`)
+        ];
+    }
+    /**
+     * Validate that all variables in a path can be resolved
+     */
+    validatePath(pathTemplate) {
+        const result = this.resolve(pathTemplate);
+        if (result.success) {
+            return { valid: true, errors: [] };
+        }
+        const errors = [];
+        if (result.missing.length > 0) {
+            errors.push(`Missing variables: ${result.missing.join(', ')}`);
+        }
+        errors.push(...result.errors);
+        return { valid: false, errors };
+    }
+    /**
+     * Get resolution statistics
+     */
+    getStats() {
+        return {
+            cacheSize: this.resolutionCache.size,
+            availableVariables: this.getAvailableVariables().length,
+            platformInfo: this.context.platform
+        };
+    }
+    /**
+     * Clear the resolution cache
+     */
+    clearCache() {
+        this.resolutionCache.clear();
+    }
+}
+/**
+ * Utility functions for path resolution
+ */
+export var PathResolverUtils;
+(function (PathResolverUtils) {
+    /**
+     * Check if a path template is valid (contains only supported variable syntax)
+     */
+    function isValidTemplate(pathTemplate) {
+        // Check for balanced braces
+        const openBraces = (pathTemplate.match(/\$\{/g) || []).length;
+        const closeBraces = (pathTemplate.match(/\}/g) || []).length;
+        if (openBraces !== closeBraces) {
+            return false;
+        }
+        // Check for valid variable names (alphanumeric, dots, underscores)
+        const variablePattern = /\$\{([^}]+)\}/g;
+        let match;
+        while ((match = variablePattern.exec(pathTemplate)) !== null) {
+            const varName = match[1];
+            if (!/^[a-zA-Z0-9_.]+$/.test(varName)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    PathResolverUtils.isValidTemplate = isValidTemplate;
+    /**
+     * Extract all unique variables from a set of path templates
+     */
+    function extractAllVariables(pathTemplates) {
+        const variables = new Set();
+        for (const template of Object.values(pathTemplates)) {
+            const templateVars = PathResolver.prototype['extractVariables'].call({ extractVariables: PathResolver.prototype['extractVariables'] }, template);
+            templateVars.forEach(v => variables.add(v));
+        }
+        return Array.from(variables);
+    }
+    PathResolverUtils.extractAllVariables = extractAllVariables;
+    /**
+     * Create a dependency graph of variables
+     */
+    function createDependencyGraph(pathTemplates) {
+        const graph = {};
+        for (const [key, template] of Object.entries(pathTemplates)) {
+            const resolver = new PathResolver({
+                variables: {},
+                env: {},
+                platform: { type: 'linux', separator: '/', homeDir: '/home/user' }
+            });
+            const variables = resolver['extractVariables'](template);
+            graph[key] = variables;
+        }
+        return graph;
+    }
+    PathResolverUtils.createDependencyGraph = createDependencyGraph;
+    /**
+     * Detect potential circular references in path templates
+     */
+    function detectCircularReferences(pathTemplates) {
+        const graph = createDependencyGraph(pathTemplates);
+        const issues = [];
+        function hasCycle(node, visited, path) {
+            if (path.includes(node)) {
+                issues.push(`Circular reference: ${[...path, node].join(' -> ')}`);
+                return true;
+            }
+            if (visited.has(node)) {
+                return false;
+            }
+            visited.add(node);
+            const dependencies = graph[node] || [];
+            for (const dep of dependencies) {
+                if (hasCycle(dep, visited, [...path, node])) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        const visited = new Set();
+        for (const node of Object.keys(graph)) {
+            if (!visited.has(node)) {
+                hasCycle(node, visited, []);
+            }
+        }
+        return issues;
+    }
+    PathResolverUtils.detectCircularReferences = detectCircularReferences;
+})(PathResolverUtils || (PathResolverUtils = {}));
+//# sourceMappingURL=path-resolver.js.map

package/dist/core/config/path-resolver.js.map

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

package/dist/core/config/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/project-detector.d.ts.map

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