Skip to content

docs(adr): correct ADR 0001 evidence left by the living-audit deferral - #796

Merged
tylerkron merged 2 commits into
mainfrom
cursor/adr-0001-evidence-bb49
Sep 27, 2026
Merged

tylerkron merged 2 commits into
mainfrom
cursor/adr-0001-evidence-bb49

Conversation

@tylerkron

@tylerkron tylerkron commented Sep 26, 2026 •

Copy link
Copy Markdown
Contributor

Unblocked residue of the ADR 0001 living-audit deferral. Docs only, and only the two stale evidence paragraphs in docs/adr/0001-firmware-feature-gating.md. Stays out of #759’s hunks (Decision 1, the DeviceFeature sketch, consequences, and the living-audit rewrite); a git merge-tree of this branch with #759's head merges cleanly. Does not touch docs/DEVICE_INTERFACES.md.

What was wrong

Checked against current main and the firmware repo's releases:

  • The release timeline stopped at v3.7.2 and called it "current firmware HEAD". Two newer tags now exist, both pre-releases: v3.7.3 (2026-08-31), which is v3.7.2 plus cherry-picked SD fixes and adds the __TRANSFER_ERROR__ marker on a mid-transfer SD:GET read error (firmware ContinuousDeviceFinder: a timed-out pass and a metadata-only change are both silent, so a UI cannot tell degraded discovery from quiet discovery #725, already documented in SdCardTransferErrorException and SdCardFileReceiver), and v3.8.0 (2026-09-06), which supersedes v3.7.3 and includes its fixes. v3.7.2 is still the latest full release.
  • The enabling-fact paragraph said core does not parse the numeric SCPI code, and cited DaqifiStreamingDevice.IsScpiErrorLine, which does not exist. The classifier is ScpiResponseClassifier.IsScpiErrorLine, the parser is ScpiResponseClassifier.TryExtractErrorCode, and SdCardOperations.GetSdCardStorageAsync already throws FeatureNotSupportedException on -113.

What changed

No decision text, no feature table, no benchmarks.

Open in Web Open in Cursor 

🤖 Generated with Claude Code

The living-audit timeline still called v3.7.2 firmware HEAD, and the
enabling-fact paragraph cited a member that does not exist and claimed
the numeric SCPI code was unparsed. Point both at the code on main.

Co-authored-by: Tyler Kron <tylerkron@gmail.com>
@tylerkron
tylerkron requested a review from a team as a code owner September 26, 2026 10:34
@qodo-code-review

qodo-code-review Bot commented Sep 26, 2026 •

Copy link
Copy Markdown

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📎 Requirement gaps (0)

Grey Divider

Great, no issues found!

Qodo reviewed your code and found no material issues that require review

Grey Divider

Tip of the day
💡 Did you know, you can describe a rule in plain language on the Rules page and Qodo drafts it for you

More tips ↗ | Customize Qodo ↗ | Qodo docs ↗

Grey Divider

Previous reviews

Review updated until commit 0e4f3bb ⏭️ Skipped

Results up to commit 3a0f87f ⏭️ Skipped


No changes from previous review

Grey Divider

Qodo Logo

@qodo-code-review

Copy link
Copy Markdown

PR Summary by Qodo

Correct ADR 0001 firmware and SCPI evidence

📝 Documentation 🕐 Less than 5 minutes

Grey Divider

AI Description

• Updates firmware HEAD evidence to v3.7.3 and records SD transfer-error behavior.
• Aligns SCPI classification, numeric parsing, and feature-gating evidence with current core code.
Diagram

graph TD
  FW["Firmware v3.7.3"] -->|release evidence| ADR["ADR 0001 audit"]
  SCPI["SCPI classifier"] -->|classification and parsing| ADR
  SD["SD operations"] -->|minus 113 behavior| ADR
Loading
High-Level Assessment

The narrow documentation-only correction is optimal because it fixes stale evidence without modifying ADR decisions or overlapping the deferred living-audit rewrite. A broader ADR revision was considered but would unnecessarily expand scope and conflict risk.

Files changed (1) +6 / -5

Documentation (1) +6 / -5
0001-firmware-feature-gating.mdCorrect firmware HEAD and SCPI parsing evidence +6/-5

Correct firmware HEAD and SCPI parsing evidence

• Updates the firmware timeline to identify v3.7.3 as current HEAD and records the SD transfer-error marker. Replaces stale SCPI references with the actual classifier, numeric-code parser, and existing -113 feature-not-supported behavior.

docs/adr/0001-firmware-feature-gating.md

v3.7.3 is a pre-release cherry-picked onto v3.7.2, and v3.8.0 (also a
pre-release) has since superseded it. v3.7.2 remains the latest full
release. Say that instead of naming any tag as current HEAD.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tylerkron

Copy link
Copy Markdown
Contributor Author

/agentic_review

@qodo-code-review

Copy link
Copy Markdown

Code review by qodo was updated up to the latest commit 0e4f3bb

@tylerkron

Copy link
Copy Markdown
Contributor Author

Qodo-clean, CI green — ready for review

@tylerkron
tylerkron added this pull request to the merge queue Sep 27, 2026
Merged via the queue into main with commit ae9312c Sep 27, 2026
4 checks passed
@tylerkron
tylerkron deleted the cursor/adr-0001-evidence-bb49 branch September 27, 2026 22:33
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.

2 participants