@grafema/cli 0.2.12-beta → 0.3.1-beta

package/dist/commands/who.js

@@ -0,0 +1,184 @@
+/**
+ * who command — "Who uses this?"
+ *
+ * Find all callers and references to a symbol.
+ *
+ * Usage:
+ *   grafema who authenticate          # Who calls authenticate()?
+ *   grafema who UserService.findById  # Who calls this method?
+ */
+import { Command } from 'commander';
+import { resolve, join, isAbsolute, relative } from 'path';
+import { existsSync } from 'fs';
+import { RFDBServerBackend } from '@grafema/util';
+import { exitWithError } from '../utils/errorFormatter.js';
+import { Spinner } from '../utils/spinner.js';
+export const whoCommand = new Command('who')
+    .description('Who uses this? — find all callers/references to a symbol')
+    .argument('<symbol>', 'Function or method name')
+    .option('-p, --project <path>', 'Project path', '.')
+    .option('-j, --json', 'Output as JSON')
+    .addHelpText('after', `
+Examples:
+  grafema who authenticate          Who calls authenticate()?
+  grafema who UserService.findById  Who calls this method?
+  grafema who handleRequest --json  Output as JSON
+`)
+    .action(async (symbol, options) => {
+    const projectPath = resolve(options.project);
+    const grafemaDir = join(projectPath, '.grafema');
+    const dbPath = join(grafemaDir, 'graph.rfdb');
+    if (!existsSync(dbPath)) {
+        exitWithError('No graph database found', ['Run: grafema analyze']);
+    }
+    const backend = new RFDBServerBackend({ dbPath, clientName: 'cli' });
+    await backend.connect();
+    const spinner = new Spinner('Searching for callers...');
+    spinner.start();
+    try {
+        const lowerSymbol = symbol.toLowerCase();
+        // If symbol has a dot, extract the part after the last dot for method matching
+        const dotIndex = symbol.lastIndexOf('.');
+        const methodPart = dotIndex >= 0 ? symbol.substring(dotIndex + 1).toLowerCase() : null;
+        // Strategy 1: Find CALL nodes that match the symbol name
+        // (same approach as MCP handleFindCalls)
+        const matchingCalls = [];
+        for await (const node of backend.queryNodes({ type: 'CALL' })) {
+            const callName = (node.name || '').toLowerCase();
+            // Match exact name or method part after last dot
+            let isMatch = callName === lowerSymbol;
+            if (!isMatch && methodPart) {
+                const callMethodPart = callName.lastIndexOf('.') >= 0
+                    ? callName.substring(callName.lastIndexOf('.') + 1)
+                    : callName;
+                isMatch = callMethodPart === methodPart;
+            }
+            if (!isMatch && !methodPart) {
+                // Also match if the call name ends with the symbol (e.g., "obj.authenticate" matches "authenticate")
+                const callMethodPart = callName.lastIndexOf('.') >= 0
+                    ? callName.substring(callName.lastIndexOf('.') + 1)
+                    : null;
+                if (callMethodPart === lowerSymbol)
+                    isMatch = true;
+            }
+            if (!isMatch)
+                continue;
+            // Check resolution status via CALLS edges
+            const edges = await backend.getOutgoingEdges(node.id, ['CALLS']);
+            const resolved = edges.length > 0;
+            // Extract caller name from semantic ID
+            // Format: "file->SCOPE->TYPE->name" — parent scope is the caller
+            const idParts = node.id.split('->');
+            let callerName = '<anonymous>';
+            // Walk up the scope chain to find a FUNCTION or METHOD parent
+            for (let i = idParts.length - 3; i >= 1; i--) {
+                if (idParts[i] === 'FUNCTION' || idParts[i] === 'METHOD') {
+                    callerName = idParts[i + 1] || callerName;
+                    break;
+                }
+            }
+            const file = node.file || '';
+            matchingCalls.push({
+                file,
+                line: node.line,
+                callerName,
+                resolved,
+            });
+        }
+        // Strategy 2: Find the target function/method node and check incoming CALLS/READS_FROM edges
+        const incomingCallers = [];
+        let funcNode = null;
+        // Search for FUNCTION, METHOD, CLASS, or CONSTANT node matching the symbol
+        for (const nodeType of ['FUNCTION', 'METHOD', 'CLASS', 'CONSTANT']) {
+            for await (const n of backend.queryNodes({ type: nodeType })) {
+                const name = (n.name || '').toLowerCase();
+                if (name === lowerSymbol || (methodPart && name === methodPart)) {
+                    funcNode = n;
+                    break;
+                }
+            }
+            if (funcNode)
+                break;
+        }
+        if (funcNode) {
+            const incomingEdges = await backend.getIncomingEdges(funcNode.id, ['CALLS', 'READS_FROM', 'IMPORTS_FROM']);
+            for (const edge of incomingEdges) {
+                const srcNode = await backend.getNode(edge.src);
+                if (!srcNode)
+                    continue;
+                // Deduplicate — skip if we already found this call via Strategy 1
+                if (matchingCalls.some(c => c.file === (srcNode.file || '') && c.line === srcNode.line)) {
+                    continue;
+                }
+                incomingCallers.push({
+                    file: srcNode.file || '',
+                    line: srcNode.line,
+                    callerName: srcNode.name || '<anonymous>',
+                    resolved: true,
+                });
+            }
+        }
+        // Strategy 3: Find IMPORT_BINDING nodes that import this symbol
+        // (for classes/exports that are imported across files/repos)
+        const importers = [];
+        for await (const n of backend.queryNodes({ type: 'IMPORT_BINDING' })) {
+            const bindingName = (n.name || '').toLowerCase();
+            if (bindingName !== lowerSymbol && !(methodPart && bindingName === methodPart))
+                continue;
+            // Skip if already found via Strategy 1 or 2
+            if (matchingCalls.some(c => c.file === (n.file || '') && c.line === n.line))
+                continue;
+            if (incomingCallers.some(c => c.file === (n.file || '') && c.line === n.line))
+                continue;
+            importers.push({
+                file: n.file || '',
+                line: n.line,
+                callerName: `imports ${n.name || symbol}`,
+                resolved: true,
+            });
+        }
+        spinner.stop();
+        // Merge results
+        const allCallers = [...matchingCalls, ...incomingCallers, ...importers];
+        if (options.json) {
+            console.log(JSON.stringify({
+                symbol,
+                targetNode: funcNode ? { id: funcNode.id, type: funcNode.type, name: funcNode.name, file: funcNode.file } : null,
+                callers: allCallers.map(c => ({
+                    file: c.file,
+                    line: c.line,
+                    caller: c.callerName,
+                    resolved: c.resolved,
+                })),
+                total: allCallers.length,
+            }, null, 2));
+            return;
+        }
+        if (allCallers.length === 0) {
+            console.log(`${symbol} — no callers found`);
+            console.log('');
+            console.log('Hints:');
+            console.log('  - Check the symbol name is correct');
+            console.log('  - The function may be exported but unused in analyzed code');
+            console.log('  - Use: grafema query "<name>" to verify the symbol exists');
+            return;
+        }
+        console.log(`${symbol} — ${allCallers.length} caller${allCallers.length === 1 ? '' : 's'}`);
+        console.log('');
+        for (const caller of allCallers) {
+            const relFile = isAbsolute(caller.file)
+                ? relative(projectPath, caller.file)
+                : caller.file;
+            const location = caller.line ? `${relFile}:${caller.line}` : relFile;
+            const status = caller.resolved ? '[resolved]' : '[unresolved]';
+            const paddedLocation = location.padEnd(30);
+            const paddedCaller = caller.callerName.padEnd(20);
+            console.log(`  ${paddedLocation} ${paddedCaller} ${status}`);
+        }
+    }
+    finally {
+        spinner.stop();
+        await backend.close();
+    }
+});
+//# sourceMappingURL=who.js.map

package/dist/commands/who.js.map

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

package/dist/commands/why.d.ts

@@ -0,0 +1,12 @@
+/**
+ * why command — "Why is it this way?"
+ *
+ * Query knowledge base for architectural decisions and facts about a symbol or module.
+ *
+ * Usage:
+ *   grafema why auth-middleware       # Why was auth middleware designed this way?
+ *   grafema why UserService           # Decisions about UserService
+ */
+import { Command } from 'commander';
+export declare const whyCommand: Command;
+//# sourceMappingURL=why.d.ts.map

package/dist/commands/why.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"why.d.ts","sourceRoot":"","sources":["../../src/commands/why.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,eAAO,MAAM,UAAU,SA8GnB,CAAC"}

package/dist/commands/why.js

@@ -0,0 +1,118 @@
+/**
+ * why command — "Why is it this way?"
+ *
+ * Query knowledge base for architectural decisions and facts about a symbol or module.
+ *
+ * Usage:
+ *   grafema why auth-middleware       # Why was auth middleware designed this way?
+ *   grafema why UserService           # Decisions about UserService
+ */
+import { Command } from 'commander';
+import { resolve, join } from 'path';
+import { existsSync } from 'fs';
+import { KnowledgeBase } from '@grafema/util';
+import { exitWithError } from '../utils/errorFormatter.js';
+import { Spinner } from '../utils/spinner.js';
+export const whyCommand = new Command('why')
+    .description('Why is it this way? — query knowledge base decisions and facts')
+    .argument('<query>', 'Search text (symbol name, module, or topic)')
+    .option('-p, --project <path>', 'Project path', '.')
+    .option('-j, --json', 'Output as JSON')
+    .addHelpText('after', `
+Examples:
+  grafema why auth-middleware       Why was auth middleware designed this way?
+  grafema why UserService           Decisions about UserService
+  grafema why "error handling"      Facts about error handling approach
+  grafema why dataflow --json       Output as JSON
+`)
+    .action(async (query, options) => {
+    const projectPath = resolve(options.project);
+    const knowledgeDir = join(projectPath, 'knowledge');
+    if (!existsSync(knowledgeDir)) {
+        exitWithError('No knowledge base found', [
+            'Knowledge directory not found: ' + knowledgeDir,
+            'Use `add_knowledge` MCP tool to capture architectural decisions',
+        ]);
+    }
+    const spinner = new Spinner('Searching knowledge base...');
+    spinner.start();
+    try {
+        const kb = new KnowledgeBase(knowledgeDir);
+        await kb.load();
+        // Search DECISION nodes matching query text
+        const decisions = await kb.queryNodes({ type: 'DECISION', text: query });
+        // Search FACT nodes matching query text
+        const facts = await kb.queryNodes({ type: 'FACT', text: query });
+        spinner.stop();
+        if (options.json) {
+            console.log(JSON.stringify({
+                query,
+                decisions: decisions.map(d => ({
+                    id: d.id,
+                    status: d.status,
+                    content: d.content,
+                    applies_to: d.applies_to,
+                    relates_to: d.relates_to,
+                })),
+                facts: facts.map(f => ({
+                    id: f.id,
+                    confidence: f.confidence,
+                    content: f.content,
+                    relates_to: f.relates_to,
+                })),
+                total: decisions.length + facts.length,
+            }, null, 2));
+            return;
+        }
+        if (decisions.length === 0 && facts.length === 0) {
+            console.log(`No knowledge found for: "${query}"`);
+            console.log('');
+            console.log('No decisions or facts recorded matching this query.');
+            console.log('Use `add_knowledge` MCP tool to capture architectural decisions.');
+            return;
+        }
+        // Display decisions
+        if (decisions.length > 0) {
+            console.log(`Decisions (${decisions.length}):`);
+            console.log('');
+            for (const d of decisions) {
+                console.log(`  [${d.status?.toUpperCase() || 'ACTIVE'}] ${d.id}`);
+                // Show first ~200 chars of content as summary
+                const summary = d.content.length > 200
+                    ? d.content.substring(0, 200) + '...'
+                    : d.content;
+                // Indent content lines
+                for (const line of summary.split('\n')) {
+                    console.log(`    ${line}`);
+                }
+                if (d.applies_to && d.applies_to.length > 0) {
+                    console.log(`    Applies to: ${d.applies_to.join(', ')}`);
+                }
+                console.log('');
+            }
+        }
+        // Display facts
+        if (facts.length > 0) {
+            console.log(`Facts (${facts.length}):`);
+            console.log('');
+            for (const f of facts) {
+                const confidence = f.confidence ? ` [${f.confidence}]` : '';
+                console.log(`  ${f.id}${confidence}`);
+                const summary = f.content.length > 200
+                    ? f.content.substring(0, 200) + '...'
+                    : f.content;
+                for (const line of summary.split('\n')) {
+                    console.log(`    ${line}`);
+                }
+                if (f.relates_to && f.relates_to.length > 0) {
+                    console.log(`    Relates to: ${f.relates_to.join(', ')}`);
+                }
+                console.log('');
+            }
+        }
+    }
+    finally {
+        spinner.stop();
+    }
+});
+//# sourceMappingURL=why.js.map

package/dist/commands/why.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"why.js","sourceRoot":"","sources":["../../src/commands/why.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAO9C,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC;KACzC,WAAW,CAAC,gEAAgE,CAAC;KAC7E,QAAQ,CAAC,SAAS,EAAE,6CAA6C,CAAC;KAClE,MAAM,CAAC,sBAAsB,EAAE,cAAc,EAAE,GAAG,CAAC;KACnD,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC;KACtC,WAAW,CAAC,OAAO,EAAE;;;;;;CAMvB,CAAC;KACC,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,OAA0B,EAAE,EAAE;IAC1D,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IAEpD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,aAAa,CAAC,yBAAyB,EAAE;YACvC,iCAAiC,GAAG,YAAY;YAChD,iEAAiE;SAClE,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,6BAA6B,CAAC,CAAC;IAC3D,OAAO,CAAC,KAAK,EAAE,CAAC;IAEhB,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,IAAI,aAAa,CAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;QAEhB,4CAA4C;QAC5C,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,CAAiB,CAAC;QAEzF,wCAAwC;QACxC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAa,CAAC;QAE7E,OAAO,CAAC,IAAI,EAAE,CAAC;QAEf,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;gBACzB,KAAK;gBACL,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBAC7B,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,UAAU,EAAE,CAAC,CAAC,UAAU;oBACxB,UAAU,EAAE,CAAC,CAAC,UAAU;iBACzB,CAAC,CAAC;gBACH,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBACrB,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,UAAU,EAAE,CAAC,CAAC,UAAU;oBACxB,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,UAAU,EAAE,CAAC,CAAC,UAAU;iBACzB,CAAC,CAAC;gBACH,KAAK,EAAE,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;aACvC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACb,OAAO;QACT,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,4BAA4B,KAAK,GAAG,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;YACnE,OAAO,CAAC,GAAG,CAAC,kEAAkE,CAAC,CAAC;YAChF,OAAO;QACT,CAAC;QAED,oBAAoB;QACpB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,cAAc,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBAC1B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClE,8CAA8C;gBAC9C,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG;oBACpC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK;oBACrC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACd,uBAAuB;gBACvB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBACvC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;gBAC7B,CAAC;gBACD,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC5C,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC5D,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAED,gBAAgB;QAChB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,UAAU,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,MAAM,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC;gBACtC,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG;oBACpC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK;oBACrC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACd,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBACvC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;gBAC7B,CAAC;gBACD,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC5C,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC5D,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,IAAI,EAAE,CAAC;IACjB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/commands/wtf.d.ts

@@ -0,0 +1,12 @@
+/**
+ * wtf command — "Where does this come from?"
+ *
+ * Backward dataflow trace with arrow-formatted output.
+ *
+ * Usage:
+ *   grafema wtf req.user              # Backward trace
+ *   grafema wtf config.apiKey         # Where does this value originate?
+ */
+import { Command } from 'commander';
+export declare const wtfCommand: Command;
+//# sourceMappingURL=wtf.d.ts.map

package/dist/commands/wtf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wtf.d.ts","sourceRoot":"","sources":["../../src/commands/wtf.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,eAAO,MAAM,UAAU,SA+GnB,CAAC"}

package/dist/commands/wtf.js

@@ -0,0 +1,117 @@
+/**
+ * wtf command — "Where does this come from?"
+ *
+ * Backward dataflow trace with arrow-formatted output.
+ *
+ * Usage:
+ *   grafema wtf req.user              # Backward trace
+ *   grafema wtf config.apiKey         # Where does this value originate?
+ */
+import { Command } from 'commander';
+import { resolve, join } from 'path';
+import { existsSync } from 'fs';
+import { RFDBServerBackend, traceDataflow, renderTraceNarrative, } from '@grafema/util';
+import { exitWithError } from '../utils/errorFormatter.js';
+import { Spinner } from '../utils/spinner.js';
+export const wtfCommand = new Command('wtf')
+    .description('Where does this come from? — backward dataflow trace')
+    .argument('<symbol>', 'Variable, constant, or parameter name to trace')
+    .option('-p, --project <path>', 'Project path', '.')
+    .option('-d, --depth <n>', 'Max trace depth', '10')
+    .option('-j, --json', 'Output as JSON')
+    .addHelpText('after', `
+Examples:
+  grafema wtf req.user              Trace where req.user comes from
+  grafema wtf config.apiKey         Where does this value originate?
+  grafema wtf userId --depth 5      Limit trace depth
+  grafema wtf token --json          Output as JSON
+`)
+    .action(async (symbol, options) => {
+    const projectPath = resolve(options.project);
+    const grafemaDir = join(projectPath, '.grafema');
+    const dbPath = join(grafemaDir, 'graph.rfdb');
+    if (!existsSync(dbPath)) {
+        exitWithError('No graph database found', ['Run: grafema analyze']);
+    }
+    const maxDepth = parseInt(options.depth, 10);
+    if (isNaN(maxDepth) || maxDepth < 1) {
+        exitWithError('Invalid depth', ['Provide a positive integer']);
+    }
+    const backend = new RFDBServerBackend({ dbPath, clientName: 'cli' });
+    await backend.connect();
+    const spinner = new Spinner('Searching for symbol...');
+    spinner.start();
+    try {
+        // Find the node: search VARIABLE, CONSTANT, PARAMETER by name (case-insensitive)
+        // Also try PROPERTY_ACCESS by matching method part after last dot
+        const lowerSymbol = symbol.toLowerCase();
+        // If symbol has a dot, extract the part after the last dot for method matching
+        const dotIndex = symbol.lastIndexOf('.');
+        const methodPart = dotIndex >= 0 ? symbol.substring(dotIndex + 1).toLowerCase() : null;
+        let found = null;
+        for (const nodeType of ['VARIABLE', 'CONSTANT', 'PARAMETER']) {
+            for await (const n of backend.queryNodes({ type: nodeType })) {
+                const name = (n.name || '').toLowerCase();
+                if (name === lowerSymbol) {
+                    found = { id: n.id, type: n.type || nodeType, name: n.name || '', file: n.file || '', line: n.line };
+                    break;
+                }
+            }
+            if (found)
+                break;
+        }
+        // Try PROPERTY_ACCESS if not found and symbol has a dot
+        if (!found && methodPart) {
+            for await (const n of backend.queryNodes({ type: 'PROPERTY_ACCESS' })) {
+                const name = (n.name || '').toLowerCase();
+                // Match by full name or by the part after last dot
+                const nameMethodPart = name.lastIndexOf('.') >= 0
+                    ? name.substring(name.lastIndexOf('.') + 1)
+                    : name;
+                if (name === lowerSymbol || nameMethodPart === methodPart) {
+                    found = { id: n.id, type: n.type || 'PROPERTY_ACCESS', name: n.name || '', file: n.file || '', line: n.line };
+                    break;
+                }
+            }
+        }
+        if (!found) {
+            spinner.stop();
+            exitWithError(`Symbol not found: "${symbol}"`, [
+                'Check the symbol name and try again',
+                'Use: grafema query "<name>" to search available nodes',
+            ]);
+            return;
+        }
+        spinner.stop();
+        // Cast backend to DataflowBackend
+        const dfDb = backend;
+        // Trace backward
+        const results = await traceDataflow(dfDb, found.id, {
+            direction: 'backward',
+            maxDepth,
+        });
+        if (options.json) {
+            console.log(JSON.stringify({
+                symbol: found.name,
+                node: found,
+                results: results.map(r => ({
+                    direction: r.direction,
+                    startNode: r.startNode,
+                    reached: r.reached,
+                    totalReached: r.totalReached,
+                })),
+            }, null, 2));
+        }
+        else {
+            console.log(`${found.name} (${found.type}) — ${found.file}${found.line ? ':' + found.line : ''}`);
+            console.log('');
+            const narrative = renderTraceNarrative(results, found.name, { detail: 'normal' });
+            console.log(narrative);
+        }
+    }
+    finally {
+        spinner.stop();
+        await backend.close();
+    }
+});
+//# sourceMappingURL=wtf.js.map

package/dist/commands/wtf.js.map

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

package/dist/plugins/builtinPlugins.d.ts

@@ -1,10 +1,2 @@
-/**
- * Built-in plugin registry — maps plugin names to factory functions.
- *
- * Each entry creates a fresh plugin instance. Plugin names match the class names
- * and are referenced by name in .grafema/config.yaml under phases:
- * discovery, indexing, analysis, enrichment, validation.
- */
-import type { Plugin } from '@grafema/core';
-export declare const BUILTIN_PLUGINS: Record<string, () => Plugin>;
+export {};
 //# sourceMappingURL=builtinPlugins.d.ts.map

package/dist/plugins/builtinPlugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtinPlugins.d.ts","sourceRoot":"","sources":["../../src/plugins/builtinPlugins.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAmD5C,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,MAAM,CAgDxD,CAAC"}
+{"version":3,"file":"builtinPlugins.d.ts","sourceRoot":"","sources":["../../src/plugins/builtinPlugins.ts"],"names":[],"mappings":""}

package/dist/plugins/builtinPlugins.js

@@ -1,68 +1,3 @@
-/**
- * Built-in plugin registry — maps plugin names to factory functions.
- *
- * Each entry creates a fresh plugin instance. Plugin names match the class names
- * and are referenced by name in .grafema/config.yaml under phases:
- * discovery, indexing, analysis, enrichment, validation.
- */
-import { 
-// Discovery
-SimpleProjectDiscovery, MonorepoServiceDiscovery, WorkspaceDiscovery, 
-// Indexing
-JSModuleIndexer, RustModuleIndexer, 
-// Analysis
-JSASTAnalyzer, ExpressRouteAnalyzer, ExpressResponseAnalyzer, NestJSRouteAnalyzer, SocketIOAnalyzer, DatabaseAnalyzer, FetchAnalyzer, ServiceLayerAnalyzer, ReactAnalyzer, RustAnalyzer, 
-// Enrichment
-MethodCallResolver, ArgumentParameterLinker, AliasTracker, ValueDomainAnalyzer, MountPointResolver, ExpressHandlerLinker, PrefixEvaluator, InstanceOfResolver, ImportExportLinker, FunctionCallResolver, HTTPConnectionEnricher, ConfigRoutingMapBuilder, ServiceConnectionEnricher, RustFFIEnricher, RejectionPropagationEnricher, CallbackCallResolver, 
-// Validation
-CallResolverValidator, EvalBanValidator, SQLInjectionValidator, AwaitInLoopValidator, ShadowingDetector, GraphConnectivityValidator, DataFlowValidator, TypeScriptDeadCodeValidator, BrokenImportValidator, UnconnectedRouteValidator, PackageCoverageValidator, } from '@grafema/core';
-export const BUILTIN_PLUGINS = {
-    // Discovery
-    SimpleProjectDiscovery: () => new SimpleProjectDiscovery(),
-    MonorepoServiceDiscovery: () => new MonorepoServiceDiscovery(),
-    WorkspaceDiscovery: () => new WorkspaceDiscovery(),
-    // Indexing
-    JSModuleIndexer: () => new JSModuleIndexer(),
-    RustModuleIndexer: () => new RustModuleIndexer(),
-    // Analysis
-    JSASTAnalyzer: () => new JSASTAnalyzer(),
-    ExpressRouteAnalyzer: () => new ExpressRouteAnalyzer(),
-    ExpressResponseAnalyzer: () => new ExpressResponseAnalyzer(),
-    NestJSRouteAnalyzer: () => new NestJSRouteAnalyzer(),
-    SocketIOAnalyzer: () => new SocketIOAnalyzer(),
-    DatabaseAnalyzer: () => new DatabaseAnalyzer(),
-    FetchAnalyzer: () => new FetchAnalyzer(),
-    ServiceLayerAnalyzer: () => new ServiceLayerAnalyzer(),
-    ReactAnalyzer: () => new ReactAnalyzer(),
-    RustAnalyzer: () => new RustAnalyzer(),
-    // Enrichment
-    MethodCallResolver: () => new MethodCallResolver(),
-    ArgumentParameterLinker: () => new ArgumentParameterLinker(),
-    AliasTracker: () => new AliasTracker(),
-    ValueDomainAnalyzer: () => new ValueDomainAnalyzer(),
-    MountPointResolver: () => new MountPointResolver(),
-    ExpressHandlerLinker: () => new ExpressHandlerLinker(),
-    PrefixEvaluator: () => new PrefixEvaluator(),
-    InstanceOfResolver: () => new InstanceOfResolver(),
-    ImportExportLinker: () => new ImportExportLinker(),
-    FunctionCallResolver: () => new FunctionCallResolver(),
-    HTTPConnectionEnricher: () => new HTTPConnectionEnricher(),
-    ConfigRoutingMapBuilder: () => new ConfigRoutingMapBuilder(),
-    ServiceConnectionEnricher: () => new ServiceConnectionEnricher(),
-    RustFFIEnricher: () => new RustFFIEnricher(),
-    RejectionPropagationEnricher: () => new RejectionPropagationEnricher(),
-    CallbackCallResolver: () => new CallbackCallResolver(),
-    // Validation
-    CallResolverValidator: () => new CallResolverValidator(),
-    EvalBanValidator: () => new EvalBanValidator(),
-    SQLInjectionValidator: () => new SQLInjectionValidator(),
-    AwaitInLoopValidator: () => new AwaitInLoopValidator(),
-    ShadowingDetector: () => new ShadowingDetector(),
-    GraphConnectivityValidator: () => new GraphConnectivityValidator(),
-    DataFlowValidator: () => new DataFlowValidator(),
-    TypeScriptDeadCodeValidator: () => new TypeScriptDeadCodeValidator(),
-    BrokenImportValidator: () => new BrokenImportValidator(),
-    UnconnectedRouteValidator: () => new UnconnectedRouteValidator(),
-    PackageCoverageValidator: () => new PackageCoverageValidator(),
-};
+export {};
+// Deleted: plugin registration moved to grafema-orchestrator (Rust).
 //# sourceMappingURL=builtinPlugins.js.map

package/dist/plugins/builtinPlugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"builtinPlugins.js","sourceRoot":"","sources":["../../src/plugins/builtinPlugins.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"builtinPlugins.js","sourceRoot":"","sources":["../../src/plugins/builtinPlugins.ts"],"names":[],"mappings":";AAAA,qEAAqE"}

package/dist/plugins/pluginLoader.d.ts

@@ -1,16 +1,2 @@
-/**
- * Plugin loading — resolves built-in and custom plugins from config.
- *
- * Handles:
- * - ESM resolve hook for custom plugin @grafema/* imports
- * - Loading custom plugins from .grafema/plugins/
- * - Creating plugin instances from config phases
- */
-import type { Plugin, GrafemaConfig } from '@grafema/core';
-export declare function registerPluginResolver(): void;
-/**
- * Load custom plugins from .grafema/plugins/ directory
- */
-export declare function loadCustomPlugins(projectPath: string, log: (msg: string) => void): Promise<Record<string, () => Plugin>>;
-export declare function createPlugins(config: GrafemaConfig['plugins'], customPlugins?: Record<string, () => Plugin>, verbose?: boolean): Plugin[];
+export {};
 //# sourceMappingURL=pluginLoader.d.ts.map

package/dist/plugins/pluginLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pluginLoader.d.ts","sourceRoot":"","sources":["../../src/plugins/pluginLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAgB3D,wBAAgB,sBAAsB,IAAI,IAAI,CAiB7C;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC,CAAC,CA2CvC;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,EAChC,aAAa,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,MAAM,CAAM,EAChD,OAAO,GAAE,OAAe,GACvB,MAAM,EAAE,CAmBV"}
+{"version":3,"file":"pluginLoader.d.ts","sourceRoot":"","sources":["../../src/plugins/pluginLoader.ts"],"names":[],"mappings":""}