refactor(ddd-lite): shell layout + kernel contract + base64 reference module

[rivodotlove]

Summary

Step 1 of the DDD-lite refactor. Establishes the layered module shape and lands the first tool as the reference template.

• refactor(structure): collapse shell into app / shared / kernel layout.
• feat(kernel): add tool loader contract, Result type, and boundary lint rules.
• feat(base64): implement Base64 as the reference module (domain / ui / store / view-model seam).

Architecture

• app/ — VS Code-style shell + global state.
• shared/kernel/ — registry.ts (tool catalog + loader contract), result.ts (Result type).
• modules/<tool>/ — self-contained tool; base64 is the reference template.
• Boundary rules lint-enforced: domain stays pure (no React/IO), modules reachable only through their barrel.

Test plan

• vp check (format + lint + typecheck)
• vp test

🤖 Generated with Claude Code

Summary by CodeRabbit

Release Notes

• New Features

  • Base64 encoding and decoding tool with toggleable URL-safe format option for flexible text transformation
  • Lazy loading system for tools enabling efficient on-demand module instantiation

• Tests

  • Comprehensive test coverage for Base64 operations including UTF-8 multibyte characters, URL-safe formatting, whitespace handling, and error scenarios

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	devbox	918675d	Commit Preview URL Branch Preview URL	Jun 02 2026, 06:35 AM

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

This PR adds a complete Base64 encoding/decoding tool module and establishes lazy-loaded tool architecture. It introduces shared domain logic patterns via a Result type, implements Zustand state persistence with IndexedDB, and reorganizes imports under @/shared paths while enforcing module boundaries through ESLint rules.

Changes

Base64 Tool and Lazy-Loaded Tool System

Layer / File(s)	Summary
Shared kernel abstractions src/shared/kernel/result.ts, src/shared/lib/storage/idb-zustand.ts	Result<T> with DomainError, success/failure constructors, and IndexedDB-backed Zustand StateStorage adapter.
Tool registry with lazy-load support src/shared/kernel/registry.ts	ToolModule contract added; ToolDefinition extended with optional async loader() function; base64 tool includes dynamic module loader.
Base64 domain logic and tests src/modules/base64/domain/base64.ts, src/modules/base64/domain/base64.test.ts	Pure domain functions encodeBase64, decodeBase64, runBase64 return Result<string>, handle UTF-8 safety via TextEncoder/TextDecoder, support URL-safe mode, and include comprehensive test coverage for encode/decode/round-trip and error cases.
Base64 state and view model src/modules/base64/ui/store.ts, src/modules/base64/ui/use-base64.ts	Zustand store with IndexedDB persistence; useBase64() hook wires store state to domain logic, exposing input, mode, urlSafe toggle, derived output/error, and action setters.
Base64 UI component and barrel src/modules/base64/ui/base64-tool.tsx, src/modules/base64/index.ts	Base64Tool React component with mode selection buttons, URL-safe checkbox, editable input textarea, read-only output, and error display; module barrel exports default component.
Route-level lazy loading and Suspense src/routes/tool.$toolId.tsx	Tool route derives tool.loader, creates lazy component via React.lazy(), renders inside Suspense with ToolLoading fallback; falls back to "Not implemented yet" when loader is absent.
App shell and route integration src/routes/__root.tsx, src/app/shell/app-shell.tsx, src/app/shell/command-palette.tsx, src/app/shell/shortcuts-cheatsheet.tsx, src/app/stores/use-settings-store.ts	Updated imports for shell stores, registry utilities, and hotkeys constants to use new @/app, @/shared, and @/shared/kernel paths.
Path aliases and lint architecture rules components.json, vite.config.ts	Alias targets moved from @/components, @/lib, @/hooks to @/shared/* locations; ESLint rules added to enforce barrel-only imports for @/modules/* and restrict **/domain/** files to pure logic without React/app/storage dependencies.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Possibly related PRs

• rivodotlove/devbox#5: Introduces the hotkeys/constants and shell store infrastructure that this PR reorganizes under new @/shared/@/app paths and extends with lazy-loading support.

Poem

🐰 A Base64 bundle hops into the fold,
With lazy lanes and domains of gold—
Result types catch what might slip away,
While ESLint guards the code's new way! ✨

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 42.86% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title directly summarizes the PR's main changes: a DDD-lite refactor reorganizing the project structure (shell layout) and adding foundational infrastructure (kernel contracts) and a reference tool (base64 module).
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch refactor/ddd-lite-step1-shell

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}