@claude-flow/cli 3.32.3 → 3.32.5

package/dist/src/mcp-tools/progress-tools.d.ts

@@ -0,0 +1,14 @@
+/**
+ * V3 Progress MCP Tools
+ *
+ * Provides MCP tools for checking and syncing V3 implementation progress.
+ *
+ * @module @claude-flow/cli/mcp-tools/progress
+ */
+import type { MCPTool } from './types.js';
+/**
+ * All progress tools
+ */
+export declare const progressTools: MCPTool[];
+export default progressTools;
+//# sourceMappingURL=progress-tools.d.ts.map

package/dist/src/mcp-tools/progress-tools.js

@@ -0,0 +1,348 @@
+/**
+ * V3 Progress MCP Tools
+ *
+ * Provides MCP tools for checking and syncing V3 implementation progress.
+ *
+ * @module @claude-flow/cli/mcp-tools/progress
+ */
+import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join, basename, dirname } from 'path';
+import { fileURLToPath } from 'url';
+// Get project root - handles both src and dist paths
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// From dist/src/mcp-tools or src/mcp-tools, navigate to v3 directory
+// CLI is at v3/@claude-flow/cli, so go up 2 levels from cli to get to v3
+const CLI_ROOT = join(__dirname, '../../..');
+const CLAUDE_FLOW_DIR = join(CLI_ROOT, '..'); // @claude-flow directory
+const V3_DIR = join(CLAUDE_FLOW_DIR, '..'); // v3 directory
+const PROJECT_ROOT = join(V3_DIR, '..');
+// Utility/service packages follow DDD differently - their services ARE the application layer
+const UTILITY_PACKAGES = new Set([
+    'cli', 'hooks', 'mcp', 'shared', 'testing', 'agents', 'integration',
+    'embeddings', 'deployment', 'performance', 'plugins', 'providers'
+]);
+// Target metrics for 100% completion
+const TARGETS = {
+    CLI_COMMANDS: 28,
+    MCP_TOOLS: 100,
+    HOOKS_SUBCOMMANDS: 27, // 27 hooks documented in CLAUDE.md
+    PACKAGES: 17,
+};
+// Weight distribution for overall progress
+const WEIGHTS = {
+    CLI: 0.25,
+    MCP: 0.25,
+    HOOKS: 0.20,
+    PACKAGES: 0.15,
+    DDD: 0.15,
+};
+function countFilesAndLines(dir, ext = '.ts') {
+    let files = 0;
+    let lines = 0;
+    function walk(currentDir) {
+        if (!existsSync(currentDir))
+            return;
+        try {
+            const entries = readdirSync(currentDir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = join(currentDir, entry.name);
+                if (entry.isDirectory() && !entry.name.includes('node_modules') && !entry.name.startsWith('.')) {
+                    walk(fullPath);
+                }
+                else if (entry.isFile() && entry.name.endsWith(ext)) {
+                    files++;
+                    try {
+                        const content = readFileSync(fullPath, 'utf-8');
+                        lines += content.split('\n').length;
+                    }
+                    catch (_e) { /* ignore */ }
+                }
+            }
+        }
+        catch (_e) { /* ignore */ }
+    }
+    walk(dir);
+    return { files, lines };
+}
+function calculateModuleProgress(moduleDir) {
+    if (!existsSync(moduleDir))
+        return 0;
+    const moduleName = basename(moduleDir);
+    // Utility packages are 100% complete by design
+    if (UTILITY_PACKAGES.has(moduleName)) {
+        return 100;
+    }
+    let progress = 0;
+    // Check for DDD structure
+    if (existsSync(join(moduleDir, 'src/domain')))
+        progress += 30;
+    if (existsSync(join(moduleDir, 'src/application')))
+        progress += 30;
+    if (existsSync(join(moduleDir, 'src')))
+        progress += 10;
+    if (existsSync(join(moduleDir, 'src/index.ts')) || existsSync(join(moduleDir, 'index.ts')))
+        progress += 10;
+    if (existsSync(join(moduleDir, '__tests__')) || existsSync(join(moduleDir, 'tests')))
+        progress += 10;
+    if (existsSync(join(moduleDir, 'package.json')))
+        progress += 10;
+    return Math.min(progress, 100);
+}
+async function calculateProgress() {
+    const now = new Date().toISOString();
+    // Count V3 modules
+    const modulesDir = join(V3_DIR, '@claude-flow');
+    const modules = [];
+    let totalProgress = 0;
+    let explicitDDD = 0;
+    let utilityDDD = 0;
+    if (existsSync(modulesDir)) {
+        const entries = readdirSync(modulesDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory() && !entry.name.startsWith('.')) {
+                const moduleDir = join(modulesDir, entry.name);
+                const { files, lines } = countFilesAndLines(moduleDir);
+                const progress = calculateModuleProgress(moduleDir);
+                modules.push({ name: entry.name, files, lines, progress });
+                totalProgress += progress;
+                if (UTILITY_PACKAGES.has(entry.name)) {
+                    utilityDDD++;
+                }
+                else if (progress >= 60) {
+                    explicitDDD++;
+                }
+            }
+        }
+    }
+    const avgProgress = modules.length > 0 ? Math.round(totalProgress / modules.length) : 0;
+    const totalStats = countFilesAndLines(V3_DIR);
+    // Count CLI commands (from commands/index.ts)
+    let cliCommands = 28; // Default to known count
+    const commandsIndexPath = join(V3_DIR, '@claude-flow/cli/src/commands/index.ts');
+    if (existsSync(commandsIndexPath)) {
+        try {
+            const content = readFileSync(commandsIndexPath, 'utf-8');
+            const matches = content.match(/export const commands.*\[([^\]]+)\]/s);
+            if (matches) {
+                cliCommands = (matches[1].match(/Command/g) || []).length || 28;
+            }
+        }
+        catch (_e) { /* ignore */ }
+    }
+    // Count MCP tools
+    let mcpTools = 100; // Approximate
+    const toolsIndexPath = join(V3_DIR, '@claude-flow/cli/src/mcp-tools/index.ts');
+    if (existsSync(toolsIndexPath)) {
+        try {
+            const content = readFileSync(toolsIndexPath, 'utf-8');
+            mcpTools = (content.match(/export.*Tools/g) || []).length * 10 || 100;
+        }
+        catch (_e) { /* ignore */ }
+    }
+    // Count hooks subcommands (count const *Command definitions)
+    let hooksSubcommands = 27; // Default to documented count
+    const hooksPath = join(V3_DIR, '@claude-flow/cli/src/commands/hooks.ts');
+    if (existsSync(hooksPath)) {
+        try {
+            const content = readFileSync(hooksPath, 'utf-8');
+            // Count command definitions like "const fooCommand: Command = {"
+            const commandDefs = content.match(/const\s+\w+Command\s*:\s*Command\s*=/g);
+            if (commandDefs && commandDefs.length > 0) {
+                hooksSubcommands = commandDefs.length;
+            }
+        }
+        catch (_e) { /* ignore */ }
+    }
+    // Calculate component progress
+    const cliProgress = Math.min(100, Math.round((cliCommands / TARGETS.CLI_COMMANDS) * 100));
+    const mcpProgress = Math.min(100, Math.round((mcpTools / TARGETS.MCP_TOOLS) * 100));
+    const hooksProgress = Math.min(100, Math.round((hooksSubcommands / TARGETS.HOOKS_SUBCOMMANDS) * 100));
+    const packagesProgress = Math.min(100, Math.round((modules.length / TARGETS.PACKAGES) * 100));
+    // Calculate overall weighted progress
+    const overall = Math.round(cliProgress * WEIGHTS.CLI +
+        mcpProgress * WEIGHTS.MCP +
+        hooksProgress * WEIGHTS.HOOKS +
+        packagesProgress * WEIGHTS.PACKAGES +
+        avgProgress * WEIGHTS.DDD);
+    return {
+        overall,
+        cli: { commands: cliCommands, target: TARGETS.CLI_COMMANDS, progress: cliProgress },
+        mcp: { tools: mcpTools, target: TARGETS.MCP_TOOLS, progress: mcpProgress },
+        hooks: { subcommands: hooksSubcommands, target: TARGETS.HOOKS_SUBCOMMANDS, progress: hooksProgress },
+        packages: {
+            total: modules.length,
+            withDDD: explicitDDD + utilityDDD,
+            target: TARGETS.PACKAGES,
+            progress: packagesProgress,
+            list: modules.map(m => m.name),
+        },
+        ddd: { explicit: explicitDDD, utility: utilityDDD, progress: avgProgress },
+        codebase: { totalFiles: totalStats.files, totalLines: totalStats.lines },
+        lastUpdated: now,
+        source: 'V3ProgressService',
+    };
+}
+async function syncProgress() {
+    const metrics = await calculateProgress();
+    // Persist to file
+    const metricsDir = join(PROJECT_ROOT, '.claude-flow/metrics');
+    if (!existsSync(metricsDir)) {
+        mkdirSync(metricsDir, { recursive: true });
+    }
+    const outputPath = join(metricsDir, 'v3-progress.json');
+    writeFileSync(outputPath, JSON.stringify({
+        domains: { completed: Math.floor(metrics.packages.withDDD / 3), total: 5 },
+        ddd: {
+            progress: metrics.ddd.progress,
+            modules: metrics.packages.total,
+            totalFiles: metrics.codebase.totalFiles,
+            totalLines: metrics.codebase.totalLines,
+        },
+        swarm: { activeAgents: 0, totalAgents: 15 },
+        lastUpdated: metrics.lastUpdated,
+        source: 'V3ProgressService',
+    }, null, 2));
+    return metrics;
+}
+function getSummary(metrics) {
+    const lines = [
+        '═══════════════════════════════════════════════════',
+        '           V3 Implementation Progress',
+        '═══════════════════════════════════════════════════',
+        '',
+        `  Overall Progress: ${metrics.overall}%`,
+        '',
+        `  CLI Commands:     ${metrics.cli.progress}% (${metrics.cli.commands}/${metrics.cli.target})`,
+        `  MCP Tools:        ${metrics.mcp.progress}% (${metrics.mcp.tools}/${metrics.mcp.target})`,
+        `  Hooks:            ${metrics.hooks.progress}% (${metrics.hooks.subcommands}/${metrics.hooks.target})`,
+        `  Packages:         ${metrics.packages.progress}% (${metrics.packages.total}/${metrics.packages.target})`,
+        `  DDD Structure:    ${metrics.ddd.progress}%`,
+        '',
+        `  Codebase: ${metrics.codebase.totalFiles} files, ${metrics.codebase.totalLines.toLocaleString()} lines`,
+        '',
+        `  Last Updated: ${metrics.lastUpdated}`,
+        '═══════════════════════════════════════════════════',
+    ];
+    return lines.join('\n');
+}
+/**
+ * progress/check - Get current V3 implementation progress
+ */
+const progressCheck = {
+    name: 'progress_check',
+    description: 'Get current V3 implementation progress percentage and metrics Use when native TodoWrite is wrong because you need cross-session goal-completion tracking with witness/audit trail. For in-session checklists, native TodoWrite is simpler.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            detailed: {
+                type: 'boolean',
+                description: 'Include detailed breakdown by category',
+            },
+        },
+        required: [],
+    },
+    handler: async (params) => {
+        const detailed = params.detailed;
+        const metrics = await calculateProgress();
+        if (detailed) {
+            return {
+                overall: metrics.overall,
+                cli: metrics.cli,
+                mcp: metrics.mcp,
+                hooks: metrics.hooks,
+                packages: metrics.packages,
+                ddd: metrics.ddd,
+                codebase: metrics.codebase,
+                lastUpdated: metrics.lastUpdated,
+            };
+        }
+        return {
+            progress: metrics.overall,
+            summary: `V3 Implementation: ${metrics.overall}% complete`,
+            breakdown: {
+                cli: `${metrics.cli.progress}%`,
+                mcp: `${metrics.mcp.progress}%`,
+                hooks: `${metrics.hooks.progress}%`,
+                packages: `${metrics.packages.progress}%`,
+                ddd: `${metrics.ddd.progress}%`,
+            },
+        };
+    },
+};
+/**
+ * progress/sync - Calculate and persist V3 progress
+ */
+const progressSync = {
+    name: 'progress_sync',
+    description: 'Calculate and persist V3 progress metrics to file Use when native TodoWrite is wrong because you need cross-session goal-completion tracking with witness/audit trail. For in-session checklists, native TodoWrite is simpler.',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: [],
+    },
+    handler: async () => {
+        const metrics = await syncProgress();
+        return {
+            progress: metrics.overall,
+            message: `Progress synced: ${metrics.overall}%`,
+            persisted: true,
+            lastUpdated: metrics.lastUpdated,
+        };
+    },
+};
+/**
+ * progress/summary - Get human-readable progress summary
+ */
+const progressSummary = {
+    name: 'progress_summary',
+    description: 'Get human-readable V3 implementation progress summary Use when native TodoWrite is wrong because you need cross-session goal-completion tracking with witness/audit trail. For in-session checklists, native TodoWrite is simpler.',
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: [],
+    },
+    handler: async () => {
+        const metrics = await calculateProgress();
+        return {
+            summary: getSummary(metrics),
+        };
+    },
+};
+/**
+ * progress/watch - Watch progress (status check)
+ */
+const progressWatch = {
+    name: 'progress_watch',
+    description: 'Get current watch status for progress monitoring Use when native TodoWrite is wrong because you need cross-session goal-completion tracking with witness/audit trail. For in-session checklists, native TodoWrite is simpler.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                enum: ['status'],
+                description: 'Action to perform (status only for MCP)',
+            },
+        },
+        required: [],
+    },
+    handler: async () => {
+        const metrics = await calculateProgress();
+        return {
+            hasMetrics: true,
+            lastProgress: metrics.overall,
+            lastUpdated: metrics.lastUpdated,
+        };
+    },
+};
+/**
+ * All progress tools
+ */
+export const progressTools = [
+    progressCheck,
+    progressSync,
+    progressSummary,
+    progressWatch,
+];
+export default progressTools;
+//# sourceMappingURL=progress-tools.js.map

package/dist/src/mcp-tools/request-tracker.d.ts

@@ -0,0 +1,17 @@
+/**
+ * MCP Request Tracker
+ * Lightweight counter for tracking MCP tool invocations.
+ * Used by system_metrics to report real request counts.
+ */
+interface RequestCounts {
+    total: number;
+    success: number;
+    errors: number;
+    byTool: Record<string, number>;
+    startedAt: string;
+}
+export declare function trackRequest(toolName: string, success: boolean): void;
+export declare function getRequestCounts(): RequestCounts;
+export declare function resetRequestCounts(): void;
+export {};
+//# sourceMappingURL=request-tracker.d.ts.map

package/dist/src/mcp-tools/request-tracker.js

@@ -0,0 +1,27 @@
+/**
+ * MCP Request Tracker
+ * Lightweight counter for tracking MCP tool invocations.
+ * Used by system_metrics to report real request counts.
+ */
+let counts = {
+    total: 0,
+    success: 0,
+    errors: 0,
+    byTool: {},
+    startedAt: new Date().toISOString(),
+};
+export function trackRequest(toolName, success) {
+    counts.total++;
+    if (success)
+        counts.success++;
+    else
+        counts.errors++;
+    counts.byTool[toolName] = (counts.byTool[toolName] || 0) + 1;
+}
+export function getRequestCounts() {
+    return { ...counts };
+}
+export function resetRequestCounts() {
+    counts = { total: 0, success: 0, errors: 0, byTool: {}, startedAt: new Date().toISOString() };
+}
+//# sourceMappingURL=request-tracker.js.map

package/dist/src/mcp-tools/ruvllm-tools.d.ts

@@ -0,0 +1,9 @@
+/**
+ * RuVector LLM WASM MCP Tools
+ *
+ * Exposes @ruvector/ruvllm-wasm operations via MCP protocol.
+ * All tools gracefully degrade when the WASM package is not installed.
+ */
+import type { MCPTool } from './types.js';
+export declare const ruvllmWasmTools: MCPTool[];
+//# sourceMappingURL=ruvllm-tools.d.ts.map