The Multiverse Logic & Character Synthesis Engine.
WorldCraft-Visuals is a Python framework for fusing characters — historical figures, cinematic icons, anime leads — into a single "Legacy Profile," complete with powers, lore, and a home biome. Instead of picking outcomes at random, it runs every fusion through a modality system so the results stay internally consistent: a fusion of two grounded, real-world figures shouldn't casually wield reality-bending anime powers, and the engine enforces that.
- Modality Classifier (
modality_classifier.py) — tags every character asLEGACY(real historical/cultural figures),GROUNDED(cinematic but physically realistic), orHIGH_CONCEPT(physics-bending, supernatural), and blends two characters' modalities into a single fusion profile. - Logic Auditor (
logic_auditor.py) — the enforcer. Checks every power against the fusion's modality ceiling and auto-transposes anything illegal down to a legal equivalent (e.g.Domain Expansion→Strategic Geniusfor aLEGACYfusion), so nothing breaks its own power-scaling rules. - Mythos-Sync Engine (
mythos_sync.py) — the full pipeline: classify → select thematic powers by tag → audit → generate lore, biome, rhetorical style, and influence pattern → persist tocontainment_matrix.json. - Fantasy Kingdom Generator (
fantasy_kingdom_generator.py) — the original, standalone lore generator. Lighter weight than Mythos-Sync; good for a quick taste of the anime/legend flavor text without the full fusion pipeline. - Live Dashboard (
dashboard.html+server.py) — a local web UI. Runserver.pyand it servesdashboard.html, which posts fusion requests to/fuseand renders the resulting Legacy Profile.
The engine's behavior is governed by written rulings, not only by code. These are binding documents, and they are the place to look before changing how concepts are named, classified, or grounded.
ruling_001_canonicalization_policy.md— concept identity: when two names are the same concept, when they may be merged, and what a learned vocabulary is permitted to propose. LOCKED.ruling_002_family_taxonomy_integrity.md— whatfamilyis (a grounding behavior class, not an ontology), the domain layer, and what happens when a concept cannot be placed. LOCKED.contract_001_domain_resolution.md— the machine-enforceable form: domain resolution states, transitions, and invariants. DRAFT — binding only once signed off and marked LOCKED.audit_001_…/audit_002_…— measured evidence the rulings are argued from.open_contract_gaps.md— the register, in two categories: requirements ruled but not yet enforceable, and ownership gaps — topics a document excludes that no document claims.evidence/— preserved exhibits, including Regression Case 001.
Each document carries its own sign-off checklist, which is the authority on what has been signed. A ruling states what is true; it does not assert that the current implementation obeys it — the gaps register is where those differences are tracked.
The engine has no third-party dependencies — it runs on the Python standard library (3.10+), and
python -m unittest test_engine needs no install step. The one exception is the Hypothesis property
suite, which is deliberately kept separate so that stays true: pip install -r requirements-dev.txt,
then python -m unittest test_hypothesis_properties.
Quick lore sample:
python fantasy_kingdom_generator.pyFull fusion engine (command line):
python mythos_sync.pyWeb dashboard:
python server.py
# then open http://localhost:8000/dashboard.html
The Mythos-Sync engine (classifier, auditor, tag-driven power selection, live dashboard) is functional end to end.
Current work is architectural rather than feature work: the engine is being taken from a closed-world model — a hand-authored registry that is correct for the vocabulary it contains — toward one that can accept concepts it was never authored with. That transition is being specified in docs/ before it is implemented, which is why the recent history is rulings rather than code.
Earlier plans listed here (growing the character registry, rebalancing power-scaling between modalities) are superseded by that work rather than abandoned.
See CONTRIBUTING.md.
Repository for replit.com/@lamontb778/WorldCraft-Visuals