docs: backend goal clarity, scaffold module notes, CONTRIBUTING parity

- README: TCP stub model + backend_type reserved for #9; roadmap #10/#11 closed
- breakpoints/state/ui: document scaffold status (not wired into proxy)
- CONTRIBUTING: align issue-tracking section with README Current vs roadmap

Made-with: Cursor

Author: Alex J Lennon

CONTRIBUTING.md

@@ -107,9 +107,13 @@ RUN_E2E_ZEPHYR_NATIVE=1 ./scripts/validate_local.sh
 
 Work is tracked in [GitHub issues](https://github.com/DynamicDevices/rsgdb/issues). **Blocked-by** dependencies define order (e.g. Part A **#1 → #3**; **#2** can run in parallel). Close an issue from a PR with `Closes #N` when it is fully done.
 
-**Status (short):** Part A (**#1–#3**), session recording (**#4**), SVD baseline (**#5**), breakpoint/semihosting spike (**#6**), flash orchestration (**#7**), RTOS decode/log (**#8**) are **closed**. **Phase A/B** (RSP matrix + proxy tests, gdbinit, backend thread reply logging) are in-tree; see README. **CI:** main workflow (**CI**) + optional **Zephyr E2E** (`native_sim`, debug `rsgdb`, west venv + `pyelftools`) — both green on `main`.
+**Foundation (closed issues):** Part A (**#1–#3**), session recording (**#4**), SVD baseline (**#5**), breakpoint/semihosting spike (**#6**), flash (**#7**), RTOS decode/log (**#8**). **Phase A/B** in-tree: RSP matrix + proxy tests, gdbinit example, `rsgdb::rtos` decode logs — see README **Key Features**.
 
-**Next roadmap focus (open):** [#9](https://github.com/DynamicDevices/rsgdb/issues/9) native probe / backend beyond TCP. **In-tree:** session replay ([#10](https://github.com/DynamicDevices/rsgdb/issues/10) — `rsgdb replay`), SVD field + enum labels in memory annotations ([#11](https://github.com/DynamicDevices/rsgdb/issues/11) — baseline; correlation with recordings may remain on the issue).
+**Current capabilities (same as README “Current”):** RSP codec + TCP proxy, `tracing` logging, TOML/env config, JSONL **record** + **`rsgdb replay`**, SVD register/field/enum-name memory annotations, `rsgdb flash`, RTOS packet summaries, CI + optional GDB/Zephyr E2E scripts.
+
+**Roadmap — open:** [#9](https://github.com/DynamicDevices/rsgdb/issues/9) native / non-TCP backend beyond `connect_tcp_backend`. **Optional follow-ups:** SVD value decode + recording correlation (see [#11](https://github.com/DynamicDevices/rsgdb/issues/11) history); TUI, logging export, proxy-side breakpoint management — open an issue before large changes.
+
+**CI:** Workflow **CI** + optional **Zephyr E2E** — green on `main` (see workflow files).
 
 **CI jobs (overview):** Workflow **CI**: `test` (matrix), `fmt`, `clippy`, `docs`, `e2e-gdb-smoke`, `coverage`, `build` (artifacts; upload may use `continue-on-error` for transient infra). Workflow **Zephyr E2E**: west + SDK + `scripts/e2e_zephyr_native_sim.sh` (path / schedule / `workflow_dispatch`).
 

README.md

@@ -15,7 +15,7 @@ A Rust GDB **RSP proxy** with structured logging, optional CMSIS-SVD memory labe
 - **Advanced Breakpoint Management** (roadmap): Named breakpoints, conditional expressions, and hardware/software optimization — config and parsing exist; the proxy today **forwards** breakpoint RSP unchanged
 - **State Inspection** (partial today): Peripheral/register **labels** for memory traffic via CMSIS-SVD in logs; snapshots / deep state are not implemented yet
 - **Session Management**: JSONL **recording** and **`rsgdb replay`** mock-backend playback (see below)
-- **Backend Flexibility**: Support for multiple debug probes (probe-rs, OpenOCD, pyOCD)
+- **Backend Flexibility** (today): The proxy speaks **TCP** to whatever GDB stub you run (OpenOCD, probe-rs GDB port, `gdbserver`, …). `[backend].backend_type` / `--backend` is reserved for **future** native integration ([#9](https://github.com/DynamicDevices/rsgdb/issues/9)); it does not select a transport yet.
 - **Modern Architecture**: Built with Rust for safety, performance, and reliability
 
 ## ✨ Key Features
@@ -294,8 +294,8 @@ Source of truth for ordering and scope: **[GitHub Issues](https://github.com/Dyn
 |------------------|---------------|-------|
 | **Foundation + proxy** | RSP codec, TCP proxy, config, logging, CI (incl. GDB + Zephyr E2E), session record (JSONL), SVD labels, flash orchestration, RTOS decode/log | Closed: [#1–#8](https://github.com/DynamicDevices/rsgdb/issues?q=is%3Aissue+is%3Aclosed) |
 | **Next: native backend** | Probe-facing backend beyond TCP to a stub (see `backends::connect_tcp_backend`) | [#9](https://github.com/DynamicDevices/rsgdb/issues/9) (open) |
-| **Replay** | `rsgdb replay` + mock TCP backend from `.jsonl` | [#10](https://github.com/DynamicDevices/rsgdb/issues/10) (implemented; close when shipped) |
-| **Richer SVD** | Overlapping fields + enum variant names in annotations; value decode / recording correlation follow-ups | [#11](https://github.com/DynamicDevices/rsgdb/issues/11) (baseline in-tree) |
+| **Replay** | `rsgdb replay` + mock TCP backend from `.jsonl` | [#10](https://github.com/DynamicDevices/rsgdb/issues/10) (closed) |
+| **Richer SVD** | Overlapping fields + enum variant names in annotations; value decode / recording correlation follow-ups | [#11](https://github.com/DynamicDevices/rsgdb/issues/11) (baseline closed; follow-ups optional) |
 
 Older versioned bullets (v0.2–v0.4) below are **aspirational**; issue titles supersede them.
 

src/breakpoints/mod.rs

@@ -2,6 +2,10 @@
 //!
 //! Advanced breakpoint management with support for named, conditional,
 //! and grouped breakpoints.
+//!
+//! **Status — scaffold:** types and config exist; the TCP proxy does not run a breakpoint
+//! manager on the wire yet (RSP `Z`/`z` packets are forwarded unchanged). Safe to ignore unless
+//! you are extending this API.
 
 /// Breakpoint type
 #[derive(Debug, Clone, PartialEq)]

src/state/mod.rs

@@ -1,6 +1,9 @@
 //! State module
 //!
 //! State tracking and inspection for debugging sessions.
+//!
+//! **Status — scaffold:** not wired into the proxy; placeholder enum for future session/target
+//! state. Safe to ignore unless you are extending this API.
 
 /// Represents the target state
 #[derive(Debug, Clone, PartialEq)]

src/ui/mod.rs

@@ -1,6 +1,9 @@
 //! UI module
 //!
 //! User interface implementations (TUI, web).
+//!
+//! **Status — scaffold:** `UiConfig`-style placeholders only; no TUI/web server in the binary yet.
+//! Safe to ignore unless you are extending this API.
 
 /// UI configuration
 #[derive(Debug, Clone)]