## Secrets (SOPS + age) Secrets live encrypted in `secrets/*.enc.yaml`. The decryption key is on the developer's machine, outside this repository. You may USE secrets; you must never SEE them. Do: - Run anything that needs secrets through `node scripts/secret.mjs run -- `. Example: `node scripts/secret.mjs run -- npm run test:integration` - Use `node scripts/secret.mjs list` to see which secret names exist (it never prints values). - If a secret is missing or wrong, stop and ask the developer to run `node scripts/secret.mjs set ` themselves. Tell them the name; never ask for the value. Never: - Run `sops` directly, or `node scripts/secret.mjs get|set|unset|edit`. - Print environment variables (`env`, `printenv`, `echo $VAR`, `console.log(process.env)`). - Read the age key file (`keys.txt`) or anything under `~/.config/sops`, `~/Library/Application Support/sops`, or `%AppData%\sops`. - Write decrypted values to a file, log, commit, test fixture, or chat message. - Hard-code a secret value in code, even temporarily. - Edit `secrets/*.enc.yaml` or `.sops.yaml` by hand. If you see a secret value in any output, stop, tell the developer which value it was, and do not repeat it. It must be rotated.