meta:
  project: UltraMax Shotgun v2
  domain: downloader
  language: python
  strictness: high

rules:

  - id: NET-001
    description: No retry logic at any level
    forbidden:
      - retries > 0
      - retry
    severity: critical

  - id: NET-002
    description: Proxy must deliver first byte within 3 seconds
    must:
      - PROBE_TIMEOUT == 3
    severity: critical

  - id: NET-003
    description: Wave fails immediately if no proxy responds
    must:
      - winner_event.wait(timeout=PROBE_TIMEOUT)
    severity: critical

  - id: NET-004
    description: No hanging sockets
    must:
      - socket_timeout <= 3
    severity: high
    note: Python thread hard-kill is best-effort only

  - id: CACHE-001
    description: Cache identity must include URL, format, codec, bitrate
    must:
      - sha256(url+format+codec+bitrate)
    severity: critical

  - id: CACHE-002
    description: Cache-first delivery must bypass network layer
    must:
      - cache_check_before_network
    severity: critical

  - id: ZOMBIE-001
    description: Background execution must survive UI disconnect
    must:
      - detached_execution
    severity: high
    environment_note: Depends on runtime persistence

  - id: ZOMBIE-002
    description: Absolute max task lifetime
    must:
      - max_lifetime_minutes == 20
    severity: critical

  - id: UX-001
    description: Deferred delivery message within 5 seconds
    must:
      - DEFERRED_LIMIT <= 5
    severity: medium

  - id: UX-002
    description: No fake progress indicators
    forbidden:
      - percentage_progress
      - estimated_time
    severity: medium