tickets

42.4 KB

1. ## 2026-10-01 — mission 048: re-vendor to hybriel master ff51cf46 STOPPED (Hybriel bug) — restored to 837fe120
2. Tried master ff51cf46 (ReleaseFast, read-only archive): gate 212 passed, 1 failed — settings "Save" turns the admin page into
3. "Only an admin of the project can open its settings". CAUSE (hl:web, 0b17f65b + 64527baa): after ANY face that takes `session`,
4. WebFramework.hl answers with `ack.sync` built from `mount(key, {}, s, …)` — the component re-mounted WITHOUT its route params, so
5. every server reference site reading session (`isAdmin = … isAdminOf(project.id, me)`) is computed with `projectSlug = null` →
6. false, and the browser takes it. Minimal repro: `.scratch/w048/repro/` (`node repro.mjs <bin>` in a tree with master's plugins:
7. "you may edit" → "you may not edit" after a face; 837fe120 keeps it). Restored `bin/` + `plugins/` from `.scratch/pre-048/`;
8. gate on the restored copy (ports 8732–8739, A/B one port each) → 245 passed, 0 failed. Logs: `.scratch/w048/`.
9. Live data (copy, deleted): no duplicate @id in any table (#113). migrate.hl compactNow() workaround (hybriel #110, master has it)
10. KEPT — not provable without the new binary. Not deployed.
11. Follow-up (lead: since 64527baa a session face also syncs session-derived members → a handler that appends the face's row shows
12. it twice, as in gitoria): tickets never appends a face's answer to a synced list (comments/state events arrive by push into `events`,
13. which reads no session; list/inbox upsert by id; tokens/members/choices are replaced from the answer). Gate +4 "once:" checks
14. (comment once in A and B, state change once, bob once in the settings members). 837fe120: 249 passed, 0 failed. Master copy
15. (throwaway): the 3 comment/state ones green, members unreachable (stops at the settings bug) — `.scratch/w048/gate-once-*.txt`.
17. ## 2026-10-01 — mission 046: installable app (PWA) + own icons — NOT deployed, awaiting architect / creator
18. Done: `project.hl` (appIcons, appTouchIcon, appFavicon, theme = header darker rgb(15, 20, 25), `offline = [ TicketList ]`, icon routes,
19. real `/favicon.ico`), `components/main.hl` + `styles.hl` (the "You are offline" note via the net-probe animation tick),
20. `icons/` (ticket stub, svg source + PNGs + ico), gate part "PWA" in `tests/browser.mjs` (README "PWA", "Test").
21. Gate (ports 8750–8759, command in README "Test") → **245 passed, 0 failed** (was 233); `tests/connect.mjs` 60/60 (run on a
22. temp copy with Chrome 8757–8759). Looked at: icon 48/192/512 + maskable crop, 390 px online/offline shots — /tmp/w046-tickets/ on Loreana.
23. Gate race fixed: "inbox follows the state change live" failed ~1/5 (API write overtook the tab's hello; the worker's extra
24. requests widened the window) → `connected()` now waits for a pong after the hello. 12 runs green (6 on 8740–8749, 6 on 8750–8759).
25. Open: offline `/` shows the list as last loaded (stale by design); verify install on a real phone after deploy.
27. ## 2026-09-26 — ticket #23: connect protocol documented for app workers
28. New `docs/connect-apps.md` (steps, exchange, key headers, create-ticket / comment / state calls); linked from the README. No code change.
30. # STATUS
32. ## 2026-09-26 — ticket #21: connect an app to a project (gitoria's tickets) — NOT deployed
33. Done: `connections.hl` + `components/connect.hl` + routes (`/connect`, `/connect/:nonce`, `/api/connect/exchange`, `…/connections`, `…/connections/remove`), the
34. connections line + Disconnect on the project page, per-project key `tktc_…` (create / comment / state only, roles of the NAMED person via
35. `X-Tickets-Identity`). README section "Connecting an app to a project". `node tests/connect.mjs` → 60 passed, 0 failed. NOT run: the old gate
36. `tests/browser.mjs` / `short-id-switch.mjs` (they need a copy of ident's code, `ident.worldapi.org` is not on this machine); the only shared-code
37. change is `apiAuth` in `project.hl` (token users behave as before — checked in the new gate). Gitoria's side (button "Connect tickets", storing the key,
38. sending the events) is gitoria's ticket. On Byrodin set `TICKETS_CONNECT_ORIGINS` only if a non-worldapi.org app must connect.
40. ## 2026-09-26 — ticket #22: every event in the API carries `userId` — NOT deployed
41. `store.hl eventRowOf` adds `userId` (the users @id of the author; `''` for events from before the login). `author` (display name) unchanged. Checked with a real write on a fresh store (`.scratch/m22/t.hl`: user, project, ticket, comment): both events show `userId` = the author's users @id. Not covered by the gate.
43. ## 2026-09-26 — ticket #20: projects as own data, members, roles, new states — NOT deployed (architect: together with the scheduler update)
44. Took over the unfinished worker session s-20260926T1044-278e20 (store/projects/members/settings/invites/inbox code was written, the gate not run).
45. Fixed: the migration's replaced records left tombstones and the page realm's second open compacted the files under the first handle (every slug
46. lookup 404'd after the first page render) → `migrate.hl` compacts the changed tables. Gate: `tests/browser.mjs` → 233 passed, 0 failed (roles,
47. states + aliases, inbox, project create / settings / slug change / members / invite accepted through ident, layouts of the new pages);
48. `tests/short-id-switch.mjs` (ports 8706/8707) → 19 passed, ported to the roles. The migration was also run on a copy of the dev store (5 projects,
49. 47 tickets: 38 open, 9 done). Parked: the old browser checks (`tests/browser-pre20-parked.txt`). Not done: live push of a role change to an open page
50. (a page needs a reload after an admin changes its role), the "answered" state of #19 is gone (replaced by these states).
52. ## 2026-09-26 — mission 036: on hybriel master 837fe120 (hl:web, no local patch) — NOT deployed, awaiting architect
53. Still carries the UNDEPLOYED #19 state (see Byrodin STATUS: never deploy tickets before #19 is decided).
54. Switched: plugins/webex + both LOCAL PATCHes gone → master's plugins/web; `'hl:web'` / `'hl:web/css'` imports;
55. NativeWebSocketServer/bindHost gone (hl:web reads HL_HOST); /login/callback uses `req.session` (still mints +
56. Set-Cookie when the browser has none); `realSession()` gone (`session == null`); `encode` = `encodeURIComponent`;
57. import.hl `after` = `a > b`; jsoncheck accepts a VALID \u surrogate pair (lone ones still 400 — JSON.parse still
58. aborts on them, checked with the new binary); shared/tokens.hl = ident's/gitoria's hl:web copy. Gate: the 12 forged
59. checks accept hl:web's own refusal (ack `ok:false`, "the `session` parameter is filled by the server"); surrogate cases
60. updated (+2 checks: pair passes, high+non-low refused). `node tests/browser.mjs` → **423 passed, 0 failed** (incl.
61. the #104 text-order check "the form says which ticket it opened"), no Chrome left. Served page:
62. `/__hl/{hl-runtime.js,web/client.js,app.css}?v=ead0a6f2dfc83077`, 0 unhashed refs, hashed = immutable, bare = no-cache.
63. Backup of the old state: `.scratch/pre-036/` (bin, plugins, src, tests). Kept: jsoncheck, localtime, hand sorts,
64. login.js guard (JS untouched).
66. ## 2026-09-25 — mission 035: re-vendor to hybriel master 13ef4f9b STOPPED (Hybriel bug) — code NOT touched (only this note)
67. Probe in a copy (loreana `~/scratch-035/tickets-probe` deleted; recipe: rsync without .env/storage, bin+plugins from master,
68. `'hl:webex'`→`'hl:web'`, `'hl:webex/css'`→`'hl:web/css'`, gitoria's `shared/tokens.hl`): gate 408 passed, 13 failed. (1) HYBRIEL
69. BUG: an element built in the browser when its `if` turns true puts a child element BEFORE the bound text: `p { notice " " a {…} }`
70. in ticket_list.hl renders `<a>open it</a>Opened hybriel #1. ` (server render is right). Repro: loreana
71. `~/scratch-035/repro/home-textorder.hl`. (2) 12 forged-session checks expect an app `{error}`; hl:web now refuses the extra
72. argument itself (ack `ok:false`) → the checks must accept that. Workarounds to drop at the real re-vendor: webex LOCAL PATCHes,
73. NativeWebSocketServer listener (HL_HOST), realSession(), charCodeAt ordering, jsoncheck surrogate refusal (#15), hand URL encoders.
75. ## 2026-09-25 — ticket #19 "answered" state — awaiting architect (deploy) / creator
77. New state `answered`. When the creator comments on a ticket in `awaiting creator`, the store (`addComment`)
78. also writes a state event → `answered` (goes back to whoever asked, leaves the inbox). Other users' comments
79. change nothing; "confirmed" stays "tested, works". The asker sets `awaiting creator` again as before.
80. API POST comments and the page face push both events; state badge colour + filter added. Gate: new #19 checks.
81. DECISIONS.md not touched (architect/librarian).
83. ## 2026-09-24 — ticket #12 Markdown source view (mission 025) — awaiting architect (deploy) / creator
85. Follow-up to mission 024: the creator asked (ticket #12, after "awaiting creator") for "a switch
86. source / markdown at the bottom" to copy/paste or hand-edit the raw Markdown.
88. Done (worker; edited `/media/STORAGE/projects/worldapi-components/md-editor.js` directly — a plain
89. JS asset, no `.hl` dev-server-reload risk — then `cp` into `shared/md-editor.js` here; no tickets
90. `.hl`/faces/API/data changed, so nothing else needed a dev-copy round-trip):
91. - `<md-editor>` gets a footer row at the bottom with a "Markdown source" button: swaps the visual
92. editor for a plain textarea with the raw Markdown (copy/paste or hand-editing), "Visual editor"
93. swaps back (re-parses the text). Same `input`/`change` events, Ctrl+Enter still sends the form.
94. Hidden together with the toolbar when `toolbar="none"`. Details: worldapi-components README
95. "Source view" / STATUS mission 025.
96. - Component test (worldapi-components) → **81 passed, 0 failed** (72 before + 9 new checks), 83
97. with `ORACLE_APP`. Screenshot `worldapi-components/.scratch/test/md-editor-source-view.png`.
98. - This app's gate `node tests/browser.mjs` (ports 8700-8729, this session's range) → **418 passed,
99. 0 failed**, unchanged from mission 024 (no new tickets-side checks added — the feature lives
100. entirely in the vendored component; the existing `#12` checks already cover the enhanced/standalone
101. editors and keep passing with the new footer present).
103. How to verify (ports 8700-8749 only):
104. ```bash
105. cmp /media/STORAGE/projects/worldapi-components/md-editor.js shared/md-editor.js && echo same
106. cd /media/STORAGE/projects/worldapi-components && HL_CHROME=/opt/google/chrome/chrome node test/run.mjs # 81 passed
107. cd /media/STORAGE/projects/tickets.worldapi.org
108. TICKETS_GATE_PORT=8700 TICKETS_GATE_IDENT_PORT=8701 TICKETS_GATE_EXCHANGE_PORT=8702 \
109. TICKETS_GATE_CHROME_A=8710-8719 TICKETS_GATE_CHROME_B=8720-8729 node tests/browser.mjs # 418 passed
110. ```
111. Manual (creator): open a ticket → Comment field → click "Markdown source" at the bottom → the box
112. becomes a plain textarea with the Markdown → edit it → click "Visual editor" → it renders again.
114. Not deployed (Byrodin container untouched, live app on tickets.worldapi.org still the pre-mission-025
115. version); the architect deploys with `./deploy.sh` after the creator confirms.
117. ## 2026-09-24 — ticket #12 Markdown editor (mission 024) — awaiting architect (deploy) / creator
119. Done (worker; developed in `.scratch/dev-m024`, copied back, NOT deployed):
120. - New project `/media/STORAGE/projects/worldapi-components/` with `<md-editor>` (its README/STATUS/test).
121. - Vendored as `shared/md-editor.js`, route `/md-editor.js`, script in the shell; new-ticket summary, edit
122. summary, comment and state note (input → textarea rows 1) wrapped in `mdEditor { textarea {…} }`;
123. `styles.hl` sets the `--md-*` tokens. Faces/API/data unchanged. README "Markdown editor".
124. - Gate `node tests/browser.mjs` → **418 passed, 0 failed** (402 old + 16 new `#12` checks; dev copy and main folder).
125. - Component test (in worldapi-components, with this app's markdown.hl as oracle) → 72 passed, 0 failed.
126. - Old files before the copy-back: `.scratch/m024/pre-copy-backup/`.
128. How to verify (ports 8800-8849 only):
129. ```bash
130. cd /media/STORAGE/projects/tickets.worldapi.org
131. cmp shared/md-editor.js ../worldapi-components/md-editor.js && echo same
132. bash .scratch/m024/gate-tickets.sh .scratch/m024/g.txt; tail -2 .scratch/m024/g.txt # 418 passed (ports 8810-8812, Chromes 8835-8844)
133. cd ../worldapi-components && ORACLE_APP=../tickets.worldapi.org HL_CHROME=/opt/google/chrome/chrome node test/run.mjs # 72 passed
134. ps -eo pid,args | grep [h]l-browser-tier | grep remote-debugging-port=88 # empty
135. ```
136. Screenshots: `.scratch/gate-{phone,desktop}-mdeditor.png`, `.scratch/gate-phone-newticket-mdeditor.png`,
137. `../worldapi-components/.scratch/test/md-editor-{phone,desktop}.png`.
138. Manual (creator): open a ticket → Comment: type `**bold**` → it turns bold; tap B / list on the phone;
139. Ctrl+Enter sends; Edit → the summary shows formatted, Save.
140. Lessons: `<md-editor>` is form-associated, so a wrapping `<label>` activates IT (not the textarea);
141. Hybriel's JSON.stringify sorts object keys (compare key-sorted); a `<textarea>` turns CR LF into LF
142. when its value is set by script.
144. ## 2026-09-24 — design tokens AS DESCRIBED (ticket antcolony#3, mission 021) — awaiting architect (deploy) / creator
146. Mission 018 (generated `':root'` copy + sync.sh) was REJECTED by the creator; mission 021 replaces it.
147. Done (worker; developed in `.scratch/dev-m021`, copied back, NOT deployed):
148. - `shared/tokens.hl` = hand-written webex `var()` tokens (`static dark = var('rgb(25, 30, 35)')`, semantic
149. `colorText = var(light)` …, incl. `colorAccentText` moved here from the app), verbatim copy of
150. `/media/STORAGE/projects/worldapi-tokens/tokens.hl`. `styles.hl` member-imports them and uses them as
151. members; sets only `colorAccent = var(purple)`. README "Design tokens".
152. - webex LOCAL PATCH (mission 021, hybriel#39) in `plugins/webex/WebFramework.hl`; XSS patch kept.
153. - Old files: `.scratch/m021/pre-copy-backup/` (styles.hl, shared/tokens.hl, WebFramework.hl); mission 018's
154. worldapi-tokens folder (sync.sh, tokens.css, generated tokens.hl): `tickets.worldapi.org/.scratch/m021/worldapi-tokens-m018-backup/`.
155. - Rendered colours unchanged: `/__hl/app.css` after `:root` byte-identical old vs new (in `:root` only
156. the order of `--color-accent-text` / the app's `--color-accent` changed); Chrome computed colours
157. of every element + every token, tickets list/inbox/state/ticket/you + ident home/code/account/apps/inbox,
158. 390 + 1280: 23 passed, 0 failed.
159. - Gate `node tests/browser.mjs` (ports remapped: `.scratch/m021/gate-tickets.sh`) → **402 passed, 0 failed** (dev copy and main folder).
160. - Deploy simulation (deploy.sh excludes + debian:12-slim container): same app.css, byte-identical.
162. How to verify (ports 8850-8879 only; scripts in tickets.worldapi.org/.scratch/m021 unless noted):
163. ```bash
164. cd /media/STORAGE/projects/tickets.worldapi.org
165. for a in tickets ident; do cmp /media/STORAGE/projects/worldapi-tokens/tokens.hl ../$a.worldapi.org/shared/tokens.hl && echo same $a; done
166. bash .scratch/m021/cmpup.sh up; node .scratch/m021/cmpstyles.mjs; bash .scratch/m021/cmpup.sh down # 23 passed (old code: <app>/.scratch/m021/old-<app>)
167. IDENT_GATE_DIR=/media/STORAGE/projects/ident.worldapi.org bash .scratch/m021/gate-tickets.sh .scratch/m021/g.txt; tail -2 .scratch/m021/g.txt # 402 passed
168. cd /media/STORAGE/projects/ident.worldapi.org; bash .scratch/m021/gate-ident.sh . .scratch/m021/gates-main # 6 suites green
169. bash /media/STORAGE/projects/tickets.worldapi.org/.scratch/m021/deploysim.sh <tickets dir> <ident dir> # needs cmpup's run/main-*.css
170. ps -eo pid,args | grep [h]l-browser-tier # empty
171. ```
172. Screenshots: `tickets.worldapi.org/.scratch/m021/shots/<app>-<old|new>-<page>-<390|1280>.png`.
173. Lesson: an imported `static` var() token works only with the mission 021 webex patch; tokens.hl changes need a restart.
175. ## 2026-09-24 — shared design tokens (ticket antcolony#3, mission 018) — REJECTED by the creator, superseded by mission 021
177. Done (worker; developed in `.scratch/dev-m018`, copied back, NOT deployed):
178. - Tokens now come from `shared/tokens.hl` (generated from layouts `tokens.css` by
179. `/media/STORAGE/projects/worldapi-tokens/sync.sh`, vendored like plugins/); `styles.hl` inherits it and
180. sets only the accent (README "Design tokens"). Old copy of `styles.hl`: `.scratch/m018/pre-copy-backup/`.
181. - Every rendered colour unchanged: `/__hl/app.css` after `:root` byte-identical old vs new; computed
182. colours of every element (tickets list/inbox/state/ticket/you, ident home/code/account/apps/inbox, 390 +
183. 1280) old == new in Chrome.
184. - Gate `node tests/browser.mjs` → **402 passed, 0 failed** (dev copy and main folder).
186. How to verify (ports 8850-8879 only):
187. ```bash
188. cd /media/STORAGE/projects/tickets.worldapi.org
189. /media/STORAGE/projects/worldapi-tokens/sync.sh --check # ok ×3
190. bash .scratch/m018/cmpup.sh up; node .scratch/m018/cmpstyles.mjs; bash .scratch/m018/cmpup.sh down # 23 passed (old code in .scratch/m018/old-*)
191. IDENT_GATE_DIR=/media/STORAGE/projects/ident.worldapi.org bash .scratch/m018/gate-tickets.sh /tmp/g.txt; tail -2 /tmp/g.txt # 402 passed
192. cd /media/STORAGE/projects/ident.worldapi.org; bash .scratch/m018/gate-ident.sh . .scratch/m018/gates-main # 6 suites green (ports remapped copies)
193. bash /media/STORAGE/projects/tickets.worldapi.org/.scratch/m018/deploysim.sh <tickets dir> <ident dir> # deploy rsync + container: same app.css
194. ps -eo pid,args | grep [h]l-browser-tier # empty
195. ```
196. Screenshots: `tickets.worldapi.org/.scratch/m018/shots/<app>-<old|new>-<page>-<390|1280>.png`.
197. Lesson: a `var()` token of hl:webex/css can't cross an `inherit` (second instance) — use literal `':root'` strings.
199. ## 2026-09-24 — ticket #4 (mission 017): parent / child + blocked-by — awaiting architect (deploy) / creator
201. Done (worker; developed in `.scratch/dev-m017`, copied back, NOT deployed to Byrodin):
202. - **Relations** (README "Relations"): a ticket has ≤ 1 parent and any number of blockers, across
203. projects; parent page lists children + states, child shows "Part of …"; "Blocked by" / "Blocks" on
204. both sides. New table `storage/mpackdb/links.*` (created empty — no migration); every change is a
205. history event `kind:"link"` on the child / blocked ticket.
206. - **Who may**: the author of either ticket or the creator (legacy tickets without author: only the
207. creator or the other ticket's author). No self-links, no loops (also transitive), no duplicates.
208. - **Parent state**: `allChildrenConfirmed` (children exist and all `confirmed`) → page "all children
209. confirmed (n)" (green) / "k of n children confirmed"; the parent's state is never changed.
210. - **API**: `POST …/parent {parent}` (`""` removes), `POST …/blocked-by {add}|{remove}`, both URL
211. forms; rows (list + single) carry `parent`, `children`, `blockedBy`, `blocks` (refs with states),
212. `allChildrenConfirmed`. Markdown view: Parent / Children / Blocked by / Blocks blocks + list-line tails.
213. - **Web**: forms "Parent ticket" (Set / Remove) and "Blocked by" (Add, Remove per row) for logged-in
214. users; live push `ticketsRelated` after relation writes, state changes and edits.
215. - Gate ports configurable (`TICKETS_GATE_CHROME_A/B` new); a `connected()` wait added before the
216. pre-existing token "Revoke" click (it flaked once on the bare SSR button).
217. - Gate `node tests/browser.mjs` → **402 passed, 0 failed** (dev copy 3× in a row, main folder 3×).
219. How to verify:
220. ```bash
221. cd /media/STORAGE/projects/tickets.worldapi.org
222. bash .scratch/m017/gate.sh .scratch/m017/g.txt; tail -2 .scratch/m017/g.txt # gate on ports 8800-8819 (or plain node tests/browser.mjs)
223. ps -eo pid,args | grep [h]l-browser-tier # empty
224. bash .scratch/m017/compat.sh # old vs new code on store copies: JSON equal minus the 5 new keys, Markdown identical, .mpack unchanged
225. node .scratch/m017/identmigrate.mjs # rehearsal on a store COPY: ident #3–#8 under ident #1 (creator token 201 ×6, non-creator 403)
226. ```
227. Look at `.scratch/gate-{phone,desktop}-{parent,blocked}.png`.
229. For the architect (after the deploy): link the ident pieces —
230. `for n in 3 4 5 6 7 8; do curl -s -XPOST -H "Authorization: Bearer $TOKEN" -d '{"parent":"ident.worldapi.org#1"}' https://tickets.worldapi.org/api/projects/ident.worldapi.org/tickets/$n/parent; done`
231. — ident #1 and #3–#8 were opened BEFORE the login (authors "import" / "architect" as text), so only
232. the CREATOR's token may (a non-creator gets 403, rehearsed). Check: `curl -s -H 'Accept: text/markdown' https://tickets.worldapi.org/api/projects/ident.worldapi.org/tickets/1 | head -20`.
233. Manual (creator): open a ticket you opened → "Parent ticket" field → `ident.worldapi.org#1` → Set parent;
234. the parent page lists it under "Children".
236. Lessons (mission 017):
237. - `from` is reserved in Hybriel (parse error "Expected parameter name") — known (hybriel#22), bit again.
238. - A gate click right after `goto` + `waitForSelector` can hit the SSR button before hydration → wait for
239. the socket (`connected()`) before any click.
240. - Loreana ports 8821 and 8830 are taken by other software (llama-server) — inside the 8800-8849 range.
242. ## 2026-09-24 — tickets #8 (edit) + #6 (Markdown) + #11 (gate under load), mission 014 — awaiting architect (deploy) / creator
244. Done (worker; developed in `.scratch/dev-m014`, copied back, NOT deployed to Byrodin):
245. - **SECURITY, found on the way (pre-existing, live too)**: hl:webex writes the page state (user
246. text) into an inline `<script>` unescaped → a summary / comment containing
247. `</script><img src=x onerror=…>` executes in every viewer's browser. Reproduced on the pre-m014
248. code (`.scratch/m014/old-app`, probe ticket via `.scratch/m014/xssprobe.hl` on a store COPY →
249. `xsscheck.mjs` `__pwned = 1`); fixed by a one-line LOCAL PATCH in `plugins/webex/WebFramework.hl`
250. (`<` → `\u003c` in the seed) → `__pwned = undefined`, page hydrates. Deploy soon; ident and
251. every other hl:webex app vendor the same code (hybriel issue to file).
252. - **#8 editing** (README "Markdown, editing"): the author edits subject + summary (web "Edit",
253. API `POST …/edit`); legacy tickets (no user on the created event): only the creator; else 403.
254. Edit = history event `kind:"edit"` with old + new values, pushed live.
255. - **#6 Markdown**: `markdown.hl` + `components/markdown.hl` render summary / comments / state
256. notes safely (text nodes only, `safeHref`); `mdview.hl` = `Accept: text/markdown` on the ticket
257. GETs. JSON unchanged (old vs new code on copies of the store: every GET byte-identical).
258. - **#11 gate**: page waits × `TICKETS_GATE_SLOW` (default 3); console check before ident stops,
259. browsers parked on `about:blank` during "ident down".
260. - Gate `node tests/browser.mjs` → **335 passed, 0 failed** (dev copy and main folder).
262. How to verify:
263. ```bash
264. cd /media/STORAGE/projects/tickets.worldapi.org
265. node tests/browser.mjs # 335 passed; look at .scratch/gate-{phone,desktop}-{edit,markdown}.png
266. ps -eo pid,args | grep [h]l-browser-tier # empty
267. bash .scratch/m014/compat.sh # JSON DUMPS IDENTICAL, 47 tickets md+page 200, .mpack unchanged
268. # #11 under load: a dev server on a store COPY (:8374), then
269. node .scratch/m014/load.mjs http://127.0.0.1:8374 4 6 & # 4 Chromes x 6 tabs; kill %1 afterwards
270. node tests/browser.mjs # 3x green (logs .scratch/m014/gate-load-*.txt, gate-heavy-*.txt)
271. # old code under the same load: .scratch/m014/old-app → 274/1 (ERR_CONNECTION_REFUSED selector.js), 3 of 3 runs
272. ```
273. Manual (creator): open a ticket you opened after the login → "Edit" (top, under the dates) →
274. change subject / summary (Markdown) → Save: the history shows "edited the ticket" with the
275. previous version folded. `curl -H 'Accept: text/markdown' https://tickets.worldapi.org/api/projects/tickets.worldapi.org/tickets/6`.
276. Old files before the copy-back: `.scratch/m014/pre-copy-backup/` (+ `.scratch/m014/old-app/plugins`).
278. Lessons (mission 014):
279. - A `#events li` selector (CSS or test) also hits the `<li>` of a Markdown list inside an event:
280. use `#events > li`.
281. - Hybriel string literals DO decode `\uXXXX` but not `\\`: a literal backslash is `'\u005c'`.
282. - Never embed user text in an inline `<script>` without escaping `<` (webex did — see above).
284. ## 2026-09-24 — tickets #9 + #10 (mission 012): login banner after logout, button returns to the page — awaiting architect (deploy) / creator
286. Done (worker; developed in `.scratch/dev-m012`, copied back, NOT deployed to Byrodin):
287. - **#9 cause (reproduced in headless Chrome, own ident + tickets, `.scratch/m012/repro.mjs`)**:
288. hl:webex re-creates the shell header — `<ident-selector>` AND the `<script>` elements — every
289. time the login state flips (login, logout); the browser runs the re-inserted `/login.js` again,
290. and every run added one more `ident-login` listener to the (new) selector. After a logout the
291. selector carried 2 listeners → one choice = 2 `change`s on `#identcode` = 2 `identLogin` faces =
292. 2 exchanges of the SAME code at ident (200, then 400 "unknown or already used code" → banner).
293. The first exchange had logged the session in as the chosen identity (B). Not identity-specific:
294. A → Log out → A again showed the banner too; the first selector login after a page load never
295. does (one listener) — that is why "with A alone" it never appeared. Navigation is NOT the cause
296. (after an in-app click list → ticket, login.js had not run again); list, ticket page reached by
297. click and ticket page loaded directly all showed it (old code: exchanges `[200, 400]`).
298. - **Fix** `login.js`: installs once per document, `ident-login` listener on `document`, current
299. `#selector` looked up each time (MutationObserver on the whole document), each code handed on
300. once. After: exactly one exchange, no banner, logged in as B (all 3 scenarios).
301. - **#10** the button returns to the page: `login.js` adds `?next=<path+query>` to the button's
302. return URL at the click; `project.hl` `safeNext` + `/login/callback` → 302 there (same-origin
303. path only, else `/`). ident keeps the return URL's query and appends `&ident_code=`.
304. - Gate `node tests/browser.mjs` → **275 passed, 0 failed** (+25: #9 path with an exchange-counting
305. proxy, #10 table + browser). With the OLD `login.js` the new #9/#10 checks FAIL (negative control).
307. How to verify:
308. ```bash
309. cd /media/STORAGE/projects/tickets.worldapi.org
310. node tests/browser.mjs # 275 passed; grep '#9\|#10' in the output
311. ps -eo pid,args | grep [h]l-browser-tier # empty
312. SCEN=ticket-nav node .scratch/m012/repro.mjs # "B login: exchanges=1 ..." ; banner null
313. SCEN=list node .scratch/m012/repro.mjs .scratch/m012/old-app # the OLD login.js: "B login: exchanges=2", banner
314. ```
315. Old files before the copy-back: `.scratch/m012/pre-copy-backup/`. Gate logs `.scratch/m012/gate-*.txt`.
316. Manual (creator): log in with the selector, Log out, choose another identity → no red banner,
317. top right the other identity; log out on a ticket page, "Log in with ident" → back on that page.
319. ## 2026-09-24 — ticket #7 (mission 011): login via ident — awaiting architect (deploy) / creator
321. Done (worker; developed in `.scratch/dev-m011`, NOT deployed to Byrodin):
322. - **Login** (README "Login (ident)"): ident's selector top right + "Log in with ident" button;
323. the server exchanges the one-time code (`users.hl` exchangeCode, IDENT_API_KEY/SECRET) for the
324. per-app identity id; `login.js` bridges the selector's `ident-login` event into the shell's
325. face `identLogin` (no reload); `/login/callback` for the button. Logout resets the selector.
326. - **Users** `storage/mpackdb/users.*` (identity id → display name, asked once at the first login,
327. cannot be changed afterwards), **tokens** `storage/mpackdb/tokens.*` (sha256 only; `/you`:
328. create / list / revoke; `Authorization: Bearer` on every API write, else 401).
329. - **Reading public, writing needs a login** (web faces check the REAL session, #31; API 401).
330. No author field (API `author` → 400 naming it); events store `user`, old events keep their
331. author. **Confirm/reject only by `TICKETS_CREATOR_IDENTITY`** (unset = nobody; API 403).
332. - `/you` shows the user's own per-app id (for TICKETS_CREATOR_IDENTITY) + tokens.
333. - `import.hl` needs `TICKETS_TOKEN`. `docker-compose.yml`: `IDENT_EXCHANGE_URL=http://127.0.0.1:45002`
334. (key/secret/creator come from `.env`, loaded by the runtime).
335. - Gate `node tests/browser.mjs` → **250 passed, 0 failed** (own ident on :8353 from a copy of
336. ident's code without `.env`, mail sink; see README "Test").
337. - Live-store compatibility: old code (`.scratch/dev-m010`) and new code each on a COPY of
338. `storage/mpackdb`, every GET dumped → byte-identical (`.scratch/m011/compat.sh`); old
339. `.mpack` files unchanged; `users.*`/`tokens.*` appear empty. No migration step.
341. For the architect (deploy): `.env` on Byrodin must have `IDENT_API_KEY` / `IDENT_API_SECRET`
342. (creator set them). After the deploy: the creator logs in, opens `/you`, the architect sets
343. `TICKETS_CREATOR_IDENTITY=<id>` in `.env`, restarts; the creator (identity "Architect") creates
344. the architect's token on `/you`. Until then NOBODY can confirm/reject, and every API client
345. (the architect's scripts, import) needs a token — writes without one are 401 from the deploy on.
347. How to verify:
348. ```bash
349. cd /media/STORAGE/projects/tickets.worldapi.org
350. node tests/browser.mjs # 250 passed; screenshots .scratch/gate-*-{signedout,name,loggedin,tokens}.png
351. ps -eo pid,args | grep [h]l-browser-tier # empty
352. bash .scratch/m011/compat.sh # DUMPS IDENTICAL (old vs new code on copies of storage/mpackdb)
353. ```
354. Manual (dev): own ident + tickets: `bash .scratch/m011/devup.sh` (ident :8358 from
355. `.scratch/m011/ident` = copy WITHOUT .env, mail sink `.scratch/m011/run/mail.txt`; tickets :8359
356. with `.scratch/m011/run/app.env`; `node .scratch/m011/devsetup.mjs` registers the app first).
357. Query users/tokens: only on a COPY (#40): `cp -a storage/mpackdb /tmp/c` + a small hl script
358. (`MPackDB(file = '/tmp/c/users.db', primaryKey = '@id', indexes = ['!identity'])`).
360. ## 2026-09-24 — deploy readiness (mission 010) — awaiting architect (first deploy)
362. Done (worker; NOT deployed to Byrodin):
363. - `project.hl`: builds the listener itself so `HL_HOST=127.0.0.1` binds loopback (hl:webex
364. ignores HL_HOST); `TICKETS_WATCH=0` = no dev watcher. Defaults unchanged (0.0.0.0, watcher on).
365. - `docker-compose.yml` (container `tickets.worldapi.org`, 127.0.0.1:45003) + `deploy.sh`
366. (README "Deploy").
367. - Gate `node tests/browser.mjs` → 164 passed, 0 failed (dev copy `.scratch/dev-m010` and live folder).
368. - Tested on Loreana only: local deploy into a directory + the container there (only
369. 127.0.0.1:45003 listens, URL 200, fake storage marker untouched), and behind a local TLS
370. nginx in real Chrome: page + wss socket, no http:// URLs (ident `.scratch/m010/`).
372. How to verify:
373. ```bash
374. cd /media/STORAGE/projects/tickets.worldapi.org
375. node tests/browser.mjs # 164 passed
376. bash -n deploy.sh && ./deploy.sh --dry-run --target /tmp/ticketsdeploy-test # LOCAL dir only
377. ```
378. For the architect: the vhost needs WebSocket Upgrade headers and `proxy_pass http://127.0.0.1:45003`.
380. ## 2026-09-24 — ticket #38 (mission 008): per-project numbers, UUID keys, storage/mpackdb/ — awaiting creator
382. Done (worker, not yet confirmed by the creator):
383. - **UUID keys** (`@id`) in all three tables, files in `storage/mpackdb/{projects,tickets,events}.*`.
384. Ordering from stored times: lists by `updated`, history by (`created`, `seq`), projects by `created`.
385. - **Per-project numbers** from 1; URL `/projects/<project>/<number>`; slug = project name as is
386. (new names: letters, digits, `. _ -` only). List, inbox, ticket page, pushes, notice link use it.
387. - **Old global numbers** kept as `oldNumber`: page shows "formerly #n", `/tickets/<n>` → 301,
388. `/api/tickets/<n>[/comments|/state]` still work (also with the UUID). New tickets: no old number.
389. - **API** per-project form `/api/projects/<slug>/tickets[/<number>[/comments|/state]]` (GET/POST),
390. rows carry `project`, `number`, `href`, `apiHref`, `oldNumber`. `ticket.id` is now the UUID.
391. - **Migration** `tools/migrate-008.hl` (idempotent) of the live data, deployed 2026-09-24:
392. old tables stay in `storage/tickets-*` (untouched, md5-checked), full backup
393. `.scratch/storage-backup-<ts>`, logs + before/after dumps in `.scratch/deploy-008-<ts>/`
394. (`deploy-008.sh`, compare `cmp008.py`). Rehearsed on a copy first (`.scratch/rehearse.sh`).
395. - Gate: `node tests/browser.mjs` → **164 passed, 0 failed** (in `.scratch/dev` before deploy).
397. Test: gate (see README "Test"), then
398. `python3 .scratch/cmp008.py .scratch/deploy-008-*/before.jsonl .scratch/deploy-008-*/after.jsonl`
399. and open http://192.168.178.75:8350/tickets/38 (→ /projects/tickets.worldapi.org/5).
401. Known gaps: new tickets have no global number, so `/api/tickets/<n>` works only for the
402. migrated #1–#40 (use the UUID or the per-project form). Numbers are max+1 (a deleted ticket's
403. number would be reused — there is no delete). Project names stay case-sensitive.
405. ## 2026-09-24 — ticket #15 (mission 004): required author, 400 on invalid JSON, list lines — awaiting creator
407. Done (worker, not yet confirmed by the creator):
408. - **`author` required** on `POST /api/tickets`, `/comments`, `/state` → 400 `{error, field:"author"}`
409. when missing/empty (`api.hl` required lists + `store.hl` `authorMissing`, so web faces too).
410. Web forms: name fields removed, they write as `creator` until ident exists. Stored data unchanged.
411. - **Invalid JSON → 400 `{error:"invalid JSON at character N"}`** (no source path) via
412. `jsoncheck.hl` before `JSON.parse` — WORKAROUND for hybriel #12, remove when fixed. It also
413. refuses `\uD800`–`\uDFFF` escapes (hl JSON.parse refuses even valid pairs → would be 500).
414. - **Import list lines**: `ticketfile.hl` keeps `- ` / `* ` / `1. ` lines as own lines (`\n`),
415. wrapped lines still joined; page shows them as separate lines (pre-wrap). #1–#5 have no lists
416. → nothing to migrate.
417. - Gate: `node tests/browser.mjs` → **119 passed, 0 failed** (in `.scratch/dev` before deploy).
418. - Deploy 2026-09-24: backup + before/after API dumps in `.scratch/` (see `deploy-004.sh`).
420. Known gaps: a body that passes jsoncheck but that hl JSON.parse still refuses would 500
421. (none known besides surrogates). Nested list indentation is dropped. A wrapped line that
422. happens to start with `12. ` is taken as a list item (same as Markdown).
424. ## 2026-09-24 — ticket #10 (mission 002): strict API, Vienna time, paragraph import — awaiting creator
426. Done (worker, not yet confirmed by the creator):
427. - **Strict API** (`bodyError` in `api.hl`): every POST body must be a JSON object; unknown
428. field / missing or empty required field / non-string value → 400 `{ error, field }`,
429. nothing written. Semantic refusals (state, project name) carry `field` too. `POST /api/projects` → 405.
430. - **Local time**: all shown times (pages + API `created`/`updated`/`when`) are Europe/Vienna
431. (`localtime.hl`, userland EU DST rule — hl:time has no time zones). Storage stays epoch ms.
432. - **Import**: `ticketfile.hl` joins hard-wrapped lines, blank line = new paragraph (`\n\n`).
433. - **One-off data fix** 2026-09-24 00:11: `tools/fix-import-summaries.hl` rewrote only `summary`
434. of #1–#5 (server stopped, backup `.scratch/storage-backup-20260924-001142`). Ids, states,
435. `updatedMs`, events unchanged — compared API dumps `.scratch/{before,after}-full-20260924-001142.json`.
436. - Gate: `node tests/browser.mjs` → **93 passed, 0 failed** (2026-09-24, run in a copy before deploy).
438. Known gaps: invalid JSON → 500 (no way to catch `JSON.parse` in Hybriel; nothing written).
439. `author` stays optional (defaults to `anonymous`). Vienna rule is correct from 1996 on only.
441. Running: dev server on :8350, PID in `server.pid`, log `server.log`, data `storage/mpackdb/`.
443. ## 2026-09-23 — MVP (AntColony ticket 0001, mission 001)
445. Done (worker, not yet confirmed by the creator):
446. - Data: projects, tickets (id, project, subject, summary, state, source, created, updated),
447. append-only events (created / comment / state, free-text `author`). Six states.
448. - Pages `/`, filters `/project/:p`, `/state/:s`, both; `/tickets/:id`; `/inbox`; new-ticket form.
449. - Live push of comments / state changes / new tickets to every open browser (web AND API writes).
450. - JSON API (list/get/create/comment/state/projects), import command (idempotent by file name).
451. - Dark WorldAPI tokens, accent #c586c0, danger #f44747; works at 390px and 1280px.
452. - Gate then: 57 passed.
454. ## How to verify
456. ```bash
457. cd /media/STORAGE/projects/tickets.worldapi.org
458. node tests/browser.mjs # the gate (see README "Test")
459. ps -eo pid,args | grep [h]l-browser-tier # must print nothing afterwards
460. curl -s http://127.0.0.1:8350/api/tickets | jq '.tickets[] | {project, ref, oldNumber, state, subject}'
461. curl -s -XPOST -d '{"text":"x","bogus":"1"}' http://127.0.0.1:8350/api/tickets/1/comments # → 400 naming bogus (nothing written)
462. curl -s -XPOST -d '{bad' http://127.0.0.1:8350/api/tickets/1/comments # → 400 invalid JSON at character 1
463. curl -si http://127.0.0.1:8350/tickets/38 | grep Location # → /projects/tickets.worldapi.org/5
464. node .scratch/checklive.mjs # read-only real-Chrome look at :8350: list/history times == Intl Vienna, #1/#2 summaries one paragraph
465. ```
466. Then open http://192.168.178.75:8350 in two browsers, comment in one, watch the other.
468. ## Open / next
470. - ~~No users~~ — done by ticket #7 (mission 011): creator-only confirm/reject via TICKETS_CREATOR_IDENTITY.
471. - Not deployed (Byrodin container, nginx vhost, DNS) — out of MVP scope.
472. - Project filter chips / datalist of a list page do not grow live when a NEW project appears
473. (a reload shows it); ticket rows do.
474. - No delete of tickets or comments; comments cannot be edited (only subject + summary, ticket #8).
475. - Keywords in comments (`/confirm`, `/reject`, …) are the scheduler's job, not implemented here.
476. - Hybriel limits met (worked around): no time zones in hl:time (localtime.hl), no catch for
477. JSON.parse (jsoncheck.hl → 400), JSON.parse refuses \u surrogate escapes, no list `concat()` (NotCallable), no string escapes ("\r" is 2 chars).
478. - Older Hybriel limits met (worked around): no string ordering / no list `sort()` (import sorts by
479. char codes). (mpackdb `*id` from 0 no longer matters: UUID keys since #38.)
481. ## Lessons
483. - (mission 012) hl:webex re-creates elements of a View when an `if` block before/around them
484. flips — including `script { src }`: the browser EXECUTES a re-inserted script again, and custom
485. elements lose their internal state (the selector forgets the chosen name). A plain script in a
486. View must be idempotent (guard per document) and must not hold element references.
488. - (mission 011) A called function's PARAMETER NAMED LIKE AN ENTRY of the object literal it is
489. called from reads that entry: `{ id = e.id author = nameOfUser(e.user) }` with
490. `nameOfUser = (id) => …` got the EVENT's id. Compute such calls before the literal, avoid
491. parameter names like `id` (Hybriel issue reported in mission 011).
492. - (mission 011) hl:mpackdb `update(key, rec)` on an `@id` table with a record WITHOUT `id`
493. stores it without the key: `fetch(key)` is null afterwards (the unique index still finds it)
494. and the next update fails `CorruptRecord`. Always pass the whole record with `id`.
495. - (mission 011) hl:webex cannot listen to a custom DOM event (`ident-login`): a plain script
496. (`login.js`) writes the value into a hidden input and fires `change`.
497. - (mission 011) A failed hl:fetch (connection refused) is an `Error` event; only a root
498. `on Error(e)` in the ENTRY file (project.hl) absorbs it — one in the imported users.hl did not.
499. - (mission 011) hl:webex ships every component member AND `session.user` to the browser:
500. keep the identity id out of members and out of the session (only on /you, on purpose).
501. - (mission 011) `rsync --exclude 'server.*'` also drops `plugins/*/server.hl` — anchor it (`/server.*`).
503. - Hybriel resolves RELATIVE file paths (mpackdb too) against the ENTRY SCRIPT's directory,
504. not the cwd: a tool in `tools/` must get an absolute `TICKETS_STORAGE`.
505. - Saving a `.hl` file reloads the running dev server (watcher): develop in a copy
506. (`.scratch/dev`, gate there), stop the server, then copy files in.
507. - `JSON.parse` of a JSON array gives a Hybrid with `.length`; of an object `.length` is null.
508. - A function route's request has `req.query` (parsed object); `req.path` carries NO query string.
509. - `emit client …` inside a function route (API) works: with an `audience` entry it fans out to
510. every admitted connection that has a listener mounted.
511. - A selector group in `styles.hl` must be ONE quoted key (`'input,\ntextarea' { … }`); a bare
512. `input, textarea` is a parse error.
513. - Function PARAMETERS are immutable in Hybriel (`i = i + 1` on a param is a runtime error):
514. copy into a `let` first (jsoncheck.hl).
515. - `google-chrome` is not on PATH on Loreana; the gate uses `/opt/google/chrome/chrome`.
516. - Opening an hl:mpackdb table REWRITES its index/meta files (`*.txt`, `*.meta.json`,
517. `*.idxstate.json`) even with `compact = false`; only `.mpack` stays. Migrate from a COPY
518. when the originals must stay byte-identical (deploy-008.sh does).
519. - mpackdb `@id` keys are 12-char strings (`0mufbphip3w7`); a missing indexed field is fine
520. (`*oldNumber` on new tickets); `!path` unique index refuses duplicate numbers.
521. - A non-literal `static` in project.hl reads null in function routes (hybriel #16): API helpers
522. in project.hl are plain members, not statics.
524. ## 2026-09-24 — DEPLOYED (architect)
525. - LIVE is now https://tickets.worldapi.org on Byrodin (/CONTAINERS/projects/tickets.worldapi.org). The live data was moved there.
526. - This Loreana folder is DEVELOPMENT only; its storage/ is a stale copy. Dev servers were stopped. Update live with ./deploy.sh.
528. ## 2026-09-24 — ticket #16: tidy relations block out of the edit handlers — awaiting creator
530. Done (worker, not yet confirmed by the creator):
531. - `components/ticket.hl`: the relations init block (`rel`, `hasRelations`, `hasParent`, …,
532. `parentDraft`, `blockerDraft`, `linkMessage` — 16 lines) had been pasted verbatim into
533. `startEdit`, `cancelEdit` and `saveEdit` too (ticket #4 code landing inside the ticket #8 edit
534. handlers). Removed the three copies; the component's own init block (still there) is the only
535. place that sets them. No behaviour change intended — clicking Edit/Cancel/Save no longer resets
536. `parentDraft`/`blockerDraft`/`linkMessage` mid-edit, which was a side effect of the paste, not a
537. feature. 489 → 441 lines.
538. - Gate: `node tests/browser.mjs` → **418 passed, 0 failed**, run on this folder with
539. `TICKETS_GATE_PORT=8700 TICKETS_GATE_IDENT_PORT=8701 TICKETS_GATE_EXCHANGE_PORT=8702
540. TICKETS_GATE_CHROME_A=8703-8704 TICKETS_GATE_CHROME_B=8705-8706` (own storage in
541. `.scratch/gate-store`, own ident, no live data touched). Includes the full #4 relations suite
542. and #8 edit suite, both still green.
543. - Not deployed (deploy.sh is the architect's job).
545. Test: gate above, then open a ticket with relations on the live site and click Edit — the
546. relations panel keeps showing normally, editing subject/summary still works.