@gokiteam/goki-dev 0.2.0

package/bin/goki-dev.js

@@ -0,0 +1,452 @@
+#!/usr/bin/env node
+import { Command } from 'commander'
+import { ProjectCLI } from '../cli/ProjectCLI.js'
+import { NgrokManager } from '../cli/NgrokManager.js'
+import { Logger } from '../cli/Logger.js'
+import { offerConfigGeneration } from '../cli/ConfigGenerator.js'
+import { configExists, loadConfig as loadDevToolsConfig } from '../cli/DevToolsDir.js'
+
+async function loadConfig () {
+  const projectDir = process.cwd()
+  if (configExists(projectDir)) {
+    const config = await loadDevToolsConfig(projectDir)
+    if (config) return config
+  }
+  // Config not found — offer to generate
+  const generated = await offerConfigGeneration()
+  if (generated) {
+    const config = await loadDevToolsConfig(projectDir)
+    if (config) return config
+  }
+  Logger.error('No .dev-tools/config.js found in current directory')
+  console.log('\nExpected structure:')
+  console.log('  .dev-tools/config.js - Project configuration')
+  console.log('\nRun "goki-dev start" to auto-generate configuration')
+  process.exit(1)
+}
+
+const program = new Command()
+
+program
+  .name('goki-dev')
+  .description('Goki microservices development CLI')
+  .version('1.0.0')
+
+// Default action when no command provided - show interactive menu
+program
+  .action(async () => {
+    const config = await loadConfig()
+    const cli = new ProjectCLI(config)
+    await cli.menu()
+  })
+
+program
+  .command('menu')
+  .description('Show interactive menu')
+  .action(async () => {
+    const config = await loadConfig()
+    const cli = new ProjectCLI(config)
+    await cli.menu()
+  })
+
+program
+  .command('start')
+  .description('Start application')
+  .action(async () => {
+    const config = await loadConfig()
+    const cli = new ProjectCLI(config)
+    await cli.start()
+  })
+
+program
+  .command('stop')
+  .description('Stop application')
+  .action(async () => {
+    const config = await loadConfig()
+    const cli = new ProjectCLI(config)
+    await cli.stop()
+  })
+
+program
+  .command('status')
+  .description('Show service status')
+  .action(async () => {
+    const config = await loadConfig()
+    const cli = new ProjectCLI(config)
+    await cli.status()
+  })
+
+program
+  .command('logs')
+  .option('-f, --follow', 'Follow log output')
+  .description('View application logs')
+  .action(async (options) => {
+    const config = await loadConfig()
+    const cli = new ProjectCLI(config)
+    await cli.logs(options)
+  })
+
+program
+  .command('setup')
+  .description('Complete local setup (Docker, dev-tools, DB, Pub/Sub, app)')
+  .action(async () => {
+    const config = await loadConfig()
+    const cli = new ProjectCLI(config)
+    await cli.setup()
+  })
+
+program
+  .command('shutdown')
+  .description('Stop services with options')
+  .option('--app', 'Stop app only')
+  .option('--all', 'Stop app + dev-tools')
+  .option('--reset', 'Clear database data')
+  .option('--destroy', 'Full cleanup (stop all + drop database)')
+  .action(async (options) => {
+    const config = await loadConfig()
+    const cli = new ProjectCLI(config)
+    await cli.shutdown(options)
+  })
+
+const db = program.command('db').description('Database management')
+
+db.command('init')
+  .description('Initialize database schema')
+  .action(async () => {
+    const config = await loadConfig()
+    const cli = new ProjectCLI(config)
+    await cli.dbInit()
+  })
+
+db.command('reset')
+  .description('Drop and recreate database (DESTRUCTIVE)')
+  .action(async () => {
+    const config = await loadConfig()
+    const cli = new ProjectCLI(config)
+    await cli.dbReset()
+  })
+
+db.command('clear')
+  .description('Clear all data, keep schema')
+  .action(async () => {
+    const config = await loadConfig()
+    const cli = new ProjectCLI(config)
+    await cli.dbClear()
+  })
+
+const pubsub = program.command('pubsub').description('Pub/Sub management')
+
+pubsub.command('init')
+  .description('Initialize Pub/Sub topics and subscriptions')
+  .action(async () => {
+    const config = await loadConfig()
+    const cli = new ProjectCLI(config)
+    await cli.pubsubInit()
+  })
+
+const ngrok = program.command('ngrok').description('ngrok tunnel management')
+
+ngrok.command('status')
+  .description('Show ngrok tunnel status')
+  .action(async () => {
+    const status = await NgrokManager.getStatus()
+    if (status.running) {
+      console.log('\n  ngrok tunnel is running')
+      console.log(`    URL:     ${status.url}`)
+      if (status.domain) console.log(`    Domain:  ${status.domain}`)
+      if (status.pid) console.log(`    PID:     ${status.pid}`)
+      if (status.port) console.log(`    Port:    ${status.port}`)
+      if (status.uptime) console.log(`    Uptime:  ${status.uptime}`)
+      if (status.startedBy) console.log(`    Started: by ${status.startedBy}`)
+      console.log('')
+    } else {
+      console.log('\n  ngrok tunnel is not running\n')
+    }
+  })
+
+ngrok.command('stop')
+  .description('Stop ngrok tunnel')
+  .action(async () => {
+    const result = await NgrokManager.stop()
+    if (result.stopped) {
+      const pidInfo = result.pid ? ` (PID: ${result.pid})` : ''
+      console.log(`\n  ngrok tunnel stopped${pidInfo}\n`)
+    } else {
+      console.log('\n  ngrok tunnel is not running\n')
+    }
+  })
+
+ngrok.command('restart')
+  .description('Restart ngrok tunnel with saved domain')
+  .action(async () => {
+    const state = NgrokManager.readState()
+    const domain = state?.domain || await NgrokManager.loadDomain()
+    if (!domain) {
+      Logger.error('No saved ngrok domain found. Run "goki-dev start" first or set domain via prompt.')
+      process.exit(1)
+    }
+    const port = state?.port || 9000
+    console.log(`\n  Restarting ngrok tunnel (${domain})...`)
+    await NgrokManager.stop()
+    try {
+      const { url, pid } = await NgrokManager.start(domain, port)
+      console.log(`  ngrok tunnel started (PID: ${pid})`)
+      console.log(`    URL: ${url}\n`)
+    } catch (error) {
+      Logger.error(`Failed to start ngrok: ${error.message}`)
+      process.exit(1)
+    }
+  })
+
+const e2e = program.command('e2e').description('End-to-end testing with snapshot/restore')
+
+e2e.command('run')
+  .description('Run e2e tests (auto snapshot/restore)')
+  .option('--keep-snapshot', 'Keep snapshot after tests (for debugging)')
+  .action(async (options) => {
+    const config = await loadConfig()
+    const cli = new ProjectCLI(config)
+    await cli.e2eRun(options)
+  })
+
+e2e.command('snapshot')
+  .description('Create a snapshot of current development state')
+  .action(async () => {
+    const config = await loadConfig()
+    const cli = new ProjectCLI(config)
+    await cli.e2eSnapshot()
+  })
+
+e2e.command('restore <snapshot-id>')
+  .description('Restore development environment from snapshot')
+  .action(async (snapshotId) => {
+    const config = await loadConfig()
+    const cli = new ProjectCLI(config)
+    await cli.e2eRestore(snapshotId)
+  })
+
+e2e.command('list')
+  .description('List available snapshots')
+  .action(async () => {
+    const config = await loadConfig()
+    const cli = new ProjectCLI(config)
+    await cli.e2eList()
+  })
+
+e2e.command('cleanup [snapshot-id]')
+  .description('Delete snapshot files (or all if no ID specified)')
+  .action(async (snapshotId) => {
+    const config = await loadConfig()
+    const cli = new ProjectCLI(config)
+    await cli.e2eCleanup(snapshotId)
+  })
+
+// --- Secrets ---
+
+const secrets = program.command('secrets').description('Credential management')
+
+secrets.command('set <key> [value]')
+  .description('Set a secret (value prompted if omitted)')
+  .option('--global', 'Force global scope')
+  .option('--description <desc>', 'Optional metadata description')
+  .action(async (key, value, options) => {
+    const { SecretsManager } = await import('../cli/secrets/SecretsManager.js')
+    const chalk = (await import('chalk')).default
+    try {
+      if (!value) {
+        const inquirer = (await import('inquirer')).default
+        const answers = await inquirer.prompt([{
+          type: 'password',
+          name: 'value',
+          message: `Enter value for ${key}:`,
+          mask: '\u25CF'
+        }])
+        value = answers.value
+      }
+      const manager = await SecretsManager.create({ projectDir: process.cwd() })
+      if (manager.projectName) Logger.info(`project detected: ${manager.projectName}`)
+      await manager.unlock()
+      const scope = options.global ? 'global' : undefined
+      await manager.set(key, value, { scope, description: options.description })
+      const label = options.global ? 'global' : (manager.projectName ? `project: ${manager.projectName}` : 'global')
+      Logger.success(`set ${key} (${label})`)
+    } catch (error) {
+      Logger.error(error.message)
+      process.exit(1)
+    }
+  })
+
+secrets.command('get <key>')
+  .description('Print secret value to stdout')
+  .option('--global', 'Force global scope')
+  .action(async (key, options) => {
+    const { SecretsManager } = await import('../cli/secrets/SecretsManager.js')
+    const chalk = (await import('chalk')).default
+    try {
+      const manager = await SecretsManager.create({ projectDir: process.cwd() })
+      await manager.unlock()
+      let value
+      if (options.global) {
+        value = manager.getGlobalSecrets()[key]
+      } else {
+        value = manager.get(key)
+      }
+      if (value === undefined) {
+        Logger.error(`secret not found: ${key}`)
+        process.exit(1)
+      }
+      process.stdout.write(value)
+    } catch (error) {
+      Logger.error(error.message)
+      process.exit(1)
+    }
+  })
+
+secrets.command('delete <key>')
+  .description('Remove secret from keychain and index')
+  .option('--global', 'Force global scope')
+  .action(async (key, options) => {
+    const { SecretsManager } = await import('../cli/secrets/SecretsManager.js')
+    try {
+      const manager = await SecretsManager.create({ projectDir: process.cwd() })
+      if (manager.projectName) Logger.info(`project detected: ${manager.projectName}`)
+      await manager.unlock()
+      await manager.delete(key, { scope: options.global ? 'global' : undefined })
+      Logger.success(`deleted ${key}`)
+    } catch (error) {
+      Logger.error(error.message)
+      process.exit(1)
+    }
+  })
+
+secrets.command('list')
+  .description('List keys and metadata (never values)')
+  .option('--format <format>', 'Output format: table or json', 'table')
+  .action(async (options) => {
+    const { SecretsManager } = await import('../cli/secrets/SecretsManager.js')
+    const chalk = (await import('chalk')).default
+    try {
+      const manager = await SecretsManager.create({ projectDir: process.cwd() })
+      if (manager.projectName) Logger.info(`project detected: ${manager.projectName}`)
+      const entries = manager.list()
+      if (options.format === 'json') {
+        console.log(JSON.stringify(entries, null, 2))
+        return
+      }
+      if (entries.length === 0) {
+        console.log(chalk.dim('  No secrets found'))
+        return
+      }
+      const globalEntries = entries.filter(e => e.scope === 'global')
+      const projectEntries = entries.filter(e => e.scope === 'project')
+      if (globalEntries.length > 0) {
+        console.log(chalk.bold('\n  Global'))
+        for (const e of globalEntries) {
+          console.log(`  ${e.key.padEnd(30)} ${(e.description || '-').padEnd(30)}`)
+        }
+      }
+      if (projectEntries.length > 0) {
+        console.log(chalk.bold(`\n  Project: ${projectEntries[0].project || manager.projectName}`))
+        for (const e of projectEntries) {
+          console.log(`  ${e.key.padEnd(30)} ${(e.description || '-').padEnd(30)}`)
+        }
+      }
+      console.log()
+    } catch (error) {
+      Logger.error(error.message)
+      process.exit(1)
+    }
+  })
+
+secrets.command('setup')
+  .description('Interactive: prompt for missing secrets')
+  .action(async () => {
+    const { SecretsManager } = await import('../cli/secrets/SecretsManager.js')
+    const { SecretsConfig } = await import('../cli/secrets/SecretsConfig.js')
+    try {
+      const manager = await SecretsManager.create({ projectDir: process.cwd() })
+      await manager.unlock()
+      const config = new SecretsConfig(manager)
+      await config.setup()
+    } catch (error) {
+      Logger.error(error.message)
+      process.exit(1)
+    }
+  })
+
+secrets.command('check')
+  .description('Non-interactive: verify required secrets exist')
+  .action(async () => {
+    const { SecretsManager } = await import('../cli/secrets/SecretsManager.js')
+    const { SecretsConfig } = await import('../cli/secrets/SecretsConfig.js')
+    try {
+      const manager = await SecretsManager.create({ projectDir: process.cwd() })
+      await manager.unlock()
+      const config = new SecretsConfig(manager)
+      const ok = await config.check()
+      if (!ok) process.exit(1)
+    } catch (error) {
+      Logger.error(error.message)
+      process.exit(1)
+    }
+  })
+
+secrets.command('doctor')
+  .description('Scan for plaintext credentials')
+  .option('--fix', 'Interactively migrate plaintext credentials to keychain')
+  .action(async (options) => {
+    const { SecretsDoctor } = await import('../cli/secrets/SecretsDoctor.js')
+    try {
+      const doctor = new SecretsDoctor(process.cwd())
+      const findings = await doctor.scan()
+      if (!options.fix) {
+        doctor.report(findings)
+        if (findings.length > 0) process.exit(1)
+        return
+      }
+      doctor.report(findings)
+      if (findings.length === 0) return
+      const { SecretsManager } = await import('../cli/secrets/SecretsManager.js')
+      const manager = await SecretsManager.create({ projectDir: process.cwd() })
+      await manager.unlock()
+      await doctor.interactiveFix(findings, manager)
+    } catch (error) {
+      Logger.error(error.message)
+      process.exit(1)
+    }
+  })
+
+secrets.command('config [setting] [value]')
+  .description('Show or update preferences')
+  .action(async (setting, value) => {
+    const { BiometricAuth } = await import('../cli/secrets/BiometricAuth.js')
+    const chalk = (await import('chalk')).default
+    try {
+      if (!setting) {
+        const prefs = BiometricAuth.loadPreferences()
+        console.log(chalk.bold('\n  Preferences'))
+        console.log(`  biometric:  ${prefs.biometric !== false ? chalk.green('on') : chalk.red('off')}`)
+        console.log(`  passphrase: ${prefs.passphraseHash ? chalk.green('set') : chalk.dim('not set')}`)
+        console.log()
+        return
+      }
+      if (setting === 'biometric') {
+        if (value !== 'on' && value !== 'off') {
+          Logger.error('usage: goki-dev secrets config biometric on|off')
+          process.exit(1)
+        }
+        const prefs = BiometricAuth.loadPreferences()
+        prefs.biometric = value === 'on'
+        BiometricAuth.savePreferences(prefs)
+        Logger.success(`biometric ${value}`)
+        return
+      }
+      Logger.error(`unknown setting: ${setting}`)
+      process.exit(1)
+    } catch (error) {
+      Logger.error(error.message)
+      process.exit(1)
+    }
+  })
+
+program.parse()

package/bin/mcp-server.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+
+// MCP server entry point for Claude Code / Claude Desktop integration.
+// Spawned as a subprocess using stdio transport.
+//
+// IMPORTANT: Never use console.log() in this process — stdout is reserved
+// for JSON-RPC protocol messages. Use console.error() for diagnostics.
+
+import { startMcpServer } from '../src/mcp/Server.js'
+
+const DEV_TOOLS_URL = process.env.DEV_TOOLS_URL || 'http://localhost:9000'
+
+startMcpServer({ devToolsUrl: DEV_TOOLS_URL }).catch(error => {
+  console.error('Fatal: MCP server failed to start', error)
+  process.exit(1)
+})