Persistent World Observer Terminal

A read-only Angular observer terminal for the E1 stage of the Persistent World experiment.

The prototype presents a deterministic, AI-free world through a BIOS-inspired startup sequence and a controlled shell. It is not a game client, a real Linux shell, or the world runtime itself.

Project status

Experimental / E1 usability prototype

This repository tests one question:

Can a BIOS-and-shell interface help people understand world facts, entity perspectives, and causal history?

The browser currently replays a fixed, synthetic Experiment-01 fixture. The persistent Python runtime and database service are not included in this repository.

Features

• BIOS / POST sequence driven by fixture integrity data
• Read-only World Shell
• Controlled command registry; no operating-system command execution
• Command history, Tab completion, spelling suggestions, and contextual recommendations
• Distinct [FACT] and [VIEW] presentation layers
• Public entity views and event inspection
• Luna / Echo perspective comparison for the key event
• Static, synthetic Experiment-01 projections exported by the private world-runtime prototype

Commands

help
brief
feed
entity <id>
event <eventId>
compare <actorA> <actorB> <eventId>
status
clear
reboot
exit

Suggested walkthrough:

brief
feed
event main-K000002
compare luna echo main-K000002
entity luna
entity echo

Requirements

• Node.js 22.12 or later in the Node 22/24 release lines
• npm 10 or later

Run locally

npm ci
npm start

Open http://localhost:4200.

Verify the project

npm run check

This runs the English-copy check, unit tests, and production build.

Static deployment

npm run build:pages

Deploy the files from:

dist/persistent-world-observer-terminal/browser/

The relative base path makes this build suitable for a repository subpath such as GitHub Pages.

Repository structure

src/app/core/                 Domain-facing front-end models and services
src/app/features/boot-screen BIOS / POST experience
src/app/features/world-shell Controlled observer shell
public/experiment-01/        Synthetic, read-only experiment projections
docs/                        Architecture and experiment documentation
scripts/                      Repository checks

Security boundary

This project does not expose Bash, Zsh, PowerShell, or any server-side shell. User input is parsed by a fixed front-end command registry. The fixture is read-only and observer commands cannot mutate world facts.

See SECURITY.md for reporting guidance.

Open-source scope

Included:

• Angular observer terminal
• Experiment-01 synthetic fixture
• Front-end command and presentation logic
• Tests and project documentation

Not included:

• Python world kernel
• Persistent Event Store
• World Worker
• Private validation fixtures and internal administration tools
• AI services

See docs/OPEN_SOURCE_SCOPE.md. Deployment instructions are available in docs/DEPLOYMENT.md.

Contributing

Contributions are welcome when they support the current experiment and preserve its boundaries. Read CONTRIBUTING.md before opening a pull request.

License

MIT. See LICENSE. Project and trademark notices are in NOTICE.md.