ops: add Domovoy production health monitor
CI / test (pull_request) Successful in 11s
CI / test (push) Successful in 9s

This commit was merged in pull request #3.
This commit is contained in:
m
2026-08-16 18:20:40 +03:00
parent 0a188ddafe
commit 4016820541
5 changed files with 262 additions and 2 deletions
+2 -2
View File
@@ -1,5 +1,5 @@
{
"task_file": "dev/tasks/DEV-000037-encrypted-offhost-backup.json",
"task_id": "DEV-000037",
"task_file": "dev/tasks/DEV-000038-production-health-monitor.json",
"task_id": "DEV-000038",
"task_revision": 1
}
@@ -0,0 +1,81 @@
{
"task_id": "DEV-000038",
"task_revision": 1,
"architecture_revision": "ADR-0004",
"base_repo_revision": "0a188ddafe24dc2b31271f0d47ac31baed1d237f",
"risk_tier": "E",
"intent": "Add an external production health monitor for Domovoy containers, HTTPS certificate, public DNS, verified backups, and scheduled jobs without creating canonical Monitor semantics or using docker-test.",
"requirement_ids": ["CONSTITUTION-1.3.11", "CONSTITUTION-1.3.31", "USER-DOCKER-PROD-ONLY"],
"allowed_change_scope": {
"modules": [],
"paths": [
"deploy/windows/Test-DomovoyProductionHealth.ps1",
"deploy/windows/Register-DomovoyProductionHealthTask.ps1",
"docs/DEPLOYMENT.md",
"dev/ACTIVE_TASK.json",
"dev/tasks/DEV-000038-production-health-monitor.json"
]
},
"forbidden_change_scope": {
"paths": [
"architecture/**",
"ci/**",
".gitea/**",
"cmd/**",
"contracts/**",
"modules/**",
"database/**",
"security/**",
"deploy/docker-compose*.yml"
]
},
"allowed_architecture_delta": {
"new_cross_module_dependencies": 0,
"new_canonical_owners": 0,
"new_privileges": 0,
"new_third_party_dependencies": 0
},
"contracts": {
"consume": ["Docker read-only inspection", "HTTPS/TLS endpoint", "public DNS", "DEV-000035 backup manifest", "DEV-000037 NAS manifest", "Windows Scheduled Tasks"],
"may_change": []
},
"semantic_owner": "none; external rebuildable operational projection",
"canonical_state": ["none; status JSON is non-canonical and may be regenerated"],
"state_transitions": ["observed checks -> healthy or degraded operational snapshot"],
"side_effects_and_privileges": ["read-only inspection of production Docker and backup state", "atomic write of local and NAS status JSON", "registration of a current-user scheduled task"],
"persistence_and_migrations": ["no database migration", "latest status JSON only; no hidden retention deletion"],
"failure_retry_restart": ["checks are independent and record explicit failure details", "the monitor exits nonzero when any check fails", "local status remains available if NAS publication fails", "scheduled execution retries every 15 minutes and at logon"],
"assumptions": [
"The authorized Windows user retains Docker context docker-prod, SSH alias docker, public DNS, and NAS access",
"Production backup should be younger than 30 hours and off-host backup younger than 36 hours",
"TLS certificate should retain at least 21 days",
"docker-test remains prohibited"
],
"acceptance_scenarios": [
"all expected Assistant containers are running and health-enabled containers are healthy",
"HTTPS returns healthy and the certificate has at least 21 remaining days",
"public assistent.cin.su and docker.cin.su A records agree",
"production and NAS backups are recent and their hashes validate",
"backup scheduled tasks and production cron report success",
"status JSON is atomically published locally and to NAS",
"a failed check produces overall degraded and a nonzero exit code",
"monitor runs every 15 minutes and at logon",
"exact diff validation observes only declared paths"
],
"required_tests": [
"PowerShell parser",
"architecture preflight",
"exact diff scope",
"healthy live monitoring run",
"synthetic degraded run",
"atomic local and NAS status validation",
"scheduled task registration and manual invocation",
"go test",
"go vet",
"CI"
],
"terminal_gap_states": [
"BLOCKED_BY_MISSING_CAPABILITY",
"BLOCKED_BY_CONFLICT"
]
}