diff --git a/README.md b/README.md index 4eff462e..63b82c70 100644 --- a/README.md +++ b/README.md @@ -226,9 +226,10 @@ pipelines run "your pipeline name" "Describe the task" Open **:status** for the server and ntfy connection details. In the ntfy phone app, add the displayed ntfy server, sign in as **phone-reader** with the password -you set during installation, and subscribe to the displayed topic. Stages must -include a `notify` block to send notifications; see [ntfy setup](docs/ntfy.md). -Installation checks publishing, not reception on your phone. +you set during installation, and subscribe to the displayed topic. A run that +waits for a decision or fails notifies automatically; to notify on a stage's own +result, add a `notify` block. See [ntfy setup](docs/ntfy.md). Installation checks +publishing, not reception on your phone. For Tailscale, both devices must be connected; use `http://:8090`. Binding to `0.0.0.0` does not bypass firewalls: diff --git a/android/README.md b/android/README.md index 3fa8b3e1..d288fcc8 100644 --- a/android/README.md +++ b/android/README.md @@ -5944,3 +5944,69 @@ surface" named in the brief is not present in this tree, so the decision is reachable from the run detail and its stage and the shared component is ready for it. No packaged skill reference was touched: the decide protocol is unchanged and already documented, and this is an app-UI change. + +## Run attention surface and phone notifications (17 Oct 2026) + +> Supersedes the note at the end of the previous section: the run-attention +> surface the brief named is now present in this tree. The server publishes the +> notification; the app shows the same information in one live surface. + +A run that needs a person — waiting for a human decision, or failed — now reaches +the operator through the ntfy they already run, and the app answers "what needs me +now" in one ordered list. The server change is the smallest that reuses the +existing delivery machinery; there is no second publisher, topic or service. + +- **One run-level notification, reusing the stage's publisher.** `internal/server/ + notify.go` adds `notifyRun`, called from `finishRunState` (failed) and when a run + parks on a human (`runner.go` `runLoop`). It publishes to the same `system` + destination through the unchanged `stage.PublishNtfy`, with the operator's + configured token handling, so nothing is duplicated. `runAttentionEvent` maps + only `waiting` and `failed`; queued/running/succeeded/canceled/interrupted + produce `""` and publish nothing. +- **No storms.** `runner.attentionSent` (guarded by `attentionMu`) records + `sequence:event` per run before publishing, so a run that stays waiting is never + republished on a re-request or restart, and a stage `notify` policy that already + covers the same event (`on=waiting`, or a failure hook) marks it first so the + run-level default is suppressed. The set is dropped when the run is terminal + (`forgetAttention`). A delivery failure is logged, never fails the run, and is + not retried. +- **The payload opens the run.** It names the run id and pipeline, and carries a + `click` action `pipelines://run/` (validated in `validNtfyClick` — absolute + URL, no userinfo, no fragment, no credentials). `AndroidManifest.xml` declares + the `pipelines`/`run` deep link on `MainActivity` (`launchMode=singleTop`); + `runIdFromDeepLink` parses it and `PipelinesApp` opens that run once, clearing + the link so a rotation re-opens nothing. It opens a run; it starts nothing. +- **One attention surface.** `ui/Attention.kt` is the pure model: a run status maps + to `Decision`/`Failed`/`Finished` (or nothing), and `attentionEntries` orders by + kind then newest-first. `ui/components/AttentionSurface.kt` renders a floating + indicator in the same bottom container as the destination pill — visible from + every destination and window width — that opens a bottom sheet listing the run, + its pipeline and what it needs, with a per-row dismiss. The indicator draws + nothing when the list is empty. No competing navigation surface is added. +- **Live and self-clearing.** The list is derived from the same `RuntimeState` + pushes the runs list folds, so an entry appears with no refresh and clears when + the run is resolved (the decision answered, the failure retried). A finished run + clears once the list is opened; any entry can be deliberately dismissed; + dismissals and looked-at finishes persist in `SettingsRepository` as one + serializable preference. Opening a non-decision entry deals with it. + +Tests: `internal/server/notify_test.go` covers the event mapping (waiting, failed, +nothing else) and the real HTTP delivery (destination, topic, click, no +duplicate); `AttentionTest` (13 cases) covers the app's mapping, ordering, +appearing from a pushed event, clearing on resolution, dismissal, the empty case, +persistence and the deep-link parser. + +Evidence (this pass, macOS, JDK 17 `/opt/homebrew/opt/openjdk@17`, cached Gradle +8.11.1, `ANDROID_HOME=$HOME/Library/Android/sdk`): + +- `go build ./...` → success; `go test ./internal/server/... ./internal/stage/... + ./internal/author/...` → `ok` for all three packages. +- `gradle :app:testDebugUnitTest --offline --no-daemon --console=plain` → + `BUILD SUCCESSFUL`; the JUnit XMLs total **58 suites / 531 tests / 0 failures / + 0 errors / 0 skipped** (up from 57 suites / 518 tests: the new `AttentionTest`). + +Not verified in this pass: the on-device indicator/list/finished/empty screenshots +and the phone's own notification — the brief keeps ordinary code review to the +build and the unit tests, and visual review owns the operator's Pixel 9 Pro XL. +The concrete payload delivered to the local ntfy service was reproduced by the +code review with a live curl subscriber; the device captures are visual review's. diff --git a/android/app/src/main/AndroidManifest.xml b/android/app/src/main/AndroidManifest.xml index e748c0f6..57e587d9 100644 --- a/android/app/src/main/AndroidManifest.xml +++ b/android/app/src/main/AndroidManifest.xml @@ -30,12 +30,26 @@ android:name=".MainActivity" android:exported="true" android:label="@string/app_name" + android:launchMode="singleTop" android:theme="@style/Theme.Pipelines" android:windowSoftInputMode="adjustResize"> + + + + + + +