@girardmedia/bootspring 1.2.0 → 2.0.3

package/cli/cloud-sync.js

@@ -0,0 +1,447 @@
+/**
+ * Bootspring Cloud Sync CLI
+ * Sync project context to Cloudflare R2
+ *
+ * @package bootspring
+ * @module cli/cloud-sync
+ */
+
+const r2Sync = require('../core/r2-sync');
+const auth = require('../core/auth');
+const session = require('../core/session');
+const utils = require('../core/utils');
+
+const { COLORS: C } = utils;
+
+// ============================================================================
+// Help
+// ============================================================================
+
+function showHelp() {
+  console.log(`
+${C.bold}${C.cyan}bootspring cloud-sync${C.reset} - Sync project context to cloud storage
+
+${C.bold}USAGE${C.reset}
+  bootspring cloud-sync <command> [options]
+
+${C.bold}COMMANDS${C.reset}
+  ${C.cyan}status${C.reset}              Show sync status
+  ${C.cyan}push${C.reset}                Push local context to cloud
+  ${C.cyan}pull${C.reset}                Pull context from cloud
+  ${C.cyan}history${C.reset}             List version history
+  ${C.cyan}restore${C.reset} <version>   Restore a specific version
+  ${C.cyan}configure${C.reset}           Configure R2 credentials
+  ${C.cyan}help${C.reset}                Show this help
+
+${C.bold}OPTIONS${C.reset}
+  --force             Force overwrite without confirmation
+  --no-version        Don't create version backup on push
+  --verify            Verify checksum before pull
+
+${C.bold}EXAMPLES${C.reset}
+  ${C.dim}# Check sync status${C.reset}
+  bootspring cloud-sync status
+
+  ${C.dim}# Push context to cloud${C.reset}
+  bootspring cloud-sync push
+
+  ${C.dim}# Pull latest context${C.reset}
+  bootspring cloud-sync pull
+
+  ${C.dim}# Restore previous version${C.reset}
+  bootspring cloud-sync restore v1708534800000
+
+${C.bold}ENVIRONMENT VARIABLES${C.reset}
+  BOOTSPRING_R2_ACCOUNT_ID       Cloudflare account ID
+  BOOTSPRING_R2_ACCESS_KEY_ID    R2 access key ID
+  BOOTSPRING_R2_SECRET_ACCESS_KEY R2 secret access key
+  BOOTSPRING_R2_BUCKET_NAME      Bucket name (default: bootspring-context)
+
+${C.dim}Configure R2 at: https://dash.cloudflare.com > R2 > Manage R2 API Tokens${C.reset}
+`);
+}
+
+// ============================================================================
+// Commands
+// ============================================================================
+
+/**
+ * Show sync status
+ */
+async function statusCommand(projectRoot, projectId) {
+  console.log(`\n${C.bold}Cloud Sync Status${C.reset}\n`);
+
+  // Check configuration
+  if (!r2Sync.isConfigured()) {
+    console.log(`${C.yellow}⚠${C.reset}  R2 not configured`);
+    console.log(`${C.dim}   Set environment variables or run: bootspring cloud-sync configure${C.reset}\n`);
+    return;
+  }
+
+  console.log(`${C.green}✓${C.reset}  R2 configured`);
+
+  // Validate credentials
+  const spinner = utils.createSpinner('Checking connection...');
+  spinner.start();
+
+  const validation = await r2Sync.validateCredentials();
+  if (!validation.valid) {
+    spinner.fail(`Connection failed: ${validation.error}`);
+    return;
+  }
+  spinner.succeed('Connection verified');
+
+  // Get status
+  const status = await r2Sync.getStatus(projectRoot, projectId);
+
+  console.log(`\n${C.bold}Local State${C.reset}`);
+  if (status.local.lastPush) {
+    console.log(`  Last push: ${C.cyan}${status.local.lastPush}${C.reset}`);
+  }
+  if (status.local.lastPull) {
+    console.log(`  Last pull: ${C.cyan}${status.local.lastPull}${C.reset}`);
+  }
+  if (status.local.currentChecksum) {
+    console.log(`  Checksum:  ${C.dim}${status.local.currentChecksum.substring(0, 16)}...${C.reset}`);
+  }
+
+  if (status.remote) {
+    console.log(`\n${C.bold}Remote State${C.reset}`);
+    console.log(`  Last sync: ${C.cyan}${status.remote.lastPush}${C.reset}`);
+    console.log(`  Version:   ${C.cyan}${status.remote.lastVersion}${C.reset}`);
+    console.log(`  Files:     ${status.remote.fileCount}`);
+    console.log(`  Size:      ${formatBytes(status.remote.totalSize)}`);
+
+    if (status.needsSync) {
+      console.log(`\n${C.yellow}⚠${C.reset}  Local changes detected - run ${C.cyan}bootspring cloud-sync push${C.reset} to sync`);
+    } else {
+      console.log(`\n${C.green}✓${C.reset}  Up to date`);
+    }
+  } else {
+    console.log(`\n${C.dim}No remote context found. Run 'bootspring cloud-sync push' to create.${C.reset}`);
+  }
+
+  console.log();
+}
+
+/**
+ * Push context to cloud
+ */
+async function pushCommand(projectRoot, projectId, options) {
+  console.log(`\n${C.bold}Push Context to Cloud${C.reset}\n`);
+
+  if (!r2Sync.isConfigured()) {
+    console.log(`${C.red}Error:${C.reset} R2 not configured`);
+    console.log(`${C.dim}Set environment variables or run: bootspring cloud-sync configure${C.reset}\n`);
+    return;
+  }
+
+  // Generate package preview
+  const pkg = r2Sync.generateContextPackage(projectRoot);
+  console.log(`Files to sync: ${C.cyan}${pkg.metadata.totalFiles}${C.reset}`);
+  console.log(`Total size:    ${C.cyan}${formatBytes(pkg.metadata.totalSize)}${C.reset}`);
+  console.log();
+
+  // Confirm unless forced
+  if (!options.force) {
+    const readline = require('readline');
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+
+    const answer = await new Promise(resolve => {
+      rl.question('Push to cloud? (y/N) ', resolve);
+    });
+    rl.close();
+
+    if (answer.toLowerCase() !== 'y') {
+      console.log(`${C.dim}Cancelled${C.reset}\n`);
+      return;
+    }
+  }
+
+  const spinner = utils.createSpinner('Pushing context to R2...');
+  spinner.start();
+
+  const result = await r2Sync.pushContext(projectRoot, projectId, {
+    createVersion: !options.noVersion
+  });
+
+  if (result.success) {
+    spinner.succeed(`Pushed ${result.fileCount} files (${formatBytes(result.totalSize)})`);
+    console.log(`${C.dim}Version: ${result.version}${C.reset}\n`);
+  } else {
+    spinner.fail(`Push failed: ${result.error}`);
+  }
+}
+
+/**
+ * Pull context from cloud
+ */
+async function pullCommand(projectRoot, projectId, options) {
+  console.log(`\n${C.bold}Pull Context from Cloud${C.reset}\n`);
+
+  if (!r2Sync.isConfigured()) {
+    console.log(`${C.red}Error:${C.reset} R2 not configured`);
+    return;
+  }
+
+  // Check for local changes
+  if (!options.force) {
+    const status = await r2Sync.getStatus(projectRoot, projectId);
+    if (status.needsSync) {
+      console.log(`${C.yellow}Warning:${C.reset} Local changes will be overwritten`);
+
+      const readline = require('readline');
+      const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+      });
+
+      const answer = await new Promise(resolve => {
+        rl.question('Continue? (y/N) ', resolve);
+      });
+      rl.close();
+
+      if (answer.toLowerCase() !== 'y') {
+        console.log(`${C.dim}Cancelled${C.reset}\n`);
+        return;
+      }
+    }
+  }
+
+  const spinner = utils.createSpinner('Pulling context from R2...');
+  spinner.start();
+
+  const result = await r2Sync.pullContext(projectRoot, projectId, {
+    version: options.version,
+    verifyChecksum: options.verify
+  });
+
+  if (result.success) {
+    if (result.upToDate) {
+      spinner.succeed('Already up to date');
+    } else {
+      spinner.succeed(`Restored ${result.restoredCount} files (${formatBytes(result.totalSize)})`);
+      console.log(`${C.dim}Version: ${result.version}${C.reset}`);
+    }
+  } else {
+    spinner.fail(`Pull failed: ${result.error}`);
+  }
+
+  console.log();
+}
+
+/**
+ * List version history
+ */
+async function historyCommand(projectId) {
+  console.log(`\n${C.bold}Version History${C.reset}\n`);
+
+  if (!r2Sync.isConfigured()) {
+    console.log(`${C.red}Error:${C.reset} R2 not configured`);
+    return;
+  }
+
+  const spinner = utils.createSpinner('Fetching versions...');
+  spinner.start();
+
+  const versions = await r2Sync.listVersions(projectId);
+  spinner.stop();
+
+  if (versions.length === 0) {
+    console.log(`${C.dim}No versions found${C.reset}\n`);
+    return;
+  }
+
+  console.log(`Found ${C.cyan}${versions.length}${C.reset} versions:\n`);
+
+  for (const version of versions.slice(0, 10)) {
+    // Parse timestamp from version
+    const timestamp = parseInt(version.replace('v', ''));
+    const date = new Date(timestamp);
+    console.log(`  ${C.cyan}${version}${C.reset}  ${C.dim}${date.toLocaleString()}${C.reset}`);
+  }
+
+  if (versions.length > 10) {
+    console.log(`  ${C.dim}... and ${versions.length - 10} more${C.reset}`);
+  }
+
+  console.log(`\n${C.dim}Restore with: bootspring cloud-sync restore <version>${C.reset}\n`);
+}
+
+/**
+ * Restore a specific version
+ */
+async function restoreCommand(projectRoot, projectId, version, options) {
+  console.log(`\n${C.bold}Restore Version${C.reset}\n`);
+
+  if (!r2Sync.isConfigured()) {
+    console.log(`${C.red}Error:${C.reset} R2 not configured`);
+    return;
+  }
+
+  console.log(`Version: ${C.cyan}${version}${C.reset}`);
+
+  // Confirm
+  if (!options.force) {
+    console.log(`${C.yellow}Warning:${C.reset} This will overwrite local files`);
+
+    const readline = require('readline');
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+
+    const answer = await new Promise(resolve => {
+      rl.question('Continue? (y/N) ', resolve);
+    });
+    rl.close();
+
+    if (answer.toLowerCase() !== 'y') {
+      console.log(`${C.dim}Cancelled${C.reset}\n`);
+      return;
+    }
+  }
+
+  const spinner = utils.createSpinner(`Restoring ${version}...`);
+  spinner.start();
+
+  const result = await r2Sync.pullContext(projectRoot, projectId, { version });
+
+  if (result.success) {
+    spinner.succeed(`Restored ${result.restoredCount} files`);
+  } else {
+    spinner.fail(`Restore failed: ${result.error}`);
+  }
+
+  console.log();
+}
+
+/**
+ * Configure R2 credentials
+ */
+async function configureCommand() {
+  console.log(`\n${C.bold}Configure Cloud Sync (Cloudflare R2)${C.reset}\n`);
+
+  console.log('To configure R2, set the following environment variables:\n');
+  console.log(`  ${C.cyan}BOOTSPRING_R2_ACCOUNT_ID${C.reset}        Your Cloudflare account ID`);
+  console.log(`  ${C.cyan}BOOTSPRING_R2_ACCESS_KEY_ID${C.reset}     R2 API token access key`);
+  console.log(`  ${C.cyan}BOOTSPRING_R2_SECRET_ACCESS_KEY${C.reset} R2 API token secret`);
+  console.log(`  ${C.cyan}BOOTSPRING_R2_BUCKET_NAME${C.reset}       Bucket name (optional)`);
+
+  console.log(`\n${C.bold}Steps:${C.reset}`);
+  console.log(`  1. Go to ${C.cyan}https://dash.cloudflare.com${C.reset}`);
+  console.log('  2. Navigate to R2 > Manage R2 API Tokens');
+  console.log('  3. Create a new API token with Object Read & Write permissions');
+  console.log('  4. Copy the Access Key ID and Secret Access Key');
+  console.log('  5. Create a bucket (or use default: bootspring-context)');
+  console.log('  6. Add the environment variables to your shell profile');
+
+  console.log(`\n${C.bold}Example (.bashrc / .zshrc):${C.reset}`);
+  console.log(`${C.dim}  export BOOTSPRING_R2_ACCOUNT_ID="your-account-id"${C.reset}`);
+  console.log(`${C.dim}  export BOOTSPRING_R2_ACCESS_KEY_ID="your-access-key"${C.reset}`);
+  console.log(`${C.dim}  export BOOTSPRING_R2_SECRET_ACCESS_KEY="your-secret"${C.reset}`);
+
+  console.log();
+}
+
+// ============================================================================
+// Utilities
+// ============================================================================
+
+function formatBytes(bytes) {
+  if (bytes === 0) return '0 B';
+  const k = 1024;
+  const sizes = ['B', 'KB', 'MB', 'GB'];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + ' ' + sizes[i];
+}
+
+function parseArgs(args) {
+  const options = {
+    force: false,
+    noVersion: false,
+    verify: false,
+    version: null
+  };
+
+  const positional = [];
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === '--force' || arg === '-f') {
+      options.force = true;
+    } else if (arg === '--no-version') {
+      options.noVersion = true;
+    } else if (arg === '--verify') {
+      options.verify = true;
+    } else if (!arg.startsWith('-')) {
+      positional.push(arg);
+    }
+  }
+
+  return { options, positional };
+}
+
+// ============================================================================
+// Main
+// ============================================================================
+
+async function main(args) {
+  const { options, positional } = parseArgs(args);
+  const command = positional[0] || 'help';
+
+  // Help doesn't require auth
+  if (command === 'help' || command === '--help' || command === '-h') {
+    showHelp();
+    return;
+  }
+
+  // Configure doesn't require auth
+  if (command === 'configure') {
+    await configureCommand();
+    return;
+  }
+
+  // Get project context
+  const projectRoot = process.cwd();
+  const project = session.getEffectiveProject();
+  const projectId = project?.id || project?.slug || 'local';
+
+  switch (command) {
+    case 'status':
+      await statusCommand(projectRoot, projectId);
+      break;
+
+    case 'push':
+      await pushCommand(projectRoot, projectId, options);
+      break;
+
+    case 'pull':
+      await pullCommand(projectRoot, projectId, options);
+      break;
+
+    case 'history':
+      await historyCommand(projectId);
+      break;
+
+    case 'restore': {
+      const version = positional[1];
+      if (!version) {
+        console.log(`${C.red}Error:${C.reset} Version required`);
+        console.log(`${C.dim}Usage: bootspring cloud-sync restore <version>${C.reset}\n`);
+        return;
+      }
+      await restoreCommand(projectRoot, projectId, version, options);
+      break;
+    }
+
+    default:
+      console.log(`${C.red}Unknown command:${C.reset} ${command}`);
+      showHelp();
+  }
+}
+
+module.exports = { run: main, showHelp };

package/cli/content.js

@@ -0,0 +1,198 @@
+/**
+ * Bootspring Content Command
+ * Generate and manage content (blogs, docs, release notes, etc.)
+ *
+ * @package bootspring
+ * @command content
+ */
+
+const path = require('path');
+const utils = require('../core/utils');
+const contentTemplate = require('../generators/templates/content.template');
+
+/**
+ * Generate content file
+ */
+function generateContent(type, args) {
+  const contentType = contentTemplate.getContentType(type);
+
+  if (!contentType) {
+    utils.print.error(`Unknown content type: ${type}`);
+    utils.print.dim('Available types: ' + Object.keys(contentTemplate.CONTENT_TYPES).join(', '));
+    return;
+  }
+
+  const parsedArgs = utils.parseArgs(args);
+
+  // Build options from args
+  const options = {
+    title: parsedArgs.title || parsedArgs.t || '',
+    description: parsedArgs.description || parsedArgs.d || '',
+    author: parsedArgs.author || parsedArgs.a || 'Team',
+    version: parsedArgs.version || parsedArgs.v || '1.0.0',
+    tags: parsedArgs.tags ? parsedArgs.tags.split(',').map(t => t.trim()) : [],
+    name: parsedArgs.name || parsedArgs.n || '',
+    date: parsedArgs.date || new Date().toISOString().split('T')[0]
+  };
+
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}⚡ Bootspring Content${utils.COLORS.reset}
+${utils.COLORS.dim}Generating ${contentType.name}...${utils.COLORS.reset}
+`);
+
+  const spinner = utils.createSpinner(`Creating ${contentType.name}`).start();
+
+  try {
+    const content = contentTemplate.generate(type, options);
+
+    // Determine output path
+    const filename = options.title
+      ? options.title.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '')
+      : type;
+
+    const outputDir = parsedArgs.output || parsedArgs.o || contentType.directory;
+    const outputPath = path.join(process.cwd(), outputDir, `${filename}${contentType.extension}`);
+
+    // Create directory if needed
+    const dir = path.dirname(outputPath);
+    if (!utils.fileExists(dir)) {
+      require('fs').mkdirSync(dir, { recursive: true });
+    }
+
+    utils.writeFile(outputPath, content);
+    spinner.succeed(`Created ${contentType.name}`);
+
+    console.log(`
+${utils.COLORS.bold}File created:${utils.COLORS.reset} ${outputPath}
+
+${utils.COLORS.dim}Next steps:${utils.COLORS.reset}
+  1. Edit the generated file with your content
+  2. Run ${utils.COLORS.cyan}bootspring agent invoke content-expert${utils.COLORS.reset} for writing help
+  3. Publish when ready
+`);
+
+  } catch (error) {
+    spinner.fail(`Failed to create ${contentType.name}: ${error.message}`);
+  }
+}
+
+/**
+ * List available content types
+ */
+function listTypes() {
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}⚡ Bootspring Content Types${utils.COLORS.reset}
+${utils.COLORS.dim}Generate any content type with a single command${utils.COLORS.reset}
+`);
+
+  const types = contentTemplate.listContentTypes();
+
+  for (const [id, type] of Object.entries(types)) {
+    console.log(`  ${utils.COLORS.cyan}${id}${utils.COLORS.reset}`);
+    console.log(`    ${utils.COLORS.dim}${type.name} (${type.extension})${utils.COLORS.reset}`);
+    console.log(`    ${utils.COLORS.dim}Directory: ${type.directory}${utils.COLORS.reset}`);
+    console.log();
+  }
+
+  utils.print.dim(`${Object.keys(types).length} content types available`);
+  utils.print.dim('Use "bootspring content new <type> --title \'Title\'" to generate');
+}
+
+/**
+ * Show content help
+ */
+function showHelp() {
+  console.log(`
+${utils.COLORS.cyan}${utils.COLORS.bold}⚡ Bootspring Content${utils.COLORS.reset}
+${utils.COLORS.dim}Generate and manage content for your project${utils.COLORS.reset}
+
+${utils.COLORS.bold}Usage:${utils.COLORS.reset}
+  bootspring content <command> [options]
+
+${utils.COLORS.bold}Commands:${utils.COLORS.reset}
+  ${utils.COLORS.cyan}new${utils.COLORS.reset} <type>          Generate new content from template
+  ${utils.COLORS.cyan}types${utils.COLORS.reset}              List available content types
+  ${utils.COLORS.cyan}help${utils.COLORS.reset}               Show this help
+
+${utils.COLORS.bold}Content Types:${utils.COLORS.reset}
+  ${utils.COLORS.cyan}blog-post${utils.COLORS.reset}          Blog article template
+  ${utils.COLORS.cyan}release-notes${utils.COLORS.reset}      Version release notes
+  ${utils.COLORS.cyan}documentation${utils.COLORS.reset}      Documentation page (MDX)
+  ${utils.COLORS.cyan}changelog${utils.COLORS.reset}          Changelog entry
+  ${utils.COLORS.cyan}readme${utils.COLORS.reset}             README file
+  ${utils.COLORS.cyan}api-doc${utils.COLORS.reset}            API endpoint documentation
+  ${utils.COLORS.cyan}tutorial${utils.COLORS.reset}           Step-by-step tutorial
+
+${utils.COLORS.bold}Options:${utils.COLORS.reset}
+  ${utils.COLORS.cyan}--title, -t${utils.COLORS.reset}        Content title
+  ${utils.COLORS.cyan}--description, -d${utils.COLORS.reset}  Brief description
+  ${utils.COLORS.cyan}--author, -a${utils.COLORS.reset}       Author name
+  ${utils.COLORS.cyan}--tags${utils.COLORS.reset}             Comma-separated tags
+  ${utils.COLORS.cyan}--version, -v${utils.COLORS.reset}      Version number (for releases)
+  ${utils.COLORS.cyan}--output, -o${utils.COLORS.reset}       Output directory
+
+${utils.COLORS.bold}Examples:${utils.COLORS.reset}
+  ${utils.COLORS.dim}# Create a blog post${utils.COLORS.reset}
+  bootspring content new blog-post --title "Getting Started with Bootspring"
+
+  ${utils.COLORS.dim}# Generate release notes${utils.COLORS.reset}
+  bootspring content new release-notes --version 1.2.0
+
+  ${utils.COLORS.dim}# Create API documentation${utils.COLORS.reset}
+  bootspring content new api-doc --title "Create User"
+
+  ${utils.COLORS.dim}# Generate a tutorial${utils.COLORS.reset}
+  bootspring content new tutorial --title "Building Your First App"
+
+${utils.COLORS.bold}Workflow:${utils.COLORS.reset}
+  1. Generate content: ${utils.COLORS.cyan}bootspring content new blog-post --title "My Post"${utils.COLORS.reset}
+  2. Get writing help: ${utils.COLORS.cyan}bootspring agent invoke content-expert${utils.COLORS.reset}
+  3. Publish when ready
+`);
+}
+
+/**
+ * Run content command
+ */
+async function run(args) {
+  const subcommand = args[0] || 'help';
+  const subargs = args.slice(1);
+
+  switch (subcommand) {
+    case 'new':
+    case 'create':
+    case 'generate':
+    case 'gen':
+      if (!subargs[0]) {
+        utils.print.error('Please specify a content type');
+        utils.print.dim('Usage: bootspring content new <type> [options]');
+        utils.print.dim('Run "bootspring content types" to see available types');
+        return;
+      }
+      generateContent(subargs[0], subargs.slice(1));
+      break;
+
+    case 'types':
+    case 'list':
+    case 'ls':
+      listTypes();
+      break;
+
+    case 'help':
+    case '-h':
+    case '--help':
+      showHelp();
+      break;
+
+    default:
+      // Check if it's a content type shortcut
+      if (contentTemplate.getContentType(subcommand)) {
+        generateContent(subcommand, subargs);
+      } else {
+        utils.print.error(`Unknown subcommand: ${subcommand}`);
+        showHelp();
+      }
+  }
+}
+
+module.exports = { run, generateContent, listTypes };

package/cli/context.js

@@ -18,7 +18,7 @@
  * @command context
  */
 
-const fs = require('fs');
+const _fs = require('fs');
 const config = require('../core/config');
 const context = require('../core/context');
 const contextLoader = require('../core/context-loader');