Bitwise Object GitHub issue

• • Overview
• • Access
• • Open Questions
• • Methods

Overview GitHub issue

{"vibecode": {
    "section": "overview",
    "concept": "bitwise_operations_via_dedicated_wrapper_object",
    "access": "$n.bitwise",
    "rationale": "keeps_Number_class_uncluttered_makes_intent_explicit"
}}

Bitwise operations are exposed through a dedicated bitwise object rather than as direct methods on Number. This keeps the Number class uncluttered and makes bitwise intent explicit at the call site.

Access GitHub issue

{"vibecode": {
    "section": "access",
    "method": "bitwise",
    "returns": "Bitwise object",
    "example": "$n.bitwise.or(456)"
}}

Call .bitwise on any Number to get a bitwise object wrapping that value:

$n = 123
$n.bitwise.or(456)

Open Questions GitHub issue

• Do operations take a second Number argument, or does the bitwise object wrap the value and chain? e.g. $a.bitwise.or($b) vs $a.bitwise.or($b).and($c)
• What does not return for negative numbers? Behavior depends on the integer representation (two's complement assumed).
• Are bitwise operations defined only for integers? Should calling .bitwise on a non-integer raise an error?

Methods GitHub issue

{"vibecode": {
    "section": "methods",
    "methods": ["or", "and", "xor", "not", "shift_left", "shift_right",
        "nand", "nor", "xnor"],
    "aliases": {"shift_left": "<<", "shift_right": ">>"},
    "notes": ["not_is_unary", "assumes_twos_complement_for_negative_numbers"]
}}