blackops-onboard 0.1.0

package/README.md

@@ -0,0 +1,28 @@
+# blackops-onboard
+
+Agent-first onboarding for [BlackOps Center](https://blackopscenter.com).
+
+```bash
+npx blackops-onboard
+```
+
+That command:
+
+1. Provisions an onboarding token for you.
+2. Adds a `blackops` MCP server entry to your Claude Code settings (`~/.claude/settings.json`).
+3. Prints a prompt to paste into Claude Code.
+
+From there, the agent walks you through account creation, brand-voice capture, social-account OAuth, and publishing your first content across X, Threads, LinkedIn, and your new blog — entirely conversationally.
+
+## Re-running
+
+Re-running detects an existing config at `~/.blackops/config.json`. You can keep the existing token (and re-paste the saved prompt) or overwrite to start fresh.
+
+## Environment
+
+- `BLACKOPS_INSTALL_URL` — override the install endpoint (default `https://blackopscenter.com/api/install`).
+
+## Requirements
+
+- Node.js 18+
+- [Claude Code](https://claude.com/claude-code)

package/bin/onboard.mjs

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+// BlackOps Center agent-first onboarding CLI.
+//
+// What this does:
+//   1. POSTs to https://blackopscenter.com/api/install to mint an onboarding token.
+//   2. Writes ~/.blackops/config.json with token + MCP URL.
+//   3. Adds a `blackops` MCP server entry to Claude Code's settings.json.
+//   4. Prints the onboarding prompt for the user to paste into Claude Code.
+//
+// Re-runs are idempotent: an existing ~/.blackops/config.json will prompt the
+// user before overwriting.
+
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+import readline from 'node:readline/promises'
+
+const VERSION = '0.1.0'
+const INSTALL_URL = process.env.BLACKOPS_INSTALL_URL || 'https://blackopscenter.com/api/install'
+const CONFIG_DIR = path.join(os.homedir(), '.blackops')
+const CONFIG_PATH = path.join(CONFIG_DIR, 'config.json')
+
+const RESET = '\x1b[0m'
+const BOLD = '\x1b[1m'
+const DIM = '\x1b[2m'
+const GREEN = '\x1b[32m'
+const CYAN = '\x1b[36m'
+const YELLOW = '\x1b[33m'
+const RED = '\x1b[31m'
+
+const log = (s = '') => process.stdout.write(`${s}\n`)
+const err = (s) => process.stderr.write(`${RED}${s}${RESET}\n`)
+
+async function confirm(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+  try {
+    const answer = await rl.question(`${question} (y/N) `)
+    return /^y(es)?$/i.test(answer.trim())
+  } finally {
+    rl.close()
+  }
+}
+
+function findClaudeCodeSettingsPath() {
+  // Claude Code stores user-level settings in ~/.claude/settings.json on macOS/Linux.
+  // (The same file holds permissions, hooks, and MCP servers.)
+  const candidates = [
+    path.join(os.homedir(), '.claude', 'settings.json'),
+  ]
+  for (const p of candidates) {
+    if (fs.existsSync(p)) return p
+  }
+  return candidates[0] // first candidate; we'll create it
+}
+
+function readJsonSafe(filePath) {
+  try {
+    const raw = fs.readFileSync(filePath, 'utf8')
+    return JSON.parse(raw)
+  } catch {
+    return null
+  }
+}
+
+function writeJsonAtomic(filePath, value) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true })
+  const tmp = `${filePath}.tmp.${process.pid}`
+  fs.writeFileSync(tmp, `${JSON.stringify(value, null, 2)}\n`, 'utf8')
+  fs.renameSync(tmp, filePath)
+}
+
+async function callInstallEndpoint() {
+  const response = await fetch(INSTALL_URL, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ cli_version: VERSION }),
+  })
+  if (!response.ok) {
+    const text = await response.text().catch(() => '')
+    throw new Error(`install endpoint returned ${response.status}: ${text || 'no body'}`)
+  }
+  const data = await response.json()
+  if (!data?.token || !data?.mcp_url) {
+    throw new Error('install endpoint returned an invalid response')
+  }
+  return data
+}
+
+function injectClaudeCodeMcp({ mcpUrl, mcpServerName, token }) {
+  const settingsPath = findClaudeCodeSettingsPath()
+  const settings = readJsonSafe(settingsPath) ?? {}
+  settings.mcpServers = settings.mcpServers ?? {}
+
+  // Use the SSE/HTTP transport — Claude Code supports `type: "http"` MCP servers.
+  settings.mcpServers[mcpServerName] = {
+    type: 'http',
+    url: mcpUrl,
+    headers: {
+      Authorization: `Bearer ${token}`,
+    },
+  }
+
+  writeJsonAtomic(settingsPath, settings)
+  return settingsPath
+}
+
+async function main() {
+  log(`${BOLD}${CYAN}BlackOps Center — agent-first onboarding${RESET}`)
+  log(`${DIM}v${VERSION}${RESET}`)
+  log()
+
+  // Idempotency check — if the user already has a config, ask before overwriting.
+  if (fs.existsSync(CONFIG_PATH)) {
+    log(`${YELLOW}Existing config found at ${CONFIG_PATH}.${RESET}`)
+    const overwrite = await confirm('Overwrite and start fresh?')
+    if (!overwrite) {
+      log('Keeping existing config. Re-paste the prompt below to resume:')
+      log()
+      const existing = readJsonSafe(CONFIG_PATH)
+      log(existing?.prompt ?? '(no saved prompt)')
+      return
+    }
+  }
+
+  // 1. Mint onboarding token.
+  let install
+  try {
+    log(`${DIM}Provisioning onboarding token…${RESET}`)
+    install = await callInstallEndpoint()
+  } catch (e) {
+    err(`Failed to reach BlackOps install endpoint: ${e.message}`)
+    process.exit(1)
+  }
+
+  // 2. Save config locally.
+  const config = {
+    token: install.token,
+    mcp_url: install.mcp_url,
+    mcp_server_name: install.mcp_server_name || 'blackops',
+    token_id: install.token_id,
+    expires_at: install.expires_at,
+    prompt: install.prompt,
+    cli_version: VERSION,
+    installed_at: new Date().toISOString(),
+  }
+  writeJsonAtomic(CONFIG_PATH, config)
+  log(`${GREEN}✓${RESET} Saved config to ${CONFIG_PATH}`)
+
+  // 3. Wire up Claude Code MCP.
+  let settingsPath
+  try {
+    settingsPath = injectClaudeCodeMcp({
+      mcpUrl: config.mcp_url,
+      mcpServerName: config.mcp_server_name,
+      token: config.token,
+    })
+    log(`${GREEN}✓${RESET} Added MCP server "${config.mcp_server_name}" to ${settingsPath}`)
+  } catch (e) {
+    err(`Could not write Claude Code settings: ${e.message}`)
+    log('You can configure manually by adding this MCP server to your Claude Code settings:')
+    log(JSON.stringify({ [config.mcp_server_name]: { type: 'http', url: config.mcp_url, headers: { Authorization: `Bearer ${config.token}` } } }, null, 2))
+  }
+
+  // 4. Print onboarding prompt for the user.
+  log()
+  log(`${BOLD}Open Claude Code and paste this prompt to begin:${RESET}`)
+  log()
+  log(`${CYAN}${config.prompt}${RESET}`)
+  log()
+  log(`${DIM}Token expires: ${config.expires_at}${RESET}`)
+}
+
+main().catch((e) => {
+  err(`Unexpected error: ${e?.stack ?? e}`)
+  process.exit(1)
+})

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "blackops-onboard",
+  "version": "0.1.0",
+  "description": "Agent-first onboarding for BlackOps Center. Run via `npx blackops-onboard` to provision your account through Claude Code.",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "blackops-onboard": "./bin/onboard.mjs"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "UNLICENSED",
+  "homepage": "https://blackopscenter.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bennewton999/2024-blog.git",
+    "directory": "packages/blackops-onboard"
+  },
+  "keywords": [
+    "blackopscenter",
+    "claude-code",
+    "mcp",
+    "onboarding",
+    "cli"
+  ]
+}