Evidence model and rules

Evidence states

StateMeaningProduced by this tool?
VERIFIED_STATICComputed over the supplied filesYes
EXECUTED_VERIFIEDA separately recorded tool resultNever
DECLARED_NOT_VERIFIEDA person said so; no independent proofYes (rollback inputs)
NOT_TESTEDNo test exists or ranYes (drift, live RBAC)
NOT_RUNNeeds something this tool will not do (cluster, metrics)Yes
NOT_VERIFIEDAuthenticity or approval not establishedYes
FAILEDA check ran and failedAudit
PARTIAL_TRUNCATEDInput larger than the summarised windowPlans

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.

IDSeverityWhat it flags
DS-K8S-001HIGHService type LoadBalancer or NodePort (potential public exposure)
DS-K8S-002HIGHIngress with no rules or a wildcard/missing host
DS-K8S-003HIGHhostNetwork: true
DS-K8S-004HIGHPrivileged container
DS-K8S-005HIGHallowPrivilegeEscalation: true
DS-K8S-006MEDIUMrunAsUser: 0
DS-K8S-007MEDIUMNo tag, :latest, no digest (registry ports handled)
DS-K8S-008MEDIUMNo resources.limits
DS-K8S-009HIGHDeployment/StatefulSet replicas 0
DS-K8S-010HIGHRBAC wildcard verbs or resources
DS-K8S-011HIGHClusterRoleBinding
DS-K8S-012HIGHSecret-like env var with an inline literal (value withheld)
DS-K8S-013HIGHhostPID or hostIPC
DS-K8S-014HIGHhostPath volume
DS-K8S-015HIGHCapabilities ALL, SYS_ADMIN, NET_ADMIN, SYS_PTRACE, SYS_MODULE
DS-K8S-016LOWNo readinessProbe (Deployment/StatefulSet/DaemonSet)
DS-K8S-017LOWrunAsNonRoot not enforced
DS-K8S-018MEDIUMRole can read Secrets
DS-K8S-019MEDIUMResource 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

ProfileBlocks onUse
developmentHIGHThrow-away environments
staging (default)HIGHPre-production
productionHIGH, MEDIUMProduction 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.