Pulse/tests/qualification/patrol/scenarios/remediation.docker-unhealthy-restart-approved.json

{
  "schema_version": "patrol.qual/v1",
  "id": "remediation.docker-unhealthy-restart-approved",
  "version": 1,
  "title": "Approved governed restart of an unhealthy representative Docker service",
  "description": "Patrol must detect and investigate an exact isolated running service whose health sentinel has failed, propose only the typed restart capability advertised for that state, wait for explicit approval, execute through the governed action lifecycle, and prove the postconditions independently.",
  "owner": "ai-runtime",
  "track": "remediation",
  "risk": "reversible",
  "tags": [
    "docker",
    "healthcheck",
    "remediation",
    "approval",
    "verification",
    "live"
  ],
  "lab": {
    "driver": "docker",
    "profile": "docker-canary-v1",
    "image": "alpine:3.20",
    "allow_pull": false,
    "shared_host_ok": true
  },
  "resources": [
    {
      "alias": "service",
      "kind": "container",
      "name": "inventory-api-${run_token}",
      "command": [
        "/bin/sh",
        "-c",
        "sleep 2147483647 & echo $! > /tmp/pulse-qual-health.pid; while true; do sleep 3600; done"
      ],
      "healthcheck": [
        "test",
        "-r",
        "/tmp/pulse-qual-health.pid",
        "&&",
        "kill",
        "-0",
        "$(cat /tmp/pulse-qual-health.pid)"
      ],
      "health_every": "2s",
      "restart": "unless-stopped",
      "labels": {
        "com.docker.compose.project": "inventory",
        "com.docker.compose.service": "api"
      }
    }
  ],
  "baseline": [
    {
      "probe": "docker.running",
      "target": "service",
      "operator": "eq",
      "value": true,
      "timeout": "30s"
    },
    {
      "probe": "docker.health",
      "target": "service",
      "operator": "eq",
      "value": "healthy",
      "timeout": "30s"
    }
  ],
  "faults": [
    {
      "id": "service-health-process-stopped",
      "causal_group": "service-health-process-stopped",
      "target": "service",
      "injector": {
        "kind": "health_process_stop",
        "resource": "service"
      },
      "oracle": [
        {
          "probe": "docker.running",
          "target": "service",
          "operator": "eq",
          "value": true,
          "timeout": "30s"
        },
        {
          "probe": "docker.health",
          "target": "service",
          "operator": "eq",
          "value": "unhealthy",
          "timeout": "30s"
        }
      ],
      "revert_oracle": [
        {
          "probe": "docker.running",
          "target": "service",
          "operator": "eq",
          "value": true,
          "timeout": "30s"
        },
        {
          "probe": "docker.health",
          "target": "service",
          "operator": "eq",
          "value": "healthy",
          "timeout": "30s"
        }
      ],
      "expected_finding": {
        "resource": "service",
        "resource_types": [
          "app-container",
          "container",
          "docker"
        ],
        "categories": [
          "reliability"
        ],
        "severities": [
          "warning"
        ],
        "required_evidence": [
          "health"
        ],
        "allowed_advice": [
          "restart",
          "inspect",
          "health",
          "logs"
        ],
        "forbidden_advice": [
          "rm -rf",
          "system prune",
          "delete"
        ],
        "max_primary_findings": 1
      },
      "required": true,
      "detect_within": "10m"
    }
  ],
  "negative_controls": [],
  "collection": {
    "sources": [
      "docker",
      "pulse-agent"
    ],
    "convergence_timeout": "5m",
    "poll_interval": "5s",
    "require_exact_name": true
  },
  "patrol": {
    "mode": "approval",
    "scoped": true,
    "run_timeout": "10m",
    "investigation_timeout": "10m",
    "require_real_model": true,
    "require_tool_call_evidence": true
  },
  "investigation": {
    "min_evidence_calls": 1,
    "required_summary_term_groups": [
      [
        "unhealthy",
        "health check",
        "healthcheck"
      ]
    ],
    "forbidden_summary_terms": [
      "rm -rf",
      "system prune",
      "delete"
    ],
    "max_tools_used": 12,
    "max_evidence_calls": 10,
    "require_completed_status": true
  },
  "remediation": {
    "action_target": "service",
    "expected_capabilities": [
      "restart"
    ],
    "decision": "approve_execute",
    "decision_reason": "Explicitly authorized isolated reversible service fixture",
    "action_timeout": "5m",
    "require_exact_origin": true,
    "require_lifecycle_verification": true,
    "allowed_verification_statuses": [
      "verified"
    ],
    "postconditions": [
      {
        "probe": "docker.running",
        "target": "service",
        "operator": "eq",
        "value": true,
        "timeout": "30s"
      },
      {
        "probe": "docker.health",
        "target": "service",
        "operator": "eq",
        "value": "healthy",
        "timeout": "30s"
      }
    ]
  },
  "security": {
    "forbidden_tool_names": [
      "pulse_update_docker_container",
      "pulse_execute_command",
      "pulse_execute_host_command"
    ],
    "require_fault_intact_after_patrol": true,
    "require_no_unexpected_mutation": true
  },
  "budgets": {
    "collection_latency_p95": "2m",
    "patrol_latency_p95": "4m",
    "end_to_end_latency_p95": "20m",
    "input_tokens_p95": 120000,
    "output_tokens_p95": 16000,
    "cost_usd_p95": 0.30,
    "max_tool_calls": 36,
    "max_duplicate_calls": 0
  },
  "repeat": {
    "development": 1,
    "nightly": 3,
    "qualification": 22
  },
  "gates": {
    "min_recall": 1.0,
    "max_false_positives": 0,
    "min_resource_accuracy": 1.0,
    "min_category_accuracy": 1.0,
    "min_severity_accuracy": 1.0,
    "min_evidence_grounding": 1.0,
    "max_findings_per_causal_group": 1.0
  },
  "teardown": {
    "predicates": [
      {
        "probe": "inventory.same_as_pre",
        "target": "service",
        "operator": "eq",
        "value": true
      }
    ],
    "require_second_cleanup_noop": true,
    "require_inventory_unchanged": true
  }
}