gitoria

3.6 KB

1. # gitoria.worldapi.org — concept
3. Git hosting for all projects, built in Hybriel (hl:webex), login via ident. Source of truth = the creator's words below.
5. ## The creator's first thoughts (ticket gitoria.worldapi.org#1, 2026-09-24, verbatim)
7. > Wildcard url: *.gitoria.worldapi.org
8. > a new repo needs a slug for that thats unique in the hole system.
9. > a repos / shows the README.md parsed to html, if there is a $docs folder it renders all md files inside that folder as a homepage
10. >
11. > /code shows the current state of their main branch (can be switched in settings)
12. > /branch/xy shows entire branch at last comit
13. > /commit/xy shows entire project at that commit
14. > /tickets implements the ticketlist view of tickets.worldapi.org, the moment one ticket is created the project is created in tickets.worldapi.org - when a user loggs in to tickets.worldapi.org they see all tickets of a gitoria project like its a tickets project.
15. > /pulls commits starting with `|||PR ` create a pull request using the branch title the main target for PRS can be configured in settings and is main by default `|||PR|name-of-branch] ` at the beginning of a commit sets a target branch
16. > /releases a commit starting with `|||RL ` creates a semver release by default it counts up the last one 0.0.1 `|||RL|med ` counts up the middle number 0.1.0 and `|||RL|mj ` the major version 1.0.1 with `|||RL|1.1.1a ` the version can be set manually
18. Earlier (chat, 2026-09-23/24): "i use ident login to login to ticktes and gitoria. i host the code in gitoria and use tickets
19. to manage their tasks." · "deploy.sh yes, until gitoria does it automatically".
21. ## Structure (architect's reading of the above — the quotes count)
22. - **A repo** = a unique slug (unique in the whole system) → reachable at `https://<slug>.gitoria.worldapi.org`.
23. - **`/`** = the repo's README.md rendered as HTML; if the repo has a `$docs` folder, all its Markdown files form the homepage.
24. - **`/code`** = the main branch now (which branch is "main" is a repo setting). **`/branch/<name>`** = a branch at its last
25. commit. **`/commit/<id>`** = the whole project at that commit.
26. - **`/tickets`** = the tickets list of tickets.worldapi.org for this repo; the tickets project is created with the first
27. ticket; in tickets.worldapi.org a gitoria project appears like any tickets project.
28. - **`/pulls`**: a commit message starting `|||PR ` opens a pull request (title = branch title) into the default target
29. (repo setting, default `main`); `|||PR|<branch>] ` sets the target.
30. - **`/releases`**: a commit message starting `|||RL ` creates a semver release, patch +1 by default; `|||RL|med ` minor +1,
31. `|||RL|mj ` major +1, `|||RL|<version> ` sets it explicitly.
32. - Existing research: `docs/differ-from-custom-ide.md` (the diff logic is reusable) — shared components live in
33. layouts.worldapi.org (creator).
35. ## Open — not decided by the creator yet (a worker must not invent these)
36. - ~~How code gets in and out~~ — decided (gitoria#5): "the dev can use ssh keys or the git http credentials if thats not deprecated by git itself". How to do it in Hybriel: research ticket gitoria#5.
37. - Who may create repos; public / private repos; who may push.
38. - Merging pull requests: where and by whom.
39. - What a release contains besides the version (tag only? downloadable archive?).
40. - The 4 old repos rescued from the previous gitoria (byrodin `/CONTAINERS/projects/gitoria.worldapi.org/repos-rescued-2026-09-24/`):
41. import them or not.
43. ## Old gitoria (Byrodin, hybrilior) — 2026-09-24
44. The old container is removed. It hosted 4 bare repos (hybrilior, misant, mpackdb, bsondb); rescued to
45. byrodin:/CONTAINERS/projects/gitoria.worldapi.org/repos-rescued-2026-09-24/.