@hailer/mcp 0.1.10 → 0.1.12

package/dist/modules/bug-reports/giuseppe-git.js

@@ -0,0 +1,298 @@
+"use strict";
+/**
+ * Giuseppe Git Module - Git operations for committing, reverting, tagging
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GiuseppeGit = void 0;
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const logger_1 = require("../../lib/logger");
+const logger = (0, logger_1.createLogger)({ component: 'giuseppe-git' });
+class GiuseppeGit {
+    /**
+     * Get source files using git ls-files (fast and accurate)
+     */
+    async getSourceFilesFromGit(projectPath) {
+        try {
+            const result = (0, child_process_1.execSync)('git ls-files "*.tsx" "*.ts" "*.jsx" "*.js"', {
+                cwd: projectPath,
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe']
+            });
+            return result.trim().split('\n').filter(f => f && !f.includes('.test.') && !f.includes('.spec.'));
+        }
+        catch {
+            // Fallback returns empty - caller should use file scan instead
+            logger.debug('Git ls-files failed, caller should fallback to file scan', { projectPath });
+            return [];
+        }
+    }
+    /**
+     * Commit changes to git
+     */
+    async commitChanges(app, bug) {
+        try {
+            // Check if git is initialized
+            try {
+                (0, child_process_1.execSync)('git rev-parse --is-inside-work-tree', {
+                    cwd: app.projectPath,
+                    encoding: 'utf-8',
+                    stdio: 'pipe'
+                });
+            }
+            catch {
+                logger.warn('No git repo in app project - skipping commit', { app: app.name });
+                return { success: true, hash: 'no-git' };
+            }
+            // Stage all changes
+            (0, child_process_1.execSync)('git add -A', {
+                cwd: app.projectPath,
+                encoding: 'utf-8',
+                stdio: 'pipe'
+            });
+            // Create commit message
+            const commitMessage = `fix: ${bug.name}\n\nBug ID: ${bug.id}\nFixed by Giuseppe Bot`;
+            // Write commit message to temp file to avoid shell injection
+            const commitMsgFile = path.join(app.projectPath, '.git', 'COMMIT_MSG_TEMP');
+            await fs.writeFile(commitMsgFile, commitMessage, 'utf-8');
+            try {
+                (0, child_process_1.execSync)(`git commit -F "${commitMsgFile}"`, {
+                    cwd: app.projectPath,
+                    encoding: 'utf-8',
+                    stdio: 'pipe'
+                });
+            }
+            finally {
+                // Clean up temp file
+                try {
+                    await fs.unlink(commitMsgFile);
+                }
+                catch { /* ignore */ }
+            }
+            // Get commit hash
+            const hash = (0, child_process_1.execSync)('git rev-parse --short HEAD', {
+                cwd: app.projectPath,
+                encoding: 'utf-8',
+                stdio: 'pipe'
+            }).trim();
+            logger.info('Committed changes', { app: app.name, hash, bugId: bug.id });
+            return { success: true, hash };
+        }
+        catch (error) {
+            logger.error('Failed to commit changes', { app: app.name, error });
+            return { success: false };
+        }
+    }
+    /**
+     * Revert changes using git checkout
+     */
+    async revertChanges(app, files) {
+        if (files.length === 0) {
+            logger.info('No files to revert', { app: app.name });
+            return;
+        }
+        try {
+            // Check if git is initialized
+            try {
+                (0, child_process_1.execSync)('git rev-parse --is-inside-work-tree', {
+                    cwd: app.projectPath,
+                    encoding: 'utf-8',
+                    stdio: 'pipe'
+                });
+            }
+            catch {
+                logger.warn('No git repo in app project - cannot revert', { app: app.name });
+                return;
+            }
+            // Revert each file to HEAD
+            for (const file of files) {
+                try {
+                    (0, child_process_1.execSync)(`git checkout HEAD -- "${file}"`, {
+                        cwd: app.projectPath,
+                        encoding: 'utf-8',
+                        stdio: 'pipe'
+                    });
+                    logger.info('Reverted file', { app: app.name, file });
+                }
+                catch (error) {
+                    logger.warn('Failed to revert file', { app: app.name, file, error });
+                }
+            }
+            logger.info('Reverted changes', { app: app.name, fileCount: files.length });
+        }
+        catch (error) {
+            logger.error('Failed to revert changes', { app: app.name, error });
+        }
+    }
+    /**
+     * Get latest version from git tags (e.g., v1.0.1 -> 1.0.1)
+     * Returns null if no version tags found
+     */
+    getLatestVersionFromTags(projectPath) {
+        try {
+            // Get all version tags sorted by version (descending)
+            const output = (0, child_process_1.execSync)('git tag --list "v*" --sort=-v:refname 2>/dev/null | head -1', { cwd: projectPath, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+            if (output && output.startsWith('v')) {
+                const version = output.substring(1); // Remove 'v' prefix
+                logger.debug('Found latest version from git tags', { tag: output, version });
+                return version;
+            }
+            return null;
+        }
+        catch {
+            // No tags or git error - that's fine, fallback to manifest
+            return null;
+        }
+    }
+    /**
+     * Create and push a version tag after successful publish
+     */
+    createVersionTag(projectPath, version) {
+        try {
+            const tag = `v${version}`;
+            // Create annotated tag
+            (0, child_process_1.execSync)(`git tag -a "${tag}" -m "Release ${version}"`, {
+                cwd: projectPath,
+                stdio: 'pipe'
+            });
+            // Push the tag
+            (0, child_process_1.execSync)(`git push origin "${tag}"`, {
+                cwd: projectPath,
+                stdio: 'pipe'
+            });
+            logger.info('Created and pushed version tag', { tag, projectPath });
+            return true;
+        }
+        catch (error) {
+            logger.warn('Failed to create version tag', {
+                version,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return false;
+        }
+    }
+    /**
+     * Bump patch version in manifest.json (bug fixes always bump patch)
+     * Uses git tags to determine latest version, falls back to manifest
+     * 1.0.0 -> 1.0.1 -> 1.0.2 etc.
+     */
+    async bumpPatchVersion(projectPath) {
+        try {
+            // Find manifest.json
+            let manifestPath = path.join(projectPath, 'manifest.json');
+            let manifestExists = false;
+            try {
+                await fs.access(manifestPath);
+                manifestExists = true;
+            }
+            catch {
+                manifestPath = path.join(projectPath, 'public', 'manifest.json');
+                try {
+                    await fs.access(manifestPath);
+                    manifestExists = true;
+                }
+                catch {
+                    manifestExists = false;
+                }
+            }
+            if (!manifestExists) {
+                logger.warn('No manifest.json found for version bump', { projectPath });
+                return null;
+            }
+            const content = await fs.readFile(manifestPath, 'utf-8');
+            const manifest = JSON.parse(content);
+            // Get version from git tags first (persists across resets), fallback to manifest
+            const tagVersion = this.getLatestVersionFromTags(projectPath);
+            const manifestVersion = manifest.version || '0.0.0';
+            const oldVersion = tagVersion || manifestVersion;
+            logger.debug('Version sources', { tagVersion, manifestVersion, using: oldVersion });
+            // Parse and bump patch (x.y.z -> x.y.z+1)
+            const parts = oldVersion.split('.').map((p) => parseInt(p, 10) || 0);
+            while (parts.length < 3)
+                parts.push(0);
+            parts[2]++;
+            const newVersion = parts.join('.');
+            manifest.version = newVersion;
+            await fs.writeFile(manifestPath, JSON.stringify(manifest, null, 2) + '\n', 'utf-8');
+            logger.info('Bumped patch version', { oldVersion, newVersion, manifestPath, fromTag: !!tagVersion });
+            return { oldVersion, newVersion };
+        }
+        catch (error) {
+            logger.error('Failed to bump patch version', { projectPath, error });
+            return null;
+        }
+    }
+    /**
+     * Push to git remote
+     */
+    async push(projectPath) {
+        try {
+            (0, child_process_1.execSync)('git push', { cwd: projectPath, stdio: 'pipe' });
+            logger.info('Pushed to git', { projectPath });
+            return true;
+        }
+        catch (pushError) {
+            logger.warn('Git push failed (non-fatal)', {
+                error: pushError instanceof Error ? pushError.message : String(pushError)
+            });
+            return false;
+        }
+    }
+    /**
+     * Stage and commit version bump
+     */
+    async commitVersionBump(projectPath, version) {
+        try {
+            (0, child_process_1.execSync)('git add manifest.json public/manifest.json 2>/dev/null || git add manifest.json', {
+                cwd: projectPath,
+                stdio: 'pipe'
+            });
+            (0, child_process_1.execSync)(`git commit -m "chore: bump version to ${version} for bug fix"`, {
+                cwd: projectPath,
+                stdio: 'pipe'
+            });
+            return true;
+        }
+        catch {
+            // Version file might already be staged, or git not initialized
+            logger.debug('Version commit skipped (may already be committed)');
+            return false;
+        }
+    }
+}
+exports.GiuseppeGit = GiuseppeGit;
+//# sourceMappingURL=giuseppe-git.js.map

package/dist/modules/bug-reports/giuseppe-prompt.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Giuseppe System Prompt - Expert TypeScript/React debugger prompt
+ */
+export declare const GIUSEPPE_SYSTEM_PROMPT = "<identity>\nYou are Giuseppe, an expert TypeScript/React debugger for Hailer apps.\nYou fix bugs by TRACING code paths, not by guessing.\n</identity>\n\n<expertise>\nTYPESCRIPT: Strict types, interfaces, generics, type guards\nREACT: Hooks, state, effects, memoization, dependency arrays\nCHAKRA UI: Box, Flex, useColorModeValue, responsive props\nHAILER SDK: useHailerContext, useActivity, useWorkflows, activity fields\nCANVAS: 2D context, drawing, hit detection, coordinate systems\n</expertise>\n\n<debugging-process>\nSTEP 1: TRACE THE CODE PATH\n- What function handles the user action? (onClick, onMouseMove, etc.)\n- What state/props does it use?\n- What conditions might fail?\n\nSTEP 2: CHECK REACT REACTIVITY\n- Is state being SET? (setState called)\n- Is component RE-RENDERING? (check useCallback/useMemo deps)\n- Are closures STALE? (missing deps = old values)\n\nSTEP 3: IDENTIFY EXACT FAILURE POINT\nGOOD: \"handleClick uses selectedId but renderList deps array is missing selectedId\"\nBAD: \"Something might be wrong with the click handler\"\n\nSTEP 4: MINIMAL FIX\n- Add missing dependency to array\n- Add missing prop to component\n- Fix the one broken thing - don't refactor\n</debugging-process>\n\n<react-patterns>\nDEPENDENCY ARRAY BUGS (most common!):\n- useCallback/useMemo/useEffect use state but deps array missing it\n- Symptom: UI doesn't update when state changes\n- Fix: Add ALL used state variables to deps array\n\nSTATE UPDATE BUGS:\n- setState called but component doesn't re-render\n- Check if state is used in memoized callback with stale closure\n\nPROP DRILLING BUGS:\n- Prop passed but not used in child\n- Prop used but not passed from parent\n\nEVENT HANDLER BUGS:\n- Handler defined but not connected to element\n- Handler connected but wrong event type\n</react-patterns>\n\n<hailer-sdk>\nuseHailerContext() - workspace, user, permissions\nuseActivity(id) - load single activity by ID\nuseWorkflows() - list available workflows\nActivity fields keyed by FIELD ID not label\nAlways handle loading states\nuseToast() for notifications\n</hailer-sdk>\n\n<output-format>\n{\n  \"debugTrace\": \"Step-by-step: function X calls Y, which uses state Z, but useCallback deps missing Z\",\n  \"failurePoint\": \"File.tsx line N - deps array missing stateVariable\",\n  \"rootCause\": \"Stale closure - useCallback keeps old value of stateVariable\",\n  \"fix\": {\n    \"files\": [{\n      \"path\": \"src/components/File.tsx\",\n      \"action\": \"edit\",\n      \"search\": \"exact code to find\",\n      \"replace\": \"fixed code\"\n    }]\n  },\n  \"explanation\": \"Added stateVariable to deps array so callback updates when state changes\",\n  \"testSuggestions\": [\"How to verify the fix works\"]\n}\n</output-format>\n\n<rules>\n1. TRACE before fixing - follow the code path\n2. CHECK DEPS ARRAYS - most common React bug\n3. Fix ONE thing - minimal change\n4. Use EXACT file paths from provided code\n5. Search string must EXACTLY match file content\n</rules>";
+//# sourceMappingURL=giuseppe-prompt.d.ts.map

package/dist/modules/bug-reports/giuseppe-prompt.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * Giuseppe System Prompt - Expert TypeScript/React debugger prompt
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GIUSEPPE_SYSTEM_PROMPT = void 0;
+exports.GIUSEPPE_SYSTEM_PROMPT = `<identity>
+You are Giuseppe, an expert TypeScript/React debugger for Hailer apps.
+You fix bugs by TRACING code paths, not by guessing.
+</identity>
+
+<expertise>
+TYPESCRIPT: Strict types, interfaces, generics, type guards
+REACT: Hooks, state, effects, memoization, dependency arrays
+CHAKRA UI: Box, Flex, useColorModeValue, responsive props
+HAILER SDK: useHailerContext, useActivity, useWorkflows, activity fields
+CANVAS: 2D context, drawing, hit detection, coordinate systems
+</expertise>
+
+<debugging-process>
+STEP 1: TRACE THE CODE PATH
+- What function handles the user action? (onClick, onMouseMove, etc.)
+- What state/props does it use?
+- What conditions might fail?
+
+STEP 2: CHECK REACT REACTIVITY
+- Is state being SET? (setState called)
+- Is component RE-RENDERING? (check useCallback/useMemo deps)
+- Are closures STALE? (missing deps = old values)
+
+STEP 3: IDENTIFY EXACT FAILURE POINT
+GOOD: "handleClick uses selectedId but renderList deps array is missing selectedId"
+BAD: "Something might be wrong with the click handler"
+
+STEP 4: MINIMAL FIX
+- Add missing dependency to array
+- Add missing prop to component
+- Fix the one broken thing - don't refactor
+</debugging-process>
+
+<react-patterns>
+DEPENDENCY ARRAY BUGS (most common!):
+- useCallback/useMemo/useEffect use state but deps array missing it
+- Symptom: UI doesn't update when state changes
+- Fix: Add ALL used state variables to deps array
+
+STATE UPDATE BUGS:
+- setState called but component doesn't re-render
+- Check if state is used in memoized callback with stale closure
+
+PROP DRILLING BUGS:
+- Prop passed but not used in child
+- Prop used but not passed from parent
+
+EVENT HANDLER BUGS:
+- Handler defined but not connected to element
+- Handler connected but wrong event type
+</react-patterns>
+
+<hailer-sdk>
+useHailerContext() - workspace, user, permissions
+useActivity(id) - load single activity by ID
+useWorkflows() - list available workflows
+Activity fields keyed by FIELD ID not label
+Always handle loading states
+useToast() for notifications
+</hailer-sdk>
+
+<output-format>
+{
+  "debugTrace": "Step-by-step: function X calls Y, which uses state Z, but useCallback deps missing Z",
+  "failurePoint": "File.tsx line N - deps array missing stateVariable",
+  "rootCause": "Stale closure - useCallback keeps old value of stateVariable",
+  "fix": {
+    "files": [{
+      "path": "src/components/File.tsx",
+      "action": "edit",
+      "search": "exact code to find",
+      "replace": "fixed code"
+    }]
+  },
+  "explanation": "Added stateVariable to deps array so callback updates when state changes",
+  "testSuggestions": ["How to verify the fix works"]
+}
+</output-format>
+
+<rules>
+1. TRACE before fixing - follow the code path
+2. CHECK DEPS ARRAYS - most common React bug
+3. Fix ONE thing - minimal change
+4. Use EXACT file paths from provided code
+5. Search string must EXACTLY match file content
+</rules>`;
+//# sourceMappingURL=giuseppe-prompt.js.map

package/dist/modules/bug-reports/index.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Bug Reports Module
+ *
+ * Self-contained module for bug monitoring and auto-fixing.
+ * No hardcoded IDs - discovers workflow by name pattern.
+ *
+ * Usage:
+ *   import { BugReportsModule } from './modules/bug-reports';
+ *
+ *   const module = new BugReportsModule(userContext);
+ *   await module.start();
+ *
+ * Configuration (in order of precedence):
+ * 1. Hailer "MCP Config" workflow activity named "Bug Reports Config"
+ * 2. Environment variables (BUG_MONITOR_*)
+ * 3. Default values
+ */
+import type { UserContext } from '../../mcp/UserContextCache';
+import type { BugReportsConfig, BugReport, FixResult } from './types';
+export declare class BugReportsModule {
+    private userContext;
+    private monitor?;
+    private giuseppe?;
+    private config?;
+    private started;
+    constructor(userContext: UserContext);
+    /**
+     * Register a bot user ID to ignore messages from
+     * Call this before start() to ensure all bots are registered
+     */
+    registerBotUser(userId: string): void;
+    private _pendingBotUsers?;
+    /**
+     * Register a handler for when Giuseppe is disabled but a bug is found
+     * Call this before start() to ensure handler is registered
+     */
+    onGiuseppeDisabled(handler: (bug: BugReport) => Promise<void>): void;
+    private _pendingGiuseppeDisabledHandlers?;
+    /**
+     * Start the bug reports module
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the module
+     */
+    stop(): Promise<void>;
+    /**
+     * Get current configuration
+     */
+    getConfig(): BugReportsConfig;
+    /**
+     * Check if module is running
+     */
+    isRunning(): boolean;
+    /**
+     * Manually trigger a bug fix (for testing or manual dispatch)
+     */
+    fixBug(bug: BugReport): Promise<FixResult>;
+    /**
+     * Register a custom bug handler
+     */
+    onNewBug(handler: (bug: BugReport, userContext: UserContext) => Promise<void>): void;
+}
+export type { BugReportsConfig, BugReport, FixResult, AppRegistryEntry, WorkflowDiscoveryResult } from './types';
+export { BugMonitor } from './bug-monitor';
+export { GiuseppeBot } from './giuseppe-bot';
+export { loadConfig, discoverWorkflow, getDefaultConfig } from './bug-config';
+export { PendingRegistry, PendingItem } from './pending-registry';
+export { pendingFixRegistry, PendingFixInfo } from './pending-fix-registry';
+export { pendingClassificationRegistry, PendingClassificationInfo } from './pending-classification-registry';
+export { GiuseppeAI, BugClassification, ClassificationResult, FileContent } from './giuseppe-ai';
+export type { FixPlan } from './giuseppe-ai';
+export { GiuseppeGit } from './giuseppe-git';
+export { GiuseppeFiles, ApplyResult, ScannedApp } from './giuseppe-files';
+export { GIUSEPPE_SYSTEM_PROMPT } from './giuseppe-prompt';
+//# sourceMappingURL=index.d.ts.map