DO Commands

Execute Workflows & I/O

The do verb triggers system operations, numerical dispatch, file operations, and management actions.

Command / Aliases	Arguments	Description & Notes
guests	<enable|disable>	Toggles guest access. ⚠️ Admin Only
load_config	<hosts|users|compute>	Reloads specified configuration files from disk. ⚠️ Admin Only
network	None	Generates a new network topology geometry.
system, subsystem	None	Creates a new child system in the hierarchy.
copy, study	None	Duplicates system context for independent analysis.
save	[all]	Persists state to disk. all saves the root hierarchy.
reload	None	Restores state from the last saved snapshot.
refresh	[all]	Updates bounding boxes and revision counters. all updates root.
segment	None	Processes mesh: removes duplicates, extracts volume/surface manifolds.
load	<file1> <file2>...	Loads multiple files into system context. Increments minor revision.
attach	[-d|-f] <path>...	Stages files. -d removes, -f forces overwrite. Maintains provenance.
add_user	<email> <fingerprint>	Appends user to users.cfg and reloads config.
remove_user	<email>	Removes user & unregisters active connections.
notify, all:	<message>	Broadcasts message to all connected clients.
solve, simulate, execute	None	Dispatches solver job. Validates flux continuity: ∮ J·n dA = d/dt ∫ ρ dV.
stop, pause	None	Gracefully halts active solver execution.
reset	None	Restores system to t=0 state, clears residuals.
import	<filepath>	Imports external data (defaults to SI meters).
export	<filepath>	Exports system data & topology to file.
shell, python	<script>	Executes external script in sandboxed environment. (Placeholder)
couple, decouple	<region_A> <region_B>	Manages region interfaces & conserved quantity continuity. (Placeholder)

🔍 HELP Interface & CLI Design Notes

Command	Arguments	Description
help / get help	None	Displays CLI structure, verbs, and examples.
help	<get|set|do>	Lists all commands in the specified category.
help	<noun>	Shows specific usage, syntax, and physical context for a command.