@misterhuydo/sentinel 1.0.97 → 1.0.99

package/.cairn/session.json

@@ -1,6 +1,6 @@
 {
-  "message": "Auto-checkpoint at 2026-03-23T07:34:25.856Z",
-  "checkpoint_at": "2026-03-23T07:34:25.857Z",
+  "message": "Auto-checkpoint at 2026-03-23T07:47:01.705Z",
+  "checkpoint_at": "2026-03-23T07:47:01.706Z",
   "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.97",
+  "version": "1.0.99",
   "description": "Sentinel — Autonomous DevOps Agent installer and manager",
   "bin": {
     "sentinel": "./bin/sentinel.js"

package/python/sentinel/sentinel_boss.py

@@ -179,6 +179,22 @@ When to act vs. when to ask:
 - Unclear intent (could be either) → use judgment: brief explanation + "Want me to run this now?"
 Never say "Stand by" or "Requesting..." and then return nothing. Either act, or ask.
 
+Issue identification — before calling create_issue:
+1. Determine if the message is a REAL issue/task (bug report, feature request, investigation ask)
+   vs. a status question, tool query, or casual chat. If not an issue, just answer normally.
+2. If it IS an issue, gather what's needed before creating:
+   - Project: which project? If unclear, ask. Use list_projects if you need to check names.
+   - Context: what's the problem? Include everything: description, error text, steps to reproduce.
+   - Attachments: summarise any files/screenshots the user shared.
+   - Support URL: note any ticket/doc/link the user mentioned.
+   - Identity: always captured automatically from the Slack session.
+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]
 IMPORTANT: Always write your actual reply text FIRST, then append [DONE] at the end. Example: "Hello! I'm Sentinel. [DONE]". Never output [DONE] as your only content.
 For greetings like "hello" or empty messages, introduce yourself briefly and offer help, then end with [DONE].
@@ -209,26 +225,35 @@ _TOOLS = [
     {
         "name": "create_issue",
         "description": (
-            "Deliver a fix/task request to a Sentinel project instance. "
-            "Use when the engineer says 'tell 1881 to do X', 'look into Y in project elprint', "
-            "'implement this in 1881: ...'. Can target any project by short name. "
-            "Defaults to the current project if no project is specified."
+            "Deliver a confirmed issue/task to a Sentinel project instance. "
+            "Only call this after you have: (1) confirmed the message is a real issue or task, "
+            "(2) identified the target project, (3) gathered enough context, and "
+            "(4) confirmed with the user ('I'll create this issue for project X — does that look right?'). "
+            "Do NOT call this for status questions, tool queries, or casual chat."
         ),
         "input_schema": {
             "type": "object",
             "properties": {
                 "description": {
                     "type": "string",
-                    "description": "Full task/problem description — everything the engineer told you",
+                    "description": "Full problem/task description — include all context the user gave you",
                 },
                 "project": {
                     "type": "string",
-                    "description": "Project short name to deliver to (e.g. '1881', 'elprint'). Omit for current project.",
+                    "description": "Project short name (e.g. '1881', 'elprint'). Ask if unclear.",
                 },
                 "target_repo": {
                     "type": "string",
                     "description": "Specific repo within the project (omit to let Sentinel auto-route)",
                 },
+                "support_url": {
+                    "type": "string",
+                    "description": "Any URL the user shared (ticket, doc, screenshot link, etc.)",
+                },
+                "attachments_summary": {
+                    "type": "string",
+                    "description": "Summary of any files/screenshots the user attached",
+                },
             },
             "required": ["description"],
         },
@@ -796,10 +821,28 @@ async def _run_tool(name: str, inputs: dict, cfg_loader, store, slack_client=Non
         else:
             project_dir = Path(".")
 
+        support_url          = inputs.get("support_url", "").strip()
+        attachments_summary  = inputs.get("attachments_summary", "").strip()
+
         issues_dir = project_dir / "issues"
         issues_dir.mkdir(exist_ok=True)
-        fname   = f"slack-{uuid.uuid4().hex[:8]}.txt"
-        content = (f"TARGET_REPO: {target_repo}\n\n" if target_repo else "") + description
+        fname = f"slack-{uuid.uuid4().hex[:8]}.txt"
+
+        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 = []
+        if submitter_line:
+            lines.append(submitter_line)
+        if target_repo:
+            lines.append(f"TARGET_REPO: {target_repo}")
+        if support_url:
+            lines.append(f"SUPPORT_URL: {support_url}")
+        lines.append(f"SUBMITTED_AT: {datetime.now(timezone.utc).isoformat()}")
+        lines.append("")
+        lines.append(description)
+        if attachments_summary:
+            lines.append(f"\nATTACHMENTS:\n{attachments_summary}")
+        content = "\n".join(lines)
         (issues_dir / fname).write_text(content, encoding="utf-8")
 
         # Touch SENTINEL_POLL_NOW so the target instance picks it up immediately
@@ -811,7 +854,7 @@ async def _run_tool(name: str, inputs: dict, cfg_loader, store, slack_client=Non
             try:
                 store.record_submitted_issue(
                     user_id=user_id,
-                    user_name="",        # resolved by caller if needed
+                    user_name=submitter_name,
                     project=project_label,
                     fname=fname,
                     description=description,
@@ -1610,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 "")
@@ -1751,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/.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);
-});