@mcp-graph-workflow/mcp-graph 5.16.0 → 5.17.0

package/dist/core/translation/language-detect.js

@@ -0,0 +1,140 @@
+/**
+ * Language Detection from Code Snippets — heuristic keyword/pattern detection.
+ * Returns languageId, confidence (0-1), and indicators explaining the detection.
+ */
+export { detectProjectLanguages } from "../lsp/language-detector.js";
+const PROFILES = [
+    {
+        id: "typescript",
+        unique: [
+            /\binterface\s+\w+\s*\{/, /\btype\s+\w+\s*=/, /\benum\s+\w+\s*\{/,
+            /:\s*(string|number|boolean|void)\b/, /\bas\s+(string|number|boolean)\b/,
+        ],
+        strong: [
+            /\bconst\s+\w+\s*[:=]/, /\bimport\s*\{[^}]+\}\s*from\s*['"]/, /\bexport\s+(function|class|const|interface|type)\b/,
+            /=>\s*\{/, /\bPromise</, /\bconsole\.\w+\(/,
+        ],
+        weak: [
+            /\bfunction\s+\w+/, /\bclass\s+\w+/, /\breturn\s+/, /\bnew\s+\w+/,
+        ],
+    },
+    {
+        id: "python",
+        unique: [
+            /^(\s*)def\s+\w+\s*\(/m, /^(\s*)class\s+\w+.*:\s*$/m,
+            /^from\s+\S+\s+import\s+/m, /^\s*elif\s+/m,
+            /\bprint\s*\(/, /\bTrue\b/, /\bFalse\b/, /\bNone\b/,
+            /^\s*@\w+/m, /\basync\s+def\b/,
+        ],
+        strong: [
+            /^import\s+\w+\s*$/m, /\bself\.\w+/, /\bpass\b/,
+            /:\s*$\n\s+/m, /\bf["']/, /\braise\s+\w+/,
+        ],
+        weak: [
+            /\bif\s+.*:\s*$/m, /\bfor\s+\w+\s+in\s+/m, /\bwhile\s+/m,
+        ],
+    },
+    {
+        id: "go",
+        unique: [
+            /^package\s+\w+/m, /\bfunc\s+\w*\s*\(/, /\b:=\s*/,
+            /\bgo\s+func\b/, /\bdefer\s+/, /\bchan\s+/,
+            /\bfmt\.\w+/, /\bgoroutine/,
+        ],
+        strong: [
+            /\bvar\s+\w+\s+\w+/, /\bstruct\s*\{/, /\binterface\s*\{/,
+            /\berr\s*!=\s*nil/, /\brange\s+/,
+        ],
+        weak: [
+            /\breturn\s+/, /\bif\s+.*\{/,
+        ],
+    },
+    {
+        id: "java",
+        unique: [
+            /\bpublic\s+(static\s+)?void\s+main\b/, /\bSystem\.out\.print/,
+            /\bpublic\s+class\s+\w+/, /\bprivate\s+(static\s+)?\w+\s+\w+/,
+            /\bnew\s+ArrayList</, /\bextends\s+\w+\s*\{/,
+        ],
+        strong: [
+            /\b@Override\b/, /\b@Autowired\b/, /\bimport\s+java\./,
+            /\bList<\w+>/, /\bString\[\]\s+\w+/, /\bthrows\s+\w+/,
+        ],
+        weak: [
+            /\bpublic\s+\w+/, /\bprivate\s+\w+/, /\bprotected\s+\w+/,
+        ],
+    },
+    {
+        id: "csharp",
+        unique: [
+            /\busing\s+System\b/, /\bnamespace\s+\w+/, /\bConsole\.Write/,
+            /\.Where\(/, /\.Select\(/, /\.ToList\(\)/,
+            /\bvar\s+\w+\s*=\s*.*\.Where/, /\basync\s+Task</,
+        ],
+        strong: [
+            /\busing\s+\w+\.\w+;/, /\bstring\.\w+/, /\bint\s+\w+/,
+            /\bpublic\s+(override|virtual)\b/,
+        ],
+        weak: [
+            /\bpublic\s+\w+/, /\bclass\s+\w+/,
+        ],
+    },
+    {
+        id: "rust",
+        unique: [
+            /\bfn\s+\w+\s*\(/, /\blet\s+mut\s+/, /\bimpl\s+\w+/,
+            /\bprintln!\(/, /\b->\s*(Self|&)/, /\bstruct\s+\w+\s*\{/,
+            /\bmatch\s+\w+\s*\{/, /\bOption</, /\bResult</,
+        ],
+        strong: [
+            /\buse\s+\w+::/, /\bpub\s+(fn|struct|enum)\b/, /\b&self\b/,
+            /\bunwrap\(\)/, /\b\.clone\(\)/,
+        ],
+        weak: [
+            /\blet\s+\w+/, /\breturn\s+/,
+        ],
+    },
+];
+const UNIQUE_WEIGHT = 3;
+const STRONG_WEIGHT = 1.5;
+const WEAK_WEIGHT = 0.5;
+export function detectLanguageFromCode(code) {
+    if (!code.trim()) {
+        return { languageId: "unknown", confidence: 0, indicators: [] };
+    }
+    let bestLang = "unknown";
+    let bestScore = 0;
+    let bestIndicators = [];
+    for (const profile of PROFILES) {
+        let score = 0;
+        const indicators = [];
+        for (const pattern of profile.unique) {
+            if (pattern.test(code)) {
+                score += UNIQUE_WEIGHT;
+                indicators.push(`unique: ${pattern.source.substring(0, 40)}`);
+            }
+        }
+        for (const pattern of profile.strong) {
+            if (pattern.test(code)) {
+                score += STRONG_WEIGHT;
+                indicators.push(`strong: ${pattern.source.substring(0, 40)}`);
+            }
+        }
+        for (const pattern of profile.weak) {
+            if (pattern.test(code)) {
+                score += WEAK_WEIGHT;
+                indicators.push(`weak: ${pattern.source.substring(0, 40)}`);
+            }
+        }
+        if (score > bestScore) {
+            bestScore = score;
+            bestLang = profile.id;
+            bestIndicators = indicators;
+        }
+    }
+    // Normalize confidence: map score to 0-1 range
+    // A score of ~6+ is high confidence, ~3 is medium, <2 is low
+    const confidence = Math.min(bestScore / 8, 1);
+    return { languageId: bestLang, confidence, indicators: bestIndicators };
+}
+//# sourceMappingURL=language-detect.js.map

package/dist/core/translation/language-detect.js.map

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

package/dist/core/translation/parsers/parser-adapter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Parser Adapter interface — language-agnostic contract for parsing code into
+ * canonical constructs from the UCR (Universal Construct Registry).
+ */
+/** A construct detected in source code, mapped to a UCR canonical ID. */
+export interface ParsedConstruct {
+    /** UCR canonical construct ID (e.g., "uc_fn_def", "uc_class_def") */
+    constructId: string;
+    /** Name of the construct if applicable (function name, class name, etc.) */
+    name?: string;
+    /** 1-based start line in source */
+    startLine: number;
+    /** 1-based end line in source */
+    endLine: number;
+}
+/** Adapter interface for language-specific parsers. */
+export interface ParserAdapter {
+    /** Language identifier (matches UCR language_id, e.g., "typescript", "python") */
+    readonly languageId: string;
+    /** Parse a code snippet and return detected canonical constructs. */
+    parseSnippet(code: string): ParsedConstruct[];
+}
+//# sourceMappingURL=parser-adapter.d.ts.map

package/dist/core/translation/parsers/parser-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-adapter.d.ts","sourceRoot":"","sources":["../../../../src/core/translation/parsers/parser-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,qEAAqE;IACrE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;CAC/C"}

package/dist/core/translation/parsers/parser-adapter.js

@@ -0,0 +1,6 @@
+/**
+ * Parser Adapter interface — language-agnostic contract for parsing code into
+ * canonical constructs from the UCR (Universal Construct Registry).
+ */
+export {};
+//# sourceMappingURL=parser-adapter.js.map

package/dist/core/translation/parsers/parser-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser-adapter.js","sourceRoot":"","sources":["../../../../src/core/translation/parsers/parser-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/core/translation/parsers/python-parser-adapter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Python Parser Adapter — heuristic regex + line-based parser for Python code.
+ * Maps detected constructs to UCR canonical IDs without requiring a Python AST library.
+ */
+import type { ParserAdapter, ParsedConstruct } from "./parser-adapter.js";
+export declare class PythonParserAdapter implements ParserAdapter {
+    readonly languageId = "python";
+    parseSnippet(code: string): ParsedConstruct[];
+}
+//# sourceMappingURL=python-parser-adapter.d.ts.map

package/dist/core/translation/parsers/python-parser-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-parser-adapter.d.ts","sourceRoot":"","sources":["../../../../src/core/translation/parsers/python-parser-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AA+C1E,qBAAa,mBAAoB,YAAW,aAAa;IACvD,QAAQ,CAAC,UAAU,YAAY;IAE/B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE;CA8C9C"}

package/dist/core/translation/parsers/python-parser-adapter.js

@@ -0,0 +1,85 @@
+/**
+ * Python Parser Adapter — heuristic regex + line-based parser for Python code.
+ * Maps detected constructs to UCR canonical IDs without requiring a Python AST library.
+ */
+const LINE_RULES = [
+    // async def must come before def
+    { pattern: /^(\s*)async\s+def\s+(\w+)/, constructId: "uc_async_fn", nameGroup: 2 },
+    { pattern: /^(\s*)def\s+(\w+)/, constructId: "uc_fn_def", nameGroup: 2 },
+    // class with inheritance
+    {
+        pattern: /^(\s*)class\s+(\w+)\s*\([^)]+\)\s*:/,
+        constructId: "uc_class_def",
+        nameGroup: 2,
+        also: [{ constructId: "uc_extends" }],
+    },
+    // class without inheritance
+    { pattern: /^(\s*)class\s+(\w+)/, constructId: "uc_class_def", nameGroup: 2 },
+    // from x import y (named import)
+    { pattern: /^from\s+\S+\s+import\s+/, constructId: "uc_import_named" },
+    // import x (default/module import)
+    { pattern: /^import\s+\w+/, constructId: "uc_import_default" },
+    // if/elif/else
+    { pattern: /^(\s*)(if|elif)\s+.+:/, constructId: "uc_if_else" },
+    // for loop (Python for is always for-each style)
+    { pattern: /^(\s*)for\s+\w+\s+in\s+/, constructId: "uc_for_each" },
+    // while loop
+    { pattern: /^(\s*)while\s+/, constructId: "uc_while" },
+    // try/except
+    { pattern: /^(\s*)try\s*:/, constructId: "uc_try_catch" },
+    // raise (throw)
+    { pattern: /^(\s*)raise\s+/, constructId: "uc_throw" },
+    // return
+    { pattern: /^(\s*)return\b/, constructId: "uc_return" },
+    // await expression
+    { pattern: /\bawait\s+/, constructId: "uc_await" },
+    // continue
+    { pattern: /^(\s*)continue\s*$/, constructId: "uc_continue" },
+    // break
+    { pattern: /^(\s*)break\s*$/, constructId: "uc_break" },
+];
+export class PythonParserAdapter {
+    languageId = "python";
+    parseSnippet(code) {
+        if (!code.trim())
+            return [];
+        const lines = code.split("\n");
+        const constructs = [];
+        const seen = new Set();
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const lineNum = i + 1;
+            for (const rule of LINE_RULES) {
+                const match = rule.pattern.exec(line);
+                if (!match)
+                    continue;
+                // Deduplicate if/else — only emit once per if block
+                if (rule.constructId === "uc_if_else") {
+                    const key = `${rule.constructId}:${lineNum}`;
+                    if (seen.has(key))
+                        continue;
+                    seen.add(key);
+                }
+                const name = rule.nameGroup ? match[rule.nameGroup] : undefined;
+                constructs.push({
+                    constructId: rule.constructId,
+                    name,
+                    startLine: lineNum,
+                    endLine: lineNum,
+                });
+                if (rule.also) {
+                    for (const extra of rule.also) {
+                        constructs.push({
+                            constructId: extra.constructId,
+                            startLine: lineNum,
+                            endLine: lineNum,
+                        });
+                    }
+                }
+                break; // Only first matching rule per line
+            }
+        }
+        return constructs;
+    }
+}
+//# sourceMappingURL=python-parser-adapter.js.map

package/dist/core/translation/parsers/python-parser-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-parser-adapter.js","sourceRoot":"","sources":["../../../../src/core/translation/parsers/python-parser-adapter.ts"],"names":[],"mappings":"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"}

package/dist/core/translation/parsers/ts-parser-adapter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * TypeScript Parser Adapter — parses TS/JS code into UCR canonical constructs
+ * using the TypeScript compiler API (ts.createSourceFile + AST walk).
+ */
+import type { ParserAdapter, ParsedConstruct } from "./parser-adapter.js";
+export declare class TsParserAdapter implements ParserAdapter {
+    readonly languageId = "typescript";
+    parseSnippet(code: string): ParsedConstruct[];
+}
+//# sourceMappingURL=ts-parser-adapter.d.ts.map

package/dist/core/translation/parsers/ts-parser-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-parser-adapter.d.ts","sourceRoot":"","sources":["../../../../src/core/translation/parsers/ts-parser-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE1E,qBAAa,eAAgB,YAAW,aAAa;IACnD,QAAQ,CAAC,UAAU,gBAAgB;IAEnC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE;CAe9C"}

package/dist/core/translation/parsers/ts-parser-adapter.js

@@ -0,0 +1,145 @@
+/**
+ * TypeScript Parser Adapter — parses TS/JS code into UCR canonical constructs
+ * using the TypeScript compiler API (ts.createSourceFile + AST walk).
+ */
+import ts from "typescript";
+export class TsParserAdapter {
+    languageId = "typescript";
+    parseSnippet(code) {
+        if (!code.trim())
+            return [];
+        const sourceFile = ts.createSourceFile("snippet.ts", code, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+        const constructs = [];
+        const visit = (node) => {
+            const mapped = mapNode(node, sourceFile);
+            if (mapped)
+                constructs.push(...mapped);
+            ts.forEachChild(node, visit);
+        };
+        ts.forEachChild(sourceFile, visit);
+        return constructs;
+    }
+}
+function getLines(node, sf) {
+    const start = sf.getLineAndCharacterOfPosition(node.getStart(sf));
+    const end = sf.getLineAndCharacterOfPosition(node.getEnd());
+    return { startLine: start.line + 1, endLine: end.line + 1 };
+}
+function mapNode(node, sf) {
+    const lines = getLines(node, sf);
+    // Function declaration
+    if (ts.isFunctionDeclaration(node) && node.name) {
+        const results = [{ constructId: "uc_fn_def", name: node.name.text, ...lines }];
+        if (hasAsyncModifier(node)) {
+            results.push({ constructId: "uc_async_fn", name: node.name.text, ...lines });
+        }
+        return results;
+    }
+    // Arrow function (const x = (...) => ...)
+    if (ts.isVariableDeclaration(node) && node.initializer && ts.isArrowFunction(node.initializer)) {
+        const name = ts.isIdentifier(node.name) ? node.name.text : undefined;
+        return [{ constructId: "uc_arrow_fn", name, ...lines }];
+    }
+    // Class declaration
+    if (ts.isClassDeclaration(node) && node.name) {
+        const results = [{ constructId: "uc_class_def", name: node.name.text, ...lines }];
+        if (node.heritageClauses) {
+            for (const clause of node.heritageClauses) {
+                if (clause.token === ts.SyntaxKind.ExtendsKeyword) {
+                    results.push({ constructId: "uc_extends", ...lines });
+                }
+                if (clause.token === ts.SyntaxKind.ImplementsKeyword) {
+                    results.push({ constructId: "uc_implements", ...lines });
+                }
+            }
+        }
+        return results;
+    }
+    // Interface declaration
+    if (ts.isInterfaceDeclaration(node)) {
+        return [{ constructId: "uc_interface", name: node.name.text, ...lines }];
+    }
+    // Type alias
+    if (ts.isTypeAliasDeclaration(node)) {
+        return [{ constructId: "uc_type_alias", name: node.name.text, ...lines }];
+    }
+    // Enum declaration
+    if (ts.isEnumDeclaration(node)) {
+        return [{ constructId: "uc_type_enum", name: node.name.text, ...lines }];
+    }
+    // Import declaration
+    if (ts.isImportDeclaration(node) && node.importClause) {
+        const results = [];
+        const clause = node.importClause;
+        if (clause.name) {
+            results.push({ constructId: "uc_import_default", ...lines });
+        }
+        if (clause.namedBindings) {
+            if (ts.isNamedImports(clause.namedBindings)) {
+                results.push({ constructId: "uc_import_named", ...lines });
+            }
+            if (ts.isNamespaceImport(clause.namedBindings)) {
+                results.push({ constructId: "uc_import_namespace", ...lines });
+            }
+        }
+        return results.length > 0 ? results : null;
+    }
+    // If statement
+    if (ts.isIfStatement(node)) {
+        return [{ constructId: "uc_if_else", ...lines }];
+    }
+    // For statement
+    if (ts.isForStatement(node)) {
+        return [{ constructId: "uc_for_loop", ...lines }];
+    }
+    // ForOf / ForIn
+    if (ts.isForOfStatement(node) || ts.isForInStatement(node)) {
+        return [{ constructId: "uc_for_each", ...lines }];
+    }
+    // While
+    if (ts.isWhileStatement(node)) {
+        return [{ constructId: "uc_while", ...lines }];
+    }
+    // Do/While
+    if (ts.isDoStatement(node)) {
+        return [{ constructId: "uc_do_while", ...lines }];
+    }
+    // Try/Catch
+    if (ts.isTryStatement(node)) {
+        const results = [{ constructId: "uc_try_catch", ...lines }];
+        if (node.finallyBlock) {
+            results.push({ constructId: "uc_try_finally", ...lines });
+        }
+        return results;
+    }
+    // Switch
+    if (ts.isSwitchStatement(node)) {
+        return [{ constructId: "uc_switch", ...lines }];
+    }
+    // Throw
+    if (ts.isThrowStatement(node)) {
+        return [{ constructId: "uc_throw", ...lines }];
+    }
+    // Return
+    if (ts.isReturnStatement(node)) {
+        return [{ constructId: "uc_return", ...lines }];
+    }
+    // Await expression
+    if (ts.isAwaitExpression(node)) {
+        return [{ constructId: "uc_await", ...lines }];
+    }
+    // Export (named)
+    if (ts.isExportDeclaration(node)) {
+        return [{ constructId: "uc_export_named", ...lines }];
+    }
+    // Export default
+    if (ts.isExportAssignment(node)) {
+        return [{ constructId: "uc_export_default", ...lines }];
+    }
+    return null;
+}
+function hasAsyncModifier(node) {
+    const modifiers = ts.getModifiers(node);
+    return modifiers?.some((m) => m.kind === ts.SyntaxKind.AsyncKeyword) ?? false;
+}
+//# sourceMappingURL=ts-parser-adapter.js.map

package/dist/core/translation/parsers/ts-parser-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ts-parser-adapter.js","sourceRoot":"","sources":["../../../../src/core/translation/parsers/ts-parser-adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5B,MAAM,OAAO,eAAe;IACjB,UAAU,GAAG,YAAY,CAAC;IAEnC,YAAY,CAAC,IAAY;QACvB,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,OAAO,EAAE,CAAC;QAE5B,MAAM,UAAU,GAAG,EAAE,CAAC,gBAAgB,CAAC,YAAY,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC5G,MAAM,UAAU,GAAsB,EAAE,CAAC;QAEzC,MAAM,KAAK,GAAG,CAAC,IAAa,EAAQ,EAAE;YACpC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;YACzC,IAAI,MAAM;gBAAE,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;YACvC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC,CAAC;QAEF,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QACnC,OAAO,UAAU,CAAC;IACpB,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,IAAa,EAAE,EAAiB;IAChD,MAAM,KAAK,GAAG,EAAE,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAClE,MAAM,GAAG,GAAG,EAAE,CAAC,6BAA6B,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5D,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,SAAS,OAAO,CAAC,IAAa,EAAE,EAAiB;IAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAEjC,uBAAuB;IACvB,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAChD,MAAM,OAAO,GAAsB,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QAClG,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,0CAA0C;IAC1C,IAAI,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/F,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACrE,OAAO,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,oBAAoB;IACpB,IAAI,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAsB,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QACrG,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC1C,IAAI,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC;oBAClD,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;gBACxD,CAAC;gBACD,IAAI,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC;oBACrD,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,wBAAwB;IACxB,IAAI,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,aAAa;IACb,IAAI,EAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,EAAE,WAAW,EAAE,eAAe,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,mBAAmB;IACnB,IAAI,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,qBAAqB;IACrB,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtD,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC;QACjC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,mBAAmB,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,IAAI,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC5C,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;YAC7D,CAAC;YACD,IAAI,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC/C,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,qBAAqB,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC;IAED,eAAe;IACf,IAAI,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,gBAAgB;IAChB,IAAI,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,gBAAgB;IAChB,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3D,OAAO,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,QAAQ;IACR,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,WAAW;IACX,IAAI,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,YAAY;IACZ,IAAI,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAsB,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QAC/E,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,SAAS;IACT,IAAI,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,QAAQ;IACR,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,SAAS;IACT,IAAI,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,mBAAmB;IACnB,IAAI,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,iBAAiB;IACjB,IAAI,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,EAAE,WAAW,EAAE,iBAAiB,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,iBAAiB;IACjB,IAAI,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,EAAE,WAAW,EAAE,mBAAmB,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,IAA4B;IACpD,MAAM,SAAS,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC;AAChF,CAAC"}

package/dist/core/translation/prompt-builder.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Prompt Builder — generates structured LLM prompts for code translation.
+ *
+ * 4 prompt types:
+ * - mapping: analyze constructs and determine best mapping strategy
+ * - translation: full code translation with construct context
+ * - syntactic repair: fix syntax errors in generated code
+ * - semantic repair: fix semantic issues preserving meaning
+ */
+import type { TranslationScore, AmbiguityReport } from "./ucr/construct-types.js";
+export interface PromptContext {
+    sourceLanguage: string;
+    targetLanguage: string;
+    sourceCode: string;
+    scores: TranslationScore[];
+    ambiguities: AmbiguityReport[];
+}
+/**
+ * Build a mapping prompt — asks the LLM to analyze constructs and choose mappings.
+ */
+export declare function buildMappingPrompt(ctx: PromptContext): string;
+/**
+ * Build a full translation prompt — asks the LLM to translate the code.
+ */
+export declare function buildTranslationPrompt(ctx: PromptContext): string;
+/**
+ * Build a syntactic repair prompt — fix syntax errors in generated code.
+ */
+export declare function buildSyntacticRepairPrompt(ctx: PromptContext, brokenCode: string, errors: string[]): string;
+/**
+ * Build a semantic repair prompt — fix semantic issues preserving meaning.
+ */
+export declare function buildSemanticRepairPrompt(ctx: PromptContext, targetCode: string, issues: string[]): string;
+//# sourceMappingURL=prompt-builder.d.ts.map

package/dist/core/translation/prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../../../src/core/translation/prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAElF,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,WAAW,EAAE,eAAe,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAmC7D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAkDjE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EAAE,GACf,MAAM,CAkBR;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EAAE,GACf,MAAM,CAuBR"}

package/dist/core/translation/prompt-builder.js

@@ -0,0 +1,137 @@
+/**
+ * Prompt Builder — generates structured LLM prompts for code translation.
+ *
+ * 4 prompt types:
+ * - mapping: analyze constructs and determine best mapping strategy
+ * - translation: full code translation with construct context
+ * - syntactic repair: fix syntax errors in generated code
+ * - semantic repair: fix semantic issues preserving meaning
+ */
+/**
+ * Build a mapping prompt — asks the LLM to analyze constructs and choose mappings.
+ */
+export function buildMappingPrompt(ctx) {
+    const sections = [
+        `## Construct Mapping Analysis`,
+        ``,
+        `**Source language**: ${ctx.sourceLanguage}`,
+        `**Target language**: ${ctx.targetLanguage}`,
+        ``,
+        `### Detected Constructs`,
+        ``,
+        formatScoresTable(ctx.scores),
+    ];
+    if (ctx.ambiguities.length > 0) {
+        sections.push(``, `### Ambiguities Requiring Decision`, ``);
+        for (const amb of ctx.ambiguities) {
+            sections.push(`- **${amb.canonicalName}** (${amb.ambiguityType}): ${amb.candidates.length} candidates`);
+            for (const c of amb.candidates) {
+                sections.push(`  - ${c.tradeoff} (confidence: ${c.confidence})`);
+            }
+            if (amb.recommendation) {
+                sections.push(`  → Recommendation: ${amb.recommendation}`);
+            }
+        }
+    }
+    sections.push(``, `### Instructions`, `For each construct above, confirm or override the selected mapping.`, `For ambiguous constructs, justify your choice.`);
+    return sections.join("\n");
+}
+/**
+ * Build a full translation prompt — asks the LLM to translate the code.
+ */
+export function buildTranslationPrompt(ctx) {
+    const deterministicCount = ctx.scores.filter((s) => !s.needsAiAssist).length;
+    const aiAssistCount = ctx.scores.filter((s) => s.needsAiAssist).length;
+    const sections = [
+        `## Code Translation: ${ctx.sourceLanguage} → ${ctx.targetLanguage}`,
+        ``,
+        `### Source Code`,
+        "```" + ctx.sourceLanguage,
+        ctx.sourceCode,
+        "```",
+        ``,
+        `### Construct Analysis`,
+        `- **Deterministic mappings**: ${deterministicCount} (high confidence, direct translation)`,
+        `- **AI-assisted mappings**: ${aiAssistCount} (require judgment)`,
+        ``,
+        formatScoresTable(ctx.scores),
+    ];
+    if (aiAssistCount > 0) {
+        sections.push(``, `### Constructs Requiring AI Judgment`);
+        for (const score of ctx.scores.filter((s) => s.needsAiAssist)) {
+            sections.push(`- **${score.constructId}** (confidence: ${score.finalConfidence.toFixed(2)})`);
+            if (score.alternatives.length > 0) {
+                for (const alt of score.alternatives) {
+                    sections.push(`  - Alternative: ${alt.reason} (${alt.confidence})`);
+                }
+            }
+        }
+    }
+    if (ctx.ambiguities.length > 0) {
+        sections.push(``, `### Ambiguity Warnings`);
+        for (const amb of ctx.ambiguities) {
+            sections.push(`- **${amb.canonicalName}**: ${amb.ambiguityType} — ${amb.recommendation ?? "review needed"}`);
+        }
+    }
+    sections.push(``, `### Instructions`, `Translate the source code to ${ctx.targetLanguage}.`, `Use the construct mappings above. For AI-assisted constructs, choose the best mapping.`, `Preserve semantics, follow ${ctx.targetLanguage} conventions (naming, idioms).`, `Return ONLY the translated code.`);
+    return sections.join("\n");
+}
+/**
+ * Build a syntactic repair prompt — fix syntax errors in generated code.
+ */
+export function buildSyntacticRepairPrompt(ctx, brokenCode, errors) {
+    return [
+        `## Syntactic Repair: ${ctx.targetLanguage}`,
+        ``,
+        `The following ${ctx.targetLanguage} code has syntax errors. Fix them while preserving the intended logic.`,
+        ``,
+        `### Code with Errors`,
+        "```" + ctx.targetLanguage,
+        brokenCode,
+        "```",
+        ``,
+        `### Errors`,
+        ...errors.map((e) => `- ${e}`),
+        ``,
+        `### Instructions`,
+        `Fix ONLY the syntax errors. Do not change logic or structure.`,
+        `Return the corrected code.`,
+    ].join("\n");
+}
+/**
+ * Build a semantic repair prompt — fix semantic issues preserving meaning.
+ */
+export function buildSemanticRepairPrompt(ctx, targetCode, issues) {
+    return [
+        `## Semantic Repair: ${ctx.sourceLanguage} → ${ctx.targetLanguage}`,
+        ``,
+        `The translated code has semantic issues — it may not preserve the original behavior.`,
+        ``,
+        `### Original Source (${ctx.sourceLanguage})`,
+        "```" + ctx.sourceLanguage,
+        ctx.sourceCode,
+        "```",
+        ``,
+        `### Current Translation (${ctx.targetLanguage})`,
+        "```" + ctx.targetLanguage,
+        targetCode,
+        "```",
+        ``,
+        `### Semantic Issues`,
+        ...issues.map((i) => `- ${i}`),
+        ``,
+        `### Instructions`,
+        `Fix the semantic issues to ensure the ${ctx.targetLanguage} code behaves identically to the ${ctx.sourceLanguage} source.`,
+        `Return the corrected code.`,
+    ].join("\n");
+}
+function formatScoresTable(scores) {
+    if (scores.length === 0)
+        return "_No constructs detected._";
+    const lines = ["| Construct | Confidence | AI Assist |", "|-----------|------------|-----------|"];
+    for (const s of scores) {
+        lines.push(`| ${s.constructId} | ${s.finalConfidence.toFixed(2)} | ${s.needsAiAssist ? "Yes" : "No"} |`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=prompt-builder.js.map

package/dist/core/translation/prompt-builder.js.map

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