gitnexus 1.6.2-rc.23 → 1.6.2-rc.24
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli/ai-context.js +0 -58
- package/package.json +3 -3
package/dist/cli/ai-context.js
CHANGED
|
@@ -70,19 +70,6 @@ This project is indexed by GitNexus as **${projectName}**${noStats ? '' : ` (${s
|
|
|
70
70
|
- When exploring unfamiliar code, use \`gitnexus_query({query: "concept"})\` to find execution flows instead of grepping. It returns process-grouped results ranked by relevance.
|
|
71
71
|
- When you need full context on a specific symbol — callers, callees, which execution flows it participates in — use \`gitnexus_context({name: "symbolName"})\`.
|
|
72
72
|
|
|
73
|
-
## When Debugging
|
|
74
|
-
|
|
75
|
-
1. \`gitnexus_query({query: "<error or symptom>"})\` — find execution flows related to the issue
|
|
76
|
-
2. \`gitnexus_context({name: "<suspect function>"})\` — see all callers, callees, and process participation
|
|
77
|
-
3. \`READ gitnexus://repo/${projectName}/process/{processName}\` — trace the full execution flow step by step
|
|
78
|
-
4. For regressions: \`gitnexus_detect_changes({scope: "compare", base_ref: "main"})\` — see what your branch changed
|
|
79
|
-
|
|
80
|
-
## When Refactoring
|
|
81
|
-
|
|
82
|
-
- **Renaming**: MUST use \`gitnexus_rename({symbol_name: "old", new_name: "new", dry_run: true})\` first. Review the preview — graph edits are safe, text_search edits need manual review. Then run with \`dry_run: false\`.
|
|
83
|
-
- **Extracting/Splitting**: MUST run \`gitnexus_context({name: "target"})\` to see all incoming/outgoing refs, then \`gitnexus_impact({target: "target", direction: "upstream"})\` to find all external callers before moving code.
|
|
84
|
-
- After any refactor: run \`gitnexus_detect_changes({scope: "all"})\` to verify only expected files changed.
|
|
85
|
-
|
|
86
73
|
## Never Do
|
|
87
74
|
|
|
88
75
|
- NEVER edit a function, class, or method without first running \`gitnexus_impact\` on it.
|
|
@@ -90,25 +77,6 @@ This project is indexed by GitNexus as **${projectName}**${noStats ? '' : ` (${s
|
|
|
90
77
|
- NEVER rename symbols with find-and-replace — use \`gitnexus_rename\` which understands the call graph.
|
|
91
78
|
- NEVER commit changes without running \`gitnexus_detect_changes()\` to check affected scope.
|
|
92
79
|
|
|
93
|
-
## Tools Quick Reference
|
|
94
|
-
|
|
95
|
-
| Tool | When to use | Command |
|
|
96
|
-
|------|-------------|---------|
|
|
97
|
-
| \`query\` | Find code by concept | \`gitnexus_query({query: "auth validation"})\` |
|
|
98
|
-
| \`context\` | 360-degree view of one symbol | \`gitnexus_context({name: "validateUser"})\` |
|
|
99
|
-
| \`impact\` | Blast radius before editing | \`gitnexus_impact({target: "X", direction: "upstream"})\` |
|
|
100
|
-
| \`detect_changes\` | Pre-commit scope check | \`gitnexus_detect_changes({scope: "staged"})\` |
|
|
101
|
-
| \`rename\` | Safe multi-file rename | \`gitnexus_rename({symbol_name: "old", new_name: "new", dry_run: true})\` |
|
|
102
|
-
| \`cypher\` | Custom graph queries | \`gitnexus_cypher({query: "MATCH ..."})\` |
|
|
103
|
-
|
|
104
|
-
## Impact Risk Levels
|
|
105
|
-
|
|
106
|
-
| Depth | Meaning | Action |
|
|
107
|
-
|-------|---------|--------|
|
|
108
|
-
| d=1 | WILL BREAK — direct callers/importers | MUST update these |
|
|
109
|
-
| d=2 | LIKELY AFFECTED — indirect deps | Should test |
|
|
110
|
-
| d=3 | MAY NEED TESTING — transitive | Test if critical path |
|
|
111
|
-
|
|
112
80
|
## Resources
|
|
113
81
|
|
|
114
82
|
| Resource | Use for |
|
|
@@ -118,32 +86,6 @@ This project is indexed by GitNexus as **${projectName}**${noStats ? '' : ` (${s
|
|
|
118
86
|
| \`gitnexus://repo/${projectName}/processes\` | All execution flows |
|
|
119
87
|
| \`gitnexus://repo/${projectName}/process/{name}\` | Step-by-step execution trace |
|
|
120
88
|
|
|
121
|
-
## Self-Check Before Finishing
|
|
122
|
-
|
|
123
|
-
Before completing any code modification task, verify:
|
|
124
|
-
1. \`gitnexus_impact\` was run for all modified symbols
|
|
125
|
-
2. No HIGH/CRITICAL risk warnings were ignored
|
|
126
|
-
3. \`gitnexus_detect_changes()\` confirms changes match expected scope
|
|
127
|
-
4. All d=1 (WILL BREAK) dependents were updated
|
|
128
|
-
|
|
129
|
-
## Keeping the Index Fresh
|
|
130
|
-
|
|
131
|
-
After committing code changes, the GitNexus index becomes stale. Re-run analyze to update it:
|
|
132
|
-
|
|
133
|
-
\`\`\`bash
|
|
134
|
-
npx gitnexus analyze
|
|
135
|
-
\`\`\`
|
|
136
|
-
|
|
137
|
-
If the index previously included embeddings, preserve them by adding \`--embeddings\`:
|
|
138
|
-
|
|
139
|
-
\`\`\`bash
|
|
140
|
-
npx gitnexus analyze --embeddings
|
|
141
|
-
\`\`\`
|
|
142
|
-
|
|
143
|
-
To check whether embeddings exist, inspect \`.gitnexus/meta.json\` — the \`stats.embeddings\` field shows the count (0 means no embeddings). **Running analyze without \`--embeddings\` will delete any previously generated embeddings.**
|
|
144
|
-
|
|
145
|
-
> Claude Code users: A PostToolUse hook handles this automatically after \`git commit\` and \`git merge\`.
|
|
146
|
-
|
|
147
89
|
${groupNames && groupNames.length > 0
|
|
148
90
|
? `## Cross-Repo Groups
|
|
149
91
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "gitnexus",
|
|
3
|
-
"version": "1.6.2-rc.
|
|
3
|
+
"version": "1.6.2-rc.24",
|
|
4
4
|
"description": "Graph-powered code intelligence for AI agents. Index any codebase, query via MCP or CLI.",
|
|
5
5
|
"author": "Abhigyan Patwari",
|
|
6
6
|
"license": "PolyForm-Noncommercial-1.0.0",
|
|
@@ -51,7 +51,7 @@
|
|
|
51
51
|
"prepack": "node scripts/build.js"
|
|
52
52
|
},
|
|
53
53
|
"dependencies": {
|
|
54
|
-
"@huggingface/transformers": "^
|
|
54
|
+
"@huggingface/transformers": "^4.1.0",
|
|
55
55
|
"@ladybugdb/core": "^0.15.2",
|
|
56
56
|
"@modelcontextprotocol/sdk": "^1.0.0",
|
|
57
57
|
"@scarf/scarf": "^1.4.0",
|
|
@@ -66,7 +66,7 @@
|
|
|
66
66
|
"ignore": "^7.0.5",
|
|
67
67
|
"js-yaml": "^4.1.1",
|
|
68
68
|
"lru-cache": "^11.0.0",
|
|
69
|
-
"mnemonist": "^0.
|
|
69
|
+
"mnemonist": "^0.40.3",
|
|
70
70
|
"onnxruntime-node": "^1.24.0",
|
|
71
71
|
"pandemonium": "^2.4.0",
|
|
72
72
|
"tree-sitter": "^0.21.1",
|