@magpiecloud/mags 1.6.1 → 1.6.2

package/bin/mags.js

@@ -215,6 +215,7 @@ ${colors.bold}Run Options:${colors.reset}
   -w, --workspace <id>            Use persistent workspace (S3 sync)
   -n, --name <name>               Set job name (for easier reference)
   -p, --persistent                Keep VM alive after script completes
+  --base <workspace>              Mount workspace read-only as base image
   -e, --ephemeral                 No workspace/S3 sync (fastest execution)
   -f, --file <path>               Upload file(s) to VM (repeatable)
   --url                           Enable public URL access (requires -p)
@@ -242,6 +243,8 @@ ${colors.bold}Examples:${colors.reset}
   mags run -e 'echo fast'           # Ephemeral (no S3 sync)
   mags run -f script.py 'python3 script.py'  # Upload + run file
   mags run -w myproject 'python3 script.py'
+  mags run --base golden 'npm test'           # Use golden as read-only base
+  mags run --base golden -w fork-1 'npm test' # Base + save changes to fork-1
   mags run -p --url 'python3 -m http.server 8080'
   mags run -n webapp -w webapp -p --url --port 3000 'npm start'
   mags workspace list               # List workspaces
@@ -436,6 +439,7 @@ async function newVM(name) {
 async function runJob(args) {
   let script = '';
   let workspace = '';
+  let baseWorkspace = '';
   let name = '';
   let persistent = false;
   let ephemeral = false;
@@ -455,6 +459,9 @@ async function runJob(args) {
       case '--name':
         name = args[++i];
         break;
+      case '--base':
+        baseWorkspace = args[++i];
+        break;
       case '-p':
       case '--persistent':
         persistent = true;
@@ -496,6 +503,10 @@ async function runJob(args) {
     log('red', 'Error: Cannot use --ephemeral with --persistent; ephemeral VMs are destroyed after execution');
     process.exit(1);
   }
+  if (ephemeral && baseWorkspace) {
+    log('red', 'Error: Cannot use --ephemeral with --base; ephemeral VMs have no workspace support');
+    process.exit(1);
+  }
 
   // Upload files if any
   let fileIds = [];
@@ -523,6 +534,7 @@ async function runJob(args) {
   // Only set workspace_id if not ephemeral
   if (!ephemeral && workspace) payload.workspace_id = workspace;
   if (name) payload.name = name;
+  if (baseWorkspace) payload.base_workspace_id = baseWorkspace;
   if (startupCommand) payload.startup_command = startupCommand;
   if (fileIds.length > 0) payload.file_ids = fileIds;
 
@@ -538,6 +550,7 @@ async function runJob(args) {
   log('green', `Job submitted: ${requestId}`);
   if (name) log('blue', `Name: ${name}`);
   if (workspace) log('blue', `Workspace: ${workspace}`);
+  if (baseWorkspace) log('blue', `Base workspace: ${baseWorkspace} (read-only)`);
   if (persistent) log('yellow', 'Persistent: VM will stay alive');
 
   // Poll for completion
@@ -1202,7 +1215,7 @@ async function main() {
         break;
       case '--version':
       case '-v':
-        console.log('mags v1.6.1');
+        console.log('mags v1.6.2');
         process.exit(0);
         break;
       case 'new':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magpiecloud/mags",
-  "version": "1.6.1",
+  "version": "1.6.2",
   "description": "Mags CLI - Execute scripts on Magpie's instant VM infrastructure",
   "main": "index.js",
   "bin": {