Skip to content

Commit 5083842

Browse files
committed
[docs] update C1-S1 plans from connected-device evidence
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
1 parent 4171aff commit 5083842

8 files changed

Lines changed: 69 additions & 51 deletions

File tree

‎CHANGELOG.md‎

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -84,15 +84,19 @@ and submission packet do not claim Play submission, approval, or rollout.
8484
regression assertions while retaining the high/critical audit gate.
8585
- Added the reviewed Cycle 1 roadmap, milestones, Scrum working agreement,
8686
stories and Sprint Backlogs, plus C1-S1 execution evidence and operational
87-
pilot/validation procedures. Physical installation and participant work
88-
remain blocked; no pilot results or new release are claimed.
87+
pilot/validation procedures. Verified existing Play 0.2.0 (8) and TestFlight
88+
0.2.0 (6) installations and launches on connected tablets; pilot setup and
89+
participant evidence remain pending. No fresh enrollment, reinstall, pilot
90+
results or new release are claimed.
8991
- Specified bounded Drift current-text recovery, local restore/discard,
9092
failure handling and document/session guards in ADR-0048 and the App
9193
contracts. Implementation remains pending; sizing requires revising the
9294
original S2 forecast.
9395
- Verified live Android open-testing wording and prepared correction of the
94-
older public TestFlight description. Store-installed build identities remain
95-
unverified and the TestFlight metadata change remains pending.
96+
older public TestFlight description. Installed identities are now recorded;
97+
Android code/assets match the retained build-8 AAB, while iPad build-6 source
98+
mapping and a minimum-OS metadata discrepancy need distribution-owner
99+
follow-up. The TestFlight metadata change remains pending.
96100
- Prepared Google Play open-testing listing text, reviewer hardware setup,
97101
tester instructions, data-use assessment, and reproducible store artwork
98102
with authentic screenshot provenance. Store availability remains a separate

‎docs/README.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,8 @@ maintainer guidance beside the source they govern.
2424
— roadmap, milestones, stories and capacity forecasts
2525
- [C1-S1 execution record](developments/2026-q4-reliable-workflow/c1-s1/00_Execution_Record.md)
2626
— channel evidence, pilot kit, recovery contract/sizing and validation recipe;
27-
physical installation and participant work remain blocked
27+
existing Play/TestFlight installations verified; pilot setup and participant
28+
evidence remain pending
2829

2930
## Detailed specifications
3031

‎docs/ROADMAP.md‎

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -32,9 +32,11 @@ v0.7.0 remains non-normative and requires separate maintainer approval.
3232
## Near term
3333

3434
- Complete the [C1-S1 remaining evidence](developments/2026-q4-reliable-workflow/c1-s1/00_Execution_Record.md):
35-
physical store installations, confirmed pilot ownership/setup and five real
36-
baseline observations. The channel ledger, pilot kit, recovery design and
37-
validation inventory are prepared; this does not complete the Sprint.
35+
confirmed pilot ownership/setup, actual capacity and five real baseline
36+
observations. Existing Play 0.2.0 (8) and TestFlight 0.2.0 (6) installations
37+
and launches are verified on connected tablets; fresh enrollment/reinstallation
38+
was not exercised. The pilot kit, recovery design and validation inventory
39+
are prepared; this does not complete the Sprint or board qualification.
3840
- Implement the [bounded current-text recovery contract](specifications/App/current-draft-recovery.md)
3941
after replanning against its 45–72 hour working estimate for engineering,
4042
recipe, representative platform checks and follow-up. Current drafts remain
@@ -45,8 +47,13 @@ v0.7.0 remains non-normative and requires separate maintainer approval.
4547
[Android publication review](testing/website/android-open-testing-2026-09-25.md)
4648
records live open-testing availability. The
4749
[prepared build-8 handoff](testing/google-play/0.2.0-build-8.md) remains a
48-
source-specific historical record, not validation of subsequent source
49-
changes in the installed store app.
50+
source-specific historical record. The [current Android installation check](developments/2026-q4-reliable-workflow/c1-s1/06_Android_Channel_Verification.md)
51+
matches 38 retained code/asset entries to that AAB; this supports its historical
52+
source mapping, not complete binary equivalence or validation of subsequent
53+
source changes. The [iPad check](developments/2026-q4-reliable-workflow/c1-s1/07_iPad_Channel_Verification.md)
54+
records TestFlight build 6 with source mapping unresolved; distribution-owner
55+
review is needed for conflicting minimum-OS metadata before making a support
56+
claim.
5057
- Review the proposed v0.7.0 Reliable Projects scope before implementation.
5158
- Expand user-facing setup, recovery, and board-specific wiring guidance
5259
- Gather Android open-testing feedback and improve installation and recovery

‎docs/developments/2026-q4-reliable-workflow/02_Product_Roadmap.md‎

Lines changed: 10 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@
55

66
| Control | Value |
77
|---|---|
8-
| Status | C1-S1 repository work recorded; physical/pilot tasks blocked. Future direction remains conditional and forecasts need revision after sizing |
8+
| Status | C1-S1 has six tasks Done, two Prepared awaiting pilot setup and four Awaiting evidence; existing channel installations verified. Future direction remains conditional and forecasts need revision after sizing |
99
| Planning date | 25 September 2026; dates use Asia/Bangkok |
10-
| Source | [Implementation strategy revision 1.3](../../planning/PyBLE_Implementation_Plan_and_Strategy_v1.0.md), particularly §§1, 6–9, 12, 14, and 19 |
10+
| Source | [Implementation strategy revision 1.4](../../planning/PyBLE_Implementation_Plan_and_Strategy_v1.0.md), particularly §§1, 6–9, 12, 14, and 19 |
1111
| Inspected baseline | `main` at `23ed764b0ef88dce9720c66fbd1c0655268860cf` |
1212
| First cycle | C1: 28 September–20 December 2026; later horizons conditional through September 2028 |
1313
| Planning authority | Product Owner orders the Product Backlog; Developers forecast feasible work during Sprint Planning; names and capacity remain unassigned |
@@ -32,14 +32,17 @@ continues to communicate direction without promising release dates.
3232

3333
## Completed baseline and remaining uncertainty
3434

35-
These records are inputs to planning, not new achievements of this development
36-
cycle. The [C1-S1 record](c1-s1/00_Execution_Record.md) distinguishes completed design/evidence preparation from blocked installations and observations. Future work remains **Proposed** until explicitly selected.
35+
These records distinguish the historical baseline from the dated device retry.
36+
The [C1-S1 record](c1-s1/00_Execution_Record.md) records completed design/evidence
37+
preparation and existing channel installations separately from prepared pilot
38+
work and missing observations. Future work remains **Proposed** until explicitly
39+
selected.
3740

3841
| Baseline item | Recorded state at the planning date | Consequence for this roadmap |
3942
|---|---|---|
4043
| Android distribution and public copy | Google Play 0.2.0 open testing; direct live-site checks on 25 September confirm the PR #33 correction | Preserve accurate copy; newly found TestFlight description discrepancy is PYB-002.1 |
41-
| App source and installed identity | Source `0.2.0+8`; source version alone does not identify an installed Play/TestFlight binary | PYB-001 records actual installed versions/builds and source mapping or explicit unknowns |
42-
| iPad distribution | External TestFlight beta is the recorded channel | Verify the selected installation path and artifact evidence; do not infer production App Store availability |
44+
| App source and installed identity | [Lenovo Android](c1-s1/06_Android_Channel_Verification.md): Play `0.2.0 (8)` with beta enrollment, Open and launch verified; 38/38 code/asset entries match the retained AAB | Evidence supports historical source `768fafe`; it is not complete binary equivalence, a Play Console record or validation of later source changes |
45+
| iPad distribution | [iPad](c1-s1/07_iPad_Channel_Verification.md): existing TestFlight `0.2.0 (6)` with offered build, Open, launch and beta signing verified | Source mapping remains unknown; minimum-OS metadata conflict needs owner review. Fresh enrollment/reinstallation and production App Store availability are not claimed |
4346
| Existing workflow | PBLE/1 editing, files, run/stop, console, Blocks, tutorials, and reviewed import already exist | Reuse implementation and tests; improve measured failures rather than rebuild the workflow |
4447
| Firmware v0.6.1 | Owner-confirmed publication for five exact profiles; incomplete automated evidence remains visible | New qualification and compatibility claims require their own applicable evidence |
4548
| Historical issue #24 | Closed as superseded; incomplete checklist was not declared passed | Do not recreate closure as a new dependency or treat historical closure as qualification |
@@ -81,7 +84,7 @@ for one maintainer. All rows in this table have status **Proposed**.
8184
**Sizing update:** recovery now has a 45–72 hour working estimate including supporting tasks. Its 60-hour S2–S4 allocation option would displace original matrix/activation work. The table above is the original sequencing baseline, not a validated selection; replan before using its delivery dates. The full matrix has its own [costed inventory](c1-s1/04_Validation_Inventory_and_Operator_Recipe.md).
8285

8386
The [Sprint Plan](04_Sprint_Plan.md) owns detailed dates and capacity. The first
84-
Sprint Backlog now records early C1-S1 execution and its remaining blockers;
87+
Sprint Backlog now records early C1-S1 execution and pending pilot evidence;
8588
later allocations are forecasts requiring replanning. A milestone review neither replaces a Sprint Review nor supplies
8689
missing Definition of Done evidence.
8790

‎docs/developments/2026-q4-reliable-workflow/03_Milestones.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@
55

66
| Control | Value |
77
|---|---|
8-
| Status | M-01/SG0 assessed Blocked on 25 September; other milestones remain Proposed and forecast windows need replanning |
8+
| Status | M-01/SG0 remains Blocked on 25 September by pilot ownership/cohort/setup and capacity decisions; existing channel installations verified on retry. Other milestones remain Proposed and forecast windows need replanning |
99
| Planning date | 25 September 2026; dates use Asia/Bangkok |
10-
| Source | [Implementation strategy revision 1.3](../../planning/PyBLE_Implementation_Plan_and_Strategy_v1.0.md), especially §§4, 8–10, 14, and 19 |
10+
| Source | [Implementation strategy revision 1.4](../../planning/PyBLE_Implementation_Plan_and_Strategy_v1.0.md), especially §§4, 8–10, 14, and 19 |
1111
| Inspected baseline | `main` at `23ed764b0ef88dce9720c66fbd1c0655268860cf` |
1212
| Related documents | [Framework](01_Overview_and_Scrum_Framework.md), [roadmap](02_Product_Roadmap.md), [Sprint Plan](04_Sprint_Plan.md), [stories](05_Product_Backlog_and_Stories.md), [Sprint Backlogs](06_Sprint_Backlogs.md) |
1313
| Meaning | Milestones describe inspectable outcomes and decision evidence; they are not additional Scrum events or promised releases |
@@ -51,7 +51,7 @@ no role in this table implies committed staffing or independent review.
5151
| M-05 — Proposed | Users can obtain the selected qualified app build through a verified existing channel | C1-S5–C1-S6, 23 Nov–20 Dec; PYB-014 and residual 002 | M-04; distribution-owner access; separate submission, availability, installed build/provenance, and installation outcome records; current user-facing claims | Verified-channel milestone passes only for the stated evidence; store delays are recorded as blockers; release owner |
5252
| M-06 — Proposed | Useful-repeat and support evidence drives one explicit next-stage investment | C1-S6, 7–20 Dec; PYB-011 follow-up, cycle review; Ready inputs only if selected | Mature consented cohort accounting, useful Task C/return outcomes, task opportunity, prompting, missing responses, support burden, and status of candidate/channel evidence; retain blocked outcomes | SG3 assessment plus dated continue/narrow/pause-expansion decision; Product Owner with pilot and Developers |
5353

54-
[C1-S1 evidence](c1-s1/00_Execution_Record.md) prepares the ledger, pilot protocol, recovery contract and cost model, but does not satisfy missing human ownership, confirmed capacity, device installations or participant observations. M-01/SG0 remains blocked. M-02's S2–S3 window is the original baseline; a sized S2–S4 option now requires explicit replanning, with downstream matrix/recruitment dates reviewed together.
54+
[C1-S1 evidence](c1-s1/00_Execution_Record.md) includes the ledger, pilot protocol, recovery contract, cost model and verified existing Play/TestFlight installations. Six tasks are Done, two are Prepared awaiting pilot setup and four await participant/observation evidence. Human ownership, cohort/setup and actual capacity remain unconfirmed, so M-01/SG0 remains blocked. Missing participants are recorded as a recruitment gap, not completed observations. Current-build verification does not pass M-05 for a future qualified update. M-02's S2–S3 window is the original baseline; a sized S2–S4 option now requires explicit replanning, with downstream matrix/recruitment dates reviewed together.
5555

5656
M-04 may occur in any Sprint once a maintenance candidate qualifies. M-03 and
5757
M-06 do not block it. M-06 can assess learning and choose a narrower next step

‎docs/developments/2026-q4-reliable-workflow/04_Sprint_Plan.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77
|---|---|
88
| Status | C1-S1 early execution recorded; original S2–S6 forecasts are not ready for selection after the new recovery/matrix estimates |
99
| Cycle | `C1`, 28 September–20 December 2026, Asia/Bangkok |
10-
| Basis | [Strategy revision 1.3, §8](../../planning/PyBLE_Implementation_Plan_and_Strategy_v1.0.md#8-twelve-week-implementation-schedule) |
10+
| Basis | [Strategy revision 1.4, §8](../../planning/PyBLE_Implementation_Plan_and_Strategy_v1.0.md#8-twelve-week-implementation-schedule) |
1111
| Product Goal and quality rules | [Working agreement](01_Overview_and_Scrum_Framework.md) |
1212
| Acceptance criteria | [Product backlog and stories](05_Product_Backlog_and_Stories.md) |
1313
| Task-level proposal | [Sprint backlogs](06_Sprint_Backlogs.md) |
@@ -16,7 +16,7 @@
1616

1717
| Planning element | Treatment |
1818
|---|---|
19-
| `C1-S1` | Early repository execution recorded; remaining device/pilot tasks blocked. Actual staffing and the original formal timebox still require confirmation |
19+
| `C1-S1` | Six tasks Done, including existing channel installations; two Prepared awaiting pilot setup and four Awaiting evidence. Actual staffing and the original formal timebox still require confirmation |
2020
| `C1-S2` … `C1-S6` | Forecasts revised using preceding results, capacity and learning |
2121
| Sprint Goal | One coherent outcome confirmed by the Scrum Team at Planning |
2222
| Scope and task details | Developers select feasible items and adapt their plan with the Product Owner as learning changes scope |
@@ -26,14 +26,14 @@
2626

2727
## C1-S1 findings and required reforecast
2828

29-
[Execution evidence](c1-s1/00_Execution_Record.md) records four completed repository tasks and eight blocked installation/pilot tasks. The original calendar is retained; no completed Sprint or SG0 approval is claimed.
29+
[Execution evidence](c1-s1/00_Execution_Record.md) records six Done tasks after verifying existing Play and TestFlight installations. T04/T05 are Prepared awaiting pilot setup; T06–T08 await participants and T09 awaits observation records. These more specific states preserve their acceptance criteria. The original calendar is retained; no completed Sprint or SG0 approval is claimed.
3030

3131
| New sizing input | Planning consequence |
3232
|---|---|
3333
| Recovery engineering 38–63h; recipe, representative physical work and one follow-up allowance bring the original two-week scope to 45–72h | Original S2 allowance is insufficient; contract and all required failure/session protections remain intact |
3434
| [Working allocation option](c1-s1/03_Recovery_Design_and_Sizing.md): S2 26h, S3 22h, S4 12h, totaling 60h | Fits within the three 26h ceilings only by replacing original selections; includes 50h engineering, 2h recipe, 5h physical and 3h rolling follow-up |
3535
| [App matrix](c1-s1/04_Validation_Inventory_and_Operator_Recipe.md): 13.5–26 operator h; fresh firmware qualification 30–59h excluding builds/access/repair | Select the applicable scope; do not treat app-only work as a new firmware release or count representative recovery runs twice |
36-
| Missing human capacity, pilot owner and physical access | Confirm before selecting the revised scope; maintain rolling follow-up only for actual consenting activations |
36+
| Connected tablets now verified; human capacity, pilot owner and exact-board setup still unconfirmed | Bind future recovery runs to their actual candidate and board, and confirm owners before selecting revised scope; maintain rolling follow-up only for actual consenting activations |
3737

3838
The remaining 18h under S2–S4's combined 78h ceiling cannot silently absorb all displaced matrix, activation and repair tasks. Reorder those tasks, review the November recruitment window, and reforecast S5/S6 if required. The tables below preserve the original allowance/calendar for comparison; they are **not** an adopted revised forecast. A tested foundation is not the completed recovery user story. All selected increments still need their applicable Definition of Done.
3939

0 commit comments

Comments
 (0)