Module debug 

Debug doctor domain — a port of the TypeScript @alp-sdk/core/debug doctor logic (buildDoctorReport, serverChoicesForTarget, and the runtime-capability/workspace-context adapters).

All logic here is pure: runtime capabilities and board.yaml existence are injected as predicates, so doctor parity with the TS implementation is guaranteed by deterministic unit tests rather than by the (machine- dependent) golden-fixture harness.

Structs

DebugGenerationTraceDecision

One generation decision recorded by alp trace.

DebugResolvedValue

A single resolved project value surfaced by alp inspect.

DebugRuntimeCapabilities

Probed availability of debug tooling on the host (PATH lookups + interpreter).

DebugWorkspaceContext

Context fed to build_doctor_report. Serialized (camelCase) only inside the support-bundle file; the doctor/inspect envelopes emit derived reports, not the context itself.

DebuggerExtensionsState

Which VS Code debugger extensions are installed in the host.

DoctorCheck

A single doctor check with its status and an optional remediation.

DoctorReport

Full alp doctor report for a target/server combination.

DoctorSummary

Per-status check counts for a doctor report.

Enums

DebugServerKind

Debug-server / GDB backend used to attach to a target.

DebugTargetKind

Class of debug target a project produces; drives which servers and checks apply.

DebugTraceOutcome

Result of a single generation decision in an alp trace.

DebugValueSource

Where a resolved alp inspect value originated.

DoctorStatus

Outcome of a single doctor check.

Functions

build_doctor_report

Mirror of TS buildDoctorReport.

collect_resolved_values

Mirror of TS collectResolvedValues: the project-context fields surfaced by alp inspect, each tagged with a source + human detail.

collect_runtime_capabilities_from_commands

Mirror of TS collectRuntimeCapabilitiesFromCommands.

create_debug_workspace_context

Mirror of TS createDebugWorkspaceContext: board.yaml existence is probed via the injected predicate only when a path resolved.

is_server_supported_for_target

Whether server is among the valid choices for target.

parse_server_kind

Parse --server. Mirrors TS parseServerKind: absent/empty defaults to none; an unknown value is an error.

parse_target_kind

Parse --target-kind. Mirrors TS parseTargetKind: an absent/empty value defaults to native-host; an unknown value is an error.

server_choices_for_target

The debug servers valid for a given target kind.