SurfSense/plans/backend
DESKTOP-RTLN3BA\$punk 05bbb64527 docs(plans): principal-engineer citation pass before Phase 4
Verified revamp Phase 4-7 code citations against surfsense_backend and corrected drift:

- automations have NO delivery/notification path and automation_runs.output is never written; CI alerts wire to the separate app/notifications system (NotificationService.create_notification, Zero-synced)

- automation PENDING-gate is non-atomic (no UPDATE...WHERE status=pending); per-Tracker lock is the primary concurrency guard, not belt-and-suspenders

- folder upload uses root_folder_id (not destination_folder); KB folder scoping goes via referenced_document_ids -> SearchScope.document_ids (no folder_id search filter)

- billable predicate is 'SUCCESS and outcome.result' duplicated per caller; to be single-sourced in the 04a executor

Confirmed accurate: schedule selector (FOR UPDATE SKIP LOCKED/next_fire_at/self-heal/catchup=False/croniter), AutomationRun model, format_to_structured_document(exclude_metadata=True), MCP routing gap (constants.py), connector enum, MANUAL trigger placeholder. Added dated verification stamp to revamp/00-overview.md. Also reconciled 03b/03c/umbrella wording.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-30 19:30:21 -07:00
..
revamp phases 4-7 docs(plans): principal-engineer citation pass before Phase 4 2026-06-30 19:30:21 -07:00
00-umbrella-plan.md docs(plans): principal-engineer citation pass before Phase 4 2026-06-30 19:30:21 -07:00
01-rename-db.md docs(plans): record as-built state + re-runnable verification for Phase 1 (DB rename) 2026-06-27 22:24:41 +02:00
02-rename-backend.md docs(plans): record as-built state + re-runnable verification for Phase 2 (backend rename) 2026-06-27 22:24:41 +02:00
03a-crawler-core.md chore: sync plans (03a@5c36cd3, 03b@6226012 implemented) 2026-06-29 21:04:17 -07:00
03b-proxy-expansion.md docs(plans): principal-engineer citation pass before Phase 4 2026-06-30 19:30:21 -07:00
03c-crawl-billing.md docs(plans): principal-engineer citation pass before Phase 4 2026-06-30 19:30:21 -07:00
03d-captcha-solving.md feat(crawler): captcha solving + per-attempt billing (Phase 3d) 2026-06-29 22:58:21 -07:00
03e-stealth-hardening.md feat: completed init mvp of phase 3 2026-06-30 03:02:40 -07:00
03f-undetectability-testing.md feat: completed init mvp of phase 3 2026-06-30 03:02:40 -07:00
04a-connector-category.md docs(plans): principal-engineer citation pass before Phase 4 2026-06-30 19:30:21 -07:00
04b-source-discovery.md docs(plans): principal-engineer citation pass before Phase 4 2026-06-30 19:30:21 -07:00
05-pipelines-model.md docs(plans): principal-engineer citation pass before Phase 4 2026-06-30 19:30:21 -07:00
06-pipelines-exec.md docs(plans): principal-engineer citation pass before Phase 4 2026-06-30 19:30:21 -07:00
07-upload-pipeline-kb.md docs(plans): principal-engineer citation pass before Phase 4 2026-06-30 19:30:21 -07:00