@symbeon/orbit-devops 1.1.0 → 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/README.md

@@ -18,6 +18,9 @@
 
 **Orbit-DevOps** is a professional-grade CLI toolkit designed to reclaim GBs of "ghost" storage from modern development stacks. It specializes in **WSL2 VHDX compaction**, **Docker pruning**, and **Dev-Stack synchronization**.
 
+> [!IMPORTANT]
+> **Read the [Orbit Thesis & Manifesto](./THESIS.md)** to understand the philosophy and strategic vision behind this project.
+
 ## 🚀 One-Minute Start
 
 Run without installing:

package/THESIS.md

@@ -0,0 +1,50 @@
+# 🪐 Orbit-DevOps: Tese e Manifesto de Fundação
+
+## 📖 A Gênese: Por que o Orbit existe?
+
+Em uma era de desenvolvimento de software dominada por abstrações pesadas, ambientes de IA famintos por recursos e ferramentas que "sequestram" o controle do usuário, o workspace do desenvolvedor tornou-se um campo de batalha caótico. 
+
+O **Orbit-DevOps** nasceu de um problema fundamental enfrentado pela **Symbeon Labs**:
+> "Como manter um ambiente de alta fidelidade e alta performance, sem sacrificar a privacidade e sem se afogar na poluição digital gerada pelas próprias ferramentas de desenvolvimento?"
+
+---
+
+## 🏛️ Os Três Pilares da Tese
+
+### 1. A Automação Cirúrgica (Eficiência)
+A maioria dos utilitários de sistema são "marretas" que atingem tudo sem precisão. O Orbit é um "bisturi". Ele não apenas apaga arquivos; ele entende o ecossistema (Node.js, Docker, WSL, AppData) e remove cirurgicamente o que é lixo, preservando o que é DNA do projeto.
+
+### 2. Infraestrutura Agente-Pronta (Agentic Backbone)
+Este é o diferencial estratégico. Para que IAs e Agentes (como o Antigravity) operem com eficiência máxima, eles precisam de um ambiente limpo e previsível. O Orbit fornece a **"Linguagem de Controle"** que permite que humanos e IAs mantenham a infraestrutura em harmonia.
+
+### 3. Fortificando a Privacidade (Sovereign Context)
+O caos gera vazamento de dados. Ao organizar diagnósticos e remover rastros sensíveis de caminhos locais, o Orbit garante que o desenvolvedor possa compartilhar seu trabalho e suas métricas sem expor sua vida privada. É a ferramenta da **Soberania Digital**.
+
+### 4. Pilhas de Agentes (Agent DNA & Hybrid Evolution)
+Este é o ápice da tese Orbit. Não construímos apenas ferramentas para humanos; construímos o **DNA de infraestrutura para Agentes Autônomos**. 
+
+O diferencial do Orbit é a **Evolução Híbrida**:
+- **Genomas Fixos**: Blueprints de referência que garantem estabilidade e padrões. (Veja: [agent-stack-dev](https://github.com/SH1W4/agent-stack-dev))
+- **Adaptação Orgânica**: A capacidade do Orbit de observar o hardware e o contexto em tempo real (via `orbit doctor`) e "mutar" a stack para garantir performance máxima, agindo como um sistema imunológico e de provisionamento inteligente.
+
+---
+
+## 🚀 A Visão: Do Local para o Hub
+
+O Orbit não busca ser apenas um CLI. Ele é o primeiro passo para o **Symbeon Hub**:
+
+1. **Fase Atual (Orbit OS)**: Controle total da máquina local.
+2. **Fase Próxima (Orbit Sync)**: Sincronização de preferências e stacks entre máquinas.
+3. **Fase Final (Enterprise Fleet)**: Gestão centralizada de frotas de desenvolvimento, garantindo que "Um ambiente perfeito para um, seja o padrão para todos".
+
+---
+
+## 💡 Conclusão
+
+O Orbit-DevOps existe porque acreditamos que **a ordem precede a inteligência**. Antes de construirmos sistemas complexos, precisamos garantir que o solo (nosso workspace) é fértil, limpo e controlado. 
+
+**Orbit é o Centro de Comando para quem não aceita o caos.**
+
+---
+*Assinado,*
+**Symbeon Labs**

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.1.0",
+  "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';
+  }
+}

package/templates/adaptive-logic-sample.json

@@ -0,0 +1,27 @@
+{
+  "profile": "Autonomous-Edge-Agent",
+  "base_dna": "v1.2.0-core",
+  "adaptation_rules": [
+    {
+      "trigger": "RAM < 8GB",
+      "action": "use_lite_runtimes",
+      "impact": "Disables local LLM inference, switches to API-based agents."
+    },
+    {
+      "trigger": "Disk_Free < 20GB",
+      "action": "aggressive_cleanup",
+      "impact": "Runs `orbit clean` and `orbit compact` before any task."
+    },
+    {
+      "trigger": "OS == Windows_Server",
+      "action": "enable_fleet_telemetry",
+      "impact": "Activates enterprise monitoring hooks."
+    }
+  ],
+  "evolution_path": {
+    "step_1": "Analyze Context",
+    "step_2": "Mutate Requirements",
+    "step_3": "Provision Bio-Shell",
+    "step_4": "Verify Health"
+  }
+}

package/templates/agent-stack-dev.json

@@ -0,0 +1,24 @@
+{
+  "stack_name": "Autonomous-Dev-Shell",
+  "version": "1.0.0",
+  "archetype": "Specialist-Developer",
+  "requirements": {
+    "os": "Windows 11 | WSL2",
+    "runtime": ["Node.js 20.x", "Python 3.12"],
+    "cli_tools": ["gh", "npm", "git", "orbit"],
+    "env_vars": {
+      "AGENT_MODE": "autonomous",
+      "ORBIT_ENV": "production"
+    }
+  },
+  "provisioning": {
+    "doctor_before_run": true,
+    "cleanup_on_exit": true,
+    "sync_stack_on_change": true
+  },
+  "permissions": {
+    "fs_read": ["PROJECT_ROOT"],
+    "fs_write": ["PROJECT_ROOT/temp", "PROJECT_ROOT/logs"],
+    "network": true
+  }
+}