Specifications (Active Implementation)

This directory contains active design specifications - work happening NOW.

Distinction from _future/

Directory	Purpose	When to Use
_specs/	Active implementation	Work happening NOW
_future/	Backlog	Blocked, deferred, or planned later

---

Current Active Specs

ID	Title	Status
SPEC-030	Exa Endpoint Strategy (Cost-Bounded, Verifiable Research)	🟡 Phase 1 Complete (budget controls wired; citation verification backlog)
SPEC-034	TradeExecutor Safety Harness (Budgeted, Safe-by-Default)	🟡 Phase 1 implemented (Phase 2 wiring deferred)
SPEC-042	LLM Synthesizer Implementation	🟡 Phase 1 Complete (OpenAI/Gemini backends not implemented)

Remaining Work

🟡 SPEC-030 (Exa Policy)           ← Phase 1 done; Phase 3 citation verification deferred
🟡 SPEC-034 (TradeExecutor)        ← Phase 1 done; Phase 2 wiring deferred
🟡 SPEC-042 (LLM Synthesizer)      ← Phase 1 done; OpenAI/Gemini backends not implemented

---

Next ID Tracker

Use this ID for the next specification: SPEC-044

---

Workflow

1. New spec: Create SPEC-XXX-description.md here
2. Future work: Move to _future/ if deprioritized
3. Implemented: Move to _archive/specs/

---

Archive (Implemented)

Completed specifications are stored under docs/_archive/specs/ (excluded from the MkDocs site build). See docs/_archive/README.md for the archive structure.

Recently Archived (2026-01-19)

ID	Title	Status
SPEC-043	Discovery Endpoints CLI Wiring	✅ Implemented
SPEC-038	Exa Websets API Coverage (Monitoring + Alerts Foundation)	✅ Phase 1 Complete
SPEC-033	Exa Research Agent (Cost-Bounded, Reproducible)	✅ Implemented
SPEC-032	Agent System Orchestration (Single-Agent Default + Escalation)	✅ Phase 1 Complete
SPEC-031	Scanner Quality Profiles (Slop Filtering + "Get In Early" Mode)	✅ Phase 1–2 Complete
SPEC-028	Topic Search & Market Discovery (DB + CLI)	✅ Implemented

Previously Archived

ID	Title	Status
SPEC-041	Phase 5: Remaining High-Value Endpoints	✅ Complete (2026-01-16)
SPEC-040	Complete Kalshi Endpoint Implementation (TDD)	✅ Complete (2026-01-15)
SPEC-039	New Market Alerts (Information Arbitrage)	✅ Phase 1 Complete (2026-01-16)
SPEC-037	Kalshi Missing Endpoints Phase 1	🔀 Superseded by SPEC-040
SPEC-036	Category Filtering for Markets	✅ Implemented
SPEC-035	Ticker Display Enhancement	✅ Implemented
SPEC-029	Kalshi Endpoint Coverage Strategy	🔀 Superseded by SPEC-040
SPEC-027	Settlement Timestamp Support	✅ Implemented
SPEC-026	Liquidity Analysis	✅ Implemented
SPEC-025	Market Open Time Display	✅ Implemented
SPEC-023	Exa-Thesis Integration	✅ Implemented
SPEC-022	Exa News & Sentiment Pipeline	✅ Implemented
SPEC-021	Exa-Powered Market Research	✅ Implemented
SPEC-020	Exa API Client Foundation	✅ Implemented
SPEC-001 to SPEC-019	Foundation specs	✅ Implemented