@zbigniewsobiecki/squint 1.0.0

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

@@ -0,0 +1,176 @@
+/**
+ * Flow and interaction validation logic.
+ */
+export const DEFAULT_VALIDATION_OPTIONS = {
+    maxSteps: 20,
+};
+// ============================================
+// FlowValidator Class
+// ============================================
+export class FlowValidator {
+    db;
+    options;
+    constructor(db, options = DEFAULT_VALIDATION_OPTIONS) {
+        this.db = db;
+        this.options = options;
+    }
+    /**
+     * Validate a single flow.
+     */
+    validateFlow(flow) {
+        const errors = [];
+        const warnings = [];
+        // 1. Check if entry point module is valid
+        if (flow.entryPointModuleId !== null) {
+            const entryPointModule = this.db.modules.getById(flow.entryPointModuleId);
+            if (!entryPointModule) {
+                errors.push({
+                    type: 'invalid_entry_point_module',
+                    message: `Entry point module ID ${flow.entryPointModuleId} does not exist`,
+                    flowId: flow.id,
+                    flowName: flow.name,
+                });
+            }
+        }
+        // 2. Check if entry point definition is valid (if set)
+        if (flow.entryPointId !== null) {
+            const entryPoint = this.db.definitions.getById(flow.entryPointId);
+            if (!entryPoint) {
+                errors.push({
+                    type: 'invalid_entry_point',
+                    message: `Entry point definition ID ${flow.entryPointId} does not exist`,
+                    flowId: flow.id,
+                    flowName: flow.name,
+                });
+            }
+        }
+        // 3. Check steps
+        const steps = this.db.flows.getSteps(flow.id);
+        if (steps.length === 0) {
+            warnings.push({
+                type: 'no_steps',
+                message: `Flow "${flow.name}" has no interaction steps`,
+                severity: 'medium',
+            });
+        }
+        if (steps.length > this.options.maxSteps) {
+            errors.push({
+                type: 'max_steps_exceeded',
+                message: `Flow has ${steps.length} steps, exceeds maximum ${this.options.maxSteps}`,
+                flowId: flow.id,
+                flowName: flow.name,
+            });
+        }
+        // 4. Validate each step's interaction exists
+        for (const step of steps) {
+            const interaction = this.db.interactions.getById(step.interactionId);
+            if (!interaction) {
+                errors.push({
+                    type: 'invalid_interaction_id',
+                    message: `Step ${step.stepOrder} references non-existent interaction ${step.interactionId}`,
+                    flowId: flow.id,
+                    flowName: flow.name,
+                });
+            }
+        }
+        // 5. Check for missing description
+        if (!flow.description) {
+            warnings.push({
+                type: 'missing_description',
+                message: `Flow "${flow.name}" has no description`,
+                severity: 'low',
+            });
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Validate all flows in the database.
+     */
+    validateAllFlows() {
+        const flows = this.db.flows.getAll();
+        const results = new Map();
+        for (const flow of flows) {
+            results.set(flow.id, this.validateFlow(flow));
+        }
+        return results;
+    }
+    /**
+     * Find duplicate slugs.
+     */
+    findDuplicateSlugs() {
+        const flows = this.db.flows.getAll();
+        const bySlug = new Map();
+        for (const flow of flows) {
+            const list = bySlug.get(flow.slug) ?? [];
+            list.push(flow);
+            bySlug.set(flow.slug, list);
+        }
+        const duplicates = [];
+        for (const [slug, flowList] of bySlug) {
+            if (flowList.length > 1) {
+                duplicates.push({ slug, flows: flowList });
+            }
+        }
+        return duplicates;
+    }
+}
+export function validateInteraction(db, interaction) {
+    const errors = [];
+    const fromModule = db.modules.getById(interaction.fromModuleId);
+    if (!fromModule) {
+        errors.push({
+            type: 'invalid_module_id',
+            message: `From module ID ${interaction.fromModuleId} does not exist`,
+            interactionId: interaction.id,
+        });
+    }
+    const toModule = db.modules.getById(interaction.toModuleId);
+    if (!toModule) {
+        errors.push({
+            type: 'invalid_module_id',
+            message: `To module ID ${interaction.toModuleId} does not exist`,
+            interactionId: interaction.id,
+        });
+    }
+    return errors;
+}
+/**
+ * Find interactions not covered by any flow.
+ */
+export function findUncoveredInteractions(db) {
+    return db.flows.getUncoveredInteractions();
+}
+/**
+ * Find module edges that don't have interactions.
+ */
+export function findMissingInteractions(db) {
+    const moduleEdges = db.callGraph.getModuleCallGraph();
+    const interactions = db.interactions.getAll();
+    // Build set of interaction edges
+    const interactionEdges = new Set();
+    for (const interaction of interactions) {
+        interactionEdges.add(`${interaction.fromModuleId}->${interaction.toModuleId}`);
+    }
+    // Find module edges without interactions
+    const gaps = [];
+    for (const edge of moduleEdges) {
+        const key = `${edge.fromModuleId}->${edge.toModuleId}`;
+        if (!interactionEdges.has(key)) {
+            gaps.push({
+                fromModuleId: edge.fromModuleId,
+                toModuleId: edge.toModuleId,
+                fromModulePath: edge.fromModulePath,
+                toModulePath: edge.toModulePath,
+                weight: edge.weight,
+            });
+        }
+    }
+    // Sort by weight (most calls first)
+    gaps.sort((a, b) => b.weight - a.weight);
+    return gaps;
+}
+//# sourceMappingURL=flow-validation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flow-validation.js","sourceRoot":"","sources":["../../../../src/commands/llm/_shared/flow-validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,MAAM,CAAC,MAAM,0BAA0B,GAAsB;IAC3D,QAAQ,EAAE,EAAE;CACb,CAAC;AA8BF,+CAA+C;AAC/C,sBAAsB;AACtB,+CAA+C;AAE/C,MAAM,OAAO,aAAa;IAEd;IACA;IAFV,YACU,EAAiB,EACjB,UAA6B,0BAA0B;QADvD,OAAE,GAAF,EAAE,CAAe;QACjB,YAAO,GAAP,OAAO,CAAgD;IAC9D,CAAC;IAEJ;;OAEG;IACH,YAAY,CAAC,IAAU;QACrB,MAAM,MAAM,GAA0B,EAAE,CAAC;QACzC,MAAM,QAAQ,GAA4B,EAAE,CAAC;QAE7C,0CAA0C;QAC1C,IAAI,IAAI,CAAC,kBAAkB,KAAK,IAAI,EAAE,CAAC;YACrC,MAAM,gBAAgB,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAC1E,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,4BAA4B;oBAClC,OAAO,EAAE,yBAAyB,IAAI,CAAC,kBAAkB,iBAAiB;oBAC1E,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,QAAQ,EAAE,IAAI,CAAC,IAAI;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,uDAAuD;QACvD,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAClE,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,qBAAqB;oBAC3B,OAAO,EAAE,6BAA6B,IAAI,CAAC,YAAY,iBAAiB;oBACxE,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,QAAQ,EAAE,IAAI,CAAC,IAAI;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,iBAAiB;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAE9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,4BAA4B;gBACvD,QAAQ,EAAE,QAAQ;aACnB,CAAC,CAAC;QACL,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,oBAAoB;gBAC1B,OAAO,EAAE,YAAY,KAAK,CAAC,MAAM,2BAA2B,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE;gBACnF,MAAM,EAAE,IAAI,CAAC,EAAE;gBACf,QAAQ,EAAE,IAAI,CAAC,IAAI;aACpB,CAAC,CAAC;QACL,CAAC;QAED,6CAA6C;QAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACrE,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,wBAAwB;oBAC9B,OAAO,EAAE,QAAQ,IAAI,CAAC,SAAS,wCAAwC,IAAI,CAAC,aAAa,EAAE;oBAC3F,MAAM,EAAE,IAAI,CAAC,EAAE;oBACf,QAAQ,EAAE,IAAI,CAAC,IAAI;iBACpB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,qBAAqB;gBAC3B,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,sBAAsB;gBACjD,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC1B,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;QAExD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QAEzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACzC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,UAAU,GAA2C,EAAE,CAAC;QAC9D,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC;YACtC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF;AAYD,MAAM,UAAU,mBAAmB,CAAC,EAAiB,EAAE,WAAwB;IAC7E,MAAM,MAAM,GAAiC,EAAE,CAAC;IAEhD,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAChE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,kBAAkB,WAAW,CAAC,YAAY,iBAAiB;YACpE,aAAa,EAAE,WAAW,CAAC,EAAE;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC5D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,gBAAgB,WAAW,CAAC,UAAU,iBAAiB;YAChE,aAAa,EAAE,WAAW,CAAC,EAAE;SAC9B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAcD;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,EAAiB;IACzD,OAAO,EAAE,CAAC,KAAK,CAAC,wBAAwB,EAAE,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,EAAiB;IACvD,MAAM,WAAW,GAAG,EAAE,CAAC,SAAS,CAAC,kBAAkB,EAAE,CAAC;IACtD,MAAM,YAAY,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;IAE9C,iCAAiC;IACjC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC3C,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,gBAAgB,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,YAAY,KAAK,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,yCAAyC;IACzC,MAAM,IAAI,GAAkB,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;QACvD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC;gBACR,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IAEzC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/commands/llm/_shared/llm-utils.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Shared utilities for LLM commands.
+ * Consolidates duplicate patterns from flows.ts, interactions.ts, annotate.ts, etc.
+ */
+import type { Command } from '@oclif/core';
+/**
+ * Safely extract error message from unknown error type.
+ * Replaces the duplicated `error instanceof Error ? error.message : String(error)` pattern.
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Calculate percentage with safety for division by zero.
+ */
+export declare function calculatePercentage(value: number, total: number, decimals?: number): number;
+/**
+ * Create a lookup map from an array using a key function.
+ */
+export declare function createLookup<T, K>(items: T[], keyFn: (item: T) => K): Map<K, T>;
+/**
+ * Create a multi-value lookup map (groupBy) from an array.
+ */
+export declare function groupBy<T, K>(items: T[], keyFn: (item: T) => K): Map<K, T[]>;
+/**
+ * LLM request/response logging utilities.
+ */
+export interface LlmLogOptions {
+    showRequests: boolean;
+    showResponses: boolean;
+    isJson: boolean;
+}
+/**
+ * Display LLM request details if enabled.
+ */
+export declare function logLlmRequest(command: Command, methodName: string, systemPrompt: string, userPrompt: string, options: LlmLogOptions): void;
+/**
+ * Display LLM response details if enabled.
+ */
+export declare function logLlmResponse(command: Command, methodName: string, response: string, options: LlmLogOptions): void;
+/**
+ * Log a warning message (for both JSON and non-JSON modes).
+ */
+export declare function logWarning(command: Command, message: string, isJson: boolean): void;
+/**
+ * Log an error message (for both JSON and non-JSON modes).
+ */
+export declare function logError(command: Command, message: string, hint: string | null, isJson: boolean): void;
+/**
+ * Log a step header for non-JSON output.
+ */
+export declare function logStep(command: Command, step: number, title: string, isJson: boolean): void;
+/**
+ * Log verbose progress message.
+ */
+export declare function logVerbose(command: Command, message: string, verbose: boolean, isJson: boolean): void;
+/**
+ * Log a section header.
+ */
+export declare function logSection(command: Command, title: string, isJson: boolean): void;
+/**
+ * Batch processing helper - processes items in batches with progress reporting.
+ */
+export interface BatchProcessOptions<T, R> {
+    items: T[];
+    batchSize: number;
+    processBatch: (batch: T[], batchIndex: number) => Promise<R[]>;
+    onBatchComplete?: (results: R[], batchIndex: number, totalBatches: number) => void;
+    onBatchError?: (error: unknown, batch: T[], batchIndex: number) => R[] | null;
+}
+export declare function processBatches<T, R>(options: BatchProcessOptions<T, R>): Promise<R[]>;
+export interface CompleteWithLoggingOptions {
+    model: string;
+    systemPrompt: string;
+    userPrompt: string;
+    temperature?: number;
+    maxTokens?: number;
+    command: Command;
+    isJson: boolean;
+    iteration?: {
+        current: number;
+        max: number;
+    };
+}
+export declare function completeWithLogging(options: CompleteWithLoggingOptions): Promise<string>;
+/**
+ * Generate a unique slug from a name, handling duplicates.
+ */
+export declare function generateUniqueSlug(baseName: string, usedSlugs: Set<string>): string;
+//# sourceMappingURL=llm-utils.d.ts.map

package/dist/commands/llm/_shared/llm-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-utils.d.ts","sourceRoot":"","sources":["../../../../src/commands/llm/_shared/llm-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAGtF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAM/E;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAS5E;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,aAAa,GACrB,IAAI,CAcN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAUnH;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAMnF;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAStG;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAK5F;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAIrG;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAKjF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,EAAE,CAAC;IACvC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/D,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACnF,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC;CAC/E;AAED,wBAAsB,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CA6B3F;AAYD,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAsBD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAyD9F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAmBnF"}

package/dist/commands/llm/_shared/llm-utils.js

@@ -0,0 +1,256 @@
+/**
+ * Shared utilities for LLM commands.
+ * Consolidates duplicate patterns from flows.ts, interactions.ts, annotate.ts, etc.
+ */
+import chalk from 'chalk';
+import { LLMist, resolveModel } from 'llmist';
+/**
+ * Safely extract error message from unknown error type.
+ * Replaces the duplicated `error instanceof Error ? error.message : String(error)` pattern.
+ */
+export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+/**
+ * Calculate percentage with safety for division by zero.
+ */
+export function calculatePercentage(value, total, decimals = 1) {
+    if (total === 0)
+        return 0;
+    return Number(((value / total) * 100).toFixed(decimals));
+}
+/**
+ * Create a lookup map from an array using a key function.
+ */
+export function createLookup(items, keyFn) {
+    const map = new Map();
+    for (const item of items) {
+        map.set(keyFn(item), item);
+    }
+    return map;
+}
+/**
+ * Create a multi-value lookup map (groupBy) from an array.
+ */
+export function groupBy(items, keyFn) {
+    const map = new Map();
+    for (const item of items) {
+        const key = keyFn(item);
+        const existing = map.get(key) ?? [];
+        existing.push(item);
+        map.set(key, existing);
+    }
+    return map;
+}
+/**
+ * Display LLM request details if enabled.
+ */
+export function logLlmRequest(command, methodName, systemPrompt, userPrompt, options) {
+    if (options.isJson || !options.showRequests)
+        return;
+    command.log('');
+    command.log(chalk.bold.cyan('═'.repeat(60)));
+    command.log(chalk.bold.cyan(`LLM REQUEST - ${methodName}`));
+    command.log(chalk.bold.cyan('═'.repeat(60)));
+    command.log('');
+    command.log(chalk.cyan('System Prompt:'));
+    command.log(chalk.gray(systemPrompt));
+    command.log('');
+    command.log(chalk.cyan('User Prompt:'));
+    command.log(chalk.gray(userPrompt));
+    command.log('');
+}
+/**
+ * Display LLM response details if enabled.
+ */
+export function logLlmResponse(command, methodName, response, options) {
+    if (options.isJson || !options.showResponses)
+        return;
+    command.log('');
+    command.log(chalk.bold.green('═'.repeat(60)));
+    command.log(chalk.bold.green(`LLM RESPONSE - ${methodName}`));
+    command.log(chalk.bold.green('═'.repeat(60)));
+    command.log('');
+    command.log(chalk.gray(response));
+    command.log('');
+}
+/**
+ * Log a warning message (for both JSON and non-JSON modes).
+ */
+export function logWarning(command, message, isJson) {
+    if (isJson) {
+        command.log(JSON.stringify({ warning: message }));
+    }
+    else {
+        command.log(chalk.yellow(message));
+    }
+}
+/**
+ * Log an error message (for both JSON and non-JSON modes).
+ */
+export function logError(command, message, hint, isJson) {
+    if (isJson) {
+        command.log(JSON.stringify({ error: message, ...(hint && { hint }) }));
+    }
+    else {
+        command.log(chalk.red(message));
+        if (hint) {
+            command.log(chalk.gray(hint));
+        }
+    }
+}
+/**
+ * Log a step header for non-JSON output.
+ */
+export function logStep(command, step, title, isJson) {
+    if (!isJson) {
+        if (step > 1)
+            command.log('');
+        command.log(chalk.bold(`Step ${step}: ${title}`));
+    }
+}
+/**
+ * Log verbose progress message.
+ */
+export function logVerbose(command, message, verbose, isJson) {
+    if (!isJson && verbose) {
+        command.log(chalk.gray(message));
+    }
+}
+/**
+ * Log a section header.
+ */
+export function logSection(command, title, isJson) {
+    if (!isJson) {
+        command.log('');
+        command.log(chalk.bold(title));
+    }
+}
+export async function processBatches(options) {
+    const { items, batchSize, processBatch, onBatchComplete, onBatchError } = options;
+    const results = [];
+    const totalBatches = Math.ceil(items.length / batchSize);
+    for (let i = 0; i < items.length; i += batchSize) {
+        const batch = items.slice(i, i + batchSize);
+        const batchIndex = Math.floor(i / batchSize);
+        try {
+            const batchResults = await processBatch(batch, batchIndex);
+            results.push(...batchResults);
+            if (onBatchComplete) {
+                onBatchComplete(batchResults, batchIndex, totalBatches);
+            }
+        }
+        catch (error) {
+            if (onBatchError) {
+                const fallbackResults = onBatchError(error, batch, batchIndex);
+                if (fallbackResults) {
+                    results.push(...fallbackResults);
+                }
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// completeWithLogging – wraps every LLM call with one-line before/after logs
+// ---------------------------------------------------------------------------
+let _client = null;
+function getClient() {
+    if (!_client)
+        _client = new LLMist();
+    return _client;
+}
+function formatNumber(n) {
+    return n.toLocaleString('en-US');
+}
+function formatIterationTag(iter) {
+    if (!iter)
+        return '';
+    if (iter.max === 0)
+        return `  [${iter.current}]`;
+    return `  [${iter.current}/${iter.max}]`;
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+function formatCost(cost) {
+    if (cost < 0.01)
+        return `$${cost.toFixed(4)}`;
+    return `$${cost.toFixed(2)}`;
+}
+export async function completeWithLogging(options) {
+    const { model, systemPrompt, userPrompt, temperature, maxTokens, command, isJson, iteration } = options;
+    const estTokens = Math.round((systemPrompt.length + userPrompt.length) / 4);
+    const iterTag = formatIterationTag(iteration);
+    if (!isJson) {
+        command.log(chalk.gray(`  → LLM  ${model}  ~${formatNumber(estTokens)} tok${iterTag}`));
+    }
+    const resolvedModel = resolveModel(model);
+    const messages = [
+        { role: 'system', content: systemPrompt },
+        { role: 'user', content: userPrompt },
+    ];
+    const client = getClient();
+    const startTime = Date.now();
+    let text = '';
+    let usage;
+    const stream = client.stream({
+        model: resolvedModel,
+        messages,
+        ...(temperature !== undefined && { temperature }),
+        ...(maxTokens !== undefined && { maxTokens }),
+    });
+    for await (const chunk of stream) {
+        text += chunk.text;
+        if (chunk.usage) {
+            usage = chunk.usage;
+        }
+    }
+    const duration = Date.now() - startTime;
+    if (!isJson) {
+        const inputTokens = usage?.inputTokens ?? 0;
+        const outputTokens = usage?.outputTokens ?? 0;
+        const cachedTokens = usage?.cachedInputTokens ?? 0;
+        const costEstimate = client.modelRegistry.estimateCost(resolvedModel, inputTokens, outputTokens, cachedTokens);
+        const costStr = costEstimate ? formatCost(costEstimate.totalCost) : '?';
+        const parts = [
+            `  ← LLM  ${formatDuration(duration)}`,
+            `in: ${formatNumber(inputTokens)}`,
+            `out: ${formatNumber(outputTokens)}`,
+            `cached: ${formatNumber(cachedTokens)}`,
+            costStr,
+        ];
+        command.log(chalk.gray(parts.join('  ') + iterTag));
+    }
+    return text.trim();
+}
+/**
+ * Generate a unique slug from a name, handling duplicates.
+ */
+export function generateUniqueSlug(baseName, usedSlugs) {
+    const slug = baseName
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+    if (!usedSlugs.has(slug)) {
+        usedSlugs.add(slug);
+        return slug;
+    }
+    let counter = 1;
+    while (usedSlugs.has(`${slug}-${counter}`)) {
+        counter++;
+    }
+    const uniqueSlug = `${slug}-${counter}`;
+    usedSlugs.add(uniqueSlug);
+    return uniqueSlug;
+}
+//# sourceMappingURL=llm-utils.js.map

package/dist/commands/llm/_shared/llm-utils.js.map

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

package/dist/commands/llm/_shared/module-csv.d.ts

@@ -0,0 +1,76 @@
+/**
+ * CSV parsing for module tree and symbol assignment LLM responses.
+ */
+export { formatCsvValue } from './csv-utils.js';
+/**
+ * Normalize an LLM-returned module path before validation.
+ *
+ * Fixes common LLM formatting quirks:
+ * - Strips backticks and surrounding quotes
+ * - Lowercases each segment
+ * - Replaces underscores with hyphens
+ * - Trims whitespace within segments
+ * - Collapses consecutive dots
+ */
+export declare function normalizeModulePath(raw: string): string;
+/**
+ * Validate a module slug.
+ * Rules: ^[a-z][a-z0-9-]*$, max 50 chars, no consecutive/trailing hyphens
+ */
+export declare function isValidSlug(slug: string): boolean;
+/**
+ * Validate a module path.
+ * Rules: Must start with "project", dot-separated valid slugs
+ */
+export declare function isValidModulePath(path: string): boolean;
+export interface ModuleDefinitionRow {
+    parentPath: string;
+    slug: string;
+    name: string;
+    description: string;
+    isTest: boolean;
+}
+export interface TreeParseResult {
+    modules: ModuleDefinitionRow[];
+    errors: string[];
+}
+/**
+ * Parse Phase 1 LLM response (tree structure).
+ * Expected CSV format: type,parent_path,slug,name,description,is_test
+ * Also accepts legacy 5-column format without is_test.
+ */
+export declare function parseTreeCsv(content: string): TreeParseResult;
+export interface SymbolAssignmentRow {
+    symbolId: number;
+    modulePath: string;
+}
+export interface AssignmentParseResult {
+    assignments: SymbolAssignmentRow[];
+    errors: string[];
+}
+/**
+ * Parse Phase 2 LLM response (symbol assignments).
+ * Expected CSV format: type,symbol_id,module_path
+ */
+export declare function parseAssignmentCsv(content: string): AssignmentParseResult;
+export interface DeepenModuleRow {
+    parentPath: string;
+    slug: string;
+    name: string;
+    description: string;
+}
+export interface DeepenReassignRow {
+    definitionId: number;
+    targetModulePath: string;
+}
+export interface DeepenParseResult {
+    newModules: DeepenModuleRow[];
+    reassignments: DeepenReassignRow[];
+    errors: string[];
+}
+/**
+ * Parse Phase 3 LLM response (deepen/split modules).
+ * Expected CSV format: type,parent_path,slug,name,description,definition_id
+ */
+export declare function parseDeepenCsv(content: string): DeepenParseResult;
+//# sourceMappingURL=module-csv.d.ts.map

package/dist/commands/llm/_shared/module-csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-csv.d.ts","sourceRoot":"","sources":["../../../../src/commands/llm/_shared/module-csv.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMhD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgBvD;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIvD;AAMD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CA+C7D;AAMD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAiCzE;AAMD,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAmDjE"}