@zbigniewsobiecki/squint 1.0.0

package/dist/commands/llm/flows/flow-tracer.d.ts

@@ -0,0 +1,50 @@
+/**
+ * FlowTracer - Definition-level call graph traversal.
+ * Traces composite tier-1 flows from entry point definitions through the call graph,
+ * mapping interactions to atomic subflow references.
+ */
+import type { InteractionWithPaths } from '../../../db/schema.js';
+import type { EntryPointModuleInfo, FlowSuggestion, FlowTracingContext } from './types.js';
+export declare class FlowTracer {
+    private readonly context;
+    private readonly maxDepth;
+    constructor(context: FlowTracingContext);
+    /**
+     * Trace composite tier-1 flows from entry point modules.
+     * Maps definition-derived interactions to atomic subflow references.
+     */
+    traceFlowsFromEntryPoints(entryPointModules: EntryPointModuleInfo[], atomicFlows: FlowSuggestion[]): FlowSuggestion[];
+    /**
+     * Trace a flow from a starting definition through the definition-level call graph.
+     * At leaf nodes (no outgoing call graph edges), bridges via LLM-inferred interactions.
+     */
+    private traceDefinitionFlow;
+    /**
+     * Derive unique interaction IDs from definition-level steps.
+     */
+    private deriveInteractionIds;
+    /**
+     * Generate a flow name from an entry point module and member.
+     */
+    private generateFlowNameFromModule;
+    private actionTypeToVerb;
+    /**
+     * Generate a slug from an entry point module and member.
+     */
+    private generateFlowSlugFromModule;
+    /**
+     * Infer stakeholder from entry point module context.
+     */
+    private inferStakeholderFromModule;
+}
+/**
+ * Build the flow tracing context from database data.
+ */
+export declare function buildFlowTracingContext(definitionCallGraph: Map<number, number[]>, allModulesWithMembers: Array<{
+    id: number;
+    fullPath: string;
+    members: Array<{
+        definitionId: number;
+    }>;
+}>, interactions: InteractionWithPaths[]): FlowTracingContext;
+//# sourceMappingURL=flow-tracer.d.ts.map

package/dist/commands/llm/flows/flow-tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-tracer.d.ts","sourceRoot":"","sources":["../../../../src/commands/llm/flows/flow-tracer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAEV,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAGnB,MAAM,YAAY,CAAC;AAEpB,qBAAa,UAAU;IAGT,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAM;gBAEF,OAAO,EAAE,kBAAkB;IAExD;;;OAGG;IACH,yBAAyB,CACvB,iBAAiB,EAAE,oBAAoB,EAAE,EACzC,WAAW,EAAE,cAAc,EAAE,GAC5B,cAAc,EAAE;IAqDnB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA2F3B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA4BlC,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IASlC;;OAEG;IACH,OAAO,CAAC,0BAA0B;CAYnC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAC1C,qBAAqB,EAAE,KAAK,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1C,CAAC,EACF,YAAY,EAAE,oBAAoB,EAAE,GACnC,kBAAkB,CAgDpB"}

package/dist/commands/llm/flows/flow-tracer.js

@@ -0,0 +1,271 @@
+/**
+ * FlowTracer - Definition-level call graph traversal.
+ * Traces composite tier-1 flows from entry point definitions through the call graph,
+ * mapping interactions to atomic subflow references.
+ */
+export class FlowTracer {
+    context;
+    maxDepth = 15;
+    constructor(context) {
+        this.context = context;
+    }
+    /**
+     * Trace composite tier-1 flows from entry point modules.
+     * Maps definition-derived interactions to atomic subflow references.
+     */
+    traceFlowsFromEntryPoints(entryPointModules, atomicFlows) {
+        // Build interaction-to-atomic-flow lookup
+        const interactionToAtomic = new Map();
+        for (const atomic of atomicFlows) {
+            for (const iId of atomic.interactionIds) {
+                if (!interactionToAtomic.has(iId)) {
+                    interactionToAtomic.set(iId, atomic);
+                }
+            }
+        }
+        const flowSuggestions = [];
+        for (const entryPointModule of entryPointModules) {
+            for (const member of entryPointModule.memberDefinitions) {
+                const { definitionSteps, inferredSteps } = this.traceDefinitionFlow(member.id);
+                const derivedInteractionIds = this.deriveInteractionIds(definitionSteps);
+                // Map interactions to subflow references
+                const subflowSlugs = [];
+                const seen = new Set();
+                for (const iId of derivedInteractionIds) {
+                    const atomic = interactionToAtomic.get(iId);
+                    if (atomic && !seen.has(atomic.slug)) {
+                        seen.add(atomic.slug);
+                        subflowSlugs.push(atomic.slug);
+                    }
+                }
+                if (definitionSteps.length > 0 || derivedInteractionIds.length > 0) {
+                    flowSuggestions.push({
+                        name: this.generateFlowNameFromModule(entryPointModule, member),
+                        slug: this.generateFlowSlugFromModule(entryPointModule, member),
+                        entryPointModuleId: entryPointModule.moduleId,
+                        entryPointId: member.id,
+                        entryPath: `${entryPointModule.modulePath}.${member.name}`,
+                        stakeholder: this.inferStakeholderFromModule(entryPointModule),
+                        description: `Flow starting from ${member.name} in ${entryPointModule.modulePath}`,
+                        interactionIds: derivedInteractionIds,
+                        definitionSteps,
+                        inferredSteps,
+                        actionType: member.actionType,
+                        targetEntity: member.targetEntity,
+                        tier: 1,
+                        subflowSlugs,
+                    });
+                }
+            }
+        }
+        return flowSuggestions;
+    }
+    /**
+     * Trace a flow from a starting definition through the definition-level call graph.
+     * At leaf nodes (no outgoing call graph edges), bridges via LLM-inferred interactions.
+     */
+    traceDefinitionFlow(startDefinitionId) {
+        const visited = new Set();
+        const visitedBridgeModules = new Set();
+        const steps = [];
+        const inferredSteps = [];
+        const trace = (defId, depth, lastKnownModule, isBridged = false) => {
+            if (depth >= this.maxDepth)
+                return;
+            if (visited.has(defId))
+                return;
+            visited.add(defId);
+            // When a definition was reached via bridge (inferred interaction),
+            // don't follow its regular call-graph edges. The bridge connects the
+            // boundary crossing; the target's own call graph is traced by its own
+            // entry-point flows. Following it here would expand the entire target
+            // subsystem (e.g. an Express app.use() aggregator → all controllers).
+            if (isBridged)
+                return;
+            const calledDefs = this.context.definitionCallGraph.get(defId) ?? [];
+            for (const calledDefId of calledDefs) {
+                const fromModule = this.context.defToModule.get(defId) ?? lastKnownModule;
+                const toModule = this.context.defToModule.get(calledDefId);
+                // Only include cross-module calls
+                if (fromModule && toModule && fromModule.moduleId !== toModule.moduleId) {
+                    steps.push({
+                        fromDefinitionId: defId,
+                        toDefinitionId: calledDefId,
+                        fromModuleId: fromModule.moduleId,
+                        toModuleId: toModule.moduleId,
+                    });
+                }
+                const nextKnownModule = this.context.defToModule.get(calledDefId) ?? fromModule;
+                trace(calledDefId, depth + 1, nextKnownModule);
+            }
+            // Bridge via inferred interactions at leaf nodes
+            if (calledDefs.length === 0) {
+                const leafModule = this.context.defToModule.get(defId) ?? lastKnownModule;
+                if (!leafModule)
+                    return;
+                const leafModuleId = leafModule.moduleId;
+                if (visitedBridgeModules.has(leafModuleId))
+                    return;
+                visitedBridgeModules.add(leafModuleId);
+                const inferred = this.context.inferredFromModule.get(leafModuleId);
+                if (!inferred)
+                    return;
+                for (const interaction of inferred) {
+                    const targetModuleId = interaction.toModuleId;
+                    const targetDefs = this.context.moduleToDefIds.get(targetModuleId);
+                    if (!targetDefs || targetDefs.length === 0)
+                        continue;
+                    // Pick representative: first unvisited, fallback first
+                    const representative = targetDefs.find((d) => !visited.has(d)) ?? targetDefs[0];
+                    steps.push({
+                        fromDefinitionId: defId,
+                        toDefinitionId: representative,
+                        fromModuleId: leafModuleId,
+                        toModuleId: targetModuleId,
+                    });
+                    inferredSteps.push({
+                        fromModuleId: leafModuleId,
+                        toModuleId: targetModuleId,
+                        source: 'llm-inferred',
+                    });
+                    // Continue tracing from the bridge target — marked as bridged
+                    // so we record the step but don't expand its call graph
+                    const targetModule = this.context.defToModule.get(representative) ?? null;
+                    trace(representative, depth + 1, targetModule, true);
+                }
+            }
+        };
+        const startModule = this.context.defToModule.get(startDefinitionId) ?? null;
+        trace(startDefinitionId, 0, startModule);
+        return { definitionSteps: steps, inferredSteps };
+    }
+    /**
+     * Derive unique interaction IDs from definition-level steps.
+     */
+    deriveInteractionIds(definitionSteps) {
+        const seenIds = new Set();
+        const result = [];
+        for (const step of definitionSteps) {
+            if (step.fromModuleId && step.toModuleId) {
+                const key = `${step.fromModuleId}->${step.toModuleId}`;
+                const interactionId = this.context.interactionByModulePair.get(key);
+                if (interactionId && !seenIds.has(interactionId)) {
+                    seenIds.add(interactionId);
+                    result.push(interactionId);
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Generate a flow name from an entry point module and member.
+     */
+    generateFlowNameFromModule(_module, member) {
+        if (member.actionType && member.targetEntity) {
+            const actionVerb = this.actionTypeToVerb(member.actionType);
+            const entity = member.targetEntity.charAt(0).toUpperCase() + member.targetEntity.slice(1);
+            return `${actionVerb}${entity}Flow`;
+        }
+        let name = member.name;
+        name = name.replace(/^handle/, '');
+        name = name.replace(/Handler$/, '');
+        name = name.replace(/Controller$/, '');
+        name = name.replace(/^on/, '');
+        if (member.actionType) {
+            const actionVerb = this.actionTypeToVerb(member.actionType);
+            name = `${actionVerb}${name}`;
+        }
+        if (!name.endsWith('Flow')) {
+            name = `${name}Flow`;
+        }
+        return name;
+    }
+    actionTypeToVerb(actionType) {
+        switch (actionType) {
+            case 'view':
+                return 'View';
+            case 'create':
+                return 'Create';
+            case 'update':
+                return 'Update';
+            case 'delete':
+                return 'Delete';
+            case 'process':
+                return 'Process';
+            default:
+                return '';
+        }
+    }
+    /**
+     * Generate a slug from an entry point module and member.
+     */
+    generateFlowSlugFromModule(module, member) {
+        return this.generateFlowNameFromModule(module, member)
+            .replace(/([a-z])([A-Z])/g, '$1-$2')
+            .toLowerCase();
+    }
+    /**
+     * Infer stakeholder from entry point module context.
+     */
+    inferStakeholderFromModule(module) {
+        const path = module.modulePath.toLowerCase();
+        if (path.includes('admin'))
+            return 'admin';
+        if (path.includes('api') || path.includes('route'))
+            return 'external';
+        if (path.includes('cron') || path.includes('job') || path.includes('worker'))
+            return 'system';
+        if (path.includes('cli') || path.includes('command'))
+            return 'developer';
+        return 'user';
+    }
+}
+/**
+ * Build the flow tracing context from database data.
+ */
+export function buildFlowTracingContext(definitionCallGraph, allModulesWithMembers, interactions) {
+    // Build definition-to-module lookup and reverse module-to-definitions lookup
+    const defToModule = new Map();
+    const moduleToDefIds = new Map();
+    for (const mod of allModulesWithMembers) {
+        const defIds = [];
+        for (const member of mod.members) {
+            defToModule.set(member.definitionId, { moduleId: mod.id, modulePath: mod.fullPath });
+            defIds.push(member.definitionId);
+        }
+        if (defIds.length > 0) {
+            moduleToDefIds.set(mod.id, defIds);
+        }
+    }
+    // Build interaction lookup for module pairs
+    const interactionByModulePair = new Map();
+    for (const interaction of interactions) {
+        const key = `${interaction.fromModuleId}->${interaction.toModuleId}`;
+        interactionByModulePair.set(key, interaction.id);
+    }
+    // Build lookup for llm-inferred interactions by source module
+    const inferredFromModule = new Map();
+    for (const interaction of interactions) {
+        if (interaction.source === 'llm-inferred') {
+            const existing = inferredFromModule.get(interaction.fromModuleId) ?? [];
+            existing.push(interaction);
+            inferredFromModule.set(interaction.fromModuleId, existing);
+        }
+    }
+    // Build lookup for ALL interactions by source module
+    const allInteractionsFromModule = new Map();
+    for (const interaction of interactions) {
+        const existing = allInteractionsFromModule.get(interaction.fromModuleId) ?? [];
+        existing.push(interaction);
+        allInteractionsFromModule.set(interaction.fromModuleId, existing);
+    }
+    return {
+        definitionCallGraph,
+        defToModule,
+        interactionByModulePair,
+        inferredFromModule,
+        allInteractionsFromModule,
+        moduleToDefIds,
+    };
+}
+//# sourceMappingURL=flow-tracer.js.map

package/dist/commands/llm/flows/flow-tracer.js.map

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

package/dist/commands/llm/flows/flow-validator.d.ts

@@ -0,0 +1,31 @@
+/**
+ * FlowValidator - Reviews generated flows for completeness and identifies missing user stories.
+ * Uses LLM to find gaps in flow coverage and creates corrective flows.
+ */
+import type { Command } from '@oclif/core';
+import type { IndexDatabase } from '../../../db/database.js';
+import type { InteractionWithPaths } from '../../../db/schema.js';
+import type { EntryPointModuleInfo, FlowSuggestion, LlmOptions } from './types.js';
+interface CoverageGateFailure {
+    gate: string;
+    actual: number;
+    threshold: number;
+    details: string;
+}
+export declare class FlowValidator {
+    private readonly db;
+    private readonly command;
+    private readonly isJson;
+    private readonly verbose;
+    constructor(db: IndexDatabase, command: Command, isJson: boolean, verbose: boolean);
+    /**
+     * Validate existing flows for completeness and generate flows for missing user stories.
+     */
+    validateAndFillGaps(existingFlows: FlowSuggestion[], interactions: InteractionWithPaths[], model: string, llmOptions: LlmOptions, gateFailures?: CoverageGateFailure[], entryPointModules?: EntryPointModuleInfo[], atomicFlows?: FlowSuggestion[]): Promise<FlowSuggestion[]>;
+    private buildValidationSystemPrompt;
+    private buildValidationUserPrompt;
+    private parseValidatorResponse;
+    private findModuleByPrefix;
+}
+export {};
+//# sourceMappingURL=flow-validator.d.ts.map

package/dist/commands/llm/flows/flow-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-validator.d.ts","sourceRoot":"","sources":["../../../../src/commands/llm/flows/flow-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAU,MAAM,uBAAuB,CAAC;AAU1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEnF,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAHP,EAAE,EAAE,aAAa,EACjB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,OAAO;IAGnC;;OAEG;IACG,mBAAmB,CACvB,aAAa,EAAE,cAAc,EAAE,EAC/B,YAAY,EAAE,oBAAoB,EAAE,EACpC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,UAAU,EACtB,YAAY,CAAC,EAAE,mBAAmB,EAAE,EACpC,iBAAiB,CAAC,EAAE,oBAAoB,EAAE,EAC1C,WAAW,CAAC,EAAE,cAAc,EAAE,GAC7B,OAAO,CAAC,cAAc,EAAE,CAAC;IAuC5B,OAAO,CAAC,2BAA2B;IA2CnC,OAAO,CAAC,yBAAyB;IAgHjC,OAAO,CAAC,sBAAsB;IAkG9B,OAAO,CAAC,kBAAkB;CAS3B"}

package/dist/commands/llm/flows/flow-validator.js

@@ -0,0 +1,262 @@
+/**
+ * FlowValidator - Reviews generated flows for completeness and identifies missing user stories.
+ * Uses LLM to find gaps in flow coverage and creates corrective flows.
+ */
+import { parseRow } from '../_shared/csv-utils.js';
+import { groupModulesByEntity } from '../_shared/entity-utils.js';
+import { completeWithLogging, logLlmRequest, logLlmResponse, logVerbose, } from '../_shared/llm-utils.js';
+export class FlowValidator {
+    db;
+    command;
+    isJson;
+    verbose;
+    constructor(db, command, isJson, verbose) {
+        this.db = db;
+        this.command = command;
+        this.isJson = isJson;
+        this.verbose = verbose;
+    }
+    /**
+     * Validate existing flows for completeness and generate flows for missing user stories.
+     */
+    async validateAndFillGaps(existingFlows, interactions, model, llmOptions, gateFailures, entryPointModules, atomicFlows) {
+        const modules = this.db.modules.getAll();
+        const moduleByPath = new Map(modules.map((m) => [m.fullPath, m]));
+        const coveredInteractionIds = new Set(existingFlows.flatMap((f) => f.interactionIds));
+        const systemPrompt = this.buildValidationSystemPrompt();
+        const userPrompt = this.buildValidationUserPrompt(existingFlows, interactions, modules, coveredInteractionIds, gateFailures, entryPointModules, atomicFlows);
+        const logOptions = {
+            showRequests: llmOptions.showLlmRequests,
+            showResponses: llmOptions.showLlmResponses,
+            isJson: this.isJson,
+        };
+        logLlmRequest(this.command, 'validateAndFillGaps', systemPrompt, userPrompt, logOptions);
+        const response = await completeWithLogging({
+            model,
+            systemPrompt,
+            userPrompt,
+            temperature: 0,
+            command: this.command,
+            isJson: this.isJson,
+        });
+        logLlmResponse(this.command, 'validateAndFillGaps', response, logOptions);
+        return this.parseValidatorResponse(response, interactions, moduleByPath);
+    }
+    buildValidationSystemPrompt() {
+        return `You are reviewing auto-detected user journey flows for completeness.
+
+## What You Have
+1. A list of detected flows with their entry points and steps
+2. The full module interaction graph
+3. Module descriptions
+4. Entry point definitions showing what operations actually exist in code
+
+## Your Task
+Identify MISSING user stories — important user-facing workflows that should exist
+but don't appear in the detected flows.
+
+What to look for:
+- UNCOVERED interactions in the graph that should be part of a user story
+- Cross-entity side effects visible in the interaction graph (e.g., a sale flow also touching vehicle/inventory modules)
+- Compositions of existing atomic flows into higher-level user stories
+
+What NOT to do:
+- Do NOT infer operations that are not visible in the interaction graph
+- Do NOT propose admin CRUD flows unless admin-specific entry points are listed above
+- Do NOT create flows from type/interface-only modules
+- Do NOT duplicate flows that already exist — check the existing flows list carefully
+
+## CRITICAL CONSTRAINTS
+- [AST] interactions are statically verified from source code — reliable
+- [INFERRED] interactions are LLM-estimated — may not exist in actual code
+- The "Entry Point Definitions" section shows what operations ACTUALLY exist
+- Do NOT propose flows for operations not listed in Entry Point Definitions
+- Prefer building flows from [AST] interactions when possible
+
+## Output Format
+\`\`\`csv
+flow_name,stakeholder,action_type,target_entity,interaction_chain,description
+"user views dashboard","user","view","dashboard","project.frontend.screens→project.frontend.hooks→project.backend.api","Fetches stats for KPI display"
+"admin registers new user","admin","process","user","project.frontend.screens→project.backend.api.controllers","Admin creates new user account"
+\`\`\`
+
+For interaction_chain: list the module path segments in order, separated by →.
+Only report flows that are genuinely MISSING — do not duplicate existing flows.
+Only report flows where the module interactions to support them actually EXIST in the graph.`;
+    }
+    buildValidationUserPrompt(existingFlows, interactions, modules, coveredInteractionIds, gateFailures, entryPointModules, atomicFlows) {
+        const parts = [];
+        // Existing flows summary
+        parts.push(`## Existing Flows (${existingFlows.length})`);
+        for (const f of existingFlows) {
+            const stepCount = f.interactionIds.length;
+            const isGap = f.entryPointModuleId === null;
+            parts.push(`- ${f.name} [${f.stakeholder}/${f.actionType ?? 'unknown'}/${f.targetEntity ?? 'unknown'}] (${stepCount} steps${isGap ? ', gap/internal' : ''})`);
+        }
+        parts.push('');
+        // Modules grouped by domain
+        parts.push('## Modules by Domain');
+        const entityGroups = groupModulesByEntity(modules);
+        for (const [entity, mods] of entityGroups) {
+            if (entity === '_generic') {
+                parts.push('### Generic/Shared');
+            }
+            else {
+                parts.push(`### ${entity}`);
+            }
+            for (const m of mods) {
+                parts.push(`- ${m.fullPath}: ${m.name}${m.description ? ` - ${m.description}` : ''}`);
+            }
+            parts.push('');
+        }
+        // Entry point definitions section
+        if (entryPointModules && entryPointModules.length > 0) {
+            parts.push('## Entry Point Definitions (operations that exist in code)');
+            parts.push('ONLY create flows for operations listed below. Do NOT invent operations.');
+            parts.push('');
+            for (const ep of entryPointModules) {
+                const defs = ep.memberDefinitions
+                    .map((d) => {
+                    const action = d.actionType ?? 'unclassified';
+                    const entity = d.targetEntity ?? '?';
+                    return `  - ${d.name} [${action}/${entity}]`;
+                })
+                    .join('\n');
+                parts.push(`### ${ep.modulePath}`);
+                parts.push(defs);
+                parts.push('');
+            }
+        }
+        // Available atomic flows
+        if (atomicFlows && atomicFlows.length > 0) {
+            parts.push('## Available Atomic Flows');
+            parts.push('You can compose flows by referencing these atomic building blocks:');
+            for (const af of atomicFlows) {
+                const interactionCount = af.interactionIds.length;
+                parts.push(`- ${af.slug} (${interactionCount} interaction${interactionCount !== 1 ? 's' : ''}): ${af.description}`);
+            }
+            parts.push('');
+        }
+        // Interaction graph summary with coverage annotations
+        const uncoveredInteractions = interactions.filter((i) => !coveredInteractionIds.has(i.id));
+        const coveredCount = interactions.length - uncoveredInteractions.length;
+        parts.push(`## Interactions (${interactions.length} total, ${coveredCount} covered, ${uncoveredInteractions.length} uncovered)`);
+        for (const i of interactions) {
+            const coverTag = coveredInteractionIds.has(i.id) ? '[COVERED]' : '[UNCOVERED]';
+            const srcTag = i.source === 'llm-inferred' ? '[INFERRED]' : '[AST]';
+            parts.push(`- ${coverTag} ${srcTag} ${i.fromModulePath} → ${i.toModulePath}${i.semantic ? `: ${i.semantic}` : ''}`);
+        }
+        parts.push('');
+        // Priority section: uncovered interactions only
+        if (uncoveredInteractions.length > 0) {
+            parts.push('## Uncovered Interactions — PRIORITY');
+            parts.push('These interactions are NOT yet covered by any flow. Create flows that include them:');
+            for (const i of uncoveredInteractions) {
+                const srcTag = i.source === 'llm-inferred' ? '[INFERRED]' : '[AST]';
+                parts.push(`- ${srcTag} ${i.fromModulePath} → ${i.toModulePath}${i.semantic ? `: ${i.semantic}` : ''}`);
+            }
+            parts.push('');
+        }
+        // Gate failure context for retries
+        if (gateFailures && gateFailures.length > 0) {
+            parts.push('## Previous Attempt Results');
+            parts.push('The following coverage gaps remain:');
+            for (const f of gateFailures) {
+                parts.push(`- ${f.gate}: ${f.details}`);
+            }
+            parts.push('');
+            parts.push('Focus on creating flows that address these specific gaps.');
+            parts.push('');
+        }
+        parts.push('Identify MISSING user stories. Only report flows supported by existing interactions.');
+        return parts.join('\n');
+    }
+    parseValidatorResponse(response, interactions, moduleByPath) {
+        const results = [];
+        const csvMatch = response.match(/```csv\n([\s\S]*?)\n```/) || response.match(/```\n([\s\S]*?)\n```/);
+        const csvContent = csvMatch ? csvMatch[1] : response;
+        const lines = csvContent.split('\n').filter((l) => l.trim() && !l.startsWith('flow_name'));
+        // Build interaction lookup by module pair
+        const interactionByPair = new Map();
+        for (const i of interactions) {
+            interactionByPair.set(`${i.fromModuleId}->${i.toModuleId}`, i);
+        }
+        for (const line of lines) {
+            const fields = parseRow(line);
+            if (!fields || fields.length < 6)
+                continue;
+            const [flowName, stakeholder, actionType, targetEntity, interactionChain, description] = fields;
+            // Parse interaction chain (module paths separated by →)
+            const chainPaths = interactionChain
+                .split('→')
+                .map((p) => p.trim())
+                .filter((p) => p.length > 0);
+            if (chainPaths.length < 2)
+                continue;
+            // Resolve module paths and find matching interactions
+            const resolvedModules = [];
+            for (const path of chainPaths) {
+                // Try exact match first, then prefix match
+                const mod = moduleByPath.get(path) ?? this.findModuleByPrefix(path, moduleByPath);
+                if (mod) {
+                    resolvedModules.push(mod);
+                }
+            }
+            if (resolvedModules.length < 2)
+                continue;
+            // Find interaction IDs for consecutive module pairs
+            const interactionIds = [];
+            for (let i = 0; i < resolvedModules.length - 1; i++) {
+                const from = resolvedModules[i];
+                const to = resolvedModules[i + 1];
+                const interaction = interactionByPair.get(`${from.id}->${to.id}`);
+                if (interaction) {
+                    interactionIds.push(interaction.id);
+                }
+            }
+            if (interactionIds.length === 0)
+                continue;
+            const validStakeholders = ['user', 'admin', 'system', 'developer', 'external'];
+            const parsedStakeholder = validStakeholders.includes(stakeholder.trim().toLowerCase())
+                ? stakeholder.trim().toLowerCase()
+                : 'user';
+            const validActions = ['view', 'create', 'update', 'delete', 'process'];
+            const parsedAction = validActions.includes(actionType.trim().toLowerCase())
+                ? actionType.trim().toLowerCase()
+                : null;
+            const cleanName = flowName.replace(/"/g, '').trim();
+            const slug = cleanName
+                .toLowerCase()
+                .replace(/[^a-z0-9]+/g, '-')
+                .replace(/^-|-$/g, '');
+            results.push({
+                name: cleanName,
+                slug,
+                entryPointModuleId: resolvedModules[0].id,
+                entryPointId: null,
+                entryPath: resolvedModules[0].fullPath,
+                stakeholder: parsedStakeholder,
+                description: description.replace(/"/g, '').trim(),
+                interactionIds,
+                definitionSteps: [],
+                inferredSteps: [],
+                actionType: parsedAction,
+                targetEntity: targetEntity.replace(/"/g, '').trim() || null,
+                tier: 1,
+                subflowSlugs: [],
+            });
+        }
+        logVerbose(this.command, `  Validator identified ${results.length} missing flows`, this.verbose, this.isJson);
+        return results;
+    }
+    findModuleByPrefix(path, moduleByPath) {
+        // Try to find a module whose path ends with the given path segment
+        for (const [fullPath, mod] of moduleByPath) {
+            if (fullPath.endsWith(path) || fullPath.endsWith(`.${path}`)) {
+                return mod;
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=flow-validator.js.map

package/dist/commands/llm/flows/flow-validator.js.map

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