Commit 370524d
docs(agents): qualify line 8's DB-column item — control plane vs. the metadata tables (#13431)
`AGENTS.md:8` presents `environment_id` as one of five flagship surfaces of the
v5.0 `project` -> `environment` rename, closing with "No aliases." Measured on
`origin/main`, that item is under-qualified in BOTH directions, and the two
errors point opposite ways:
* On the METADATA tables the column is retired. `sys_metadata` still declares
it, but only as a deprecated nullable legacy column that no writer writes
and the uniqueness discriminator excludes; `sys_metadata_history` dropped it
from its declaration outright in the ADR-0008 SS0 branch/project-removal
amendment. A reader taking line 8 at face value learns to write
`environment_id` into new metadata rows; the spec's own describe() strings
say new code must use `organization_id` only.
* On the CONTROL PLANE the column is fully live and enforced.
`sys_environment_member` is keyed `(environment_id, user_id)` and the
runtime HTTP dispatcher filters on it for the per-project membership 403
gate. So a flat "since deprecated" qualification -- or dropping the item --
would teach the opposite error.
The edit therefore carries the SCOPE rather than a single verdict, in place and
line-neutral. The v5.0 rename statement is untouched: the rename happened, and
the deprecation sits on a later and different axis (environment -> organization,
not project -> environment).
Line-neutral by construction and measured: AGENTS.md stays at 1162 lines
(ceiling 1162, headroom 0) and the widest table row stays 1081 bytes at L720
(pin 1081, headroom 0) -- line 8 is a blockquote, not a table row, so neither
byte ratchet meters it, and the gate's own `scanLineLengths` reports 0 offenders
with line 8 classified `blockquote`.
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>1 parent 94a588a commit 370524d
1 file changed
Lines changed: 1 addition & 1 deletion
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
5 | 5 | | |
6 | 6 | | |
7 | 7 | | |
8 | | - | |
| 8 | + | |
9 | 9 | | |
10 | 10 | | |
11 | 11 | | |
| |||
0 commit comments