@zbigniewsobiecki/squint 1.0.0

package/dist/commands/interactions/verify.js

@@ -0,0 +1,127 @@
+import { Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { LlmFlags, SharedFlags } from '../_shared/index.js';
+import { BaseLlmCommand } from '../llm/_shared/base-llm-command.js';
+import { computeProcessGroups } from '../llm/_shared/process-utils.js';
+import { checkInteractionQuality, checkReferentialIntegrity } from '../llm/_shared/verify/coverage-checker.js';
+export default class InteractionsVerify extends BaseLlmCommand {
+    static description = 'Verify existing interactions';
+    static examples = [
+        '<%= config.bin %> interactions verify',
+        '<%= config.bin %> interactions verify --fix',
+        '<%= config.bin %> interactions verify -d index.db --verbose',
+    ];
+    static flags = {
+        database: SharedFlags.database,
+        json: SharedFlags.json,
+        ...LlmFlags,
+        fix: Flags.boolean({
+            description: 'Auto-fix structural issues found during verification',
+            default: false,
+        }),
+    };
+    async execute(ctx, flags) {
+        const { db, isJson, dryRun } = ctx;
+        const shouldFix = flags.fix;
+        if (!isJson) {
+            this.log(chalk.bold('Interaction Quality Verification'));
+            this.log('');
+        }
+        // Run referential integrity check first
+        const ghostResult = checkReferentialIntegrity(db);
+        const processGroups = computeProcessGroups(db);
+        const result = checkInteractionQuality(db, processGroups);
+        // Merge ghost issues into result
+        result.issues.unshift(...ghostResult.issues);
+        result.stats.structuralIssueCount += ghostResult.stats.structuralIssueCount;
+        if (!ghostResult.passed)
+            result.passed = false;
+        if (!isJson) {
+            const errorIssues = result.issues.filter((i) => i.severity === 'error');
+            const warningIssues = result.issues.filter((i) => i.severity === 'warning');
+            const infoIssues = result.issues.filter((i) => i.severity === 'info');
+            if (errorIssues.length > 0) {
+                this.log(chalk.red(`  Errors (${errorIssues.length}):`));
+                for (const issue of errorIssues.slice(0, 30)) {
+                    this.log(`    ${chalk.red('ERR')}  [${issue.category}] ${issue.message}`);
+                }
+                if (errorIssues.length > 30) {
+                    this.log(chalk.gray(`    ... and ${errorIssues.length - 30} more`));
+                }
+                this.log('');
+            }
+            if (warningIssues.length > 0) {
+                this.log(chalk.yellow(`  Warnings (${warningIssues.length}):`));
+                for (const issue of warningIssues.slice(0, 30)) {
+                    this.log(`    ${chalk.yellow('WARN')} [${issue.category}] ${issue.message}`);
+                }
+                if (warningIssues.length > 30) {
+                    this.log(chalk.gray(`    ... and ${warningIssues.length - 30} more`));
+                }
+                this.log('');
+            }
+            if (infoIssues.length > 0) {
+                this.log(chalk.gray(`  Info (${infoIssues.length}):`));
+                for (const issue of infoIssues.slice(0, 30)) {
+                    this.log(`    ${chalk.gray('INFO')} [${issue.category}] ${issue.message}`);
+                }
+                if (infoIssues.length > 30) {
+                    this.log(chalk.gray(`    ... and ${infoIssues.length - 30} more`));
+                }
+                this.log('');
+            }
+            if (result.passed) {
+                this.log(chalk.green('  \u2713 All interactions passed verification'));
+            }
+            else {
+                this.log(chalk.red(`  \u2717 Verification failed: ${result.stats.structuralIssueCount} structural issues`));
+            }
+        }
+        // Auto-fix
+        if (shouldFix && !dryRun) {
+            let fixed = 0;
+            for (const issue of result.issues) {
+                if (!issue.fixData)
+                    continue;
+                if (issue.fixData.action === 'remove-ghost' && issue.fixData.ghostTable && issue.fixData.ghostRowId) {
+                    const deleted = db.deleteGhostRow(issue.fixData.ghostTable, issue.fixData.ghostRowId);
+                    if (deleted)
+                        fixed++;
+                }
+                if (issue.fixData.action === 'remove-interaction' && issue.fixData.interactionId) {
+                    const deleted = db.interactions.delete(issue.fixData.interactionId);
+                    if (deleted)
+                        fixed++;
+                }
+                if (issue.fixData.action === 'rebuild-symbols' && issue.fixData.interactionId) {
+                    const interaction = db.interactions.getById(issue.fixData.interactionId);
+                    if (interaction) {
+                        const importedSymbols = db.interactions.getModuleImportedSymbols(interaction.fromModuleId, interaction.toModuleId);
+                        if (importedSymbols.length > 0) {
+                            db.interactions.update(issue.fixData.interactionId, {
+                                symbols: importedSymbols.map((s) => s.name),
+                            });
+                            fixed++;
+                        }
+                    }
+                }
+                if (issue.fixData.action === 'set-direction-uni' && issue.fixData.interactionId) {
+                    const updated = db.interactions.update(issue.fixData.interactionId, { direction: 'uni' });
+                    if (updated)
+                        fixed++;
+                }
+                if (issue.fixData.action === 'remove-inferred-to-module' && issue.fixData.targetModuleId) {
+                    const removed = db.interactions.removeInferredToModule(issue.fixData.targetModuleId);
+                    fixed += removed;
+                }
+            }
+            if (fixed > 0 && !isJson) {
+                this.log(chalk.green(`  Fixed: ${fixed} issues auto-corrected`));
+            }
+        }
+        if (isJson) {
+            this.log(JSON.stringify(result, null, 2));
+        }
+    }
+}
+//# sourceMappingURL=verify.js.map

package/dist/commands/interactions/verify.js.map

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

package/dist/commands/llm/_shared/base-llm-command.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Base class for LLM commands that share common patterns:
+ * - Database open/close lifecycle
+ * - Flag unpacking into a typed LlmContext
+ * - Header logging
+ * - Existence check + force/clear pattern
+ */
+import { Command } from '@oclif/core';
+import type { IndexDatabase } from '../../../db/database.js';
+export interface LlmContext {
+    db: IndexDatabase;
+    isJson: boolean;
+    dryRun: boolean;
+    verbose: boolean;
+    model: string;
+    llmOptions: {
+        showLlmRequests: boolean;
+        showLlmResponses: boolean;
+    };
+}
+export declare abstract class BaseLlmCommand extends Command {
+    /**
+     * Subclasses implement this instead of run().
+     * The db is opened before and closed after (in finally).
+     */
+    protected abstract execute(ctx: LlmContext, flags: Record<string, unknown>): Promise<void>;
+    run(): Promise<void>;
+    /**
+     * Print a bold title + gray model line.
+     */
+    protected logHeader(ctx: LlmContext, title: string): void;
+    /**
+     * Handle the existence check + force/clear pattern.
+     * Returns true if the command should continue, false if it should return early.
+     */
+    protected checkExistingAndClear(ctx: LlmContext, opts: {
+        entityName: string;
+        existingCount: number;
+        force: boolean;
+        clearFn: () => void;
+        forceHint?: string;
+    }): boolean;
+}
+//# sourceMappingURL=base-llm-command.d.ts.map

package/dist/commands/llm/_shared/base-llm-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-llm-command.d.ts","sourceRoot":"","sources":["../../../../src/commands/llm/_shared/base-llm-command.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,aAAa,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE;QAAE,eAAe,EAAE,OAAO,CAAC;QAAC,gBAAgB,EAAE,OAAO,CAAA;KAAE,CAAC;CACrE;AAED,8BAAsB,cAAe,SAAQ,OAAO;IAClD;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAE7E,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBjC;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQzD;;;OAGG;IACH,SAAS,CAAC,qBAAqB,CAC7B,GAAG,EAAE,UAAU,EACf,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,EAAE,MAAM,IAAI,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GACA,OAAO;CA6BX"}

package/dist/commands/llm/_shared/base-llm-command.js

@@ -0,0 +1,73 @@
+/**
+ * Base class for LLM commands that share common patterns:
+ * - Database open/close lifecycle
+ * - Flag unpacking into a typed LlmContext
+ * - Header logging
+ * - Existence check + force/clear pattern
+ */
+import { Command } from '@oclif/core';
+import chalk from 'chalk';
+import { openDatabase } from '../../_shared/index.js';
+export class BaseLlmCommand extends Command {
+    async run() {
+        const { flags } = await this.parse(this.constructor);
+        const db = await openDatabase(flags.database, this);
+        const ctx = {
+            db,
+            isJson: flags.json,
+            dryRun: flags['dry-run'],
+            verbose: flags.verbose,
+            model: flags.model,
+            llmOptions: {
+                showLlmRequests: flags['show-llm-requests'],
+                showLlmResponses: flags['show-llm-responses'],
+            },
+        };
+        try {
+            await this.execute(ctx, flags);
+        }
+        finally {
+            db.close();
+        }
+    }
+    /**
+     * Print a bold title + gray model line.
+     */
+    logHeader(ctx, title) {
+        if (!ctx.isJson) {
+            this.log(chalk.bold(title));
+            this.log(chalk.gray(`Model: ${ctx.model}`));
+            this.log('');
+        }
+    }
+    /**
+     * Handle the existence check + force/clear pattern.
+     * Returns true if the command should continue, false if it should return early.
+     */
+    checkExistingAndClear(ctx, opts) {
+        const { entityName, existingCount, force, clearFn, forceHint } = opts;
+        const hint = forceHint ?? 'Use --force to re-run';
+        if (existingCount > 0 && !force) {
+            if (ctx.isJson) {
+                this.log(JSON.stringify({
+                    error: `${entityName} already exist`,
+                    count: existingCount,
+                    hint,
+                }));
+            }
+            else {
+                this.log(chalk.yellow(`${existingCount} ${entityName.toLowerCase()} already exist.`));
+                this.log(chalk.gray(`${hint}.`));
+            }
+            return false;
+        }
+        if (existingCount > 0 && force && !ctx.dryRun) {
+            clearFn();
+            if (!ctx.isJson && ctx.verbose) {
+                this.log(chalk.gray(`Cleared ${existingCount} existing ${entityName.toLowerCase()}`));
+            }
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=base-llm-command.js.map

package/dist/commands/llm/_shared/base-llm-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-llm-command.js","sourceRoot":"","sources":["../../../../src/commands/llm/_shared/base-llm-command.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAWtD,MAAM,OAAgB,cAAe,SAAQ,OAAO;IAO3C,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAoC,CAAC,CAAC;QAE9E,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,QAA8B,EAAE,IAAI,CAAC,CAAC;QAC1E,MAAM,GAAG,GAAe;YACtB,EAAE;YACF,MAAM,EAAE,KAAK,CAAC,IAAe;YAC7B,MAAM,EAAE,KAAK,CAAC,SAAS,CAAY;YACnC,OAAO,EAAE,KAAK,CAAC,OAAkB;YACjC,KAAK,EAAE,KAAK,CAAC,KAAe;YAC5B,UAAU,EAAE;gBACV,eAAe,EAAE,KAAK,CAAC,mBAAmB,CAAY;gBACtD,gBAAgB,EAAE,KAAK,CAAC,oBAAoB,CAAY;aACzD;SACF,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;IACH,CAAC;IAED;;OAEG;IACO,SAAS,CAAC,GAAe,EAAE,KAAa;QAChD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC5C,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;OAGG;IACO,qBAAqB,CAC7B,GAAe,EACf,IAMC;QAED,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QACtE,MAAM,IAAI,GAAG,SAAS,IAAI,uBAAuB,CAAC;QAElD,IAAI,aAAa,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBACf,IAAI,CAAC,GAAG,CACN,IAAI,CAAC,SAAS,CAAC;oBACb,KAAK,EAAE,GAAG,UAAU,gBAAgB;oBACpC,KAAK,EAAE,aAAa;oBACpB,IAAI;iBACL,CAAC,CACH,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,aAAa,IAAI,UAAU,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC;gBACtF,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;YACnC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,aAAa,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAC9C,OAAO,EAAE,CAAC;YACV,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC/B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,aAAa,aAAa,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/commands/llm/_shared/coverage.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Coverage display utilities for LLM annotation.
+ */
+export interface CoverageInfo {
+    aspect: string;
+    covered: number;
+    total: number;
+    percentage: number;
+}
+export interface AnnotationResult {
+    symbolId: number;
+    symbolName: string;
+    aspect: string;
+    value: string;
+    success: boolean;
+    error?: string;
+}
+export interface RelationshipAnnotationResult {
+    fromId: number;
+    fromName: string;
+    toId: number;
+    toName: string;
+    value: string;
+    success: boolean;
+    error?: string;
+}
+export interface RelationshipCoverageInfo {
+    annotated: number;
+    total: number;
+    percentage: number;
+}
+export interface IterationSummary {
+    iteration: number;
+    results: AnnotationResult[];
+    relationshipResults: RelationshipAnnotationResult[];
+    coverage: CoverageInfo[];
+    relationshipCoverage: RelationshipCoverageInfo;
+    readyCount: number;
+    blockedCount: number;
+}
+/**
+ * Format coverage stats as a single line.
+ */
+export declare function formatCoverageLine(coverage: CoverageInfo): string;
+/**
+ * Format all coverage stats.
+ */
+export declare function formatCoverageStats(coverage: CoverageInfo[], previousCoverage?: CoverageInfo[]): string[];
+/**
+ * Format iteration results.
+ */
+export declare function formatIterationResults(summary: IterationSummary): string[];
+/**
+ * Format final summary.
+ */
+export declare function formatFinalSummary(totalAnnotations: number, totalRelationshipAnnotations: number, totalErrors: number, iterations: number, coverage: CoverageInfo[], relationshipCoverage: RelationshipCoverageInfo): string[];
+/**
+ * Build coverage info for specified aspects from database coverage data.
+ */
+export declare function filterCoverageForAspects(allCoverage: CoverageInfo[], aspects: string[], totalSymbols: number): CoverageInfo[];
+//# sourceMappingURL=coverage.d.ts.map

package/dist/commands/llm/_shared/coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../../../../src/commands/llm/_shared/coverage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,mBAAmB,EAAE,4BAA4B,EAAE,CAAC;IACpD,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,oBAAoB,EAAE,wBAAwB,CAAC;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAKjE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,gBAAgB,CAAC,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAqBzG;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAyF1E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,gBAAgB,EAAE,MAAM,EACxB,4BAA4B,EAAE,MAAM,EACpC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,YAAY,EAAE,EACxB,oBAAoB,EAAE,wBAAwB,GAC7C,MAAM,EAAE,CA+BV;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,YAAY,EAAE,EAC3B,OAAO,EAAE,MAAM,EAAE,EACjB,YAAY,EAAE,MAAM,GACnB,YAAY,EAAE,CAmBhB"}

package/dist/commands/llm/_shared/coverage.js

@@ -0,0 +1,161 @@
+/**
+ * Coverage display utilities for LLM annotation.
+ */
+import chalk from 'chalk';
+/**
+ * Format coverage stats as a single line.
+ */
+export function formatCoverageLine(coverage) {
+    const percentage = coverage.percentage.toFixed(1);
+    const percentColor = coverage.percentage >= 80 ? chalk.green : coverage.percentage >= 50 ? chalk.yellow : chalk.red;
+    return `${coverage.aspect}: ${coverage.covered}/${coverage.total} (${percentColor(`${percentage}%`)})`;
+}
+/**
+ * Format all coverage stats.
+ */
+export function formatCoverageStats(coverage, previousCoverage) {
+    const lines = [];
+    for (const c of coverage) {
+        let line = formatCoverageLine(c);
+        // Add delta if we have previous coverage
+        if (previousCoverage) {
+            const prev = previousCoverage.find((p) => p.aspect === c.aspect);
+            if (prev) {
+                const delta = c.covered - prev.covered;
+                if (delta > 0) {
+                    line += chalk.green(` [+${delta} this iteration]`);
+                }
+            }
+        }
+        lines.push(line);
+    }
+    return lines;
+}
+/**
+ * Format iteration results.
+ */
+export function formatIterationResults(summary) {
+    const lines = [];
+    lines.push('');
+    lines.push(chalk.bold(`Iteration ${summary.iteration}:`));
+    // Group symbol results by symbol
+    const bySymbol = new Map();
+    for (const result of summary.results) {
+        const existing = bySymbol.get(result.symbolId) || [];
+        existing.push(result);
+        bySymbol.set(result.symbolId, existing);
+    }
+    // Group relationship results by from symbol
+    const relsBySymbol = new Map();
+    for (const rel of summary.relationshipResults) {
+        const existing = relsBySymbol.get(rel.fromId) || [];
+        existing.push(rel);
+        relsBySymbol.set(rel.fromId, existing);
+    }
+    // Output results grouped by symbol
+    for (const [symbolId, results] of bySymbol) {
+        const firstResult = results[0];
+        const allSuccessful = results.every((r) => r.success);
+        const icon = allSuccessful ? chalk.green('✓') : chalk.red('✗');
+        // Show first successful value (usually purpose)
+        const purposeResult = results.find((r) => r.aspect === 'purpose' && r.success);
+        const displayValue = purposeResult ? `: "${purposeResult.value}"` : '';
+        lines.push(`  ${icon} ${firstResult.symbolName}${displayValue}`);
+        // Show aspect annotations (not purpose since it's already shown)
+        for (const result of results) {
+            if (result.success && result.aspect !== 'purpose') {
+                lines.push(`    ${result.aspect}: ${result.value}`);
+            }
+        }
+        // Show relationship annotations for this symbol
+        const symbolRels = relsBySymbol.get(symbolId) || [];
+        for (const rel of symbolRels) {
+            if (rel.success) {
+                lines.push(`    ${chalk.cyan('→')} ${rel.toName}: "${rel.value}"`);
+            }
+        }
+        // Show any errors
+        for (const result of results) {
+            if (!result.success && result.error) {
+                lines.push(`    ${chalk.red('└')} ${result.aspect}: ${result.error}`);
+            }
+        }
+        for (const rel of symbolRels) {
+            if (!rel.success && rel.error) {
+                lines.push(`    ${chalk.red('└')} → ${rel.toName}: ${rel.error}`);
+            }
+        }
+    }
+    // Show errors for missing symbols
+    const symbolIds = new Set(summary.results.map((r) => r.symbolId));
+    if (symbolIds.size === 0 && summary.results.length === 0) {
+        lines.push(`  ${chalk.yellow('No annotations received from LLM')}`);
+    }
+    lines.push('');
+    // Coverage
+    lines.push(chalk.dim('Coverage:'));
+    for (const line of formatCoverageStats(summary.coverage)) {
+        lines.push(`  ${line}`);
+    }
+    // Add relationship coverage
+    const relCov = summary.relationshipCoverage;
+    const relPercentColor = relCov.percentage >= 80 ? chalk.green : relCov.percentage >= 50 ? chalk.yellow : chalk.red;
+    lines.push(`  relationships: ${relCov.annotated}/${relCov.total} (${relPercentColor(`${relCov.percentage.toFixed(1)}%`)})`);
+    // Ready/blocked counts
+    lines.push('');
+    lines.push(`Ready: ${chalk.cyan(summary.readyCount)} symbols | Blocked: ${chalk.gray(summary.blockedCount)} (unmet deps)`);
+    return lines;
+}
+/**
+ * Format final summary.
+ */
+export function formatFinalSummary(totalAnnotations, totalRelationshipAnnotations, totalErrors, iterations, coverage, relationshipCoverage) {
+    const lines = [];
+    lines.push('');
+    lines.push(chalk.bold('═'.repeat(50)));
+    lines.push(chalk.bold('Annotation Complete'));
+    lines.push(chalk.bold('═'.repeat(50)));
+    lines.push('');
+    lines.push(`Total iterations: ${iterations}`);
+    lines.push(`Symbol annotations created: ${chalk.green(totalAnnotations)}`);
+    lines.push(`Relationship annotations created: ${chalk.green(totalRelationshipAnnotations)}`);
+    if (totalErrors > 0) {
+        lines.push(`Errors: ${chalk.red(totalErrors)}`);
+    }
+    lines.push('');
+    lines.push(chalk.bold('Final Coverage:'));
+    for (const c of coverage) {
+        lines.push(`  ${formatCoverageLine(c)}`);
+    }
+    // Add relationship coverage
+    const relPercentColor = relationshipCoverage.percentage >= 80
+        ? chalk.green
+        : relationshipCoverage.percentage >= 50
+            ? chalk.yellow
+            : chalk.red;
+    lines.push(`  relationships: ${relationshipCoverage.annotated}/${relationshipCoverage.total} (${relPercentColor(`${relationshipCoverage.percentage.toFixed(1)}%`)})`);
+    return lines;
+}
+/**
+ * Build coverage info for specified aspects from database coverage data.
+ */
+export function filterCoverageForAspects(allCoverage, aspects, totalSymbols) {
+    const result = [];
+    for (const aspect of aspects) {
+        const existing = allCoverage.find((c) => c.aspect === aspect);
+        if (existing) {
+            result.push(existing);
+        }
+        else {
+            // Aspect not in use yet
+            result.push({
+                aspect,
+                covered: 0,
+                total: totalSymbols,
+                percentage: 0,
+            });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=coverage.js.map

package/dist/commands/llm/_shared/coverage.js.map

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

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

@@ -0,0 +1,65 @@
+/**
+ * Unified CSV utilities for LLM response parsing.
+ * Consolidates duplicate CSV parsing logic from flows.ts, interactions.ts, and other files.
+ * Implements RFC 4180 compliant parsing.
+ */
+/**
+ * Extract CSV content from LLM response (removes code fences).
+ */
+export declare function extractCsvContent(content: string): string;
+/**
+ * Split CSV content into logical lines, handling multi-line quoted values.
+ * RFC 4180 compliant - handles escaped quotes and multi-line values.
+ */
+export declare function splitCsvLines(csv: string): string[];
+/**
+ * Parse a single CSV row into columns.
+ * Handles quoted fields and escaped quotes (RFC 4180).
+ * Returns null if the row has unclosed quotes.
+ */
+export declare function parseRow(line: string): string[] | null;
+/**
+ * Safely parse an integer from a CSV field, pushing an error if invalid.
+ */
+export declare function safeParseInt(value: string, fieldName: string, lineNum: number, errors: string[]): number | null;
+/**
+ * Format a value for CSV output.
+ * Quotes fields that contain commas, quotes, or newlines.
+ */
+export declare function formatCsvValue(value: string): string;
+/**
+ * Parse CSV content with header validation.
+ * Returns parsed rows as arrays of strings.
+ */
+export interface GenericCsvParseResult {
+    header: string[];
+    rows: string[][];
+    errors: string[];
+}
+export declare function parseCsvWithHeader(content: string, expectedColumns: number, headerValidator?: (header: string[]) => boolean): GenericCsvParseResult;
+/**
+ * Generic mapper-based CSV parser. Handles shared boilerplate (extract content,
+ * split lines, validate header, iterate rows, validate column count) and
+ * delegates row-level logic to a callback.
+ */
+export interface CsvParseOptions<T> {
+    /** Exact column count(s) accepted. Rows with other counts are rejected. */
+    expectedColumns?: number | number[];
+    /** Minimum column count accepted. Rows with fewer columns are rejected. */
+    minColumns?: number;
+    /** Optional header validation (receives raw header fields). */
+    headerValidator?: (header: string[]) => boolean;
+    /** Map trimmed columns to a domain object, or return null to skip the row. */
+    rowMapper: (columns: string[], lineNum: number, errors: string[]) => T | null;
+    /** Whether to skip the first row as a header (default: true). */
+    skipHeader?: boolean;
+}
+export declare function parseCsvWithMapper<T>(content: string, options: CsvParseOptions<T>): {
+    items: T[];
+    errors: string[];
+};
+/**
+ * Skip header row if present and filter empty lines.
+ */
+export declare function getDataLines(lines: string[], headerPrefix?: string): string[];
+//# sourceMappingURL=csv-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"csv-utils.d.ts","sourceRoot":"","sources":["../../../../src/commands/llm/_shared/csv-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOzD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CA+BnD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CA6CtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAO/G;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,EACvB,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,OAAO,GAC9C,qBAAqB,CA+CvB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACpC,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;IAChD,8EAA8E;IAC9E,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;IAC9E,iEAAiE;IACjE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG;IAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA0EpH;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAS7E"}