@veewo/gitnexus 1.4.8 → 1.4.9-rc

package/dist/core/unity/ui-trace.test.js

@@ -0,0 +1,183 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { runUnityUiTrace } from './ui-trace.js';
+const here = path.dirname(fileURLToPath(import.meta.url));
+const fixtureRoot = path.resolve(here, '../../../src/core/unity/__fixtures__/mini-unity-ui');
+test('resolves asset_refs with strict path+line evidence chain', async () => {
+    const out = await runUnityUiTrace({
+        repoRoot: fixtureRoot,
+        target: 'EliteBossScreenController',
+        goal: 'asset_refs',
+    });
+    assert.equal(out.goal, 'asset_refs');
+    assert.equal(out.results.length, 1);
+    assert.equal(out.results[0].evidence_chain.every((hop) => Boolean(hop.path) && hop.line > 0), true);
+});
+test('resolves template_refs from target uxml', async () => {
+    const out = await runUnityUiTrace({
+        repoRoot: fixtureRoot,
+        target: 'Assets/UI/Screens/DressUpScreenNew.uxml',
+        goal: 'template_refs',
+    });
+    assert.equal(out.goal, 'template_refs');
+    assert.equal(out.results.length, 1);
+    assert.equal(out.results[0].evidence_chain[1].path, 'Assets/UI/Components/TooltipBox.uxml');
+});
+test('resolves selector_bindings for static csharp selector usage', async () => {
+    const out = await runUnityUiTrace({
+        repoRoot: fixtureRoot,
+        target: 'EliteBossScreenController',
+        goal: 'selector_bindings',
+    });
+    assert.equal(out.goal, 'selector_bindings');
+    assert.equal(out.results.length, 1);
+    assert.equal(out.results[0].evidence_chain.every((hop) => Boolean(hop.path) && hop.line > 0), true);
+});
+test('resolves selector_bindings when target is a UXML path', async () => {
+    const out = await runUnityUiTrace({
+        repoRoot: fixtureRoot,
+        target: 'Assets/UI/Screens/EliteBossScreenNew.uxml',
+        goal: 'selector_bindings',
+    });
+    assert.equal(out.goal, 'selector_bindings');
+    assert.equal(out.results.length, 1);
+    assert.equal(out.results[0].evidence_chain[0].path.endsWith('.cs'), true);
+    assert.equal(out.results[0].evidence_chain[1].path.endsWith('.uss'), true);
+});
+test('selector_bindings path target uses UXML->resource->m_Script chain before filename fallback', async () => {
+    const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'gitnexus-ui-trace-selector-chain-'));
+    await fs.mkdir(path.join(tempRoot, 'Assets/UI/Screens'), { recursive: true });
+    await fs.mkdir(path.join(tempRoot, 'Assets/UI/Styles'), { recursive: true });
+    await fs.mkdir(path.join(tempRoot, 'Assets/Prefabs'), { recursive: true });
+    await fs.mkdir(path.join(tempRoot, 'Assets/Scripts'), { recursive: true });
+    await fs.writeFile(path.join(tempRoot, 'Assets/UI/Screens/FeaturePanelNew.uxml'), '<ui:UXML xmlns:ui="UnityEngine.UIElements"><ui:Style src="project://database/Assets/UI/Styles/FeaturePanel.uss?guid=bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb&amp;type=3" /></ui:UXML>\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/UI/Screens/FeaturePanelNew.uxml.meta'), 'fileFormatVersion: 2\nguid: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/UI/Styles/FeaturePanel.uss'), '.feature-panel { color: red; }\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/UI/Styles/FeaturePanel.uss.meta'), 'fileFormatVersion: 2\nguid: bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/Scripts/PanelBinder.cs'), 'public class PanelBinder { void Bind() { root.AddToClassList("feature-panel"); } }\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/Scripts/PanelBinder.cs.meta'), 'fileFormatVersion: 2\nguid: cccccccccccccccccccccccccccccccc\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/Prefabs/FeaturePanel.prefab'), [
+        '%YAML 1.1',
+        '--- !u!114 &11400000',
+        'MonoBehaviour:',
+        '  m_Script: {fileID: 11500000, guid: cccccccccccccccccccccccccccccccc, type: 3}',
+        '  runtimeViewAsset: {fileID: 9197481963319205126, guid: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa, type: 3}',
+    ].join('\n'), 'utf-8');
+    const out = await runUnityUiTrace({
+        repoRoot: tempRoot,
+        target: 'Assets/UI/Screens/FeaturePanelNew.uxml',
+        goal: 'selector_bindings',
+    });
+    assert.equal(out.results.length, 1);
+    assert.equal(out.results[0].evidence_chain[0].path, 'Assets/Scripts/PanelBinder.cs');
+    assert.equal(out.results[0].evidence_chain[1].path, 'Assets/UI/Styles/FeaturePanel.uss');
+    await fs.rm(tempRoot, { recursive: true, force: true });
+});
+test('selector_bindings matches class token inside composite USS selectors', async () => {
+    const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'gitnexus-ui-trace-composite-selector-'));
+    await fs.mkdir(path.join(tempRoot, 'Assets/UI/Screens'), { recursive: true });
+    await fs.mkdir(path.join(tempRoot, 'Assets/UI/Styles'), { recursive: true });
+    await fs.mkdir(path.join(tempRoot, 'Assets/Prefabs'), { recursive: true });
+    await fs.mkdir(path.join(tempRoot, 'Assets/Scripts'), { recursive: true });
+    await fs.writeFile(path.join(tempRoot, 'Assets/UI/Screens/CompositePanelNew.uxml'), '<ui:UXML xmlns:ui="UnityEngine.UIElements"><ui:Style src="project://database/Assets/UI/Styles/CompositePanel.uss?guid=bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb&amp;type=3" /></ui:UXML>\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/UI/Screens/CompositePanelNew.uxml.meta'), 'fileFormatVersion: 2\nguid: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/UI/Styles/CompositePanel.uss'), '.isLock .preview-icon { opacity: 0.4; }\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/UI/Styles/CompositePanel.uss.meta'), 'fileFormatVersion: 2\nguid: bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/Scripts/CompositeBinder.cs'), 'public class CompositeBinder { void Bind() { root.AddToClassList("isLock"); } }\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/Scripts/CompositeBinder.cs.meta'), 'fileFormatVersion: 2\nguid: cccccccccccccccccccccccccccccccc\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/Prefabs/CompositePanel.prefab'), [
+        '%YAML 1.1',
+        '--- !u!114 &11400000',
+        'MonoBehaviour:',
+        '  m_Script: {fileID: 11500000, guid: cccccccccccccccccccccccccccccccc, type: 3}',
+        '  runtimeViewAsset: {fileID: 9197481963319205126, guid: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa, type: 3}',
+    ].join('\n'), 'utf-8');
+    const out = await runUnityUiTrace({
+        repoRoot: tempRoot,
+        target: 'Assets/UI/Screens/CompositePanelNew.uxml',
+        goal: 'selector_bindings',
+    });
+    assert.equal(out.results.length, 1);
+    assert.equal(out.results[0].evidence_chain[0].path, 'Assets/Scripts/CompositeBinder.cs');
+    assert.equal(out.results[0].evidence_chain[1].path, 'Assets/UI/Styles/CompositePanel.uss');
+    await fs.rm(tempRoot, { recursive: true, force: true });
+});
+test('selector_bindings ranks resource-chain matches ahead of name-fallback matches', async () => {
+    const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'gitnexus-ui-trace-ranking-'));
+    await fs.mkdir(path.join(tempRoot, 'Assets/UI/Screens'), { recursive: true });
+    await fs.mkdir(path.join(tempRoot, 'Assets/UI/Styles'), { recursive: true });
+    await fs.mkdir(path.join(tempRoot, 'Assets/Prefabs'), { recursive: true });
+    await fs.mkdir(path.join(tempRoot, 'Assets/Scripts'), { recursive: true });
+    await fs.writeFile(path.join(tempRoot, 'Assets/UI/Screens/RankPanelNew.uxml'), '<ui:UXML xmlns:ui="UnityEngine.UIElements"><ui:Style src="project://database/Assets/UI/Styles/RankPanel.uss?guid=bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb&amp;type=3" /></ui:UXML>\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/UI/Screens/RankPanelNew.uxml.meta'), 'fileFormatVersion: 2\nguid: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/UI/Styles/RankPanel.uss'), '.active .rank-icon { opacity: 1; }\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/UI/Styles/RankPanel.uss.meta'), 'fileFormatVersion: 2\nguid: bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/Scripts/ResourceDriver.cs'), 'public class ResourceDriver { void Bind() { root.AddToClassList("active"); } }\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/Scripts/ResourceDriver.cs.meta'), 'fileFormatVersion: 2\nguid: cccccccccccccccccccccccccccccccc\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/Scripts/RankPanel.cs'), 'public class RankPanel { void Bind() { root.AddToClassList("active"); } }\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/Scripts/RankPanel.cs.meta'), 'fileFormatVersion: 2\nguid: dddddddddddddddddddddddddddddddd\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/Prefabs/RankPanel.prefab'), [
+        '%YAML 1.1',
+        '--- !u!114 &11400000',
+        'MonoBehaviour:',
+        '  m_Script: {fileID: 11500000, guid: cccccccccccccccccccccccccccccccc, type: 3}',
+        '  runtimeViewAsset: {fileID: 9197481963319205126, guid: aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa, type: 3}',
+    ].join('\n'), 'utf-8');
+    const out = await runUnityUiTrace({
+        repoRoot: tempRoot,
+        target: 'Assets/UI/Screens/RankPanelNew.uxml',
+        goal: 'selector_bindings',
+    });
+    assert.equal(out.results.length, 2);
+    assert.equal(out.results[0].evidence_chain[0].path, 'Assets/Scripts/ResourceDriver.cs');
+    assert.equal(out.results[1].evidence_chain[0].path, 'Assets/Scripts/RankPanel.cs');
+    assert.equal((out.results[0].score || 0) > (out.results[1].score || 0), true);
+    assert.equal(out.results[0].confidence, 'high');
+    assert.equal(out.results[1].confidence, 'medium');
+    await fs.rm(tempRoot, { recursive: true, force: true });
+});
+test('enforces unique-result gate and returns ambiguity diagnostics', async () => {
+    const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'gitnexus-ui-trace-ambiguity-'));
+    await fs.cp(fixtureRoot, tempRoot, { recursive: true });
+    await fs.writeFile(path.join(tempRoot, 'Assets/UI/Screens/EliteBossScreen.uxml'), '<ui:UXML xmlns:ui="UnityEngine.UIElements"><ui:VisualElement /></ui:UXML>\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/UI/Screens/EliteBossScreen.uxml.meta'), 'fileFormatVersion: 2\nguid: 12121212121212121212121212121212\n', 'utf-8');
+    const out = await runUnityUiTrace({
+        repoRoot: tempRoot,
+        target: 'EliteBossScreenController',
+        goal: 'asset_refs',
+    });
+    assert.deepEqual(out.results, []);
+    assert.equal(out.diagnostics[0].code, 'ambiguous');
+    assert.equal(Boolean(out.diagnostics[0].candidates[0].path), true);
+    assert.equal(out.diagnostics[0].candidates[0].line > 0, true);
+    await fs.rm(tempRoot, { recursive: true, force: true });
+});
+test('treats existing UXML path target as unique even when canonical names collide', async () => {
+    const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'gitnexus-ui-trace-path-'));
+    await fs.cp(fixtureRoot, tempRoot, { recursive: true });
+    await fs.mkdir(path.join(tempRoot, 'Assets/UI/Legacy'), { recursive: true });
+    await fs.writeFile(path.join(tempRoot, 'Assets/UI/Legacy/EliteBossScreen.uxml'), '<ui:UXML xmlns:ui="UnityEngine.UIElements"><ui:VisualElement /></ui:UXML>\n', 'utf-8');
+    await fs.writeFile(path.join(tempRoot, 'Assets/UI/Legacy/EliteBossScreen.uxml.meta'), 'fileFormatVersion: 2\nguid: 34343434343434343434343434343434\n', 'utf-8');
+    const out = await runUnityUiTrace({
+        repoRoot: tempRoot,
+        target: 'Assets/UI/Screens/EliteBossScreenNew.uxml',
+        goal: 'asset_refs',
+    });
+    assert.equal(out.diagnostics.length, 0);
+    assert.equal(out.results.length, 1);
+    assert.equal(out.results[0].evidence_chain[1].path, 'Assets/UI/Screens/EliteBossScreenNew.uxml');
+    await fs.rm(tempRoot, { recursive: true, force: true });
+});
+test('ensures no graph mutations occur in query-time engine', async () => {
+    const mockGraphAddRelationship = () => { };
+    await runUnityUiTrace({
+        repoRoot: fixtureRoot,
+        target: 'EliteBossScreenController',
+        goal: 'asset_refs',
+    });
+    assert.equal(typeof mockGraphAddRelationship, 'function');
+});

package/dist/core/unity/uss-selector-parser.d.ts

@@ -0,0 +1,6 @@
+export interface UssSelectorEvidence {
+    selector: string;
+    line: number;
+    snippet: string;
+}
+export declare function parseUssSelectors(content: string): UssSelectorEvidence[];

package/dist/core/unity/uss-selector-parser.js

@@ -0,0 +1,21 @@
+export function parseUssSelectors(content) {
+    const out = [];
+    const lines = content.split(/\r?\n/);
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i];
+        if (!line.includes('{'))
+            continue;
+        const selectorChunk = line.split('{', 1)[0];
+        const rawSelectors = selectorChunk.split(',').map((item) => item.trim()).filter(Boolean);
+        for (const selector of rawSelectors) {
+            if (!selector.startsWith('.'))
+                continue;
+            out.push({
+                selector,
+                line: i + 1,
+                snippet: line.trim(),
+            });
+        }
+    }
+    return out;
+}

package/dist/core/unity/uss-selector-parser.test.d.ts

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

package/dist/core/unity/uss-selector-parser.test.js

@@ -0,0 +1,13 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseUssSelectors } from './uss-selector-parser.js';
+const here = path.dirname(fileURLToPath(import.meta.url));
+const fixtureRoot = path.resolve(here, '../../../src/core/unity/__fixtures__/mini-unity-ui');
+test('extracts uss selectors with line evidence', async () => {
+    const source = await fs.readFile(path.join(fixtureRoot, 'Assets/UI/Styles/EliteBossScreenNew.uss'), 'utf-8');
+    const selectors = parseUssSelectors(source);
+    assert.equal(selectors.some((entry) => entry.selector === '.tooltip-box' && entry.line > 0), true);
+});

package/dist/core/unity/uxml-ref-parser.d.ts

@@ -0,0 +1,10 @@
+export interface UxmlRefEvidence {
+    guid: string;
+    line: number;
+    snippet: string;
+}
+export interface ParsedUxmlRefs {
+    templates: UxmlRefEvidence[];
+    styles: UxmlRefEvidence[];
+}
+export declare function parseUxmlRefs(content: string): ParsedUxmlRefs;

package/dist/core/unity/uxml-ref-parser.js

@@ -0,0 +1,22 @@
+const GUID_PARAM_PATTERN = /\bguid=([0-9a-f]{32})\b/i;
+export function parseUxmlRefs(content) {
+    const templates = [];
+    const styles = [];
+    const lines = content.split(/\r?\n/);
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i];
+        const guidMatch = line.match(GUID_PARAM_PATTERN);
+        if (!guidMatch)
+            continue;
+        const entry = {
+            guid: guidMatch[1].toLowerCase(),
+            line: i + 1,
+            snippet: line.trim(),
+        };
+        if (/<\s*(?:[A-Za-z_][\w.-]*\s*:\s*)?Template\b/i.test(line))
+            templates.push(entry);
+        if (/<\s*(?:[A-Za-z_][\w.-]*\s*:\s*)?Style\b/i.test(line))
+            styles.push(entry);
+    }
+    return { templates, styles };
+}

package/dist/core/unity/uxml-ref-parser.test.d.ts

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

package/dist/core/unity/uxml-ref-parser.test.js

@@ -0,0 +1,31 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseUxmlRefs } from './uxml-ref-parser.js';
+const here = path.dirname(fileURLToPath(import.meta.url));
+const fixtureRoot = path.resolve(here, '../../../src/core/unity/__fixtures__/mini-unity-ui');
+test('extracts uxml template/style refs with line evidence', async () => {
+    const source = await fs.readFile(path.join(fixtureRoot, 'Assets/UI/Screens/EliteBossScreenNew.uxml'), 'utf-8');
+    const out = parseUxmlRefs(source);
+    assert.equal(out.templates.length > 0, true);
+    assert.equal(out.styles.length > 0, true);
+    assert.equal(out.templates[0].guid, 'cccccccccccccccccccccccccccccccc');
+    assert.equal(out.styles[0].guid, 'dddddddddddddddddddddddddddddddd');
+    assert.equal(out.templates[0].line > 0, true);
+    assert.equal(out.styles[0].line > 0, true);
+});
+test('supports namespaced ui:Template and ui:Style tags', () => {
+    const source = [
+        '<ui:UXML xmlns:ui="UnityEngine.UIElements">',
+        '  <ui:Style src="project://database/Assets/UI/Styles/A.uss?guid=11111111111111111111111111111111&amp;type=3" />',
+        '  <ui:Template src="project://database/Assets/UI/Components/B.uxml?guid=22222222222222222222222222222222&amp;type=3" />',
+        '</ui:UXML>',
+    ].join('\n');
+    const out = parseUxmlRefs(source);
+    assert.equal(out.styles.length, 1);
+    assert.equal(out.templates.length, 1);
+    assert.equal(out.styles[0].guid, '11111111111111111111111111111111');
+    assert.equal(out.templates[0].guid, '22222222222222222222222222222222');
+});

package/dist/mcp/local/local-backend.d.ts

@@ -13,6 +13,18 @@ import { type RegistryEntry } from '../../storage/repo-manager.js';
  * Matches common test file patterns across all supported languages.
  */
 export declare function isTestFilePath(filePath: string): boolean;
+export interface ExpandedSymbolCandidate {
+    id: string;
+    name: string;
+    type: string;
+    filePath: string;
+    startLine?: number;
+    endLine?: number;
+}
+export declare function filterBm25ResultsByScopePreset<T extends {
+    filePath?: string;
+}>(rows: T[], scopePreset?: string): T[];
+export declare function rankExpandedSymbolsForQuery(symbols: ExpandedSymbolCandidate[], query: string, limit?: number, scopePreset?: string): ExpandedSymbolCandidate[];
 export declare function mergeUnityBindings(baseBindings: ResolvedUnityBinding[], resolvedByPath: Map<string, ResolvedUnityBinding[]>): ResolvedUnityBinding[];
 export declare function mergeParityUnityBindings(baseNonLightweightBindings: ResolvedUnityBinding[], resolvedBindings: ResolvedUnityBinding[]): ResolvedUnityBinding[];
 export declare function attachUnityHydrationMeta(payload: UnityContextPayload, input: Pick<UnityHydrationMeta, 'requestedMode' | 'effectiveMode' | 'elapsedMs' | 'fallbackToCompact'> & {
@@ -97,6 +109,7 @@ export declare class LocalBackend {
         stats?: any;
     }>>;
     callTool(method: string, params: any): Promise<any>;
+    private unityUiTrace;
     /**
      * Query tool — process-grouped search.
      *