Skip to content

Commit cf3b262

Browse files
committed
[docs] record C1-S1 execution and reconcile delivery forecasts
Record live channel evidence and explicit device/pilot blockers, prepare the residual TestFlight metadata correction, and update strategy, Scrum views, architecture, roadmap and discovery links. Preserve four completed repository tasks and eight blocked tasks. Carry forward the reviewed recovery contract and its larger estimate without claiming runtime persistence, installations, participant results or release admission. Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>
1 parent 0b82861 commit cf3b262

18 files changed

Lines changed: 430 additions & 76 deletions

‎CHANGELOG.md‎

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,9 @@ are released independently from this monorepo.
66
## Unreleased
77

88
These app, website, and repository-source changes do not designate a new app
9-
or firmware release. The qualified firmware release remains v0.6.0, built from
10-
its annotated tag rather than from the newer branch tip.
9+
or firmware release. Firmware v0.6.1 is published on the owner's confirmation;
10+
incomplete automated evidence remains pending. The qualified v0.6.0 release
11+
remains a separate historical baseline built from its annotated tag.
1112

1213
The current compatible app feature set now targets `0.2.0`; build `5` was
1314
handed off through Transporter for TestFlight. This candidate identity improves
@@ -81,6 +82,17 @@ and submission packet do not claim Play submission, approval, or rollout.
8182
Vitest 4.1.12, with patched Sharp, Undici, source-map-js and supporting
8283
dependencies. Refreshed the reviewed license notices and dependency
8384
regression assertions while retaining the high/critical audit gate.
85+
- Added the reviewed Cycle 1 roadmap, milestones, Scrum working agreement,
86+
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.
89+
- Specified bounded Drift current-text recovery, local restore/discard,
90+
failure handling and document/session guards in ADR-0048 and the App
91+
contracts. Implementation remains pending; sizing requires revising the
92+
original S2 forecast.
93+
- 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.
8496
- Prepared Google Play open-testing listing text, reviewer hardware setup,
8597
tester instructions, data-use assessment, and reproducible store artwork
8698
with authentic screenshot provenance. Store availability remains a separate

‎README.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -311,6 +311,8 @@ publish new firmware or replace the live site.
311311
- [App contract](docs/specifications/app.md)
312312
- [Hardware and compatibility](docs/specifications/hardware.md)
313313
- [Public roadmap](docs/ROADMAP.md)
314+
- [Cycle 1 delivery plan](docs/developments/2026-q4-reliable-workflow/01_Overview_and_Scrum_Framework.md)
315+
- [C1-S1 execution and remaining evidence](docs/developments/2026-q4-reliable-workflow/c1-s1/00_Execution_Record.md)
314316
- [Architecture decisions](docs/decisions/README.md)
315317
- [Validation evidence index](docs/validation/README.md)
316318
- [Security policy](SECURITY.md)

‎docs/README.md‎

Lines changed: 19 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -16,13 +16,22 @@ maintainer guidance beside the source they govern.
1616
## Proposed release plans
1717

1818
- [Firmware v0.6.1 and v0.7.0 roadmap](planning/firmware-v0.6.1-v0.7.0-roadmap.md)
19-
— v0.6.1 hardening is approved for implementation; the Reliable Projects
20-
v0.7.0 scope remains proposed
19+
— v0.6.1 is published on owner confirmation; incomplete automated evidence
20+
remains pending, and Reliable Projects v0.7.0 remains proposed
21+
- [Implementation strategy](planning/PyBLE_Implementation_Plan_and_Strategy_v1.0.md)
22+
— current outcomes, evidence gates and conditional expansion
23+
- [Cycle 1 Scrum delivery package](developments/2026-q4-reliable-workflow/01_Overview_and_Scrum_Framework.md)
24+
— roadmap, milestones, stories and capacity forecasts
25+
- [C1-S1 execution record](developments/2026-q4-reliable-workflow/c1-s1/00_Execution_Record.md)
26+
— channel evidence, pilot kit, recovery contract/sizing and validation recipe;
27+
physical installation and participant work remain blocked
2128

2229
## Detailed specifications
2330

2431
- [`specifications/App/`](specifications/App/) — app requirements, test design,
2532
and the Signal visual system
33+
- [Bounded current-text recovery contract](specifications/App/current-draft-recovery.md)
34+
— specified in C1-S1; implementation and acceptance evidence remain pending
2635
- [`specifications/firmware/`](specifications/firmware/) — firmware
2736
requirements, test design, browser flashing, release integrity, and HIL
2837
gates
@@ -64,7 +73,11 @@ bundled offline examples required by its own product contracts.
6473
plan](testing/testflight/0.2.0-build-5.md)
6574
- [PyBLE 0.1.0 (4) TestFlight description and test
6675
plan](testing/testflight/0.1.0-build-4.md)
67-
68-
Internal sprint notes and automated-agent orchestration are intentionally kept
69-
outside the public source repository. Public work is planned through the
70-
roadmap and GitHub issues.
76+
- [Current channel and artifact ledger](developments/2026-q4-reliable-workflow/c1-s1/01_Channel_and_Artifact_Ledger.md)
77+
- [TestFlight metadata correction packet](developments/2026-q4-reliable-workflow/c1-s1/05_TestFlight_Metadata_Correction.md)
78+
— prepared replacement for the stale public description; store update pending
79+
80+
Reviewed delivery plans and redacted execution evidence live under
81+
`developments/`. Raw observations, contact/consent records, device identifiers,
82+
local worktree state and automated-agent orchestration remain outside Git.
83+
Planning IDs are not GitHub issue numbers; link actual issues when created.

‎docs/ROADMAP.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,16 @@ v0.7.0 remains non-normative and requires separate maintainer approval.
3131

3232
## Near term
3333

34+
- 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.
38+
- Implement the [bounded current-text recovery contract](specifications/App/current-draft-recovery.md)
39+
after replanning against its 45–72 hour working estimate for engineering,
40+
recipe, representative platform checks and follow-up. Current drafts remain
41+
volatile; full A-24 and Blocks persistence remain separate scope.
42+
- Correct the [stale public TestFlight description](developments/2026-q4-reliable-workflow/c1-s1/05_TestFlight_Metadata_Correction.md)
43+
through the distribution owner; replacement copy is prepared, not published.
3444
- Continue the app 0.2.0 beta train; source is currently `0.2.0+8`. The
3545
[Android publication review](testing/website/android-open-testing-2026-09-25.md)
3646
records live open-testing availability. The

‎docs/decisions/0011-connection-gated-shell.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,3 +28,13 @@ The Signal landscape shell renders a fixed three-pane IDE frame — **Files side
2828
- The change is confined to the shell + providers; the `Connection` seam (D1/D2), the import boundary (no UI package imports `lib/ble`, CON-8), Riverpod (ADR-0007), and every §1A.3 rejection are unchanged.
2929

3030
Unchanged rejection list, seam, and layering as in [ADR-0009](0009-runtime-connection-manager.md)/[ADR-0010](0010-working-loop-in-memory-document.md).
31+
32+
## Follow-up — 25 September 2026
33+
34+
[ADR-0048](0048-bounded-current-text-draft-recovery.md) and the
35+
[bounded recovery contract](../specifications/App/current-draft-recovery.md)
36+
specify a narrow successor exception: a local recovery preview/Restore/Discard
37+
panel must be reachable without a board, permission prompt or network access.
38+
The normal IDE remains connection-gated; this is not a full offline IDE or an
39+
authorization to restore board-write authority. Implementation is pending, so
40+
the current shell behavior above remains the recorded runtime baseline.

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

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,14 +9,14 @@
99
|---|---|
1010
| Package | PyBLE 2026 Q4 reliable workflow, Cycle 1 (`C1`) |
1111
| Prepared | 25 September 2026; Asia/Bangkok |
12-
| Strategy | [Implementation Plan, revision 1.2](../../planning/PyBLE_Implementation_Plan_and_Strategy_v1.0.md) |
12+
| Strategy | [Implementation Plan, revision 1.3](../../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 | Proposed delivery package; no Sprint Planning, estimates, named assignments, implementation approval, or new physical results are implied |
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 |
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

19-
This package derives execution views from the strategy. It does not replace normative specifications, expand hardware claims, create GitHub issues, or authorize store/website publication. The strategy file is currently a local document; include it with this package when proposing the documentation for version control.
19+
This package derives execution views from the strategy. It does not replace normative specifications, expand hardware claims, create GitHub issues, or authorize store/website publication. The strategy and original package were recorded together in planning baseline `d039db0`. The [C1-S1 execution record](c1-s1/00_Execution_Record.md) owns actual results and blockers.
2020

2121
## Navigation and ownership of information
2222

@@ -27,11 +27,12 @@ This package derives execution views from the strategy. It does not replace norm
2727
| [03 — Milestones](03_Milestones.md) | Evidence-based decisions and admission criteria | New evidence or a milestone decision |
2828
| [04 — Sprint plan](04_Sprint_Plan.md) | Sprint Goal forecasts, calendar, and capacity | Sprint Planning or Sprint Review |
2929
| [05 — Product backlog and stories](05_Product_Backlog_and_Stories.md) | Ordered work, parent/child identities, acceptance criteria, and source traceability | Refinement or changed user evidence |
30-
| [06 — Sprint backlogs](06_Sprint_Backlogs.md) | Candidate tasks, local effort allowances, dependencies, and execution status | Developers select/adapt work during a Sprint |
30+
| [06 — Sprint backlogs](06_Sprint_Backlogs.md) | Task allowances, dependencies, C1-S1 execution status and later forecasts requiring replanning | Developers select/adapt work during a Sprint |
31+
| [C1-S1 — Execution and evidence](c1-s1/00_Execution_Record.md) | Actual channel checks, pilot kit, recovery design/sizing and validation inventory | New evidence, source review or a resolved blocker |
3132

3233
```mermaid
3334
flowchart LR
34-
Strategy["Strategy revision 1.2"] --> Goal["One Product Goal"]
35+
Strategy["Strategy revision 1.3"] --> Goal["One Product Goal"]
3536
Goal --> Roadmap["Outcome roadmap and milestones"]
3637
Roadmap --> Product["Ordered Product Backlog"]
3738
Product --> Planning["Sprint Planning"]
@@ -122,10 +123,10 @@ Unfinished items return to the Product Backlog for reordering and replanning. Do
122123
| Convention | Rule |
123124
|---|---|
124125
| `PYB-001` … `PYB-032` | Existing strategy planning parents; not GitHub issue numbers |
125-
| `PYB-006.1`, `PYB-006.2`, etc. | Derived child items in this package; acceptance is maintained in file 05 |
126+
| `PYB-006.1`, `PYB-006.2`, etc. | Derived child items in this package; acceptance is maintained in file 05; new residual `PYB-002.1` records the TestFlight metadata discrepancy |
126127
| `A-24` | Existing broader persistence story; a bounded child does not complete all of it |
127128
| `C1-S1` … `C1-S6` | This cycle's Sprints; distinct from historical App TDD Sprint labels |
128-
| `C1-S1-T01`, etc. | Proposed task rows; not new public contracts |
129+
| `C1-S1-T01`, etc. | Task identities with recorded early C1-S1 outcomes; later task rows remain forecasts, not new public contracts |
129130
| `M-01`, etc.; `SG0` … `SG6` | Delivery milestones versus strategy gates; neither replaces CI G0/G1 or C3 firmware gates |
130131
| Item/task status | Proposed → Selected at Planning → In progress → Review → Done; Blocked records a reason/owner; later forecasts remain Proposed |
131132
| Private versus public records | Contact/consent, device identifiers and raw logs remain private/ignored; publish only reviewed aggregate findings and redacted evidence |
@@ -136,7 +137,7 @@ When facts or priority change, update the canonical file above and its dependent
136137

137138
| Source | Use and precedence |
138139
|---|---|
139-
| [Strategy revision 1.2](../../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.3](../../planning/PyBLE_Implementation_Plan_and_Strategy_v1.0.md) | Scope, targets, six-Sprint capacity, three outcomes, Ready program and conditional horizons |
140141
| [Public roadmap](../../ROADMAP.md), [README](../../../README.md) | Current capability and distribution baseline |
141142
| [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 |
142143
| [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 |

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

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

66
| Control | Value |
77
|---|---|
8-
| Status | Proposed; product direction and forecasts, not approved feature or release commitments |
8+
| Status | C1-S1 repository work recorded; physical/pilot tasks blocked. 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.2](../../planning/PyBLE_Implementation_Plan_and_Strategy_v1.0.md), particularly §§1, 6–9, 12, 14, and 19 |
10+
| Source | [Implementation strategy revision 1.3](../../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 |
@@ -33,11 +33,11 @@ continues to communicate direction without promising release dates.
3333
## Completed baseline and remaining uncertainty
3434

3535
These records are inputs to planning, not new achievements of this development
36-
cycle. Future work below remains **Proposed** until explicitly selected.
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.
3737

3838
| Baseline item | Recorded state at the planning date | Consequence for this roadmap |
3939
|---|---|---|
40-
| Android distribution and public copy | Google Play 0.2.0 open testing; README/site correction completed in PR #33 | Preserve accurate copy; PYB-002 covers only newly found discrepancies |
40+
| 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 |
4141
| 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 |
4242
| iPad distribution | External TestFlight beta is the recorded channel | Verify the selected installation path and artifact evidence; do not infer production App Store availability |
4343
| 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 |
@@ -78,9 +78,11 @@ for one maintainer. All rows in this table have status **Proposed**.
7878
| C1-S5; 23 Nov–6 Dec | Freeze candidate, complete applicable evidence, and assess mature follow-ups | M-04 / SG1; M-06 inputs | Release only when relevant evidence passes; qualified maintenance may also ship earlier |
7979
| C1-S6; 7–20 Dec | Verify actual channel/install state and choose one subsequent investment | M-05; M-06 / SG3 | Record pass, iterate, blocked, or inconclusive outcomes; make a dated next-stage decision |
8080

81+
**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).
82+
8183
The [Sprint Plan](04_Sprint_Plan.md) owns detailed dates and capacity. The first
82-
Sprint Backlog is a candidate for Sprint Planning; later allocations are
83-
forecasts. A milestone review neither replaces a Sprint Review nor supplies
84+
Sprint Backlog now records early C1-S1 execution and its remaining blockers;
85+
later allocations are forecasts requiring replanning. A milestone review neither replaces a Sprint Review nor supplies
8486
missing Definition of Done evidence.
8587

8688
```mermaid

0 commit comments

Comments
 (0)