chore: adopt the project template and add the Kotlin/Compose skeleton
Period was a bare directory holding one 2,527-line specification, with no git
repository, no tracker and no documentation convention. This is the adoption
from Projects/Template/START-HERE-New-Project.md, plus a project that compiles
so the hooks and future guards have something real to run against.
Documents. scaffold.sh created 19 paths, 0 skipped. The specification moved to
docs/planning/PRODUCT_PLAN.md unchanged in substance, with a status header; the
capitalised Docs/ is gone. Every scaffolded document was filled in for Period.
docs/OPERATIONS.md deleted — an offline app is not a deployed service.
DOC_TRUST_MAP.md written last, describing what is actually here, including what
this project deliberately does not have.
Code. Four Gradle modules. domain/cycle and domain/prediction are kotlin("jvm")
and cannot see the Android SDK, so the engine is testable without an emulator —
17 tests pass, 12 of them the acceptance cases from PRODUCT_PLAN.md §51.
BaselinePredictionEngine is a robust-median prototype and explicitly not the
product; it exists so Batch 02's replacement can be shown to be better rather
than merely different.
Versions verified against their official sources today rather than inherited
from the specification's own numbers, which that document asks for: Kotlin
2.4.10, AGP 9.3.1, Gradle 9.7.0, Compose BOM 2026.08.00, Room 2.8.4, Hilt
2.60.1. AGP 9 ships Kotlin built in, so org.jetbrains.kotlin.android is no
longer applied. compileSdk is 37 because current AndroidX requires it; targetSdk
stays 36, Play's floor from 2026-08-31, and the difference is deliberate.
Six scripts taken into scripts/; the rest declined and named in docs/TOOLS.md.
Three hooks in .githooks/, with pre-commit adapted to Gradle.
closes #1
closes #2
2026-08-18 02:16:47 -05:00
|
|
|
# Claude QA Report — Period
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
Status: Current
|
|
|
|
|
Owner: _null
|
|
|
|
|
Last reviewed: 2026-08-18
|
|
|
|
|
Governs: the QA verdict — build SHAs, round summaries, the overall judgment
|
|
|
|
|
Review trigger: Any QA round run
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
> The QA verdict. Companion to [`ClaudeQACoverage.md`](ClaudeQACoverage.md)
|
|
|
|
|
> (what each pass reached) and [`ClaudeQAPlan.md`](ClaudeQAPlan.md) (the
|
|
|
|
|
> playbook).
|
|
|
|
|
>
|
|
|
|
|
> **Defects are issues, not entries here.** A defect found in a round is filed
|
|
|
|
|
> in the tracker with a severity label, where it can be assigned, closed by a
|
|
|
|
|
> commit, and counted. This file keeps the part a tracker is bad at: a judgment
|
|
|
|
|
> about whether the thing is fit to ship.
|
|
|
|
|
|
|
|
|
|
## Current run-state
|
|
|
|
|
|
2026-08-18 03:01:33 -05:00
|
|
|
- **Last QA round:** Round 1 — 2026-08-18, partial (passes A and B; C, D and H partial)
|
|
|
|
|
- **Last verified build SHA:** `adc5075`
|
|
|
|
|
- **Last tested device / environment:** emulator `PeriodQA`, API 36, Pixel 6 profile, debug build
|
|
|
|
|
- **Overall status:** The Batch 01 foundation works end to end on a device — log
|
|
|
|
|
a period, see a forecast with an honest window and confidence, edit it and
|
|
|
|
|
watch the forecast move — and the first partial QA round found two defects
|
|
|
|
|
that 70 passing unit tests could not: tapping the app's primary button twice
|
|
|
|
|
crashed it, and two date APIs on the recalculation path would have crashed
|
|
|
|
|
every device below Android 14. Both are fixed, with regression tests. That
|
|
|
|
|
ratio is the honest summary of where this project stands: the logic is well
|
|
|
|
|
covered and the product has barely been used, so the next round matters more
|
|
|
|
|
than the last one. Nothing has been tested at the minimum Android version this
|
|
|
|
|
app claims to support.
|
chore: adopt the project template and add the Kotlin/Compose skeleton
Period was a bare directory holding one 2,527-line specification, with no git
repository, no tracker and no documentation convention. This is the adoption
from Projects/Template/START-HERE-New-Project.md, plus a project that compiles
so the hooks and future guards have something real to run against.
Documents. scaffold.sh created 19 paths, 0 skipped. The specification moved to
docs/planning/PRODUCT_PLAN.md unchanged in substance, with a status header; the
capitalised Docs/ is gone. Every scaffolded document was filled in for Period.
docs/OPERATIONS.md deleted — an offline app is not a deployed service.
DOC_TRUST_MAP.md written last, describing what is actually here, including what
this project deliberately does not have.
Code. Four Gradle modules. domain/cycle and domain/prediction are kotlin("jvm")
and cannot see the Android SDK, so the engine is testable without an emulator —
17 tests pass, 12 of them the acceptance cases from PRODUCT_PLAN.md §51.
BaselinePredictionEngine is a robust-median prototype and explicitly not the
product; it exists so Batch 02's replacement can be shown to be better rather
than merely different.
Versions verified against their official sources today rather than inherited
from the specification's own numbers, which that document asks for: Kotlin
2.4.10, AGP 9.3.1, Gradle 9.7.0, Compose BOM 2026.08.00, Room 2.8.4, Hilt
2.60.1. AGP 9 ships Kotlin built in, so org.jetbrains.kotlin.android is no
longer applied. compileSdk is 37 because current AndroidX requires it; targetSdk
stays 36, Play's floor from 2026-08-31, and the difference is deliberate.
Six scripts taken into scripts/; the rest declined and named in docs/TOOLS.md.
Three hooks in .githooks/, with pre-commit adapted to Gradle.
closes #1
closes #2
2026-08-18 02:16:47 -05:00
|
|
|
|
|
|
|
|
## Open defects
|
|
|
|
|
|
|
|
|
|
**Do not list them here, and do not read a defect count out of this file.** The
|
|
|
|
|
Command Center's docs report parses this document for open `P0` / `P1` / `P2`
|
|
|
|
|
counts, and under this convention they are always zero — the defects are in the
|
|
|
|
|
tracker, which is the whole point. The zeros here mean *this file does not hold
|
|
|
|
|
them*, never *there are none*.
|
|
|
|
|
|
|
|
|
|
Filed as issues in this repository's tracker, labelled by what they cost:
|
|
|
|
|
|
|
|
|
|
- **P0** — ships broken, or loses data
|
|
|
|
|
- **P1** — materially wrong, but shippable
|
|
|
|
|
- **P2** — cosmetic or low impact
|
|
|
|
|
- **release-blocker** — a release built today would be *wrong*, not merely
|
|
|
|
|
incomplete
|
|
|
|
|
|
|
|
|
|
Severity is what it costs, not how annoying it is to fix. Every defect needs the
|
|
|
|
|
build SHA it was found at — a finding that cannot be re-tested cannot be closed
|
|
|
|
|
— so put it in the issue body.
|
|
|
|
|
|
|
|
|
|
## Round notes
|
|
|
|
|
|
|
|
|
|
No rounds yet.
|