amos 9d633e9e67 Batch 15 (20261023-C-hwe-scale-15): 320 HWE-derived repair tasks
One user-space repair task per eligible HWE debug-diag / compile-deploy base
ID: 320 admitted (C 218, C++ 97, build scripts 5), 1 skipped by the content
filter. Each ships a public spec with a check-to-basis table, at least two
defects with single-fix fixtures, a symptom-masking fixture and an alternative
correct implementation. Claude re-checked all 320: structure, the HWE quality
items and trace6 Docker calibration receipts against current digests
(320/320 USABLE). Difficulty is unmeasured. Known follow-up: 212 tasks use 120
ad-hoc family names; the next batch maps them to the canonical list.
The batch's 1,256-line progress log stays in its factory report and the
36-local branch batch15-hwe.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-27 01:55:56 +08:00

232 lines
40 KiB
Python

SUPERVISOR = "import base64,ctypes,hashlib,json,os,selectors,signal,subprocess,sys,time,zlib\n\ndef table():\n result={}\n for item in os.listdir('/proc'):\n if not item.isdecimal(): continue\n try:\n raw=open('/proc/'+item+'/stat').read()\n fields=raw[raw.rfind(')')+2:].split()\n result[int(item)]=(int(fields[1]),int(fields[2]),int(fields[19]),fields[0])\n except (FileNotFoundError,ProcessLookupError): pass\n return result\n\ndef closure(rows, supervisor, tracked):\n roots={supervisor}\n for pid,start in tracked.items():\n if pid in rows and rows[pid][2]==start and rows[pid][3] not in ('Z','X'): roots.add(pid)\n found=set(roots)\n while True:\n extra={pid for pid,row in rows.items() if row[0] in found}\n if extra<=found: break\n found.update(extra)\n return {pid:rows[pid][2] for pid in found if pid!=supervisor and pid in rows}\n\ndef identity(pid):\n values={}\n with open('/proc/'+str(pid)+'/status') as stream:\n for line in stream:\n k,_,v=line.partition(':')\n if k in ('Uid','Gid','Groups'): values[k]=[int(x) for x in v.split()]\n return [values['Uid'][1],values['Gid'][1],values['Groups']]\n\nspec=json.loads(sys.argv[1]);start=time.monotonic()\nmeta={'phase':spec['phase'],'nonce':spec['nonce'],'argv':spec['argv'],'deadline':spec['deadline'],\n 'supervisor':os.getpid(),'identity':[os.geteuid(),os.getegid(),os.getgroups()],\n 'exceptions':[],'leader':None,'leader_start':None,'leader_identity':None,\n 'leader_rc':None,'reaped':False,'timeout':False,'controlled_rc':None,\n 'pg_absent':False,'descendants_absent':False,'tokens':[],'subreaper':False}\nleader=None;tracked={};out=bytearray();err=bytearray();selector=selectors.DefaultSelector()\ntry:\n if ctypes.CDLL(None,use_errno=True).prctl(36,1,0,0,0)!=0: raise OSError(ctypes.get_errno(),'subreaper')\n meta['subreaper']=True\n leader=subprocess.Popen(spec['argv'],cwd=spec['cwd'],stdin=subprocess.PIPE,stdout=subprocess.PIPE,stderr=subprocess.PIPE,start_new_session=True)\n meta['leader']=leader.pid\n birth=table()[leader.pid][2];meta['leader_start']=birth\n meta['leader_identity']=identity(leader.pid)\n tracked[leader.pid]=birth\n for stream,role in [(leader.stdout,'out'),(leader.stderr,'err')]:\n os.set_blocking(stream.fileno(),False);selector.register(stream,selectors.EVENT_READ,role)\n data=base64.b64decode(spec['stdin']);cursor=0\n if data:\n os.set_blocking(leader.stdin.fileno(),False);selector.register(leader.stdin,selectors.EVENT_WRITE,'in')\n else: leader.stdin.close()\n while True:\n # poll owns the leader wait status; adopted-child reaping happens only later.\n code=leader.poll()\n rows=table();tracked.update(closure(rows,os.getpid(),tracked))\n if code is not None and not selector.get_map(): break\n if time.monotonic()-start>=spec['deadline']:\n meta['timeout']=True;break\n for key,event in selector.select(0.01):\n if key.data=='in':\n try: cursor+=os.write(key.fd,data[cursor:cursor+65536])\n except BrokenPipeError: cursor=len(data)\n if cursor==len(data): selector.unregister(key.fileobj);key.fileobj.close()\n else:\n try: chunk=os.read(key.fd,65536)\n except BlockingIOError: continue\n if chunk: (out if key.data=='out' else err).extend(chunk)\n else: selector.unregister(key.fileobj);key.fileobj.close()\nexcept BaseException as exc:\n meta['exceptions'].append(type(exc).__name__+':'+str(exc))\nfinally:\n recovery=time.monotonic()+6\n if leader is not None:\n while True:\n code=leader.poll()\n rows=table();current=closure(rows,os.getpid(),tracked);tracked.update(current)\n for pid,birth in current.items():\n if pid in rows and rows[pid][2]==birth:\n try: os.kill(pid,signal.SIGKILL)\n except ProcessLookupError: pass\n except BaseException as exc: meta['exceptions'].append(type(exc).__name__+':'+str(exc))\n # Never let waitpid(-1) consume a live Popen leader status.\n code=leader.poll()\n if code is not None:\n while True:\n try:\n pid,status=os.waitpid(-1,os.WNOHANG)\n if pid==0: break\n except ChildProcessError: break\n except BaseException as exc:\n meta['exceptions'].append(type(exc).__name__+':'+str(exc));break\n for key,event in selector.select(0):\n if key.data=='in': selector.unregister(key.fileobj);key.fileobj.close();continue\n try: chunk=os.read(key.fd,65536)\n except BlockingIOError: continue\n if chunk: (out if key.data=='out' else err).extend(chunk)\n else: selector.unregister(key.fileobj);key.fileobj.close()\n rows=table()\n alive={pid:birth for pid,birth in tracked.items() if pid in rows and rows[pid][2]==birth}\n if leader.poll() is not None and not alive and not selector.get_map(): break\n if time.monotonic()>recovery:\n meta['exceptions'].append('recovery_deadline');break\n time.sleep(0.005)\n meta['leader_rc']=leader.poll();meta['reaped']=meta['leader_rc'] is not None\n rows=table()\n alive={pid:birth for pid,birth in tracked.items() if pid in rows and rows[pid][2]==birth}\n meta['descendants_absent']=not alive\n meta['pg_absent']=not any(row[1]==leader.pid for row in rows.values())\n meta['tokens']=[[pid,birth] for pid,birth in sorted(tracked.items())]\n meta['elapsed']=time.monotonic()-start\n meta['controlled_rc']=124 if meta['timeout'] else meta['leader_rc']\n for name,data in [('out',out),('err',err)]:\n meta[name+'_length']=len(data);meta[name+'_sha256']=hashlib.sha256(data).hexdigest()\n wire={'meta':meta,'out':base64.b64encode(out).decode(),'err':base64.b64encode(err).decode()}\n sys.stdout.buffer.write(base64.b64encode(zlib.compress(json.dumps(wire,separators=(',',':')).encode(),9)))\n sys.stdout.buffer.flush()\n"
SUPPORT = {'Makefile': 'Q0MgPSBnY2MKQ0ZMQUdTID0gLXN0ZD1jMTEgLU8yIC1XYWxsIC1XZXh0cmEgLVdlcnJvciAtSWluY2x1ZGUKU09VUkNFUyA9IHNyYy90ZW5zb3JfYnJpZGdlLmMgc3JjL3RlbnNvcl9zZXNzaW9uLmMgdG9vbHMvb2JzZXJ2ZS5jCmFsbDogb2JzZXJ2ZQpvYnNlcnZlOiAkKFNPVVJDRVMpIGluY2x1ZGUvdGVuc29yX2JyaWRnZS5oCgkkKENDKSAkKENGTEFHUykgJChTT1VSQ0VTKSAtbyAkQApkZW1vOiBvYnNlcnZlCglwcmludGYgJ0EgMSAxIDIgMiAzIDIgMVxuTyAxIDAgMVxuQiA3IDQwOTYgNDA5NiAwXG5IXG4nIHwgLi9vYnNlcnZlCmNsZWFuOgoJcm0gLWYgb2JzZXJ2ZQouUEhPTlk6IGFsbCBkZW1vIGNsZWFuCg==', 'README.md': 'IyBUZW5zb3IgYnJpZGdlIG1haW50ZW5hbmNlIHdvcmtzcGFjZQoKVGhpcyBDMTEgc29mdHdhcmUgcGFja2FnZSBtb3ZlcyBib3VuZGVkIHRlbnNvciBieXRlIHNlcXVlbmNlcyBiZXR3ZWVuIGRlcGxveW1lbnQgbGF5b3V0cyBhbmQgbWFuYWdlcyByZXVzYWJsZSBtb2RlbCBzZXNzaW9ucy4gSXQgc2ltdWxhdGVzIHRoZSBkYXRhIGJvdW5kYXJ5IG9ubHk7IG5vIEJQVSwgRE1BLCBtb2RlbCBleGVjdXRpb24gb3IgYWNjdXJhY3kgaXMgcmVwcmVzZW50ZWQuCgpCdWlsZCB3aXRoIGBtYWtlYDsgcnVuIGBtYWtlIGRlbW9gLiBUaGUgb2JzZXJ2ZXIgaXMgYWxzbyBhbiBpbnRlcmFjdGl2ZSBsaW5lIHByb3RvY29sIGRyaXZlcjogYC4vb2JzZXJ2ZSA8IGV4YW1wbGVzL3Nlc3Npb24udHh0YC4gUmVxdWlyZW1lbnRzIGFuZCBlcnJvciBydWxlcyBhcmUgaW4gYGRvY3MvY29udHJhY3QubWRgLCB0aGUgb2JzZXJ2ZXIgZm9ybWF0IGluIGBkb2NzL29ic2VydmVyLm1kYC4gTGlicmFyeSBkZWNsYXJhdGlvbnMgYXJlIGluIGBpbmNsdWRlL3RlbnNvcl9icmlkZ2UuaGAuCg==', 'examples/session.txt': 'QSAxIDEgMiAyIDMgMiAxCk8gMSAwIDEKQiA3IDQwOTYgNDA5NiAwCkgKQwo=', 'tools/observe.c': 'I2luY2x1ZGUgInRlbnNvcl9icmlkZ2UuaCIKI2luY2x1ZGUgPHN0ZGlvLmg+CiNpbmNsdWRlIDxzdGRsaWIuaD4KI2luY2x1ZGUgPHN0cmluZy5oPgojaW5jbHVkZSA8aW50dHlwZXMuaD4Kc3RhdGljIHZvaWQgYnl0ZXMoY29uc3QgdW5zaWduZWQgY2hhciAqZGF0YSxzaXplX3QgY291bnQpCnsKICAgIGZvcihzaXplX3QgaT0wO2k8Y291bnQ7aSsrKSBwcmludGYoIiUwMngiLGRhdGFbaV0pOwp9CnN0YXRpYyB2b2lkIHN0YXRlKHRiX3Nlc3Npb24gKnMsdGJfY2F0YWxvZyAqYykKewogICAgcHJpbnRmKCIgJWQgJSIgUFJJdTY0ICIgJSIgUFJJdTY0ICIgJSIgUFJJdTY0ICIgJXUgJXp1ICUiIFBSSXU2NCwKICAgICAgICBzLT5hY3RpdmUscy0+Z2VuZXJhdGlvbixzLT5jYWxscyxzLT50cmFuc2ZlcnJlZCxzLT5tb2RlbC5pZCxjLT5jb3VudCxjLT5yZXZpc2lvbik7Cn0Kc3RhdGljIHRiX21vZGVsIG1vZGVsKHVuc2lnbmVkIGlkLHNpemVfdCBuLHNpemVfdCBoLHNpemVfdCB3LHNpemVfdCBjLGludCB0LGludCBsKQp7CiAgICB0Yl9tb2RlbCBtOwogICAgbWVtc2V0KCZtLDAsc2l6ZW9mIG0pOwogICAgbS5pZD1pZDttLnNoYXBlPSh0Yl9zaGFwZSl7bixoLHcsY307bS50eXBlPSh0Yl90eXBlKXQ7bS5sYXlvdXQ9KHRiX2xheW91dClsOwogICAgcmV0dXJuIG07Cn0KaW50IG1haW4odm9pZCkKewogICAgY2hhciBvcFs4XTsKICAgIHRiX3Nlc3Npb24gc2Vzc2lvbjt0Yl9jYXRhbG9nIGNhdGFsb2c7CiAgICB0Yl9zZXNzaW9uX2luaXQoJnNlc3Npb24pO3RiX2NhdGFsb2dfaW5pdCgmY2F0YWxvZyk7CiAgICB3aGlsZShzY2FuZigiJTdzIixvcCk9PTEpIHsKICAgICAgICBpbnQgcmM9MDsKICAgICAgICBpZighc3RyY21wKG9wLCJBIikgfHwgIXN0cmNtcChvcCwiUiIpIHx8ICFzdHJjbXAob3AsIlUiKSkgewogICAgICAgICAgICB1bnNpZ25lZCBpZDtzaXplX3QgbixoLHcsYztpbnQgdCxsOwogICAgICAgICAgICBpZihzY2FuZigiJXUlenUlenUlenUlenUlZCVkIiwmaWQsJm4sJmgsJncsJmMsJnQsJmwpIT03KSByZXR1cm4gMTE7CiAgICAgICAgICAgIHRiX21vZGVsIG09bW9kZWwoaWQsbixoLHcsYyx0LGwpOwogICAgICAgICAgICBpZihvcFswXT09J0EnKSByYz10Yl9jYXRhbG9nX2FkZCgmY2F0YWxvZywmbSk7CiAgICAgICAgICAgIGVsc2UgaWYob3BbMF09PSdSJykgcmM9dGJfY2F0YWxvZ19yZXBsYWNlKCZjYXRhbG9nLCZtKTsKICAgICAgICAgICAgZWxzZSByYz10Yl9jYXRhbG9nX2ltcG9ydCgmY2F0YWxvZywmbSwxKTsKICAgICAgICB9IGVsc2UgaWYoIXN0cmNtcChvcCwiWCIpKSB7CiAgICAgICAgICAgIHVuc2lnbmVkIGlkO2lmKHNjYW5mKCIldSIsJmlkKSE9MSkgcmV0dXJuIDExOwogICAgICAgICAgICByYz10Yl9jYXRhbG9nX3JlbW92ZSgmY2F0YWxvZyxpZCk7CiAgICAgICAgfSBlbHNlIGlmKCFzdHJjbXAob3AsIkYiKSB8fCAhc3RyY21wKG9wLCJMIikpIHsKICAgICAgICAgICAgdW5zaWduZWQgaWQ7aWYoc2NhbmYoIiV1IiwmaWQpIT0xKSByZXR1cm4gMTE7CiAgICAgICAgICAgIHRiX21vZGVsIG07bWVtc2V0KCZtLDAsc2l6ZW9mIG0pOwogICAgICAgICAgICByYz1vcFswXT09J0YnP3RiX2NhdGFsb2dfZmluZCgmY2F0YWxvZyxpZCwmbSk6dGJfY2F0YWxvZ19nZXQoJmNhdGFsb2csaWQsJm0pOwogICAgICAgICAgICBwcmludGYoIk0gJWQgJXUgJXp1ICV6dSAlenUgJXp1ICVkICVkXG4iLHJjLG0uaWQsbS5zaGFwZS5uLG0uc2hhcGUuaCxtLnNoYXBlLncsbS5zaGFwZS5jLG0udHlwZSxtLmxheW91dCk7CiAgICAgICAgICAgIGNvbnRpbnVlOwogICAgICAgIH0gZWxzZSBpZighc3RyY21wKG9wLCJWIikpIHsKICAgICAgICAgICAgdGJfY2F0YWxvZyBjb3B5O21lbXNldCgmY29weSwwLHNpemVvZiBjb3B5KTsKICAgICAgICAgICAgcmM9dGJfY2F0YWxvZ19jb3B5KCZjb3B5LCZjYXRhbG9nKTsKICAgICAgICAgICAgcHJpbnRmKCJWICVkICVkICV6dSAlIiBQUkl1NjQgIlxuIixyYyx0Yl9jYXRhbG9nX3ZhbGlkYXRlKCZjYXRhbG9nKSxjb3B5LmNvdW50LGNvcHkucmV2aXNpb24pOwogICAgICAgICAgICBjb250aW51ZTsKICAgICAgICB9IGVsc2UgaWYoIXN0cmNtcChvcCwiTyIpKSB7CiAgICAgICAgICAgIHVuc2lnbmVkIGlkO2ludCBpLG87aWYoc2NhbmYoIiV1JWQlZCIsJmlkLCZpLCZvKSE9MykgcmV0dXJuIDExOwogICAgICAgICAgICByYz10Yl9zZXNzaW9uX3NlbGVjdCgmc2Vzc2lvbiwmY2F0YWxvZyxpZCwodGJfY29uZmlnKXsodGJfbGF5b3V0KWksKHRiX2xheW91dClvfSk7CiAgICAgICAgfSBlbHNlIGlmKCFzdHJjbXAob3AsIkMiKSkgcmM9dGJfc2Vzc2lvbl9jbG9zZSgmc2Vzc2lvbik7CiAgICAgICAgZWxzZSBpZighc3RyY21wKG9wLCJaIikpIHJjPXRiX3Nlc3Npb25fcmVzZXRfc3RhdHMoJnNlc3Npb24pOwogICAgICAgIGVsc2UgaWYoIXN0cmNtcChvcCwiSCIpKSB7CiAgICAgICAgICAgIHRiX21vZGVsIG07dGJfY29uZmlnIGM7dWludDY0X3QgdlszXTsKICAgICAgICAgICAgbWVtc2V0KCZtLDAsc2l6ZW9mIG0pO21lbXNldCgmYywwLHNpemVvZiBjKTttZW1zZXQodiwwLHNpemVvZiB2KTsKICAgICAgICAgICAgcmM9dGJfc2Vzc2lvbl9pbmZvKCZzZXNzaW9uLCZtLCZjLHYpOwogICAgICAgICAgICBwcmludGYoIkggJWQgJXUgJWQgJWQgJSIgUFJJdTY0ICIgJSIgUFJJdTY0ICIgJSIgUFJJdTY0ICJcbiIscmMsbS5pZCxjLmlucHV0X2xheW91dCxjLmNvbmZpZ3VyZWRfbGF5b3V0LHZbMF0sdlsxXSx2WzJdKTsKICAgICAgICAgICAgY29udGludWU7CiAgICAgICAgfSBlbHNlIGlmKCFzdHJjbXAob3AsIkIiKSB8fCAhc3RyY21wKG9wLCJEIikpIHsKICAgICAgICAgICAgdW5zaWduZWQgc2VlZDtzaXplX3QgaW5fY2FwLG91dF9jYXA7aW50IG1vZGU7CiAgICAgICAgICAgIHRiX3BsYW4gcGxhbjttZW1zZXQoJnBsYW4sMCxzaXplb2YgcGxhbik7CiAgICAgICAgICAgIGludCBpbml0PTA7CiAgICAgICAgICAgIGlmKG9wWzBdPT0nRCcpIHsKICAgICAgICAgICAgICAgIHNpemVfdCBuLGgsdyxjO2ludCB0LGksbzsKICAgICAgICAgICAgICAgIGlmKHNjYW5mKCIlenUlenUlenUlenUlZCVkJWQiLCZuLCZoLCZ3LCZjLCZ0LCZpLCZvKSE9NykgcmV0dXJuIDExOwogICAgICAgICAgICAgICAgaW5pdD10Yl9wbGFuX2luaXQoJnBsYW4sKHRiX3NoYXBlKXtuLGgsdyxjfSwodGJfdHlwZSl0LCh0Yl9sYXlvdXQpaSwodGJfbGF5b3V0KW8pOwogICAgICAgICAgICB9IGVsc2UgcGxhbj1zZXNzaW9uLnBsYW47CiAgICAgICAgICAgIGlmKHNjYW5mKCIldSV6dSV6dSVkIiwmc2VlZCwmaW5fY2FwLCZvdXRfY2FwLCZtb2RlKSE9NCkgcmV0dXJuIDExOwogICAgICAgICAgICB1bnNpZ25lZCBjaGFyIGlucHV0WzgxOTJdLG91dHB1dFs0MDk2XTsKICAgICAgICAgICAgZm9yKHNpemVfdCBrPTA7azxzaXplb2YgaW5wdXQ7aysrKSBpbnB1dFtrXT0odW5zaWduZWQgY2hhcikoc2VlZCtrKjM3KyhrLzMpKjExKTsKICAgICAgICAgICAgaWYobW9kZT09MykgewogICAgICAgICAgICAgICAgY29uc3QgdW5zaWduZWQgY2hhciBwYXR0ZXJuc1szMl09ezAsMCwwLDAsMCwwLDAsMTI4LDAsMCwxMjgsMTI3LDAsMCwxMjgsMjU1LDEsMCwxOTIsMTI3LDEsMCwxMjgsMTI3LDAsMCwxMjgsNjMsMjU1LDI1NSwyNTUsMjU1fTsKICAgICAgICAgICAgICAgIGZvcihzaXplX3Qgaz0wO2s8c2l6ZW9mIGlucHV0O2srKylpbnB1dFtrXT1wYXR0ZXJuc1soaytzZWVkJTMyKSUzMl07CiAgICAgICAgICAgIH0KICAgICAgICAgICAgbWVtc2V0KG91dHB1dCwweGE1LHNpemVvZiBvdXRwdXQpOwogICAgICAgICAgICBzaXplX3QgY291bnQ9cGxhbi5ieXRlczw9NDA5NiAmJiBwbGFuLmJ5dGVzP3BsYW4uYnl0ZXM6MzI7CiAgICAgICAgICAgIHZvaWQgKmRlc3Q9bW9kZT09MT9pbnB1dCsxOm91dHB1dDsKICAgICAgICAgICAgaWYobW9kZT09MikgcGxhbi5pbnB1dF9zdHJpZGVbMF0rKzsKICAgICAgICAgICAgaWYoaW5pdCkgcmM9aW5pdDsKICAgICAgICAgICAgZWxzZSBpZihvcFswXT09J0QnKSByYz10Yl9jb252ZXJ0KCZwbGFuLGlucHV0LGluX2NhcCxkZXN0LG91dF9jYXApOwogICAgICAgICAgICBlbHNlIHJjPXRiX3Nlc3Npb25fcnVuKCZzZXNzaW9uLGlucHV0LGluX2NhcCxkZXN0LG91dF9jYXApOwogICAgICAgICAgICBwcmludGYoIiVzICVkICVkICV6dSAlenUiLG9wLHJjLGluaXQscGxhbi5lbGVtZW50cyxwbGFuLmJ5dGVzKTsKICAgICAgICAgICAgc3RhdGUoJnNlc3Npb24sJmNhdGFsb2cpOwogICAgICAgICAgICBwdXRjaGFyKCcgJyk7Ynl0ZXMob3V0cHV0LGNvdW50KTtwdXRjaGFyKCcgJyk7Ynl0ZXMoaW5wdXQsY291bnQpO3B1dGNoYXIoJ1xuJyk7CiAgICAgICAgICAgIGNvbnRpbnVlOwogICAgICAgIH0gZWxzZSBpZighc3RyY21wKG9wLCJJIikpIHsKICAgICAgICAgICAgc2l6ZV90IG4saCx3LGMsaW5kZXg7aW50IGw7CiAgICAgICAgICAgIGlmKHNjYW5mKCIlenUlenUlenUlenUlZCV6dSIsJm4sJmgsJncsJmMsJmwsJmluZGV4KSE9NikgcmV0dXJuIDExOwogICAgICAgICAgICBzaXplX3Qgdls0XT17OTksOTksOTksOTl9LG9mZnNldD05OTt0Yl9zaGFwZSBzPXtuLGgsdyxjfTsKICAgICAgICAgICAgcmM9dGJfY29vcmRpbmF0ZShzLCh0Yl9sYXlvdXQpbCxpbmRleCx2KTsKICAgICAgICAgICAgaW50IHJjMj10Yl9vZmZzZXQocywodGJfbGF5b3V0KWwsdiwmb2Zmc2V0KTsKICAgICAgICAgICAgcHJpbnRmKCJJICVkICVkICV6dSAlenUgJXp1ICV6dSAlenVcbiIscmMscmMyLHZbMF0sdlsxXSx2WzJdLHZbM10sb2Zmc2V0KTsKICAgICAgICAgICAgY29udGludWU7CiAgICAgICAgfSBlbHNlIGlmKCFzdHJjbXAob3AsIkoiKSkgewogICAgICAgICAgICBzaXplX3QgbixoLHcsYztpbnQgdCxpLG87CiAgICAgICAgICAgIGlmKHNjYW5mKCIlenUlenUlenUlenUlZCVkJWQiLCZuLCZoLCZ3LCZjLCZ0LCZpLCZvKSE9NykgcmV0dXJuIDExOwogICAgICAgICAgICB0Yl9wbGFuIGEsYixkO21lbXNldCgmYSwwLHNpemVvZiBhKTttZW1zZXQoJmIsMCxzaXplb2YgYik7bWVtc2V0KCZkLDAsc2l6ZW9mIGQpOwogICAgICAgICAgICByYz10Yl9wbGFuX2luaXQoJmEsKHRiX3NoYXBlKXtuLGgsdyxjfSwodGJfdHlwZSl0LCh0Yl9sYXlvdXQpaSwodGJfbGF5b3V0KW8pOwogICAgICAgICAgICBpbnQgcj10Yl9wbGFuX2ludmVyc2UoJmEsJmIpLHE9dGJfcGxhbl9jaGFpbigmYSwmYiwmZCk7CiAgICAgICAgICAgIHByaW50ZigiSiAlZCAlZCAlZCAlZCAlZCAlZCAlZCAlenVcbiIscmMscixxLGIuaW5wdXRfbGF5b3V0LGIub3V0cHV0X2xheW91dCxkLmlucHV0X2xheW91dCxkLm91dHB1dF9sYXlvdXQsZC5ieXRlcyk7CiAgICAgICAgICAgIGNvbnRpbnVlOwogICAgICAgIH0gZWxzZSByZXR1cm4gMTI7CiAgICAgICAgcHJpbnRmKCJTICVkIixyYyk7c3RhdGUoJnNlc3Npb24sJmNhdGFsb2cpO3B1dGNoYXIoJ1xuJyk7CiAgICB9CiAgICByZXR1cm4gZmVycm9yKHN0ZGluKT8xMzowOwp9Cg==', 'docs/contract.md': 'IyBUZW5zb3IgYnJpZGdlIGNvbnRyYWN0ICh2ZXJzaW9uIDEpCgoxLiBMb2dpY2FsIGNvb3JkaW5hdGVzIGFsd2F5cyB1c2UgYChuLGgsdyxjKWAuIEEgc2hhcGUgaXMgdmFsaWQgaWZmIGAxPD1uPD00YCwgYDE8PWgsdyxjPD04YCBhbmQgYG4qaCp3KmM8PTEwMjRgLiBJbnZhbGlkIHNoYXBlIHJldHVybnMgVEJfU0hBUEUuIExheW91dCB2YWx1ZXMgYXJlIE5IV0M9MCBhbmQgTkNIVz0xOyBvdGhlciB2YWx1ZXMgcmV0dXJuIFRCX0xBWU9VVC4gVHlwZXMgSTE2PTAsIEkzMj0xLCBGMzI9MiBoYXZlIHdpZHRocyAyLDQsNCBieXRlczsgb3RoZXIgdHlwZXMgcmV0dXJuIFRCX1RZUEUuIFRoZSBsaWJyYXJ5IG1vdmVzIGJ5dGVzIHdpdGhvdXQgbnVtZXJpYyBjb252ZXJzaW9uOyBhbGwgMzItYml0IGZsb2F0IGVuY29kaW5ncywgaW5jbHVkaW5nIHNpZ25lZCB6ZXJvLCBpbmZpbml0aWVzIGFuZCBOYU5zLCByZXRhaW4gdGhlaXIgYml0IHBhdHRlcm5zLgoyLiBOSFdDIHN0b3JlcyBjIGZhc3Rlc3QsIHRoZW4gdywgaCwgbi4gTkNIVyBzdG9yZXMgdyBmYXN0ZXN0LCB0aGVuIGgsIGMsIG4uIGB0Yl9zdHJpZGVzYCByZXBvcnRzIHN0cmlkZXMgaW4gbG9naWNhbCBgKG4saCx3LGMpYCBvcmRlci4gYHRiX29mZnNldGAgbWFwcyBpbi1yYW5nZSBjb29yZGluYXRlczsgYHRiX2Nvb3JkaW5hdGVgIGlzIGl0cyBpbnZlcnNlIGZvciBpbmRpY2VzIHNtYWxsZXIgdGhhbiBlbGVtZW50IGNvdW50LiBJbnZhbGlkIGNvb3JkaW5hdGVzIG9yIGluZGljZXMgcmV0dXJuIFRCX1NIQVBFLiBFYWNoIGZhaWxlZCBvdXRwdXQtcGFyYW1ldGVyIG9wZXJhdGlvbiBsZWF2ZXMgaXRzIG91dHB1dCB1bmNoYW5nZWQuCjMuIGB0Yl9wbGFuX2luaXRgIHZhbGlkYXRlcyBzaGFwZSwgbGF5b3V0cywgdHlwZSBpbiB0aGF0IG9yZGVyIGFuZCByZWNvcmRzIGVsZW1lbnQgY291bnQsIGJ5dGUgbGVuZ3RoLCB3aWR0aHMgYW5kIGJvdGggc3RyaWRlcy4gYHRiX3BsYW5fY2hlY2tgIGNoZWNrcyBhbGwgdGhlc2UgZGVyaXZlZCBmaWVsZHM7IGluY29uc2lzdGVudCB2YWxpZC1wbGFuIGZpZWxkcyByZXR1cm4gVEJfQ09ORklHLiBgdGJfcGxhbl9pbnZlcnNlYCBzd2FwcyB0aGUgbGF5b3V0cy4gYHRiX3BsYW5fY2hhaW5gIHJlcXVpcmVzIG1hdGNoaW5nIHNoYXBlIGFuZCB0eXBlLCBhbmQgZmlyc3Qgb3V0cHV0IGVxdWFsIHRvIHNlY29uZCBpbnB1dDsgb3RoZXJ3aXNlIFRCX0NPTkZJRy4gU3VjY2Vzc2Z1bCBjaGFpbiBtYXBzIGZpcnN0IGlucHV0IGRpcmVjdGx5IHRvIHNlY29uZCBvdXRwdXQuIEFsbCBwbGFuIGZhaWx1cmVzIGxlYXZlIGRlc3RpbmF0aW9uIHBsYW5zIHVuY2hhbmdlZC4KNC4gYHRiX2NvbnZlcnRgIGNoZWNrcyB0aGUgcGxhbiwgbm9uLW51bGwgaW5wdXQvb3V0cHV0LCB0aGVuIGJ5dGUgY2FwYWNpdGllcywgdGhlbiBvdmVybGFwLCBpbiB0aGF0IG9yZGVyLiBFYWNoIGNhcGFjaXR5IG11c3QgY292ZXIgZXhhY3RseSB0aGUgcGxhbiBieXRlIGxlbmd0aCwgaW5kZXBlbmRlbnQgb2YgdW51c2VkIGNhcGFjaXR5IHRhaWxzLiBBbnkgaW50ZXJzZWN0aW9uIG9mIHRoZSB0d28gZWZmZWN0aXZlIGJ5dGUgcmFuZ2VzIChpbmNsdWRpbmcgaWRlbnRpY2FsIGFkZHJlc3NlcykgcmV0dXJucyBUQl9PVkVSTEFQLiBTdWNjZXNzZnVsIGNvbnZlcnNpb24gbW92ZXMgZXZlcnkgbG9naWNhbCBlbGVtZW50IGZyb20gaXRzIGlucHV0LWxheW91dCBvZmZzZXQgdG8gaXRzIG91dHB1dC1sYXlvdXQgb2Zmc2V0LCBwcmVzZXJ2aW5nIGlucHV0LCBhbmQgd3JpdGVzIG9ubHkgdGhlIGVmZmVjdGl2ZSBkZXN0aW5hdGlvbiByYW5nZS4gQW55IGZhaWx1cmUgcHJlc2VydmVzIGJvdGggYnVmZmVycy4gQ2FsbGVyIHN1cHBsaWVzIHZhbGlkIG1lbW9yeSBmb3IgYWR2ZXJ0aXNlZCBjYXBhY2l0aWVzOyBubyBtYWxmb3JtZWQgcG9pbnRlcnMgYXJlIGluIHNjb3BlLgo1LiBBIG1vZGVsIGhhcyBhIG5vbnplcm8gMzItYml0IGlkLCB2YWxpZCBzaGFwZSwgdHlwZSBhbmQgdGFyZ2V0IGxheW91dC4gYHRiX21vZGVsX2NoZWNrYCByZXR1cm5zIFRCX0FSR1VNRU5UIGZvciBudWxsIG1vZGVsL2lkMCBhbmQgb3RoZXJ3aXNlIHVzZXMgcGxhbiB2YWxpZGF0aW9uLiBBIGNhdGFsb2cgY29udGFpbnMgYXQgbW9zdCBlaWdodCB1bmlxdWUgaWRzIGluIGluc2VydGlvbiBvcmRlciwgd2l0aCByZXZpc2lvbiBpbml0aWFsbHkgemVyby4gQWRkIHZhbGlkYXRlcyBtb2RlbCB0aGVuIHJlamVjdHMgZHVwbGljYXRlcyBUQl9EVVBMSUNBVEUsIHRoZW4gZnVsbCBjYXRhbG9nL3JldmlzaW9uIG92ZXJmbG93IFRCX0NBUEFDSVRZLiBGaW5kL2dldCByZXR1cm4gVEJfTk9UX0ZPVU5EIGZvciBhYnNlbnQgaWQvb3V0LW9mLXJhbmdlIGluZGV4IGFuZCBwcmVzZXJ2ZSBkZXN0aW5hdGlvbi4gUmVwbGFjZSByZXF1aXJlcyBhbiBleGlzdGluZyBpZDsgcmVtb3ZlIGNvbXBhY3RzIGluc2VydGlvbiBvcmRlci4gRWFjaCBzdWNjZXNzZnVsIGFkZC9yZXBsYWNlL3JlbW92ZSBpbmNyZW1lbnRzIHJldmlzaW9uIG9uY2U7IGZhaWx1cmUgY2hhbmdlcyBub3RoaW5nLiBSZW1vdmluZy9maW5kIGlkMCByZXR1cm5zIFRCX0FSR1VNRU5ULiBSZXZpc2lvbnMgbWF5IHJlYWNoIFVJTlQ2NF9NQVggYnV0IGNhbm5vdCB3cmFwLiBVbnVzZWQgbW9kZWwgc2xvdHMgYXJlIG91dHNpZGUgdGhlIG9ic2VydmFibGUgY29udHJhY3QuCjYuIENhdGFsb2cgdmFsaWRhdGUgY2hlY2tzIGNvdW50LCBlYWNoIG1vZGVsLCBhbmQgdW5pcXVlbmVzcy4gQ29weSBjb3BpZXMgYSB2YWxpZCBjYXRhbG9nIHRyYW5zYWN0aW9uYWxseS4gSW1wb3J0IGFkZHMgYSBtb2RlbCBzZXF1ZW5jZSB0cmFuc2FjdGlvbmFsbHksIHJldHVybmluZyBUQl9DQVBBQ0lUWSBpZiBjb3VudCBleGNlZWRzIGF2YWlsYWJsZSBzbG90cyBiZWZvcmUgcmVhZGluZyB0aGUgc2VxdWVuY2UuIEEgbnVsbCBzZXF1ZW5jZSBpcyBwZXJtaXR0ZWQgb25seSBmb3IgY291bnQwLiBEdXBsaWNhdGUsIGludmFsaWQgb3IgY2FwYWNpdHkgZmFpbHVyZSBsZWF2ZXMgdGhlIGNhdGFsb2cgdW5jaGFuZ2VkLiBBIGNvdW50IGFib3ZlIGVpZ2h0IGlzIFRCX1NUQVRFLgo3LiBJbml0IHplcm9lcyBhIGNhdGFsb2cgb3Igc2Vzc2lvbjsgbnVsbCBpbml0IGlzIGEgbm8tb3AuIE9wZW4gcmVxdWlyZXMgYW4gaW5hY3RpdmUgaW5pdGlhbGl6ZWQgc2Vzc2lvbjsgcmVjb25maWd1cmUgcmVxdWlyZXMgYWN0aXZlLiBWYWxpZGF0ZSB0aGUgbW9kZWwsIHRoZW4gY29uZmlndXJlZC1sYXlvdXQgZW51bSwgdGhlbiByZXF1aXJlIGNvbmZpZ3VyZWQgbGF5b3V0IHRvIGVxdWFsIG1vZGVsIHRhcmdldCAoVEJfQ09ORklHIG90aGVyd2lzZSksIHRoZW4gdmFsaWRhdGUgaW5wdXQgbGF5b3V0IGJ5IHBsYW4gY29uc3RydWN0aW9uLiBFdmVyeSBzdWNjZXNzZnVsIG9wZW4gaW5jcmVtZW50cyByZXRhaW5lZCBnZW5lcmF0aW9uIGFuZCByZXNldHMgY2FsbHMvdHJhbnNmZXJyZWQ7IHJlY29uZmlndXJlIGluY3JlbWVudHMgZ2VuZXJhdGlvbiBhbmQgcHJlc2VydmVzIGNhbGxzL3RyYW5zZmVycmVkLiBPdmVyZmxvdyByZXR1cm5zIFRCX0NBUEFDSVRZLiBGYWlsdXJlIGxlYXZlcyB0aGUgd2hvbGUgc2Vzc2lvbiB1bmNoYW5nZWQuIFNlbGVjdCBmaW5kcyB0aGUgY2F0YWxvZyBtb2RlbCBhbmQgY2FsbHMgb3BlbiBvciByZWNvbmZpZ3VyZSBhY2NvcmRpbmcgdG8gYWN0aXZlIHN0YXRlLiBDYXRhbG9nIGVkaXRzIGFmdGVyIHNlbGVjdGlvbiBkbyBub3QgYWx0ZXIgdGhlIHNlbGVjdGVkIG1vZGVsIHNuYXBzaG90Lgo4LiBSdW4gcmVxdWlyZXMgYWN0aXZlIHN0YXRlLCBhIGNvaGVyZW50IG1vZGVsL2NvbmZpZy9wbGFuIHNuYXBzaG90LCBhbmQgbm9uLW92ZXJmbG93aW5nIGNvdW50ZXJzLiBJdCBkZWxlZ2F0ZXMgdG8gdGhlIGNvbnZlcnNpb24gY29udHJhY3QuIE9uIHN1Y2Nlc3Mgb25seSwgY2FsbHMgaW5jcmVtZW50cyBvbmNlIGFuZCB0cmFuc2ZlcnJlZCBpbmNyZWFzZXMgYnkgZWZmZWN0aXZlIGJ5dGVzLiBGYWlsdXJlIHByZXNlcnZlcyBzZXNzaW9uIGFuZCBidWZmZXJzLiBSZXNldCBzdGF0cyByZXF1aXJlcyBhIGNvaGVyZW50IGFjdGl2ZSBzZXNzaW9uIGFuZCB6ZXJvZXMgY2FsbHMvdHJhbnNmZXJyZWQgb25seS4gQ2xvc2UgcmVxdWlyZXMgYWN0aXZlIHNlc3Npb24sIGNsZWFycyBpdHMgbW9kZWwvY29uZmlnL3BsYW4vY291bnRlcnMgYW5kIGFjdGl2ZSBmbGFnLCByZXRhaW5pbmcgZ2VuZXJhdGlvbi4gUmVwZWF0ZWQgY2xvc2UgcmV0dXJucyBUQl9TVEFURS4gSW5mbyByZXF1aXJlcyBjb2hlcmVudCBhY3RpdmUgc3RhdGUgYW5kIG5vbi1udWxsIG91dHB1dHMgYW5kIHJldHVybnMgbW9kZWwvY29uZmlnIGFuZCBgW2dlbmVyYXRpb24sY2FsbHMsdHJhbnNmZXJyZWRdYCwgbGVhdmluZyBvdXRwdXRzIHVuY2hhbmdlZCBvbiBmYWlsdXJlLgo5LiBBbnkgcmVxdWlyZWQgbnVsbCBhcmd1bWVudCByZXR1cm5zIFRCX0FSR1VNRU5UOyB0aGUgb3JkZXIgZm9yIGNvbXBvdW5kIHZhbGlkYXRpb24gZm9sbG93cyB0aGUgY2xhdXNlcyBhYm92ZS4gTnVsbCBzZXNzaW9uIGlzIGNoZWNrZWQgYmVmb3JlIGFjdGl2ZSBzdGF0ZS4gQ2F0YWxvZyBudWxsL2NvdW50IHZhbGlkaXR5IGlzIGNoZWNrZWQgYmVmb3JlIGNhdGFsb2cgb3BlcmF0aW9ucy4gU3RhdHVzIG51bWVyaWMgdmFsdWVzIGFuZCBleGFjdCBBUEkgZGVjbGFyYXRpb25zIGFyZSBpbiB0aGUgcHVibGljIGhlYWRlci4gTm8gc3RkZXJyIGZvcm1hdCBvciBzaXplIGNvbnN0cmFpbnQgYXBwbGllczsgYXJiaXRyYXJ5IGRpYWdub3N0aWMgYnl0ZXMgYXJlIHBlcm1pdHRlZC4gU3VjY2Vzc2Z1bCBsaWJyYXJ5L29ic2VydmVyIGJlaGF2aW9yIG11c3QgZmluaXNoIG5vcm1hbGx5IHdpdGhpbiBvcmRpbmFyeSByZXNvdXJjZSBib3VuZHM7IHRoZSBwcm9kdWN0aW9uIGdyYWRlciBhbGxvd3MgY29tcGlsZXIgMjBzIGFuZCBvYnNlcnZlciAyMHMsIHBsdXMgc2VwYXJhdGUgY2xlYW51cCBhbmQgYWJzZW5jZSBkZWFkbGluZXMgb2YgNXMgZWFjaC4gVGltaW5nL09TIHByb2Nlc3MgYmVoYXZpb3IgaXMgb3V0c2lkZSB0aGlzIHRlbnNvciBBUEkuCg==', 'docs/observer.md': 'IyBSYXcgb2JzZXJ2YXRpb24gZHJpdmVyCgpUaGUgZHJpdmVyIGB0b29scy9vYnNlcnZlLmNgIG9ubHkgaW52b2tlcyBwdWJsaWMgQVBJcyBhbmQgcHJpbnRzIG9ic2VydmF0aW9ucy4gSXQgaGFzIG5vIGV4cGVjdGVkIHZhbHVlcyBvciBhc3NlcnRpb25zLiBBbGwgaW50ZWdlcnMgaW4gaW5wdXQgYXJlIGRlY2ltYWw7IG9uZSBjb21tYW5kIHBlciBsaW5lLiBJbml0aWFsIHNlc3Npb24gYW5kIGNhdGFsb2cgYXJlIHplcm8gaW5pdGlhbGl6ZWQuIEVhY2ggZ2VuZXJpYyBjb21tYW5kIHByaW50cyBgUyBzdGF0dXMgYWN0aXZlIGdlbmVyYXRpb24gY2FsbHMgdHJhbnNmZXJyZWQgc2VsZWN0ZWRfaWQgY2F0YWxvZ19jb3VudCBjYXRhbG9nX3JldmlzaW9uYC4KCi0gYEEvUi9VIGlkIG4gaCB3IGMgdHlwZSBsYXlvdXRgOiBhZGQsIHJlcGxhY2Ugb3IgaW1wb3J0IG9uZSBtb2RlbC4gYFggaWRgOiByZW1vdmUuIGBPIGlkIGlucHV0X2xheW91dCBjb25maWd1cmVkX2xheW91dGA6IHNlbGVjdC9vcGVuL3JlY29uZmlndXJlLiBgQ2A6IGNsb3NlOyBgWmA6IHJlc2V0IHN0YXRzLgotIGBGIGlkYCBhbmQgYEwgaW5kZXhgOiBmaW5kL2dldDsgcHJpbnQgYE0gc3RhdHVzIGlkIG4gaCB3IGMgdHlwZSBsYXlvdXRgLCB3aXRoIGEgemVyby1pbml0aWFsaXplZCBkZXN0aW5hdGlvbi4gYFZgOiBjb3B5L3ZhbGlkYXRlOyBwcmludCBgViBjb3B5X3N0YXR1cyB2YWxpZGF0ZV9zdGF0dXMgY29waWVkX2NvdW50IGNvcGllZF9yZXZpc2lvbmAuCi0gYEhgOiBpbmZvOyBwcmludCBgSCBzdGF0dXMgaWQgaW5wdXRfbGF5b3V0IGNvbmZpZ3VyZWRfbGF5b3V0IGdlbmVyYXRpb24gY2FsbHMgdHJhbnNmZXJyZWRgLCB3aXRoIHplcm8taW5pdGlhbGl6ZWQgZGVzdGluYXRpb24gb3V0cHV0cy4KLSBgQiBzZWVkIGlucHV0X2NhcGFjaXR5IG91dHB1dF9jYXBhY2l0eSBtb2RlYDogcnVuIGN1cnJlbnQgc2Vzc2lvbi4gYEQgbiBoIHcgYyB0eXBlIGlucHV0X2xheW91dCBvdXRwdXRfbGF5b3V0IHNlZWQgaW5wdXRfY2FwYWNpdHkgb3V0cHV0X2NhcGFjaXR5IG1vZGVgOiBpbml0IGFuZCBjb252ZXJ0IGEgc3RhbmRhbG9uZSBwbGFuLiBCb3RoIGFsbG9jYXRlIHNlcGFyYXRlIDgxOTItYnl0ZSBpbnB1dCBhbmQgNDA5Ni1ieXRlIG91dHB1dCBhcnJheXM7IG9ubHkgdGhlIGZpcnN0IDQwOTYgaW5wdXQgYnl0ZXMgcGFydGljaXBhdGUgaW4gdGhlIGJvdW5kZWQgdGVuc29yIHByb3RvY29sLiBJbnB1dCBieXRlIGsgaXMgYChzZWVkKzM3KmsrMTEqKGsvMykpIG1vZHVsbyAyNTZgLCBpbnRlZ2VyIGRpdmlzaW9uLiBPdXRwdXQgc3RhcnRzIGF0IGhleCBhNS4gTW9kZTAgdXNlcyBzZXBhcmF0ZSBvdXRwdXQ7IG1vZGUxIHBvaW50cyBkZXN0aW5hdGlvbiB0byBpbnB1dCsxIHRvIGV4cG9zZSBvdmVybGFwLiBNb2RlMyByZXBsYWNlcyB0aGUgZ2VuZXJhdGVkIGlucHV0IHdpdGggYSByZXBlYXRpbmcgMzItYnl0ZSBzZXF1ZW5jZSwgcm90YXRlZCBieSBzZWVkIG1vZHVsbzMyOiBgMDAwMDAwMDAgMDAwMDAwODAgMDAwMDgwN2YgMDAwMDgwZmYgMDEwMGMwN2YgMDEwMDgwN2YgMDAwMDgwM2YgZmZmZmZmZmZgIChoZXggYnl0ZXMsIGxpdHRsZSBlbmRpYW4gZmxvYXQgZXhhbXBsZXMpLiBNb2RlMiBjaGFuZ2VzIHRoZSBsb2NhbCBzdGFuZGFsb25lIHBsYW4ncyBmaXJzdCBpbnB1dCBzdHJpZGUgYmVmb3JlIGNvbnZlcnNpb247IGZvciBCIHRoZSBsb2NhbCBwcmludGVkIHBsYW4gY2hhbmdlcyBidXQgdGhlIHNlc3Npb24gcnVuIHJlbWFpbnMgdW5jaGFuZ2VkLiBUaGVzZSBjb21tYW5kcyBwcmludCBgQi9EIHN0YXR1cyBpbml0X3N0YXR1cyBlbGVtZW50cyBieXRlc2AsIHRoZW4gdGhlIHNldmVuIHN0YXRlIGZpZWxkcyBhZnRlciBnZW5lcmljIHN0YXR1cywgdGhlbiBsb3dlcmNhc2Ugb3V0cHV0IGFuZCBpbnB1dCBoZXguIEhleCBjb3ZlcnMgZWZmZWN0aXZlIGJ5dGVzIGlmIDEuLjQwOTYsIG90aGVyd2lzZSAzMiBieXRlcy4gQSBmYWlsZWQgRCBpbml0IHJlcG9ydHMgemVybyBwbGFuIGZpZWxkcyBhbmQgZG9lcyBub3QgY29udmVydC4gT25seSBlZmZlY3RpdmUgcmFuZ2VzIGFyZSBjb21wYXJlZDsgdW51c2VkIHRhaWxzIGhhdmUgbm8gZGVmaW5lZCBvdXRwdXQgcmVxdWlyZW1lbnQuCi0gYEkgbiBoIHcgYyBsYXlvdXQgaW5kZXhgOiBjb29yZGluYXRlIHRoZW4gb2Zmc2V0OyBvdXRwdXQgYEkgc3RhdHVzIGludmVyc2Vfc3RhdHVzIG4gaCB3IGMgb2Zmc2V0YC4gQ29vcmRpbmF0ZS9vZmZzZXQgc2VudGluZWxzIHN0YXJ0IGF0IDk5IGFuZCByZW1haW4gb24gZXJyb3IuCi0gYEogbiBoIHcgYyB0eXBlIGlucHV0X2xheW91dCBvdXRwdXRfbGF5b3V0YDogcGxhbiwgaW52ZXJzZSwgY2hhaW47IG91dHB1dCBgSiBpbml0X3N0YXR1cyBpbnZlcnNlX3N0YXR1cyBjaGFpbl9zdGF0dXMgaW52ZXJzZV9pbnB1dCBpbnZlcnNlX291dHB1dCBjaGFpbl9pbnB1dCBjaGFpbl9vdXRwdXQgY2hhaW5fYnl0ZXNgLiBQbGFucyBzdGFydCB6ZXJvZWQuCgpUaGUgb2JzZXJ2ZXIgYWNjZXB0cyBjb21tYW5kIHN0cmVhbXMgY29udGFpbmluZyB2YWxpZCBkZWNpbWFsIHRva2VuczsgdW5rbm93biBjb21tYW5kcyBvciBtaXNzaW5nIG9wZXJhbmRzIHRlcm1pbmF0ZSBub256ZXJvLiBTdWJtaXNzaW9uIG1heSBjaGFuZ2Ugb25seSB0aGUgbGlzdGVkIGxpYnJhcnkgZmlsZXMuIFRoZSBwdWJsaWMgZHJpdmVyL2hlYWRlci9kb2N1bWVudHMgcHJvdmlkZSB0aGUgZm9ybWFsIGludGVyZmFjZTsgcHJpdmF0ZSB2ZXJpZmljYXRpb24gcmVidWlsZHMgYSBmcmVzaCBjb3B5IG9mIHRoaXMgc2FtZSBkcml2ZXIgYW5kIGNvbXBhcmVzIHJhdyBvYnNlcnZhdGlvbnMgYWdhaW5zdCBhbiBpbmRlcGVuZGVudCBtb2RlbC4gQWRkaXRpb25hbCBzdGRlcnIgZGlhZ25vc3RpY3MgYXJlIGFsbG93ZWQsIGluY2x1ZGluZyBhcmJpdHJhcnkgYnl0ZXMuCg=='}
CANDIDATES = ['include/tensor_bridge.h', 'src/tensor_bridge.c', 'src/tensor_session.c']
import random
def shape_status(s):
n,h,w,c=s
return 0 if 1<=n<=4 and 1<=h<=8 and 1<=w<=8 and 1<=c<=8 and n*h*w*c<=1024 else 2
def plan_status(s,t,i,o):
return shape_status(s) or (3 if i not in (0,1) or o not in (0,1) else 4 if t not in (0,1,2) else 0)
def offset(s,l,n,h,w,c):
N,H,W,C=s
return ((n*H+h)*W+w)*C+c if l==0 else ((n*C+c)*H+h)*W+w
def coordinate(s,l,x):
n,h,w,c=s
if l==0:
C=x%c;x//=c;W=x%w;x//=w;H=x%h;return [x//h,H,W,C]
W=x%w;x//=w;H=x%h;x//=h;C=x%c;return [x//c,H,W,C]
def payload(seed,mode=0):
if mode==3:
pattern=bytes.fromhex('00000000000000800000807f000080ff0100c07f0100807f0000803fffffffff')
return bytes(pattern[(k+seed%32)%32] for k in range(4096))
return bytes((seed+37*k+11*(k//3))%256 for k in range(4096))
def transform(s,t,i,o,src):
width=2 if t==0 else 4
result=bytearray(len(src))
for n in range(s[0]):
for h in range(s[1]):
for w in range(s[2]):
for c in range(s[3]):
a=offset(s,i,n,h,w,c)*width;b=offset(s,o,n,h,w,c)*width
result[b:b+width]=src[a:a+width]
return bytes(result)
class Model:
def __init__(self):
self.catalog={};self.revision=0;self.active=0;self.generation=0;self.calls=0;self.transferred=0;self.selected=None;self.i=0;self.o=0
def state(self):
return [self.active,self.generation,self.calls,self.transferred,self.selected[0] if self.selected else 0,len(self.catalog),self.revision]
def command(self,line):
x=line.split();op=x[0];a=list(map(int,x[1:]));rc=0
if op in ('A','R','U'):
id,n,h,w,c,t,l=a;m=(id,(n,h,w,c),t,l)
rc=(1 if not id else plan_status(m[1],t,l,l))
if not rc:
if op in ('A','U'):
rc=9 if id in self.catalog else 5 if len(self.catalog)==8 else 0
else: rc=10 if id not in self.catalog else 0
if not rc:self.catalog[id]=m;self.revision+=1
elif op=='X':
rc=1 if a[0]==0 else 10 if a[0] not in self.catalog else 0
if not rc:del self.catalog[a[0]];self.revision+=1
elif op in ('F','L'):
m=self.catalog.get(a[0]) if op=='F' else list(self.catalog.values())[a[0]] if a[0]<len(self.catalog) else None
rc=1 if op=='F' and a[0]==0 else 0 if m else 10
return ['M',rc,*([m[0],*m[1],m[2],m[3]] if m and not rc else [0]*7)]
elif op=='V':return ['V',0,0,len(self.catalog),self.revision]
elif op=='O':
id,i,o=a;m=self.catalog.get(id)
rc=1 if id==0 else 10 if m is None else 3 if o not in (0,1) else 7 if o!=m[3] else 3 if i not in (0,1) else 0
if not rc:
if not self.active:self.calls=0;self.transferred=0
self.active=1;self.generation+=1;self.selected=m;self.i=i;self.o=o
elif op=='C':
rc=0 if self.active else 8
if not rc:self.active=0;self.calls=0;self.transferred=0;self.selected=None;self.i=0;self.o=0
elif op=='Z':
rc=0 if self.active else 8
if not rc:self.calls=0;self.transferred=0
elif op=='H':return ['H',0,self.selected[0],self.i,self.o,self.generation,self.calls,self.transferred] if self.active else ['H',8,0,0,0,0,0,0]
elif op in ('D','B'):
if op=='D':n,h,w,c,t,i,o,seed,ic,oc,mode=a;s=(n,h,w,c);init=plan_status(s,t,i,o)
else:
seed,ic,oc,mode=a;init=0
if self.selected:_,s,t,_=self.selected;i=self.i;o=self.o
else:s=(0,0,0,0);t=0;i=0;o=0
elements=0 if init or not any(s) else s[0]*s[1]*s[2]*s[3]
count=elements*(2 if t==0 else 4)
width=count if count else 32
src=payload(seed,mode);dst=bytes([165])*width
rc=init or (8 if op=='B' and not self.active else 7 if mode==2 and op=='D' else 5 if ic<count or oc<count else 6 if mode==1 else 0)
if not rc:
dst=transform(s,t,i,o,src[:count])
if op=='B':self.calls+=1;self.transferred+=count
return [op,rc,init,elements,count,*self.state(),dst.hex(),src[:width].hex()]
elif op=='I':
n,h,w,c,l,index=a;s=(n,h,w,c);rc=shape_status(s) or (3 if l not in (0,1) else 2 if index>=n*h*w*c else 0)
v=coordinate(s,l,index) if not rc else [99]*4
rc2=shape_status(s) or (3 if l not in (0,1) else 2 if rc else 0)
return ['I',rc,rc2,*v,index if not rc2 else 99]
elif op=='J':
n,h,w,c,t,i,o=a;s=(n,h,w,c);rc=plan_status(s,t,i,o)
return ['J',rc,rc or 2,rc or 2,0,0,0,0,0] if rc else ['J',0,0,0,o,i,i,i,n*h*w*c*(2 if t==0 else 4)]
else:raise ValueError(op)
return ['S',rc,*self.state()]
def cases():
commands=[];expected=[];model=Model()
def add(s):
commands.append(s);expected.append(' '.join(map(str,model.command(s))))
for s in ['C','Z','H','B 3 4096 4096 0','O 0 0 0','F 0','F 8','L 0','V']:add(s)
for i,s in enumerate([(1,2,2,3),(2,3,2,4),(4,8,8,4),(1,1,1,1)]):
add('A %d %s %d %d'%(i+1,' '.join(map(str,s)),i%3,i%2))
for s in ['A 1 1 1 1 1 0 0','A 0 1 1 1 1 0 0','A 5 0 1 1 1 0 0','A 5 1 1 1 1 9 0','A 5 1 1 1 1 0 9','V','F 2','L 3','L 4','O 1 1 0','B 17 4096 4096 0','O 2 0 0','H','B 29 4096 4096 0','O 2 1 1','B 31 4096 4096 0','B 9 0 4096 0','B 9 4096 0 0','B 9 4096 4096 1','H','O 3 1 1','H','B 11 4096 4096 0','O 3 1 0','B 12 4096 4096 0','Z','H','R 3 1 2 2 2 0 1','F 3','H','B 13 4096 4096 0','O 3 0 1','B 14 4096 4096 0','X 2','L 1','O 2 0 1','H','C','H','O 1 0 0','B 15 4096 4096 0','C','C','X 0','X 99','R 99 1 1 1 1 0 0','U 1 1 1 1 1 0 0']:
add(s)
for id in range(20,26):add(f'A {id} 1 1 1 1 0 0')
add('V');add('A 40 1 1 1 1 0 0');add('X 1');add('A 40 1 1 1 1 0 0');add('V')
rng=random.Random(760024)
shapes=[(1,2,2,3),(2,3,5,4),(4,8,8,4),(3,1,7,2),(1,1,1,1),(4,4,8,8)]
for s in shapes:
for t in range(3):
for i in range(2):
for o in range(2):
seed=rng.randrange(2**32);text=' '.join(map(str,s))
add(f'D {text} {t} {i} {o} {seed} 4096 4096 0')
add(f'J {text} {t} {i} {o}')
for l in range(2):
for x in [0,1 if s!=(1,1,1,1) else 0,s[0]*s[1]*s[2]*s[3]-1]:
add('I '+' '.join(map(str,s))+f' {l} {x}')
for i in range(2):
for o in range(2):add(f'D 2 3 2 4 2 {i} {o} 0 4096 4096 3')
for tail in ['0 1 1 1 0 0 1','5 1 1 1 0 0 1','4 8 8 8 0 0 1','1 1 1 1 9 0 1','1 1 1 1 0 7 1','1 1 1 1 0 0 7']:
add('D '+tail+' 7 4096 4096 0')
for mode,ic,oc in [(0,47,4096),(0,4096,47),(1,4096,4096),(2,4096,4096),(0,48,48)]:
add(f'D 1 2 2 3 2 0 1 20 {ic} {oc} {mode}')
for s in ['I 1 2 2 3 0 12','I 1 2 2 3 9 0','I 0 2 2 3 0 0']:add(s)
return ('\n'.join(commands)+'\n').encode(),expected
import base64,hashlib,json,math,os,re,shutil,subprocess,sys,tempfile,uuid,zlib
from pathlib import Path
# Frozen public support and candidate list are assigned above this source.
def digest(data): return hashlib.sha256(data).hexdigest()
def strict_meta(meta,spec,pid,out,err):
required={'phase','nonce','argv','deadline','supervisor','identity','exceptions','leader','leader_start','leader_identity','leader_rc','reaped','timeout','controlled_rc','pg_absent','descendants_absent','tokens','subreaper','elapsed','out_length','out_sha256','err_length','err_sha256'}
if type(meta) is not dict or set(meta)!=required: raise ValueError('metadata fields')
for name in ('phase','nonce','argv','deadline'):
if meta[name]!=spec[name] or type(meta[name]) is not type(spec[name]): raise ValueError('metadata binding '+name)
for name in ('supervisor','leader','leader_start'):
if type(meta[name]) is not int or meta[name]<=0: raise ValueError('metadata positive int '+name)
if meta['supervisor']!=pid or meta['supervisor']==meta['leader']: raise ValueError('metadata pid')
expected=[65534,65534,[]] if os.environ.get('ROLLOUT_GRADE_ISOLATION')=='uid65534' else [os.geteuid(),os.getegid(),os.getgroups()]
for name in ('identity','leader_identity'):
ident=meta[name]
if type(ident) is not list or len(ident)!=3 or type(ident[0]) is not int or type(ident[1]) is not int or type(ident[2]) is not list or any(type(x) is not int for x in ident[2]) or ident!=expected: raise ValueError('metadata identity '+name)
for name in ('reaped','timeout','pg_absent','descendants_absent','subreaper'):
if type(meta[name]) is not bool: raise ValueError('metadata bool '+name)
if type(meta['exceptions']) is not list or meta['exceptions']: raise ValueError('metadata exceptions')
if not all(meta[k] for k in ('reaped','pg_absent','descendants_absent','subreaper')): raise ValueError('metadata completion')
if type(meta['leader_rc']) is not int or type(meta['controlled_rc']) is not int: raise ValueError('metadata rc')
if meta['controlled_rc']!=(124 if meta['timeout'] else meta['leader_rc']): raise ValueError('metadata controlled rc')
elapsed=meta['elapsed']
if type(elapsed) not in (int,float) or not math.isfinite(elapsed) or not 0<=elapsed<=spec['deadline']+7: raise ValueError('metadata elapsed')
if type(meta['tokens']) is not list or not meta['tokens']: raise ValueError('metadata tokens')
tokens=meta['tokens']
if any(type(x) is not list or len(x)!=2 or any(type(v) is not int or v<=0 for v in x) for x in tokens): raise ValueError('metadata token types')
if len({x[0] for x in tokens})!=len(tokens) or [meta['leader'],meta['leader_start']] not in tokens: raise ValueError('metadata leader token')
for name,data in [('out',out),('err',err)]:
if type(meta[name+'_length']) is not int or meta[name+'_length']<0 or meta[name+'_length']!=len(data) or meta[name+'_sha256']!=digest(data): raise ValueError('metadata io '+name)
return not meta['timeout'] and meta['leader_rc']==0 and meta['controlled_rc']==0
def run_phase(phase,argv,cwd,stdin,deadline,records):
spec={'phase':phase,'nonce':uuid.uuid4().hex,'argv':argv,'cwd':cwd,'stdin':base64.b64encode(stdin).decode(),'deadline':deadline}
wrapper=[sys.executable,'-I','-c',SUPERVISOR,json.dumps(spec,separators=(',',':'))]
p=subprocess.Popen(wrapper,stdout=subprocess.PIPE,stderr=subprocess.PIPE)
raw,wrapper_err=p.communicate(timeout=deadline+9)
record={'phase':phase,'nonce':spec['nonce'],'wrapper_pid':p.pid,'wrapper_rc':p.returncode,'wire_length':len(raw),'wire_sha256':digest(raw),'wrapper_stderr_length':len(wrapper_err),'wrapper_stderr_sha256':digest(wrapper_err)}
record['wrapper_argv_sha256']=digest(json.dumps(wrapper,separators=(',',':')).encode())
record['stdin_offered_length']=len(stdin);record['stdin_offered_sha256']=digest(stdin)
records.append(record) # Preserve actual wrapper facts before parsing any wire.
try:
if p.returncode!=0 or wrapper_err: raise ValueError('wrapper execution '+phase)
wire=json.loads(zlib.decompress(base64.b64decode(raw,validate=True)))
if type(wire) is not dict or set(wire)!={'meta','out','err'}: raise ValueError('wire fields')
out=base64.b64decode(wire['out'],validate=True);err=base64.b64decode(wire['err'],validate=True)
record['meta']=wire['meta']
ok=strict_meta(wire['meta'],spec,p.pid,out,err)
except BaseException:
if len(raw)<=4096: record['raw_wire_base64']=base64.b64encode(raw).decode()
raise
return ok,out,err
def main(candidate):
records=[];errors=[];business=False;clean=False;absent=False;scratch=None;differences=[]
try:
scratch=tempfile.mkdtemp(prefix='tensor-bridge-')
work=Path(scratch)/'work';work.mkdir();work.chmod(0o777)
for name,data in SUPPORT.items():
path=work/name;path.parent.mkdir(parents=True,exist_ok=True);path.parent.chmod(0o777);path.write_bytes(base64.b64decode(data));path.chmod(0o644)
for name in CANDIDATES:
path=work/name;path.parent.mkdir(parents=True,exist_ok=True);path.parent.chmod(0o777);path.write_bytes((candidate/name).read_bytes());path.chmod(0o644)
offered,expected=cases()
compiler=['gcc','-std=c11','-O2','-Wall','-Wextra','-Werror','-I'+str(work/'include'),str(work/'src/tensor_bridge.c'),str(work/'src/tensor_session.c'),str(work/'tools/observe.c'),'-o',str(work/'observe')]
compiled,_,compile_err=run_phase('compiler',compiler,str(work),b'',20,records)
if compiled:
executed,observed,candidate_err=run_phase('candidate',[str(work/'observe')],str(work),offered,20,records)
# Arbitrary stderr bytes are allowed and hashed; only stdout is a protocol.
if executed:
actual=observed.decode('ascii').splitlines()
business=actual==expected
if not business:
first=next((i for i,(a,b) in enumerate(zip(actual,expected)) if a!=b),min(len(actual),len(expected)))
differences=[{'index':first,'actual':actual[first][:160] if first<len(actual) else None,'expected':expected[first][:160] if first<len(expected) else None,'actual_rows':len(actual),'expected_rows':len(expected)}]
else: errors.append('candidate controlled rejection')
else: errors.append('compiler controlled rejection')
except BaseException as exc:
errors.append(type(exc).__name__+':'+str(exc))
finally:
if scratch is not None:
try:
cleanup=[sys.executable,'-I','-c','import shutil,sys;shutil.rmtree(sys.argv[1])',scratch]
clean,_,_=run_phase('cleanup',cleanup,'/tmp',b'',5,records)
except BaseException as exc: errors.append('cleanup '+type(exc).__name__+':'+str(exc))
try:
absence_code='import os,sys\ntry: os.lstat(sys.argv[1])\nexcept FileNotFoundError: raise SystemExit(0)\nraise SystemExit(1)'
absent,_,_=run_phase('absence',[sys.executable,'-I','-c',absence_code,scratch],'/tmp',b'',5,records)
except BaseException as exc: errors.append('absence '+type(exc).__name__+':'+str(exc))
evidence={'scratch':scratch,'phases':records,'exceptions':errors,'differences':differences,'business':business,'clean':clean,'absent':absent}
encoded=base64.b64encode(zlib.compress(json.dumps(evidence,separators=(',',':')).encode(),9)).decode()
print('TBMETA '+encoded,file=sys.stderr)
passed=business and clean and absent and not errors and not differences
print('PASS' if passed else 'FAIL')
return 0 if passed else 1
if __name__=='__main__':raise SystemExit(main(Path(sys.argv[1])))