docs(openclaw): rescue scheduler observability spec kit #631

Merged
pdurlej merged 1 commit from codex/m08-openclaw-scheduler-spec into main 2026-05-30 09:13:50 +02:00
Collaborator

Summary

Replacement for stale WIP PR #568. This rescues only the intended OpenClaw Scheduler Observability Spec Kit and inert Python scaffold from ollama/dziadek-openclaw-scheduler-spec, rebased onto current main.

Why replacement instead of updating #568

PR #568's source branch was old and carried accidental reverse-diff churn against current main, including many unrelated deletions. This PR keeps the valuable content and drops the stale branch drift.

What changed

  • Adds docs/specs/openclaw-scheduler-observability-v0/ with constitution, spec, plan, tasks, implementation notes, and README.
  • Adds inert scripts/openclaw_scheduler/ scaffold for Slice (a) inventory work.
  • Documents that this PR does not close #135 by itself; it prepares the implementation path.

Safety

  • No runtime calls.
  • No VPS1000 mutation.
  • No scheduler/cron/systemd writes.
  • No upgrade.
  • Inert scaffold only; functions raise NotImplementedError until Slice (a) implements read-only inventory.

Validation

  • python3 -m py_compile scripts/openclaw_scheduler/__init__.py scripts/openclaw_scheduler/_types.py scripts/openclaw_scheduler/inventory.py passed.
  • PYTHONPATH=control-plane uv run --project control-plane python -m platformctl.cli validate all --json passed.

Follow-up

After merge, #135 should remain open and be decomposed/continued with a concrete read-only Slice (a): scheduler inventory on VPS1000, no repairs.

Refs #135
Supersedes #568

## Summary Replacement for stale WIP PR #568. This rescues only the intended OpenClaw Scheduler Observability Spec Kit and inert Python scaffold from `ollama/dziadek-openclaw-scheduler-spec`, rebased onto current `main`. ## Why replacement instead of updating #568 PR #568's source branch was old and carried accidental reverse-diff churn against current `main`, including many unrelated deletions. This PR keeps the valuable content and drops the stale branch drift. ## What changed - Adds `docs/specs/openclaw-scheduler-observability-v0/` with constitution, spec, plan, tasks, implementation notes, and README. - Adds inert `scripts/openclaw_scheduler/` scaffold for Slice (a) inventory work. - Documents that this PR does not close #135 by itself; it prepares the implementation path. ## Safety - No runtime calls. - No VPS1000 mutation. - No scheduler/cron/systemd writes. - No upgrade. - Inert scaffold only; functions raise `NotImplementedError` until Slice (a) implements read-only inventory. ## Validation - `python3 -m py_compile scripts/openclaw_scheduler/__init__.py scripts/openclaw_scheduler/_types.py scripts/openclaw_scheduler/inventory.py` passed. - `PYTHONPATH=control-plane uv run --project control-plane python -m platformctl.cli validate all --json` passed. ## Follow-up After merge, #135 should remain open and be decomposed/continued with a concrete read-only Slice (a): scheduler inventory on VPS1000, no repairs. Refs #135 Supersedes #568
docs(openclaw): rescue scheduler observability spec kit
All checks were successful
base-is-main / guard (pull_request) Successful in 1s
canary-required / collect-diff (pull_request) Successful in 4s
patchwarden-client-dry-run / collect-diff (pull_request) Successful in 4s
patchwarden-pr-sanity / collect-diff (pull_request) Successful in 5s
canary-required / canary (pull_request) Has been skipped
patchwarden-client-dry-run / dry-run (pull_request) Successful in 23s
patchwarden-pr-sanity / sanity (pull_request) Successful in 2m31s
26eaf4f10a
Author
Collaborator

Patchwarden PR sanity

  • Status: advisory_findings
  • PR: 631
  • Commit: fca8c469a025d7141b72abc304db0703d7624129
  • Security-sensitive label: missing
  • 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: OK
  • Findings: none

redteam / kimi-k2.6:cloud

  • Status: ok

  • Verdict: NOT_OK

  • medium Hardcoded UID 1000 in active cron path

    • Evidence: scripts/openclaw_scheduler/inventory.py line 17: ACTIVE_CRON_PATH = Path("/run/user/1000/openclaw/cron/jobs.json"). The spec itself acknowledges in 02-plan.md risks that '/run/user/1000/openclaw/ requires correct uid context to read', yet t
    • Next: Resolve the openclaw user's uid dynamically (e.g., pwd.getpwnam('openclaw').pw_uid) or accept an explicit --runtime-dir flag so the inventory script remains correct regardless of which user executes it.

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-631 --> # Patchwarden PR sanity - Status: `advisory_findings` - PR: `631` - Commit: `fca8c469a025d7141b72abc304db0703d7624129` - Security-sensitive label: `missing` - 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: `OK` - Findings: none ### `redteam` / `kimi-k2.6:cloud` - Status: `ok` - Verdict: `NOT_OK` - **`medium`** Hardcoded UID 1000 in active cron path - Evidence: `scripts/openclaw_scheduler/inventory.py line 17: ACTIVE_CRON_PATH = Path("/run/user/1000/openclaw/cron/jobs.json"). The spec itself acknowledges in 02-plan.md risks that '/run/user/1000/openclaw/ requires correct uid context to read', yet t` - Next: Resolve the openclaw user's uid dynamically (e.g., pwd.getpwnam('openclaw').pw_uid) or accept an explicit --runtime-dir flag so the inventory script remains correct regardless of which user executes it. ## 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.
pdurlej approved these changes 2026-05-30 09:08:13 +02:00
Dismissed
pdurlej left a comment

Owner/admin approval after green checks and non-destructive scope. Secret output: none.

Owner/admin approval after green checks and non-destructive scope. Secret output: none.
codex force-pushed codex/m08-openclaw-scheduler-spec from 26eaf4f10a
All checks were successful
base-is-main / guard (pull_request) Successful in 1s
canary-required / collect-diff (pull_request) Successful in 4s
patchwarden-client-dry-run / collect-diff (pull_request) Successful in 4s
patchwarden-pr-sanity / collect-diff (pull_request) Successful in 5s
canary-required / canary (pull_request) Has been skipped
patchwarden-client-dry-run / dry-run (pull_request) Successful in 23s
patchwarden-pr-sanity / sanity (pull_request) Successful in 2m31s
to fca8c469a0
All checks were successful
base-is-main / guard (pull_request) Successful in 2s
canary-required / collect-diff (pull_request) Successful in 5s
patchwarden-client-dry-run / collect-diff (pull_request) Successful in 5s
patchwarden-pr-sanity / collect-diff (pull_request) Successful in 5s
canary-required / canary (pull_request) Has been skipped
patchwarden-client-dry-run / dry-run (pull_request) Successful in 22s
patchwarden-pr-sanity / sanity (pull_request) Successful in 3m10s
2026-05-30 09:09:11 +02:00
Compare
pdurlej approved these changes 2026-05-30 09:13:49 +02:00
pdurlej left a comment

Owner-authorized admin approval after green checks. Scope is non-runtime docs/spec rescue; no secrets printed.

Owner-authorized admin approval after green checks. Scope is non-runtime docs/spec rescue; no secrets printed.
pdurlej referenced this pull request from a commit 2026-05-30 09:13:51 +02:00
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!631
No description provided.