This project treats npm install-time execution as a supply-chain risk.
- Use
npm ci --ignore-scriptsfor clean installs. - Keep
package-lock.jsoncommitted. - Keep direct dependency versions pinned exactly in
package.json. - Do not add dependencies casually; prefer local code for small utilities.
- Review any package that requires
preinstall,install,postinstall, orprepare.
The repo-level .npmrc sets ignore-scripts=true, so dependency lifecycle scripts are disabled by default. Explicit npm run ... commands still run the project scripts you invoke directly.
The current tree includes esbuild, which declares a postinstall script in its package metadata. The clean bootstrap is validated with lifecycle scripts disabled so this package cannot execute during install.
npm ci --ignore-scripts
npm test
npm run buildRun npm audit as a vulnerability signal, not as proof that the dependency tree is safe from newly compromised packages.
Workflow actions are pinned to full commit SHAs. Refresh those pins deliberately during release maintenance rather than using moving refs such as tags or branch names.
Dependabot is configured for GitHub Actions and npm update PRs. Treat those PRs as prompts for review, not automatic approval.
- Keep Dependabot as the single update bot for now; do not add Renovate unless we need policy features Dependabot cannot cover.
- Merge dependency PRs only after the repo checks pass and the update matches the current runtime/tooling baseline.
- Major
@types/nodeupdates are intentionally ignored while CI and local scripts target Node 22. - Major
vitestupdates are intentionally ignored until we do a deliberate test-runner migration pass. - Prefer small, separate update PRs over broad grouped changes so any failure has an obvious cause.
Card debug logs are opt-in through debug: true or the documented localStorage flag. They avoid tokens and raw recorder rows, but may include entity IDs, value ranges, bucket counts, and timing data. Do not leave debug enabled when sharing browser console output from a private Home Assistant instance.