Overview

Fash (Flat Bash) is the official scripting ecosystem in PurOS v3.0. Fash scripts allow automation, simple calculation routines, interactive terminal layouts, and dynamic visualizations inside the sandboxed POSIX console. You can write shebang scripts directly inside the nano editor and execute them using ./yourscript.fash.

1. Sequential Line Execution (#!/bin/fash)

This engine processes standard console commands line-by-line exactly as if you were typing them sequentially in the prompt. Useful for setting up directories, making system backups, or calling series of built-in commands.

[COPY]#!/bin/fash
echo "Initializing environment setup..."
mkdir -p /ROOT/projects
cd /ROOT/projects
touch README.md
echo "Setup Complete!" > README.md
ls -l

2. Sandboxed JavaScript Routines (#!/bin/js)

This engine executes Javascript loops, calculations, condition blocks, and logic statements directly within a hardened virtual runtime window. It isolates global variables while offering key shell control handles.

[COPY]#!/bin/js
print("Executing JavaScript sandboxed code block.");
let total = 0;
for (let i = 1; i <= 10; i++) {
    total += i;
}
print("Sum of numbers from 1 to 10 is: " + total);

When running under #!/bin/js shebang, the following system API hooks are exposed in the execution sandbox context:

Multi-Layer Scripting Concept

Using Fash SDK v3.2, you can build layered architectures by structuring code into standalone shared modules (e.g. databases, utilities, parsers) and importing them inside a controller script using require(), while executing sub-processes via exec().

1. Creating a Shared Module Helper (/ROOT/bin/mathLib.js)

[COPY]#!/bin/js
// CommonJS exports supported!
module.exports = {
    add: (a, b) => a + b,
    square: (x) => x * x,
    info: "Secure Math Core Utility Module"
};

2. Requiring the Module in your Core Script (/ROOT/bin/main.js)

[COPY]#!/bin/js
// Require mathematical module dynamically!
const math = require("/ROOT/bin/mathLib.js");
print("Loading helper: " + math.info);
print("12 + 15 = " + math.add(12, 15));
print("Square of 9 = " + math.square(9));

Template A: Persistent Registry & System Health Monitor

Prints simulated RAM and CPU stats, increments a persistent boot metric count in the sandboxed KV database, and logs the execution state directly to a log file.

[COPY]#!/bin/js
let runs = db.get("boot_count") || 0;
runs++;
db.set("boot_count", runs);

print("--- System Health Logger v3.2 ---");
print("Number of runs registered: " + runs);
print("Writing health logs to /ROOT/system_health.log...");

const cpu = Math.floor(Math.random() * 25) + 5;
const logLine = "[" + new Date().toLocaleTimeString() + "] Health Check - CPU: " + cpu + "%\n";

let existing = cat("/ROOT/system_health.log") || "";
write("/ROOT/system_health.log", existing + logLine);
print("Done! Last Log: " + logLine.trim());

Template B: Dynamic Pipeline Controller (exec subprocesses)

This controller program invokes `neofetch` and standard folders subcommands natively, captures their outputs, and prints a formatted diagnostic summary.

[COPY]#!/bin/js
print("Initializing Pipeline Controller Diagnostic...");
print("Running sub-process neofetch...");

const sysInfo = exec("neofetch");
if (sysInfo.success) {
    print("--- Retrieved Sub-Process Output ---");
    print(sysInfo.output);
    print("-------------------------------------");
} else {
    print("Failed to run neofetch.");
}