@tonycasey/lisa 2.25.4 → 2.26.0

package/dist/lib/infrastructure/services/CommitEnricher.js

@@ -0,0 +1,214 @@
+"use strict";
+/**
+ * Commit Enricher Implementation.
+ *
+ * LLM-powered extraction of structured facts from git commits.
+ * Takes high-interest commits from GitTriageService and extracts
+ * meaningful facts (features, decisions, refactors, etc.) for memory.
+ *
+ * Error Handling:
+ * - Graceful fallback: if the LLM call fails for any reason, returns
+ *   an empty result — never blocks session start or git triage.
+ * - Error messages are sanitized (first line only) to avoid logging
+ *   raw API response bodies which may contain sensitive data.
+ *
+ * Part of LISA-8: Phase 2 Git-Powered Memory Enrichment.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCommitEnricher = createCommitEnricher;
+const ICommitEnricher_1 = require("../../domain/interfaces/ICommitEnricher");
+const IMemoryQuality_1 = require("../../domain/interfaces/types/IMemoryQuality");
+const commit_extraction_1 = require("./prompts/commit-extraction");
+/** Default maximum commits to process in one batch. */
+const DEFAULT_MAX_COMMITS = 5;
+/** Default maximum tokens for the LLM call. */
+const DEFAULT_MAX_TOKENS = 4096;
+/** Empty usage stats for fallback results. */
+const EMPTY_USAGE = { inputTokens: 0, outputTokens: 0, totalTokens: 0 };
+/**
+ * Create a commit enricher.
+ *
+ * @param llmGuard - LLM guard for policy-enforced completions
+ * @param logger - Optional logger
+ */
+function createCommitEnricher(llmGuard, logger) {
+    return {
+        async enrich(commits, options = {}) {
+            try {
+                // Filter out commits that should be skipped (use shortSha for consistency)
+                const skipShas = new Set(options.skipShas ?? []);
+                const filteredCommits = commits.filter(c => !skipShas.has(c.commit.shortSha));
+                if (filteredCommits.length === 0) {
+                    return {
+                        facts: [],
+                        commitsProcessed: 0,
+                        commitsSkipped: commits.length,
+                        usage: EMPTY_USAGE,
+                    };
+                }
+                // Limit to maxCommits (guard against <= 0)
+                const maxCommits = Math.max(0, options.maxCommits ?? DEFAULT_MAX_COMMITS);
+                const toProcess = filteredCommits.slice(0, maxCommits);
+                // Fast-return for empty toProcess to avoid wasting LLM tokens
+                if (toProcess.length === 0) {
+                    return {
+                        facts: [],
+                        commitsProcessed: 0,
+                        commitsSkipped: commits.length,
+                        usage: EMPTY_USAGE,
+                    };
+                }
+                const skipped = commits.length - toProcess.length;
+                // Build allowed SHAs set for validation (both full and short)
+                const allowedShas = new Set(toProcess.flatMap(c => [c.commit.sha, c.commit.shortSha].filter(Boolean)));
+                const prompt = (0, commit_extraction_1.buildCommitExtractionPrompt)(toProcess, options);
+                const response = await llmGuard.complete(prompt.user, 'extraction', {
+                    systemPrompt: prompt.system,
+                    temperature: 0.3,
+                    maxTokens: options.maxTokens ?? DEFAULT_MAX_TOKENS,
+                });
+                const parsed = parseCommitExtractionResponse(response.text, options, allowedShas);
+                return {
+                    facts: parsed.facts,
+                    commitsProcessed: toProcess.length,
+                    commitsSkipped: skipped,
+                    usage: response.usage,
+                };
+            }
+            catch (error) {
+                // Sanitize error message to avoid logging raw API response bodies
+                const errorMsg = error instanceof Error
+                    ? error.message.split('\n')[0] // Take only first line
+                    : 'Unknown error';
+                logger?.warn('Commit enrichment failed, returning empty result', {
+                    error: errorMsg,
+                });
+                return {
+                    facts: [],
+                    commitsProcessed: 0,
+                    commitsSkipped: commits.length,
+                    usage: EMPTY_USAGE,
+                };
+            }
+        },
+    };
+}
+/**
+ * Parse and validate the LLM extraction response.
+ *
+ * Expects JSON with `{ facts: [...] }`.
+ * Invalid facts are silently dropped.
+ *
+ * @param allowedShas - Optional set of valid SHAs to reject hallucinated commits
+ */
+function parseCommitExtractionResponse(responseText, options = {}, allowedShas) {
+    // Try to extract JSON from the response
+    const jsonText = extractJson(responseText);
+    if (!jsonText) {
+        return { facts: [] };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonText);
+    }
+    catch {
+        return { facts: [] };
+    }
+    if (typeof parsed !== 'object' || parsed === null) {
+        return { facts: [] };
+    }
+    const obj = parsed;
+    const rawFacts = Array.isArray(obj.facts) ? obj.facts : [];
+    const allowedTypes = options.extractTypes;
+    const facts = [];
+    for (const raw of rawFacts) {
+        const fact = validateCommitFact(raw, allowedTypes, allowedShas);
+        if (fact) {
+            facts.push(fact);
+        }
+    }
+    return { facts };
+}
+/**
+ * Extract JSON from LLM response text.
+ * Handles responses that may have text before/after the JSON block.
+ * Uses progressive try-parse from each '{' to handle braces inside strings.
+ */
+function extractJson(text) {
+    const trimmed = text.trim();
+    // Try each '{' as a potential JSON start
+    let start = trimmed.indexOf('{');
+    while (start !== -1) {
+        // Try parsing progressively longer substrings from this start
+        for (let end = trimmed.lastIndexOf('}'); end > start; end = trimmed.lastIndexOf('}', end - 1)) {
+            const candidate = trimmed.slice(start, end + 1);
+            try {
+                JSON.parse(candidate);
+                return candidate;
+            }
+            catch {
+                // Try a shorter substring
+            }
+        }
+        start = trimmed.indexOf('{', start + 1);
+    }
+    return null;
+}
+/**
+ * Validate a single extracted commit fact from the LLM response.
+ * Returns null for invalid facts.
+ *
+ * @param allowedShas - Optional set of valid SHAs to reject hallucinated commits
+ */
+function validateCommitFact(raw, allowedTypes, allowedShas) {
+    if (typeof raw !== 'object' || raw === null)
+        return null;
+    const obj = raw;
+    // Text is required and must be non-empty
+    if (typeof obj.text !== 'string' || obj.text.trim().length === 0)
+        return null;
+    // Type must be valid
+    if (typeof obj.type !== 'string' || !(0, ICommitEnricher_1.isValidCommitFactType)(obj.type))
+        return null;
+    // If type filter specified, enforce it
+    if (allowedTypes && allowedTypes.length > 0 && !allowedTypes.includes(obj.type)) {
+        return null;
+    }
+    // commitSha is required
+    if (typeof obj.commitSha !== 'string' || obj.commitSha.trim().length === 0)
+        return null;
+    const commitSha = obj.commitSha.trim();
+    // Reject facts with unknown SHAs (LLM may hallucinate)
+    if (allowedShas && !allowedShas.has(commitSha))
+        return null;
+    // Confidence must be valid (default to 'medium' if missing)
+    let confidence = 'medium';
+    if (typeof obj.confidence === 'string') {
+        if ((0, IMemoryQuality_1.isValidConfidence)(obj.confidence)) {
+            confidence = obj.confidence;
+        }
+        // If invalid confidence string, keep default 'medium'
+    }
+    // Tags must be string array (default to empty)
+    const tags = [];
+    if (Array.isArray(obj.tags)) {
+        for (const tag of obj.tags) {
+            if (typeof tag === 'string' && tag.trim().length > 0) {
+                tags.push(tag.trim());
+            }
+        }
+    }
+    // Rationale is optional
+    const rationale = typeof obj.rationale === 'string' && obj.rationale.trim().length > 0
+        ? obj.rationale.trim()
+        : undefined;
+    return {
+        text: obj.text.trim(),
+        type: obj.type,
+        confidence,
+        tags,
+        commitSha,
+        rationale,
+    };
+}
+//# sourceMappingURL=CommitEnricher.js.map

package/dist/lib/infrastructure/services/CommitEnricher.js.map

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

package/dist/lib/infrastructure/services/prompts/commit-extraction.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Commit Extraction Prompt Builder.
+ *
+ * Constructs system and user prompts for LLM-based fact extraction
+ * from git commits. Requests structured JSON output with typed facts,
+ * confidence levels, and tags.
+ *
+ * Part of LISA-8: Phase 2 Git-Powered Memory Enrichment.
+ */
+import type { IScoredCommit } from '../../../domain/interfaces/IGitTriageService';
+import type { ICommitEnrichmentOptions } from '../../../domain/interfaces/ICommitEnricher';
+/**
+ * Built prompt pair for the commit extraction LLM call.
+ */
+export interface ICommitExtractionPrompt {
+    readonly system: string;
+    readonly user: string;
+}
+/**
+ * Build an extraction prompt from a batch of high-interest commits.
+ *
+ * @param commits - High-interest commits from triage
+ * @param options - Enrichment options
+ */
+export declare function buildCommitExtractionPrompt(commits: readonly IScoredCommit[], options?: ICommitEnrichmentOptions): ICommitExtractionPrompt;
+//# sourceMappingURL=commit-extraction.d.ts.map

package/dist/lib/infrastructure/services/prompts/commit-extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-extraction.d.ts","sourceRoot":"","sources":["../../../../../src/lib/infrastructure/services/prompts/commit-extraction.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8CAA8C,CAAC;AAClF,OAAO,KAAK,EAAE,wBAAwB,EAAkB,MAAM,4CAA4C,CAAC;AAE3G;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAOD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,OAAO,GAAE,wBAA6B,GACrC,uBAAuB,CAiEzB"}

package/dist/lib/infrastructure/services/prompts/commit-extraction.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * Commit Extraction Prompt Builder.
+ *
+ * Constructs system and user prompts for LLM-based fact extraction
+ * from git commits. Requests structured JSON output with typed facts,
+ * confidence levels, and tags.
+ *
+ * Part of LISA-8: Phase 2 Git-Powered Memory Enrichment.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCommitExtractionPrompt = buildCommitExtractionPrompt;
+/**
+ * Default maximum facts to extract per batch.
+ */
+const DEFAULT_MAX_FACTS = 10;
+/**
+ * Build an extraction prompt from a batch of high-interest commits.
+ *
+ * @param commits - High-interest commits from triage
+ * @param options - Enrichment options
+ */
+function buildCommitExtractionPrompt(commits, options = {}) {
+    const extractTypes = options.extractTypes;
+    const maxFacts = Math.min(commits.length * 2, DEFAULT_MAX_FACTS);
+    const validTypes = extractTypes && extractTypes.length > 0
+        ? extractTypes
+        : [
+            'feature',
+            'decision',
+            'refactor',
+            'migration',
+            'bugfix',
+            'breaking-change',
+            'convention',
+            'dependency',
+        ];
+    const system = [
+        'You are analyzing git commits to extract structured facts for project memory.',
+        'Your task is to identify important information worth remembering long-term.',
+        '',
+        'Fact types to extract:',
+        '- feature: New functionality or capability added to the project',
+        '- decision: Architecture or technology choice evident from the commit',
+        '- refactor: Code restructuring without behavior change',
+        '- migration: Data migration, API migration, or technology migration',
+        '- bugfix: Bug fix with root cause (what was broken and why)',
+        '- breaking-change: Changes that break backward compatibility',
+        '- convention: New patterns or coding conventions introduced',
+        '- dependency: Significant dependency additions, updates, or removals',
+        '',
+        'Confidence levels:',
+        '- high: Clear from commit message, subject, or explicit description',
+        '- medium: Reasonably inferred from commit context and signals',
+        '- low: Tentative inference, may need verification',
+        '',
+        'Guidelines:',
+        '- Each fact should be self-contained and understandable without the commit context.',
+        '- Include relevant file paths, technologies, or components in tags.',
+        '- For bugfixes, try to identify the root cause if evident from the message.',
+        '- Focus on facts that would be valuable for future developers.',
+        '- Do not extract trivial changes (formatting, typos, version bumps).',
+        `- Extract at most ${maxFacts} facts total across all commits.`,
+        extractTypes && extractTypes.length > 0
+            ? `- Only extract facts of these types: ${extractTypes.join(', ')}`
+            : '- Extract facts of any type listed above.',
+        '',
+        'Respond with ONLY a valid JSON object in this exact format:',
+        '{',
+        '  "facts": [',
+        '    {',
+        '      "text": "Clear description of the fact",',
+        `      "type": "one of: ${validTypes.join(', ')}",`,
+        '      "confidence": "high | medium | low",',
+        '      "tags": ["relevant", "tags"],',
+        '      "commitSha": "short SHA of the source commit",',
+        '      "rationale": "Why this fact is worth remembering"',
+        '    }',
+        '  ]',
+        '}',
+    ].join('\n');
+    const user = formatCommitsForPrompt(commits);
+    return { system, user };
+}
+/**
+ * Format commits into a structured prompt section.
+ */
+function formatCommitsForPrompt(commits) {
+    const parts = [];
+    parts.push('## Commits to Analyze');
+    parts.push('');
+    for (let i = 0; i < commits.length; i++) {
+        const { commit, stats, signals } = commits[i];
+        parts.push(`### Commit ${i + 1}: ${commit.shortSha}`);
+        parts.push(`**Subject:** ${commit.subject}`);
+        if (commit.body && commit.body.trim().length > 0) {
+            const truncatedBody = commit.body.length > 500
+                ? commit.body.slice(0, 500) + '...'
+                : commit.body;
+            parts.push(`**Body:** ${truncatedBody}`);
+        }
+        parts.push(`**Timestamp:** ${commit.timestamp.toISOString()}`);
+        parts.push(`**Author:** ${commit.author}`);
+        if (stats) {
+            parts.push(`**Files changed:** ${stats.filesChanged}`);
+            parts.push(`**Lines:** +${stats.insertions} -${stats.deletions}`);
+            if (stats.directoriesCreated.length > 0) {
+                parts.push(`**New directories:** ${stats.directoriesCreated.join(', ')}`);
+            }
+        }
+        // Format interest signals
+        const signalList = formatSignals(signals);
+        if (signalList.length > 0) {
+            parts.push(`**Signals:** ${signalList.join(', ')}`);
+        }
+        parts.push('');
+    }
+    return parts.join('\n');
+}
+/**
+ * Format interest signals into readable strings.
+ */
+function formatSignals(signals) {
+    const result = [];
+    if (signals.largeDiffFiles) {
+        result.push('large-diff-files');
+    }
+    if (signals.largeDiffLines) {
+        result.push('large-diff-lines');
+    }
+    if (signals.mergeCommitWithPR && signals.prNumber) {
+        result.push(`merge-PR-#${signals.prNumber}`);
+    }
+    if (signals.hasConventionalPrefix && signals.conventionalType) {
+        result.push(`conventional:${signals.conventionalType}`);
+    }
+    if (signals.hasDecisionKeywords) {
+        result.push('decision-keywords');
+    }
+    if (signals.createsNewDirectory) {
+        result.push('new-directory');
+    }
+    if (signals.isTagAdjacent) {
+        result.push('tag-adjacent');
+    }
+    if (signals.hasLongMessageBody) {
+        result.push('detailed-message');
+    }
+    return result;
+}
+//# sourceMappingURL=commit-extraction.js.map

package/dist/lib/infrastructure/services/prompts/commit-extraction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-extraction.js","sourceRoot":"","sources":["../../../../../src/lib/infrastructure/services/prompts/commit-extraction.ts"],"names":[],"mappings":"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"}