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

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,EAInB,MAAM,oCAAoC,CAAC;AAW5C,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,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"}

package/dist/services/analyse-service.js

@@ -4,10 +4,8 @@
  * Handles repository tech stack analysis.
  * Focused solely on analysis - no context file management.
  */
-import { analyseRepository, formatTechStackChanges, detectTechStackChanges, ConfigService, RepoConfigService } from '@magic-ingredients/tiny-brain-core';
+import { analyseRepository, formatTechStackChanges, detectTechStackChanges, ConfigService, RepoConfigService, LibraryClient, TechContextService, } from '@magic-ingredients/tiny-brain-core';
 import { RepoService } from './repo-service.js';
-import { LibraryClient } from '@magic-ingredients/tiny-brain-core';
-import { TechContextService } from './tech-context-service.js';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import { existsSync } from 'fs';

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

@@ -58,6 +58,11 @@ export declare class RepoService {
      * - Operational Tracking Directory (when SDD enabled)
      */
     writeWorkflowSections(options?: WriteWorkflowSectionsOptions): Promise<void>;
+    /**
+     * Format the Repository Context section
+     * When agentic coding is enabled, includes a mandatory agent delegation section
+     */
+    private formatRepoContextSection;
     /**
      * Format the Commit Message Format section
      */

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;IAwFtF;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAkGlC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoChC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAwErC;;OAEG;IACH,OAAO,CAAC,gCAAgC;CAqCzC"}
+{"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"}

package/dist/services/repo-service.js

@@ -147,12 +147,15 @@ export class RepoService {
         // Check config flags
         const enableSDD = await this.configService.isSDDEnabled();
         const enableTDD = await this.configService.isTDDEnabled();
+        const enableAgentic = await this.configService.isAgenticCodingEnabled();
         // If nothing is enabled, don't write anything
         if (!enableSDD && !enableTDD) {
             return;
         }
         // Build the workflow sections content
         let workflowContent = '';
+        // Repository Context (always when workflow sections are enabled)
+        workflowContent += this.formatRepoContextSection(enableAgentic);
         // Commit Message Format (when SDD enabled)
         if (enableSDD) {
             workflowContent += this.formatCommitMessageSection();
@@ -169,8 +172,9 @@ export class RepoService {
         if (enableSDD) {
             workflowContent += this.formatOperationalTrackingSection();
         }
-        // Build the complete tiny-brain block
-        const repoBlock = `${RepoService.REPO_BLOCK_START}\n\n${workflowContent}${RepoService.REPO_BLOCK_END}\n`;
+        // Build the complete tiny-brain block with version frontmatter
+        const version = this.getAnalysisVersion();
+        const repoBlock = `${RepoService.REPO_BLOCK_START}\n---\nversion: ${version}\n---\n\n${workflowContent}${RepoService.REPO_BLOCK_END}\n`;
         // Get full path
         const repoRoot = getRepoRoot();
         const fullPath = path.join(repoRoot, contextPath);
@@ -218,6 +222,32 @@ export class RepoService {
         await fs.writeFile(fullPath, existingContent, 'utf-8');
         this.context.logger.info(`Updated workflow sections in ${contextPath}`);
     }
+    /**
+     * Format the Repository Context section
+     * When agentic coding is enabled, includes a mandatory agent delegation section
+     */
+    formatRepoContextSection(enableAgenticCoding) {
+        let content = `## Repository Context
+
+Before starting work, read \`.tiny-brain/analysis.json\` for the detected tech stack, test patterns, and documentation locations.
+
+`;
+        if (enableAgenticCoding) {
+            content += `## Agent Delegation (MANDATORY)
+
+IMPORTANT: You MUST delegate implementation work to specialized agents using the Task tool. Do NOT write production code or tests directly.
+
+When the user asks you to implement a feature, fix a bug, or refactor code:
+1. Use the Task tool with \`subagent_type="tiny-brain:developer"\`
+2. Provide the full task context in the prompt
+3. Let the agent handle the TDD workflow (red/green/refactor)
+
+Only skip delegation for trivial tasks (single-line fixes, config changes).
+
+`;
+        }
+        return content;
+    }
     /**
      * Format the Commit Message Format section
      */
@@ -229,7 +259,7 @@ export class RepoService {
 **BEFORE EVERY COMMIT**, check if you're working on tracked work:
 
 1. **Active PRDs?** Check \`.tiny-brain/progress/\` for \`in_progress\` status
-2. **Open Fixes?** Check \`.tiny-brain/fixes/progress.json\` for \`investigating\` or \`in_progress\` status
+2. **Open Fixes?** Check \`.tiny-brain/fixes/progress.json\` for \`documented\` or \`in_progress\` status
 
 **If YES, you MUST include tracking headers or the commit will be REJECTED.**
 
@@ -265,42 +295,53 @@ Description of changes...
 
 **WARNING:** The commit-msg hook will reject commits missing required headers.
 
-### CRITICAL: Update Markdown After Successful Commits
-
-**IMMEDIATELY after your commit is accepted**, you MUST update the source markdown file. This is NOT optional.
+### Updating Markdown After Commits
 
 **For PRD tasks:**
 1. Open the feature file: \`docs/prd/{prd-id}/features/{feature-id}.md\`
-2. Find the task checkbox and update it:
+2. Update the task with status and commitSha:
+   \`\`\`markdown
+   ### 1. Task description
+   status: completed
+   commitSha: abc1234
    \`\`\`
-   Before: - [ ] Task description
-   After:  - [x] Task description ({short-sha})
-   \`\`\`
-3. Add implementation notes below the task if helpful
-4. If ALL tasks in the feature are complete, mark the feature complete in the PRD file
-   - The feature file's frontmatter contains \`prd: {prd-id}\` - use this to find \`docs/prd/{prd-id}/prd.md\`
+3. Run: \`npx tiny-brain sync-file docs/prd/{prd-id}/features/{feature-id}.md\`
+4. If ALL tasks in the feature are complete, update the PRD status
+
+### Fix Status Workflow
 
-**For Fix tasks:**
+Fix documents have three statuses: \`documented\` → \`in_progress\` → \`resolved\`
+
+**When starting work on a fix:**
 1. Open the fix file: \`.tiny-brain/fixes/{fix-id}.md\`
-2. **Update EACH task** with its resolution:
-   - Set the task's \`commitSha\` field in \`.tiny-brain/fixes/progress.json\`
-   - Set the task's \`status\` to \`"completed"\`
-   - If one commit addresses multiple tasks, use the same SHA for all
-   - Mark tasks as \`(superseded)\` if no longer needed
-   - **Show the user a task status table** after updating, e.g.:
-     | Task | Description | Status | commitSha |
-     |------|-------------|--------|-----------|
-     | 1 | Write failing test | completed | abc1234 |
-     | 2 | Implement fix | completed | abc1234 |
-     | 3 | Skipped task | superseded | - |
-3. **ONLY set \`status: resolved\`** when ALL tasks are accounted for:
-   - 100% of tasks must have either a commit SHA or be marked superseded
-   - A fix with 5 tasks could be: 3 completed + 2 superseded = resolved
+2. Update frontmatter: \`status: in_progress\`
+3. Run: \`npx tiny-brain sync-file .tiny-brain/fixes/{fix-id}.md\`
+
+**After each commit:**
+1. Update the completed task(s) in the markdown:
+   \`\`\`markdown
+   ### 1. Task description
+   status: completed
+   commitSha: abc1234
+   \`\`\`
+2. If one commit addresses multiple tasks, use the same commitSha for all of them
+3. If a task is no longer needed (work done elsewhere or obsolete), mark it superseded:
+   \`\`\`markdown
+   ### 3. Obsolete task
+   status: superseded
+   commitSha: null
+   \`\`\`
+4. Run: \`npx tiny-brain sync-file .tiny-brain/fixes/{fix-id}.md\`
+
+**When all tasks are complete:**
+1. **ONLY set \`status: resolved\`** when ALL tasks are accounted for:
+   - 100% of tasks must have either \`status: completed\` (with commitSha) or \`status: superseded\`
+   - Example: A fix with 5 tasks could be: 3 completed + 2 superseded = resolved
    - A fix with incomplete tasks stays \`in_progress\`
-4. When fully resolved, update YAML frontmatter:
+2. Update YAML frontmatter:
    - Set \`status: resolved\`
    - Set \`resolved: YYYY-MM-DDTHH:mm:ss.sssZ\` (ISO timestamp)
-   - Add \`resolution\` object with \`rootCause\`, \`fix\` (array), and \`filesModified\` (array):
+   - Add \`resolution\` object:
      \`\`\`yaml
      resolution:
        rootCause: Brief description of what caused the issue
@@ -311,10 +352,9 @@ Description of changes...
          - path/to/file1.ts
          - path/to/file2.ts
      \`\`\`
+3. Run: \`npx tiny-brain sync-file .tiny-brain/fixes/{fix-id}.md\`
 
-**The sync-progress hook will automatically sync your changes to progress.json, preserving task commit history.**
-
-**Failure to update markdown files is a workflow violation.**
+**Note:** The markdown file is the source of truth. The \`sync-file\` command updates \`progress.json\` from the markdown.
 
 `;
     }
@@ -440,6 +480,10 @@ The \`.tiny-brain/\` directory stores operational tracking data separate from do
 
 \`\`\`
 .tiny-brain/
+├── analysis.json       # Detected tech stack and repo analysis
+├── tech/               # Technology-specific context files
+│   ├── config.json     # Tech context mode configuration
+│   └── {name}.md       # One file per detected technology
 ├── progress/           # PRD progress tracking
 │   └── {prd-id}.json   # One file per PRD
 └── fixes/              # Fix progress tracking

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

@@ -1 +1 @@
-{"version":3,"file":"config.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/config/config.tool.ts"],"names":[],"mappings":"AACA,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;AAWrE,qBAAa,UAAU;IACrB,MAAM,CAAC,iBAAiB,IAAI,OAAO;WA4DtB,OAAO,CAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC;mBA6BD,UAAU;mBAwCV,SAAS;mBAoCT,iBAAiB;mBAgEjB,SAAS;mBAuDT,WAAW;CAqBjC"}
+{"version":3,"file":"config.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/config/config.tool.ts"],"names":[],"mappings":"AACA,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;AAUrE,qBAAa,UAAU;IACrB,MAAM,CAAC,iBAAiB,IAAI,OAAO;WA4DtB,OAAO,CAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC;mBA6BD,UAAU;mBAwCV,SAAS;mBAoCT,iBAAiB;mBAgEjB,SAAS;mBAuDT,WAAW;CAqBjC"}

package/dist/tools/config/config.tool.js

@@ -1,7 +1,6 @@
 import { z } from 'zod';
 import { createSuccessResult, createErrorResult } from '../index.js';
-import { ConfigService } from '@magic-ingredients/tiny-brain-core';
-import { TechContextService } from '../../services/tech-context-service.js';
+import { ConfigService, TechContextService } from '@magic-ingredients/tiny-brain-core';
 const ConfigArgsSchema = z.object({
     operation: z.enum(['list', 'get', 'show-sources', 'set', 'reset']),
     key: z.string().optional(),

package/dist/tools/persona/as.tool.d.ts

@@ -37,6 +37,10 @@ export declare class AsTool {
      * Check if agents are installed by checking the platform-specific agents directory
      */
     private static checkHasAgents;
+    /**
+     * Resolve feature flags from ConfigService
+     */
+    private static resolveFeatureFlags;
     /**
      * Build persona response data structure
      */

package/dist/tools/persona/as.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"as.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/persona/as.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAWrE,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAqCrE;;;;;;;;;GASG;AACH,qBAAa,MAAM;IACjB,MAAM,CAAC,iBAAiB,IAAI,OAAO;IAqDnC;;OAEG;WACU,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IA4BvF;;OAEG;mBACkB,wBAAwB;IAmE7C;;OAEG;mBACkB,mBAAmB;IA2ExC;;OAEG;mBACkB,oBAAoB;IAmGzC;;OAEG;mBACkB,eAAe;IAsBpC;;OAEG;mBACkB,cAAc;IAWnC;;OAEG;mBACkB,aAAa;IA6DlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IA8H7B;;OAEG;mBACkB,mBAAmB;mBAyDnB,qBAAqB;CAsC3C"}
+{"version":3,"file":"as.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/persona/as.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAYrE,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAyCrE;;;;;;;;;GASG;AACH,qBAAa,MAAM;IACjB,MAAM,CAAC,iBAAiB,IAAI,OAAO;IAqDnC;;OAEG;WACU,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;IA4BvF;;OAEG;mBACkB,wBAAwB;IAsE7C;;OAEG;mBACkB,mBAAmB;IA8ExC;;OAEG;mBACkB,oBAAoB;IAsGzC;;OAEG;mBACkB,eAAe;IAsBpC;;OAEG;mBACkB,cAAc;IAWnC;;OAEG;mBACkB,mBAAmB;IAexC;;OAEG;mBACkB,aAAa;IA6DlC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IA8H7B;;OAEG;mBACkB,mBAAmB;mBA4DnB,qBAAqB;CAsC3C"}

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

@@ -1,12 +1,9 @@
 import { z } from 'zod';
 import { createErrorResult } from '../index.js';
-import { createDefaultProfile, PlanningService, RulesService, LibraryClient, parsePersonaMarkdown } from '@magic-ingredients/tiny-brain-core';
+import { createDefaultProfile, PlanningService, RulesService, LibraryClient, ConfigService, parsePersonaMarkdown } from '@magic-ingredients/tiny-brain-core';
 import { PersonaService } from '../../services/persona-service.js';
 import { RepoService } from '../../services/repo-service.js';
 import { AgentService } from '../../services/agent-service.js';
-import { existsSync } from 'fs';
-import { join } from 'path';
-import { getRepoRoot } from '../../utils/repo-utils.js';
 const AsArgsSchema = z.object({
     personaName: z.string().optional(),
     confirmCreate: z.boolean().optional(),
@@ -147,11 +144,14 @@ export class AsTool {
         const formatter = agentService.getDefaultFormatter();
         const contextFilePath = formatter.getRepoContextFilePath();
         const response = await AsTool.buildResponse(context, parsedPersona, contextFilePath);
-        const hasAgents = await AsTool.checkHasAgents(context, contextFilePath);
+        const [hasAgents, featureFlags] = await Promise.all([
+            AsTool.checkHasAgents(context, contextFilePath),
+            AsTool.resolveFeatureFlags(context),
+        ]);
         return {
             content: [{
                     type: 'text',
-                    text: AsTool.formatResponse(response, contextFilePath, hasAgents),
+                    text: AsTool.formatResponse(response, contextFilePath, hasAgents, featureFlags, context.libraryAuth),
                 }],
             isError: false,
         };
@@ -201,11 +201,14 @@ export class AsTool {
             // Activate persona and return response with updated context
             const updatedContext = await AsTool.activatePersona(personaName, profile, context);
             const response = await AsTool.buildResponse(updatedContext, parsedPersona, contextFilePath);
-            const hasAgents = await AsTool.checkHasAgents(updatedContext, contextFilePath);
+            const [hasAgents, featureFlags] = await Promise.all([
+                AsTool.checkHasAgents(updatedContext, contextFilePath),
+                AsTool.resolveFeatureFlags(updatedContext),
+            ]);
             return {
                 content: [{
                         type: 'text',
-                        text: AsTool.formatResponse(response, contextFilePath, hasAgents),
+                        text: AsTool.formatResponse(response, contextFilePath, hasAgents, featureFlags, updatedContext.libraryAuth),
                     }],
                 isError: false,
             };
@@ -280,11 +283,14 @@ export class AsTool {
             const contextFilePath = formatter?.getRepoContextFilePath();
             // Step 8: Build and return response
             const response = await AsTool.buildResponse(updatedContext, parsedPersona, contextFilePath);
-            const hasAgents = await AsTool.checkHasAgents(updatedContext, contextFilePath);
+            const [hasAgents, featureFlags] = await Promise.all([
+                AsTool.checkHasAgents(updatedContext, contextFilePath),
+                AsTool.resolveFeatureFlags(updatedContext),
+            ]);
             return {
                 content: [{
                         type: 'text',
-                        text: AsTool.formatResponse(response, contextFilePath, hasAgents) + needsInitMessage,
+                        text: AsTool.formatResponse(response, contextFilePath, hasAgents, featureFlags, updatedContext.libraryAuth) + needsInitMessage,
                     }],
                 isError: false,
             };
@@ -327,6 +333,24 @@ export class AsTool {
             return false;
         }
     }
+    /**
+     * Resolve feature flags from ConfigService
+     */
+    static async resolveFeatureFlags(context) {
+        try {
+            const configService = new ConfigService(context);
+            const [sddEnabled, tddEnabled, adrEnabled, agenticCodingEnabled] = await Promise.all([
+                configService.isSDDEnabled(),
+                configService.isTDDEnabled(),
+                configService.isADREnabled(),
+                configService.isAgenticCodingEnabled(),
+            ]);
+            return { sddEnabled, tddEnabled, adrEnabled, agenticCodingEnabled };
+        }
+        catch {
+            return { sddEnabled: false, tddEnabled: false, adrEnabled: false, agenticCodingEnabled: false };
+        }
+    }
     /**
      * Build persona response data structure
      */
@@ -385,7 +409,7 @@ export class AsTool {
     /**
      * Format the persona response as human-readable markdown with enforced workflow
      */
-    static formatResponse(response, contextFilePath, hasAgents) {
+    static formatResponse(response, contextFilePath, hasAgents, featureFlags, libraryAuth) {
         let formatted = `# THIS IS YOUR CONTEXT FOR THIS SESSION - YOU MUST USE IT\n\n`;
         formatted += `IMPORTANT: USER RULES and USER DETAILS ALWAYS take precedence over SYSTEM RULES and SYSTEM DETAILS. When there are conflicts, follow the user's preferences.\n\n`;
         formatted += `## PERSONA: ${response.PERSONA.name}\n\n`;
@@ -461,33 +485,32 @@ export class AsTool {
             formatted += `**EXCEPTION**: Only skip agents if you can explicitly justify why none apply\n\n`;
             formatted += `**MANDATORY CONFIRMATION:** When ready to proceed, you MUST respond with exactly this format (copy it exactly, do not modify):\n\n`;
             formatted += `\`\`\`\n`;
+            formatted += `    🧠 tiny brain\n\n`;
             formatted += `    ✅ Received context for persona\n`;
             formatted += `    ✅ Re-read ${contextFilePath}\n`;
-            // Check for PRD and ADR directories and add checklist items (indented by 2 spaces)
-            try {
-                const repoRoot = getRepoRoot();
-                const hasPRD = existsSync(join(repoRoot, 'docs', 'prd'));
-                const hasADR = existsSync(join(repoRoot, 'docs', 'adr'));
-                if (hasPRD) {
-                    formatted += `      ✅ Enabled Spec Driven Design workflow with Test Driven Development\n`;
-                }
-                if (hasADR) {
-                    formatted += `      ✅ Enabled Architecture Decision Records\n`;
-                }
+            if (featureFlags?.sddEnabled) {
+                formatted += `    ✅ Enabled Spec Driven Design workflow with Test Driven Development\n`;
+            }
+            if (featureFlags?.adrEnabled) {
+                formatted += `    ✅ Enabled Architecture Decision Records\n`;
+            }
+            if (featureFlags?.agenticCodingEnabled) {
+                formatted += `    ✅ Enabled agentic coding\n`;
             }
-            catch {
-                // Not in a repo, skip PRD/ADR checklist items
+            if (libraryAuth?.token) {
+                formatted += `    🔑 Connected to Tiny Brain Remote\n`;
+            }
+            if (libraryAuth?.hasLlmApiKey) {
+                formatted += `    🔑 LLM API key configured\n`;
             }
             // Only show pre-flight and agent-first workflow if agents are installed
             if (hasAgents) {
                 formatted += `    ✅ Completed pre-flight checklist\n`;
                 formatted += `    ✅ Ready for agent-first workflow\n`;
             }
-            formatted += `    \n\n`;
-            formatted += `    I've switched to your **${response.PERSONA.name}** persona.\n`;
-            formatted += `    \n`;
-            formatted += `    🧠 Dashboard available at: [http://localhost:8765](http://localhost:8765)\n`;
             formatted += `\`\`\`\n\n`;
+            formatted += `I've switched to your **${response.PERSONA.name}** persona.\n\n`;
+            formatted += `🧠 Dashboard available at: [http://localhost:8765](http://localhost:8765)\n`;
         }
         else {
             // Add persona switch confirmation message when no context file
@@ -524,11 +547,14 @@ export class AsTool {
             context.logger.info(`Renamed persona '${oldName}' to '${newName}'`);
             // Return response showing the renamed persona is now active with updated context
             const response = await AsTool.buildResponse(updatedContext, parsedPersona, contextFilePath);
-            const hasAgents = await AsTool.checkHasAgents(updatedContext, contextFilePath);
+            const [hasAgents, featureFlags] = await Promise.all([
+                AsTool.checkHasAgents(updatedContext, contextFilePath),
+                AsTool.resolveFeatureFlags(updatedContext),
+            ]);
             return {
                 content: [{
                         type: 'text',
-                        text: AsTool.formatResponse(response, contextFilePath, hasAgents),
+                        text: AsTool.formatResponse(response, contextFilePath, hasAgents, featureFlags, updatedContext.libraryAuth),
                     }],
                 isError: false,
             };

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

@@ -16,5 +16,8 @@ export declare class QualityTool {
     private static handleSave;
     private static handleHistory;
     private static handleDetails;
+    private static handleCompare;
+    private static handlePlan;
+    private static handlePlanDetails;
 }
 //# 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;AAGH,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;AAiCrE;;GAEG;AACH,qBAAa,WAAW;IACtB,MAAM,CAAC,iBAAiB,IAAI,OAAO;WA4EtB,OAAO,CAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,UAAU,CAAC;mBAgCD,UAAU;mBAqCV,aAAa;mBA2Bb,aAAa;CA0EnC"}
+{"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"}

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

@@ -5,13 +5,15 @@
  * Analysis is performed by agents; this tool only handles persistence.
  */
 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';
 /**
  * Zod schema for QualityTool arguments
  */
 const QualityArgsSchema = z.object({
-    operation: z.enum(['save', 'history', 'details']),
+    operation: z.enum(['save', 'history', 'details', 'compare', 'plan', 'plan-details']),
     // For 'save' operation
     score: z.number().min(0).max(100).optional(),
     grade: z.enum(['A', 'B', 'C', 'D', 'F']).optional(),
@@ -28,6 +30,14 @@ const QualityArgsSchema = z.object({
     limit: z.number().min(1).optional(),
     // For 'details' operation
     runId: z.string().optional(),
+    // For 'compare' operation
+    baseRunId: z.string().optional(),
+    targetRunId: z.string().optional(),
+    // For 'plan' operation
+    sourceRunId: z.string().optional(),
+    targetGrade: z.string().optional(),
+    // For 'plan-details' operation
+    planId: z.string().optional(),
 });
 /**
  * MCP Tool for quality analysis persistence
@@ -44,18 +54,22 @@ Persists and retrieves quality analysis results. Analysis is performed by agents
   • save: Persist a quality run to docs/quality/runs/
   • history: List previous quality runs with summary data
   • details: Get full details for a specific run by ID
+  • 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
 
 💡 WORKFLOW:
   1. Quality-coordinator agent performs analysis
   2. Agent calls quality save with score, grade, issues, recommendations
   3. Results stored as markdown in docs/quality/runs/YYYY-MM-DD-quality.md
-  4. Use history/details to retrieve past runs`,
+  4. Use history/details to retrieve past runs
+  5. Use plan to generate an improvement roadmap from a run`,
             inputSchema: {
                 type: 'object',
                 properties: {
                     operation: {
                         type: 'string',
-                        enum: ['save', 'history', 'details'],
+                        enum: ['save', 'history', 'details', 'compare', 'plan', 'plan-details'],
                         description: 'The quality operation to perform',
                     },
                     // For 'save' operation
@@ -80,6 +94,42 @@ Persists and retrieves quality analysis results. Analysis is performed by agents
                                 line: { type: 'number' },
                                 message: { type: 'string' },
                                 suggestion: { type: 'string' },
+                                effort: {
+                                    type: 'string',
+                                    enum: ['trivial', 'small', 'medium', 'large', 'epic'],
+                                    description: 'Estimated effort to remediate',
+                                },
+                                impact: {
+                                    type: 'string',
+                                    enum: ['critical', 'high', 'medium', 'low'],
+                                    description: 'Impact level if this issue is not addressed',
+                                },
+                                theme: {
+                                    type: 'string',
+                                    description: 'Thematic grouping tag (e.g., "type-safety", "auth-hardening")',
+                                },
+                                evidence: {
+                                    type: 'string',
+                                    description: 'Code snippet or evidence showing the problem',
+                                },
+                                relatedIssues: {
+                                    type: 'array',
+                                    items: { type: 'number' },
+                                    description: 'Indices of related issues in the same run',
+                                },
+                                references: {
+                                    type: 'array',
+                                    items: { type: 'string' },
+                                    description: 'External references such as CWE or OWASP identifiers',
+                                },
+                                scoreImpact: {
+                                    type: 'number',
+                                    description: 'Points that would be gained if this issue were fixed',
+                                },
+                                effortHours: {
+                                    type: 'number',
+                                    description: 'Estimated hours to remediate',
+                                },
                             },
                             required: ['category', 'severity', 'file', 'message'],
                         },
@@ -103,6 +153,29 @@ Persists and retrieves quality analysis results. Analysis is performed by agents
                         type: 'string',
                         description: 'Run ID to get details for (required for details)',
                     },
+                    // For 'compare' operation
+                    baseRunId: {
+                        type: 'string',
+                        description: 'Base run ID for comparison (required for compare)',
+                    },
+                    targetRunId: {
+                        type: 'string',
+                        description: 'Target run ID for comparison (required for compare)',
+                    },
+                    // For 'plan' operation
+                    sourceRunId: {
+                        type: 'string',
+                        description: 'Source run ID to generate improvement plan from (required for plan)',
+                    },
+                    targetGrade: {
+                        type: 'string',
+                        description: 'Target grade to aim for in the improvement plan (optional for plan)',
+                    },
+                    // For 'plan-details' operation
+                    planId: {
+                        type: 'string',
+                        description: 'Plan ID to retrieve details for (required for plan-details)',
+                    },
                 },
                 required: ['operation'],
             },
@@ -123,6 +196,12 @@ Persists and retrieves quality analysis results. Analysis is performed by agents
                     return await QualityTool.handleHistory(validatedArgs, service);
                 case 'details':
                     return await QualityTool.handleDetails(validatedArgs, service);
+                case 'compare':
+                    return await QualityTool.handleCompare(validatedArgs, service);
+                case 'plan':
+                    return await QualityTool.handlePlan(validatedArgs, service);
+                case 'plan-details':
+                    return await QualityTool.handlePlanDetails(validatedArgs, context.repositoryRoot);
                 default:
                     return createErrorResult(`Unknown operation: ${validatedArgs.operation}`);
             }
@@ -243,4 +322,140 @@ Persists and retrieves quality analysis results. Analysis is performed by agents
         }
         return createSuccessResult(lines.join('\n'));
     }
+    static async handleCompare(args, service) {
+        if (!args.baseRunId) {
+            return createErrorResult('baseRunId is required for compare operation');
+        }
+        if (!args.targetRunId) {
+            return createErrorResult('targetRunId is required for compare operation');
+        }
+        const comparison = await service.compareRuns(args.baseRunId, args.targetRunId);
+        if (!comparison) {
+            return createErrorResult(`One or both runs not found: ${args.baseRunId}, ${args.targetRunId}`);
+        }
+        const deltaSign = comparison.scoreDelta >= 0 ? '+' : '';
+        const lines = [
+            `📊 Run Comparison: ${comparison.baseRunId} → ${comparison.targetRunId}`,
+            '',
+            '## Summary',
+            `**Score Delta:** ${deltaSign}${comparison.scoreDelta}`,
+            `**Grade Change:** ${comparison.gradeChange.from} → ${comparison.gradeChange.to}`,
+            `**New Issues:** ${comparison.newIssues.length}`,
+            `**Resolved Issues:** ${comparison.resolvedIssues.length}`,
+            `**Persistent Issues:** ${comparison.persistentIssues.length}`,
+            '',
+        ];
+        // Category changes
+        const categoryEntries = Object.entries(comparison.categoryChanges);
+        if (categoryEntries.length > 0) {
+            lines.push('## Category Changes');
+            lines.push('');
+            lines.push('| Category | Count Delta | Deduction Delta |');
+            lines.push('|----------|-------------|-----------------|');
+            for (const [category, changes] of categoryEntries) {
+                const countSign = changes.countDelta >= 0 ? '+' : '';
+                const deductionSign = changes.deductionDelta >= 0 ? '+' : '';
+                lines.push(`| ${category} | ${countSign}${changes.countDelta} | ${deductionSign}${changes.deductionDelta.toFixed(1)} |`);
+            }
+            lines.push('');
+        }
+        // New issues
+        if (comparison.newIssues.length > 0) {
+            lines.push('## New Issues');
+            for (const issue of comparison.newIssues) {
+                lines.push(`- **[${issue.severity}]** ${issue.message} (${issue.file})`);
+            }
+            lines.push('');
+        }
+        // Resolved issues
+        if (comparison.resolvedIssues.length > 0) {
+            lines.push('## Resolved Issues');
+            for (const issue of comparison.resolvedIssues) {
+                lines.push(`- **[${issue.severity}]** ${issue.message} (${issue.file})`);
+            }
+            lines.push('');
+        }
+        return createSuccessResult(lines.join('\n'));
+    }
+    static async handlePlan(args, service) {
+        if (!args.sourceRunId) {
+            return createErrorResult('sourceRunId is required for plan operation');
+        }
+        const run = await service.getRunDetails(args.sourceRunId);
+        if (!run) {
+            return createErrorResult(`Quality run not found: ${args.sourceRunId}`);
+        }
+        const plan = QualityService.generateImprovementPlan(run, args.targetGrade);
+        const result = await service.saveImprovementPlan(plan);
+        const totalInitiatives = plan.phases.reduce((sum, phase) => sum + phase.initiatives.length, 0);
+        const response = [
+            '✅ Quality Improvement Plan generated successfully!',
+            '',
+            `📋 Plan ID: ${result.planId}`,
+            `📁 File: ${result.filePath}`,
+            `📊 Current Score: ${plan.currentScore}/100 (Grade ${plan.currentGrade})`,
+            `🎯 Phases: ${plan.phases.length}`,
+            `📦 Initiatives: ${totalInitiatives}`,
+            `⏱️ Total Effort: ${plan.totalEffortHours} hours`,
+            '',
+            '## Executive Summary',
+            '',
+            plan.executiveSummary,
+            '',
+            'Use "quality plan-details planId=<id>" to see full plan details.',
+        ].join('\n');
+        return createSuccessResult(response);
+    }
+    static async handlePlanDetails(args, repositoryRoot) {
+        if (!args.planId) {
+            return createErrorResult('planId is required for plan-details operation');
+        }
+        try {
+            const plansDir = path.join(repositoryRoot, 'docs', 'quality', 'plans');
+            const filePath = path.join(plansDir, `${args.planId}.md`);
+            const content = await fs.readFile(filePath, 'utf-8');
+            // Extract JSON from the Raw Data code block
+            const jsonMatch = content.match(/```json\n([\s\S]*?)\n```/);
+            if (!jsonMatch) {
+                return createErrorResult(`Could not parse plan data from: ${args.planId}`);
+            }
+            const planData = JSON.parse(jsonMatch[1]);
+            const lines = [
+                `📋 Quality Improvement Plan: ${planData.planId}`,
+                '',
+                '## Summary',
+                `**Date:** ${planData.date}`,
+                `**Source Run:** ${planData.sourceRunId}`,
+                `**Current Score:** ${planData.currentScore}/100 (Grade ${planData.currentGrade})`,
+                `**Total Effort:** ${planData.totalEffortHours} hours`,
+                '',
+                '## Executive Summary',
+                '',
+                planData.executiveSummary,
+                '',
+            ];
+            // Phase summaries
+            if (planData.phases && planData.phases.length > 0) {
+                lines.push('## Phases');
+                lines.push('');
+                for (const phase of planData.phases) {
+                    lines.push(`### Phase ${phase.phase}: ${phase.name}`);
+                    lines.push(`**Projected Score:** ${phase.projectedScore}/100 (Grade ${phase.projectedGrade})`);
+                    lines.push(`**Effort:** ${phase.totalEffortHours} hours`);
+                    lines.push(`**Initiatives:** ${phase.initiatives.length}`);
+                    lines.push('');
+                }
+            }
+            // ROI
+            if (planData.roiAnalysis) {
+                lines.push('## ROI Analysis');
+                lines.push(`**Estimated Cost:** ${planData.roiAnalysis.currency} ${planData.roiAnalysis.estimatedCostToFix}`);
+                lines.push('');
+            }
+            return createSuccessResult(lines.join('\n'));
+        }
+        catch {
+            return createErrorResult(`Improvement plan not found: ${args.planId}`);
+        }
+    }
 }

package/package.json

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

package/dist/services/tech-context-service.d.ts

@@ -1,106 +0,0 @@
-/**
- * Tech Context Service
- *
- * Manages reading and writing of tech context files:
- * - .tiny-brain/analysis.json - repo analysis data
- * - .tiny-brain/tech/*.md - per-tech expertise files
- * - .tiny-brain/tech/config.json - agent mode configuration
- * - .claude/agents/tech-*.md - tech agent files (when enableAgentic=true)
- */
-import type { RepoAnalysisFile, TechExpertiseFrontmatter, TechExpertiseFile, TechConfig } from '@magic-ingredients/tiny-brain-core';
-/** Input analysis data from repository analysis */
-export interface AnalysisInput {
-    languages: string[];
-    frameworks: string[];
-    testingTools: string[];
-    buildTools: string[];
-    hasTests: boolean;
-    testFileCount: number;
-    testPatterns: string[];
-    isPolyglot?: boolean;
-    primaryLanguage?: string;
-    documentationPattern?: 'single-readme' | 'folder-readmes' | 'docs-folder' | 'mixed';
-    documentationLocations?: string[];
-}
-export declare class TechContextService {
-    private readonly tinyBrainDir;
-    private readonly techDir;
-    private readonly agentsDir;
-    constructor(repoPath: string);
-    /** Get the .tiny-brain directory path */
-    getTinyBrainDir(): string;
-    /** Get the .tiny-brain/tech directory path */
-    getTechDir(): string;
-    /** Get the .claude/agents directory path */
-    getAgentsDir(): string;
-    /** Ensure required directories exist */
-    ensureDirectories(): Promise<void>;
-    /**
-     * Write analysis data to .tiny-brain/analysis.json
-     */
-    writeAnalysis(analysis: AnalysisInput): Promise<void>;
-    /**
-     * Write a tech expertise file with YAML frontmatter
-     */
-    writeTechFile(name: string, frontmatter: TechExpertiseFrontmatter, content: string): Promise<void>;
-    /**
-     * Write raw markdown content to a tech file
-     * Used when receiving complete markdown from TBR API
-     */
-    writeTechFileRaw(name: string, content: string): Promise<void>;
-    /**
-     * Read analysis data from .tiny-brain/analysis.json
-     */
-    readAnalysis(): Promise<RepoAnalysisFile | null>;
-    /**
-     * Read all tech expertise files from .tiny-brain/tech/
-     */
-    readTechFiles(): Promise<TechExpertiseFile[]>;
-    /**
-     * Get tech files that match a given file path based on filePatterns
-     */
-    getTechForFile(filePath: string): Promise<TechExpertiseFile[]>;
-    /**
-     * Check if the tech stack has changed compared to previous analysis
-     */
-    hasStackChanged(analysis: AnalysisInput): Promise<boolean>;
-    /**
-     * Write config to .tiny-brain/tech/config.json
-     */
-    writeConfig(config: Omit<TechConfig, 'lastSynced'>): Promise<void>;
-    /**
-     * Read config from .tiny-brain/tech/config.json
-     */
-    readConfig(): Promise<TechConfig>;
-    /**
-     * Install tech agents to .claude/agents/
-     * Converts tech context files into proper Claude Code sub-agents with:
-     * - name: tech-{name} (matches subagent_type="tech-react")
-     * - description: for Claude Code auto-delegation
-     * - Sub-agent invocation context
-     */
-    installTechAgents(): Promise<void>;
-    /**
-     * Remove only tech-*.md files from .claude/agents/
-     */
-    removeTechAgents(): Promise<void>;
-    /**
-     * Sync agents based on enableAgentic preference
-     */
-    syncAgents(enableAgentic: boolean): Promise<void>;
-    /**
-     * Get versions of all local tech context files
-     * @returns Map of tech name → version
-     */
-    getLocalTechVersions(): Promise<Map<string, string>>;
-    /**
-     * Compare versions to determine if TBS version is newer
-     * @returns true if tbsVersion is newer than localVersion
-     */
-    shouldUpdateTech(localVersion: string, tbsVersion: string): boolean;
-    /**
-     * Parse YAML frontmatter from a markdown file
-     */
-    private parseFrontmatter;
-}
-//# sourceMappingURL=tech-context-service.d.ts.map

package/dist/services/tech-context-service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"tech-context-service.d.ts","sourceRoot":"","sources":["../../src/services/tech-context-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EACV,gBAAgB,EAGhB,wBAAwB,EACxB,iBAAiB,EACjB,UAAU,EACX,MAAM,oCAAoC,CAAC;AAE5C,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,eAAe,GAAG,gBAAgB,GAAG,aAAa,GAAG,OAAO,CAAC;IACpF,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;CACnC;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,QAAQ,EAAE,MAAM;IAM5B,yCAAyC;IACzC,eAAe,IAAI,MAAM;IAIzB,8CAA8C;IAC9C,UAAU,IAAI,MAAM;IAIpB,4CAA4C;IAC5C,YAAY,IAAI,MAAM;IAItB,wCAAwC;IAClC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxC;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC3D;;OAEG;IACG,aAAa,CACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,wBAAwB,EACrC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAmBhB;;;OAGG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpE;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAWtD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA0BnD;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAwBpE;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IA4BhE;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAWvC;;;;;;OAMG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCxC;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAcvC;;OAEG;IACG,UAAU,CAAC,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvD;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAW1D;;;OAGG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAsBnE;;OAEG;IACH,OAAO,CAAC,gBAAgB;CA+CzB"}

package/dist/services/tech-context-service.js

@@ -1,365 +0,0 @@
-/**
- * Tech Context Service
- *
- * Manages reading and writing of tech context files:
- * - .tiny-brain/analysis.json - repo analysis data
- * - .tiny-brain/tech/*.md - per-tech expertise files
- * - .tiny-brain/tech/config.json - agent mode configuration
- * - .claude/agents/tech-*.md - tech agent files (when enableAgentic=true)
- */
-import { promises as fs } from 'fs';
-import path from 'path';
-import crypto from 'crypto';
-import minimatch from 'minimatch';
-export class TechContextService {
-    tinyBrainDir;
-    techDir;
-    agentsDir;
-    constructor(repoPath) {
-        this.tinyBrainDir = path.join(repoPath, '.tiny-brain');
-        this.techDir = path.join(this.tinyBrainDir, 'tech');
-        this.agentsDir = path.join(repoPath, '.claude', 'agents');
-    }
-    /** Get the .tiny-brain directory path */
-    getTinyBrainDir() {
-        return this.tinyBrainDir;
-    }
-    /** Get the .tiny-brain/tech directory path */
-    getTechDir() {
-        return this.techDir;
-    }
-    /** Get the .claude/agents directory path */
-    getAgentsDir() {
-        return this.agentsDir;
-    }
-    /** Ensure required directories exist */
-    async ensureDirectories() {
-        await fs.mkdir(this.tinyBrainDir, { recursive: true });
-        await fs.mkdir(this.techDir, { recursive: true });
-    }
-    /**
-     * Write analysis data to .tiny-brain/analysis.json
-     */
-    async writeAnalysis(analysis) {
-        await this.ensureDirectories();
-        const stack = {
-            languages: analysis.languages,
-            frameworks: analysis.frameworks,
-            testing: analysis.testingTools,
-            build: analysis.buildTools,
-        };
-        const analysisData = {
-            hasTests: analysis.hasTests,
-            testFileCount: analysis.testFileCount,
-            testPatterns: analysis.testPatterns,
-            isPolyglot: analysis.isPolyglot ?? false,
-            primaryLanguage: analysis.primaryLanguage ?? analysis.languages[0] ?? 'unknown',
-            documentationPattern: analysis.documentationPattern,
-            documentationLocations: analysis.documentationLocations,
-        };
-        // Generate hash from stable analysis input
-        const hashInput = JSON.stringify({ stack, analysis: analysisData });
-        const analysisHash = crypto.createHash('sha256').update(hashInput).digest('hex');
-        const file = {
-            version: '1.0',
-            detectedAt: new Date().toISOString(),
-            analysisHash,
-            stack,
-            analysis: analysisData,
-        };
-        const filePath = path.join(this.tinyBrainDir, 'analysis.json');
-        await fs.writeFile(filePath, JSON.stringify(file, null, 2), 'utf-8');
-    }
-    /**
-     * Write a tech expertise file with YAML frontmatter
-     */
-    async writeTechFile(name, frontmatter, content) {
-        await this.ensureDirectories();
-        const yamlFrontmatter = [
-            '---',
-            `name: ${frontmatter.name}`,
-            `version: ${frontmatter.version}`,
-            `domain: ${frontmatter.domain}`,
-            `filePatterns:`,
-            ...frontmatter.filePatterns.map(p => `  - "${p}"`),
-            frontmatter.description ? `description: "${frontmatter.description}"` : null,
-            '---',
-        ].filter(Boolean).join('\n');
-        const fileContent = `${yamlFrontmatter}\n\n${content}`;
-        const filePath = path.join(this.techDir, `${name}.md`);
-        await fs.writeFile(filePath, fileContent, 'utf-8');
-    }
-    /**
-     * Write raw markdown content to a tech file
-     * Used when receiving complete markdown from TBR API
-     */
-    async writeTechFileRaw(name, content) {
-        await this.ensureDirectories();
-        const filePath = path.join(this.techDir, `${name}.md`);
-        await fs.writeFile(filePath, content, 'utf-8');
-    }
-    /**
-     * Read analysis data from .tiny-brain/analysis.json
-     */
-    async readAnalysis() {
-        const filePath = path.join(this.tinyBrainDir, 'analysis.json');
-        try {
-            const content = await fs.readFile(filePath, 'utf-8');
-            return JSON.parse(content);
-        }
-        catch {
-            return null;
-        }
-    }
-    /**
-     * Read all tech expertise files from .tiny-brain/tech/
-     */
-    async readTechFiles() {
-        try {
-            const files = await fs.readdir(this.techDir);
-            const techFiles = [];
-            for (const file of files) {
-                if (!file.endsWith('.md'))
-                    continue;
-                const filePath = path.join(this.techDir, file);
-                const content = await fs.readFile(filePath, 'utf-8');
-                const parsed = this.parseFrontmatter(content);
-                if (parsed) {
-                    techFiles.push({
-                        ...parsed,
-                        filePath,
-                    });
-                }
-            }
-            return techFiles;
-        }
-        catch {
-            return [];
-        }
-    }
-    /**
-     * Get tech files that match a given file path based on filePatterns
-     */
-    async getTechForFile(filePath) {
-        const techFiles = await this.readTechFiles();
-        const matches = [];
-        const basename = path.basename(filePath);
-        for (const techFile of techFiles) {
-            for (const pattern of techFile.frontmatter.filePatterns) {
-                // Check multiple matching strategies:
-                // 1. Full path glob match
-                // 2. Basename match (for patterns like *.tsx)
-                // 3. Directory prefix match (for patterns like components/)
-                if (minimatch(filePath, pattern) ||
-                    minimatch(basename, pattern) ||
-                    minimatch(filePath, `**/${pattern}`) ||
-                    filePath.includes(pattern.replace(/\/$/, ''))) {
-                    matches.push(techFile);
-                    break; // Don't add same file multiple times
-                }
-            }
-        }
-        return matches;
-    }
-    /**
-     * Check if the tech stack has changed compared to previous analysis
-     */
-    async hasStackChanged(analysis) {
-        const existing = await this.readAnalysis();
-        if (!existing)
-            return true;
-        // Generate hash for new analysis using same logic as writeAnalysis
-        const stack = {
-            languages: analysis.languages,
-            frameworks: analysis.frameworks,
-            testing: analysis.testingTools,
-            build: analysis.buildTools,
-        };
-        const analysisData = {
-            hasTests: analysis.hasTests,
-            testFileCount: analysis.testFileCount,
-            testPatterns: analysis.testPatterns,
-            isPolyglot: analysis.isPolyglot ?? false,
-            primaryLanguage: analysis.primaryLanguage ?? analysis.languages[0] ?? 'unknown',
-            documentationPattern: analysis.documentationPattern,
-            documentationLocations: analysis.documentationLocations,
-        };
-        const hashInput = JSON.stringify({ stack, analysis: analysisData });
-        const newHash = crypto.createHash('sha256').update(hashInput).digest('hex');
-        return newHash !== existing.analysisHash;
-    }
-    /**
-     * Write config to .tiny-brain/tech/config.json
-     */
-    async writeConfig(config) {
-        await this.ensureDirectories();
-        const fullConfig = {
-            ...config,
-            lastSynced: new Date().toISOString(),
-        };
-        const filePath = path.join(this.techDir, 'config.json');
-        await fs.writeFile(filePath, JSON.stringify(fullConfig, null, 2), 'utf-8');
-    }
-    /**
-     * Read config from .tiny-brain/tech/config.json
-     */
-    async readConfig() {
-        const filePath = path.join(this.techDir, 'config.json');
-        try {
-            const content = await fs.readFile(filePath, 'utf-8');
-            return JSON.parse(content);
-        }
-        catch {
-            return { useAgents: false };
-        }
-    }
-    /**
-     * Install tech agents to .claude/agents/
-     * Converts tech context files into proper Claude Code sub-agents with:
-     * - name: tech-{name} (matches subagent_type="tech-react")
-     * - description: for Claude Code auto-delegation
-     * - Sub-agent invocation context
-     */
-    async installTechAgents() {
-        await fs.mkdir(this.agentsDir, { recursive: true });
-        const techFiles = await this.readTechFiles();
-        for (const techFile of techFiles) {
-            const name = techFile.frontmatter.name;
-            const agentFileName = `tech-${name}.md`;
-            const agentPath = path.join(this.agentsDir, agentFileName);
-            // Build description from frontmatter or generate default
-            const description = techFile.frontmatter.description
-                || `${name} development specialist. Use for ${techFile.frontmatter.domain} tasks involving ${name}.`;
-            // Create agent file with proper Claude Code sub-agent format
-            const agentContent = `---
-name: tech-${name}
-description: ${description}
-version: ${techFile.frontmatter.version}
-domain: ${techFile.frontmatter.domain}
----
-
-# ${name} Sub-Agent
-
-You are a specialized ${name} development agent invoked by the developer agent. Apply the expertise and patterns below to the task you've been given.
-
-## Tech Expertise
-
-${techFile.content}`;
-            await fs.writeFile(agentPath, agentContent, 'utf-8');
-        }
-    }
-    /**
-     * Remove only tech-*.md files from .claude/agents/
-     */
-    async removeTechAgents() {
-        try {
-            const files = await fs.readdir(this.agentsDir);
-            for (const file of files) {
-                if (file.startsWith('tech-') && file.endsWith('.md')) {
-                    await fs.unlink(path.join(this.agentsDir, file));
-                }
-            }
-        }
-        catch {
-            // Directory may not exist, ignore
-        }
-    }
-    /**
-     * Sync agents based on enableAgentic preference
-     */
-    async syncAgents(enableAgentic) {
-        await this.writeConfig({ useAgents: enableAgentic });
-        if (enableAgentic) {
-            await this.installTechAgents();
-        }
-        else {
-            await this.removeTechAgents();
-        }
-    }
-    /**
-     * Get versions of all local tech context files
-     * @returns Map of tech name → version
-     */
-    async getLocalTechVersions() {
-        const techFiles = await this.readTechFiles();
-        const versions = new Map();
-        for (const file of techFiles) {
-            versions.set(file.frontmatter.name, file.frontmatter.version);
-        }
-        return versions;
-    }
-    /**
-     * Compare versions to determine if TBS version is newer
-     * @returns true if tbsVersion is newer than localVersion
-     */
-    shouldUpdateTech(localVersion, tbsVersion) {
-        const parseVersion = (v) => {
-            return v.split('.').map(s => parseInt(s, 10) || 0);
-        };
-        const local = parseVersion(localVersion);
-        const tbs = parseVersion(tbsVersion);
-        // Pad arrays to same length
-        const maxLen = Math.max(local.length, tbs.length);
-        while (local.length < maxLen)
-            local.push(0);
-        while (tbs.length < maxLen)
-            tbs.push(0);
-        // Compare each segment
-        for (let i = 0; i < maxLen; i++) {
-            if (tbs[i] > local[i])
-                return true;
-            if (tbs[i] < local[i])
-                return false;
-        }
-        return false; // Versions are equal
-    }
-    /**
-     * Parse YAML frontmatter from a markdown file
-     */
-    parseFrontmatter(content) {
-        const match = content.match(/^---\n([\s\S]*?)\n---\n\n?([\s\S]*)$/);
-        if (!match)
-            return null;
-        const yamlContent = match[1];
-        const markdownContent = match[2];
-        // Simple YAML parsing for our known structure
-        const frontmatter = {};
-        const lines = yamlContent.split('\n');
-        let currentKey = '';
-        let filePatterns = [];
-        for (const line of lines) {
-            const keyMatch = line.match(/^(\w+):\s*(.*)$/);
-            if (keyMatch) {
-                currentKey = keyMatch[1];
-                const value = keyMatch[2].replace(/^["']|["']$/g, '');
-                if (currentKey === 'filePatterns') {
-                    filePatterns = [];
-                }
-                else if (currentKey === 'name') {
-                    frontmatter.name = value;
-                }
-                else if (currentKey === 'version') {
-                    frontmatter.version = value;
-                }
-                else if (currentKey === 'domain') {
-                    frontmatter.domain = value;
-                }
-                else if (currentKey === 'description') {
-                    frontmatter.description = value;
-                }
-            }
-            else if (currentKey === 'filePatterns' && line.trim().startsWith('-')) {
-                const pattern = line.trim().replace(/^-\s*/, '').replace(/^["']|["']$/g, '');
-                filePatterns.push(pattern);
-            }
-        }
-        frontmatter.filePatterns = filePatterns;
-        if (!frontmatter.name || !frontmatter.version || !frontmatter.domain) {
-            return null;
-        }
-        return {
-            frontmatter: frontmatter,
-            content: markdownContent,
-        };
-    }
-}