@magic-ingredients/tiny-brain-local 0.19.0 → 0.20.0

package/dist/core/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/core/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0BH,OAAO,KAAK,EAA4B,QAAQ,EAAkC,MAAM,oCAAoC,CAAC;AAE7H,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAQ5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IAEF,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,sBAAsB,CAA0D;IACxF,OAAO,CAAC,mBAAmB,CAA2G;IACtI,OAAO,CAAC,UAAU,CAA6E;IAC/F,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,gBAAgB,CAAC,CAAmB;gBAEhC,MAAM,GAAE,SAAc;IAwFlC,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,SAAS,IAAI,SAAS;IAItB;;OAEG;IACH,mBAAmB,IAAI,gBAAgB,GAAG,SAAS;IAInD;;OAEG;IACH,oBAAoB,IAAI,iBAAiB,GAAG,IAAI;IAIhD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBjC;;;;;;;OAOG;YACW,sBAAsB;IA+DpC;;OAEG;YACW,iBAAiB;IAW/B;;;OAGG;YACW,oBAAoB;IA6BlC;;OAEG;YACW,oBAAoB;IAkHlC;;;;;;OAMG;YACW,yBAAyB;IA+CvC;;OAEG;YACW,kBAAkB;IAsBhC;;OAEG;YACW,wBAAwB;IA8BtC;;OAEG;YACW,mBAAmB;IA8BjC;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAiBjB,eAAe;YAMf,cAAc;YA+Fd,iBAAiB;YAMjB,eAAe;YAqEf,iBAAiB;IAS/B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAkD7B"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/core/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0BH,OAAO,KAAK,EAA4B,QAAQ,EAAkC,MAAM,oCAAoC,CAAC;AAE7H,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAQ5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IAEF,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,QAAQ,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,sBAAsB,CAA0D;IACxF,OAAO,CAAC,mBAAmB,CAA2G;IACtI,OAAO,CAAC,UAAU,CAA6E;IAC/F,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,gBAAgB,CAAC,CAAmB;gBAEhC,MAAM,GAAE,SAAc;IAwFlC,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,SAAS,IAAI,SAAS;IAItB;;OAEG;IACH,mBAAmB,IAAI,gBAAgB,GAAG,SAAS;IAInD;;OAEG;IACH,oBAAoB,IAAI,iBAAiB,GAAG,IAAI;IAIhD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBjC;;;;;;;OAOG;YACW,sBAAsB;IA+DpC;;OAEG;YACW,iBAAiB;IAW/B;;;OAGG;YACW,oBAAoB;IA6BlC;;OAEG;YACW,oBAAoB;IAwGlC;;;;;;OAMG;YACW,yBAAyB;IA+CvC;;OAEG;YACW,kBAAkB;IAsBhC;;OAEG;YACW,wBAAwB;IA8BtC;;OAEG;YACW,mBAAmB;IA8BjC;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAiBjB,eAAe;YAMf,cAAc;YA+Fd,iBAAiB;YAMjB,eAAe;YAqEf,iBAAiB;IAS/B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAkD7B"}

package/dist/core/mcp-server.js

@@ -8,7 +8,7 @@ import { existsSync, cpSync, readdirSync, readFileSync, writeFileSync, mkdirSync
 import { execSync } from 'child_process';
 import { Server as McpServer } from '@modelcontextprotocol/sdk/server/index.js';
 import { ListToolsRequestSchema, CallToolRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, SetLevelRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { isDevelopment as checkIsDevelopment } from '@magic-ingredients/tiny-brain-core';
+import { isDevelopment as checkIsDevelopment, detectClaudeCliStatus } from '@magic-ingredients/tiny-brain-core';
 import { AuthTokenService } from '../services/remote/auth-token-service.js';
 import { CredentialStorageService } from '../services/credential-storage.service.js';
 import { SystemPersonaService } from '../services/remote/system-persona-service.js';
@@ -276,12 +276,11 @@ export class MCPServer {
             hasClientSecret: !!this.config.account?.clientSecret,
             configKeys: Object.keys(this.config)
         });
-        // Create credential service to check for credentials and LLM API key
+        // Create credential service to check for credentials
         const credentialService = new CredentialStorageService();
-        // Check LLM API key availability (for dashboard to disable/enable skill invocation buttons)
-        const hasLlmApiKey = await credentialService.hasLlmApiKey();
-        // Create getter function for the actual API key (for skill invocation)
-        const getLlmApiKey = () => credentialService.getLlmApiKey();
+        // Check Claude CLI availability (for dashboard to disable/enable skill invocation buttons)
+        const cliStatus = await detectClaudeCliStatus(this.logger);
+        const hasClaudeCli = cliStatus.authenticated;
         // Check for remote auth credentials
         if (!this.config.account?.clientId || !this.config.account?.clientSecret) {
             this.logger.info('No remote credentials configured in MCP config, checking tiny-brain CLI config...');
@@ -298,13 +297,11 @@ export class MCPServer {
                 }
                 else {
                     this.logger.info('No credentials found in CLI config either, running in local-only mode');
-                    // Still set libraryAuth with hasLlmApiKey for dashboard
                     this.baseContext.libraryAuth = {
                         clientId: undefined,
                         hasStoredSecret: false,
-                        hasLlmApiKey,
+                        hasClaudeCli,
                         token: undefined,
-                        getLlmApiKey
                     };
                     return;
                 }
@@ -312,13 +309,11 @@ export class MCPServer {
             catch (error) {
                 this.logger.warn('Error reading CLI config:', error);
                 this.logger.info('Running in local-only mode');
-                // Still set libraryAuth with hasLlmApiKey for dashboard
                 this.baseContext.libraryAuth = {
                     clientId: undefined,
                     hasStoredSecret: false,
-                    hasLlmApiKey,
+                    hasClaudeCli,
                     token: undefined,
-                    getLlmApiKey
                 };
                 return;
             }
@@ -343,9 +338,8 @@ export class MCPServer {
                 this.baseContext.libraryAuth = {
                     clientId: this.config.account?.clientId,
                     hasStoredSecret: true,
-                    hasLlmApiKey,
+                    hasClaudeCli,
                     token: token.token,
-                    getLlmApiKey
                 };
             }
             else {
@@ -356,22 +350,19 @@ export class MCPServer {
                 this.baseContext.libraryAuth = {
                     clientId: this.config.account?.clientId,
                     hasStoredSecret: !!this.config.account?.clientSecret,
-                    hasLlmApiKey,
+                    hasClaudeCli,
                     token: undefined,
-                    getLlmApiKey
                 };
             }
         }
         catch (error) {
             this.logger.error('Unexpected error during remote authentication', error);
             // Continue in local mode - don't fail the entire initialization
-            // Still set libraryAuth with hasLlmApiKey for dashboard
             this.baseContext.libraryAuth = {
                 clientId: this.config.account?.clientId,
                 hasStoredSecret: !!this.config.account?.clientSecret,
-                hasLlmApiKey,
+                hasClaudeCli,
                 token: undefined,
-                getLlmApiKey
             };
         }
     }

package/dist/services/analyse-service.d.ts

@@ -29,6 +29,7 @@ export interface AnalyseResult {
     };
     skillPermissionsAdded?: string[];
     writtenTechContexts?: string[];
+    agentsMdStatus?: 'created' | 'updated' | 'up-to-date';
 }
 /**
  * Service for managing repository analysis
@@ -45,6 +46,20 @@ export declare class AnalyseService {
      * Perform repository analysis with unified behavior for initialized/uninitialized repos
      */
     performAnalysis(options?: AnalyseOptions): Promise<AnalyseResult>;
+    /**
+     * Generate AGENTS.md file in the repository root
+     * For monorepos, also generates per-package AGENTS.md files
+     * Uses AgentsMdService from tiny-brain-core
+     */
+    private generateAgentsMd;
+    /**
+     * Read package.json from each workspace directory to collect names and descriptions
+     */
+    private collectPackageDescriptions;
+    /**
+     * Generate AGENTS.md for each workspace package in a monorepo
+     */
+    private generatePerPackageAgentsMd;
     /**
      * Register repository in dashboard for visibility
      * Called after successful analysis regardless of invocation method
@@ -95,6 +110,10 @@ export declare class AnalyseService {
      * Format analysis output for display
      */
     formatAnalysisOutput(result: AnalyseResult): string;
+    /**
+     * Append rich metadata sections to output lines
+     */
+    private appendRichMetadataOutput;
     /**
      * Compare two tech stacks and return differences
      * Handles null previous analysis (first run)

package/dist/services/analyse-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyse-service.d.ts","sourceRoot":"","sources":["../../src/services/analyse-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,aAAa,EAMnB,MAAM,oCAAoC,CAAC;AAS5C,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAGD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,CAAC,EAAE;QACR,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;IACF,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAGD;;;GAGG;AACH,qBAAa,cAAc;IAMb,OAAO,CAAC,OAAO;IAL3B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,kBAAkB,CAAqB;gBAE3B,OAAO,EAAE,cAAc;IAO3C;;OAEG;IACG,eAAe,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAwJ3E;;;OAGG;YACW,kBAAkB;IAoBhC;;OAEG;YACW,eAAe;IAc7B;;;OAGG;YACW,sBAAsB;IAwBpC;;;OAGG;YACW,sBAAsB;IAwBpC;;;OAGG;YACW,0BAA0B;IAwBxC;;;OAGG;YACW,wBAAwB;IAwBtC;;;;OAIG;YACW,kBAAkB;IA+EhC;;;;OAIG;YACW,sBAAsB;IAiEpC;;;OAGG;YACW,yBAAyB;IAkCvC;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IAiHnD;;;OAGG;IACH,iBAAiB,CAAC,gBAAgB,EAAE,YAAY,GAAG,IAAI,EAAE,eAAe,EAAE,YAAY,GAAG,aAAa;IA8BtG;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;CAWxB"}
+{"version":3,"file":"analyse-service.d.ts","sourceRoot":"","sources":["../../src/services/analyse-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,aAAa,EAQnB,MAAM,oCAAoC,CAAC;AAS5C,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAGD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,YAAY,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,CAAC,EAAE;QACR,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,CAAC;IACF,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,cAAc,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;CACvD;AAGD;;;GAGG;AACH,qBAAa,cAAc;IAMb,OAAO,CAAC,OAAO;IAL3B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,kBAAkB,CAAqB;gBAE3B,OAAO,EAAE,cAAc;IAO3C;;OAEG;IACG,eAAe,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAyK3E;;;;OAIG;YACW,gBAAgB;IAmD9B;;OAEG;YACW,0BAA0B;IAyBxC;;OAEG;YACW,0BAA0B;IA+BxC;;;OAGG;YACW,kBAAkB;IAoBhC;;OAEG;YACW,eAAe;IAc7B;;;OAGG;YACW,sBAAsB;IAwBpC;;;OAGG;YACW,sBAAsB;IAwBpC;;;OAGG;YACW,0BAA0B;IAwBxC;;;OAGG;YACW,wBAAwB;IAwBtC;;;;OAIG;YACW,kBAAkB;IA+EhC;;;;OAIG;YACW,sBAAsB;IAiEpC;;;OAGG;YACW,yBAAyB;IAkCvC;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IAgInD;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA2ChC;;;OAGG;IACH,iBAAiB,CAAC,gBAAgB,EAAE,YAAY,GAAG,IAAI,EAAE,eAAe,EAAE,YAAY,GAAG,aAAa;IA8BtG;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;CAWxB"}

package/dist/services/analyse-service.js

@@ -4,7 +4,7 @@
  * Handles repository tech stack analysis.
  * Focused solely on analysis - no context file management.
  */
-import { analyseRepository, formatTechStackChanges, detectTechStackChanges, ConfigService, RepoConfigService, LibraryClient, TechContextService, } from '@magic-ingredients/tiny-brain-core';
+import { analyseRepository, formatTechStackChanges, detectTechStackChanges, ConfigService, RepoConfigService, LibraryClient, TechContextService, AgentsMdService, } from '@magic-ingredients/tiny-brain-core';
 import { RepoService } from './repo-service.js';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
@@ -60,6 +60,13 @@ export class AnalyseService {
             primaryLanguage: currentAnalysis.primaryLanguage,
             documentationPattern: currentAnalysis.documentationPattern,
             documentationLocations: currentAnalysis.documentationLocations,
+            // Rich metadata
+            packageManager: currentAnalysis.packageManager,
+            scripts: currentAnalysis.scripts,
+            linting: currentAnalysis.linting,
+            monorepo: currentAnalysis.monorepo,
+            projectName: currentAnalysis.projectName,
+            sourceDirectories: currentAnalysis.sourceDirectories,
         };
         const stackChanged = await this.techContextService.hasStackChanged(analysisInput);
         const existingAnalysis = await this.techContextService.readAnalysis();
@@ -79,6 +86,12 @@ export class AnalyseService {
         if (!dryRun) {
             await this.techContextService.syncAgents(enableAgentic);
         }
+        // Generate AGENTS.md (if config allows)
+        let agentsMdStatus;
+        const manageAgentsMd = await this.configService.isManageAgentsMdEnabled();
+        if (!dryRun && manageAgentsMd) {
+            agentsMdStatus = await this.generateAgentsMd(currentAnalysis);
+        }
         // Write workflow sections to CLAUDE.md based on config flags (SDD, TDD)
         if (!dryRun) {
             await this.repoService.writeWorkflowSections({ contextPath });
@@ -105,7 +118,8 @@ export class AnalyseService {
                 contextBlockVersion,
                 contextBlockUpdated,
                 skillPermissionsAdded: skillPermissionsAdded.length > 0 ? skillPermissionsAdded : undefined,
-                writtenTechContexts
+                writtenTechContexts,
+                agentsMdStatus,
             };
         }
         if (!stackChanged) {
@@ -125,7 +139,8 @@ export class AnalyseService {
                 contextBlockVersion,
                 contextBlockUpdated,
                 skillPermissionsAdded: skillPermissionsAdded.length > 0 ? skillPermissionsAdded : undefined,
-                writtenTechContexts
+                writtenTechContexts,
+                agentsMdStatus,
             };
         }
         // Changes detected - compute diff for display purposes
@@ -163,9 +178,108 @@ export class AnalyseService {
                 techStackRemoved: techStackDiff.removed
             },
             skillPermissionsAdded: skillPermissionsAdded.length > 0 ? skillPermissionsAdded : undefined,
-            writtenTechContexts
+            writtenTechContexts,
+            agentsMdStatus,
         };
     }
+    /**
+     * Generate AGENTS.md file in the repository root
+     * For monorepos, also generates per-package AGENTS.md files
+     * Uses AgentsMdService from tiny-brain-core
+     */
+    async generateAgentsMd(analysis) {
+        const repoRoot = process.cwd();
+        const agentsMdService = new AgentsMdService(repoRoot);
+        const agentsMdPath = join(repoRoot, 'AGENTS.md');
+        // Read existing AGENTS.md if present
+        let existingContent;
+        try {
+            existingContent = await readFile(agentsMdPath, 'utf-8');
+        }
+        catch {
+            // File doesn't exist
+        }
+        // Extract README excerpt
+        const readmeExcerpt = await agentsMdService.extractReadmeExcerpt();
+        // Collect package descriptions for monorepo
+        let packageDescriptions;
+        if (analysis.monorepo?.packages && analysis.monorepo.packages.length > 0) {
+            packageDescriptions = await this.collectPackageDescriptions(repoRoot, analysis.monorepo.packages);
+        }
+        // Generate root content
+        const result = await agentsMdService.generateContent({
+            analysis,
+            readmeExcerpt,
+            repoPath: repoRoot,
+            existingContent,
+            packageDescriptions,
+        });
+        if (!existingContent) {
+            await writeFile(agentsMdPath, result.content, 'utf-8');
+            this.context.logger.info('Created AGENTS.md');
+        }
+        else if (!result.contentChanged) {
+            this.context.logger.info('AGENTS.md is up to date');
+        }
+        else {
+            await writeFile(agentsMdPath, result.content, 'utf-8');
+            this.context.logger.info('Updated AGENTS.md');
+        }
+        // Generate per-package AGENTS.md for monorepo
+        if (analysis.monorepo?.packages && analysis.monorepo.packages.length > 0) {
+            await this.generatePerPackageAgentsMd(repoRoot, analysis, agentsMdService);
+        }
+        if (!existingContent)
+            return 'created';
+        if (!result.contentChanged)
+            return 'up-to-date';
+        return 'updated';
+    }
+    /**
+     * Read package.json from each workspace directory to collect names and descriptions
+     */
+    async collectPackageDescriptions(repoRoot, packages) {
+        const descriptions = [];
+        for (const pkgPath of packages) {
+            const fullPath = join(repoRoot, pkgPath);
+            const pkgJsonPath = join(fullPath, 'package.json');
+            try {
+                const raw = await readFile(pkgJsonPath, 'utf-8');
+                const pkgJson = JSON.parse(raw);
+                descriptions.push({
+                    name: pkgJson.name,
+                    path: pkgPath,
+                    description: pkgJson.description,
+                });
+            }
+            catch {
+                descriptions.push({ path: pkgPath });
+            }
+        }
+        return descriptions;
+    }
+    /**
+     * Generate AGENTS.md for each workspace package in a monorepo
+     */
+    async generatePerPackageAgentsMd(repoRoot, analysis, agentsMdService) {
+        const packages = analysis.monorepo?.packages ?? [];
+        for (const pkgPath of packages) {
+            const fullPkgPath = join(repoRoot, pkgPath);
+            const pkgAgentsMdPath = join(fullPkgPath, 'AGENTS.md');
+            let existingPkgContent;
+            try {
+                existingPkgContent = await readFile(pkgAgentsMdPath, 'utf-8');
+            }
+            catch {
+                // File doesn't exist
+            }
+            const pkgResult = await agentsMdService.generatePackageContent(fullPkgPath, analysis, existingPkgContent);
+            if (!existingPkgContent || pkgResult.contentChanged) {
+                await writeFile(pkgAgentsMdPath, pkgResult.content, 'utf-8');
+                this.context.logger.debug(`Wrote AGENTS.md for ${pkgPath}`);
+            }
+        }
+    }
     /**
      * Register repository in dashboard for visibility
      * Called after successful analysis regardless of invocation method
@@ -506,6 +620,9 @@ export class AnalyseService {
             lines.push(`  Frameworks: ${result.analysis.frameworks.join(', ')}`);
             lines.push(`  Build Tools: ${result.analysis.buildTools.join(', ')}`);
             lines.push(`  Testing Tools: ${result.analysis.testingTools.join(', ')}`);
+            if (result.analysis.packageManager) {
+                lines.push(`  Package Manager: ${result.analysis.packageManager}`);
+            }
             if (result.analysis.documentationPattern) {
                 lines.push(`\n📚 Documentation: ${result.analysis.documentationPattern}`);
                 if (result.analysis.documentationLocations) {
@@ -578,8 +695,64 @@ export class AnalyseService {
                 lines.push('  None');
             }
         }
+        // Rich metadata sections (shown in all cases when data exists)
+        this.appendRichMetadataOutput(lines, result.analysis);
+        // AGENTS.md status (shown in all cases)
+        if (result.agentsMdStatus) {
+            const statusLabel = result.agentsMdStatus === 'created' ? 'Created'
+                : result.agentsMdStatus === 'updated' ? 'Updated'
+                    : 'Up to date';
+            lines.push(`\nAGENTS.md: ${statusLabel}`);
+        }
         return lines.join('\n');
     }
+    /**
+     * Append rich metadata sections to output lines
+     */
+    appendRichMetadataOutput(lines, analysis) {
+        // Package manager (shown when not already in tech stack section)
+        if (analysis.packageManager) {
+            lines.push(`\n  Package Manager: ${analysis.packageManager}`);
+        }
+        // Commands section
+        const scripts = analysis.scripts;
+        if (scripts && (scripts.test?.command || scripts.build?.command || scripts.dev?.command || scripts.lint?.command || scripts.e2e?.command)) {
+            lines.push('\n📋 Commands:');
+            if (scripts.test?.command)
+                lines.push(`  Test: ${scripts.test.command}`);
+            if (scripts.build?.command)
+                lines.push(`  Build: ${scripts.build.command}`);
+            if (scripts.dev?.command)
+                lines.push(`  Dev: ${scripts.dev.command}`);
+            if (scripts.lint?.command)
+                lines.push(`  Lint: ${scripts.lint.command}`);
+            if (scripts.e2e?.command)
+                lines.push(`  E2E: ${scripts.e2e.command}`);
+        }
+        // Linting section
+        if (analysis.linting) {
+            lines.push('\n🔍 Linting:');
+            if (analysis.linting.tool) {
+                lines.push(`  Tool: ${analysis.linting.tool}`);
+            }
+            if (analysis.linting.plugins && analysis.linting.plugins.length > 0) {
+                lines.push(`  Plugins: ${analysis.linting.plugins.join(', ')}`);
+            }
+        }
+        // Monorepo section
+        if (analysis.monorepo) {
+            lines.push('\n📦 Monorepo:');
+            if (analysis.monorepo.tool) {
+                lines.push(`  Tool: ${analysis.monorepo.tool}`);
+            }
+            if (analysis.monorepo.packages && analysis.monorepo.packages.length > 0) {
+                lines.push('  Packages:');
+                for (const pkg of analysis.monorepo.packages) {
+                    lines.push(`    - ${pkg}`);
+                }
+            }
+        }
+    }
     /**
      * Compare two tech stacks and return differences
      * Handles null previous analysis (first run)

package/dist/services/repo-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo-service.d.ts","sourceRoot":"","sources":["../../src/services/repo-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAIlE,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,WAAW;IAMV,OAAO,CAAC,OAAO;IAL3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAA2B;IACnE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAyB;IAE/D,OAAO,CAAC,aAAa,CAAgB;gBAEjB,OAAO,EAAE,cAAc;IAS3C;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACG,4BAA4B,CAChC,eAAe,GAAE,MAAoB,GACpC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmCzB;;;;OAIG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOvD;;OAEG;IACH,cAAc,IAAI,OAAO;IAUzB;;;OAGG;IACG,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC;IAcjD;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAa5B;;;;;;;;OAQG;IACG,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,IAAI,CAAC;IA6FtF;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAyBhC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA4GlC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoChC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAwErC;;OAEG;IACH,OAAO,CAAC,gCAAgC;CAyCzC"}
+{"version":3,"file":"repo-service.d.ts","sourceRoot":"","sources":["../../src/services/repo-service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAIlE,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,WAAW;IAMV,OAAO,CAAC,OAAO;IAL3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAA2B;IACnE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAyB;IAE/D,OAAO,CAAC,aAAa,CAAgB;gBAEjB,OAAO,EAAE,cAAc;IAS3C;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACG,4BAA4B,CAChC,eAAe,GAAE,MAAoB,GACpC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAmCzB;;;;OAIG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAOvD;;OAEG;IACH,cAAc,IAAI,OAAO;IAUzB;;;OAGG;IACG,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC;IAcjD;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAa5B;;;;;;;;OAQG;IACG,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,IAAI,CAAC;IA6FtF;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IA0BhC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA6GlC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoChC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAwErC;;OAEG;IACH,OAAO,CAAC,gCAAgC;CAyCzC"}

package/dist/services/repo-service.js

@@ -229,7 +229,8 @@ export class RepoService {
     formatRepoContextSection(enableAgenticCoding) {
         let content = `## Repository Context
 
-Before starting work, read \`.tiny-brain/analysis.json\` for the detected tech stack, test patterns, and documentation locations.
+Before starting work, read \`AGENTS.md\` for comprehensive project context (tech stack, commands, structure).
+Also read \`.tiny-brain/analysis.json\` for detailed detection data and test patterns.
 
 `;
         if (enableAgenticCoding) {
@@ -292,6 +293,7 @@ Description of changes...
 | \`fix:\` | Bug fixes | Yes |
 | \`refactor:\` | Code improvement | Yes |
 | \`chore:\` | Maintenance (untracked) | No |
+| \`untracked:\` | Work not related to any PRD or Fix | No |
 
 **WARNING:** The commit-msg hook will reject commits missing required headers.
 

package/dist/tools/persona/as.tool.js

@@ -500,8 +500,8 @@ export class AsTool {
             if (libraryAuth?.token) {
                 formatted += `    🔑 Connected to Tiny Brain Remote\n`;
             }
-            if (libraryAuth?.hasLlmApiKey) {
-                formatted += `    🔑 LLM API key configured\n`;
+            if (libraryAuth?.hasClaudeCli) {
+                formatted += `    🤖 Claude CLI authenticated\n`;
             }
             // Only show pre-flight and agent-first workflow if agents are installed
             if (hasAgents) {

package/dist/tools/quality/quality.tool.d.ts

@@ -19,5 +19,10 @@ export declare class QualityTool {
     private static handleCompare;
     private static handlePlan;
     private static handlePlanDetails;
+    private static handleDetectAnalyzers;
+    private static handleRunAnalyzers;
+    private static handleAssembleRun;
+    private static handleImplementPlan;
+    private static handleMergeResults;
 }
 //# sourceMappingURL=quality.tool.d.ts.map

package/dist/tools/quality/quality.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"quality.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/quality/quality.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,oCAAoC,CAAC;AA4CrE;;GAEG;AACH,qBAAa,WAAW;IACtB,MAAM,CAAC,iBAAiB,IAAI,OAAO;WA2ItB,OAAO,CAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC;mBAsCD,UAAU;mBAqCV,aAAa;mBA2Bb,aAAa;mBA2Eb,aAAa;mBAsEb,UAAU;mBA0CV,iBAAiB;CA+DvC"}
+{"version":3,"file":"quality.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/quality/quality.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,oCAAoC,CAAC;AA0DrE;;GAEG;AACH,qBAAa,WAAW;IACtB,MAAM,CAAC,iBAAiB,IAAI,OAAO;WAiLtB,OAAO,CAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC;mBAgDD,UAAU;mBAqCV,aAAa;mBA2Bb,aAAa;mBA2Eb,aAAa;mBAsEb,UAAU;mBA0CV,iBAAiB;mBAgEjB,qBAAqB;mBA6BrB,kBAAkB;mBAgDlB,iBAAiB;mBAmDjB,mBAAmB;IAiDxC,OAAO,CAAC,MAAM,CAAC,kBAAkB;CAoBlC"}

package/dist/tools/quality/quality.tool.js

@@ -8,12 +8,16 @@ import { z } from 'zod';
 import { promises as fs } from 'fs';
 import path from 'path';
 import { createSuccessResult, createErrorResult } from '../index.js';
-import { QualityService, QualityIssueSchema, SaveQualityRunInputSchema, } from '@magic-ingredients/tiny-brain-core';
+import { QualityService, AnalyzerDetectionService, AnalyzerExecutorService, AssemblyService, mergeResults, QualityIssueSchema, SaveQualityRunInputSchema, generateRunId, runIdToPath, } from '@magic-ingredients/tiny-brain-core';
 /**
  * Zod schema for QualityTool arguments
  */
 const QualityArgsSchema = z.object({
-    operation: z.enum(['save', 'history', 'details', 'compare', 'plan', 'plan-details']),
+    operation: z.enum([
+        'save', 'history', 'details', 'compare', 'plan', 'plan-details',
+        'detect-analysers', 'run-analysers', 'merge-results', 'assemble-run',
+        'implement-plan',
+    ]),
     // For 'save' operation
     score: z.number().min(0).max(100).optional(),
     grade: z.enum(['A', 'B', 'C', 'D', 'F']).optional(),
@@ -38,6 +42,9 @@ const QualityArgsSchema = z.object({
     targetGrade: z.string().optional(),
     // For 'plan-details' operation
     planId: z.string().optional(),
+    // For 'merge-results' operation
+    analyzerIssues: z.array(QualityIssueSchema).optional(),
+    llmIssues: z.array(QualityIssueSchema).optional(),
 });
 /**
  * MCP Tool for quality analysis persistence
@@ -57,6 +64,11 @@ Persists and retrieves quality analysis results. Analysis is performed by agents
   • compare: Compare two runs to see new, resolved, and persistent issues
   • plan: Generate a Quality Improvement Plan from a saved run
   • plan-details: Retrieve a saved Quality Improvement Plan by ID
+  • detect-analysers: Scan repo for configured static analyzers
+  • run-analysers: Execute detected analyzers and return normalized issues
+  • merge-results: Merge analyzer + LLM issues with deduplication
+  • assemble-run: Read all intermediate files, merge, score, and save final report
+  • implement-plan: Generate fix documents from a saved Quality Improvement Plan
 
 💡 WORKFLOW:
   1. Quality-coordinator agent performs analysis
@@ -69,7 +81,11 @@ Persists and retrieves quality analysis results. Analysis is performed by agents
                 properties: {
                     operation: {
                         type: 'string',
-                        enum: ['save', 'history', 'details', 'compare', 'plan', 'plan-details'],
+                        enum: [
+                            'save', 'history', 'details', 'compare', 'plan', 'plan-details',
+                            'detect-analysers', 'run-analysers', 'merge-results', 'assemble-run',
+                            'implement-plan',
+                        ],
                         description: 'The quality operation to perform',
                     },
                     // For 'save' operation
@@ -151,7 +167,7 @@ Persists and retrieves quality analysis results. Analysis is performed by agents
                     // For 'details' operation
                     runId: {
                         type: 'string',
-                        description: 'Run ID to get details for (required for details)',
+                        description: 'Run ID (required for details, assemble-run; optional for run-analysers to reuse Phase 1 directory)',
                     },
                     // For 'compare' operation
                     baseRunId: {
@@ -176,6 +192,35 @@ Persists and retrieves quality analysis results. Analysis is performed by agents
                         type: 'string',
                         description: 'Plan ID to retrieve details for (required for plan-details)',
                     },
+                    // For 'merge-results' operation
+                    analyzerIssues: {
+                        type: 'array',
+                        description: 'Array of analyzer issues (required for merge-results)',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                category: { type: 'string' },
+                                severity: { type: 'string' },
+                                file: { type: 'string' },
+                                message: { type: 'string' },
+                            },
+                            required: ['category', 'severity', 'file', 'message'],
+                        },
+                    },
+                    llmIssues: {
+                        type: 'array',
+                        description: 'Array of LLM investigation issues (required for merge-results)',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                category: { type: 'string' },
+                                severity: { type: 'string' },
+                                file: { type: 'string' },
+                                message: { type: 'string' },
+                            },
+                            required: ['category', 'severity', 'file', 'message'],
+                        },
+                    },
                 },
                 required: ['operation'],
             },
@@ -202,6 +247,16 @@ Persists and retrieves quality analysis results. Analysis is performed by agents
                     return await QualityTool.handlePlan(validatedArgs, service);
                 case 'plan-details':
                     return await QualityTool.handlePlanDetails(validatedArgs, context.repositoryRoot);
+                case 'detect-analysers':
+                    return await QualityTool.handleDetectAnalyzers(context.repositoryRoot);
+                case 'run-analysers':
+                    return await QualityTool.handleRunAnalyzers(validatedArgs, context.repositoryRoot);
+                case 'merge-results':
+                    return QualityTool.handleMergeResults(validatedArgs);
+                case 'assemble-run':
+                    return await QualityTool.handleAssembleRun(validatedArgs, context.repositoryRoot);
+                case 'implement-plan':
+                    return await QualityTool.handleImplementPlan(validatedArgs, service);
                 default:
                     return createErrorResult(`Unknown operation: ${validatedArgs.operation}`);
             }
@@ -458,4 +513,150 @@ Persists and retrieves quality analysis results. Analysis is performed by agents
             return createErrorResult(`Improvement plan not found: ${args.planId}`);
         }
     }
+    static async handleDetectAnalyzers(repositoryRoot) {
+        const service = new AnalyzerDetectionService(repositoryRoot);
+        const analyzers = await service.detectAnalyzers();
+        if (analyzers.length === 0) {
+            return createSuccessResult('No static analyzers detected in this repository.\n\nSupported analyzers: ESLint, TypeScript, npm audit, RuboCop, ruff.');
+        }
+        const lines = [
+            `🔍 Detected ${analyzers.length} analyzer(s):`,
+            '',
+        ];
+        for (const analyzer of analyzers) {
+            lines.push(`- **${analyzer.name}** (${analyzer.analyzerId})`);
+            lines.push(`  Configs: ${analyzer.configPaths.join(', ')}`);
+            lines.push(`  Categories: ${analyzer.categories.join(', ')}`);
+        }
+        lines.push('');
+        lines.push(JSON.stringify(analyzers, null, 2));
+        return createSuccessResult(lines.join('\n'));
+    }
+    static async handleRunAnalyzers(args, repositoryRoot) {
+        const runId = args.runId ?? generateRunId();
+        const runDir = path.join(repositoryRoot, 'docs', 'quality', 'runs', runIdToPath(runId));
+        const outputPath = path.join(runDir, 'analysis.json');
+        const outputDir = path.join(runDir, 'analysers');
+        const detectionService = new AnalyzerDetectionService(repositoryRoot);
+        const analyzers = await detectionService.detectAnalyzers();
+        const emptyResults = {
+            issues: [],
+            executions: [],
+            totalDurationMs: 0,
+            summary: { total: 0, succeeded: 0, failed: 0, timedOut: 0, skipped: 0 },
+        };
+        if (analyzers.length === 0) {
+            await fs.mkdir(runDir, { recursive: true });
+            await fs.writeFile(outputPath, JSON.stringify(emptyResults, null, 2), 'utf-8');
+            return createSuccessResult(`🔧 No analyzers detected. Empty results written to file.\n  Run ID: ${runId}\n  Output: ${outputPath}`);
+        }
+        const executorService = new AnalyzerExecutorService(repositoryRoot);
+        const results = await executorService.executeAnalyzers(analyzers, outputDir);
+        // Write merged/normalized result to the auto-generated run directory
+        await fs.mkdir(runDir, { recursive: true });
+        await fs.writeFile(outputPath, JSON.stringify(results, null, 2), 'utf-8');
+        const lines = [
+            `🔧 Executed ${results.summary.total} analyzer(s):`,
+            `  Succeeded: ${results.summary.succeeded}`,
+            `  Failed: ${results.summary.failed}`,
+            `  Total issues: ${results.issues.length}`,
+            `  Duration: ${results.totalDurationMs}ms`,
+            `  Run ID: ${runId}`,
+            `  Output: ${outputPath}`,
+            `  Raw files: ${outputDir}/`,
+        ];
+        return createSuccessResult(lines.join('\n'));
+    }
+    static async handleAssembleRun(args, repositoryRoot) {
+        if (!args.runId) {
+            return createErrorResult('runId is required for assemble-run operation (YYYY-MM-DD date prefix)');
+        }
+        const assemblyService = new AssemblyService(repositoryRoot);
+        const result = await assemblyService.assembleRun(args.runId, args.baseRunId);
+        const lines = [
+            '✅ Quality run assembled successfully!',
+            '',
+            `📊 Run ID: ${result.runId}`,
+            `📈 Score: ${result.score}/100 (Grade: ${result.grade})`,
+            `🔍 Issues: ${result.issueCount}`,
+            `📁 File: ${result.filePath}`,
+        ];
+        if (result.planId) {
+            lines.push(`📋 Plan: ${result.planId}`);
+            lines.push(`📁 Plan File: ${result.planFilePath}`);
+        }
+        if (result.incremental) {
+            lines.push('');
+            lines.push('### Incremental Analysis');
+            lines.push(`  Base run: ${result.baseRunId}`);
+            lines.push(`  Files analyzed: ${result.filesAnalyzed}`);
+            lines.push(`  Files carried forward: ${result.filesCarriedForward}`);
+        }
+        lines.push('');
+        lines.push('### Source Breakdown');
+        lines.push(`  Analyzer: ${result.sourceBreakdown.analyzer}`);
+        lines.push(`  Specialist: ${result.sourceBreakdown.llm}`);
+        lines.push(`  Total: ${result.sourceBreakdown.total}`);
+        const categoryEntries = Object.entries(result.categoryBreakdown);
+        if (categoryEntries.length > 0) {
+            lines.push('');
+            lines.push('### Category Breakdown');
+            for (const [category, count] of categoryEntries) {
+                lines.push(`  ${category}: ${count}`);
+            }
+        }
+        return createSuccessResult(lines.join('\n'));
+    }
+    static async handleImplementPlan(args, service) {
+        if (!args.planId) {
+            return createErrorResult('planId is required for implement-plan operation');
+        }
+        const plan = await service.loadImprovementPlan(args.planId);
+        if (!plan) {
+            return createErrorResult(`Improvement plan not found: ${args.planId}`);
+        }
+        const run = await service.getRunDetails(plan.sourceRunId);
+        if (!run) {
+            return createErrorResult(`Source quality run not found: ${plan.sourceRunId}`);
+        }
+        const fixIds = await service.generateFixesFromPlan(plan, run.issues);
+        if (fixIds.length === 0) {
+            return createSuccessResult('No initiatives found in plan. No fix documents created.');
+        }
+        const lines = [
+            `Created ${fixIds.length} fix document(s) from Quality Improvement Plan ${args.planId}`,
+            '',
+            '## Fixes Created',
+            '',
+            '| Fix ID | File |',
+            '|--------|------|',
+        ];
+        for (const fixId of fixIds) {
+            lines.push(`| ${fixId} | .tiny-brain/fixes/${fixId}.md |`);
+        }
+        lines.push('');
+        lines.push('## Next Steps');
+        lines.push('');
+        for (const fixId of fixIds) {
+            lines.push(`1. Run \`npx tiny-brain sync-file .tiny-brain/fixes/${fixId}.md\``);
+        }
+        lines.push('2. Start working on fixes using the /fix workflow');
+        lines.push('3. Track progress in the dashboard');
+        return createSuccessResult(lines.join('\n'));
+    }
+    static handleMergeResults(args) {
+        const analyzerIssues = args.analyzerIssues ?? [];
+        const llmIssues = args.llmIssues ?? [];
+        const result = mergeResults(analyzerIssues, llmIssues);
+        const lines = [
+            `🔀 Merged results:`,
+            `  Analyzer issues: ${result.sourceBreakdown.analyzer}`,
+            `  LLM issues: ${result.sourceBreakdown.llm}`,
+            `  Total (deduplicated): ${result.sourceBreakdown.total}`,
+            `  Duplicates removed: ${result.duplicatesRemoved}`,
+            '',
+            JSON.stringify(result, null, 2),
+        ];
+        return createSuccessResult(lines.join('\n'));
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magic-ingredients/tiny-brain-local",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "MCP server for Tiny Brain AI assistant",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,7 +31,7 @@
     "dxt:init": "cd dxt && dxt init"
   },
   "dependencies": {
-    "@magic-ingredients/tiny-brain-core": "^0.19.0",
+    "@magic-ingredients/tiny-brain-core": "^0.20.0",
     "@magic-ingredients/tiny-brain-dashboard": "file:../tiny-brain-dashboard",
     "@modelcontextprotocol/sdk": "^1.0.6",
     "chalk": "^5.3.0",