mutation engine + lineage tracker for adaptive payload ecosystems

part of the LANimals collective // built by GnomeMan4201

chain is the mutation and lineage tracking engine behind LANIMORPH — an adaptive payload framework that evolves payloads across a local network, tracks their lineage, scores their stealth, and visualizes the mutation tree over time.

it's not a traditional offensive tool. it's closer to an ecosystem simulator — payloads have personalities, families, XP, and mutation histories. the engine tracks which mutations survive, which get flagged, and evolves accordingly.

mutation families payloads are grouped into families based on behavior: exfil, scanner, polymorph, lateral, decoy. each family evolves independently with its own scoring curve.

personality system every mutation run is tagged with a personality (Scout, Mimic, Parasite, Ghost, Phantom) that influences behavior — aggression, stealth weight, lateral tendency.

XP + lineage tracking successful mutations accumulate XP. the engine tracks parent→child relationships across mutation generations, building a full lineage tree you can replay and visualize.

stealth scoring each payload variant is scored by an AI-assisted stealth scorer (lanimorph_ai_scorer.py) that weights evasion, signature noise, and behavioral fingerprint.

chain/
├── lan_dash.py              # live operation dashboard
├── lanimorph_dash.py        # LANIMORPH-specific dashboard
├── dna_mutator.py           # core mutation engine
├── chain_rotator.py         # payload rotation logic
├── mutation_memory.py       # persistence layer
├── lanimorph_xp.db          # XP + personality log (SQLite)
├── payload_family.json      # mutation corpus (demo data)
├── payload_families.csv     # family summary stats
├── mutation_stats.txt       # personality run stats
│
├── lineage/                 # lineage tree generators
├── replays/                 # captured session replays
├── family/                  # family tree visualization
├── mutants/                 # mutation variant store
├── reports/                 # generated HTML/text reports
├── meshmap/                 # LAN mesh topology data
└── mirror/                  # beacon sync mirrors

cd chain
python3 lan_dash.py

expects a vault at ~/LANIMORPH/vault/ — create it or point the config at your own path.

payload_family.json

{
  "exfil": [
    {
      "mutation": "mut_8210",
      "ip": "192.168.1.10",
      "timestamp": "2025-01-15 10:00:00",
      "port": "data_siphon.py [scout]",
      "score": 0.847,
      "generation": 1
    }
  ]
}

lanimorph_xp.db — xp_log table

id | timestamp | personality | xp_gained

active research tool — used in controlled lab environments. data in this repo is sanitized demo corpus. no real network data included.

for authorized research, red team simulation, and educational use only. do not use against systems you don't own or have explicit permission to test.

part of the LANimals collective ecosystem.

the work speaks first.

all path references are centralized in chain_config.py.

override vault location via environment variables:

export LANIMORPH_VAULT=~/your/vault/path
export LANIMORPH_LOGS=~/your/logs/path
export LANIMORPH_MEM=~/your/memory/path

or run the setup helper to initialize the default vault structure:

python3 chain_config.py

all path references are centralized in chain_config.py.

override vault location via environment variables:

export LANIMORPH_VAULT=~/your/vault/path
export LANIMORPH_LOGS=~/your/logs/path
export LANIMORPH_MEM=~/your/memory/path

or run the setup helper to initialize the default vault structure:

python3 chain_config.py