<img align="right" src="https://github.com/mearvk/SLeeLa/blob/master/images/debian/debian-logo.png" width="75" height="75" alt="SLeeLa">
<img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela/sleela-logo-004.jpg" alt="SLeeLa">
sleela-terminal — the SleelaTerminal™ shell
SleelaTerminal™ is an original command shell authored by the SLeeLa
project — a clean-room implementation guided by public POSIX-shell
specifications, not derived from GNU Bash or any other shell's source (see
NOTICE). It aims at the same excellent capabilities as a mature
shell, expressed through our own hierarchical, math-driven architecture (see
ARCHITECTURE.md).
This is authored, so it is ours to brand. The ideas (pipelines, redirection, quoting, arithmetic) are common shell knowledge; the code is new. The repository's vendored GNU Bash under
bash/is a separate, unmodified component and is not used here.
Layers
A strict downward-only dependency stack:
L6 CLI / M5 slsh + select/process-substitution/trap orchestration
L5 Executor pipelines, redirections, control flow, builtins
L4 Expansion variables, arithmetic $(( )), quote removal
L3 Parser tokens -> AST (recursive descent)
L2 Lexer text -> tokens (quoting, operators, comments)
L1 Core + Arith Value/Token/AST model, precedence-climbing arithmetic
Features (M1 – M5)
M1 — the core:
- Core model —
Value,Token, AST nodes,Environment. - Arithmetic engine — an original precedence-climbing integer evaluator
(used by
$(( … ))), with correct precedence/associativity and div-by-zero reporting. - Lexer — words, single/double quoting, operators (
| < > >> ; && ||), comments,name=valueassignments. - Parser — simple commands, pipelines, and-or lists, redirections,
if,while, assignments. - Executor — runs the AST: assignments, expansion, builtin/external
dispatch, pipelines, redirections, control flow, and
$?exit status. - Builtins —
cd,pwd,echo,export,unset,true,false,exit,set,:, plus topic-basedhelpfor language features, jobs, process substitution, traps, prompt, portability, and build/install workflows.
M2 — control, functions, expansion:
for … in … ; do … doneloops (iterate a word list; falls back to$@).case … in pat) … ;; esacwith glob patterns and|alternation.- Shell functions
name() { … }with positional parameters$1,$2, …,$@,$#(scoped per call). - Command substitution
$( … )— captures a command's stdout. - Pathname globbing —
*,?,[a-z],[!..], with field splitting. - Brace groups
{ … }run in the current shell.
M3 — expansion depth, here-docs, pipeline functions:
- Parameter operators —
${x:-default},${x:=default}(assigns back),${x:?message},${x:+alternate}, and${#x}(length). - Brace expansion —
{a,b,c}lists and numeric{m..n}ranges (cartesian when combined, e.g.{a,b}{1,2}). Expansion is capped at 4,096 results and 64 recursive levels to limit memory/stack exhaustion from pathological input. - Tilde expansion —
~→$HOME,~user→ that user's home. - Here-documents —
<< DELIMand<<- DELIM(tab-stripping); the body is expanded unless the delimiter is quoted (<<'DELIM'). - Functions in pipelines — a shell function can be a pipeline stage.
M4 — loops, jobs, conditional builtins:
until … ; do … doneloops — run the body until the condition succeeds (the inverse ofwhile).- Background jobs —
command &forks the command, records it in a job table, and prints[id] pid;jobslists them,wait [id]waits, andfg/bgresume jobs in the fore/background. - Loop control —
break [n]andcontinue [n](with an optional number of enclosing loop levels). - Pipeline negation —
! pipelineinverts the exit status. test/[ … ]— string (=,!=,-z,-n), numeric (-eq -ne -lt -le -gt -ge), and file (-e -f -d) predicates, with!negation;[requires a closing].read [-r] name…— read one line from stdin, split on whitespace into the named variables (remainder to the last), or intoREPLY.getopts optstring name [arg…]— parse options withOPTIND/OPTARG, supporting bundled flags (-abc),-oVALUE, and-o VALUE.
M5 — shell interaction and process integration:
select name in …; do … done— numbered menus,PS3,REPLY, choice assignment, invalid-choice handling, and loop exit throughbreak.- Multi-segment pathname globbing — the expansion layer's filesystem
walker supports path components rather than limiting
*/?/[..]to one directory level; M5 promotes this as a tested capability. - Process substitution —
<(command)supplies a readable FIFO and>(command)supplies a writable FIFO, with 0600 permissions and a private child environment. - Signal traps — standalone
trap 'command' SIGNALdeclarations are installed by the M5 layer; caught signals are dispatched to the registered action after the active shell command returns. Numeric signals and common names (HUP,INT,TERM,QUIT,USR1,USR2,PIPE,ALRM) are accepted. - M5 hardening — filesystem results stay data, external-command prefix assignments use scoped environments, redirection failures are checked, and the process-substitution startup path avoids the common FIFO open deadlock.
- M5 CI validation — the workflow performs a clean build, full smoke suite, sanitizer validation, Clang installation, and fuzz-target compilation. The fuzz harness also exercises expansion with command execution disabled.
Soros relative time
The base binary set includes the project-defined soros time command. It uses
the terminal's local civil year as its input and applies this explicit relative
time rule:
- 2026 → 2407 — the project's Own National Time reference year.
- 2026 + 1 → 2408.
- 2026 + 2 → 2409.
- In general:
2407 + (civil_year - 2026). - 2607+ is retained as the project's Great Mystery marker and is displayed separately from the calculated relative timestamp; it is not presented as a historical or externally recognized calendar.
The command is available directly in the REPL and through slsh -c / script
execution:
./build/slsh -c 'soros time'
The implementation deliberately uses the terminal's local civil year rather than claiming that this project-defined notation replaces a civil calendar.
See M5-HARDENING.md for the implementation closeout and
remaining gates toward the GREAT engineering classification.
Interactive prompt and help
The interactive prompt defaults to the account username followed by $ (for example, ada$). Run help for the feature index or help expansion, help jobs, help process, help traps, help select, help prompt, help soros, help portability, or help build for topic-specific guidance. The help text also calls out known conformance and platform limitations.
Build & run
cd sleela-terminal
make # builds ./build/slsh and the smoke test
make smoke # run the layered smoke test
./m5-smoke.sh # run the M5 integration smoke tests after building
./build/slsh -c 'echo hello | tr a-z A-Z'
./build/slsh -c 'x=3; echo $(( x * x + 1 ))'
./build/slsh -c 'for i in a b c; do echo $i; done'
./build/slsh -c 'greet() { echo Hi, $1; }; greet Ada'
./build/slsh -c 'case $(echo cat) in cat|dog) echo pet;; esac'
./build/slsh -c 'for f in */include/*.hpp; do echo "$f"; done'
./build/slsh -c 'echo report{1..3}.txt; echo {dev,prod}-{a,b}'
./build/slsh -c 'up() { tr a-z A-Z; }; echo hi | up'
printf 'cat <<END\nyear $(( 2000 + 25 ))\nEND\n' | ./build/slsh /dev/stdin
./build/slsh -c 'n=0; until [ $n -ge 3 ]; do echo $n; n=$(( n + 1 )); done'
./build/slsh -c 'if ! [ -f /no/such ]; then echo missing; fi'
./build/slsh -c 'sleep 1 & jobs; wait; echo done'
printf 'ada 42\n' | ./build/slsh -c 'read name age; echo "$name is $age"'
printf '1\n' | ./build/slsh -c 'PS3="pick> "; select x in alpha beta; do echo "$x:$REPLY"; break; done'
printf '%s\n' 'cat <(printf hi)' | ./build/slsh
./build/slsh script.slsh
./build/slsh
Files
| File | Layer | What it is |
|---|---|---|
ARCHITECTURE.md | — | Hierarchical, math-driven design. |
M5-HARDENING.md | — | M5 hardening, validation, regression baseline, and release gates. |
PERFORMANCE.md | — | Performance, security, validation, and engineering classification reference. |
core.hpp | L1 | Value, Token, AST, Environment. |
arith.hpp / arith.cpp | L1 | Precedence-climbing arithmetic engine. |
lexer.hpp / lexer.cpp | L2 | Text → tokens. |
parser.hpp / parser.cpp | L3 | Tokens → AST. |
expand.hpp / expand.cpp | L4 | Word expansion and pathname globbing. |
executor.hpp / executor.cpp | L5 | Run the AST + builtins. |
m5.hpp / m5.cpp | M5 | Select, process substitution, and signal-trap orchestration. |
slsh.cpp | L6 | CLI / REPL driver and M5 entry point. |
smoke.cpp | test | Existing layered smoke test. |
m5-smoke.sh | test | M5 integration and security regression smoke test. |
fuzz.cpp | test | Bounded Clang/libFuzzer lexer/parser harness. |
Makefile | — | Self-contained build and validation targets. |
NOTICE | — | Original-authorship statement. |
Original SleelaTerminal™ work. Behaviour targets public POSIX-shell specifications; no shell source was copied.
Footerbar topic news feed
Configure the footerbar from the shell with footerbar chemistry, footerbar pharmacology, or footerbar chemistry pharmacology to select one or multiple topics. Use footerbar list to see the 100-term catalog, footerbar status to inspect the saved selection, and footerbar clear to disable it. The GUI polls for changes and displays RSS headlines for the selected topics. See FOOTERBAR-TOPICS.md.
Interactive Tab completion
In an interactive terminal, press Tab to complete a command from shell builtins and executable programs on PATH, or to complete a file or directory name. A unique directory completion keeps a trailing slash; a unique command/file completion adds a space. When several names match, Tab expands their shared prefix; pressing Tab again lists the matching candidates. Hidden files are offered when the typed prefix begins with a dot. Completion is part of the CLI line editor and does not change non-interactive script input.
Footer ticker appearance, scrolling, and RSS freshness
The footer ticker uses a slightly grey text colour with a 1px pure-white text outline. In Settings → Footer ticker, choose when rightward scrolling starts: 5, 10, 15, 30, 45, or 60 minutes after the current footer message appears. The preference is saved in the user configuration. RSS searches request the past day of stories and display up to eight headlines. When a topic feed is enabled, SleelaTerminal refreshes every 15 minutes from 9:00 AM through 4:59 PM local time, and hourly outside that workday window. Feed updates require network access and curl.
SLeeLa
<p align="center"><img src="images/sleela/sleela-wordmark.svg" alt="SLeeLa — The Now. The Ingredient." width="560"></p> <p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela-programming-language-002.jpg" alt="SLeeLa Marketing Logo" width="560"></p>