notes

5.7 KB

1. # STATUS — notes.worldapi.org
3. ## 2026-10-01 — mission 046: installable app (PWA) + own icons — built, NOT deployed
4. `project.hl`: `appThemeColor` = token `darker` (the header, rgb(15, 20, 25); rule changed from the accent mid-mission), `appBackgroundColor` = `dark`, `appIcons` (192/512,
5. any + maskable), `appTouchIcon`, `appFavicon`; file routes for `icons/*` and a real `/favicon.ico` (was `direct ""`).
6. hl:web serves `/__hl/manifest.webmanifest` and links it + apple-touch-icon + theme-color from every head.
7. **No `offline = [...]`** on purpose: it would make hl:web register `/__hl/sw.js` for scope `/` over notes' own `/sw.js`
8. (same scope, one replaces the other). Offline stays notes' own (sw.js + notes-offline.js, notes#2) until notes#4.
9. Icon: a note page (folded corner, text lines) with a pencil writing the last line; `icons/icon.svg` source, PNGs via
10. rsvg-convert (README "PWA"). Images looked at: Loreana `/tmp/w046-notes/` (icon-48/192/512, sheet.png, maskable-preview,
11. gate-pwa-phone-offline.png). Gate: `NOTES_GATE_PORT=8720 NOTES_GATE_IDENT_PORT=8721 NOTES_GATE_CHROME=8722-8726 node
12. tests/browser.mjs` → **50 passed, 0 failed** (42 old + 8 new: head links, manifest, icons, Chrome manifest/installability,
13. one worker = /sw.js, offline reload of `/` shows the shell). Signed out there is no worker (notes-offline.js only
14. registers it when signed in) — unchanged behaviour.
16. ## 2026-09-26 — mission 039: ident#23 short ids — switch tool + gate, NOT deployed
17. `users.hl`: the exchange answer is checked with the new `isIdentId` (lower-case letters/digits, 1–64) instead of
18. `isHex(…, 64)`, which refused ident#23's short ids (`a68sz`) — without it nobody could log in after the switch (shown on
19. tickets, whose code mission 039 could not change). New `tools/migrate-short-ids.hl` (users.identity old → short id via
20. ident `POST /api/migrate-ids`, idempotent, never `finish`, prints `users seen / mapped / already short / unmapped /
21. conflicts / failed`, key/secret from env only; non-zero exit on refusal/failed write/conflict). New gate
22. `node tests/short-id-switch.mjs` (ports 8720/8721; old ident `ident.worldapi.org/.scratch/pre-023-ident` → data → copies →
23. new ident → control copy = NEW empty user → tool twice → same user + same data, old session too): **18 passed, 0 failed**.
24. `tests/browser.mjs` (ident#23 in the folder, ports 8730-8739): 42 passed, 0 failed. Docker proof of the runbook command
25. (fake .env, copy): `.scratch/m039-docker-proof.sh`.
26. Runbook (architect, one go for all four apps): Loreana `antcolony-docs/docs/short-id-switch.md`. Deploy this code BEFORE
27. ident#23 (accepts old ids too). Not deployed.
29. ## 2026-09-26 — mission 037: re-vendored Hybriel master e6720b1f
30. `bin/hybriel` + `plugins/` = hybriel master e6720b1f (includes #103/#104, #105 f15a2f7f, #106, #94 c12065d8); old copy
31. (13ef4f9b) in `.scratch/pre-037/`. No local patch, no app change. Gate `node tests/browser.mjs`: 42 passed, 0 failed.
32. Dev server (`~/scratch-037/hashcheck.sh notes.worldapi.org NOTES /`, port 8720): `hl-runtime.js`, `web/client.js`, `app.css`
33. all `?v=39f4c3bb5bd56621` (immutable), bare app.css no-cache, 0 unhashed refs. Not deployed.
35. ## 2026-09-25 — mission 035: re-vendored Hybriel master 13ef4f9b
36. `bin/hybriel` + `plugins/` from hybriel master 13ef4f9b (old copy `.scratch/pre-035/`). No local patch existed.
37. Gate (`NOTES_GATE_PORT=8720 NOTES_GATE_IDENT_PORT=8721 NOTES_GATE_CHROME=8722-8729 node tests/browser.mjs`): 42 passed,
38. 0 failed before, on 9d608332 (2 runs) and on 13ef4f9b. Dev server: `/__hl/app.css?v=<hash>`, `hl-runtime.js?v=`,
39. `web/client.js?v=` (immutable); bare `/__hl/app.css` → no-cache. sw.js caches by full URL, so `?v=` needs no change.
40. Not deployed (architect).
42. ## Ticket notes#1 — notes with a sidebar and the Markdown editor (2026-09-25) — built, not deployed
43. Built: ident login (button + selector), sidebar by subject / last edited first, note on the right in `<md-editor>`,
44. New note, Delete note (with a question), live sidebar across tabs, phone layout (list, then note), storage in
45. `storage/mpackdb/`. `node tests/browser.mjs`: 33 checks green (own ident copy, real Chrome, 390 and 1280 px
46. screenshots in `.scratch/gate-*.png`) — login, create, heading via "# ", edit moves to top, second tab follows,
47. reload and server restart keep everything, another user sees nothing and cannot save/delete, size limit,
48. delete with "Keep", phone and desktop layout, logout. `./deploy.sh --dry-run --skip-tests --target <dir>` shows a
49. clean file list (no storage, no `.env`).
51. Not done / next: the first deploy is the architect's (README "First deploy"). Not built because the concept does not ask: JSON / Markdown API, search,
52. folders, display names.
54. ## Ticket notes#2 — notes offline, synced when back online (2026-09-25) — built, not deployed
55. Built: the notes area is now client-side (`notes-offline.js`): IndexedDB copy per user, edits written there first, sent
56. to `/api/notes`, pulled every 10 s / on online / on tab focus; `sw.js` keeps the page so a reload works offline; a note
57. made offline gets its server id at the first push; conflicts: later edit wins, the other version is kept as a copy;
58. deletes are tombstones; log out sends the unsent and wipes the browser copy. The old hl faces for save/create/delete
59. and the `notesChanged` push are gone (old components in `.scratch/old/`). `node tests/browser.mjs`: 42 checks green —
60. real Chrome, the server really stopped for "offline" (reload, edit, new note offline; back online → server and second
61. device; two devices editing one note → copy; delete; other user; phone/desktop; log out wipes).
62. Not done: the service worker needs https (worldapi.org has it); no update-available prompt; Back button does not step
63. through notes (replaceState); a note is compared by its edit time from the device's clock (large clock skew can make
64. the "wrong" version the copy — nothing is lost).