Code Repositories
The code section provides versioned repositories for the Astreum language (Lispeum). You can create repos, edit files, commit changes, create branches and tags, and collaborate with others.
Creating a repository
From the code home page, click Create Repository. Give it a name and optional description. The system initialises the repo with two files: a README.md and a main.aex file (the entry-point Lispeum expression). Repositories can be public (visible to everyone) or private (visible only to you and your organization members).
Editing files
Open a file from the repository browser. The editor displays the file contents with a 10-second autosave timer (configurable in your code profile). Changes are saved as you type — there is no explicit save button. The autosave stores edits in a CodeDraft linked to the current reference (branch or tag).
Commits
When you are ready to finalise your changes, create a commit. A commit takes all pending drafts on the current reference and creates a snapshot. Each commit has a message, an author, and a parent commit reference.
Branches and tags
References are pointers to commits. Branches are mutable — they move as you add commits. Tags are immutable — they always point to the same commit. Create a new branch to work on features without affecting the main line. Switch between references in the repository browser.
Drafts and merges
Drafts store uncommitted changes per reference. When you switch branches, the drafts follow. The merge system uses a 3-way merge algorithm:
- Base — the common ancestor commit.
- Left — the target branch.
- Right — the source branch.
If the same file was changed on both sides, a conflict is created, and you must resolve it by editing the conflicted file before the merge can complete.
Running code
From a file view, you can run the main.aex expression against a code environment. The expression executes on the in-process Astreum node and returns the result.
Liking repos
Public repositories can be liked by other users. The trending section on the code home page surfaces repositories with recent activity and likes.