{"record":{"id":"2a8702b1c4e93964","repo":"Hmbown/CodeWhale","slug":"codewhale-terminal-receipt-contained-an-invalid-co","errorCode":null,"errorMessage":"Codewhale terminal receipt contained an invalid count","messagePattern":"Codewhale terminal receipt contained an invalid count","errorType":"exception","errorClass":"RuntimeError","httpStatus":null,"severity":"error","filePath":"integrations/verifiers-codewhale/codewhale_harness/harness.py","lineNumber":266,"sourceCode":"            rf\"(?<![0-9A-Za-z.+-]){re.escape(version)}(?![0-9A-Za-z.+-])\",\n            output,\n        )\n        is not None\n    )\n\n\ndef _bounded_terminal(meta: dict[str, Any]) -> dict[str, Any]:\n    terminal: dict[str, Any] = {}\n    for key in _TERMINAL_FIELDS:\n        if key not in meta or meta[key] is None:\n            continue\n        value = meta[key]\n        if isinstance(value, str):\n            if len(value) > MAX_TERMINAL_STRING_CHARS:\n                raise RuntimeError(\"Codewhale terminal receipt exceeded its string bound\")\n        elif isinstance(value, int) and not isinstance(value, bool):\n            if value < 0 or value > 2**63 - 1:\n                raise RuntimeError(\"Codewhale terminal receipt contained an invalid count\")\n        else:\n            raise RuntimeError(\"Codewhale terminal receipt contained a non-scalar field\")\n        terminal[key] = value\n    encoded = json.dumps(terminal, sort_keys=True, separators=(\",\", \":\")).encode()\n    if len(encoded) > MAX_TERMINAL_RECEIPT_BYTES:\n        raise RuntimeError(\"Codewhale terminal receipt exceeded its total bound\")\n    return terminal\n\n\ndef _install_script(version: str) -> str:\n    version_q = shlex.quote(version)\n    install_q = shlex.quote(INSTALL_DIR)\n    release_q = shlex.quote(RELEASE_ROOT)\n    return f\"\"\"\nset -eu\nversion={version_q}\ninstall_dir={install_q}\nrelease_root={release_q}","sourceCodeStart":248,"sourceCodeEnd":284,"githubUrl":"https://github.com/Hmbown/CodeWhale/blob/8880682c63083a91624de936797efa3ce9e498fd/integrations/verifiers-codewhale/codewhale_harness/harness.py#L248-L284","documentation":"Integer terminal fields (token counters, duration_ms, retry_count, message_count, ...) must lie in [0, 2^63-1], the range safely representable downstream. Negative values or anything above 2^63-1 raise RuntimeError during parsing. Booleans are deliberately excluded from the integer branch (bool subclasses int in Python) and fall through to the non-scalar error instead.","triggerScenarios":"A facade emitting -1 sentinels for unknown counts; u64 saturation values such as 2^64-1 in token totals; overflow bugs in usage accounting.","commonSituations":"Stub facades using -1 for 'unknown'; counters ported from unsigned languages; aggregations that overflow during long runs.","solutions":["Clamp counts to the valid range before emitting","Use 0 or omit the field for unknown values; None fields are skipped entirely","Fix u64 overflow in the emitter's usage accounting"],"exampleFix":"# before\nmeta = {'input_tokens': -1, 'output_tokens': 2**64 - 1}\n# after\nmeta = {'input_tokens': 0, 'output_tokens': 2**63 - 1}","handlingStrategy":"validation","validationCode":"I64_MAX = 2**63 - 1\nmeta = {\n    k: (min(max(v, 0), I64_MAX) if isinstance(v, int) and not isinstance(v, bool) else v)\n    for k, v in meta.items()\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Use 0 or omit unknown counts; never -1 sentinels","Watch for u64 saturation when porting counters","Assert count ranges in facade unit tests"],"tags":["receipt","bounds","parsing","integers","harness"],"backgroundTag":null,"analyzedSha":"8880682c63083a91624de936797efa3ce9e498fd","analyzedAt":"2026-08-16T11:31:27.956Z","schemaVersion":2},"datasetVersion":"2026-08-16T13:17:31.715Z"}