From 10801058c5bb1ca9adc7896506841b924ff049d2 Mon Sep 17 00:00:00 2001 From: CREDO23 Date: Tue, 30 Jun 2026 23:35:05 +0200 Subject: [PATCH] docs(revamp): add CI pivot overview & domain map --- plans/backend/revamp/00-overview.md | 40 +++++++++++++++++++++++++++++ 1 file changed, 40 insertions(+) create mode 100644 plans/backend/revamp/00-overview.md diff --git a/plans/backend/revamp/00-overview.md b/plans/backend/revamp/00-overview.md new file mode 100644 index 000000000..1604406bc --- /dev/null +++ b/plans/backend/revamp/00-overview.md @@ -0,0 +1,40 @@ +# Phase 4 → end revamp — Overview & reconciliation (CI pivot · WIP) + +> **What this is.** The CI pivot re-architects the old "pipeline" phases (`04`–`07`) into small, +> single-responsibility domains. This file is the map + the reconciliation against the old plans. +> **Scope guardrail:** Phases **1–3 are SHIPPED/FIXED** (rename/DB, proxy/captcha/stealth, crawl +> billing). The revamp is **Phase 4 → end only**. We do **not** touch 1–3. + +## The two products + +``` +PRODUCT A — stateless utility ① Capabilities + ② Access + call a verb → get data → bill. Nothing persists. + +PRODUCT B — decision-grounded CI ③ Intelligence + ④ Timeline (+ ⑤ Triggers to drive it) + a Lens accumulates structured signal over time. The Timeline is the moat. +``` + +## The domain map + +``` + FIXED (Phases 1–3) OUR SCOPE (Phase 4 → end) + ┌─────────────────────────────────┐ ┌──────────────────────────────────────────────┐ + │ Acquisition │ │ ① Capabilities typed verbs over Acquisition │ + │ proprietary/web_crawler │◄──┤ ② Access chat · REST · MCP doors │ + │ CrawlOutcome · billing (03c) │ │ ③ Intelligence Lens · schema · hot loop │ + │ │ │ ④ Timeline 3-store delta state (moat) │ + │ │ │ ⑤ Triggers pluggable refresh clock │ + │ │ │ ⑥ Orchestration CI-expert subagent + tools │ + └─────────────────────────────────┘ └──────────────────────────────────────────────┘ + data engine (untouched) stateless ①② → stateful ③④ , driven by ⑤ , fronted by ⑥ +``` + +| # | Domain | One line | Doc | +|---|--------|----------|-----| +| ① | Capabilities | Acquisition → typed callable verbs (`web.scrape`, `web.discover`, `maps.*`) | `01-capabilities.md` | +| ② | Access | expose verbs to callers, authed + metered (chat / REST / MCP) | `02-access.md` | +| ③ | Intelligence | the Lens, agent-designed locked schema, hot loop (agent judges, code computes) | `03-intelligence.md` | +| ④ | Timeline | durable time-shaped truth; deltas not snapshots; no change → no row | `04-timeline.md` | +| ⑤ | Triggers | when a Lens refreshes; `refresh(lens)` callers; recurrence+delivery = optional CI action on automations | `05-triggers.md` | +| ⑥ | Orchestration | the human-facing CI-expert subagent (intent routing, verb chains, Lens crafting) + its tools | `06-orchestration.md` |