@code-insights/cli 3.6.0 → 4.0.0

package/server-dist/llm/facet-extraction.js

@@ -0,0 +1,91 @@
+// Facet-only extraction — backfill path for sessions that already have insights.
+// Extracted from analysis.ts to keep each analysis responsibility in its own module.
+import { jsonrepair } from 'jsonrepair';
+import { createLLMClient, isLLMConfigured, loadLLMConfig } from './client.js';
+import { calculateAnalysisCost } from './analysis-pricing.js';
+import { saveAnalysisUsage } from './analysis-usage-db.js';
+import { formatMessagesForAnalysis } from './message-format.js';
+import { extractJsonPayload } from './response-parsers.js';
+import { SHARED_ANALYST_SYSTEM_PROMPT, buildCacheableConversationBlock, buildFacetOnlyInstructions } from './prompts.js';
+import { ANALYSIS_VERSION, saveFacetsToDb, } from './analysis-db.js';
+import { MAX_INPUT_TOKENS, buildSessionMeta } from './analysis-internal.js';
+/**
+ * Extract facets only for a session that already has insights (backfill).
+ * Uses the full conversation transcript for accurate friction attribution.
+ * Falls back to truncation for sessions exceeding token limits.
+ */
+export async function extractFacetsOnly(session, messages, options) {
+    if (!isLLMConfigured()) {
+        return { success: false, error: 'LLM not configured.' };
+    }
+    if (messages.length === 0) {
+        return { success: false, error: 'No messages found.' };
+    }
+    try {
+        const startTime = Date.now();
+        const client = createLLMClient();
+        let formattedMessages = formatMessagesForAnalysis(messages);
+        // Truncate if conversation exceeds token limits (same pattern as PQ analysis)
+        const estimatedTokens = client.estimateTokens(formattedMessages);
+        if (estimatedTokens > MAX_INPUT_TOKENS) {
+            const targetLength = Math.floor((MAX_INPUT_TOKENS / estimatedTokens) * formattedMessages.length * 0.8);
+            formattedMessages = formattedMessages.slice(0, targetLength) + '\n\n[... conversation truncated for analysis ...]';
+        }
+        const sessionMeta = buildSessionMeta(session);
+        const response = await client.chat([
+            { role: 'system', content: SHARED_ANALYST_SYSTEM_PROMPT },
+            { role: 'user', content: [
+                    buildCacheableConversationBlock(formattedMessages),
+                    { type: 'text', text: buildFacetOnlyInstructions(session.project_name, session.summary, sessionMeta) },
+                ] },
+        ], { signal: options?.signal });
+        const jsonPayload = extractJsonPayload(response.content);
+        if (!jsonPayload) {
+            return { success: false, error: 'No JSON in facet response.' };
+        }
+        let facets;
+        try {
+            facets = JSON.parse(jsonPayload);
+        }
+        catch {
+            facets = JSON.parse(jsonrepair(jsonPayload));
+        }
+        if (facets) {
+            saveFacetsToDb(session.id, facets, ANALYSIS_VERSION);
+        }
+        // Record analysis cost to analysis_usage table (V7).
+        const llmConfig = loadLLMConfig();
+        if (llmConfig && response.usage) {
+            const costUsd = calculateAnalysisCost(llmConfig.provider, llmConfig.model, {
+                inputTokens: response.usage.inputTokens,
+                outputTokens: response.usage.outputTokens,
+                cacheCreationTokens: response.usage.cacheCreationTokens,
+                cacheReadTokens: response.usage.cacheReadTokens,
+            });
+            saveAnalysisUsage({
+                session_id: session.id,
+                analysis_type: 'facet',
+                provider: llmConfig.provider,
+                model: llmConfig.model,
+                input_tokens: response.usage.inputTokens,
+                output_tokens: response.usage.outputTokens,
+                cache_creation_tokens: response.usage.cacheCreationTokens,
+                cache_read_tokens: response.usage.cacheReadTokens,
+                estimated_cost_usd: costUsd,
+                duration_ms: Date.now() - startTime,
+                chunk_count: 1,
+            });
+        }
+        return { success: true };
+    }
+    catch (error) {
+        if (error instanceof Error && error.name === 'AbortError') {
+            return { success: false, error: 'Cancelled' };
+        }
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Facet extraction failed',
+        };
+    }
+}
+//# sourceMappingURL=facet-extraction.js.map

package/server-dist/llm/facet-extraction.js.map

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

package/server-dist/llm/friction-normalize.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Normalize a friction category to the closest canonical category.
+ * Returns the original category if no close match is found.
+ *
+ * Matching rules (in order):
+ * 1. Exact match against canonical list → return as-is
+ * 1.5. Explicit alias match → return alias target (may be non-canonical)
+ * 2. Levenshtein distance <= 2 → return canonical match
+ * 3. Substring match (category contains canonical or vice versa) → return canonical
+ * 4. No match → return original (novel category)
+ *
+ * Note: alias targets in FRICTION_ALIASES bypass the canonical check intentionally.
+ * e.g., "agent-orchestration-failure" is not canonical but is a valid cluster target.
+ */
+export declare function normalizeFrictionCategory(category: string): string;
+//# sourceMappingURL=friction-normalize.d.ts.map

package/server-dist/llm/friction-normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction-normalize.d.ts","sourceRoot":"","sources":["../../src/llm/friction-normalize.ts"],"names":[],"mappings":"AAoCA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKlE"}

package/server-dist/llm/friction-normalize.js

@@ -0,0 +1,54 @@
+// Friction category normalization.
+// Clusters similar free-form friction categories to canonical ones during aggregation.
+import { CANONICAL_FRICTION_CATEGORIES } from './prompt-constants.js';
+import { normalizeCategory } from './normalize-utils.js';
+// Explicit alias map for clustering emergent category variants.
+// Targets don't need to be in CANONICAL_FRICTION_CATEGORIES —
+// this clusters semantically-equivalent novel categories together.
+// Insert alias lookup runs AFTER exact canonical match but BEFORE Levenshtein,
+// so well-known emergent variants are clustered deterministically.
+const FRICTION_ALIASES = {
+    // legacy canonical → new canonical (15→9 taxonomy revision)
+    'missing-dependency': 'stale-assumptions',
+    'config-drift': 'stale-assumptions',
+    'stale-cache': 'stale-assumptions',
+    'version-mismatch': 'stale-assumptions',
+    'permission-issue': 'stale-assumptions',
+    'environment-mismatch': 'stale-assumptions',
+    'race-condition': 'wrong-approach',
+    'circular-dependency': 'wrong-approach',
+    'test-failure': 'wrong-approach',
+    'type-error': 'knowledge-gap',
+    'api-misunderstanding': 'knowledge-gap',
+    // agent orchestration variants → cluster under one emergent name
+    'agent-lifecycle-issue': 'agent-orchestration-failure',
+    'agent-communication-failure': 'agent-orchestration-failure',
+    'agent-communication-breakdown': 'agent-orchestration-failure',
+    'agent-lifecycle-management': 'agent-orchestration-failure',
+    'agent-shutdown-failure': 'agent-orchestration-failure',
+    // rate limit variants → cluster under one emergent name
+    'api-rate-limit': 'rate-limit-hit',
+    'rate-limiting': 'rate-limit-hit',
+    'rate-limited': 'rate-limit-hit',
+};
+/**
+ * Normalize a friction category to the closest canonical category.
+ * Returns the original category if no close match is found.
+ *
+ * Matching rules (in order):
+ * 1. Exact match against canonical list → return as-is
+ * 1.5. Explicit alias match → return alias target (may be non-canonical)
+ * 2. Levenshtein distance <= 2 → return canonical match
+ * 3. Substring match (category contains canonical or vice versa) → return canonical
+ * 4. No match → return original (novel category)
+ *
+ * Note: alias targets in FRICTION_ALIASES bypass the canonical check intentionally.
+ * e.g., "agent-orchestration-failure" is not canonical but is a valid cluster target.
+ */
+export function normalizeFrictionCategory(category) {
+    return normalizeCategory(category, {
+        canonicalCategories: CANONICAL_FRICTION_CATEGORIES,
+        aliases: FRICTION_ALIASES,
+    });
+}
+//# sourceMappingURL=friction-normalize.js.map

package/server-dist/llm/friction-normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction-normalize.js","sourceRoot":"","sources":["../../src/llm/friction-normalize.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,uFAAuF;AAEvF,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,gEAAgE;AAChE,8DAA8D;AAC9D,mEAAmE;AACnE,+EAA+E;AAC/E,mEAAmE;AACnE,MAAM,gBAAgB,GAA2B;IAC/C,4DAA4D;IAC5D,oBAAoB,EAAE,mBAAmB;IACzC,cAAc,EAAE,mBAAmB;IACnC,aAAa,EAAE,mBAAmB;IAClC,kBAAkB,EAAE,mBAAmB;IACvC,kBAAkB,EAAE,mBAAmB;IACvC,sBAAsB,EAAE,mBAAmB;IAC3C,gBAAgB,EAAE,gBAAgB;IAClC,qBAAqB,EAAE,gBAAgB;IACvC,cAAc,EAAE,gBAAgB;IAChC,YAAY,EAAE,eAAe;IAC7B,sBAAsB,EAAE,eAAe;IACvC,iEAAiE;IACjE,uBAAuB,EAAE,6BAA6B;IACtD,6BAA6B,EAAE,6BAA6B;IAC5D,+BAA+B,EAAE,6BAA6B;IAC9D,4BAA4B,EAAE,6BAA6B;IAC3D,wBAAwB,EAAE,6BAA6B;IACvD,wDAAwD;IACxD,gBAAgB,EAAE,gBAAgB;IAClC,eAAe,EAAE,gBAAgB;IACjC,cAAc,EAAE,gBAAgB;CACjC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,OAAO,iBAAiB,CAAC,QAAQ,EAAE;QACjC,mBAAmB,EAAE,6BAA6B;QAClD,OAAO,EAAE,gBAAgB;KAC1B,CAAC,CAAC;AACL,CAAC"}

package/server-dist/llm/index.d.ts

@@ -1,7 +1,8 @@
 export type { LLMClient, LLMMessage, LLMResponse, ChatOptions } from './types.js';
 export type { LLMProvider, LLMProviderConfig } from './types.js';
 export { createLLMClient, createClientFromConfig, loadLLMConfig, isLLMConfigured, testLLMConfig } from './client.js';
-export { analyzeSession, analyzePromptQuality, findRecurringInsights } from './analysis.js';
-export type { AnalysisResult, InsightRow, SessionData, RecurringInsightResult } from './analysis.js';
+export { analyzeSession, analyzePromptQuality, findRecurringInsights, extractFacetsOnly } from './analysis.js';
+export type { AnalysisResult, RecurringInsightResult } from './analysis.js';
+export type { InsightRow, SessionData } from './analysis-db.js';
 export { discoverOllamaModels } from './providers/ollama.js';
 //# sourceMappingURL=index.d.ts.map

package/server-dist/llm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAClF,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC5F,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAClF,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC/G,YAAY,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5E,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}

package/server-dist/llm/index.js

@@ -1,5 +1,5 @@
 // Public API for the server-side LLM engine.
 export { createLLMClient, createClientFromConfig, loadLLMConfig, isLLMConfigured, testLLMConfig } from './client.js';
-export { analyzeSession, analyzePromptQuality, findRecurringInsights } from './analysis.js';
+export { analyzeSession, analyzePromptQuality, findRecurringInsights, extractFacetsOnly } from './analysis.js';
 export { discoverOllamaModels } from './providers/ollama.js';
 //# sourceMappingURL=index.js.map

package/server-dist/llm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAI7C,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAE5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAI7C,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAG/G,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}

package/server-dist/llm/message-format.d.ts

@@ -0,0 +1,32 @@
+import type { SQLiteMessageRow, SessionMetadata } from './prompt-types.js';
+/**
+ * Detect the class of a stored user message from its content string.
+ * Operates on the DB content field (stringified), not raw JSONL.
+ *
+ * This mirrors classifyUserMessage() in cli/src/parser/jsonl.ts but works on
+ * stored content strings instead of parsed JSONL message objects. The DB stores
+ * message content as a plain string — tool-results are JSON arrays stringified,
+ * human text is stored as-is.
+ *
+ * Order matters — most specific checks first.
+ */
+export declare function classifyStoredUserMessage(content: string): 'human' | 'tool-result' | 'system-artifact';
+/**
+ * Format SQLite message rows for LLM consumption.
+ * Handles snake_case fields and JSON-encoded tool_calls/tool_results.
+ *
+ * User#N indices only increment for genuine human messages. Tool-results and
+ * system artifacts (auto-compacts, slash commands) receive bracketed labels
+ * instead. This ensures User#N references in PQ takeaways and evidence fields
+ * align with actual human turns, not inflated by tool-result rows.
+ */
+export declare function formatMessagesForAnalysis(messages: SQLiteMessageRow[]): string;
+/**
+ * Format a one-line context signals header from V6 session metadata.
+ * Returns empty string when no signals are present (pre-V6 sessions with NULL columns).
+ *
+ * Example output:
+ *   "Context signals: 3 context compactions (2 auto, 1 manual) — session exceeded context window; slash commands used: /review, /test\n"
+ */
+export declare function formatSessionMetaLine(meta?: SessionMetadata): string;
+//# sourceMappingURL=message-format.d.ts.map

package/server-dist/llm/message-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-format.d.ts","sourceRoot":"","sources":["../../src/llm/message-format.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAW3E;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,iBAAiB,CAiBtG;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,MAAM,CA6D9E;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,MAAM,CAkBpE"}

package/server-dist/llm/message-format.js

@@ -0,0 +1,129 @@
+// SQLite message formatting utilities for LLM prompt construction.
+// Extracted from prompts.ts — used by prompt generator functions in prompts.ts.
+/**
+ * Detect the class of a stored user message from its content string.
+ * Operates on the DB content field (stringified), not raw JSONL.
+ *
+ * This mirrors classifyUserMessage() in cli/src/parser/jsonl.ts but works on
+ * stored content strings instead of parsed JSONL message objects. The DB stores
+ * message content as a plain string — tool-results are JSON arrays stringified,
+ * human text is stored as-is.
+ *
+ * Order matters — most specific checks first.
+ */
+export function classifyStoredUserMessage(content) {
+    // Tool-result: content is a JSON array containing tool_result blocks.
+    // The DB stores these as stringified JSON arrays starting with '['.
+    if (content.startsWith('[') && content.includes('"tool_result"'))
+        return 'tool-result';
+    // Auto-compact summary: Claude Code uses two known prefixes for LLM-initiated
+    // context compaction summaries. Both must be checked.
+    if (content.startsWith('Here is a summary of our conversation'))
+        return 'system-artifact';
+    if (content.startsWith('This session is being continued'))
+        return 'system-artifact';
+    // Slash command or skill load: single-line starting with / followed by a lowercase letter.
+    // Requires content.trim() to be short (≤2 lines) to avoid false-positives on messages
+    // containing file paths like "/usr/bin/..." as part of a longer instruction.
+    const trimmed = content.trim();
+    if (/^\/[a-z]/.test(trimmed) && trimmed.split('\n').length <= 2)
+        return 'system-artifact';
+    return 'human';
+}
+/**
+ * Format SQLite message rows for LLM consumption.
+ * Handles snake_case fields and JSON-encoded tool_calls/tool_results.
+ *
+ * User#N indices only increment for genuine human messages. Tool-results and
+ * system artifacts (auto-compacts, slash commands) receive bracketed labels
+ * instead. This ensures User#N references in PQ takeaways and evidence fields
+ * align with actual human turns, not inflated by tool-result rows.
+ */
+export function formatMessagesForAnalysis(messages) {
+    let userIndex = 0;
+    let assistantIndex = 0;
+    return messages
+        .map((m) => {
+        let roleLabel;
+        if (m.type === 'user') {
+            const msgClass = classifyStoredUserMessage(m.content);
+            if (msgClass === 'tool-result') {
+                roleLabel = '[tool-result]';
+            }
+            else if (msgClass === 'system-artifact') {
+                // Auto-compact summaries use two known prefixes — everything else (slash commands,
+                // skill loads) is a generic system artifact, not a compaction event.
+                const isAutoCompact = m.content.startsWith('Here is a summary of our conversation')
+                    || m.content.startsWith('This session is being continued');
+                roleLabel = isAutoCompact ? '[auto-compact]' : '[system]';
+            }
+            else {
+                // Genuine human message — increment counter
+                roleLabel = `User#${userIndex++}`;
+            }
+        }
+        else if (m.type === 'assistant') {
+            roleLabel = `Assistant#${assistantIndex++}`;
+        }
+        else {
+            roleLabel = 'System';
+        }
+        // Parse JSON-encoded tool_calls
+        let toolCalls = [];
+        try {
+            toolCalls = m.tool_calls ? JSON.parse(m.tool_calls) : [];
+        }
+        catch {
+            toolCalls = [];
+        }
+        // Parse JSON-encoded tool_results
+        let toolResults = [];
+        try {
+            toolResults = m.tool_results ? JSON.parse(m.tool_results) : [];
+        }
+        catch {
+            toolResults = [];
+        }
+        const toolInfo = toolCalls.length > 0
+            ? `\n[Tools used: ${toolCalls.map(t => t.name || 'unknown').join(', ')}]`
+            : '';
+        // Include thinking content — capped at 1000 chars to stay within token budget
+        const thinkingInfo = m.thinking
+            ? `\n[Thinking: ${m.thinking.slice(0, 1000)}]`
+            : '';
+        // Include tool results for context — 500 chars per result (error messages need ~300-400 chars)
+        const resultInfo = toolResults.length > 0
+            ? `\n[Tool results: ${toolResults.map(r => (r.output || '').slice(0, 500)).join(' | ')}]`
+            : '';
+        return `### ${roleLabel}:\n${m.content}${thinkingInfo}${toolInfo}${resultInfo}`;
+    })
+        .join('\n\n');
+}
+/**
+ * Format a one-line context signals header from V6 session metadata.
+ * Returns empty string when no signals are present (pre-V6 sessions with NULL columns).
+ *
+ * Example output:
+ *   "Context signals: 3 context compactions (2 auto, 1 manual) — session exceeded context window; slash commands used: /review, /test\n"
+ */
+export function formatSessionMetaLine(meta) {
+    if (!meta)
+        return '';
+    const parts = [];
+    const totalCompacts = (meta.compactCount ?? 0) + (meta.autoCompactCount ?? 0);
+    if (totalCompacts > 0) {
+        const breakdown = [];
+        if (meta.autoCompactCount)
+            breakdown.push(`${meta.autoCompactCount} auto`);
+        if (meta.compactCount)
+            breakdown.push(`${meta.compactCount} manual`);
+        parts.push(`${totalCompacts} context compaction${totalCompacts > 1 ? 's' : ''} (${breakdown.join(', ')}) — session exceeded context window`);
+    }
+    if (meta.slashCommands?.length) {
+        parts.push(`slash commands used: ${meta.slashCommands.join(', ')}`);
+    }
+    if (parts.length === 0)
+        return '';
+    return `Context signals: ${parts.join('; ')}\n`;
+}
+//# sourceMappingURL=message-format.js.map

package/server-dist/llm/message-format.js.map

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

package/server-dist/llm/normalize-utils.d.ts

@@ -0,0 +1,22 @@
+/** Standard Levenshtein distance between two strings */
+export declare function levenshtein(a: string, b: string): number;
+export interface NormalizerConfig {
+    /** Canonical category strings (lowercase kebab-case) */
+    canonicalCategories: readonly string[];
+    /** Maps known aliases to their target (may be non-canonical cluster targets) */
+    aliases: Record<string, string>;
+}
+/**
+ * Generic category normalizer. Matching rules (in order):
+ * 1. Exact match against canonical list → return as-is
+ * 1.5. Explicit alias match → return alias target (may be non-canonical)
+ * 2. Levenshtein distance <= 2 → return canonical match
+ * 3. Substring match (shorter >= 5 chars, >= 50% of longer) → return canonical
+ * 4. No match → return original (novel category)
+ */
+export declare function normalizeCategory(category: string, config: NormalizerConfig): string;
+/**
+ * Convert kebab-case to Title Case. Shared fallback for category label functions.
+ */
+export declare function kebabToTitleCase(kebab: string): string;
+//# sourceMappingURL=normalize-utils.d.ts.map

package/server-dist/llm/normalize-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-utils.d.ts","sourceRoot":"","sources":["../../src/llm/normalize-utils.ts"],"names":[],"mappings":"AAGA,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAoBxD;AAED,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAmCpF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKtD"}

package/server-dist/llm/normalize-utils.js

@@ -0,0 +1,71 @@
+// Shared normalization infrastructure for friction, pattern, and prompt-quality categories.
+// Each domain provides its own canonical list, alias map, and label map.
+/** Standard Levenshtein distance between two strings */
+export function levenshtein(a, b) {
+    const m = a.length;
+    const n = b.length;
+    const dp = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0));
+    for (let i = 0; i <= m; i++)
+        dp[i][0] = i;
+    for (let j = 0; j <= n; j++)
+        dp[0][j] = j;
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+        }
+    }
+    return dp[m][n];
+}
+/**
+ * Generic category normalizer. Matching rules (in order):
+ * 1. Exact match against canonical list → return as-is
+ * 1.5. Explicit alias match → return alias target (may be non-canonical)
+ * 2. Levenshtein distance <= 2 → return canonical match
+ * 3. Substring match (shorter >= 5 chars, >= 50% of longer) → return canonical
+ * 4. No match → return original (novel category)
+ */
+export function normalizeCategory(category, config) {
+    const lower = category.toLowerCase();
+    // 1. Exact match
+    for (const canonical of config.canonicalCategories) {
+        if (lower === canonical)
+            return canonical;
+    }
+    // 1.5. Explicit alias match
+    if (config.aliases[lower])
+        return config.aliases[lower];
+    // 2. Levenshtein distance <= 2
+    let bestMatch = null;
+    let bestDistance = Infinity;
+    for (const canonical of config.canonicalCategories) {
+        const dist = levenshtein(lower, canonical);
+        if (dist <= 2 && dist < bestDistance) {
+            bestDistance = dist;
+            bestMatch = canonical;
+        }
+    }
+    if (bestMatch)
+        return bestMatch;
+    // 3. Substring match — only if the shorter string is a significant portion of the longer
+    // to avoid false positives like "type" matching "type-error"
+    for (const canonical of config.canonicalCategories) {
+        const shorter = lower.length < canonical.length ? lower : canonical;
+        const longer = lower.length < canonical.length ? canonical : lower;
+        if (shorter.length >= 5 && shorter.length / longer.length >= 0.5 && longer.includes(shorter)) {
+            return canonical;
+        }
+    }
+    // 4. No match — novel category
+    return category;
+}
+/**
+ * Convert kebab-case to Title Case. Shared fallback for category label functions.
+ */
+export function kebabToTitleCase(kebab) {
+    return kebab
+        .split('-')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+//# sourceMappingURL=normalize-utils.js.map

package/server-dist/llm/normalize-utils.js.map

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

package/server-dist/llm/pattern-normalize.d.ts

@@ -0,0 +1,19 @@
+export declare const PATTERN_CATEGORY_LABELS: Record<string, string>;
+/**
+ * Normalize a pattern category to the closest canonical category.
+ * Returns the original category if no close match is found.
+ *
+ * Matching rules (in order):
+ * 1. Exact match against canonical list → return as-is
+ * 1.5. Explicit alias match → return alias target (may be non-canonical)
+ * 2. Levenshtein distance <= 2 → return canonical match
+ * 3. Substring match (category contains canonical or vice versa) → return canonical
+ * 4. No match → return original (novel category)
+ */
+export declare function normalizePatternCategory(category: string): string;
+/**
+ * Get a human-readable label for a pattern category.
+ * Falls back to Title Case conversion for novel categories.
+ */
+export declare function getPatternCategoryLabel(category: string): string;
+//# sourceMappingURL=pattern-normalize.d.ts.map

package/server-dist/llm/pattern-normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-normalize.d.ts","sourceRoot":"","sources":["../../src/llm/pattern-normalize.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAS1D,CAAC;AA0DF;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKjE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/server-dist/llm/pattern-normalize.js

@@ -0,0 +1,90 @@
+// Effective pattern category normalization.
+// Clusters similar free-form pattern categories to canonical ones during aggregation.
+// Delegates to normalize-utils.ts for the shared levenshtein/normalizeCategory algorithm.
+import { CANONICAL_PATTERN_CATEGORIES } from './prompt-constants.js';
+import { normalizeCategory, kebabToTitleCase } from './normalize-utils.js';
+// Human-readable labels for each canonical category.
+// Used in dashboard display (e.g., "structured-planning" → "Structured Planning").
+export const PATTERN_CATEGORY_LABELS = {
+    'structured-planning': 'Structured Planning',
+    'incremental-implementation': 'Incremental Implementation',
+    'verification-workflow': 'Verification Workflow',
+    'systematic-debugging': 'Systematic Debugging',
+    'self-correction': 'Self-Correction',
+    'context-gathering': 'Context Gathering',
+    'domain-expertise': 'Domain Expertise',
+    'effective-tooling': 'Effective Tooling',
+};
+// Explicit alias map for clustering emergent category variants.
+// Targets don't need to be in CANONICAL_PATTERN_CATEGORIES —
+// this clusters semantically-equivalent novel categories together.
+// Insert alias lookup runs AFTER exact canonical match but BEFORE Levenshtein,
+// so well-known emergent variants are clustered deterministically.
+const PATTERN_ALIASES = {
+    // structured-planning variants
+    'task-decomposition': 'structured-planning',
+    'plan-first': 'structured-planning',
+    'upfront-planning': 'structured-planning',
+    'phased-approach': 'structured-planning',
+    'task-breakdown': 'structured-planning',
+    'planning-before-implementation': 'structured-planning',
+    // effective-tooling variants
+    'agent-delegation': 'effective-tooling',
+    'agent-orchestration': 'effective-tooling',
+    'specialized-agents': 'effective-tooling',
+    'multi-agent': 'effective-tooling',
+    'tool-leverage': 'effective-tooling',
+    // verification-workflow variants
+    'build-test-verify': 'verification-workflow',
+    'test-driven-development': 'verification-workflow',
+    'tdd': 'verification-workflow',
+    'test-first': 'verification-workflow',
+    'pre-commit-checks': 'verification-workflow',
+    // systematic-debugging variants
+    'binary-search-debugging': 'systematic-debugging',
+    'methodical-debugging': 'systematic-debugging',
+    'log-based-debugging': 'systematic-debugging',
+    'debugging-methodology': 'systematic-debugging',
+    // self-correction variants
+    'course-correction': 'self-correction',
+    'pivot-on-failure': 'self-correction',
+    'backtracking': 'self-correction',
+    // context-gathering variants
+    'code-reading-first': 'context-gathering',
+    'codebase-exploration': 'context-gathering',
+    'understanding-before-changing': 'context-gathering',
+    // domain-expertise variants
+    'framework-knowledge': 'domain-expertise',
+    'types-first': 'domain-expertise',
+    'type-driven-development': 'domain-expertise',
+    'schema-first': 'domain-expertise',
+    // incremental-implementation variants
+    'small-steps': 'incremental-implementation',
+    'iterative-building': 'incremental-implementation',
+    'iterative-development': 'incremental-implementation',
+};
+/**
+ * Normalize a pattern category to the closest canonical category.
+ * Returns the original category if no close match is found.
+ *
+ * Matching rules (in order):
+ * 1. Exact match against canonical list → return as-is
+ * 1.5. Explicit alias match → return alias target (may be non-canonical)
+ * 2. Levenshtein distance <= 2 → return canonical match
+ * 3. Substring match (category contains canonical or vice versa) → return canonical
+ * 4. No match → return original (novel category)
+ */
+export function normalizePatternCategory(category) {
+    return normalizeCategory(category, {
+        canonicalCategories: CANONICAL_PATTERN_CATEGORIES,
+        aliases: PATTERN_ALIASES,
+    });
+}
+/**
+ * Get a human-readable label for a pattern category.
+ * Falls back to Title Case conversion for novel categories.
+ */
+export function getPatternCategoryLabel(category) {
+    return PATTERN_CATEGORY_LABELS[category] ?? kebabToTitleCase(category);
+}
+//# sourceMappingURL=pattern-normalize.js.map

package/server-dist/llm/pattern-normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-normalize.js","sourceRoot":"","sources":["../../src/llm/pattern-normalize.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sFAAsF;AACtF,0FAA0F;AAE1F,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE3E,qDAAqD;AACrD,mFAAmF;AACnF,MAAM,CAAC,MAAM,uBAAuB,GAA2B;IAC7D,qBAAqB,EAAE,qBAAqB;IAC5C,4BAA4B,EAAE,4BAA4B;IAC1D,uBAAuB,EAAE,uBAAuB;IAChD,sBAAsB,EAAE,sBAAsB;IAC9C,iBAAiB,EAAE,iBAAiB;IACpC,mBAAmB,EAAE,mBAAmB;IACxC,kBAAkB,EAAE,kBAAkB;IACtC,mBAAmB,EAAE,mBAAmB;CACzC,CAAC;AAEF,gEAAgE;AAChE,6DAA6D;AAC7D,mEAAmE;AACnE,+EAA+E;AAC/E,mEAAmE;AACnE,MAAM,eAAe,GAA2B;IAC9C,+BAA+B;IAC/B,oBAAoB,EAAE,qBAAqB;IAC3C,YAAY,EAAE,qBAAqB;IACnC,kBAAkB,EAAE,qBAAqB;IACzC,iBAAiB,EAAE,qBAAqB;IACxC,gBAAgB,EAAE,qBAAqB;IACvC,gCAAgC,EAAE,qBAAqB;IAEvD,6BAA6B;IAC7B,kBAAkB,EAAE,mBAAmB;IACvC,qBAAqB,EAAE,mBAAmB;IAC1C,oBAAoB,EAAE,mBAAmB;IACzC,aAAa,EAAE,mBAAmB;IAClC,eAAe,EAAE,mBAAmB;IAEpC,iCAAiC;IACjC,mBAAmB,EAAE,uBAAuB;IAC5C,yBAAyB,EAAE,uBAAuB;IAClD,KAAK,EAAE,uBAAuB;IAC9B,YAAY,EAAE,uBAAuB;IACrC,mBAAmB,EAAE,uBAAuB;IAE5C,gCAAgC;IAChC,yBAAyB,EAAE,sBAAsB;IACjD,sBAAsB,EAAE,sBAAsB;IAC9C,qBAAqB,EAAE,sBAAsB;IAC7C,uBAAuB,EAAE,sBAAsB;IAE/C,2BAA2B;IAC3B,mBAAmB,EAAE,iBAAiB;IACtC,kBAAkB,EAAE,iBAAiB;IACrC,cAAc,EAAE,iBAAiB;IAEjC,6BAA6B;IAC7B,oBAAoB,EAAE,mBAAmB;IACzC,sBAAsB,EAAE,mBAAmB;IAC3C,+BAA+B,EAAE,mBAAmB;IAEpD,4BAA4B;IAC5B,qBAAqB,EAAE,kBAAkB;IACzC,aAAa,EAAE,kBAAkB;IACjC,yBAAyB,EAAE,kBAAkB;IAC7C,cAAc,EAAE,kBAAkB;IAElC,sCAAsC;IACtC,aAAa,EAAE,4BAA4B;IAC3C,oBAAoB,EAAE,4BAA4B;IAClD,uBAAuB,EAAE,4BAA4B;CACtD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,OAAO,iBAAiB,CAAC,QAAQ,EAAE;QACjC,mBAAmB,EAAE,4BAA4B;QACjD,OAAO,EAAE,eAAe;KACzB,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,OAAO,uBAAuB,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AACzE,CAAC"}