@magic-ingredients/tiny-brain-local 0.19.1 → 0.20.1

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;YAgGd,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
             };
         }
     }
@@ -558,6 +549,7 @@ export class MCPServer {
             activePersona,
             authToken: this.authToken,
             config: this.config,
+            dashboardLauncher: this.dashboardLauncher ?? undefined,
             updateActivePersona: (persona) => {
                 const newPersonaId = persona?.id;
                 this.activePersona = newPersonaId;

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/dashboard-launcher.service.d.ts

@@ -15,6 +15,7 @@ export declare class DashboardLauncher {
     private server;
     start(context: RequestContext, options?: DashboardOptions): Promise<DashboardStartResult>;
     stop(): Promise<void>;
+    restart(context: RequestContext, options?: DashboardOptions): Promise<DashboardStartResult>;
     isRunning(): boolean;
 }
 //# sourceMappingURL=dashboard-launcher.service.d.ts.map

package/dist/services/dashboard-launcher.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard-launcher.service.d.ts","sourceRoot":"","sources":["../../src/services/dashboard-launcher.service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAIlE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAa;IAErB,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAc7F,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,SAAS,IAAI,OAAO;CAGrB"}
+{"version":3,"file":"dashboard-launcher.service.d.ts","sourceRoot":"","sources":["../../src/services/dashboard-launcher.service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAIlE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAa;IAErB,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAc7F,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,OAAO,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAKrG,SAAS,IAAI,OAAO;CAGrB"}

package/dist/services/dashboard-launcher.service.js

@@ -23,6 +23,10 @@ export class DashboardLauncher {
             this.server = null;
         }
     }
+    async restart(context, options = {}) {
+        await this.stop();
+        return this.start(context, options);
+    }
     isRunning() {
         return this.server !== null;
     }

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/dashboard/dashboard.tool.d.ts

@@ -0,0 +1,14 @@
+import { type ToolArguments, type ToolResult } from '../index.js';
+import type { RequestContext } from '../../types/request-context.js';
+import type { Tool as MCPTool } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Dashboard Tool - Restart the dashboard server
+ *
+ * Developer maintenance tool for force-reloading the dashboard,
+ * e.g. after rebuilding packages.
+ */
+export declare class DashboardTool {
+    static getToolDefinition(): MCPTool;
+    static execute(_args: ToolArguments, context: RequestContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=dashboard.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/dashboard/dashboard.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0C,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC1G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAErE,OAAO,KAAK,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAE1E;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,MAAM,CAAC,iBAAiB,IAAI,OAAO;WAatB,OAAO,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;CAiBzF"}

package/dist/tools/dashboard/dashboard.tool.js

@@ -0,0 +1,34 @@
+import { createErrorResult, createSuccessResult } from '../index.js';
+/**
+ * Dashboard Tool - Restart the dashboard server
+ *
+ * Developer maintenance tool for force-reloading the dashboard,
+ * e.g. after rebuilding packages.
+ */
+export class DashboardTool {
+    static getToolDefinition() {
+        return {
+            name: 'dev_restart_dashboard',
+            description: 'Restart the dashboard server. Developer maintenance tool — only needed to force a reload of the dashboard (e.g. after rebuilding packages).',
+            inputSchema: {
+                type: 'object',
+                properties: {},
+                required: [],
+            },
+        };
+    }
+    static async execute(_args, context) {
+        const localContext = context;
+        const launcher = localContext.dashboardLauncher;
+        if (!launcher) {
+            return createErrorResult('Dashboard launcher is not available. The dashboard may not have been started.');
+        }
+        try {
+            const result = await launcher.restart(context, {});
+            return createSuccessResult(`Dashboard restarted successfully at ${result.url}`);
+        }
+        catch (error) {
+            return createErrorResult(`Failed to restart dashboard: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+}

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

@@ -22,6 +22,7 @@ export declare class QualityTool {
     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;AAyDrE;;GAEG;AACH,qBAAa,WAAW;IACtB,MAAM,CAAC,iBAAiB,IAAI,OAAO;WA+KtB,OAAO,CAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC;mBA8CD,UAAU;mBAqCV,aAAa;mBA2Bb,aAAa;mBA2Eb,aAAa;mBAsEb,UAAU;mBA0CV,iBAAiB;mBAgEjB,qBAAqB;mBA6BrB,kBAAkB;mBA+ClB,iBAAiB;IA8CtC,OAAO,CAAC,MAAM,CAAC,kBAAkB;CAoBlC"}
+{"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

@@ -15,7 +15,8 @@ import { QualityService, AnalyzerDetectionService, AnalyzerExecutorService, Asse
 const QualityArgsSchema = z.object({
     operation: z.enum([
         'save', 'history', 'details', 'compare', 'plan', 'plan-details',
-        'detect-analyzers', 'run-analyzers', 'merge-results', 'assemble-run',
+        'detect-analysers', 'run-analysers', 'merge-results', 'assemble-run',
+        'implement-plan',
     ]),
     // For 'save' operation
     score: z.number().min(0).max(100).optional(),
@@ -63,10 +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-analyzers: Scan repo for configured static analyzers
-  • run-analyzers: Execute detected analyzers and return normalized issues
+  • 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
@@ -81,7 +83,8 @@ Persists and retrieves quality analysis results. Analysis is performed by agents
                         type: 'string',
                         enum: [
                             'save', 'history', 'details', 'compare', 'plan', 'plan-details',
-                            'detect-analyzers', 'run-analyzers', 'merge-results', 'assemble-run',
+                            'detect-analysers', 'run-analysers', 'merge-results', 'assemble-run',
+                            'implement-plan',
                         ],
                         description: 'The quality operation to perform',
                     },
@@ -164,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: {
@@ -244,14 +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-analyzers':
+                case 'detect-analysers':
                     return await QualityTool.handleDetectAnalyzers(context.repositoryRoot);
-                case 'run-analyzers':
-                    return await QualityTool.handleRunAnalyzers(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}`);
             }
@@ -527,8 +532,8 @@ Persists and retrieves quality analysis results. Analysis is performed by agents
         lines.push(JSON.stringify(analyzers, null, 2));
         return createSuccessResult(lines.join('\n'));
     }
-    static async handleRunAnalyzers(repositoryRoot) {
-        const runId = generateRunId();
+    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');
@@ -576,6 +581,10 @@ Persists and retrieves quality analysis results. Analysis is performed by agents
             `🔍 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');
@@ -598,6 +607,43 @@ Persists and retrieves quality analysis results. Analysis is performed by agents
         }
         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 ?? [];

package/dist/tools/tool-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/tools/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,KAAK,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,OAAO,EAAE;IAoC5B;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;CAmB9D;AAGD,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,8BAAqC,CAAC;AAChF,eAAO,MAAM,eAAe,gBAAyD,CAAC"}
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/tools/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,OAAO,KAAK,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,OAAO,EAAE;IAuC5B;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;CAoB9D;AAGD,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,8BAAqC,CAAC;AAChF,eAAO,MAAM,eAAe,gBAAyD,CAAC"}

package/dist/tools/tool-registry.js

@@ -15,6 +15,7 @@ import { StrategyTool } from './strategy/strategy.tool.js';
 import { AnalyseTool } from './analyse.tool.js';
 import { QualityTool } from './quality/quality.tool.js';
 import { ConfigTool } from './config/config.tool.js';
+import { DashboardTool } from './dashboard/dashboard.tool.js';
 export class ToolRegistry {
     /**
      * Get all available tool definitions from all tools
@@ -36,6 +37,8 @@ export class ToolRegistry {
             QualityTool.getToolDefinition(),
             // Config tool - manages preferences with reactive agent sync
             ConfigTool.getToolDefinition(),
+            // Dashboard tool - restart dashboard server (dev maintenance)
+            DashboardTool.getToolDefinition(),
             // Response tools (disabled for later release)
             // AnalyseRequestTool.getToolDefinition(),
             // ValidateResponseTool.getToolDefinition(),
@@ -63,6 +66,7 @@ export class ToolRegistry {
             update: UpdateTool,
             quality: QualityTool,
             config: ConfigTool,
+            dev_restart_dashboard: DashboardTool,
         };
         return toolMap[name];
     }

package/dist/types/local-context.d.ts

@@ -5,6 +5,7 @@
  */
 import type { RequestContext } from '@magic-ingredients/tiny-brain-core';
 import type { AuthToken } from '../services/remote/auth-token-service.js';
+import type { DashboardLauncher } from '../services/dashboard-launcher.service.js';
 export interface LocalRequestContext extends RequestContext {
     authToken?: AuthToken;
     config?: {
@@ -13,5 +14,6 @@ export interface LocalRequestContext extends RequestContext {
             clientSecret?: string;
         };
     };
+    dashboardLauncher?: DashboardLauncher;
 }
 //# sourceMappingURL=local-context.d.ts.map

package/dist/types/local-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-context.d.ts","sourceRoot":"","sources":["../../src/types/local-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAE1E,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IAEzD,SAAS,CAAC,EAAE,SAAS,CAAC;IAGtB,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE;YACR,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,YAAY,CAAC,EAAE,MAAM,CAAC;SACvB,CAAC;KACH,CAAC;CACH"}
+{"version":3,"file":"local-context.d.ts","sourceRoot":"","sources":["../../src/types/local-context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0CAA0C,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAC;AAEnF,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IAEzD,SAAS,CAAC,EAAE,SAAS,CAAC;IAGtB,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE;YACR,QAAQ,CAAC,EAAE,MAAM,CAAC;YAClB,YAAY,CAAC,EAAE,MAAM,CAAC;SACvB,CAAC;KACH,CAAC;IAGF,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magic-ingredients/tiny-brain-local",
-  "version": "0.19.1",
+  "version": "0.20.1",
   "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.1",
+    "@magic-ingredients/tiny-brain-core": "^0.20.1",
     "@magic-ingredients/tiny-brain-dashboard": "file:../tiny-brain-dashboard",
     "@modelcontextprotocol/sdk": "^1.0.6",
     "chalk": "^5.3.0",