docs(modules): anchor shelfmark F3 approval #303

Merged

pdurlej merged 1 commit from codex/f3/shelfmark-approval-anchor into main

2026-05-17 00:04:41 +02:00

codex commented

2026-05-16 23:53:26 +02:00

Collaborator

Canary status: operator_override — Piotr granted temporary Codex push/merge lane for RS2000 F3 completion.

Summary

Documents that Shelfmark now has canonical compose in /opt/pdurlej-platform/current/compose/apps/compose.yaml.
Updates the non-destructive restart command to use the canonical release root and runtime env file.
Provides a merged-PR approval anchor for the stateful F3 workflow after the direct main push was rejected by the approved-pr guard (no merged PR found for SHA).

Runtime evidence

Fresh backup already created before F3: /opt/pdurlej-platform/backups/shelfmark-20260516T215056Z.tar.gz, mode 0600, owner root:root, size 1895955 bytes.
RS2000 release root already points at b558c451c3aa06f7d26069b857843b2119c60be0.
docker compose --env-file /opt/pdurlej-platform/runtime/compose.env -f /opt/pdurlej-platform/current/compose/apps/compose.yaml config --quiet passed.
home-platform-shelfmark-1 is currently healthy.

Tests

uv run --project control-plane python -m platformctl validate --strict-v2 modules/shelfmark/module.yaml
PLATFORMCTL_SMOKE_REMOTE_MODE=skip ... tests/smoke.sh --json shelfmark
git diff --check

Spec sources read

modules/shelfmark/module.yaml — F3 manifest and health criteria.
modules/shelfmark/runbook.md — restart/recovery command update.
compose/apps/compose.yaml — canonical service import already on main.
.forgejo/workflows/platformctl-auto-apply.yml — confirmed approved-pr guard requires merged PR SHA.

Refs: #142

Canary status: operator_override — Piotr granted temporary Codex push/merge lane for RS2000 F3 completion. ## Summary - Documents that Shelfmark now has canonical compose in `/opt/pdurlej-platform/current/compose/apps/compose.yaml`. - Updates the non-destructive restart command to use the canonical release root and runtime env file. - Provides a merged-PR approval anchor for the stateful F3 workflow after the direct main push was rejected by the `approved-pr` guard (`no merged PR found for SHA`). ## Runtime evidence - Fresh backup already created before F3: `/opt/pdurlej-platform/backups/shelfmark-20260516T215056Z.tar.gz`, mode `0600`, owner `root:root`, size `1895955` bytes. - RS2000 release root already points at `b558c451c3aa06f7d26069b857843b2119c60be0`. - `docker compose --env-file /opt/pdurlej-platform/runtime/compose.env -f /opt/pdurlej-platform/current/compose/apps/compose.yaml config --quiet` passed. - `home-platform-shelfmark-1` is currently healthy. ## Tests - `uv run --project control-plane python -m platformctl validate --strict-v2 modules/shelfmark/module.yaml` - `PLATFORMCTL_SMOKE_REMOTE_MODE=skip ... tests/smoke.sh --json shelfmark` - `git diff --check` ## Spec sources read - `modules/shelfmark/module.yaml` — F3 manifest and health criteria. - `modules/shelfmark/runbook.md` — restart/recovery command update. - `compose/apps/compose.yaml` — canonical service import already on main. - `.forgejo/workflows/platformctl-auto-apply.yml` — confirmed `approved-pr` guard requires merged PR SHA. Refs: #142

Rows
Columns