bobs-workshop 0.3.0 → 0.3.2

package/dist/tools/structural/engines/typescript/utils.js.map

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

package/dist/tools/structural/index.js

@@ -0,0 +1,248 @@
+import * as fs from "fs";
+import * as path from "path";
+import { TypeScriptEngine } from "./engines/typescript/index.js";
+import { ErrorCode, AnalysisError } from "./types.js";
+/**
+ * Structural Search Orchestrator
+ *
+ * Coordinates AST-based structural searches across different languages.
+ * Routes queries to appropriate engines (TypeScript, Python, etc.)
+ */
+export class StructuralSearchOrchestrator {
+    constructor() {
+        this.engines = new Map([
+            ["typescript", new TypeScriptEngine()],
+            ["javascript", new TypeScriptEngine()], // JS uses TS engine
+            ["tsx", new TypeScriptEngine()],
+            ["jsx", new TypeScriptEngine()],
+            // ["python", new PythonEngine()], // Disabled until Phase 2
+        ]);
+    }
+    /**
+     * Main search method - analyzes query and routes to appropriate engine
+     */
+    async search(query, options) {
+        const language = this.detectLanguage(options.scope || process.cwd());
+        const engine = this.selectEngine(language);
+        if (!engine) {
+            throw new AnalysisError({
+                code: ErrorCode.PARSE_ERROR,
+                message: `No structural search engine available for language: ${language}`,
+                details: {
+                    suggestion: "Structural search currently supports TypeScript/JavaScript. Use lexical or semantic search for other languages."
+                }
+            });
+        }
+        const operation = this.parseOperation(query);
+        const scope = options.scope || process.cwd();
+        switch (operation.type) {
+            case "references":
+                if (!operation.symbol) {
+                    throw new AnalysisError({
+                        code: ErrorCode.INVALID_PATTERN,
+                        message: "Symbol name is required for references search"
+                    });
+                }
+                return engine.findReferences(operation.symbol, scope, options);
+            case "definition":
+                if (!operation.symbol) {
+                    throw new AnalysisError({
+                        code: ErrorCode.INVALID_PATTERN,
+                        message: "Symbol name is required for definition search"
+                    });
+                }
+                const def = await engine.findDefinition(operation.symbol, scope, options);
+                return def ? [def] : [];
+            case "dependencies":
+                // If a target file is specified in the query, resolve it relative to scope
+                const targetPath = operation.target
+                    ? (path.isAbsolute(operation.target) ? operation.target : path.join(scope, operation.target))
+                    : scope;
+                return engine.getDependencies(targetPath, options);
+            case "architectural-issues":
+                // Architect-specific: find architectural problems
+                if (language === "typescript" || language === "javascript") {
+                    const tsEngine = engine;
+                    const issues = await tsEngine.findArchitecturalIssues(scope);
+                    return issues.map(issue => ({
+                        file: issue.location.file,
+                        line: issue.location.position.line,
+                        symbol: issue.type,
+                        kind: "variable",
+                        context: `${issue.severity.toUpperCase()}: ${issue.message}`,
+                        relevance: issue.severity === "error" ? 1.0 : issue.severity === "warning" ? 0.7 : 0.5
+                    }));
+                }
+                return [];
+            case "call-graph":
+                // Debugger-specific: show call relationships
+                if (!operation.symbol) {
+                    throw new AnalysisError({
+                        code: ErrorCode.INVALID_PATTERN,
+                        message: "Symbol name is required for call graph analysis"
+                    });
+                }
+                // For now, use references as a proxy for call graph
+                return engine.findReferences(operation.symbol, scope, options);
+            case "unused-exports":
+                // Engineer-specific: find unused exports
+                if (language === "typescript" || language === "javascript") {
+                    const tsEngine = engine;
+                    const unused = await tsEngine.findUnusedExports(scope);
+                    return unused.map(item => ({
+                        file: item.location.file,
+                        line: item.location.position.line,
+                        symbol: item.name,
+                        kind: item.kind,
+                        context: `Unused export from ${item.exportedFrom}`,
+                        relevance: 0.8
+                    }));
+                }
+                return [];
+            default:
+                throw new AnalysisError({
+                    code: ErrorCode.INVALID_PATTERN,
+                    message: `Unsupported operation type: ${operation.type}`
+                });
+        }
+    }
+    /**
+     * Detect programming language from project structure
+     */
+    detectLanguage(projectPath) {
+        // Check if path looks like a file (has extension), even if it doesn't exist
+        const ext = path.extname(projectPath).substring(1);
+        if (ext) {
+            // Normalize extensions to language names
+            if (ext === 'ts' || ext === 'tsx')
+                return 'typescript';
+            if (ext === 'js' || ext === 'jsx')
+                return 'javascript';
+            if (ext === 'py')
+                return 'python';
+            return ext || "typescript";
+        }
+        // If it's an existing file, use its extension
+        if (fs.existsSync(projectPath) && fs.statSync(projectPath).isFile()) {
+            return "typescript"; // Default for files without extension
+        }
+        // Check for project indicators
+        const indicators = [
+            { file: "tsconfig.json", language: "typescript" },
+            { file: "package.json", language: "typescript" }, // Assume TypeScript for Node projects
+            { file: "requirements.txt", language: "python" },
+            { file: "setup.py", language: "python" },
+            { file: "pyproject.toml", language: "python" },
+        ];
+        for (const { file, language } of indicators) {
+            if (fs.existsSync(path.join(projectPath, file))) {
+                return language;
+            }
+        }
+        // Default to TypeScript
+        return "typescript";
+    }
+    /**
+     * Select appropriate engine for language
+     */
+    selectEngine(language) {
+        return this.engines.get(language);
+    }
+    /**
+     * Parse natural language query to extract operation intent
+     *
+     * Supported patterns (from spec):
+     * - US-1: "find references to UserService"
+     * - US-1: "show all usages of calculatePrice"
+     * - US-2: "go to definition of AuthToken"
+     * - US-2: "where is validateInput defined"
+     * - US-3: "show dependencies for user.ts"
+     * - US-3: "what does api/auth.ts import"
+     */
+    parseOperation(query) {
+        const normalized = query.toLowerCase().trim();
+        const original = query.trim(); // Preserve original casing for symbol names
+        // Pattern 1: References
+        if (normalized.match(/find references (to|for|of)\s+(\w+)/) ||
+            normalized.match(/show (all )?usages? (of|for)\s+(\w+)/) ||
+            normalized.match(/where is (\w+) used/) ||
+            normalized.match(/who uses (\w+)/)) {
+            // Extract symbol from original query to preserve casing
+            const symbolMatch = original.match(/(?:to|for|of|used|uses)\s+(\w+)/) ||
+                original.match(/where is (\w+)/);
+            const symbol = symbolMatch ? symbolMatch[1] : undefined;
+            return {
+                type: "references",
+                symbol
+            };
+        }
+        // Pattern 2: Definition
+        if (normalized.match(/go to definition (of|for)\s+(\w+)/) ||
+            normalized.match(/where is (\w+) defined/) ||
+            normalized.match(/find definition (of|for)\s+(\w+)/) ||
+            normalized.match(/show (\w+) definition/)) {
+            // Extract symbol from original query to preserve casing
+            const symbolMatch = original.match(/(?:of|for|is)\s+(\w+)(?:\s+defined)?/) ||
+                original.match(/show (\w+)/);
+            const symbol = symbolMatch ? symbolMatch[1] : undefined;
+            return {
+                type: "definition",
+                symbol
+            };
+        }
+        // Pattern 3: Dependencies
+        if (normalized.match(/show dependencies (for|of)\s+(.+)/) ||
+            normalized.match(/what does (.+) import/) ||
+            normalized.match(/list imports (in|for)\s+(.+)/) ||
+            normalized.match(/dependencies (of|for)\s+(.+)/)) {
+            // Extract from original query to preserve casing
+            const targetMatch = original.match(/(?:for|of)\s+(.+)$/) ||
+                original.match(/what does (.+) import/) ||
+                original.match(/(?:in|for)\s+(.+)$/);
+            const target = targetMatch ? targetMatch[1].trim() : undefined;
+            return {
+                type: "dependencies",
+                target
+            };
+        }
+        // Pattern 4: Call graph
+        if (normalized.match(/call graph (for|of)\s+(\w+)/) ||
+            normalized.match(/what calls (\w+)/) ||
+            normalized.match(/show callers (of|for)\s+(\w+)/)) {
+            // Extract symbol from original query to preserve casing
+            const symbolMatch = original.match(/(?:for|of|calls)\s+(\w+)/) ||
+                original.match(/what calls (\w+)/);
+            const symbol = symbolMatch ? symbolMatch[1] : undefined;
+            return {
+                type: "call-graph",
+                symbol
+            };
+        }
+        // Pattern 5: Architectural issues
+        if (normalized.match(/find (circular|architectural) (dependencies|issues)/) ||
+            normalized.match(/check architecture/) ||
+            normalized.match(/analyze (architecture|structure)/) ||
+            normalized.match(/circular dependencies/)) {
+            return {
+                type: "architectural-issues"
+            };
+        }
+        // Pattern 6: Unused exports
+        if (normalized.match(/find unused exports/) ||
+            normalized.match(/show unused exports/) ||
+            normalized.match(/list unused exports/) ||
+            normalized.match(/unused (code|exports)/)) {
+            return {
+                type: "unused-exports"
+            };
+        }
+        // Default: Try to extract symbol name and assume references search
+        const words = original.split(/\s+/); // Use original to detect CamelCase
+        const potentialSymbol = words.find(w => /^[A-Z][a-zA-Z0-9]*$/.test(w)); // CamelCase
+        return {
+            type: "references",
+            symbol: potentialSymbol
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/structural/index.js.map

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

package/dist/tools/structural/types.js

@@ -0,0 +1,18 @@
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+    ErrorCode["PARSE_ERROR"] = "PARSE_ERROR";
+    ErrorCode["TIMEOUT"] = "TIMEOUT";
+    ErrorCode["MEMORY_LIMIT"] = "MEMORY_LIMIT";
+    ErrorCode["INVALID_PATTERN"] = "INVALID_PATTERN";
+    ErrorCode["SCOPE_ERROR"] = "SCOPE_ERROR";
+})(ErrorCode || (ErrorCode = {}));
+export class AnalysisError extends Error {
+    constructor(data) {
+        super(data.message);
+        this.code = data.code;
+        this.details = data.details;
+        this.name = "AnalysisError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/tools/structural/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/structural/types.ts"],"names":[],"mappings":"AAwHA,MAAM,CAAN,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,8CAAiC,CAAA;IACjC,wCAA2B,CAAA;IAC3B,gCAAmB,CAAA;IACnB,0CAA6B,CAAA;IAC7B,gDAAmC,CAAA;IACnC,wCAA2B,CAAA;AAC7B,CAAC,EAPW,SAAS,KAAT,SAAS,QAOpB;AAUD,MAAM,OAAO,aAAc,SAAQ,KAAK;IAYtC,YAAY,IAYX;QACC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bobs-workshop",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Bob's Workshop — agentic development helper with observability, guard rails, research, and review capabilities",
   "type": "module",
   "main": "dist/index.js",
@@ -26,15 +26,17 @@
     "chokidar": "^4.0.3",
     "express": "^4.x",
     "fs-extra": "^11.x",
+    "glob": "^10.3.10",
+    "lru-cache": "^10.1.0",
+    "minimatch": "^9.0.3",
     "multer": "^2.0.2",
     "simple-git": "^3.x",
+    "ts-morph": "^23.0.0",
     "uuid": "^9.x",
-    "zod": "^3.x"
-  },
-  "optionalDependencies": {
+    "zod": "^3.x",
     "@lvce-editor/ripgrep": "^2.4.0"
   },
-  "devDependencies": {
+    "devDependencies": {
     "@types/chokidar": "^1.7.5",
     "@types/express": "^5.0.3",
     "@types/fs-extra": "^11.0.4",

package/public/.well-known/mcp/manifest.json

@@ -173,14 +173,14 @@
     "mcp__bobs-workshop__bob_code_search": {
       "title": "Code Search",
       "category": "search",
-      "description": "Phase-aware unified search combining semantic (semgrep) and lexical (ripgrep) search capabilities. Automatically selects best search mode based on query and phase context.",
-      "enhancements": ["mode_banner", "smart_query_routing", "summary_output", "phase_aware_analysis"],
+      "description": "Phase-aware hybrid search combining semantic (semgrep), lexical (ripgrep), and structural (AST-based) search. Automatically selects best mode based on query and phase context. Structural mode provides symbol references, definitions, and dependency analysis for TypeScript/JavaScript.",
+      "enhancements": ["mode_banner", "smart_query_routing", "summary_output", "phase_aware_analysis", "structural_ast_analysis"],
       "permissions": { "file_read": true },
       "rate_limits": { "rps": 6, "burst": 12 },
       "timeouts": { "ms": 6000 },
       "input_schema": {
-        "query": "string (REQUIRED) - search query or pattern",
-        "mode": "enum(auto,semantic,lexical)? - auto selects best mode based on query",
+        "query": "string (REQUIRED) - search query, pattern, or structural query (e.g., 'find references to UserService', 'show dependencies for api.ts')",
+        "mode": "enum(auto,semantic,lexical,structural)? - auto selects best mode based on query (structural for symbol/dependency queries)",
         "phase": "enum(architect,engineer,debugger,reviewer)? - role context for specialized analysis rules",
         "path": "string? - directory to search within (defaults to current directory)",
         "includeHidden": "boolean? - include hidden files/folders",
@@ -198,7 +198,8 @@
       },
       "usage_guidelines": [
         "Use phase parameter to get specialized analysis relevant to your role",
-        "mode=auto (default) automatically selects semantic or lexical based on query complexity",
+        "mode=auto (default) automatically routes to structural, semantic, or lexical based on query type",
+        "Structural mode: AST-based analysis for 'find references to X', 'show dependencies', 'go to definition' (TypeScript/JavaScript only)",
         "Semantic mode: Best for finding patterns, similar code structures, or architectural analysis",
         "Lexical mode: Best for exact matches, symbol lookups, or simple string searches",
         "Combine with path parameter to scope searches to specific directories",