cgraphx 1.1.0

package/dist/extraction/liquid-extractor.d.ts

@@ -0,0 +1,59 @@
+import { ExtractionResult } from '../types';
+/**
+ * LiquidExtractor - Extracts relationships from Liquid template files
+ *
+ * Liquid is a templating language (used by Shopify, Jekyll, etc.) that doesn't
+ * have traditional functions or classes. Instead, we extract:
+ * - Section references ({% section 'name' %})
+ * - Snippet references ({% render 'name' %} and {% include 'name' %})
+ * - Schema blocks ({% schema %}...{% endschema %})
+ */
+export declare class LiquidExtractor {
+    private filePath;
+    private source;
+    private nodes;
+    private edges;
+    private unresolvedReferences;
+    private errors;
+    constructor(filePath: string, source: string);
+    /**
+     * Extract from Liquid source
+     */
+    extract(): ExtractionResult;
+    /**
+     * Create a file node for the Liquid template
+     */
+    private createFileNode;
+    /**
+     * Shopify OS 2.0 JSON template / section group. Both have a `sections` object
+     * mapping an id → `{ "type": "<section-name>", ... }`; the `type` names a
+     * `sections/<type>.liquid` file. Emit a `references` edge to each, so a section
+     * used only from a JSON template (the OS 2.0 norm) is no longer orphaned.
+     */
+    private extractShopifyJsonSections;
+    /**
+     * Extract {% render 'snippet' %} and {% include 'snippet' %} references
+     */
+    private extractSnippetReferences;
+    /**
+     * Extract {% section 'name' %} references
+     */
+    private extractSectionReferences;
+    /**
+     * Extract {% schema %}...{% endschema %} blocks
+     */
+    private extractSchema;
+    /**
+     * Extract {% assign var = value %} statements
+     */
+    private extractAssignments;
+    /**
+     * Get the line number for a character index
+     */
+    private getLineNumber;
+    /**
+     * Get the character index of the start of a line
+     */
+    private getLineStart;
+}
+//# sourceMappingURL=liquid-extractor.d.ts.map

package/dist/extraction/liquid-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquid-extractor.d.ts","sourceRoot":"","sources":["../../src/extraction/liquid-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,gBAAgB,EAAwC,MAAM,UAAU,CAAC;AAG9F;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,oBAAoB,CAA6B;IACzD,OAAO,CAAC,MAAM,CAAyB;gBAE3B,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAK5C;;OAEG;IACH,OAAO,IAAI,gBAAgB;IA2C3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;;;;OAKG;IACH,OAAO,CAAC,0BAA0B;IAwBlC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAuEhC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAuEhC;;OAEG;IACH,OAAO,CAAC,aAAa;IAwDrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqC1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,YAAY;CAQrB"}

package/dist/extraction/liquid-extractor.js

@@ -0,0 +1,357 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiquidExtractor = void 0;
+const tree_sitter_helpers_1 = require("./tree-sitter-helpers");
+/**
+ * LiquidExtractor - Extracts relationships from Liquid template files
+ *
+ * Liquid is a templating language (used by Shopify, Jekyll, etc.) that doesn't
+ * have traditional functions or classes. Instead, we extract:
+ * - Section references ({% section 'name' %})
+ * - Snippet references ({% render 'name' %} and {% include 'name' %})
+ * - Schema blocks ({% schema %}...{% endschema %})
+ */
+class LiquidExtractor {
+    filePath;
+    source;
+    nodes = [];
+    edges = [];
+    unresolvedReferences = [];
+    errors = [];
+    constructor(filePath, source) {
+        this.filePath = filePath;
+        this.source = source;
+    }
+    /**
+     * Extract from Liquid source
+     */
+    extract() {
+        const startTime = Date.now();
+        try {
+            // Create file node
+            const fileNode = this.createFileNode();
+            // Shopify OS 2.0 JSON template / section group: link each section `type`
+            // to its `sections/<type>.liquid` file. (No symbol nodes are emitted — the
+            // JSON file just carries the references — so it stays out of any
+            // symbol-bearing-file metric while its sections still get their dependents.)
+            if (this.filePath.endsWith('.json')) {
+                this.extractShopifyJsonSections(fileNode.id);
+            }
+            else {
+                // Extract render/include statements (snippet references)
+                this.extractSnippetReferences(fileNode.id);
+                // Extract section references
+                this.extractSectionReferences(fileNode.id);
+                // Extract schema block
+                this.extractSchema(fileNode.id);
+                // Extract assign statements as variables
+                this.extractAssignments(fileNode.id);
+            }
+        }
+        catch (error) {
+            this.errors.push({
+                message: `Liquid extraction error: ${error instanceof Error ? error.message : String(error)}`,
+                severity: 'error',
+                code: 'parse_error',
+            });
+        }
+        return {
+            nodes: this.nodes,
+            edges: this.edges,
+            unresolvedReferences: this.unresolvedReferences,
+            errors: this.errors,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    /**
+     * Create a file node for the Liquid template
+     */
+    createFileNode() {
+        const lines = this.source.split('\n');
+        const id = (0, tree_sitter_helpers_1.generateNodeId)(this.filePath, 'file', this.filePath, 1);
+        const fileNode = {
+            id,
+            kind: 'file',
+            name: this.filePath.split('/').pop() || this.filePath,
+            qualifiedName: this.filePath,
+            filePath: this.filePath,
+            language: 'liquid',
+            startLine: 1,
+            endLine: lines.length,
+            startColumn: 0,
+            endColumn: lines[lines.length - 1]?.length || 0,
+            updatedAt: Date.now(),
+        };
+        this.nodes.push(fileNode);
+        return fileNode;
+    }
+    /**
+     * Shopify OS 2.0 JSON template / section group. Both have a `sections` object
+     * mapping an id → `{ "type": "<section-name>", ... }`; the `type` names a
+     * `sections/<type>.liquid` file. Emit a `references` edge to each, so a section
+     * used only from a JSON template (the OS 2.0 norm) is no longer orphaned.
+     */
+    extractShopifyJsonSections(fromNodeId) {
+        let parsed;
+        try {
+            parsed = JSON.parse(this.source);
+        }
+        catch {
+            return; // not valid JSON (or a partial) — nothing to link
+        }
+        const sections = parsed?.sections;
+        if (!sections || typeof sections !== 'object')
+            return;
+        const seen = new Set();
+        for (const key of Object.keys(sections)) {
+            const type = sections[key]?.type;
+            if (typeof type !== 'string' || seen.has(type))
+                continue;
+            seen.add(type);
+            this.unresolvedReferences.push({
+                fromNodeId,
+                referenceName: `sections/${type}.liquid`,
+                referenceKind: 'references',
+                line: 1,
+                column: 0,
+            });
+        }
+    }
+    /**
+     * Extract {% render 'snippet' %} and {% include 'snippet' %} references
+     */
+    extractSnippetReferences(fileNodeId) {
+        // Match {% render 'name' %} or {% include 'name' %} with optional parameters
+        const renderRegex = /\{%[-]?\s*(render|include)\s+['"]([^'"]+)['"]/g;
+        let match;
+        while ((match = renderRegex.exec(this.source)) !== null) {
+            const [fullMatch, tagType, snippetName] = match;
+            const line = this.getLineNumber(match.index);
+            // Create an import node for searchability
+            const importNodeId = (0, tree_sitter_helpers_1.generateNodeId)(this.filePath, 'import', snippetName, line);
+            const importNode = {
+                id: importNodeId,
+                kind: 'import',
+                name: snippetName,
+                qualifiedName: `${this.filePath}::import:${snippetName}`,
+                filePath: this.filePath,
+                language: 'liquid',
+                signature: fullMatch,
+                startLine: line,
+                endLine: line,
+                startColumn: match.index - this.getLineStart(line),
+                endColumn: match.index - this.getLineStart(line) + fullMatch.length,
+                updatedAt: Date.now(),
+            };
+            this.nodes.push(importNode);
+            // Add containment edge from file to import
+            this.edges.push({
+                source: fileNodeId,
+                target: importNodeId,
+                kind: 'contains',
+            });
+            // Create a component node for the snippet reference
+            const nodeId = (0, tree_sitter_helpers_1.generateNodeId)(this.filePath, 'component', `${tagType}:${snippetName}`, line);
+            const node = {
+                id: nodeId,
+                kind: 'component',
+                name: snippetName,
+                qualifiedName: `${this.filePath}::${tagType}:${snippetName}`,
+                filePath: this.filePath,
+                language: 'liquid',
+                startLine: line,
+                endLine: line,
+                startColumn: match.index - this.getLineStart(line),
+                endColumn: match.index - this.getLineStart(line) + fullMatch.length,
+                updatedAt: Date.now(),
+            };
+            this.nodes.push(node);
+            // Add containment edge from file
+            this.edges.push({
+                source: fileNodeId,
+                target: nodeId,
+                kind: 'contains',
+            });
+            // Add unresolved reference to the snippet file
+            this.unresolvedReferences.push({
+                fromNodeId: fileNodeId,
+                referenceName: `snippets/${snippetName}.liquid`,
+                referenceKind: 'references',
+                line,
+                column: match.index - this.getLineStart(line),
+            });
+        }
+    }
+    /**
+     * Extract {% section 'name' %} references
+     */
+    extractSectionReferences(fileNodeId) {
+        // Match {% section 'name' %}
+        const sectionRegex = /\{%[-]?\s*section\s+['"]([^'"]+)['"]/g;
+        let match;
+        while ((match = sectionRegex.exec(this.source)) !== null) {
+            const [fullMatch, sectionName] = match;
+            const line = this.getLineNumber(match.index);
+            // Create an import node for searchability
+            const importNodeId = (0, tree_sitter_helpers_1.generateNodeId)(this.filePath, 'import', sectionName, line);
+            const importNode = {
+                id: importNodeId,
+                kind: 'import',
+                name: sectionName,
+                qualifiedName: `${this.filePath}::import:${sectionName}`,
+                filePath: this.filePath,
+                language: 'liquid',
+                signature: fullMatch,
+                startLine: line,
+                endLine: line,
+                startColumn: match.index - this.getLineStart(line),
+                endColumn: match.index - this.getLineStart(line) + fullMatch.length,
+                updatedAt: Date.now(),
+            };
+            this.nodes.push(importNode);
+            // Add containment edge from file to import
+            this.edges.push({
+                source: fileNodeId,
+                target: importNodeId,
+                kind: 'contains',
+            });
+            // Create a component node for the section reference
+            const nodeId = (0, tree_sitter_helpers_1.generateNodeId)(this.filePath, 'component', `section:${sectionName}`, line);
+            const node = {
+                id: nodeId,
+                kind: 'component',
+                name: sectionName,
+                qualifiedName: `${this.filePath}::section:${sectionName}`,
+                filePath: this.filePath,
+                language: 'liquid',
+                startLine: line,
+                endLine: line,
+                startColumn: match.index - this.getLineStart(line),
+                endColumn: match.index - this.getLineStart(line) + fullMatch.length,
+                updatedAt: Date.now(),
+            };
+            this.nodes.push(node);
+            // Add containment edge from file
+            this.edges.push({
+                source: fileNodeId,
+                target: nodeId,
+                kind: 'contains',
+            });
+            // Add unresolved reference to the section file
+            this.unresolvedReferences.push({
+                fromNodeId: fileNodeId,
+                referenceName: `sections/${sectionName}.liquid`,
+                referenceKind: 'references',
+                line,
+                column: match.index - this.getLineStart(line),
+            });
+        }
+    }
+    /**
+     * Extract {% schema %}...{% endschema %} blocks
+     */
+    extractSchema(fileNodeId) {
+        // Match {% schema %}...{% endschema %}
+        const schemaRegex = /\{%[-]?\s*schema\s*[-]?%\}([\s\S]*?)\{%[-]?\s*endschema\s*[-]?%\}/g;
+        let match;
+        while ((match = schemaRegex.exec(this.source)) !== null) {
+            const [fullMatch, schemaContent] = match;
+            const startLine = this.getLineNumber(match.index);
+            const endLine = this.getLineNumber(match.index + fullMatch.length);
+            // Try to parse the schema JSON to get the name
+            let schemaName = 'schema';
+            try {
+                const schemaJson = JSON.parse(schemaContent);
+                if (schemaJson.name) {
+                    // Shopify schema names can be translation objects like {"en": "...", "fr": "..."}
+                    schemaName = typeof schemaJson.name === 'string'
+                        ? schemaJson.name
+                        : schemaJson.name.en || Object.values(schemaJson.name)[0] || 'schema';
+                }
+            }
+            catch {
+                // Schema isn't valid JSON, use default name
+            }
+            // Create a node for the schema
+            const nodeId = (0, tree_sitter_helpers_1.generateNodeId)(this.filePath, 'constant', `schema:${schemaName}`, startLine);
+            const node = {
+                id: nodeId,
+                kind: 'constant',
+                name: schemaName,
+                qualifiedName: `${this.filePath}::schema:${schemaName}`,
+                filePath: this.filePath,
+                language: 'liquid',
+                startLine,
+                endLine,
+                startColumn: match.index - this.getLineStart(startLine),
+                endColumn: 0,
+                // SECURITY (#383): don't dump the raw {% schema %} JSON (section settings
+                // + default values) into the docstring — the schema name is already in
+                // `name`, so the data block adds nothing but a potential leak of any
+                // IDs/endpoints/keys a developer placed in setting defaults.
+                updatedAt: Date.now(),
+            };
+            this.nodes.push(node);
+            // Add containment edge from file
+            this.edges.push({
+                source: fileNodeId,
+                target: nodeId,
+                kind: 'contains',
+            });
+        }
+    }
+    /**
+     * Extract {% assign var = value %} statements
+     */
+    extractAssignments(fileNodeId) {
+        // Match {% assign variable_name = ... %}
+        const assignRegex = /\{%[-]?\s*assign\s+(\w+)\s*=/g;
+        let match;
+        while ((match = assignRegex.exec(this.source)) !== null) {
+            const [, variableName] = match;
+            const line = this.getLineNumber(match.index);
+            // Create a variable node
+            const nodeId = (0, tree_sitter_helpers_1.generateNodeId)(this.filePath, 'variable', variableName, line);
+            const node = {
+                id: nodeId,
+                kind: 'variable',
+                name: variableName,
+                qualifiedName: `${this.filePath}::${variableName}`,
+                filePath: this.filePath,
+                language: 'liquid',
+                startLine: line,
+                endLine: line,
+                startColumn: match.index - this.getLineStart(line),
+                endColumn: match.index - this.getLineStart(line) + match[0].length,
+                updatedAt: Date.now(),
+            };
+            this.nodes.push(node);
+            // Add containment edge from file
+            this.edges.push({
+                source: fileNodeId,
+                target: nodeId,
+                kind: 'contains',
+            });
+        }
+    }
+    /**
+     * Get the line number for a character index
+     */
+    getLineNumber(index) {
+        const substring = this.source.substring(0, index);
+        return (substring.match(/\n/g) || []).length + 1;
+    }
+    /**
+     * Get the character index of the start of a line
+     */
+    getLineStart(lineNumber) {
+        const lines = this.source.split('\n');
+        let index = 0;
+        for (let i = 0; i < lineNumber - 1 && i < lines.length; i++) {
+            index += lines[i].length + 1; // +1 for newline
+        }
+        return index;
+    }
+}
+exports.LiquidExtractor = LiquidExtractor;
+//# sourceMappingURL=liquid-extractor.js.map

package/dist/extraction/liquid-extractor.js.map

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

package/dist/extraction/mybatis-extractor.d.ts

@@ -0,0 +1,48 @@
+import { ExtractionResult } from '../types';
+/**
+ * MyBatisExtractor — parses MyBatis mapper XML files.
+ *
+ * MyBatis splits a DAO interface across two files: a Java interface (parsed by
+ * tree-sitter) declares the method, and an XML mapper file holds the SQL keyed
+ * by `<namespace>` (the fully-qualified Java type name) and `id` (the method
+ * name). Without the XML side in the graph, `trace(Controller, ...DAO.method)`
+ * dead-ends at the interface method — the SQL it actually runs is invisible,
+ * and "what does this query touch" / "where is this column written" can't be
+ * answered.
+ *
+ * This extractor emits one method-shaped node per `<select|insert|update|
+ * delete>` and per `<sql>` fragment, qualified as `<namespace>::<id>` so the
+ * MyBatis framework synthesizer (`src/resolution/frameworks/mybatis.ts`) can
+ * link the matching Java method → XML statement by suffix-matching qualified
+ * names. `<include refid="...">` inside a statement yields an unresolved
+ * reference to the SQL fragment, also keyed by `<namespace>::<refid>`.
+ *
+ * Non-mapper XML (Maven `pom.xml`, Spring beans XML, `web.xml`, log4j config,
+ * etc.) is detected by the absence of a `<mapper namespace="...">` root and
+ * returns just a file node — we still need the file row so the watcher can
+ * track it, but we emit no symbols.
+ */
+export declare class MyBatisExtractor {
+    private filePath;
+    private source;
+    private nodes;
+    private edges;
+    private unresolvedReferences;
+    private errors;
+    private lineStarts;
+    constructor(filePath: string, source: string);
+    extract(): ExtractionResult;
+    private createFileNode;
+    /**
+     * Find the `<mapper namespace="X">` opening tag. Returns the namespace and
+     * the byte offsets of the body (between the opening and closing tag) so
+     * statement extraction can be scoped to mapper contents.
+     */
+    private findMapperRoot;
+    private extractMapper;
+    private buildSignature;
+    private previewSql;
+    private computeLineStarts;
+    private getLineNumber;
+}
+//# sourceMappingURL=mybatis-extractor.d.ts.map

package/dist/extraction/mybatis-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mybatis-extractor.d.ts","sourceRoot":"","sources":["../../src/extraction/mybatis-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,gBAAgB,EAA6B,MAAM,UAAU,CAAC;AAG9F;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,oBAAoB,CAA6B;IACzD,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,UAAU,CAAgB;gBAEtB,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAM5C,OAAO,IAAI,gBAAgB;IA2B3B,OAAO,CAAC,cAAc;IAoBtB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,aAAa;IA2DrB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,aAAa;CAWtB"}