antcolony

3.2 KB

1. ## Conventions for all apps — already decided by the creator, don't ask about them
2. (Copy of byrodin:/CONTAINERS/projects/antcolony/README.md "Conventions for all apps" + "Design: colors", 2026-09-24 — keep in step.)
3. - Primary keys: mpackdb UUID (`@id`), never `*id` counters; numbers a human sees are separate fields.
4. - Database files: always `storage/mpackdb/`.
5. - **Shared components** (editor, differ, comments, design tokens) live in **layouts.worldapi.org**.
6. - Data formats: JSON for API writes (strictly validated), Markdown inside text fields, a Markdown read view
7. (`Accept: text/markdown`) for LLM readers.
8. - Colours: the VS Code Dark+ tokens of layouts.worldapi.org `css/foundation/tokens.css`; every app sets one
9. `--color-accent`, components use only the semantic tokens — no own colours per component or mode.
10. - Ticket texts are written for the creator: short, plain words, what is done / what to do first — no code names,
11. file paths, ticket jargon or test counts unless needed to test. Your `result` and `test` ARE that text.
13. - **Build it properly, never a shortcut with side effects.** If the proper way needs something that is missing, build that too, or stop and say so — never ship a shortcut and then ask the creator about its side effects. Never ask the creator about internal implementation details; decide them. (creator, 2026-09-24, about ident#17: "i am molested with such a dumb useless question of an obviously shit as fuck implementation")
15. ## No hand-written JavaScript (creator 2026-09-25: "these asshole components bypass the entire system and write fucking javascript files!!!!!")
16. - Everything is written in **Hybriel** (hl:web components, faces, plugins). No `.js` file of your own — not as a "bridge",
17. not "just for the browser part", not for offline, not for a service worker.
18. - If Hybriel cannot do something you need: STOP that part, report it in `issues` as a Hybriel gap (what, a minimal repro)
19. and in `open`. The architect files it for Anton; the part waits for the fix. A JS workaround is a failed ticket.
20. - Existing `.js` in a project is not a precedent; only the architect may name an exception, in the brief.
21. - **Allowed: bridges to EXTERNAL components** (creator 2026-09-27: "login.js is correct, as thats for externals in general").
22. A small `.js` whose only job is to connect a component from OUTSIDE the app (e.g. ident's `<ident-selector>`) to the
23. Hybriel shell is fine. The login is always calendar's: copy `login.js` + the header from calendar.worldapi.org
24. (`components/main.hl`, `users.hl`, the login routes in `project.hl`) — never write your own login JS.
26. ## A component carries its own styles (creator 2026-09-25: "all componets have no styles")
27. - A reusable component (components.hybriel.worldapi.org, and any component meant to be copied) has its own `Style` in its
28. file, scoped to it, using the shared WorldAPI tokens. The site's/app's global styles.hl holds only its own page layout.
30. ## No patches to the vendored framework (2026-09-25, calendar#6 patched plugins/web for Accept-Language)
31. - Never change files under `plugins/` or `bin/` of an app. They are Hybriel, copied from master. A missing feature is a
32. Hybriel gap: stop that part and report it (the architect files it for Anton), exactly as with JavaScript.