Add STATUS.md checkpoint: verified state, architecture decisions, open items
Folds in the Sep 14-15 cycle (Android removal, batch transcribe, library bulk ops, Debian path) with live test counts and the five open candidates.
This commit is contained in:
parent
6599935e28
commit
2a1d5d5ab2
1 changed files with 51 additions and 0 deletions
51
STATUS.md
Normal file
51
STATUS.md
Normal file
|
|
@ -0,0 +1,51 @@
|
||||||
|
# SHONAR Desktop — Status
|
||||||
|
|
||||||
|
Checkpoint for the standalone desktop app. Prepend a new dated section per
|
||||||
|
material change; keep history below.
|
||||||
|
|
||||||
|
## 2026-09-15 — standalone desktop, Android fully removed
|
||||||
|
|
||||||
|
**Verified state (live this session):**
|
||||||
|
- HEAD `6599935`, clean tree, single branch `master`, no stashes
|
||||||
|
- Backend tests: `78 passed, 1 skipped` (pytest, SQLite) · `ruff check` clean
|
||||||
|
- Frontend tests: `39 passed` across 7 gradle suites
|
||||||
|
- Engine runs locally on `127.0.0.1:8000` (healthz ok); runtime state in
|
||||||
|
`~/.config/shonar-desktop/` (`engine.db`, `settings.json`)
|
||||||
|
|
||||||
|
**What the app is:** Compose Desktop (Kotlin) UI + bundled FastAPI engine
|
||||||
|
(SQLite + in-process queue, self-migrating on boot). No Postgres/Redis/Docker,
|
||||||
|
no server, no phone component. faster-whisper (Base vendored under
|
||||||
|
`models/hf-cache/`, Large v3 downloadable) + an LLM for summaries
|
||||||
|
(`openai_compat` or `ollama`).
|
||||||
|
|
||||||
|
**Architecture decisions worth keeping:**
|
||||||
|
- All Android/phone code deleted (`71b5571`) — desktop is the product. The
|
||||||
|
old server-era source lives on the main repo's `deferred/desktop-server`
|
||||||
|
branch for reference only.
|
||||||
|
- Shared code sits at `shared/com/shonar` (no `src/`), pulled in via
|
||||||
|
`srcDir("../shared")` in `app/build.gradle.kts`.
|
||||||
|
- Search picks its path by SQL dialect inside `services/search.py` (SQLite
|
||||||
|
substring scan / Postgres tsvector) — intentionally **no** `search_backend`
|
||||||
|
config knob (removed `6599935`; nothing ever read it).
|
||||||
|
- Engine endpoint root is `/api/v1` (`/healthz`, `/system/status`, …).
|
||||||
|
- Dev loop: `./desktop-dev.sh` (inotifywait restarts app on `.kt`; uvicorn
|
||||||
|
`--reload` for backend). Debian path: `INSTALL-debian.md`.
|
||||||
|
|
||||||
|
**Done this cycle (Sep 14–15):** batch transcribe-all with overall +
|
||||||
|
per-file stage progress; library multi-select/bulk delete (single delete
|
||||||
|
path); queued-file delete/rename; folder picker in-app + path in Settings;
|
||||||
|
zoom keys; search-within-recording; click-hit-to-playback; model choice
|
||||||
|
narrowed to Base + Large v3; Debian packaging + install guide; standalone
|
||||||
|
provisioning with vendored base model.
|
||||||
|
|
||||||
|
**Open items / candidates:**
|
||||||
|
1. Startup adoption of engine jobs already running (app restart currently
|
||||||
|
orphans them from the UI).
|
||||||
|
2. Reuse upload mapping after restart instead of re-uploading.
|
||||||
|
3. Investigate the 1 skipped backend test (likely the Postgres-path test).
|
||||||
|
4. Confirm Large v3 one-command provisioning on a fresh machine.
|
||||||
|
5. Stale-noise cleanup: `~/.config/shonar-desktop/pump-error.log` holds old
|
||||||
|
Android→server upload 404s (pre-desktop pivot); no action taken.
|
||||||
|
|
||||||
|
**Known debt:** none blocking. No dead stubs; one former TODO (search
|
||||||
|
backend) resolved by deletion.
|
||||||
Loading…
Add table
Add a link
Reference in a new issue