@theihtisham/agent-shadow-brain 1.2.0 → 2.1.0

package/dist/brain/adr-engine.js

@@ -0,0 +1,400 @@
+// src/brain/adr-engine.ts — Architecture Decision Records engine
+import * as fs from 'fs';
+import * as path from 'path';
+const ADR_HEADER_RE = /^#\s+(.+)$/;
+const ADR_SECTION_RE = /^##\s+(.+)$/;
+export class ADREngine {
+    constructor(projectDir, llmClient) {
+        this.projectDir = projectDir;
+        this.llmClient = llmClient;
+        // Prefer docs/adr/, fall back to .shadow-brain/adrs/
+        const docsAdr = path.join(projectDir, 'docs', 'adr');
+        const shadowAdr = path.join(projectDir, '.shadow-brain', 'adrs');
+        if (fs.existsSync(docsAdr)) {
+            this.adrDir = docsAdr;
+        }
+        else if (fs.existsSync(shadowAdr)) {
+            this.adrDir = shadowAdr;
+        }
+        else {
+            // Default to docs/adr (will be created on first save)
+            this.adrDir = docsAdr;
+        }
+    }
+    /**
+     * Load all ADR markdown files from the ADR directory.
+     * Returns parsed ADRDecision objects sorted by ID.
+     */
+    async loadADRs() {
+        if (!fs.existsSync(this.adrDir)) {
+            return [];
+        }
+        const adrs = [];
+        const files = fs.readdirSync(this.adrDir)
+            .filter(f => f.endsWith('.md'))
+            .sort();
+        for (const file of files) {
+            const fullPath = path.join(this.adrDir, file);
+            try {
+                const content = fs.readFileSync(fullPath, 'utf-8');
+                const adr = this.parseADR(content, file);
+                if (adr)
+                    adrs.push(adr);
+            }
+            catch {
+                // unreadable file — skip
+            }
+        }
+        return adrs;
+    }
+    /**
+     * Write an ADR to the docs/adr/ directory in standard markdown format.
+     * Filename pattern: NNNN-kebab-case-title.md
+     */
+    async saveADR(adr) {
+        // Ensure the directory exists
+        fs.mkdirSync(this.adrDir, { recursive: true });
+        // Determine the next sequence number
+        const nextNum = await this.getNextNumber();
+        const slug = this.slugify(adr.title);
+        const filename = `${String(nextNum).padStart(4, '0')}-${slug}.md`;
+        const fullPath = path.join(this.adrDir, filename);
+        const markdown = this.formatADRMd(adr);
+        fs.writeFileSync(fullPath, markdown, 'utf-8');
+    }
+    /**
+     * Analyse file changes to detect architectural decisions.
+     * Uses heuristic rules, and optionally an LLM client for deeper analysis.
+     */
+    async detectDecisions(changes) {
+        const decisions = [];
+        const now = new Date();
+        // Gather all diffs for LLM analysis if available
+        const allDiffs = [];
+        for (const change of changes) {
+            const diff = change.diff || '';
+            // ── Heuristic: Framework change ───────────────────────────────────────
+            if (this.looksLikeFrameworkChange(change.path, diff)) {
+                decisions.push({
+                    id: `adr-auto-${Date.now()}-framework`,
+                    title: `Framework or library adoption in ${path.basename(change.path)}`,
+                    status: 'proposed',
+                    date: now,
+                    context: `A significant framework or core library change was detected in ${change.path}.`,
+                    decision: 'Pending review — framework or library change detected automatically.',
+                    consequences: 'May affect the overall architecture, build pipeline, and dependency tree.',
+                    alternatives: ['Evaluate alternatives before committing', 'Create a spike/prototype first'],
+                    files: [change.path],
+                });
+                continue;
+            }
+            // ── Heuristic: New architectural pattern ──────────────────────────────
+            if (this.looksLikeNewPattern(change.path, diff)) {
+                decisions.push({
+                    id: `adr-auto-${Date.now()}-pattern`,
+                    title: `New architectural pattern introduced in ${path.basename(change.path)}`,
+                    status: 'proposed',
+                    date: now,
+                    context: `A new structural or architectural pattern was introduced in ${change.path}.`,
+                    decision: 'Pending review — new pattern detected automatically.',
+                    consequences: 'May establish a precedent for how similar features are structured.',
+                    alternatives: ['Document the pattern explicitly', 'Refactor to match existing patterns'],
+                    files: [change.path],
+                });
+                continue;
+            }
+            // ── Heuristic: Significant refactor ───────────────────────────────────
+            if (this.looksLikeSignificantRefactor(diff)) {
+                decisions.push({
+                    id: `adr-auto-${Date.now()}-refactor`,
+                    title: `Significant refactor in ${path.basename(change.path)}`,
+                    status: 'proposed',
+                    date: now,
+                    context: `A large-scale refactoring was detected in ${change.path}. This could indicate an architectural shift.`,
+                    decision: 'Pending review — significant code restructure detected.',
+                    consequences: 'Could affect multiple modules, API contracts, or data flows.',
+                    alternatives: ['Incremental refactor with feature flags', 'Phased rollout'],
+                    files: [change.path],
+                });
+                continue;
+            }
+            if (diff) {
+                allDiffs.push(`--- ${change.path} ---\n${diff}`);
+            }
+        }
+        // ── LLM-assisted detection ─────────────────────────────────────────────
+        if (this.llmClient && allDiffs.length > 0) {
+            try {
+                const llmDecisions = await this.detectWithLLM(allDiffs);
+                decisions.push(...llmDecisions);
+            }
+            catch {
+                // LLM detection is best-effort — heuristics are the primary path
+            }
+        }
+        return decisions;
+    }
+    // ── Private Helpers ────────────────────────────────────────────────────────
+    /**
+     * Format an ADRDecision as a standard ADR markdown document.
+     */
+    formatADRMd(adr) {
+        let md = `# ${adr.title}\n\n`;
+        md += `## Status\n\n${adr.status}\n\n`;
+        md += `## Context\n\n${adr.context}\n\n`;
+        md += `## Decision\n\n${adr.decision}\n\n`;
+        md += `## Consequences\n\n${adr.consequences}\n\n`;
+        if (adr.alternatives && adr.alternatives.length > 0) {
+            md += `## Alternatives Considered\n\n`;
+            for (const alt of adr.alternatives) {
+                md += `- ${alt}\n`;
+            }
+            md += `\n`;
+        }
+        if (adr.files && adr.files.length > 0) {
+            md += `## Files Affected\n\n`;
+            for (const file of adr.files) {
+                md += `- ${file}\n`;
+            }
+            md += `\n`;
+        }
+        md += `## Date\n\n${adr.date.toISOString().split('T')[0]}\n`;
+        return md;
+    }
+    /**
+     * Parse a markdown ADR file into an ADRDecision object.
+     */
+    parseADR(content, filename) {
+        const lines = content.split('\n');
+        // Extract ID from filename (e.g. "0003-use-postgres.md" -> "0003")
+        const idMatch = filename.match(/^(\d+)/);
+        const id = idMatch ? idMatch[1] : filename.replace('.md', '');
+        // Parse title from first H1
+        let title = filename.replace(/^\d+-/, '').replace(/\.md$/, '').replace(/-/g, ' ');
+        for (const line of lines) {
+            const m = line.match(ADR_HEADER_RE);
+            if (m) {
+                title = m[1].trim();
+                break;
+            }
+        }
+        // Parse sections
+        let status = 'proposed';
+        let context = '';
+        let decision = '';
+        let consequences = '';
+        let alternatives = [];
+        let currentSection = '';
+        for (const line of lines) {
+            const sectionMatch = line.match(ADR_SECTION_RE);
+            if (sectionMatch) {
+                currentSection = sectionMatch[1].trim().toLowerCase();
+                continue;
+            }
+            switch (currentSection) {
+                case 'status':
+                    const statusVal = line.trim().toLowerCase();
+                    if (['proposed', 'accepted', 'deprecated', 'superseded'].includes(statusVal)) {
+                        status = statusVal;
+                    }
+                    break;
+                case 'context':
+                    context += line + '\n';
+                    break;
+                case 'decision':
+                    decision += line + '\n';
+                    break;
+                case 'consequences':
+                    consequences += line + '\n';
+                    break;
+                case 'alternatives considered':
+                case 'alternatives':
+                    const trimmed = line.trim();
+                    if (trimmed.startsWith('- ') || trimmed.startsWith('* ')) {
+                        alternatives.push(trimmed.slice(2).trim());
+                    }
+                    else if (trimmed && !trimmed.startsWith('#')) {
+                        alternatives.push(trimmed);
+                    }
+                    break;
+            }
+        }
+        return {
+            id,
+            title,
+            status,
+            date: new Date(), // Files don't carry creation date in content; use mtime if needed
+            context: context.trim(),
+            decision: decision.trim(),
+            consequences: consequences.trim(),
+            alternatives: alternatives.length > 0 ? alternatives : undefined,
+        };
+    }
+    /**
+     * Get the next sequence number for ADR filenames.
+     */
+    async getNextNumber() {
+        if (!fs.existsSync(this.adrDir))
+            return 1;
+        const files = fs.readdirSync(this.adrDir).filter(f => f.endsWith('.md'));
+        let maxNum = 0;
+        for (const file of files) {
+            const match = file.match(/^(\d+)/);
+            if (match) {
+                const num = parseInt(match[1], 10);
+                if (num > maxNum)
+                    maxNum = num;
+            }
+        }
+        return maxNum + 1;
+    }
+    /**
+     * Heuristic: detect framework or core library changes.
+     */
+    looksLikeFrameworkChange(filePath, diff) {
+        const frameworkIndicators = [
+            /package\.json/,
+            /next\.config/,
+            /tsconfig\.json/,
+            /webpack\.config/,
+            /vite\.config/,
+            /angular\.json/,
+            /vue\.config/,
+            /nuxt\.config/,
+            /tailwind\.config/,
+            /docker-compose/,
+            /Dockerfile/,
+            /\.env\.example/,
+            /prisma\/schema/,
+            /drizzle\.config/,
+        ];
+        const isConfigFile = frameworkIndicators.some(re => re.test(path.basename(filePath)));
+        if (isConfigFile && diff.length > 100)
+            return true;
+        // Check diff for import changes of major frameworks
+        const frameworkImports = [
+            /from\s+['"]react['"]/,
+            /from\s+['"]vue['"]/,
+            /from\s+['"]@angular/,
+            /from\s+['"]next['"]/,
+            /from\s+['"]express['"]/,
+            /from\s+['"]fastify['"]/,
+            /from\s+['"]nestjs['"]/,
+            /from\s+['"]@prisma/,
+            /from\s+['"]drizzle-orm/,
+        ];
+        const hasFrameworkImport = frameworkImports.some(re => re.test(diff));
+        return hasFrameworkImport && diff.length > 200;
+    }
+    /**
+     * Heuristic: detect introduction of new architectural patterns.
+     */
+    looksLikeNewPattern(filePath, diff) {
+        if (!diff)
+            return false;
+        const patternIndicators = [
+            // Design patterns
+            /\bclass\s+\w+Singleton\b/,
+            /\bclass\s+\w+Factory\b/,
+            /\bclass\s+\w+Strategy\b/,
+            /\bclass\s+\w+Observer\b/,
+            /\bclass\s+\w+Adapter\b/,
+            /\bimplements\s+\w+Strategy/,
+            /\bimplements\s+\w+Repository/,
+            /\bimplements\s+\w+Service/,
+            // Architectural patterns
+            /\buseCase\b|\bUseCase\b/,
+            /\brepository\b|\bRepository\b/,
+            /\bservice\s+layer\b|\bServiceLayer\b/i,
+            /\bclean\s+architecture\b/i,
+            /\bhexagonal\b/i,
+            /\bmiddleware\b/i,
+            /\bplugin\b/i,
+        ];
+        return patternIndicators.some(re => re.test(diff));
+    }
+    /**
+     * Heuristic: detect significant refactoring (large diffs with structural changes).
+     */
+    looksLikeSignificantRefactor(diff) {
+        if (!diff || diff.length < 500)
+            return false;
+        // Count structural change indicators
+        const addedLines = (diff.match(/^\+/gm) || []).length;
+        const removedLines = (diff.match(/^-/gm) || []).length;
+        // Significant if lots of additions and removals
+        const totalChanges = addedLines + removedLines;
+        if (totalChanges < 30)
+            return false;
+        // Check for structural keywords in the diff
+        const structuralKeywords = [
+            /\bclass\b.*\bextends\b/,
+            /\binterface\b/,
+            /\bexport\s+default\b/,
+            /\bmodule\.exports\b/,
+            /\bimport\s+.*\bfrom\b/,
+            /\btype\s+\w+\s*=/,
+            /\basync\s+/,
+            /\bawait\s+/,
+        ];
+        let keywordHits = 0;
+        for (const kw of structuralKeywords) {
+            if (kw.test(diff))
+                keywordHits++;
+        }
+        return keywordHits >= 2;
+    }
+    /**
+     * Use the LLM client to analyse diffs and detect architectural decisions.
+     */
+    async detectWithLLM(diffs) {
+        if (!this.llmClient)
+            return [];
+        const combined = diffs.join('\n\n').slice(0, 8000); // truncate to reasonable size
+        const prompt = `Analyse the following code diffs and identify any architectural decisions that should be documented as ADRs (Architecture Decision Records).
+For each decision, provide:
+- title: short descriptive title
+- context: what is the situation that necessitates this decision
+- decision: what was decided
+- consequences: what are the resulting consequences
+
+Respond with a JSON array of objects with keys: title, context, decision, consequences.
+If no architectural decisions are detected, respond with an empty array: []
+
+Diffs:
+${combined}`;
+        const response = await this.llmClient.complete(prompt, 'You are a senior software architect. Analyse code changes and identify architectural decisions. Respond with valid JSON only.');
+        try {
+            const cleaned = response.replace(/```json\n?/g, '').replace(/```\n?/g, '').trim();
+            const parsed = JSON.parse(cleaned);
+            if (!Array.isArray(parsed))
+                return [];
+            return parsed.map((item, idx) => ({
+                id: `adr-llm-${Date.now()}-${idx}`,
+                title: item.title || 'Untitled LLM-detected decision',
+                status: 'proposed',
+                date: new Date(),
+                context: item.context || '',
+                decision: item.decision || '',
+                consequences: item.consequences || '',
+                alternatives: item.alternatives || undefined,
+            }));
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Convert a title string to a kebab-case slug for filenames.
+     */
+    slugify(title) {
+        return title
+            .toLowerCase()
+            .replace(/[^a-z0-9\s-]/g, '')
+            .replace(/\s+/g, '-')
+            .replace(/-+/g, '-')
+            .replace(/^-|-$/g, '')
+            .slice(0, 60);
+    }
+}
+//# sourceMappingURL=adr-engine.js.map

package/dist/brain/adr-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr-engine.js","sourceRoot":"","sources":["../../src/brain/adr-engine.ts"],"names":[],"mappings":"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"}

package/dist/brain/code-similarity.d.ts

@@ -0,0 +1,43 @@
+import { DuplicateGroup } from '../types.js';
+export declare class CodeSimilarityDetector {
+    private projectDir;
+    constructor(projectDir: string);
+    /**
+     * Scan all source files for duplicate code blocks.
+     * Returns groups of blocks whose pairwise similarity >= minSimilarity.
+     */
+    detectDuplicates(minSimilarity?: number): Promise<DuplicateGroup[]>;
+    /**
+     * Walk the project tree, read each source file, and extract code blocks.
+     */
+    private collectAllBlocks;
+    /**
+     * Split a single file into code blocks by tracking brace depth.
+     * Recognises the block type (function, method, class, generic block).
+     * Only returns blocks with >= 6 lines.
+     */
+    private extractBlocks;
+    /**
+     * Compute Jaccard similarity between two code blocks.
+     * Tokenises content into word tokens, then calculates |intersection| / |union|.
+     */
+    private computeSimilarity;
+    /**
+     * Split content into individual word tokens and return as a Set.
+     * Strips punctuation and normalises to lowercase for comparison.
+     */
+    private tokenize;
+    /**
+     * Generate a refactoring suggestion based on the types of the duplicate blocks.
+     */
+    private suggestRefactor;
+    /**
+     * Walk a directory tree, returning full paths of source files.
+     */
+    private walkDir;
+    /**
+     * Produce a unique key for a block (file path + line range).
+     */
+    private blockKey;
+}
+//# sourceMappingURL=code-similarity.d.ts.map

package/dist/brain/code-similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-similarity.d.ts","sourceRoot":"","sources":["../../src/brain/code-similarity.ts"],"names":[],"mappings":"AAIA,OAAO,EAAa,cAAc,EAAE,MAAM,aAAa,CAAC;AASxD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAI9B;;;OAGG;IACG,gBAAgB,CAAC,aAAa,GAAE,MAAY,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA6C9E;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAoErB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAShB;;OAEG;IACH,OAAO,CAAC,eAAe;IA6BvB;;OAEG;IACH,OAAO,CAAC,OAAO;IA2Bf;;OAEG;IACH,OAAO,CAAC,QAAQ;CAGjB"}