@mcp-graph-workflow/mcp-graph 5.22.0 → 5.25.0

package/dist/core/translation/pre-indexed-analyzer.js

@@ -0,0 +1,100 @@
+/**
+ * Pre-indexed Analysis — leverages Code Intelligence symbol table
+ * to provide instant translation analysis for already-indexed files.
+ *
+ * Maps code intelligence symbol kinds to UCR constructs:
+ * function → uc_fn_def, class → uc_class_def, interface → uc_interface, etc.
+ */
+import { logger } from "../utils/logger.js";
+/** Map Code Intelligence symbol kind → UCR construct ID */
+const KIND_TO_CONSTRUCT = {
+    function: "uc_fn_def",
+    method: "uc_fn_def",
+    class: "uc_class_def",
+    interface: "uc_interface",
+    enum: "uc_type_enum",
+    variable: "uc_var_const",
+    type: "uc_type_alias",
+    property: "uc_fn_def",
+};
+/** File extension → detected language */
+const EXT_TO_LANGUAGE = {
+    ".ts": "typescript",
+    ".tsx": "typescript",
+    ".js": "javascript",
+    ".jsx": "javascript",
+    ".py": "python",
+    ".java": "java",
+    ".go": "go",
+    ".rs": "rust",
+    ".cs": "csharp",
+    ".rb": "ruby",
+    ".php": "php",
+    ".swift": "swift",
+    ".kt": "kotlin",
+    ".scala": "scala",
+    ".lua": "lua",
+    ".cpp": "cpp",
+    ".cc": "cpp",
+    ".c": "c",
+    ".dart": "dart",
+};
+/**
+ * Try to build a TranslationAnalysis from the Code Intelligence index.
+ * Returns null if the file is not indexed or the index is stale.
+ */
+export function analyzeFromIndex(codeStore, projectId, filePath) {
+    try {
+        const meta = codeStore.getIndexMeta(projectId);
+        if (!meta)
+            return null;
+        // Get symbols for this specific file
+        const allSymbols = codeStore.getAllSymbols(projectId, 10000);
+        const fileSymbols = allSymbols.filter((s) => s.file === filePath);
+        if (fileSymbols.length === 0)
+            return null;
+        // Detect language from file extension
+        const parts = filePath.split(".");
+        const ext = parts.length > 1 ? "." + parts[parts.length - 1].toLowerCase() : "";
+        const detectedLanguage = EXT_TO_LANGUAGE[ext] ?? "unknown";
+        // Map symbols to constructs
+        const constructCounts = new Map();
+        for (const sym of fileSymbols) {
+            const constructId = KIND_TO_CONSTRUCT[sym.kind];
+            if (constructId) {
+                constructCounts.set(constructId, (constructCounts.get(constructId) ?? 0) + 1);
+            }
+        }
+        const constructs = Array.from(constructCounts.entries()).map(([canonicalName, count]) => ({
+            canonicalName,
+            count,
+            confidence: 0.9, // slightly lower than direct parsing since we're mapping kinds
+        }));
+        const totalConstructs = constructs.reduce((sum, c) => sum + c.count, 0);
+        const uniqueConstructs = constructs.length;
+        const complexityScore = Math.min(uniqueConstructs / 15, 1);
+        const analysis = {
+            detectedLanguage,
+            detectedConfidence: 1.0, // file extension is definitive
+            constructs,
+            complexityScore,
+            estimatedTranslatability: totalConstructs > 0 ? 0.95 : 0,
+            ambiguousConstructs: [],
+            totalConstructs,
+        };
+        logger.debug("pre-indexed-analysis", {
+            file: filePath,
+            language: detectedLanguage,
+            symbols: fileSymbols.length,
+            constructs: totalConstructs,
+        });
+        return { analysis, fromIndex: true };
+    }
+    catch (err) {
+        logger.debug("pre-indexed-analysis:failed", {
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return null;
+    }
+}
+//# sourceMappingURL=pre-indexed-analyzer.js.map

package/dist/core/translation/pre-indexed-analyzer.js.map

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

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

@@ -14,6 +14,8 @@ export interface PromptContext {
     sourceCode: string;
     scores: TranslationScore[];
     ambiguities: AmbiguityReport[];
+    /** Max prompt token budget (default: 8000). */
+    maxPromptTokens?: number;
 }
 /**
  * Build a mapping prompt — asks the LLM to analyze constructs and choose mappings.

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

@@ -1 +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"}
+{"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;AASlF,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;IAC/B,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAmC7D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAiGjE;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

@@ -7,6 +7,11 @@
  * - syntactic repair: fix syntax errors in generated code
  * - semantic repair: fix semantic issues preserving meaning
  */
+import { estimateTokens } from "../context/token-estimator.js";
+/** Default max prompt token budget (~32KB). */
+const DEFAULT_MAX_PROMPT_TOKENS = 8000;
+/** Max constructs to show in the table when truncating. */
+const MAX_CONSTRUCTS_ON_TRUNCATE = 20;
 /**
  * Build a mapping prompt — asks the LLM to analyze constructs and choose mappings.
  */
@@ -24,7 +29,7 @@ export function buildMappingPrompt(ctx) {
     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`);
+            sections.push(`- **${amb.canonicalName ?? amb.constructId}** (${amb.ambiguityType}): ${amb.candidates.length} candidates`);
             for (const c of amb.candidates) {
                 sections.push(`  - ${c.tradeoff} (confidence: ${c.confidence})`);
             }
@@ -40,25 +45,39 @@ export function buildMappingPrompt(ctx) {
  * 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 maxTokens = ctx.maxPromptTokens ?? DEFAULT_MAX_PROMPT_TOKENS;
+    let truncated = false;
+    // Possibly truncate scores to top N by count (we don't have count here, so limit by total)
+    let effectiveScores = ctx.scores;
+    if (effectiveScores.length > MAX_CONSTRUCTS_ON_TRUNCATE) {
+        // Sort by finalConfidence desc, keep top N
+        effectiveScores = [...effectiveScores]
+            .sort((a, b) => b.finalConfidence - a.finalConfidence)
+            .slice(0, MAX_CONSTRUCTS_ON_TRUNCATE);
+        truncated = true;
+    }
+    const deterministicCount = effectiveScores.filter((s) => !s.needsAiAssist).length;
+    const aiAssistCount = effectiveScores.filter((s) => s.needsAiAssist).length;
+    // Possibly truncate source code to fit budget
+    let sourceBlock = ctx.sourceCode;
+    const sourceLines = ctx.sourceCode.split("\n");
     const sections = [
         `## Code Translation: ${ctx.sourceLanguage} → ${ctx.targetLanguage}`,
         ``,
         `### Source Code`,
         "```" + ctx.sourceLanguage,
-        ctx.sourceCode,
+        sourceBlock,
         "```",
         ``,
         `### Construct Analysis`,
         `- **Deterministic mappings**: ${deterministicCount} (high confidence, direct translation)`,
         `- **AI-assisted mappings**: ${aiAssistCount} (require judgment)`,
         ``,
-        formatScoresTable(ctx.scores),
+        formatScoresTable(effectiveScores),
     ];
     if (aiAssistCount > 0) {
         sections.push(``, `### Constructs Requiring AI Judgment`);
-        for (const score of ctx.scores.filter((s) => s.needsAiAssist)) {
+        for (const score of effectiveScores.filter((s) => s.needsAiAssist)) {
             sections.push(`- **${score.constructId}** (confidence: ${score.finalConfidence.toFixed(2)})`);
             if (score.alternatives.length > 0) {
                 for (const alt of score.alternatives) {
@@ -70,11 +89,40 @@ export function buildTranslationPrompt(ctx) {
     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"}`);
+            const name = amb.canonicalName ?? amb.constructId;
+            sections.push(`- **${name}**: ${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");
+    // Check token budget — if over, truncate source code block
+    let result = sections.join("\n");
+    if (estimateTokens(result) > maxTokens) {
+        // Binary search for max lines that fit within budget
+        let lo = 1;
+        let hi = sourceLines.length;
+        while (lo < hi) {
+            const mid = Math.ceil((lo + hi) / 2);
+            const candidate = sourceLines.slice(0, mid).join("\n")
+                + `\n... [truncated — showing first ${mid} lines of ${sourceLines.length} total]`;
+            sections[4] = candidate; // replace source code block content
+            const candidateResult = sections.join("\n");
+            if (estimateTokens(candidateResult) <= maxTokens) {
+                lo = mid;
+            }
+            else {
+                hi = mid - 1;
+            }
+        }
+        sourceBlock = sourceLines.slice(0, lo).join("\n")
+            + `\n... [truncated — showing first ${lo} lines of ${sourceLines.length} total]`;
+        sections[4] = sourceBlock;
+        truncated = true;
+        result = sections.join("\n");
+    }
+    if (truncated) {
+        result += `\n<!-- truncated: true -->`;
+    }
+    return result;
 }
 /**
  * Build a syntactic repair prompt — fix syntax errors in generated code.

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * Prompt Paginator — splits large translation prompts into numbered pages.
+ *
+ * When a prompt exceeds the token budget (default 8K tokens), it splits
+ * at natural boundaries (code sections) and returns paginated results.
+ * Each page is self-contained with construct context header.
+ */
+export interface PromptPage {
+    content: string;
+    currentPage: number;
+    totalPages: number;
+    tokenEstimate: number;
+    truncated: boolean;
+}
+/**
+ * Paginate a prompt if it exceeds the token budget.
+ * Returns a single page if within budget (no pagination needed).
+ */
+export declare function paginatePrompt(prompt: string, pageTokenBudget?: number, requestedPage?: number): PromptPage;
+//# sourceMappingURL=prompt-paginator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-paginator.d.ts","sourceRoot":"","sources":["../../../src/core/translation/prompt-paginator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,eAAe,GAAE,MAAkC,EACnD,aAAa,GAAE,MAAU,GACxB,UAAU,CAoCZ"}

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

@@ -0,0 +1,108 @@
+/**
+ * Prompt Paginator — splits large translation prompts into numbered pages.
+ *
+ * When a prompt exceeds the token budget (default 8K tokens), it splits
+ * at natural boundaries (code sections) and returns paginated results.
+ * Each page is self-contained with construct context header.
+ */
+import { estimateTokens } from "../context/token-estimator.js";
+import { logger } from "../utils/logger.js";
+const DEFAULT_PAGE_TOKEN_BUDGET = 8000;
+/**
+ * Paginate a prompt if it exceeds the token budget.
+ * Returns a single page if within budget (no pagination needed).
+ */
+export function paginatePrompt(prompt, pageTokenBudget = DEFAULT_PAGE_TOKEN_BUDGET, requestedPage = 1) {
+    const totalTokens = estimateTokens(prompt);
+    // If within budget, return as single page
+    if (totalTokens <= pageTokenBudget) {
+        return {
+            content: prompt,
+            currentPage: 1,
+            totalPages: 1,
+            tokenEstimate: totalTokens,
+            truncated: false,
+        };
+    }
+    // Split prompt into sections at markdown headers or code block boundaries
+    const sections = splitPromptSections(prompt);
+    const pages = buildPages(sections, pageTokenBudget);
+    const totalPages = pages.length;
+    const pageIndex = Math.max(0, Math.min(requestedPage - 1, totalPages - 1));
+    const page = pages[pageIndex];
+    logger.debug("prompt:paginated", {
+        totalTokens,
+        totalPages,
+        requestedPage,
+        pageTokens: estimateTokens(page),
+    });
+    return {
+        content: page,
+        currentPage: pageIndex + 1,
+        totalPages,
+        tokenEstimate: estimateTokens(page),
+        truncated: true,
+    };
+}
+/**
+ * Split a prompt into logical sections (headers, code blocks, tables).
+ */
+function splitPromptSections(prompt) {
+    const sections = [];
+    const lines = prompt.split("\n");
+    let current = [];
+    for (const line of lines) {
+        // Split at markdown headers (##, ###)
+        if (/^#{2,3}\s/.test(line) && current.length > 0) {
+            sections.push(current.join("\n"));
+            current = [];
+        }
+        current.push(line);
+    }
+    if (current.length > 0) {
+        sections.push(current.join("\n"));
+    }
+    return sections;
+}
+/**
+ * Build pages from sections, respecting token budget per page.
+ * First section (header/metadata) is included in every page.
+ */
+function buildPages(sections, pageTokenBudget) {
+    if (sections.length === 0)
+        return [""];
+    if (sections.length === 1)
+        return [sections[0]];
+    const header = sections[0]; // Always include first section as context
+    const headerTokens = estimateTokens(header);
+    const availablePerPage = pageTokenBudget - headerTokens - 100; // 100 tokens for pagination metadata
+    const pages = [];
+    let currentPageSections = [];
+    let currentTokens = 0;
+    for (let i = 1; i < sections.length; i++) {
+        const sectionTokens = estimateTokens(sections[i]);
+        if (currentTokens + sectionTokens > availablePerPage && currentPageSections.length > 0) {
+            // Flush current page
+            const pageNum = pages.length + 1;
+            const pageHeader = `${header}\n\n_Page ${pageNum} of translation prompt_\n`;
+            pages.push(pageHeader + currentPageSections.join("\n\n"));
+            currentPageSections = [];
+            currentTokens = 0;
+        }
+        currentPageSections.push(sections[i]);
+        currentTokens += sectionTokens;
+    }
+    // Flush remaining
+    if (currentPageSections.length > 0) {
+        const pageNum = pages.length + 1;
+        const pageHeader = `${header}\n\n_Page ${pageNum} of translation prompt_\n`;
+        pages.push(pageHeader + currentPageSections.join("\n\n"));
+    }
+    // If everything fit in one page, return as-is
+    if (pages.length === 0) {
+        return [sections.join("\n\n")];
+    }
+    // Update total pages count in each page
+    return pages.map((p) => p.replace(/Page (\d+) of translation prompt/, `Page $1 of ${pages.length} — translation prompt`));
+}
+//# sourceMappingURL=prompt-paginator.js.map

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

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

package/dist/core/translation/translation-orchestrator.d.ts

@@ -5,6 +5,7 @@
  */
 import { ConstructRegistry } from "./ucr/construct-registry.js";
 import { TranslationStore } from "./translation-store.js";
+import type { CodeStore } from "../code/code-store.js";
 import type { TranslationAnalysis, TranslationScope } from "./translation-types.js";
 interface AnalyzeHints {
     languageHint?: string;
@@ -49,11 +50,17 @@ interface FinalizeResult {
 export declare class TranslationOrchestrator {
     private readonly registry;
     private readonly store;
-    constructor(registry: ConstructRegistry, store: TranslationStore);
+    private readonly codeStore?;
+    constructor(registry: ConstructRegistry, store: TranslationStore, codeStore?: CodeStore | undefined);
     /**
      * Analyze source code — detect language, identify constructs, compute complexity.
+     * Results are cached with SHA-256 content hash (TTL 60min, max 100 entries).
+     * When filePath + projectId are provided and Code Intelligence has indexed the file,
+     * uses pre-indexed analysis (instant, zero parsing cost).
      */
-    analyzeSource(code: string, hints?: AnalyzeHints): TranslationAnalysis;
+    analyzeSource(code: string, hints?: AnalyzeHints, filePath?: string, projectId?: string): TranslationAnalysis & {
+        cacheHit: boolean;
+    };
     /**
      * Prepare a translation job — creates the job, analyzes source, builds prompt.
      */

package/dist/core/translation/translation-orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translation-orchestrator.d.ts","sourceRoot":"","sources":["../../../src/core/translation/translation-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAkB,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAYpG,UAAU,YAAY;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChF,KAAK,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,UAAU,cAAc;IACtB,GAAG,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,QAAQ,EAAE,YAAY,CAAC;CACxB;AAOD,qBAAa,uBAAuB;IAEhC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,gBAAgB;IAG1C;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,mBAAmB;IA8DtE;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa;IAyCtD;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,cAAc;CAkD1E"}
+{"version":3,"file":"translation-orchestrator.d.ts","sourceRoot":"","sources":["../../../src/core/translation/translation-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EAAE,mBAAmB,EAAkB,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAqEpG,UAAU,YAAY;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChF,KAAK,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,UAAU,cAAc;IACtB,GAAG,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,QAAQ,EAAE,YAAY,CAAC;CACxB;AAqBD,qBAAa,uBAAuB;IAEhC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAFV,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,gBAAgB,EACvB,SAAS,CAAC,EAAE,SAAS,YAAA;IAGxC;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,mBAAmB,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE;IAqFrI;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa;IA+CtD;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,cAAc;CAkD1E"}

package/dist/core/translation/translation-orchestrator.js

@@ -3,28 +3,111 @@
  *
  * Flow: analyzeSource → prepareTranslation → (AI generates code) → finalizeTranslation
  */
+import { createHash } from "node:crypto";
+import { analyzeFromIndex } from "./pre-indexed-analyzer.js";
 import { detectLanguageFromCode } from "./language-detect.js";
 import { TsParserAdapter } from "./parsers/ts-parser-adapter.js";
 import { PythonParserAdapter } from "./parsers/python-parser-adapter.js";
+import { JavaParserAdapter } from "./parsers/java-parser-adapter.js";
+import { GoParserAdapter } from "./parsers/go-parser-adapter.js";
+import { CSharpParserAdapter } from "./parsers/csharp-parser-adapter.js";
+import { RustParserAdapter } from "./parsers/rust-parser-adapter.js";
+import { RubyParserAdapter } from "./parsers/ruby-parser-adapter.js";
+import { PhpParserAdapter } from "./parsers/php-parser-adapter.js";
+import { SwiftParserAdapter } from "./parsers/swift-parser-adapter.js";
+import { KotlinParserAdapter } from "./parsers/kotlin-parser-adapter.js";
+import { ScalaParserAdapter } from "./parsers/scala-parser-adapter.js";
+import { ElixirParserAdapter } from "./parsers/elixir-parser-adapter.js";
+import { DartParserAdapter } from "./parsers/dart-parser-adapter.js";
+import { HaskellParserAdapter } from "./parsers/haskell-parser-adapter.js";
+import { CppParserAdapter } from "./parsers/cpp-parser-adapter.js";
+import { LuaParserAdapter } from "./parsers/lua-parser-adapter.js";
 import { scoreConstructs } from "./confidence/equivalence-scorer.js";
 import { detectAmbiguities } from "./confidence/ambiguity-detector.js";
 import { buildTranslationPrompt } from "./prompt-builder.js";
 import { TranslationError } from "../utils/errors.js";
+/**
+ * Mapping of equivalent constructs across languages.
+ * When source construct X translates to target construct Y,
+ * both are valid equivalents and should not be flagged as risk.
+ */
+const EQUIVALENT_CONSTRUCTS = new Map([
+    ["uc_for_each", "uc_for_loop"],
+    ["uc_for_loop", "uc_for_each"],
+    ["uc_fn_def", "uc_arrow_fn"],
+    ["uc_arrow_fn", "uc_fn_def"],
+]);
+// ── Analysis Cache (LRU, SHA-256 keyed) ────────────
+const ANALYSIS_CACHE_TTL_MS = 3_600_000; // 60 minutes
+const ANALYSIS_CACHE_MAX_ENTRIES = 100;
+const analysisCache = new Map();
+function computeCacheKey(code, targetLanguage) {
+    return createHash("sha256")
+        .update(code + "|" + (targetLanguage ?? ""))
+        .digest("hex");
+}
+function evictOldestIfNeeded() {
+    if (analysisCache.size <= ANALYSIS_CACHE_MAX_ENTRIES)
+        return;
+    let oldestKey;
+    let oldestTs = Infinity;
+    for (const [key, entry] of analysisCache) {
+        if (entry.timestamp < oldestTs) {
+            oldestTs = entry.timestamp;
+            oldestKey = key;
+        }
+    }
+    if (oldestKey)
+        analysisCache.delete(oldestKey);
+}
 const PARSERS = new Map([
     ["typescript", new TsParserAdapter()],
     ["python", new PythonParserAdapter()],
+    ["java", new JavaParserAdapter()],
+    ["go", new GoParserAdapter()],
+    ["csharp", new CSharpParserAdapter()],
+    ["rust", new RustParserAdapter()],
+    ["ruby", new RubyParserAdapter()],
+    ["php", new PhpParserAdapter()],
+    ["swift", new SwiftParserAdapter()],
+    ["kotlin", new KotlinParserAdapter()],
+    ["scala", new ScalaParserAdapter()],
+    ["elixir", new ElixirParserAdapter()],
+    ["dart", new DartParserAdapter()],
+    ["haskell", new HaskellParserAdapter()],
+    ["cpp", new CppParserAdapter()],
+    ["lua", new LuaParserAdapter()],
 ]);
 export class TranslationOrchestrator {
     registry;
     store;
-    constructor(registry, store) {
+    codeStore;
+    constructor(registry, store, codeStore) {
         this.registry = registry;
         this.store = store;
+        this.codeStore = codeStore;
     }
     /**
      * Analyze source code — detect language, identify constructs, compute complexity.
+     * Results are cached with SHA-256 content hash (TTL 60min, max 100 entries).
+     * When filePath + projectId are provided and Code Intelligence has indexed the file,
+     * uses pre-indexed analysis (instant, zero parsing cost).
      */
-    analyzeSource(code, hints) {
+    analyzeSource(code, hints, filePath, projectId) {
+        // Try pre-indexed analysis (Layer 5) when file context is available
+        if (filePath && projectId && this.codeStore) {
+            const preIndexed = analyzeFromIndex(this.codeStore, projectId, filePath);
+            if (preIndexed) {
+                const result = { ...preIndexed.analysis, cacheHit: false };
+                return result;
+            }
+        }
+        // Check cache
+        const cacheKey = computeCacheKey(code, hints?.targetLanguage);
+        const cached = analysisCache.get(cacheKey);
+        if (cached && Date.now() - cached.timestamp < ANALYSIS_CACHE_TTL_MS) {
+            return { ...cached.result, cacheHit: true };
+        }
         // Detect language
         const detection = detectLanguageFromCode(code);
         const lang = hints?.languageHint ?? detection.languageId;
@@ -68,7 +151,7 @@ export class TranslationOrchestrator {
         const estimatedTranslatability = scores.length > 0
             ? scores.reduce((sum, s) => sum + s.finalConfidence, 0) / scores.length
             : 0;
-        return {
+        const result = {
             detectedLanguage: lang,
             detectedConfidence: confidence,
             constructs,
@@ -76,13 +159,19 @@ export class TranslationOrchestrator {
             estimatedTranslatability,
             ambiguousConstructs: ambiguities.map((a) => a.constructId),
             totalConstructs: parsed.length,
+            cacheHit: false,
         };
+        // Store in cache
+        analysisCache.set(cacheKey, { result, timestamp: Date.now() });
+        evictOldestIfNeeded();
+        return result;
     }
     /**
      * Prepare a translation job — creates the job, analyzes source, builds prompt.
      */
     prepareTranslation(input) {
-        const analysis = this.analyzeSource(input.sourceCode, {
+        const sourceCode = input.sourceCode ?? "";
+        const analysis = this.analyzeSource(sourceCode, {
             languageHint: input.sourceLanguage,
             targetLanguage: input.targetLanguage,
         });
@@ -91,7 +180,7 @@ export class TranslationOrchestrator {
             projectId: input.projectId,
             sourceLanguage: analysis.detectedLanguage,
             targetLanguage: input.targetLanguage,
-            sourceCode: input.sourceCode,
+            sourceCode,
             scope: input.scope,
         });
         // Update to analyzing status
@@ -100,17 +189,21 @@ export class TranslationOrchestrator {
             analysis: analysis,
         });
         // Build scores + ambiguities for prompt
+        // Guard: if registry has no seed data, scoreConstructs returns [] safely
         const parser = PARSERS.get(analysis.detectedLanguage);
-        const parsed = parser ? parser.parseSnippet(input.sourceCode) : [];
-        const constructIds = [...new Set(parsed.map((p) => p.constructId))];
+        const parsed = parser ? parser.parseSnippet(sourceCode) : [];
+        const constructIds = [...new Set(parsed.map((p) => p.constructId))].filter(Boolean);
         const scores = scoreConstructs(this.registry, constructIds, analysis.detectedLanguage, input.targetLanguage);
         const ambiguities = detectAmbiguities(scores, this.registry, analysis.detectedLanguage, input.targetLanguage);
+        // Filter out scores/ambiguities with undefined construct data
+        const safeScores = scores.filter((s) => s.constructId != null);
+        const safeAmbiguities = ambiguities.filter((a) => a.constructId != null && a.canonicalName != null);
         const promptCtx = {
             sourceLanguage: analysis.detectedLanguage,
             targetLanguage: input.targetLanguage,
-            sourceCode: input.sourceCode,
-            scores,
-            ambiguities,
+            sourceCode,
+            scores: safeScores,
+            ambiguities: safeAmbiguities,
         };
         const prompt = buildTranslationPrompt(promptCtx);
         return { jobId: job.id, prompt, analysis };
@@ -175,12 +268,19 @@ function buildEvidence(source, target, sourceLang, targetLang) {
             translated.push({ source: id, target: id, method: "direct" });
         }
         else {
-            risks.push({
-                construct: id,
-                severity: "medium",
-                message: `${id} from ${sourceLang} has no direct equivalent detected in ${targetLang} output`,
-            });
-            reviewPoints.push(`Review mapping of ${id}`);
+            // Check if an equivalent construct exists in target (e.g. uc_for_each ↔ uc_for_loop)
+            const equivalent = EQUIVALENT_CONSTRUCTS.get(id);
+            if (equivalent && targetIds.has(equivalent)) {
+                translated.push({ source: id, target: equivalent, method: "equivalent" });
+            }
+            else {
+                risks.push({
+                    construct: id,
+                    severity: "medium",
+                    message: `${id} from ${sourceLang} has no direct equivalent detected in ${targetLang} output`,
+                });
+                reviewPoints.push(`Review mapping of ${id}`);
+            }
         }
     }
     // Coverage-based confidence