Skip to content

Dev docs: full reality-reconciliation at v0.4.0-alpha.1#379

Merged
ryan-johnson2 merged 1 commit into
develfrom
dev-docs-reconcile
Jul 5, 2026
Merged

Dev docs: full reality-reconciliation at v0.4.0-alpha.1#379
ryan-johnson2 merged 1 commit into
develfrom
dev-docs-reconcile

Conversation

@ryan-johnson2

Copy link
Copy Markdown
Contributor

Four parallel code-checked audits over all 30 dev docs, findings applied: the GitLab planning apparatus replaced with GitHub reality, roadmap/vision rewritten around the released alpha, every 'planned/not built' flag that shipped flipped (Tauri, wizard, heat tagging, manual heat selection, re-detection), every claim that never shipped honestly marked (#80 loopback middleware, gate-start config, LapRF goldens), the one FSM error fixed in both lifecycle docs (Discard legal from Unofficial), Stop/SkipCountdown console reality noted, plugin slice statuses recorded (S0-S2 shipped / S3 partial / S4 Grid-side), and marshaling-plan retired with a SUPERSEDED banner. The orphaned .gitlab-ci.yml is deleted.

All 29 HTML files parse clean.

🤖 Generated with Claude Code

Four parallel audits (narrative, timer/integration, pipeline/format, core/process)
checked every dev doc against the shipped code; this applies their findings.

- roadmap: GitLab planning apparatus (§4/§5 + masthead/lead) replaced with the
  GitHub/GitFlow reality; status callout records the RELEASED v0.4.0-alpha.1 and
  the between-v0.3-and-alpha work (marshaling, race audio, audit, versioning);
  v0.3/v0.4 bodies annotated done/cut (Slice 5 → tournaments-snapshot); a new
  'in flight' block (alpha hardening, tournament rebuild, RH plugin slices);
  open decisions resolved (branch flow, per-format placement); diagram marks
  v0.1-v0.4 complete.
- vision: dated status callout (shipped / deferred-by-decision / future); table
  stakes re-scoped — marshaling is now a shipped differentiator, incumbents lead
  on structures/seasons/notifications; §7 defensible-results marked shipped.
- timer-adapters: the as-built staging flow (Stage-time prepare+seat, pre-stage
  re-prepare, 5s stage retry, per-arming pass gate, failover model, plugin
  handshake probe); Pass gains the D20 heat-tag field; plugin Direction callout
  gains an as-shipped status; signal reality (chunks/thresholds/dense history);
  harness = RH 4.4.0 built from source.
- rotorhazard-plugin: slice statuses (S0/S1/S2 shipped, S3 partial — clean
  start/stop NOT landed, socket path still production; S4 delivered Grid-side);
  protocol marked events-not-acks with shipped/unshipped channel markers; risks
  2/3/4/5 resolved/answered; install-steps reality.
- protocol: Tauri packaging SHIPPED; /about, /time, /plugin/gridfpv.zip, /audit,
  /rounds/standings routes added; loopback source-IP middleware honestly marked
  not-built (#80, dev/local-trust posture today).
- clients: workspace/wizard Planned→as-built (real tab set incl. Audit/Timers);
  Windows/macOS portables shipped; stale test counts dropped; app-wide race
  audio noted.
- race-engine + heat-lifecycle: Discard legal from Unofficial AND Final (the one
  outright FSM error, both diagrams+tables); SkipCountdown wire-only / ForceEnd
  = the console's Stop; IMD-aware channel selection (not first-fit); RD-driven
  heat production (no round-robin interleaver); one StartProcedure mode.
- live-state-clock: the real current_heat rule (HeatStateChanged /
  CurrentHeatSelected win; fill-no-steal) — manual selection is built.
- pipeline docs: wizard step order; event-level format-config superseded by
  rounds; track = decided-not-built; 'Practice' rename; qualifying gains
  0=open-ended, D24 freeze, D26 min-lap, #326 cite, multi-source FromRanking;
  mains as-built callout re-labeled pre-carve and the carry corrected to
  FromHeatWinners; format-model rollout + knobs current.
- testing-strategy: plugin-era harness inventory (race-day autopilot, RH 4.4.0
  image); LapRF/manual goldens marked aspirational; ZippyQ note; :8080.
- code-conventions: GitHub Actions CI reality + the one-version scheme; the
  orphaned .gitlab-ci.yml deleted.
- marshaling: §3.1/§3.2/§5 brought to the as-built vocabulary (lap-list editor,
  Throw out vs Remove, D26 floor instead of smart-minimum, Tune Detection
  SHIPPED); marshaling-plan gets a SUPERSEDED banner (kept as the build record)
  and is labeled so on the index.
- index: release-state = the tagged alpha; user docs live at docs.gridfpv.com;
  streaming scene map re-keyed to the real lifecycle names; integrations tense;
  'coming soon' boilerplate cleared everywhere.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@ryan-johnson2 ryan-johnson2 merged commit 4e0f796 into devel Jul 5, 2026
3 checks passed
@ryan-johnson2 ryan-johnson2 deleted the dev-docs-reconcile branch July 5, 2026 12:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant