docs: correct the vault policy, and qualify workspace decision ids
This repo's Work tracking section still described the reversed policy -- that tickets and decisions live in the workspace vault and this repo's trees stay empty. That was overturned the same day: repo vaults are standalone and a repo's work travels with a clone, because the changelog is committed. Every other repo was corrected at the time; this one was missed because the search for the offending phrase used a fixed string and the phrase happened to wrap across a line break here. Worth noting as a search failure rather than a writing one -- five files were checked, four matched, and the fifth was reported clean. Decision ids are also qualified now. They are per-vault sequences, so a bare D-15 here will mean this repo's D-15 the moment this repo records one; pql already holds D-1 through D-31 against the workspace's D-1 through D-21, all of them unrelated. Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -125,24 +125,31 @@ pytest and ruff only run locally or on request. Verify tests pass before tagging
|
|||||||
|
|
||||||
## Work tracking
|
## Work tracking
|
||||||
|
|
||||||
Work lives in **pql**, not a markdown TODO or `docs/COVERAGE.md`. Tickets *and* decisions for
|
Work lives in **pql**, not a markdown TODO or `docs/COVERAGE.md`. **This repo's vault is
|
||||||
this repo live in the **workspace** vault; this repo's `.pql/` and `governance/` trees stay
|
standalone** — its tickets and its internal decisions live here in `.pql/` and `governance/`,
|
||||||
empty (D-15).
|
and travel with a clone, because `.pql/changelog/` is committed and replayed by the git hooks
|
||||||
|
(workspace D-15). The databases are gitignored and rebuildable with `pql plan rebuild`.
|
||||||
|
|
||||||
Two things must be spelled out on every invocation from in here, and each fails differently:
|
`pql` is **not** on the non-interactive `PATH` — invoke it as
|
||||||
|
`/home/jpmschweitzer/.local/bin/pql`. From inside this repo no `--vault` is needed: pql anchors
|
||||||
|
at the nearest `.git/` ancestor, which is this repo.
|
||||||
|
|
||||||
- **`pql` is not on the non-interactive `PATH`** — use `/home/jpmschweitzer/.local/bin/pql`.
|
```bash
|
||||||
- **`--vault /mnt/media/Projects` is mandatory.** pql anchors a vault at the nearest `.git/`
|
/home/jpmschweitzer/.local/bin/pql ticket list # this repo's open work
|
||||||
ancestor, and this repo is one, so a bare call resolves to *this repo's* empty vault. Reads
|
/home/jpmschweitzer/.local/bin/pql plan whatsnext # next unblocked item, with context
|
||||||
return nothing; a **write** creates a stray vault and starts ticket ids at T-1, colliding
|
/home/jpmschweitzer/.local/bin/pql decisions list # this repo's own decisions
|
||||||
with the real ones.
|
```
|
||||||
|
|
||||||
|
Stack-level decisions that constrain this service live in the **workspace** vault and need the
|
||||||
|
flag:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
/home/jpmschweitzer/.local/bin/pql --vault /mnt/media/Projects ticket list
|
|
||||||
/home/jpmschweitzer/.local/bin/pql --vault /mnt/media/Projects plan whatsnext
|
|
||||||
/home/jpmschweitzer/.local/bin/pql --vault /mnt/media/Projects decisions list --domain webber
|
/home/jpmschweitzer/.local/bin/pql --vault /mnt/media/Projects decisions list --domain webber
|
||||||
```
|
```
|
||||||
|
|
||||||
|
Note `ticket new --decision D-N` resolves ids within **one** vault, so a ticket here cannot link
|
||||||
|
to a workspace decision. Cite the id in the ticket body instead.
|
||||||
|
|
||||||
Do not add a TODO section to a markdown file.
|
Do not add a TODO section to a markdown file.
|
||||||
|
|
||||||
## Git
|
## Git
|
||||||
|
|||||||
Reference in New Issue
Block a user