e35c59bd6e
docs(sp7): SP7 implementation plan — 21 tasks across 6 phases
2026-06-20 19:19:26 -06:00
1359b0753a
merge: SP5 live-tail — pub/sub + 3 stream endpoints + frontend tail integration
...
Brings the SP5 live-tail implementation into main:
Backend
* EventBus (cyclone.pubsub): per-kind fan-out with drop-oldest overflow
* FastAPI lifespan initializes the bus + db once per process
* store.add() publishes claim_written / remittance_written /
activity_recorded events on every batch write
* GET /api/{claims,remittances,activity}/stream: NDJSON snapshot +
live subscription + 15s idle heartbeat
* EventBus.unsubscribe() lets the tail loop release its queue on
client disconnect (no queue leak per open stream)
Frontend
* src/lib/tail-stream.ts: streamTail() async-generator over fetch
* src/store/tail-store.ts: zustand with FIFO cap 10k per slice
* src/hooks/useTailStream.ts: connecting/live/reconnecting/stalled/error/closed
state machine with 1→2→4→8→16→30s backoff
* src/hooks/useMergedTail.ts: base + tail merge with filter
* src/components/TailStatusPill.tsx: badge + Reconnect button
* Claims, Remittances, ActivityLog pages wired to the tail
Tests
* 437 backend tests pass (was 418 before SP5)
* 154 frontend tests pass (was 124)
* npm run typecheck clean
* end-to-end smoke: open /api/claims/stream, POST 837, see new claims
arrive in real time without refresh
# Conflicts:
# src/pages/ActivityLog.tsx
# src/pages/Remittances.test.tsx
# src/pages/Remittances.tsx
2026-06-20 17:28:58 -06:00
972cc99200
docs: mark SP4 partial shipped (claim drawer); tick all plan checkboxes
2026-06-20 12:37:31 -06:00
bdc851f0f0
docs(sp4): per-claim detail drawer implementation plan (24 tasks, 5 phases)
2026-06-20 08:55:49 -06:00
446a02d0a2
docs: mark SP3 shipped; tick all plan checkboxes
2026-06-20 08:25:15 -06:00
763ca3d758
docs(sp3): put transaction_type_code on ClaimOutput (mirrors envelope convention)
2026-06-20 07:18:16 -06:00
467087d683
docs(sp3): fix rule IDs (R034/R035) and BHT06 naming in plan+spec
2026-06-20 07:18:03 -06:00
b47818883a
docs: add EDI features spec + implementation plan (sub-project 3, 30 tasks)
2026-06-20 07:14:14 -06:00
b7f831e170
docs: tick off completed boxes in sub-project 1 plan (housekeeping)
2026-06-20 00:11:01 -06:00
53010b89dd
docs: add DB + reconciliation implementation plan (30 tasks, 7 phases)
...
Implements the spec at docs/superpowers/specs/2026-06-19-cyclone-db-reconciliation-design.md.
Phase 1 — Backend foundation (T1-T3): SQLAlchemy dep, db.py skeleton,
PRAGMA user_version migration runner, 0001_initial.sql with 6 tables.
Phase 2 — ORM models (T4-T6): Batch, Claim, Remittance, CasAdjustment,
Match, ActivityEvent + ClaimState enum.
Phase 3 — Reconciliation pure functions (T7-T8): match() with date
window + multi-claim fallback, apply_payment/apply_reversal,
split_unmatched.
Phase 4 — Store facade refactor (T9-T12): CycloneStore replaces
InMemoryStore with same public API + list_unmatched / manual_match /
manual_unmatch; reconcile.run orchestrator wired into store.add().
Phase 5 — API additions (T13-T17): db.init() in startup,
GET /api/reconciliation/unmatched, POST /match, POST /unmatch,
parse-835 response includes reconciliation summary; TODO marker
removal verification.
Phase 6 — Frontend (T18-T26): ClaimState types, api.listUnmatched/
matchRemit/unmatchClaim, useReconciliation hook, ClaimStateBadge
primitive (7 states, same palette), Reconciliation page, sidebar
nav entry, vitest worktree exclude.
Phase 7 — Docs + smoke (T27-T30): README persistence section + DB
URL docs, tick off sub-project 1 plan boxes, full end-to-end smoke
procedure, merge to main.
Total: 30 tasks across 7 phases. TDD discipline per task with
~32 new backend tests + ~4 new frontend tests. Target after
completion: 210 backend + 7 frontend tests passing.
2026-06-19 20:51:31 -06:00
d7ef35dd9a
docs: add production-readiness implementation plan (33 tasks, 4 phases)
...
Phases:
1. Backend (T1-T10): cyclone.store module, 6 GET routes, NDJSON streaming,
parse persistence, uvicorn 127.0.0.1 bind, full test suite run
2. Frontend (T11-T27): react-query wiring, 5 new UI primitives (Skeleton,
EmptyState, ErrorState, FilterChips, Pagination), Layout-level refetch
indicator, 5 page refactors (Claims, Remittances, Providers, ActivityLog,
Upload), 6 hooks, 3 keyframes, api.test.ts
3. Docs (T28-T32): 4 reference notes (837p, 835, x12naming, co-medicaid),
root README rewrite
4. Smoke (T33): end-to-end manual test with full acceptance checklist
Self-review included at end of plan (spec coverage table + placeholder
scan + type consistency check).
For agentic workers: superpowers:subagent-driven-development (recommended)
or superpowers:executing-plans.
2026-06-19 18:43:17 -06:00
5ed59ef01a
Add 837P parser implementation plan
...
- 12 tasks: project skeleton, exceptions, segments, models, payer config,
fixtures, validator, parser orchestrator, CO fixture, writer, CLI, README
- TDD throughout; each task has 4-6 bite-sized steps with full code
- Optional prodfile smoke test (skipped if docs/prodfiles absent)
- Self-review checklist confirms full spec coverage
2026-06-19 15:12:04 -06:00
Tyler
Cyclone