Files
vdm/daemon/docs/deferrals.md
T
samiandClaude Sonnet 5 08d7ee9263 daemon: wire the engine into veloxd — the vertical slice runs end to end
CORE stage 8 merged, so vdm::Engine is linkable. This closes D4a and
narrows D4b: `velox add <url>` now actually downloads.

- sched/engine_port_core.hpp — the real EnginePort: forwards to a live
  vdm::Engine, keeps the DownloadHandle per task for pause/resume/
  cancel/provide_auth/decide/refresh_url, drives set_task_order /
  set_max_active_segments / set_host_segment_cap via
  engine.segment_budget(). CORE confirmed the admission model: DAEMON
  decides when to start(); the engine's own download_task calls
  register_task/set_want internally — DAEMON never touches per-task
  budget calls. EnginePort gains release(TaskId) so the port drops a
  handle when the task goes terminal.
- rpc/event_loop — EventLoop::post(fn): thread-safe, runs fn on the
  loop thread next iteration. The marshaller for engine-thread
  callbacks.
- main.cpp — constructs vdm::Engine + EnginePortCore + Scheduler
  (post_to_loop = loop.post). At startup: reconcile_after_restart()
  (ADR 0013 §5), reload_config(), tick(). A 1 s timerfd on the loop
  re-runs tick() (schedule windows, missed nudges); download.add nudges
  via dispatcher.set_on_mutation.

End-to-end verified against tools/testserver: `velox add
http://127.0.0.1:.../file/512K` -> task queued -> scheduler admits ->
engine downloads 524288 bytes -> complete, file on disk. First
byte-path all the way through the project.

safepath-adversarial.md: re-verified per its own note — CORE landed
O_NOFOLLOW on the target open (core/src/io/sparse_file.cpp), so the
leaf-symlink TOCTOU is now closed; residual is down to one
intermediate-dir gap (documented post-M1 chase).

36 daemon/cli tests green; scheduler + uds_roundtrip TSan-clean.

Co-Authored-By: Claude Sonnet 5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01Upd9WhG9oppieig5nRDLig
2026-09-10 20:36:11 +04:00

2.0 KiB

DAEMON — deferred work, tracked

Things that are deliberately incomplete in daemon/ right now, with why and when they close. Kept here (not buried in commit messages) so the next pass can see them at a glance.

# What Where Why deferred Closes when
D1 Pairing prompt is EnvAutoApprover (needs VELOX_PAIR_AUTO=1) rpc/pairing.hpp, main.cpp A GUI dialog / org.freedesktop.Notifications approver is integration work Build step 7 (systemd + notifications)
D2 download.probe-32603 rpc/dispatcher.cpp download.add is wired (fs/safepath + store, real -32011); download.probe needs the engine's probe path for -32013 probe with the engine link (CORE stage 3 is landed; wire Engine::probe)
D3 Stub handlers for everything except session.*, download.add/list/get rpc/dispatcher.cpp No store behind them yet (categories/queues/rules/settings/limiter/schedule) Per method, as the store query modules land behind them
D4a Closedsched/engine_port_core.hpp wraps vdm::Engine + segment_budget(); main.cpp constructs Engine + Scheduler, calls reconcile_after_restart / reload_config / tick at startup done (lane/core stage 8 merged)
D4b timer + nudges: a 1 s timerfd re-runs Scheduler::tick() and download.add nudges via on_mutation. download.pause/resume/start/cancel and the queue.* handlers still don't touch the scheduler rpc/dispatcher.cpp those handlers are still stubs (D3) as each handler is implemented behind the store, it calls on_mutation / drives the scheduler
D5 event.* fan-out not implemented; session.subscribe accepts and echoes but nothing is emitted rpc/uds_server.cpp, rpc/ws_server.cpp No task state to broadcast until the engine is wired. Scheduler::on_engine_state is the hook it will fire from With D4a — the same engine-state callback feeds both the store and event.task.state