(doers)=

# 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. |