@zbigniewsobiecki/squint 1.0.0

package/dist/commands/stats.js

@@ -0,0 +1,207 @@
+import { Command } from '@oclif/core';
+import chalk from 'chalk';
+import { SharedFlags, outputJsonOrPlain, resolveDbPath, withDatabase } from './_shared/index.js';
+import { computeProcessGroups } from './llm/_shared/process-utils.js';
+function fmt(n) {
+    return n.toLocaleString('en-US');
+}
+function pct(n, total) {
+    if (total === 0)
+        return ' 0.0%';
+    const p = (n / total) * 100;
+    return `${p.toFixed(1).padStart(5)}%`;
+}
+function colorPct(n, total) {
+    if (total === 0)
+        return chalk.gray(' 0.0%');
+    const p = (n / total) * 100;
+    const s = `${p.toFixed(1).padStart(5)}%`;
+    if (p >= 80)
+        return chalk.green(s);
+    if (p >= 50)
+        return chalk.yellow(s);
+    return chalk.red(s);
+}
+function ratio(n, total) {
+    return `${fmt(n).padStart(6)} / ${fmt(total).padEnd(6)}`;
+}
+function sectionHeader(title) {
+    const line = '─'.repeat(48 - title.length - 4);
+    return chalk.bold(`── ${title} ${line}`);
+}
+export default class Stats extends Command {
+    static description = 'Show database statistics and pipeline progress';
+    static examples = [
+        '<%= config.bin %> stats',
+        '<%= config.bin %> stats -d ./my-index.db',
+        '<%= config.bin %> stats --json',
+    ];
+    static flags = {
+        database: SharedFlags.database,
+        json: SharedFlags.json,
+    };
+    async run() {
+        const { flags } = await this.parse(Stats);
+        await withDatabase(flags.database, this, async (db) => {
+            const resolvedPath = resolveDbPath(flags.database, this);
+            // ── Parsed ──
+            const fileCount = db.files.getCount();
+            const symbolCount = db.definitions.getCount();
+            const kindCounts = db.definitions.getKindCounts();
+            const depCount = db.dependencies.getCallsiteCount();
+            // ── Annotations ──
+            const aspectCoverage = db.metadata.getAspectCoverage();
+            const relAnnotated = db.relationships.getCount();
+            const relUnannotated = db.relationships.getUnannotatedCount();
+            const relTotal = relAnnotated + relUnannotated;
+            // ── Modules ──
+            const moduleStats = db.modules.getStats();
+            let processGroupCount = 0;
+            try {
+                if (moduleStats.moduleCount > 0) {
+                    processGroupCount = computeProcessGroups(db).groupCount;
+                }
+            }
+            catch {
+                // modules may not exist yet
+            }
+            // ── Interactions ──
+            const interactionStats = db.interactions.getStats();
+            // ── Flows ──
+            const flowStats = db.flows.getStats();
+            const flowCoverage = db.flows.getCoverage();
+            // ── Features ──
+            const featureCount = db.features.getCount();
+            const totalFlows = flowStats.flowCount;
+            const assignedFlowCount = db.features.getAssignedFlowCount();
+            // ── JSON mode ──
+            outputJsonOrPlain(this, flags.json, {
+                database: resolvedPath,
+                parsed: {
+                    files: fileCount,
+                    symbols: symbolCount,
+                    symbolsByKind: kindCounts,
+                    dependencies: depCount,
+                },
+                annotations: {
+                    aspects: aspectCoverage.map((a) => ({
+                        aspect: a.aspect,
+                        covered: a.covered,
+                        total: a.total,
+                        percentage: a.percentage,
+                    })),
+                    relationships: { annotated: relAnnotated, total: relTotal },
+                },
+                modules: {
+                    count: moduleStats.moduleCount,
+                    assignedSymbols: moduleStats.assigned,
+                    totalSymbols: symbolCount,
+                    processGroups: processGroupCount,
+                },
+                interactions: {
+                    total: interactionStats.totalCount,
+                    business: interactionStats.businessCount,
+                    utility: interactionStats.utilityCount,
+                    biDirectional: interactionStats.biDirectionalCount,
+                },
+                flows: {
+                    count: flowStats.flowCount,
+                    withEntryPoint: flowStats.withEntryPointCount,
+                    avgStepsPerFlow: Math.round(flowStats.avgStepsPerFlow * 10) / 10,
+                    interactionCoverage: {
+                        covered: flowCoverage.coveredByFlows,
+                        total: flowCoverage.totalInteractions,
+                        percentage: Math.round(flowCoverage.percentage * 10) / 10,
+                    },
+                },
+                features: {
+                    count: featureCount,
+                    flowsAssigned: assignedFlowCount,
+                    totalFlows,
+                },
+            }, () => {
+                // ── Plain text mode ──
+                this.log(`Squint Index: ${chalk.cyan(resolvedPath)}`);
+                this.log('');
+                // ── Parsed ──
+                this.log(sectionHeader('Parsed'));
+                this.log(`  Files          ${fmt(fileCount).padStart(8)}`);
+                this.log(`  Symbols        ${fmt(symbolCount).padStart(8)}`);
+                const kindOrder = ['function', 'class', 'variable', 'type', 'interface', 'enum'];
+                const sortedKinds = Object.entries(kindCounts).sort((a, b) => {
+                    const ai = kindOrder.indexOf(a[0]);
+                    const bi = kindOrder.indexOf(b[0]);
+                    if (ai !== -1 && bi !== -1)
+                        return ai - bi;
+                    if (ai !== -1)
+                        return -1;
+                    if (bi !== -1)
+                        return 1;
+                    return b[1] - a[1];
+                });
+                for (const [kind, count] of sortedKinds) {
+                    this.log(`    ${kind.padEnd(14)} ${fmt(count).padStart(6)}   (${pct(count, symbolCount)})`);
+                }
+                this.log(`  Dependencies   ${fmt(depCount).padStart(8)}`);
+                this.log('');
+                // ── Annotations ──
+                if (aspectCoverage.length > 0 || relTotal > 0) {
+                    this.log(sectionHeader('Annotations'));
+                    for (const a of aspectCoverage) {
+                        this.log(`  ${a.aspect.padEnd(14)} ${ratio(a.covered, a.total)}   (${colorPct(a.covered, a.total)})`);
+                    }
+                    if (relTotal > 0) {
+                        this.log(`  ${'relationships'.padEnd(14)} ${ratio(relAnnotated, relTotal)}   (${colorPct(relAnnotated, relTotal)})`);
+                    }
+                    this.log('');
+                }
+                // ── Modules ──
+                if (moduleStats.moduleCount > 0) {
+                    this.log(sectionHeader('Modules'));
+                    this.log(`  Modules        ${fmt(moduleStats.moduleCount).padStart(8)}`);
+                    this.log(`  Assigned symbols ${ratio(moduleStats.assigned, symbolCount)}   (${colorPct(moduleStats.assigned, symbolCount)})`);
+                    if (processGroupCount > 0) {
+                        this.log(`  Process groups ${fmt(processGroupCount).padStart(8)}`);
+                    }
+                    this.log('');
+                }
+                // ── Interactions ──
+                if (interactionStats.totalCount > 0) {
+                    this.log(sectionHeader('Interactions'));
+                    this.log(`  Total          ${fmt(interactionStats.totalCount).padStart(8)}`);
+                    if (interactionStats.businessCount > 0) {
+                        this.log(`    business     ${fmt(interactionStats.businessCount).padStart(8)}   (${pct(interactionStats.businessCount, interactionStats.totalCount)})`);
+                    }
+                    if (interactionStats.utilityCount > 0) {
+                        this.log(`    utility      ${fmt(interactionStats.utilityCount).padStart(8)}   (${pct(interactionStats.utilityCount, interactionStats.totalCount)})`);
+                    }
+                    if (interactionStats.biDirectionalCount > 0) {
+                        this.log(`    bi-directional ${fmt(interactionStats.biDirectionalCount).padStart(6)}   (${pct(interactionStats.biDirectionalCount, interactionStats.totalCount)})`);
+                    }
+                    this.log('');
+                }
+                // ── Flows ──
+                if (flowStats.flowCount > 0) {
+                    this.log(sectionHeader('Flows'));
+                    this.log(`  Flows          ${fmt(flowStats.flowCount).padStart(8)}`);
+                    this.log(`    with entry point ${fmt(flowStats.withEntryPointCount).padStart(4)}`);
+                    this.log(`  Avg steps/flow ${(Math.round(flowStats.avgStepsPerFlow * 10) / 10).toFixed(1).padStart(8)}`);
+                    if (flowCoverage.totalInteractions > 0) {
+                        this.log(`  Interaction coverage ${ratio(flowCoverage.coveredByFlows, flowCoverage.totalInteractions)}   (${colorPct(flowCoverage.coveredByFlows, flowCoverage.totalInteractions)})`);
+                    }
+                    this.log('');
+                }
+                // ── Features ──
+                if (featureCount > 0) {
+                    this.log(sectionHeader('Features'));
+                    this.log(`  Features       ${fmt(featureCount).padStart(8)}`);
+                    if (totalFlows > 0) {
+                        this.log(`  Flows assigned ${ratio(assignedFlowCount, totalFlows)}`);
+                    }
+                    this.log('');
+                }
+            });
+        });
+    }
+}
+//# sourceMappingURL=stats.js.map

package/dist/commands/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../src/commands/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEtE,SAAS,GAAG,CAAC,CAAS;IACpB,OAAO,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,GAAG,CAAC,CAAS,EAAE,KAAa;IACnC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAChC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;IAC5B,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC;AACxC,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS,EAAE,KAAa;IACxC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;IAC5B,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC;IACzC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACpC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,KAAK,CAAC,CAAS,EAAE,KAAa;IACrC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/C,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;IACxC,MAAM,CAAU,WAAW,GAAG,gDAAgD,CAAC;IAE/E,MAAM,CAAU,QAAQ,GAAG;QACzB,yBAAyB;QACzB,0CAA0C;QAC1C,gCAAgC;KACjC,CAAC;IAEF,MAAM,CAAU,KAAK,GAAG;QACtB,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,IAAI,EAAE,WAAW,CAAC,IAAI;KACvB,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAE1C,MAAM,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACpD,MAAM,YAAY,GAAG,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAEzD,eAAe;YACf,MAAM,SAAS,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACtC,MAAM,WAAW,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;YAC9C,MAAM,UAAU,GAAG,EAAE,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC;YAClD,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE,CAAC;YAEpD,oBAAoB;YACpB,MAAM,cAAc,GAAG,EAAE,CAAC,QAAQ,CAAC,iBAAiB,EAAE,CAAC;YACvD,MAAM,YAAY,GAAG,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;YACjD,MAAM,cAAc,GAAG,EAAE,CAAC,aAAa,CAAC,mBAAmB,EAAE,CAAC;YAC9D,MAAM,QAAQ,GAAG,YAAY,GAAG,cAAc,CAAC;YAE/C,gBAAgB;YAChB,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAE1C,IAAI,iBAAiB,GAAG,CAAC,CAAC;YAC1B,IAAI,CAAC;gBACH,IAAI,WAAW,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;oBAChC,iBAAiB,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;gBAC1D,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,4BAA4B;YAC9B,CAAC;YAED,qBAAqB;YACrB,MAAM,gBAAgB,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YAEpD,cAAc;YACd,MAAM,SAAS,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACtC,MAAM,YAAY,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAE5C,iBAAiB;YACjB,MAAM,YAAY,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC5C,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC;YACvC,MAAM,iBAAiB,GAAG,EAAE,CAAC,QAAQ,CAAC,oBAAoB,EAAE,CAAC;YAE7D,kBAAkB;YAClB,iBAAiB,CACf,IAAI,EACJ,KAAK,CAAC,IAAI,EACV;gBACE,QAAQ,EAAE,YAAY;gBACtB,MAAM,EAAE;oBACN,KAAK,EAAE,SAAS;oBAChB,OAAO,EAAE,WAAW;oBACpB,aAAa,EAAE,UAAU;oBACzB,YAAY,EAAE,QAAQ;iBACvB;gBACD,WAAW,EAAE;oBACX,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBAClC,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,OAAO,EAAE,CAAC,CAAC,OAAO;wBAClB,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,UAAU,EAAE,CAAC,CAAC,UAAU;qBACzB,CAAC,CAAC;oBACH,aAAa,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE;iBAC5D;gBACD,OAAO,EAAE;oBACP,KAAK,EAAE,WAAW,CAAC,WAAW;oBAC9B,eAAe,EAAE,WAAW,CAAC,QAAQ;oBACrC,YAAY,EAAE,WAAW;oBACzB,aAAa,EAAE,iBAAiB;iBACjC;gBACD,YAAY,EAAE;oBACZ,KAAK,EAAE,gBAAgB,CAAC,UAAU;oBAClC,QAAQ,EAAE,gBAAgB,CAAC,aAAa;oBACxC,OAAO,EAAE,gBAAgB,CAAC,YAAY;oBACtC,aAAa,EAAE,gBAAgB,CAAC,kBAAkB;iBACnD;gBACD,KAAK,EAAE;oBACL,KAAK,EAAE,SAAS,CAAC,SAAS;oBAC1B,cAAc,EAAE,SAAS,CAAC,mBAAmB;oBAC7C,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,eAAe,GAAG,EAAE,CAAC,GAAG,EAAE;oBAChE,mBAAmB,EAAE;wBACnB,OAAO,EAAE,YAAY,CAAC,cAAc;wBACpC,KAAK,EAAE,YAAY,CAAC,iBAAiB;wBACrC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,GAAG,EAAE,CAAC,GAAG,EAAE;qBAC1D;iBACF;gBACD,QAAQ,EAAE;oBACR,KAAK,EAAE,YAAY;oBACnB,aAAa,EAAE,iBAAiB;oBAChC,UAAU;iBACX;aACF,EACD,GAAG,EAAE;gBACH,wBAAwB;gBACxB,IAAI,CAAC,GAAG,CAAC,iBAAiB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;gBACtD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAEb,eAAe;gBACf,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAClC,IAAI,CAAC,GAAG,CAAC,oBAAoB,GAAG,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC3D,IAAI,CAAC,GAAG,CAAC,oBAAoB,GAAG,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAE7D,MAAM,SAAS,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;gBACjF,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;oBAC3D,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBACnC,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBACnC,IAAI,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;wBAAE,OAAO,EAAE,GAAG,EAAE,CAAC;oBAC3C,IAAI,EAAE,KAAK,CAAC,CAAC;wBAAE,OAAO,CAAC,CAAC,CAAC;oBACzB,IAAI,EAAE,KAAK,CAAC,CAAC;wBAAE,OAAO,CAAC,CAAC;oBACxB,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrB,CAAC,CAAC,CAAC;gBACH,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC;oBACxC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;gBAC9F,CAAC;gBAED,IAAI,CAAC,GAAG,CAAC,oBAAoB,GAAG,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC1D,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAEb,oBAAoB;gBACpB,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;oBAC9C,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC;oBACvC,KAAK,MAAM,CAAC,IAAI,cAAc,EAAE,CAAC;wBAC/B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBACxG,CAAC;oBACD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;wBACjB,IAAI,CAAC,GAAG,CACN,KAAK,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,YAAY,EAAE,QAAQ,CAAC,OAAO,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG,CAC3G,CAAC;oBACJ,CAAC;oBACD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACf,CAAC;gBAED,gBAAgB;gBAChB,IAAI,WAAW,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;oBAChC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;oBACnC,IAAI,CAAC,GAAG,CAAC,oBAAoB,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACzE,IAAI,CAAC,GAAG,CACN,sBAAsB,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,OAAO,QAAQ,CAAC,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,CACpH,CAAC;oBACF,IAAI,iBAAiB,GAAG,CAAC,EAAE,CAAC;wBAC1B,IAAI,CAAC,GAAG,CAAC,oBAAoB,GAAG,CAAC,iBAAiB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACrE,CAAC;oBACD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACf,CAAC;gBAED,qBAAqB;gBACrB,IAAI,gBAAgB,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;oBACpC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;oBACxC,IAAI,CAAC,GAAG,CAAC,oBAAoB,GAAG,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBAC7E,IAAI,gBAAgB,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;wBACvC,IAAI,CAAC,GAAG,CACN,oBAAoB,GAAG,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,gBAAgB,CAAC,aAAa,EAAE,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAC9I,CAAC;oBACJ,CAAC;oBACD,IAAI,gBAAgB,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;wBACtC,IAAI,CAAC,GAAG,CACN,oBAAoB,GAAG,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,gBAAgB,CAAC,YAAY,EAAE,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAC5I,CAAC;oBACJ,CAAC;oBACD,IAAI,gBAAgB,CAAC,kBAAkB,GAAG,CAAC,EAAE,CAAC;wBAC5C,IAAI,CAAC,GAAG,CACN,sBAAsB,GAAG,CAAC,gBAAgB,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,UAAU,CAAC,GAAG,CAC1J,CAAC;oBACJ,CAAC;oBACD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACf,CAAC;gBAED,cAAc;gBACd,IAAI,SAAS,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;oBAC5B,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;oBACjC,IAAI,CAAC,GAAG,CAAC,oBAAoB,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACrE,IAAI,CAAC,GAAG,CAAC,wBAAwB,GAAG,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACnF,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,eAAe,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACzG,IAAI,YAAY,CAAC,iBAAiB,GAAG,CAAC,EAAE,CAAC;wBACvC,IAAI,CAAC,GAAG,CACN,0BAA0B,KAAK,CAAC,YAAY,CAAC,cAAc,EAAE,YAAY,CAAC,iBAAiB,CAAC,OAAO,QAAQ,CAAC,YAAY,CAAC,cAAc,EAAE,YAAY,CAAC,iBAAiB,CAAC,GAAG,CAC5K,CAAC;oBACJ,CAAC;oBACD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACf,CAAC;gBAED,iBAAiB;gBACjB,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;oBACrB,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;oBACpC,IAAI,CAAC,GAAG,CAAC,oBAAoB,GAAG,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBAC9D,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;wBACnB,IAAI,CAAC,GAAG,CAAC,oBAAoB,KAAK,CAAC,iBAAiB,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;oBACvE,CAAC;oBACD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACf,CAAC;YACH,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC"}

package/dist/commands/symbols/annotate.d.ts

@@ -0,0 +1,32 @@
+import { BaseLlmCommand, type LlmContext } from '../llm/_shared/base-llm-command.js';
+export default class Annotate extends BaseLlmCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        aspect: import("@oclif/core/interfaces").OptionFlag<string[], import("@oclif/core/interfaces").CustomOptions>;
+        'batch-size': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'max-iterations': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        kind: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        exclude: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'relationship-limit': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        model: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'show-llm-requests': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'show-llm-responses': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        database: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    protected execute(ctx: LlmContext, flags: Record<string, unknown>): Promise<void>;
+    /**
+     * Enhance symbols with source code, dependency context, and relationships to annotate.
+     */
+    private enhanceSymbols;
+    /**
+     * Validate a value for a specific aspect.
+     */
+    private validateValue;
+}
+//# sourceMappingURL=annotate.d.ts.map

package/dist/commands/symbols/annotate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotate.d.ts","sourceRoot":"","sources":["../../../src/commands/symbols/annotate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,oCAAoC,CAAC;AA6FrF,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,cAAc;IAClD,OAAgB,WAAW,SAAwD;IAEnF,OAAgB,QAAQ,WAMtB;IAEF,OAAgB,KAAK;;;;;;;;;;;;;;;;MAuCnB;cAEc,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAwtBvF;;OAEG;YACW,cAAc;IAoF5B;;OAEG;IACH,OAAO,CAAC,aAAa;CAkDtB"}