diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 0ca7c0b..214ba14 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -66,7 +66,12 @@ or your feature's manual verification steps. We use [Conventional Commits](https://www.conventionalcommits.org/). Per-version user-facing notes live in `PREVIOUS_HISTORY.md` (Development Plan §11.1) — the release CI attaches the matching section -to each Gitea release automatically: +to each Gitea release automatically. Write each note (paragraph or bullet) +as **one complete line — do not hard-wrap it**: the CI copies the section +verbatim, so manual line breaks ship as premature returns, and the release +UI reflows the text for you. + +Commit types: | Type | Use for | |------|---------| diff --git a/Incido Development Plan.txt b/Incido Development Plan.txt index df02813..f4e54f7 100644 --- a/Incido Development Plan.txt +++ b/Incido Development Plan.txt @@ -435,7 +435,11 @@ A small Gradle task called `copyReleaseApks` (registered in line. **`PREVIOUS_HISTORY.md`** — append a new `## v — ` section at the top: friendly user-facing bullets, newest first (this file replaced the old README Changelog - table). On tag push the release workflow runs + table). **Write each note (paragraph or bullet) as one complete line — + do not hard-wrap it:** the CI copies the section verbatim into the release + description and the `Incido--changes.md` asset, so a manual line + break ships as a premature return; the release UI reflows the text for you. + On tag push the release workflow runs `scripts/ci/release-notes.py` and attaches that section to the Gitea release as its description **and** as an `Incido--changes.md` asset beside the APKs — so keep one section per released version and diff --git a/PREVIOUS_HISTORY.md b/PREVIOUS_HISTORY.md index 253ef6d..0cd8624 100644 --- a/PREVIOUS_HISTORY.md +++ b/PREVIOUS_HISTORY.md @@ -1,61 +1,30 @@ # Incido — Previous Release History -Reference archive of Incido's user-facing release history (formerly the -README changelog table). +Reference archive of Incido's user-facing release history (formerly the README changelog table). -Current downloads ship **with their own notes**: every release on the -[Releases page](https://git.trevena.info/nick/incido/releases) carries its -version's changelog — rendered in the release description and also -attached beside the APKs as `Incido--changes.md`. The CI generates -both from the matching section below via `scripts/ci/release-notes.py` -at tag-build time. +Current downloads ship **with their own notes**: every release on the [Releases page](https://git.trevena.info/nick/incido/releases) carries its version's changelog — rendered in the release description and also attached beside the APKs as `Incido--changes.md`. The CI generates both from the matching section below via `scripts/ci/release-notes.py` at tag-build time. -**Adding a release:** append a `## v — ` section at the -top of this file (see Development Plan §11.1). Newest first; never delete -or reorder older sections — the CI must find a section for whatever tag it -builds, and hotfix retags can target any version. If a tag has no section, -the release falls back to a plain "Release " description. +**Adding a release:** append a `## v — ` section at the top of this file (see Development Plan §11.1). Newest first; never delete or reorder older sections — the CI must find a section for whatever tag it builds, and hotfix retags can target any version. If a tag has no section, the release falls back to a plain "Release " description. --- ## v0.4.0.0 — 2026-09-18 -New in this release: **Import 3rd Party Notes**. Settings → Backup & Restore -now has an "Import 3rd Party Notes" button that ingests a Carnet / QuickNote -`.zip` export — a single archive bundling one `.sqd` per note — straight -on-device, with no pre-conversion step. Rich-text bodies are flattened to plain -text; note colours, keywords (imported as tags) and links carry over; to-do -lists become native checklists; and image attachments are imported -(auto-generated preview thumbnails are skipped). Import is additive — existing -notes are preserved and imported notes get fresh IDs. +New in this release: **Import 3rd Party Notes**. Settings → Backup & Restore now has an "Import 3rd Party Notes" button that ingests a Carnet / QuickNote `.zip` export — a single archive bundling one `.sqd` per note — straight on-device, with no pre-conversion step. Rich-text bodies are flattened to plain text; note colours, keywords (imported as tags) and links carry over; to-do lists become native checklists; and image attachments are imported (auto-generated preview thumbnails are skipped). Import is additive — existing notes are preserved and imported notes get fresh IDs. --- ## v0.3.8.1 — 2026-09-17 -> **⚠️ Reinstall required — please export a backup first.** This build is signed -> with a **new CI signing key** (the previous key lived in the old build runner's -> cache and was not carried over), so Android will refuse to install it over an -> existing Incido — it reports a signature conflict. Incido deliberately doesn't -> participate in Android's automatic backup/restore, so **uninstalling deletes -> your notes**. To update safely: **Settings → Backup → Export** (and -> **Settings → Security → Export encryption key** if you use encryption), -> then uninstall Incido, install this APK, and restore from your backup. -> If you'd rather keep using v0.3.8.0, that's fine — nothing in it is broken. +> **⚠️ Reinstall required — please export a backup first.** This build is signed with a **new CI signing key** (the previous key lived in the old build runner's cache and was not carried over), so Android will refuse to install it over an existing Incido — it reports a signature conflict. Incido deliberately doesn't participate in Android's automatic backup/restore, so **uninstalling deletes your notes**. To update safely: **Settings → Backup → Export** (and **Settings → Security → Export encryption key** if you use encryption), then uninstall Incido, install this APK, and restore from your backup. If you'd rather keep using v0.3.8.0, that's fine — nothing in it is broken. -- **No app changes.** v0.3.8.1 is a re-release of v0.3.8.0: same task lists, - shopping lists with the running total, and add-tag suggestions fix. Only the - build number and the release pipeline changed. -- **Why the rebuild.** The release pipeline had been failing to publish builds - reliably. Release uploads now go to the Gitea API over the local network - instead of the proxied public address, which is where the upload timeouts were - coming from — so this is the first build in a while to ship with its APKs and - notes attached the way §11.1 intends. +- **No app changes.** v0.3.8.1 is a re-release of v0.3.8.0: same task lists, shopping lists with the running total, and add-tag suggestions fix. Only the build number and the release pipeline changed. +- **Why the rebuild.** The release pipeline had been failing to publish builds reliably. Release uploads now go to the Gitea API over the local network instead of the proxied public address, which is where the upload timeouts were coming from — so this is the first build in a while to ship with its APKs and notes attached the way §11.1 intends. ## v0.3.8.0 — 2026-09-16 - **Task lists + shopping lists (Development Plan §6.1).** New checklist button in the editor's bottom action row (next to the `#` tag button) converts any note into an editable task list — real checkboxes, add / remove item rows; tap the button again to return to plain text (`NoteType`, additive `typeKey` column, auto-migrated). New shopping-basket button works the same way but gives every row a tap-to-pick **quantity (1–9) dropdown** and a supermarket-style price field where the number pad types cents — enter `199` and it counts as **$1.99** in the maths (the price box keeps exactly the digits you typed, so cursor placement can never scramble them, while the total bar speaks real dollars). An always-visible running total sits above the list, adding quantity × price for everything checked (= in the basket). The three values are strictly separate fields saved with an explicit end-of-line marker (`- [x] Eggs {q12 p2.40}`), so numbers inside a product name (like "Battery AA 3") can never leak into the money maths; hand-typed classic lines (`Milk 3.50`, `Eggs 12 x 2.40`) are still recognised when converting older notes. Lists persist as GitHub-flavoured `- [ ]` lines, so search, encryption, backups (new defaulted `noteType` field — old files still import), and card "N open · M done" summaries keep working; shopping cards show a basket icon. -- **Add-tag sheet suggestions fixed** — the nested-collect autocomplete pipeline never resumed past the first keystroke, so only "+ Create…" ever showed; rebuilt on `flatMapLatest`, existing tags now list immediately when the sheet opens and filter live per keystroke. +- **Add-tag sheet suggestions fixed.** The nested-collect autocomplete pipeline never resumed past the first keystroke, so only "+ Create…" ever showed; rebuilt on `flatMapLatest`, existing tags now list immediately when the sheet opens and filter live per keystroke. ## v0.3.7.1 — 2026-08-30 @@ -71,7 +40,7 @@ notes are preserved and imported notes get fresh IDs. ## v0.3.6.2 — 2026-08-19 -- **CI / release-pipeline tag.** — re-tag of v0.3.6.1 used to exercise the Gitea Actions release workflow (keystore minted on the release runner; debug + release APKs attached to the Gitea release). No app changes. +- **CI / release-pipeline tag.** Re-tag of v0.3.6.1 used to exercise the Gitea Actions release workflow (keystore minted on the release runner; debug + release APKs attached to the Gitea release). No app changes. ## v0.3.6.1 — 2026-08-19 @@ -87,7 +56,7 @@ notes are preserved and imported notes get fresh IDs. ## v0.3.5.1 — 2026-08-17 - **"Encrypted" badge now appears the moment you flip the switch.** A race in `EncryptionVerifier.checkNow()` could silently drop the post-migration verification, leaving cards without the badge until a second toggle; replaced with a serializing Mutex so every check runs in invocation order. -- **"Encrypted" indicator is now a single lock icon next to the date** — consistent position on every card instead of a centred "lock + label" group at the bottom. +- **"Encrypted" indicator is now a single lock icon next to the date.** Consistent position on every card instead of a centred "lock + label" group at the bottom. ## v0.3.5.0 — 2026-08-17 @@ -97,9 +66,9 @@ notes are preserved and imported notes get fresh IDs. ## v0.3.4.0 — 2026-08-17 -- **Attachment indicator on note cards.** — a paperclip icon now appears on the right edge of every card that carries an attachment. -- **Light-theme readability over image thumbnails.** — cards with a dark photo background now force light text/icon colours over the image so notes stay readable in Light mode. -- **Auto-Lock "Immediately" no longer locks during file pickers.** — attaching a file, taking a photo, viewing an attachment, or exporting/importing a backup no longer destroys your in-progress note. +- **Attachment indicator on note cards.** A paperclip icon now appears on the right edge of every card that carries an attachment. +- **Light-theme readability over image thumbnails.** Cards with a dark photo background now force light text/icon colours over the image so notes stay readable in Light mode. +- **Auto-Lock "Immediately" no longer locks during file pickers.** Attaching a file, taking a photo, viewing an attachment, or exporting/importing a backup no longer destroys your in-progress note. ## v0.3.3.8 — 2026-08-17 @@ -148,13 +117,13 @@ notes are preserved and imported notes get fresh IDs. - **At-rest encryption.** ObjectBox store is opened with a 32-byte AES-256 key wrapped by the Android Keystore; toggling the switch generates / deletes the key and surfaces a "Re-encrypting notes…" dialog. - **PIN lock + biometric.** 4–6 digit PIN (PBKDF2-hashed, 100k iters, constant-time compare) with optional fingerprint / face unlock; cold launch + auto-lock timeout gate. - **Backup / Import / Export.** JSON codec with Base64 attachment bytes; encrypted variant uses AES-256-GCM + PBKDF2(passphrase, 200k iters) with a Generate button + Copy to clipboard. Passphrase policy: 12–32 chars, ≥1 digit, ≥1 special. -- **Release notes dialog.** — tap the version number on the About card. Adds `USE_BIOMETRIC` + `USE_FINGERPRINT` permissions (still no INTERNET). +- **Release notes dialog.** Tap the version number on the About card. Adds `USE_BIOMETRIC` + `USE_FINGERPRINT` permissions (still no INTERNET). ## v0.3.1.2 — 2026-08-15 -- **Three v0.3.1.1 issues fixed.** **card thumbnails are actually visible now** — the v0.3.1.1 layout had the thumbnail Image as a sibling of the Card, so the Card's opaque `containerColor` was drawn on top and the image was completely hidden; the architecture is restructured so the Image + dark scrim live INSIDE the Card, and `containerColor = Color.Transparent` when a thumbnail is present (plain notes still get the existing tinted/surface background). -- **Camera photos honour EXIF orientation** — `NoteRepositoryImpl.normalizeImageOrientation(bytes)` runs at storage time inside `addAttachment` (guarded `if (mimeType.startsWith("image/"))`); reads EXIF `Orientation`, rotates the bitmap, re-encodes as JPEG quality 92, and stores the corrected bytes so every render path (editor thumbnail, card thumbnail, full-screen viewer) sees the photo the right way up. -- **Non-image attachments open in the system viewer** — `AttachmentThumbnail.onClick` now branches on `isImage`: image taps still go to the in-app full-screen viewer; non-image taps write the bytes to a `cacheDir` temp file, get a `FileProvider` URI, and launch `Intent.ACTION_VIEW` with `FLAG_GRANT_READ_URI_PERMISSION` (the previous unconditional viewer path silently failed for PDFs/MP3s/etc. with a stuck "Loading…"). `file_paths.xml` already exposes `cacheDir` via ``, so no manifest change was needed. Attaching arbitrary file types from the paperclip icon was already shipped in v0.3.1.1 (the `*/*` intent filters) — no code change here, just called out so it's clear what was already in place. +- **Three v0.3.1.1 issues fixed.** **card thumbnails are actually visible now.** The v0.3.1.1 layout had the thumbnail Image as a sibling of the Card, so the Card's opaque `containerColor` was drawn on top and the image was completely hidden; the architecture is restructured so the Image + dark scrim live INSIDE the Card, and `containerColor = Color.Transparent` when a thumbnail is present (plain notes still get the existing tinted/surface background). +- **Camera photos honour EXIF orientation.** `NoteRepositoryImpl.normalizeImageOrientation(bytes)` runs at storage time inside `addAttachment` (guarded `if (mimeType.startsWith("image/"))`); reads EXIF `Orientation`, rotates the bitmap, re-encodes as JPEG quality 92, and stores the corrected bytes so every render path (editor thumbnail, card thumbnail, full-screen viewer) sees the photo the right way up. +- **Non-image attachments open in the system viewer.** `AttachmentThumbnail.onClick` now branches on `isImage`: image taps still go to the in-app full-screen viewer; non-image taps write the bytes to a `cacheDir` temp file, get a `FileProvider` URI, and launch `Intent.ACTION_VIEW` with `FLAG_GRANT_READ_URI_PERMISSION` (the previous unconditional viewer path silently failed for PDFs/MP3s/etc. with a stuck "Loading…"). `file_paths.xml` already exposes `cacheDir` via ``, so no manifest change was needed. Attaching arbitrary file types from the paperclip icon was already shipped in v0.3.1.1 (the `*/*` intent filters) — no code change here, just called out so it's clear what was already in place. ## v0.3.1.1 — 2026-08-15 @@ -162,10 +131,10 @@ notes are preserved and imported notes get fresh IDs. ## v0.3.1.0 — 2026-08-15 -- **Context-aware search.** — on the Favorites and Untagged pages, the search icon is now visible and a typed query intersects with the active filter (search only favourites on Favorites, only untagged notes on Untagged). On Home, search spans everything. -- **Photo / File attachments.** — the editor now has Camera (camera icon) and Attach File (paperclip icon) buttons. Photos are captured via `MediaStore.ACTION_IMAGE_CAPTURE` (with a transient `FileProvider` outbox; bytes live in the database, the temp file is deleted) and files via `ACTION_OPEN_DOCUMENT`. Attachments are stored as `ByteArray` columns inside ObjectBox — no filesystem paths to manage. Each note's attachments show up as a thumbnail strip in the editor with a ✕ in the top-right corner to remove. Tapping a thumbnail opens a full-screen viewer with pinch-to-zoom + pan (`Modifier.transformable`) and a close button. -- **Card thumbnails.** — notes with image attachments show the first image as a (alpha-blended, scrimmed) background on the list card. -- **Share-into.** — the app accepts `ACTION_SEND` (text + image) and `ACTION_SEND_MULTIPLE` (multiple images) from other apps. Inbound bytes are copied into a process-singleton `SharedIntentBuffer` and pre-filled into a new-note editor. Adds the `CAMERA` permission — still no `INTERNET`, still fully offline. +- **Context-aware search.** On the Favorites and Untagged pages, the search icon is now visible and a typed query intersects with the active filter (search only favourites on Favorites, only untagged notes on Untagged). On Home, search spans everything. +- **Photo / File attachments.** The editor now has Camera (camera icon) and Attach File (paperclip icon) buttons. Photos are captured via `MediaStore.ACTION_IMAGE_CAPTURE` (with a transient `FileProvider` outbox; bytes live in the database, the temp file is deleted) and files via `ACTION_OPEN_DOCUMENT`. Attachments are stored as `ByteArray` columns inside ObjectBox — no filesystem paths to manage. Each note's attachments show up as a thumbnail strip in the editor with a ✕ in the top-right corner to remove. Tapping a thumbnail opens a full-screen viewer with pinch-to-zoom + pan (`Modifier.transformable`) and a close button. +- **Card thumbnails.** Notes with image attachments show the first image as a (alpha-blended, scrimmed) background on the list card. +- **Share-into.** The app accepts `ACTION_SEND` (text + image) and `ACTION_SEND_MULTIPLE` (multiple images) from other apps. Inbound bytes are copied into a process-singleton `SharedIntentBuffer` and pre-filled into a new-note editor. Adds the `CAMERA` permission — still no `INTERNET`, still fully offline. ## v0.3.0.5 — 2026-08-15