@specship/specship 0.11.0

package/dist/resolution/frameworks/csharp.js

@@ -0,0 +1,241 @@
+"use strict";
+/**
+ * C# Framework Resolver
+ *
+ * Handles ASP.NET Core, ASP.NET MVC, and common C# patterns.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.aspnetResolver = void 0;
+const strip_comments_1 = require("../strip-comments");
+exports.aspnetResolver = {
+    name: 'aspnet',
+    languages: ['csharp'],
+    detect(context) {
+        // Check for .csproj files with ASP.NET references
+        const allFiles = context.getAllFiles();
+        for (const file of allFiles) {
+            if (file.endsWith('.csproj')) {
+                const content = context.readFile(file);
+                if (content && (content.includes('Microsoft.AspNetCore') ||
+                    content.includes('Microsoft.NET.Sdk.Web') ||
+                    content.includes('System.Web.Mvc'))) {
+                    return true;
+                }
+            }
+        }
+        // Check for Program.cs with WebApplication
+        const programCs = context.readFile('Program.cs');
+        if (programCs && (programCs.includes('WebApplication') ||
+            programCs.includes('CreateHostBuilder') ||
+            programCs.includes('UseStartup'))) {
+            return true;
+        }
+        // Check for Startup.cs (ASP.NET Core signature)
+        if (context.fileExists('Startup.cs')) {
+            return true;
+        }
+        // ASP.NET signatures in controller/entrypoint SOURCE — covers feature-folder
+        // apps with no `/Controllers/` dir and a subdir `Program.cs` that the
+        // root-only checks above miss (e.g. realworld: Features/*/FooController.cs).
+        // `.csproj` often isn't in the indexed source set, so source-scan is the
+        // reliable signal.
+        for (const file of allFiles) {
+            if (!/(?:Controller|Program|Startup)\.cs$/.test(file))
+                continue;
+            const c = context.readFile(file);
+            if (c && (/\[(?:ApiController|Route|Http(?:Get|Post|Put|Patch|Delete))\b/.test(c) ||
+                c.includes('ControllerBase') || c.includes(': Controller') ||
+                c.includes('MapControllers') || c.includes('WebApplication') ||
+                c.includes('Microsoft.AspNetCore')))
+                return true;
+        }
+        return false;
+    },
+    resolve(ref, context) {
+        // Pattern 1: Controller references
+        if (ref.referenceName.endsWith('Controller')) {
+            const result = resolveByNameAndKind(ref.referenceName, CLASS_KINDS, CONTROLLER_DIRS, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.85,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        // Pattern 2: Service references (dependency injection)
+        if (ref.referenceName.endsWith('Service') || ref.referenceName.startsWith('I') && ref.referenceName.length > 1) {
+            const result = resolveByNameAndKind(ref.referenceName, SERVICE_KINDS, SERVICE_DIRS, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.85,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        // Pattern 3: Repository references
+        if (ref.referenceName.endsWith('Repository')) {
+            const result = resolveByNameAndKind(ref.referenceName, SERVICE_KINDS, REPO_DIRS, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.85,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        // Pattern 4: Model/Entity references
+        if (/^[A-Z][a-zA-Z]+$/.test(ref.referenceName)) {
+            const result = resolveByNameAndKind(ref.referenceName, CLASS_KINDS, MODEL_DIRS, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.7,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        // Pattern 5: ViewModel references
+        if (ref.referenceName.endsWith('ViewModel') || ref.referenceName.endsWith('Dto')) {
+            const result = resolveByNameAndKind(ref.referenceName, CLASS_KINDS, VIEWMODEL_DIRS, context);
+            if (result) {
+                return {
+                    original: ref,
+                    targetNodeId: result,
+                    confidence: 0.8,
+                    resolvedBy: 'framework',
+                };
+            }
+        }
+        return null;
+    },
+    extract(filePath, content) {
+        if (!filePath.endsWith('.cs'))
+            return { nodes: [], references: [] };
+        const nodes = [];
+        const references = [];
+        const now = Date.now();
+        const safe = (0, strip_comments_1.stripCommentsForRegex)(content, 'csharp');
+        // Class-level [Route("api/[controller]")] prefix — joined onto each action.
+        let classPrefix = '';
+        const cls = /\[Route\s*\(\s*"([^"]+)"[^)]*\)\]\s*(?:\[[^\]]*\]\s*)*(?:public\s+|sealed\s+|abstract\s+|partial\s+)*class\b/.exec(safe);
+        if (cls)
+            classPrefix = cls[1];
+        // [HttpGet], [HttpGet("path")], [HttpPost("path", Name="x")] — BARE or with a
+        // path. (The old regex required a string, so bare attributes — with the route
+        // on the class [Route] — were missed; eShopOnWeb was 24 bare / 2 string.)
+        const attrRegex = /\[(HttpGet|HttpPost|HttpPut|HttpPatch|HttpDelete)(?:\s*\(\s*"([^"]+)"[^)]*\))?\s*\]/g;
+        let match;
+        while ((match = attrRegex.exec(safe)) !== null) {
+            const verb = match[1];
+            const method = verb.replace(/^Http/, '').toUpperCase();
+            const routePath = joinCsPath(classPrefix, match[2] || '');
+            const line = safe.slice(0, match.index).split('\n').length;
+            const routeNode = {
+                id: `route:${filePath}:${line}:${method}:${routePath}`,
+                kind: 'route',
+                name: `${method} ${routePath}`,
+                qualifiedName: `${filePath}::route:${routePath}`,
+                filePath,
+                startLine: line,
+                endLine: line,
+                startColumn: 0,
+                endColumn: match[0].length,
+                language: 'csharp',
+                updatedAt: now,
+            };
+            nodes.push(routeNode);
+            // Next method declaration (skip stacked attributes; C# puts the return type
+            // before the name). Bounded so we don't grab a far one.
+            const tail = safe.slice(match.index + match[0].length, match.index + match[0].length + 600);
+            const methodMatch = tail.match(/(?:public|private|protected|internal)\s+[\w<>,\s\[\]?.]+?\s+(\w+)\s*\(/);
+            if (methodMatch) {
+                references.push({
+                    fromNodeId: routeNode.id,
+                    referenceName: methodMatch[1],
+                    referenceKind: 'references',
+                    line,
+                    column: 0,
+                    filePath,
+                    language: 'csharp',
+                });
+            }
+        }
+        // Minimal APIs: app.MapGet("/path", handler)
+        const minimalRegex = /\.Map(Get|Post|Put|Patch|Delete)\s*\(\s*"([^"]+)"\s*,\s*([^,)]+)/g;
+        while ((match = minimalRegex.exec(safe)) !== null) {
+            const [, verb, routePath, handlerExpr] = match;
+            const method = verb.toUpperCase();
+            const line = safe.slice(0, match.index).split('\n').length;
+            const routeNode = {
+                id: `route:${filePath}:${line}:${method}:${routePath}`,
+                kind: 'route',
+                name: `${method} ${routePath}`,
+                qualifiedName: `${filePath}::route:${routePath}`,
+                filePath,
+                startLine: line,
+                endLine: line,
+                startColumn: 0,
+                endColumn: match[0].length,
+                language: 'csharp',
+                updatedAt: now,
+            };
+            nodes.push(routeNode);
+            const handlerName = extractCSharpTailIdent(handlerExpr);
+            if (handlerName) {
+                references.push({
+                    fromNodeId: routeNode.id,
+                    referenceName: handlerName,
+                    referenceKind: 'references',
+                    line,
+                    column: 0,
+                    filePath,
+                    language: 'csharp',
+                });
+            }
+        }
+        return { nodes, references };
+    },
+};
+/** Join a class-level [Route] prefix and an action's path into one normalized `/path`. */
+function joinCsPath(prefix, sub) {
+    const parts = [prefix, sub].map((p) => p.replace(/^\/+|\/+$/g, '')).filter(Boolean);
+    return '/' + parts.join('/');
+}
+/** Extract last identifier from an expression like `MyService.Handler` or `Handler`. */
+function extractCSharpTailIdent(expr) {
+    const cleaned = expr.trim().replace(/\s+/g, '');
+    const m = cleaned.match(/(?:\.|^)([A-Za-z_][A-Za-z0-9_]*)$/);
+    return m ? m[1] : null;
+}
+// Directory patterns
+const CONTROLLER_DIRS = ['/Controllers/'];
+const SERVICE_DIRS = ['/Services/', '/Service/', '/Application/'];
+const REPO_DIRS = ['/Repositories/', '/Repository/', '/Data/', '/Infrastructure/'];
+const MODEL_DIRS = ['/Models/', '/Model/', '/Entities/', '/Entity/', '/Domain/'];
+const VIEWMODEL_DIRS = ['/ViewModels/', '/ViewModel/', '/DTOs/', '/Dto/'];
+const CLASS_KINDS = new Set(['class']);
+const SERVICE_KINDS = new Set(['class', 'interface']);
+/**
+ * Resolve a symbol by name using indexed queries instead of scanning all files.
+ */
+function resolveByNameAndKind(name, kinds, preferredDirPatterns, context) {
+    const candidates = context.getNodesByName(name);
+    if (candidates.length === 0)
+        return null;
+    const kindFiltered = candidates.filter((n) => kinds.has(n.kind));
+    if (kindFiltered.length === 0)
+        return null;
+    // Prefer candidates in framework-conventional directories
+    const preferred = kindFiltered.filter((n) => preferredDirPatterns.some((d) => n.filePath.includes(d)));
+    if (preferred.length > 0)
+        return preferred[0].id;
+    // Fall back to any match
+    return kindFiltered[0].id;
+}
+//# sourceMappingURL=csharp.js.map

package/dist/resolution/frameworks/csharp.js.map

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

package/dist/resolution/frameworks/drupal.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Drupal Framework Resolver
+ *
+ * Supports Drupal 8/9/10/11 (Composer-based projects). Drupal 7 is not supported.
+ *
+ * ## What this resolver does
+ *
+ * 1. **Detection** — reads composer.json and checks for any `drupal/*` dependency in
+ *    `require` or `require-dev`.
+ *
+ * 2. **Route extraction** — parses `*.routing.yml` files and emits `route` nodes for each
+ *    Drupal route, with `references` edges to the `_controller`, `_form`, or entity handler
+ *    class/method.
+ *
+ * 3. **Hook detection** — scans `.module`, `.install`, `.theme`, and `.inc` files for Drupal
+ *    hook implementations. Two strategies are used:
+ *      a. Docblock: `@Implements hook_X()` → precise, no false positives.
+ *      b. Name pattern: function `{moduleName}_{hookSuffix}()` → catches hooks without
+ *         docblocks but may produce false positives on helper functions.
+ *    Detected hooks emit an `UnresolvedRef` from the implementing function node to the
+ *    canonical `hook_X` name, linking implementations to the hook when `specship_callers`
+ *    is invoked.
+ *
+ * ## Design decisions (review in future iterations)
+ *
+ * - Hook graph resolution (v1): hook references are stored as UnresolvedRef pointing to the
+ *   canonical `hook_X` name. If Drupal core is indexed, these will resolve to core hook
+ *   definitions. Without core, they remain unresolved but are still searchable via
+ *   `specship_search("form_alter")`. Full hook-node creation (virtual nodes for every hook)
+ *   is deferred to a future iteration.
+ *
+ * - Services / plugins (out of scope for v1): `*.services.yml` service definitions and plugin
+ *   annotations (`@Block`, `@FormElement`, etc.) are not extracted. Add a TODO below when
+ *   ready to implement.
+ *
+ * - Twig templates (out of scope for v1): `.twig` files are tracked as file nodes but no
+ *   symbol extraction is performed (no tree-sitter Twig grammar). Implement when a Twig
+ *   grammar WASM is available.
+ *
+ * ## TODOs for future iterations
+ *
+ * - TODO: Extract service definitions from `*.services.yml` files (class → service-id edges).
+ * - TODO: Extract plugin annotations (`@Block`, `@FormElement`, `@Field`, etc.) from PHP
+ *   docblocks and emit plugin nodes with references to the annotated class.
+ * - TODO: Add Twig symbol extraction when a tree-sitter Twig grammar becomes available.
+ * - TODO: Improve hook resolution: create virtual `hook_*` nodes so `specship_callers`
+ *   returns all implementations even when Drupal core is not indexed.
+ */
+import { FrameworkResolver } from '../types';
+export declare const drupalResolver: FrameworkResolver;
+//# sourceMappingURL=drupal.d.ts.map

package/dist/resolution/frameworks/drupal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drupal.d.ts","sourceRoot":"","sources":["../../../src/resolution/frameworks/drupal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAIH,OAAO,EAAE,iBAAiB,EAAiD,MAAM,UAAU,CAAC;AAoP5F,eAAO,MAAM,cAAc,EAAE,iBAsH5B,CAAC"}