| Filename | Latest commit message | Latest commit date |
|---|---|---|
ADR 0044, step 2 (D1, D2, D11, D13, and D15 to D17, decided today). halkyon_base keeps the spaces several people share, for every app: shared_space, its members with their roles (Owner, Editor, Viewer), and invitations by handle waiting for someone with no account on the service yet. The sharedSpace endpoint creates a space, lists its members, invites by handle, changes roles, removes members, hands the space on, leaves and deletes it. Who may do what: - Only people with an identity reach the endpoint. - A space the caller isn't in can't be told from one that doesn't exist. - Members are named by their membership, never by their account's ID. - Only the Owner manages the members, unless the space lets members invite. - The Owner's role passes only by handing the space on, and the Owner leaves only naming who takes it on. - An invitation counts as an answer about a handle, as it tells whether one exists. Every rule has a test asserting the refusal. The module stays free of the sync engine: a host hands it a SpaceGrants, and every call runs in the module's transaction, so the engine's grants follow the roles or nothing changes. The Owner and an Editor write; a Viewer reads. Learn hands over SyncSpaceGrants on OfflineSyncSpaces. Todo hands over none yet, so its server refuses until its projects are shared. Deleting an account hands each space the person owns to the Editor who joined first, else the Viewer who joined first. A space with no other member goes. This runs before the host's own deletions. A person's first sign-in on a service makes their waiting invitations memberships, in the same transaction that makes them a person there. Migrations: the module's and every host's (Learn, Todo, Train, Meditate) create the three tables, their indexes and the two cascading foreign keys to shared_space, and nothing else. The old server keeps working. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Tizian 「ティツィアーン」 <raisondetredev@pm.me> |
||
| .. | ||
| halkyon_todo_client | ||
| halkyon_todo_flutter | ||
| halkyon_todo_server | ||
| snap | ||
| tool | ||
| .gitignore | ||
| AGENTS.md | ||
| CLAUDE.md | ||
| README.md | ||
| release.dart | ||
Halkyon Todo
To-dos, as a Halkyon app: for now a shell on the shared packages. People choose an instance, sign in (with SimpleLogin or a password), switch between the accounts on their devices, sign out and delete their account; the home is empty until Todo's first model.
| Package | What it is |
|---|---|
halkyon_todo_server |
The server: Serverpod with the halkyon_base module |
halkyon_todo_client |
Its client, generated by Serverpod |
halkyon_todo_flutter |
The app, on halkyon_app and halkyon_ui (Android, iOS, Linux, macOS, Windows) |
Run it with serverpod start in halkyon_todo_server, which starts the server (and its
embedded PostgreSQL) and the app; or the app alone against an instance with
flutter run --dart-define=SERVER_URL=https://…/ in halkyon_todo_flutter. Tests:
dart run melos run test:dart --scope=halkyon_todo_server and
dart run melos run test:flutter --scope=halkyon_todo_flutter at the repository's
root, or dart run tool/check.dart for everything.
The app's icon is Lucide's list-todo (ISC licence, ADR 0031),
drawn by the repository's tool/app_icons.py. Licences: the server under the SSPL, the client and the app under
the AGPL (LICENSE.md).