grok-cli-hurry-mode 1.0.4 → 1.0.5

package/dist/tools/documentation/claude-md-parser.js

@@ -0,0 +1,108 @@
+import path from 'path';
+import fs from 'fs/promises';
+import { existsSync } from 'fs';
+export class ClaudeMdParserImpl {
+    async parseClaude(rootPath) {
+        const claudePath = path.join(rootPath, 'CLAUDE.md');
+        if (!existsSync(claudePath)) {
+            return {
+                exists: false,
+                content: '',
+                hasDocumentationSection: false
+            };
+        }
+        try {
+            const content = await fs.readFile(claudePath, 'utf-8');
+            const hasDocumentationSection = content.includes('Documentation System Workflow') ||
+                content.includes('.agent documentation system');
+            return {
+                exists: true,
+                content,
+                hasDocumentationSection
+            };
+        }
+        catch (error) {
+            return {
+                exists: false,
+                content: '',
+                hasDocumentationSection: false
+            };
+        }
+    }
+    async updateClaude(rootPath, documentationSection) {
+        const claudePath = path.join(rootPath, 'CLAUDE.md');
+        try {
+            const { exists, content, hasDocumentationSection } = await this.parseClaude(rootPath);
+            if (hasDocumentationSection) {
+                return {
+                    success: true,
+                    message: '✅ CLAUDE.md already contains documentation system instructions'
+                };
+            }
+            let newContent;
+            if (exists) {
+                // Append to existing CLAUDE.md
+                newContent = content + '\n\n' + documentationSection;
+            }
+            else {
+                // Create new CLAUDE.md with basic header
+                newContent = `# CLAUDE.md
+
+This document provides context and instructions for Claude Code when working with this project.
+
+${documentationSection}`;
+            }
+            await fs.writeFile(claudePath, newContent);
+            return {
+                success: true,
+                message: exists
+                    ? '✅ Updated existing CLAUDE.md with documentation system instructions'
+                    : '✅ Created CLAUDE.md with documentation system instructions'
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Failed to update CLAUDE.md: ${error.message}`
+            };
+        }
+    }
+    generateDocumentationSection() {
+        return `## 📚 Documentation System Workflow
+
+### Before Planning Features:
+1. **Read \`.agent/README.md\`** for project overview
+2. **Check \`.agent/system/\`** for architecture context
+3. **Review \`.agent/tasks/\`** for related work
+4. **Scan \`.agent/sop/\`** for established patterns
+
+### During Implementation:
+- Store PRDs in \`.agent/tasks/\` before coding
+- Reference architecture docs for consistency
+- Follow established patterns from SOPs
+- Use cross-references between .agent docs
+
+### After Implementation:
+- Run \`/update-agent-docs\` to capture changes
+- Update \`.agent/system/\` if architecture changed
+- Add new SOPs for repeatable processes
+- Link related tasks and documents
+
+### Documentation Rules:
+- Keep system docs as single source of truth
+- Use relative links between .agent documents  
+- Maintain concise, actionable content
+- Update cross-references when adding new docs
+
+### Token Optimization:
+- Read .agent docs hierarchically (README → critical-state → relevant docs)
+- Expect ~600 tokens for full context vs 3000+ without system
+- Use .agent structure to avoid redundant codebase scanning
+- Reference existing documentation rather than recreating context
+
+---
+*This section was added by the Grok CLI documentation system*`;
+    }
+}
+export const claudeMdParser = new ClaudeMdParserImpl();
+//# sourceMappingURL=claude-md-parser.js.map

package/dist/tools/documentation/claude-md-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md-parser.js","sourceRoot":"","sources":["../../../src/tools/documentation/claude-md-parser.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAQhC,MAAM,OAAO,kBAAkB;IAE7B,KAAK,CAAC,WAAW,CAAC,QAAgB;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAEpD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,OAAO;gBACL,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,EAAE;gBACX,uBAAuB,EAAE,KAAK;aAC/B,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,uBAAuB,GAAG,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CAAC;gBAClD,OAAO,CAAC,QAAQ,CAAC,6BAA6B,CAAC,CAAC;YAE/E,OAAO;gBACL,MAAM,EAAE,IAAI;gBACZ,OAAO;gBACP,uBAAuB;aACxB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,MAAM,EAAE,KAAK;gBACb,OAAO,EAAE,EAAE;gBACX,uBAAuB,EAAE,KAAK;aAC/B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,oBAA4B;QAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAEpD,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAEtF,IAAI,uBAAuB,EAAE,CAAC;gBAC5B,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,gEAAgE;iBAC1E,CAAC;YACJ,CAAC;YAED,IAAI,UAAkB,CAAC;YAEvB,IAAI,MAAM,EAAE,CAAC;gBACX,+BAA+B;gBAC/B,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,oBAAoB,CAAC;YACvD,CAAC;iBAAM,CAAC;gBACN,yCAAyC;gBACzC,UAAU,GAAG;;;;EAInB,oBAAoB,EAAE,CAAC;YACnB,CAAC;YAED,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAE3C,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,MAAM;oBACb,CAAC,CAAC,qEAAqE;oBACvE,CAAC,CAAC,4DAA4D;aACjE,CAAC;QAEJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,+BAA+B,KAAK,CAAC,OAAO,EAAE;aACxD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,4BAA4B;QAC1B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8DAiCmD,CAAC;IAC7D,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,kBAAkB,EAAE,CAAC"}

package/dist/tools/documentation/comments-generator.d.ts

@@ -0,0 +1,55 @@
+export interface CommentsConfig {
+    filePath: string;
+    commentType: 'functions' | 'classes' | 'all';
+    style: 'jsdoc' | 'inline' | 'auto';
+}
+export interface CodeAnalysis {
+    language: string;
+    functions: FunctionInfo[];
+    classes: ClassInfo[];
+    interfaces: InterfaceInfo[];
+    hasExistingComments: boolean;
+}
+export interface FunctionInfo {
+    name: string;
+    line: number;
+    parameters: string[];
+    returnType?: string;
+    isAsync: boolean;
+    isExported: boolean;
+}
+export interface ClassInfo {
+    name: string;
+    line: number;
+    methods: FunctionInfo[];
+    properties: PropertyInfo[];
+    isExported: boolean;
+}
+export interface InterfaceInfo {
+    name: string;
+    line: number;
+    properties: PropertyInfo[];
+}
+export interface PropertyInfo {
+    name: string;
+    type?: string;
+    optional: boolean;
+}
+export declare class CommentsGenerator {
+    private config;
+    constructor(config: CommentsConfig);
+    generateComments(): Promise<{
+        success: boolean;
+        message: string;
+        modifiedContent?: string;
+    }>;
+    private analyzeCode;
+    private detectLanguage;
+    private hasExtensiveComments;
+    private addComments;
+    private generateFunctionComment;
+    private generateClassComment;
+    private generateFunctionDescription;
+    private getIndentation;
+    private countAddedComments;
+}

package/dist/tools/documentation/comments-generator.js

@@ -0,0 +1,238 @@
+import path from 'path';
+import fs from 'fs/promises';
+import { existsSync } from 'fs';
+export class CommentsGenerator {
+    constructor(config) {
+        this.config = config;
+    }
+    async generateComments() {
+        try {
+            if (!existsSync(this.config.filePath)) {
+                return {
+                    success: false,
+                    message: 'File not found'
+                };
+            }
+            const content = await fs.readFile(this.config.filePath, 'utf-8');
+            const analysis = this.analyzeCode(content);
+            if (analysis.hasExistingComments) {
+                return {
+                    success: false,
+                    message: 'File already has extensive comments. Use --force to override.'
+                };
+            }
+            const modifiedContent = this.addComments(content, analysis);
+            // Create backup
+            const backupPath = this.config.filePath + '.backup';
+            await fs.writeFile(backupPath, content);
+            // Write modified content
+            await fs.writeFile(this.config.filePath, modifiedContent);
+            const commentCount = this.countAddedComments(analysis);
+            return {
+                success: true,
+                message: `✅ Added ${commentCount} comments to ${path.basename(this.config.filePath)}\n📁 Backup created: ${path.basename(backupPath)}`,
+                modifiedContent
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Failed to add comments: ${error.message}`
+            };
+        }
+    }
+    analyzeCode(content) {
+        const lines = content.split('\n');
+        const language = this.detectLanguage();
+        const analysis = {
+            language,
+            functions: [],
+            classes: [],
+            interfaces: [],
+            hasExistingComments: this.hasExtensiveComments(content)
+        };
+        // Simple regex-based parsing (could be enhanced with AST)
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            // Detect functions
+            const funcMatch = line.match(/(?:export\s+)?(?:async\s+)?function\s+(\w+)\s*\(([^)]*)\)/);
+            if (funcMatch) {
+                const [, name, params] = funcMatch;
+                analysis.functions.push({
+                    name,
+                    line: i + 1,
+                    parameters: params.split(',').map(p => p.trim()).filter(Boolean),
+                    isAsync: line.includes('async'),
+                    isExported: line.includes('export')
+                });
+            }
+            // Detect arrow functions
+            const arrowMatch = line.match(/(?:export\s+)?(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s+)?\([^)]*\)\s*=>/);
+            if (arrowMatch) {
+                const [, name] = arrowMatch;
+                analysis.functions.push({
+                    name,
+                    line: i + 1,
+                    parameters: [],
+                    isAsync: line.includes('async'),
+                    isExported: line.includes('export')
+                });
+            }
+            // Detect classes
+            const classMatch = line.match(/(?:export\s+)?class\s+(\w+)/);
+            if (classMatch) {
+                const [, name] = classMatch;
+                analysis.classes.push({
+                    name,
+                    line: i + 1,
+                    methods: [],
+                    properties: [],
+                    isExported: line.includes('export')
+                });
+            }
+            // Detect interfaces (TypeScript)
+            const interfaceMatch = line.match(/(?:export\s+)?interface\s+(\w+)/);
+            if (interfaceMatch) {
+                const [, name] = interfaceMatch;
+                analysis.interfaces.push({
+                    name,
+                    line: i + 1,
+                    properties: []
+                });
+            }
+        }
+        return analysis;
+    }
+    detectLanguage() {
+        const ext = path.extname(this.config.filePath);
+        switch (ext) {
+            case '.ts':
+            case '.tsx': return 'typescript';
+            case '.js':
+            case '.jsx': return 'javascript';
+            case '.py': return 'python';
+            case '.java': return 'java';
+            case '.cpp':
+            case '.cc':
+            case '.cxx': return 'cpp';
+            default: return 'unknown';
+        }
+    }
+    hasExtensiveComments(content) {
+        const lines = content.split('\n');
+        const commentLines = lines.filter(line => {
+            const trimmed = line.trim();
+            return trimmed.startsWith('//') ||
+                trimmed.startsWith('/*') ||
+                trimmed.startsWith('*') ||
+                trimmed.startsWith('#') ||
+                trimmed.includes('/**');
+        });
+        // Consider "extensive" if more than 20% of lines are comments
+        return commentLines.length / lines.length > 0.2;
+    }
+    addComments(content, analysis) {
+        const lines = content.split('\n');
+        let modifiedLines = [...lines];
+        let insertOffset = 0;
+        // Add comments to functions
+        if (this.config.commentType === 'functions' || this.config.commentType === 'all') {
+            for (const func of analysis.functions) {
+                const commentLines = this.generateFunctionComment(func, analysis.language);
+                const insertIndex = func.line - 1 + insertOffset;
+                // Insert comment lines before function
+                modifiedLines.splice(insertIndex, 0, ...commentLines);
+                insertOffset += commentLines.length;
+            }
+        }
+        // Add comments to classes
+        if (this.config.commentType === 'classes' || this.config.commentType === 'all') {
+            for (const cls of analysis.classes) {
+                const commentLines = this.generateClassComment(cls, analysis.language);
+                const insertIndex = cls.line - 1 + insertOffset;
+                modifiedLines.splice(insertIndex, 0, ...commentLines);
+                insertOffset += commentLines.length;
+            }
+        }
+        return modifiedLines.join('\n');
+    }
+    generateFunctionComment(func, language) {
+        const indent = this.getIndentation(func.line);
+        if (language === 'typescript' || language === 'javascript') {
+            const lines = [
+                `${indent}/**`,
+                `${indent} * ${this.generateFunctionDescription(func)}`,
+            ];
+            if (func.parameters.length > 0) {
+                lines.push(`${indent} *`);
+                func.parameters.forEach(param => {
+                    const cleanParam = param.split(':')[0].split('=')[0].trim();
+                    lines.push(`${indent} * @param {any} ${cleanParam} - Parameter description`);
+                });
+            }
+            lines.push(`${indent} * @returns {${func.isAsync ? 'Promise<any>' : 'any'}} Return description`);
+            lines.push(`${indent} */`);
+            return lines;
+        }
+        return [`${indent}// ${this.generateFunctionDescription(func)}`];
+    }
+    generateClassComment(cls, language) {
+        const indent = this.getIndentation(cls.line);
+        if (language === 'typescript' || language === 'javascript') {
+            return [
+                `${indent}/**`,
+                `${indent} * ${cls.name} class`,
+                `${indent} * `,
+                `${indent} * @class ${cls.name}`,
+                `${indent} */`
+            ];
+        }
+        return [`${indent}// ${cls.name} class`];
+    }
+    generateFunctionDescription(func) {
+        if (func.name === 'constructor') {
+            return 'Creates an instance of the class';
+        }
+        // Generate smart descriptions based on function name
+        const name = func.name.toLowerCase();
+        if (name.startsWith('get')) {
+            return `Gets ${name.substring(3).replace(/([A-Z])/g, ' $1').toLowerCase()}`;
+        }
+        if (name.startsWith('set')) {
+            return `Sets ${name.substring(3).replace(/([A-Z])/g, ' $1').toLowerCase()}`;
+        }
+        if (name.startsWith('create')) {
+            return `Creates a new ${name.substring(6).replace(/([A-Z])/g, ' $1').toLowerCase()}`;
+        }
+        if (name.startsWith('delete') || name.startsWith('remove')) {
+            const target = name.startsWith('delete') ? name.substring(6) : name.substring(6);
+            return `Deletes ${target.replace(/([A-Z])/g, ' $1').toLowerCase()}`;
+        }
+        if (name.startsWith('update')) {
+            return `Updates ${name.substring(6).replace(/([A-Z])/g, ' $1').toLowerCase()}`;
+        }
+        if (name.startsWith('is') || name.startsWith('has')) {
+            return `Checks if ${name.substring(2).replace(/([A-Z])/g, ' $1').toLowerCase()}`;
+        }
+        if (name.includes('handle')) {
+            return `Handles ${name.replace('handle', '').replace(/([A-Z])/g, ' $1').toLowerCase()}`;
+        }
+        return `${func.name} function`;
+    }
+    getIndentation(lineNumber) {
+        // This would need access to the original line to detect indentation
+        // For now, return empty string - could be enhanced
+        return '';
+    }
+    countAddedComments(analysis) {
+        let count = 0;
+        if (this.config.commentType === 'functions' || this.config.commentType === 'all') {
+            count += analysis.functions.length;
+        }
+        if (this.config.commentType === 'classes' || this.config.commentType === 'all') {
+            count += analysis.classes.length;
+        }
+        return count;
+    }
+}
+//# sourceMappingURL=comments-generator.js.map

package/dist/tools/documentation/comments-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments-generator.js","sourceRoot":"","sources":["../../../src/tools/documentation/comments-generator.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AA6ChC,MAAM,OAAO,iBAAiB;IAG5B,YAAY,MAAsB;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACtC,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,gBAAgB;iBAC1B,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAE3C,IAAI,QAAQ,CAAC,mBAAmB,EAAE,CAAC;gBACjC,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,+DAA+D;iBACzE,CAAC;YACJ,CAAC;YAED,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAE5D,gBAAgB;YAChB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,SAAS,CAAC;YACpD,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAExC,yBAAyB;YACzB,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;YAE1D,MAAM,YAAY,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;YAEvD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,WAAW,YAAY,gBAAgB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE;gBACtI,eAAe;aAChB,CAAC;QAEJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,2BAA2B,KAAK,CAAC,OAAO,EAAE;aACpD,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,OAAe;QACjC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAEvC,MAAM,QAAQ,GAAiB;YAC7B,QAAQ;YACR,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,EAAE;YACX,UAAU,EAAE,EAAE;YACd,mBAAmB,EAAE,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC;SACxD,CAAC;QAEF,0DAA0D;QAC1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAE7B,mBAAmB;YACnB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;YAC1F,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;gBACnC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC;oBACtB,IAAI;oBACJ,IAAI,EAAE,CAAC,GAAG,CAAC;oBACX,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;oBAChE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAC/B,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;iBACpC,CAAC,CAAC;YACL,CAAC;YAED,yBAAyB;YACzB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAC;YAC3G,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,UAAU,CAAC;gBAC5B,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC;oBACtB,IAAI;oBACJ,IAAI,EAAE,CAAC,GAAG,CAAC;oBACX,UAAU,EAAE,EAAE;oBACd,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAC/B,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;iBACpC,CAAC,CAAC;YACL,CAAC;YAED,iBAAiB;YACjB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC7D,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,UAAU,CAAC;gBAC5B,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;oBACpB,IAAI;oBACJ,IAAI,EAAE,CAAC,GAAG,CAAC;oBACX,OAAO,EAAE,EAAE;oBACX,UAAU,EAAE,EAAE;oBACd,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;iBACpC,CAAC,CAAC;YACL,CAAC;YAED,iCAAiC;YACjC,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACrE,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,cAAc,CAAC;gBAChC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;oBACvB,IAAI;oBACJ,IAAI,EAAE,CAAC,GAAG,CAAC;oBACX,UAAU,EAAE,EAAE;iBACf,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,cAAc;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC/C,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,KAAK,CAAC;YAAC,KAAK,MAAM,CAAC,CAAC,OAAO,YAAY,CAAC;YAC7C,KAAK,KAAK,CAAC;YAAC,KAAK,MAAM,CAAC,CAAC,OAAO,YAAY,CAAC;YAC7C,KAAK,KAAK,CAAC,CAAC,OAAO,QAAQ,CAAC;YAC5B,KAAK,OAAO,CAAC,CAAC,OAAO,MAAM,CAAC;YAC5B,KAAK,MAAM,CAAC;YAAC,KAAK,KAAK,CAAC;YAAC,KAAK,MAAM,CAAC,CAAC,OAAO,KAAK,CAAC;YACnD,OAAO,CAAC,CAAC,OAAO,SAAS,CAAC;QAC5B,CAAC;IACH,CAAC;IAEO,oBAAoB,CAAC,OAAe;QAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;YACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;gBACxB,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;gBACxB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;gBACvB,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;gBACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,8DAA8D;QAC9D,OAAO,YAAY,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;IAClD,CAAC;IAEO,WAAW,CAAC,OAAe,EAAE,QAAsB;QACzD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,aAAa,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;QAC/B,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,4BAA4B;QAC5B,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;YACjF,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;gBACtC,MAAM,YAAY,GAAG,IAAI,CAAC,uBAAuB,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAC3E,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,YAAY,CAAC;gBAEjD,uCAAuC;gBACvC,aAAa,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,GAAG,YAAY,CAAC,CAAC;gBACtD,YAAY,IAAI,YAAY,CAAC,MAAM,CAAC;YACtC,CAAC;QACH,CAAC;QAED,0BAA0B;QAC1B,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;YAC/E,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACnC,MAAM,YAAY,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBACvE,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,YAAY,CAAC;gBAEhD,aAAa,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,GAAG,YAAY,CAAC,CAAC;gBACtD,YAAY,IAAI,YAAY,CAAC,MAAM,CAAC;YACtC,CAAC;QACH,CAAC;QAED,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAEO,uBAAuB,CAAC,IAAkB,EAAE,QAAgB;QAClE,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9C,IAAI,QAAQ,KAAK,YAAY,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC3D,MAAM,KAAK,GAAG;gBACZ,GAAG,MAAM,KAAK;gBACd,GAAG,MAAM,MAAM,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,EAAE;aACxD,CAAC;YAEF,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,CAAC;gBAC1B,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;oBAC9B,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBAC5D,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,mBAAmB,UAAU,0BAA0B,CAAC,CAAC;gBAC/E,CAAC,CAAC,CAAC;YACL,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,gBAAgB,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,sBAAsB,CAAC,CAAC;YACjG,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,KAAK,CAAC,CAAC;YAE3B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,CAAC,GAAG,MAAM,MAAM,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IAEO,oBAAoB,CAAC,GAAc,EAAE,QAAgB;QAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAE7C,IAAI,QAAQ,KAAK,YAAY,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC3D,OAAO;gBACL,GAAG,MAAM,KAAK;gBACd,GAAG,MAAM,MAAM,GAAG,CAAC,IAAI,QAAQ;gBAC/B,GAAG,MAAM,KAAK;gBACd,GAAG,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE;gBAChC,GAAG,MAAM,KAAK;aACf,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,GAAG,MAAM,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAEO,2BAA2B,CAAC,IAAkB;QACpD,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAChC,OAAO,kCAAkC,CAAC;QAC5C,CAAC;QAED,qDAAqD;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAErC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,QAAQ,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAC9E,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,QAAQ,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAC9E,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,OAAO,iBAAiB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACvF,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3D,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACjF,OAAO,WAAW,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACtE,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,OAAO,WAAW,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACjF,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,OAAO,aAAa,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACnF,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,WAAW,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAC1F,CAAC;QAED,OAAO,GAAG,IAAI,CAAC,IAAI,WAAW,CAAC;IACjC,CAAC;IAEO,cAAc,CAAC,UAAkB;QACvC,oEAAoE;QACpE,mDAAmD;QACnD,OAAO,EAAE,CAAC;IACZ,CAAC;IAEO,kBAAkB,CAAC,QAAsB;QAC/C,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;YACjF,KAAK,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC;QACrC,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;YAC/E,KAAK,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;QACnC,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/tools/documentation/docs-menu.d.ts

@@ -0,0 +1,9 @@
+export interface DocsMenuOption {
+    key: string;
+    title: string;
+    description: string;
+    command: string;
+}
+export declare const DOCS_MENU_OPTIONS: DocsMenuOption[];
+export declare function generateDocsMenuText(): string;
+export declare function findDocsMenuOption(input: string): DocsMenuOption | null;

package/dist/tools/documentation/docs-menu.js

@@ -0,0 +1,57 @@
+export const DOCS_MENU_OPTIONS = [
+    {
+        key: "1",
+        title: "Generate README",
+        description: "Create comprehensive README.md from project structure",
+        command: "/readme"
+    },
+    {
+        key: "2",
+        title: "Generate API Documentation",
+        description: "Extract and document functions, classes, modules",
+        command: "/api-docs"
+    },
+    {
+        key: "3",
+        title: "Add Code Comments",
+        description: "Add intelligent comments to existing code",
+        command: "/comments"
+    },
+    {
+        key: "4",
+        title: "Generate Changelog",
+        description: "Generate CHANGELOG.md from git history",
+        command: "/changelog"
+    },
+    {
+        key: "5",
+        title: "Initialize .agent System",
+        description: "Set up AI-first documentation structure",
+        command: "/init-agent"
+    },
+    {
+        key: "6",
+        title: "Update .agent Documentation",
+        description: "Sync docs with recent code changes",
+        command: "/update-agent-docs"
+    }
+];
+export function generateDocsMenuText() {
+    return `📚 **Documentation Menu**
+
+Choose a documentation task:
+
+${DOCS_MENU_OPTIONS.map(option => `**${option.key}.** ${option.title}
+   ${option.description}
+   → \`${option.command}\`
+`).join('\n')}
+
+**0.** Exit Menu
+
+Type a number to select an option, or type any command directly.`;
+}
+export function findDocsMenuOption(input) {
+    const trimmed = input.trim();
+    return DOCS_MENU_OPTIONS.find(option => option.key === trimmed) || null;
+}
+//# sourceMappingURL=docs-menu.js.map

package/dist/tools/documentation/docs-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-menu.js","sourceRoot":"","sources":["../../../src/tools/documentation/docs-menu.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,iBAAiB,GAAqB;IACjD;QACE,GAAG,EAAE,GAAG;QACR,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,uDAAuD;QACpE,OAAO,EAAE,SAAS;KACnB;IACD;QACE,GAAG,EAAE,GAAG;QACR,KAAK,EAAE,4BAA4B;QACnC,WAAW,EAAE,kDAAkD;QAC/D,OAAO,EAAE,WAAW;KACrB;IACD;QACE,GAAG,EAAE,GAAG;QACR,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,2CAA2C;QACxD,OAAO,EAAE,WAAW;KACrB;IACD;QACE,GAAG,EAAE,GAAG;QACR,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,wCAAwC;QACrD,OAAO,EAAE,YAAY;KACtB;IACD;QACE,GAAG,EAAE,GAAG;QACR,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,yCAAyC;QACtD,OAAO,EAAE,aAAa;KACvB;IACD;QACE,GAAG,EAAE,GAAG;QACR,KAAK,EAAE,6BAA6B;QACpC,WAAW,EAAE,oCAAoC;QACjD,OAAO,EAAE,oBAAoB;KAC9B;CACF,CAAC;AAEF,MAAM,UAAU,oBAAoB;IAClC,OAAO;;;;EAIP,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAC/B,KAAK,MAAM,CAAC,GAAG,OAAO,MAAM,CAAC,KAAK;KAC/B,MAAM,CAAC,WAAW;SACd,MAAM,CAAC,OAAO;CACtB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;iEAIoD,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,OAAO,CAAC,IAAI,IAAI,CAAC;AAC1E,CAAC"}

package/dist/tools/documentation/readme-generator.d.ts

@@ -0,0 +1,31 @@
+export interface ReadmeConfig {
+    projectName: string;
+    rootPath: string;
+    updateExisting: boolean;
+    template: 'default' | 'api' | 'cli' | 'library';
+}
+export interface ProjectAnalysis {
+    packageJson?: any;
+    hasTypeScript: boolean;
+    hasReact: boolean;
+    hasTests: boolean;
+    hasDocs: boolean;
+    buildScripts: string[];
+    dependencies: string[];
+    devDependencies: string[];
+    mainFiles: string[];
+    framework?: string;
+}
+export declare class ReadmeGenerator {
+    private config;
+    constructor(config: ReadmeConfig);
+    generateReadme(): Promise<{
+        success: boolean;
+        message: string;
+        content?: string;
+    }>;
+    private analyzeProject;
+    private generateReadmeContent;
+    private generateBadges;
+    private getScriptDescription;
+}