How arunima072004/signalwatch works
SignalWatch is a market-intelligence pipeline: it turns historical retail prices into detected change events, then investigates each event with targeted searches and produces an evidence-backed assessment. The graph follows those two documented phases and includes the internal search, evidence, and verification layers. Relationships in the detection phase are documented at the README level; the investigation links also draw on the supplied source index. Unsampled modules are represented only where the README describes their role.
Main entry points: orchestrator.py Investigation coordinator · provider_interface.py Search provider interface · event_generator.py Change events · builder.py Time-series builder
Components 27
Price detection
- Data preparation
src/data/preprocessing.py - Time-series builder
src/timeseries/builder.py - Price features
src/features/price_features.py - Competitive features
src/features/competitive_features.py - BOCPD detector
src/bocpd/detector.py - Detector configuration
src/bocpd/config.py - Change events
src/events/event_generator.py - Heuristic labels
src/weak_supervision/label_generator.py
Event investigation
- Investigation coordinator
src/investigation/orchestrator.py - Hypothesis generation
src/investigation/hypothesis_generator.py - Hypothesis model
src/models/hypothesis.py - Investigation strategies
src/investigation/investigation_agent.py - Search provider interface
src/search/provider_interface.py - Tavily search
src/search/tavily_provider.py - Mock search
src/search/mock_provider.py - Cached search
src/search/cached_provider.py - Query and result models
src/models/search.py
Evidence verification
- Evidence extraction
src/evidence/extractor.py - Page parser
src/evidence/parser.py - Evidence model
src/models/evidence.py - Evidence verification
src/investigation/verification_agent.py - Verification model
src/models/verification.py
Assessment output
- Event assessment
src/models/assessment.py - Markdown report
scripts/generate_report.py
Other components
- Pricing CSV
- Change event
- Assessment JSON and report
Connections 27
- Pricing CSV → Data preparation: preprocesses
README.md - Data preparation → Time-series builder: builds series
README.md - Time-series builder → Price features: engineers features
README.md - Time-series builder → Competitive features: engineers features
README.md - Price features → BOCPD detector: provides signals
README.md - Competitive features → Change events: enriches events
README.md - Detector configuration → BOCPD detector: configures
src/bocpd/detector.py - BOCPD detector → Change events: flags change points
README.md - Change events → Heuristic labels: labels events
README.md - Change events → Change event: produces
README.md - Change event → Investigation coordinator: investigates
src/investigation/orchestrator.py - Investigation coordinator → Hypothesis generation: generates hypotheses
src/investigation/orchestrator.py - Hypothesis generation → Hypothesis model: creates
src/investigation/hypothesis_generator.py - Investigation coordinator → Investigation strategies: runs investigation
src/investigation/orchestrator.py - Investigation strategies → Search provider interface: executes queries
src/investigation/investigation_agent.py - Tavily search → Search provider interface: implements
src/search/tavily_provider.py - Mock search → Search provider interface: implements
src/search/mock_provider.py - Cached search → Search provider interface: wraps provider
src/search/cached_provider.py - Search provider interface → Query and result models: uses query models
src/search/provider_interface.py - Investigation strategies → Evidence extraction: extracts evidence
src/investigation/investigation_agent.py - Evidence extraction → Page parser: parses pages
src/evidence/extractor.py - Evidence extraction → Evidence model: creates evidence
src/evidence/extractor.py - Investigation coordinator → Evidence verification: verifies evidence
src/investigation/orchestrator.py - Evidence verification → Verification model: builds verification
src/investigation/verification_agent.py - Investigation coordinator → Event assessment: assembles assessment
src/investigation/orchestrator.py - Event assessment → Markdown report: renders report
README.md - Markdown report → Assessment JSON and report: writes report
README.md