reporting-governance-plugin/policy-packs/verified-completion-only/policy.yaml

apiVersion: reporting-governance/v1alpha1
kind: PolicyPack
metadata:
  id: verified-completion-only
  title: Verified Completion Only
  version: 1.0.0
  summary: >-
    Prevent completion from being accepted without the evidence and review state
    required by the governance evidence and decision models.
  owner: reporting-governance-plugin
  severity_default: high
  applies_to:
    runtimes: [openclaw]
    task_modes: [interactive, silent]
    workflow_shapes: [single-agent, parent-child]
    channels: [telegram]
  tags: [reporting, completion, verification, review]
spec:
  evaluation_mode: any_rule_match
  rules:
    - id: verified-completion-only.completion-without-required-evidence
      title: Completion claim below moderate evidence threshold is invalid
      intent: >-
        Enforce the evidence-model baseline that completion requires at least
        moderate auditable support.
      triggers:
        event_types: [task_claimed_complete]
        claim_types: [completion]
      conditions:
        all:
          - fact: claim.completion_asserted
            equals: true
          - fact: evidence.completion_min_quality
            less_than: moderate
      evidence_requirements:
        completion:
          min_quality: moderate
        must_reference_evidence_classes: [verification_output, file_change, tool_output, decision_record]
      decision_output:
        decision: downgrade_status
        severity: high
        reason: >-
          completion was claimed without sufficient auditable evidence
        suggested_status: pending_verification
        required_actions:
          - action: set_status
            target: status_transition
            mandatory: true
            details:
              from: completed
              to: pending_verification
          - action: request_review
            target: review_queue
            mandatory: true
            details:
              review_scope: completion_evidence
          - action: append_audit_note
            target: task_record
            mandatory: true
            details:
              note: original completion claim preserved; downgraded by governance due to insufficient evidence
        operator_notice:
          required: true
          channel: telegram
          urgency: high
          message: >-
            Completion claim was downgraded to pending verification because
            sufficient evidence was not attached.
          must_reference: []
          deadline: null
      operator_message_templates:
        status_downgraded: >-
          Completion claim received, but the task remains pending verification
          until auditable evidence is attached.

    - id: verified-completion-only.verified-completion-without-strong-evidence
      title: Verified completion requires strong evidence
      intent: >-
        Enforce the stronger threshold for reports that claim verified or fully
        accepted completion.
      triggers:
        event_types: [task_claimed_complete]
        claim_types: [verified_completion]
      conditions:
        all:
          - fact: claim.verified_completion_asserted
            equals: true
          - fact: evidence.verified_completion_min_quality
            less_than: strong
      evidence_requirements:
        verified_completion:
          min_quality: strong
        must_reference_evidence_classes: [verification_output, decision_record]
      decision_output:
        decision: require_review
        severity: high
        reason: >-
          verified completion was asserted without strong enough supporting evidence
        suggested_status: pending_verification
        required_actions:
          - action: request_review
            target: review_queue
            mandatory: true
            details:
              review_scope: verified_completion
          - action: append_audit_note
            target: task_record
            mandatory: true
            details:
              note: verified completion wording retained for audit but requires review before acceptance
        operator_notice:
          required: true
          channel: telegram
          urgency: high
          message: >-
            Verified completion was claimed, but the evidence does not yet meet
            the strong threshold required for acceptance.
          must_reference: []
          deadline: null
      operator_message_templates:
        review_required: >-
          Review required: completion may be real, but the current evidence does
          not yet justify a verified-completion label.

    - id: verified-completion-only.ambiguous-completion-review-path
      title: Ambiguous completion must be routed to operator review
      intent: >-
        Provide a conservative review path when completion evidence exists but
        remains mixed, incomplete, or interpretation-dependent.
      triggers:
        event_types: [task_claimed_complete, operator_review_requested]
        claim_types: [completion]
      conditions:
        all:
          - fact: claim.completion_asserted
            equals: true
          - fact: evidence.completion_is_ambiguous
            equals: true
      evidence_requirements:
        completion:
          min_quality: moderate
      decision_output:
        decision: require_review
        severity: medium
        reason: >-
          completion evidence is present but ambiguous and should not be auto-accepted
        suggested_status: awaiting_review
        required_actions:
          - action: request_review
            target: review_queue
            mandatory: true
            details:
              review_scope: ambiguous_completion
          - action: notify_operator
            target: operator_channel
            mandatory: true
            details:
              kind: ambiguous_completion_review
        operator_notice:
          required: true
          channel: telegram
          urgency: medium
          message: >-
            Completion evidence exists but is ambiguous. Operator review is
            required before the task can be treated as complete.
          must_reference: []
          deadline: null
      operator_message_templates:
        review_required: >-
          Completion evidence is present, but acceptance is ambiguous. This task
          is being routed for operator review rather than treated as complete.