@veewo/gitnexus 1.5.0-rc → 1.5.0-rc.3

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/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,7 @@ 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');
             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",
+  "version": "1.5.0-rc.3",
   "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-cli.md

@@ -48,8 +48,11 @@ Run from the project root. This parses all source files, builds the knowledge gr
 | `--embeddings`             | Enable embedding generation for semantic search (off by default)                          |
 | `--extensions <ext>`       | Limit parsing to specific file types (e.g., `--extensions ".cs .meta"` for Unity)        |
 | `--scope-prefix <prefix>`  | Limit analysis to a path prefix (e.g., `--scope-prefix Assets/` for Unity)               |
+| `--scope-manifest <file>`  | Read scope rules from a manifest file (e.g., `.gitnexus/sync-manifest.txt`)              |
 | `--skills`                 | Generate repo-specific skill files from detected code communities                         |
 
+**Scope manifest syntax:** Each line is a **path prefix** (not glob). `Assets/Code` matches all files under `Assets/Code/`. Trailing `*` is a wildcard prefix (`Packages/com.veewo.*` matches `Packages/com.veewo.stat/...`). Lines starting with `#` are comments. Do **not** use glob patterns like `**/*.cs` — they will match nothing. Use `--extensions` for file type filtering instead.
+
 **When to run:** First time in a project, after major code changes, or when `gitnexus://repo/{name}/context` reports the index is stale. In Claude Code, a PostToolUse hook runs `analyze` automatically after `git commit` and `git merge`, preserving embeddings if previously generated.
 
 **Unity projects:** Add `--extensions ".cs .meta"` to ensure Unity asset edges (`UNITY_ASSET_GUID_REF`, `UNITY_COMPONENT_INSTANCE`) are parsed. Add `--scope-prefix Assets/` to limit scope if all code lives under `Assets/`.

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>`