Skip to content

Commit 8dde8d6

Browse files
committed
[docs] reconcile C1-S1 device retry and remaining pilot work
Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
1 parent 5083842 commit 8dde8d6

10 files changed

Lines changed: 111 additions & 79 deletions

‎docs/developments/2026-q4-reliable-workflow/01_Overview_and_Scrum_Framework.md‎

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,10 +9,10 @@
99
|---|---|
1010
| Package | PyBLE 2026 Q4 reliable workflow, Cycle 1 (`C1`) |
1111
| Prepared | 25 September 2026; Asia/Bangkok |
12-
| Strategy | [Implementation Plan, revision 1.3](../../planning/PyBLE_Implementation_Plan_and_Strategy_v1.0.md) |
12+
| Strategy | [Implementation Plan, revision 1.4](../../planning/PyBLE_Implementation_Plan_and_Strategy_v1.0.md) |
1313
| Repository baseline | `23ed764b0ef88dce9720c66fbd1c0655268860cf` |
1414
| Proposed cycle | 28 September–20 December 2026; six two-week Sprints |
15-
| Status | C1-S1 execution initiated on 25 September; repository deliverables prepared and physical/pilot work blocked. Later Sprints require replanning against new sizing; no staffed-team ceremony is inferred |
15+
| Status | C1-S1 device retry on 25 September: six tasks Done, two Prepared and four Awaiting evidence; both current channel installations verified, pilot work unfinished. Later Sprints require replanning against new sizing; no staffed-team ceremony is inferred |
1616
| Primary audience | Tablet-owning makers, provisionally; confirm one reachable cohort before observation |
1717
| Authoritative contracts | [Contributor rules](../../../AGENTS.md), [App specification](../../specifications/App/specs.md), [App TDD](../../specifications/App/TDD.md), [PBLE/1](../../specifications/protocol.md), and applicable firmware/release specifications |
1818

@@ -32,7 +32,7 @@ This package derives execution views from the strategy. It does not replace norm
3232

3333
```mermaid
3434
flowchart LR
35-
Strategy["Strategy revision 1.3"] --> Goal["One Product Goal"]
35+
Strategy["Strategy revision 1.4"] --> Goal["One Product Goal"]
3636
Goal --> Roadmap["Outcome roadmap and milestones"]
3737
Roadmap --> Product["Ordered Product Backlog"]
3838
Product --> Planning["Sprint Planning"]
@@ -58,7 +58,7 @@ flowchart LR
5858
| Baseline fact | Consequence |
5959
|---|---|
6060
| Android open-testing copy correction is complete in PR #33 | Do not replan that correction; identify any new discrepancy separately |
61-
| App source is `0.2.0+8`; Play publicly identifies `0.2.0`; iPad remains external TestFlight beta | Source version does not prove the installed store binary or its source commit |
61+
| App source is `0.2.0+8`; physical retry verifies Play `0.2.0 (8)` and TestFlight `0.2.0 (6)` | Android payloads map to the historical build-8 bundle; iPad source mapping remains unknown. Neither channel check proves BLE or older-OS compatibility |
6262
| Firmware v0.6.1 is published on owner confirmation across five exact profiles | Pending automated results stay pending; no automatic PyBLE Ready badge |
6363
| Issue #24 is closed/superseded | Do not resurrect its old release umbrella as a dependency |
6464
| Editor draft is volatile under [ADR-0010](../../decisions/0010-working-loop-in-memory-document.md) | Close an accepted subset of A-24; do not claim full project persistence or Blocks recovery |
@@ -107,7 +107,7 @@ Readiness is a local refinement aid. It does not replace Sprint Planning or add
107107
| Claims have evidence | Exact artifacts, pass/fail/not-run states, limitations and pending release work recorded truthfully |
108108
| Documentation/discovery scope is complete | Usable reviewed record/guide or agreed findings, source/link checks, and explicit unmet targets; no invented physical results |
109109

110-
This is the proposed package-wide minimum; accepted normative requirements remain binding. Apply it to the selected item rather than treating a source merge as a finished feature. A documentation or discovery item can be Done with a negative finding, while a required physical-installation task cannot be Done if no installation happened. A usable Sprint 1 documentation increment should help an operator or user perform the current workflow; an internal plan alone is not evidence of improved app behavior.
110+
This is the proposed package-wide minimum; accepted normative requirements remain binding. Apply it to the selected item rather than treating a source merge as a finished feature. A documentation or discovery item can be Done with a negative finding, while a required channel-installation verification task needs observed installation identity, origin and launch; verifying an existing installation does not imply a fresh install. A usable Sprint 1 documentation increment should help an operator or user perform the current workflow; an internal plan alone is not evidence of improved app behavior.
111111

112112
| State distinction | Meaning |
113113
|---|---|
@@ -128,7 +128,7 @@ Unfinished items return to the Product Backlog for reordering and replanning. Do
128128
| `C1-S1` … `C1-S6` | This cycle's Sprints; distinct from historical App TDD Sprint labels |
129129
| `C1-S1-T01`, etc. | Task identities with recorded early C1-S1 outcomes; later task rows remain forecasts, not new public contracts |
130130
| `M-01`, etc.; `SG0` … `SG6` | Delivery milestones versus strategy gates; neither replaces CI G0/G1 or C3 firmware gates |
131-
| Item/task status | Proposed → Selected at Planning → In progress → Review → Done; Blocked records a reason/owner; later forecasts remain Proposed |
131+
| Item/task status | Proposed → Selected at Planning → In progress → Review → Done. Prepared means a reviewed partial deliverable; Awaiting evidence identifies an unperformed observation/session. Both remain unfinished. Blocked names a concrete impediment/owner; later forecasts remain Proposed |
132132
| Private versus public records | Contact/consent, device identifiers and raw logs remain private/ignored; publish only reviewed aggregate findings and redacted evidence |
133133

134134
When facts or priority change, update the canonical file above and its dependent tables together. Preserve old evidence and dated decisions. New opcode/capability values, hardware support, Ready awards, and publication need their normal specification and authorization paths; none is inferred from this package.
@@ -137,9 +137,9 @@ When facts or priority change, update the canonical file above and its dependent
137137

138138
| Source | Use and precedence |
139139
|---|---|
140-
| [Strategy revision 1.3](../../planning/PyBLE_Implementation_Plan_and_Strategy_v1.0.md) | Scope, targets, six-Sprint capacity, three outcomes, Ready program and conditional horizons |
140+
| [Strategy revision 1.4](../../planning/PyBLE_Implementation_Plan_and_Strategy_v1.0.md) | Scope, targets, six-Sprint capacity, three outcomes, Ready program and conditional horizons |
141141
| [Public roadmap](../../ROADMAP.md), [README](../../../README.md) | Current capability and distribution baseline |
142142
| [App specification](../../specifications/App/specs.md), [App TDD](../../specifications/App/TDD.md), [ADR-0010](../../decisions/0010-working-loop-in-memory-document.md) | Persistence contract and recorded implementation deviation; consult frozen working-loop scope |
143143
| [Firmware roadmap](../../planning/firmware-v0.6.1-v0.7.0-roadmap.md), [PBLE/1](../../specifications/protocol.md) | v0.7 proposals versus frozen wire behavior; old v0.6.1 publication/#24 wording is historical |
144-
| [Android publication review](../../testing/website/android-open-testing-2026-09-25.md), [v0.6.1 publication record](../../testing/firmware-v0.6.1-publication-2026-09-11.md) | Dated evidence; neither establishes a newly installed binary or missing automated qualification |
144+
| [Android publication review](../../testing/website/android-open-testing-2026-09-25.md), [v0.6.1 publication record](../../testing/firmware-v0.6.1-publication-2026-09-11.md) | Dated publication evidence, separate from the new [Android](c1-s1/06_Android_Channel_Verification.md) and [iPad](c1-s1/07_iPad_Channel_Verification.md) existing-installation checks; missing automated qualification remains unfinished |
145145
| [HIL guide](../../../tests/firmware_tests/hil/README.md), [CI workflow](../../../.github/workflows/ci.yml), [CONTRIBUTING](../../../CONTRIBUTING.md) | Reuse existing tools and gates; actual CI requirements govern merges |

‎docs/developments/2026-q4-reliable-workflow/06_Sprint_Backlogs.md‎

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

66
| Field | Rule |
77
|---|---|
8-
| Status | C1-S1 execution initiated 25 September: four repository tasks Done, eight device/pilot tasks Blocked. C1-S2–C1-S6 retain original Proposed allowances and require replanning before selection |
8+
| Status | C1-S1 device retry 25 September: six tasks Done, two Prepared and four Awaiting evidence. Both current channel installations verified; participant-dependent work remains unfinished. C1-S2–C1-S6 retain original Proposed allowances and require replanning before selection |
99
| Product/Sprint Goals | [Framework](01_Overview_and_Scrum_Framework.md) and [Sprint plan](04_Sprint_Plan.md) |
1010
| Acceptance authority | [Product backlog and stories](05_Product_Backlog_and_Stories.md); task completion never overrides a parent story's acceptance criteria |
1111
| Selection | Developers confirm scope, ownership, estimates and task plan at each Sprint Planning |
1212
| Hours | Initial task allowances totaling the source plan's 136 hours; not story points or validated effort estimates |
1313
| Dependencies | Same-Sprint `Txx` references refer to that Sprint's task. Cross-Sprint dependencies name their full item/task ID |
14-
| Evidence | Record artifact identity and actual results; unavailable access/recruitment leaves the affected task Blocked, not Done |
14+
| Evidence | Record artifact identity and actual results; use Prepared for reviewed partial work, Awaiting evidence for unperformed sessions/observations, and Blocked for a concrete impediment with an owner; unfinished work is never Done |
1515
| Privacy | Keep private consent/contact/device records outside Git; link only reviewed public aggregates and redacted evidence |
1616

1717
Actual task evidence and blocker owners are maintained in the [C1-S1 execution record](c1-s1/00_Execution_Record.md). The original future task tables below are retained as the baseline; the new 45–72h recovery estimate and matrix cost model invalidate their assumed fit. Use the [reforecast requirements](04_Sprint_Plan.md#c1-s1-findings-and-required-reforecast) before selection. Prepared TestFlight correction copy records residual PYB-002.1; its external application is not an extra committed task.
@@ -33,19 +33,21 @@ Record optional follow-up consent and the prospective day-7–14 window at each
3333
| Task ID | Parent child item | Proposed task and expected output | Dependency | Contribution role | h | Status |
3434
|---|---|---|---|---|---:|---|
3535
| C1-S1-T01 | PYB-001.1 | Assemble the dated channel/install/provenance/qualification ledger from existing records; assign unresolved fields | Current source/publication records | Release | 1 | Done |
36-
| C1-S1-T02 | PYB-001.2 | Verify eligible Android enrollment/install and record build/version, restrictions and available source mapping | T01; Play/device access | Release + QA | 2 | Blocked |
37-
| C1-S1-T03 | PYB-001.2 | Verify current TestFlight installation and record its actual build and provenance limitations | T01; TestFlight/device access | Release + QA | 2 | Blocked |
38-
| C1-S1-T04 | PYB-003.1 | Review harmless hardware/pilot boundaries, consent/retention rules, and manual support template | Recorded pilot setup; named pilot owner | Pilot + QA | 2 | Blocked |
39-
| C1-S1-T05 | PYB-004.1 | Confirm primary cohort and Tasks A/B/C, assistance/timeout rules, previous workflow and prospective follow-up | T04; recorded app/setup | Pilot | 2 | Blocked |
40-
| C1-S1-T06 | PYB-004.2 / PYB-011.2 | Observe the first baseline batch; record every eligible start, assistance, consent/window and any due follow-up | T05; consenting participants | Pilot | 2 | Blocked |
41-
| C1-S1-T07 | PYB-004.2 / PYB-011.2 | Observe the next baseline batch under the same task/build rules; record windows and collect due follow-up | T05; consenting participants | Pilot | 2 | Blocked |
42-
| C1-S1-T08 | PYB-004.2 / PYB-011.2 | Complete planned observation/follow-up slots toward five baseline starts; retain failures, missing responses and recruitment gaps | T05; participant access | Pilot | 2 | Blocked |
43-
| C1-S1-T09 | PYB-004.2 | Summarize baseline outcomes and actual observation cost; identify an observed obstacle without inventing one | T06–T08 actual records | Pilot + Product Owner | 1 | Blocked |
36+
| C1-S1-T02 | PYB-001.2 | Verify eligible Android enrollment/current installation and record build/version, restrictions and available source mapping | T01; Play/device access | Release + QA | 2 | Done |
37+
| C1-S1-T03 | PYB-001.2 | Verify current TestFlight installation and record its actual build and provenance limitations | T01; TestFlight/device access | Release + QA | 2 | Done |
38+
| C1-S1-T04 | PYB-003.1 | Review harmless hardware/pilot boundaries, consent/retention rules, and manual support template | Recorded pilot setup; named pilot owner | Pilot + QA | 2 | Prepared — awaiting pilot setup |
39+
| C1-S1-T05 | PYB-004.1 | Confirm primary cohort and Tasks A/B/C, assistance/timeout rules, previous workflow and prospective follow-up | T04; recorded app/setup | Pilot | 2 | Prepared — awaiting pilot setup |
40+
| C1-S1-T06 | PYB-004.2 / PYB-011.2 | Observe the first baseline batch; record every eligible start, assistance, consent/window and any due follow-up | T05; consenting participants | Pilot | 2 | Awaiting participant sessions |
41+
| C1-S1-T07 | PYB-004.2 / PYB-011.2 | Observe the next baseline batch under the same task/build rules; record windows and collect due follow-up | T05; consenting participants | Pilot | 2 | Awaiting participant sessions |
42+
| C1-S1-T08 | PYB-004.2 / PYB-011.2 | Complete planned observation/follow-up slots toward five baseline starts; retain failures, missing responses and recruitment gaps | T05; participant access | Pilot | 2 | Awaiting participant sessions |
43+
| C1-S1-T09 | PYB-004.2 | Summarize baseline outcomes and actual observation cost; identify an observed obstacle without inventing one | T06–T08 actual records | Pilot + Product Owner | 1 | Awaiting observation records |
4444
| C1-S1-T10 | PYB-006.1 | Draft the bounded Drift recovery contract: write boundary, restore/discard, board association, failure handling and carried Blocks/A-24 scope | ADR-0010 and App contracts; no recruitment dependency | App | 3 | Done |
4545
| C1-S1-T11 | PYB-006.1 | Review acceptance scenarios and size the safe increment including required tests; record approval or unresolved design questions | T10; review path | App + reviewer | 1 | Done |
4646
| C1-S1-T12 | PYB-009.1 | Inventory existing suites, hardware/operators, applicable gates and matrix cost; draft the next operator recipe | T01 and current tools/specs | QA + firmware | 2 | Done |
4747
| **C1-S1 total** | | | | | **22** | |
4848

49+
T02/T03 verified existing Play `0.2.0 (8)` and TestFlight `0.2.0 (6)` installations, origin and launch using the ledger checklist; no fresh enrollment, reinstall or upgrade was performed. Platform reports retain provenance and minimum-OS limitations. T04/T05 have completed source QA but still need the named pilot owner, cohort and tested reference setup.
50+
4951
Five baseline starts is a target, not the implied result of reserving six hours. If access or session duration prevents it, report the actual sample and replan. A completed findings record does not mark an unperformed installation or observation task Done. Missing store source mapping remains an owned limitation under the applicable gate.
5052

5153
## C1-S2 — deliver a bounded safe recovery increment
@@ -208,10 +210,13 @@ flowchart LR
208210
S --> W["In progress"]
209211
W --> R["Review evidence and acceptance"]
210212
R --> D["Done task; assess parent separately"]
213+
R --> A["Prepared or awaiting evidence; unfinished"]
214+
A --> W
211215
W --> B["Blocked with reason and owner"]
212216
B --> W
213217
R --> W
214218
B --> U["Unfinished at Sprint end"]
219+
A --> U
215220
W --> U
216221
U --> PB["Product Backlog: reorder and replan"]
217222
PB --> S

0 commit comments

Comments
 (0)