@grantx/fleet-cli 0.1.3 → 0.1.5

package/src/prompt-utils.js

@@ -0,0 +1,127 @@
+// prompt-utils.js — Shared readline prompt helpers for the fleet wizard.
+// All wizard phases import from here for consistent UX.
+
+import readline from 'node:readline';
+
+/**
+ * Create a readline interface for interactive prompts.
+ */
+export function createReadline() {
+  return readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+}
+
+/**
+ * Ask a single-line question with optional default.
+ */
+export function ask(rl, question, defaultValue = '') {
+  const prompt = defaultValue
+    ? `  ${question} [${defaultValue}]: `
+    : `  ${question}: `;
+  return new Promise((resolve) => {
+    rl.question(prompt, (answer) => {
+      resolve(answer.trim() || defaultValue);
+    });
+  });
+}
+
+/**
+ * Ask a required question (loops until non-empty).
+ */
+export async function askRequired(rl, question) {
+  while (true) {
+    const answer = await ask(rl, question);
+    if (answer) return answer;
+    console.log('    (required)');
+  }
+}
+
+/**
+ * Ask a yes/no question.
+ */
+export async function askYesNo(rl, question, defaultYes = true) {
+  const hint = defaultYes ? 'Y/n' : 'y/N';
+  const answer = await ask(rl, `${question} [${hint}]`);
+  if (!answer) return defaultYes;
+  return answer.toLowerCase().startsWith('y');
+}
+
+/**
+ * Ask for a numbered list selection.
+ * @param {readline.Interface} rl
+ * @param {string} question - Header question
+ * @param {Array<{label: string, description: string, value: any}>} options
+ * @returns {any} The selected option's value
+ */
+export async function askList(rl, question, options) {
+  console.log(`\n  ${question}`);
+  for (let i = 0; i < options.length; i++) {
+    const opt = options[i];
+    console.log(`    ${i + 1}. ${opt.label.padEnd(12)} — ${opt.description}`);
+  }
+  while (true) {
+    const answer = await ask(rl, `Choice [1-${options.length}]`);
+    const idx = parseInt(answer, 10) - 1;
+    if (idx >= 0 && idx < options.length) {
+      return options[idx].value;
+    }
+    console.log(`    (enter 1-${options.length})`);
+  }
+}
+
+/**
+ * Ask for comma-separated values.
+ */
+export async function askCommaSeparated(rl, question) {
+  const answer = await ask(rl, question);
+  if (!answer) return [];
+  return answer.split(',').map(s => s.trim()).filter(Boolean);
+}
+
+/**
+ * Ask for multi-line input (one per line, blank to finish).
+ */
+export async function askMultiline(rl, question, hint = 'blank line to finish') {
+  console.log(`  ${question} (${hint}):`);
+  const lines = [];
+  while (true) {
+    const line = await ask(rl, '>');
+    if (!line) break;
+    lines.push(line);
+  }
+  return lines;
+}
+
+/**
+ * Ask for a secret (masked display).
+ */
+export async function askSecret(rl, question) {
+  const answer = await askRequired(rl, question);
+  return answer;
+}
+
+/**
+ * Print a section header.
+ */
+export function printHeader(title) {
+  console.log(`\n  ${title}`);
+  console.log(`  ${'─'.repeat(title.length)}`);
+}
+
+/**
+ * Print a progress step.
+ */
+export function printStep(step, total, label, value) {
+  const stepStr = `[${step}/${total}]`;
+  const dots = '.'.repeat(Math.max(2, 30 - label.length));
+  console.log(`  ${stepStr} ${label} ${dots} ${value}`);
+}
+
+/**
+ * Check if running in interactive mode (TTY available).
+ */
+export function isInteractive() {
+  return process.stdin.isTTY === true;
+}

package/src/setup-agents.js

@@ -28,9 +28,12 @@ export function setupAgentWorkspaces(projectRoot, roster) {
     // Copy/symlink credentials
     setupCredentials(agentClaudeDir);
 
-    // Write per-agent CLAUDE.md
-    const claudeMd = generateAgentClaudeMd(agent, projectRoot);
-    fs.writeFileSync(path.join(agentDir, 'CLAUDE.md'), claudeMd);
+    // Write basic CLAUDE.md (caller may overwrite with a richer version)
+    const claudeMdPath = path.join(agentDir, 'CLAUDE.md');
+    if (!fs.existsSync(claudeMdPath)) {
+      const claudeMd = generateAgentClaudeMd(agent, projectRoot);
+      fs.writeFileSync(claudeMdPath, claudeMd);
+    }
   }
 
   // Initialize sessions.json

package/src/slack-setup.js

@@ -0,0 +1,153 @@
+// slack-setup.js — Guided Slack bot creation walkthrough for fleet setup.
+// Walks users through creating a Slack app, installing it, and collecting tokens.
+
+import { ask, askRequired, askYesNo, printHeader } from './prompt-utils.js';
+
+/**
+ * Run the Slack bot setup walkthrough.
+ * @param {readline.Interface} rl
+ * @param {string} teamId - Team ID for app naming
+ * @returns {Promise<object|null>} Slack config or null if skipped
+ */
+export async function runSlackSetup(rl, teamId) {
+  printHeader('Slack Integration (optional)');
+
+  const setup = await askYesNo(rl, 'Set up a Slack bot for fleet notifications?', true);
+  if (!setup) {
+    console.log('  Skipped. You can set this up later in fleet.config.json.\n');
+    return null;
+  }
+
+  // Step 1: Create the app
+  console.log(`
+  Step 1: Create a Slack App
+  --------------------------
+  1. Go to https://api.slack.com/apps
+  2. Click "Create New App" → "From a manifest"
+  3. Select your workspace
+  4. Paste this manifest:
+`);
+
+  const manifest = generateSlackManifest(teamId);
+  console.log(manifest);
+
+  await ask(rl, 'Press Enter when the app is created...');
+
+  // Step 2: Install
+  console.log(`
+  Step 2: Install to Workspace
+  ----------------------------
+  1. In your Slack app settings, click "Install to Workspace"
+  2. Authorize the requested permissions
+`);
+
+  await ask(rl, 'Press Enter when installed...');
+
+  // Step 3: Tokens
+  console.log(`
+  Step 3: Collect Tokens
+  ----------------------
+  1. Go to "OAuth & Permissions" → copy "Bot User OAuth Token" (xoxb-...)
+  2. Go to "Basic Information" → "App-Level Tokens" → Generate one with
+     connections:write scope (this is your xapp- token)
+`);
+
+  const botToken = await askRequired(rl, 'Bot Token (xoxb-...)');
+  if (!botToken.startsWith('xoxb-')) {
+    console.log('    ⚠ Token should start with xoxb- — proceeding anyway.');
+  }
+
+  const appToken = await askRequired(rl, 'App Token (xapp-...)');
+  if (!appToken.startsWith('xapp-')) {
+    console.log('    ⚠ Token should start with xapp- — proceeding anyway.');
+  }
+
+  // Step 4: Channels
+  console.log(`
+  Step 4: Create Channels
+  -----------------------
+  Create two channels in your Slack workspace:
+    #fleet-decisions — Agent dispatch decisions and completions
+    #fleet-general   — General fleet status and check-ins
+
+  Then get their channel IDs:
+    Right-click channel → "View channel details" → scroll to bottom → copy ID
+`);
+
+  const decisionsChannel = await askRequired(rl, 'Decisions channel ID (starts with C)');
+  const generalChannel = await askRequired(rl, 'General channel ID (starts with C)');
+
+  // Test connection
+  console.log('\n  Testing connection...');
+  const testResult = await testSlackConnection(botToken, generalChannel);
+  if (testResult.ok) {
+    console.log('  ✓ Posted test message to fleet-general');
+  } else {
+    console.log(`  ⚠ Test failed: ${testResult.error}`);
+    console.log('    Check that the bot is invited to the channel and tokens are correct.');
+    console.log('    Configuration saved anyway — you can fix tokens in fleet.config.json.');
+  }
+
+  console.log('');
+
+  return {
+    botToken,
+    appToken,
+    channels: {
+      decisions: decisionsChannel,
+      general: generalChannel,
+    },
+  };
+}
+
+// ── Helpers ───────────────────────────────────────────────────────
+
+/**
+ * Generate a Slack app manifest YAML.
+ */
+function generateSlackManifest(teamId) {
+  return `  ---
+  display_information:
+    name: "Fleet Bot (${teamId})"
+    description: "Agent fleet orchestration notifications"
+  features:
+    bot_user:
+      display_name: "Fleet Bot"
+      always_online: true
+  oauth_config:
+    scopes:
+      bot:
+        - chat:write
+        - channels:read
+        - channels:history
+        - users:read
+  settings:
+    socket_mode_enabled: true
+    org_deploy_enabled: false
+    token_rotation_enabled: false
+  ---`;
+}
+
+/**
+ * Test Slack connection by posting a message.
+ */
+async function testSlackConnection(botToken, channelId) {
+  try {
+    const res = await fetch('https://slack.com/api/chat.postMessage', {
+      method: 'POST',
+      headers: {
+        'Authorization': `Bearer ${botToken}`,
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({
+        channel: channelId,
+        text: '✓ Fleet bot connected.',
+      }),
+    });
+
+    const data = await res.json();
+    return { ok: data.ok, error: data.error || null };
+  } catch (err) {
+    return { ok: false, error: err.message };
+  }
+}