Skip to content

Add bounded local draft recovery for app 0.3.0 - #40

Merged
yyods merged 29 commits into
mainfrom
feature/current-draft-recovery
Oct 31, 2026
Merged

yyods merged 29 commits into
mainfrom
feature/current-draft-recovery

Conversation

@yyods

@yyods yyods commented Oct 31, 2026 •

Copy link
Copy Markdown
Contributor

PyBLE's current editor text is lost when its process stops. App candidate 0.3.0+9 adds one atomic Drift recovery slot, explicit offline Restore/Discard, local checkpoint status and safe replacement choices. Recovered text requires current board-target consent; document/session guards prevent stale transfers from replacing newer edits or running on another attachment.

Validation: 972 ordinary Flutter tests pass; full analysis, formatting, localization, licensing and source gates pass. File-backed tests cover SIGKILL during writes, corrupt/newer schemas, full/read-only storage, bounded metadata hydration and tombstones. Native seed → process termination → verify checks passed on Lenovo Android 12 and iPadOS 26.6.2 with unchanged closed database hashes. The Lenovo production entry also passed explicit local checkpoint, force-stop/relaunch, offline Restore, physical ESP32 Save/Run destination confirmation, print(123) execution and durable New cleanup. The final scan shows all five boards. The created board file was deleted and durable New cleanup was verified across another fresh launch.

Both implementation CI runs at 709556e passed all 18 jobs (36 checks), including pinned golden and native Android jobs. The final follow-up changes are documentation-only and their CI is visible on this PR. Local macOS 27 golden mismatches reproduce byte-for-byte on unchanged main; existing baselines remain unchanged.

The absent classic ESP32 8C9E was diagnosed as an intentional invalid-media fixture left by an earlier qualification run. After a fresh backup, exact fixture verification and offline inspection of the verified original workspace, only the workspace region was restored. The flash tool verified its hash and the existing 0.6.1 firmware resumed advertising. The original owner backup and failed-test evidence remain preserved. The HIL guide now requires an explicit runtime-ready handback after invalid-media tests.

Draft pending the remaining iPad production interaction/board-consent scenarios, affected release matrix and release review. Source implementation does not complete full A-24, pilot work or store publication.

Execution, operator instructions and artifact/incident evidence:

  • docs/developments/2026-q4-reliable-workflow/c1-s2/00_Execution_Record.md
  • docs/developments/2026-q4-reliable-workflow/c1-s2/01_Operator_Recipe.md
  • docs/developments/2026-q4-reliable-workflow/c1-s2/02_Platform_Qualification.md
  • docs/developments/2026-q4-reliable-workflow/c1-s2/03_Classic_ESP32_Workspace_Recovery.md

yyods added 29 commits October 31, 2026 10:40
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
…ents

Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
…ents

Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
…ions

Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
…flow

Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
@yyods
yyods marked this pull request as ready for review October 31, 2026 08:12
@yyods
yyods merged commit 6f5b3ea into main Oct 31, 2026
36 checks passed
@yyods
yyods deleted the feature/current-draft-recovery branch October 31, 2026 08:12
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