feat(cli): add elide db studio command

.gitignore

@@ -4,6 +4,7 @@
 .dev/dependencies
 .dev/coverage
 .dev/artifacts
+.dev/db-studio
 */.dev/artifacts
 */.dev/coverage
 */.dev/dependencies

packages/cli/build.gradle.kts

@@ -2414,7 +2414,7 @@ tasks {
   val allSamples = layout.projectDirectory.dir("src/projects")
     .asFile
     .listFiles()
-    .filter { it.isDirectory() }
+    .filter { it.isDirectory() && it.name != "db-studio" }
     .map { it.toPath() to it.name }
 
   val builtSamples = layout.buildDirectory.dir("packed-samples")
@@ -2436,10 +2436,30 @@ tasks {
     dependsOn(allSamplePackTasks)
   }
 
+  val prepareDbStudioResources by registering(Copy::class) {
+    group = "build"
+    description = "Prepare Database Studio resources for embedding in CLI"
+
+    from(layout.projectDirectory.dir("src/db-studio/api")) {
+      into("api")
+      exclude("config.ts")        // Generated at runtime with injected config
+      exclude(".dev/**")          // Exclude development-only dependencies directory
+      exclude("node_modules/**")  // Dependencies installed at runtime
+    }
+
+    // Copy built UI (dist/ folder only, not source or node_modules)
+    from(layout.projectDirectory.dir("src/db-studio/ui/dist")) {
+      into("ui")
+    }
+
+    into(layout.buildDirectory.dir("resources/main/META-INF/elide/db-studio"))
+  }
+
   processResources {
     dependsOn(
       ":packages:graalvm:buildRustNativesForHostDebug",
       prepKotlinResources,
+      prepareDbStudioResources,
       packSamples,
       allSamplePackTasks,
     )

packages/cli/src/db-studio/README.md

@@ -0,0 +1,44 @@
+# Database Studio
+
+Web-based database management UI that runs on the Elide runtime. At the moment it only supports SQLite with Elide's `elide:sqlite` js bindings. We assume that an existing valid database file exists for the `elide db studio` command to find. If you need a database file to run this on, [Northwind](https://github.com/jpwhite3/northwind-SQLite3) and [Chinook](https://github.com/lerocha/chinook-database/releases) are some good prepopulated examples.
+
+## Directory Structure
+
+```
+db-studio/
+├── api/              # TypeScript REST API server
+│   ├── ...
+│   ├── index.ts      # Server entrypoint
+│   └── elide.pkl
+└── ui/               # React frontend application
+    ├── src/
+    └── dist/         # Vite production build
+```
+
+## Running Locally
+
+### Using the Gradle Command
+
+The best way to run this locally is through the CLI in JVM mode. Simply passing `db studio` as args.
+
+**Note:** In order to see UI changes you've made, you'll need to run `pnpm build` in the `ui/` directory first.
+
+```bash
+# Build the UI
+cd packages/cli/src/db-studio/ui
+pnpm build
+
+# Go back to the elide repo root
+# Then run the db studio command
+./gradlew :packages:cli:run --args="db studio"
+
+# With a specific database
+./gradlew :packages:cli:run --args="db studio path/to/database.db"
+```
+
+### Running api or ui independently
+
+Database Studio consists of two separate projects that can be run independently:
+
+- `api`: run directly by calling `elide run index.ts` within the directory.
+- `ui`: using `pnpm dev` within the directory.

packages/cli/src/db-studio/api/.dev/dependencies/npm/package-lock.kdl

@@ -0,0 +1 @@
+/Users/francis/code/millpointlabs/elide/elide/packages/cli/src/db-studio/api/package-lock.kdl

packages/cli/src/db-studio/api/.dev/dependencies/npm/package.json

@@ -0,0 +1,13 @@
+{
+    "name": "db-studio-api",
+    "version": "1.0.0",
+    "description": "Database Studio API Server",
+    "main": "index.ts",
+    "scripts": {},
+    "dependencies": {
+        "zod": "4"
+    },
+    "devDependencies": {
+        "@elide-dev/types": "1.0.0-beta10"
+    }
+}

packages/cli/src/db-studio/api/config.ts

@@ -0,0 +1,22 @@
+import type { DiscoveredDatabase } from "./database.ts";
+
+/**
+ * Database Studio Configuration
+ *
+ * This is a sample configuration file. In production, this would be
+ * generated by DbStudioCommand.kt based on discovered databases.
+ */
+
+const config = {
+  port: 4984,
+  databases: [
+    {
+      path: "./sample.db",
+      name: "sample.db",
+      size: 0,
+      lastModified: Date.now(),
+    }
+  ] as DiscoveredDatabase[],
+};
+
+export default config;