@symbeon/orbit-devops 1.3.1 → 1.4.0

package/.agent/skills/orbit-devops/SKILL.md

@@ -28,10 +28,11 @@ To reclaim space safely:
 2. Clean `npm-cache` using `npm cache clean --force` if large Node.js footprints are detected.
 3. Use `scripts/wsl/CompactWSL.ps1` (requires admin) to "squeeze" WSL2 virtual disks.
 
-### 3. Environment DNA Management
+### 3. Environment DNA Management & Genome Integration
 To ensure a portable and safe environment:
 1. Use `scripts/stack/SnapshotEnv.ps1` to generate a local `dev-stack.json`.
-2. Use `scripts/stack/Push-Stack.ps1` to sync the environment DNA to the `SH1W4/stack` repository.
+2. Access the **Genome Library** via the [agent-stack-dev](https://github.com/SH1W4/agent-stack-dev) skill to pull standardized Agent DNAs.
+3. Apply adaptive provisioning rules from `logic/` to mutate the environment based on machine constraints.
 
 ## Capabilities Mapping
 

package/bin/orbit.js

@@ -1,95 +1,87 @@
-#!/usr/bin/env node
-
 import { Command } from 'commander';
 import chalk from 'chalk';
-import spawn from 'cross-spawn';
 import path from 'path';
 import { fileURLToPath } from 'url';
+import os from 'os';
+
+// Providers
+import WindowsProvider from '../providers/WindowsProvider.js';
+import UnixProvider from '../providers/UnixProvider.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const PROJECT_ROOT = path.join(__dirname, '..');
 
+// Platform Detection & Provider Initialization
+let provider;
+const platform = os.platform();
+
+if (platform === 'win32') {
+  provider = new WindowsProvider(PROJECT_ROOT);
+} else if (platform === 'linux' || platform === 'darwin') {
+  provider = new UnixProvider(PROJECT_ROOT);
+} else {
+  console.error(chalk.red(`\n❌ Error: Unsupported platform: ${platform}`));
+  process.exit(1);
+}
+
 const program = new Command();
 
 program
   .name('orbit')
   .description('Orbit-DevOps: The Developer\'s Workspace Command Center')
-  .version('1.1.0');
-
-import fs from 'fs';
-
-// ... (previous imports)
-
-// Helper to run PowerShell scripts
-function runScript(scriptPath, args = []) {
-  // Safe path resolution for Windows
-  const fullPath = path.normalize(path.resolve(PROJECT_ROOT, scriptPath));
-  
-  if (!fs.existsSync(fullPath)) {
-    console.error(chalk.red(`\n❌ Error: Script not found at: ${fullPath}`));
-    process.exit(1);
-  }
-
-  console.log(chalk.blue(`\n🚀 Orbit Launching: ${path.basename(fullPath)}...`));
-
-  // Don't manually quote the path; spawn handles it if we don't use windowsVerbatimArgumentsor specific shell options
-  const child = spawn('powershell.exe', ['-ExecutionPolicy', 'Bypass', '-File', fullPath, ...args], {
-    stdio: 'inherit'
-  });
-
-  child.on('close', (code) => {
-    if (code === 0) {
-      console.log(chalk.green(`\n✅ Mission Complete (Exit Code: ${code})`));
-    } else {
-      console.log(chalk.red(`\n❌ Mission Failed (Exit Code: ${code})`));
-    }
-  });
-}
+  .version('1.4.0');
 
 // --- Commands ---
 
 program
   .command('doctor')
   .description('Run a full system diagnostic health check')
-  .action(() => {
-    runScript('scripts/diagnostic/SystemDiagnosticUser_v2.ps1');
+  .action(async () => {
+    await provider.runScript('Diagnostic', 'scripts/diagnostic/SystemDiagnosticUser_v2.ps1');
   });
 
 program
   .command('space')
   .description('Analyze disk usage and find hotspots')
-  .action(() => {
-    runScript('scripts/diagnostic/ScanStorage.ps1');
+  .action(async () => {
+    await provider.runScript('Storage Analysis', 'scripts/diagnostic/ScanStorage.ps1');
   });
 
 program
   .command('clean')
   .description('Perform safe system and dev-tool cleanup')
-  .action(() => {
-    runScript('scripts/cleanup/AdditionalCleanup.ps1');
+  .action(async () => {
+    await provider.runScript('Cleanup', 'scripts/cleanup/AdditionalCleanup.ps1');
   });
 
 program
   .command('compact')
   .description('Compact WSL2 virtual disks manually (requires Admin)')
-  .action(() => {
-    console.log(chalk.yellow('⚠️  Note: Compaction might require Administrator privileges.'));
-    runScript('scripts/wsl/CompactWSL.ps1');
+  .action(async () => {
+    if (platform !== 'win32') {
+      console.error(chalk.yellow('\n⚠️  Note: WSL2 compaction is only available on Windows.'));
+      return;
+    }
+    await provider.runScript('WSL Compaction', 'scripts/wsl/CompactWSL.ps1');
   });
 
 program
   .command('sync')
-  .description('Sync environment stack to GitHub (sh1w4/stack)')
-  .action(() => {
-    runScript('scripts/stack/Push-Stack.ps1');
+  .description('Sync environment stack to GitHub')
+  .action(async () => {
+    await provider.runScript('Stack Sync', 'scripts/stack/Push-Stack.ps1');
   });
 
 program
   .command('menu')
   .description('Launch the interactive PowerShell menu (Legacy)')
-  .action(() => {
-    runScript('scripts/core/Orbit.ps1');
+  .action(async () => {
+    if (platform !== 'win32') {
+      console.error(chalk.yellow('\n⚠️  Note: The interactive menu is currently Windows-only.'));
+      return;
+    }
+    await provider.runScript('Legacy Menu', 'scripts/core/Orbit.ps1');
   });
 
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbeon/orbit-devops",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "The Developer's Workspace Command Center. Diagnose, Optimize, Compact, Control.",
   "main": "bin/orbit.js",
   "bin": {

package/providers/BaseProvider.js

@@ -0,0 +1,33 @@
+import chalk from 'chalk';
+
+export default class BaseProvider {
+  constructor(projectRoot) {
+    this.projectRoot = projectRoot;
+  }
+
+  /**
+   * Run a platform-specific command or script.
+   * @param {string} taskName Name of the task
+   * @param {string} scriptPath Relative path to the script
+   * @param {Array} args Arguments for the script
+   */
+  async runScript(taskName, scriptPath, args = []) {
+    throw new Error('runScript() must be implemented by the provider');
+  }
+
+  logInfo(message) {
+    console.log(chalk.blue(`\n🚀 Orbit [${this.getName()}]: ${message}`));
+  }
+
+  logSuccess(message) {
+    console.log(chalk.green(`\n✅ ${message}`));
+  }
+
+  logError(message) {
+    console.error(chalk.red(`\n❌ Error [${this.getName()}]: ${message}`));
+  }
+
+  getName() {
+    return 'Base';
+  }
+}

package/providers/UnixProvider.js

@@ -0,0 +1,18 @@
+import BaseProvider from './BaseProvider.js';
+
+export default class UnixProvider extends BaseProvider {
+  /**
+   * Run a Bash/Shell script.
+   */
+  async runScript(taskName, scriptPath, args = []) {
+    this.logInfo(`(PREVIEW) Launching Unix command (Linux/macOS): ${scriptPath}...`);
+    
+    // In the future, this will map to .sh scripts or python scripts
+    this.logError(`Unix implementation for ${scriptPath} is coming soon in Phase 2.`);
+    return false;
+  }
+
+  getName() {
+    return 'Unix (Linux/macOS)';
+  }
+}

package/providers/WindowsProvider.js

@@ -0,0 +1,44 @@
+import spawn from 'cross-spawn';
+import path from 'path';
+import fs from 'fs';
+import BaseProvider from './BaseProvider.js';
+
+export default class WindowsProvider extends BaseProvider {
+  /**
+   * Run a PowerShell script.
+   */
+  async runScript(taskName, scriptPath, args = []) {
+    const fullPath = path.normalize(path.resolve(this.projectRoot, scriptPath));
+    
+    if (!fs.existsSync(fullPath)) {
+      this.logError(`Script not found at: ${fullPath}`);
+      return;
+    }
+
+    this.logInfo(`Launching: ${path.basename(fullPath)}...`);
+
+    return new Promise((resolve) => {
+      const child = spawn('powershell.exe', [
+        '-ExecutionPolicy', 'Bypass', 
+        '-File', fullPath, 
+        ...args
+      ], {
+        stdio: 'inherit'
+      });
+
+      child.on('close', (code) => {
+        if (code === 0) {
+          this.logSuccess(`Mission Complete (Exit Code: ${code})`);
+          resolve(true);
+        } else {
+          this.logError(`Mission Failed (Exit Code: ${code})`);
+          resolve(false);
+        }
+      });
+    });
+  }
+
+  getName() {
+    return 'Windows';
+  }
+}