shoud-cli 1.0.11 → 3.0.2

package/src/tools/shell.js

@@ -0,0 +1,71 @@
+const { spawn } = require('child_process');
+const os = require('os');
+
+function getShell() {
+  if (os.platform() === 'win32') return 'powershell.exe';
+  return process.env.SHELL || '/bin/bash';
+}
+
+function getShellArgs(command) {
+  if (os.platform() === 'win32') {
+    const escaped = command.replace(/"/g, '`"');
+    return ['-NoProfile', '-Command', `& { ${escaped} } | Out-String -Width 4096`];
+  }
+  return ['-c', command];
+}
+
+/**
+ * Execute a shell command and stream output to `onOutput` (if provided).
+ * Returns { ok, exitCode, stdout, stderr, duration }.
+ */
+function runShell(command, { cwd, timeout, onOutput, env } = {}) {
+  return new Promise((resolve) => {
+    const start = Date.now();
+    let stdout = '';
+    let stderr = '';
+    let timedOut = false;
+
+    const child = spawn(getShell(), getShellArgs(command), {
+      cwd,
+      env: { ...process.env, ...(env || {}) },
+      windowsHide: true,
+    });
+
+    const timer = timeout ? setTimeout(() => {
+      timedOut = true;
+      try { child.kill('SIGKILL'); } catch (_) {}
+    }, timeout) : null;
+
+    const forward = (chunk, isErr) => {
+      const text = chunk.toString();
+      if (isErr) stderr += text; else stdout += text;
+      if (onOutput) onOutput(text, isErr);
+    };
+
+    child.stdout.on('data', (c) => forward(c, false));
+    child.stderr.on('data', (c) => forward(c, true));
+
+    child.on('close', (code) => {
+      if (timer) clearTimeout(timer);
+      resolve({
+        ok: code === 0 && !timedOut,
+        exitCode: code,
+        timedOut,
+        stdout: stdout.trim(),
+        stderr: stderr.trim(),
+        duration: Date.now() - start,
+      });
+    });
+
+    child.on('error', (err) => {
+      if (timer) clearTimeout(timer);
+      resolve({
+        ok: false, exitCode: -1, timedOut: false,
+        stdout, stderr: stderr + '\n' + err.message,
+        duration: Date.now() - start,
+      });
+    });
+  });
+}
+
+module.exports = { runShell };

package/src/ui/banner.js

@@ -0,0 +1,20 @@
+const chalk = require('chalk');
+
+const BANNER_ART = [
+  "  ███████╗██╗  ██╗ ██████╗ ██╗   ██╗██████╗ ",
+  "  ██╔════╝██║  ██║██╔═══██╗██║   ██║██╔══██╗",
+  "  ███████╗███████║██║   ██║██║   ██║██║  ██║",
+  "  ╚════██║██╔══██║██║   ██║██║   ██║██║  ██║",
+  "  ███████║██║  ██║╚██████╔╝╚██████╔╝██████╔╝",
+  "  ╚══════╝╚═╝  ╚═╝ ╚═════╝  ╚═════╝ ╚═════╝ "
+];
+
+function printStaticBanner() {
+  const color = chalk.hex('#B5F96C');
+  console.log(color(BANNER_ART.join('\n')));
+  console.log(color('  ┌──────────────────────────────────────────────────────────┐'));
+  console.log(color('  │          Give your computer a job.                       │'));
+  console.log(color('  └──────────────────────────────────────────────────────────┘'));
+}
+
+module.exports = { printStaticBanner, BANNER_ART };

package/src/ui/output.js

@@ -0,0 +1,17 @@
+const chalk = require('chalk');
+
+const sym = {
+  ok: chalk.green('✓'),
+  fail: chalk.red('✗'),
+  warn: chalk.yellow('⚠'),
+  info: chalk.cyan('●'),
+  bullet: chalk.gray('·'),
+};
+
+function section(title) { console.log(chalk.bold('\n' + title)); }
+function ok(msg) { console.log(`  ${sym.ok} ${msg}`); }
+function fail(msg) { console.log(`  ${sym.fail} ${msg}`); }
+function warn(msg) { console.log(`  ${sym.warn} ${msg}`); }
+function info(msg) { console.log(`  ${sym.info} ${msg}`); }
+
+module.exports = { section, ok, fail, warn, info, sym };

package/src/utils/config.js

@@ -0,0 +1,47 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const CONFIG_DIR = path.join(os.homedir(), '.shoud');
+const JOBS_DIR = path.join(CONFIG_DIR, 'jobs');
+const LOGS_DIR = path.join(CONFIG_DIR, 'logs');
+
+function ensureDir(dir, mode = 0o700) {
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true, mode });
+}
+
+function initDirs() {
+  ensureDir(CONFIG_DIR);
+  ensureDir(JOBS_DIR);
+  ensureDir(LOGS_DIR);
+}
+
+const paths = {
+  CONFIG_DIR,
+  JOBS_DIR,
+  LOGS_DIR,
+  SESSION_FILE: path.join(CONFIG_DIR, 'session.json'),
+  ALLOWLIST_FILE: path.join(CONFIG_DIR, 'allowlist.json'),
+  SETTINGS_FILE: path.join(CONFIG_DIR, 'settings.json'),
+  jobDir: (id) => path.join(JOBS_DIR, id),
+  jobFile: (id, name) => path.join(JOBS_DIR, id, name),
+};
+
+const DEFAULT_SETTINGS = {
+  apiUrl: 'https://shoud.online/api',
+  billingUrl: 'https://shoud.vantyrixtek.online',
+  defaultBudget: 2.0,
+  shellDefaults: { read: 30000, test: 300000, build: 600000, install: 600000 },
+  telemetry: false,
+};
+
+function loadSettings() {
+  try {
+    if (fs.existsSync(paths.SETTINGS_FILE)) {
+      return { ...DEFAULT_SETTINGS, ...JSON.parse(fs.readFileSync(paths.SETTINGS_FILE, 'utf-8')) };
+    }
+  } catch (_) {}
+  return { ...DEFAULT_SETTINGS };
+}
+
+module.exports = { paths, initDirs, loadSettings, DEFAULT_SETTINGS };

package/src/utils/errors.js

@@ -0,0 +1,21 @@
+class ShoudError extends Error {
+  constructor(message, code = 1, meta = {}) {
+    super(message);
+    this.name = 'ShoudError';
+    this.code = code;
+    this.meta = meta;
+  }
+}
+
+const ExitCodes = {
+  VERIFIED: 0,
+  FAILED: 1,
+  BLOCKED: 2,
+  PERMISSION_DENIED: 3,
+  VERIFICATION_FAILED: 4,
+  BUDGET_EXCEEDED: 5,
+  AUTH_REQUIRED: 6,
+  CANCELLED: 130,
+};
+
+module.exports = { ShoudError, ExitCodes };

package/src/context/checkpoint.js

@@ -1,82 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-const CONFIG_DIR = path.join(os.homedir(), '.shoud');
-const CHECKPOINT_FILE = path.join(CONFIG_DIR, 'checkpoint.json');
-const MAX_AGE_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
-
-// Ensure config directory exists with secure permissions
-if (!fs.existsSync(CONFIG_DIR)) {
-  fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
-}
-
-/**
- * Save the execution state (messages, etc.) to a checkpoint file.
- * Includes a timestamp for TTL.
- */
-function saveCheckpoint(state) {
-  try {
-    const data = {
-      timestamp: Date.now(),
-      ...state
-    };
-    fs.writeFileSync(CHECKPOINT_FILE, JSON.stringify(data, null, 2), {
-      encoding: 'utf-8',
-      mode: 0o600
-    });
-  } catch (err) {
-    console.error(`Failed to save checkpoint: ${err.message}`);
-    // We don't throw; the agent can continue without checkpointing
-  }
-}
-
-/**
- * Load a checkpoint if it exists and is not too old.
- * Returns the state object (e.g., { messages }) or null if none or expired.
- */
-function loadCheckpoint() {
-  if (!fs.existsSync(CHECKPOINT_FILE)) {
-    return null;
-  }
-  try {
-    const raw = fs.readFileSync(CHECKPOINT_FILE, 'utf-8');
-    const data = JSON.parse(raw);
-    const { timestamp, ...state } = data;
-
-    // Check TTL
-    if (timestamp && (Date.now() - timestamp) > MAX_AGE_MS) {
-      // Stale checkpoint – delete it and ignore
-      clearCheckpoint();
-      return null;
-    }
-
-    // Validate that the state contains at least a messages array
-    if (!state.messages || !Array.isArray(state.messages)) {
-      // Corrupted or invalid state; delete it
-      clearCheckpoint();
-      return null;
-    }
-
-    return state;
-  } catch (err) {
-    // If file is corrupt, delete it
-    clearCheckpoint();
-    return null;
-  }
-}
-
-/**
- * Clear (delete) the checkpoint file.
- */
-function clearCheckpoint() {
-  if (fs.existsSync(CHECKPOINT_FILE)) {
-    try {
-      fs.unlinkSync(CHECKPOINT_FILE);
-    } catch (_) {
-      // Ignore errors during cleanup
-    }
-  }
-}
-
-module.exports = { saveCheckpoint, loadCheckpoint, clearCheckpoint };

package/src/permissions/engine.js

@@ -1,133 +0,0 @@
-const inquirer = require('inquirer');
-const chalk = require('chalk');
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-const CONFIG_DIR = path.join(os.homedir(), '.shoud');
-const ALLOWLIST_FILE = path.join(CONFIG_DIR, 'allowlist.json');
-
-// Ensure config directory exists
-if (!fs.existsSync(CONFIG_DIR)) {
-  fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
-}
-
-// Load persistent allowlist (or create empty)
-function loadAllowlist() {
-  try {
-    if (fs.existsSync(ALLOWLIST_FILE)) {
-      return JSON.parse(fs.readFileSync(ALLOWLIST_FILE, 'utf-8'));
-    }
-  } catch (_) {}
-  return { commands: [], paths: [] };
-}
-
-// Save allowlist
-function saveAllowlist(data) {
-  try {
-    fs.writeFileSync(ALLOWLIST_FILE, JSON.stringify(data, null, 2), {
-      encoding: 'utf-8',
-      mode: 0o600
-    });
-  } catch (_) {}
-}
-
-// In‑memory session allowlist (cleared on CLI restart)
-let sessionAllowList = {
-  commands: new Set(),
-  paths: new Set()
-};
-
-/**
- * Check if a command is allowed by persistent or session allowlists.
- */
-function isAllowed(toolName, input) {
-  if (toolName === 'read_file') return true; // always safe
-
-  if (toolName === 'execute_shell') {
-    const cmd = input.command?.trim().split(/\s+/)[0] || '';
-    // Persistent allowlist
-    const persistent = loadAllowlist();
-    if (persistent.commands.includes(cmd)) return true;
-    // Session allowlist
-    if (sessionAllowList.commands.has(cmd)) return true;
-  }
-
-  if (toolName === 'write_file' || toolName === 'read_file') {
-    const filePath = input.path || '';
-    // Check persistent and session for paths (exact match or prefix)
-    // For simplicity, we'll just match exact paths; could be extended
-    const persistent = loadAllowlist();
-    if (persistent.paths.includes(filePath)) return true;
-    if (sessionAllowList.paths.has(filePath)) return true;
-  }
-
-  return false;
-}
-
-/**
- * Prompt user for permission, with options for session‑wide or persistent allow.
- */
-async function verifyPermission(toolName, input) {
-  // If already allowed, skip prompt
-  if (isAllowed(toolName, input)) return true;
-
-  // Build display info
-  let target = '';
-  if (toolName === 'execute_shell') target = input.command || 'unknown command';
-  else if (toolName === 'read_file' || toolName === 'write_file') target = input.path || 'unknown path';
-  else target = JSON.stringify(input);
-
-  console.log(chalk.yellow(`\n⚠ SHOUD requests permission to run: ${chalk.bold(toolName)}`));
-  console.log(chalk.gray(`Target: ${target}`));
-
-  const { permission } = await inquirer.prompt([
-    {
-      type: 'list',
-      name: 'permission',
-      message: 'Allow this operation?',
-      choices: [
-        { name: 'Allow once', value: 'once' },
-        { name: 'Allow for this session', value: 'session' },
-        { name: 'Always allow (save to config)', value: 'always' },
-        { name: 'Deny', value: 'deny' }
-      ]
-    }
-  ]);
-
-  if (permission === 'deny') return false;
-
-  // Add to session allowlist if requested
-  if (permission === 'session') {
-    if (toolName === 'execute_shell') {
-      const cmd = input.command.trim().split(/\s+/)[0];
-      sessionAllowList.commands.add(cmd);
-    } else if (toolName === 'read_file' || toolName === 'write_file') {
-      sessionAllowList.paths.add(input.path);
-    }
-    return true;
-  }
-
-  // Add to persistent allowlist
-  if (permission === 'always') {
-    const allowlist = loadAllowlist();
-    if (toolName === 'execute_shell') {
-      const cmd = input.command.trim().split(/\s+/)[0];
-      if (!allowlist.commands.includes(cmd)) {
-        allowlist.commands.push(cmd);
-        saveAllowlist(allowlist);
-      }
-    } else if (toolName === 'read_file' || toolName === 'write_file') {
-      if (!allowlist.paths.includes(input.path)) {
-        allowlist.paths.push(input.path);
-        saveAllowlist(allowlist);
-      }
-    }
-    return true;
-  }
-
-  // Once
-  return true;
-}
-
-module.exports = { verifyPermission };