@zbigniewsobiecki/squint 1.0.0

package/dist/commands/flows/list.js

@@ -0,0 +1,98 @@
+import { Command, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { SharedFlags, openDatabase } from '../_shared/index.js';
+export default class FlowsList extends Command {
+    static description = 'List all detected user journey flows';
+    static examples = [
+        '<%= config.bin %> flows',
+        '<%= config.bin %> flows --stakeholder user',
+        '<%= config.bin %> flows --stakeholder admin',
+        '<%= config.bin %> flows -d index.db --json',
+    ];
+    static flags = {
+        database: SharedFlags.database,
+        json: SharedFlags.json,
+        stakeholder: Flags.string({
+            description: 'Filter by stakeholder type',
+            options: ['user', 'admin', 'system', 'developer', 'external'],
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(FlowsList);
+        const db = await openDatabase(flags.database, this);
+        const isJson = flags.json;
+        try {
+            let flows;
+            if (flags.stakeholder) {
+                flows = db.flows.getByStakeholder(flags.stakeholder);
+            }
+            else {
+                flows = db.flows.getAll();
+            }
+            if (flows.length === 0) {
+                if (isJson) {
+                    this.log(JSON.stringify({ flows: [], stats: { flowCount: 0 } }));
+                }
+                else {
+                    this.log(chalk.gray('No flows detected yet.'));
+                    this.log(chalk.gray('Run `squint llm flows` to detect user journey flows.'));
+                }
+                return;
+            }
+            if (isJson) {
+                const stats = db.flows.getStats();
+                const coverage = db.flows.getCoverage();
+                this.log(JSON.stringify({ flows, stats, coverage }, null, 2));
+                return;
+            }
+            // Group by stakeholder
+            const byStakeholder = new Map();
+            for (const flow of flows) {
+                const key = flow.stakeholder ?? 'unassigned';
+                const list = byStakeholder.get(key) ?? [];
+                list.push(flow);
+                byStakeholder.set(key, list);
+            }
+            this.log(chalk.bold(`Flows (${flows.length})`));
+            this.log('');
+            const stakeholderOrder = ['user', 'admin', 'system', 'developer', 'external', 'unassigned'];
+            const stakeholderColors = {
+                user: chalk.green,
+                admin: chalk.red,
+                system: chalk.blue,
+                developer: chalk.yellow,
+                external: chalk.magenta,
+                unassigned: chalk.gray,
+            };
+            for (const stakeholder of stakeholderOrder) {
+                const stakeholderFlows = byStakeholder.get(stakeholder);
+                if (!stakeholderFlows || stakeholderFlows.length === 0)
+                    continue;
+                const colorFn = stakeholderColors[stakeholder] ?? chalk.white;
+                this.log(chalk.bold(colorFn(`${stakeholder.charAt(0).toUpperCase() + stakeholder.slice(1)} Flows`)));
+                for (const flow of stakeholderFlows) {
+                    this.log(`  ${chalk.bold(flow.name)} ${chalk.gray(`(${flow.slug})`)}`);
+                    if (flow.entryPath) {
+                        this.log(`    Entry: ${flow.entryPath}`);
+                    }
+                    if (flow.description) {
+                        this.log(`    ${chalk.gray(flow.description)}`);
+                    }
+                }
+                this.log('');
+            }
+            // Stats
+            const stats = db.flows.getStats();
+            const coverage = db.flows.getCoverage();
+            this.log(chalk.bold('Statistics'));
+            this.log(`Total flows: ${stats.flowCount}`);
+            this.log(`With entry points: ${stats.withEntryPointCount}`);
+            this.log(`Avg steps per flow: ${stats.avgStepsPerFlow.toFixed(1)}`);
+            this.log(`Interaction coverage: ${coverage.coveredByFlows}/${coverage.totalInteractions} (${coverage.percentage.toFixed(1)}%)`);
+        }
+        finally {
+            db.close();
+        }
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/flows/list.js.map

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

package/dist/commands/flows/remove-step.d.ts

@@ -0,0 +1,18 @@
+import { Command } from '@oclif/core';
+export default class FlowsRemoveStep extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        'flow-id-or-slug': import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        'step-order': 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>;
+    private findFlow;
+}
+//# sourceMappingURL=remove-step.d.ts.map

package/dist/commands/flows/remove-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-step.d.ts","sourceRoot":"","sources":["../../../src/commands/flows/remove-step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAE,MAAM,aAAa,CAAC;AAK5C,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,OAAO;IAClD,OAAgB,WAAW,SAA+B;IAE1D,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,IAAI;;;;;;MAGlB;IAEF,OAAgB,KAAK;;MAEnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBjC,OAAO,CAAC,QAAQ;CAWjB"}

package/dist/commands/flows/remove-step.js

@@ -0,0 +1,41 @@
+import { Args, Command } from '@oclif/core';
+import chalk from 'chalk';
+import { SharedFlags, withDatabase } from '../_shared/index.js';
+export default class FlowsRemoveStep extends Command {
+    static description = 'Remove a step from a flow';
+    static examples = [
+        '<%= config.bin %> flows remove-step user-login 2',
+        '<%= config.bin %> flows remove-step 3 1',
+    ];
+    static args = {
+        'flow-id-or-slug': Args.string({ description: 'Flow ID or slug', required: true }),
+        'step-order': Args.integer({ description: 'Step order to remove', required: true }),
+    };
+    static flags = {
+        database: SharedFlags.database,
+    };
+    async run() {
+        const { args, flags } = await this.parse(FlowsRemoveStep);
+        await withDatabase(flags.database, this, async (db) => {
+            const flow = this.findFlow(db, args['flow-id-or-slug']);
+            if (!flow) {
+                this.error(chalk.red(`Flow "${args['flow-id-or-slug']}" not found.`));
+            }
+            const removed = db.flows.removeStep(flow.id, args['step-order']);
+            if (!removed) {
+                this.error(chalk.red(`Step ${args['step-order']} not found in flow "${flow.name}".`));
+            }
+            this.log(`Removed step ${chalk.cyan(String(args['step-order']))} from flow ${chalk.cyan(flow.name)}`);
+        });
+    }
+    findFlow(db, identifier) {
+        const id = Number.parseInt(identifier, 10);
+        if (!Number.isNaN(id)) {
+            const flow = db.flows.getById(id);
+            if (flow)
+                return flow;
+        }
+        return db.flows.getBySlug(identifier);
+    }
+}
+//# sourceMappingURL=remove-step.js.map

package/dist/commands/flows/remove-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-step.js","sourceRoot":"","sources":["../../../src/commands/flows/remove-step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEhE,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,OAAO;IAClD,MAAM,CAAU,WAAW,GAAG,2BAA2B,CAAC;IAE1D,MAAM,CAAU,QAAQ,GAAG;QACzB,kDAAkD;QAClD,yCAAyC;KAC1C,CAAC;IAEF,MAAM,CAAU,IAAI,GAAG;QACrB,iBAAiB,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAClF,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;KACpF,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,eAAe,CAAC,CAAC;QAE1D,MAAM,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE;YACpD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACxD,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC;YACxE,CAAC;YAED,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;YACjE,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,YAAY,CAAC,uBAAuB,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;YACxF,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxG,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,QAAQ,CACd,EAAyF,EACzF,UAAkB;QAElB,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC;QACxB,CAAC;QACD,OAAO,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC"}

package/dist/commands/flows/show.d.ts

@@ -0,0 +1,17 @@
+import { Command } from '@oclif/core';
+export default class FlowsShow extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        identifier: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        database: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private findFlow;
+    private displayFlow;
+    private getStakeholderDisplay;
+}
+//# sourceMappingURL=show.d.ts.map

package/dist/commands/flows/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/commands/flows/show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAE,MAAM,aAAa,CAAC;AAM5C,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,OAAO;IAC5C,OAAgB,WAAW,SAA8C;IAEzE,OAAgB,QAAQ,WAItB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;MAGnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAuDjC,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,WAAW;IAiDnB,OAAO,CAAC,qBAAqB;CAW9B"}

package/dist/commands/flows/show.js

@@ -0,0 +1,136 @@
+import { Args, Command } from '@oclif/core';
+import chalk from 'chalk';
+import { SharedFlags, openDatabase } from '../_shared/index.js';
+export default class FlowsShow extends Command {
+    static description = 'Show flow details with interaction steps';
+    static examples = [
+        '<%= config.bin %> flows show login-flow',
+        '<%= config.bin %> flows show 5',
+        '<%= config.bin %> flows show user-registration --json',
+    ];
+    static args = {
+        identifier: Args.string({ description: 'Flow name, slug, or ID', required: true }),
+    };
+    static flags = {
+        database: SharedFlags.database,
+        json: SharedFlags.json,
+    };
+    async run() {
+        const { args, flags } = await this.parse(FlowsShow);
+        const db = await openDatabase(flags.database, this);
+        const isJson = flags.json;
+        try {
+            const flow = this.findFlow(db, args.identifier);
+            if (!flow) {
+                // Try partial match
+                const allFlows = db.flows.getAll();
+                const matches = allFlows.filter((f) => f.name.toLowerCase().includes(args.identifier.toLowerCase()) ||
+                    f.slug.toLowerCase().includes(args.identifier.toLowerCase()));
+                if (matches.length === 1) {
+                    this.displayFlow(db, matches[0], isJson);
+                    return;
+                }
+                if (matches.length > 1) {
+                    if (isJson) {
+                        this.log(JSON.stringify({
+                            error: 'Multiple matches',
+                            matches: matches.map((f) => ({ id: f.id, name: f.name, slug: f.slug })),
+                        }));
+                    }
+                    else {
+                        this.log(chalk.yellow(`Multiple flows match "${args.identifier}":`));
+                        for (const f of matches) {
+                            this.log(`  ${chalk.cyan(f.name)} ${chalk.gray(`(${f.slug})`)}`);
+                        }
+                        this.log('');
+                        this.log(chalk.gray('Please specify the exact slug or ID.'));
+                    }
+                    return;
+                }
+                if (isJson) {
+                    this.log(JSON.stringify({ error: `Flow "${args.identifier}" not found.` }));
+                }
+                else {
+                    this.log(chalk.red(`Flow "${args.identifier}" not found.`));
+                }
+                return;
+            }
+            this.displayFlow(db, flow, isJson);
+        }
+        finally {
+            db.close();
+        }
+    }
+    findFlow(db, identifier) {
+        // Try by ID
+        const id = Number.parseInt(identifier, 10);
+        if (!Number.isNaN(id)) {
+            const flow = db.flows.getById(id);
+            if (flow)
+                return flow;
+        }
+        // Try by slug
+        const bySlug = db.flows.getBySlug(identifier);
+        if (bySlug)
+            return bySlug;
+        // Try exact name match
+        const allFlows = db.flows.getAll();
+        const byName = allFlows.find((f) => f.name === identifier);
+        return byName ?? null;
+    }
+    displayFlow(db, flow, isJson) {
+        // Get flow with steps
+        const flowWithSteps = db.flows.getWithSteps(flow.id);
+        if (isJson) {
+            this.log(JSON.stringify(flowWithSteps, null, 2));
+            return;
+        }
+        // Flow header
+        this.log(chalk.bold(`Flow: ${flow.name}`));
+        this.log(`Slug: ${chalk.gray(flow.slug)}`);
+        if (flow.stakeholder) {
+            this.log(`Stakeholder: ${this.getStakeholderDisplay(flow.stakeholder)}`);
+        }
+        if (flow.entryPath) {
+            this.log(`Entry: ${flow.entryPath}`);
+        }
+        if (flow.description) {
+            this.log(`Description: ${flow.description}`);
+        }
+        // Steps
+        if (flowWithSteps && flowWithSteps.steps.length > 0) {
+            this.log('');
+            this.log(chalk.bold(`Steps (${flowWithSteps.steps.length})`));
+            for (const step of flowWithSteps.steps) {
+                const i = step.interaction;
+                const fromShort = i.fromModulePath.split('.').slice(-2).join('.');
+                const toShort = i.toModulePath.split('.').slice(-2).join('.');
+                const patternLabel = i.pattern === 'business'
+                    ? chalk.cyan('[business]')
+                    : i.pattern === 'utility'
+                        ? chalk.yellow('[utility]')
+                        : '';
+                this.log(`  ${step.stepOrder}. ${fromShort} → ${toShort} ${patternLabel}`);
+                if (i.semantic) {
+                    this.log(`     ${chalk.gray(`"${i.semantic}"`)}`);
+                }
+            }
+        }
+        else {
+            this.log('');
+            this.log(chalk.gray('No steps recorded for this flow.'));
+        }
+    }
+    getStakeholderDisplay(stakeholder) {
+        const colors = {
+            user: chalk.green,
+            admin: chalk.red,
+            system: chalk.blue,
+            developer: chalk.yellow,
+            external: chalk.magenta,
+        };
+        const colorFn = colors[stakeholder] ?? chalk.white;
+        return colorFn(stakeholder);
+    }
+}
+//# sourceMappingURL=show.js.map

package/dist/commands/flows/show.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.js","sourceRoot":"","sources":["../../../src/commands/flows/show.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEhE,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,OAAO;IAC5C,MAAM,CAAU,WAAW,GAAG,0CAA0C,CAAC;IAEzE,MAAM,CAAU,QAAQ,GAAG;QACzB,yCAAyC;QACzC,gCAAgC;QAChC,uDAAuD;KACxD,CAAC;IAEF,MAAM,CAAU,IAAI,GAAG;QACrB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,wBAAwB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;KACnF,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,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAEpD,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC;QAE1B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAEhD,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,oBAAoB;gBACpB,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAC7B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;oBAC5D,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAC/D,CAAC;gBAEF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;oBACzC,OAAO;gBACT,CAAC;gBACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,IAAI,MAAM,EAAE,CAAC;wBACX,IAAI,CAAC,GAAG,CACN,IAAI,CAAC,SAAS,CAAC;4BACb,KAAK,EAAE,kBAAkB;4BACzB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;yBACxE,CAAC,CACH,CAAC;oBACJ,CAAC;yBAAM,CAAC;wBACN,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,yBAAyB,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;wBACrE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;4BACxB,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC;wBACnE,CAAC;wBACD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;wBACb,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC,CAAC;oBAC/D,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,IAAI,MAAM,EAAE,CAAC;oBACX,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,IAAI,CAAC,UAAU,cAAc,EAAE,CAAC,CAAC,CAAC;gBAC9E,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,IAAI,CAAC,UAAU,cAAc,CAAC,CAAC,CAAC;gBAC9D,CAAC;gBACD,OAAO;YACT,CAAC;YAED,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACrC,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;IACH,CAAC;IAEO,QAAQ,CAAC,EAAiB,EAAE,UAAkB;QACpD,YAAY;QACZ,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAClC,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC;QACxB,CAAC;QAED,cAAc;QACd,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,uBAAuB;QACvB,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;QAC3D,OAAO,MAAM,IAAI,IAAI,CAAC;IACxB,CAAC;IAEO,WAAW,CAAC,EAAiB,EAAE,IAAU,EAAE,MAAe;QAChE,sBAAsB;QACtB,MAAM,aAAa,GAAG,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAErD,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACjD,OAAO;QACT,CAAC;QAED,cAAc;QACd,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,QAAQ;QACR,IAAI,aAAa,IAAI,aAAa,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,aAAa,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAE9D,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;gBACvC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;gBAC3B,MAAM,SAAS,GAAG,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAClE,MAAM,OAAO,GAAG,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC9D,MAAM,YAAY,GAChB,CAAC,CAAC,OAAO,KAAK,UAAU;oBACtB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC;oBAC1B,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS;wBACvB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC;wBAC3B,CAAC,CAAC,EAAE,CAAC;gBAEX,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,SAAS,KAAK,SAAS,MAAM,OAAO,IAAI,YAAY,EAAE,CAAC,CAAC;gBAC3E,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;oBACf,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAEO,qBAAqB,CAAC,WAAmB;QAC/C,MAAM,MAAM,GAA0C;YACpD,IAAI,EAAE,KAAK,CAAC,KAAK;YACjB,KAAK,EAAE,KAAK,CAAC,GAAG;YAChB,MAAM,EAAE,KAAK,CAAC,IAAI;YAClB,SAAS,EAAE,KAAK,CAAC,MAAM;YACvB,QAAQ,EAAE,KAAK,CAAC,OAAO;SACxB,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC;QACnD,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC;IAC9B,CAAC"}

package/dist/commands/flows/trace.d.ts

@@ -0,0 +1,22 @@
+import { Command } from '@oclif/core';
+export default class FlowsTrace extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        database: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        id: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        depth: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    /**
+     * Trace reachable symbols from an entry point using call graph (BFS).
+     */
+    private traceFromEntry;
+    private buildTree;
+    private flattenTree;
+    private printTree;
+}
+//# sourceMappingURL=trace.d.ts.map

package/dist/commands/flows/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/commands/flows/trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAiB7C,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,OAAO;IAC7C,OAAgB,WAAW,SAAoC;IAE/D,OAAgB,QAAQ,WAKtB;IAEF,OAAgB,KAAK;;;;;;;MAkBnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAyDjC;;OAEG;IACH,OAAO,CAAC,cAAc;IAqDtB,OAAO,CAAC,SAAS;IA2EjB,OAAO,CAAC,WAAW;IAsCnB,OAAO,CAAC,SAAS;CAiBlB"}

package/dist/commands/flows/trace.js

@@ -0,0 +1,217 @@
+import { Command, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { SharedFlags, SymbolResolver, outputJsonOrPlain, withDatabase } from '../_shared/index.js';
+export default class FlowsTrace extends Command {
+    static description = 'Trace call graph from a symbol';
+    static examples = [
+        '<%= config.bin %> flows trace --name handleRegister',
+        '<%= config.bin %> flows trace --id 42',
+        '<%= config.bin %> flows trace --name processPayment --depth 5',
+        '<%= config.bin %> flows trace --name login --json',
+    ];
+    static flags = {
+        database: SharedFlags.database,
+        json: SharedFlags.json,
+        name: Flags.string({
+            char: 'n',
+            description: 'Symbol name to trace from',
+        }),
+        id: Flags.integer({
+            description: 'Definition ID to trace from',
+        }),
+        depth: Flags.integer({
+            description: 'Max depth to trace',
+            default: 10,
+        }),
+        file: Flags.string({
+            char: 'f',
+            description: 'Disambiguate by file path',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(FlowsTrace);
+        if (!flags.name && flags.id === undefined) {
+            this.error('Either provide --name or --id');
+        }
+        await withDatabase(flags.database, this, async (db) => {
+            const resolver = new SymbolResolver(db, this);
+            const definition = resolver.resolve(flags.name, flags.id, flags.file);
+            if (!definition) {
+                return; // Disambiguation message already shown
+            }
+            // Get full definition details
+            const defDetails = db.definitions.getById(definition.id);
+            if (!defDetails) {
+                this.error(chalk.red(`Definition with ID ${definition.id} not found`));
+            }
+            // Trace the call graph from this entry point
+            const trace = this.traceFromEntry(db, definition.id, flags.depth);
+            // Build a tree structure for display
+            const tree = this.buildTree(db, definition.id, trace);
+            const jsonData = {
+                entryPoint: {
+                    id: defDetails.id,
+                    name: defDetails.name,
+                    kind: defDetails.kind,
+                    filePath: defDetails.filePath,
+                    line: defDetails.line,
+                },
+                maxDepth: flags.depth,
+                nodeCount: trace.length,
+                trace: this.flattenTree(tree),
+            };
+            outputJsonOrPlain(this, flags.json, jsonData, () => {
+                this.log(`Trace from: ${chalk.cyan(defDetails.name)} (${defDetails.filePath}:${defDetails.line})`);
+                this.log('');
+                if (trace.length <= 1) {
+                    this.log(chalk.gray('No outgoing calls found from this symbol.'));
+                    return;
+                }
+                this.printTree(tree, '', true);
+                this.log('');
+                this.log(chalk.gray(`${trace.length} nodes traced (max depth: ${flags.depth})`));
+            });
+        });
+    }
+    /**
+     * Trace reachable symbols from an entry point using call graph (BFS).
+     */
+    traceFromEntry(db, entryId, maxDepth) {
+        // Build call graph adjacency list
+        const edges = db.modules.getCallGraph();
+        const adjacency = new Map();
+        for (const edge of edges) {
+            if (!adjacency.has(edge.fromId)) {
+                adjacency.set(edge.fromId, []);
+            }
+            adjacency.get(edge.fromId).push(edge.toId);
+        }
+        // BFS traversal
+        const visited = new Map(); // defId -> depth
+        const queue = [{ id: entryId, depth: 0 }];
+        while (queue.length > 0) {
+            const { id, depth } = queue.shift();
+            if (visited.has(id))
+                continue;
+            if (depth > maxDepth)
+                continue;
+            visited.set(id, depth);
+            const neighbors = adjacency.get(id) ?? [];
+            for (const neighborId of neighbors) {
+                if (!visited.has(neighborId)) {
+                    queue.push({ id: neighborId, depth: depth + 1 });
+                }
+            }
+        }
+        // Get module info for each visited definition
+        const result = [];
+        for (const [definitionId, depth] of visited) {
+            const moduleInfo = db.modules.getDefinitionModule(definitionId);
+            result.push({
+                definitionId,
+                depth,
+                moduleId: moduleInfo?.module.id ?? null,
+            });
+        }
+        // Sort by depth
+        result.sort((a, b) => a.depth - b.depth);
+        return result;
+    }
+    buildTree(db, rootId, trace) {
+        // Build adjacency list from call graph
+        const edges = db.modules.getCallGraph();
+        const adjacency = new Map();
+        for (const edge of edges) {
+            if (!adjacency.has(edge.fromId)) {
+                adjacency.set(edge.fromId, []);
+            }
+            adjacency.get(edge.fromId).push(edge.toId);
+        }
+        // Build depth map for quick lookup
+        const depthMap = new Map();
+        for (const t of trace) {
+            depthMap.set(t.definitionId, t.depth);
+        }
+        // Build tree recursively
+        const visited = new Set();
+        const buildNode = (id, depth) => {
+            if (visited.has(id))
+                return null;
+            visited.add(id);
+            const def = db.definitions.getById(id);
+            if (!def)
+                return null;
+            const moduleInfo = db.modules.getDefinitionModule(id);
+            const children = [];
+            const neighbors = adjacency.get(id) ?? [];
+            for (const neighborId of neighbors) {
+                if (depthMap.has(neighborId) && !visited.has(neighborId)) {
+                    const childNode = buildNode(neighborId, depth + 1);
+                    if (childNode) {
+                        children.push(childNode);
+                    }
+                }
+            }
+            // Sort children by name for consistent output
+            children.sort((a, b) => a.name.localeCompare(b.name));
+            return {
+                id,
+                name: def.name,
+                kind: def.kind,
+                filePath: def.filePath,
+                line: def.line,
+                depth,
+                moduleId: moduleInfo?.module.id ?? null,
+                moduleName: moduleInfo?.module.name ?? null,
+                children,
+            };
+        };
+        return (buildNode(rootId, 0) ?? {
+            id: rootId,
+            name: 'unknown',
+            kind: 'unknown',
+            filePath: '',
+            line: 0,
+            depth: 0,
+            moduleId: null,
+            moduleName: null,
+            children: [],
+        });
+    }
+    flattenTree(node) {
+        const result = [];
+        const visit = (n) => {
+            result.push({
+                id: n.id,
+                name: n.name,
+                kind: n.kind,
+                filePath: n.filePath,
+                line: n.line,
+                depth: n.depth,
+                moduleName: n.moduleName,
+            });
+            for (const child of n.children) {
+                visit(child);
+            }
+        };
+        visit(node);
+        return result;
+    }
+    printTree(node, prefix, isLast) {
+        const connector = isLast ? '└── ' : '├── ';
+        const depthLabel = node.depth === 0 ? '' : `${chalk.gray(`[${node.depth}]`)} `;
+        const moduleLabel = node.moduleName ? chalk.magenta(` (${node.moduleName})`) : '';
+        if (node.depth === 0) {
+            this.log(`${depthLabel}${chalk.cyan(node.name)}${moduleLabel}`);
+        }
+        else {
+            this.log(`${prefix}${connector}${depthLabel}${chalk.cyan(node.name)}${moduleLabel}`);
+        }
+        const childPrefix = prefix + (isLast ? '    ' : '│   ');
+        for (let i = 0; i < node.children.length; i++) {
+            const isChildLast = i === node.children.length - 1;
+            this.printTree(node.children[i], childPrefix, isChildLast);
+        }
+    }
+}
+//# sourceMappingURL=trace.js.map

package/dist/commands/flows/trace.js.map

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

package/dist/commands/flows/update.d.ts

@@ -0,0 +1,17 @@
+import { Command } from '@oclif/core';
+export default class FlowsUpdate extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        'id-or-slug': import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        database: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        stakeholder: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private findFlow;
+}
+//# sourceMappingURL=update.d.ts.map

package/dist/commands/flows/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../../src/commands/flows/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAS,MAAM,aAAa,CAAC;AAKnD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,OAAO;IAC9C,OAAgB,WAAW,SAAmB;IAE9C,OAAgB,QAAQ,WAGtB;IAEF,OAAgB,IAAI;;MAElB;IAEF,OAAgB,KAAK;;;;;MAYnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BjC,OAAO,CAAC,QAAQ;CAWjB"}