ADFA-4128 (7/11): quickbuild:core — provisioning and the daemon client

[fryanpan]

Part 7/11 of the stacked split of #1669 (requested by Akash). Base: feature/ADFA-4128-qb-06-core-deploy. Stack overview + review mechanics: PR 1 (#1713). Terms are defined in quickbuild/README.md (lands in PR 1).

Makes sure the two things Quick Build needs before it can start — an installed app to reload into, and a live compiler — are ready, and that it never fights a standard Run for the same install slot.

flowchart LR
    subgraph s7["<b>This PR: core slice 3 — provisioning + daemon client</b>"]
        prov["service/provision<br/>proxy-app install state,<br/>stateless install-slot checks<br/><i>QuickBuildClobberCheck.kt</i>"]
        dc["QuickBuildDaemonController +<br/>DaemonProcessClient (data)<br/>spawn, configure, request matching<br/><i>DaemonProcessClient.kt</i>"]
        fg["FileGenerationStore (data)<br/>generation counter,<br/>outside the scratch tree<br/><i>FileGenerationStore.kt</i>"]
    end
    dc -- "line-delimited JSON<br/>(:quickbuild:protocol, PR 3)" --> d["compile daemon (PR 9)"]
    sess["session state machine (PR 8)"] -.-> prov
    sess -.-> dc
    classDef thisPrBox fill:#dbeafe,stroke:#93c5fd,color:#1e3a5f
    classDef inPr fill:#ffffff,stroke:#64748b,color:#000
    class s7 thisPrBox
    class prov,dc,fg inPr

Loading

What to review

• DaemonProcessClient.kt — the client half: spawn, configure, request/response matching. C11 fix lands here.
• QuickBuildClobberCheck.kt — confirms the single install slot before either side clobbers.
• FileGenerationStore.kt — generation counter lives outside the scratch tree; survives teardown.
• Deferred followup: prepare() scratch-tree residue, named rather than silently dropped.
• Fakes.kt grows by FakeDaemon + FakePaths (the progressive split flagged in PR 6).

How this PR Was Tested

• 13 test files across data/ and service/provision.
• [verified 2026-08-21] At this cut: :quickbuild:core:test — runs slices 1-3's tests: 49 suites, 650 tests per variant across all 6 variants, 0 failures, 0 errors. Coverage 98.2% line / 90.1% branch.

Coverage (JaCoCo at the stack tip, single run):

Package	Line	Branch	Note
…quickbuild.data	97.9%	90.4%
…quickbuild.service.provision	98.6%	86.9%	process-spawn branches
…quickbuild.service.session	100.0%	96.4%
NON-UI TOTAL	98.2%	90.1%	710 lines, 496 branches

11 source files in the diff, all 11 measured.

Slice 3 of 4 — next: orchestration (PR 8).

🤖 Generated with Claude Code

https://claude.ai/code/session_01Kj9YeCDHGp9DU8LPtfWJ7W

[claude]

Claude Code Review

This repository is configured for manual code reviews. Comment @claude review for a one-time review, or @claude review always to subscribe this PR to a review on every future push.

_{Tip: disable this comment in your organization's Code Review settings.}