Superplan(sky)

A modern systems experiment built on historical programming language ideas.

Superplan is a structured, procedural programming language inspired by early high-level languages such as ALGOL, Plankalkül, and Superplan — reimagined for modern systems experimentation.

This repository contains a working system where Superplan programs interact with the AT Protocol (Bluesky) through a Lisp runtime and a Rust bridge.

---

Editor Support

Superplan includes a VS Code language extension in:

editors/vscode/superplan

Current support includes:

• syntax highlighting
• snippets
• .spl file association

---

Why Superplan

This project explores a simple question:

What if early structured languages evolved directly into modern networked systems?

Instead of building everything in contemporary languages, this stack is deliberately split:

• Superplan — visible application layer
• Common Lisp — parser, AST, interpreter
• Rust — protocol edge (AT Proto / Bluesky)

The result is a real system capable of:

• login
• profile lookup
• home timeline fetch
• posting content

---

Architecture

Superplan (.spl)
      ↓
Lisp lexer / parser / AST / interpreter
      ↓
Bridge client (JSON over stdio)
      ↓
Rust AT Proto bridge
      ↓
Bluesky / AT Protocol

---

Example

PROGRAM HELLO

BEGIN
    WRITE("HELLO SUPERPLAN")
END

---

Real Example (Bluesky)

PROGRAM PROFILE

STRING ACTOR
JSON PROFILE

PROCEDURE SHOW_PROFILE(JSON PROFILE)
BEGIN
    WRITE("HANDLE:")
    WRITE(JSON_STRING(JSON_GET(PROFILE, "handle")))
END

BEGIN
    WRITE("ACTOR:")
    ACTOR = READLINE()
    PROFILE = ATP_PROFILE(ACTOR)
    CALL SHOW_PROFILE(PROFILE)
END

---

Getting Started

Requirements

• SBCL (Common Lisp)
• Rust / Cargo

Build the bridge

cargo build --manifest-path bridge/Cargo.toml

Run the Superplan program

sbcl --script lisp-tools/parser/run.lisp

---

Example Programs

Located in:

superplan/examples/

Included:

• home.spl — interactive client (timeline, profile, post, whoami)
• profile.spl — profile lookup
• post.spl — post creation

---

File Extension

Superplan source files use:

.spl

(.sp is avoided due to GitHub Linguist mapping to SourcePawn)

---

Project Status

Early but functional.

Currently working:

• Superplan parsing and execution
• terminal client written in Superplan
• real Bluesky profile lookup
• real authenticated timeline fetch
• real post creation

Not yet implemented:

• automatic token refresh
• static type checking
• compiled backend

---

Repo Layout

• docs/ — vision, spec, grammar, bridge ABI
• superplan/examples/ — .spl programs
• lisp-tools/parser/ — lexer, parser, AST, runner
• lisp-tools/interpreter/ — runtime + bridge client
• bridge/ — Rust AT Proto bridge
• editors/vscode/superplan/ — VS Code language support

---

Design Influences

• ALGOL — structure and control flow
• Plankalkül — typed data model thinking
• Lisp — language tooling and meta-layer
• modern API systems — practical integration

---

License

MIT

---

Former Lab