chore(deps): add Forgejo Renovate setup #682

Merged

pdurlej merged 1 commit from codex/667-renovate-forgejo into main 2026-06-02 11:17:46 +02:00

Conversation 2 Commits 1 Files changed 7 +356 -3

codex commented 2026-06-02 08:59:56 +02:00

Collaborator

Copy link

Canary status: missing — fire canary 3+3 manually before merge

Summary

Adds the first Forgejo-native Renovate setup for pdurlej/platform so dependency drift becomes scheduled PRs instead of manual surprise audits.

What changed

• Added renovate.json with repo policy for Docker, Python, uv lockfiles, Dockerfiles, Forgejo/GitHub Actions, and custom regex parsing for compose ${*_IMAGE:-image:tag} defaults.
• Added .forgejo/workflows/renovate.yml to run self-hosted Renovate weekly and on manual dispatch against pdurlej/platform using RENOVATE_PLATFORM=forgejo.
• Added runbooks/renovate.md with token requirements, coverage, first-run checklist, and runtime-apply boundaries.
• Linked Renovate from AGENTS.md and runbooks/module-update-flow.md.
• Marked the older custom auto-updates spec as superseded-for-v0-by-renovate rather than deleting it.
• Added tests for Renovate config/workflow invariants.

Canary Context Pack

Product story

The platform should stop discovering dependency drift only during manual sweeps. Renovate should open bounded, reviewable Forgejo PRs for repo-visible dependency updates while keeping runtime mutation behind existing review and apply gates.

What changed

This PR wires config-as-code and a scheduled Forgejo workflow for Renovate. It does not run Renovate live and does not create/update any secrets.

Why it changed

Issue #667 identified missing dependency automation as the root cause behind silent image drift, including PostgreSQL lagging behind security patch releases.

Files touched

• .forgejo/workflows/renovate.yml
• renovate.json
• runbooks/renovate.md
• runbooks/module-update-flow.md
• AGENTS.md
• docs/specs/platform-auto-updates-v0/README.md
• control-plane/platformctl/tests/test_renovate_config.py

Relevant context

• Issue #667
• Issue #669 remains the companion for runtime-only floating tags.
• Issue #668 remains the explicit PostgreSQL security update.
• Renovate official docs: self-hosting, Forgejo platform, custom regex managers, Docker updates/digest pinning.

Runtime evidence

No runtime mutation. No token creation. No live Renovate run.

Local validation:

cd control-plane && uv run pytest platformctl/tests/test_renovate_config.py
python3 control-plane/platformctl/ci/lint_workflows.py --policy .forgejo/ci-policy.yaml --workflows .forgejo/workflows --markdown /private/tmp/renovate-ci-lint.md --json /private/tmp/renovate-ci-lint.json
python3 -m json.tool renovate.json
PYTHONPATH=control-plane uv run --project control-plane python -m platformctl.cli validate all --json

Results:

• test_renovate_config.py: 3 passed
• Forgejo workflow lint: 0 findings
• renovate.json: parses
• platformctl validate all --json: exitCode 0

Known constraints

• First real Renovate run requires a Forgejo Actions RENOVATE_TOKEN for a non-operator Renovate bot identity.
• RENOVATE_GITHUB_COM_TOKEN is optional but recommended for changelog/upstream metadata rate limits.
• Runtime-only image vars in host env/Infisical are not fully repo-visible yet; #669 remains necessary for those seven floating tags.

Explicit out-of-scope

• No Renovate token creation.
• No live Renovate run.
• No auto-merge.
• No platformctl apply.
• No runtime image/env mutation.
• No PostgreSQL 16.14 bump; that stays in #668.

Requested decision

Merge if the self-hosted Renovate workflow/config and no-runtime-mutation boundary are acceptable.

Merge blockers

• Any workflow secret exposure under PR triggers.
• Any accidental auto-merge/runtime apply path.
• Any Renovate config shape that would not run on Forgejo.

Spec sources read

• Forgejo issue #667 — task scope and acceptance criteria.
• docs/specs/platform-auto-updates-v0/README.md and 01-plan.md — existing auto-update background.
• runbooks/module-update-flow.md — existing module update discipline.
• .forgejo/ci-policy.yaml and workflow examples — local Forgejo workflow policy.
• Official Renovate docs for Forgejo, self-hosted config, Docker updates, and regex custom managers.

Closes #667

Canary status: missing — fire canary 3+3 manually before merge ## Summary Adds the first Forgejo-native Renovate setup for `pdurlej/platform` so dependency drift becomes scheduled PRs instead of manual surprise audits. ## What changed - Added `renovate.json` with repo policy for Docker, Python, uv lockfiles, Dockerfiles, Forgejo/GitHub Actions, and custom regex parsing for compose `${*_IMAGE:-image:tag}` defaults. - Added `.forgejo/workflows/renovate.yml` to run self-hosted Renovate weekly and on manual dispatch against `pdurlej/platform` using `RENOVATE_PLATFORM=forgejo`. - Added `runbooks/renovate.md` with token requirements, coverage, first-run checklist, and runtime-apply boundaries. - Linked Renovate from `AGENTS.md` and `runbooks/module-update-flow.md`. - Marked the older custom auto-updates spec as superseded-for-v0-by-renovate rather than deleting it. - Added tests for Renovate config/workflow invariants. ## Canary Context Pack ### Product story The platform should stop discovering dependency drift only during manual sweeps. Renovate should open bounded, reviewable Forgejo PRs for repo-visible dependency updates while keeping runtime mutation behind existing review and apply gates. ### What changed This PR wires config-as-code and a scheduled Forgejo workflow for Renovate. It does not run Renovate live and does not create/update any secrets. ### Why it changed Issue #667 identified missing dependency automation as the root cause behind silent image drift, including PostgreSQL lagging behind security patch releases. ### Files touched - `.forgejo/workflows/renovate.yml` - `renovate.json` - `runbooks/renovate.md` - `runbooks/module-update-flow.md` - `AGENTS.md` - `docs/specs/platform-auto-updates-v0/README.md` - `control-plane/platformctl/tests/test_renovate_config.py` ### Relevant context - Issue #667 - Issue #669 remains the companion for runtime-only floating tags. - Issue #668 remains the explicit PostgreSQL security update. - Renovate official docs: self-hosting, Forgejo platform, custom regex managers, Docker updates/digest pinning. ### Runtime evidence No runtime mutation. No token creation. No live Renovate run. Local validation: ```bash cd control-plane && uv run pytest platformctl/tests/test_renovate_config.py python3 control-plane/platformctl/ci/lint_workflows.py --policy .forgejo/ci-policy.yaml --workflows .forgejo/workflows --markdown /private/tmp/renovate-ci-lint.md --json /private/tmp/renovate-ci-lint.json python3 -m json.tool renovate.json PYTHONPATH=control-plane uv run --project control-plane python -m platformctl.cli validate all --json ``` Results: - `test_renovate_config.py`: 3 passed - Forgejo workflow lint: 0 findings - `renovate.json`: parses - `platformctl validate all --json`: exitCode 0 ### Known constraints - First real Renovate run requires a Forgejo Actions `RENOVATE_TOKEN` for a non-operator Renovate bot identity. - `RENOVATE_GITHUB_COM_TOKEN` is optional but recommended for changelog/upstream metadata rate limits. - Runtime-only image vars in host env/Infisical are not fully repo-visible yet; #669 remains necessary for those seven floating tags. ### Explicit out-of-scope - No Renovate token creation. - No live Renovate run. - No auto-merge. - No `platformctl apply`. - No runtime image/env mutation. - No PostgreSQL 16.14 bump; that stays in #668. ### Requested decision Merge if the self-hosted Renovate workflow/config and no-runtime-mutation boundary are acceptable. ### Merge blockers - Any workflow secret exposure under PR triggers. - Any accidental auto-merge/runtime apply path. - Any Renovate config shape that would not run on Forgejo. ## Spec sources read - Forgejo issue #667 — task scope and acceptance criteria. - `docs/specs/platform-auto-updates-v0/README.md` and `01-plan.md` — existing auto-update background. - `runbooks/module-update-flow.md` — existing module update discipline. - `.forgejo/ci-policy.yaml` and workflow examples — local Forgejo workflow policy. - Official Renovate docs for Forgejo, self-hosted config, Docker updates, and regex custom managers. Closes #667

codex added 1 commit 2026-06-02 08:59:56 +02:00

chore(deps): add Forgejo Renovate setup f099cefd9d

codex added the

class/security-sensitive

domain:ci

kind/ops

safety:no-prod-mutation

tier/full

labels 2026-06-02 09:00:21 +02:00

codex added this to the 10 - Improvements milestone 2026-06-02 09:00:22 +02:00

codex commented 2026-06-02 09:07:30 +02:00

Author

Collaborator

Copy link

Patchwarden PR sanity

• Status: eligible_sanity_clean
• PR: 682
• Commit: bc99925ecf25a736065b054e57de6bb089cdf031
• Security-sensitive label: present
• Authority: advisory model review plus deterministic blockers only
• 3+3 canary: still alive; this does not replace it

Deterministic findings

• info sensitive-path-touched Sensitive path touched — .forgejo/workflows/renovate.yml
  • Evidence: .forgejo/workflows/renovate.yml
  • Next: Route through the existing 3+3/risk-tier process; model review remains advisory.

Model reviewers

global-glm / glm-5.1:cloud

• Status: ok
• Verdict: OK
• Findings: none

global-deepseek / deepseek-v4-pro:cloud

• Status: ok
• Verdict: OK
• Findings: none

redteam / kimi-k2.6:cloud

• Status: error
• Verdict: -
• Note: ReadTimeout: The read operation timed out
• Findings: none

Policy notes

• GLM 5.1 + DeepSeek V4 Pro are the operator-required model mix for this bot.
• Optional red-team model is enabled only when PLATFORMCTL_PR_SANITY_REDTEAM_MODEL is configured.
• Auto-merge is not enabled here.

<!-- patchwarden-pr-sanity:pdurlej/platform:PR-682 --> # Patchwarden PR sanity - Status: `eligible_sanity_clean` - PR: `682` - Commit: `bc99925ecf25a736065b054e57de6bb089cdf031` - Security-sensitive label: `present` - Authority: advisory model review plus deterministic blockers only - 3+3 canary: still alive; this does not replace it ## Deterministic findings - **`info` `sensitive-path-touched`** Sensitive path touched — `.forgejo/workflows/renovate.yml` - Evidence: `.forgejo/workflows/renovate.yml` - Next: Route through the existing 3+3/risk-tier process; model review remains advisory. ## Model reviewers ### `global-glm` / `glm-5.1:cloud` - Status: `ok` - Verdict: `OK` - Findings: none ### `global-deepseek` / `deepseek-v4-pro:cloud` - Status: `ok` - Verdict: `OK` - Findings: none ### `redteam` / `kimi-k2.6:cloud` - Status: `error` - Verdict: `-` - Note: ReadTimeout: The read operation timed out - Findings: none ## Policy notes - GLM 5.1 + DeepSeek V4 Pro are the operator-required model mix for this bot. - Optional red-team model is enabled only when `PLATFORMCTL_PR_SANITY_REDTEAM_MODEL` is configured. - Auto-merge is not enabled here.

codex force-pushed codex/667-renovate-forgejo from f099cefd9d to bc99925ecf 2026-06-02 10:22:48 +02:00 Compare

codex commented 2026-06-02 10:24:31 +02:00

Author

Collaborator

Copy link

Rebased and refreshed after #683/#684 merged.

Current head: bc99925ecf25a736065b054e57de6bb089cdf031
Base: main at c7c179732b6142bbc7d830da724433340f806e3c

Validation rerun after rebase:

• uv run pytest platformctl/tests/test_renovate_config.py -> 3 passed
• python3 control-plane/platformctl/ci/lint_workflows.py --policy .forgejo/ci-policy.yaml --workflows .forgejo/workflows ... -> 0 findings
• python3 -m json.tool renovate.json -> passed
• PYTHONPATH=control-plane uv run --project control-plane python -m platformctl.cli validate all --json -> exitCode 0

No runtime mutation, no token creation, no live Renovate run.

Rebased and refreshed after #683/#684 merged. Current head: `bc99925ecf25a736065b054e57de6bb089cdf031` Base: `main` at `c7c179732b6142bbc7d830da724433340f806e3c` Validation rerun after rebase: - `uv run pytest platformctl/tests/test_renovate_config.py` -> 3 passed - `python3 control-plane/platformctl/ci/lint_workflows.py --policy .forgejo/ci-policy.yaml --workflows .forgejo/workflows ...` -> 0 findings - `python3 -m json.tool renovate.json` -> passed - `PYTHONPATH=control-plane uv run --project control-plane python -m platformctl.cli validate all --json` -> exitCode 0 No runtime mutation, no token creation, no live Renovate run.

pdurlej merged commit 1e7ea2ad9a into main 2026-06-02 11:17:46 +02:00

pdurlej deleted branch codex/667-renovate-forgejo 2026-06-02 11:17:46 +02:00

pdurlej referenced this pull request from a commit 2026-06-02 11:17:48 +02:00

Merge pull request 'chore(deps): add Forgejo Renovate setup' (#682) from codex/667-renovate-forgejo into main

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

W6d-automerge-calibration

  

agent/claude-code

Vistula actor: Claude Code.

  

agent/codex

Vistula actor: Codex.

  

agent/hermes

Vistula actor: Hermes Upstream.

  

agent/iskra

Vistula actor: Iskra.

  

agent/ollama

Vistula actor: Ollama or compatible model.

  

agent/patchwarden

Vistula actor: Patchwarden.

  

automerge-candidate

Candidate for narrow W6d autonomous merge readiness pilot

  

class/security-sensitive

Security-sensitive class of service: smallest coherent PRs and full canary

  

cutover-gate

blocks production declare / final RS2000 replacement

  

dependency/blocked

Vistula dependency state: blocked.

  

dependency/blocks-others

Vistula dependency state: blocks other work.

  

dependency/cross-repo

Vistula dependency scope: cross-repository.

  

dependency/needs-confirmation

Vistula dependency state: needs confirmation.

  

domain:agents

Agent identity, delegation, subagents, routing, or workflows.

  

domain:ci

CI, checks, Actions, runners, or release automation.

  

domain:docs

Documentation, packets, practices, or source-of-truth text.

  

domain:forgejo

Forgejo issues, PRs, labels, repo settings, or identity.

  

domain:infra

Infrastructure, storage, backup, DNS, network, or host substrate.

  

domain:memory

Memory, recall, write gates, salience, or Honcho-adjacent behavior.

  

domain:runtime

Runtime services, deploys, daemons, timers, or live behavior.

  

domain:signal

Signal UX, delivery, context, or outbound behavior.

  

domain:ux

Product UX, operator experience, or conversation ergonomics.

  

flow/architecture

Vistula lifecycle: architecture phase in progress.

  

flow/blocked

Vistula lifecycle: blocked on dependency or decision.

  

flow/deployed

Vistula lifecycle: deployed to runtime where applicable.

  

flow/done

Vistula lifecycle: work merged or otherwise done.

  

flow/implementation

Vistula lifecycle: implementation phase in progress.

  

flow/intake

Vistula lifecycle: incoming signal not refined yet.

  

flow/maintained

Vistula lifecycle: maintained/steady state.

  

flow/observed

Vistula lifecycle: observed after delivery.

  

flow/ready

Vistula lifecycle: ready for architecture or implementation.

  

flow/refining

Vistula lifecycle: Hermes/spec refinement in progress.

  

flow/retired

Vistula lifecycle: retired or intentionally closed.

  

flow/review

Vistula lifecycle: review phase in progress.

  

iterating

Orchestrator/Codex actively amending in response to review — operator can ignore until resolved

  

judge/codex-candidate

Candidate for Codex implementation.

  

judge/hermes-candidate

Candidate for Hermes discovery/research.

  

judge/low-confidence

Judgment confidence is low.

  

judge/needs-refinement

Needs clearer evidence or scope.

  

judge/operator-needed

Needs Piotr decision or input.

  

judge/p0

Urgent, operator attention or unblock now.

  

judge/p1

High value, schedule soon.

  

judge/p2

Useful, normal queue.

  

judge/p3

Low priority, keep but do not chase.

  

judge/park

Parked from current attention.

  

judge/patchwarden-candidate

Needs Patchwarden merge-safety attention.

  

judge/stale-priority

Existing priority judgment appears stale.

  

kind/adr

Vistula work kind: architecture decision record.

  

kind/bug

Vistula work kind: bug fix.

  

kind/chore

Vistula work kind: chore.

  

kind/feature

Vistula work kind: feature.

  

kind/infra

Vistula work kind: infrastructure.

  

kind/ops

Vistula work kind: operations.

  

kind/refactor

Vistula work kind: refactor.

  

kind/research

Vistula work kind: research/discovery.

  

large-impact

Per charter §3 review-by-impact: large impact (≥300 LOC OR new module OR identity/secret change OR architectural pivot) — Oracle pre-review recommended

  

merge/auto

Vistula merge mode: automated merge.

  

merge/manual

Vistula merge mode: manual merge.

  

merge/manual-dependency-conflict

Manual merge reason: dependency conflict.

  

merge/manual-failing-tests

Manual merge reason: failing tests.

  

merge/manual-merge-conflict

Manual merge reason: merge conflict.

  

merge/manual-missing-review

Manual merge reason: missing review.

  

merge/manual-operator-preference

Manual merge reason: operator preference.

  

merge/manual-red-zone

Manual merge reason: red-zone risk.

  

merge/manual-security-sensitive

Manual merge reason: security-sensitive work.

  

merge/manual-unclear-scope

Manual merge reason: unclear scope.

  

merge/manual-unknown

Manual merge reason: unknown.

  

meta

meta-decomposition issue; first agent decomposes into atomic children

  

mode:operator-only

Apply step requires explicit operator approval.

  

mode:patchwarden-iskra-approved

Work eligible for Patchwarden/Iskra approval inside repo policy.

  

mode:safe-auto

Low-risk work eligible for lightweight autonomous handling.

  

needs-operator-decision

PR is blocked on operator yes/no decision — fresh-Claude/Codex won't make this call alone

  

needs-triage

decomposing agent has open questions / unknowns

  

not-ready

reviewed but blocked on a precondition

  

observed/erroring

Vistula observation: erroring.

  

observed/needs-followup

Vistula observation: needs follow-up.

  

observed/pending

Vistula observation: pending.

  

observed/retire-candidate

Vistula observation: retire candidate.

  

observed/unused

Vistula observation: unused.

  

observed/used

Vistula observation: used.

  

operator-emotional

operator-emotional importance (Iskra memory etc.)

  

owner-attention

owner must decide; blocks default path

  

phase/02

Phase 02 cataloging

  

phase/03

Phase 03 control plane (platformctl)

  

priority:p0

Immediate safety, uptime, data, or operator-blocking issue.

  

priority:p1

Important active work; should be pulled soon.

  

priority:p2

Useful normal-priority work.

  

priority:p3

Opportunistic cleanup, research, or backlog work.

  

proposed

auto-generated by meta-decomposition; awaiting human review

  

ready-for-agent

reviewed and pickable; agents may claim per cookbook

  

ready-for-operator

PR is ready for operator review/merge — orchestrator finished its part

  

recovery

disaster recovery / restore semantics relevant

  

review:claude-reviewed

Reviewed by Claude-family agent.

  

review:codex-reviewed

Reviewed by Codex-family agent.

  

review:dziadek-reviewed

Reviewed by Dziadek pinch-point reviewer.

  

review:needs-human

Needs human review before merge or apply.

  

risk/exposure

incorrectly public/private/tailnet/auth/routed

  

risk/process

workflow/review/orchestration may produce bad outcomes

  

risk/product

work may have lost owner/user value

  

risk/runtime

platform may not run, recover, validate, behave reproducibly

  

safety:external-write

May write to external systems, users, rooms, repos, or services.

  

safety:no-prod-mutation

Must not mutate production or live external state.

  

safety:prod-impact

May affect production/runtime behavior.

  

safety:secret-touch

Touches secrets, credentials, auth, or secret-adjacent config.

  

size/large

Vistula size: large.

  

size/medium

Vistula size: medium.

  

size/small

Vistula size: small.

  

size/tiny

Vistula size: tiny.

  

size/unknown

Vistula size: not classified yet.

  

source/adr

Vistula source: ADR.

  

source/agent-generated

Vistula source: agent generated.

  

source/manual

Vistula source: manual entry.

  

source/operator-chat

Vistula source: operator chat.

  

source/voice-note

Vistula source: voice note.

  

status:blocked

Blocked by missing dependency, evidence, access, or operator decision.

  

status:codex-ready

Ready for a Codex implementation pass.

  

status:merged:pending-evidence

Merged but waiting for live or artifact evidence before closure.

  

status:needs-evidence

Needs proof, logs, tests, or operator-visible evidence.

  

status:operator-needed

Requires explicit operator input before safe progress.

  

status:parked

Intentionally deferred; not active campaign work.

  

tier/full

Full review tier per ADR-0007

  

tier/lite

Lite review tier per ADR-0007

  

tier/stacked

Stacked PR (base != main) escape hatch per ADR-0017. Requires consolidator-PR plan in PR body.

  

tier:0-platform-substrate

Data, secrets, backup, storage, or critical platform substrate.

  

tier:1-iskra-value-layer

Iskra/OpenClaw behavior, memory, runtime, or value-layer work.

  

tier:2-tools-products-modules

Tools, products, modules, experiments, and lower-blast-radius work.

  

type:bug

Incorrect behavior or regression.

  

type:chore

Maintenance, cleanup, metadata, or operational task.

  

type:docs

Documentation-only work.

  

type:feat

New capability or product behavior.

  

type:policy

Governance, protocol, boundary, or decision-contract change.

  

type:research

Investigation, spike, or evidence-gathering task.

No labels

W6d-automerge-calibration

agent/claude-code

agent/codex

agent/hermes

agent/iskra

agent/ollama

agent/patchwarden

automerge-candidate

class/security-sensitive

cutover-gate

dependency/blocked

dependency/blocks-others

dependency/cross-repo

dependency/needs-confirmation

domain:agents

domain:ci

domain:docs

domain:forgejo

domain:infra

domain:memory

domain:runtime

domain:signal

domain:ux

flow/architecture

flow/blocked

flow/deployed

flow/done

flow/implementation

flow/intake

flow/maintained

flow/observed

flow/ready

flow/refining

flow/retired

flow/review

iterating

judge/codex-candidate

judge/hermes-candidate

judge/low-confidence

judge/needs-refinement

judge/operator-needed

judge/p0

judge/p1

judge/p2

judge/p3

judge/park

judge/patchwarden-candidate

judge/stale-priority

kind/adr

kind/bug

kind/chore

kind/feature

kind/infra

kind/ops

kind/refactor

kind/research

large-impact

merge/auto

merge/manual

merge/manual-dependency-conflict

merge/manual-failing-tests

merge/manual-merge-conflict

merge/manual-missing-review

merge/manual-operator-preference

merge/manual-red-zone

merge/manual-security-sensitive

merge/manual-unclear-scope

merge/manual-unknown

meta

mode:operator-only

mode:patchwarden-iskra-approved

mode:safe-auto

needs-operator-decision

needs-triage

not-ready

observed/erroring

observed/needs-followup

observed/pending

observed/retire-candidate

observed/unused

observed/used

operator-emotional

owner-attention

phase/02

phase/03

priority:p0

priority:p1

priority:p2

priority:p3

proposed

ready-for-agent

ready-for-operator

recovery

review:claude-reviewed

review:codex-reviewed

review:dziadek-reviewed

review:needs-human

risk/exposure

risk/process

risk/product

risk/runtime

safety:external-write

safety:no-prod-mutation

safety:prod-impact

safety:secret-touch

size/large

size/medium

size/small

size/tiny

size/unknown

source/adr

source/agent-generated

source/manual

source/operator-chat

source/voice-note

status:blocked

status:codex-ready

status:merged:pending-evidence

status:needs-evidence

status:operator-needed

status:parked

tier/full

tier/lite

tier/stacked

tier:0-platform-substrate

tier:1-iskra-value-layer

tier:2-tools-products-modules

type:bug

type:chore

type:docs

type:feat

type:policy

type:research

Milestone

Clear milestone

No items

No milestone

10 - Improvements

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

pdurlej/platform!682

No description provided.