Skip to content

Commit 81a4acc

Browse files
committed
[docs] Bind the runtime agent version to the release lock
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
1 parent b558bb2 commit 81a4acc

1 file changed

Lines changed: 7 additions & 2 deletions

File tree

‎docs/specifications/firmware/specs.md‎

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -544,7 +544,7 @@ This is software-level safety of the IDE/agent, **not** hardware/actuator safety
544544
## 8. Build, versioning & distribution (BLD)
545545

546546
> **FROZEN v1.0 (amended) for the initial ESP32 v1 port (G0 · 2026-07-01;
547-
> browser-release amendments 2026-07-29 and 2026-07-30 · `[docs]`).**
547+
> browser-release amendments 2026-07-29 through 2026-07-31 · `[docs]`).**
548548
> BLD-1…22 are the build/versioning contract build-smith implements. The
549549
> 2026-07-29 amendments tighten BLD-5…8/13/14 and add BLD-17…22 before
550550
> X-10/X-11 code; the 2026-07-30 amendment freezes the two-profile pre-v1
@@ -619,7 +619,12 @@ This is software-level safety of the IDE/agent, **not** hardware/actuator safety
619619
[`versions.lock`](../../../firmware/versions.lock); verify: build; story:
620620
X-03)*
621621
- **BLD-11** — ESP-IDF MUST be installed from the pin into a **gitignored** directory (not an outer submodule); MicroPython `lib/` deps come from the standard port build. — *(source: PRD §10.9, §17.1; verify: build; story: X-03)*
622-
- **BLD-12** — The firmware agent MUST follow **SemVer** (`MAJOR.MINOR.PATCH`); a backward-incompatible change bumps MAJOR. — *(source: PRD §18.1; verify: build; story: X-11)*
622+
- **BLD-12** — The firmware agent MUST follow **SemVer**
623+
(`MAJOR.MINOR.PATCH`); a backward-incompatible change bumps MAJOR.
624+
`firmware/versions.lock` `[pyble].agent_version` is the canonical agent
625+
version for a source commit, and the importable `pyble.__version__` used by
626+
`DEVICE_INFO`/HELLO MUST equal it exactly. — *(source: PRD §18.1; verify:
627+
build; story: X-11)*
623628
- **BLD-13** — A release MUST make the firmware-agent version, PBLE/1 version,
624629
upstream MicroPython/ESP-IDF versions and commits, PyBLE source commit, image
625630
profile, and artifact hashes recoverable from `DEVICE_INFO`/HELLO,

0 commit comments

Comments
 (0)