specmem-hardwicksoftware 3.5.99

package/dist/tools/goofy/spawnResearchTeamMemberTool.js

@@ -0,0 +1,215 @@
+/**
+ * SPAWN RESEARCH TEAM_MEMBER TOOL
+ *
+ * MCP Tool wrapper for spawnResearchTeamMember functionality.
+ * Spawns  subprocess to research topics on the web and save to SpecMem.
+ *
+ * Why this exists:
+ * - Local embedding model is just a dumb vector generator
+ * - Can't actually understand or research things
+ * - This spawns  to do real web research
+ * - Results saved back to SpecMem for future retrieval
+ */
+import { spawnResearchTeamMember, getActiveResearchTeamMembers } from './spawnResearchTeamMember.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * SpawnResearchTeamMemberTool - spawns  to research topics fr fr
+ *
+ * When SpecMem needs more context than the local AI can provide,
+ * this tool spawns a  subprocess to do real web research
+ */
+export class SpawnResearchTeamMemberTool {
+    name = 'spawn_research_teamMember';
+    description = `Spawn a  subprocess to research a topic on the web and save findings to SpecMem.
+
+**IMPORTANT: MUST ASK USER BEFORE SPAWNING**
+Before calling this tool,  MUST use AskUserQuestion to confirm:
+{
+  "question": "I need to research '[topic]' on the web. Confirm deployment?",
+  "header": "Research Team Member",
+  "options": [
+    {"label": "Quick Search", "description": "1-2 sources, fast results"},
+    {"label": "Medium Search (Recommended)", "description": "3-5 sources, balanced"},
+    {"label": "Thorough Search", "description": "5-10 sources, comprehensive"},
+    {"label": "Cancel", "description": "Don't spawn research team member"}
+  ],
+  "multiSelect": false
+}
+
+Use this when you need current/accurate information that local memory doesn't have.
+The research team member will:
+1. Search the web for the topic using WebSearch
+2. Fetch and analyze sources using WebFetch
+3. Synthesize findings into a summary
+4. Save the research to SpecMem for future retrieval
+
+Examples:
+- Research "latest React 19 features" to get up-to-date docs
+- Research "PostgreSQL pgvector performance tips" for technical info
+- Research a specific error message to find solutions
+
+Parameters:
+- topic: What to research (required)
+- context: Why you need this info (helps focus research)
+- depth: quick (1-2 sources), medium (3-5), thorough (5-10)
+- saveToMemory: Save findings to SpecMem (default: true)
+- tags: Tags for saved memories
+- userConfirmed: Set to true after user confirms via AskUserQuestion (required for execution)`;
+    inputSchema = {
+        type: 'object',
+        properties: {
+            topic: {
+                type: 'string',
+                description: 'The topic to research on the web'
+            },
+            context: {
+                type: 'string',
+                description: 'Additional context about why this is needed'
+            },
+            depth: {
+                type: 'string',
+                enum: ['quick', 'medium', 'thorough'],
+                default: 'medium',
+                description: 'How deep to research - quick (1-2 sources), medium (3-5), thorough (5-10)'
+            },
+            saveToMemory: {
+                type: 'boolean',
+                default: true,
+                description: 'Whether to save findings as SpecMem memories'
+            },
+            tags: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Tags to apply to saved memories'
+            },
+            userConfirmed: {
+                type: 'boolean',
+                default: false,
+                description: 'REQUIRED: Must be true after user confirms via AskUserQuestion. Tool will return instructions if false.'
+            }
+        },
+        required: ['topic']
+    };
+    async execute(params) {
+        logger.info({ topic: params.topic, depth: params.depth, confirmed: params.userConfirmed }, '[SpawnResearchTeamMemberTool] Execute called');
+        // CHECK USER CONFIRMATION FIRST
+        if (!params.userConfirmed) {
+            logger.info({ topic: params.topic }, '[SpawnResearchTeamMemberTool] User confirmation required');
+            return {
+                success: false,
+                topic: params.topic,
+                summary: '',
+                sources: [],
+                memoriesCreated: 0,
+                error: `USER_CONFIRMATION_REQUIRED: Before spawning research team member, use AskUserQuestion:
+{
+  "questions": [{
+    "question": "I want to research '${params.topic}' on the web. Which search depth?",
+    "header": "Research",
+    "options": [
+      {"label": "Quick Search", "description": "1-2 sources, ~30 seconds"},
+      {"label": "Medium Search (Recommended)", "description": "3-5 sources, ~1 minute"},
+      {"label": "Thorough Search", "description": "5-10 sources, ~2 minutes"},
+      {"label": "Cancel", "description": "Don't spawn research team member"}
+    ],
+    "multiSelect": false
+  }]
+}
+Then call spawn_research_team member again with userConfirmed: true and the selected depth.`
+            };
+        }
+        // User confirmed - proceed with research
+        logger.info({ topic: params.topic, depth: params.depth }, '[SpawnResearchTeamMemberTool] Starting research (confirmed)');
+        try {
+            const result = await spawnResearchTeamMember({
+                topic: params.topic,
+                context: params.context,
+                depth: params.depth || 'medium',
+                saveToMemory: params.saveToMemory !== false,
+                tags: params.tags
+            });
+            return result;
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : 'Unknown error';
+            logger.error({ error: errorMsg, topic: params.topic }, '[SpawnResearchTeamMemberTool] Research failed');
+            return {
+                success: false,
+                topic: params.topic,
+                summary: '',
+                sources: [],
+                memoriesCreated: 0,
+                error: errorMsg
+            };
+        }
+    }
+}
+/**
+ * GetActiveResearchTeamMembersTool - check what research is in progress
+ *
+ * FIXED: Now properly awaits the async getActiveResearchTeamMembers() function
+ * which queries the database and verifies screen session liveness for accurate results.
+ */
+export class GetActiveResearchTeamMembersTool {
+    name = 'get_active_research_teamMembers';
+    description = `Get list of currently running research team members.
+
+Use this to check if research is still in progress or to monitor active research tasks.
+
+Returns:
+- List of active research team members with their ID, topic, start time, PID, screen session, and elapsed time
+- TeamMember count and status message
+
+The tool now queries the database for team members across all processes and verifies
+that the screen session is actually still running before including it in results.`;
+    inputSchema = {
+        type: 'object',
+        properties: {},
+        required: []
+    };
+    async execute() {
+        try {
+            const rawTeamMembers = await getActiveResearchTeamMembers();
+            const now = Date.now();
+            // Transform to include elapsedMs and status
+            const teamMembers = rawTeamMembers.map(a => ({
+                id: a.id,
+                topic: a.topic,
+                startTime: a.startTime,
+                pid: a.pid,
+                depth: a.depth,
+                screenSession: a.screenSession,
+                status: 'running',
+                elapsedMs: now - a.startTime
+            }));
+            const count = teamMembers.length;
+            let message;
+            if (count === 0) {
+                message = 'No research team members currently running.';
+            }
+            else if (count === 1) {
+                const teamMember = teamMembers[0];
+                const elapsed = `${Math.round(teamMember.elapsedMs / 1000)}s`;
+                message = `1 research team member running: "${teamMember.topic}" (${elapsed} elapsed, screen: ${teamMember.screenSession || 'N/A'})`;
+            }
+            else {
+                message = `${count} research team members currently running:\n${teamMembers.map(a => {
+                    const elapsed = `${Math.round(a.elapsedMs / 1000)}s`;
+                    return `- "${a.topic}" (${elapsed} elapsed, screen: ${a.screenSession || 'N/A'})`;
+                }).join('\n')}`;
+            }
+            logger.info({ count }, '[GetActiveResearchTeamMembersTool] Returning active team members');
+            return { teamMembers, count, message };
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : 'Unknown error';
+            logger.error({ error: errorMsg }, '[GetActiveResearchTeamMembersTool] Failed to get active team members');
+            return {
+                teamMembers: [],
+                count: 0,
+                message: `Error getting active teamMembers: ${errorMsg}`
+            };
+        }
+    }
+}
+//# sourceMappingURL=spawnResearchTeamMemberTool.js.map

package/dist/tools/goofy/spawnResearchTeamMemberTool.js.map

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

package/dist/tools/goofy/startWatchingTheFiles.d.ts

@@ -0,0 +1,81 @@
+/**
+ * startWatchingTheFiles.ts - Start File Watcher MCP Tool
+ *
+ * PROJECT-SCOPED: Only watches the current project directory
+ * Uses SPECMEM_PROJECT_PATH to determine scope
+ */
+import { z } from 'zod';
+import { WatcherManager } from '../../watcher/index.js';
+export declare const StartWatchingTheFilesInput: z.ZodObject<{
+    rootPath: z.ZodOptional<z.ZodString>;
+    syncCheckIntervalMinutes: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    rootPath?: string;
+    syncCheckIntervalMinutes?: number;
+}, {
+    rootPath?: string;
+    syncCheckIntervalMinutes?: number;
+}>;
+export type StartWatchingTheFilesParams = z.infer<typeof StartWatchingTheFilesInput>;
+export interface StartWatchingTheFilesResult {
+    success: boolean;
+    message: string;
+    projectScoped: boolean;
+    config: {
+        projectPath: string;
+        watchedPaths: string[];
+        syncCheckIntervalMinutes: number;
+        filesWatched?: number;
+    };
+}
+/**
+ * StartWatchingTheFiles - MCP tool to start file watcher
+ *
+ * PROJECT-SCOPED: Only watches the current project, not global paths
+ * This prevents RAM bloat from watching files across all sessions
+ */
+export declare class StartWatchingTheFiles {
+    /**
+     * execute - starts the file watcher (PROJECT-SCOPED)
+     */
+    static execute(params: StartWatchingTheFilesParams, watcherManager: WatcherManager): Promise<StartWatchingTheFilesResult>;
+    /**
+     * schema - MCP tool schema
+     */
+    static schema: {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {
+                rootPath: {
+                    type: string;
+                    description: string;
+                };
+                syncCheckIntervalMinutes: {
+                    type: string;
+                    description: string;
+                    minimum: number;
+                    maximum: number;
+                    default: number;
+                };
+            };
+        };
+    };
+}
+/**
+ * GetWatcherStatusResult - type for watcher status
+ */
+export interface GetWatcherStatusResult {
+    isRunning: boolean;
+    projectScoped: boolean;
+    projectPath: string | null;
+    watchedPaths: string[];
+    filesWatched: number;
+    eventsProcessed: number;
+}
+/**
+ * getWatcherStatusForMcp - helper to get watcher status for MCP responses
+ */
+export declare function getWatcherStatusForMcp(): GetWatcherStatusResult;
+//# sourceMappingURL=startWatchingTheFiles.d.ts.map

package/dist/tools/goofy/startWatchingTheFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startWatchingTheFiles.d.ts","sourceRoot":"","sources":["../../../src/tools/goofy/startWatchingTheFiles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAIxD,eAAO,MAAM,0BAA0B;;;;;;;;;EAIrC,CAAC;AAEH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAErF,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE;QACN,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,wBAAwB,EAAE,MAAM,CAAC;QACjC,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;;;;GAKG;AACH,qBAAa,qBAAqB;IAChC;;OAEG;WACU,OAAO,CAClB,MAAM,EAAE,2BAA2B,EACnC,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,2BAA2B,CAAC;IA8GvC;;OAEG;IACH,MAAM,CAAC,MAAM;;;;;;;;;;;;;;;;;;;MAmBX;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,sBAAsB,CAU/D"}

package/dist/tools/goofy/startWatchingTheFiles.js

@@ -0,0 +1,161 @@
+/**
+ * startWatchingTheFiles.ts - Start File Watcher MCP Tool
+ *
+ * PROJECT-SCOPED: Only watches the current project directory
+ * Uses SPECMEM_PROJECT_PATH to determine scope
+ */
+import { z } from 'zod';
+import { logger } from '../../utils/logger.js';
+import { getProjectContext } from '../../services/ProjectContext.js';
+import { getWatcherStatus, getWatchedPaths } from '../../mcp/watcherIntegration.js';
+export const StartWatchingTheFilesInput = z.object({
+    // Note: rootPath is DEPRECATED - always uses project path now
+    rootPath: z.string().optional().describe('DEPRECATED: Root directory to watch (ignored - always uses SPECMEM_PROJECT_PATH)'),
+    syncCheckIntervalMinutes: z.number().int().min(1).max(1440).default(60).describe('How often to check sync status in minutes (default: 60)')
+});
+/**
+ * StartWatchingTheFiles - MCP tool to start file watcher
+ *
+ * PROJECT-SCOPED: Only watches the current project, not global paths
+ * This prevents RAM bloat from watching files across all sessions
+ */
+export class StartWatchingTheFiles {
+    /**
+     * execute - starts the file watcher (PROJECT-SCOPED)
+     */
+    static async execute(params, watcherManager) {
+        const projectPath = getProjectContext().getProjectPath();
+        try {
+            // Warn if deprecated rootPath was provided
+            if (params.rootPath && params.rootPath !== projectPath) {
+                logger.warn({
+                    providedPath: params.rootPath,
+                    projectPath
+                }, 'rootPath parameter is DEPRECATED and ignored - using project path instead');
+            }
+            logger.info({ projectPath }, 'starting PROJECT-SCOPED file watcher via MCP tool');
+            // check if already running
+            const status = watcherManager.getStatus();
+            if (status.isRunning) {
+                const watchedPaths = getWatchedPaths();
+                return {
+                    success: true, // Changed to true - already running is OK
+                    message: `File watcher already running for project: ${projectPath}`,
+                    projectScoped: true,
+                    config: {
+                        projectPath,
+                        watchedPaths,
+                        syncCheckIntervalMinutes: params.syncCheckIntervalMinutes,
+                        filesWatched: status.watcher.filesWatched
+                    }
+                };
+            }
+            // start the watcher
+            await watcherManager.start(params.syncCheckIntervalMinutes);
+            // get updated status
+            const newStatus = watcherManager.getStatus();
+            const watchedPaths = getWatchedPaths();
+            // CRITICAL: Verify watcher actually started - dont trust the call alone
+            if (!newStatus.isRunning) {
+                logger.error({
+                    projectPath,
+                    status: newStatus
+                }, 'watcher start() completed but isRunning is false');
+                return {
+                    success: false,
+                    message: 'Watcher failed to start - manager not running after start() call',
+                    projectScoped: true,
+                    config: {
+                        projectPath,
+                        watchedPaths: [],
+                        syncCheckIntervalMinutes: params.syncCheckIntervalMinutes
+                    }
+                };
+            }
+            // also verify underlying file watcher is actually watching
+            if (!newStatus.watcher.isWatching) {
+                logger.error({
+                    projectPath,
+                    watcherStats: newStatus.watcher
+                }, 'watcher manager running but file watcher not active');
+                return {
+                    success: false,
+                    message: 'Watcher partially started but file monitoring not active',
+                    projectScoped: true,
+                    config: {
+                        projectPath,
+                        watchedPaths: [],
+                        syncCheckIntervalMinutes: params.syncCheckIntervalMinutes
+                    }
+                };
+            }
+            logger.info({
+                projectPath,
+                watchedPaths,
+                filesWatched: newStatus.watcher.filesWatched
+            }, 'PROJECT-SCOPED file watcher started and VERIFIED');
+            return {
+                success: true,
+                message: 'Project-scoped file watcher started and verified. Monitoring ' + newStatus.watcher.filesWatched + ' files in ' + projectPath,
+                projectScoped: true,
+                config: {
+                    projectPath,
+                    watchedPaths,
+                    syncCheckIntervalMinutes: params.syncCheckIntervalMinutes,
+                    filesWatched: newStatus.watcher.filesWatched
+                }
+            };
+        }
+        catch (error) {
+            logger.error({ error, projectPath }, 'failed to start project-scoped file watcher');
+            return {
+                success: false,
+                message: `Failed to start file watcher: ${error.message}`,
+                projectScoped: true,
+                config: {
+                    projectPath,
+                    watchedPaths: [],
+                    syncCheckIntervalMinutes: params.syncCheckIntervalMinutes
+                }
+            };
+        }
+    }
+    /**
+     * schema - MCP tool schema
+     */
+    static schema = {
+        name: 'start_watching',
+        description: 'Start file watcher to auto-update MCP memories when code changes. Monitors your entire codebase and keeps memories in sync with the filesystem. nah bruh this is ESSENTIAL for keeping everything up to date',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                rootPath: {
+                    type: 'string',
+                    description: 'Root directory to watch (defaults to current working directory)'
+                },
+                syncCheckIntervalMinutes: {
+                    type: 'number',
+                    description: 'How often to check sync status in minutes (default: 60)',
+                    minimum: 1,
+                    maximum: 1440,
+                    default: 60
+                }
+            }
+        }
+    };
+}
+/**
+ * getWatcherStatusForMcp - helper to get watcher status for MCP responses
+ */
+export function getWatcherStatusForMcp() {
+    const status = getWatcherStatus();
+    return {
+        isRunning: status.isRunning,
+        projectScoped: true, // Always project-scoped now
+        projectPath: status.projectPath,
+        watchedPaths: status.watchedPaths,
+        filesWatched: status.watcherStats?.watcher.filesWatched ?? 0,
+        eventsProcessed: status.watcherStats?.watcher.eventsProcessed ?? 0
+    };
+}
+//# sourceMappingURL=startWatchingTheFiles.js.map

package/dist/tools/goofy/startWatchingTheFiles.js.map

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

package/dist/tools/goofy/stopWatchingTheFiles.d.ts

@@ -0,0 +1,50 @@
+/**
+ * stopWatchingTheFiles.ts - Stop File Watcher MCP Tool
+ *
+ * yooo stopping the file watcher
+ */
+import { z } from 'zod';
+import type { WatcherManager } from '../../watcher/index.js';
+export declare const StopWatchingTheFilesInput: z.ZodObject<{
+    flushPending: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    flushPending?: boolean;
+}, {
+    flushPending?: boolean;
+}>;
+export type StopWatchingTheFilesParams = z.infer<typeof StopWatchingTheFilesInput>;
+export interface StopWatchingTheFilesResult {
+    success: boolean;
+    message: string;
+    stats: {
+        eventsProcessed: number;
+        pendingFlushed: number;
+    };
+}
+/**
+ * StopWatchingTheFiles - MCP tool to stop file watcher
+ */
+export declare class StopWatchingTheFiles {
+    /**
+     * execute - stops the file watcher
+     */
+    static execute(params: StopWatchingTheFilesParams, watcherManager: WatcherManager): Promise<StopWatchingTheFilesResult>;
+    /**
+     * schema - MCP tool schema
+     */
+    static schema: {
+        name: string;
+        description: string;
+        inputSchema: {
+            type: string;
+            properties: {
+                flushPending: {
+                    type: string;
+                    description: string;
+                    default: boolean;
+                };
+            };
+        };
+    };
+}
+//# sourceMappingURL=stopWatchingTheFiles.d.ts.map

package/dist/tools/goofy/stopWatchingTheFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stopWatchingTheFiles.d.ts","sourceRoot":"","sources":["../../../src/tools/goofy/stopWatchingTheFiles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,eAAO,MAAM,yBAAyB;;;;;;EAEpC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAEnF,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B;;OAEG;WACU,OAAO,CAClB,MAAM,EAAE,0BAA0B,EAClC,cAAc,EAAE,cAAc,GAC7B,OAAO,CAAC,0BAA0B,CAAC;IAqDtC;;OAEG;IACH,MAAM,CAAC,MAAM;;;;;;;;;;;;;MAaX;CACH"}

package/dist/tools/goofy/stopWatchingTheFiles.js

@@ -0,0 +1,81 @@
+/**
+ * stopWatchingTheFiles.ts - Stop File Watcher MCP Tool
+ *
+ * yooo stopping the file watcher
+ */
+import { z } from 'zod';
+import { logger } from '../../utils/logger.js';
+export const StopWatchingTheFilesInput = z.object({
+    flushPending: z.boolean().default(true).describe('Process all pending changes before stopping')
+});
+/**
+ * StopWatchingTheFiles - MCP tool to stop file watcher
+ */
+export class StopWatchingTheFiles {
+    /**
+     * execute - stops the file watcher
+     */
+    static async execute(params, watcherManager) {
+        try {
+            logger.info({ params }, 'stopping file watcher via MCP tool');
+            // check if running
+            const status = watcherManager.getStatus();
+            if (!status.isRunning) {
+                return {
+                    success: false,
+                    message: 'File watcher is not running',
+                    stats: {
+                        eventsProcessed: 0,
+                        pendingFlushed: 0
+                    }
+                };
+            }
+            const pendingCount = status.queue.currentQueueSize;
+            // flush pending changes if requested
+            if (params.flushPending && pendingCount > 0) {
+                logger.info({ pendingCount }, 'flushing pending changes before stop');
+                await watcherManager.flush();
+            }
+            // stop the watcher
+            await watcherManager.stop();
+            logger.info({ eventsProcessed: status.watcher.eventsProcessed }, 'file watcher stopped');
+            return {
+                success: true,
+                message: `File watcher stopped. Processed ${status.watcher.eventsProcessed} events total.`,
+                stats: {
+                    eventsProcessed: status.watcher.eventsProcessed,
+                    pendingFlushed: pendingCount
+                }
+            };
+        }
+        catch (error) {
+            logger.error({ error, params }, 'failed to stop file watcher');
+            return {
+                success: false,
+                message: `Failed to stop file watcher: ${error.message}`,
+                stats: {
+                    eventsProcessed: 0,
+                    pendingFlushed: 0
+                }
+            };
+        }
+    }
+    /**
+     * schema - MCP tool schema
+     */
+    static schema = {
+        name: 'stop_watching',
+        description: 'Stop the file watcher. Optionally processes all pending changes before stopping. Use this when you want to pause auto-updates temporarily.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                flushPending: {
+                    type: 'boolean',
+                    description: 'Process all pending changes before stopping (default: true)',
+                    default: true
+                }
+            }
+        }
+    };
+}
+//# sourceMappingURL=stopWatchingTheFiles.js.map

package/dist/tools/goofy/stopWatchingTheFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stopWatchingTheFiles.js","sourceRoot":"","sources":["../../../src/tools/goofy/stopWatchingTheFiles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAG/C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;CAChG,CAAC,CAAC;AAaH;;GAEG;AACH,MAAM,OAAO,oBAAoB;IAC/B;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAClB,MAAkC,EAClC,cAA8B;QAE9B,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,oCAAoC,CAAC,CAAC;YAE9D,mBAAmB;YACnB,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,EAAE,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACtB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,6BAA6B;oBACtC,KAAK,EAAE;wBACL,eAAe,EAAE,CAAC;wBAClB,cAAc,EAAE,CAAC;qBAClB;iBACF,CAAC;YACJ,CAAC;YAED,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC;YAEnD,qCAAqC;YACrC,IAAI,MAAM,CAAC,YAAY,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;gBAC5C,MAAM,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,EAAE,sCAAsC,CAAC,CAAC;gBACtE,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC;YAC/B,CAAC;YAED,mBAAmB;YACnB,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC;YAE5B,MAAM,CAAC,IAAI,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,sBAAsB,CAAC,CAAC;YAEzF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,mCAAmC,MAAM,CAAC,OAAO,CAAC,eAAe,gBAAgB;gBAC1F,KAAK,EAAE;oBACL,eAAe,EAAE,MAAM,CAAC,OAAO,CAAC,eAAe;oBAC/C,cAAc,EAAE,YAAY;iBAC7B;aACF,CAAC;QAEJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,6BAA6B,CAAC,CAAC;YAE/D,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,gCAAiC,KAAe,CAAC,OAAO,EAAE;gBACnE,KAAK,EAAE;oBACL,eAAe,EAAE,CAAC;oBAClB,cAAc,EAAE,CAAC;iBAClB;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,GAAG;QACd,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,4IAA4I;QACzJ,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,YAAY,EAAE;oBACZ,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,6DAA6D;oBAC1E,OAAO,EAAE,IAAI;iBACd;aACF;SACF;KACF,CAAC"}