grok-cli-hurry-mode 1.0.3 → 1.0.5

package/dist/tools/documentation/smart-prd-assistant.js

@@ -0,0 +1,325 @@
+import path from 'path';
+import fs from 'fs/promises';
+import { existsSync } from 'fs';
+export class SmartPRDAssistant {
+    constructor(rootPath) {
+        this.rootPath = rootPath;
+        this.agentPath = path.join(rootPath, '.agent');
+    }
+    async analyzePRD(prdPath) {
+        const fileName = path.basename(prdPath);
+        const content = await fs.readFile(prdPath, 'utf-8');
+        const title = this.extractTitle(content);
+        // Load project context
+        const context = await this.loadProjectContext();
+        // Analyze the PRD
+        const analysis = {
+            fileName,
+            title,
+            content,
+            suggestions: [],
+            conflicts: [],
+            similarTasks: [],
+            missingContext: [],
+            architectureImpact: []
+        };
+        // Generate suggestions
+        analysis.suggestions = await this.generateSuggestions(content, context);
+        analysis.conflicts = await this.detectConflicts(content, context);
+        analysis.similarTasks = await this.findSimilarTasks(content, context);
+        analysis.missingContext = this.detectMissingContext(content, context);
+        analysis.architectureImpact = this.analyzeArchitectureImpact(content, context);
+        return analysis;
+    }
+    async monitorTasksFolder() {
+        const tasksPath = path.join(this.agentPath, 'tasks');
+        if (!existsSync(tasksPath)) {
+            return { newPRDs: [], analysisResults: [] };
+        }
+        try {
+            const files = await fs.readdir(tasksPath);
+            const prdFiles = files.filter(file => file.endsWith('.md') && !file.startsWith('example-'));
+            const newPRDs = [];
+            const analysisResults = [];
+            for (const file of prdFiles) {
+                const filePath = path.join(tasksPath, file);
+                const stats = await fs.stat(filePath);
+                // Check if file was created/modified in the last 10 minutes
+                const tenMinutesAgo = Date.now() - (10 * 60 * 1000);
+                if (stats.mtime.getTime() > tenMinutesAgo) {
+                    newPRDs.push(file);
+                    const analysis = await this.analyzePRD(filePath);
+                    analysisResults.push(analysis);
+                }
+            }
+            return { newPRDs, analysisResults };
+        }
+        catch (error) {
+            return { newPRDs: [], analysisResults: [] };
+        }
+    }
+    async loadProjectContext() {
+        const context = {
+            architecture: [],
+            patterns: [],
+            dependencies: [],
+            existingTasks: [],
+            systemConstraints: []
+        };
+        try {
+            // Load architecture info
+            const archPath = path.join(this.agentPath, 'system', 'architecture.md');
+            if (existsSync(archPath)) {
+                const archContent = await fs.readFile(archPath, 'utf-8');
+                context.architecture = this.extractKeyPoints(archContent);
+            }
+            // Load critical state
+            const statePath = path.join(this.agentPath, 'system', 'critical-state.md');
+            if (existsSync(statePath)) {
+                const stateContent = await fs.readFile(statePath, 'utf-8');
+                context.systemConstraints = this.extractKeyPoints(stateContent);
+            }
+            // Load existing SOPs for patterns
+            const sopPath = path.join(this.agentPath, 'sop');
+            if (existsSync(sopPath)) {
+                const sopFiles = await fs.readdir(sopPath);
+                for (const file of sopFiles) {
+                    if (file.endsWith('.md')) {
+                        const sopContent = await fs.readFile(path.join(sopPath, file), 'utf-8');
+                        context.patterns.push(...this.extractKeyPoints(sopContent));
+                    }
+                }
+            }
+            // Load existing tasks
+            const tasksPath = path.join(this.agentPath, 'tasks');
+            if (existsSync(tasksPath)) {
+                const taskFiles = await fs.readdir(tasksPath);
+                for (const file of taskFiles) {
+                    if (file.endsWith('.md') && !file.startsWith('example-')) {
+                        context.existingTasks.push(file);
+                    }
+                }
+            }
+            // Load dependencies from package.json
+            const packagePath = path.join(this.rootPath, 'package.json');
+            if (existsSync(packagePath)) {
+                const packageContent = await fs.readFile(packagePath, 'utf-8');
+                const packageData = JSON.parse(packageContent);
+                context.dependencies = [
+                    ...Object.keys(packageData.dependencies || {}),
+                    ...Object.keys(packageData.devDependencies || {})
+                ];
+            }
+        }
+        catch (error) {
+            // Continue with empty context if loading fails
+        }
+        return context;
+    }
+    extractTitle(content) {
+        const titleMatch = content.match(/^#\s*(.+)$/m);
+        return titleMatch ? titleMatch[1].trim() : 'Untitled PRD';
+    }
+    extractKeyPoints(content) {
+        const lines = content.split('\n');
+        const keyPoints = [];
+        for (const line of lines) {
+            const trimmed = line.trim();
+            // Extract bullet points, headings, and important statements
+            if (trimmed.startsWith('- ') || trimmed.startsWith('* ') ||
+                trimmed.startsWith('#') || trimmed.includes('**')) {
+                keyPoints.push(trimmed.replace(/[#*-]/g, '').trim());
+            }
+        }
+        return keyPoints.filter(point => point.length > 10); // Filter out short points
+    }
+    async generateSuggestions(content, context) {
+        const suggestions = [];
+        // Check for missing architecture context
+        if (context.architecture.length > 0) {
+            const hasArchContext = context.architecture.some(arch => content.toLowerCase().includes(arch.toLowerCase()));
+            if (!hasArchContext) {
+                suggestions.push({
+                    type: 'context',
+                    priority: 'medium',
+                    message: 'Consider referencing existing architecture patterns',
+                    reference: '.agent/system/architecture.md'
+                });
+            }
+        }
+        // Check for established patterns
+        if (context.patterns.length > 0) {
+            const hasPatterns = context.patterns.some(pattern => content.toLowerCase().includes(pattern.toLowerCase()));
+            if (!hasPatterns) {
+                suggestions.push({
+                    type: 'pattern',
+                    priority: 'low',
+                    message: 'Review existing SOPs for established patterns',
+                    reference: '.agent/sop/'
+                });
+            }
+        }
+        // Check for dependency conflicts
+        const mentionedDeps = context.dependencies.filter(dep => content.toLowerCase().includes(dep.toLowerCase()));
+        if (mentionedDeps.length > 0) {
+            suggestions.push({
+                type: 'dependency',
+                priority: 'medium',
+                message: `References existing dependencies: ${mentionedDeps.slice(0, 3).join(', ')}`,
+                reference: 'package.json'
+            });
+        }
+        // Check for system constraints
+        const constraintConflicts = context.systemConstraints.filter(constraint => this.hasConflict(content, constraint));
+        if (constraintConflicts.length > 0) {
+            suggestions.push({
+                type: 'conflict',
+                priority: 'high',
+                message: 'Potential conflicts with system constraints detected',
+                reference: '.agent/system/critical-state.md'
+            });
+        }
+        return suggestions;
+    }
+    async detectConflicts(content, context) {
+        const conflicts = [];
+        // Check against system constraints
+        for (const constraint of context.systemConstraints) {
+            if (this.hasConflict(content, constraint)) {
+                conflicts.push(`Conflicts with: ${constraint}`);
+            }
+        }
+        return conflicts;
+    }
+    async findSimilarTasks(content, context) {
+        const similar = [];
+        const contentWords = this.extractKeywords(content);
+        // Load and analyze existing tasks
+        const tasksPath = path.join(this.agentPath, 'tasks');
+        if (existsSync(tasksPath)) {
+            for (const taskFile of context.existingTasks) {
+                try {
+                    const taskPath = path.join(tasksPath, taskFile);
+                    const taskContent = await fs.readFile(taskPath, 'utf-8');
+                    const taskWords = this.extractKeywords(taskContent);
+                    const similarity = this.calculateSimilarity(contentWords, taskWords);
+                    if (similarity > 0.3) { // 30% similarity threshold
+                        similar.push(`${taskFile} (${Math.round(similarity * 100)}% similar)`);
+                    }
+                }
+                catch (error) {
+                    // Skip files we can't read
+                }
+            }
+        }
+        return similar;
+    }
+    detectMissingContext(content, context) {
+        const missing = [];
+        // Check for common PRD sections
+        const requiredSections = [
+            'objective', 'requirements', 'technical approach', 'success criteria'
+        ];
+        for (const section of requiredSections) {
+            if (!content.toLowerCase().includes(section)) {
+                missing.push(`Missing section: ${section}`);
+            }
+        }
+        // Check for architecture considerations
+        if (!content.toLowerCase().includes('architecture') && !content.toLowerCase().includes('component')) {
+            missing.push('No architecture impact discussed');
+        }
+        // Check for dependency analysis
+        if (!content.toLowerCase().includes('depend') && !content.toLowerCase().includes('integrat')) {
+            missing.push('Dependencies not analyzed');
+        }
+        return missing;
+    }
+    analyzeArchitectureImpact(content, context) {
+        const impacts = [];
+        // Detect potential architecture changes
+        const architectureKeywords = [
+            'new component', 'new service', 'new tool', 'new command',
+            'refactor', 'restructure', 'migrate', 'breaking change'
+        ];
+        for (const keyword of architectureKeywords) {
+            if (content.toLowerCase().includes(keyword)) {
+                impacts.push(`May require: ${keyword}`);
+            }
+        }
+        // Check against current architecture
+        if (context.architecture.some(arch => content.toLowerCase().includes(arch.toLowerCase()))) {
+            impacts.push('Affects existing architecture components');
+        }
+        return impacts;
+    }
+    hasConflict(content, constraint) {
+        // Simple conflict detection - could be enhanced with NLP
+        const conflictKeywords = ['replace', 'remove', 'delete', 'deprecated', 'breaking'];
+        const contentLower = content.toLowerCase();
+        const constraintLower = constraint.toLowerCase();
+        return conflictKeywords.some(keyword => contentLower.includes(keyword) && contentLower.includes(constraintLower));
+    }
+    extractKeywords(content) {
+        // Simple keyword extraction
+        const words = content.toLowerCase()
+            .replace(/[^\w\s]/g, ' ')
+            .split(/\s+/)
+            .filter(word => word.length > 3);
+        // Remove common words
+        const commonWords = ['this', 'that', 'will', 'should', 'could', 'would', 'need', 'want'];
+        return words.filter(word => !commonWords.includes(word));
+    }
+    calculateSimilarity(words1, words2) {
+        const set1 = new Set(words1);
+        const set2 = new Set(words2);
+        const intersection = new Set([...set1].filter(x => set2.has(x)));
+        const union = new Set([...set1, ...set2]);
+        return intersection.size / union.size;
+    }
+    generateAnalysisReport(analysis) {
+        let report = `📋 **PRD Analysis: ${analysis.title}**\n\n`;
+        if (analysis.suggestions.length > 0) {
+            report += `💡 **Suggestions:**\n`;
+            analysis.suggestions.forEach(suggestion => {
+                const priority = suggestion.priority === 'high' ? '🔴' :
+                    suggestion.priority === 'medium' ? '🟡' : '🟢';
+                report += `${priority} ${suggestion.message}`;
+                if (suggestion.reference) {
+                    report += ` (see: ${suggestion.reference})`;
+                }
+                report += '\n';
+            });
+            report += '\n';
+        }
+        if (analysis.conflicts.length > 0) {
+            report += `⚠️ **Potential Conflicts:**\n`;
+            analysis.conflicts.forEach(conflict => {
+                report += `- ${conflict}\n`;
+            });
+            report += '\n';
+        }
+        if (analysis.similarTasks.length > 0) {
+            report += `🔗 **Similar Tasks:**\n`;
+            analysis.similarTasks.forEach(task => {
+                report += `- ${task}\n`;
+            });
+            report += '\n';
+        }
+        if (analysis.architectureImpact.length > 0) {
+            report += `🏗️ **Architecture Impact:**\n`;
+            analysis.architectureImpact.forEach(impact => {
+                report += `- ${impact}\n`;
+            });
+            report += '\n';
+        }
+        if (analysis.missingContext.length > 0) {
+            report += `📝 **Consider Adding:**\n`;
+            analysis.missingContext.forEach(missing => {
+                report += `- ${missing}\n`;
+            });
+        }
+        return report;
+    }
+}
+//# sourceMappingURL=smart-prd-assistant.js.map

package/dist/tools/documentation/smart-prd-assistant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-prd-assistant.js","sourceRoot":"","sources":["../../../src/tools/documentation/smart-prd-assistant.ts"],"names":[],"mappings":"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"}

package/dist/tools/documentation/update-agent-docs.d.ts

@@ -0,0 +1,37 @@
+export interface UpdateConfig {
+    rootPath: string;
+    updateTarget: 'all' | 'system' | 'tasks' | 'sop';
+    autoCommit: boolean;
+}
+export interface ChangeAnalysis {
+    filesChanged: string[];
+    newFiles: string[];
+    deletedFiles: string[];
+    gitCommits: string[];
+    architectureChanges: boolean;
+    configChanges: boolean;
+    hasNewFeatures: boolean;
+}
+export interface UpdateResult {
+    success: boolean;
+    message: string;
+    updatedFiles: string[];
+    suggestions: string[];
+}
+export declare class UpdateAgentDocs {
+    private config;
+    constructor(config: UpdateConfig);
+    updateDocs(): Promise<UpdateResult>;
+    private analyzeChanges;
+    private getRecentlyModifiedFiles;
+    private detectArchitectureChanges;
+    private detectConfigChanges;
+    private detectNewFeatures;
+    private shouldUpdate;
+    private updateSystemDocs;
+    private updateCriticalState;
+    private updateArchitectureDoc;
+    private generateChangesSummary;
+    private generateSuggestions;
+    private generateUpdateMessage;
+}

package/dist/tools/documentation/update-agent-docs.js

@@ -0,0 +1,275 @@
+import path from 'path';
+import fs from 'fs/promises';
+import { existsSync } from 'fs';
+export class UpdateAgentDocs {
+    constructor(config) {
+        this.config = config;
+    }
+    async updateDocs() {
+        try {
+            // Check if .agent system exists
+            const agentPath = path.join(this.config.rootPath, '.agent');
+            if (!existsSync(agentPath)) {
+                return {
+                    success: false,
+                    message: '❌ .agent documentation system not found. Run `/init-agent` first.',
+                    updatedFiles: [],
+                    suggestions: ['Run `/init-agent` to initialize the documentation system']
+                };
+            }
+            // Analyze recent changes
+            const analysis = await this.analyzeChanges();
+            if (analysis.filesChanged.length === 0 && analysis.gitCommits.length === 0) {
+                return {
+                    success: true,
+                    message: '✅ No significant changes detected. Documentation is up to date.',
+                    updatedFiles: [],
+                    suggestions: []
+                };
+            }
+            // Update documentation based on analysis
+            const updatedFiles = [];
+            const suggestions = [];
+            // Update system documentation if needed
+            if (this.shouldUpdate('system') && (analysis.architectureChanges || analysis.configChanges)) {
+                const systemUpdates = await this.updateSystemDocs(analysis);
+                updatedFiles.push(...systemUpdates);
+            }
+            // Update critical state
+            const criticalStateUpdate = await this.updateCriticalState(analysis);
+            if (criticalStateUpdate) {
+                updatedFiles.push('.agent/system/critical-state.md');
+            }
+            // Generate suggestions for manual updates
+            suggestions.push(...this.generateSuggestions(analysis));
+            const message = this.generateUpdateMessage(analysis, updatedFiles);
+            return {
+                success: true,
+                message,
+                updatedFiles,
+                suggestions
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Failed to update agent docs: ${error.message}`,
+                updatedFiles: [],
+                suggestions: []
+            };
+        }
+    }
+    async analyzeChanges() {
+        const analysis = {
+            filesChanged: [],
+            newFiles: [],
+            deletedFiles: [],
+            gitCommits: [],
+            architectureChanges: false,
+            configChanges: false,
+            hasNewFeatures: false
+        };
+        try {
+            // Get git changes since last update
+            const { execSync } = require('child_process');
+            // Get recent commits (last 10)
+            try {
+                const commits = execSync('git log --oneline -10', {
+                    cwd: this.config.rootPath,
+                    encoding: 'utf-8'
+                });
+                analysis.gitCommits = commits.trim().split('\n').filter(Boolean);
+            }
+            catch (error) {
+                // Not a git repo or no commits
+            }
+            // Get changed files since last commit
+            try {
+                const changedFiles = execSync('git diff --name-only HEAD~5..HEAD', {
+                    cwd: this.config.rootPath,
+                    encoding: 'utf-8'
+                });
+                analysis.filesChanged = changedFiles.trim().split('\n').filter(Boolean);
+            }
+            catch (error) {
+                // Use file system timestamps as fallback
+                analysis.filesChanged = await this.getRecentlyModifiedFiles();
+            }
+            // Analyze types of changes
+            analysis.architectureChanges = this.detectArchitectureChanges(analysis.filesChanged);
+            analysis.configChanges = this.detectConfigChanges(analysis.filesChanged);
+            analysis.hasNewFeatures = this.detectNewFeatures(analysis.gitCommits);
+            return analysis;
+        }
+        catch (error) {
+            return analysis;
+        }
+    }
+    async getRecentlyModifiedFiles() {
+        // Fallback: get files modified in last 24 hours
+        const oneDayAgo = Date.now() - (24 * 60 * 60 * 1000);
+        const recentFiles = [];
+        const scanDir = async (dirPath) => {
+            try {
+                const entries = await fs.readdir(dirPath, { withFileTypes: true });
+                for (const entry of entries) {
+                    const fullPath = path.join(dirPath, entry.name);
+                    if (entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'node_modules') {
+                        await scanDir(fullPath);
+                    }
+                    else if (entry.isFile()) {
+                        const stats = await fs.stat(fullPath);
+                        if (stats.mtime.getTime() > oneDayAgo) {
+                            recentFiles.push(path.relative(this.config.rootPath, fullPath));
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                // Skip directories we can't read
+            }
+        };
+        await scanDir(this.config.rootPath);
+        return recentFiles;
+    }
+    detectArchitectureChanges(filesChanged) {
+        const architectureIndicators = [
+            'src/tools/', 'src/commands/', 'src/ui/', 'src/agent/',
+            'package.json', 'tsconfig.json', 'src/index.ts'
+        ];
+        return filesChanged.some(file => architectureIndicators.some(indicator => file.includes(indicator)));
+    }
+    detectConfigChanges(filesChanged) {
+        const configFiles = [
+            'package.json', 'tsconfig.json', '.grok/', 'CLAUDE.md',
+            '.env', '.gitignore', 'README.md'
+        ];
+        return filesChanged.some(file => configFiles.some(config => file.includes(config)));
+    }
+    detectNewFeatures(commits) {
+        const featureKeywords = ['feat:', 'add:', 'new:', 'feature:', 'implement:'];
+        return commits.some(commit => featureKeywords.some(keyword => commit.toLowerCase().includes(keyword)));
+    }
+    shouldUpdate(target) {
+        return this.config.updateTarget === 'all' || this.config.updateTarget === target;
+    }
+    async updateSystemDocs(analysis) {
+        const updatedFiles = [];
+        const systemPath = path.join(this.config.rootPath, '.agent', 'system');
+        // Update architecture.md if architecture changed
+        if (analysis.architectureChanges) {
+            try {
+                const archPath = path.join(systemPath, 'architecture.md');
+                if (existsSync(archPath)) {
+                    const content = await fs.readFile(archPath, 'utf-8');
+                    const updatedContent = await this.updateArchitectureDoc(content, analysis);
+                    await fs.writeFile(archPath, updatedContent);
+                    updatedFiles.push('.agent/system/architecture.md');
+                }
+            }
+            catch (error) {
+                // Continue with other updates
+            }
+        }
+        return updatedFiles;
+    }
+    async updateCriticalState(analysis) {
+        try {
+            const criticalStatePath = path.join(this.config.rootPath, '.agent', 'system', 'critical-state.md');
+            if (!existsSync(criticalStatePath)) {
+                return false;
+            }
+            const content = await fs.readFile(criticalStatePath, 'utf-8');
+            // Update timestamp and recent changes
+            const timestamp = new Date().toISOString();
+            const changesSummary = this.generateChangesSummary(analysis);
+            let updatedContent = content.replace(/Last Updated: .*/, `Last Updated: ${timestamp}`);
+            // Add recent changes section if significant changes detected
+            if (analysis.filesChanged.length > 0) {
+                const recentChangesSection = `
+
+## Recent Changes
+${changesSummary}`;
+                if (content.includes('## Recent Changes')) {
+                    updatedContent = updatedContent.replace(/## Recent Changes[\s\S]*?(?=##|$)/, recentChangesSection);
+                }
+                else {
+                    updatedContent = updatedContent.replace(/Last Updated: .*/, `Last Updated: ${timestamp}\nUpdated By: /update-agent-docs after detecting changes${recentChangesSection}`);
+                }
+            }
+            await fs.writeFile(criticalStatePath, updatedContent);
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    async updateArchitectureDoc(content, analysis) {
+        // Simple update - add timestamp and recent changes note
+        const timestamp = new Date().toISOString().split('T')[0];
+        return content.replace(/\*Updated: .*/, `*Updated: ${timestamp} - Recent changes detected in: ${analysis.filesChanged.slice(0, 3).join(', ')}${analysis.filesChanged.length > 3 ? '...' : ''}*`);
+    }
+    generateChangesSummary(analysis) {
+        const lines = [];
+        if (analysis.gitCommits.length > 0) {
+            lines.push(`**Recent Commits (${analysis.gitCommits.length}):**`);
+            analysis.gitCommits.slice(0, 5).forEach(commit => {
+                lines.push(`- ${commit}`);
+            });
+            if (analysis.gitCommits.length > 5) {
+                lines.push(`- ... and ${analysis.gitCommits.length - 5} more`);
+            }
+        }
+        if (analysis.filesChanged.length > 0) {
+            lines.push(`\n**Files Modified (${analysis.filesChanged.length}):**`);
+            analysis.filesChanged.slice(0, 10).forEach(file => {
+                lines.push(`- ${file}`);
+            });
+            if (analysis.filesChanged.length > 10) {
+                lines.push(`- ... and ${analysis.filesChanged.length - 10} more files`);
+            }
+        }
+        if (analysis.architectureChanges) {
+            lines.push('\n**⚠️ Architecture changes detected**');
+        }
+        if (analysis.configChanges) {
+            lines.push('**⚙️ Configuration changes detected**');
+        }
+        return lines.join('\n');
+    }
+    generateSuggestions(analysis) {
+        const suggestions = [];
+        if (analysis.hasNewFeatures) {
+            suggestions.push('📝 Consider adding new features to .agent/tasks/ as PRDs');
+            suggestions.push('📖 Update README.md with new feature documentation');
+        }
+        if (analysis.architectureChanges) {
+            suggestions.push('🏗️ Review and update .agent/system/architecture.md manually');
+            suggestions.push('📋 Update API documentation if interfaces changed');
+        }
+        if (analysis.configChanges) {
+            suggestions.push('⚙️ Review configuration changes in .agent/system/');
+        }
+        if (analysis.filesChanged.length > 20) {
+            suggestions.push('🧹 Consider running /compact to optimize conversation history');
+        }
+        return suggestions;
+    }
+    generateUpdateMessage(analysis, updatedFiles) {
+        let message = `✅ **Agent Documentation Updated**\n\n`;
+        message += `📊 **Change Analysis:**\n`;
+        message += `- Files changed: ${analysis.filesChanged.length}\n`;
+        message += `- Recent commits: ${analysis.gitCommits.length}\n`;
+        message += `- Architecture changes: ${analysis.architectureChanges ? '✅' : '❌'}\n`;
+        message += `- Config changes: ${analysis.configChanges ? '✅' : '❌'}\n\n`;
+        if (updatedFiles.length > 0) {
+            message += `📝 **Updated Files:**\n`;
+            updatedFiles.forEach(file => {
+                message += `- ${file}\n`;
+            });
+            message += '\n';
+        }
+        return message;
+    }
+}
+//# sourceMappingURL=update-agent-docs.js.map