@zbigniewsobiecki/squint 1.0.0

package/dist/commands/llm/_shared/flow-csv.js

@@ -0,0 +1,198 @@
+/**
+ * CSV parser for LLM-generated flow output.
+ *
+ * Handles two output formats:
+ * 1. Entry point classification (Phase 1)
+ * 2. Flow construction with sub-flow references (Phase 2)
+ */
+import { extractCsvContent, parseCsvWithMapper, parseRow, safeParseInt, splitCsvLines } from './csv-utils.js';
+/**
+ * Parse entry point classification output.
+ * Expected format: type,id,classification,confidence,reason
+ */
+export function parseEntryPointClassification(content) {
+    const { items, errors } = parseCsvWithMapper(content, {
+        minColumns: 5,
+        rowMapper: (cols, lineNum, errs) => {
+            const [type, idStr, classification, confidence, reason] = cols;
+            if (type !== 'entry')
+                return null; // Skip non-entry rows
+            const id = safeParseInt(idStr, 'ID', lineNum, errs);
+            if (id === null)
+                return null;
+            if (!isValidClassification(classification)) {
+                errs.push(`Line ${lineNum}: Invalid classification "${classification}"`);
+                return null;
+            }
+            if (!isValidConfidence(confidence)) {
+                errs.push(`Line ${lineNum}: Invalid confidence "${confidence}"`);
+                return null;
+            }
+            return { id, classification, confidence, reason };
+        },
+    });
+    return { entries: items, errors };
+}
+function isValidClassification(s) {
+    return s === 'top_level' || s === 'subflow_candidate' || s === 'internal';
+}
+function isValidConfidence(s) {
+    return s === 'high' || s === 'medium' || s === 'low';
+}
+/**
+ * Parse flow construction output.
+ * Expected format:
+ * ```csv
+ * type,flow_id,field,value
+ * flow,1,name,"UserRegistration"
+ * flow,1,description,"Handles new user signup"
+ * flow,1,domain,"auth"
+ * flow,1,is_composite,"true"
+ * step,1,1,42
+ * step,1,2,subflow:ValidateUser
+ * step,1,3,89
+ * subflow_reason,1,2,"Delegates input validation to reusable validation flow"
+ * ```
+ */
+export function parseFlowConstruction(content) {
+    const errors = [];
+    const flowsMap = new Map();
+    const csv = extractCsvContent(content);
+    const lines = splitCsvLines(csv);
+    if (lines.length === 0) {
+        errors.push('Empty CSV content');
+        return { flows: [], errors };
+    }
+    // Validate header
+    const header = parseRow(lines[0]);
+    if (!header || header.length < 4) {
+        errors.push(`Invalid header: expected "type,flow_id,field,value", got "${lines[0]}"`);
+        return { flows: [], errors };
+    }
+    // Parse data rows
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (!line)
+            continue;
+        const parsed = parseRow(line);
+        if (!parsed || parsed.length < 4) {
+            errors.push(`Line ${i + 1}: Invalid row format`);
+            continue;
+        }
+        const [type, flowIdStr, field, value] = parsed;
+        const flowId = safeParseInt(flowIdStr, 'flow_id', i + 1, errors);
+        if (flowId === null)
+            continue;
+        // Ensure flow exists in map
+        if (!flowsMap.has(flowId)) {
+            flowsMap.set(flowId, {
+                id: flowId,
+                name: '',
+                description: '',
+                domain: null,
+                isComposite: false,
+                steps: [],
+                subflowReasons: new Map(),
+            });
+        }
+        const flow = flowsMap.get(flowId);
+        switch (type) {
+            case 'flow':
+                switch (field) {
+                    case 'name':
+                        flow.name = value.trim();
+                        break;
+                    case 'description':
+                        flow.description = value.trim();
+                        break;
+                    case 'domain':
+                        flow.domain = value.trim() || null;
+                        break;
+                    case 'is_composite':
+                        flow.isComposite = value.trim().toLowerCase() === 'true';
+                        break;
+                    default:
+                        errors.push(`Line ${i + 1}: Unknown flow field "${field}"`);
+                }
+                break;
+            case 'step': {
+                const stepOrder = safeParseInt(field, 'step order', i + 1, errors);
+                if (stepOrder === null)
+                    continue;
+                const stepValue = value.trim();
+                if (stepValue.startsWith('subflow:')) {
+                    const flowName = stepValue.slice(8).trim();
+                    flow.steps.push({
+                        type: 'subflow',
+                        order: stepOrder,
+                        flowName,
+                    });
+                    flow.isComposite = true;
+                }
+                else {
+                    const defId = safeParseInt(stepValue, 'step definition ID', i + 1, errors);
+                    if (defId === null)
+                        continue;
+                    flow.steps.push({
+                        type: 'definition',
+                        order: stepOrder,
+                        id: defId,
+                    });
+                }
+                break;
+            }
+            case 'subflow_reason': {
+                const stepOrder = safeParseInt(field, 'step order for subflow_reason', i + 1, errors);
+                if (stepOrder === null)
+                    continue;
+                flow.subflowReasons.set(stepOrder, value.trim());
+                break;
+            }
+            default:
+                errors.push(`Line ${i + 1}: Unknown row type "${type}"`);
+        }
+    }
+    // Sort steps by order for each flow
+    for (const flow of flowsMap.values()) {
+        flow.steps.sort((a, b) => a.order - b.order);
+    }
+    return {
+        flows: Array.from(flowsMap.values()).filter((f) => f.name !== ''),
+        errors,
+    };
+}
+/**
+ * Parse gap filling suggestions.
+ * Expected format: type,symbol_id,target_flow_id,reason
+ */
+export function parseGapFillSuggestions(content) {
+    const { items, errors } = parseCsvWithMapper(content, {
+        minColumns: 4,
+        rowMapper: (cols, lineNum, errs) => {
+            const [type, symbolIdStr, targetFlowIdStr, reason] = cols;
+            if (!isValidGapFillType(type)) {
+                errs.push(`Line ${lineNum}: Invalid suggestion type "${type}"`);
+                return null;
+            }
+            const symbolId = safeParseInt(symbolIdStr, 'symbol_id', lineNum, errs);
+            if (symbolId === null)
+                return null;
+            const targetFlowId = targetFlowIdStr ? Number.parseInt(targetFlowIdStr, 10) : undefined;
+            if (type === 'add_to_existing' && (targetFlowId === undefined || Number.isNaN(targetFlowId))) {
+                errs.push(`Line ${lineNum}: add_to_existing requires valid target_flow_id`);
+                return null;
+            }
+            return {
+                type,
+                symbolId,
+                targetFlowId: targetFlowId && !Number.isNaN(targetFlowId) ? targetFlowId : undefined,
+                reason,
+            };
+        },
+    });
+    return { suggestions: items, errors };
+}
+function isValidGapFillType(s) {
+    return s === 'new_flow' || s === 'add_to_existing' || s === 'new_subflow';
+}
+//# sourceMappingURL=flow-csv.js.map

package/dist/commands/llm/_shared/flow-csv.js.map

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

package/dist/commands/llm/_shared/flow-prompts.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Prompt templates for LLM-driven hierarchical flow detection.
+ */
+import type { AnnotatedEdgeInfo, AnnotatedSymbolInfo, FlowCoverageStats } from '../../../db/schema.js';
+export declare function buildEntryPointSystemPrompt(): string;
+export interface EntryPointCandidate {
+    id: number;
+    name: string;
+    kind: string;
+    filePath: string;
+    incomingDeps: number;
+    outgoingDeps: number;
+    purpose: string | null;
+    domain: string[] | null;
+    role: string | null;
+}
+export declare function buildEntryPointUserPrompt(candidates: EntryPointCandidate[]): string;
+export declare function buildFlowConstructionSystemPrompt(): string;
+export interface FlowConstructionContext {
+    entryPoint: AnnotatedSymbolInfo;
+    neighborhood: {
+        nodes: AnnotatedSymbolInfo[];
+        edges: AnnotatedEdgeInfo[];
+    };
+    existingFlows: Array<{
+        id: number;
+        name: string;
+        description: string | null;
+        entryPointId: number;
+    }>;
+    existingSubflows: string[];
+}
+export declare function buildFlowConstructionUserPrompt(contexts: FlowConstructionContext[]): string;
+export declare function buildGapFillingSystemPrompt(): string;
+export interface GapFillingContext {
+    uncoveredSymbols: Array<{
+        id: number;
+        name: string;
+        kind: string;
+        filePath: string;
+        purpose: string | null;
+        domain: string[] | null;
+        role: string | null;
+        incomingDeps: number;
+        outgoingDeps: number;
+    }>;
+    existingFlows: Array<{
+        id: number;
+        name: string;
+        description: string | null;
+        stepCount: number;
+    }>;
+    coverageStats: {
+        covered: number;
+        total: number;
+        percentage: number;
+    };
+}
+export declare function buildGapFillingUserPrompt(context: GapFillingContext): string;
+export declare function formatCoverageStats(stats: FlowCoverageStats): string;
+//# sourceMappingURL=flow-prompts.d.ts.map

package/dist/commands/llm/_shared/flow-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-prompts.d.ts","sourceRoot":"","sources":["../../../../src/commands/llm/_shared/flow-prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAMvG,wBAAgB,2BAA2B,IAAI,MAAM,CA6CpD;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,mBAAmB,EAAE,GAAG,MAAM,CA0BnF;AAMD,wBAAgB,iCAAiC,IAAI,MAAM,CA4D1D;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,mBAAmB,CAAC;IAChC,YAAY,EAAE;QACZ,KAAK,EAAE,mBAAmB,EAAE,CAAC;QAC7B,KAAK,EAAE,iBAAiB,EAAE,CAAC;KAC5B,CAAC;IACF,aAAa,EAAE,KAAK,CAAC;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,uBAAuB,EAAE,GAAG,MAAM,CAiE3F;AAMD,wBAAgB,2BAA2B,IAAI,MAAM,CAwCpD;AAED,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,EAAE,KAAK,CAAC;QACtB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;IACH,aAAa,EAAE,KAAK,CAAC;QACnB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,aAAa,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAuC5E;AAMD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CASpE"}

package/dist/commands/llm/_shared/flow-prompts.js

@@ -0,0 +1,281 @@
+/**
+ * Prompt templates for LLM-driven hierarchical flow detection.
+ */
+// ============================================
+// Phase 1: Entry Point Classification
+// ============================================
+export function buildEntryPointSystemPrompt() {
+    return `You are a software architect analyzing entry points in a codebase.
+
+## Your Task
+Classify each candidate entry point into one of three categories:
+1. **top_level**: Entry points for top-level execution flows (HTTP handlers, CLI commands, event handlers)
+2. **subflow_candidate**: Reusable logic that appears to be called by multiple entry points (validation, common operations)
+3. **internal**: Internal implementation details, not suitable as flow entry points
+
+## Output Format
+Respond with **only** a CSV table:
+
+\`\`\`csv
+type,id,classification,confidence,reason
+entry,42,top_level,high,"HTTP controller handling POST /users"
+entry,87,subflow_candidate,medium,"Validation logic called by multiple controllers"
+entry,15,internal,high,"Private helper function"
+\`\`\`
+
+## Classification Guidelines
+
+**top_level indicators:**
+- Controllers, handlers, or routes receiving external requests
+- CLI command entry points
+- Event handlers processing external events
+- Symbols with role=controller metadata
+- Names containing "Controller", "Handler", "Route"
+- Exported from routes/controllers/handlers directories
+
+**subflow_candidate indicators:**
+- High incoming dependency count (called by many)
+- Names suggesting reusable operations: "validate", "process", "transform"
+- Pure business logic without direct external interface
+- Appears in multiple execution paths
+
+**internal indicators:**
+- Private or unexported helpers
+- Low connectivity (few callers)
+- Utility functions with generic names
+- Implementation details not representing business operations
+
+## Confidence Levels
+- **high**: Clear indicators match the classification
+- **medium**: Some indicators present, but not definitive
+- **low**: Classification based on heuristics, may need review`;
+}
+export function buildEntryPointUserPrompt(candidates) {
+    const parts = [];
+    parts.push(`## Entry Point Candidates (${candidates.length})`);
+    parts.push('');
+    for (const c of candidates) {
+        parts.push(`### #${c.id}: ${c.name} (${c.kind})`);
+        parts.push(`File: ${c.filePath}`);
+        parts.push(`Connectivity: ${c.incomingDeps} incoming, ${c.outgoingDeps} outgoing`);
+        if (c.purpose) {
+            parts.push(`Purpose: "${c.purpose}"`);
+        }
+        if (c.domain && c.domain.length > 0) {
+            parts.push(`Domains: ${c.domain.join(', ')}`);
+        }
+        if (c.role) {
+            parts.push(`Role: ${c.role}`);
+        }
+        parts.push('');
+    }
+    parts.push('Classify each entry point in CSV format.');
+    return parts.join('\n');
+}
+// ============================================
+// Phase 2: Flow Construction
+// ============================================
+export function buildFlowConstructionSystemPrompt() {
+    return `You are a software architect constructing execution flows from annotated code.
+
+## Your Task
+For each entry point, trace the logical execution path through the codebase to create a meaningful business flow.
+
+## Key Concepts
+
+**Atomic flows**: Sequences of definition steps (function/method calls)
+**Composite flows**: Flows that include references to sub-flows
+**Sub-flows**: Reusable patterns that can be referenced by name
+
+## Output Format
+Respond with **only** a CSV table:
+
+\`\`\`csv
+type,flow_id,field,value
+flow,1,name,"UserRegistration"
+flow,1,description,"Handles new user signup from request to confirmation"
+flow,1,domain,"auth"
+flow,1,is_composite,"true"
+step,1,1,42
+step,1,2,subflow:ValidateUser
+step,1,3,89
+step,1,4,subflow:SendWelcomeEmail
+step,1,5,123
+subflow_reason,1,2,"Delegates input validation to reusable validation flow"
+subflow_reason,1,4,"Triggers async email notification flow"
+\`\`\`
+
+## Row Types
+
+**flow rows:**
+- \`flow,{id},name,{PascalCase name}\`
+- \`flow,{id},description,{one-sentence description}\`
+- \`flow,{id},domain,{primary domain}\`
+- \`flow,{id},is_composite,{true|false}\`
+
+**step rows:**
+- \`step,{flow_id},{order},{definition_id}\` - Direct function call
+- \`step,{flow_id},{order},subflow:{FlowName}\` - Reference to sub-flow
+
+**subflow_reason rows:**
+- \`subflow_reason,{flow_id},{step_order},{reason}\` - Why this sub-flow is invoked
+
+## Construction Guidelines
+
+1. **Follow call graph edges**: Each step should have a call edge to the next
+2. **Identify sub-flow opportunities**:
+   - Validation logic reused across flows
+   - Common patterns like "send notification", "log action", "update cache"
+   - Sequences that appear in multiple flows
+3. **Name flows by business operation**: CreateSale, UserLogin, ProcessPayment
+4. **Order steps by execution sequence**: Follow the actual call order
+5. **Use relationship annotations**: Leverage semantic descriptions to understand purpose
+
+## Naming Conventions
+- Flow names: PascalCase, action-oriented (CreateUser, ValidatePayment)
+- Sub-flow names: PascalCase, describing the reusable operation (ValidateUser, SendEmail)
+- Descriptions: One sentence, business-focused`;
+}
+export function buildFlowConstructionUserPrompt(contexts) {
+    const parts = [];
+    // List existing sub-flows that can be referenced
+    if (contexts.length > 0 && contexts[0].existingSubflows.length > 0) {
+        parts.push('## Available Sub-flows');
+        for (const name of contexts[0].existingSubflows) {
+            parts.push(`- ${name}`);
+        }
+        parts.push('');
+    }
+    // List existing flows for context
+    if (contexts.length > 0 && contexts[0].existingFlows.length > 0) {
+        parts.push('## Existing Flows');
+        for (const flow of contexts[0].existingFlows) {
+            const desc = flow.description ? `: ${flow.description}` : '';
+            parts.push(`- ${flow.name}${desc}`);
+        }
+        parts.push('');
+    }
+    parts.push(`## Entry Points to Trace (${contexts.length})`);
+    parts.push('');
+    for (let i = 0; i < contexts.length; i++) {
+        const ctx = contexts[i];
+        const flowId = i + 1;
+        parts.push(`### Flow ${flowId}: Entry Point #${ctx.entryPoint.id} - ${ctx.entryPoint.name}`);
+        parts.push(`File: ${ctx.entryPoint.filePath}:${ctx.entryPoint.line}`);
+        if (ctx.entryPoint.purpose) {
+            parts.push(`Purpose: "${ctx.entryPoint.purpose}"`);
+        }
+        if (ctx.entryPoint.domain && ctx.entryPoint.domain.length > 0) {
+            parts.push(`Domain: ${ctx.entryPoint.domain.join(', ')}`);
+        }
+        parts.push('');
+        // Show neighborhood nodes
+        parts.push('**Call Graph Neighborhood:**');
+        for (const node of ctx.neighborhood.nodes) {
+            const purpose = node.purpose ? ` - "${node.purpose}"` : '';
+            const role = node.role ? ` [${node.role}]` : '';
+            parts.push(`- #${node.id}: ${node.name} (${node.kind})${role}${purpose}`);
+        }
+        parts.push('');
+        // Show edges with semantic annotations
+        parts.push('**Call Relationships:**');
+        for (const edge of ctx.neighborhood.edges) {
+            const fromNode = ctx.neighborhood.nodes.find((n) => n.id === edge.fromId);
+            const toNode = ctx.neighborhood.nodes.find((n) => n.id === edge.toId);
+            if (fromNode && toNode) {
+                const semantic = edge.semantic ? `: "${edge.semantic}"` : '';
+                parts.push(`- ${fromNode.name} (#${edge.fromId}) → ${toNode.name} (#${edge.toId})${semantic}`);
+            }
+        }
+        parts.push('');
+    }
+    parts.push('Construct flows in CSV format. Reference sub-flows where appropriate.');
+    return parts.join('\n');
+}
+// ============================================
+// Phase 3: Gap Filling
+// ============================================
+export function buildGapFillingSystemPrompt() {
+    return `You are a software architect analyzing coverage gaps in detected execution flows.
+
+## Your Task
+Review uncovered symbols and suggest how they should be incorporated into flows.
+
+## Suggestion Types
+
+1. **new_flow**: Symbol should be an entry point for a new top-level flow
+2. **add_to_existing**: Symbol should be added as a step to an existing flow
+3. **new_subflow**: Symbol represents reusable logic that should become a sub-flow
+
+## Output Format
+Respond with **only** a CSV table:
+
+\`\`\`csv
+type,symbol_id,target_flow_id,reason
+new_flow,89,,"Payment validation should be a standalone flow"
+add_to_existing,156,3,"Should be added to CreateSale flow as notification step"
+new_subflow,42,,"Appears in multiple flows as common validation pattern"
+\`\`\`
+
+## Guidelines
+
+**When to suggest new_flow:**
+- Symbol has characteristics of an entry point
+- Represents a distinct business operation not covered by existing flows
+- Has outgoing dependencies forming a logical execution path
+
+**When to suggest add_to_existing:**
+- Symbol is called by or calls symbols in an existing flow
+- Logically belongs to an existing flow's execution path
+- Would complete or enhance an existing flow
+
+**When to suggest new_subflow:**
+- Symbol is called by multiple existing flows
+- Represents reusable business logic (validation, notification, etc.)
+- Would reduce duplication if extracted as sub-flow
+
+Prioritize symbols with high connectivity - they're more likely to be important.`;
+}
+export function buildGapFillingUserPrompt(context) {
+    const parts = [];
+    parts.push('## Current Coverage');
+    parts.push(`${context.coverageStats.covered}/${context.coverageStats.total} symbols covered (${context.coverageStats.percentage.toFixed(1)}%)`);
+    parts.push('');
+    parts.push('## Existing Flows');
+    for (const flow of context.existingFlows) {
+        const desc = flow.description ? `: ${flow.description}` : '';
+        parts.push(`- [${flow.id}] ${flow.name} (${flow.stepCount} steps)${desc}`);
+    }
+    parts.push('');
+    parts.push(`## Uncovered Important Symbols (${context.uncoveredSymbols.length})`);
+    parts.push('');
+    for (const sym of context.uncoveredSymbols) {
+        parts.push(`### #${sym.id}: ${sym.name} (${sym.kind})`);
+        parts.push(`File: ${sym.filePath}`);
+        parts.push(`Connectivity: ${sym.incomingDeps} incoming, ${sym.outgoingDeps} outgoing`);
+        if (sym.purpose) {
+            parts.push(`Purpose: "${sym.purpose}"`);
+        }
+        if (sym.domain && sym.domain.length > 0) {
+            parts.push(`Domains: ${sym.domain.join(', ')}`);
+        }
+        if (sym.role) {
+            parts.push(`Role: ${sym.role}`);
+        }
+        parts.push('');
+    }
+    parts.push('Suggest how to incorporate these symbols in CSV format.');
+    return parts.join('\n');
+}
+// ============================================
+// Coverage Formatting
+// ============================================
+export function formatCoverageStats(stats) {
+    const parts = [];
+    parts.push('## Flow Coverage Statistics');
+    parts.push('');
+    parts.push(`Total interactions: ${stats.totalInteractions}`);
+    parts.push(`Covered by flows: ${stats.coveredByFlows} (${stats.percentage.toFixed(1)}%)`);
+    return parts.join('\n');
+}
+//# sourceMappingURL=flow-prompts.js.map

package/dist/commands/llm/_shared/flow-prompts.js.map

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

package/dist/commands/llm/_shared/flow-validation.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Flow and interaction validation logic.
+ */
+import type { IndexDatabase } from '../../../db/database.js';
+import type { Flow, Interaction, InteractionWithPaths } from '../../../db/schema.js';
+export interface ValidationOptions {
+    maxSteps: number;
+}
+export declare const DEFAULT_VALIDATION_OPTIONS: ValidationOptions;
+export type FlowValidationErrorType = 'invalid_entry_point_module' | 'invalid_entry_point' | 'invalid_interaction_id' | 'max_steps_exceeded' | 'duplicate_slug';
+export interface FlowValidationError {
+    type: FlowValidationErrorType;
+    message: string;
+    flowId?: number;
+    flowName?: string;
+}
+export type FlowValidationWarningType = 'no_steps' | 'missing_description';
+export interface FlowValidationWarning {
+    type: FlowValidationWarningType;
+    message: string;
+    severity: 'low' | 'medium' | 'high';
+}
+export interface FlowValidationResult {
+    valid: boolean;
+    errors: FlowValidationError[];
+    warnings: FlowValidationWarning[];
+}
+export declare class FlowValidator {
+    private db;
+    private options;
+    constructor(db: IndexDatabase, options?: ValidationOptions);
+    /**
+     * Validate a single flow.
+     */
+    validateFlow(flow: Flow): FlowValidationResult;
+    /**
+     * Validate all flows in the database.
+     */
+    validateAllFlows(): Map<number, FlowValidationResult>;
+    /**
+     * Find duplicate slugs.
+     */
+    findDuplicateSlugs(): Array<{
+        slug: string;
+        flows: Flow[];
+    }>;
+}
+export interface InteractionValidationError {
+    type: 'invalid_module_id';
+    message: string;
+    interactionId: number;
+}
+export declare function validateInteraction(db: IndexDatabase, interaction: Interaction): InteractionValidationError[];
+export interface CoverageGap {
+    fromModuleId: number;
+    toModuleId: number;
+    fromModulePath: string;
+    toModulePath: string;
+    weight: number;
+}
+/**
+ * Find interactions not covered by any flow.
+ */
+export declare function findUncoveredInteractions(db: IndexDatabase): InteractionWithPaths[];
+/**
+ * Find module edges that don't have interactions.
+ */
+export declare function findMissingInteractions(db: IndexDatabase): CoverageGap[];
+//# sourceMappingURL=flow-validation.d.ts.map

package/dist/commands/llm/_shared/flow-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-validation.d.ts","sourceRoot":"","sources":["../../../../src/commands/llm/_shared/flow-validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAMrF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,0BAA0B,EAAE,iBAExC,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAC/B,4BAA4B,GAC5B,qBAAqB,GACrB,wBAAwB,GACxB,oBAAoB,GACpB,gBAAgB,CAAC;AAErB,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,yBAAyB,GAAG,UAAU,GAAG,qBAAqB,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,yBAAyB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAMD,qBAAa,aAAa;IAEtB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,OAAO;gBADP,EAAE,EAAE,aAAa,EACjB,OAAO,GAAE,iBAA8C;IAGjE;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,oBAAoB;IA+E9C;;OAEG;IACH,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAWrD;;OAEG;IACH,kBAAkB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,IAAI,EAAE,CAAA;KAAE,CAAC;CAmB7D;AAMD,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,GAAG,0BAA0B,EAAE,CAsB7G;AAMD,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,aAAa,GAAG,oBAAoB,EAAE,CAEnF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,aAAa,GAAG,WAAW,EAAE,CA6BxE"}