@veewo/gitnexus 1.5.0-rc.2 → 1.5.0-rc.4

package/dist/core/ingestion/unity-runtime-binding-rules.js

@@ -51,10 +51,23 @@ export function applyUnityRuntimeBindingRules(graph, rules, _config) {
         else if (rel.type === 'UNITY_COMPONENT_INSTANCE')
             componentInstances.push(rel);
     }
+    // Pre-build scene file index: lowercase scene name → fileId[]
+    const sceneFilesByName = new Map();
+    for (const node of graph.iterNodes()) {
+        if (node.label !== 'File')
+            continue;
+        const filePath = String(node.properties.filePath ?? '');
+        if (!filePath.endsWith('.unity'))
+            continue;
+        const fileName = (filePath.split('/').pop() ?? '').replace(/\.unity$/, '').toLowerCase();
+        const list = sceneFilesByName.get(fileName) ?? [];
+        list.push(node.id);
+        sceneFilesByName.set(fileName, list);
+    }
     for (const rule of rules) {
         let ruleEdges = 0;
         for (const binding of rule.resource_bindings ?? []) {
-            ruleEdges += processBinding(binding, rule.id, assetGuidRefs, componentInstances, methodsByClassId, classNodes, addSyntheticEdge);
+            ruleEdges += processBinding(binding, rule.id, assetGuidRefs, componentInstances, methodsByClassId, classNodes, sceneFilesByName, addSyntheticEdge);
         }
         if (rule.lifecycle_overrides?.additional_entry_points?.length) {
             ruleEdges += processLifecycleOverrides(rule, methodsByClassId, classNodes, addSyntheticEdge);
@@ -78,13 +91,19 @@ function findMethodsOnResource(resourceFileId, componentInstances, methodsByClas
     }
     return results;
 }
-function processBinding(binding, ruleId, assetGuidRefs, componentInstances, methodsByClassId, classNodes, addEdge) {
+function processBinding(binding, ruleId, assetGuidRefs, componentInstances, methodsByClassId, classNodes, sceneFilesByName, addEdge) {
     if (binding.kind === 'asset_ref_loads_components') {
         return processAssetRefLoadsComponents(binding, ruleId, assetGuidRefs, componentInstances, methodsByClassId, addEdge);
     }
     if (binding.kind === 'method_triggers_field_load') {
         return processMethodTriggersFieldLoad(binding, ruleId, assetGuidRefs, componentInstances, methodsByClassId, classNodes, addEdge);
     }
+    if (binding.kind === 'method_triggers_scene_load') {
+        return processMethodTriggersSceneLoad(binding, ruleId, componentInstances, methodsByClassId, classNodes, sceneFilesByName, addEdge);
+    }
+    if (binding.kind === 'method_triggers_method') {
+        return processMethodTriggersMethod(binding, ruleId, methodsByClassId, classNodes, addEdge);
+    }
     return 0;
 }
 function processAssetRefLoadsComponents(binding, ruleId, assetGuidRefs, componentInstances, methodsByClassId, addEdge) {
@@ -157,6 +176,65 @@ function processMethodTriggersFieldLoad(binding, ruleId, assetGuidRefs, componen
     }
     return count;
 }
+function processMethodTriggersSceneLoad(binding, ruleId, componentInstances, methodsByClassId, classNodes, sceneFilesByName, addEdge) {
+    const classPattern = binding.host_class_pattern ? new RegExp(binding.host_class_pattern) : null;
+    const loaderMethodNames = new Set(binding.loader_methods ?? []);
+    const sceneName = binding.scene_name;
+    const defaultEntryPoints = ['OnEnable', 'Awake', 'Start'];
+    const entryPoints = (binding.target_entry_points ?? []).length > 0
+        ? binding.target_entry_points
+        : defaultEntryPoints;
+    if (!classPattern || loaderMethodNames.size === 0 || !sceneName)
+        return 0;
+    const sceneFileIds = sceneFilesByName.get(sceneName.toLowerCase()) ?? [];
+    if (sceneFileIds.length === 0)
+        return 0;
+    let count = 0;
+    for (const cls of classNodes) {
+        if (!classPattern.test(cls.properties.name))
+            continue;
+        const methods = methodsByClassId.get(cls.id) ?? [];
+        const loaders = methods.filter(m => loaderMethodNames.has(m.properties.name));
+        if (loaders.length === 0)
+            continue;
+        for (const sceneFileId of sceneFileIds) {
+            const targetMethods = findMethodsOnResource(sceneFileId, componentInstances, methodsByClassId, entryPoints);
+            for (const loader of loaders) {
+                for (const target of targetMethods) {
+                    if (addEdge(loader.id, target.id, `unity-rule-scene-load:${ruleId}`))
+                        count++;
+                }
+            }
+        }
+    }
+    return count;
+}
+function processMethodTriggersMethod(binding, ruleId, methodsByClassId, classNodes, addEdge) {
+    const { source_class_pattern, source_method, target_class_pattern, target_method } = binding;
+    if (!source_class_pattern || !source_method || !target_class_pattern || !target_method)
+        return 0;
+    const srcPattern = new RegExp(source_class_pattern);
+    const tgtPattern = new RegExp(target_class_pattern);
+    let sourceMethodId;
+    let targetMethodId;
+    for (const cls of classNodes) {
+        if (!sourceMethodId && srcPattern.test(cls.properties.name)) {
+            const match = (methodsByClassId.get(cls.id) ?? []).find(m => m.properties.name === source_method);
+            if (match)
+                sourceMethodId = match.id;
+        }
+        if (!targetMethodId && tgtPattern.test(cls.properties.name)) {
+            const match = (methodsByClassId.get(cls.id) ?? []).find(m => m.properties.name === target_method);
+            if (match)
+                targetMethodId = match.id;
+        }
+        if (sourceMethodId && targetMethodId)
+            break;
+    }
+    if (!sourceMethodId || !targetMethodId)
+        return 0;
+    return addEdge(sourceMethodId, targetMethodId, `unity-rule-method-bridge:${ruleId}`) ? 1 : 0;
+}
 function processLifecycleOverrides(rule, methodsByClassId, classNodes, addEdge) {
     const overrides = rule.lifecycle_overrides;
     if (!overrides?.additional_entry_points?.length)

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

@@ -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 Function TO `Property`,\n  FROM Class TO Method,\n  FROM Class TO Function,\n  FROM Class TO File,\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 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 Interface TO `Property`,\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 `Struct` TO Interface,\n  FROM `Struct` TO `Constructor`,\n  FROM `Struct` TO `Property`,\n  FROM `Enum` TO `Enum`,\n  FROM `Enum` TO Community,\n  FROM `Enum` TO Class,\n  FROM `Enum` TO Interface,\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 Method,\n  FROM `Trait` TO `Constructor`,\n  FROM `Trait` TO `Property`,\n  FROM `Trait` TO Community,\n  FROM `Impl` TO Method,\n  FROM `Impl` TO `Constructor`,\n  FROM `Impl` TO `Property`,\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 `TypeAlias` TO Class,\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 Method,\n  FROM `Record` TO `Constructor`,\n  FROM `Record` TO `Property`,\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 `Constructor` TO `Typedef`,\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 `Const`,\n  FROM Function TO `Typedef`,\n  FROM Function TO `Union`,\n  FROM Function TO `Property`,\n  FROM Class TO Method,\n  FROM Class TO Function,\n  FROM Class TO File,\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 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 Method TO `Record`,\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 Interface TO `Property`,\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 `Struct` TO Interface,\n  FROM `Struct` TO `Constructor`,\n  FROM `Struct` TO `Property`,\n  FROM `Enum` TO `Enum`,\n  FROM `Enum` TO Community,\n  FROM `Enum` TO Class,\n  FROM `Enum` TO Interface,\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 Method,\n  FROM `Trait` TO `Constructor`,\n  FROM `Trait` TO `Property`,\n  FROM `Trait` TO Community,\n  FROM `Impl` TO Method,\n  FROM `Impl` TO `Constructor`,\n  FROM `Impl` TO `Property`,\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 `TypeAlias` TO Class,\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 Method,\n  FROM `Record` TO `Constructor`,\n  FROM `Record` TO `Property`,\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 `Constructor` TO `Typedef`,\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/lbug/schema.js

@@ -262,6 +262,7 @@ CREATE REL TABLE ${REL_TABLE_NAME} (
   FROM Method TO \`Constructor\`,
   FROM Method TO \`Property\`,
   FROM Method TO \`Delegate\`,
+  FROM Method TO \`Record\`,
   FROM \`Template\` TO \`Template\`,
   FROM \`Template\` TO Function,
   FROM \`Template\` TO Method,

package/dist/mcp/local/runtime-claim-rule-registry.d.ts

@@ -9,6 +9,7 @@ export interface RuntimeClaimRuleCatalogEntry {
 export interface RuntimeClaimRule {
     id: string;
     version: string;
+    description?: string;
     trigger_family: string;
     resource_types: string[];
     host_base_type: string[];

package/dist/mcp/local/runtime-claim-rule-registry.js

@@ -173,6 +173,11 @@ export function parseRuleYaml(raw, filePath) {
             binding.host_class_pattern = scalar('host_class_pattern');
             binding.field_name = scalar('field_name');
             binding.loader_methods = list('loader_methods');
+            binding.scene_name = scalar('scene_name');
+            binding.source_class_pattern = scalar('source_class_pattern');
+            binding.source_method = scalar('source_method');
+            binding.target_class_pattern = scalar('target_class_pattern');
+            binding.target_method = scalar('target_method');
             resource_bindings.push(binding);
         }
         if (resource_bindings.length === 0)

package/dist/rule-lab/types.d.ts

@@ -76,12 +76,18 @@ export interface RuleDslClaims {
     next_action: string;
 }
 export interface UnityResourceBinding {
-    kind: 'asset_ref_loads_components' | 'method_triggers_field_load';
+    kind: 'asset_ref_loads_components' | 'method_triggers_field_load' | 'method_triggers_scene_load' | 'method_triggers_method';
+    description?: string;
     ref_field_pattern?: string;
     target_entry_points?: string[];
     host_class_pattern?: string;
     field_name?: string;
     loader_methods?: string[];
+    scene_name?: string;
+    source_class_pattern?: string;
+    source_method?: string;
+    target_class_pattern?: string;
+    target_method?: string;
 }
 export interface LifecycleOverrides {
     additional_entry_points?: string[];
@@ -90,6 +96,7 @@ export interface LifecycleOverrides {
 export interface RuleDslDraft {
     id: string;
     version: string;
+    description?: string;
     match: RuleDslMatch;
     topology: RuleDslTopologyHop[];
     closure: RuleDslClosure;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veewo/gitnexus",
-  "version": "1.5.0-rc.2",
+  "version": "1.5.0-rc.4",
   "description": "Graph-powered code intelligence for AI agents. Index any codebase, query via MCP or CLI.",
   "author": "Abhigyan Patwari",
   "license": "PolyForm-Noncommercial-1.0.0",

package/skills/gitnexus-unity-rule-gen.md

@@ -59,6 +59,7 @@ loop:
 | 目标入口方法 | 加载的资源上哪些方法会被触发？ | OnEnable, Awake |
 | 持有字段的类 | 哪些类持有触发加载的字段？ | WeaponPowerUp |
 | 加载方法 | 哪些方法触发资源加载？ | Equip |
+| 动态跳转 | 链路中是否有事件派发或回调（C# Action/SyncList/delegate）？ | `NetEventHub.OnPickUpItem → OnClientPickItUp` |
 | 额外 lifecycle | 项目有自定义入口方法吗？ | Init |
 | lifecycle 范围 | 自定义入口方法的作用范围？ | Assets/Code/Graph |
 
@@ -111,6 +112,8 @@ Grep: pattern="void Init\b|void Setup\b" path=<Assets目录>
 |---------|-------------|------|
 | asset GUID 引用 → 目标资源组件激活 | `asset_ref_loads_components` | 序列化字段引用 asset，加载时触发组件 lifecycle |
 | 方法调用 → 字段引用的资源加载 | `method_triggers_field_load` | 特定方法触发序列化字段引用的资源加载 |
+| 方法调用 → SceneManager.LoadScene → 场景组件激活 | `method_triggers_scene_load` | 特定方法触发场景加载，场景中组件 lifecycle 被触发 |
+| 动态跳转（事件派发/回调/delegate，静态分析不可见） | `method_triggers_method` | 声明"方法 A 动态触发方法 B"，注入合成 CALLS 边桥接 gap |
 | 项目自定义入口方法 | `lifecycle_overrides` | 非标准 Unity lifecycle 的自定义入口 |
 
 ### 1.5 生成规则 YAML
@@ -121,6 +124,9 @@ Grep: pattern="void Init\b|void Setup\b" path=<Assets目录>
 id: unity.<scenario-name>.v2
 version: 2.0.0
 family: analyze_rules
+description: >-
+  （可选）描述该规则覆盖的业务场景和调用链背景，
+  包括动态跳转的机制说明（事件派发/回调绑定等）。
 trigger_family: <scenario-name>
 resource_types:
   - asset
@@ -153,6 +159,30 @@ resource_bindings:
     loader_methods:
       - <method_name>
 
+  # 类型 C（可选）：方法触发场景加载，场景中组件 lifecycle 被触发
+  - kind: method_triggers_scene_load
+    host_class_pattern: "<class_pattern>"
+    loader_methods:
+      - <method_name>
+    scene_name: "<scene_name>"           # 匹配 .unity 文件名（不含扩展名）
+    target_entry_points:
+      - Awake
+      - Start
+      - OnEnable
+
+  # 类型 D（可选）：声明静态分析无法捕获的动态跳转（事件派发/回调/delegate）
+  # 适用场景：C# Action/UnityEvent 事件派发、Mirror SyncList 回调、delegate 绑定等
+  # 注入一条 source_method → target_method 的合成 CALLS 边（精确匹配，一条边）
+  - kind: method_triggers_method
+    description: >-
+      说明动态跳转的机制：例如"A 通过 EventHub.OnXxx?.Invoke() 触发，
+      B 在初始化时订阅该事件"，或"A 调用 SyncList.Add()，
+      触发 SyncList.Callback 回调到 B"
+    source_class_pattern: "<source_class_regex>"   # 例如 "^PlayerActor$"
+    source_method: "<source_method_name>"           # 例如 "ProcessInteractables"
+    target_class_pattern: "<target_class_regex>"   # 例如 "^NetPlayer$"
+    target_method: "<target_method_name>"           # 例如 "OnClientPickItUp"
+
 lifecycle_overrides:
   additional_entry_points:
     - <custom_entry>
@@ -286,13 +316,15 @@ mcp__gitnexus__cypher:
         WHEN r.reason CONTAINS 'resource-load' THEN 'resource-load'
         WHEN r.reason CONTAINS 'lifecycle-override' THEN 'lifecycle-override'
         WHEN r.reason CONTAINS 'loader-bridge' THEN 'loader-bridge'
+        WHEN r.reason CONTAINS 'scene-load' THEN 'scene-load'
+        WHEN r.reason CONTAINS 'method-bridge' THEN 'method-bridge'
         ELSE 'other'
       END AS edgeKind,
       count(*) AS cnt
   repo: <repo-name>
 ```
 
-**PASS**: 三种边类型（resource-load, lifecycle-override, loader-bridge）均有产出。
+**PASS**: 规则涉及的边类型均有产出（`method_triggers_method` 对应 `method-bridge`）。
 
 ---
 
@@ -302,9 +334,12 @@ mcp__gitnexus__cypher:
 |------|---------|---------|
 | 验证 1 失败（0 合成边） | 规则未被 compile 或 family 不对 | 检查 catalog.json + compiled bundle |
 | 验证 1 部分（只有 resource-load） | method_triggers_field_load 参数错误 | 检查 host_class_pattern / loader_methods |
+| 验证 1 部分（无 scene-load） | method_triggers_scene_load 参数错误 | 检查 scene_name 是否匹配 .unity 文件名 |
+| 验证 1 部分（无 method-bridge） | method_triggers_method 类名/方法名不匹配 | 检查 source/target_class_pattern 和 source/target_method 是否与图谱中节点名一致 |
 | 验证 2 失败（rule_not_matched） | trigger_tokens 未匹配查询文本 | 调整 match.trigger_tokens |
 | 验证 2 失败（verification_failed） | 合成边 reason 中的 ruleId 不匹配 | 检查规则 ID 一致性 |
 | 验证 3 失败（无 Process） | 合成边 confidence 过低 | 检查 RULE_EDGE_CONFIDENCE（应为 0.75） |
+| 验证 4 链路断裂（中间有动态跳转） | 事件派发/回调/delegate 无静态 CALLS 边 | 添加 `method_triggers_method` binding 桥接动态跳转 |
 | lifecycle_overrides 无效 | scope 值不是文件路径前缀 | scope 应匹配 filePath 而非类名 |
 
 ---
@@ -314,5 +349,5 @@ mcp__gitnexus__cypher:
 - 设计文档：`docs/plans/2026-04-04-unity-rule-gen-skill-design.md`
 - YAML 格式定义：设计文档 section 3.3
 - 注入逻辑：`gitnexus/src/core/ingestion/unity-runtime-binding-rules.ts`
-- 规则类型定义：`gitnexus/src/rule-lab/types.ts:90-102`
+- 规则类型定义：`gitnexus/src/rule-lab/types.ts:90-114`
 - 编译命令：`gitnexus rule-lab compile --repo-path <path>`