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

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

@@ -0,0 +1,86 @@
+import { z } from "zod/v4";
+// --- Translation Job Status ---
+export const TranslationJobStatusSchema = z.enum([
+    "pending", "analyzing", "translating", "validating", "done", "failed",
+]);
+// --- Translation Scope ---
+export const TranslationScopeSchema = z.enum(["snippet", "function", "module"]);
+// --- Translation Job ---
+export const TranslationJobSchema = z.object({
+    id: z.string(),
+    projectId: z.string(),
+    sourceLanguage: z.string(),
+    targetLanguage: z.string(),
+    sourceCode: z.string(),
+    targetCode: z.string().optional(),
+    status: TranslationJobStatusSchema,
+    scope: TranslationScopeSchema,
+    constraints: z.record(z.string(), z.unknown()).optional(),
+    confidenceScore: z.number().min(0).max(1).optional(),
+    warnings: z.array(z.string()).optional(),
+    errorMessage: z.string().optional(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+});
+// --- Translation Construct Info (per-construct in analysis) ---
+export const TranslationConstructInfoSchema = z.object({
+    canonicalName: z.string(),
+    count: z.number().int().min(0),
+    confidence: z.number().min(0).max(1),
+});
+// --- Translation Analysis ---
+export const TranslationAnalysisSchema = z.object({
+    detectedLanguage: z.string(),
+    detectedConfidence: z.number().min(0).max(1).optional(),
+    constructs: z.array(TranslationConstructInfoSchema),
+    complexityScore: z.number().min(0).max(1),
+    estimatedTranslatability: z.number().min(0).max(1),
+    ambiguousConstructs: z.array(z.string()).optional(),
+    totalConstructs: z.number().int().min(0),
+});
+// --- Translation Metrics ---
+export const TranslationMetricsSchema = z.object({
+    parseSuccess: z.boolean(),
+    lintSuccess: z.boolean(),
+    typeCheckSuccess: z.boolean(),
+    ruleCoverage: z.number().min(0).max(1),
+    templateCoverage: z.number().min(0).max(1),
+    llmInterventions: z.number().int().min(0),
+    tokensConsumed: z.number().int().min(0),
+    totalTimeMs: z.number().int().min(0),
+});
+// --- Translation Mapping Report (per-construct in result) ---
+export const TranslationMappingReportSchema = z.object({
+    sourceConstruct: z.string(),
+    targetConstruct: z.string(),
+    method: z.enum(["rule", "template", "llm"]),
+    confidence: z.number().min(0).max(1),
+});
+// --- Translation Result ---
+export const TranslationResultSchema = z.object({
+    targetCode: z.string(),
+    mappingReport: z.array(TranslationMappingReportSchema),
+    warnings: z.array(z.string()),
+    confidenceScore: z.number().min(0).max(1),
+    repairIterations: z.number().int().min(0),
+    metrics: TranslationMetricsSchema,
+});
+// --- Evidence Pack ---
+export const EvidenceTranslatedConstructSchema = z.object({
+    source: z.string(),
+    target: z.string(),
+    method: z.enum(["rule", "template", "llm"]),
+});
+export const EvidenceRiskSchema = z.object({
+    construct: z.string(),
+    severity: z.enum(["low", "medium", "high"]),
+    message: z.string(),
+});
+export const EvidencePackSchema = z.object({
+    diff: z.string(),
+    translatedConstructs: z.array(EvidenceTranslatedConstructSchema),
+    risks: z.array(EvidenceRiskSchema),
+    confidenceScore: z.number().min(0).max(1),
+    humanReviewPoints: z.array(z.string()),
+});
+//# sourceMappingURL=translation-types.js.map

package/dist/core/translation/translation-types.js.map

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

package/dist/core/translation/ucr/construct-registry.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Universal Construct Registry — SQLite CRUD + queries.
+ * Uses the shared Database instance from SqliteStore.
+ */
+import type Database from "better-sqlite3";
+import type { UcrCategory, UcrConstruct, UcrLanguageMapping, UcrSeedData } from "./construct-types.js";
+export interface TranslationPathResult {
+    sourceMapping: UcrLanguageMapping;
+    targetMapping: UcrLanguageMapping;
+    confidence: number;
+    alternatives: UcrLanguageMapping[];
+}
+export interface SeedResult {
+    categories: number;
+    constructs: number;
+    mappings: number;
+}
+export declare class ConstructRegistry {
+    private readonly db;
+    constructor(db: Database.Database);
+    insertCategory(cat: UcrCategory): void;
+    getCategory(id: string): UcrCategory | null;
+    listCategories(): UcrCategory[];
+    insertConstruct(construct: UcrConstruct): void;
+    getConstruct(canonicalName: string): UcrConstruct | null;
+    getConstructById(id: string): UcrConstruct | null;
+    getConstructsByCategory(categoryId: string): UcrConstruct[];
+    searchConstructs(query: string): UcrConstruct[];
+    insertMapping(mapping: UcrLanguageMapping): void;
+    getMappings(constructId: string, languageId: string): UcrLanguageMapping[];
+    getPrimaryMapping(constructId: string, languageId: string): UcrLanguageMapping | null;
+    findTranslationPath(constructId: string, sourceLang: string, targetLang: string): TranslationPathResult | null;
+    updateConfidence(mappingId: string, delta: number): void;
+    seedFromJson(data: UcrSeedData): SeedResult;
+}
+//# sourceMappingURL=construct-registry.d.ts.map

package/dist/core/translation/ucr/construct-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"construct-registry.d.ts","sourceRoot":"","sources":["../../../../src/core/translation/ucr/construct-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAmE9B,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,kBAAkB,CAAC;IAClC,aAAa,EAAE,kBAAkB,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAID,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAIlD,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAOtC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAK3C,cAAc,IAAI,WAAW,EAAE;IAO/B,eAAe,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI;IAc9C,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAKxD,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAKjD,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE;IAK3D,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE;IAe/C,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAgBhD,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAS1E,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAYrF,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI;IAiB9G,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAUxD,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU;CA4B5C"}

package/dist/core/translation/ucr/construct-registry.js

@@ -0,0 +1,159 @@
+/**
+ * Universal Construct Registry — SQLite CRUD + queries.
+ * Uses the shared Database instance from SqliteStore.
+ */
+import { logger } from "../../utils/logger.js";
+// ── Mappers ──────────────────────────────────────────────
+function rowToCategory(row) {
+    return {
+        id: row.id,
+        name: row.name,
+        ...(row.description != null && { description: row.description }),
+    };
+}
+function rowToConstruct(row) {
+    return {
+        id: row.id,
+        categoryId: row.category_id,
+        canonicalName: row.canonical_name,
+        ...(row.description != null && { description: row.description }),
+        ...(row.semantic_group != null && { semanticGroup: row.semantic_group }),
+        ...(row.metadata != null && { metadata: JSON.parse(row.metadata) }),
+    };
+}
+function rowToMapping(row) {
+    return {
+        id: row.id,
+        constructId: row.construct_id,
+        languageId: row.language_id,
+        syntaxPattern: row.syntax_pattern,
+        ...(row.ast_node_type != null && { astNodeType: row.ast_node_type }),
+        confidence: row.confidence,
+        isPrimary: row.is_primary === 1,
+        ...(row.constraints != null && { constraints: JSON.parse(row.constraints) }),
+    };
+}
+// ── Registry class ───────────────────────────────────────
+export class ConstructRegistry {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    // ── Categories ──────────────────────────────────────────
+    insertCategory(cat) {
+        this.db.prepare(`
+      INSERT OR IGNORE INTO ucr_categories (id, name, description)
+      VALUES (?, ?, ?)
+    `).run(cat.id, cat.name, cat.description ?? null);
+    }
+    getCategory(id) {
+        const row = this.db.prepare("SELECT * FROM ucr_categories WHERE id = ?").get(id);
+        return row ? rowToCategory(row) : null;
+    }
+    listCategories() {
+        const rows = this.db.prepare("SELECT * FROM ucr_categories ORDER BY name").all();
+        return rows.map(rowToCategory);
+    }
+    // ── Constructs ──────────────────────────────────────────
+    insertConstruct(construct) {
+        this.db.prepare(`
+      INSERT OR IGNORE INTO ucr_constructs (id, category_id, canonical_name, description, semantic_group, metadata)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `).run(construct.id, construct.categoryId, construct.canonicalName, construct.description ?? null, construct.semanticGroup ?? null, construct.metadata ? JSON.stringify(construct.metadata) : null);
+    }
+    getConstruct(canonicalName) {
+        const row = this.db.prepare("SELECT * FROM ucr_constructs WHERE canonical_name = ?").get(canonicalName);
+        return row ? rowToConstruct(row) : null;
+    }
+    getConstructById(id) {
+        const row = this.db.prepare("SELECT * FROM ucr_constructs WHERE id = ?").get(id);
+        return row ? rowToConstruct(row) : null;
+    }
+    getConstructsByCategory(categoryId) {
+        const rows = this.db.prepare("SELECT * FROM ucr_constructs WHERE category_id = ? ORDER BY canonical_name").all(categoryId);
+        return rows.map(rowToConstruct);
+    }
+    searchConstructs(query) {
+        const sanitized = query.replace(/['"]/g, "").trim();
+        if (!sanitized)
+            return [];
+        const rows = this.db.prepare(`
+      SELECT c.* FROM ucr_constructs c
+      WHERE c.canonical_name LIKE ? OR c.description LIKE ? OR c.semantic_group LIKE ?
+      ORDER BY c.canonical_name
+      LIMIT 50
+    `).all(`%${sanitized}%`, `%${sanitized}%`, `%${sanitized}%`);
+        return rows.map(rowToConstruct);
+    }
+    // ── Language Mappings ───────────────────────────────────
+    insertMapping(mapping) {
+        this.db.prepare(`
+      INSERT OR IGNORE INTO ucr_language_mappings (id, construct_id, language_id, syntax_pattern, ast_node_type, confidence, is_primary, constraints)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(mapping.id, mapping.constructId, mapping.languageId, mapping.syntaxPattern, mapping.astNodeType ?? null, mapping.confidence, mapping.isPrimary ? 1 : 0, mapping.constraints ? JSON.stringify(mapping.constraints) : null);
+    }
+    getMappings(constructId, languageId) {
+        const rows = this.db.prepare(`
+      SELECT * FROM ucr_language_mappings
+      WHERE construct_id = ? AND language_id = ?
+      ORDER BY is_primary DESC, confidence DESC
+    `).all(constructId, languageId);
+        return rows.map(rowToMapping);
+    }
+    getPrimaryMapping(constructId, languageId) {
+        const row = this.db.prepare(`
+      SELECT * FROM ucr_language_mappings
+      WHERE construct_id = ? AND language_id = ? AND is_primary = 1
+      ORDER BY confidence DESC
+      LIMIT 1
+    `).get(constructId, languageId);
+        return row ? rowToMapping(row) : null;
+    }
+    // ── Translation Path ───────────────────────────────────
+    findTranslationPath(constructId, sourceLang, targetLang) {
+        const sourceMapping = this.getPrimaryMapping(constructId, sourceLang);
+        if (!sourceMapping)
+            return null;
+        const targetMapping = this.getPrimaryMapping(constructId, targetLang);
+        if (!targetMapping)
+            return null;
+        const allTargetMappings = this.getMappings(constructId, targetLang);
+        const alternatives = allTargetMappings.filter((m) => m.id !== targetMapping.id);
+        const confidence = Math.min(sourceMapping.confidence, targetMapping.confidence);
+        return { sourceMapping, targetMapping, confidence, alternatives };
+    }
+    // ── Confidence Update ──────────────────────────────────
+    updateConfidence(mappingId, delta) {
+        this.db.prepare(`
+      UPDATE ucr_language_mappings
+      SET confidence = MIN(1.0, MAX(0.0, confidence + ?))
+      WHERE id = ?
+    `).run(delta, mappingId);
+    }
+    // ── Seed ───────────────────────────────────────────────
+    seedFromJson(data) {
+        const result = { categories: 0, constructs: 0, mappings: 0 };
+        const tx = this.db.transaction(() => {
+            for (const cat of data.categories) {
+                this.insertCategory(cat);
+                result.categories++;
+            }
+            for (const construct of data.constructs) {
+                this.insertConstruct(construct);
+                result.constructs++;
+            }
+            for (const mapping of data.mappings) {
+                this.insertMapping(mapping);
+                result.mappings++;
+            }
+        });
+        tx();
+        logger.info("ucr:seed", {
+            categories: result.categories,
+            constructs: result.constructs,
+            mappings: result.mappings,
+        });
+        return result;
+    }
+}
+//# sourceMappingURL=construct-registry.js.map

package/dist/core/translation/ucr/construct-registry.js.map

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

package/dist/core/translation/ucr/construct-seed.d.ts

@@ -0,0 +1,12 @@
+/**
+ * UCR Seed Loader — loads construct-seed-data.json into ConstructRegistry.
+ */
+import type { UcrSeedData } from "./construct-types.js";
+import type { ConstructRegistry, SeedResult } from "./construct-registry.js";
+/** Load the built-in seed data and populate the registry. Idempotent. */
+export declare function loadAndSeedRegistry(registry: ConstructRegistry): SeedResult;
+/** Load seed data from a custom JSON file and populate the registry. Validates against Zod schema. */
+export declare function seedRegistryFromFile(registry: ConstructRegistry, filePath: string): SeedResult;
+/** Parse and validate seed data without inserting (dry-run). */
+export declare function validateSeedData(filePath: string): UcrSeedData;
+//# sourceMappingURL=construct-seed.d.ts.map

package/dist/core/translation/ucr/construct-seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"construct-seed.d.ts","sourceRoot":"","sources":["../../../../src/core/translation/ucr/construct-seed.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAM7E,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,UAAU,CAE3E;AAED,sGAAsG;AACtG,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,CAgB9F;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAI9D"}

package/dist/core/translation/ucr/construct-seed.js

@@ -0,0 +1,35 @@
+/**
+ * UCR Seed Loader — loads construct-seed-data.json into ConstructRegistry.
+ */
+import { readFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { UcrSeedDataSchema } from "./construct-types.js";
+import { logger } from "../../utils/logger.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const DEFAULT_SEED_PATH = resolve(__dirname, "construct-seed-data.json");
+/** Load the built-in seed data and populate the registry. Idempotent. */
+export function loadAndSeedRegistry(registry) {
+    return seedRegistryFromFile(registry, DEFAULT_SEED_PATH);
+}
+/** Load seed data from a custom JSON file and populate the registry. Validates against Zod schema. */
+export function seedRegistryFromFile(registry, filePath) {
+    const raw = readFileSync(filePath, "utf-8");
+    const parsed = JSON.parse(raw);
+    const validated = UcrSeedDataSchema.parse(parsed);
+    const result = registry.seedFromJson(validated);
+    logger.info("ucr:seed:file", {
+        file: filePath,
+        categories: result.categories,
+        constructs: result.constructs,
+        mappings: result.mappings,
+    });
+    return result;
+}
+/** Parse and validate seed data without inserting (dry-run). */
+export function validateSeedData(filePath) {
+    const raw = readFileSync(filePath, "utf-8");
+    const parsed = JSON.parse(raw);
+    return UcrSeedDataSchema.parse(parsed);
+}
+//# sourceMappingURL=construct-seed.js.map

package/dist/core/translation/ucr/construct-seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"construct-seed.js","sourceRoot":"","sources":["../../../../src/core/translation/ucr/construct-seed.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,iBAAiB,GAAG,OAAO,CAAC,SAAS,EAAE,0BAA0B,CAAC,CAAC;AAEzE,yEAAyE;AACzE,MAAM,UAAU,mBAAmB,CAAC,QAA2B;IAC7D,OAAO,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;AAC3D,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,oBAAoB,CAAC,QAA2B,EAAE,QAAgB;IAChF,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IAE1C,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAElD,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAEhD,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE;QAC3B,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;IAC1C,OAAO,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC"}

package/dist/core/translation/ucr/construct-types.d.ts

@@ -0,0 +1,174 @@
+import { z } from "zod/v4";
+export declare const UcrCategorySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type UcrCategory = z.infer<typeof UcrCategorySchema>;
+export declare const UcrConstructSchema: z.ZodObject<{
+    id: z.ZodString;
+    categoryId: z.ZodString;
+    canonicalName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    semanticGroup: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type UcrConstruct = z.infer<typeof UcrConstructSchema>;
+export declare const UcrLanguageMappingSchema: z.ZodObject<{
+    id: z.ZodString;
+    constructId: z.ZodString;
+    languageId: z.ZodString;
+    syntaxPattern: z.ZodString;
+    astNodeType: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodNumber;
+    isPrimary: z.ZodBoolean;
+    constraints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type UcrLanguageMapping = z.infer<typeof UcrLanguageMappingSchema>;
+export declare const EquivalenceTypeSchema: z.ZodEnum<{
+    none: "none";
+    exact: "exact";
+    syntactic: "syntactic";
+    semantic: "semantic";
+}>;
+export type EquivalenceType = z.infer<typeof EquivalenceTypeSchema>;
+export declare const UcrEquivalenceClassSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    equivalenceType: z.ZodEnum<{
+        none: "none";
+        exact: "exact";
+        syntactic: "syntactic";
+        semantic: "semantic";
+    }>;
+}, z.core.$strip>;
+export type UcrEquivalenceClass = z.infer<typeof UcrEquivalenceClassSchema>;
+export type CanonicalConstruct = {
+    constructId: string;
+    canonicalName: string;
+    sourceText: string;
+    startLine: number;
+    endLine: number;
+    children: CanonicalConstruct[];
+    metadata?: Record<string, unknown>;
+};
+export declare const CanonicalConstructSchema: z.ZodType<CanonicalConstruct>;
+export declare const TranslationPathSchema: z.ZodObject<{
+    sourceMapping: z.ZodObject<{
+        id: z.ZodString;
+        constructId: z.ZodString;
+        languageId: z.ZodString;
+        syntaxPattern: z.ZodString;
+        astNodeType: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodNumber;
+        isPrimary: z.ZodBoolean;
+        constraints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    targetMapping: z.ZodObject<{
+        id: z.ZodString;
+        constructId: z.ZodString;
+        languageId: z.ZodString;
+        syntaxPattern: z.ZodString;
+        astNodeType: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodNumber;
+        isPrimary: z.ZodBoolean;
+        constraints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    confidence: z.ZodNumber;
+    alternatives: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        constructId: z.ZodString;
+        languageId: z.ZodString;
+        syntaxPattern: z.ZodString;
+        astNodeType: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodNumber;
+        isPrimary: z.ZodBoolean;
+        constraints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type TranslationPath = z.infer<typeof TranslationPathSchema>;
+export declare const TranslationScoreAlternativeSchema: z.ZodObject<{
+    mappingId: z.ZodString;
+    confidence: z.ZodNumber;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export declare const TranslationScoreSchema: z.ZodObject<{
+    constructId: z.ZodString;
+    staticConfidence: z.ZodNumber;
+    contextualConfidence: z.ZodNumber;
+    finalConfidence: z.ZodNumber;
+    selectedMappingId: z.ZodString;
+    alternatives: z.ZodArray<z.ZodObject<{
+        mappingId: z.ZodString;
+        confidence: z.ZodNumber;
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+    needsAiAssist: z.ZodBoolean;
+}, z.core.$strip>;
+export type TranslationScore = z.infer<typeof TranslationScoreSchema>;
+export declare const AmbiguityTypeSchema: z.ZodEnum<{
+    multiple_targets: "multiple_targets";
+    no_target: "no_target";
+    lossy_translation: "lossy_translation";
+}>;
+export type AmbiguityType = z.infer<typeof AmbiguityTypeSchema>;
+export declare const AmbiguityCandidateSchema: z.ZodObject<{
+    mappingId: z.ZodString;
+    confidence: z.ZodNumber;
+    tradeoff: z.ZodString;
+}, z.core.$strip>;
+export declare const AmbiguityReportSchema: z.ZodObject<{
+    constructId: z.ZodString;
+    canonicalName: z.ZodString;
+    ambiguityType: z.ZodEnum<{
+        multiple_targets: "multiple_targets";
+        no_target: "no_target";
+        lossy_translation: "lossy_translation";
+    }>;
+    candidates: z.ZodArray<z.ZodObject<{
+        mappingId: z.ZodString;
+        confidence: z.ZodNumber;
+        tradeoff: z.ZodString;
+    }, z.core.$strip>>;
+    recommendation: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AmbiguityReport = z.infer<typeof AmbiguityReportSchema>;
+export declare const UcrSeedDataSchema: z.ZodObject<{
+    categories: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    constructs: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        categoryId: z.ZodString;
+        canonicalName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        semanticGroup: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    mappings: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        constructId: z.ZodString;
+        languageId: z.ZodString;
+        syntaxPattern: z.ZodString;
+        astNodeType: z.ZodOptional<z.ZodString>;
+        confidence: z.ZodNumber;
+        isPrimary: z.ZodBoolean;
+        constraints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    equivalenceClasses: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        equivalenceType: z.ZodEnum<{
+            none: "none";
+            exact: "exact";
+            syntactic: "syntactic";
+            semantic: "semantic";
+        }>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type UcrSeedData = z.infer<typeof UcrSeedDataSchema>;
+//# sourceMappingURL=construct-types.d.ts.map

package/dist/core/translation/ucr/construct-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"construct-types.d.ts","sourceRoot":"","sources":["../../../../src/core/translation/ucr/construct-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAI3B,eAAO,MAAM,iBAAiB;;;;iBAI5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI5D,eAAO,MAAM,kBAAkB;;;;;;;iBAO7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,eAAO,MAAM,wBAAwB;;;;;;;;;iBASnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAI1E,eAAO,MAAM,qBAAqB;;;;;EAAqD,CAAC;AAExF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,yBAAyB;;;;;;;;;;iBAKpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAI5E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAUlE,CAAC;AAIF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIpE,eAAO,MAAM,iCAAiC;;;;iBAI5C,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;iBAQjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE,eAAO,MAAM,mBAAmB;;;;EAAiE,CAAC;AAElG,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,wBAAwB;;;;iBAInC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;iBAMhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIpE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/core/translation/ucr/construct-types.js

@@ -0,0 +1,88 @@
+import { z } from "zod/v4";
+// --- UCR Category ---
+export const UcrCategorySchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string().optional(),
+});
+// --- UCR Construct (canonical) ---
+export const UcrConstructSchema = z.object({
+    id: z.string(),
+    categoryId: z.string(),
+    canonicalName: z.string(),
+    description: z.string().optional(),
+    semanticGroup: z.string().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+// --- UCR Language Mapping ---
+export const UcrLanguageMappingSchema = z.object({
+    id: z.string(),
+    constructId: z.string(),
+    languageId: z.string(),
+    syntaxPattern: z.string(),
+    astNodeType: z.string().optional(),
+    confidence: z.number().min(0).max(1),
+    isPrimary: z.boolean(),
+    constraints: z.record(z.string(), z.unknown()).optional(),
+});
+// --- UCR Equivalence Class ---
+export const EquivalenceTypeSchema = z.enum(["exact", "syntactic", "semantic", "none"]);
+export const UcrEquivalenceClassSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string().optional(),
+    equivalenceType: EquivalenceTypeSchema,
+});
+export const CanonicalConstructSchema = z.lazy(() => z.object({
+    constructId: z.string(),
+    canonicalName: z.string(),
+    sourceText: z.string(),
+    startLine: z.number().int(),
+    endLine: z.number().int(),
+    children: z.array(CanonicalConstructSchema),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+}));
+// --- Translation Path (UCR lookup result) ---
+export const TranslationPathSchema = z.object({
+    sourceMapping: UcrLanguageMappingSchema,
+    targetMapping: UcrLanguageMappingSchema,
+    confidence: z.number().min(0).max(1),
+    alternatives: z.array(UcrLanguageMappingSchema),
+});
+// --- Translation Score (per-construct scoring) ---
+export const TranslationScoreAlternativeSchema = z.object({
+    mappingId: z.string(),
+    confidence: z.number().min(0).max(1),
+    reason: z.string(),
+});
+export const TranslationScoreSchema = z.object({
+    constructId: z.string(),
+    staticConfidence: z.number().min(0).max(1),
+    contextualConfidence: z.number().min(0).max(1),
+    finalConfidence: z.number().min(0).max(1),
+    selectedMappingId: z.string(),
+    alternatives: z.array(TranslationScoreAlternativeSchema),
+    needsAiAssist: z.boolean(),
+});
+// --- Ambiguity Report ---
+export const AmbiguityTypeSchema = z.enum(["multiple_targets", "no_target", "lossy_translation"]);
+export const AmbiguityCandidateSchema = z.object({
+    mappingId: z.string(),
+    confidence: z.number().min(0).max(1),
+    tradeoff: z.string(),
+});
+export const AmbiguityReportSchema = z.object({
+    constructId: z.string(),
+    canonicalName: z.string(),
+    ambiguityType: AmbiguityTypeSchema,
+    candidates: z.array(AmbiguityCandidateSchema),
+    recommendation: z.string().optional(),
+});
+// --- UCR Seed Data (JSON import format) ---
+export const UcrSeedDataSchema = z.object({
+    categories: z.array(UcrCategorySchema),
+    constructs: z.array(UcrConstructSchema),
+    mappings: z.array(UcrLanguageMappingSchema),
+    equivalenceClasses: z.array(UcrEquivalenceClassSchema).optional(),
+});
+//# sourceMappingURL=construct-types.js.map

package/dist/core/translation/ucr/construct-types.js.map

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