refactor: reduce explicit any types

[magyargergo]

Summary

Incremental reduction of explicit any types across the codebase. Three high-leverage fixes targeting the ingestion layer:

1. NodeProperties index signature (gitnexus-shared/src/graph/types.ts)

• Changed [key: string]: any → [key: string]: unknown
• Removed 19 redundant (node.properties as any).field casts in csv-generator.ts

2. SyntaxNode substitution (ingestion layer, 4 files → 8 files)

• Replaced ~80 any with SyntaxNode across parse-worker.ts, ast-helpers.ts, parsing-processor.ts, php.ts, call-processor.ts, call-routing.ts, c-cpp.ts
• Added TreeSitterLanguage type alias for optional grammar loading

3. Remaining ingestion cleanup (community-processor, worker-pool, ast-cache, import-processor)

• Typed graphology AbstractGraph for community detection
• Defined LeidenModule interface for vendored leiden code
• Typed WorkerIncomingMessage / WorkerOutgoingMessage discriminated unions for worker protocol
• Targeted cast for Tree.delete() (missing from tree-sitter types)

Result: 689 → 561 no-explicit-any warnings (128 eliminated, 19% reduction)

Ingestion layer specifically: 130 → 7 warnings (95% reduction)

Files changed

File	Change
gitnexus-shared/src/graph/types.ts	[key: string]: any → unknown
gitnexus/src/core/lbug/csv-generator.ts	Removed 19 as any casts
gitnexus/src/core/ingestion/utils/ast-helpers.ts	any → SyntaxNode
gitnexus/src/core/ingestion/parsing-processor.ts	any → SyntaxNode
gitnexus/src/core/ingestion/workers/parse-worker.ts	SyntaxNode + WorkerIncomingMessage
gitnexus/src/core/ingestion/workers/worker-pool.ts	WorkerOutgoingMessage + Error
gitnexus/src/core/ingestion/languages/php.ts	any → SyntaxNode
gitnexus/src/core/ingestion/call-processor.ts	any → SyntaxNode
gitnexus/src/core/ingestion/call-routing.ts	any → SyntaxNode
gitnexus/src/core/ingestion/type-extractors/c-cpp.ts	any → SyntaxNode
gitnexus/src/core/ingestion/community-processor.ts	graphology + leiden types
gitnexus/src/core/ingestion/ast-cache.ts	targeted Tree.delete() cast
gitnexus/src/core/ingestion/import-processor.ts	targeted Tree.delete() cast

Test plan

• npx tsc --noEmit passes in gitnexus/ and gitnexus-shared/
• npx prettier --check . passes
• No runtime behavior changes — purely type annotation changes

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
gitnexus	Ready	Preview, Comment	Mar 28, 2026 5:02pm

[github-actions]

CI Report

✅ All checks passed

Pipeline Status

Stage	Status	Details
✅ Typecheck	success	tsc --noEmit
✅ Tests	success	unit tests, 3 platforms
✅ E2E	success	gitnexus-web changes only

Test Results

Tests	Passed	Failed	Skipped	Duration
4692	4646	0	46	180s

✅ All 4646 tests passed

46 test(s) skipped — expand for details

• buildTypeEnv > known limitations (documented skip tests) > Ruby block parameter: users.each { |user| } — closure param inference, different feature
• Swift constructor-inferred type resolution > detects User and Repo classes, both with save methods
• Swift constructor-inferred type resolution > resolves user.save() to Models/User.swift via constructor-inferred type
• Swift constructor-inferred type resolution > resolves repo.save() to Models/Repo.swift via constructor-inferred type
• Swift constructor-inferred type resolution > emits exactly 2 save() CALLS edges (one per receiver type)
• Swift self resolution > detects User and Repo classes, each with a save function
• Swift self resolution > resolves self.save() inside User.process to User.save, not Repo.save
• Swift parent resolution > detects BaseModel and User classes plus Serializable protocol
• Swift parent resolution > emits EXTENDS edge: User → BaseModel
• Swift parent resolution > emits IMPLEMENTS edge: User → Serializable (protocol conformance)
• Swift cross-file User.init() inference > resolves user.save() via User.init(name:) inference
• Swift cross-file User.init() inference > resolves user.greet() via User.init(name:) inference
• Swift return type inference > detects User class and getUser function
• Swift return type inference > detects save function on User (Swift class methods are Function nodes)
• Swift return type inference > resolves user.save() to User#save via return type of getUser() -> User
• Swift return-type inference via function return type > resolves user.save() to User#save via return type of getUser()
• Swift return-type inference via function return type > user.save() does NOT resolve to Repo#save
• Swift return-type inference via function return type > resolves repo.save() to Repo#save via return type of getRepo()
• Swift implicit imports (cross-file visibility) > detects UserService class in Models.swift
• Swift implicit imports (cross-file visibility) > resolves UserService() constructor call across files (no explicit import)
• Swift implicit imports (cross-file visibility) > resolves service.fetchUser() member call across files
• Swift implicit imports (cross-file visibility) > creates IMPORTS edges between files in the same module
• Swift extension deduplication > detects Product class
• Swift extension deduplication > resolves Product() constructor despite extension creating duplicate class node
• Swift extension deduplication > resolves product.save() to Product.swift (primary definition)
• Swift constructor call fallback (no new keyword) > resolves OCRService() as constructor call across files
• Swift constructor call fallback (no new keyword) > resolves ocr.recognize() member call via constructor-inferred type
• Swift export visibility (internal vs private) > resolves PublicService() constructor across files
• Swift export visibility (internal vs private) > resolves internalHelper() across files (internal = module-scoped)
• Swift if let / guard let binding resolution > detects User and Repo classes
• Swift if let / guard let binding resolution > resolves user.save() inside if-let to User#save
• Swift if let / guard let binding resolution > resolves repo.save() inside guard-let to Repo#save
• Swift if let / guard let binding resolution > user.save() in if-let does NOT resolve to Repo#save
• Swift await / try expression unwrapping > resolves user.save() via await fetchUser() return type
• Swift await / try expression unwrapping > resolves repo.save() via try parseRepo() return type
• Swift await / try expression unwrapping > detects fetchUser and parseRepo as functions
• Swift for-in loop element type inference > detects User and Repo classes
• Swift for-in loop element type inference > creates implicit import edges between files
• Swift field-type resolution > detects classes and their properties
• Swift field-type resolution > emits HAS_PROPERTY edges from class to field
• Swift field-type resolution > resolves field-chain call user.address.save() → Address#save
• Swift field-type resolution > emits ACCESSES edges for field reads in chains
• Swift field-type resolution > populates field metadata (visibility, declaredType) on Property nodes
• Swift call-result binding > resolves call-result-bound method call user.save() → User#save
• Swift call-result binding > getUser() is present as a defined function
• Swift call-result binding > emits processUser -> getUser CALLS edge for let-assigned free function call

Code Coverage

Tests

Metric	Coverage	Covered	Base	Delta	Status
Statements	70.55%	12604/17864	70.53%	📈 +0.0	🟢 ██████████████░░░░░░
Branches	59.86%	8286/13842	59.87%	📉 -0.0	🔴 ███████████░░░░░░░░░
Functions	74.88%	1103/1473	74.77%	📈 +0.1	🟢 ██████████████░░░░░░
Lines	72.77%	11489/15788	72.74%	📈 +0.0	🟢 ██████████████░░░░░░

---

_{📋 View full run · Generated by CI}