@misterhuydo/sentinel 1.0.98 → 1.1.0

package/.cairn/.hint-lock

@@ -1 +1 @@
-2026-03-23T07:27:36.554Z
+2026-03-23T08:08:15.205Z

package/.cairn/session.json

@@ -1,6 +1,6 @@
 {
-  "message": "Auto-checkpoint at 2026-03-23T07:36:48.429Z",
-  "checkpoint_at": "2026-03-23T07:36:48.430Z",
+  "message": "Auto-checkpoint at 2026-03-23T08:15:23.322Z",
+  "checkpoint_at": "2026-03-23T08:15:23.323Z",
   "active_files": [],
   "notes": [],
   "mtime_snapshot": {}

package/bin/sentinel.js

@@ -1,86 +1,87 @@
-#!/usr/bin/env node
-'use strict';
-
-const chalk = require('chalk');
-const [,, command = 'help', ...args] = process.argv;
-
-// Handle flags before the main switch
-if (command === '--version' || command === '-v') {
-  const { version } = require('../package.json');
-  console.log(version);
-  process.exit(0);
-}
-if (command === '--help' || command === '-h') {
-  printUsage();
-  process.exit(0);
-}
-
-const BANNER = `
-${chalk.cyan('███████╗███████╗███╗   ██╗████████╗██╗███╗   ██╗███████╗██╗')}
-${chalk.cyan('██╔════╝██╔════╝████╗  ██║╚══██╔══╝██║████╗  ██║██╔════╝██║')}
-${chalk.cyan('███████╗█████╗  ██╔██╗ ██║   ██║   ██║██╔██╗ ██║█████╗  ██║')}
-${chalk.cyan('╚════██║██╔══╝  ██║╚██╗██║   ██║   ██║██║╚██╗██║██╔══╝  ██║')}
-${chalk.cyan('███████║███████╗██║ ╚████║   ██║   ██║██║ ╚████║███████╗███████╗')}
-${chalk.cyan('╚══════╝╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝')}
-${chalk.gray('  Autonomous DevOps Agent')}
-`;
-
-async function main() {
-  console.log(BANNER);
-
-  switch (command) {
-    case 'init':
-      await require('../lib/init')();
-      break;
-    case 'add':
-      await require('../lib/add')(args[0]);
-      break;
-    case 'upgrade': {
-      let upgradeCmd;
-      try {
-        upgradeCmd = require('../lib/upgrade');
-      } catch (loadErr) {
-        // upgrade.js itself is broken — self-heal with a bare npm install
-        console.log(chalk.yellow('  ⚠'), 'upgrade module failed to load (' + loadErr.message + ')');
-        console.log(chalk.cyan('  →'), 'Running bare npm install to self-heal...');
-        const { spawnSync } = require('child_process');
-        const r = spawnSync('npm', ['install', '-g', '@misterhuydo/sentinel@latest'],
-                            { stdio: 'inherit' });
-        if (r.status === 0) {
-          console.log(chalk.green('  ✔'), 'Self-healed — run `sentinel upgrade` again to finish');
-        } else {
-          console.error(chalk.red('  ✖'), 'npm install failed — try: npm install -g @misterhuydo/sentinel');
-        }
-        process.exit(r.status || 0);
-      }
-      await upgradeCmd();
-      break;
-    }
-    case 'help':
-    default:
-      printUsage();
-  }
-}
-
-function printUsage() {
-  const { version } = require('../package.json');
-  console.log(`${chalk.bold('sentinel')} v${version} — Autonomous DevOps Agent
-
-${chalk.bold('Usage:')}
-  sentinel init                        Interactive setup — install everything and create workspace
-  sentinel add <name>                  Add a blank project (fill config manually)
-  sentinel add <git-url>               Add a project pre-configured for a GitHub repo
-  sentinel add <project.json>          Add a project from a local JSON config file
-  sentinel add <https://host/cfg.json> Add a project from a remote JSON config URL
-  sentinel upgrade                     Pull latest version and hot-deploy Python source
-
-${chalk.bold('Options:')}
-  --version, -v                        Print version
-  --help,    -h                        Print this help
-`);
-}
-
-main().catch(err => {
-  console.error(chalk.red('Error:'), err.message);
-  process.exit(1);
-});
+#!/usr/bin/env node
+'use strict';
+
+const chalk = require('chalk');
+const [,, command = 'help', ...args] = process.argv;
+
+if (command === '--version' || command === '-v') {
+  const { version } = require('../package.json');
+  console.log(version);
+  process.exit(0);
+}
+if (command === '--help' || command === '-h') {
+  printUsage();
+  process.exit(0);
+}
+
+const BANNER = `
+${chalk.cyan('███████╗███████╗███╗   ██╗████████╗██╗███╗   ██╗███████╗██╗')}
+${chalk.cyan('██╔════╝██╔════╝████╗  ██║╚══██╔══╝██║████╗  ██║██╔════╝██║')}
+${chalk.cyan('███████╗█████╗  ██╔██╗ ██║   ██║   ██║██╔██╗ ██║█████╗  ██║')}
+${chalk.cyan('╚════██║██╔══╝  ██║╚██╗██║   ██║   ██║██║╚██╗██║██╔══╝  ██║')}
+${chalk.cyan('███████║███████╗██║ ╚████║   ██║   ██║██║ ╚████║███████╗███████╗')}
+${chalk.cyan('╚══════╝╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝')}
+${chalk.gray('  Autonomous DevOps Agent')}
+`;
+
+async function main() {
+  console.log(BANNER);
+  switch (command) {
+    case 'init':
+      await require('../lib/init')();
+      break;
+    case 'add':
+      await require('../lib/add')(args[0]);
+      break;
+    case 'test':
+      await require('../lib/test')(args[0]);
+      break;
+    case 'upgrade': {
+      let upgradeCmd;
+      try {
+        upgradeCmd = require('../lib/upgrade');
+      } catch (loadErr) {
+        console.log(chalk.yellow('  ⚠'), 'upgrade module failed to load (' + loadErr.message + ')');
+        console.log(chalk.cyan('  →'), 'Running bare npm install to self-heal...');
+        const { spawnSync } = require('child_process');
+        const r = spawnSync('npm', ['install', '-g', '@misterhuydo/sentinel@latest'],
+                            { stdio: 'inherit' });
+        if (r.status === 0) {
+          console.log(chalk.green('  ✔'), 'Self-healed — run `sentinel upgrade` again to finish');
+        } else {
+          console.error(chalk.red('  ✖'), 'npm install failed — try: npm install -g @misterhuydo/sentinel');
+        }
+        process.exit(r.status || 0);
+      }
+      await upgradeCmd();
+      break;
+    }
+    case 'help':
+    default:
+      printUsage();
+  }
+}
+
+function printUsage() {
+  const { version } = require('../package.json');
+  console.log(`${chalk.bold('sentinel')} v${version} — Autonomous DevOps Agent
+
+${chalk.bold('Usage:')}
+  sentinel init                        Interactive setup — install everything and create workspace
+  sentinel add <name>                  Add a blank project (fill config manually)
+  sentinel add <git-url>               Add a project pre-configured for a GitHub repo
+  sentinel add <project.json>          Add a project from a local JSON config file
+  sentinel add <https://host/cfg.json> Add a project from a remote JSON config URL
+  sentinel test [project]              Validate installation and config before going live
+  sentinel upgrade                     Pull latest version and hot-deploy Python source
+
+${chalk.bold('Options:')}
+  --version, -v                        Print version
+  --help,    -h                        Print this help
+`);
+}
+
+main().catch(err => {
+  console.error(chalk.red('Error:'), err.message);
+  process.exit(1);
+});

package/lib/test.js

@@ -0,0 +1,208 @@
+'use strict';
+const fs       = require('fs-extra');
+const path     = require('path');
+const os       = require('os');
+const { execSync, spawnSync } = require('child_process');
+const chalk    = require('chalk');
+
+const ok   = msg => console.log(chalk.green('  ✔'), msg);
+const fail = msg => console.log(chalk.red('  ✖'), msg);
+const warn = msg => console.log(chalk.yellow('  ⚠'), msg);
+const info = msg => console.log(chalk.cyan('  →'), msg);
+
+module.exports = async function testInstall(projectName) {
+  const defaultWorkspace = path.join(os.homedir(), 'sentinel');
+  const projectDir = projectName
+    ? path.join(defaultWorkspace, projectName)
+    : _findActiveProject(defaultWorkspace);
+
+  console.log(chalk.bold('\nSentinel — Installation Check\n'));
+
+  let passed = 0;
+  let failed = 0;
+
+  // ── 1. Tools ──────────────────────────────────────────────────────────────
+  info('Checking required tools...');
+
+  const tools = [
+    { cmd: 'python3 --version',  label: 'Python 3'          },
+    { cmd: 'node --version',     label: 'Node.js'           },
+    { cmd: 'git --version',      label: 'git'               },
+  ];
+  for (const { cmd, label } of tools) {
+    try {
+      const out = execSync(cmd, { encoding: 'utf8', stdio: ['pipe','pipe','pipe'] }).trim();
+      ok(`${label}: ${out}`);
+      passed++;
+    } catch {
+      fail(`${label} not found`);
+      failed++;
+    }
+  }
+
+  // ── 2. npm globals ────────────────────────────────────────────────────────
+  info('Checking npm globals...');
+
+  const npms = [
+    { cmd: 'sentinel --version',  label: '@misterhuydo/sentinel'   },
+    { cmd: 'cairn --version',     label: '@misterhuydo/cairn-mcp'  },
+    { cmd: 'claude --version',    label: '@anthropic-ai/claude-code'},
+  ];
+  for (const { cmd, label } of npms) {
+    try {
+      const out = execSync(cmd, { encoding: 'utf8', stdio: ['pipe','pipe','pipe'] }).trim();
+      ok(`${label}: ${out}`);
+      passed++;
+    } catch {
+      fail(`${label} not installed — run: npm install -g ${label}`);
+      failed++;
+    }
+  }
+
+  // ── 3. Claude auth ────────────────────────────────────────────────────────
+  info('Checking Claude auth...');
+  const apiKey = _readSentinelProp(projectDir, 'ANTHROPIC_API_KEY')
+               || process.env.ANTHROPIC_API_KEY || '';
+  const claudeProTasks = (_readSentinelProp(projectDir, 'CLAUDE_PRO_FOR_TASKS') || 'true').toLowerCase() !== 'false';
+
+  if (apiKey) {
+    ok(`ANTHROPIC_API_KEY configured (${apiKey.slice(0, 12)}...)`);
+    passed++;
+  } else {
+    warn('ANTHROPIC_API_KEY not set — Sentinel Boss will use CLI fallback only');
+  }
+
+  try {
+    const r = spawnSync('claude', ['--version'], { encoding: 'utf8', stdio: ['pipe','pipe','pipe'] });
+    if (r.status === 0) {
+      ok(`claude CLI available: ${(r.stdout || '').trim()}`);
+      if (claudeProTasks) {
+        ok('CLAUDE_PRO_FOR_TASKS=true — fix_engine will use Claude Pro subscription');
+      }
+      passed++;
+    } else {
+      warn('claude CLI found but --version failed');
+    }
+  } catch {
+    fail('claude CLI not found');
+    failed++;
+  }
+
+  if (!apiKey) {
+    // Try a quick login check
+    try {
+      const r = spawnSync('claude', ['--print', 'ping', '--no-interactive'],
+                          { encoding: 'utf8', timeout: 10000, stdio: ['pipe','pipe','pipe'] });
+      if (r.status === 0) {
+        ok('claude OAuth session active');
+        passed++;
+      } else {
+        warn('claude OAuth session may be expired — run: claude login');
+      }
+    } catch {
+      warn('Could not verify claude OAuth session');
+    }
+  }
+
+  // ── 4. Project config ─────────────────────────────────────────────────────
+  if (projectDir && fs.existsSync(projectDir)) {
+    info(`Checking project config at ${projectDir}...`);
+
+    const sentinelProps = path.join(projectDir, 'config', 'sentinel.properties');
+    if (fs.existsSync(sentinelProps)) {
+      ok('sentinel.properties found');
+      passed++;
+    } else {
+      fail(`sentinel.properties missing at ${sentinelProps}`);
+      failed++;
+    }
+
+    const logConfigs  = path.join(projectDir, 'config', 'log-configs');
+    const repoConfigs = path.join(projectDir, 'config', 'repo-configs');
+
+    const logCount  = fs.existsSync(logConfigs)  ? fs.readdirSync(logConfigs).filter(f => f.endsWith('.properties') && !f.startsWith('_')).length : 0;
+    const repoCount = fs.existsSync(repoConfigs) ? fs.readdirSync(repoConfigs).filter(f => f.endsWith('.properties') && !f.startsWith('_')).length : 0;
+
+    if (logCount > 0)  { ok(`${logCount} log-config(s) found`);  passed++; }
+    else               { warn('No log-configs found — add at least one in config/log-configs/'); }
+
+    if (repoCount > 0) { ok(`${repoCount} repo-config(s) found`); passed++; }
+    else               { warn('No repo-configs found — add at least one in config/repo-configs/'); }
+
+    // GitHub token
+    const ghToken = _readSentinelProp(projectDir, 'GITHUB_TOKEN') || '';
+    if (ghToken) { ok('GITHUB_TOKEN configured'); passed++; }
+    else         { warn('GITHUB_TOKEN not set — cannot open PRs'); }
+
+    // Slack
+    const slackBot = _readSentinelProp(projectDir, 'SLACK_BOT_TOKEN') || '';
+    const slackApp = _readSentinelProp(projectDir, 'SLACK_APP_TOKEN') || '';
+    if (slackBot && slackApp) { ok('Slack tokens configured (Boss enabled)'); passed++; }
+    else                      { warn('Slack tokens not set — Boss disabled'); }
+
+  } else if (projectName) {
+    fail(`Project '${projectName}' not found at ${projectDir}`);
+    failed++;
+  } else {
+    warn('No project specified — skipping project config checks');
+    warn('Run: sentinel test <project-name>');
+  }
+
+  // ── 5. Python deps ────────────────────────────────────────────────────────
+  info('Checking Python dependencies...');
+  const codeDir = path.join(defaultWorkspace, 'code');
+  const reqFile = path.join(codeDir, 'requirements.txt');
+  if (fs.existsSync(reqFile)) {
+    try {
+      execSync('python3 -c "import paramiko, schedule, requests, jinja2"',
+               { encoding: 'utf8', stdio: ['pipe','pipe','pipe'] });
+      ok('Python dependencies installed');
+      passed++;
+    } catch {
+      fail('Python dependencies missing — run: pip install -r requirements.txt');
+      failed++;
+    }
+  } else {
+    warn('requirements.txt not found — run: sentinel init');
+  }
+
+  // ── Summary ───────────────────────────────────────────────────────────────
+  console.log('');
+  if (failed === 0) {
+    console.log(chalk.green.bold(`  ✔ All checks passed (${passed} ok)`));
+  } else {
+    console.log(chalk.yellow.bold(`  ${passed} passed, ${failed} failed`));
+    console.log(chalk.gray('  Fix the issues above before starting Sentinel.'));
+  }
+  console.log('');
+  process.exit(failed > 0 ? 1 : 0);
+};
+
+
+function _findActiveProject(workspace) {
+  if (!fs.existsSync(workspace)) return null;
+  const dirs = fs.readdirSync(workspace)
+    .map(d => path.join(workspace, d))
+    .filter(d => fs.statSync(d).isDirectory()
+              && fs.existsSync(path.join(d, 'config', 'sentinel.properties')));
+  return dirs.length === 1 ? dirs[0] : null;
+}
+
+function _readSentinelProp(projectDir, key) {
+  if (!projectDir) return '';
+  // Try project-level first, then workspace-level
+  const candidates = [
+    path.join(projectDir, 'config', 'sentinel.properties'),
+    path.join(os.homedir(), 'sentinel', 'sentinel.properties'),
+  ];
+  for (const f of candidates) {
+    if (!fs.existsSync(f)) continue;
+    for (const line of fs.readFileSync(f, 'utf8').split('\n')) {
+      const stripped = line.trim();
+      if (stripped.startsWith('#') || !stripped.includes('=')) continue;
+      const [k, ...rest] = stripped.split('=');
+      if (k.trim() === key) return rest.join('=').split('#')[0].trim();
+    }
+  }
+  return '';
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@misterhuydo/sentinel",
-  "version": "1.0.98",
+  "version": "1.1.0",
   "description": "Sentinel — Autonomous DevOps Agent installer and manager",
   "bin": {
     "sentinel": "./bin/sentinel.js"

package/python/sentinel/sentinel_boss.py

@@ -191,6 +191,8 @@ Issue identification — before calling create_issue:
 3. Before calling the tool, confirm with the user in natural language:
    e.g. "I'll create an issue for project *1881* — here's what I have: [summary]. Look right?"
    Wait for their confirmation before proceeding.
+   EXCEPTION: if the user's message already contains a clear project + unambiguous description,
+   skip the confirmation and create immediately — don't ask when nothing is unclear.
 4. After creating, tell them the issue was queued and Sentinel will pick it up on the next poll.
 
 When the engineer's request is fully handled, end your LAST message with the token: [DONE]
@@ -826,7 +828,6 @@ async def _run_tool(name: str, inputs: dict, cfg_loader, store, slack_client=Non
         issues_dir.mkdir(exist_ok=True)
         fname = f"slack-{uuid.uuid4().hex[:8]}.txt"
 
-        from datetime import datetime, timezone as _tz
         submitter_name = store.get_user_name(user_id) if user_id else ""
         submitter_line = f"SUBMITTED_BY: {submitter_name} ({user_id})" if user_id else ""
         lines = []
@@ -836,7 +837,7 @@ async def _run_tool(name: str, inputs: dict, cfg_loader, store, slack_client=Non
             lines.append(f"TARGET_REPO: {target_repo}")
         if support_url:
             lines.append(f"SUPPORT_URL: {support_url}")
-        lines.append(f"SUBMITTED_AT: {datetime.now(_tz.utc).isoformat()}")
+        lines.append(f"SUBMITTED_AT: {datetime.now(timezone.utc).isoformat()}")
         lines.append("")
         lines.append(description)
         if attachments_summary:
@@ -1652,6 +1653,7 @@ async def _handle_with_cli(
         + f"\nManaged repos: {', '.join(repos) if repos else '(none configured)'}"
         + (f"\nLog sources: {', '.join(log_sources)}" if log_sources else "")
         + f"\nAdmin access for this user: {'YES — admin tools are available' if is_admin else 'NO — admin tools will be refused'}"
+        + "\nNOTE: Running in CLI fallback mode — admin tools and some features are unavailable. Ask user to configure ANTHROPIC_API_KEY for full features."
         + f"\n\nCurrent status (last 24 h):\n{status_json}"
         + f"\n\nOpen PRs:\n{prs_json}"
         + (f"\n\nLog search results:\n{search_json}" if search_json else "")
@@ -1793,6 +1795,9 @@ async def _handle_with_api(
             if not reply:
                 greeting = f"Hi {user_name}! " if user_name else "Hi! "
                 reply = f"{greeting}I'm Sentinel, your autonomous DevOps agent. How can I help you?"
+            # Heuristic override: if reply ends with a question, Claude is waiting for input
+            if is_done and re.search(r'\?\s*$', reply):
+                is_done = False
             history.append({"role": "assistant", "content": response.content})
             return reply, is_done
 

package/python/sentinel/slack_bot.py

@@ -379,9 +379,9 @@ async def _run_turn(session: _Session, message: str, client, cfg_loader, store,
     if len(session.history) > _MAX_HISTORY_TURNS * 2:
         session.history = session.history[-(_MAX_HISTORY_TURNS * 2):]
 
-    # Typing indicator
+    # Post "thinking..." and keep its ts so we can replace it with the real reply
     session.busy = True
-    await _post(client, channel, "_thinking..._")
+    thinking_ts = await _post(client, channel, "_thinking..._")
 
     reply = ""
     is_done = True
@@ -401,20 +401,38 @@ async def _run_turn(session: _Session, message: str, client, cfg_loader, store,
     finally:
         session.busy = False
 
-    await _post(client, channel, reply)
+    if thinking_ts:
+        await _update(client, channel, thinking_ts, reply)
+    else:
+        await _post(client, channel, reply)
     # If session ended, save current history; if history was just cleared it will already be [] in DB
     store.save_conversation(session.user_id, session.history)
 
 
 # ── Helpers ───────────────────────────────────────────────────────────────────
 
-async def _post(client, channel: str, text: str) -> None:
+async def _post(client, channel: str, text: str) -> str:
+    """Post a message and return its ts (for later update), or '' on failure."""
     if not text:
-        return
+        return ""
     try:
-        await client.chat_postMessage(channel=channel, text=text)
+        resp = await client.chat_postMessage(channel=channel, text=text)
+        return resp.get("ts", "")
     except Exception as e:
         logger.warning("Slack post failed: %s", e)
+        return ""
+
+
+async def _update(client, channel: str, ts: str, text: str) -> None:
+    """Replace an existing message in place (used to swap 'thinking...' with the reply)."""
+    if not text or not ts:
+        return
+    try:
+        await client.chat_update(channel=channel, ts=ts, text=text)
+    except Exception as e:
+        # Fall back to posting a new message if update fails (e.g. missing chat:write scope)
+        logger.warning("Slack update failed (%s), posting new message", e)
+        await _post(client, channel, text)
 
 
 async def _resolve_name(client, user_id: str) -> str:

package/.cairn/views/a348d8_sentinel.js

@@ -1,58 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-const chalk = require('chalk');
-const [,, command = 'help', ...args] = process.argv;
-if (command === '--version' || command === '-v') {
-  const { version } = require('../package.json');
-  console.log(version);
-  process.exit(0);
-}
-if (command === '--help' || command === '-h') {
-  printUsage();
-  process.exit(0);
-}
-const BANNER = `
-${chalk.cyan('███████╗███████╗███╗   ██╗████████╗██╗███╗   ██╗███████╗██╗')}
-${chalk.cyan('██╔════╝██╔════╝████╗  ██║╚══██╔══╝██║████╗  ██║██╔════╝██║')}
-${chalk.cyan('███████╗█████╗  ██╔██╗ ██║   ██║   ██║██╔██╗ ██║█████╗  ██║')}
-${chalk.cyan('╚════██║██╔══╝  ██║╚██╗██║   ██║   ██║██║╚██╗██║██╔══╝  ██║')}
-${chalk.cyan('███████║███████╗██║ ╚████║   ██║   ██║██║ ╚████║███████╗███████╗')}
-${chalk.cyan('╚══════╝╚══════╝╚═╝  ╚═══╝   ╚═╝   ╚═╝╚═╝  ╚═══╝╚══════╝╚══════╝')}
-${chalk.gray('  Autonomous DevOps Agent')}
-`;
-async function main() {
-  console.log(BANNER);
-  switch (command) {
-    case 'init':
-      await require('../lib/init')();
-      break;
-    case 'add':
-      await require('../lib/add')(args[0]);
-      break;
-    case 'upgrade':
-      await require('../lib/upgrade')();
-      break;
-    case 'help':
-    default:
-      printUsage();
-  }
-}
-function printUsage() {
-  const { version } = require('../package.json');
-  console.log(`${chalk.bold('sentinel')} v${version} — Autonomous DevOps Agent
-${chalk.bold('Usage:')}
-  sentinel init                        Interactive setup — install everything and create workspace
-  sentinel add <name>                  Add a blank project (fill config manually)
-  sentinel add <git-url>               Add a project pre-configured for a GitHub repo
-  sentinel add <project.json>          Add a project from a local JSON config file
-  sentinel add <https://host/cfg.json> Add a project from a remote JSON config URL
-  sentinel upgrade                     Pull latest version and hot-deploy Python source
-${chalk.bold('Options:')}
-  --version, -v                        Print version
-  --help,    -h                        Print this help
-`);
-}
-main().catch(err => {
-  console.error(chalk.red('Error:'), err.message);
-  process.exit(1);
-});