Metadata-Version: 2.4
Name: flux-asm
Version: 0.1.0
Summary: FLUX bytecode assembler and disassembler for constraint enforcement VM
Home-page: https://github.com/SuperInstance/JetsonClaw1-vessel
Author: Forgemaster
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: requires-python
Dynamic: summary

# flux-asm

FLUX bytecode assembler — two-pass with labels, comments, and disassembler.

43 opcodes for the FLUX constraint enforcement VM.

## Usage

```bash
# Assemble
python -m flux_asm program.fxasm -o program.flux

# Disassemble
python -m flux_asm -d program.flux

# Run self-tests
python -m flux_asm
```

## Example

```asm
# eVTOL altitude check
PUSH 100        # altitude
PUSH 0          # min
CMP_GE          # altitude >= 0?
JFAIL fail
PUSH 15000      # max
CARRY_LT        # altitude < max
ASSERT
HALT
fail:
GUARD_TRAP
```
