sverklo 0.3.0 → 0.4.0

package/dist/src/workspace/graphql-consumer.js

@@ -0,0 +1,293 @@
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+/**
+ * Scan a TypeScript/JavaScript file for GraphQL operations (gql tagged templates,
+ * graphql() calls, .graphql imports) and resolve field references against known contracts.
+ */
+export function detectGraphQLConsumers(filePath, content, knownContracts) {
+    const matches = [];
+    // Build lookup maps from known contracts
+    const endpointContracts = new Map();
+    const fieldContracts = new Set();
+    const typeReturnMap = new Map(); // "Query.user" -> "User"
+    for (const c of knownContracts) {
+        if (c.symbolKind === "endpoint") {
+            endpointContracts.set(c.symbolName, c);
+            // Extract return type from signature, e.g. "user(id: ID!): User" -> "User"
+            const returnType = extractReturnType(c.signature ?? "");
+            if (returnType) {
+                typeReturnMap.set(c.symbolName, returnType);
+            }
+        }
+        if (c.symbolKind === "field" || c.symbolKind === "endpoint") {
+            fieldContracts.add(c.symbolName);
+        }
+    }
+    // Collect all GraphQL operation strings with their source locations
+    const operations = extractOperations(filePath, content);
+    for (const op of operations) {
+        const parsed = parseGraphQLOperation(op.graphql);
+        if (!parsed)
+            continue;
+        const referencedFields = [];
+        // Resolve root fields against endpoints
+        for (const rootField of parsed.rootFields) {
+            const endpointName = `${capitalize(parsed.operationType)}.${rootField.name}`;
+            const returnType = typeReturnMap.get(endpointName);
+            if (endpointContracts.has(endpointName)) {
+                referencedFields.push(endpointName);
+            }
+            // Resolve nested selections
+            if (rootField.selections.length > 0) {
+                const parentType = returnType ?? capitalize(rootField.name);
+                resolveSelections(rootField.selections, parentType, fieldContracts, typeReturnMap, referencedFields, returnType != null);
+            }
+        }
+        if (referencedFields.length > 0) {
+            matches.push({
+                file: filePath,
+                symbol: op.enclosingSymbol,
+                line: op.line,
+                referencedFields: [...new Set(referencedFields)],
+                edgeType: parsed.operationType,
+            });
+        }
+    }
+    return matches;
+}
+function extractOperations(filePath, content) {
+    const ops = [];
+    // Pattern 1: gql`...` or graphql`...` tagged template literals
+    const taggedTemplateRe = /\b(?:gql|graphql)\s*`([\s\S]*?)`/g;
+    let m;
+    while ((m = taggedTemplateRe.exec(content)) !== null) {
+        const line = lineAt(content, m.index);
+        ops.push({
+            graphql: m[1],
+            line,
+            enclosingSymbol: findEnclosingSymbol(content, m.index),
+        });
+    }
+    // Pattern 2: graphql("...") or graphql('...') function call with a string literal
+    const graphqlCallRe = /\bgraphql\s*\(\s*(['"`])([\s\S]*?)\1\s*\)/g;
+    while ((m = graphqlCallRe.exec(content)) !== null) {
+        const line = lineAt(content, m.index);
+        ops.push({
+            graphql: m[2],
+            line,
+            enclosingSymbol: findEnclosingSymbol(content, m.index),
+        });
+    }
+    // Pattern 3: import from .graphql file
+    const graphqlImportRe = /import\s+.*?\s+from\s+['"]([^'"]+\.graphql)['"]/g;
+    while ((m = graphqlImportRe.exec(content)) !== null) {
+        const importPath = m[1];
+        const resolved = resolve(dirname(filePath), importPath);
+        try {
+            const graphqlContent = readFileSync(resolved, "utf-8");
+            const line = lineAt(content, m.index);
+            ops.push({
+                graphql: graphqlContent,
+                line,
+                enclosingSymbol: findEnclosingSymbol(content, m.index),
+            });
+        }
+        catch {
+            // File not found — skip silently
+        }
+    }
+    return ops;
+}
+function parseGraphQLOperation(graphql) {
+    // Strip comments
+    const cleaned = graphql.replace(/#[^\n]*/g, "");
+    // Find operation keyword
+    const opMatch = cleaned.match(/\b(query|mutation|subscription)\b\s*([A-Za-z_]\w*)?\s*(?:\([^)]*\))?\s*\{/);
+    // If no explicit operation keyword, assume it's a query if we see { at top level
+    let operationType = "query";
+    let operationName = null;
+    let bodyStart;
+    if (opMatch) {
+        operationType = opMatch[1];
+        operationName = opMatch[2] ?? null;
+        bodyStart = opMatch.index + opMatch[0].length - 1; // position of {
+    }
+    else {
+        const braceIdx = cleaned.indexOf("{");
+        if (braceIdx === -1)
+            return null;
+        bodyStart = braceIdx;
+    }
+    const rootFields = parseSelectionSet(cleaned, bodyStart);
+    if (rootFields.length === 0)
+        return null;
+    return { operationType, operationName, rootFields };
+}
+/**
+ * Parse a selection set starting at the opening brace.
+ * Returns the field selections inside.
+ */
+function parseSelectionSet(src, bracePos) {
+    const fields = [];
+    // Find the matching closing brace
+    let depth = 0;
+    let i = bracePos;
+    if (src[i] !== "{")
+        return fields;
+    depth = 1;
+    i++;
+    while (i < src.length && depth > 0) {
+        const ch = src[i];
+        if (ch === "{") {
+            depth++;
+            i++;
+        }
+        else if (ch === "}") {
+            depth--;
+            i++;
+        }
+        else if (depth === 1) {
+            // At the top-level of this selection set — look for a field name
+            const fieldMatch = src.slice(i).match(/^(\s*(?:\.\.\.\s+on\s+\w+\s*\{[\s\S]*?\}|\.\.\.\w+)\s*)/);
+            if (fieldMatch) {
+                // Fragment spread or inline fragment — skip for now
+                i += fieldMatch[1].length;
+                continue;
+            }
+            const nameMatch = src.slice(i).match(/^\s*([A-Za-z_]\w*)\s*(?:\([^)]*\))?\s*/);
+            if (nameMatch) {
+                const fieldName = nameMatch[1];
+                // Skip GraphQL keywords that aren't field names
+                if (fieldName === "on" || fieldName === "fragment") {
+                    i += nameMatch[0].length;
+                    continue;
+                }
+                // Check for alias: `alias: fieldName`
+                const afterName = i + nameMatch[0].length;
+                let actualName = fieldName;
+                // Handle alias pattern: aliasName: actualFieldName
+                const aliasCheck = src.slice(afterName).match(/^:\s*([A-Za-z_]\w*)\s*(?:\([^)]*\))?\s*/);
+                if (aliasCheck) {
+                    actualName = aliasCheck[1];
+                    const subStart = afterName + aliasCheck[0].length;
+                    if (src[subStart] === "{") {
+                        const subFields = parseSelectionSet(src, subStart);
+                        fields.push({ name: actualName, selections: subFields });
+                        // Advance past the sub-selection
+                        i = skipSelectionSet(src, subStart);
+                    }
+                    else {
+                        fields.push({ name: actualName, selections: [] });
+                        i = subStart;
+                    }
+                }
+                else if (src[afterName] === "{") {
+                    const subFields = parseSelectionSet(src, afterName);
+                    fields.push({ name: actualName, selections: subFields });
+                    i = skipSelectionSet(src, afterName);
+                }
+                else {
+                    fields.push({ name: actualName, selections: [] });
+                    i = afterName;
+                }
+            }
+            else {
+                i++;
+            }
+        }
+        else {
+            i++;
+        }
+    }
+    return fields;
+}
+/** Skip past a balanced { ... } block, returning the position after the closing brace. */
+function skipSelectionSet(src, bracePos) {
+    let depth = 0;
+    let i = bracePos;
+    while (i < src.length) {
+        if (src[i] === "{")
+            depth++;
+        else if (src[i] === "}") {
+            depth--;
+            if (depth === 0)
+                return i + 1;
+        }
+        i++;
+    }
+    return i;
+}
+// ---------------------------------------------------------------------------
+// Field resolution against known contracts
+// ---------------------------------------------------------------------------
+function resolveSelections(selections, parentType, fieldContracts, typeReturnMap, referencedFields, exact) {
+    for (const sel of selections) {
+        const qualifiedName = `${parentType}.${sel.name}`;
+        if (fieldContracts.has(qualifiedName)) {
+            referencedFields.push(qualifiedName);
+        }
+        else if (!exact) {
+            // Inferred match — still include it but it will get 0.8 confidence
+            // at the edge level (handled by the caller/cross-indexer)
+            referencedFields.push(qualifiedName);
+        }
+        // Recurse into nested selections
+        if (sel.selections.length > 0) {
+            // Try to find the return type for this field from endpoint map
+            const returnType = typeReturnMap.get(qualifiedName);
+            const childType = returnType ?? capitalize(sel.name);
+            const childExact = returnType != null;
+            resolveSelections(sel.selections, childType, fieldContracts, typeReturnMap, referencedFields, childExact);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Extract the return type from a GraphQL field signature like "user(id: ID!): User!" */
+function extractReturnType(signature) {
+    const m = signature.match(/:\s*\[?\s*([A-Za-z_]\w*)/);
+    return m ? m[1] : null;
+}
+/** Capitalize the first letter of a string. */
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+/** Compute 1-based line number at a character offset within content. */
+function lineAt(content, offset) {
+    let line = 1;
+    for (let i = 0; i < offset && i < content.length; i++) {
+        if (content[i] === "\n")
+            line++;
+    }
+    return line;
+}
+/**
+ * Find the name of the enclosing function/component at a given offset.
+ * Looks backwards for: function X, const X =, export function X, etc.
+ */
+function findEnclosingSymbol(content, offset) {
+    // Get the content before the offset
+    const before = content.slice(0, offset);
+    // Try to find the nearest function/const/class declaration
+    // Search backwards through the lines
+    const lines = before.split("\n");
+    for (let i = lines.length - 1; i >= 0 && i >= lines.length - 30; i--) {
+        const line = lines[i];
+        // function declaration
+        const funcMatch = line.match(/(?:export\s+)?(?:async\s+)?function\s+([A-Za-z_]\w*)/);
+        if (funcMatch)
+            return funcMatch[1];
+        // arrow function / const assignment
+        const constMatch = line.match(/(?:export\s+)?(?:const|let|var)\s+([A-Za-z_]\w*)\s*=/);
+        if (constMatch)
+            return constMatch[1];
+        // class method
+        const methodMatch = line.match(/^\s*(?:async\s+)?([A-Za-z_]\w*)\s*\(/);
+        if (methodMatch && methodMatch[1] !== "if" && methodMatch[1] !== "for" && methodMatch[1] !== "while") {
+            return methodMatch[1];
+        }
+    }
+    return "<module>";
+}
+//# sourceMappingURL=graphql-consumer.js.map

package/dist/src/workspace/graphql-consumer.js.map

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

package/dist/src/workspace/graphql-extractor.d.ts

@@ -0,0 +1,13 @@
+import type { InterfaceContract } from "./cross-db.js";
+export interface GraphQLExtractionResult {
+    contracts: Omit<InterfaceContract, "id" | "projectId">[];
+}
+/**
+ * Extract type/field contracts from GraphQL schema SDL files.
+ *
+ * Produces a flat list of contracts:
+ *  - One per type/input/interface/enum (symbolKind = "type")
+ *  - One per field within a type (symbolKind = "field" or "endpoint" for root types)
+ *  - One per scalar declaration (symbolKind = "type")
+ */
+export declare function extractGraphQLContracts(filePath: string, content: string): GraphQLExtractionResult;

package/dist/src/workspace/graphql-extractor.js

@@ -0,0 +1,172 @@
+import { createHash } from "node:crypto";
+// Root types whose fields are exposed as "endpoint" kind
+const ROOT_TYPES = new Set(["Query", "Mutation", "Subscription"]);
+/**
+ * Extract type/field contracts from GraphQL schema SDL files.
+ *
+ * Produces a flat list of contracts:
+ *  - One per type/input/interface/enum (symbolKind = "type")
+ *  - One per field within a type (symbolKind = "field" or "endpoint" for root types)
+ *  - One per scalar declaration (symbolKind = "type")
+ */
+export function extractGraphQLContracts(filePath, content) {
+    const contracts = [];
+    const lines = content.split("\n");
+    // Pre-process: strip comments and block descriptions to simplify parsing.
+    // We keep the original lines for line-number tracking and hashing,
+    // but work on a cleaned version for regex matching.
+    const cleaned = stripCommentsAndDescriptions(lines);
+    // Extract scalar declarations:  scalar DateTime
+    for (let i = 0; i < cleaned.length; i++) {
+        const scalarMatch = cleaned[i].match(/^\s*scalar\s+([A-Za-z_]\w*)/);
+        if (scalarMatch) {
+            contracts.push({
+                symbolName: scalarMatch[1],
+                symbolKind: "type",
+                sourceFile: filePath,
+                fileLine: i + 1,
+                interfaceType: "graphql",
+                signature: `scalar ${scalarMatch[1]}`,
+                contentHash: sha256(lines[i]),
+            });
+        }
+    }
+    // Extract type / input / interface / enum blocks
+    // Handles:  type Foo {  |  type Foo implements Bar {  |  extend type Foo {
+    //           input Foo {  |  interface Foo {  |  enum Foo {
+    const blockStartRe = /^\s*(extend\s+)?(type|input|interface|enum)\s+([A-Za-z_]\w*)(?:\s+implements\s+[A-Za-z_][\w\s&,]*)?\s*\{/;
+    let i = 0;
+    while (i < cleaned.length) {
+        const m = cleaned[i].match(blockStartRe);
+        if (!m) {
+            i++;
+            continue;
+        }
+        const isExtend = !!m[1];
+        const blockKind = m[2]; // type | input | interface | enum
+        const typeName = m[3];
+        const blockStartLine = i;
+        // Emit a contract for the type itself (skip for extend blocks — the base
+        // type was already declared elsewhere)
+        if (!isExtend) {
+            contracts.push({
+                symbolName: typeName,
+                symbolKind: "type",
+                sourceFile: filePath,
+                fileLine: blockStartLine + 1,
+                interfaceType: "graphql",
+                signature: cleaned[i].trim(),
+                contentHash: sha256(lines[i]),
+            });
+        }
+        // Find the matching closing brace, accounting for nesting (rare in SDL
+        // but possible with nested input types etc.)
+        let depth = 1;
+        i++;
+        while (i < cleaned.length && depth > 0) {
+            for (const ch of cleaned[i]) {
+                if (ch === "{")
+                    depth++;
+                else if (ch === "}")
+                    depth--;
+            }
+            if (depth > 0) {
+                // This line is inside the block — try to extract a field
+                const field = parseField(cleaned[i], typeName, blockKind);
+                if (field) {
+                    const symbolKind = ROOT_TYPES.has(typeName) ? "endpoint" : "field";
+                    contracts.push({
+                        symbolName: `${typeName}.${field.name}`,
+                        symbolKind,
+                        sourceFile: filePath,
+                        fileLine: i + 1,
+                        interfaceType: "graphql",
+                        signature: field.signature,
+                        contentHash: sha256(lines[i]),
+                    });
+                }
+            }
+            i++;
+        }
+    }
+    return { contracts };
+}
+/**
+ * Parse a single field line inside a type block.
+ * Handles:
+ *   fieldName: Type
+ *   fieldName(arg: Type, arg2: Type): Type
+ *   ENUM_VALUE            (inside enum blocks)
+ */
+function parseField(line, _typeName, blockKind) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed === "{" || trimmed === "}")
+        return null;
+    if (blockKind === "enum") {
+        // Enum values are simple identifiers, possibly followed by @directives
+        const enumMatch = trimmed.match(/^([A-Za-z_]\w*)/);
+        if (enumMatch) {
+            return { name: enumMatch[1], signature: trimmed };
+        }
+        return null;
+    }
+    // Field: name(args): ReturnType or name: ReturnType
+    const fieldMatch = trimmed.match(/^([A-Za-z_]\w*)\s*(\([^)]*\))?\s*:\s*(.+)/);
+    if (fieldMatch) {
+        return { name: fieldMatch[1], signature: trimmed };
+    }
+    return null;
+}
+/**
+ * Strip # line comments and """ block descriptions from SDL lines.
+ * Returns a new array of the same length, with comment/description lines blanked out.
+ */
+function stripCommentsAndDescriptions(lines) {
+    const result = new Array(lines.length);
+    let inBlockDesc = false;
+    for (let i = 0; i < lines.length; i++) {
+        if (inBlockDesc) {
+            // Look for the closing """
+            const closeIdx = lines[i].indexOf('"""');
+            if (closeIdx !== -1) {
+                inBlockDesc = false;
+                // Blank out up to and including the closing """
+                result[i] = lines[i].substring(closeIdx + 3);
+            }
+            else {
+                result[i] = "";
+            }
+            continue;
+        }
+        let line = lines[i];
+        // Handle opening """ — could be single-line """ ... """ or start a block
+        const openIdx = line.indexOf('"""');
+        if (openIdx !== -1) {
+            const afterOpen = line.substring(openIdx + 3);
+            const closeIdx = afterOpen.indexOf('"""');
+            if (closeIdx !== -1) {
+                // Single-line block description: """some text"""
+                line = line.substring(0, openIdx) + afterOpen.substring(closeIdx + 3);
+            }
+            else {
+                // Multi-line block description starts
+                inBlockDesc = true;
+                line = line.substring(0, openIdx);
+            }
+        }
+        // Strip # comments (but not inside strings — SDL doesn't have inline strings
+        // outside of descriptions, so this is safe)
+        const hashIdx = line.indexOf("#");
+        if (hashIdx !== -1) {
+            line = line.substring(0, hashIdx);
+        }
+        // Strip single-line "description" strings that precede fields
+        line = line.replace(/^\s*"[^"]*"\s*$/, "");
+        result[i] = line;
+    }
+    return result;
+}
+function sha256(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+//# sourceMappingURL=graphql-extractor.js.map

package/dist/src/workspace/graphql-extractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-extractor.js","sourceRoot":"","sources":["../../../src/workspace/graphql-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOzC,yDAAyD;AACzD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAgB,EAChB,OAAe;IAEf,MAAM,SAAS,GAAyC,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,0EAA0E;IAC1E,mEAAmE;IACnE,oDAAoD;IACpD,MAAM,OAAO,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;IAEpD,gDAAgD;IAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACpE,IAAI,WAAW,EAAE,CAAC;YAChB,SAAS,CAAC,IAAI,CAAC;gBACb,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;gBAC1B,UAAU,EAAE,MAAM;gBAClB,UAAU,EAAE,QAAQ;gBACpB,QAAQ,EAAE,CAAC,GAAG,CAAC;gBACf,aAAa,EAAE,SAAS;gBACxB,SAAS,EAAE,UAAU,WAAW,CAAC,CAAC,CAAC,EAAE;gBACrC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aAC9B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,2EAA2E;IAC3E,2DAA2D;IAC3D,MAAM,YAAY,GAChB,0GAA0G,CAAC;IAE7G,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACzC,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,kCAAkC;QAC1D,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACtB,MAAM,cAAc,GAAG,CAAC,CAAC;QAEzB,yEAAyE;QACzE,uCAAuC;QACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,SAAS,CAAC,IAAI,CAAC;gBACb,UAAU,EAAE,QAAQ;gBACpB,UAAU,EAAE,MAAM;gBAClB,UAAU,EAAE,QAAQ;gBACpB,QAAQ,EAAE,cAAc,GAAG,CAAC;gBAC5B,aAAa,EAAE,SAAS;gBACxB,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;gBAC5B,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aAC9B,CAAC,CAAC;QACL,CAAC;QAED,uEAAuE;QACvE,6CAA6C;QAC7C,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,CAAC,EAAE,CAAC;QACJ,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACvC,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5B,IAAI,EAAE,KAAK,GAAG;oBAAE,KAAK,EAAE,CAAC;qBACnB,IAAI,EAAE,KAAK,GAAG;oBAAE,KAAK,EAAE,CAAC;YAC/B,CAAC;YACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,yDAAyD;gBACzD,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;gBAC1D,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;oBACnE,SAAS,CAAC,IAAI,CAAC;wBACb,UAAU,EAAE,GAAG,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE;wBACvC,UAAU;wBACV,UAAU,EAAE,QAAQ;wBACpB,QAAQ,EAAE,CAAC,GAAG,CAAC;wBACf,aAAa,EAAE,SAAS;wBACxB,SAAS,EAAE,KAAK,CAAC,SAAS;wBAC1B,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;qBAC9B,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YACD,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,UAAU,CACjB,IAAY,EACZ,SAAiB,EACjB,SAAiB;IAEjB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAEhE,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;QACzB,uEAAuE;QACvE,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACnD,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;QACpD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oDAAoD;IACpD,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC9E,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IACrD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,4BAA4B,CAAC,KAAe;IACnD,MAAM,MAAM,GAAG,IAAI,KAAK,CAAS,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,WAAW,EAAE,CAAC;YAChB,2BAA2B;YAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACzC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;gBACpB,WAAW,GAAG,KAAK,CAAC;gBACpB,gDAAgD;gBAChD,MAAM,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YACjB,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEpB,yEAAyE;QACzE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;YACnB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YAC9C,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC1C,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;gBACpB,iDAAiD;gBACjD,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;YACxE,CAAC;iBAAM,CAAC;gBACN,sCAAsC;gBACtC,WAAW,GAAG,IAAI,CAAC;gBACnB,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QAED,6EAA6E;QAC7E,4CAA4C;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;YACnB,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC;QAED,8DAA8D;QAC9D,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;QAE3C,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,MAAM,CAAC,OAAe;IAC7B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC"}

package/dist/src/workspace/workspace-config.d.ts

@@ -0,0 +1,32 @@
+export interface WorkspaceProject {
+    path: string;
+    role: "provider" | "consumer" | "both";
+    interfaces?: Array<{
+        type: "graphql" | "openapi" | "protobuf" | "npm" | "trpc";
+        schema?: string;
+        spec?: string;
+    }>;
+}
+export interface WorkspaceConfig {
+    workspace: string;
+    projects: WorkspaceProject[];
+}
+/**
+ * Load a workspace config from ~/.sverklo/workspaces/<name>.yaml.
+ * Returns null if the file doesn't exist or can't be parsed.
+ */
+export declare function loadWorkspaceConfig(name: string): WorkspaceConfig | null;
+/**
+ * Scan ~/.sverklo/workspaces/ for .yaml files and return their names.
+ */
+export declare function listWorkspaces(): string[];
+/**
+ * Find which workspace contains this project path (exact match on
+ * any project's path). Returns the first match or null.
+ */
+export declare function findWorkspaceForProject(projectPath: string): WorkspaceConfig | null;
+/**
+ * Get the path for the cross-repo SQLite database for a workspace.
+ * Creates the parent directory if it doesn't exist.
+ */
+export declare function getWorkspaceDbPath(name: string): string;

package/dist/src/workspace/workspace-config.js

@@ -0,0 +1,91 @@
+import { existsSync, readdirSync, readFileSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { parse as parseYaml } from "yaml";
+const WORKSPACES_DIR = join(homedir(), ".sverklo", "workspaces");
+/**
+ * Load a workspace config from ~/.sverklo/workspaces/<name>.yaml.
+ * Returns null if the file doesn't exist or can't be parsed.
+ */
+export function loadWorkspaceConfig(name) {
+    const filePath = join(WORKSPACES_DIR, `${name}.yaml`);
+    if (!existsSync(filePath))
+        return null;
+    try {
+        const raw = readFileSync(filePath, "utf-8");
+        const parsed = parseYaml(raw);
+        if (!parsed || typeof parsed !== "object")
+            return null;
+        const workspace = String(parsed.workspace ?? name);
+        const rawProjects = Array.isArray(parsed.projects) ? parsed.projects : [];
+        const projects = rawProjects
+            .filter((p) => typeof p === "object" && p !== null && typeof p.path === "string")
+            .map((p) => {
+            const role = ["provider", "consumer", "both"].includes(p.role)
+                ? p.role
+                : "both";
+            const interfaces = Array.isArray(p.interfaces)
+                ? p.interfaces
+                    .filter((i) => typeof i === "object" &&
+                    i !== null &&
+                    typeof i.type === "string")
+                    .map((i) => ({
+                    type: i.type,
+                    ...(typeof i.schema === "string" ? { schema: i.schema } : {}),
+                    ...(typeof i.spec === "string" ? { spec: i.spec } : {}),
+                }))
+                : undefined;
+            return {
+                path: p.path,
+                role,
+                ...(interfaces && interfaces.length > 0 ? { interfaces } : {}),
+            };
+        });
+        return { workspace, projects };
+    }
+    catch (err) {
+        if (process.env.SVERKLO_DEBUG) {
+            process.stderr.write(`[sverklo] Failed to parse workspace '${name}': ${err}\n`);
+        }
+        return null;
+    }
+}
+/**
+ * Scan ~/.sverklo/workspaces/ for .yaml files and return their names.
+ */
+export function listWorkspaces() {
+    if (!existsSync(WORKSPACES_DIR))
+        return [];
+    try {
+        return readdirSync(WORKSPACES_DIR)
+            .filter((f) => f.endsWith(".yaml"))
+            .map((f) => f.replace(/\.yaml$/, ""));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Find which workspace contains this project path (exact match on
+ * any project's path). Returns the first match or null.
+ */
+export function findWorkspaceForProject(projectPath) {
+    const names = listWorkspaces();
+    for (const name of names) {
+        const config = loadWorkspaceConfig(name);
+        if (config && config.projects.some((p) => p.path === projectPath)) {
+            return config;
+        }
+    }
+    return null;
+}
+/**
+ * Get the path for the cross-repo SQLite database for a workspace.
+ * Creates the parent directory if it doesn't exist.
+ */
+export function getWorkspaceDbPath(name) {
+    const dir = join(WORKSPACES_DIR, name);
+    mkdirSync(dir, { recursive: true });
+    return join(dir, "cross.db");
+}
+//# sourceMappingURL=workspace-config.js.map

package/dist/src/workspace/workspace-config.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sverklo",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Sverklo — local-first code intelligence MCP server. Diff-aware MR review, risk scoring, hybrid semantic search, PageRank ranking, persistent memory. Zero config.",
   "type": "module",
   "bin": {