Files
obsidian-vault/personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/REMOTE-DEBUG.md
T
Taiga bff83c8369 [2026-10-16 09:10:23] syncthing-out: personal/projects/archive/virfield-release-cleanup-2026-10-16/README.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/AGENT-GUIDE.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/ARCHITECTURE.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/COMPOSITIONAL-PLATFORM.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/IMAGE-PIPELINE.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/OPERATIONS.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/REMOTE-DEBUG.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/VERIFICATION.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/VIRFIELD-3-PLAN.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/acceptance/2026-10-16.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/acceptance/broker-reviewer-readonly.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/fixtures/execution-broker-darwin-process-group.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/history/AGENT-GUIDE-before-2026-10-14.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/history/ARCHITECTURE-before-2026-10-14.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/history/COMPOSITIONAL-PLATFORM-before-2026-10-14.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/history/IMAGE-PIPELINE-before-2026-10-14.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/history/OPERATIONS-before-2026-10-14.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/history/README-before-2026-10-14.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/history/REMOTE-DEBUG-before-2026-10-14.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/history/VERIFICATION-before-2026-10-14.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/history/VERIFICATION-checkpoints-through-2026-10-15.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/history/VIRFIELD-3-PLAN-before-2026-10-14.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/reference/lume-0.5.3-api.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/superpowers/plans/2026-10-07-tart-adoption-pipeline.md personal/projects/archive/virfield-release-cleanup-2026-10-16/docs/superpowers/plans/2026-10-07-tart-guest-identity.md (... +7 more)
2026-10-16 09:10:23 +00:00

94 lines
4.8 KiB
Markdown
Executable File
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Архив исходника docs/REMOTE-DEBUG.md
Источник: Virfield, commit a1460d3372bdfbb5cb19d633d41dd5d3fb3164e6. Снимок перед релизной очисткой. Исторические утверждения ниже относятся к моменту исходной записи; актуальное состояние — в [[personal/projects/virfield]].
````markdown
# VS Code remote debugging
Virfield generates a host-build/remote-run workflow for a ready macOS lease.
Install the official LLDB-DAP VS Code extension before opening the generated
workspace.
The 2026-10-07 timing baseline below belongs to the retired Lume lease.
On 2026-10-16 an actual Monterey12.7.6/Xcode13.4.1 Tart lease passed generated
build/sync/prepare, LLDB-DAP breakpoint/stack/evaluation, output and exit checks.
The original helper exposed a listener-startup race. The correction is installed
in `8bfff9f`; actual installed generated build/sync/prepare and full LLDB-DAP
breakpoint/stack/evaluate41/output42/exit0 passed. No VS Code editor UI or real
DuckDuckGo application debug was driven. Exact receipts and remaining scope are
in [Verification](VERIFICATION.md).
Do not treat the old timings as a Tart release result.
## Data path
| Operation | Location and protocol |
|---|---|
| Swift build and tests | Host, using the repository's existing commands |
| App and debug products | Incremental `rsync` over pinned SSH |
| Process launch | Apple `debugserver` bound to guest loopback |
| Debug connection | Host `lldb-dap` and gdb-remote through an SSH tunnel |
| macOS system images | Xcode `macOS DeviceSupport`, prepared from read-only NFS during golden verification |
The debug port is never exposed on the VM network. Golden verification extracts
the guest cache into `~/Library/Developer/Xcode/macOS DeviceSupport/<version>
(<build>)/Symbols`. The generated helper validates that cache, mounts NFS only
as a recovery fallback, starts `debugserver`, and creates the local SSH tunnel.
The checked listener correction waits for that exact child's loopback LISTEN
socket using `lsof`, without opening a TCP readiness connection: debugserver's
first connection belongs to LLDB. Merely finding its process is insufficient.
LLDB loads application symbols on demand and uses minimal remote module loading.
Golden developer images enable `DevToolsSecurity`, add their configured guest user to `_developer`,
and export only the immutable dyld cache to the private `192.168.64.0/24`
network. Ad-hoc signed apps therefore launch under `debugserver` without an
interactive authorization prompt.
## Create the workspace
Acquire a lease, wait for `ready`, and create its pinned SSH config. Then run:
```sh
VIRFIELD_HOME="$HOME/Library/Application Support/Virfield"
VIRFIELD_URL="http://127.0.0.1:7780"
"$VIRFIELD_HOME/bin/virfield" -url "$VIRFIELD_URL" -token-file "$VIRFIELD_HOME/token" \
vscode-config LEASE_A /absolute/private/IDENTITY_A /absolute/path/to/SWIFTPM_WORKTREE \
LEASE_B /absolute/private/IDENTITY_B
```
Existing files are never overwritten. A DuckDuckGo worktree containing
`DuckDuckGo-macOS.code-workspace` gets:
- `.vscode/DuckDuckGo-macOS.virfield-remote-SET_ID.code-workspace`
- one LLDB prepare helper per supplied ready VM
- a host `lldb-dap` adapter
The Run/Debug dropdown contains one entry per supplied VM, named with both its
VM and lease ID. **Terminal → Run Task → Virfield: Open console** opens the
Virfield web console; each VM also has an **Open VM terminal** task. Files are
lease-set-specific, so creating the next session cannot silently retarget an
open debugging session or overwrite a teammate's configuration.
Open the generated workspace, select **DuckDuckGo — Virfield VM: VM [LEASE]**,
set the desired breakpoint, and press F5. That single action uses
the repository's host-side
`make-host-app.sh`, SwiftBuild `DuckDuckGoBrowserDynamic` product, ad-hoc
signing, and `sign-dylib.sh`; only the resulting app and Debug products are
copied to the VM. **Virfield: Test** runs the existing SwiftPM test command on
the host.
For another SwiftPM package, Virfield creates `launch.json`, `tasks.json`,
`settings.json`, and the same two helpers. Select **Virfield: Debug SwiftPM
product**, press F5, and enter the executable product name.
The historical 2026-10-07 Lume DuckDuckGo baseline on macOS 27.0/Xcode 27.0 connected LLDB-DAP in
0.14–0.15 seconds and reaches `DuckDuckGoBrowserMain` in a median 7.56 seconds
after the cached prepare step. A missing or incomplete DeviceSupport extraction
blocks golden verification instead of publishing a slow debugging image.
The actual Tart protocol checks used the operator-required
standard `admin/admin`, pinned key-only SSH and verified native key storage;
automatic random password rotation was removed in `0f8bc20`, with exact
per-profile installed acceptance tracked in the
[maintained plan](VIRFIELD-3-PLAN.md).
````