refactors

Author: voltsparx

README.md

@@ -110,6 +110,13 @@ Installed command aliases:
 - `asrfacet-rb`
 - `asrfrb`
 
+Installer prompt theme (all platforms):
+
+- `[ASRFacet-Rb][INFO]`
+- `[ASRFacet-Rb][ OK ]`
+- `[ASRFacet-Rb][WARN]`
+- `[ASRFacet-Rb][FAIL]`
+
 ## Command Examples
 
 ```bash

docs/getting-started.md

@@ -34,6 +34,13 @@ Each installer supports:
 
 They stage the framework into its own `asrfacet-rb` application directory, install dependencies into that directory, create launchers, and print the final install and report paths when complete. After installation you can invoke the framework with either `asrfacet-rb` or the shorter alias `asrfrb`.
 
+Installer prompt legend is consistent across Linux, macOS, and Windows:
+
+- `[ASRFacet-Rb][INFO]` for progress
+- `[ASRFacet-Rb][ OK ]` for successful milestones
+- `[ASRFacet-Rb][WARN]` for recoverable issues
+- `[ASRFacet-Rb][FAIL]` for stopping errors
+
 ## First Commands
 
 ```bash

docs/website/download.html

@@ -73,6 +73,12 @@
       Website installers fetch required files from the main repository, then execute the maintained platform installer under <code>install/</code> so behavior stays consistent.
     </div>
 
+    <div class="callout callout-info">
+      <div class="callout-title">Prompt Theme</div>
+      Installer output now uses a shared prompt style across docs and platforms:
+      <code>[ASRFacet-Rb][INFO]</code>, <code>[ASRFacet-Rb][ OK ]</code>, <code>[ASRFacet-Rb][WARN]</code>, and <code>[ASRFacet-Rb][FAIL]</code>.
+    </div>
+
     <div class="callout callout-warn">
       <div class="callout-title">Authorized Use Only</div>
       Use ASRFacet-Rb only on systems you own or have explicit written permission to test.

docs/website/web_assets/installers/README.md

@@ -35,6 +35,15 @@ All installers support:
 
 If no mode is passed, an interactive mode chooser is shown.
 
+## Prompt Theme
+
+Installer prompts follow a shared subtle theme so terminal output feels consistent with docs and website language:
+
+- `[ASRFacet-Rb][INFO]` progress updates
+- `[ASRFacet-Rb][ OK ]` completed actions
+- `[ASRFacet-Rb][WARN]` recoverable warnings
+- `[ASRFacet-Rb][FAIL]` stopping errors
+
 ## Optional flags
 
 - `--yes` or `--no-prompt`: skip prompts where possible

docs/website/web_assets/installers/asrfacet-rb-installer-linux.sh

@@ -5,6 +5,7 @@ set -u
 set -o pipefail
 
 APP_NAME="asrfacet-rb"
+THEME_TAG="ASRFacet-Rb"
 REPO_URL="https://github.com/voltsparx/ASRFacet-Rb.git"
 BRANCH="main"
 TEMP_BASE="${TMPDIR:-/tmp}/${APP_NAME}-installer"
@@ -14,7 +15,7 @@ KEEP_TEMP="no"
 VERBOSE="no"
 WORK_DIR=""
 
-log() { printf '[%s] %s\n' "$1" "$2"; }
+log() { printf '[%s][%s] %s\n' "$THEME_TAG" "$1" "$2"; }
 info() { log "INFO" "$1"; }
 ok() { log " OK " "$1"; }
 warn() { log "WARN" "$1"; }

docs/website/web_assets/installers/asrfacet-rb-installer-macos.sh

@@ -5,6 +5,7 @@ set -u
 set -o pipefail
 
 APP_NAME="asrfacet-rb"
+THEME_TAG="ASRFacet-Rb"
 REPO_URL="https://github.com/voltsparx/ASRFacet-Rb.git"
 BRANCH="main"
 TEMP_BASE="${TMPDIR:-/tmp}/${APP_NAME}-installer"
@@ -14,7 +15,7 @@ KEEP_TEMP="no"
 VERBOSE="no"
 WORK_DIR=""
 
-log() { printf '[%s] %s\n' "$1" "$2"; }
+log() { printf '[%s][%s] %s\n' "$THEME_TAG" "$1" "$2"; }
 info() { log "INFO" "$1"; }
 ok() { log " OK " "$1"; }
 warn() { log "WARN" "$1"; }

docs/website/web_assets/installers/asrfacet-rb-installer-windows.cmd

@@ -4,6 +4,7 @@ setlocal EnableExtensions
 
 set "SCRIPT_DIR=%~dp0"
 set "SCRIPT_NAME=%~nx0"
+set "THEME=[ASRFacet-Rb]"
 set "PS_SCRIPT=%SCRIPT_DIR%asrfacet-rb-installer-windows.ps1"
 set "PS_EXE="
 set "MODE="
@@ -14,7 +15,7 @@ set "FLAG_VERBOSE="
 set "PS_ARGS="
 
 if not exist "%PS_SCRIPT%" (
-  echo [FAIL] Missing installer script: %PS_SCRIPT%
+  echo %THEME%[FAIL] Missing installer script: %PS_SCRIPT%
   exit /b 1
 )
 
@@ -54,8 +55,8 @@ if /I "%~1"=="--verbose" (
   goto :parse_args
 )
 
-echo [FAIL] Unknown argument: %~1
-echo [INFO] Run "%SCRIPT_NAME% --help" for usage.
+echo %THEME%[FAIL] Unknown argument: %~1
+echo %THEME%[INFO] Run "%SCRIPT_NAME% --help" for usage.
 exit /b 1
 
 :set_mode_install
@@ -83,7 +84,7 @@ shift
 goto :parse_args
 
 :multiple_mode
-echo [FAIL] Multiple modes provided. Use one of: install, test, update, uninstall.
+echo %THEME%[FAIL] Multiple modes provided. Use one of: install, test, update, uninstall.
 exit /b 1
 
 :args_done
@@ -100,30 +101,30 @@ if not defined PS_EXE where pwsh >nul 2>nul
 if not defined PS_EXE if not errorlevel 1 set "PS_EXE=pwsh"
 
 if not defined PS_EXE (
-  echo [FAIL] Neither powershell nor pwsh was found in PATH.
+  echo %THEME%[FAIL] Neither powershell nor pwsh was found in PATH.
   exit /b 1
 )
 
 if /I "%PS_EXE%"=="powershell" goto :run_powershell
 goto :run_pwsh
 
 :run_powershell
-echo [INFO] Running installer with PowerShell.
+echo %THEME%[INFO] Running installer with PowerShell.
 powershell -NoProfile -ExecutionPolicy Bypass -File "%PS_SCRIPT%" %PS_ARGS%
 set "EXIT_CODE=%ERRORLEVEL%"
 goto :finish
 
 :run_pwsh
-echo [INFO] Running installer with PowerShell Core (pwsh).
+echo %THEME%[INFO] Running installer with PowerShell Core (pwsh).
 pwsh -NoProfile -File "%PS_SCRIPT%" %PS_ARGS%
 set "EXIT_CODE=%ERRORLEVEL%"
 goto :finish
 
 :finish
 if not "%EXIT_CODE%"=="0" (
-  echo [FAIL] Installer failed with exit code %EXIT_CODE%.
+  echo %THEME%[FAIL] Installer failed with exit code %EXIT_CODE%.
 ) else (
-  echo [ OK ] Installer completed successfully.
+  echo %THEME%[ OK ] Installer completed successfully.
 )
 exit /b %EXIT_CODE%
 

docs/website/web_assets/installers/asrfacet-rb-installer-windows.ps1

@@ -17,14 +17,15 @@ Set-StrictMode -Version Latest
 $RepoUrl = "https://github.com/voltsparx/ASRFacet-Rb.git"
 $Branch = "main"
 $WorkDir = $null
+$ThemeTag = "ASRFacet-Rb"
 
 function Write-Labelled {
   param(
     [string]$Label,
     [string]$Message,
     [ConsoleColor]$Color = [ConsoleColor]::Gray
   )
-  Write-Host ("[{0}] {1}" -f $Label, $Message) -ForegroundColor $Color
+  Write-Host ("[{0}][{1}] {2}" -f $ThemeTag, $Label, $Message) -ForegroundColor $Color
 }
 
 function Write-Info { param([string]$Message) Write-Labelled -Label "INFO" -Message $Message -Color ([ConsoleColor]::Cyan) }

install/linux.sh

@@ -17,6 +17,7 @@ set -o pipefail
 
 APP_NAME="asrfacet-rb"
 ALIAS_NAME="asrfrb"
+THEME_TAG="ASRFacet-Rb"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 INSTALL_ROOT="$HOME/.local/share/$APP_NAME"
@@ -46,7 +47,7 @@ RUNTIME_PAYLOAD=(
   "asrfacet-rb.gemspec"
 )
 
-log() { printf '[%s] %s\n' "$1" "$2"; }
+log() { printf '[%s][%s] %s\n' "$THEME_TAG" "$1" "$2"; }
 info() { log "INFO" "$1"; }
 ok() { log " OK " "$1"; }
 warn() { log "WARN" "$1"; }

install/macos.sh

@@ -17,6 +17,7 @@ set -o pipefail
 
 APP_NAME="asrfacet-rb"
 ALIAS_NAME="asrfrb"
+THEME_TAG="ASRFacet-Rb"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
 INSTALL_ROOT="$HOME/Library/Application Support/$APP_NAME"
@@ -46,7 +47,7 @@ RUNTIME_PAYLOAD=(
   "asrfacet-rb.gemspec"
 )
 
-log() { printf '[%s] %s\n' "$1" "$2"; }
+log() { printf '[%s][%s] %s\n' "$THEME_TAG" "$1" "$2"; }
 info() { log "INFO" "$1"; }
 ok() { log " OK " "$1"; }
 warn() { log "WARN" "$1"; }