@veewo/gitnexus 1.3.8 → 1.3.10

package/dist/core/kuzu/kuzu-adapter.js

@@ -187,6 +187,7 @@ export const loadGraphToKuzu = async (graph, repoPath, storagePath, onProgress)
     });
     const insertedRels = totalValidRels;
     const warnings = [];
+    let fallbackStats = { attempted: 0, succeeded: 0, failed: 0 };
     if (insertedRels > 0) {
         log(`Loading edges: ${insertedRels.toLocaleString()} across ${relsByPair.size} types`);
         let pairIdx = 0;
@@ -224,7 +225,7 @@ export const loadGraphToKuzu = async (graph, repoPath, storagePath, onProgress)
         }
         if (failedPairLines.length > 0) {
             log(`Inserting ${failedPairEdges} edges individually (missing schema pairs)`);
-            await fallbackRelationshipInserts([relHeader, ...failedPairLines], validTables, getNodeLabel);
+            fallbackStats = await fallbackRelationshipInserts([relHeader, ...failedPairLines], validTables, getNodeLabel);
         }
     }
     // Cleanup all CSVs
@@ -252,7 +253,7 @@ export const loadGraphToKuzu = async (graph, repoPath, storagePath, onProgress)
         await fs.rmdir(csvDir);
     }
     catch { }
-    return { success: true, insertedRels, skippedRels, warnings };
+    return { success: true, insertedRels, skippedRels, warnings, fallbackStats };
 };
 // KuzuDB default ESCAPE is '\' (backslash), but our CSV uses RFC 4180 escaping ("" for literal quotes).
 // Source code content is full of backslashes which confuse the auto-detection.
@@ -271,22 +272,30 @@ const escapeTableName = (table) => {
 };
 /** Fallback: insert relationships one-by-one if COPY fails */
 const fallbackRelationshipInserts = async (validRelLines, validTables, getNodeLabel) => {
-    if (!conn)
-        return;
+    const attempted = Math.max(0, validRelLines.length - 1);
+    if (!conn) {
+        return { attempted, succeeded: 0, failed: attempted };
+    }
     const escapeLabel = (label) => {
         return BACKTICK_TABLES.has(label) ? `\`${label}\`` : label;
     };
+    let succeeded = 0;
+    let failed = 0;
     for (let i = 1; i < validRelLines.length; i++) {
         const line = validRelLines[i];
         try {
             const match = line.match(/"([^"]*)","([^"]*)","([^"]*)",([0-9.]+),"([^"]*)",([0-9-]+)/);
-            if (!match)
+            if (!match) {
+                failed++;
                 continue;
+            }
             const [, fromId, toId, relType, confidenceStr, reason, stepStr] = match;
             const fromLabel = getNodeLabel(fromId);
             const toLabel = getNodeLabel(toId);
-            if (!validTables.has(fromLabel) || !validTables.has(toLabel))
+            if (!validTables.has(fromLabel) || !validTables.has(toLabel)) {
+                failed++;
                 continue;
+            }
             const confidence = parseFloat(confidenceStr) || 1.0;
             const step = parseInt(stepStr) || 0;
             await conn.query(`
@@ -294,11 +303,13 @@ const fallbackRelationshipInserts = async (validRelLines, validTables, getNodeLa
               (b:${escapeLabel(toLabel)} {id: '${toId.replace(/'/g, "''")}' })
         CREATE (a)-[:${REL_TABLE_NAME} {type: '${relType}', confidence: ${confidence}, reason: '${reason.replace(/'/g, "''")}', step: ${step}}]->(b)
       `);
+            succeeded++;
         }
         catch {
-            // skip
+            failed++;
         }
     }
+    return { attempted, succeeded, failed };
 };
 /** Tables with isExported column (TypeScript/JS-native types) */
 const TABLES_WITH_EXPORTED = new Set(['Function', 'Class', 'Interface', 'Method', 'CodeElement']);

package/dist/core/kuzu/schema.d.ts

@@ -11,7 +11,7 @@
 export declare const NODE_TABLES: readonly ["File", "Folder", "Function", "Class", "Interface", "Method", "CodeElement", "Community", "Process", "Struct", "Enum", "Macro", "Typedef", "Union", "Namespace", "Trait", "Impl", "TypeAlias", "Const", "Static", "Property", "Record", "Delegate", "Annotation", "Constructor", "Template", "Module"];
 export type NodeTableName = typeof NODE_TABLES[number];
 export declare const REL_TABLE_NAME = "CodeRelation";
-export declare const REL_TYPES: readonly ["CONTAINS", "DEFINES", "IMPORTS", "CALLS", "EXTENDS", "IMPLEMENTS", "MEMBER_OF", "STEP_IN_PROCESS"];
+export declare const REL_TYPES: readonly ["CONTAINS", "DEFINES", "IMPORTS", "CALLS", "EXTENDS", "IMPLEMENTS", "MEMBER_OF", "STEP_IN_PROCESS", "UNITY_COMPONENT_IN", "UNITY_COMPONENT_INSTANCE", "UNITY_SERIALIZED_TYPE_IN"];
 export type RelType = typeof REL_TYPES[number];
 export declare const EMBEDDING_TABLE_NAME = "CodeEmbedding";
 export declare const FILE_SCHEMA = "\nCREATE NODE TABLE File (\n  id STRING,\n  name STRING,\n  filePath STRING,\n  content STRING,\n  PRIMARY KEY (id)\n)";
@@ -41,7 +41,7 @@ export declare const ANNOTATION_SCHEMA: string;
 export declare const CONSTRUCTOR_SCHEMA: string;
 export declare const TEMPLATE_SCHEMA: string;
 export declare const MODULE_SCHEMA: string;
-export declare const RELATION_SCHEMA = "\nCREATE REL TABLE CodeRelation (\n  FROM File TO File,\n  FROM File TO Folder,\n  FROM File TO Function,\n  FROM File TO Class,\n  FROM File TO Interface,\n  FROM File TO Method,\n  FROM File TO CodeElement,\n  FROM File TO `Struct`,\n  FROM File TO `Enum`,\n  FROM File TO `Macro`,\n  FROM File TO `Typedef`,\n  FROM File TO `Union`,\n  FROM File TO `Namespace`,\n  FROM File TO `Trait`,\n  FROM File TO `Impl`,\n  FROM File TO `TypeAlias`,\n  FROM File TO `Const`,\n  FROM File TO `Static`,\n  FROM File TO `Property`,\n  FROM File TO `Record`,\n  FROM File TO `Delegate`,\n  FROM File TO `Annotation`,\n  FROM File TO `Constructor`,\n  FROM File TO `Template`,\n  FROM File TO `Module`,\n  FROM Folder TO Folder,\n  FROM Folder TO File,\n  FROM Function TO Function,\n  FROM Function TO Method,\n  FROM Function TO Class,\n  FROM Function TO Community,\n  FROM Function TO `Macro`,\n  FROM Function TO `Struct`,\n  FROM Function TO `Template`,\n  FROM Function TO `Enum`,\n  FROM Function TO `Namespace`,\n  FROM Function TO `TypeAlias`,\n  FROM Function TO `Module`,\n  FROM Function TO `Impl`,\n  FROM Function TO Interface,\n  FROM Function TO `Constructor`,\n  FROM Function TO `Const`,\n  FROM Function TO `Typedef`,\n  FROM Function TO `Union`,\n  FROM Class TO Method,\n  FROM Class TO Function,\n  FROM Class TO Class,\n  FROM Class TO Interface,\n  FROM Class TO Community,\n  FROM Class TO `Template`,\n  FROM Class TO `TypeAlias`,\n  FROM Class TO `Struct`,\n  FROM Class TO `Enum`,\n  FROM Class TO `Annotation`,\n  FROM Class TO `Constructor`,\n  FROM Class TO `Trait`,\n  FROM Class TO `Macro`,\n  FROM Class TO `Impl`,\n  FROM Class TO `Union`,\n  FROM Class TO `Namespace`,\n  FROM Class TO `Typedef`,\n  FROM Method TO Function,\n  FROM Method TO Method,\n  FROM Method TO Class,\n  FROM Method TO Community,\n  FROM Method TO `Template`,\n  FROM Method TO `Struct`,\n  FROM Method TO `TypeAlias`,\n  FROM Method TO `Enum`,\n  FROM Method TO `Macro`,\n  FROM Method TO `Namespace`,\n  FROM Method TO `Module`,\n  FROM Method TO `Impl`,\n  FROM Method TO Interface,\n  FROM Method TO `Constructor`,\n  FROM Method TO `Property`,\n  FROM `Template` TO `Template`,\n  FROM `Template` TO Function,\n  FROM `Template` TO Method,\n  FROM `Template` TO Class,\n  FROM `Template` TO `Struct`,\n  FROM `Template` TO `TypeAlias`,\n  FROM `Template` TO `Enum`,\n  FROM `Template` TO `Macro`,\n  FROM `Template` TO Interface,\n  FROM `Template` TO `Constructor`,\n  FROM `Module` TO `Module`,\n  FROM CodeElement TO Community,\n  FROM Interface TO Community,\n  FROM Interface TO Function,\n  FROM Interface TO Method,\n  FROM Interface TO Class,\n  FROM Interface TO Interface,\n  FROM Interface TO `TypeAlias`,\n  FROM Interface TO `Struct`,\n  FROM Interface TO `Constructor`,\n  FROM `Struct` TO Community,\n  FROM `Struct` TO `Trait`,\n  FROM `Struct` TO `Struct`,\n  FROM `Struct` TO Class,\n  FROM `Struct` TO `Enum`,\n  FROM `Struct` TO Function,\n  FROM `Struct` TO Method,\n  FROM `Enum` TO Community,\n  FROM `Macro` TO Community,\n  FROM `Macro` TO Function,\n  FROM `Macro` TO Method,\n  FROM `Module` TO Function,\n  FROM `Module` TO Method,\n  FROM `Typedef` TO Community,\n  FROM `Union` TO Community,\n  FROM `Namespace` TO Community,\n  FROM `Namespace` TO `Struct`,\n  FROM `Trait` TO Community,\n  FROM `Impl` TO Community,\n  FROM `Impl` TO `Trait`,\n  FROM `Impl` TO `Struct`,\n  FROM `Impl` TO `Impl`,\n  FROM `TypeAlias` TO Community,\n  FROM `TypeAlias` TO `Trait`,\n  FROM `Const` TO Community,\n  FROM `Static` TO Community,\n  FROM `Property` TO Community,\n  FROM `Record` TO Community,\n  FROM `Delegate` TO Community,\n  FROM `Annotation` TO Community,\n  FROM `Constructor` TO Community,\n  FROM `Constructor` TO Interface,\n  FROM `Constructor` TO Class,\n  FROM `Constructor` TO Method,\n  FROM `Constructor` TO Function,\n  FROM `Constructor` TO `Constructor`,\n  FROM `Constructor` TO `Struct`,\n  FROM `Constructor` TO `Macro`,\n  FROM `Constructor` TO `Template`,\n  FROM `Constructor` TO `TypeAlias`,\n  FROM `Constructor` TO `Enum`,\n  FROM `Constructor` TO `Annotation`,\n  FROM `Constructor` TO `Impl`,\n  FROM `Constructor` TO `Namespace`,\n  FROM `Constructor` TO `Module`,\n  FROM `Template` TO Community,\n  FROM `Module` TO Community,\n  FROM Function TO Process,\n  FROM Method TO Process,\n  FROM Class TO Process,\n  FROM Interface TO Process,\n  FROM `Struct` TO Process,\n  FROM `Constructor` TO Process,\n  FROM `Module` TO Process,\n  FROM `Macro` TO Process,\n  FROM `Impl` TO Process,\n  FROM `Typedef` TO Process,\n  FROM `TypeAlias` TO Process,\n  FROM `Enum` TO Process,\n  FROM `Union` TO Process,\n  FROM `Namespace` TO Process,\n  FROM `Trait` TO Process,\n  FROM `Const` TO Process,\n  FROM `Static` TO Process,\n  FROM `Property` TO Process,\n  FROM `Record` TO Process,\n  FROM `Delegate` TO Process,\n  FROM `Annotation` TO Process,\n  FROM `Template` TO Process,\n  FROM CodeElement TO Process,\n  type STRING,\n  confidence DOUBLE,\n  reason STRING,\n  step INT32\n)";
+export declare const RELATION_SCHEMA = "\nCREATE REL TABLE CodeRelation (\n  FROM File TO File,\n  FROM File TO Folder,\n  FROM File TO Function,\n  FROM File TO Class,\n  FROM File TO Interface,\n  FROM File TO Method,\n  FROM File TO CodeElement,\n  FROM File TO `Struct`,\n  FROM File TO `Enum`,\n  FROM File TO `Macro`,\n  FROM File TO `Typedef`,\n  FROM File TO `Union`,\n  FROM File TO `Namespace`,\n  FROM File TO `Trait`,\n  FROM File TO `Impl`,\n  FROM File TO `TypeAlias`,\n  FROM File TO `Const`,\n  FROM File TO `Static`,\n  FROM File TO `Property`,\n  FROM File TO `Record`,\n  FROM File TO `Delegate`,\n  FROM File TO `Annotation`,\n  FROM File TO `Constructor`,\n  FROM File TO `Template`,\n  FROM File TO `Module`,\n  FROM Folder TO Folder,\n  FROM Folder TO File,\n  FROM Function TO Function,\n  FROM Function TO Method,\n  FROM Function TO Class,\n  FROM Function TO Community,\n  FROM Function TO `Macro`,\n  FROM Function TO `Struct`,\n  FROM Function TO `Template`,\n  FROM Function TO `Enum`,\n  FROM Function TO `Namespace`,\n  FROM Function TO `TypeAlias`,\n  FROM Function TO `Module`,\n  FROM Function TO `Impl`,\n  FROM Function TO Interface,\n  FROM Function TO `Constructor`,\n  FROM Function TO `Property`,\n  FROM Function TO `Const`,\n  FROM Function TO `Typedef`,\n  FROM Function TO `Union`,\n  FROM Class TO Method,\n  FROM Class TO Function,\n  FROM Class TO Class,\n  FROM Class TO File,\n  FROM Class TO CodeElement,\n  FROM Class TO Interface,\n  FROM Class TO Community,\n  FROM Class TO `Template`,\n  FROM Class TO `TypeAlias`,\n  FROM Class TO `Struct`,\n  FROM Class TO `Enum`,\n  FROM Class TO `Annotation`,\n  FROM Class TO `Constructor`,\n  FROM Class TO `Trait`,\n  FROM Class TO `Macro`,\n  FROM Class TO `Impl`,\n  FROM Class TO `Union`,\n  FROM Class TO `Namespace`,\n  FROM Class TO `Typedef`,\n  FROM Class TO `Property`,\n  FROM Class TO `Delegate`,\n  FROM Method TO Function,\n  FROM Method TO Method,\n  FROM Method TO Class,\n  FROM Method TO Community,\n  FROM Method TO `Template`,\n  FROM Method TO `Struct`,\n  FROM Method TO `TypeAlias`,\n  FROM Method TO `Enum`,\n  FROM Method TO `Macro`,\n  FROM Method TO `Namespace`,\n  FROM Method TO `Module`,\n  FROM Method TO `Impl`,\n  FROM Method TO Interface,\n  FROM Method TO `Constructor`,\n  FROM Method TO `Property`,\n  FROM Method TO `Delegate`,\n  FROM `Template` TO `Template`,\n  FROM `Template` TO Function,\n  FROM `Template` TO Method,\n  FROM `Template` TO Class,\n  FROM `Template` TO `Struct`,\n  FROM `Template` TO `TypeAlias`,\n  FROM `Template` TO `Enum`,\n  FROM `Template` TO `Macro`,\n  FROM `Template` TO Interface,\n  FROM `Template` TO `Constructor`,\n  FROM `Module` TO `Module`,\n  FROM CodeElement TO Community,\n  FROM Interface TO Community,\n  FROM Interface TO Function,\n  FROM Interface TO Method,\n  FROM Interface TO Class,\n  FROM Interface TO Interface,\n  FROM Interface TO `TypeAlias`,\n  FROM Interface TO `Struct`,\n  FROM Interface TO `Constructor`,\n  FROM `Struct` TO Community,\n  FROM `Struct` TO `Trait`,\n  FROM `Struct` TO `Struct`,\n  FROM `Struct` TO Class,\n  FROM `Struct` TO `Enum`,\n  FROM `Struct` TO Function,\n  FROM `Struct` TO Method,\n  FROM `Enum` TO Community,\n  FROM `Macro` TO Community,\n  FROM `Macro` TO Function,\n  FROM `Macro` TO Method,\n  FROM `Module` TO Function,\n  FROM `Module` TO Method,\n  FROM `Typedef` TO Community,\n  FROM `Union` TO Community,\n  FROM `Namespace` TO Community,\n  FROM `Namespace` TO `Struct`,\n  FROM `Trait` TO Community,\n  FROM `Impl` TO Community,\n  FROM `Impl` TO `Trait`,\n  FROM `Impl` TO `Struct`,\n  FROM `Impl` TO `Impl`,\n  FROM `TypeAlias` TO Community,\n  FROM `TypeAlias` TO `Trait`,\n  FROM `Const` TO Community,\n  FROM `Static` TO Community,\n  FROM `Property` TO Community,\n  FROM `Property` TO Class,\n  FROM `Property` TO Interface,\n  FROM `Record` TO Community,\n  FROM `Delegate` TO Community,\n  FROM `Annotation` TO Community,\n  FROM `Constructor` TO Community,\n  FROM `Constructor` TO Interface,\n  FROM `Constructor` TO Class,\n  FROM `Constructor` TO Method,\n  FROM `Constructor` TO Function,\n  FROM `Constructor` TO `Constructor`,\n  FROM `Constructor` TO `Struct`,\n  FROM `Constructor` TO `Macro`,\n  FROM `Constructor` TO `Template`,\n  FROM `Constructor` TO `TypeAlias`,\n  FROM `Constructor` TO `Enum`,\n  FROM `Constructor` TO `Annotation`,\n  FROM `Constructor` TO `Impl`,\n  FROM `Constructor` TO `Namespace`,\n  FROM `Constructor` TO `Module`,\n  FROM `Constructor` TO `Property`,\n  FROM `Template` TO Community,\n  FROM `Module` TO Community,\n  FROM Function TO Process,\n  FROM Method TO Process,\n  FROM Class TO Process,\n  FROM Interface TO Process,\n  FROM `Struct` TO Process,\n  FROM `Constructor` TO Process,\n  FROM `Module` TO Process,\n  FROM `Macro` TO Process,\n  FROM `Impl` TO Process,\n  FROM `Typedef` TO Process,\n  FROM `TypeAlias` TO Process,\n  FROM `Enum` TO Process,\n  FROM `Union` TO Process,\n  FROM `Namespace` TO Process,\n  FROM `Trait` TO Process,\n  FROM `Const` TO Process,\n  FROM `Static` TO Process,\n  FROM `Property` TO Process,\n  FROM `Record` TO Process,\n  FROM `Delegate` TO Process,\n  FROM `Annotation` TO Process,\n  FROM `Template` TO Process,\n  FROM CodeElement TO Process,\n  type STRING,\n  confidence DOUBLE,\n  reason STRING,\n  step INT32\n)";
 export declare const EMBEDDING_SCHEMA = "\nCREATE NODE TABLE CodeEmbedding (\n  nodeId STRING,\n  embedding FLOAT[384],\n  PRIMARY KEY (nodeId)\n)";
 /**
  * Create vector index for semantic search

package/dist/core/kuzu/schema.js

@@ -22,7 +22,19 @@ export const NODE_TABLES = [
 // ============================================================================
 export const REL_TABLE_NAME = 'CodeRelation';
 // Valid relation types
-export const REL_TYPES = ['CONTAINS', 'DEFINES', 'IMPORTS', 'CALLS', 'EXTENDS', 'IMPLEMENTS', 'MEMBER_OF', 'STEP_IN_PROCESS'];
+export const REL_TYPES = [
+    'CONTAINS',
+    'DEFINES',
+    'IMPORTS',
+    'CALLS',
+    'EXTENDS',
+    'IMPLEMENTS',
+    'MEMBER_OF',
+    'STEP_IN_PROCESS',
+    'UNITY_COMPONENT_IN',
+    'UNITY_COMPONENT_INSTANCE',
+    'UNITY_SERIALIZED_TYPE_IN',
+];
 // ============================================================================
 // EMBEDDING TABLE
 // ============================================================================
@@ -216,12 +228,15 @@ CREATE REL TABLE ${REL_TABLE_NAME} (
   FROM Function TO \`Impl\`,
   FROM Function TO Interface,
   FROM Function TO \`Constructor\`,
+  FROM Function TO \`Property\`,
   FROM Function TO \`Const\`,
   FROM Function TO \`Typedef\`,
   FROM Function TO \`Union\`,
   FROM Class TO Method,
   FROM Class TO Function,
   FROM Class TO Class,
+  FROM Class TO File,
+  FROM Class TO CodeElement,
   FROM Class TO Interface,
   FROM Class TO Community,
   FROM Class TO \`Template\`,
@@ -236,6 +251,8 @@ CREATE REL TABLE ${REL_TABLE_NAME} (
   FROM Class TO \`Union\`,
   FROM Class TO \`Namespace\`,
   FROM Class TO \`Typedef\`,
+  FROM Class TO \`Property\`,
+  FROM Class TO \`Delegate\`,
   FROM Method TO Function,
   FROM Method TO Method,
   FROM Method TO Class,
@@ -251,6 +268,7 @@ CREATE REL TABLE ${REL_TABLE_NAME} (
   FROM Method TO Interface,
   FROM Method TO \`Constructor\`,
   FROM Method TO \`Property\`,
+  FROM Method TO \`Delegate\`,
   FROM \`Template\` TO \`Template\`,
   FROM \`Template\` TO Function,
   FROM \`Template\` TO Method,
@@ -298,6 +316,8 @@ CREATE REL TABLE ${REL_TABLE_NAME} (
   FROM \`Const\` TO Community,
   FROM \`Static\` TO Community,
   FROM \`Property\` TO Community,
+  FROM \`Property\` TO Class,
+  FROM \`Property\` TO Interface,
   FROM \`Record\` TO Community,
   FROM \`Delegate\` TO Community,
   FROM \`Annotation\` TO Community,
@@ -316,6 +336,7 @@ CREATE REL TABLE ${REL_TABLE_NAME} (
   FROM \`Constructor\` TO \`Impl\`,
   FROM \`Constructor\` TO \`Namespace\`,
   FROM \`Constructor\` TO \`Module\`,
+  FROM \`Constructor\` TO \`Property\`,
   FROM \`Template\` TO Community,
   FROM \`Module\` TO Community,
   FROM Function TO Process,

package/dist/core/kuzu/schema.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/kuzu/schema.test.js

@@ -0,0 +1,17 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { RELATION_SCHEMA } from './schema.js';
+test('RELATION_SCHEMA includes audited fallback pairs for Property/Delegate links', () => {
+    const requiredPairs = [
+        'FROM Method TO `Delegate`',
+        'FROM Class TO `Property`',
+        'FROM `Constructor` TO `Property`',
+        'FROM Function TO `Property`',
+        'FROM `Property` TO Class',
+        'FROM `Property` TO Interface',
+        'FROM Class TO `Delegate`',
+    ];
+    for (const pair of requiredPairs) {
+        assert.match(RELATION_SCHEMA, new RegExp(pair.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')), `Missing relationship pair in schema: ${pair}`);
+    }
+});

package/dist/core/unity/meta-index.d.ts

@@ -0,0 +1,5 @@
+export interface BuildMetaIndexOptions {
+    metaFiles?: string[];
+}
+export declare function buildMetaIndex(repoRoot: string, options?: BuildMetaIndexOptions): Promise<Map<string, string>>;
+export declare function buildAssetMetaIndex(repoRoot: string, options?: BuildMetaIndexOptions): Promise<Map<string, string>>;

package/dist/core/unity/meta-index.js

@@ -0,0 +1,113 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { glob } from 'glob';
+const GUID_PATTERN = /^guid:\s*([0-9a-f]{32})\s*$/im;
+const META_INDEX_READ_CONCURRENCY = 64;
+export async function buildMetaIndex(repoRoot, options = {}) {
+    const metaFiles = await resolveMetaFiles(repoRoot, options.metaFiles);
+    const entries = await mapWithConcurrency(metaFiles, META_INDEX_READ_CONCURRENCY, async (metaPath) => {
+        const absolutePath = path.join(repoRoot, metaPath);
+        let content = '';
+        try {
+            content = await fs.readFile(absolutePath, 'utf-8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return null;
+            throw error;
+        }
+        const match = content.match(GUID_PATTERN);
+        if (!match)
+            return null;
+        const scriptPath = metaPath.slice(0, -'.meta'.length).replace(/\\/g, '/');
+        return [match[1], scriptPath];
+    });
+    const index = new Map();
+    for (const entry of entries) {
+        if (!entry)
+            continue;
+        index.set(entry[0], entry[1]);
+    }
+    return index;
+}
+export async function buildAssetMetaIndex(repoRoot, options = {}) {
+    const metaFiles = await resolveAssetMetaFiles(repoRoot, options.metaFiles);
+    const entries = await mapWithConcurrency(metaFiles, META_INDEX_READ_CONCURRENCY, async (metaPath) => {
+        const absolutePath = path.join(repoRoot, metaPath);
+        let content = '';
+        try {
+            content = await fs.readFile(absolutePath, 'utf-8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return null;
+            throw error;
+        }
+        const match = content.match(GUID_PATTERN);
+        if (!match)
+            return null;
+        const assetPath = metaPath.slice(0, -'.meta'.length).replace(/\\/g, '/');
+        return [match[1], assetPath];
+    });
+    const index = new Map();
+    for (const entry of entries) {
+        if (!entry)
+            continue;
+        index.set(entry[0], entry[1]);
+        index.set(entry[0].toLowerCase(), entry[1]);
+    }
+    return index;
+}
+async function resolveMetaFiles(repoRoot, scopedMetaFiles) {
+    if (!scopedMetaFiles || scopedMetaFiles.length === 0) {
+        return (await glob('**/*.cs.meta', {
+            cwd: repoRoot,
+            nodir: true,
+            dot: false,
+        })).sort((left, right) => left.localeCompare(right));
+    }
+    const normalized = scopedMetaFiles
+        .filter((value) => value.endsWith('.cs.meta'))
+        .map((value) => normalizeRelativePath(repoRoot, value))
+        .filter((value) => value !== null)
+        .sort((left, right) => left.localeCompare(right));
+    return [...new Set(normalized)];
+}
+async function resolveAssetMetaFiles(repoRoot, scopedMetaFiles) {
+    if (!scopedMetaFiles || scopedMetaFiles.length === 0) {
+        return (await glob('**/*.meta', {
+            cwd: repoRoot,
+            nodir: true,
+            dot: false,
+        })).sort((left, right) => left.localeCompare(right));
+    }
+    const normalized = scopedMetaFiles
+        .filter((value) => value.endsWith('.meta'))
+        .map((value) => normalizeRelativePath(repoRoot, value))
+        .filter((value) => value !== null)
+        .sort((left, right) => left.localeCompare(right));
+    return [...new Set(normalized)];
+}
+function normalizeRelativePath(repoRoot, filePath) {
+    const relativePath = path.isAbsolute(filePath) ? path.relative(repoRoot, filePath) : filePath;
+    const normalized = relativePath.replace(/\\/g, '/');
+    if (normalized.startsWith('../'))
+        return null;
+    return normalized;
+}
+async function mapWithConcurrency(items, concurrency, mapper) {
+    const safeConcurrency = Math.max(1, Math.min(concurrency, items.length || 1));
+    const results = new Array(items.length);
+    let cursor = 0;
+    const workers = Array.from({ length: safeConcurrency }, async () => {
+        while (true) {
+            const index = cursor;
+            cursor += 1;
+            if (index >= items.length)
+                break;
+            results[index] = await mapper(items[index], index);
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}

package/dist/core/unity/meta-index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/unity/meta-index.test.js

@@ -0,0 +1,11 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { buildMetaIndex } from './meta-index.js';
+const here = path.dirname(fileURLToPath(import.meta.url));
+const fixtureRoot = path.resolve(here, '../../../src/core/unity/__fixtures__/mini-unity');
+test('buildMetaIndex maps script guid to script path', async () => {
+    const index = await buildMetaIndex(fixtureRoot);
+    assert.equal(index.get('a6d481d58c0b4f646b7106ceaf633d6e')?.endsWith('Global.cs'), true);
+});

package/dist/core/unity/options.d.ts

@@ -0,0 +1,2 @@
+export type UnityResourcesMode = 'off' | 'on' | 'auto';
+export declare function parseUnityResourcesMode(raw?: string): UnityResourcesMode;

package/dist/core/unity/options.js

@@ -0,0 +1,9 @@
+export function parseUnityResourcesMode(raw) {
+    if (!raw)
+        return 'off';
+    const normalized = raw.trim().toLowerCase();
+    if (normalized === 'off' || normalized === 'on' || normalized === 'auto') {
+        return normalized;
+    }
+    throw new Error('Invalid unity resources mode. Use off|on|auto.');
+}

package/dist/core/unity/options.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/unity/options.test.js

@@ -0,0 +1,10 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { parseUnityResourcesMode } from './options.js';
+test('parseUnityResourcesMode defaults to off', () => {
+    assert.equal(parseUnityResourcesMode(undefined), 'off');
+});
+test('parseUnityResourcesMode validates mode', () => {
+    assert.equal(parseUnityResourcesMode('on'), 'on');
+    assert.throws(() => parseUnityResourcesMode('bad'), /unity resources mode/i);
+});

package/dist/core/unity/override-merger.d.ts

@@ -0,0 +1,27 @@
+export interface UnityScalarFieldInput {
+    value: string;
+    valueType?: string;
+}
+export interface UnityReferenceFieldInput {
+    fileId?: string;
+    guid?: string;
+    resolvedAssetPath?: string;
+}
+export interface UnityObjectLayer {
+    sourceLayer: string;
+    scalarFields?: Record<string, UnityScalarFieldInput>;
+    referenceFields?: Record<string, UnityReferenceFieldInput>;
+}
+export interface MergedUnityScalarField extends UnityScalarFieldInput {
+    name: string;
+    sourceLayer: string;
+}
+export interface MergedUnityReferenceField extends UnityReferenceFieldInput {
+    name: string;
+    sourceLayer: string;
+}
+export interface MergedUnityComponent {
+    scalarFields: Record<string, MergedUnityScalarField>;
+    referenceFields: Record<string, MergedUnityReferenceField>;
+}
+export declare function mergeOverrideChain(...layersOrArray: Array<UnityObjectLayer | UnityObjectLayer[]>): MergedUnityComponent;

package/dist/core/unity/override-merger.js

@@ -0,0 +1,35 @@
+export function mergeOverrideChain(...layersOrArray) {
+    const layers = normalizeLayers(layersOrArray);
+    const merged = {
+        scalarFields: {},
+        referenceFields: {},
+    };
+    for (const layer of layers) {
+        if (!layer)
+            continue;
+        for (const [name, field] of Object.entries(layer.scalarFields || {})) {
+            merged.scalarFields[name] = {
+                name,
+                sourceLayer: layer.sourceLayer,
+                value: field.value,
+                valueType: field.valueType,
+            };
+        }
+        for (const [name, field] of Object.entries(layer.referenceFields || {})) {
+            merged.referenceFields[name] = {
+                name,
+                sourceLayer: layer.sourceLayer,
+                fileId: field.fileId,
+                guid: field.guid,
+                resolvedAssetPath: field.resolvedAssetPath,
+            };
+        }
+    }
+    return merged;
+}
+function normalizeLayers(layersOrArray) {
+    if (layersOrArray.length === 1 && Array.isArray(layersOrArray[0])) {
+        return layersOrArray[0];
+    }
+    return layersOrArray;
+}

package/dist/core/unity/override-merger.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/unity/override-merger.test.js

@@ -0,0 +1,47 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { mergeOverrideChain } from './override-merger.js';
+test('mergeOverrideChain applies base -> variant -> nested -> scene order', () => {
+    const baseComponent = {
+        sourceLayer: 'base',
+        scalarFields: {
+            needPause: { value: '0' },
+            title: { value: 'Base' },
+        },
+        referenceFields: {
+            mainUIDocument: { fileId: '1000', guid: 'base-guid' },
+        },
+    };
+    const variantComponent = {
+        sourceLayer: 'variant',
+        scalarFields: {
+            title: { value: 'Variant' },
+        },
+        referenceFields: {
+            mainUIDocument: { fileId: '2000', guid: 'variant-guid' },
+        },
+    };
+    const nestedComponent = {
+        sourceLayer: 'nested',
+        scalarFields: {
+            subtitle: { value: 'Nested' },
+        },
+    };
+    const sceneOverride = {
+        sourceLayer: 'scene',
+        scalarFields: {
+            needPause: { value: '1' },
+        },
+        referenceFields: {
+            mainUIDocument: { fileId: '11400000', guid: 'scene-guid' },
+        },
+    };
+    const merged = mergeOverrideChain(baseComponent, variantComponent, nestedComponent, sceneOverride);
+    assert.equal(merged.scalarFields.needPause.value, '1');
+    assert.equal(merged.scalarFields.needPause.sourceLayer, 'scene');
+    assert.equal(merged.scalarFields.title.value, 'Variant');
+    assert.equal(merged.scalarFields.title.sourceLayer, 'variant');
+    assert.equal(merged.scalarFields.subtitle.value, 'Nested');
+    assert.equal(merged.referenceFields.mainUIDocument.fileId, '11400000');
+    assert.equal(merged.referenceFields.mainUIDocument.sourceLayer, 'scene');
+});

package/dist/core/unity/resolver.d.ts

@@ -0,0 +1,79 @@
+import type { UnityScanContext } from './scan-context.js';
+import { type UnityObjectType } from './yaml-object-graph.js';
+export type UnityBindingKind = 'direct' | 'prefab-instance' | 'nested' | 'variant' | 'scene-override';
+export interface ResolveInput {
+    repoRoot: string;
+    symbol: string;
+    scanContext?: UnityScanContext;
+}
+export interface UnityScalarField {
+    name: string;
+    value: string;
+    valueType?: string;
+    sourceLayer: string;
+}
+export interface UnityReferenceField {
+    name: string;
+    fileId?: string;
+    guid?: string;
+    resolvedAssetPath?: string;
+    sourceLayer: string;
+}
+export interface UnitySerializedFields {
+    scalarFields: UnityScalarField[];
+    referenceFields: UnityReferenceField[];
+}
+export type UnityReferenceResolution = 'null' | 'local-object' | 'external-asset' | 'unresolved';
+export interface UnityResolvedReferenceTarget {
+    resourcePath?: string;
+    objectId?: string;
+    objectType?: UnityObjectType | string;
+    gameObjectName?: string;
+    assetPath?: string;
+}
+export interface UnityResolvedReference {
+    fieldName: string;
+    sourceLayer: string;
+    fileId?: string;
+    guid?: string;
+    fromList: boolean;
+    listIndex?: number;
+    resolution: UnityReferenceResolution;
+    target?: UnityResolvedReferenceTarget;
+}
+export interface UnityBindingEvidence {
+    line: number;
+    lineText: string;
+}
+export interface UnityAssetRefPathReference {
+    parentFieldName: string;
+    fieldName: string;
+    relativePath: string;
+    sourceLayer: string;
+    isEmpty: boolean;
+    isSprite: boolean;
+}
+export interface ResolvedUnityBinding {
+    resourcePath: string;
+    resourceType: 'prefab' | 'scene' | 'asset';
+    bindingKind: UnityBindingKind;
+    componentObjectId: string;
+    evidence: UnityBindingEvidence;
+    serializedFields: UnitySerializedFields;
+    resolvedReferences: UnityResolvedReference[];
+    assetRefPaths?: UnityAssetRefPathReference[];
+}
+export interface ResolveOutput {
+    symbol: string;
+    scriptPath: string;
+    scriptGuid: string;
+    resourceBindings: ResolvedUnityBinding[];
+    serializedFields: UnitySerializedFields;
+    unityDiagnostics: string[];
+}
+export declare function resolveUnityBindings(input: ResolveInput): Promise<ResolveOutput>;
+export declare function hasCoverage(resultSet: ResolveOutput[]): {
+    hasScalar: boolean;
+    hasReference: boolean;
+};
+export declare function extractAssetRefPathReferences(serializedFields: UnitySerializedFields): UnityAssetRefPathReference[];