docs: qualify workspace decision ids cited from this repo
Decision ids are per-vault sequences, so they collide by construction once there is more than one vault -- and every repo now has one. A bare D-15 here will mean this repo's D-15 the moment this repo records one. Cross-vault references are therefore qualified: workspace D-15. Not hypothetical: pql holds D-1 through D-31 while the workspace holds D-1 through D-21, so every workspace id currently collides with an unrelated pql one. A bare id is not wrong the day it is written -- it decays into wrong as the other vault grows, and nothing flags it. Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -5,7 +5,7 @@ mirroring to Gitea, cleanup and retention, and arbitrary REST calls on a cron. P
|
||||
FastAPI, APScheduler, PostgreSQL and Redis. Container `scheduler` on `docker-dataplane`,
|
||||
port **8090**, Redis DB **3**, Postgres DB **scheduler**.
|
||||
|
||||
It is the homelab's cron. Recurring work belongs here rather than in a systemd timer (D-5).
|
||||
It is the homelab's cron. Recurring work belongs here rather than in a systemd timer (workspace D-5).
|
||||
|
||||
## Live contract
|
||||
|
||||
@@ -115,7 +115,7 @@ tagging.
|
||||
|
||||
Work lives in **pql**, not a markdown TODO. **This repo's vault is standalone** — its tickets
|
||||
and its internal decisions live here in `.pql/` and `governance/`, and travel with a clone,
|
||||
because `.pql/changelog/` is committed and replayed by the git hooks (D-15). The databases are
|
||||
because `.pql/changelog/` is committed and replayed by the git hooks (workspace D-15). The databases are
|
||||
gitignored and rebuildable with `pql plan rebuild`.
|
||||
|
||||
`pql` is **not** on the non-interactive `PATH` — invoke it as `/home/jpmschweitzer/.local/bin/pql`.
|
||||
@@ -129,7 +129,7 @@ is this repo.
|
||||
```
|
||||
|
||||
Stack-level decisions that constrain this service — the host, the network, deploy mechanics,
|
||||
and the fact that recurring work belongs here at all (D-5) — live in the **workspace** vault
|
||||
and the fact that recurring work belongs here at all (workspace D-5) — live in the **workspace** vault
|
||||
and need the flag:
|
||||
|
||||
```bash
|
||||
|
||||
Reference in New Issue
Block a user