How yunmin311/gitlineage works
GitLineage turns a GitHub repository reference into a validated, evidence-backed lineage graph. The main workflow resolves the input, gathers repository metadata, documents, package declarations, submodule entries, Git history and blob evidence, then resolves observations under a relationship ontology and validates the canonical artifact. The same analysis powers a web explorer with queued, cached requests and a presentation view-model. README documentation establishes the product capabilities; some collector and browser details are not shown in source excerpts, so uncertain links are omitted or marked unverified.
Main entry points: analyze.ts Analyze pipeline · app.js Interactive explorer · cached-analyze.ts Cached analysis · resolver.ts Relationship resolver
Components 32
Analysis workflow
- CLI commands
src/cli/main.ts - Analyze pipeline
src/pipeline/analyze.ts - Cached analysis
src/pipeline/cached-analyze.ts
Evidence collectors
- GitHub API client
src/collectors/github/client.ts - Fork metadata
src/collectors/github/metadata.ts - Document attribution
src/collectors/documents/attribution.ts - Git history evidence
src/collectors/git/history.ts - Blob identity evidence
src/collectors/git/blobs.ts - Submodule evidence
src/collectors/submodules/collector.ts - Manifest parsing
src/collectors/packages/manifests.ts - Package collection
src/collectors/packages/collector.ts - Package registries
src/collectors/packages/registry.ts
Lineage contract
- Relationship resolver
src/core/resolver.ts - Evidence policy
src/core/policy.ts - Relationship ontology
src/core/ontology.ts - Canonical graph model
src/core/model.ts - Stable identifiers
src/core/ids.ts - Graph validation
src/core/validate.ts
Platform services
- Bounded HTTP
src/platform/http.ts - Bounded Git access
src/platform/git.ts - Namespaced cache
src/platform/cache.ts - Repository URL safety
src/platform/url.ts
Web explorer
- HTTP server
src/web/server.ts - Analysis scheduler
src/web/analysis/scheduler.ts - Analysis store
src/web/analysis/store.ts - Presentation view-model
src/web/view-model.ts - Interactive explorer
src/web/client/app.js - Graph rendering
src/web/client/lib/compose.mjs - Graph search
src/web/client/lib/search.mjs - URL view state
src/web/client/lib/url-state.mjs
Other components
- CLI user
- Explorer user
Connections 39
- CLI user → CLI commands: runs command
README.md - CLI commands → Analyze pipeline: runs analysis
src/cli/main.ts - Analyze pipeline → Repository URL safety: resolves input
src/pipeline/analyze.ts - Analyze pipeline → GitHub API client: fetches repository data
src/pipeline/analyze.ts - Analyze pipeline → Fork metadata: collects metadata
src/pipeline/analyze.ts - Analyze pipeline → Submodule evidence: collects submodules
src/pipeline/analyze.ts - Analyze pipeline → Package collection: collects packages
src/pipeline/analyze.ts - Analyze pipeline → Package registries: resolves packages
src/pipeline/analyze.ts - Analyze pipeline → Document attribution: collects attribution
src/pipeline/analyze.ts - Analyze pipeline → Git history evidence: collects history
src/pipeline/analyze.ts - Analyze pipeline → Blob identity evidence: compares blob evidence
src/pipeline/analyze.ts - Analyze pipeline → Relationship resolver: resolves observations
src/pipeline/analyze.ts - Analyze pipeline → Graph validation: validates graph
src/pipeline/analyze.ts - Analyze pipeline → Bounded HTTP: configures client
src/pipeline/analyze.ts - Analyze pipeline → Bounded Git access: fetches history
src/pipeline/analyze.ts - Analyze pipeline → Namespaced cache: creates cache
src/pipeline/analyze.ts - Relationship resolver → Evidence policy: checks evidence policy
src/core/resolver.ts - Relationship resolver → Stable identifiers: creates identifiers
src/core/resolver.ts - Relationship resolver → Relationship ontology: applies relationship rules
- Graph validation → Relationship ontology: checks relationship rules
src/core/validate.ts - Bounded HTTP → Namespaced cache: caches responses
src/platform/http.ts - Bounded HTTP → Repository URL safety: checks destinations
src/platform/http.ts - Bounded Git access → Namespaced cache: uses cached data
src/platform/git.ts - GitHub API client → Bounded HTTP: fetches API data
src/collectors/github/client.ts - Package collection → Manifest parsing: parses manifests
src/collectors/packages/collector.ts - Package registries → Manifest parsing: uses package facts
src/collectors/packages/registry.ts - Cached analysis → Analyze pipeline: runs analysis
src/pipeline/cached-analyze.ts - Cached analysis → Graph validation: checks cached graph
src/pipeline/cached-analyze.ts - Cached analysis → Namespaced cache: reads and writes artifacts
src/pipeline/cached-analyze.ts - Explorer user → Interactive explorer: explores lineage
README.md - Interactive explorer → HTTP server: requests graph views
README.md - HTTP server → Analysis scheduler: queues analysis
src/web/server.ts - HTTP server → Cached analysis: requests cached analysis
src/web/server.ts - HTTP server → Presentation view-model: builds presentation view
src/web/server.ts - Analysis scheduler → Cached analysis: runs analysis jobs
src/web/analysis/scheduler.ts - Analysis scheduler → Analysis store: stores job state
src/web/analysis/scheduler.ts - Interactive explorer → Graph rendering: composes graph
src/web/client/app.js - Interactive explorer → Graph search: searches graph
src/web/client/app.js - Interactive explorer → URL view state: reads and writes view state
src/web/client/app.js