nvoi 0.1.6 → 0.1.7

data/.claude/todo/refactor-execution/12-cleanup.md

@@ -0,0 +1,120 @@
+# 12 - Cleanup Execution
+
+## Reference
+Read from: `/Users/ben/Desktop/nvoi-rb/lib/nvoi/`
+
+## Build
+
+### Zeitwerk Pattern (dev-only dependency)
+
+**Gemfile:**
+```ruby
+group :development do
+  gem "zeitwerk"
+end
+```
+
+**lib/nvoi.rb:**
+```ruby
+# frozen_string_literal: true
+
+if defined?(Nvoi::AUTOLOADERS)
+  require "zeitwerk"
+  Nvoi::AUTOLOADERS << Zeitwerk::Loader.for_gem.tap do |loader|
+    loader.ignore("#{__dir__}/nvoi/loader.rb")
+    loader.setup
+  end
+else
+  require_relative "nvoi/loader"
+end
+
+module Nvoi
+  VERSION = "0.1.0"
+end
+```
+
+**bin/generate_loader** (script to regenerate loader.rb):
+```ruby
+#!/usr/bin/env ruby
+require "zeitwerk"
+
+loader = Zeitwerk::Loader.for_gem(warn_on_extra_files: false)
+loader.ignore("#{__dir__}/../lib/nvoi/loader.rb")
+
+requires = []
+loader.on_load do |cpath, value, abspath|
+  requires << abspath.sub("#{__dir__}/../lib/", "").sub(".rb", "")
+end
+loader.setup
+loader.eager_load
+
+File.write("#{__dir__}/../lib/nvoi/loader.rb", <<~RUBY)
+  # frozen_string_literal: true
+  # AUTO-GENERATED by bin/generate_loader - do not edit manually
+
+  #{requires.map { |r| "require_relative \"#{r.sub('nvoi/', '')}\"" }.join("\n")}
+RUBY
+
+puts "Generated lib/nvoi/loader.rb with #{requires.size} requires"
+```
+
+**lib/nvoi/loader.rb** (auto-generated, committed):
+```ruby
+# frozen_string_literal: true
+# AUTO-GENERATED by bin/generate_loader - do not edit manually
+
+require_relative "version"
+require_relative "objects/server"
+# ... all files in dependency order
+```
+
+### Create config files
+
+Create `lib/nvoi/version.rb`:
+- From reference
+
+Create `lib/nvoi/config/` (keep config types):
+- `types.rb` - Config classes (Application, ServerConfig, etc.) - use `Objects::ServiceSpec`
+- Other config files as needed
+
+## Validate
+
+- [ ] `tree lib/nvoi -L 2` matches target structure
+- [ ] No old directories: `providers/`, `cloudflare/`, `remote/`, `service/`, `steps/`, `deployer/`, `k8s/`, `database/`, `credentials/`
+- [ ] `ruby bin/generate_loader` runs without error
+- [ ] `lib/nvoi.rb` loads without error (with and without Zeitwerk)
+
+## Test
+
+```bash
+cd /Users/ben/Desktop/nvoi-rb-refactor
+
+# Test with Zeitwerk (dev mode)
+NVOI_AUTOLOADERS=1 ruby -e "module Nvoi; AUTOLOADERS = []; end; require './lib/nvoi'; p Nvoi::Objects::Server"
+
+# Test without Zeitwerk (production mode - uses loader.rb)
+ruby -e "require './lib/nvoi'; p Nvoi::Objects::Server"
+
+# Full test suite
+bundle exec rake test
+```
+
+**Full test suite must pass.**
+
+## Commit
+
+```bash
+git add -A && git commit -m "Phase 12: Final wiring with Zeitwerk pattern"
+```
+
+## Final Verification
+
+```bash
+# CLI smoke test
+./exe/nvoi --help
+./exe/nvoi deploy --help
+./exe/nvoi delete --help
+./exe/nvoi exec --help
+./exe/nvoi credentials --help
+./exe/nvoi db --help
+```

data/.claude/todo/refactor-execution/_monitoring-strategy.md

@@ -0,0 +1,126 @@
+# Monitoring Strategy
+
+## Per-Step Validation
+
+### After Every Step
+
+```bash
+bundle exec rake test          # Must pass
+ruby -c lib/nvoi.rb            # Syntax check
+```
+
+---
+
+## Step-Specific Assertions
+
+### 01-objects
+- [ ] `Objects::Server.new(id: "1", name: "x", status: "running", public_ipv4: "1.2.3.4")` works
+- [ ] All Structs accessible under `Nvoi::Objects::`
+- [ ] Old Struct definitions removed from source files
+- [ ] All references updated to `Objects::`
+- [ ] `grep -r "Providers::Server" lib/` returns nothing
+
+### 02-utils
+- [ ] `Utils::Logger.new` works
+- [ ] `Utils::Namer.new(config).hostname("app", "example.com")` returns `"app.example.com"`
+- [ ] `Utils::ConfigLoader.new.load(path)` returns config
+- [ ] `Utils::Crypto` encrypts/decrypts
+- [ ] Old files deleted: `logger.rb`, `constants.rb`, `errors.rb`, `config/naming.rb`, etc.
+- [ ] `grep -r "Config::ResourceNamer" lib/` returns nothing
+
+### 03-external-cloud
+- [ ] `External::Cloud.for(config)` returns correct provider
+- [ ] `External::Cloud::Hetzner.new(token)` instantiates
+- [ ] Provider methods work: `find_server`, `create_server`, etc.
+- [ ] `providers/` directory deleted
+- [ ] `grep -r "Providers::Hetzner" lib/` returns nothing
+
+### 04-external-dns
+- [ ] `External::DNS::Cloudflare.new(token, account_id)` instantiates
+- [ ] `setup_tunnel` method exists and callable
+- [ ] `cloudflare/` directory deleted
+- [ ] `grep -r "Cloudflare::Client" lib/` returns nothing
+
+### 05-external-other
+- [ ] `External::SSH.new(ip, key)` instantiates
+- [ ] `External::Kubectl.new(ssh)` instantiates
+- [ ] `External::Containerd.new(ssh)` instantiates
+- [ ] `External::Database.provider_for("postgres")` returns provider
+- [ ] `remote/` directory deleted
+- [ ] `k8s/` directory deleted
+- [ ] `database/` directory deleted
+- [ ] `grep -r "Remote::SSHExecutor" lib/` returns nothing
+
+### 06-cli-deploy
+- [ ] `CLI::Deploy::Command.new(options).run` callable
+- [ ] All steps in `cli/deploy/steps/` load without error
+- [ ] Step order matches original flow
+- [ ] `service/deploy.rb` deleted
+- [ ] `steps/` directory deleted
+- [ ] `deployer/` directory deleted
+- [ ] `grep -r "Service::DeployService" lib/` returns nothing
+
+### 07-cli-delete
+- [ ] `CLI::Delete::Command.new(options).run` callable
+- [ ] Teardown order preserved (detach → delete servers → delete volumes → etc.)
+- [ ] `service/delete.rb` deleted
+- [ ] `grep -r "Service::DeleteService" lib/` returns nothing
+
+### 08-cli-exec
+- [ ] `CLI::Exec::Command.new(options).run(["ls"])` callable
+- [ ] `--all` flag works
+- [ ] `-i` interactive works
+- [ ] `service/exec.rb` deleted
+
+### 09-cli-credentials
+- [ ] `CLI::Credentials::Edit::Command.new(options).run` callable
+- [ ] `CLI::Credentials::Show::Command.new(options).run` callable
+- [ ] `credentials/` directory deleted
+
+### 10-cli-db
+- [ ] `CLI::Db::Command.new(options).branch_create` callable
+- [ ] `branch_list`, `branch_restore`, `branch_download` callable
+- [ ] `service/db.rb` deleted
+
+### 11-cli-router
+- [ ] `nvoi deploy --help` works
+- [ ] `nvoi delete --help` works
+- [ ] `nvoi exec --help` works
+- [ ] `nvoi credentials --help` works
+- [ ] `nvoi db --help` works
+- [ ] `cli.rb` is < 100 lines
+- [ ] `service/` directory deleted (should be empty by now)
+
+### 12-cleanup
+- [ ] No empty directories remain
+- [ ] `tree lib/nvoi -L 2` matches expected structure
+- [ ] Full test suite passes
+- [ ] No orphan requires in `lib/nvoi.rb`
+
+---
+
+## Integration Smoke Test (End)
+
+```bash
+# Dry run (no actual cloud calls)
+nvoi deploy --help
+nvoi delete --help
+nvoi exec --help
+nvoi credentials show --help
+nvoi db branch --help
+```
+
+If all help commands work → routing is correct.
+
+---
+
+## Rollback
+
+If any step fails:
+```bash
+git checkout HEAD~1 -- .
+# or
+git reset --hard HEAD~1
+```
+
+Single commit = single rollback.