halkyon/apps/todo/AGENTS.md

# Halkyon Todo

What holds for every app and package of this repository is in the [root AGENTS.md](../../AGENTS.md); it applies here in full.

- **Still Serverpod's scaffold** (`serverpod create`, joined the repository on 2026-10-19, ADR 0015): `halkyon_todo_server`, `halkyon_todo_client` (generated, never edited) and `halkyon_todo_flutter`, with the template's greeting endpoint and screens. Since joining: Serverpod 4.0.4 and Dart 3.13 like every package, server-side sessions (`ServerSideSessionsConfigFromPasswords`, 90 days unused), Serverpod's own email-and-password sign-in still, `google_fonts` gone (it fetches fonts, which Halkyon never does), and the scaffold's lints (`lints`, `flutter_lints`) rather than the root's.
- **To be built on the shared packages**, as Learn is: `halkyon_base` for signing in, the account and the instance's basics (its server configured with `HalkyonBase.configure` and an app id of its own, which never changes once apps use it), `halkyon_app` for the instances, sign-in, the gates and sync, `halkyon_ui` for the look (`packages/*/README.md`). What it keeps and syncs, and which of Learn's rules it adopts, the developer decides first.
- **`serverpod start`** runs in `apps/todo/halkyon_todo_server`; `.mcp.json`'s `--server-dir` names it when a session works on Todo. Its tests need throwaway passwords in its git-ignored `config/passwords.yaml` (`database`, `serviceSecret`, `serverSideSessionKeyHashPepper`) or from the environment, as CI gives them.
docs: one repository for every app and shared package (ADR 0015) The root AGENTS.md holds what applies to every app and package (how work is done, Serverpod, checks with Melos and the tools, CI); Learn's own is apps/learn/AGENTS.md, Todo's a note that it is still the scaffold. The root README introduces the project, Learn's moves to its folder; LICENSE.md says which licence covers which directory, Todo's packages unlicensed until decided; one CONTRIBUTING.md. ADR 0015 records the decision; ADR 0014 and 0003 note what moved. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Tizian 「ティツィアーン」 <raisondetredev@pm.me> 2026-10-19 20:39:09 +02:00			`# Halkyon Todo`
chore: Halkyon Todo's scaffold joins the repository in apps/todo Its server, client and app as `serverpod create` made them, with the switch to server-side sessions that was waiting uncommitted, as files: its one commit holds the scaffold alone. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Tizian 「ティツィアーン」 <raisondetredev@pm.me> 2026-10-19 20:08:27 +02:00
docs: one repository for every app and shared package (ADR 0015) The root AGENTS.md holds what applies to every app and package (how work is done, Serverpod, checks with Melos and the tools, CI); Learn's own is apps/learn/AGENTS.md, Todo's a note that it is still the scaffold. The root README introduces the project, Learn's moves to its folder; LICENSE.md says which licence covers which directory, Todo's packages unlicensed until decided; one CONTRIBUTING.md. ADR 0015 records the decision; ADR 0014 and 0003 note what moved. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Tizian 「ティツィアーン」 <raisondetredev@pm.me> 2026-10-19 20:39:09 +02:00			`What holds for every app and package of this repository is in the [root AGENTS.md](../../AGENTS.md); it applies here in full.`
chore: Halkyon Todo's scaffold joins the repository in apps/todo Its server, client and app as `serverpod create` made them, with the switch to server-side sessions that was waiting uncommitted, as files: its one commit holds the scaffold alone. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Tizian 「ティツィアーン」 <raisondetredev@pm.me> 2026-10-19 20:08:27 +02:00
docs: one repository for every app and shared package (ADR 0015) The root AGENTS.md holds what applies to every app and package (how work is done, Serverpod, checks with Melos and the tools, CI); Learn's own is apps/learn/AGENTS.md, Todo's a note that it is still the scaffold. The root README introduces the project, Learn's moves to its folder; LICENSE.md says which licence covers which directory, Todo's packages unlicensed until decided; one CONTRIBUTING.md. ADR 0015 records the decision; ADR 0014 and 0003 note what moved. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Signed-off-by: Tizian 「ティツィアーン」 <raisondetredev@pm.me> 2026-10-19 20:39:09 +02:00			- Still Serverpod's scaffold (`serverpod create`, joined the repository on 2026-10-19, ADR 0015): `halkyon_todo_server`, `halkyon_todo_client` (generated, never edited) and `halkyon_todo_flutter`, with the template's greeting endpoint and screens. Since joining: Serverpod 4.0.4 and Dart 3.13 like every package, server-side sessions (`ServerSideSessionsConfigFromPasswords`, 90 days unused), Serverpod's own email-and-password sign-in still, `google_fonts` gone (it fetches fonts, which Halkyon never does), and the scaffold's lints (`lints`, `flutter_lints`) rather than the root's.
			- To be built on the shared packages, as Learn is: `halkyon_base` for signing in, the account and the instance's basics (its server configured with `HalkyonBase.configure` and an app id of its own, which never changes once apps use it), `halkyon_app` for the instances, sign-in, the gates and sync, `halkyon_ui` for the look (`packages/*/README.md`). What it keeps and syncs, and which of Learn's rules it adopts, the developer decides first.
			- `serverpod start` runs in `apps/todo/halkyon_todo_server`; `.mcp.json`'s `--server-dir` names it when a session works on Todo. Its tests need throwaway passwords in its git-ignored `config/passwords.yaml` (`database`, `serviceSecret`, `serverSideSessionKeyHashPepper`) or from the environment, as CI gives them.