@take-out/cli 0.0.39

package/src/commands/sync.ts

@@ -0,0 +1,305 @@
+/**
+ * Sync command - sync fork with upstream Takeout repository
+ */
+
+import { execSync, spawn, spawnSync } from 'node:child_process'
+import { existsSync, mkdtempSync, readFileSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { dirname, join, parse } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { defineCommand } from 'citty'
+import pc from 'picocolors'
+
+import {
+  confirmContinue,
+  promptSelect,
+  showError,
+  showInfo,
+  showStep,
+  showSuccess,
+} from '../utils/prompts'
+
+const UPSTREAM_REPO = 'tamagui/takeout3'
+const UPSTREAM_REMOTE = 'takeout-upstream'
+const TAKEOUT_FILE = '.takeout'
+
+function getSyncPrompt(): string {
+  try {
+    // find package root by looking for package.json
+    const currentDir = dirname(fileURLToPath(import.meta.url))
+    let packageRoot = currentDir
+
+    // go up directories until we find package.json with name @take-out/cli
+    while (packageRoot !== parse(packageRoot).root) {
+      const pkgPath = join(packageRoot, 'package.json')
+      if (existsSync(pkgPath)) {
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'))
+        if (pkg.name === '@take-out/cli') {
+          break
+        }
+      }
+      packageRoot = dirname(packageRoot)
+    }
+
+    const promptPath = join(packageRoot, 'docs', 'sync-prompt.md')
+    return readFileSync(promptPath, 'utf-8')
+  } catch (error) {
+    throw new Error(
+      `Could not load sync prompt: ${error instanceof Error ? error.message : 'Unknown error'}`
+    )
+  }
+}
+
+function checkToolAvailable(command: string): boolean {
+  try {
+    // use 'where' on windows, 'which' on unix
+    const checkCmd = process.platform === 'win32' ? 'where' : 'which'
+    const result = spawnSync(checkCmd, [command])
+    return result.status === 0
+  } catch {
+    return false
+  }
+}
+
+function ensureUpstreamRemote(): boolean {
+  try {
+    // check if remote exists
+    const remotes = execSync('git remote', { encoding: 'utf-8' })
+    if (!remotes.includes(UPSTREAM_REMOTE)) {
+      execSync(`git remote add ${UPSTREAM_REMOTE} git@github.com:${UPSTREAM_REPO}.git`, {
+        stdio: 'pipe',
+      })
+    }
+    execSync(`git fetch ${UPSTREAM_REMOTE} --quiet`, { stdio: 'pipe' })
+    return true
+  } catch {
+    return false
+  }
+}
+
+function getUpstreamHeadSha(): string | null {
+  try {
+    const sha = execSync(`git rev-parse ${UPSTREAM_REMOTE}/main`, { encoding: 'utf-8' })
+    return sha.trim()
+  } catch {
+    return null
+  }
+}
+
+function writeTakeoutConfig(sha: string): void {
+  const configPath = join(process.cwd(), TAKEOUT_FILE)
+  const date = new Date().toISOString().split('T')[0]
+  const content = `# takeout sync tracking file
+# this file tracks the last synced commit from upstream takeout
+sha=${sha}
+date=${date}
+`
+  writeFileSync(configPath, content)
+}
+
+export const syncCommand = defineCommand({
+  meta: {
+    name: 'sync',
+    description: 'Sync your fork with the latest Takeout repository',
+  },
+  async run() {
+    showStep('Takeout Repository Sync')
+    console.info()
+
+    showInfo('Takeout sync uses AI to intelligently merge upstream changes')
+    console.info()
+    console.info(pc.gray('How it works:'))
+    console.info(pc.gray('  • Analyzes commits from upstream Takeout repository'))
+    console.info(pc.gray('  • Determines which changes are relevant to your fork'))
+    console.info(pc.gray('  • Applies changes while preserving your customizations'))
+    console.info(pc.gray('  • Handles package ejection automatically'))
+    console.info(pc.gray('  • Asks for your input when decisions are needed'))
+    console.info()
+
+    // check what tools are available
+    const hasClaudeCode = checkToolAvailable('claude')
+    const hasCursor = checkToolAvailable('cursor-agent')
+    const hasAider = checkToolAvailable('aider')
+
+    const options: Array<{
+      value: string
+      label: string
+      hint: string
+    }> = []
+
+    if (hasClaudeCode) {
+      options.push({
+        value: 'claude-code',
+        label: 'Claude Code (recommended)',
+        hint: 'Run sync automatically with Claude Code CLI',
+      })
+    }
+
+    if (hasCursor) {
+      options.push({
+        value: 'cursor',
+        label: 'Cursor Agent',
+        hint: 'Run sync automatically with Cursor CLI',
+      })
+    }
+
+    if (hasAider) {
+      options.push({
+        value: 'aider',
+        label: 'Aider',
+        hint: 'Run sync automatically with Aider CLI',
+      })
+    }
+
+    options.push({
+      value: 'show-prompt',
+      label: 'Show prompt (copy & paste manually)',
+      hint: 'Display the full prompt to use with any LLM',
+    })
+
+    const choice = await promptSelect<string>('How would you like to sync?', options)
+
+    if (choice === 'cancel') {
+      console.info()
+      showInfo('Sync cancelled')
+      return
+    }
+
+    console.info()
+
+    // fetch upstream to get the target SHA before syncing
+    console.info(pc.dim('Fetching upstream repository...'))
+    if (!ensureUpstreamRemote()) {
+      showError('Failed to fetch upstream repository')
+      return
+    }
+
+    const upstreamSha = getUpstreamHeadSha()
+    if (!upstreamSha) {
+      showError('Failed to get upstream HEAD SHA')
+      return
+    }
+    console.info(pc.dim(`Target SHA: ${upstreamSha.slice(0, 7)}`))
+    console.info()
+
+    try {
+      const prompt = getSyncPrompt()
+
+      if (choice === 'show-prompt') {
+        console.info(pc.dim('='.repeat(80)))
+        console.info(prompt)
+        console.info(pc.dim('='.repeat(80)))
+        console.info()
+        showInfo('Copy the prompt above and paste it into your preferred LLM')
+        console.info()
+        console.info(pc.gray('Recommended LLMs:'))
+        console.info(pc.gray('  • Claude Code (best for complex instructions)'))
+        console.info(pc.gray('  • ChatGPT'))
+        console.info(pc.gray('  • Cursor'))
+        console.info(pc.gray('  • Aider'))
+        console.info()
+      } else if (choice === 'claude-code') {
+        showInfo('Starting Claude Code with sync prompt...')
+        console.info()
+        console.info(
+          pc.dim(
+            'Note: Claude Code will run in headless mode and make changes automatically.'
+          )
+        )
+        console.info(pc.dim('You will be asked to confirm important decisions.'))
+        console.info()
+
+        const shouldContinue = await confirmContinue('Continue with Claude Code?', true)
+        if (!shouldContinue) {
+          showInfo('Sync cancelled')
+          return
+        }
+
+        // write prompt to temp file to avoid shell escaping issues
+        const tempDir = mkdtempSync(join(tmpdir(), 'takeout-sync-'))
+        const promptFile = join(tempDir, 'prompt.md')
+        writeFileSync(promptFile, prompt)
+
+        // run claude with prompt from stdin
+        const claude = spawn('claude', ['-p', '-'], {
+          stdio: ['pipe', 'inherit', 'inherit'],
+        })
+
+        claude.stdin?.write(prompt)
+        claude.stdin?.end()
+
+        claude.on('close', (code) => {
+          console.info()
+          if (code === 0) {
+            writeTakeoutConfig(upstreamSha)
+            showSuccess('Sync completed successfully!')
+            console.info(pc.dim(`Updated .takeout to ${upstreamSha.slice(0, 7)}`))
+          } else {
+            showError(`Claude Code exited with code ${code}`)
+          }
+        })
+      } else if (choice === 'cursor') {
+        showInfo('Starting Cursor Agent with sync prompt...')
+        console.info()
+
+        const shouldContinue = await confirmContinue('Continue with Cursor?', true)
+        if (!shouldContinue) {
+          showInfo('Sync cancelled')
+          return
+        }
+
+        // run cursor agent with prompt from stdin
+        const cursor = spawn('cursor-agent', ['-p', '-'], {
+          stdio: ['pipe', 'inherit', 'inherit'],
+        })
+
+        cursor.stdin?.write(prompt)
+        cursor.stdin?.end()
+
+        cursor.on('close', (code) => {
+          console.info()
+          if (code === 0) {
+            writeTakeoutConfig(upstreamSha)
+            showSuccess('Sync completed successfully!')
+            console.info(pc.dim(`Updated .takeout to ${upstreamSha.slice(0, 7)}`))
+          } else {
+            showError(`Cursor Agent exited with code ${code}`)
+          }
+        })
+      } else if (choice === 'aider') {
+        showInfo('Starting Aider with sync prompt...')
+        console.info()
+
+        const shouldContinue = await confirmContinue('Continue with Aider?', true)
+        if (!shouldContinue) {
+          showInfo('Sync cancelled')
+          return
+        }
+
+        // write prompt to temp file for aider
+        const tempDir = mkdtempSync(join(tmpdir(), 'takeout-sync-'))
+        const promptFile = join(tempDir, 'prompt.md')
+        writeFileSync(promptFile, prompt)
+
+        // run aider with message from file
+        const aider = spawn('aider', ['--message-file', promptFile, '--no-stream'], {
+          stdio: 'inherit',
+        })
+
+        aider.on('close', (code) => {
+          console.info()
+          if (code === 0) {
+            writeTakeoutConfig(upstreamSha)
+            showSuccess('Sync completed successfully!')
+            console.info(pc.dim(`Updated .takeout to ${upstreamSha.slice(0, 7)}`))
+          } else {
+            showError(`Aider exited with code ${code}`)
+          }
+        })
+      }
+    } catch (error) {
+      showError(error instanceof Error ? error.message : 'Unknown error')
+    }
+  },
+})

package/src/constants/ascii.ts

@@ -0,0 +1,17 @@
+/**
+ * ASCII art constants for Takeout branding
+ */
+
+// TAKEOUT in block letters with chinese accent line
+// chinese chars: 麵(noodles) 碼(code) 飯(rice)
+export const TAKEOUT_ASCII = `
+████████╗ █████╗ ██╗  ██╗███████╗ ██████╗ ██╗   ██╗████████╗
+╚══██╔══╝██╔══██╗██║ ██╔╝██╔════╝██╔═══██╗██║   ██║╚══██╔══╝
+   ██║   ███████║█████╔╝ █████╗  ██║   ██║██║   ██║   ██║
+   ██║   ██╔══██║██╔═██╗ ██╔══╝  ██║   ██║██║   ██║   ██║
+   ██║   ██║  ██║██║  ██╗███████╗╚██████╔╝╚██████╔╝   ██║
+   ╚═╝   ╚═╝  ╚═╝╚═╝  ╚═╝╚══════╝ ╚═════╝  ╚═════╝    ╚═╝
+                        麵 碼 飯
+`.trim()
+
+export const WELCOME_BANNER = TAKEOUT_ASCII

package/src/index.ts

@@ -0,0 +1,63 @@
+/**
+ * Takeout CLI - Library exports
+ *
+ * Use these utilities programmatically in your own scripts
+ */
+
+// Types
+export type * from './types'
+
+// Prerequisites checking
+export {
+  checkAllPrerequisites,
+  checkBun,
+  checkDocker,
+  checkGit,
+  checkNode,
+  hasRequiredPrerequisites,
+} from './utils/prerequisites'
+
+// Port management
+export {
+  checkAllPorts,
+  checkPort,
+  getConflictingPorts,
+  hasPortConflicts,
+  TAKEOUT_PORTS,
+} from './utils/ports'
+
+// Environment file operations
+export {
+  copyEnvFile,
+  createEnvLocal,
+  envFileExists,
+  generateSecret,
+  readEnvVariable,
+  updateEnvVariable,
+} from './utils/env'
+
+// File operations
+export {
+  checkOnboarded,
+  markOnboarded,
+  updateAppConfig,
+  updatePackageJson,
+} from './utils/files'
+
+// Prompts (for building custom CLIs)
+export {
+  confirmContinue,
+  displayOutro,
+  displayPortConflicts,
+  displayPrerequisites,
+  displayWelcome,
+  promptPassword,
+  promptSelect,
+  promptText,
+  showError,
+  showInfo,
+  showSpinner,
+  showStep,
+  showSuccess,
+  showWarning,
+} from './utils/prompts'

package/src/types.ts

@@ -0,0 +1,59 @@
+export interface PrerequisiteCheck {
+  name: string
+  required: boolean
+  installed: boolean
+  version?: string
+  requiredVersion?: string
+  message?: string
+  installUrl?: string
+  recommendation?: string
+}
+
+export interface PortCheck {
+  port: number
+  name: string
+  inUse: boolean
+  pid?: number
+}
+
+export interface ProjectIdentity {
+  name: string
+  bundleId: string
+  domain: string
+}
+
+export interface OnboardingConfig {
+  skipPrerequisites?: boolean
+  skipServices?: boolean
+  skipMigrations?: boolean
+  autoStart?: boolean
+}
+
+export interface EnvironmentSetup {
+  authSecret: string
+  githubClientId?: string
+  githubClientSecret?: string
+  domain: string
+  serverUrl: string
+}
+
+export interface EnvVariable {
+  key: string
+  label: string
+  description: string
+  instructions: string
+  required: boolean
+  type: 'text' | 'secret' | 'multiline'
+  default?: string
+  placeholder?: string
+  generator?: () => string
+}
+
+export interface EnvCategory {
+  id: string
+  name: string
+  description: string
+  required: boolean
+  setupTime?: string
+  variables: EnvVariable[]
+}

package/src/utils/env-categories.ts

@@ -0,0 +1,245 @@
+import pc from 'picocolors'
+
+import type { EnvVariable, EnvCategory } from '../types'
+
+export const envCategories: EnvCategory[] = [
+  {
+    id: 'core',
+    name: 'Core Configuration',
+    description: 'Essential configuration for your production deployment',
+    required: true,
+    variables: [
+      {
+        key: 'BETTER_AUTH_SECRET',
+        label: 'Authentication Secret',
+        description: 'Secret key for session encryption and JWT signing',
+        instructions: `Generate a secure random key:\n${pc.cyan('openssl rand -hex 32')}`,
+        required: true,
+        type: 'secret',
+        generator: () => {
+          const crypto = require('node:crypto')
+          return crypto.randomBytes(32).toString('hex')
+        },
+      },
+      {
+        key: 'BETTER_AUTH_URL',
+        label: 'Authentication URL',
+        description: 'The public URL where your app will be hosted',
+        instructions: 'Enter your production domain (e.g., https://your-app.com)',
+        required: true,
+        type: 'text',
+        placeholder: 'https://your-app.com',
+      },
+      {
+        key: 'ONE_SERVER_URL',
+        label: 'Server URL',
+        description: 'The URL for your main server',
+        instructions: 'Usually the same as your authentication URL',
+        required: true,
+        type: 'text',
+        placeholder: 'https://your-app.com',
+      },
+      {
+        key: 'VITE_PUBLIC_ZERO_SERVER',
+        label: 'Zero Sync Server URL',
+        description: 'WebSocket server for real-time sync',
+        instructions: 'Typically a subdomain like https://zero.your-app.com',
+        required: true,
+        type: 'text',
+        placeholder: 'https://zero.your-app.com',
+      },
+    ],
+  },
+  {
+    id: 'database',
+    name: 'Database (PostgreSQL)',
+    description:
+      'Production database configuration - set by deployment platform (SST/uncloud)',
+    required: false,
+    variables: [
+      // Note: ZERO_UPSTREAM_DB, ZERO_CVR_DB, and ZERO_CHANGE_DB are set dynamically
+      // by the deployment platform (SST or uncloud) and should NOT be configured here
+    ],
+  },
+  {
+    id: 'storage',
+    name: 'File Storage (S3/R2)',
+    description: 'Object storage for user uploads and media files',
+    required: false,
+    variables: [
+      {
+        key: 'CLOUDFLARE_R2_ENDPOINT',
+        label: 'Storage Endpoint',
+        description: 'S3-compatible storage endpoint',
+        instructions: `Options:\n${pc.cyan('Cloudflare R2')}: https://[account-id].r2.cloudflarestorage.com\n${pc.cyan('AWS S3')}: https://s3.[region].amazonaws.com\n${pc.cyan('DigitalOcean Spaces')}: https://[region].digitaloceanspaces.com`,
+        required: false,
+        type: 'text',
+        placeholder: 'https://account-id.r2.cloudflarestorage.com',
+      },
+      {
+        key: 'CLOUDFLARE_R2_ACCESS_KEY',
+        label: 'Storage Access Key',
+        description: 'Access key ID for your storage service',
+        instructions: 'Get this from your storage provider dashboard',
+        required: false,
+        type: 'text',
+      },
+      {
+        key: 'CLOUDFLARE_R2_SECRET_KEY',
+        label: 'Storage Secret Key',
+        description: 'Secret access key for your storage service',
+        instructions: 'Keep this secure - it provides full access to your storage',
+        required: false,
+        type: 'secret',
+      },
+      {
+        key: 'CLOUDFLARE_R2_PUBLIC_URL',
+        label: 'Public Storage URL',
+        description: 'Public URL for serving stored files',
+        instructions: 'Usually a CDN URL or custom domain pointing to your bucket',
+        required: false,
+        type: 'text',
+        placeholder: 'https://cdn.your-app.com',
+      },
+    ],
+  },
+  {
+    id: 'apple',
+    name: 'Apple App Store',
+    description: 'Configuration for iOS app and push notifications',
+    required: false,
+    variables: [
+      {
+        key: 'APNS_TEAM_ID',
+        label: 'Apple Team ID',
+        description: 'Your Apple Developer Team ID',
+        instructions: `Find in Apple Developer Portal:\n1. Go to ${pc.cyan('https://developer.apple.com/account')}\n2. Look for "Team ID" in Membership Details`,
+        required: false,
+        type: 'text',
+        placeholder: 'XXXXXXXXXX',
+      },
+      {
+        key: 'APNS_KEY_ID',
+        label: 'APNs Key ID',
+        description: 'Push notification authentication key ID',
+        instructions: `Create in Apple Developer Portal:\n1. Go to Certificates, Identifiers & Profiles\n2. Keys → Create a Key\n3. Check "Apple Push Notifications service (APNs)"\n4. Download the .p8 file and note the Key ID`,
+        required: false,
+        type: 'text',
+        placeholder: 'XXXXXXXXXX',
+      },
+      {
+        key: 'APNS_KEY',
+        label: 'APNs Key Content',
+        description: 'Contents of your APNs .p8 key file',
+        instructions: 'Paste the entire contents of the .p8 file you downloaded',
+        required: false,
+        type: 'multiline',
+      },
+      {
+        key: 'APNS_ENDPOINT',
+        label: 'APNs Endpoint',
+        description: 'Apple Push Notification service endpoint',
+        instructions: `Production: ${pc.green('https://api.push.apple.com')}\nSandbox: ${pc.yellow('https://api.sandbox.push.apple.com')}`,
+        required: false,
+        type: 'text',
+        default: 'https://api.push.apple.com',
+      },
+    ],
+  },
+  {
+    id: 'email',
+    name: 'Email Service',
+    description: 'Transactional email configuration',
+    required: false,
+    variables: [
+      {
+        key: 'POSTMARK_SERVER_TOKEN',
+        label: 'Postmark Server Token',
+        description: 'API token for sending emails via Postmark',
+        instructions: `Get your token:\n1. Sign up at ${pc.cyan('https://postmarkapp.com')}\n2. Create a Server\n3. Go to Servers → API Tokens\n4. Copy your Server API Token\n\n${pc.yellow('Note: Free tier includes 100 emails/month')}`,
+        required: false,
+        type: 'text',
+      },
+    ],
+  },
+  {
+    id: 'github',
+    name: 'GitHub OAuth',
+    description: 'Enable GitHub sign-in for your app',
+    required: false,
+    variables: [
+      {
+        key: 'ONECHAT_GITHUB_CLIENT_ID',
+        label: 'GitHub OAuth Client ID',
+        description: 'Client ID for GitHub OAuth application',
+        instructions: `Create GitHub OAuth App:\n1. Go to ${pc.cyan('https://github.com/settings/developers')}\n2. New OAuth App\n3. Set Authorization callback URL:\n   ${pc.green('https://your-app.com/api/auth/callback/github')}\n4. Copy the Client ID`,
+        required: false,
+        type: 'text',
+      },
+      {
+        key: 'ONECHAT_GITHUB_CLIENT_SECRET',
+        label: 'GitHub OAuth Client Secret',
+        description: 'Client secret for GitHub OAuth application',
+        instructions: 'Copy the Client Secret from your GitHub OAuth App settings',
+        required: false,
+        type: 'secret',
+      },
+    ],
+  },
+  {
+    id: 'aws',
+    name: 'AWS Deployment',
+    description: 'AWS credentials for SST deployment',
+    required: false,
+    setupTime: '~30 minutes',
+    variables: [
+      {
+        key: 'AWS_ACCESS_KEY_ID',
+        label: 'AWS Access Key ID',
+        description: 'Access key for AWS deployment',
+        instructions: `${pc.yellow('⚠️  Setting up AWS takes about 30 minutes')}\n\nFollow the SST guide for AWS setup:\n${pc.cyan('https://sst.dev/docs/aws-accounts/')}\n\nQuick steps:\n1. Create AWS account or use existing\n2. Create IAM user with AdministratorAccess\n3. Generate access keys\n4. Copy Access Key ID`,
+        required: false,
+        type: 'text',
+      },
+      {
+        key: 'AWS_SECRET_ACCESS_KEY',
+        label: 'AWS Secret Access Key',
+        description: 'Secret key for AWS deployment',
+        instructions: 'Copy the Secret Access Key from IAM user creation',
+        required: false,
+        type: 'secret',
+      },
+      {
+        key: 'AWS_REGION',
+        label: 'AWS Region',
+        description: 'AWS region for deployment',
+        instructions:
+          'Choose a region close to your users (e.g., us-west-1, us-east-1, eu-west-1)',
+        required: false,
+        type: 'text',
+        default: 'us-west-1',
+        placeholder: 'us-west-1',
+      },
+    ],
+  },
+]
+
+export function getCategoryById(id: string): EnvCategory | undefined {
+  return envCategories.find((cat) => cat.id === id)
+}
+
+export function getRequiredCategories(): EnvCategory[] {
+  return envCategories.filter((cat) => cat.required)
+}
+
+export function getOptionalCategories(): EnvCategory[] {
+  return envCategories.filter((cat) => !cat.required)
+}
+
+export function getAllVariables(): EnvVariable[] {
+  return envCategories.flatMap((cat) => cat.variables)
+}
+
+export function getVariableByKey(key: string): EnvVariable | undefined {
+  return getAllVariables().find((v) => v.key === key)
+}