@zbigniewsobiecki/squint 1.0.0

package/dist/commands/llm/flows/entry-point-detector.js

@@ -0,0 +1,388 @@
+/**
+ * EntryPointDetector - LLM-based entry point module classification.
+ * Identifies modules and their members that serve as entry points for user flows.
+ */
+import { parseRow } from '../_shared/csv-utils.js';
+import { completeWithLogging, getErrorMessage, logLlmRequest, logLlmResponse, logVerbose, logWarning, } from '../_shared/llm-utils.js';
+export class EntryPointDetector {
+    db;
+    command;
+    isJson;
+    verbose;
+    memberClassifications = [];
+    constructor(db, command, isJson, verbose) {
+        this.db = db;
+        this.command = command;
+        this.isJson = isJson;
+        this.verbose = verbose;
+    }
+    /**
+     * Detect entry point modules using LLM classification.
+     */
+    async detectEntryPointModules(model, llmOptions) {
+        const allModulesWithMembers = this.db.modules.getAllWithMembers();
+        // Build module candidates (only modules with members, skip test modules)
+        const candidates = [];
+        for (const mod of allModulesWithMembers) {
+            if (mod.members.length === 0)
+                continue;
+            if (mod.isTest)
+                continue; // Test modules are never entry points
+            // Skip modules where ALL members are type-only (no callable code)
+            const callableKinds = new Set(['function', 'class', 'const', 'variable', 'method']);
+            const hasCallableMembers = mod.members.some((m) => callableKinds.has(m.kind));
+            if (!hasCallableMembers)
+                continue;
+            candidates.push({
+                id: mod.id,
+                fullPath: mod.fullPath,
+                name: mod.name,
+                description: mod.description,
+                depth: mod.depth,
+                memberCount: mod.members.length,
+                members: mod.members.map((m) => ({
+                    definitionId: m.definitionId,
+                    name: m.name,
+                    kind: m.kind,
+                })),
+            });
+        }
+        if (candidates.length === 0) {
+            return [];
+        }
+        // Classify with LLM
+        let classifications;
+        try {
+            classifications = await this.classifyModulesAsEntryPoints(candidates, model, llmOptions);
+            logVerbose(this.command, `  LLM classified ${classifications.filter((c) => c.isEntryPoint).length}/${candidates.length} modules as entry points`, this.verbose, this.isJson);
+        }
+        catch (error) {
+            const message = getErrorMessage(error);
+            logWarning(this.command, `  LLM classification failed: ${message}`, this.isJson);
+            if (!this.isJson) {
+                this.command.log('  Falling back to heuristic detection');
+            }
+            classifications = candidates.map((c) => ({
+                moduleId: c.id,
+                isEntryPoint: this.isLikelyEntryPointModuleHeuristic(c),
+                confidence: 'low',
+                reason: 'Heuristic fallback',
+            }));
+        }
+        return this.buildEntryPointModules(classifications, candidates);
+    }
+    /**
+     * Get stored member classifications (available after detectEntryPointModules is called).
+     */
+    getMemberClassifications() {
+        return this.memberClassifications;
+    }
+    /**
+     * Use LLM to classify modules and their member functions for user journey detection.
+     */
+    async classifyModulesAsEntryPoints(candidates, model, llmOptions) {
+        const memberClassifications = await this.classifyModuleMembers(candidates, model, llmOptions);
+        this.memberClassifications = memberClassifications;
+        // Aggregate: a module is an entry point if ANY member is an entry point
+        const moduleEntryStatus = new Map();
+        for (const mc of memberClassifications) {
+            const existing = moduleEntryStatus.get(mc.moduleId);
+            if (mc.isEntryPoint) {
+                moduleEntryStatus.set(mc.moduleId, { isEntry: true, reason: mc.reason });
+            }
+            else if (!existing) {
+                moduleEntryStatus.set(mc.moduleId, { isEntry: false, reason: mc.reason });
+            }
+        }
+        return candidates.map((c) => {
+            const status = moduleEntryStatus.get(c.id);
+            return {
+                moduleId: c.id,
+                isEntryPoint: status?.isEntry ?? this.isLikelyEntryPointModuleHeuristic(c),
+                confidence: 'medium',
+                reason: status?.reason ?? 'Heuristic fallback',
+            };
+        });
+    }
+    /**
+     * Use LLM to classify module members with action types and target entities.
+     */
+    async classifyModuleMembers(candidates, model, llmOptions) {
+        const interactions = this.db.callGraph.getEnrichedModuleCallGraph();
+        const relationships = this.db.relationships.getAll({ limit: 200 });
+        const systemPrompt = this.buildClassificationSystemPrompt();
+        const moduleList = this.buildModuleContext(candidates);
+        const interactionList = this.buildInteractionContext(interactions, candidates);
+        const relationshipList = this.buildRelationshipContext(relationships, candidates);
+        const userPrompt = `## Modules (${candidates.length})
+${moduleList}
+
+## Module Interactions (which modules call which)
+${interactionList || '(No interaction data available)'}
+
+## Symbol Relationships (semantic connections)
+${relationshipList || '(No relationship annotations available)'}
+
+Identify all user-facing actions for each entry point module. A screen component may have multiple actions if it calls different hooks/mutations.`;
+        const logOptions = {
+            showRequests: llmOptions.showLlmRequests,
+            showResponses: llmOptions.showLlmResponses,
+            isJson: this.isJson,
+        };
+        logLlmRequest(this.command, 'classifyModuleMembers', systemPrompt, userPrompt, logOptions);
+        const response = await completeWithLogging({
+            model,
+            systemPrompt,
+            userPrompt,
+            temperature: 0,
+            command: this.command,
+            isJson: this.isJson,
+        });
+        logLlmResponse(this.command, 'classifyModuleMembers', response, logOptions);
+        return this.parseMemberClassificationCSV(response, candidates);
+    }
+    buildClassificationSystemPrompt() {
+        return `You are analyzing a codebase to identify user-facing flows and their actions.
+
+## Context Provided
+You have access to:
+1. **Modules** - code organization with their exported members
+2. **Interactions** - which modules call which, and which specific symbols are called
+3. **Relationships** - semantic descriptions of symbol-to-symbol connections
+
+## Task
+For each entry point module (screens, pages, routes, controllers), identify ALL user-facing actions including those that go through hooks/services.
+
+Key insight: A screen component like "Customers" may call hooks like "useCreateCustomer", "useDeleteCustomer". These represent separate user actions even though they're not direct members of the screen module.
+
+## Action Type Guidelines
+- **view**: Displays data - list views, detail views, dashboards
+- **create**: Adds new records - uses hooks/services with "create", "add", "new"
+- **update**: Modifies existing - uses hooks/services with "update", "edit", "save"
+- **delete**: Removes records - uses hooks/services with "delete", "remove"
+- **process**: Non-CRUD - login, logout, sync, export
+
+## Output Format
+\`\`\`csv
+module_id,member_name,is_entry_point,action_type,target_entity,reason
+42,Customers,true,view,customer,"Main component displaying customer list"
+42,Customers,true,create,customer,"Calls useCreateCustomer hook for new customers"
+42,Customers,true,update,customer,"Calls useUpdateCustomer hook"
+42,Customers,true,delete,customer,"Calls useDeleteCustomer hook"
+\`\`\`
+
+IMPORTANT: A single component can have MULTIPLE action types if it calls multiple mutation hooks.
+Only mark as is_entry_point=true if it's user-initiated (UI event, API endpoint).
+Internal services/utilities should be is_entry_point=false.
+
+## CRITICAL: Test Code Exclusion
+Test helpers, mock factories, test fixtures, spec runners, and test utilities are NEVER entry points.
+Only production code that real end-users or external clients interact with should be classified as entry points.
+If a module exists solely to support testing (generating test data, mocking services, setting up test state),
+mark ALL its members as is_entry_point=false regardless of their names.
+
+## CRITICAL: Type-Only Module Exclusion
+Modules containing only interfaces, types, and enums are data structure definitions, NOT entry points.`;
+    }
+    buildModuleContext(candidates) {
+        return candidates
+            .map((m) => {
+            let desc = `## Module ${m.id}: ${m.fullPath}`;
+            if (m.description)
+                desc += `\nDescription: ${m.description}`;
+            desc += `\nName: ${m.name}`;
+            desc += '\nMembers:';
+            for (const mem of m.members) {
+                desc += `\n  - ${mem.name} (${mem.kind})`;
+            }
+            return desc;
+        })
+            .join('\n\n');
+    }
+    buildInteractionContext(interactions, candidates) {
+        const candidateIds = new Set(candidates.map((c) => c.id));
+        const relevant = interactions.filter((i) => candidateIds.has(i.fromModuleId) || candidateIds.has(i.toModuleId));
+        if (relevant.length === 0)
+            return '';
+        return relevant
+            .map((i) => {
+            const symbols = i.calledSymbols.map((s) => s.name).join(', ');
+            return `${i.fromModulePath} → ${i.toModulePath}: calls [${symbols}]`;
+        })
+            .join('\n');
+    }
+    buildRelationshipContext(relationships, candidates) {
+        const defIds = new Set(candidates.flatMap((c) => c.members.map((m) => m.definitionId)));
+        const relevant = relationships.filter((r) => defIds.has(r.fromDefinitionId) || defIds.has(r.toDefinitionId));
+        if (relevant.length === 0)
+            return '';
+        return relevant.map((r) => `${r.fromName} → ${r.toName}: "${r.semantic}"`).join('\n');
+    }
+    parseMemberClassificationCSV(response, candidates) {
+        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('module_id,'));
+        const candidateMap = new Map(candidates.map((c) => [c.id, c]));
+        for (const line of lines) {
+            const fields = parseRow(line);
+            if (!fields || fields.length < 6)
+                continue;
+            const moduleId = Number.parseInt(fields[0].trim(), 10);
+            if (!candidateMap.has(moduleId))
+                continue;
+            const memberName = fields[1].trim();
+            const isEntryPoint = fields[2].trim().toLowerCase() === 'true';
+            const actionTypeRaw = fields[3].trim().toLowerCase();
+            const targetEntity = fields[4].trim() || null;
+            const reason = fields[5].trim().replace(/"/g, '');
+            const validActions = ['view', 'create', 'update', 'delete', 'process'];
+            const actionType = validActions.includes(actionTypeRaw) ? actionTypeRaw : null;
+            results.push({
+                moduleId,
+                memberName,
+                isEntryPoint,
+                actionType,
+                targetEntity: targetEntity || null,
+                reason,
+            });
+        }
+        // Add fallback for any members not in response
+        for (const candidate of candidates) {
+            for (const member of candidate.members) {
+                if (!results.find((r) => r.moduleId === candidate.id && r.memberName === member.name)) {
+                    const inferred = this.inferMemberActionType(member.name, candidate.fullPath);
+                    results.push({
+                        moduleId: candidate.id,
+                        memberName: member.name,
+                        isEntryPoint: this.isLikelyEntryPointMemberHeuristic(member.name, candidate),
+                        actionType: inferred.actionType,
+                        targetEntity: inferred.targetEntity,
+                        reason: 'Not in LLM response, using heuristic',
+                    });
+                }
+            }
+        }
+        return results;
+    }
+    inferMemberActionType(memberName, modulePath) {
+        const name = memberName.toLowerCase();
+        const path = modulePath.toLowerCase();
+        let actionType = null;
+        if (name.includes('create') || name.includes('add') || name.includes('new') || name.includes('insert')) {
+            actionType = 'create';
+        }
+        else if (name.includes('update') || name.includes('edit') || name.includes('modify') || name.includes('save')) {
+            actionType = 'update';
+        }
+        else if (name.includes('delete') || name.includes('remove')) {
+            actionType = 'delete';
+        }
+        else if (name.includes('list') || name.includes('view') || name.includes('get') || name.includes('show')) {
+            actionType = 'view';
+        }
+        else if (name.includes('login') ||
+            name.includes('logout') ||
+            name.includes('auth') ||
+            name.includes('process') ||
+            name.includes('sync')) {
+            actionType = 'process';
+        }
+        let targetEntity = null;
+        const entityPatterns = ['customer', 'vehicle', 'sale', 'user', 'order', 'product', 'inventory', 'dashboard'];
+        for (const entity of entityPatterns) {
+            if (name.includes(entity) || path.includes(entity)) {
+                targetEntity = entity;
+                break;
+            }
+        }
+        if (!targetEntity) {
+            const pathParts = modulePath.split('.');
+            const lastPart = pathParts[pathParts.length - 1]?.toLowerCase();
+            if (lastPart && !['screen', 'page', 'view', 'handler', 'controller'].includes(lastPart)) {
+                targetEntity = lastPart;
+            }
+        }
+        return { actionType, targetEntity };
+    }
+    isLikelyEntryPointMemberHeuristic(memberName, module) {
+        const name = memberName.toLowerCase();
+        const path = module.fullPath.toLowerCase();
+        if (name.includes('handle') || name.includes('screen') || name.includes('page'))
+            return true;
+        if (name.endsWith('list') || name.endsWith('view') || name.endsWith('form'))
+            return true;
+        if (path.includes('screen') || path.includes('page') || path.includes('route'))
+            return true;
+        return false;
+    }
+    isLikelyEntryPointModuleHeuristic(candidate) {
+        const path = candidate.fullPath.toLowerCase();
+        if (path.includes('page') || path.includes('screen') || path.includes('view'))
+            return true;
+        if (path.includes('route') || path.includes('api') || path.includes('endpoint'))
+            return true;
+        if (path.includes('handler') || path.includes('controller'))
+            return true;
+        if (path.includes('command') || path.includes('cli'))
+            return true;
+        if (path.includes('util') || path.includes('helper') || path.includes('common'))
+            return false;
+        if (path.includes('lib') || path.includes('shared') || path.includes('core'))
+            return false;
+        if (path.includes('service') || path.includes('repository') || path.includes('model'))
+            return false;
+        const memberNames = candidate.members.map((m) => m.name.toLowerCase());
+        const hasHandlerLikeMember = memberNames.some((n) => n.includes('handle') || n.includes('route') || n.includes('page'));
+        if (hasHandlerLikeMember)
+            return true;
+        return false;
+    }
+    buildEntryPointModules(classifications, candidates) {
+        const entryPointModules = [];
+        for (const classification of classifications) {
+            if (!classification.isEntryPoint)
+                continue;
+            const mod = candidates.find((c) => c.id === classification.moduleId);
+            if (!mod)
+                continue;
+            const moduleClassifications = this.memberClassifications.filter((mc) => mc.moduleId === mod.id && mc.isEntryPoint);
+            const memberDefinitions = [];
+            for (const mc of moduleClassifications) {
+                const member = mod.members.find((m) => m.name === mc.memberName);
+                if (member) {
+                    memberDefinitions.push({
+                        id: member.definitionId,
+                        name: member.name,
+                        kind: member.kind,
+                        actionType: mc.actionType,
+                        targetEntity: mc.targetEntity,
+                    });
+                }
+            }
+            // For members without any classification, add them with null action type
+            for (const member of mod.members) {
+                const hasClassification = moduleClassifications.some((mc) => mc.memberName === member.name);
+                if (!hasClassification) {
+                    memberDefinitions.push({
+                        id: member.definitionId,
+                        name: member.name,
+                        kind: member.kind,
+                        actionType: null,
+                        targetEntity: null,
+                    });
+                }
+            }
+            if (memberDefinitions.length > 0) {
+                entryPointModules.push({
+                    moduleId: mod.id,
+                    modulePath: mod.fullPath,
+                    moduleName: mod.name,
+                    memberDefinitions,
+                });
+            }
+        }
+        return entryPointModules;
+    }
+}
+//# sourceMappingURL=entry-point-detector.js.map

package/dist/commands/llm/flows/entry-point-detector.js.map

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

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

@@ -0,0 +1,21 @@
+/**
+ * FlowEnhancer - LLM metadata enhancement for flows.
+ * Enriches flow suggestions with better names and descriptions using LLM.
+ */
+import type { Command } from '@oclif/core';
+import type { InteractionWithPaths } from '../../../db/schema.js';
+import type { FlowSuggestion, LlmOptions } from './types.js';
+export declare class FlowEnhancer {
+    private readonly command;
+    private readonly isJson;
+    constructor(command: Command, isJson: boolean);
+    /**
+     * Enhance flows with LLM-generated metadata.
+     */
+    enhanceFlowsWithLLM(flows: FlowSuggestion[], interactions: InteractionWithPaths[], model: string, llmOptions: LlmOptions): Promise<FlowSuggestion[]>;
+    private buildEnhancementSystemPrompt;
+    private buildEnhancementUserPrompt;
+    private stakeholderToActor;
+    private parseEnhancedFlowsCSV;
+}
+//# sourceMappingURL=flow-enhancer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flow-enhancer.d.ts","sourceRoot":"","sources":["../../../../src/commands/llm/flows/flow-enhancer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGlE,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7D,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,OAAO;IAGlC;;OAEG;IACG,mBAAmB,CACvB,KAAK,EAAE,cAAc,EAAE,EACvB,YAAY,EAAE,oBAAoB,EAAE,EACpC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,cAAc,EAAE,CAAC;IAoC5B,OAAO,CAAC,4BAA4B;IAyCpC,OAAO,CAAC,0BAA0B;IAmClC,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,qBAAqB;CA+C9B"}

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

@@ -0,0 +1,166 @@
+/**
+ * FlowEnhancer - LLM metadata enhancement for flows.
+ * Enriches flow suggestions with better names and descriptions using LLM.
+ */
+import { parseRow } from '../_shared/csv-utils.js';
+import { completeWithLogging, logLlmRequest, logLlmResponse } from '../_shared/llm-utils.js';
+export class FlowEnhancer {
+    command;
+    isJson;
+    constructor(command, isJson) {
+        this.command = command;
+        this.isJson = isJson;
+    }
+    /**
+     * Enhance flows with LLM-generated metadata.
+     */
+    async enhanceFlowsWithLLM(flows, interactions, model, llmOptions) {
+        // Separate tier-0 (atomic) flows — they keep deterministic names
+        const atomicFlows = flows.filter((f) => f.tier === 0);
+        const compositeFlows = flows.filter((f) => f.tier !== 0);
+        // If no composite flows to enhance, return all as-is
+        if (compositeFlows.length === 0)
+            return flows;
+        const interactionMap = new Map(interactions.map((i) => [i.id, i]));
+        const systemPrompt = this.buildEnhancementSystemPrompt();
+        const userPrompt = this.buildEnhancementUserPrompt(compositeFlows, interactionMap);
+        const logOptions = {
+            showRequests: llmOptions.showLlmRequests,
+            showResponses: llmOptions.showLlmResponses,
+            isJson: this.isJson,
+        };
+        logLlmRequest(this.command, 'enhanceFlowsWithLLM', systemPrompt, userPrompt, logOptions);
+        const response = await completeWithLogging({
+            model,
+            systemPrompt,
+            userPrompt,
+            temperature: 0,
+            command: this.command,
+            isJson: this.isJson,
+        });
+        logLlmResponse(this.command, 'enhanceFlowsWithLLM', response, logOptions);
+        const enhanced = this.parseEnhancedFlowsCSV(response, compositeFlows);
+        return [...atomicFlows, ...enhanced];
+    }
+    buildEnhancementSystemPrompt() {
+        return `You are creating user story names for code flows.
+
+## REQUIRED Name Format
+"[stakeholder] [verb]s [entity]"
+
+Rules:
+- Stakeholder MUST come first (user, admin, salesperson, system, developer)
+- Verb MUST match the action type:
+  - view → views, lists, browses
+  - create → creates, adds, registers
+  - update → updates, edits, modifies
+  - delete → deletes, removes
+  - process → processes, logs into, authenticates
+- Entity MUST be singular and specific (customer, vehicle, sale)
+- All lowercase sentence format
+
+## Examples
+
+GOOD:
+- "user views customer list"
+- "admin creates new vehicle"
+- "salesperson updates sale details"
+- "user deletes draft order"
+- "user logs into system"
+
+BAD (DO NOT produce):
+- "CustomerFlow" ❌ (wrong format)
+- "Vehicle Management" ❌ (too vague)
+- "views customers" ❌ (missing stakeholder)
+- "User Creates Customer" ❌ (wrong case)
+
+## Output
+\`\`\`csv
+entry_point,name,description
+handleCustomerCreate,"admin creates new customer","Validates and persists customer record"
+VehicleList,"user views vehicle inventory","Displays available vehicles with filters"
+handleDelete,"user deletes customer","Removes customer after confirmation"
+\`\`\``;
+    }
+    buildEnhancementUserPrompt(flows, interactionMap) {
+        const flowDescriptions = flows
+            .map((f, i) => {
+            const steps = f.interactionIds
+                .map((id) => {
+                const interaction = interactionMap.get(id);
+                return interaction ? `${interaction.fromModulePath} → ${interaction.toModulePath}` : '?';
+            })
+                .join(' → ');
+            const actor = this.stakeholderToActor(f.stakeholder).toLowerCase();
+            const defStepInfo = f.definitionSteps.length > 0
+                ? `\n   Definition path: ${f.definitionSteps.map((s) => `def#${s.fromDefinitionId}→def#${s.toDefinitionId}`).join(' → ')}`
+                : '';
+            const actionLine = f.actionType ? `Action: ${f.actionType}` : 'Action: unknown';
+            const entityLine = f.targetEntity ? `Entity: ${f.targetEntity}` : 'Entity: unknown';
+            return `${i + 1}. ${actionLine}, ${entityLine}, Actor: ${actor}\n   Entry: ${f.entryPath}\n   Steps: ${steps}${defStepInfo}`;
+        })
+            .join('\n\n');
+        return `## Flows to Enhance (${flows.length})
+
+${flowDescriptions}
+
+Provide enhanced names and descriptions for each flow in CSV format.
+IMPORTANT: Follow the exact format "[stakeholder] [verb]s [entity]" - all lowercase.`;
+    }
+    stakeholderToActor(stakeholder) {
+        switch (stakeholder) {
+            case 'admin':
+                return 'Admin';
+            case 'user':
+                return 'User';
+            case 'system':
+                return 'System';
+            case 'developer':
+                return 'Developer';
+            case 'external':
+                return 'External service';
+            default:
+                return 'User';
+        }
+    }
+    parseEnhancedFlowsCSV(response, originalFlows) {
+        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('entry_point'));
+        for (let i = 0; i < originalFlows.length; i++) {
+            const original = originalFlows[i];
+            if (i < lines.length) {
+                const fields = parseRow(lines[i]);
+                if (fields && fields.length >= 3) {
+                    const newName = fields[1].trim().replace(/"/g, '');
+                    const newSlug = newName
+                        .toLowerCase()
+                        .replace(/[^a-z0-9]+/g, '-')
+                        .replace(/^-|-$/g, '');
+                    // Extract stakeholder from the LLM-generated name (format: "[stakeholder] [verb]s [entity]")
+                    const validStakeholders = {
+                        user: 'user',
+                        admin: 'admin',
+                        system: 'system',
+                        developer: 'developer',
+                        external: 'external',
+                    };
+                    const firstWord = newName.split(' ')[0]?.toLowerCase();
+                    const derivedStakeholder = validStakeholders[firstWord] ?? null;
+                    results.push({
+                        ...original,
+                        name: newName || original.name,
+                        slug: newSlug || original.slug,
+                        description: fields[2].trim().replace(/"/g, '') || original.description,
+                        ...(derivedStakeholder ? { stakeholder: derivedStakeholder } : {}),
+                    });
+                    continue;
+                }
+            }
+            results.push(original);
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=flow-enhancer.js.map

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

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