GitNexus/gitnexus/CHANGELOG.md

Changelog

All notable changes to GitNexus will be documented in this file.

[1.5.2] - 2026-04-01

Fixed

• gitnexus-shared module not found — gitnexus-shared was a file: workspace dependency never published to npm, causing ERR_MODULE_NOT_FOUND when installing gitnexus globally. The build now bundles shared code into dist/_shared/ and rewrites imports to relative paths (#613)
• v1.5.1 publish regression — npm's prepare lifecycle ran tsc after prepack, overwriting the rewritten imports before packing; both scripts now run the full build so the final tarball is always correct

[1.5.1] - 2026-04-01 [YANKED]

Fixed

• Incomplete fix for gitnexus-shared bundling — prepare script overwrote rewritten imports during publish

[1.5.0] - 2026-04-01

Added

• Repo landing screen — when the backend detects indexed repositories, the web UI now shows a landing page with selectable repo cards (name, stats, indexed date) instead of auto-loading the first repo; users can also analyze new repos directly from the landing screen (#607)
• Unified web & CLI ingestion pipeline — complete architectural migration of the web app from a self-contained WASM browser app to a thin client backed by the CLI server; new gitnexus-shared package for cross-package type unification (#536)
  • New server endpoints: /api/heartbeat (SSE liveness), /api/info, /api/repos, /api/file, /api/grep, /api/analyze (SSE progress), /api/embed, /api/mcp (MCP-over-StreamableHTTP)
  • Onboarding flow: auto-detect server → connect → repo landing or analyze
  • Header repo dropdown: switch, re-analyze, or delete repos
• Azure OpenAI support for wiki command — fixed broken Azure auth (api-key header), api-version URL parameter, reasoning model handling (max_completion_tokens, no temperature), content filter error messages; added interactive setup wizard, --api-version and --reasoning-model CLI flags (#562)
• Java method references & interface dispatch — obj::method treated as call sites, overload selection via typed variable args (not just literals), interface dispatch emits additional CALLS edges to implementing classes (#540)
• MethodExtractor abstraction — structured method metadata extraction (isAbstract, isFinal, annotations, visibility, parameter types) with config-driven factory pattern (#576)
  • Java and Kotlin configs with overload-safe methodInfoCache keyed by name:line
  • C# config with sealed, params/out/ref/optional parameters, [Attribute] syntax, internal visibility (#582)
• --skip-agents-md CLI flag — opt out of overwriting GitNexus-managed sections in AGENTS.md and CLAUDE.md during gitnexus analyze (#517)
• Prettier — monorepo-wide code formatter with lint-staged + Husky pre-commit hook, .prettierrc config, Tailwind CSS v4 plugin, endOfLine: "lf" + .gitattributes for Windows consistency (#563)
• ESLint v9 — flat config with unused-imports auto-removal, @typescript-eslint rules, React hooks rules, CI lint job (#564)

Fixed

• OpenCode MCP configuration — corrected README MCP setup for OpenCode which requires command as an array containing both executable and arguments (#363)
• litellm security — excluded vulnerable versions 1.82.7 and 1.82.8 in eval harness pyproject.toml (#580)

Changed

• Reduced explicit any types — 128 no-explicit-any warnings eliminated (689 → 561, 19% reduction) across NodeProperties index signature, ~80 SyntaxNode substitutions, typed worker protocol, and graphology community detection (#566)

Docs

• Added gitnexus-shared build step to web UI quick start instructions (#585)
• Added enterprise offering section to README (#579)

[1.4.10] - 2026-03-27

Fixed

• MCP server install via npx — resolve tree-sitter peer dependency conflicts that broke npx -y gitnexus@latest mcp (#537, #538)
  • Downgrade tree-sitter from ^0.25.0 to ^0.21.1 (only npm version where all 14 parsers agree)
  • Align all parser versions to their highest ^0.21.x-compatible releases
  • Remove tree-sitter override (only applies to root packages, ignored by npx)
  • Pin tree-sitter-dart to correct ABI-14-compatible commit
  • Exact pins for tree-sitter-c (0.23.2), tree-sitter-python (0.23.4), tree-sitter-rust (0.23.1) where next patch requires ^0.22.x

[1.4.9] - 2026-03-26

Added

• COBOL language support — standalone regex processor for fixed-format and free-format COBOL, JCL, COPY/REPLACING with pseudotext (#498)
  • 95% language feature coverage: CALL USING, EXEC SQL/CICS/DLI, DECLARATIVES, SET, INSPECT, INITIALIZE, STRING/UNSTRING, SORT/MERGE with INPUT/OUTPUT PROCEDURE, GO TO DEPENDING ON, MOVE CORRESPONDING, nested programs with per-program scoping
  • 90+ review findings resolved across 20 review cycles with 241 tests (180 unit + 61 integration)
  • Benchmarked: CardDemo 12,349 nodes / 9,773 edges in 7.4s; ACAS 14,017 nodes / 15,659 edges in 9.3s
• Dart language support — tree-sitter grammar, type extractors, import/call resolution, Flutter/Riverpod framework detection (#204)
• Field type extraction — Phase 8 & 9: per-language field extractors with generic table-driven factory + TypeScript hand-written extractor, return-type binding in call-processor (#494)
  • 14 language configs (TS/JS, Python, Go, Rust, C/C++, C#, Java, Kotlin, PHP, Ruby, Swift, Dart)
  • FieldVisibility union type, extractNames hook for Ruby multi-attribute
  • 46 field extraction tests across 5 languages
• ORM dataflow detection for Prisma and Supabase (#511)
• Expo Router file-based route detection (#503)
• PHP response shape extraction for json_encode patterns (#502)
• Next.js middleware.ts linked to routes at project level (#504)
• Filter panel — additional node types (#519)

Changed

• BUILT_IN_NAMES split into per-language provider fields (#523)
• tree-sitter upgraded to 0.25.0 with all grammar packages (#516)
• Impact tool — batched chunking and entry-point grouping for enrichment (#507)

Fixed

• COBOL CRLF — all split('\n') calls use /\r?\n/ for Windows compatibility
• COBOL nested programs — all graph edges (CALL, CANCEL, CICS, ENTRY, SQL, SEARCH) use owningModuleId() for correct attribution
• COBOL callAccum — multi-line CALL USING with verb boundary detection, Area A paragraph guard, EXEC entry flush, division/END PROGRAM flush
• Dart language gaps closed (#524)
• Shape check false positives — quoted keys, DOM leaks, errorKeys (#501)
• Python alias gaps resolved (#505)
• Cypher write-detection regex false positive fixed (#507)
• CI — shape-check-regression test moved to lbug-db project (#518)

[1.4.8] - 2026-03-23

Added

• Type resolution Milestone D — Phases 10–13 consolidated into a single milestone with full integration test coverage across 11 languages (#387)
  • Phase A/B/C: overload disambiguation via argument literal types, constructor-visible virtual dispatch via constructorTypeMap, parameterTypes extraction in extractMethodSignature
  • Phase 14 enhancements: single-pass seeding, Tarjan's SCC for cyclic resolution, cross-file return types
  • Optional parameter arity resolution
  • Per-language cross-file binding tests and resolver fixes
  • Store all overloads in fileIndex instead of last-write-wins
• Cross-file binding propagation for multiple languages
• HTTP embedding backend for self-hosted/remote endpoints with dynamic dimensions, batch guards, and dimension mismatch handling (#395)
• Markdown file indexing — headings and cross-links as graph nodes (#399)
• MiniMax provider support (#224)
• Codex MCP and skills support with CLI setup flow and e2e tests
• HelpPanel UI — built-in help for the web interface (#465)
• Section node type registered in NODE_TABLES and NODE_SCHEMA_QUERIES (#401)
• Community and Process node properties documented in cypher tool description (#411)
• Server-mode hydration regression tests
• Pre-commit hooks via husky for typecheck + unit tests

Fixed

• Python import alias resolution — import X as Y now routes module aliases directly to moduleAliasMap in import processor (#417, #461)
• Python module-qualified calls resolved via moduleAliasMap (#337)
• Python module-qualified constructor calls (Issue #337)
• Heritage/MRO edges now calculate confidence per resolution tier (#412)
• LadybugDB lock — retry on DB lock with session-safe cleanup (#325)
• CORS — allow private/LAN network origins (#390)
• Analyze without git — allow indexing folders without a .git directory (#384)
• Web: LadybugDB — getAllRows, loadServerGraph, BM25, highlight clearing (#474)
• Server-mode hydration — await server connect hydration flow (#398, #404)
• Embedding dimensions — validate on every vector, not just the first; hard-throw on mismatch
• Timeout detection — always-on dim validation, test hardening
• ONNX CUDA — prevent uncatchable native crash when CUDA libs present but ORT lacks CUDA provider; clarify linux/x64-only
• CLI — run codex mcp add via shell on Windows; write tool output to stdout via fd 1
• Stale progress, cross-platform prepare, DEV log fixes
• Import resolution API simplified per PR #409 review findings (P0–P3)
• Auto-labeling — switched from clustering to z-score method; multi-dim aware Mahalanobis threshold
• PR/issue filtering — fixed prop cutoff issue
• Sequential enrichment queries + stale data detection
• package-lock.json synced with onnxruntime-node ^1.24.0

Changed

• Unified language dispatch with compile-time exhaustive tables
• Prepare script simplified — removed scripts/prepare.cjs
• Switched from .githooks to husky for pre-commit hooks
• @claude workflow restricted to maintainers and above via author_association check

Performance

• O(1) per-chunk synthesis guard using boolean[] instead of Set
• sizeBefore optimization in type resolution
• Token truncation improvements

Chore

• Strengthened Python module-import tests, un-skipped match/case, added perf guard
• Added positive and negative tests for all 4 bug fixes
• E2e tests for stale detection, sequential enrichment, stability (#396)
• Integration tests for Milestone D across all 11 languages
• gitnexus-stable-ops added to community integrations
• .env.example added for embedding backend configuration

[1.4.7] - 2026-03-19

Added

• Phase 8 field/property type resolution — ACCESSES edges with declaredType for field reads/writes (#354)
• Phase 9 return-type variable binding — call-result variable binding across 11 languages (#379)
  • extractPendingAssignment in per-language type extractors captures let x = getUser() patterns
  • Unified fixpoint loop resolves variable types from function return types after initial walk
  • Field access on call-result variables: user.name resolves name via return type's class definition
  • Method-call-result chaining: user.getProfile().bio resolves through intermediate return types
  • 22 new test fixtures covering call-result and method-chain binding across all supported languages
  • Integration tests added for all 10 language resolver suites
• ACCESSES edge type with read/write field access tracking (#372)
• Python enumerate() for-loop support with nested tuple patterns (#356)
• MCP tool/resource descriptions updated to reflect Phase 9 ACCESSES edge semantics and declaredType property

Fixed

• mcp: server crashes under parallel tool calls (#326, #349)
• parsing: undefined error on languages missing from call routers (#364)
• web: add missing Kotlin entries to Record<SupportedLanguages> maps
• rust: await expression unwrapping in extractPendingAssignment for async call-result binding
• tests: update property edge and write access expectations across multiple language tests
• docs: corrected stale "single-pass" claims in type-resolution-system.md to reflect walk+fixpoint architecture

Changed

• Upgrade @ladybugdb/core to 0.15.2 and remove segfault workarounds (#374)
• type-resolution-roadmap.md overhauled — completed phases condensed to summaries, Phases 10–14 added with full engineering specs

[1.4.6] - 2026-03-18

Added

• Phase 7 type resolution — return-aware loop inference for call-expression iterables (#341)
  • ReturnTypeLookup interface with lookupReturnType / lookupRawReturnType split
  • ForLoopExtractorContext context object replacing positional (node, env) signature
  • Call-expression iterable resolution across 8 languages (TS/JS, Java, Kotlin, C#, Go, Rust, Python, PHP)
  • PHP $this->property foreach via @var class property scan (Strategy C)
  • PHP function_call_expression and member_call_expression foreach paths
  • extractElementTypeFromString as canonical raw-string container unwrapper in shared.ts
  • extractReturnTypeName deduplicated from call-processor.ts into shared.ts (137 lines removed)
  • SKIP_SUBTREE_TYPES performance optimization with documented template_string exclusion
  • pendingCallResults infrastructure (dormant — Phase 9 work)

Fixed

• impact: return structured error + partial results instead of crashing (#345)
• impact: add HAS_METHOD and OVERRIDES to VALID_RELATION_TYPES (#350)
• cli: write tool output to stdout via fd 1 instead of stderr (#346)
• postinstall: add permission fix for CLI and hook scripts (#348)
• workflow: use prefixed temporary branch name for fork PRs to prevent overwriting real branches
• test: add --repo to CLI e2e tool tests for multi-repo environment
• php: add declaration_list type guard on findClassPropertyElementType fallback
• docs: correct pendingCallResults description in roadmap and system docs

Chore

• Add .worktrees/ to .gitignore

[1.4.5] - 2026-03-17

Added

• Ruby language support for CLI and web (#111)
• TypeEnvironment API with constructor inference, self/this/super resolution (#274)
• Return type inference with doc-comment parsing (JSDoc, PHPDoc, YARD) and per-language type extractors (#284)
• Phase 4 type resolution — nullable unwrapping, for-loop typing, assignment chain propagation (#310)
• Phase 5 type resolution — chained calls, pattern matching, class-as-receiver (#315)
• Phase 6 type resolution — for-loop Tier 1c, pattern matching, container descriptors, 10-language coverage (#318)
  • Container descriptor table for generic type argument resolution (Map keys vs values)
  • Method-aware for-loop extractors with integration tests for all languages
  • Recursive pattern binding (C# is patterns, Kotlin when/is smart casts)
  • Class field declaration unwrapping for C#/Java
  • PHP $this->property foreach member access
  • C++ pointer dereference range-for
  • Java this.data.values() field access patterns
  • Position-indexed when/is bindings for branch-local narrowing
• Type resolution system documentation with architecture guide and roadmap
• .gitignore and .gitnexusignore support during file discovery (#231)
• Codex MCP configuration documentation in README (#236)
• skipGraphPhases pipeline option to skip MRO/community/process phases for faster test runs
• hookTimeout: 120000 in vitest config for CI beforeAll hooks

Changed

• Migrated from KuzuDB to LadybugDB v0.15 (#275)
• Dynamically discover and install agent skills in CLI (#270)

Performance

• Worker pool threshold — skip worker creation for small repos (<15 files or <512KB total)
• AST walk pruning via SKIP_SUBTREE_TYPES for leaf-only nodes (string, comment, number literals)
• Pre-computed interestingNodeTypes set — single Set.has() replaces 3 checks per AST node
• fastStripNullable — skip full nullable parsing for simple identifiers (90%+ case)
• Replace .children?.find() with manual for loops in extractFunctionName to eliminate array allocations

Fixed

• Same-directory Python import resolution (#328)
• Ruby method-level call resolution, HAS_METHOD edges, and dispatch table (#278)
• C++ fixture file casing for case-sensitive CI
• Template string incorrectly included in AST pruning set (contains interpolated expressions)

[1.4.0] - Previous release