@misterhuydo/sentinel 1.0.1 → 1.0.3

package/lib/generate.js

@@ -31,7 +31,17 @@ function generateProjectScripts(projectDir, codeDir, pythonBin) {
 
   // init.sh
   fs.writeFileSync(path.join(projectDir, 'init.sh'), `#!/usr/bin/env bash
-# First-time setup: clone repos, test SSH, send test email
+# First-time setup for this Sentinel project instance.
+#
+# What this does:
+#   - Clones any repos defined in config/repo-configs/ that don't exist locally yet
+#     (skips repos that are already cloned — safe to run multiple times)
+#   - Indexes each repo with Cairn MCP for codebase context
+#   - Tests SSH connectivity to each configured log source
+#   - Sends a test email to verify SMTP settings
+#
+# Note: ongoing repo management (git pull, conflict resolution) is handled
+# automatically by Sentinel on each fix cycle — you don't need to do it manually.
 set -euo pipefail
 cd "$(dirname "$0")"
 PYTHONPATH="${codeDir}" "${pythonBin}" -m sentinel.main --config ./config --init

package/lib/init.js

@@ -1,234 +1,246 @@
-'use strict';
-
-const fs = require('fs-extra');
-const path = require('path');
-const os = require('os');
-const { execSync, spawnSync } = require('child_process');
-const prompts = require('prompts');
-const chalk = require('chalk');
-const { generateProjectScripts, generateWorkspaceScripts, writeExampleProject } = require('./generate');
-
-const ok   = msg => console.log(chalk.green('  ✔'), msg);
-const info = msg => console.log(chalk.cyan('  →'), msg);
-const warn = msg => console.log(chalk.yellow('  ⚠'), msg);
-const step = msg => console.log('\n' + chalk.bold.white(msg));
-
-module.exports = async function init() {
-  // ── Prompts ─────────────────────────────────────────────────────────────────
-  const answers = await prompts([
-    {
-      type: 'text',
-      name: 'workspace',
-      message: 'Workspace directory (each project lives here as a subdirectory)',
-      initial: path.join(os.homedir(), 'sentinel'),
-      format: v => v.replace(/^~/, os.homedir()),
-    },
-    {
-      type: 'select',
-      name: 'authMode',
-      message: 'How will Claude Code authenticate?',
-      choices: [
-        { title: 'API key  (Anthropic API account — recommended for servers)', value: 'apikey' },
-        { title: 'Claude Pro / OAuth  (will give you a URL to open in any browser)', value: 'oauth' },
-        { title: 'Skip  (I will configure this later)', value: 'skip' },
-      ],
-    },
-    {
-      type: prev => prev === 'apikey' ? 'password' : null,
-      name: 'anthropicKey',
-      message: 'Anthropic API key (sk-ant-...)',
-      validate: v => v.startsWith('sk-ant-') ? true : 'Key should start with sk-ant-',
-    },
-    {
-      type: 'confirm',
-      name: 'example',
-      message: 'Create an example project to show how to configure?',
-      initial: true,
-    },
-    {
-      type: 'confirm',
-      name: 'systemd',
-      message: 'Set up systemd service for auto-start on reboot?',
-      initial: process.platform === 'linux',
-    },
-  ], { onCancel: () => process.exit(0) });
-
-  const { workspace, authMode, anthropicKey, example, systemd } = answers;
-  const codeDir = path.join(workspace, 'code');
-
-  // ── Python ──────────────────────────────────────────────────────────────────
-  step('Checking Python…');
-  const python = findPython();
-  if (!python) {
-    console.error(chalk.red('  ✖ python3 not found. Install it first:'));
-    console.error('      sudo apt-get install -y python3 python3-pip python3-venv');
-    process.exit(1);
-  }
-  ok(`Python: ${run(python, ['--version']).trim()}`);
-
-  // ── Copy Sentinel Python source ─────────────────────────────────────────────
-  step('Installing Sentinel code…');
-  const bundledPython = path.join(__dirname, '..', 'python');
-  if (!fs.existsSync(bundledPython)) {
-    console.error(chalk.red('  ✖ Bundled Python source not found (run npm publish from the Sentinel repo)'));
-    process.exit(1);
-  }
-  fs.ensureDirSync(codeDir);
-  fs.copySync(bundledPython, codeDir, { overwrite: true });
-  ok(`Sentinel code → ${codeDir}`);
-
-  // ── Python venv ─────────────────────────────────────────────────────────────
-  step('Setting up Python environment…');
-  const venv = path.join(codeDir, '.venv');
-  if (!fs.existsSync(venv)) {
-    info('Creating virtual environment…');
-    runLive(python, ['-m', 'venv', venv]);
-  }
-  const pip = path.join(venv, 'bin', 'pip3');
-  const pythonBin = path.join(venv, 'bin', 'python3');
-  info('Installing Python packages…');
-  runLive(pip, ['install', '--quiet', '--upgrade', 'pip']);
-  runLive(pip, ['install', '--quiet', '-r', path.join(codeDir, 'requirements.txt')]);
-  ok('Python packages installed');
-
-  // ── Node tools ──────────────────────────────────────────────────────────────
-  step('Installing Node tools…');
-  installNpmGlobal('@misterhuydo/cairn-mcp', 'cairn');
-  installNpmGlobal('@anthropic-ai/claude-code', 'claude');
-
-  // ── Claude Code auth ─────────────────────────────────────────────────────────
-  step('Claude Code authentication…');
-  if (authMode === 'apikey' && anthropicKey) {
-    ok('API key will be written to each project\'s sentinel.properties');
-  } else if (authMode === 'oauth') {
-    console.log(chalk.yellow('\n  Claude Code will print a URL — open it in any browser to complete login.\n'));
-    spawnSync('claude', ['--print', 'hi'], { stdio: 'inherit', env: process.env });
-    ok('Claude Code authenticated (OAuth token stored in ~/.claude/)');
-  } else {
-    warn('Skipping auth — run "claude" manually on this server to authenticate when ready');
-  }
-
-  // ── Workspace structure ─────────────────────────────────────────────────────
-  step('Creating workspace…');
-  fs.ensureDirSync(workspace);
-  ok(`Workspace: ${workspace}`);
-
-  // ── Example project ─────────────────────────────────────────────────────────
-  if (example) {
-    step('Creating example project…');
-    const exampleDir = path.join(workspace, 'my-project');
-    writeExampleProject(exampleDir, codeDir, pythonBin, anthropicKey || '');
-    ok(`Example project: ${exampleDir}`);
-  }
-
-  // ── Workspace start/stop scripts ─────────────────────────────────────────────
-  step('Generating scripts…');
-  generateWorkspaceScripts(workspace);
-  ok(`${workspace}/startAll.sh`);
-  ok(`${workspace}/stopAll.sh`);
-
-  // ── systemd ──────────────────────────────────────────────────────────────────
-  if (systemd) {
-    step('Setting up systemd…');
-    setupSystemd(workspace);
-  }
-
-  // ── Done ─────────────────────────────────────────────────────────────────────
-  console.log('\n' + chalk.bold.green('══ Done! ══') + '\n');
-  console.log(`${chalk.bold('Next steps:')}`);
-  if (example) {
-    console.log(`
-  1. Configure your first project:
-     ${chalk.cyan(`${workspace}/my-project/config/sentinel.properties`)}
-     ${chalk.cyan(`${workspace}/my-project/config/log-configs/`)}
-     ${chalk.cyan(`${workspace}/my-project/config/repo-configs/`)}
-
-  2. First-time init (clones repos, tests SSH, sends test email):
-     ${chalk.cyan(`${workspace}/my-project/init.sh`)}
-
-  3. Start all projects:
-     ${chalk.cyan(`${workspace}/startAll.sh`)}
-
-  4. Stop all projects:
-     ${chalk.cyan(`${workspace}/stopAll.sh`)}
-`);
-  }
-  if (systemd) {
-    console.log(`  Auto-start is enabled. To manage:
-     ${chalk.cyan('sudo systemctl start sentinel')}
-     ${chalk.cyan('sudo systemctl status sentinel')}
-     ${chalk.cyan('journalctl -u sentinel -f')}
-`);
-  }
-  console.log(`  Add another project anytime:
-     ${chalk.cyan('sentinel add <project-name>')}
-`);
-};
-
-// ── Helpers ──────────────────────────────────────────────────────────────────
-
-function findPython() {
-  for (const bin of ['python3', 'python']) {
-    try {
-      execSync(`${bin} --version`, { stdio: 'pipe' });
-      return bin;
-    } catch (_) {}
-  }
-  return null;
-}
-
-function run(bin, args) {
-  const r = spawnSync(bin, args, { encoding: 'utf8' });
-  return (r.stdout || '') + (r.stderr || '');
-}
-
-function runLive(bin, args) {
-  const r = spawnSync(bin, args, { stdio: 'inherit' });
-  if (r.status !== 0) {
-    console.error(chalk.red(`  ✖ Command failed: ${bin} ${args.join(' ')}`));
-    process.exit(1);
-  }
-}
-
-function installNpmGlobal(pkg, checkBin) {
-  try {
-    execSync(`${checkBin} --version`, { stdio: 'pipe' });
-    ok(`${pkg} already installed`);
-  } catch (_) {
-    info(`Installing ${pkg}…`);
-    runLive('npm', ['install', '-g', pkg]);
-    ok(`${pkg} installed`);
-  }
-}
-
-function setupSystemd(workspace) {
-  const user = os.userInfo().username;
-  const svc = `/etc/systemd/system/sentinel.service`;
-  const content = `[Unit]
-Description=Sentinel — Autonomous DevOps Agent
-After=network-online.target
-Wants=network-online.target
-
-[Service]
-Type=forking
-User=${user}
-WorkingDirectory=${workspace}
-ExecStart=${workspace}/startAll.sh
-ExecStop=${workspace}/stopAll.sh
-Restart=on-failure
-RestartSec=10
-
-[Install]
-WantedBy=multi-user.target
-`;
-  try {
-    fs.writeFileSync('/tmp/sentinel.service', content);
-    execSync(`sudo mv /tmp/sentinel.service ${svc}`);
-    execSync('sudo systemctl daemon-reload');
-    execSync('sudo systemctl enable sentinel');
-    ok('sentinel.service enabled');
-  } catch (e) {
-    warn(`Could not write systemd service (need sudo): ${e.message}`);
-    warn(`Manually create ${svc} to auto-start on reboot`);
-  }
-}
+'use strict';
+
+const fs = require('fs-extra');
+const path = require('path');
+const os = require('os');
+const { execSync, spawnSync } = require('child_process');
+const prompts = require('prompts');
+const chalk = require('chalk');
+const { generateProjectScripts, generateWorkspaceScripts, writeExampleProject } = require('./generate');
+
+const ok   = msg => console.log(chalk.green('  ✔'), msg);
+const info = msg => console.log(chalk.cyan('  →'), msg);
+const warn = msg => console.log(chalk.yellow('  ⚠'), msg);
+const step = msg => console.log('\n' + chalk.bold.white(msg));
+
+module.exports = async function init() {
+  // ── Prompts ─────────────────────────────────────────────────────────────────
+  const answers = await prompts([
+    {
+      type: 'text',
+      name: 'workspace',
+      message: 'Workspace directory (each project lives here as a subdirectory)',
+      initial: path.join(os.homedir(), 'sentinel'),
+      format: v => v.replace(/^~/, os.homedir()),
+    },
+    {
+      type: 'select',
+      name: 'authMode',
+      message: 'How will Claude Code authenticate?',
+      choices: [
+        { title: 'API key  (Anthropic API account — recommended for servers)', value: 'apikey' },
+        { title: 'Claude Pro / OAuth  (will give you a URL to open in any browser)', value: 'oauth' },
+        { title: 'Skip  (I will configure this later)', value: 'skip' },
+      ],
+    },
+    {
+      type: prev => prev === 'apikey' ? 'password' : null,
+      name: 'anthropicKey',
+      message: 'Anthropic API key (sk-ant-...)',
+      validate: v => v.startsWith('sk-ant-') ? true : 'Key should start with sk-ant-',
+    },
+    {
+      type: 'confirm',
+      name: 'example',
+      message: 'Create an example project to show how to configure?',
+      initial: true,
+    },
+    {
+      type: 'confirm',
+      name: 'systemd',
+      message: 'Set up systemd service for auto-start on reboot?',
+      initial: process.platform === 'linux',
+    },
+  ], { onCancel: () => process.exit(0) });
+
+  const { workspace, authMode, anthropicKey, example, systemd } = answers;
+  const codeDir = path.join(workspace, 'code');
+
+  // ── Python ──────────────────────────────────────────────────────────────────
+  step('Checking Python…');
+  const python = findPython();
+  if (!python) {
+    console.error(chalk.red('  ✖ python3 not found. Install it first:'));
+    console.error('      sudo apt-get install -y python3 python3-pip python3-venv');
+    process.exit(1);
+  }
+  ok(`Python: ${run(python, ['--version']).trim()}`);
+
+  // ── Copy Sentinel Python source ─────────────────────────────────────────────
+  step('Installing Sentinel code…');
+  const bundledPython = path.join(__dirname, '..', 'python');
+  if (!fs.existsSync(bundledPython)) {
+    console.error(chalk.red('  ✖ Bundled Python source not found (run npm publish from the Sentinel repo)'));
+    process.exit(1);
+  }
+  fs.ensureDirSync(codeDir);
+  fs.copySync(bundledPython, codeDir, { overwrite: true });
+  ok(`Sentinel code → ${codeDir}`);
+
+  // ── Python venv ─────────────────────────────────────────────────────────────
+  step('Setting up Python environment…');
+  const venv = path.join(codeDir, '.venv');
+  if (!fs.existsSync(venv)) {
+    info('Creating virtual environment…');
+    runLive(python, ['-m', 'venv', venv]);
+  }
+  const pip = path.join(venv, 'bin', 'pip3');
+  const pythonBin = path.join(venv, 'bin', 'python3');
+  info('Installing Python packages…');
+  runLive(pip, ['install', '--quiet', '--upgrade', 'pip']);
+  runLive(pip, ['install', '--quiet', '-r', path.join(codeDir, 'requirements.txt')]);
+  ok('Python packages installed');
+
+  // ── Node tools ──────────────────────────────────────────────────────────────
+  step('Installing Node tools…');
+  installNpmGlobal('@misterhuydo/cairn-mcp', 'cairn');
+  installNpmGlobal('@anthropic-ai/claude-code', 'claude');
+
+  // ── Claude Code auth ─────────────────────────────────────────────────────────
+  step('Claude Code authentication…');
+  if (authMode === 'apikey' && anthropicKey) {
+    ok('API key will be written to each project\'s sentinel.properties');
+  } else if (authMode === 'oauth') {
+    console.log(chalk.yellow(
+      '\n  Launching Claude Code login — type /login at the prompt to get your auth URL.\n' +
+      '  Open the URL in any browser, log in with your Claude Pro account,\n' +
+      '  then type /exit (or Ctrl-C) to return here.\n'
+    ));
+    spawnSync('claude', [], { stdio: 'inherit' });
+    // Verify auth succeeded after the user exits claude
+    const authCheck = spawnSync('claude', ['--print', 'hi'], { encoding: 'utf8', timeout: 15000 });
+    const authOut = (authCheck.stdout || '') + (authCheck.stderr || '');
+    if (authOut.toLowerCase().includes('not logged in') || authOut.toLowerCase().includes('/login')) {
+      warn('Not authenticated yet — run "claude" and type /login when ready');
+    } else {
+      ok('Claude Code authenticated via OAuth');
+    }
+  } else {
+    warn('Skipping auth — set ANTHROPIC_API_KEY in sentinel.properties or run "claude" to authenticate');
+  }
+
+  // ── Workspace structure ─────────────────────────────────────────────────────
+  step('Creating workspace…');
+  fs.ensureDirSync(workspace);
+  ok(`Workspace: ${workspace}`);
+
+  // ── Example project ─────────────────────────────────────────────────────────
+  if (example) {
+    step('Creating example project…');
+    const exampleDir = path.join(workspace, 'my-project');
+    writeExampleProject(exampleDir, codeDir, pythonBin, anthropicKey || '');
+    ok(`Example project: ${exampleDir}`);
+  }
+
+  // ── Workspace start/stop scripts ─────────────────────────────────────────────
+  step('Generating scripts…');
+  generateWorkspaceScripts(workspace);
+  ok(`${workspace}/startAll.sh`);
+  ok(`${workspace}/stopAll.sh`);
+
+  // ── systemd ──────────────────────────────────────────────────────────────────
+  if (systemd) {
+    step('Setting up systemd…');
+    setupSystemd(workspace);
+  }
+
+  // ── Done ─────────────────────────────────────────────────────────────────────
+  console.log('\n' + chalk.bold.green('══ Done! ══') + '\n');
+  console.log(`${chalk.bold('Next steps:')}`);
+  if (example) {
+    console.log(`
+  1. Configure your first project:
+     ${chalk.cyan(`${workspace}/my-project/config/sentinel.properties`)}
+     ${chalk.cyan(`${workspace}/my-project/config/log-configs/`)}
+     ${chalk.cyan(`${workspace}/my-project/config/repo-configs/`)}
+
+  2. First-time init (clones repos, tests SSH, sends test email):
+     ${chalk.cyan(`${workspace}/my-project/init.sh`)}
+
+  3. Start all projects:
+     ${chalk.cyan(`${workspace}/startAll.sh`)}
+
+  4. Stop all projects:
+     ${chalk.cyan(`${workspace}/stopAll.sh`)}
+`);
+  }
+  if (systemd) {
+    console.log(`  Auto-start is enabled. To manage:
+     ${chalk.cyan('sudo systemctl start sentinel')}
+     ${chalk.cyan('sudo systemctl status sentinel')}
+     ${chalk.cyan('journalctl -u sentinel -f')}
+`);
+  }
+
+  console.log(`  Add another project anytime:
+     ${chalk.cyan('sentinel add <project-name>')}
+`);
+};
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+
+function findPython() {
+  for (const bin of ['python3', 'python']) {
+    try {
+      execSync(`${bin} --version`, { stdio: 'pipe' });
+      return bin;
+    } catch (_) {}
+  }
+  return null;
+}
+
+function run(bin, args) {
+  const r = spawnSync(bin, args, { encoding: 'utf8' });
+  return (r.stdout || '') + (r.stderr || '');
+}
+
+function runLive(bin, args) {
+  const r = spawnSync(bin, args, { stdio: 'inherit' });
+  if (r.status !== 0) {
+    console.error(chalk.red(`  ✖ Command failed: ${bin} ${args.join(' ')}`));
+    process.exit(1);
+  }
+}
+
+function installNpmGlobal(pkg, checkBin) {
+  try {
+    execSync(`${checkBin} --version`, { stdio: 'pipe' });
+    ok(`${pkg} already installed`);
+  } catch (_) {
+    info(`Installing ${pkg}…`);
+    runLive('npm', ['install', '-g', pkg]);
+    ok(`${pkg} installed`);
+  }
+}
+
+function setupSystemd(workspace) {
+  const user = os.userInfo().username;
+  const svc = `/etc/systemd/system/sentinel.service`;
+  const content = `[Unit]
+Description=Sentinel — Autonomous DevOps Agent
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=forking
+User=${user}
+WorkingDirectory=${workspace}
+ExecStart=${workspace}/startAll.sh
+ExecStop=${workspace}/stopAll.sh
+Restart=on-failure
+RestartSec=10
+
+[Install]
+WantedBy=multi-user.target
+`;
+  try {
+    fs.writeFileSync('/tmp/sentinel.service', content);
+    execSync(`sudo mv /tmp/sentinel.service ${svc}`);
+    execSync('sudo systemctl daemon-reload');
+    execSync('sudo systemctl enable sentinel');
+    ok('sentinel.service enabled');
+  } catch (e) {
+    warn(`Could not write systemd service (need sudo): ${e.message}`);
+    warn(`Manually create ${svc} to auto-start on reboot`);
+  }
+}

package/package.json

@@ -1,21 +1,21 @@
-{
-  "name": "@misterhuydo/sentinel",
-  "version": "1.0.1",
-  "description": "Sentinel — Autonomous DevOps Agent installer and manager",
-  "bin": {
-    "sentinel": "./bin/sentinel.js"
-  },
-  "scripts": {
-    "prepublishOnly": "node scripts/bundle.js"
-  },
-  "dependencies": {
-    "chalk": "^4.1.2",
-    "fs-extra": "^11.2.0",
-    "prompts": "^2.4.2"
-  },
-  "engines": {
-    "node": ">=16"
-  },
-  "author": "misterhuydo",
-  "license": "MIT"
-}
+{
+  "name": "@misterhuydo/sentinel",
+  "version": "1.0.3",
+  "description": "Sentinel — Autonomous DevOps Agent installer and manager",
+  "bin": {
+    "sentinel": "./bin/sentinel.js"
+  },
+  "scripts": {
+    "prepublishOnly": "node scripts/bundle.js"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "fs-extra": "^11.2.0",
+    "prompts": "^2.4.2"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "author": "misterhuydo",
+  "license": "MIT"
+}