@hailer/mcp 0.2.4 → 0.2.5

package/CLAUDE.md

@@ -34,10 +34,32 @@ NEVER forget: You delegate, agents execute, you report back.
 </identity>
 
 <orchestrator-rules>
-DO DIRECTLY: Answer from context, summarize agent results, run push/sync commands
-DELEGATE TO AGENTS: File reads, API calls, data creation/updates, complex reasoning
+DO DIRECTLY:
+- Run commands agents return (Bash)
+- Interpret agent JSON for users
+- Route tasks to agents
+
+DELEGATE ALWAYS:
+- File reads → agent-kenji-data-reader (haiku)
+- Activity CRUD → agent-dmitri-activity-crud (haiku)
+- Config questions → agent-bjorn-config-audit (haiku)
+- Code navigation → agent-lars-code-inspector (haiku)
+- Everything else → see <agents> table
+
+BOOTSTRAP EXCEPTION:
+- You may read CLAUDE.md and .claude/agents/*.md to know routing rules
+- Everything else gets delegated
+
+RATIONALE: Haiku is cheaper than Opus. Delegate aggressively.
 
 Agents return JSON. You interpret it for the user.
+
+**FIX ROOT CAUSE, NEVER BANDAID:**
+When something fails, NEVER work around it. Always:
+1. Report the error to user
+2. Identify the root cause
+3. Fix the source file/config that's broken
+4. Never wrap, bypass, or apply temporary fixes
 </orchestrator-rules>
 
 <agents>
@@ -58,6 +80,8 @@ Agents return JSON. You interpret it for the user.
 | Skills, agent improvements | `agent-ada-skill-builder` | sonnet |
 | Document templates | `agent-ingrid-doc-templates` | sonnet |
 | Name functions | `agent-nora-name-functions` | sonnet |
+| Publish plugins | `agent-marketplace-publisher` | sonnet |
+| Review plugin PRs | `agent-marketplace-reviewer` | haiku |
 </agents>
 
 <delegation-protocol>
@@ -108,6 +132,25 @@ YOU must:
 3. If declined: report cancellation to user
 </needs-confirmation>
 
+<agent-chaining>
+When agents return `trigger_review` or similar chaining directives:
+```json
+{
+  "status": "success",
+  "result": { ... },
+  "trigger_review": {
+    "agent": "marketplace-reviewer:agent-marketplace-reviewer",
+    "input": { "task": "review", "branch": "publish/plugin-name-v1.0.0" }
+  }
+}
+```
+
+YOU must:
+1. Report the first agent's success to user
+2. Immediately spawn the chained agent with the provided input
+3. Report the chained agent's result to user
+</agent-chaining>
+
 ---
 
 <local-first>
@@ -133,9 +176,14 @@ SAFE: npm run pull, npm run generate
 </safety>
 
 <lsp-setup>
-**New users:** Install LSP plugin for TypeScript support:
-1. `/plugin install typescript-lsp@hailer-mcp-marketplace`
-2. Restart: `claude -c`
+**LSP for TypeScript/JavaScript:** Requires plugin setup.
+
+`agent-lars-code-inspector` is included by default, but LSP tool requires:
+```
+/marketplace-setup
+/install-plugin lars-code-inspector
+claude -c
+```
 
 `ENABLE_LSP_TOOL` is auto-set via `.claude/settings.json`.
 </lsp-setup>
@@ -188,60 +236,58 @@ WITHOUT AGENTS: Use MCP tools directly
 <plugin-marketplace>
 Community agents are shared via the Hailer Agent Marketplace (separate git repo).
 
-**Marketplace URL:** `git@gitlab.com:hailer-repos/hailer-mcp-marketplace.git`
+**Marketplace URL:** `git@github.com:Bdolf/Hailer-Marketplace.git`
 
-**Installed marketplace agents:**
-No marketplace agents installed.
-
-
-
-
-
-
-
-
-
-**Use plugin agents:**
-```
-Task(subagent_type="plugin:agent-name", prompt="...", model="haiku|sonnet")
-```
-
-**Agent sources:**
-- Default agents: `.claude/agents/` (shipped via npm)
-- Community agents: Plugin marketplace (installed separately)
+**Plugin commands:**
+| Command | Action |
+|---------|--------|
+| `/marketplace-setup` | Clone/pull marketplace repo to `./hailer-marketplace` |
+| `/list-plugins` | List available plugins in marketplace |
+| `/install-plugin <name>` | Copy plugin to `.claude/`, add to `<agents>` table |
+| `/uninstall-plugin <name>` | Remove plugin from `.claude/`, remove from `<agents>` table |
+| `/publish-plugin` | Pre-flight checks, spawn publisher agent → auto-reviews |
 </plugin-marketplace>
 
 <plugin-setup>
-When user asks to install plugins or set up the marketplace:
+When user asks to install plugins:
 
-1. Tell user to run these slash commands:
+1. First, ensure marketplace is cloned:
    ```
-   /plugin marketplace add git@gitlab.com:hailer-repos/hailer-mcp-marketplace.git
-   /plugin install <plugin-name>
+   /marketplace-setup
    ```
 
-2. Tell user: "Restart Claude Code to load the plugin. Use `claude -c` to keep your conversation context."
+2. Install the plugin:
+   ```
+   /install-plugin <plugin-name>
+   ```
 
-Available plugins: `permissions-handler`, `voice-notifications`, `typescript-lsp`
+3. Tell user: "Restart Claude Code to load the plugin. Run `claude -c` to keep your conversation context."
 
-After restart, sync hook updates this file automatically with installed agents.
+**What `/install-plugin` does:**
+- Copies agents to `.claude/agents/`
+- Copies skills to `.claude/skills/`
+- Copies hooks to `.claude/hooks/`
+- Auto-installs native LSP if plugin requires it
 
 **IMPORTANT:** After installing OR uninstalling plugins, always tell the user:
 > "Restart required for changes to take effect. Run `claude -c` to restart while keeping your conversation context."
 </plugin-setup>
 
 <plugin-contributing>
-To contribute agents to the marketplace:
+To contribute plugins to the marketplace:
 
-1. Clone: `git clone git@gitlab.com:hailer-repos/hailer-mcp-marketplace.git`
-2. Create plugin structure:
+1. Ensure marketplace is cloned: `/marketplace-setup`
+2. Create plugin in `./hailer-marketplace/`:
    ```
    my-plugin/
      .claude-plugin/plugin.json
      agents/agent-my-agent.md
+     skills/my-skill/         (optional)
+     hooks/my-hook.cjs        (optional)
+     .lsp.json                (optional, for LSP support)
    ```
 3. Follow agent structure from `<agent-structure>` section
-4. Push to repo
+4. Publish via PR workflow: `/publish-plugin`
 </plugin-contributing>
 
 <directory>
@@ -253,5 +299,6 @@ workspace/              # Local config (check FIRST)
   skills/               # On-demand documentation
   commands/             # Slash commands
   settings.json         # Permissions
+hailer-marketplace/     # Local marketplace clone (run /marketplace-setup)
 ```
 </directory>

package/dist/app.js

@@ -17,6 +17,7 @@ const core = new core_1.Core();
 logger.info('Registering tools...');
 logger.info('Nuclear tools status', { enabled: config_1.environment.ENABLE_NUCLEAR_TOOLS });
 core.addTool(file_1.uploadFilesTool);
+core.addTool(file_1.downloadFileTool);
 core.addTool(activity_1.listActivitiesTool);
 core.addTool(activity_1.showActivityByIdTool);
 core.addTool(activity_1.createActivityTool);
@@ -86,7 +87,12 @@ if (config_1.environment.MCP_CLIENT_ENABLED) {
     core.addTool(disableBotTool);
     core.addTool(checkSpecialistStatusTool);
     // Dynamic import bug-fixer tools
-    const { bugFixerFindAppTool, bugFixerListFilesTool, bugFixerReadFileTool, bugFixerWriteFileTool, bugFixerApplyFixTool, bugFixerRunBuildTool, bugFixerGitStatusTool, bugFixerGitPullTool, bugFixerGitCommitTool, bugFixerGitPushTool, bugFixerGitRevertTool, bugFixerPublishAppTool } = require('./mcp/tools/bug-fixer-tools');
+    const { 
+    // Low-level tools
+    bugFixerFindAppTool, bugFixerListFilesTool, bugFixerReadFileTool, bugFixerWriteFileTool, bugFixerApplyFixTool, bugFixerRunBuildTool, bugFixerGitStatusTool, bugFixerGitPullTool, bugFixerGitCommitTool, bugFixerGitPushTool, bugFixerGitRevertTool, bugFixerPublishAppTool, 
+    // High-level workflow tools (LLM-driven)
+    bugFixerAnalyzeBugTool, bugFixerStartFixTool, bugFixerMarkDeclinedTool, bugFixerPublishFixTool, bugFixerRetryFixTool } = require('./mcp/tools/bug-fixer-tools');
+    // Low-level tools
     core.addTool(bugFixerFindAppTool);
     core.addTool(bugFixerListFilesTool);
     core.addTool(bugFixerReadFileTool);
@@ -99,6 +105,12 @@ if (config_1.environment.MCP_CLIENT_ENABLED) {
     core.addTool(bugFixerGitPushTool);
     core.addTool(bugFixerGitRevertTool);
     core.addTool(bugFixerPublishAppTool);
+    // High-level workflow tools (LLM-driven)
+    core.addTool(bugFixerAnalyzeBugTool);
+    core.addTool(bugFixerStartFixTool);
+    core.addTool(bugFixerMarkDeclinedTool);
+    core.addTool(bugFixerPublishFixTool);
+    core.addTool(bugFixerRetryFixTool);
     logger.info('Bot-internal tools registered (MCP_CLIENT_ENABLED=true)');
 }
 logger.info('All tools registered successfully');

package/dist/config.d.ts

@@ -49,6 +49,7 @@ export declare const environment: {
     CONTEXT_MAX_SUMMARIZATION_CHUNKS: number;
     WORKSPACE_CONFIG_PATH?: string | undefined;
     DEV_APPS_PATH?: string | undefined;
+    DEV_APPS_PATHS?: string | undefined;
     OPENAI_API_KEY?: string | undefined;
     OPENAI_API_BASE?: string | undefined;
     OPENAI_MODEL?: string | undefined;

package/dist/config.js

@@ -105,6 +105,9 @@ const environmentSchema = zod_1.z.object({
     WORKSPACE_CONFIG_PATH: zod_1.z.string().optional(),
     // Development apps path (for scaffolding Hailer apps outside the repo)
     DEV_APPS_PATH: zod_1.z.string().optional(),
+    // Multiple app directories for Bug Fixer - comma-separated paths
+    // Example: DEV_APPS_PATHS=/path/to/apps,/path/to/other/apps
+    DEV_APPS_PATHS: zod_1.z.string().optional(),
     // LLM providers
     OPENAI_API_KEY: zod_1.z.string().min(1).optional(),
     OPENAI_API_BASE: zod_1.z.string().url().optional(),

package/dist/core.d.ts

@@ -17,7 +17,6 @@ export declare class Core {
     private mcpServer?;
     private daemonManagers;
     private statusLogIntervals;
-    private bugReportsModules;
     private daemonInitInProgress;
     private initialDaemonReady;
     constructor();
@@ -33,10 +32,10 @@ export declare class Core {
      */
     private startMCPClient;
     /**
-     * Start Bug Monitor for all workspaces with running daemons
-     * Each workspace gets its own bug monitor instance
+     * Start Bug Fixer in standalone mode (no orchestrator/AI Hub needed)
+     * Uses BUG_FIXER_EMAIL and BUG_FIXER_PASSWORD env vars
      */
-    private startBugMonitor;
+    private startStandaloneBugFixer;
     private initBotConfig;
     /**
      * Register webhook handler for bot config updates

package/dist/core.js

@@ -19,7 +19,6 @@ class Core {
     mcpServer;
     daemonManagers = new Map(); // workspace ID -> DaemonManager
     statusLogIntervals = new Map(); // workspace ID -> interval
-    bugReportsModules = new Map(); // workspace ID -> BugReportsModule
     daemonInitInProgress = new Set(); // workspace IDs currently initializing
     initialDaemonReady = new Set(); // workspace IDs that have completed first init
     constructor() {
@@ -67,9 +66,8 @@ class Core {
                 // Initialize bot config persistence (reads config from Hailer Agent Directory)
                 await this.initBotConfig();
                 // Start daemons for all workspaces with orchestrator
+                // Bug Fixer is now a specialist daemon (configured in AI Hub, runs per-workspace)
                 await this.startMCPClient();
-                // Start Bug Monitor service (reads config from Hailer)
-                await this.startBugMonitor();
             }
             this.setupGracefulShutdown();
             this.logger.info('All configured services started successfully');
@@ -95,6 +93,13 @@ class Core {
      * Start MCP Client (daemons) for all workspaces with enabled orchestrators
      */
     async startMCPClient() {
+        // Check for standalone Bug Fixer mode (bypass AI Hub/orchestrator)
+        const standaloneBugFixer = process.env.BUG_MONITOR_ENABLED === 'true' && process.env.BUG_FIXER_EMAIL;
+        if (standaloneBugFixer) {
+            this.logger.info('Standalone Bug Fixer mode detected - starting Bug Fixer only');
+            await this.startStandaloneBugFixer();
+            return;
+        }
         this.logger.info('Starting Chat Agent Daemons for all enabled workspaces');
         // Load all workspace configs
         const { loadBotConfigs } = require('./bot-config');
@@ -143,68 +148,27 @@ class Core {
         });
     }
     /**
-     * Start Bug Monitor for all workspaces with running daemons
-     * Each workspace gets its own bug monitor instance
+     * Start Bug Fixer in standalone mode (no orchestrator/AI Hub needed)
+     * Uses BUG_FIXER_EMAIL and BUG_FIXER_PASSWORD env vars
      */
-    async startBugMonitor() {
+    async startStandaloneBugFixer() {
+        const email = process.env.BUG_FIXER_EMAIL;
+        const password = process.env.BUG_FIXER_PASSWORD || '';
+        this.logger.info('Starting standalone Bug Fixer', { email: email.replace(/(.{3}).*@/, '$1***@') });
         try {
-            // Get all configured accounts
-            const accounts = Object.entries(this.appConfig.hailerAccounts);
-            if (accounts.length === 0) {
-                this.logger.info('No Hailer accounts configured - Bug Reports Module disabled');
+            // Dynamic import
+            const { createStandaloneBugFixer } = require('./agents/factory');
+            const daemon = await createStandaloneBugFixer(email, password);
+            if (!daemon) {
+                this.logger.error('Failed to create standalone Bug Fixer');
                 return;
             }
-            // Start bug monitor for each workspace that has a running daemon
-            for (const [workspaceId, daemonManager] of this.daemonManagers) {
-                try {
-                    // Find the appropriate API key for this workspace
-                    // For now, use the first account (could be enhanced to match workspace-specific accounts)
-                    const [apiKey] = accounts[0];
-                    const userContext = await UserContextCache_1.UserContextCache.getContext(apiKey);
-                    // Dynamic import - agents only needed when client is enabled
-                    const { BugReportsModule } = require('./agents/bug-fixer');
-                    const bugReportsModule = new BugReportsModule(userContext);
-                    // Register bot user IDs to ignore (so bug monitor only processes human messages)
-                    const daemonStatus = daemonManager.getStatus();
-                    for (const daemon of daemonStatus) {
-                        bugReportsModule.registerBotUser(daemon.botId);
-                        this.logger.debug('Registered bot user for bug monitor to ignore', {
-                            workspaceId,
-                            botId: daemon.botId
-                        });
-                    }
-                    // Register bug fixer disabled handler to trigger HAL response (BEFORE start!)
-                    bugReportsModule.onBugFixerDisabled(async (bug) => {
-                        if (bug.discussionId) {
-                            const context = `[System notification: A new bug report "${bug.name}" was detected, but Bug Fixer (the auto-fix bot) is currently disabled. The user may ask how to enable Bug Fixer or want to know more about this bug. Be helpful and explain they can enable Bug Fixer in the AI Hub app.]`;
-                            await daemonManager.triggerHalResponse(bug.discussionId, bug.id, context);
-                        }
-                    });
-                    await bugReportsModule.start();
-                    if (bugReportsModule.isRunning()) {
-                        this.bugReportsModules.set(workspaceId, bugReportsModule);
-                        const config = bugReportsModule.getConfig();
-                        this.logger.info('Bug Reports Module started', {
-                            workspaceId,
-                            autoFix: config.autoFix,
-                            interval: `${config.intervalMs / 1000}s`
-                        });
-                    }
-                }
-                catch (error) {
-                    this.logger.warn('Bug Reports Module failed to start for workspace - continuing with other workspaces', {
-                        workspaceId,
-                        error: error instanceof Error ? error.message : String(error)
-                    });
-                }
-            }
-            this.logger.info('Bug Reports Module initialization complete', {
-                successCount: this.bugReportsModules.size,
-                totalAttempted: this.daemonManagers.size
-            });
+            // Store in daemon managers using a special key
+            this.daemonManagers.set('standalone-bugfixer', daemon);
+            this.logger.info('Standalone Bug Fixer started successfully');
         }
         catch (error) {
-            this.logger.warn('Bug Reports Module failed to start - server will continue without bug monitoring', {
+            this.logger.error('Standalone Bug Fixer failed to start', {
                 error: error instanceof Error ? error.message : String(error)
             });
         }
@@ -447,12 +411,6 @@ class Core {
                 this.logger.debug('Stopped status logging', { workspaceId });
             }
             this.statusLogIntervals.clear();
-            // Stop all Bug Reports Modules
-            for (const [workspaceId, module] of this.bugReportsModules) {
-                await module.stop();
-                this.logger.debug('Stopped Bug Reports Module', { workspaceId });
-            }
-            this.bugReportsModules.clear();
             // Cleanup bot config (clear timers and callbacks) - only if client was enabled
             if (this.appConfig.server.enableClient) {
                 const { cleanupBotConfig } = require('./bot-config');

package/dist/mcp/tools/bug-fixer-tools.d.ts

@@ -17,5 +17,27 @@ export declare const bugFixerGitCommitTool: Tool;
 export declare const bugFixerGitPushTool: Tool;
 export declare const bugFixerGitRevertTool: Tool;
 export declare const bugFixerPublishAppTool: Tool;
+/**
+ * Analyze Bug Tool - Read bug report and get classification info
+ * The LLM uses this to understand the bug and decide next steps
+ */
+export declare const bugFixerAnalyzeBugTool: Tool;
+/**
+ * Start Fix Tool - Begin the bug fix process
+ * This triggers the full fix workflow: find app → analyze → apply fix → build
+ */
+export declare const bugFixerStartFixTool: Tool;
+/**
+ * Mark Declined Tool - Mark bug as not-a-bug and close it
+ */
+export declare const bugFixerMarkDeclinedTool: Tool;
+/**
+ * Publish Fix Tool - Publish the fix to production
+ */
+export declare const bugFixerPublishFixTool: Tool;
+/**
+ * Retry Fix Tool - Retry a fix with additional context/explanation
+ */
+export declare const bugFixerRetryFixTool: Tool;
 export declare const bugFixerTools: Tool[];
 //# sourceMappingURL=bug-fixer-tools.d.ts.map