feat: improve cli dx

[calvinbrewer]

Summary by CodeRabbit

• New Features

  • Auto-detection of encryption client files during setup
  • Interactive schema builder for encrypted tables
  • Support for multiple database providers (Supabase, Neon, Vercel Postgres, PlanetScale, AWS RDS)

• Improvements

  • Renamed CLI init command to setup for clearer intent
  • Streamlined project initialization workflow with simplified configuration
  • New setup flags for provider-specific installations

• Documentation

  • Updated CLI references and guides to reflect new setup command and workflows

[changeset-bot]

🦋 Changeset detected

Latest commit: 2b907a1

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@cipherstash/basic-example	Minor
@cipherstash/stack	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 9c04bec2-0d4e-446e-805b-97d05d64f3d7

📥 Commits

Reviewing files that changed from the base of the PR and between b67bb98 and 2b907a1.

📒 Files selected for processing (22)

• .changeset/eager-cougars-watch.md
• examples/basic/src/encryption/index.ts
• packages/stack-forge/README.md
• packages/stack-forge/src/bin/stash-forge.ts
• packages/stack-forge/src/commands/index.ts
• packages/stack-forge/src/commands/init.ts
• packages/stack/README.md
• packages/stack/src/bin/commands/init/index.ts
• packages/stack/src/bin/commands/init/providers/base.ts
• packages/stack/src/bin/commands/init/providers/supabase.ts
• packages/stack/src/bin/commands/init/steps/authenticate.ts
• packages/stack/src/bin/commands/init/steps/build-schema.ts
• packages/stack/src/bin/commands/init/steps/detect-database-url.ts
• packages/stack/src/bin/commands/init/steps/install-eql.ts
• packages/stack/src/bin/commands/init/steps/install-forge.ts
• packages/stack/src/bin/commands/init/steps/select-connection.ts
• packages/stack/src/bin/commands/init/steps/select-region.ts
• packages/stack/src/bin/commands/init/steps/select-workspace.ts
• packages/stack/src/bin/commands/init/stubs.ts
• packages/stack/src/bin/commands/init/types.ts
• packages/stack/src/bin/commands/init/utils.ts
• skills/stash-forge/SKILL.md

---

📝 Walkthrough

Walkthrough

This PR refactors the CLI initialization experience across stack-forge and stack packages by renaming the init command to setup, introducing auto-detection of encryption client files, and replacing device-code authentication with a streamlined schema building and package installation workflow. The basic example project updates table definitions from helloTable to usersTable with refined encryption configurations.

Changes

Cohort / File(s)	Summary
Example Project Updates examples/basic/src/encryption/index.ts	Replaces helloTable with usersTable containing an email column with equality, orderAndRange, and freeTextSearch encryption operations.
Stack-Forge CLI Command Refactor packages/stack-forge/src/bin/stash-forge.ts, packages/stack-forge/src/commands/index.ts, packages/stack-forge/src/commands/init.ts	Renames init command to setup with expanded configuration options. Introduces SetupOptions interface and new utilities: detectClientPath, resolveClientPath, generateConfig, setupCommand, resolveInstallOptions, and DatabaseProvider type. Removes interactive schema building and authentication logic.
Stack Init Flow Restructuring packages/stack/src/bin/commands/init/index.ts, packages/stack/src/bin/commands/init/providers/base.ts, packages/stack/src/bin/commands/init/providers/supabase.ts	Replaces authentication and workspace selection steps with new buildSchemaStep and installForgeStep. Simplifies setup guidance and removes conditional ORM-specific branches.
Init Step Removals packages/stack/src/bin/commands/init/steps/authenticate.ts, packages/stack/src/bin/commands/init/steps/detect-database-url.ts, packages/stack/src/bin/commands/init/steps/install-eql.ts, packages/stack/src/bin/commands/init/steps/select-region.ts, packages/stack/src/bin/commands/init/steps/select-workspace.ts, packages/stack/src/bin/commands/init/stubs.ts	Removes device-code authentication flow, database URL detection, EQL installation, region/workspace selection, and associated mock API stubs.
Init Step Additions packages/stack/src/bin/commands/init/steps/build-schema.ts, packages/stack/src/bin/commands/init/steps/install-forge.ts	Introduces interactive schema building step with dynamic column configuration and new install-forge step for dev dependency installation.
Type and Utility Enhancements packages/stack/src/bin/commands/init/types.ts, packages/stack/src/bin/commands/init/utils.ts, packages/stack/src/bin/commands/init/steps/select-connection.ts	Adds ConnectionMethod, Integration, DataType, SearchOp types and ColumnDef/SchemaDef interfaces. Adds utilities for package manager detection and client code generation. Refines connectionMethod typing.
Documentation Updates packages/stack-forge/README.md, packages/stack/README.md, skills/stash-forge/SKILL.md, .changeset/eager-cougars-watch.md	Updates CLI references from init to setup, documents new setup wizard behavior, expands stash secrets command examples, and adds version bump changelog entry.

Sequence Diagram(s)

sequenceDiagram
    participant User
    participant setupCommand
    participant detectClientPath
    participant resolveClientPath
    participant generateConfig
    participant installCommand

    User->>setupCommand: Invoke setup with options
    activate setupCommand
    
    setupCommand->>detectClientPath: Auto-detect client file
    activate detectClientPath
    detectClientPath-->>setupCommand: Client path or undefined
    deactivate detectClientPath
    
    setupCommand->>resolveClientPath: Confirm or prompt user for path
    activate resolveClientPath
    resolveClientPath->>User: Prompt for client path
    User-->>resolveClientPath: Provide path
    resolveClientPath-->>setupCommand: Resolved client path
    deactivate resolveClientPath
    
    setupCommand->>generateConfig: Generate config with client path
    activate generateConfig
    generateConfig-->>setupCommand: stash.config.ts content
    deactivate generateConfig
    
    setupCommand->>installCommand: Install with resolved options
    activate installCommand
    installCommand->>User: Execute package installation
    User-->>installCommand: Installation complete
    installCommand-->>setupCommand: Installation status
    deactivate installCommand
    
    setupCommand-->>User: Setup complete
    deactivate setupCommand

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~60 minutes

Possibly related PRs

• chore: usability improvements #317 — Modifies stack-forge CLI surface with init/setup command refactoring and flag additions (\-\-latest, \-\-supabase), directly related to setupCommand signature changes.
• feat: add stash forge package #314 — Updates stack-forge package exports and command surfaces; this PR builds upon those changes with the init→setup rename and setupCommand refactoring.
• fix(stack): cli helpers #311 — Modifies packages/stack/src/bin/commands/init/index.ts init command flow, overlapping with the STEPS sequence reorganization in this PR.

Suggested reviewers

• coderdan
• auxesis

Poem

🐰 From init to setup, the path now gleams bright,
Auto-detect client files, no auth delays in sight,
Schema builds interactively, forge installs with ease,
The onboarding wizard makes developers pleased! ✨

✨ Finishing Touches

• 📝 Generate docstrings (stacked PR)
• 📝 Generate docstrings (commit on current branch)

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch cli-dx

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

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