@specverse/engines 6.42.3 → 6.60.1

package/dist/ai/skill-loader.js.map

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

package/dist/analyse-prepass/adapters/index.d.ts

@@ -7,4 +7,6 @@
  */
 export { extractTypeScriptPrisma, type PrismaFacts, type PrismaEntity, type PrismaField, type PrismaRelation, } from './typescript-prisma.js';
 export { extractTypeScriptDecorators, type DecoratorFacts, type DecoratorEntity, type DecoratorRelationship, } from './typescript-decorators.js';
+export { inferNamingConventionFks, type NamingConventionFkFacts, type NamingConventionFkInferred, type NamingConventionFkOptions, type NamingConventionFkInputEntity, type NamingConventionFkInputRelationship, } from './naming-convention-fks.js';
+export { parseFunctionTerminalId, groupTerminalsByFile, findExportedFunctionBody, synthesizeServiceClass, deriveServiceName, type ModuleFunctionTerminal, } from './module-functions.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/analyse-prepass/adapters/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analyse-prepass/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,uBAAuB,EACvB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,2BAA2B,EAC3B,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analyse-prepass/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,uBAAuB,EACvB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,2BAA2B,EAC3B,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC3B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,wBAAwB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,EAC9B,KAAK,6BAA6B,EAClC,KAAK,mCAAmC,GACzC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC"}

package/dist/analyse-prepass/adapters/index.js

@@ -7,4 +7,6 @@
  */
 export { extractTypeScriptPrisma, } from './typescript-prisma.js';
 export { extractTypeScriptDecorators, } from './typescript-decorators.js';
+export { inferNamingConventionFks, } from './naming-convention-fks.js';
+export { parseFunctionTerminalId, groupTerminalsByFile, findExportedFunctionBody, synthesizeServiceClass, deriveServiceName, } from './module-functions.js';
 //# sourceMappingURL=index.js.map

package/dist/analyse-prepass/adapters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analyse-prepass/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,uBAAuB,GAKxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,2BAA2B,GAI5B,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analyse-prepass/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EACL,uBAAuB,GAKxB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,2BAA2B,GAI5B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,wBAAwB,GAMzB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,GAElB,MAAM,uBAAuB,CAAC"}

package/dist/analyse-prepass/adapters/module-functions.d.ts

@@ -0,0 +1,95 @@
+/**
+ * `module-functions` adapter — surfaces module-level exported functions
+ * as synthetic service classes via the candidate-step pipeline.
+ *
+ * Why this exists: PowerSync / hand-rolled Drizzle / Supabase-queries
+ * style codebases keep their business logic in modules of exported
+ * async functions:
+ *
+ *   // db/queries/smc-rounds.ts
+ *   export async function smcCreateRound(db, params) { ... }
+ *   export async function smcGetRound(db, id) { ... }
+ *   export async function smcUpdateRoundStatus(db, id, status) { ... }
+ *
+ * The class walker only sees classes — module functions are invisible
+ * to it. But GitNexus traces cross-method call flows AND captures
+ * function terminals as `Process` nodes (`Function:<filePath>:<fnName>`).
+ * That signal is already in `facts.processes` at the point the
+ * orchestrator finishes structural extraction.
+ *
+ * This adapter consumes the process terminals, groups them by file,
+ * and synthesizes one service class per file — exactly mirroring the
+ * `express-routes` pattern. The synthetic class body feeds into the
+ * existing `extractCandidateSteps` classifier, so module-function
+ * services get pre-classified timelines just like real class methods.
+ *
+ * Phase 0 of `2026-05-13-NORMALISE-PHASE.md`.
+ *
+ * Filed in proposal section §3.
+ */
+export interface ModuleFunctionTerminal {
+    /** Function name (suitable as a yaml key — preserved verbatim from source). */
+    methodName: string;
+    /** Whether the function is declared async. */
+    isAsync: boolean;
+    /** Function body between matching braces, no wrapping. */
+    body: string;
+    /** Source line range of the full declaration (export keyword → closing brace). */
+    sourceLineRange: [number, number];
+}
+/**
+ * Parse a `Function:<filePath>:<fnName>` terminalId. Returns null if
+ * the ID doesn't match (e.g. it's a class method).
+ *
+ * Examples:
+ *   "Function:db/queries/smc-rounds.ts:smcCreateRound" → { filePath, functionName }
+ *   "Method:UserController:create" → null
+ */
+export declare function parseFunctionTerminalId(id: string): {
+    filePath: string;
+    functionName: string;
+} | null;
+/**
+ * Walk `facts.processes`-shaped input for function terminals. Returns a
+ * map: filePath → Set<functionName>. Skips:
+ *   - Non-Function: terminals (class methods, etc.)
+ *   - Files outside common source extensions
+ *   - Files in node_modules / dist / build output
+ */
+export declare function groupTerminalsByFile(processes: Array<{
+    terminalId: string;
+}>): Map<string, Set<string>>;
+/**
+ * Find an exported top-level function in source. Handles four common
+ * declaration shapes:
+ *
+ *   export async function <name>(...) { ... }
+ *   export function <name>(...) { ... }
+ *   export const <name> = async (...) => { ... }
+ *   export const <name> = (...) => { ... }
+ *
+ * Returns null if not found or if the declaration's body can't be
+ * isolated (single-expression arrow `=> expr` without a brace block).
+ */
+export declare function findExportedFunctionBody(source: string, fnName: string): ModuleFunctionTerminal | null;
+/**
+ * Wrap a list of module functions in a synthetic class body. The output
+ * is suitable for `walkMethodBodies` / `extractCandidateSteps` to
+ * consume. Each function becomes a `<methodName>(...) { <body> }` member.
+ *
+ * Mirrors `synthesizeControllerClass` in `express-routes.ts`.
+ */
+export declare function synthesizeServiceClass(serviceName: string, functions: ModuleFunctionTerminal[]): string;
+/**
+ * Derive a service class name from a file path.
+ *
+ *   "db/queries/smc-rounds.ts" → "SmcRoundsService"
+ *   "lib/round-guards.ts"      → "RoundGuardsService"
+ *   "providers/AuthProvider.tsx" → "AuthProviderService"
+ *
+ * The file basename (no extension) is split on `-`, `_`, `.`, `/` and
+ * each segment is PascalCased. `Service` suffix is appended unless the
+ * derived name already ends in `Service` / `Controller`.
+ */
+export declare function deriveServiceName(filePath: string): string;
+//# sourceMappingURL=module-functions.d.ts.map

package/dist/analyse-prepass/adapters/module-functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-functions.d.ts","sourceRoot":"","sources":["../../../src/analyse-prepass/adapters/module-functions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,MAAM,GACT;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAanD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,KAAK,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,GACvC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAqB1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,sBAAsB,GAAG,IAAI,CA4C/B;AAqED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,sBAAsB,EAAE,GAClC,MAAM,CAYR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU1D"}

package/dist/analyse-prepass/adapters/module-functions.js

@@ -0,0 +1,358 @@
+/**
+ * `module-functions` adapter — surfaces module-level exported functions
+ * as synthetic service classes via the candidate-step pipeline.
+ *
+ * Why this exists: PowerSync / hand-rolled Drizzle / Supabase-queries
+ * style codebases keep their business logic in modules of exported
+ * async functions:
+ *
+ *   // db/queries/smc-rounds.ts
+ *   export async function smcCreateRound(db, params) { ... }
+ *   export async function smcGetRound(db, id) { ... }
+ *   export async function smcUpdateRoundStatus(db, id, status) { ... }
+ *
+ * The class walker only sees classes — module functions are invisible
+ * to it. But GitNexus traces cross-method call flows AND captures
+ * function terminals as `Process` nodes (`Function:<filePath>:<fnName>`).
+ * That signal is already in `facts.processes` at the point the
+ * orchestrator finishes structural extraction.
+ *
+ * This adapter consumes the process terminals, groups them by file,
+ * and synthesizes one service class per file — exactly mirroring the
+ * `express-routes` pattern. The synthetic class body feeds into the
+ * existing `extractCandidateSteps` classifier, so module-function
+ * services get pre-classified timelines just like real class methods.
+ *
+ * Phase 0 of `2026-05-13-NORMALISE-PHASE.md`.
+ *
+ * Filed in proposal section §3.
+ */
+/**
+ * Parse a `Function:<filePath>:<fnName>` terminalId. Returns null if
+ * the ID doesn't match (e.g. it's a class method).
+ *
+ * Examples:
+ *   "Function:db/queries/smc-rounds.ts:smcCreateRound" → { filePath, functionName }
+ *   "Method:UserController:create" → null
+ */
+export function parseFunctionTerminalId(id) {
+    // Format: Function:<filePath>:<functionName>. The filePath may contain
+    // colons (drive letters on Windows, ports in URLs — rare in practice
+    // but defensive). The functionName is always the LAST `:`-separated
+    // segment. Anchor on `Function:` prefix.
+    if (!id.startsWith('Function:'))
+        return null;
+    const rest = id.slice('Function:'.length);
+    const lastColon = rest.lastIndexOf(':');
+    if (lastColon < 0)
+        return null;
+    const filePath = rest.slice(0, lastColon);
+    const functionName = rest.slice(lastColon + 1);
+    if (!filePath || !functionName)
+        return null;
+    return { filePath, functionName };
+}
+/**
+ * Walk `facts.processes`-shaped input for function terminals. Returns a
+ * map: filePath → Set<functionName>. Skips:
+ *   - Non-Function: terminals (class methods, etc.)
+ *   - Files outside common source extensions
+ *   - Files in node_modules / dist / build output
+ */
+export function groupTerminalsByFile(processes) {
+    const out = new Map();
+    for (const p of processes) {
+        const parsed = parseFunctionTerminalId(p.terminalId);
+        if (!parsed)
+            continue;
+        // Skip files that look like generated / vendored output.
+        if (/node_modules|\.d\.ts$|dist\/|build\//.test(parsed.filePath))
+            continue;
+        // Stick to backend source extensions. `.tsx`/`.jsx` are React/JSX
+        // files — those are frontend components + hooks, NOT backend
+        // service modules. The react-views adapter handles them; this
+        // adapter must not double-claim them as services.
+        if (!/\.(ts|js|mjs|cjs)$/.test(parsed.filePath))
+            continue;
+        if (/\.d\.ts$/.test(parsed.filePath))
+            continue;
+        let set = out.get(parsed.filePath);
+        if (!set) {
+            set = new Set();
+            out.set(parsed.filePath, set);
+        }
+        set.add(parsed.functionName);
+    }
+    return out;
+}
+/**
+ * Find an exported top-level function in source. Handles four common
+ * declaration shapes:
+ *
+ *   export async function <name>(...) { ... }
+ *   export function <name>(...) { ... }
+ *   export const <name> = async (...) => { ... }
+ *   export const <name> = (...) => { ... }
+ *
+ * Returns null if not found or if the declaration's body can't be
+ * isolated (single-expression arrow `=> expr` without a brace block).
+ */
+export function findExportedFunctionBody(source, fnName) {
+    // Shape A: `export (async )? function <fnName>(...) { ... }`
+    // The space-or-newline between `function` and the name allows for
+    // multiline declarations with intervening whitespace.
+    const funcRe = new RegExp(`\\bexport\\s+(async\\s+)?function\\s+${escapeRegex(fnName)}\\s*\\(`, 'm');
+    const funcMatch = funcRe.exec(source);
+    if (funcMatch) {
+        const openParenIdx = funcMatch.index + funcMatch[0].length - 1;
+        const closeParenIdx = findMatchingParen(source, openParenIdx);
+        if (closeParenIdx < 0)
+            return null;
+        // Body opening brace = first `{` after `)` at angle-bracket depth 0
+        // (skips `{` inside a return type generic like `Promise<{ ... }>`).
+        const braceIdx = findBodyBrace(source, closeParenIdx + 1);
+        if (braceIdx < 0)
+            return null;
+        return extractBody(source, funcMatch.index, braceIdx, !!funcMatch[1]);
+    }
+    // Shape B: `export const <fnName> = (async )? (...) [: Type]? => { ... }`
+    const constRe = new RegExp(`\\bexport\\s+const\\s+${escapeRegex(fnName)}\\s*=\\s*(async\\s+)?\\(`, 'm');
+    const constMatch = constRe.exec(source);
+    if (constMatch) {
+        const openParenIdx = constMatch.index + constMatch[0].length - 1;
+        const closeParenIdx = findMatchingParen(source, openParenIdx);
+        if (closeParenIdx < 0)
+            return null;
+        // After the `)`, expect optionally `: <ReturnType>` then `=>` then `{`.
+        // The return type can contain `>`, `<`, `,`, generics, etc., so we
+        // can't use a simple regex. Walk forward through angle-bracket-aware
+        // chars until we hit `=>`.
+        const arrowIdx = findArrowAfterParen(source, closeParenIdx + 1);
+        if (arrowIdx < 0)
+            return null;
+        // After `=>`, skip whitespace, expect `{`.
+        let i = arrowIdx + 2;
+        while (i < source.length && /\s/.test(source[i]))
+            i++;
+        if (source[i] !== '{')
+            return null;
+        return extractBody(source, constMatch.index, i, !!constMatch[1]);
+    }
+    return null;
+}
+/**
+ * Find the first `{` after `fromIdx` that's at angle-bracket depth 0.
+ * This skips over generic-parameter braces like `Promise<{rows: Row[]}>`
+ * which would otherwise be mistakenly identified as the function body.
+ */
+function findBodyBrace(source, fromIdx) {
+    let angleDepth = 0;
+    let strChar = null;
+    for (let i = fromIdx; i < source.length; i++) {
+        const c = source[i];
+        if (strChar) {
+            if (c === '\\') {
+                i++;
+                continue;
+            }
+            if (c === strChar)
+                strChar = null;
+            continue;
+        }
+        if (c === '"' || c === "'" || c === '`') {
+            strChar = c;
+            continue;
+        }
+        if (c === '<')
+            angleDepth++;
+        else if (c === '>')
+            angleDepth = Math.max(0, angleDepth - 1);
+        else if (c === '{' && angleDepth === 0)
+            return i;
+    }
+    return -1;
+}
+/**
+ * Find the `=>` after `fromIdx` at angle-bracket depth 0. Lets us walk
+ * past a `: Type<...>` return-type annotation on a const arrow form.
+ */
+function findArrowAfterParen(source, fromIdx) {
+    let angleDepth = 0;
+    let strChar = null;
+    for (let i = fromIdx; i < source.length - 1; i++) {
+        const c = source[i];
+        const next = source[i + 1];
+        if (strChar) {
+            if (c === '\\') {
+                i++;
+                continue;
+            }
+            if (c === strChar)
+                strChar = null;
+            continue;
+        }
+        if (c === '"' || c === "'" || c === '`') {
+            strChar = c;
+            continue;
+        }
+        if (c === '<')
+            angleDepth++;
+        else if (c === '>')
+            angleDepth = Math.max(0, angleDepth - 1);
+        else if (c === '=' && next === '>' && angleDepth === 0)
+            return i;
+        // Bail if we hit `{` or `;` at depth 0 without seeing `=>` — not an arrow form.
+        else if ((c === '{' || c === ';') && angleDepth === 0)
+            return -1;
+    }
+    return -1;
+}
+function extractBody(source, declStartIdx, openBraceIdx, isAsync) {
+    const closeBraceIdx = findMatchingBrace(source, openBraceIdx);
+    if (closeBraceIdx < 0)
+        return null;
+    const body = source.slice(openBraceIdx + 1, closeBraceIdx);
+    const startLine = source.slice(0, declStartIdx).split('\n').length;
+    const endLine = source.slice(0, closeBraceIdx + 1).split('\n').length;
+    return {
+        methodName: '', // filled by caller; we don't have the name here
+        isAsync,
+        body,
+        sourceLineRange: [startLine, endLine],
+    };
+}
+/**
+ * Wrap a list of module functions in a synthetic class body. The output
+ * is suitable for `walkMethodBodies` / `extractCandidateSteps` to
+ * consume. Each function becomes a `<methodName>(...) { <body> }` member.
+ *
+ * Mirrors `synthesizeControllerClass` in `express-routes.ts`.
+ */
+export function synthesizeServiceClass(serviceName, functions) {
+    const lines = [];
+    lines.push(`class ${serviceName} {`);
+    for (const f of functions) {
+        const asyncWord = f.isAsync ? 'async ' : '';
+        lines.push(`  ${asyncWord}${f.methodName}() {`);
+        const bodyLines = f.body.split('\n').map((l) => '  ' + l);
+        lines.push(...bodyLines);
+        lines.push('  }');
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+/**
+ * Derive a service class name from a file path.
+ *
+ *   "db/queries/smc-rounds.ts" → "SmcRoundsService"
+ *   "lib/round-guards.ts"      → "RoundGuardsService"
+ *   "providers/AuthProvider.tsx" → "AuthProviderService"
+ *
+ * The file basename (no extension) is split on `-`, `_`, `.`, `/` and
+ * each segment is PascalCased. `Service` suffix is appended unless the
+ * derived name already ends in `Service` / `Controller`.
+ */
+export function deriveServiceName(filePath) {
+    const basename = filePath.split('/').pop() ?? filePath;
+    const noExt = basename.replace(/\.(ts|tsx|js|jsx|mjs|cjs)$/, '');
+    const pascal = noExt
+        .split(/[-_./]+/)
+        .filter((p) => p.length > 0)
+        .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
+        .join('');
+    if (/Service$/.test(pascal) || /Controller$/.test(pascal))
+        return pascal;
+    return `${pascal}Service`;
+}
+// ── Brace / paren matching helpers ───────────────────────────────────
+// Inlined (not imported from express-routes) to keep this adapter
+// self-contained. Same logic, same edge cases.
+function findMatchingParen(source, openIdx) {
+    if (source[openIdx] !== '(')
+        return -1;
+    let depth = 0;
+    let strChar = null;
+    for (let i = openIdx; i < source.length; i++) {
+        const c = source[i];
+        if (strChar) {
+            if (c === '\\') {
+                i++;
+                continue;
+            }
+            if (c === strChar)
+                strChar = null;
+            continue;
+        }
+        if (c === '"' || c === "'" || c === '`') {
+            strChar = c;
+            continue;
+        }
+        if (c === '(')
+            depth++;
+        else if (c === ')') {
+            depth--;
+            if (depth === 0)
+                return i;
+        }
+    }
+    return -1;
+}
+function findMatchingBrace(source, openIdx) {
+    if (source[openIdx] !== '{')
+        return -1;
+    let depth = 0;
+    let strChar = null;
+    let inLineComment = false;
+    let inBlockComment = false;
+    for (let i = openIdx; i < source.length; i++) {
+        const c = source[i];
+        const next = source[i + 1];
+        if (inLineComment) {
+            if (c === '\n')
+                inLineComment = false;
+            continue;
+        }
+        if (inBlockComment) {
+            if (c === '*' && next === '/') {
+                inBlockComment = false;
+                i++;
+            }
+            continue;
+        }
+        if (strChar) {
+            if (c === '\\') {
+                i++;
+                continue;
+            }
+            if (c === strChar)
+                strChar = null;
+            continue;
+        }
+        if (c === '/' && next === '/') {
+            inLineComment = true;
+            i++;
+            continue;
+        }
+        if (c === '/' && next === '*') {
+            inBlockComment = true;
+            i++;
+            continue;
+        }
+        if (c === '"' || c === "'" || c === '`') {
+            strChar = c;
+            continue;
+        }
+        if (c === '{')
+            depth++;
+        else if (c === '}') {
+            depth--;
+            if (depth === 0)
+                return i;
+        }
+    }
+    return -1;
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=module-functions.js.map

package/dist/analyse-prepass/adapters/module-functions.js.map

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

package/dist/analyse-prepass/adapters/naming-convention-fks.d.ts

@@ -0,0 +1,90 @@
+/**
+ * `naming-convention-fks` adapter — convention-FK relationship inference.
+ *
+ * Some codebases carry no explicit FK metadata: PowerSync (`column.text`
+ * without `.references()`), hand-rolled Drizzle without relations, plain
+ * SQL migrations without REFERENCES clauses. The relationship lives in the
+ * column NAME (`club_id`, `userId`) by convention only. None of the
+ * structural adapters (typescript-prisma / typescript-decorators /
+ * typescript-interfaces / express-routes / react-views) catches this
+ * pattern — typescript-interfaces sees `club_id: string` as a plain string
+ * field, not a relationship.
+ *
+ * This adapter is a POST-EXTRACTION inference pass. It runs after all
+ * structural adapters have populated `facts.entities[].attributes[]` and
+ * walks those attributes for the `*_id` / `*Id` pattern, resolving the
+ * prefix against the entity name set (singular OR plural form). When a
+ * match resolves cleanly to a known entity, it emits a belongsTo
+ * relationship from the owning entity to the target plus a reverse hasMany.
+ *
+ * Surfaced as a gap by the scoremyclays full-pipeline run 2026-05-12: 10
+ * entities extracted, 0 relationships, because Supabase + PowerSync uses
+ * convention FKs throughout (`club_id: column.text`).
+ *
+ * Cut 1 patterns:
+ *   - `<entity>_id` (snake_case) or `<entity>Id` (camelCase), where the
+ *     prefix maps to a known entity name (case-insensitive, singular OR
+ *     plural via a small english heuristic).
+ *
+ * Out of scope (deferred to follow-up):
+ *   - `created_by` / `assigned_to` / `owner_id` — target entity not named
+ *     in the column (needs a curated semantic map OR LLM inference).
+ *   - Composite FKs — same shape produces independent belongsTos; downstream
+ *     can combine if it cares.
+ *
+ * Cardinality: forward `belongsTo` for every matched `*_id`. The reverse
+ * `hasMany` is emitted ONLY when this adapter discovered the forward edge
+ * itself — i.e. when a prior adapter hadn't already declared that
+ * belongsTo. Rationale: rich-metadata codebases (TypeORM with explicit
+ * @ManyToOne) decline to declare the inverse @OneToMany when they don't
+ * navigate that way, and we shouldn't second-guess that omission. For
+ * convention-only codebases (PowerSync) where no prior adapter saw the
+ * relationship, BOTH directions are emitted so downstream gets a complete
+ * cardinality view.
+ *
+ * Self-references (`parent_id` on Category → Category) emit only the
+ * belongsTo regardless — `Category hasMany Category` is legal but rarely
+ * the intended shape.
+ *
+ * Dedup: skip a candidate when the same `from|to|type` already exists in
+ * the input relationships list (a higher-fidelity adapter wins).
+ */
+export interface NamingConventionFkInputEntity {
+    name: string;
+    attributes?: Array<{
+        name: string;
+        isPrimary?: boolean;
+    }>;
+}
+export interface NamingConventionFkInputRelationship {
+    from: string;
+    to: string;
+    type: 'belongsTo' | 'hasMany' | 'hasOne' | 'manyToMany';
+}
+export interface NamingConventionFkInferred {
+    from: string;
+    to: string;
+    type: 'belongsTo' | 'hasMany';
+    /** Source attribute that triggered the inference. Kept for downstream
+     *  attribution + tests; the orchestrator drops this before merging into
+     *  facts.relationships (which has no `fieldName` field on its canonical
+     *  shape). */
+    fieldName: string;
+}
+export interface NamingConventionFkFacts {
+    relationships: NamingConventionFkInferred[];
+    /** How many attributes matched the `*_id` / `*Id` pattern. */
+    matchedAttributes: number;
+    /** Matches that were skipped because the attribute is the entity's PK. */
+    ignoredPrimaryKeys: number;
+    /** Matches that resolved to no entity name. */
+    unresolvedTargets: number;
+}
+export interface NamingConventionFkOptions {
+    /** Override pluralization. Default: simple english heuristic. */
+    pluralize?: (singular: string) => string;
+    /** Override singularization. Default: simple english heuristic. */
+    singularize?: (plural: string) => string;
+}
+export declare function inferNamingConventionFks(entities: NamingConventionFkInputEntity[], existingRelationships: NamingConventionFkInputRelationship[], options?: NamingConventionFkOptions): NamingConventionFkFacts;
+//# sourceMappingURL=naming-convention-fks.d.ts.map

package/dist/analyse-prepass/adapters/naming-convention-fks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming-convention-fks.d.ts","sourceRoot":"","sources":["../../../src/analyse-prepass/adapters/naming-convention-fks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,OAAO,CAAC;KACrB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,mCAAmC;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,CAAC;CACzD;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,GAAG,SAAS,CAAC;IAC9B;;;kBAGc;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,0BAA0B,EAAE,CAAC;IAC5C,8DAA8D;IAC9D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,0EAA0E;IAC1E,kBAAkB,EAAE,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACxC,iEAAiE;IACjE,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IACzC,mEAAmE;IACnE,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CAC1C;AAID,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,6BAA6B,EAAE,EACzC,qBAAqB,EAAE,mCAAmC,EAAE,EAC5D,OAAO,GAAE,yBAA8B,GACtC,uBAAuB,CA6EzB"}