Decomposer produced 9 stories under docs/work/2026-05-14-ci- security-and-supply-chain/, ordered to land the schema foundation first and the cross-referencing content (reviewer prompt, guide) last: 01 - trace schema extensions (socketRisk + lastRevalidated) 02 - Socket integration (skill + CI) 03 - Renovate adoption 04 - major-bump re-evaluation flow 05 - trace revalidation workflow 06 - CodeQL + audit signatures 07 - gitleaks pre-commit 08 - reviewer prompt update 09 - CI security guide + docs Also fixes a one-char status typo in the PRD frontmatter (\`appoved\` -> \`approved\`) that landed with the decompose run. Anchored by ADR-023 + the approved PRD at docs/work/prds/2026-05-14-ci-security-and-supply-chain.prd.md. Sequencing: depends on stories 01/02/04/06 of the in-flight library-evaluation epic landing first.
2.7 KiB
2.7 KiB
id, epic, title, type, status, feature, depends-on, blocks
| id | epic | title | type | status | feature | depends-on | blocks | |
|---|---|---|---|---|---|---|---|---|
| 03-renovate-adoption | 2026-05-14-ci-security-and-supply-chain | Renovate adoption | technical-story | todo | tooling |
|
Goal
Ship .github/renovate.json configuring automated dependency management: grouped per-ecosystem npm bumps, Dockerfile base-image tracking, GitHub Actions SHA pinning, automerge for green minor+patch PRs, and a single dependency dashboard issue.
Why
Major-tag pinning for GitHub Actions is documented insecure — the 2025 tj-actions/changed-files incident proved it. Renovate's pinGitHubActionDigests preset automates the one-time SHA-pin sweep and keeps SHAs current thereafter. Grouping ecosystem clusters (Sentry, OTel, tRPC, Payload, Inversify) into weekly PRs prevents noise while ensuring drift is surfaced. Automerge on green minor+patch PRs removes human toil for routine bumps.
Done when
.github/renovate.jsonexists and is valid JSON, extending presets:config:base,helpers:pinGitHubActionDigests,:separateMajorReleases,:automergeMinor,:automergePatch.packageRulesgroups@sentry/*,@opentelemetry/*,@trpc/*,payload*, andinversify*into per-cluster weekly PRs.- Dockerfile manager is enabled for
.sandcastle/Dockerfile. dependencyDashboard: trueis set (opens a single Renovate-managed issue summarising open + queued PRs, labeledrenovate/dashboardper PRD Q6).- Renovate's bump commits use
chore(deps):(minor/patch) andchore(deps-major):(major) commit-message prefixes so release-please's per-package bump rules apply cleanly. pnpm typecheck && pnpm lint && pnpm test && pnpm conformance && pnpm fallow:audit && pnpm coverage:diffall pass (no executable code change; JSON config only).
In scope
.github/renovate.json— full Renovate configuration.
Out of scope
- Verifying the first Renovate PR (SHA-pin sweep) — that happens when the GitHub App runs, not at commit time. The success criterion (all
@v<N>pins rewritten to SHAs) is verified when Renovate's first PR merges. - Renovate Dependency Dashboard →
docs/work/task integration — explicitly out of scope in the PRD.
Tasks
- Create
.github/renovate.jsonextending presetsconfig:base,helpers:pinGitHubActionDigests,:separateMajorReleases,:automergeMinor,:automergePatch; addpackageRulesgrouping@sentry/*,@opentelemetry/*,@trpc/*,payload*,inversify*into weekly per-cluster PRs; enable Dockerfile manager for.sandcastle/Dockerfile; setdependencyDashboard: true; setcommitMessagePrefixto enforcechore(deps):/chore(deps-major):per Conventional Commits; one commit, all gates pass.