claude-code-workflow 6.1.4 → 6.2.1

package/dist/tools/generate-module-docs.js

@@ -0,0 +1,379 @@
+/**
+ * Generate Module Docs Tool
+ * Generate documentation for modules and projects with multiple strategies
+ */
+import { z } from 'zod';
+import { readdirSync, statSync, existsSync, readFileSync, mkdirSync, writeFileSync, unlinkSync } from 'fs';
+import { join, resolve, basename, extname, relative } from 'path';
+import { execSync } from 'child_process';
+import { tmpdir } from 'os';
+import { getSecondaryModel } from './cli-config-manager.js';
+// Directories to exclude
+const EXCLUDE_DIRS = [
+    '.git', '__pycache__', 'node_modules', '.venv', 'venv', 'env',
+    'dist', 'build', '.cache', '.pytest_cache', '.mypy_cache',
+    'coverage', '.nyc_output', 'logs', 'tmp', 'temp', '.workflow'
+];
+// Code file extensions
+const CODE_EXTENSIONS = [
+    '.ts', '.tsx', '.js', '.jsx', '.py', '.sh', '.go', '.rs'
+];
+// Default models for each tool
+const DEFAULT_MODELS = {
+    gemini: 'gemini-2.5-flash',
+    qwen: 'coder-model',
+    codex: 'gpt5-codex'
+};
+// Template paths (relative to user home directory)
+const TEMPLATE_BASE = '.claude/workflows/cli-templates/prompts/documentation';
+// Define Zod schema for validation
+const ParamsSchema = z.object({
+    strategy: z.enum(['full', 'single', 'project-readme', 'project-architecture', 'http-api']),
+    sourcePath: z.string().min(1, 'Source path is required'),
+    projectName: z.string().min(1, 'Project name is required'),
+    tool: z.enum(['gemini', 'qwen', 'codex']).default('gemini'),
+    model: z.string().optional(),
+});
+/**
+ * Detect folder type (code vs navigation)
+ */
+function detectFolderType(dirPath) {
+    try {
+        const entries = readdirSync(dirPath, { withFileTypes: true });
+        const codeFiles = entries.filter(e => {
+            if (!e.isFile())
+                return false;
+            const ext = extname(e.name).toLowerCase();
+            return CODE_EXTENSIONS.includes(ext);
+        });
+        return codeFiles.length > 0 ? 'code' : 'navigation';
+    }
+    catch (e) {
+        return 'navigation';
+    }
+}
+/**
+ * Calculate output path
+ */
+function calculateOutputPath(sourcePath, projectName, projectRoot) {
+    const absSource = resolve(sourcePath);
+    const normRoot = resolve(projectRoot);
+    let relPath = relative(normRoot, absSource);
+    relPath = relPath.replace(/\\/g, '/');
+    return join('.workflow', 'docs', projectName, relPath);
+}
+/**
+ * Load template content
+ */
+function loadTemplate(templateName) {
+    const homePath = process.env.HOME || process.env.USERPROFILE;
+    if (!homePath) {
+        return getDefaultTemplate(templateName);
+    }
+    const templatePath = join(homePath, TEMPLATE_BASE, `${templateName}.txt`);
+    if (existsSync(templatePath)) {
+        return readFileSync(templatePath, 'utf8');
+    }
+    return getDefaultTemplate(templateName);
+}
+/**
+ * Get default template content
+ */
+function getDefaultTemplate(templateName) {
+    const fallbacks = {
+        'api': 'Generate API documentation with function signatures, parameters, return values, and usage examples.',
+        'module-readme': 'Generate README documentation with purpose, usage, configuration, and examples.',
+        'folder-navigation': 'Generate navigation README with overview of subdirectories and their purposes.',
+        'project-readme': 'Generate project README with overview, installation, usage, and configuration.',
+        'project-architecture': 'Generate ARCHITECTURE.md with system design, components, and data flow.'
+    };
+    return fallbacks[templateName] || 'Generate comprehensive documentation.';
+}
+/**
+ * Create temporary prompt file and return path
+ */
+function createPromptFile(prompt) {
+    const timestamp = Date.now();
+    const randomSuffix = Math.random().toString(36).substring(2, 8);
+    const promptFile = join(tmpdir(), `docs-prompt-${timestamp}-${randomSuffix}.txt`);
+    writeFileSync(promptFile, prompt, 'utf8');
+    return promptFile;
+}
+/**
+ * Build CLI command using stdin piping (avoids shell escaping issues)
+ */
+function buildCliCommand(tool, promptFile, model) {
+    const normalizedPath = promptFile.replace(/\\/g, '/');
+    const isWindows = process.platform === 'win32';
+    // Build the cat/read command based on platform
+    const catCmd = isWindows ? `Get-Content -Raw "${normalizedPath}" | ` : `cat "${normalizedPath}" | `;
+    switch (tool) {
+        case 'qwen':
+            return model === 'coder-model'
+                ? `${catCmd}qwen --yolo`
+                : `${catCmd}qwen -m "${model}" --yolo`;
+        case 'codex':
+            // codex uses different syntax - prompt as exec argument
+            if (isWindows) {
+                return `codex --full-auto exec (Get-Content -Raw "${normalizedPath}") -m "${model}" --skip-git-repo-check -s danger-full-access`;
+            }
+            return `codex --full-auto exec "$(cat "${normalizedPath}")" -m "${model}" --skip-git-repo-check -s danger-full-access`;
+        case 'gemini':
+        default:
+            return `${catCmd}gemini -m "${model}" --yolo`;
+    }
+}
+/**
+ * Scan directory structure
+ */
+function scanDirectoryStructure(targetPath) {
+    const lines = [];
+    const dirName = basename(targetPath);
+    let totalFiles = 0;
+    let totalDirs = 0;
+    function countRecursive(dir) {
+        try {
+            const entries = readdirSync(dir, { withFileTypes: true });
+            entries.forEach(e => {
+                if (e.name.startsWith('.') || EXCLUDE_DIRS.includes(e.name))
+                    return;
+                if (e.isFile())
+                    totalFiles++;
+                else if (e.isDirectory()) {
+                    totalDirs++;
+                    countRecursive(join(dir, e.name));
+                }
+            });
+        }
+        catch (e) {
+            // Ignore
+        }
+    }
+    countRecursive(targetPath);
+    const folderType = detectFolderType(targetPath);
+    lines.push(`Directory: ${dirName}`);
+    lines.push(`Total files: ${totalFiles}`);
+    lines.push(`Total directories: ${totalDirs}`);
+    lines.push(`Folder type: ${folderType}`);
+    return {
+        info: lines.join('\n'),
+        folderType
+    };
+}
+// Tool schema for MCP
+export const schema = {
+    name: 'generate_module_docs',
+    description: `Generate documentation for modules and projects.
+
+Module-Level Strategies:
+- full: Full documentation (API.md + README.md for all directories)
+- single: Single-layer documentation (current directory only)
+
+Project-Level Strategies:
+- project-readme: Project overview from module docs
+- project-architecture: System design documentation
+- http-api: HTTP API documentation
+
+Output: .workflow/docs/{projectName}/...`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            strategy: {
+                type: 'string',
+                enum: ['full', 'single', 'project-readme', 'project-architecture', 'http-api'],
+                description: 'Documentation strategy'
+            },
+            sourcePath: {
+                type: 'string',
+                description: 'Source module directory path'
+            },
+            projectName: {
+                type: 'string',
+                description: 'Project name for output path'
+            },
+            tool: {
+                type: 'string',
+                enum: ['gemini', 'qwen', 'codex'],
+                description: 'CLI tool to use (default: gemini)',
+                default: 'gemini'
+            },
+            model: {
+                type: 'string',
+                description: 'Model name (optional, uses tool defaults)'
+            }
+        },
+        required: ['strategy', 'sourcePath', 'projectName']
+    }
+};
+// Handler function
+export async function handler(params) {
+    const parsed = ParamsSchema.safeParse(params);
+    if (!parsed.success) {
+        return { success: false, error: `Invalid params: ${parsed.error.message}` };
+    }
+    const { strategy, sourcePath, projectName, tool, model } = parsed.data;
+    try {
+        const targetPath = resolve(process.cwd(), sourcePath);
+        if (!existsSync(targetPath)) {
+            return { success: false, error: `Directory not found: ${targetPath}` };
+        }
+        if (!statSync(targetPath).isDirectory()) {
+            return { success: false, error: `Not a directory: ${targetPath}` };
+        }
+        // Set model (use secondaryModel from config for internal calls)
+        let actualModel = model;
+        if (!actualModel) {
+            try {
+                actualModel = getSecondaryModel(process.cwd(), tool);
+            }
+            catch {
+                actualModel = DEFAULT_MODELS[tool] || DEFAULT_MODELS.gemini;
+            }
+        }
+        // Scan directory
+        const { info: structureInfo, folderType } = scanDirectoryStructure(targetPath);
+        // Calculate output path
+        const outputPath = calculateOutputPath(targetPath, projectName, process.cwd());
+        // Ensure output directory exists
+        mkdirSync(outputPath, { recursive: true });
+        // Build prompt based on strategy
+        let prompt;
+        let templateContent;
+        switch (strategy) {
+            case 'full':
+            case 'single':
+                if (folderType === 'code') {
+                    templateContent = loadTemplate('api');
+                    prompt = `Directory Structure Analysis:
+${structureInfo}
+
+Read: ${strategy === 'full' ? '@**/*' : '@*.ts @*.tsx @*.js @*.jsx @*.py @*.sh @*.md @*.json'}
+
+Generate documentation files:
+- API.md: Code API documentation
+- README.md: Module overview and usage
+
+Output directory: ${outputPath}
+
+Template Guidelines:
+${templateContent}`;
+                }
+                else {
+                    templateContent = loadTemplate('folder-navigation');
+                    prompt = `Directory Structure Analysis:
+${structureInfo}
+
+Read: @*/API.md @*/README.md
+
+Generate documentation file:
+- README.md: Navigation overview of subdirectories
+
+Output directory: ${outputPath}
+
+Template Guidelines:
+${templateContent}`;
+                }
+                break;
+            case 'project-readme':
+                templateContent = loadTemplate('project-readme');
+                prompt = `Read all module documentation:
+@.workflow/docs/${projectName}/**/API.md
+@.workflow/docs/${projectName}/**/README.md
+
+Generate project-level documentation:
+- README.md in .workflow/docs/${projectName}/
+
+Template Guidelines:
+${templateContent}`;
+                break;
+            case 'project-architecture':
+                templateContent = loadTemplate('project-architecture');
+                prompt = `Read project documentation:
+@.workflow/docs/${projectName}/README.md
+@.workflow/docs/${projectName}/**/API.md
+
+Generate:
+- ARCHITECTURE.md: System design documentation
+- EXAMPLES.md: Usage examples
+
+Output directory: .workflow/docs/${projectName}/
+
+Template Guidelines:
+${templateContent}`;
+                break;
+            case 'http-api':
+                prompt = `Read API route files:
+@**/routes/**/*.ts @**/routes/**/*.js
+@**/api/**/*.ts @**/api/**/*.js
+
+Generate HTTP API documentation:
+- api/README.md: REST API endpoints documentation
+
+Output directory: .workflow/docs/${projectName}/api/`;
+                break;
+        }
+        // Create temporary prompt file (avoids shell escaping issues)
+        const promptFile = createPromptFile(prompt);
+        // Build command using file-based prompt
+        const command = buildCliCommand(tool, promptFile, actualModel);
+        // Log execution info
+        console.log(`📚 Generating docs: ${sourcePath}`);
+        console.log(`   Strategy: ${strategy} | Tool: ${tool} | Model: ${actualModel}`);
+        console.log(`   Output: ${outputPath}`);
+        try {
+            const startTime = Date.now();
+            execSync(command, {
+                cwd: targetPath,
+                encoding: 'utf8',
+                stdio: 'inherit',
+                timeout: 600000, // 10 minutes
+                shell: process.platform === 'win32' ? 'powershell.exe' : '/bin/bash'
+            });
+            const duration = Math.round((Date.now() - startTime) / 1000);
+            // Cleanup prompt file
+            try {
+                unlinkSync(promptFile);
+            }
+            catch (e) {
+                // Ignore cleanup errors
+            }
+            console.log(`   ✅ Completed in ${duration}s`);
+            return {
+                success: true,
+                result: {
+                    success: true,
+                    strategy,
+                    source_path: sourcePath,
+                    project_name: projectName,
+                    output_path: outputPath,
+                    folder_type: folderType,
+                    tool,
+                    model: actualModel,
+                    duration_seconds: duration,
+                    message: `Documentation generated successfully in ${duration}s`
+                }
+            };
+        }
+        catch (error) {
+            // Cleanup prompt file on error
+            try {
+                unlinkSync(promptFile);
+            }
+            catch (e) {
+                // Ignore cleanup errors
+            }
+            console.log(`   ❌ Generation failed: ${error.message}`);
+            return {
+                success: false,
+                error: `Documentation generation failed: ${error.message}`
+            };
+        }
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: `Tool execution failed: ${error.message}`
+        };
+    }
+}
+//# sourceMappingURL=generate-module-docs.js.map

package/dist/tools/generate-module-docs.js.map

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

package/dist/tools/get-modules-by-depth.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Get Modules by Depth Tool
+ * Scan project structure and organize modules by directory depth (deepest first)
+ */
+import type { ToolSchema, ToolResult } from '../types/tool.js';
+interface ToolOutput {
+    format: string;
+    total_modules: number;
+    max_depth: number;
+    output: string;
+}
+export declare const schema: ToolSchema;
+export declare function handler(params: Record<string, unknown>): Promise<ToolResult<ToolOutput>>;
+export {};
+//# sourceMappingURL=get-modules-by-depth.d.ts.map

package/dist/tools/get-modules-by-depth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-modules-by-depth.d.ts","sourceRoot":"","sources":["../../src/tools/get-modules-by-depth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA4D/D,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAqLD,eAAO,MAAM,MAAM,EAAE,UAsBpB,CAAC;AAGF,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAuE9F"}