steid

docs: runbook named routes that no longer exist

/setup and /login moved under /auth/ when routes were grouped, and the
runbook still told you to visit the old paths -- the precise failure its own
header warns about, since following it would 404.

Also corrects STEID_DATA_DIR's milestone after the reorder, and the disk
layout section now uses the real {handle}/{name} vocabulary rather than
attempt #2's {org}/{repo}.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

JamesPatrickGill authored 24 days agoparentca76e1bBrowse files1a58e0016efbddb75cc5574e246c2bb04419581c

1 file changed+8 −7

plans/runbook.md+8 −7View file

		@@ -41,7 +41,7 @@ Live now:
41	41
42	42	```
43	43	STEID_DATABASE_URL=sqlite:steid.db?mode=rwc # default
44		−STEID_DATA_DIR=./data # default; bare repos, used from M4
	44	+STEID_DATA_DIR=./data # default; bare repos, used from M3
45	45	STEID_INSECURE_COOKIES=false # default; see below
46	46	```
47	47
		@@ -84,19 +84,20 @@ A gitignored `.env` in the repo root sets it for local work. Keep `.env` and
84	84	cargo run # or: topcoat dev
85	85	```
86	86
87		−An unclaimed instance prints a setup token and redirects every route to `/setup`.
	87	+An unclaimed instance prints a setup token and redirects every route to `/auth/setup`.
88	88	Paste the token, choose a handle, email, and password, and the owner is created and
89	89	signed in.
90	90
91	91	The token is held in memory only, so every restart mints a new one — including
92	92	each rebuild under `topcoat dev`. Use the most recent one printed. Once claimed, no
93		−token is minted at all and `/setup` redirects away.
	93	+token is minted at all and `/auth/setup` redirects away.
94	94
95		−Sign in at `/login` with the email, not the handle.
	95	+Sign in at `/auth/login` with the email, not the handle.
96	96
97		−## Repo layout on disk (#2)
	97	+## Repo layout on disk (Milestone 3)
98	98
99		−Bare repos at `{STEID_DATA_DIR}/{org}/{repo}.git`. Created empty — no initial commit.
	99	+Bare repos at `{STEID_DATA_DIR}/{handle}/{name}.git`. Created empty — no initial
	100	+commit, like GitHub.
100	101
101	102	## Git transport (Milestone 4)
102	103
		@@ -105,7 +106,7 @@ over HTTP Basic — see [0001](decisions/0001-git-over-http-not-ssh.md). No SSH,
105	106	keys, no `authorized_keys`.
106	107
107	108	```bash
108		−git clone http://host/owner/repo.git
	109	+git clone http://host/{handle}/repos/{name}.git
109	110	```
110	111
111	112	Fill in the token workflow and the `body_limit` setting once this is built.