Serious Tasks and Automation

Serious Tasks & Automation

While Awake Simple S1 includes interactive RPG game templates, it is built as a serious, native automation and systems scripting tool for Windows.

Traditional Windows automation typically forces a tradeoff:

• Batch (.bat): Cryptic syntax, brittle error handling, and hard to maintain.
• PowerShell: Powerful, but complex syntax, slow startup times, and strict execution policies.
• Python: Clean syntax, but requires an external runtime installed on every machine.

Awake Simple S1 solves this: a clean, plain-English scripting language backed by a single portable binary (awss1.exe) with zero dependencies and native Win32 controls.

---

🚀 Why Use Awake S1 for Real-World Work?

1. Zero Runtime Footprint: You can drop awss1.exe on any fresh Windows computer (or server) via USB or network share and run scripts immediately.
2. Built-in Native UI Dialogs: Ask users for credentials, folders, or confirmation without needing C#, WinForms, or web engines.
3. Robust Process Lifecycle Control: Start silent background jobs, open interactive terminal prompts, monitor running processes, and terminate unresponsive software.
4. Color-Coded Status Output: Built-in display_success, display_warn, and display_error make terminal reports readable at a glance.

---

🛠️ Real-World Practical Examples

---

1. Process Watchdog / Auto-Restarter

Monitor whether a critical background application or service daemon is running. If it crashes or closes, alert the user and relaunch it automatically:

note: --- SERVICE WATCHDOG ---

check if process "server_daemon.exe" is running into variable is_running

statement(start)
if variable is_running == true then
   display_success("Service Watchdog: Server daemon is active and healthy.")
else
   display_error("CRITICAL: Server daemon is DOWN!")
   show popup("System Alert", "Server daemon has crashed. Relaunching in background...")
   
   start process "C:\\Services\\server_daemon.exe" in background
   wait 1 seconds
   
   check if process "server_daemon.exe" is running into variable check_again
   statement(start)
   if variable check_again == true then
      display_success("Watchdog: Server daemon successfully restored.")
   else
      display_error("Watchdog: Failed to restart daemon. Manual intervention required.")
   statement(end)
statement(end)

---

2. Automated Silent Backup Script

Silently archive directories, log results, and notify the user with a native Windows card when finished:

note: --- AUTOMATED BACKUP ROUTINE ---

display("Starting daily maintenance...")

note: 1. Silently create backup directory if it does not exist
run command "if not exist C:\\Backups mkdir C:\\Backups" in background

note: 2. Mirror project files into backup storage silently
display_warn("Mirroring project directories...")
run command "robocopy C:\\Projects C:\\Backups\\Projects /E /Z /R:2 /W:3 /NP" in background

wait 2 seconds
display_success("Backup job complete!")

note: 3. Present clean confirmation UI to user
show window template "card":
   title = "Maintenance Utility"
   header = "Backup Complete"
   content = "Project files have been safely mirrored to C:\\Backups\\Projects.\nTimestamp: Verified"
   button = "Dismiss"
finish window;

---

3. Interactive IT Utility / Maintenance Form

Create clean administrative forms where non-technical staff or team members can select actions without touching the command line:

note: --- IT ASSISTANCE UTILITY ---

show window template "choice":
   title = "Workstation Maintenance"
   question = "Choose a maintenance action to perform:"
   button1 = "Flush DNS & Reset IP"
   button2 = "Clear Temporary Files"
   into variable task_selected
finish window;

statement(start)
if variable task_selected == "Flush DNS & Reset IP" then
   display_warn("Flushing network cache...")
   run command "ipconfig /flushdns" in background
   run command "ipconfig /registerdns" in background
   display_success("Network cache flushed and registered.")
   show popup("Network Status", "DNS cache has been cleared and renewed.")
else
   display_warn("Purging user temp folder...")
   run command "del /q /f /s %TEMP%\\*" in background
   display_success("Temp directory purged.")
   show popup("Disk Cleanup", "Temporary system files have been safely purged.")
statement(end)

---

4. Interactive Command Prompt Launcher

When a developer or system administrator needs to open an actual Command Prompt session pre-configured to a specific environment:

note: --- DEVELOPER ENVIRONMENT LAUNCHER ---

display("Preparing development shell...")

note: Opens a real, interactive CMD window initialized to your project
run in terminal "title Awake Project Terminal && cd C:\\Projects && echo Environment Initialized! && dir /w"

display_success("Developer terminal launched in separate window.")

---

5. Automated Software Deployment Script

A simple setup flow that downloads files, checks if old software is running, closes it, and opens the new release:

note: --- AUTOMATED DEPLOYMENT ---

note: 1. Check if the application is currently running
check if process "target_app.exe" is running into variable is_active

statement(start)
if variable is_active == true then
   display_warn("Application is running. Closing it before updating...")
   stop process "target_app.exe"
   wait 1 seconds
else
   nothing_pp()
statement(end)

note: 2. Silently fetch the updated release package
display("Fetching latest package release...")
run command "curl -L https://example.com/latest.zip -o latest.zip" in background
wait 2 seconds

note: 3. Launch the new deployment file
display_success("Deployment completed successfully!")
open file "README.txt"

---

📊 Summary: Background vs. Visible Tasks

Task Type	Awake S1 Command	Behavior
Silent Shell Commands	run command "..." in background	Runs via cmd.exe /c completely hidden (SW_HIDE + CREATE_NO_WINDOW). Perfect for file operations, robocopy, and silent scripts.
Interactive Terminal	run in terminal "..."	Opens a visible cmd.exe /k window that runs your command and stays open for user input.
Background Executables	start process "..." in background	Runs any executable silently without creating taskbar or desktop windows.
Normal Launch	start process "..."	Launches an application normally in its own process without freezing your script.
Open File / URL	open file "..."	Opens files or links with default Windows apps (Notepad, browser, viewer).