@claude-flow/cli 3.0.0-alpha.13 → 3.0.0-alpha.15

package/src/mcp-tools/index.ts

@@ -1,16 +0,0 @@
-/**
- * MCP Tools Index for CLI
- *
- * Re-exports all tool definitions for use within the CLI package.
- */
-
-export type { MCPTool, MCPToolInputSchema, MCPToolResult } from './types.js';
-export { agentTools } from './agent-tools.js';
-export { swarmTools } from './swarm-tools.js';
-export { memoryTools } from './memory-tools.js';
-export { configTools } from './config-tools.js';
-export { hooksTools } from './hooks-tools.js';
-export { taskTools } from './task-tools.js';
-export { sessionTools } from './session-tools.js';
-export { hiveMindTools } from './hive-mind-tools.js';
-export { workflowTools } from './workflow-tools.js';

package/src/mcp-tools/memory-tools.ts

@@ -1,270 +0,0 @@
-/**
- * Memory MCP Tools for CLI
- *
- * Tool definitions for memory management with file-based persistence.
- */
-
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
-import { join, resolve } from 'path';
-import type { MCPTool } from './types.js';
-
-// Simple file-based memory store
-interface MemoryEntry {
-  key: string;
-  value: unknown;
-  metadata?: Record<string, unknown>;
-  storedAt: string;
-  accessCount: number;
-  lastAccessed: string;
-}
-
-interface MemoryStore {
-  entries: Record<string, MemoryEntry>;
-  version: string;
-}
-
-const MEMORY_DIR = '.claude-flow/memory';
-const MEMORY_FILE = 'store.json';
-
-function getMemoryPath(): string {
-  return resolve(join(MEMORY_DIR, MEMORY_FILE));
-}
-
-function ensureMemoryDir(): void {
-  const dir = resolve(MEMORY_DIR);
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-}
-
-function loadMemoryStore(): MemoryStore {
-  try {
-    const path = getMemoryPath();
-    if (existsSync(path)) {
-      const data = readFileSync(path, 'utf-8');
-      return JSON.parse(data);
-    }
-  } catch {
-    // Return empty store on error
-  }
-  return { entries: {}, version: '3.0.0' };
-}
-
-function saveMemoryStore(store: MemoryStore): void {
-  ensureMemoryDir();
-  writeFileSync(getMemoryPath(), JSON.stringify(store, null, 2), 'utf-8');
-}
-
-export const memoryTools: MCPTool[] = [
-  {
-    name: 'memory/store',
-    description: 'Store a value in memory (persisted to disk)',
-    category: 'memory',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        key: { type: 'string', description: 'Memory key' },
-        value: { description: 'Value to store' },
-        metadata: { type: 'object', description: 'Optional metadata' },
-      },
-      required: ['key', 'value'],
-    },
-    handler: async (input) => {
-      const store = loadMemoryStore();
-      const now = new Date().toISOString();
-
-      const entry: MemoryEntry = {
-        key: input.key as string,
-        value: input.value,
-        metadata: (input.metadata as Record<string, unknown>) || {},
-        storedAt: now,
-        accessCount: 0,
-        lastAccessed: now,
-      };
-
-      store.entries[input.key as string] = entry;
-      saveMemoryStore(store);
-
-      return {
-        success: true,
-        key: input.key,
-        stored: true,
-        storedAt: now,
-        totalEntries: Object.keys(store.entries).length,
-      };
-    },
-  },
-  {
-    name: 'memory/retrieve',
-    description: 'Retrieve a value from memory',
-    category: 'memory',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        key: { type: 'string', description: 'Memory key' },
-      },
-      required: ['key'],
-    },
-    handler: async (input) => {
-      const store = loadMemoryStore();
-      const key = input.key as string;
-      const entry = store.entries[key];
-
-      if (entry) {
-        // Update access stats
-        entry.accessCount++;
-        entry.lastAccessed = new Date().toISOString();
-        saveMemoryStore(store);
-
-        return {
-          key,
-          value: entry.value,
-          metadata: entry.metadata,
-          storedAt: entry.storedAt,
-          accessCount: entry.accessCount,
-          found: true,
-        };
-      }
-
-      return {
-        key,
-        value: null,
-        found: false,
-      };
-    },
-  },
-  {
-    name: 'memory/search',
-    description: 'Search memory by keyword',
-    category: 'memory',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        query: { type: 'string', description: 'Search query' },
-        limit: { type: 'number', description: 'Result limit' },
-      },
-      required: ['query'],
-    },
-    handler: async (input) => {
-      const store = loadMemoryStore();
-      const query = (input.query as string).toLowerCase();
-      const limit = (input.limit as number) || 10;
-      const startTime = performance.now();
-
-      const results = Object.values(store.entries)
-        .filter(entry => {
-          const keyMatch = entry.key.toLowerCase().includes(query);
-          const valueStr = typeof entry.value === 'string' ? entry.value.toLowerCase() : JSON.stringify(entry.value).toLowerCase();
-          const valueMatch = valueStr.includes(query);
-          return keyMatch || valueMatch;
-        })
-        .slice(0, limit)
-        .map(entry => ({
-          key: entry.key,
-          value: entry.value,
-          score: 1.0, // Simple keyword match
-          storedAt: entry.storedAt,
-        }));
-
-      const duration = performance.now() - startTime;
-
-      return {
-        query: input.query,
-        results,
-        total: results.length,
-        searchTime: `${duration.toFixed(2)}ms`,
-      };
-    },
-  },
-  {
-    name: 'memory/delete',
-    description: 'Delete a memory entry',
-    category: 'memory',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        key: { type: 'string', description: 'Memory key' },
-      },
-      required: ['key'],
-    },
-    handler: async (input) => {
-      const store = loadMemoryStore();
-      const key = input.key as string;
-      const existed = key in store.entries;
-
-      if (existed) {
-        delete store.entries[key];
-        saveMemoryStore(store);
-      }
-
-      return {
-        success: existed,
-        key,
-        deleted: existed,
-        remainingEntries: Object.keys(store.entries).length,
-      };
-    },
-  },
-  {
-    name: 'memory/list',
-    description: 'List all memory entries',
-    category: 'memory',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        limit: { type: 'number', description: 'Result limit' },
-        offset: { type: 'number', description: 'Result offset' },
-      },
-    },
-    handler: async (input) => {
-      const store = loadMemoryStore();
-      const limit = (input.limit as number) || 50;
-      const offset = (input.offset as number) || 0;
-
-      const allEntries = Object.values(store.entries);
-      const entries = allEntries.slice(offset, offset + limit).map(e => ({
-        key: e.key,
-        storedAt: e.storedAt,
-        accessCount: e.accessCount,
-        preview: typeof e.value === 'string'
-          ? e.value.substring(0, 50) + (e.value.length > 50 ? '...' : '')
-          : JSON.stringify(e.value).substring(0, 50),
-      }));
-
-      return {
-        entries,
-        total: allEntries.length,
-        limit,
-        offset,
-      };
-    },
-  },
-  {
-    name: 'memory/stats',
-    description: 'Get memory storage statistics',
-    category: 'memory',
-    inputSchema: {
-      type: 'object',
-      properties: {},
-    },
-    handler: async () => {
-      const store = loadMemoryStore();
-      const entries = Object.values(store.entries);
-      const totalSize = JSON.stringify(store).length;
-
-      return {
-        totalEntries: entries.length,
-        totalSize: `${(totalSize / 1024).toFixed(2)} KB`,
-        version: store.version,
-        backend: 'file',
-        location: getMemoryPath(),
-        oldestEntry: entries.length > 0
-          ? entries.reduce((a, b) => a.storedAt < b.storedAt ? a : b).storedAt
-          : null,
-        newestEntry: entries.length > 0
-          ? entries.reduce((a, b) => a.storedAt > b.storedAt ? a : b).storedAt
-          : null,
-      };
-    },
-  },
-];

package/src/mcp-tools/session-tools.ts

@@ -1,359 +0,0 @@
-/**
- * Session MCP Tools for CLI
- *
- * Tool definitions for session management with file persistence.
- */
-
-import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, unlinkSync, statSync } from 'node:fs';
-import { join } from 'node:path';
-import type { MCPTool } from './types.js';
-
-// Storage paths
-const STORAGE_DIR = '.claude-flow';
-const SESSION_DIR = 'sessions';
-
-interface SessionRecord {
-  sessionId: string;
-  name: string;
-  description?: string;
-  savedAt: string;
-  stats: {
-    tasks: number;
-    agents: number;
-    memoryEntries: number;
-    totalSize: number;
-  };
-  data?: {
-    memory?: Record<string, unknown>;
-    tasks?: Record<string, unknown>;
-    agents?: Record<string, unknown>;
-  };
-}
-
-function getSessionDir(): string {
-  return join(process.cwd(), STORAGE_DIR, SESSION_DIR);
-}
-
-function getSessionPath(sessionId: string): string {
-  // Sanitize sessionId to prevent path traversal
-  const safeId = sessionId.replace(/[^a-zA-Z0-9_-]/g, '_');
-  return join(getSessionDir(), `${safeId}.json`);
-}
-
-function ensureSessionDir(): void {
-  const dir = getSessionDir();
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-}
-
-function loadSession(sessionId: string): SessionRecord | null {
-  try {
-    const path = getSessionPath(sessionId);
-    if (existsSync(path)) {
-      const data = readFileSync(path, 'utf-8');
-      return JSON.parse(data);
-    }
-  } catch {
-    // Return null on error
-  }
-  return null;
-}
-
-function saveSession(session: SessionRecord): void {
-  ensureSessionDir();
-  writeFileSync(getSessionPath(session.sessionId), JSON.stringify(session, null, 2), 'utf-8');
-}
-
-function listSessions(): SessionRecord[] {
-  ensureSessionDir();
-  const dir = getSessionDir();
-  const files = readdirSync(dir).filter(f => f.endsWith('.json'));
-
-  const sessions: SessionRecord[] = [];
-  for (const file of files) {
-    try {
-      const data = readFileSync(join(dir, file), 'utf-8');
-      sessions.push(JSON.parse(data));
-    } catch {
-      // Skip invalid files
-    }
-  }
-
-  return sessions;
-}
-
-// Load related stores for session data
-function loadRelatedStores(options: { includeMemory?: boolean; includeTasks?: boolean; includeAgents?: boolean }) {
-  const data: SessionRecord['data'] = {};
-
-  if (options.includeMemory) {
-    try {
-      const memoryPath = join(process.cwd(), STORAGE_DIR, 'memory', 'store.json');
-      if (existsSync(memoryPath)) {
-        data.memory = JSON.parse(readFileSync(memoryPath, 'utf-8'));
-      }
-    } catch { /* ignore */ }
-  }
-
-  if (options.includeTasks) {
-    try {
-      const taskPath = join(process.cwd(), STORAGE_DIR, 'tasks', 'store.json');
-      if (existsSync(taskPath)) {
-        data.tasks = JSON.parse(readFileSync(taskPath, 'utf-8'));
-      }
-    } catch { /* ignore */ }
-  }
-
-  if (options.includeAgents) {
-    try {
-      const agentPath = join(process.cwd(), STORAGE_DIR, 'agents', 'store.json');
-      if (existsSync(agentPath)) {
-        data.agents = JSON.parse(readFileSync(agentPath, 'utf-8'));
-      }
-    } catch { /* ignore */ }
-  }
-
-  return data;
-}
-
-export const sessionTools: MCPTool[] = [
-  {
-    name: 'session/save',
-    description: 'Save current session state',
-    category: 'session',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        name: { type: 'string', description: 'Session name' },
-        description: { type: 'string', description: 'Session description' },
-        includeMemory: { type: 'boolean', description: 'Include memory in session' },
-        includeTasks: { type: 'boolean', description: 'Include tasks in session' },
-        includeAgents: { type: 'boolean', description: 'Include agents in session' },
-      },
-      required: ['name'],
-    },
-    handler: async (input) => {
-      const sessionId = `session-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
-
-      // Load related data based on options
-      const data = loadRelatedStores({
-        includeMemory: input.includeMemory as boolean,
-        includeTasks: input.includeTasks as boolean,
-        includeAgents: input.includeAgents as boolean,
-      });
-
-      // Calculate stats
-      const stats = {
-        tasks: data.tasks ? Object.keys((data.tasks as { tasks?: object }).tasks || {}).length : 0,
-        agents: data.agents ? Object.keys((data.agents as { agents?: object }).agents || {}).length : 0,
-        memoryEntries: data.memory ? Object.keys((data.memory as { entries?: object }).entries || {}).length : 0,
-        totalSize: 0,
-      };
-
-      const session: SessionRecord = {
-        sessionId,
-        name: input.name as string,
-        description: input.description as string,
-        savedAt: new Date().toISOString(),
-        stats,
-        data: Object.keys(data).length > 0 ? data : undefined,
-      };
-
-      // Calculate size
-      const sessionJson = JSON.stringify(session);
-      session.stats.totalSize = Buffer.byteLength(sessionJson, 'utf-8');
-
-      saveSession(session);
-
-      return {
-        sessionId,
-        name: session.name,
-        savedAt: session.savedAt,
-        stats: session.stats,
-        path: getSessionPath(sessionId),
-      };
-    },
-  },
-  {
-    name: 'session/restore',
-    description: 'Restore a saved session',
-    category: 'session',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        sessionId: { type: 'string', description: 'Session ID to restore' },
-        name: { type: 'string', description: 'Session name to restore' },
-      },
-    },
-    handler: async (input) => {
-      let session: SessionRecord | null = null;
-
-      // Try to find by sessionId first
-      if (input.sessionId) {
-        session = loadSession(input.sessionId as string);
-      }
-
-      // Try to find by name if sessionId not found
-      if (!session && input.name) {
-        const sessions = listSessions();
-        session = sessions.find(s => s.name === input.name) || null;
-      }
-
-      // Try to find latest if no params
-      if (!session && !input.sessionId && !input.name) {
-        const sessions = listSessions();
-        if (sessions.length > 0) {
-          sessions.sort((a, b) => new Date(b.savedAt).getTime() - new Date(a.savedAt).getTime());
-          session = sessions[0];
-        }
-      }
-
-      if (session) {
-        // Restore data to respective stores
-        if (session.data?.memory) {
-          const memoryDir = join(process.cwd(), STORAGE_DIR, 'memory');
-          if (!existsSync(memoryDir)) mkdirSync(memoryDir, { recursive: true });
-          writeFileSync(join(memoryDir, 'store.json'), JSON.stringify(session.data.memory, null, 2), 'utf-8');
-        }
-        if (session.data?.tasks) {
-          const taskDir = join(process.cwd(), STORAGE_DIR, 'tasks');
-          if (!existsSync(taskDir)) mkdirSync(taskDir, { recursive: true });
-          writeFileSync(join(taskDir, 'store.json'), JSON.stringify(session.data.tasks, null, 2), 'utf-8');
-        }
-        if (session.data?.agents) {
-          const agentDir = join(process.cwd(), STORAGE_DIR, 'agents');
-          if (!existsSync(agentDir)) mkdirSync(agentDir, { recursive: true });
-          writeFileSync(join(agentDir, 'store.json'), JSON.stringify(session.data.agents, null, 2), 'utf-8');
-        }
-
-        return {
-          sessionId: session.sessionId,
-          name: session.name,
-          restored: true,
-          restoredAt: new Date().toISOString(),
-          stats: session.stats,
-        };
-      }
-
-      return {
-        sessionId: input.sessionId || input.name || 'latest',
-        restored: false,
-        error: 'Session not found',
-      };
-    },
-  },
-  {
-    name: 'session/list',
-    description: 'List saved sessions',
-    category: 'session',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        limit: { type: 'number', description: 'Maximum sessions to return' },
-        sortBy: { type: 'string', description: 'Sort field (date, name, size)' },
-      },
-    },
-    handler: async (input) => {
-      let sessions = listSessions();
-
-      // Sort
-      const sortBy = (input.sortBy as string) || 'date';
-      if (sortBy === 'date') {
-        sessions.sort((a, b) => new Date(b.savedAt).getTime() - new Date(a.savedAt).getTime());
-      } else if (sortBy === 'name') {
-        sessions.sort((a, b) => a.name.localeCompare(b.name));
-      } else if (sortBy === 'size') {
-        sessions.sort((a, b) => b.stats.totalSize - a.stats.totalSize);
-      }
-
-      // Apply limit
-      const limit = (input.limit as number) || 10;
-      sessions = sessions.slice(0, limit);
-
-      return {
-        sessions: sessions.map(s => ({
-          sessionId: s.sessionId,
-          name: s.name,
-          description: s.description,
-          savedAt: s.savedAt,
-          stats: s.stats,
-        })),
-        total: sessions.length,
-        limit,
-      };
-    },
-  },
-  {
-    name: 'session/delete',
-    description: 'Delete a saved session',
-    category: 'session',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        sessionId: { type: 'string', description: 'Session ID to delete' },
-      },
-      required: ['sessionId'],
-    },
-    handler: async (input) => {
-      const sessionId = input.sessionId as string;
-      const path = getSessionPath(sessionId);
-
-      if (existsSync(path)) {
-        unlinkSync(path);
-        return {
-          sessionId,
-          deleted: true,
-          deletedAt: new Date().toISOString(),
-        };
-      }
-
-      return {
-        sessionId,
-        deleted: false,
-        error: 'Session not found',
-      };
-    },
-  },
-  {
-    name: 'session/info',
-    description: 'Get detailed session information',
-    category: 'session',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        sessionId: { type: 'string', description: 'Session ID' },
-      },
-      required: ['sessionId'],
-    },
-    handler: async (input) => {
-      const sessionId = input.sessionId as string;
-      const session = loadSession(sessionId);
-
-      if (session) {
-        const path = getSessionPath(sessionId);
-        const stat = statSync(path);
-
-        return {
-          sessionId: session.sessionId,
-          name: session.name,
-          description: session.description,
-          savedAt: session.savedAt,
-          stats: session.stats,
-          fileSize: stat.size,
-          path,
-          hasData: {
-            memory: !!session.data?.memory,
-            tasks: !!session.data?.tasks,
-            agents: !!session.data?.agents,
-          },
-        };
-      }
-
-      return {
-        sessionId,
-        error: 'Session not found',
-      };
-    },
-  },
-];