Update handoff docs for completed engine layer
Some checks failed
CI / scan_ruby (push) Has been cancelled
CI / scan_js (push) Has been cancelled
CI / lint (push) Has been cancelled
CI / test (push) Has been cancelled
CI / system-test (push) Has been cancelled

Mark engine as done in overview and build order. Update next-steps to
focus on test gap analysis. Add engine file map, data flow, and dev
setup quirks (Zeitwerk conflict, engine routes conflict) to architecture.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-06-08 20:14:19 -06:00
parent 286db51fcd
commit ab1f29269e
3 changed files with 91 additions and 58 deletions

View File

@@ -10,20 +10,19 @@ This is the first half of a two-part tool. The second half (not yet built) uses
## Current state (as of 2026-06-08)
Two layers are complete:
Three layers are complete:
1. **Core inspector** — extracts the full chain from any ActiveRecord model class at runtime
2. **CLI**`whetrails inspect <ModelName>` boots the host Rails app and renders the chain to the terminal
The next layer (Rails engine / browser UI) has not been started.
3. **Rails engine** — browser UI mounted at `/whetrails`, sidebar model list, lifecycle timeline with vscode source links
## Build order
```
[DONE] 1. Gem core lib/whetrails/inspector.rb
[DONE] 2. CLI exe/whetrails + lib/whetrails/cli.rb
[NEXT] 3. Rails engine browser UI mounted at /whetrails
4. Test gap layer uses chain data to find uncovered callbacks/validators
[DONE] 3. Rails engine browser UI mounted at /whetrails
[NEXT] 4. Test gap layer uses chain data to find uncovered callbacks/validators
```
## Repository