@magic-ingredients/tiny-brain-local 0.16.0 → 0.17.0

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

@@ -0,0 +1,106 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,365 @@
+/**
+ * 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,
+        };
+    }
+}

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

@@ -2,10 +2,10 @@ import { type ToolArguments, type ToolResult } from './index.js';
 import type { RequestContext } from '../types/request-context.js';
 import { Tool as MCPTool } from '@modelcontextprotocol/sdk/types.js';
 /**
- * Analyse Tool - Analyze repository and manage agents
+ * Analyse Tool - Analyze repository and write tech context files
  *
- * This tool provides repository analysis and agent management functionality.
- * It analyzes the tech stack and installs/updates appropriate agents.
+ * This tool provides repository analysis and tech context management.
+ * It analyzes the tech stack and writes context files to .tiny-brain/.
  */
 export declare class AnalyseTool {
     static getToolDefinition(): MCPTool;

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

@@ -1 +1 @@
-{"version":3,"file":"analyse.tool.d.ts","sourceRoot":"","sources":["../../src/tools/analyse.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAGlE,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAQrE;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,MAAM,CAAC,iBAAiB,IAAI,OAAO;IAwBnC;;OAEG;mBACkB,sBAAsB;IA4B3C;;OAEG;WACU,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;CAsGxF"}
+{"version":3,"file":"analyse.tool.d.ts","sourceRoot":"","sources":["../../src/tools/analyse.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAOrE;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,MAAM,CAAC,iBAAiB,IAAI,OAAO;IAmBnC;;OAEG;mBACkB,sBAAsB;IA4B3C;;OAEG;WACU,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;CAoCxF"}

package/dist/tools/analyse.tool.js

@@ -1,23 +1,21 @@
 import { z } from 'zod';
 import { createErrorResult } from './index.js';
 import { AnalyseService } from '../services/analyse-service.js';
-import { AgentManager } from '../services/agent-manager.js';
 import { ConfigService } from '@magic-ingredients/tiny-brain-core';
 const AnalyseArgsSchema = z.object({
     dryRun: z.boolean().optional().default(false),
-    confirmInstall: z.boolean().optional().default(false),
 }).passthrough(); // Allow additional options to pass through
 /**
- * Analyse Tool - Analyze repository and manage agents
+ * Analyse Tool - Analyze repository and write tech context files
  *
- * This tool provides repository analysis and agent management functionality.
- * It analyzes the tech stack and installs/updates appropriate agents.
+ * This tool provides repository analysis and tech context management.
+ * It analyzes the tech stack and writes context files to .tiny-brain/.
  */
 export class AnalyseTool {
     static getToolDefinition() {
         return {
             name: 'analyse',
-            description: "🔍 REPOSITORY ANALYSIS 🔍\n\n⚡ ANALYZE & UPDATE: Analyze repository tech stack and manage agents.\n\n✅ FEATURES:\n  • Detect languages, frameworks, and tools\n  • Prompt to install recommended agents\n  • Check for agent updates\n  • Show tech stack changes\n  • Show installed skills with versions\n  • Dry-run mode for preview\n\n💡 USAGE:\n  • analyse - Analyze and prompt for installation\n  • analyse --dry-run - Preview changes without prompting\n\n🤖 AGENTS:\n  • Recommends agents based on tech stack\n  • Updates agents to latest versions\n  • Removes deprecated agents\n\n📜 SKILLS:\n  • Shows installed skills (/plan, /feature, /fix, /adr)\n  • Displays skill versions\n\n📊 OUTPUT:\n  • Tech stack summary\n  • Agent recommendations\n  • Installed skills list\n  • Installation results",
+            description: "🔍 REPOSITORY ANALYSIS 🔍\n\n⚡ ANALYZE & UPDATE: Analyze repository tech stack and write tech context files.\n\n✅ FEATURES:\n  • Detect languages, frameworks, and tools\n  • Write analysis to .tiny-brain/analysis.json\n  • Write tech context files to .tiny-brain/tech/*.md\n  • Auto-sync tech agents based on enableAgenticCoding config\n  • Show Feature flags status (SDD, TDD, ADR, Agentic)\n  • Dry-run mode for preview\n\n💡 USAGE:\n  • analyse - Analyze repo and write tech context files\n  • analyse --dry-run - Preview changes without writing\n\n📊 OUTPUT:\n  • Feature flags status\n  • Tech stack summary\n  • Tech contexts detected\n  • Directory initialization status",
             inputSchema: {
                 type: 'object',
                 properties: {
@@ -26,11 +24,6 @@ export class AnalyseTool {
                         description: 'Preview changes without applying them',
                         default: false,
                     },
-                    confirmInstall: {
-                        type: 'boolean',
-                        description: 'Confirm installation of agents (used internally)',
-                        default: false,
-                    },
                 },
                 required: [],
             },
@@ -76,67 +69,11 @@ export class AnalyseTool {
             const service = new AnalyseService(context);
             const result = await service.performAnalysis(validatedArgs);
             // Format output for display
-            let output = preAnalysisFeedback ? preAnalysisFeedback + service.formatAnalysisOutput(result) : service.formatAnalysisOutput(result);
-            // Handle agent installation
-            if (!validatedArgs.dryRun && result.recommendations) {
-                const hasRecommendations = (result.recommendations.install?.length || 0) > 0 ||
-                    (result.recommendations.update?.length || 0) > 0 ||
-                    (result.recommendations.remove?.length || 0) > 0;
-                if (hasRecommendations) {
-                    // Check if user has confirmed installation
-                    if (!validatedArgs.confirmInstall) {
-                        // Return JSON asking for confirmation (for MCP context)
-                        return {
-                            content: [{
-                                    type: 'text',
-                                    text: JSON.stringify({
-                                        requiresConfirmation: true,
-                                        action: 'installAgents',
-                                        recommendations: {
-                                            install: result.recommendations.install?.length || 0,
-                                            update: result.recommendations.update?.length || 0,
-                                            remove: result.recommendations.remove?.length || 0,
-                                        },
-                                        message: output + '\n\nWould you like to install these agents?',
-                                        hint: 'To confirm installation, call the tool again with confirmInstall: true',
-                                    }, null, 2),
-                                }],
-                            isError: false,
-                        };
-                    }
-                    // User has confirmed - proceed with installation
-                    const selection = {
-                        install: result.recommendations.install || [],
-                        update: result.recommendations.update || [],
-                        remove: result.recommendations.remove || []
-                    };
-                    // Apply the recommendations using AgentManager
-                    output += '\n📦 Installing agents...\n';
-                    const agentManager = new AgentManager(context);
-                    const executionResult = await agentManager.executeRecommendations(selection, result.analysis);
-                    // Report results
-                    if (executionResult.installed.length > 0) {
-                        output += `✅ Installed: ${executionResult.installed.join(', ')}\n`;
-                    }
-                    if (executionResult.updated.length > 0) {
-                        output += `✅ Updated: ${executionResult.updated.join(', ')}\n`;
-                    }
-                    if (executionResult.removed.length > 0) {
-                        output += `✅ Removed: ${executionResult.removed.join(', ')}\n`;
-                    }
-                    if (executionResult.skipped.length > 0) {
-                        output += `⏭️ Skipped (already up-to-date): ${executionResult.skipped.join(', ')}\n`;
-                    }
-                    if (executionResult.errors.length > 0) {
-                        output += '⚠️ Errors:\n';
-                        executionResult.errors.forEach(e => {
-                            output += `  - ${e.message}\n`;
-                        });
-                    }
-                    output += '\n✅ Agent management completed!';
-                }
-            }
-            // Note: Repository registration now happens in AnalyseService.performAnalysis()
+            const output = preAnalysisFeedback
+                ? preAnalysisFeedback + service.formatAnalysisOutput(result)
+                : service.formatAnalysisOutput(result);
+            // Note: Tech context syncing is now handled automatically by AnalyseService
+            // based on enableAgenticCoding config - no user confirmation needed
             return {
                 content: [{
                         type: 'text',

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;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;mBA8CT,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;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"}

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

@@ -1,6 +1,7 @@
 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';
 const ConfigArgsSchema = z.object({
     operation: z.enum(['list', 'get', 'show-sources', 'set', 'reset']),
     key: z.string().optional(),
@@ -79,7 +80,7 @@ export class ConfigTool {
                 case 'show-sources':
                     return await ConfigTool.handleShowSources(configService);
                 case 'set':
-                    return await ConfigTool.handleSet(validatedArgs, configService);
+                    return await ConfigTool.handleSet(validatedArgs, configService, context);
                 case 'reset':
                     return await ConfigTool.handleReset(configService);
                 default:
@@ -213,7 +214,7 @@ export class ConfigTool {
             return createErrorResult(`Failed to show preference sources: ${error instanceof Error ? error.message : 'Unknown error'}`);
         }
     }
-    static async handleSet(args, configService) {
+    static async handleSet(args, configService, context) {
         if (!args.key) {
             return createErrorResult('key is required for set operation');
         }
@@ -226,6 +227,13 @@ export class ConfigTool {
             if (!result.success) {
                 return createErrorResult(result.error);
             }
+            // React to enableAgenticCoding changes for repo scope
+            // Tech files are repo-specific, so global scope doesn't trigger sync
+            if (args.key === 'enableAgenticCoding' && scope === 'repo' && context.repositoryRoot) {
+                const techContextService = new TechContextService(context.repositoryRoot);
+                const enableAgentic = args.value === 'true';
+                await techContextService.syncAgents(enableAgentic);
+            }
             const scopeLabel = scope === 'global' ? 'Global' : 'Repository';
             const displayValue = args.value === 'true' || args.value === 'false'
                 ? args.value === 'true'

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;AAaH,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;IAiC5B;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;CAkB9D;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;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"}