Table of Contents

1. About The Project
   • The Biological Philosophy
   • Core Biomorphic Mechanics
   • File Extension Taxonomy
   • Keyword Dictionary
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
   • Building from Source
   • Windows File Association (.tmq Double-Click)
3. Usage
   • Clinical Case Study
   • Runtime Mutation Trace
   • Oncology Survival Guide
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

Modern computer science spent six decades obsessed with "determinism", "memory safety", and "predictable side effects". What a sterile, boring way to compute.

TumorScript rejects this artificial stability. In nature, living tissue is messy, mutations are inevitable, and observation alters the state of matter. TumorScript bridges biological cancer dynamics and quantum observer physics into software architecture:

• Observation causes corruption: Reading a variable actively degrades its value. Printing a variable five times might turn your integer into a floating-point tumor.
• Metastasis is contagious: Malignant variables pass infections to innocent numbers across arithmetic equations.
• Chemotherapy is a gamble: You can purge mutations with chemo, but there is an intrinsic 15% chance of destroying the variable permanently.
• Organ failure is terminal: If more than 50% of your heap becomes malignant, the virtual machine panics with FATAL: ORGAN_FAILURE_EXCEPTION and kills the process.

Writing software in TumorScript is no longer about writing logic. It is an oncological race against time to extract answers before your program dies on the operating table.

(back to top)

The Biological Philosophy

Traditional programming treats memory as a warehouse of immutable storage boxes. TumorScript treats memory as an immunocompromised petri dish:

$$V_{\text{mutated}} = V_{\text{original}} \times (1 \pm \delta)$$

Every time a CPU instruction observes a piece of DNA data, $\delta$ climbs from an initial 0.5% up to a terminal 5.0% per read. The more you watch your code, the worse it behaves.

(back to top)

Core Biomorphic Mechanics

• Entropic Memory (dna): Every read triggers mutation. Numbers drift mathematically, strings suffer random ASCII codepoint codon shifts, and booleans flip under extreme stress.
• Immune Constants (rna): Static genetic codes that are 100% resistant to entropic decay. Reassigning them is treated as an IMMUNE_VIOLATION.
• Metastasis (y = bad_x + 10): Performing calculations with an infected variable carries a 30% probability of immediately spreading malignancy to the target.
• Quarantine Chamber (quarantine { ... }): A sterile cleanroom where mutation is completely frozen. Curly braces {} are strictly illegal everywhere else in the language. To prevent developers from cheating by wrapping their whole app in quarantine, the compiler enforces a strict 20% total line budget.
• Chemotherapy (chemo x): Resets a corrupt variable back to its initial healthy state, with a terrifying 15% lethal toxicity chance of deleting the variable into null oblivion.
• Apoptosis (apoptosis value): Programmed cell death. Safely terminates a cellular function and ejects its payload before internal mutations spread.

(back to top)

File Extension Taxonomy

TumorScript classifies source code into containment biosafety levels:

Extension	Name	Biosafety Level	Purpose
.tmq	Tumor Quarantine	Level 4 (Primary)	Main executable files containing quarantine chambers and program logic.
.tmr	Tumor Source Module	Level 3 (Intermediate)	Importable cellular modules and secondary logic units.
.tmh	Tumor Header	Level 1 (Sterile)	Mutation-proof header files containing exclusively immutable rna constants.
.tmz	Tumor Zone	Level 5 (Extreme Hazard)	High-risk experimental zones where mutation and metastasis rates are tenfold.
.tmb	Tumor Bytecode	Machine Artifact	Compiled intermediate binary bytecode for the virtual machine.

(back to top)

Keyword Dictionary

Standard Syntax	TumorScript Keyword	Biological Role
var / let	dna	Mutable variable subject to decay on every read.
const	rna	Mutation-immune constant.
class / struct	cell	Living cellular blueprint containing state and traits.
function / def	gene	Cellular functional logic; degrades if fed mutated arguments.
new / clone	mitosis	Duplicates and spawns an independent living cell instance.
return	apoptosis	Programmed cell death; cleans up scope and yields data.
import	metastasis	Cross-module dissemination of code and functions.
try / catch	quarantine / chemo	Isolation and toxic intervention strategies.

(back to top)

Built With

The TumorScript reference compiler and runtime are engineered with zero-compromise native performance:

• 
• 
• 
• 
• 

(back to top)

Getting Started

You can run TumorScript immediately through your favorite package manager or compile it from source as a standalone native binary with zero runtime dependencies.

Prerequisites

• To install pre-built packages: Node.js (npm) or Python 3.8+ (pip).
• To compile from source: Rust (cargo 1.70+) and optional luac.

(back to top)

Installation

Global Installation via npm (Node.js)

npm install -g tumorscript

Global Installation via pip (Python)

pip install tumorscript

Once installed, the tumorscript command is available system-wide:

tumorscript examples/hospital_core.tmq

(back to top)

Building from Source

TumorScript compiles into an ultra-fast, single-file native executable (tumorscript.exe on Windows or tumorscript on Unix) that embeds the full Lua 5.4 engine, the application icon, and the TumorScript standard library into a compact ~547 KB binary.

On Windows:

build.bat

The compiled binary will be placed at bin\tumorscript.exe with icon.ico baked into the PE resource table.

On Linux / macOS:

chmod +x build.sh
./build.sh

The compiled binary will be placed at bin/tumorscript.

(back to top)

Windows File Association

TumorScript can register itself as the default handler for all .tmq files across Windows:

• All .tmq files display the official TumorScript Application Icon.
• Double-clicking any .tmq file opens a dedicated CMD terminal, runs the script through the biomorphic engine, and keeps the terminal open with pause so you can examine the mutation outputs before closing.
• Requires no administrator rights (scoped safely to HKCU).

To Register:

Double-click register_file_association.bat or run:

tumorscript --register

To Unregister:

Double-click unregister_file_association.bat or run:

tumorscript --unregister

(back to top)

Usage

Clinical Case Study: hospital_core.tmq

Below is the canonical TumorScript program simulating patient vital signs under entropic stress:

# file: hospital_core.tmq
metastasis System.IO

cell PatientRecord:
    dna age = 30
    dna heart_rate = 75
    rna blood_type = "AB+"

gene calculate_dosage(patient):
    # observation causes patient.age to drift slightly
    dna base_dosage = patient.age * 1.5

    if patient.age > 40:
        print("Critical Age Threshold Exceeded:", patient.age)

    apoptosis base_dosage

gene main():
    dna cycle = 0
    dna p1 = mitosis PatientRecord()

    print("--- CYCLE START (Mutation Phase) ---")

    while cycle < 5:
        cycle = cycle + 1

        # pulse data corrupts on each read
        print("Pulse Data (Read ", cycle, "): ", p1.heart_rate)

        # medical intervention if cancer spikes
        if p1.heart_rate > 78:
            print("Pulse data corrupted, applying chemo...")
            chemo p1.heart_rate
            print("Post-Treatment Pulse:", p1.heart_rate)

    print("\n--- STERILE QUARANTINE ZONE ---")

    # sterile cleanroom: values remain completely frozen
    quarantine {
        dna safe_age = p1.age
        dna exact_calc = safe_age * 10
        print("[STERILE] Frozen Age Data:", safe_age)
        print("[STERILE] Precise Calculation:", exact_calc)
    }

    # back to entropic reality
    dna final_dosage = calculate_dosage(p1)
    print("Final Dosage Output:", final_dosage)

(back to top)

Runtime Mutation Trace

Executing tumorscript examples/hospital_core.tmq produces live biomorphic entropy:

--- CYCLE START (Mutation Phase) ---
Pulse Data (Read 0.993223): 74.600719
Pulse Data (Read 1.999967): 73.544579
Pulse Data (Read 2.959608): 74.117909
Pulse Data (Read 4.061606): 77.237377
Pulse Data (Read 4.787132): 76.586058
Pulse data corrupted, applying chemo...
Post-Treatment Pulse: 75.000000
Pulse Data (Read 6.283643): 74.939735

--- STERILE QUARANTINE ZONE ---
[STERILE] Frozen Age Data: 30
[STERILE] Precise Calculation: 300
Final Dosage Output: 44.864949

Notice that:

1. cycle drifted from an integer into fractional values (0.993, 1.999, 4.787), occasionally repeating iterations!
2. p1.heart_rate climbed until triggering chemo, which reset it to baseline!
3. Inside quarantine { ... }, the calculations were 100% frozen and exact!

(back to top)

Oncology Survival Guide

• Defensive RNA Anchoring: Use rna for iteration limits, step offsets, and critical thresholds. rna cannot mutate, preventing infinite loops caused by decaying integers.
• Quarantine Budgeting: You only get 20% of your source code lines in {} quarantine. Spend it on financial calculations, cryptography, or critical arithmetic.
• Chemotherapy Contingency: Never apply chemo to your only pointer to a data structure without a backup clone (mitosis), or risk fatal CHEMO_LETHAL null pointer vaporization.

(back to top)

Roadmap

• Indentation-based lexical analyzer with virtual INDENT / DEDENT tokens
• Strict quarantine {} exclusivity and 20% source limit validation
• Read-based entropic memory engine with escalating delta curves
• Object-oriented cellular mitosis and gene definition systems
• Contagious binary metastasizing between healthy and malignant variables
• Chemotherapy intervention with 15% lethal toxicity chance
• Systemic organ failure detection (ORGAN_FAILURE_EXCEPTION)
• Standalone native compiler embedding Lua 5.4 with icon.ico resource
• Windows Registry .tmq double-click file association in CMD
• npm (npm install -g tumorscript) and pip (pip install tumorscript) distributions
• Comprehensive GitHub Wiki documentation suite
• Radiation Therapy (radiation): Purges 90% of memory corruption, but mutates all other variables by 30%
• Network Metastasis: Spreading cancer across remote machines via raw TCP/IP sockets
• CRISPR Gene Editing: Runtime AST self-modifying code rewrite engine
• Terminal flatline audio sound effects upon organ failure

See the open issues for a full list of proposed features and clinical bug reports.

(back to top)

Contributing

Contributions to TumorScript are greatly appreciated! Whether you want to fix a memory leak or introduce a more aggressive form of cellular corruption, the medical board welcomes your pull requests.

Biological Safety Guidelines:

1. Fork the Project
2. Create your Malignant Branch (git checkout -b feature/BenignMutation)
3. Commit your Genetic Modifications (git commit -m 'feat: add oncological radiation therapy')
4. Push to the Petri Dish (git push origin feature/BenignMutation)
5. Open a Clinical Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Contact

TumorScript Project - @yamanist0

Project Link: https://github.com/yamanist0/Tumor-Script

Wiki Documentation: https://github.com/yamanist0/Tumor-Script/wiki

(back to top)

Acknowledgments

• Erwin Schrödinger - For proving that looking at things ruins them.
• Werner Heisenberg - For providing our runtime's official excuse for floating-point inaccuracies.
• Conway's Game of Life - For inspiring cellular automation in software.
• Brainfuck & Malbolge - For demonstrating that programming languages do not need to be ergonomic to be art.
• The Lua Team - For creating the world's most embeddable, resilient scripting language.
• The Rust Team - For letting us package insanity into an airtight 500 KB binary.
• Best-README-Template - For the stunning markdown architecture.

(back to top)