How namra7-x/webdiscovery works
DeepScope is a RAM-first Chromium DevTools extension for discovering a site’s browser-visible resources and APIs, searching findings, and analyzing exposures. The main workflow is: capture page and network evidence, extract compact units with provenance, index and analyze them, then browse, search, and open results in their original sources. The panel owns session state; the background relays metadata, and temporary IndexedDB is only an overflow path. README capabilities supplement the partial source excerpts; uncertain internal wiring is omitted.
Main entry points: panel.ts DevTools panel · background.ts Metadata relay · worker-indexer.ts Worker indexing · search.ts Fuzzy search
Components 19
Capture
- Page observer
src/content.ts - Metadata relay
src/background.ts - Deep capture
src/cdp.ts
Discovery
- Resource extraction
src/extractors.ts - Worker indexing
src/worker-indexer.ts - RAM index
src/indexer.ts - Discovery graph
src/graph.ts
Analysis
- Fuzzy search
src/search.ts - Normalization
src/normalize.ts - Fuzzy matcher
src/fuzzy.ts - Secret scanning
src/rules.ts - Exposure analysis
src/exposure.ts
Session
- Memory budgets
src/memory.ts - Session overflow
src/idb.ts
Interface
- DevTools panel
src/panel.ts - Extension popup
src/popup.ts
Other components
- Engineer
- Inspected site
- Chromium APIs
Connections 28
- Engineer → DevTools panel: opens
- Engineer → Inspected site: inspects
- DevTools panel → Chromium APIs: uses capture APIs
- DevTools panel → Inspected site: snapshots page
- Inspected site → Page observer: DOM changes
- Page observer → Metadata relay: sends batches
- Metadata relay → DevTools panel: relays metadata
- Metadata relay → Chromium APIs: observes requests
- DevTools panel → Metadata relay: controls capture
- Chromium APIs → Metadata relay: dispatches CDP events
- Metadata relay → DevTools panel: forwards CDP data
- DevTools panel → Worker indexing: submits resources
- Worker indexing → Resource extraction: extracts units
- Worker indexing → Secret scanning: scans units
- Worker indexing → DevTools panel: returns units
- DevTools panel → RAM index: indexes findings
- DevTools panel → Discovery graph: records relationships
- DevTools panel → Memory budgets: accounts session
- DevTools panel → Session overflow: stores overflow bodies
- DevTools panel → Fuzzy search: queries index
- Fuzzy search → RAM index: retrieves candidates
- Fuzzy search → Normalization: normalizes text
- Fuzzy search → Fuzzy matcher: ranks candidates
- DevTools panel → Exposure analysis: classifies findings
- DevTools panel → Engineer: renders results
- DevTools panel → Chromium APIs: opens source location
- Engineer → Extension popup: opens
- Extension popup → Chromium APIs: requests extension actions