How msulemans/local-lens works
Local Lens is a native Mac research workspace that finds public sources, saves their passages, and presents answers with inspectable citations. A user selects Quick, Deep, Academic, or News; the workspace plans bounded searches, acquires and extracts pages, retrieves saved passages, and compiles cited answers or evidence-only results. Reports expose coverage, gaps, and conflicting or independent evidence; users can inspect citations and reopen or export saved research. The graph reflects documented capabilities and sampled orchestration; unsampled subsystem wiring is shown only where the README or module boundaries support it.
Main entry points: LivingResearchMapView.swift Living Research Map · ResearchWorkspaceModel.swift Workspace model · ResearchRunner.swift Research runner · LiveQuick.swift Quick runner
Components 22
Research workspace
- Living Research Map
Sources/LocalLensApp/LivingResearchMapView.swift - Workspace model
Sources/LocalLensApp/ResearchWorkspaceModel.swift
Planning and research
- Mode planning
Sources/LocalLensCore/ResearchModePolicy.swift - Research runner
Sources/LocalLensCore/ResearchRunner.swift - Quick runner
Sources/LocalLensCore/LiveQuick.swift - Search adapters
Sources/LocalLensCore/SearchAdapter.swift - Scholarly adapters
Sources/LocalLensCore/OpenAlexSearchAdapter.swift
Evidence and answers
- Safe acquisition
Sources/LocalLensCore/SafeAcquisition.swift - Bounded fetch
Sources/LocalLensCore/BoundedFetch.swift - Page extraction
Sources/LocalLensCore/HTMLExtraction.swift - PDF extraction
Sources/LocalLensCore/PDFExtraction.swift - Lexical retrieval
Sources/LocalLensCore/LexicalIndex.swift - Answer providers
Sources/LocalLensCore/LocalAnswerProvider.swift - Citation compiler
Sources/LocalLensCore/CitationCompiler.swift - Evidence comparison
Sources/LocalLensCore/EvidenceContrast.swift
Saved research
- Snapshot store
Sources/LocalLensCore/SnapshotStore.swift - Research history
Sources/LocalLensCore/ResearchHistory.swift - Answer artifacts
Sources/LocalLensCore/LiveAnswerArtifact.swift - Citation export
Sources/LocalLensCore/CitationExport.swift
Other components
- Researcher
- Search services
- Hosted or local model
Connections 29
- Researcher → Living Research Map: asks or inspects
- Living Research Map → Workspace model: updates workspace
- Workspace model → Mode planning: plans mode
- Workspace model → Research runner: runs research
- Workspace model → Quick runner: runs Quick
- Workspace model → Research history: loads and saves
- Research runner → Search adapters: searches queries
- Research runner → Safe acquisition: acquires sources
- Research runner → Snapshot store: shares snapshots
- Research runner → Quick runner: compiles answer
- Search adapters → Search services: queries
- Scholarly adapters → Search services: queries scholarly
- Safe acquisition → Bounded fetch: fetches pages
- Bounded fetch → Page extraction: extracts HTML
- Bounded fetch → PDF extraction: extracts PDF
- Page extraction → Snapshot store: stores passages
- PDF extraction → Snapshot store: stores passages
- Quick runner → Snapshot store: reads snapshots
- Quick runner → Lexical retrieval: retrieves passages
- Quick runner → Answer providers: requests answer
- Answer providers → Hosted or local model: sends passages
- Quick runner → Citation compiler: compiles citations
- Citation compiler → Lexical retrieval: resolves passages
- Research runner → Evidence comparison: assesses evidence
- Workspace model → Answer artifacts: records result
- Living Research Map → Citation compiler: inspects citations
- Living Research Map → Evidence comparison: shows evidence gaps
- Living Research Map → Citation export: exports sources
- Living Research Map → Research history: reopens research