nvoi 0.1.7 → 0.2.0

data/.claude/todo/refactor/12-cli-db-command.md

@@ -1,128 +0,0 @@
-# 12 - CLI: Database Commands
-
-## Priority: FIFTH (parallel with others)
-
----
-
-## Current State (NEW from main)
-
-| File | Lines | Purpose |
-|------|-------|---------|
-| `service/db.rb` | 285 | DbService - database branch operations |
-| `database/provider.rb` | 160 | Base provider + factory + structs |
-| `database/postgres.rb` | ~100 | Postgres dump/restore |
-| `database/mysql.rb` | ~100 | MySQL dump/restore |
-| `database/sqlite.rb` | ~80 | SQLite dump/restore |
-
-**Total: ~725 lines**
-
----
-
-## What It Does
-
-Database "branching" = snapshots for backup/restore:
-
-```bash
-nvoi db branch create [name]      # Dump current DB to file
-nvoi db branch list               # List saved branches
-nvoi db branch restore <id>       # Restore branch to new DB
-nvoi db branch download <id>      # Download dump locally
-```
-
----
-
-## Target Structure
-
-```
-lib/nvoi/cli/db/
-├── command.rb                    # Router for subcommands
-├── branch/
-│   ├── create/
-│   │   └── command.rb
-│   ├── list/
-│   │   └── command.rb
-│   ├── restore/
-│   │   └── command.rb
-│   └── download/
-│       └── command.rb
-```
-
-OR simpler (single file since operations are small):
-
-```
-lib/nvoi/cli/db/
-└── command.rb                    # All branch operations
-```
-
----
-
-## Database Module → External
-
-The `database/` providers are external adapters (talk to DBs via kubectl exec):
-
-```
-lib/nvoi/external/database/
-├── provider.rb                   # Base + factory
-├── postgres.rb
-├── mysql.rb
-└── sqlite.rb
-```
-
-**Note:** These use `kubectl exec` to run dump/restore commands in pods. They're external adapters like cloud providers.
-
----
-
-## Objects to Extract
-
-From `database/provider.rb`:
-
-```ruby
-# objects/database.rb
-Credentials = Struct.new(:user, :password, :host, :port, :database, :path, keyword_init: true)
-DumpOptions = Struct.new(:pod_name, :database, :user, :password, :host_path, keyword_init: true)
-RestoreOptions = Struct.new(:pod_name, :database, :user, :password, :source_db, :host_path, keyword_init: true)
-CreateOptions = Struct.new(:pod_name, :database, :user, :password, keyword_init: true)
-Branch = Struct.new(:id, :created_at, :size, :adapter, :database, keyword_init: true)
-BranchMetadata  # class with branches array
-```
-
----
-
-## DRY Opportunities
-
-### 1. SSH Helper Pattern
-`DbService#with_ssh` creates SSH executor. Same pattern in other services.
-Extract to base or mixin:
-
-```ruby
-# In command base or utils
-def with_master_ssh(config, provider)
-  server_ip = get_master_server_ip(config, provider)
-  ssh = External::SSH.new(server_ip, config.ssh_key_path)
-  yield ssh
-end
-```
-
-### 2. Database Credentials Resolution
-`Config::DatabaseHelper.get_credentials` is called from multiple places.
-Keep in config or move to database provider factory.
-
----
-
-## Migration Steps
-
-1. Create `lib/nvoi/external/database/` directory
-2. Move `database/*.rb` → `external/database/`
-3. Extract Structs to `objects/database.rb`
-4. Create `lib/nvoi/cli/db/command.rb`
-5. Move logic from `service/db.rb` → `cli/db/command.rb`
-6. Delete `service/db.rb`
-
----
-
-## Estimated Effort
-
-- **Lines to reorganize:** ~725
-- **Files created:** 5 (1 command + 4 external/database)
-- **Files deleted/moved:** 5
-- **Net change:** minimal (reorganization)

data/.claude/todo/refactor/_target.md

@@ -1,79 +0,0 @@
-lib/nvoi/
-│
-├── cli.rb # Thor routing only
-│
-├── cli/
-│ ├── deploy/
-│ │ ├── command.rb
-│ │ └── steps/
-│ │ ├── provision_network.rb
-│ │ ├── provision_server.rb
-│ │ ├── provision_volume.rb
-│ │ ├── setup_k3s.rb
-│ │ ├── configure_tunnel.rb
-│ │ ├── build_image.rb
-│ │ ├── deploy_service.rb
-│ │ └── cleanup_images.rb
-│ │
-│ ├── delete/
-│ │ ├── command.rb
-│ │ └── steps/
-│ │ ├── teardown_tunnel.rb
-│ │ ├── teardown_dns.rb
-│ │ ├── detach_volumes.rb
-│ │ ├── teardown_server.rb
-│ │ ├── teardown_volume.rb
-│ │ ├── teardown_firewall.rb
-│ │ └── teardown_network.rb
-│ │
-│ ├── exec/
-│ │ └── command.rb
-│ │
-│ └── credentials/
-│ ├── edit/
-│ │ └── command.rb
-│ └── show/
-│ └── command.rb
-│
-├── external/
-│ ├── cloud/
-│ │ ├── base.rb
-│ │ ├── hetzner.rb
-│ │ ├── aws.rb
-│ │ └── scaleway.rb
-│ ├── dns/
-│ │ └── cloudflare.rb
-│ ├── ssh.rb
-│ ├── kubectl.rb
-│ └── containerd.rb
-│
-├── objects/
-│ ├── server.rb
-│ ├── network.rb
-│ ├── firewall.rb
-│ ├── volume.rb
-│ ├── tunnel.rb
-│ ├── dns_record.rb
-│ ├── zone.rb
-│ ├── service_spec.rb
-│ └── config.rb
-│
-└── utils/
-├── namer.rb
-├── env_resolver.rb
-├── crypto.rb
-├── templates.rb
-├── logger.rb
-└── constants.rb
-
----
-
-Summary:
-
-| Folder        | Purpose                | Rule                                  |
-| ------------- | ---------------------- | ------------------------------------- |
-| cli/          | Command entrypoints    | 1 command = 1 command.rb              |
-| cli/\*/steps/ | Multi-step pipelines   | Only for commands with ordered phases |
-| external/     | Outside world adapters | APIs, SSH, CLIs                       |
-| objects/      | Data structures        | No behavior, just shape               |
-| utils/        | Stateless helpers      | Used everywhere                       |

data/.claude/todo/refactor-execution/00-entrypoint.md

@@ -1,49 +0,0 @@
-# Refactor Execution Entrypoint
-
-## Strategy
-
-**Clean slate rebuild.** Not migration.
-
-- **Reference codebase:** `/Users/ben/Desktop/nvoi-rb/` (working code, read-only)
-- **Worktree:** `/Users/ben/Desktop/nvoi-rb-refactor/` (clean slate, write here)
-
-## Setup
-
-```bash
-# Clear worktree lib/nvoi/ (keep exe/, test/, templates/, etc.)
-cd /Users/ben/Desktop/nvoi-rb-refactor
-rm -rf lib/nvoi
-mkdir lib/nvoi
-```
-
-## Execution Order
-
-Each phase: **build → validate → test → commit**
-
-```
-Phase 1: 01-objects.md      → Build objects/ from scratch
-Phase 2: 02-utils.md        → Build utils/ from scratch
-Phase 3: 03-external-cloud.md → Build external/cloud/
-Phase 4: 04-external-dns.md   → Build external/dns/
-Phase 5: 05-external-other.md → Build external/ssh, kubectl, containerd, database
-Phase 6: 06-cli-deploy.md     → Build cli/deploy/
-Phase 7: 07-cli-delete.md     → Build cli/delete/
-Phase 8: 08-cli-exec.md       → Build cli/exec/
-Phase 9: 09-cli-credentials.md → Build cli/credentials/
-Phase 10: 10-cli-db.md        → Build cli/db/
-Phase 11: 11-cli-router.md    → Build cli.rb
-Phase 12: 12-cleanup.md       → Final wiring, lib/nvoi.rb, version.rb
-```
-
-## Per-Phase Protocol
-
-1. **Build** - Create new files reading from reference
-2. **Validate** - User reviews structure
-3. **Test** - `bundle exec rake test`
-4. **Commit** - Only after tests pass
-
-## Current Step
-
-**NOT STARTED**
-
-Next: Clear worktree, then `01-objects.md`

data/.claude/todo/refactor-execution/01-objects.md

@@ -1,42 +0,0 @@
-# 01 - Objects Execution
-
-## Reference
-Read from: `/Users/ben/Desktop/nvoi-rb/lib/nvoi/`
-
-## Build
-
-Create `lib/nvoi/objects/` with:
-
-| File | Content (from reference) |
-|------|--------------------------|
-| `server.rb` | `Server`, `ServerCreateOptions` from `providers/base.rb` |
-| `network.rb` | `Network` from `providers/base.rb` |
-| `firewall.rb` | `Firewall` from `providers/base.rb` |
-| `volume.rb` | `Volume`, `VolumeCreateOptions` from `providers/base.rb`, `MountOptions` from `remote/volume_manager.rb` |
-| `tunnel.rb` | `Tunnel` from `cloudflare/client.rb`, `TunnelInfo` from `deployer/types.rb` |
-| `dns.rb` | `Zone`, `DNSRecord` from `cloudflare/client.rb` |
-| `database.rb` | `DatabaseCredentials`, `DumpOptions`, `RestoreOptions`, `CreateOptions`, `Branch`, `BranchMetadata` from `database/provider.rb` |
-| `service_spec.rb` | `ServiceSpec` from `config/types.rb` |
-
-All under `Nvoi::Objects` namespace.
-
-## Validate
-
-- [ ] `ls lib/nvoi/objects/` shows 8 files
-- [ ] Each file has `module Nvoi::Objects`
-- [ ] Structs match reference
-
-## Test
-
-```bash
-cd /Users/ben/Desktop/nvoi-rb-refactor
-ruby -e "require './lib/nvoi/objects/server'; p Nvoi::Objects::Server.new(id: '1', name: 'test', status: 'running', public_ipv4: '1.2.3.4')"
-```
-
-(Full test suite runs after all phases complete)
-
-## Commit
-
-```bash
-git add -A && git commit -m "Phase 1: Build objects/"
-```

data/.claude/todo/refactor-execution/02-utils.md

@@ -1,41 +0,0 @@
-# 02 - Utils Execution
-
-## Reference
-Read from: `/Users/ben/Desktop/nvoi-rb/lib/nvoi/`
-
-## Build
-
-Create `lib/nvoi/utils/` with:
-
-| File | Content (from reference) |
-|------|--------------------------|
-| `logger.rb` | From `logger.rb` |
-| `constants.rb` | From `constants.rb` |
-| `errors.rb` | From `errors.rb` |
-| `namer.rb` | From `config/naming.rb` + add `hostname(subdomain, domain)` |
-| `env_resolver.rb` | From `config/env_resolver.rb` |
-| `config_loader.rb` | Merge `config/loader.rb` + `config/ssh_keys.rb` |
-| `crypto.rb` | Merge `credentials/crypto.rb` + `credentials/manager.rb` |
-| `templates.rb` | Merge `k8s/templates.rb` + `k8s/renderer.rb` |
-| `retry.rb` | From `deployer/retry.rb` |
-
-All under `Nvoi::Utils` namespace.
-
-## Validate
-
-- [ ] `ls lib/nvoi/utils/` shows 9 files
-- [ ] Each file has `module Nvoi::Utils`
-- [ ] `hostname` method added to namer
-
-## Test
-
-```bash
-cd /Users/ben/Desktop/nvoi-rb-refactor
-ruby -e "require './lib/nvoi/utils/logger'; Nvoi::Utils::Logger.new.info('test')"
-```
-
-## Commit
-
-```bash
-git add -A && git commit -m "Phase 2: Build utils/"
-```

data/.claude/todo/refactor-execution/03-external-cloud.md

@@ -1,38 +0,0 @@
-# 03 - External Cloud Execution
-
-## Reference
-Read from: `/Users/ben/Desktop/nvoi-rb/lib/nvoi/`
-
-## Build
-
-Create `lib/nvoi/external/cloud/` with:
-
-| File | Content (from reference) |
-|------|--------------------------|
-| `base.rb` | From `providers/base.rb` (interface only, no Structs) |
-| `hetzner.rb` | Merge `providers/hetzner.rb` + `providers/hetzner_client.rb` |
-| `aws.rb` | From `providers/aws.rb` |
-| `scaleway.rb` | Merge `providers/scaleway.rb` + `providers/scaleway_client.rb` |
-| `factory.rb` | From `service/provider.rb` (ProviderHelper → `External::Cloud.for(config)`) |
-
-All under `Nvoi::External::Cloud` namespace.
-Use `Objects::Server`, `Objects::Network`, etc.
-
-## Validate
-
-- [ ] `ls lib/nvoi/external/cloud/` shows 5 files
-- [ ] `base.rb` has no Struct definitions
-- [ ] Each provider uses `Objects::` for return types
-
-## Test
-
-```bash
-cd /Users/ben/Desktop/nvoi-rb-refactor
-ruby -e "require './lib/nvoi/objects/server'; require './lib/nvoi/external/cloud/base'; p Nvoi::External::Cloud::Base"
-```
-
-## Commit
-
-```bash
-git add -A && git commit -m "Phase 3: Build external/cloud/"
-```

data/.claude/todo/refactor-execution/04-external-dns.md

@@ -1,35 +0,0 @@
-# 04 - External DNS Execution
-
-## Reference
-Read from: `/Users/ben/Desktop/nvoi-rb/lib/nvoi/`
-
-## Build
-
-Create `lib/nvoi/external/dns/` with:
-
-| File | Content (from reference) |
-|------|--------------------------|
-| `cloudflare.rb` | Merge `cloudflare/client.rb` + `deployer/tunnel_manager.rb` (no Structs) |
-
-Under `Nvoi::External::DNS` namespace.
-Use `Objects::Tunnel`, `Objects::Zone`, `Objects::DNSRecord`, `Objects::TunnelInfo`.
-Add `setup_tunnel` method from TunnelManager.
-
-## Validate
-
-- [ ] `ls lib/nvoi/external/dns/` shows 1 file
-- [ ] No Struct definitions in file
-- [ ] `setup_tunnel` method exists
-
-## Test
-
-```bash
-cd /Users/ben/Desktop/nvoi-rb-refactor
-ruby -e "require './lib/nvoi/objects/tunnel'; require './lib/nvoi/objects/dns'; require './lib/nvoi/external/dns/cloudflare'; p Nvoi::External::DNS::Cloudflare"
-```
-
-## Commit
-
-```bash
-git add -A && git commit -m "Phase 4: Build external/dns/"
-```

data/.claude/todo/refactor-execution/05-external-other.md

@@ -1,46 +0,0 @@
-# 05 - External Other Execution
-
-## Reference
-Read from: `/Users/ben/Desktop/nvoi-rb/lib/nvoi/`
-
-## Build
-
-Create in `lib/nvoi/external/`:
-
-| File | Content (from reference) |
-|------|--------------------------|
-| `ssh.rb` | From `remote/ssh_executor.rb` |
-| `kubectl.rb` | Extract kubectl ops from `k8s/renderer.rb` |
-| `containerd.rb` | From `remote/docker_manager.rb` (rename class) |
-| `volume_manager.rb` | From `remote/volume_manager.rb` (no MountOptions Struct) |
-
-Create `lib/nvoi/external/database/`:
-
-| File | Content (from reference) |
-|------|--------------------------|
-| `provider.rb` | From `database/provider.rb` (no Structs, use `Objects::`) |
-| `postgres.rb` | From `database/postgres.rb` |
-| `mysql.rb` | From `database/mysql.rb` |
-| `sqlite.rb` | From `database/sqlite.rb` |
-
-Under `Nvoi::External` namespace.
-Use `Objects::MountOptions`, `Objects::DatabaseCredentials`, etc.
-
-## Validate
-
-- [ ] `ls lib/nvoi/external/` shows ssh.rb, kubectl.rb, containerd.rb, volume_manager.rb
-- [ ] `ls lib/nvoi/external/database/` shows 4 files
-- [ ] No Struct definitions in any file
-
-## Test
-
-```bash
-cd /Users/ben/Desktop/nvoi-rb-refactor
-ruby -e "require './lib/nvoi/external/ssh'; p Nvoi::External::SSH"
-```
-
-## Commit
-
-```bash
-git add -A && git commit -m "Phase 5: Build external/ssh, kubectl, containerd, database"
-```

data/.claude/todo/refactor-execution/06-cli-deploy.md

@@ -1,45 +0,0 @@
-# 06 - CLI Deploy Execution
-
-## Reference
-Read from: `/Users/ben/Desktop/nvoi-rb/lib/nvoi/`
-
-## Build
-
-Create `lib/nvoi/cli/deploy/command.rb`:
-- Orchestrator from `service/deploy.rb`
-- Uses `External::`, `Utils::`, `Objects::`
-
-Create `lib/nvoi/cli/deploy/steps/`:
-
-| File | Content (from reference) |
-|------|--------------------------|
-| `provision_network.rb` | From `deployer/infrastructure.rb` (network + firewall) |
-| `provision_server.rb` | From `steps/server_provisioner.rb` |
-| `provision_volume.rb` | From `steps/volume_provisioner.rb` |
-| `setup_k3s.rb` | Merge `steps/k3s_provisioner.rb` + `steps/k3s_cluster_setup.rb` |
-| `configure_tunnel.rb` | From `steps/tunnel_configurator.rb` |
-| `build_image.rb` | From `deployer/image_builder.rb` |
-| `deploy_database.rb` | From `steps/database_provisioner.rb` |
-| `deploy_service.rb` | Merge `deployer/orchestrator.rb` + `deployer/service_deployer.rb` |
-| `cleanup_images.rb` | From `deployer/cleaner.rb` |
-
-Under `Nvoi::CLI::Deploy` namespace.
-
-## Validate
-
-- [ ] `ls lib/nvoi/cli/deploy/` shows command.rb + steps/
-- [ ] `ls lib/nvoi/cli/deploy/steps/` shows 9 files
-- [ ] command.rb orchestrates steps in correct order
-
-## Test
-
-```bash
-cd /Users/ben/Desktop/nvoi-rb-refactor
-ruby -e "require './lib/nvoi/cli/deploy/command'; p Nvoi::CLI::Deploy::Command"
-```
-
-## Commit
-
-```bash
-git add -A && git commit -m "Phase 6: Build cli/deploy/"
-```

data/.claude/todo/refactor-execution/07-cli-delete.md

@@ -1,43 +0,0 @@
-# 07 - CLI Delete Execution
-
-## Reference
-Read from: `/Users/ben/Desktop/nvoi-rb/lib/nvoi/`
-
-## Build
-
-Create `lib/nvoi/cli/delete/command.rb`:
-- Orchestrator from `service/delete.rb`
-- Uses `External::`, `Utils::`, `Objects::`
-
-Create `lib/nvoi/cli/delete/steps/`:
-
-| File | Content (from reference) |
-|------|--------------------------|
-| `detach_volumes.rb` | Extract from `service/delete.rb` |
-| `teardown_server.rb` | Extract from `service/delete.rb` |
-| `teardown_volume.rb` | Extract from `service/delete.rb` |
-| `teardown_firewall.rb` | Extract from `service/delete.rb` |
-| `teardown_network.rb` | Extract from `service/delete.rb` |
-| `teardown_tunnel.rb` | Extract from `service/delete.rb` |
-| `teardown_dns.rb` | Extract from `service/delete.rb` |
-
-Under `Nvoi::CLI::Delete` namespace.
-
-## Validate
-
-- [ ] `ls lib/nvoi/cli/delete/` shows command.rb + steps/
-- [ ] `ls lib/nvoi/cli/delete/steps/` shows 7 files
-- [ ] Teardown order correct: detach → servers → volumes → firewall → network → tunnel → dns
-
-## Test
-
-```bash
-cd /Users/ben/Desktop/nvoi-rb-refactor
-ruby -e "require './lib/nvoi/cli/delete/command'; p Nvoi::CLI::Delete::Command"
-```
-
-## Commit
-
-```bash
-git add -A && git commit -m "Phase 7: Build cli/delete/"
-```

data/.claude/todo/refactor-execution/08-cli-exec.md

@@ -1,30 +0,0 @@
-# 08 - CLI Exec Execution
-
-## Reference
-Read from: `/Users/ben/Desktop/nvoi-rb/lib/nvoi/`
-
-## Build
-
-Create `lib/nvoi/cli/exec/command.rb`:
-- From `service/exec.rb`
-- Uses `External::SSH`, `Utils::`
-
-Under `Nvoi::CLI::Exec` namespace.
-
-## Validate
-
-- [ ] `ls lib/nvoi/cli/exec/` shows command.rb
-- [ ] Supports: single server, `--all`, `-i` interactive
-
-## Test
-
-```bash
-cd /Users/ben/Desktop/nvoi-rb-refactor
-ruby -e "require './lib/nvoi/cli/exec/command'; p Nvoi::CLI::Exec::Command"
-```
-
-## Commit
-
-```bash
-git add -A && git commit -m "Phase 8: Build cli/exec/"
-```

data/.claude/todo/refactor-execution/09-cli-credentials.md

@@ -1,34 +0,0 @@
-# 09 - CLI Credentials Execution
-
-## Reference
-Read from: `/Users/ben/Desktop/nvoi-rb/lib/nvoi/`
-
-## Build
-
-Create `lib/nvoi/cli/credentials/edit/command.rb`:
-- Edit logic from `credentials/editor.rb`
-- Uses `Utils::Crypto`
-
-Create `lib/nvoi/cli/credentials/show/command.rb`:
-- Show logic from `credentials/editor.rb`
-- Uses `Utils::Crypto`
-
-Under `Nvoi::CLI::Credentials` namespace.
-
-## Validate
-
-- [ ] `ls lib/nvoi/cli/credentials/edit/` shows command.rb
-- [ ] `ls lib/nvoi/cli/credentials/show/` shows command.rb
-
-## Test
-
-```bash
-cd /Users/ben/Desktop/nvoi-rb-refactor
-ruby -e "require './lib/nvoi/cli/credentials/edit/command'; p Nvoi::CLI::Credentials::Edit::Command"
-```
-
-## Commit
-
-```bash
-git add -A && git commit -m "Phase 9: Build cli/credentials/"
-```

data/.claude/todo/refactor-execution/10-cli-db.md

@@ -1,31 +0,0 @@
-# 10 - CLI Database Execution
-
-## Reference
-Read from: `/Users/ben/Desktop/nvoi-rb/lib/nvoi/`
-
-## Build
-
-Create `lib/nvoi/cli/db/command.rb`:
-- From `service/db.rb`
-- Uses `External::Database::`, `External::SSH`, `Utils::`
-- Methods: `branch_create`, `branch_list`, `branch_restore`, `branch_download`
-
-Under `Nvoi::CLI::Db` namespace.
-
-## Validate
-
-- [ ] `ls lib/nvoi/cli/db/` shows command.rb
-- [ ] All branch methods present
-
-## Test
-
-```bash
-cd /Users/ben/Desktop/nvoi-rb-refactor
-ruby -e "require './lib/nvoi/cli/db/command'; p Nvoi::CLI::Db::Command"
-```
-
-## Commit
-
-```bash
-git add -A && git commit -m "Phase 10: Build cli/db/"
-```

data/.claude/todo/refactor-execution/11-cli-router.md

@@ -1,44 +0,0 @@
-# 11 - CLI Router Execution
-
-## Reference
-Read from: `/Users/ben/Desktop/nvoi-rb/lib/nvoi/`
-
-## Build
-
-Create `lib/nvoi/cli.rb`:
-- Thor routing only (~50-80 lines)
-- Lazy requires for each command
-- Delegates to `CLI::Deploy::Command`, `CLI::Delete::Command`, etc.
-
-```ruby
-# Structure
-module Nvoi
-  class CLI < Thor
-    desc "deploy", "Deploy application"
-    def deploy
-      require_relative "cli/deploy/command"
-      CLI::Deploy::Command.new(options).run
-    end
-    # ... etc
-  end
-end
-```
-
-## Validate
-
-- [ ] `wc -l lib/nvoi/cli.rb` < 100 lines
-- [ ] No business logic in cli.rb
-- [ ] All commands delegate to `cli/*/command.rb`
-
-## Test
-
-```bash
-cd /Users/ben/Desktop/nvoi-rb-refactor
-ruby -e "require './lib/nvoi/cli'; p Nvoi::CLI"
-```
-
-## Commit
-
-```bash
-git add -A && git commit -m "Phase 11: Build cli.rb router"
-```