ai-mind-map 1.1.0

package/dist/knowledge-graph/flow-analyzer.d.ts

@@ -0,0 +1,167 @@
+/**
+ * AI Mind Map — Flow Analyzer & Interaction Map
+ *
+ * Maps the BEHAVIORAL flow of an application:
+ *   Button click → event handler → API call → DB write → UI update
+ *
+ * This goes beyond structural analysis (what calls what) to map the
+ * full user-interaction pipeline:
+ *   - UI events → handlers → side effects
+ *   - API routes → controllers → services → data layer
+ *   - State changes → re-renders → UI updates
+ *   - Event emitters → listeners → cascading effects
+ *
+ * The AI agent can ask "what happens when the user clicks Save?"
+ * and get the full pipeline without reading any code.
+ */
+import { KnowledgeGraph } from './graph.js';
+/** A single step in a user-interaction pipeline */
+export interface FlowStep {
+    /** Position in the pipeline (0 = trigger) */
+    order: number;
+    /** What happens at this step */
+    action: string;
+    /** The layer this belongs to */
+    layer: FlowLayer;
+    /** File where this step lives */
+    filePath: string;
+    /** Function/method name */
+    symbolName: string;
+    /** The function signature */
+    signature: string;
+    /** Line number in source */
+    line: number;
+    /** What this step produces (output) */
+    produces?: string;
+    /** Node ID in the knowledge graph */
+    nodeId?: string;
+}
+/** Application layers (for classifying each step) */
+export type FlowLayer = 'ui_event' | 'ui_component' | 'event_handler' | 'state_update' | 'api_call' | 'route' | 'controller' | 'service' | 'repository' | 'database' | 'middleware' | 'validator' | 'util' | 'unknown';
+/** A complete interaction flow from trigger to final effect */
+export interface InteractionFlow {
+    /** Human-readable name: "Save Note", "Delete User", "Login" */
+    name: string;
+    /** The trigger (button, route, event) */
+    trigger: string;
+    /** Full pipeline of steps */
+    steps: FlowStep[];
+    /** Which files are touched in this flow */
+    filesInvolved: string[];
+    /** Risk level if this flow breaks */
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    /** What data/state this flow modifies */
+    sideEffects: string[];
+}
+/** A component's interaction map */
+export interface ComponentMap {
+    /** Component name */
+    name: string;
+    /** File path */
+    filePath: string;
+    /** Props/inputs this component accepts */
+    inputs: Array<{
+        name: string;
+        type: string;
+    }>;
+    /** Events/actions this component can trigger */
+    actions: Array<{
+        trigger: string;
+        handler: string;
+        flow: InteractionFlow;
+    }>;
+    /** State this component manages */
+    state: string[];
+    /** Child components it renders */
+    children: string[];
+    /** Data sources (API calls, store reads) */
+    dataSources: string[];
+}
+/** Full application interaction map */
+export interface AppInteractionMap {
+    /** All detected routes with their full pipelines */
+    routes: InteractionFlow[];
+    /** All detected UI event handlers with pipelines */
+    eventHandlers: InteractionFlow[];
+    /** Component-level interaction maps */
+    components: ComponentMap[];
+    /** Layer summary: how many symbols per layer */
+    layerSummary: Record<FlowLayer, number>;
+    /** Files grouped by layer */
+    filesByLayer: Record<string, FlowLayer>;
+}
+export declare class FlowAnalyzer {
+    private readonly graph;
+    private readonly projectRoot;
+    constructor(graph: KnowledgeGraph, projectRoot: string);
+    /**
+     * Build the complete interaction map for the application.
+     */
+    buildInteractionMap(): AppInteractionMap;
+    /**
+     * Trace a complete flow starting from a specific symbol.
+     * "What happens when createNote() is called?"
+     */
+    traceFlow(startSymbol: string, maxDepth?: number): InteractionFlow;
+    /**
+     * Trace a flow starting from a route.
+     * "What happens when someone hits POST /api/notes?"
+     */
+    traceRoute(routePattern: string): InteractionFlow;
+    /**
+     * Classify a single file by its layer using weighted multi-signal scoring.
+     */
+    classifyFile(filePath: string): FlowLayer;
+    /**
+     * Full classification with confidence details.
+     * Returns the winning layer, confidence score, all signal hits, and runner-up layers.
+     */
+    getFileClassification(filePath: string): {
+        layer: FlowLayer;
+        confidence: number;
+        signals: Array<{
+            source: string;
+            layer: FlowLayer;
+            weight: number;
+        }>;
+        runnerUp?: FlowLayer;
+    };
+    /**
+     * Get a summary of how the app is structured by layers.
+     */
+    getLayerOverview(): Array<{
+        layer: FlowLayer;
+        fileCount: number;
+        symbolCount: number;
+        files: string[];
+        keySymbols: string[];
+    }>;
+    private traceFromNode;
+    /**
+     * When the graph has no explicit 'calls' edges (common in C# partial classes),
+     * read the method body and search for method names that exist in the same class
+     * across any partial class file.
+     *
+     * E.g., NotesToggle_Click() calls OpenNotesPanel() which is in a different
+     * partial class file — the static parser may not have created an edge.
+     */
+    private discoverInlineCalls;
+    private escapeRegex;
+    private detectRoutes;
+    private detectEventHandlers;
+    private buildComponentMaps;
+    /** Score a file across ALL layers and return the best match */
+    private scoreFile;
+    /** File classification cache to avoid re-reading files */
+    private fileClassCache;
+    private classifyFilesByLayer;
+    private classifySymbol;
+    private buildLayerSummary;
+    private describeAction;
+    private inferProduces;
+    private assessRisk;
+    private generateFlowName;
+    private emptyFlow;
+    private getAllNodes;
+}
+//# sourceMappingURL=flow-analyzer.d.ts.map

package/dist/knowledge-graph/flow-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-analyzer.d.ts","sourceRoot":"","sources":["../../src/knowledge-graph/flow-analyzer.ts"],"names":[],"mappings":"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"}