@zbigniewsobiecki/squint 1.0.0

package/dist/commands/interactions/create.d.ts

@@ -0,0 +1,16 @@
+import { Command } from '@oclif/core';
+export default class InteractionsCreate extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        database: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        from: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        to: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        semantic: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        pattern: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        direction: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        weight: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/interactions/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/interactions/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAI7C,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,OAAO;IACrD,OAAgB,WAAW,SAAqC;IAEhE,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,KAAK;;;;;;;;MA0BnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAwBlC"}

package/dist/commands/interactions/create.js

@@ -0,0 +1,58 @@
+import { Command, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { SharedFlags, withDatabase } from '../_shared/index.js';
+export default class InteractionsCreate extends Command {
+    static description = 'Create a new module interaction';
+    static examples = [
+        '<%= config.bin %> interactions create --from project.backend.auth --to project.backend.db',
+        '<%= config.bin %> interactions create --from project.backend.auth --to project.backend.db --semantic "authenticates users" --pattern business',
+    ];
+    static flags = {
+        database: SharedFlags.database,
+        from: Flags.string({
+            description: 'Source module path',
+            required: true,
+        }),
+        to: Flags.string({
+            description: 'Target module path',
+            required: true,
+        }),
+        semantic: Flags.string({
+            description: 'Semantic description of the interaction',
+        }),
+        pattern: Flags.string({
+            description: 'Interaction pattern',
+            options: ['business', 'utility'],
+        }),
+        direction: Flags.string({
+            description: 'Interaction direction',
+            options: ['uni', 'bi'],
+            default: 'uni',
+        }),
+        weight: Flags.integer({
+            description: 'Interaction weight',
+            default: 1,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(InteractionsCreate);
+        await withDatabase(flags.database, this, async (db) => {
+            const fromModule = db.modules.getByPath(flags.from);
+            if (!fromModule) {
+                this.error(chalk.red(`Module "${flags.from}" not found.`));
+            }
+            const toModule = db.modules.getByPath(flags.to);
+            if (!toModule) {
+                this.error(chalk.red(`Module "${flags.to}" not found.`));
+            }
+            const id = db.interactions.insert(fromModule.id, toModule.id, {
+                direction: flags.direction,
+                weight: flags.weight,
+                pattern: flags.pattern,
+                semantic: flags.semantic,
+            });
+            this.log(`Created interaction ${chalk.cyan(String(id))}: ${chalk.cyan(flags.from)} -> ${chalk.cyan(flags.to)}`);
+        });
+    }
+}
+//# sourceMappingURL=create.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/commands/interactions/create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEhE,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,OAAO;IACrD,MAAM,CAAU,WAAW,GAAG,iCAAiC,CAAC;IAEhE,MAAM,CAAU,QAAQ,GAAG;QACzB,2FAA2F;QAC3F,+IAA+I;KAChJ,CAAC;IAEF,MAAM,CAAU,KAAK,GAAG;QACtB,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;YACjB,WAAW,EAAE,oBAAoB;YACjC,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC;YACf,WAAW,EAAE,oBAAoB;YACjC,QAAQ,EAAE,IAAI;SACf,CAAC;QACF,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;YACrB,WAAW,EAAE,yCAAyC;SACvD,CAAC;QACF,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC;YACpB,WAAW,EAAE,qBAAqB;YAClC,OAAO,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;SACjC,CAAC;QACF,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC;YACtB,WAAW,EAAE,uBAAuB;YACpC,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC;YACtB,OAAO,EAAE,KAAK;SACf,CAAC;QACF,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;YACpB,WAAW,EAAE,oBAAoB;YACjC,OAAO,EAAE,CAAC;SACX,CAAC;KACH,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAEvD,MAAM,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACpD,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACpD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC;YAC7D,CAAC;YAED,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,KAAK,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;YAC3D,CAAC;YAED,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE;gBAC5D,SAAS,EAAE,KAAK,CAAC,SAAyB;gBAC1C,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,OAAO,EAAE,KAAK,CAAC,OAA6C;gBAC5D,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB,CAAC,CAAC;YAEH,IAAI,CAAC,GAAG,CAAC,uBAAuB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAClH,CAAC,CAAC,CAAC;IACL,CAAC"}

package/dist/commands/interactions/delete.d.ts

@@ -0,0 +1,16 @@
+import { Command } from '@oclif/core';
+export default class InteractionsDelete extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<number, {
+            max?: number;
+            min?: number;
+        }>;
+    };
+    static flags: {
+        database: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=delete.d.ts.map

package/dist/commands/interactions/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../src/commands/interactions/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAE,MAAM,aAAa,CAAC;AAI5C,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,OAAO;IACrD,OAAgB,WAAW,SAA2B;IAEtD,OAAgB,QAAQ,WAA+C;IAEvE,OAAgB,IAAI;;;;;MAElB;IAEF,OAAgB,KAAK;;MAEnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAiBlC"}

package/dist/commands/interactions/delete.js

@@ -0,0 +1,28 @@
+import { Args, Command } from '@oclif/core';
+import chalk from 'chalk';
+import { SharedFlags, withDatabase } from '../_shared/index.js';
+export default class InteractionsDelete extends Command {
+    static description = 'Delete an interaction';
+    static examples = ['<%= config.bin %> interactions delete 5'];
+    static args = {
+        id: Args.integer({ description: 'Interaction ID', required: true }),
+    };
+    static flags = {
+        database: SharedFlags.database,
+    };
+    async run() {
+        const { args, flags } = await this.parse(InteractionsDelete);
+        await withDatabase(flags.database, this, async (db) => {
+            const existing = db.interactions.getById(args.id);
+            if (!existing) {
+                this.error(chalk.red(`Interaction ${args.id} not found.`));
+            }
+            const deleted = db.interactions.delete(args.id);
+            if (!deleted) {
+                this.error(chalk.red(`Failed to delete interaction ${args.id}.`));
+            }
+            this.log(`Deleted interaction ${chalk.cyan(String(args.id))}`);
+        });
+    }
+}
+//# sourceMappingURL=delete.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../src/commands/interactions/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEhE,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,OAAO;IACrD,MAAM,CAAU,WAAW,GAAG,uBAAuB,CAAC;IAEtD,MAAM,CAAU,QAAQ,GAAG,CAAC,yCAAyC,CAAC,CAAC;IAEvE,MAAM,CAAU,IAAI,GAAG;QACrB,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;KACpE,CAAC;IAEF,MAAM,CAAU,KAAK,GAAG;QACtB,QAAQ,EAAE,WAAW,CAAC,QAAQ;KAC/B,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAE7D,MAAM,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACpD,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC;YAC7D,CAAC;YAED,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,gCAAgC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACpE,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,uBAAuB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;IACL,CAAC"}

package/dist/commands/interactions/generate.d.ts

@@ -0,0 +1,62 @@
+import { BaseLlmCommand, type LlmContext } from '../llm/_shared/base-llm-command.js';
+export default class InteractionsGenerate extends BaseLlmCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'batch-size': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'min-relationship-coverage': import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'max-gate-retries': 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>;
+        force: 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>;
+    /**
+     * Generate semantic descriptions for module edges using LLM.
+     */
+    private generateInteractionSemantics;
+    /**
+     * Parse LLM CSV response into interaction suggestions.
+     */
+    private parseInteractionCSV;
+    /**
+     * Create a default interaction from an edge when LLM fails.
+     */
+    private createDefaultInteraction;
+    /**
+     * Infer cross-process interactions between modules in different process groups.
+     * Uses import graph connectivity (union-find) to detect process boundaries,
+     * then asks LLM to identify runtime connections between separate processes.
+     */
+    private inferCrossProcessInteractions;
+    /**
+     * Infer targeted interactions for specific uncovered module pairs.
+     * These are module pairs with symbol-level relationships but no detected interaction.
+     * Prompt is enriched with module descriptions, import evidence, and relationship details.
+     */
+    private inferTargetedInteractions;
+    /**
+     * Build system prompt for cross-process inference.
+     */
+    private buildCrossProcessSystemPrompt;
+    /**
+     * Build user prompt for cross-process inference between two process groups.
+     * Includes member names for entity pattern matching.
+     */
+    private buildCrossProcessUserPrompt;
+    /**
+     * Structural gate for inferred interactions.
+     * Rejects duplicates, self-loops, and reverse-of-AST interactions.
+     */
+    private gateInferredInteraction;
+    /**
+     * Parse the LLM response CSV into inferred interactions.
+     */
+    private parseLogicalInteractionCSV;
+}
+//# sourceMappingURL=generate.d.ts.map

package/dist/commands/interactions/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/commands/interactions/generate.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,oCAAoC,CAAC;AA8BrF,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,cAAc;IAC9D,OAAgB,WAAW,SAAiF;IAE5G,OAAgB,QAAQ,WAKtB;IAEF,OAAgB,KAAK;;;;;;;;;;;;MAgBnB;cAEc,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmbvF;;OAEG;YACW,4BAA4B;IAoE1C;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA4C3B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoBhC;;;;OAIG;YACW,6BAA6B;IA6E3C;;;;OAIG;YACW,yBAAyB;IA6JvC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAyCrC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAkGnC;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IA2B/B;;OAEG;IACH,OAAO,CAAC,0BAA0B;CAgDnC"}