Heavy-Tools / RULEBOOK.yaml
lexicalspace's picture
Rename app.py to RULEBOOK.yaml
d07f46d verified
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