spindb 0.9.1 → 0.9.3

package/README.md

@@ -653,16 +653,13 @@ rm -rf ~/.spindb
 
 ## Contributing
 
-See [CLAUDE.md](CLAUDE.md) for development setup and architecture documentation.
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, testing, and distribution info.
 
-### Running Tests
+See [ARCHITECTURE.md](ARCHITECTURE.md) for project architecture and comprehensive CLI command examples.
 
-```bash
-pnpm test           # All tests
-pnpm test:unit      # Unit tests only
-pnpm test:pg        # PostgreSQL integration
-pnpm test:mysql     # MySQL integration
-```
+See [CLAUDE.md](CLAUDE.md) for AI-assisted development context.
+
+See [ENGINES.md](ENGINES.md) for detailed engine documentation (backup formats, planned engines, etc.).
 
 ---
 

package/cli/commands/attach.ts

@@ -0,0 +1,108 @@
+import { Command } from 'commander'
+import { existsSync } from 'fs'
+import { resolve, basename } from 'path'
+import chalk from 'chalk'
+import { sqliteRegistry } from '../../engines/sqlite/registry'
+import { containerManager } from '../../core/container-manager'
+import { deriveContainerName } from '../../engines/sqlite/scanner'
+import { uiSuccess, uiError } from '../ui/theme'
+
+export const attachCommand = new Command('attach')
+  .description('Register an existing SQLite database with SpinDB')
+  .argument('<path>', 'Path to SQLite database file')
+  .option('-n, --name <name>', 'Container name (defaults to filename)')
+  .option('--json', 'Output as JSON')
+  .action(
+    async (
+      path: string,
+      options: { name?: string; json?: boolean },
+    ): Promise<void> => {
+      try {
+        const absolutePath = resolve(path)
+
+        // Verify file exists
+        if (!existsSync(absolutePath)) {
+          if (options.json) {
+            console.log(
+              JSON.stringify({ success: false, error: 'File not found' }),
+            )
+          } else {
+            console.error(uiError(`File not found: ${absolutePath}`))
+          }
+          process.exit(1)
+        }
+
+        // Check if already registered
+        if (await sqliteRegistry.isPathRegistered(absolutePath)) {
+          const entry = await sqliteRegistry.getByPath(absolutePath)
+          if (options.json) {
+            console.log(
+              JSON.stringify({
+                success: false,
+                error: 'Already registered',
+                existingName: entry?.name,
+              }),
+            )
+          } else {
+            console.error(
+              uiError(`File is already registered as "${entry?.name}"`),
+            )
+          }
+          process.exit(1)
+        }
+
+        // Determine container name
+        const containerName =
+          options.name || deriveContainerName(basename(absolutePath))
+
+        // Check if container name exists
+        if (await containerManager.exists(containerName)) {
+          if (options.json) {
+            console.log(
+              JSON.stringify({
+                success: false,
+                error: 'Container name already exists',
+              }),
+            )
+          } else {
+            console.error(uiError(`Container "${containerName}" already exists`))
+          }
+          process.exit(1)
+        }
+
+        // Register the file
+        await sqliteRegistry.add({
+          name: containerName,
+          filePath: absolutePath,
+          created: new Date().toISOString(),
+        })
+
+        if (options.json) {
+          console.log(
+            JSON.stringify({
+              success: true,
+              name: containerName,
+              filePath: absolutePath,
+            }),
+          )
+        } else {
+          console.log(
+            uiSuccess(
+              `Registered "${basename(absolutePath)}" as "${containerName}"`,
+            ),
+          )
+          console.log()
+          console.log(chalk.gray('  Connect with:'))
+          console.log(chalk.cyan(`    spindb connect ${containerName}`))
+        }
+      } catch (error) {
+        const e = error as Error
+        if (options.json) {
+          console.log(JSON.stringify({ success: false, error: e.message }))
+        } else {
+          console.error(uiError(e.message))
+        }
+        process.exit(1)
+      }
+    },
+  )

package/cli/commands/backup.ts

@@ -12,7 +12,7 @@ import {
   promptInstallDependencies,
 } from '../ui/prompts'
 import { createSpinner } from '../ui/spinner'
-import { success, error, warning, formatBytes } from '../ui/theme'
+import { uiSuccess, uiError, uiWarning, formatBytes } from '../ui/theme'
 import { getMissingDependencies } from '../../core/dependency-manager'
 
 function generateTimestamp(): string {
@@ -70,11 +70,13 @@ export const backupCommand = new Command('backup')
           if (running.length === 0) {
             if (containers.length === 0) {
               console.log(
-                warning('No containers found. Create one with: spindb create'),
+                uiWarning(
+                  'No containers found. Create one with: spindb create',
+                ),
               )
             } else {
               console.log(
-                warning(
+                uiWarning(
                   'No running containers. Start one first with: spindb start',
                 ),
               )
@@ -92,7 +94,7 @@ export const backupCommand = new Command('backup')
 
         const config = await containerManager.getConfig(containerName)
         if (!config) {
-          console.error(error(`Container "${containerName}" not found`))
+          console.error(uiError(`Container "${containerName}" not found`))
           process.exit(1)
         }
 
@@ -103,7 +105,7 @@ export const backupCommand = new Command('backup')
         })
         if (!running) {
           console.error(
-            error(
+            uiError(
               `Container "${containerName}" is not running. Start it first.`,
             ),
           )
@@ -133,7 +135,7 @@ export const backupCommand = new Command('backup')
           missingDeps = await getMissingDependencies(config.engine)
           if (missingDeps.length > 0) {
             console.error(
-              error(
+              uiError(
                 `Still missing tools: ${missingDeps.map((d) => d.name).join(', ')}`,
               ),
             )
@@ -169,7 +171,7 @@ export const backupCommand = new Command('backup')
           format = 'dump'
         } else if (options.format) {
           if (options.format !== 'sql' && options.format !== 'dump') {
-            console.error(error('Format must be "sql" or "dump"'))
+            console.error(uiError('Format must be "sql" or "dump"'))
             process.exit(1)
           }
           format = options.format as 'sql' | 'dump'
@@ -204,7 +206,7 @@ export const backupCommand = new Command('backup')
         backupSpinner.succeed('Backup created successfully')
 
         console.log()
-        console.log(success('Backup complete'))
+        console.log(uiSuccess('Backup complete'))
         console.log()
         console.log(chalk.gray('  File:'), chalk.cyan(result.path))
         console.log(
@@ -213,8 +215,8 @@ export const backupCommand = new Command('backup')
         )
         console.log(chalk.gray('  Format:'), chalk.white(result.format))
         console.log()
-      } catch (err) {
-        const e = err as Error
+      } catch (error) {
+        const e = error as Error
 
         const missingToolPatterns = ['pg_dump not found', 'mysqldump not found']
 
@@ -233,7 +235,7 @@ export const backupCommand = new Command('backup')
           process.exit(1)
         }
 
-        console.error(error(e.message))
+        console.error(uiError(e.message))
         process.exit(1)
       }
     },

package/cli/commands/clone.ts

@@ -5,7 +5,7 @@ import { processManager } from '../../core/process-manager'
 import { getEngine } from '../../engines'
 import { promptContainerSelect, promptContainerName } from '../ui/prompts'
 import { createSpinner } from '../ui/spinner'
-import { error, warning, connectionBox } from '../ui/theme'
+import { uiError, uiWarning, connectionBox } from '../ui/theme'
 
 export const cloneCommand = new Command('clone')
   .description('Clone a container with all its data')
@@ -22,14 +22,14 @@ export const cloneCommand = new Command('clone')
 
         if (containers.length === 0) {
           console.log(
-            warning('No containers found. Create one with: spindb create'),
+            uiWarning('No containers found. Create one with: spindb create'),
           )
           return
         }
 
         if (stopped.length === 0) {
           console.log(
-            warning(
+            uiWarning(
               'All containers are running. Stop a container first to clone it.',
             ),
           )
@@ -51,7 +51,7 @@ export const cloneCommand = new Command('clone')
 
       const sourceConfig = await containerManager.getConfig(sourceName)
       if (!sourceConfig) {
-        console.error(error(`Container "${sourceName}" not found`))
+        console.error(uiError(`Container "${sourceName}" not found`))
         process.exit(1)
       }
 
@@ -60,7 +60,7 @@ export const cloneCommand = new Command('clone')
       })
       if (running) {
         console.error(
-          error(
+          uiError(
             `Container "${sourceName}" is running. Stop it first to clone.`,
           ),
         )
@@ -72,8 +72,12 @@ export const cloneCommand = new Command('clone')
       }
 
       // Check if target container already exists
-      if (await containerManager.exists(targetName, { engine: sourceConfig.engine })) {
-        console.error(error(`Container "${targetName}" already exists`))
+      if (
+        await containerManager.exists(targetName, {
+          engine: sourceConfig.engine,
+        })
+      ) {
+        console.error(uiError(`Container "${targetName}" already exists`))
         process.exit(1)
       }
 
@@ -95,9 +99,9 @@ export const cloneCommand = new Command('clone')
       console.log(chalk.gray('  Start the cloned container:'))
       console.log(chalk.cyan(`  spindb start ${targetName}`))
       console.log()
-    } catch (err) {
-      const e = err as Error
-      console.error(error(e.message))
+    } catch (error) {
+      const e = error as Error
+      console.error(uiError(e.message))
       process.exit(1)
     }
   })

package/cli/commands/config.ts

@@ -9,7 +9,7 @@ import {
   ALL_TOOLS,
 } from '../../core/config-manager'
 import { updateManager } from '../../core/update-manager'
-import { error, success, header, info } from '../ui/theme'
+import { uiError, uiSuccess, header, uiInfo } from '../ui/theme'
 import { createSpinner } from '../ui/spinner'
 import type { BinaryTool } from '../../types'
 
@@ -95,9 +95,9 @@ export const configCommand = new Command('config')
             )
             console.log()
           }
-        } catch (err) {
-          const e = err as Error
-          console.error(error(e.message))
+        } catch (error) {
+          const e = error as Error
+          console.error(uiError(e.message))
           process.exit(1)
         }
       }),
@@ -208,9 +208,9 @@ export const configCommand = new Command('config')
             }
             console.log()
           }
-        } catch (err) {
-          const e = err as Error
-          console.error(error(e.message))
+        } catch (error) {
+          const e = error as Error
+          console.error(uiError(e.message))
           process.exit(1)
         }
       }),
@@ -224,14 +224,14 @@ export const configCommand = new Command('config')
         try {
           // Validate tool name
           if (!ALL_TOOLS.includes(tool as BinaryTool)) {
-            console.error(error(`Invalid tool: ${tool}`))
+            console.error(uiError(`Invalid tool: ${tool}`))
             console.log(chalk.gray(`  Valid tools: ${ALL_TOOLS.join(', ')}`))
             process.exit(1)
           }
 
           // Validate path exists
           if (!existsSync(path)) {
-            console.error(error(`File not found: ${path}`))
+            console.error(uiError(`File not found: ${path}`))
             process.exit(1)
           }
 
@@ -240,10 +240,10 @@ export const configCommand = new Command('config')
           const config = await configManager.getBinaryConfig(tool as BinaryTool)
           const versionLabel = config?.version ? ` (v${config.version})` : ''
 
-          console.log(success(`Set ${tool} to: ${path}${versionLabel}`))
-        } catch (err) {
-          const e = err as Error
-          console.error(error(e.message))
+          console.log(uiSuccess(`Set ${tool} to: ${path}${versionLabel}`))
+        } catch (error) {
+          const e = error as Error
+          console.error(uiError(e.message))
           process.exit(1)
         }
       }),
@@ -256,16 +256,16 @@ export const configCommand = new Command('config')
         try {
           // Validate tool name
           if (!ALL_TOOLS.includes(tool as BinaryTool)) {
-            console.error(error(`Invalid tool: ${tool}`))
+            console.error(uiError(`Invalid tool: ${tool}`))
             console.log(chalk.gray(`  Valid tools: ${ALL_TOOLS.join(', ')}`))
             process.exit(1)
           }
 
           await configManager.clearBinaryPath(tool as BinaryTool)
-          console.log(success(`Removed ${tool} configuration`))
-        } catch (err) {
-          const e = err as Error
-          console.error(error(e.message))
+          console.log(uiSuccess(`Removed ${tool} configuration`))
+        } catch (error) {
+          const e = error as Error
+          console.error(uiError(e.message))
           process.exit(1)
         }
       }),
@@ -278,7 +278,7 @@ export const configCommand = new Command('config')
         try {
           // Validate tool name
           if (!ALL_TOOLS.includes(tool as BinaryTool)) {
-            console.error(error(`Invalid tool: ${tool}`))
+            console.error(uiError(`Invalid tool: ${tool}`))
             console.log(chalk.gray(`  Valid tools: ${ALL_TOOLS.join(', ')}`))
             process.exit(1)
           }
@@ -287,15 +287,15 @@ export const configCommand = new Command('config')
           if (path) {
             console.log(path)
           } else {
-            console.error(error(`${tool} not found`))
+            console.error(uiError(`${tool} not found`))
             console.log(
               chalk.gray(`  Run 'spindb config detect' to auto-detect tools`),
             )
             process.exit(1)
           }
-        } catch (err) {
-          const e = err as Error
-          console.error(error(e.message))
+        } catch (error) {
+          const e = error as Error
+          console.error(uiError(e.message))
           process.exit(1)
         }
       }),
@@ -328,7 +328,7 @@ export const configCommand = new Command('config')
           }
 
           if (state !== 'on' && state !== 'off') {
-            console.error(error('Invalid state. Use "on" or "off"'))
+            console.error(uiError('Invalid state. Use "on" or "off"'))
             process.exit(1)
           }
 
@@ -336,18 +336,18 @@ export const configCommand = new Command('config')
           await updateManager.setAutoCheckEnabled(enabled)
 
           if (enabled) {
-            console.log(success('Update checks enabled on startup'))
+            console.log(uiSuccess('Update checks enabled on startup'))
           } else {
-            console.log(info('Update checks disabled on startup'))
+            console.log(uiInfo('Update checks disabled on startup'))
             console.log(
               chalk.gray(
                 '  You can still manually check with: spindb version --check',
               ),
             )
           }
-        } catch (err) {
-          const e = err as Error
-          console.error(error(e.message))
+        } catch (error) {
+          const e = error as Error
+          console.error(uiError(e.message))
           process.exit(1)
         }
       }),