@ginkoai/cli 1.0.0

package/dist/commands/bug/bug-reflection.js

@@ -0,0 +1,343 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-09-29
+ * @tags: [bug, reflection, tracking, ai-enhanced]
+ * @related: [../../core/reflection-pattern.ts, bug-context-gatherer.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [reflection-pattern, fs, path, chalk]
+ */
+import { ReflectionCommand } from '../../core/reflection-pattern.js';
+import { BugContextGatherer } from './bug-context-gatherer.js';
+import chalk from 'chalk';
+import fs from 'fs/promises';
+import path from 'path';
+import { getGinkoDir } from '../../utils/helpers.js';
+import { execSync } from 'child_process';
+/**
+ * Bug-specific implementation of the Reflection Pattern
+ * Analyzes bugs with codebase context and creates structured bug reports
+ */
+export class BugReflectionCommand extends ReflectionCommand {
+    contextGatherer;
+    constructor() {
+        super('bug');
+        this.contextGatherer = new BugContextGatherer();
+    }
+    /**
+     * Execute bug reflection
+     */
+    async execute(intent, options = {}) {
+        console.log(chalk.blue('🔍 Analyzing bug with context...\n'));
+        // Load template
+        const template = await this.loadTemplate(options);
+        // Gather context
+        if (options.verbose) {
+            console.log(chalk.dim('   Gathering context...'));
+        }
+        const context = await this.contextGatherer.gather(intent);
+        if (options.verbose) {
+            console.log(chalk.green('   ✓ Scanned recent logs'));
+            console.log(chalk.green('   ✓ Analyzed related code changes'));
+            console.log(chalk.green('   ✓ Checked similar past issues\n'));
+        }
+        // Auto-detect priority if not specified
+        const priority = options.priority || this.detectPriority(intent, context);
+        // Generate bug number and filename
+        const bugNumber = await this.getNextBugNumber();
+        const slug = this.generateSlug(intent);
+        const filename = `BUG-${bugNumber}-${slug}.md`;
+        // Generate AI prompt
+        const prompt = await this.generatePrompt(intent, template, context);
+        console.log(chalk.blue('📋 Bug Analysis:'));
+        console.log(chalk.dim(`   Priority: ${priority} (${options.priority ? 'specified' : 'auto-detected'})`));
+        if (context.affectedComponents.length > 0) {
+            console.log(chalk.dim(`   Affected: ${context.affectedComponents.join(', ')}`));
+        }
+        if (context.probableCause && !options['no-analysis']) {
+            console.log(chalk.dim(`   Probable cause: ${context.probableCause}`));
+        }
+        console.log();
+        // Generate bug report content
+        const content = await this.generateBugReport({
+            number: bugNumber,
+            title: this.generateTitle(intent),
+            priority,
+            status: options.status || 'Open',
+            reporter: options.reporter || await this.getGitUser(),
+            description: intent,
+            context,
+            template,
+            skipAnalysis: options['no-analysis'] === true
+        });
+        // Save bug report
+        const ginkoDir = await getGinkoDir();
+        const bugsDir = path.join(ginkoDir, 'bugs');
+        await fs.mkdir(bugsDir, { recursive: true });
+        const bugPath = path.join(bugsDir, filename);
+        await fs.writeFile(bugPath, content, 'utf-8');
+        console.log(chalk.green(`💾 Created: ${path.relative(process.cwd(), bugPath)}\n`));
+        // Update bug index
+        await this.updateBugIndex(bugNumber, filename, {
+            title: this.generateTitle(intent),
+            priority,
+            status: options.status || 'Open',
+            date: new Date().toISOString().split('T')[0]
+        });
+        // Show next steps
+        console.log(chalk.blue('Next steps:'));
+        console.log(chalk.dim('   1. Review proposed solutions'));
+        console.log(chalk.dim('   2. Test reproduction steps'));
+        console.log(chalk.dim('   3. Assign to developer'));
+        console.log();
+        console.log(chalk.dim(`   View: ginko bugs show BUG-${bugNumber}`));
+    }
+    /**
+     * Load bug-specific template
+     */
+    async loadTemplate(options) {
+        return {
+            requiredSections: [
+                'metadata',
+                'problem_description',
+                'evidence',
+                options['no-analysis'] ? null : 'root_cause_analysis',
+                'impact_assessment',
+                options.reproduce !== false ? 'reproduction_steps' : null,
+                'proposed_solutions',
+                'workaround',
+                'next_steps'
+            ].filter(Boolean),
+            contextToConsider: [
+                'recent_errors_in_logs',
+                'related_code_changes',
+                'similar_past_bugs',
+                'affected_components',
+                'system_environment'
+            ],
+            rulesAndConstraints: [
+                'Priority auto-detection: crash/security=Critical, blocks workflow=High, UX issue=Medium, cosmetic=Low',
+                'Include specific error messages and stack traces',
+                'Root cause analysis uses codebase context',
+                'Solutions ranked by feasibility and impact',
+                'Link to related files with line numbers'
+            ]
+        };
+    }
+    /**
+     * Auto-detect bug priority based on keywords
+     */
+    detectPriority(description, context) {
+        const lower = description.toLowerCase();
+        // Critical indicators
+        if (lower.match(/\b(crash|security|data loss|corruption|exploit|vulnerability|down)\b/)) {
+            return 'Critical';
+        }
+        // High indicators
+        if (lower.match(/\b(block|broken|fail|timeout|error|exception|cannot|unable)\b/)) {
+            return 'High';
+        }
+        // Low indicators
+        if (lower.match(/\b(cosmetic|typo|formatting|color|spacing|alignment)\b/)) {
+            return 'Low';
+        }
+        // Default to Medium
+        return 'Medium';
+    }
+    /**
+     * Get next bug number
+     */
+    async getNextBugNumber() {
+        const ginkoDir = await getGinkoDir();
+        const bugsDir = path.join(ginkoDir, 'bugs');
+        try {
+            await fs.mkdir(bugsDir, { recursive: true });
+            const files = await fs.readdir(bugsDir);
+            const bugNumbers = files
+                .filter(f => f.startsWith('BUG-'))
+                .map(f => {
+                const match = f.match(/^BUG-(\d+)-/);
+                return match ? parseInt(match[1], 10) : 0;
+            });
+            const maxNumber = bugNumbers.length > 0 ? Math.max(...bugNumbers) : 0;
+            return String(maxNumber + 1).padStart(3, '0');
+        }
+        catch {
+            return '001';
+        }
+    }
+    /**
+     * Generate URL-friendly slug from description
+     */
+    generateSlug(description) {
+        return description
+            .toLowerCase()
+            .replace(/[^a-z0-9\s-]/g, '')
+            .trim()
+            .split(/\s+/)
+            .slice(0, 5)
+            .join('-');
+    }
+    /**
+     * Generate bug title (first sentence or max 60 chars)
+     */
+    generateTitle(description) {
+        const firstSentence = description.split(/[.!?]/)[0];
+        return firstSentence.length > 60
+            ? firstSentence.substring(0, 57) + '...'
+            : firstSentence;
+    }
+    /**
+     * Get git user name
+     */
+    async getGitUser() {
+        try {
+            const name = execSync('git config user.name', { encoding: 'utf-8' }).trim();
+            return name || 'Unknown';
+        }
+        catch {
+            return 'Unknown';
+        }
+    }
+    /**
+     * Generate bug report content
+     */
+    async generateBugReport(data) {
+        const { number, title, priority, status, reporter, description, context, skipAnalysis } = data;
+        const date = new Date().toISOString().split('T')[0];
+        let content = `# BUG-${number}: ${title}
+
+**Reported**: ${date}
+**Reporter**: ${reporter}
+**Priority**: ${priority}
+**Status**: ${status}
+${context.affectedComponents.length > 0 ? `**Tags**: ${context.affectedComponents.join(', ')}` : ''}
+
+## Problem Description
+${description}
+
+## Evidence
+`;
+        // Add error messages if available
+        if (context.errors && context.errors.length > 0) {
+            content += `**Error Messages**:\n\`\`\`\n${context.errors.join('\n\n')}\n\`\`\`\n\n`;
+        }
+        // Add stack traces if available
+        if (context.stackTraces && context.stackTraces.length > 0) {
+            content += `**Stack Trace**:\n\`\`\`\n${context.stackTraces[0]}\n\`\`\`\n\n`;
+        }
+        // Add affected files
+        if (context.affectedFiles && context.affectedFiles.length > 0) {
+            content += `**Affected Files**:\n`;
+            context.affectedFiles.forEach((file) => {
+                content += `- \`${file}\`\n`;
+            });
+            content += '\n';
+        }
+        // Root cause analysis
+        if (!skipAnalysis) {
+            content += `## Root Cause Analysis
+${context.probableCause || 'Analysis requires further investigation.'}
+
+`;
+            if (context.affectedComponents.length > 0) {
+                content += `**Affected Components**:\n`;
+                context.affectedComponents.forEach((comp) => {
+                    content += `- ${comp}\n`;
+                });
+                content += '\n';
+            }
+        }
+        // Impact assessment
+        content += `## Impact Assessment
+- **User Impact**: ${this.assessUserImpact(priority, description)}
+- **System Impact**: Under investigation
+- **Affected Users**: To be determined
+
+`;
+        // Reproduction steps
+        content += `## Reproduction Steps
+1. [Describe initial conditions]
+2. [Action that triggers bug]
+3. [Observed behavior]
+4. **Expected**: [What should happen]
+5. **Actual**: [What actually happens]
+
+`;
+        // Proposed solutions
+        content += `## Proposed Solutions
+
+### Option 1: Investigation Required
+Further analysis needed to determine appropriate fix.
+
+**Next Investigation Steps**:
+- Review related code changes
+- Check for similar issues in bug history
+- Analyze error patterns in logs
+
+`;
+        // Workaround
+        content += `## Workaround
+${context.workaround || 'No workaround identified yet.'}
+
+`;
+        // Related issues
+        content += `## Related Issues
+- Related to: [BUG-xxx if applicable]
+- Caused by: [commit hash if known]
+- Blocks: [feature/backlog item if applicable]
+
+`;
+        // Next steps
+        content += `## Next Steps
+- [ ] Verify reproduction steps
+- [ ] Investigate root cause
+- [ ] Develop fix
+- [ ] Test solution
+- [ ] Deploy and verify
+`;
+        return content;
+    }
+    /**
+     * Assess user impact based on priority
+     */
+    assessUserImpact(priority, description) {
+        switch (priority) {
+            case 'Critical':
+                return 'Severe - System unusable or data at risk';
+            case 'High':
+                return 'High - Major functionality blocked or degraded';
+            case 'Medium':
+                return 'Moderate - Workaround available but user experience affected';
+            case 'Low':
+                return 'Minor - Cosmetic or edge case issue';
+            default:
+                return 'To be assessed';
+        }
+    }
+    /**
+     * Update bug index for querying
+     */
+    async updateBugIndex(number, filename, metadata) {
+        const ginkoDir = await getGinkoDir();
+        const bugsDir = path.join(ginkoDir, 'bugs');
+        const indexPath = path.join(bugsDir, 'index.json');
+        let index = { bugs: [] };
+        try {
+            const existing = await fs.readFile(indexPath, 'utf-8');
+            index = JSON.parse(existing);
+        }
+        catch {
+            // New index
+        }
+        index.bugs.push({
+            number: `BUG-${number}`,
+            filename,
+            ...metadata,
+            created: new Date().toISOString()
+        });
+        await fs.writeFile(indexPath, JSON.stringify(index, null, 2), 'utf-8');
+    }
+}
+//# sourceMappingURL=bug-reflection.js.map

package/dist/commands/bug/bug-reflection.js.map

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

package/dist/commands/capture/capture-reflection.d.ts

@@ -0,0 +1,139 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-10-01
+ * @tags: [capture, reflection, pipeline, builder, context]
+ * @related: [../../core/simple-pipeline-base.ts, ../capture.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [simple-pipeline-base, fs-extra, chalk]
+ */
+import { SimplePipelineBase } from '../../core/simple-pipeline-base.js';
+/**
+ * Options for capture command
+ */
+interface CaptureOptions {
+    store?: boolean;
+    id?: string;
+    content?: string;
+    review?: boolean;
+    verbose?: boolean;
+    quiet?: boolean;
+    quick?: boolean;
+    edit?: boolean;
+}
+/**
+ * Capture pipeline using Simple Builder Pattern
+ * Implements Universal Reflection Pattern for context capture
+ * Follows ADR-013 for consistent pipeline architecture
+ */
+export declare class CapturePipeline extends SimplePipelineBase {
+    private ginkoDir;
+    private modulesDir;
+    private capturesDir;
+    private options;
+    private description;
+    private captureId;
+    private detectedType;
+    private extractedTags;
+    private area;
+    private filename;
+    constructor(description: string, options?: CaptureOptions);
+    /**
+     * Initialize pipeline dependencies
+     */
+    initialize(): Promise<this>;
+    /**
+     * Get domain name for this reflector
+     */
+    getDomain(): string;
+    /**
+     * Load capture quality template
+     */
+    getQualityTemplate(): any;
+    /**
+     * Load template
+     */
+    loadTemplate(): this;
+    /**
+     * Gather context for capture
+     */
+    gatherContext(): Promise<this>;
+    /**
+     * Generate prompt for AI enhancement
+     */
+    generatePrompt(): string;
+    /**
+     * Generate capture content
+     */
+    generateContent(): this;
+    /**
+     * Generate template with AI placeholders
+     */
+    private generateTemplate;
+    /**
+     * Generate quick capture without AI placeholders
+     */
+    private generateQuickCapture;
+    /**
+     * Validate generated content
+     */
+    validateOutput(): this;
+    /**
+     * Display or save the capture
+     */
+    output(): Promise<this>;
+    /**
+     * Store AI-enhanced content (phase 2)
+     */
+    storeEnrichedContent(captureId: string, content: string): Promise<void>;
+    /**
+     * Update context index
+     */
+    private updateIndex;
+    /**
+     * Parse frontmatter from markdown content
+     */
+    private parseFrontmatter;
+    /**
+     * Detect context type from description
+     */
+    private detectContextType;
+    /**
+     * Extract relevant tags from description
+     */
+    private extractTags;
+    /**
+     * Get current working area
+     */
+    private getCurrentArea;
+    /**
+     * Custom validation for capture pipeline
+     */
+    protected customValidate(): void;
+    /**
+     * Custom recovery logic
+     */
+    protected customRecover(): void;
+    /**
+     * Custom execution logic
+     */
+    protected customExecute(): Promise<void>;
+    /**
+     * Main build method using fluent interface
+     */
+    build(): Promise<void>;
+}
+/**
+ * Adapter for CLI command usage
+ * Maintains backward compatibility with existing command structure
+ */
+export declare class CaptureReflectionCommand {
+    private pipeline;
+    /**
+     * Execute the capture command
+     */
+    execute(description: string | undefined, options?: CaptureOptions): Promise<void>;
+}
+export default CaptureReflectionCommand;
+//# sourceMappingURL=capture-reflection.d.ts.map

package/dist/commands/capture/capture-reflection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-reflection.d.ts","sourceRoot":"","sources":["../../../src/commands/capture/capture-reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,kBAAkB,EAAmB,MAAM,oCAAoC,CAAC;AAMzF;;GAEG;AACH,UAAU,cAAc;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAeD;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,kBAAkB;IACrD,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,YAAY,CAAmC;IACvD,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,QAAQ,CAAc;gBAElB,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB;IAO7D;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBjC;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,kBAAkB,IAAI,GAAG;IA8BzB;;OAEG;IACH,YAAY,IAAI,IAAI;IAWpB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA4CpC;;OAEG;IACH,cAAc,IAAI,MAAM;IAqBxB;;OAEG;IACH,eAAe,IAAI,IAAI;IAuBvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgCxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAwB5B;;OAEG;IACH,cAAc,IAAI,IAAI;IAuCtB;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAmD7B;;OAEG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+B7E;;OAEG;YACW,WAAW;IAczB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgCxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwBzB;;OAEG;IACH,OAAO,CAAC,WAAW;IA2CnB;;OAEG;YACW,cAAc;IAY5B;;OAEG;IACH,SAAS,CAAC,cAAc,IAAI,IAAI;IAYhC;;OAEG;IACH,SAAS,CAAC,aAAa,IAAI,IAAI;IAQ/B;;OAEG;cACa,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9C;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAqC7B;AAED;;;GAGG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAgC;IAEhD;;OAEG;IACG,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CA+B5F;AAGD,eAAe,wBAAwB,CAAC"}