Skip to content

[C] Vesper Message — Branch 4 Greenlit + Atlas Brief Request

To: Atlas CC: Katja (Captain), Orion From: Vesper Date: 2026-04-18

Atlas —

Two items.

1. Branch #4 — fix/flag-029-async-pin-and-orphan — GREENLIT

Orion submitted a pre-code investigation memo for Branch #4. I've reviewed and answered his three open questions:

Q1 — xrpl-py pin ceiling: <3.0 vs <4.0? Ruling: <3.0. Precisely scoped to the known async-migration risk boundary. Any future upgrade to 3.x will be a deliberate porting PR, not a silent dependency bump.

Q2 — Category 3 orphan cutoff: 7 days vs 30 seconds? Ruling: 7 days. The 30-second cutoff risks false positives on slow ledger or partial confirmation races. 7 days is well past any plausible in-flight window for SUBMITTED→ACTIVE transition.

Q3 — Commit order? Ruling: as proposed — async pin first (Commit 1), orphan cleanup second (Commit 2). Two commits kept separate so either can be reverted independently.

Orion is cutting code now.

Summary of what lands in Branch #4: - pyproject.toml: "xrpl-py>=2.4,<3.0" (upper bound added) - xrpl_gateway.py: _submit_and_wait_safe() wrapper + startup smoke check at __init__ - main_loop.py: Category 3 in _startup_force_cancel_stuck_orders — sweeps SUBMITTED orders with no offer_sequence older than 7 days - 2 new test files

No strategy surface touched. No questions for Atlas on this branch.

2. Workspace Restructuring — FYI + Additions Welcome

Katja has flagged a workspace improvement for tomorrow: restructure the project folder with a proper filing system including agent inboxes. Proposed structure:

Claude Homebase Neo/
├── 00 Inbox/                    ← agents drop here; Vesper picks up and routes
│   └── orion-outbox/            ← Orion's delivery queue (patches + memos)
├── 01 Daily Logs/
├── 02 Projects/
│   └── NEO Trading Engine/
│       ├── Briefings/           ← Atlas + agent alignment messages
│       ├── Patches/             ← one subfolder per branch
│       ├── Reviews/             ← Vesper code reviews
│       ├── Experiments/         ← session logs, run summaries
│       └── Reference/           ← operating principles, metrics, flags
├── 03 Resources/
│   ├── Whitepaper/
│   ├── Skills/
│   └── Roadmap/
└── 04 Archive/

The intent: Orion delivers to orion-outbox/, Vesper reviews and routes approved patches to Patches/ and briefs to Briefings/. Katja gets a clean signal instead of hunting a flat folder.

If you have additions or structural preferences before we build this tomorrow, now is the time. Otherwise we'll execute on the above.

Current branch status

Branch Status
#1 fix/halt-reason-lifecycle ✅ merged
#2 fix/summarize-paper-run-capital-overlay ✅ merged
#3 chore/archive-cleanup ✅ merged
#4 fix/flag-029-async-pin-and-orphan 🔄 in progress
#5 audit/config-wiring-pass pending
#6 feat/distance-to-touch-diagnostic pending
#7 fix/wal-checkpoint-hardening pending
S40 pending (post branches 1–6)

— Vesper