SyslogSolution/prose-contracts
7
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

no-mistakes(document): Reframed infra-maintenance contract as deliberate partition
PR Pipeline — Authorize → Validate → Review → Merge / auth (pull_request) Successful in 2s
Details
PR Pipeline — Authorize → Validate → Review → Merge / validate (pull_request) Successful in 2s
Details
PR Pipeline — Authorize → Validate → Review → Merge / lint (pull_request) Successful in 3s
Details
PR Pipeline — Authorize → Validate → Review → Merge / ai-review (pull_request) Successful in 2s
Details
PR Pipeline — Authorize → Validate → Review → Merge / gate (pull_request) Successful in 0s
Details

Browse Source
This commit is contained in:
root
2026-07-18 22:16:09 +00:00
parent a68879e904
commit 99789a00a1
1 changed files with 12 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
infrastructure-maintenance.prose.md
+12 -8
View File
@@ -7,10 +7,11 @@ description: >
running containers, container restarts with health verification, post-update running containers, container restarts with health verification, post-update
verification of every critical service (LiteLLM proxy, SearXNG, Zulip, Gitea, verification of every critical service (LiteLLM proxy, SearXNG, Zulip, Gitea,
PM2 processes, Hermes gateways), and rollback on failure. Consolidates the PM2 processes, Hermes gateways), and rollback on failure. Consolidates the
raw shell scripts that previously did this piecemeal and closes the Docker raw shell scripts that previously did this piecemeal. This contract owns the
image management gap that infrastructure-update left open (infra-update owns HOST-LEVEL weekly maintenance loop on the primary host plus Docker image
cluster-wide apt waves; this contract owns the host-level maintenance loop pulls ONLY for .116 and .7, while infrastructure-update owns the FULL-FLEET
on the primary host + Docker image lifecycle). Runs Sunday 2am ET. Owner: cluster-wide wave (apt across the full PVE cluster + CTs/VMs AND its Docker
image Wave 3 across all stacks). Runs Sunday 2am ET. Owner:
ops (firstmate secondmate). Blast radius: an unverified image pull can break ops (firstmate secondmate). Blast radius: an unverified image pull can break
LiteLLM (all agents lose inference) or SearXNG (search-stack down); a bad apt LiteLLM (all agents lose inference) or SearXNG (search-stack down); a bad apt
upgrade can leave the host in a half-upgraded state. Pre-update backup check upgrade can leave the host in a half-upgraded state. Pre-update backup check
@@ -34,9 +35,12 @@ version: 1.0.0
## Scope ## Scope
Primary host is the maintenance host where apt updates apply. Docker image pulls Primary host is the maintenance host where apt updates apply. Docker image pulls
span the two Docker ecosystems that run critical services. Topology, CT IDs, and span the two Docker ecosystems that run critical services. infrastructure-update
IPs are live-state fields — verify against `infrastructure-control.prose.md` runs the full-fleet cluster-wide wave (including its Wave 3 Docker pulls across
(the source of truth) and the live system before mutating. all stacks/hosts); this contract runs a narrower host-level weekly pull limited
to .116 and .7. Topology, CT IDs, and IPs are live-state fields — verify against
`infrastructure-control.prose.md` (the source of truth) and the live system
before mutating.
| Host | IP | Role | Trust | | Host | IP | Role | Trust |
|------|----|------|-------| |------|----|------|-------|
@@ -189,7 +193,7 @@ Escalation: none | warning | critical | fatal
## Related Contracts ## Related Contracts
- `infrastructure-update.prose.md` — cluster-wide apt waves across the PVE cluster + CTs/VMs (the build-phase update); this contract handles the host-level maintenance loop and Docker image lifecycle. - `infrastructure-update.prose.md` — owns the full-fleet cluster-wide wave INCLUDING its Wave 3 Docker image updates across all stacks (SearXNG, Firecrawl, Inference Harness on .116, home stack, audiobookshelf); infrastructure-maintenance is a deliberately narrower host-level weekly pull scoped to .116 and .7.
- `infrastructure-monitoring.prose.md` — provides the pre-update health baseline (depends_on). - `infrastructure-monitoring.prose.md` — provides the pre-update health baseline (depends_on).
- `infrastructure-control.prose.md` — topology source of truth (CT IDs, IPs, hostnames). - `infrastructure-control.prose.md` — topology source of truth (CT IDs, IPs, hostnames).
- `litellm-health.prose.md` — LiteLLM probe details. - `litellm-health.prose.md` — LiteLLM probe details.