Evidence model and rules
Evidence states
| State | Meaning | Produced by this tool? |
|---|---|---|
VERIFIED_STATIC | Computed over the supplied files | Yes |
EXECUTED_VERIFIED | A separately recorded tool result | Never |
DECLARED_NOT_VERIFIED | A person said so; no independent proof | Yes (rollback inputs) |
NOT_TESTED | No test exists or ran | Yes (drift, live RBAC) |
NOT_RUN | Needs something this tool will not do (cluster, metrics) | Yes |
NOT_VERIFIED | Authenticity or approval not established | Yes |
FAILED | A check ran and failed | Audit |
PARTIAL_TRUNCATED | Input larger than the summarised window | Plans |
A report never collapses these into "passed".
Seals
integrity.digest is SHA-256 over canonical JSON (keys sorted recursively). It detects edits when compared with a trusted copy. It does not say who produced the report and an attacker can recompute it, so it is not a signature.
Line confidence
exact (parser source map), parent (nearest existing ancestor for an absent field), unknown.
Rules
Rule IDs are stable; they are never renumbered or reused. Every rule has a positive case and a negative twin in the corpus.
| ID | Severity | What it flags |
|---|---|---|
| DS-K8S-001 | HIGH | Service type LoadBalancer or NodePort (potential public exposure) |
| DS-K8S-002 | HIGH | Ingress with no rules or a wildcard/missing host |
| DS-K8S-003 | HIGH | hostNetwork: true |
| DS-K8S-004 | HIGH | Privileged container |
| DS-K8S-005 | HIGH | allowPrivilegeEscalation: true |
| DS-K8S-006 | MEDIUM | runAsUser: 0 |
| DS-K8S-007 | MEDIUM | No tag, :latest, no digest (registry ports handled) |
| DS-K8S-008 | MEDIUM | No resources.limits |
| DS-K8S-009 | HIGH | Deployment/StatefulSet replicas 0 |
| DS-K8S-010 | HIGH | RBAC wildcard verbs or resources |
| DS-K8S-011 | HIGH | ClusterRoleBinding |
| DS-K8S-012 | HIGH | Secret-like env var with an inline literal (value withheld) |
| DS-K8S-013 | HIGH | hostPID or hostIPC |
| DS-K8S-014 | HIGH | hostPath volume |
| DS-K8S-015 | HIGH | Capabilities ALL, SYS_ADMIN, NET_ADMIN, SYS_PTRACE, SYS_MODULE |
| DS-K8S-016 | LOW | No readinessProbe (Deployment/StatefulSet/DaemonSet) |
| DS-K8S-017 | LOW | runAsNonRoot not enforced |
| DS-K8S-018 | MEDIUM | Role can read Secrets |
| DS-K8S-019 | MEDIUM | Resource removed from desired state |
Workload rules cover Pod, Deployment, StatefulSet, DaemonSet, ReplicaSet, Job and CronJob, including initContainers. deploysutra explain <ID> prints trigger, rationale, remediation and false-positive notes.
Profiles
| Profile | Blocks on | Use |
|---|---|---|
| development | HIGH | Throw-away environments |
| staging (default) | HIGH | Pre-production |
| production | HIGH, MEDIUM | Production reviews |
Rule accuracy (recorded)
50 author-labelled cases (31 with expected findings, 19 clean twins): 32 expected findings found, 0 false positives, 0 false negatives. This is a regression corpus written by the author, not an independent benchmark. Real manifests will differ.
Rollback prerequisites
prior_revision, backup_verified, restore_test, rollback_procedure, operator_approval. Each is MISSING or DECLARED_NOT_VERIFIED. ready is always false. A plan, checkbox or script is not proof that data is recoverable.