HaltingMachine 0.1__tar.gz → 0.2__tar.gz

{haltingmachine-0.1 → haltingmachine-0.2}/HaltingMachine.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: HaltingMachine
-Version: 0.1
+Version: 0.2
 Summary: A tiny Oblivious Compute halting-machine specimen
 Requires-Python: >=3.10
 Requires-Dist: wcwidth>=0.2

{haltingmachine-0.1 → haltingmachine-0.2}/HaltingMachine.egg-info/SOURCES.txt

@@ -7,7 +7,7 @@ HaltingMachine.egg-info/dependency_links.txt
 HaltingMachine.egg-info/entry_points.txt
 HaltingMachine.egg-info/requires.txt
 HaltingMachine.egg-info/top_level.txt
-machine/__init__.py
-machine/field.py
-machine/inverter.py
-machine/observer.py
+Machine/__init__.py
+Machine/field.py
+Machine/inverter.py
+Machine/observer.py

{haltingmachine-0.1 → haltingmachine-0.2}/HaltingMachine.egg-info/top_level.txt

@@ -1,2 +1,2 @@
 HaltingMachine
-machine
+Machine

{haltingmachine-0.1 → haltingmachine-0.2}/HaltingMachine.py

@@ -1,4 +1,4 @@
-from machine.field import main
+from Machine.field import main
 
 if __name__ == "__main__":
     main()

{haltingmachine-0.1/machine → haltingmachine-0.2/Machine}/field.py

@@ -59,7 +59,7 @@ def main():
         index = random.randrange(total)
         for i in range(total):
             if i != index:
-                spawn("machine.inverter" if i >= first else "machine.observer", i, total)
+                spawn("Machine.inverter" if i >= first else "Machine.observer", i, total)
         if index >= first:
             from .inverter import run
         else:

{haltingmachine-0.1 → haltingmachine-0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: HaltingMachine
-Version: 0.1
+Version: 0.2
 Summary: A tiny Oblivious Compute halting-machine specimen
 Requires-Python: >=3.10
 Requires-Dist: wcwidth>=0.2

haltingmachine-0.2/README.md

@@ -0,0 +1,77 @@
+# 🙂 HaltingMachine 🙂
+
+***...Rock. Paper. Scissors. Rock. Paper. Scissors...***
+
+<img src="../../AfterHours/Relics/HaltingMachine.gif" width="350"/>
+
+> ***...Forever...and ever...*** 
+
+---
+
+## 🪞 The Inverter 🪞
+
+**HaltingMachine** is a tiny executable specimen of **Oblivious Compute**. Each terminal is an **independent observer** holding its own state. Normal observers move through **Rock → Paper → Scissors**, while the inverter moves through the **same state space in reverse**.
+
+A projection does not become state merely because it was projected. Each observer admits only what belongs from its own **present position**, so the inverter may keep running while the surrounding field remains halted, or stop while the field continues to move it. **Local execution does not decide the computation. The relation among independently maintained states does.**
+
+---
+
+## 🧠 Inside Out 🧠
+
+***Two companion papers. Read them in order.***
+
+[**`BlackBox`**](./BlackBox.md) moves computation **outside the box.** 
+
+[**`HyperCube`**](./HyperCube.md) gives the relation a **Boolean language.**
+
+> ***See the computation first. Then learn how it speaks.***
+
+---
+
+## ⚙️ Mechanical Intuition ⚙️
+
+> ***Imagine several gears suspended in an Oblivious Medium. Each gear knows only its own position and what may mesh from there. No gear contains the mechanism. The mechanism exists in the relation among them, while the medium merely exposes their positions. HaltingMachine makes this visible by turning the same three-state cycle in opposite directions. The observers may move differently, separate, and meet again in shared alignment. The computation is in the relation among their states, not in any one observer.***
+
+
+---
+
+## 🐧 Operating System Support
+
+- ✅ Linux  
+- ✅ macOS  
+- ❌ Windows (sorry, but not sorry)
+
+---
+
+## 🍄 Install
+
+***To run HaltingMachine, install it with:***
+
+```bash
+pipx install HaltingMachine && HaltingMachine
+```
+
+You’ll need **Python 3.10+** and an **80x24 UNIX-like terminal environment.**
+
+> Don't have **pipx**? See how to install it [**`Here`**](../../AfterHours/Relics/pipx.md).
+
+---
+
+## ☁️ Networking
+
+**HaltingMachine runs locally** over sockets as a **Smoketest**.
+
+---
+
+🧭 **Continue to [**`Peers`**](../../Spark/Peers.md)...**
+
+> 🪙 [**`Kernel`**](../Kernel.md)***...***
+
+---
+
+## 📜 License
+
+See the [**`NOTICE`**](../../NOTICE.md) for licensing information on the [**`Oblivious Compute`**](https://github.com/ObliviousCompute) project.
+
+Use it, study it, modify it—just respect the terms outlined there.
+

{haltingmachine-0.1 → haltingmachine-0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "HaltingMachine"
-version = "0.1"
+version = "0.2"
 description = "A tiny Oblivious Compute halting-machine specimen"
 requires-python = ">=3.10"
 dependencies = ["wcwidth>=0.2"]
@@ -14,4 +14,4 @@ HaltingMachine = "HaltingMachine:main"
 
 [tool.setuptools]
 py-modules = ["HaltingMachine"]
-packages = ["machine"]
+packages = ["Machine"]

haltingmachine-0.1/README.md

@@ -1,32 +0,0 @@
-# HaltingMachine
-
-A tiny loopback-socket specimen of an Oblivious Compute field.
-
-Install from this directory:
-
-```bash
-pipx install --force .
-HaltingMachine
-```
-
-Choose the number of observers and the number of inverters. The launcher assigns the last *N* observers as inverters, randomly chooses which observer inherits the invoking shell, and drops every observer into Genesis. The random choice affects terminal persistence only; it does not change identity, role, or field behavior.
-
-## Runtime
-
-- `↑` / `↓` selects `HALT` or `REPEAT`.
-- `SPACE` exits that observer.
-- Every observer begins on `HALT` and `🪨`.
-- A healthy observer advances `🪨 → 📜 → ✂️ → 🪨`.
-- An inverted observer advances `🪨 → ✂️ → 📜 → 🪨`.
-- Healthy `REPEAT` originates its forward successor once per second; healthy `HALT` originates nothing.
-- Inverted `HALT` originates its reverse successor once per second; inverted `REPEAT` originates nothing.
-- A projection never mutates its sender. A state changes only after receiving the one successor admitted by that observer's transition rule.
-- Every accepted state is semantically reprojected once into the oblivious medium.
-- Acceptance starts a one-second refractory interval. R/P/S packets arriving during that interval are discarded, so each observer can mutate at most once per second.
-- Active origination is phase-reset by the same acceptance. The field therefore appears clocked at 1 Hz without a shared master clock.
-
-There is no DDUP/history window in this specimen. The present R/P/S state itself makes duplicates inadmissible: after accepting a ticket, that same ticket is no longer the observer's successor.
-
-The red-handle scissors wire state is the real UTF-8 `✂️` emoji. Its display row inserts one terminal cell after each glyph because some Linux terminal/font combinations draw the emoji across two cells while advancing the cursor by one.
-
-On exit, HaltingMachine restores the terminal, clears the screen, and returns the original window to a clean shell. Ctrl-C exits cleanly; Ctrl-Z and Ctrl-\ are ignored while the machine owns the terminal.