feat(status): add public dashboard publisher #820

Merged
pdurlej merged 1 commit from codex/status-dashboard-autopublish into main 2026-06-19 09:52:41 +02:00
Collaborator

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

Canary Context Pack

Product story

The platform status dashboard should receive fresh public-safe status.json snapshots without giving the dashboard runtime access to Tailnet, RS2000, VPS1000, Docker, SSH, Infisical, or logs.

What changed

  • Added platformctl status publish-dashboard.
  • Added platform-side validation for the existing platform-status.v1 contract.
  • Added leakage scan for secret-like literals, private/tailnet IPs, host paths, and internal port endpoints.
  • Added a GitHub Contents API publisher that can update only public/status.json in pdurlej/platform-status-dashboard when --publish-github is explicitly passed.
  • Added systemd service/timer examples and updated the v0 handoff doc.

Why it changed

The dashboard repo is ready to render richer status data, but it needs an autonomous outbound delivery path from the trusted platform side. This PR keeps Vercel/GitHub passive and makes publication fail closed before any external write.

Files touched

  • control-plane/platformctl/status_publish.py
  • control-plane/platformctl/cli.py
  • control-plane/platformctl/tests/test_public_status.py
  • scripts/status-dashboard/README.md
  • scripts/status-dashboard/systemd/platform-status-dashboard-publish.service.example
  • scripts/status-dashboard/systemd/platform-status-dashboard-publish.timer.example
  • docs/platform-status-dashboard-v0-prompt.md

Relevant context

  • Existing exporter: platformctl status export --public
  • Existing dashboard contract: schema_version: platform-status.v1
  • Dashboard repo reads only committed public/status.json.

Runtime evidence

No live runtime mutation performed. Local dry validation against the real 88-module snapshot returned validation_errors=[], safety_findings=[], export_errors=0, exitCode=0.

Known constraints

  • No GitHub token value is stored, printed, or committed.
  • The publisher requires PLATFORM_STATUS_DASHBOARD_GITHUB_TOKEN at runtime and should use a dashboard-repo-scoped token with contents write only.
  • The command refuses to publish any path except public/status.json.
  • This PR does not install or enable the systemd timer.

Explicit out-of-scope

  • Real service health probes.
  • Installing the runtime timer on RS2000.
  • Creating or rotating the GitHub token.
  • Changing dashboard UI behavior.
  • Any inbound runtime connector from Vercel/GitHub.

Requested decision

Approve the platform-side autonomous outbound publisher after canary/full review.

Merge blockers

  • Any leak of secret values, private IPs, host paths, or internal endpoints into public/status.json.
  • Any path that lets the dashboard call back into runtime.
  • Any broad GitHub write surface beyond public/status.json.

Spec sources read

  • control-plane/platformctl/public_status.py — existing exporter contract.
  • control-plane/platformctl/cli.py — CLI integration point.
  • control-plane/platformctl/tests/test_public_status.py — existing test surface.
  • docs/platform-status-dashboard-v0-prompt.md — dashboard handoff/contract.
  • scripts/status-dashboard/README.md — new operator runbook for this slice.
  • scripts/status-dashboard/systemd/*.example — new timer/service examples.

Tests

UV_CACHE_DIR=/Users/pd/Developer/platform/.uv-cache PYTHONPATH=control-plane uv run --project control-plane python -m pytest control-plane/platformctl/tests/test_public_status.py
# 8 passed

UV_CACHE_DIR=/Users/pd/Developer/platform/.uv-cache PYTHONPATH=control-plane uv run --project control-plane python -m platformctl.cli status publish-dashboard --json
# services=88, validation_errors=[], safety_findings=[], export_errors=0, exitCode=0

git diff --check
# passed

No closing issue: requested directly by operator in live thread.

Canary status: missing — fire canary 3+3 manually before merge ## Canary Context Pack ### Product story The platform status dashboard should receive fresh public-safe `status.json` snapshots without giving the dashboard runtime access to Tailnet, RS2000, VPS1000, Docker, SSH, Infisical, or logs. ### What changed - Added `platformctl status publish-dashboard`. - Added platform-side validation for the existing `platform-status.v1` contract. - Added leakage scan for secret-like literals, private/tailnet IPs, host paths, and internal port endpoints. - Added a GitHub Contents API publisher that can update only `public/status.json` in `pdurlej/platform-status-dashboard` when `--publish-github` is explicitly passed. - Added systemd service/timer examples and updated the v0 handoff doc. ### Why it changed The dashboard repo is ready to render richer status data, but it needs an autonomous outbound delivery path from the trusted platform side. This PR keeps Vercel/GitHub passive and makes publication fail closed before any external write. ### Files touched - `control-plane/platformctl/status_publish.py` - `control-plane/platformctl/cli.py` - `control-plane/platformctl/tests/test_public_status.py` - `scripts/status-dashboard/README.md` - `scripts/status-dashboard/systemd/platform-status-dashboard-publish.service.example` - `scripts/status-dashboard/systemd/platform-status-dashboard-publish.timer.example` - `docs/platform-status-dashboard-v0-prompt.md` ### Relevant context - Existing exporter: `platformctl status export --public` - Existing dashboard contract: `schema_version: platform-status.v1` - Dashboard repo reads only committed `public/status.json`. ### Runtime evidence No live runtime mutation performed. Local dry validation against the real 88-module snapshot returned `validation_errors=[]`, `safety_findings=[]`, `export_errors=0`, `exitCode=0`. ### Known constraints - No GitHub token value is stored, printed, or committed. - The publisher requires `PLATFORM_STATUS_DASHBOARD_GITHUB_TOKEN` at runtime and should use a dashboard-repo-scoped token with contents write only. - The command refuses to publish any path except `public/status.json`. - This PR does not install or enable the systemd timer. ### Explicit out-of-scope - Real service health probes. - Installing the runtime timer on RS2000. - Creating or rotating the GitHub token. - Changing dashboard UI behavior. - Any inbound runtime connector from Vercel/GitHub. ### Requested decision Approve the platform-side autonomous outbound publisher after canary/full review. ### Merge blockers - Any leak of secret values, private IPs, host paths, or internal endpoints into `public/status.json`. - Any path that lets the dashboard call back into runtime. - Any broad GitHub write surface beyond `public/status.json`. ## Spec sources read - `control-plane/platformctl/public_status.py` — existing exporter contract. - `control-plane/platformctl/cli.py` — CLI integration point. - `control-plane/platformctl/tests/test_public_status.py` — existing test surface. - `docs/platform-status-dashboard-v0-prompt.md` — dashboard handoff/contract. - `scripts/status-dashboard/README.md` — new operator runbook for this slice. - `scripts/status-dashboard/systemd/*.example` — new timer/service examples. ## Tests ```bash UV_CACHE_DIR=/Users/pd/Developer/platform/.uv-cache PYTHONPATH=control-plane uv run --project control-plane python -m pytest control-plane/platformctl/tests/test_public_status.py # 8 passed UV_CACHE_DIR=/Users/pd/Developer/platform/.uv-cache PYTHONPATH=control-plane uv run --project control-plane python -m platformctl.cli status publish-dashboard --json # services=88, validation_errors=[], safety_findings=[], export_errors=0, exitCode=0 git diff --check # passed ``` No closing issue: requested directly by operator in live thread.
feat(status): add public dashboard publisher
All checks were successful
canary-required / collect-diff (pull_request) Successful in 4s
python-ci / Python 3.11 (pull_request) Successful in 39s
python-ci / Python 3.12 (pull_request) Successful in 40s
python-ci / Python 3.13 (pull_request) Successful in 41s
patchwarden-client-dry-run / collect-diff (pull_request) Successful in 3s
patchwarden-pr-sanity / collect-diff (pull_request) Successful in 4s
canary-required / canary (pull_request) Successful in 16s
platformctl plan / auto-apply scope (pull_request) Successful in 17s
pyfallow / Pyfallow gate (control-plane) (pull_request) Successful in 15s
base-is-main / guard (pull_request) Successful in 1s
patchwarden-pr-sanity / sanity (pull_request) Successful in 53s
patchwarden-client-dry-run / dry-run (pull_request) Successful in 15s
e10d0f93b2
pdurlej deleted branch codex/status-dashboard-autopublish 2026-06-19 09:52:41 +02:00
First-time contributor

Patchwarden PR sanity

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

Deterministic findings

No deterministic findings.

Model reviewers

global-glm / glm-5.1:cloud

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

global-deepseek / deepseek-v4-pro:cloud

  • Status: ok

  • Verdict: ABSTAIN

  • blocker Missing diff prevents review

    • Evidence: The diff is empty; no changed files/hunks provided.
    • Next: Provide the actual diff for review to verify safety claims (no secret leaks, no broad write surface, etc.).

redteam / kimi-k2.6:cloud

  • Status: ok
  • Verdict: OK
  • 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-820 --> # Patchwarden PR sanity - Status: `eligible_sanity_clean` - PR: `820` - Commit: `e10d0f93b2eab5d98685b7cf60b06922c48321f2` - Security-sensitive label: `present` - Authority: advisory model review plus deterministic blockers only - 3+3 canary: still alive; this does not replace it ## Deterministic findings No deterministic findings. ## Model reviewers ### `global-glm` / `glm-5.1:cloud` - Status: `ok` - Verdict: `OK` - Findings: none ### `global-deepseek` / `deepseek-v4-pro:cloud` - Status: `ok` - Verdict: `ABSTAIN` - **`blocker`** Missing diff prevents review - Evidence: `The diff is empty; no changed files/hunks provided.` - Next: Provide the actual diff for review to verify safety claims (no secret leaks, no broad write surface, etc.). ### `redteam` / `kimi-k2.6:cloud` - Status: `ok` - Verdict: `OK` - 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.
Sign in to join this conversation.
No reviewers
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
No milestone
No project
No assignees
2 participants
Notifications
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!820
No description provided.