@cruxgarden/cli 0.0.1 → 0.0.3

package/.nvmrc

@@ -1 +1 @@
-22.13.1
+22.19.0

package/README.md

@@ -1,6 +1,13 @@
-# Crux Garden CLI
+<div align="center">
+  <img src=".github/banner.jpg" alt="Crux Garden - Where Ideas Grow" width="100%">
+  <p>
+    <a href="https://github.com/CruxGarden/cli/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
+    <a href="https://github.com/CruxGarden/cli/issues"><img src="https://img.shields.io/github/issues/CruxGarden/cli" alt="Issues"></a>
+    <a href="https://github.com/CruxGarden/cli/stargazers"><img src="https://img.shields.io/github/stars/CruxGarden/cli" alt="Stars"></a>
+  </p>
+</div>
 
-CLI tool to manage the Crux Garden Nursery environment with Docker.
+The Crux Garden CLI tool helps manage the Crux Garden Nursery environment with Docker.
 
 The **Nursery** is a production-like demo environment with sample data, perfect for trials, demos, and showcasing features.
 
@@ -55,7 +62,7 @@ Start the Nursery environment:
 crux nursery start
 ```
 
-The API will be available at `http://localhost:3001` with demo data loaded.
+The API will be available at `http://localhost:3000` with demo data loaded.
 
 View logs:
 
@@ -144,6 +151,20 @@ Stop and remove all Nursery containers and volumes. **Warning: This deletes all
 crux nursery clean
 ```
 
+### `crux nursery purge`
+
+Stop and remove ALL Nursery resources including containers, volumes, AND images. **Warning: This deletes everything including downloaded images! You'll need to re-download images on next start.**
+
+```bash
+crux nursery purge
+```
+
+This is more aggressive than `clean` - it removes Docker images too, which means:
+
+- Frees up more disk space
+- Requires re-downloading images (~100-500MB) on next start
+- Useful when you want to completely remove all traces of the Nursery
+
 ### `crux nursery db start`
 
 Start only Nursery database services (PostgreSQL and Redis).
@@ -201,9 +222,9 @@ The Nursery is a production-like demo environment that:
 
 **Services:**
 
-- **API**: `http://localhost:3001` - Crux Garden API (published image with demo data)
-- **PostgreSQL**: `localhost:5433` - Database
-- **Redis**: `localhost:6380` - Cache
+- **API**: `http://localhost:3000` - Crux Garden API (published image with demo data)
+- **PostgreSQL**: `localhost:5432` - Database
+- **Redis**: `localhost:6379` - Cache
 
 ## Environment Variables
 
@@ -222,7 +243,7 @@ FROM_EMAIL_ADDRESS=demo@example.com
 # Optional overrides
 CORS_ORIGIN=*
 LOG_LEVEL=info
-PORT=3001
+PORT=3000
 ```
 
 ## Common Workflows
@@ -235,7 +256,7 @@ Use the Nursery environment for demos, trials, or showcasing features:
 # First time setup - pulls image and starts with demo data
 crux nursery start
 
-# View the demo at http://localhost:3001
+# View the demo at http://localhost:3000
 
 # Stop (keeps data for next demo)
 crux nursery stop
@@ -287,9 +308,9 @@ If you get an error about ports being in use, stop any existing services:
 
 ```bash
 # Check what's using the ports
-lsof -i :3001  # Nursery API
-lsof -i :5433  # Nursery PostgreSQL
-lsof -i :6380  # Nursery Redis
+lsof -i :3000  # Nursery API
+lsof -i :5432  # Nursery PostgreSQL
+lsof -i :6379  # Nursery Redis
 
 # Stop the Nursery
 crux nursery stop

package/bin/crux.js

@@ -1,5 +1,8 @@
 #!/usr/bin/env node
 import { program } from "commander";
+import { readFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
 import {
   showBanner,
   startNursery,
@@ -8,6 +11,7 @@ import {
   statusNursery,
   logsNursery,
   cleanNursery,
+  purgeNursery,
   pullNursery,
   resetNursery,
   connectNurseryDb,
@@ -16,10 +20,16 @@ import {
   stopNurseryDb,
 } from "../lib/commands.js";
 
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(
+  readFileSync(join(__dirname, "..", "package.json"), "utf-8"),
+);
+
 program
   .name("crux")
-  .description("Crux Garden CLI - Nursery Environment Manager")
-  .version("0.1.0");
+  .description("Crux Garden CLI")
+  .version(packageJson.version);
 
 // Nursery environment commands
 const nursery = program
@@ -28,7 +38,7 @@ const nursery = program
 
 nursery
   .command("start")
-  .description("Start the Nursery environment (postgres, redis, api)")
+  .description("Start the Nursery environment (api, postgres, redis)")
   .option("--db-only", "Start only database services (postgres, redis)")
   .option("--no-banner", "Hide the startup banner")
   .action((options) => {
@@ -62,6 +72,13 @@ nursery
   .description("Stop and remove all Nursery containers and volumes")
   .action(cleanNursery);
 
+nursery
+  .command("purge")
+  .description(
+    "Stop and remove ALL Nursery resources (containers, volumes, AND images)",
+  )
+  .action(purgeNursery);
+
 nursery
   .command("pull")
   .description("Pull the latest API image from ghcr.io")

package/docker/docker-compose.nursery.yml

@@ -4,17 +4,19 @@
 # Perfect for: demos, trials, showcasing features, onboarding
 # Usage: npm run docker:nursery
 
+name: cruxgarden-nursery
+
 services:
   # PostgreSQL Database
   postgres:
     image: postgres:16-alpine
-    container_name: cruxgarden-postgres-nursery
+    container_name: cruxgarden-nursery-postgres
     environment:
       POSTGRES_DB: cruxgarden
       POSTGRES_USER: cruxgarden
       POSTGRES_PASSWORD: cruxgarden_nursery_password
     ports:
-      - "5433:5432"
+      - "5432:5432"
     volumes:
       - postgres_data_nursery:/var/lib/postgresql/data
     healthcheck:
@@ -26,10 +28,10 @@ services:
   # Redis Cache
   redis:
     image: redis:7-alpine
-    container_name: cruxgarden-redis-nursery
+    container_name: cruxgarden-nursery-redis
     command: redis-server --appendonly yes
     ports:
-      - "6380:6379"
+      - "6379:6379"
     volumes:
       - redis_data_nursery:/data
     healthcheck:
@@ -41,7 +43,7 @@ services:
   # Database Migrations (runs once before API starts)
   migrations:
     image: ghcr.io/cruxgarden/api:latest
-    container_name: cruxgarden-migrations-nursery
+    container_name: cruxgarden-nursery-migrations
     depends_on:
       postgres:
         condition: service_healthy
@@ -54,7 +56,7 @@ services:
   # Crux Garden API - Nursery Configuration
   api:
     image: ghcr.io/cruxgarden/api:latest
-    container_name: cruxgarden-api-nursery
+    container_name: cruxgarden-nursery-api
     restart: unless-stopped
     depends_on:
       migrations:
@@ -62,7 +64,7 @@ services:
       redis:
         condition: service_healthy
     ports:
-      - "${PORT:-3001}:3000"
+      - "${PORT:-3000}:3000"
     environment:
       # Application
       NODE_ENV: production

package/lib/commands.js

@@ -56,6 +56,53 @@ function runCommand(command, options = {}) {
   }
 }
 
+function runCommandAsync(command, options = {}) {
+  return new Promise((resolve, reject) => {
+    const [cmd, ...args] = command.split(/\s+/);
+    const child = spawn(cmd, args, {
+      cwd: dockerDir,
+      stdio: options.silent ? "pipe" : "inherit",
+      shell: true,
+      ...options,
+    });
+
+    let stdout = "";
+    let stderr = "";
+
+    if (options.silent) {
+      if (child.stdout) {
+        child.stdout.on("data", (data) => {
+          stdout += data.toString();
+        });
+      }
+      if (child.stderr) {
+        child.stderr.on("data", (data) => {
+          stderr += data.toString();
+        });
+      }
+    }
+
+    child.on("close", (code) => {
+      if (code !== 0 && !options.ignoreError) {
+        const error = new Error(
+          stderr || `Command failed with exit code ${code}`,
+        );
+        reject(error);
+      } else {
+        resolve(stdout);
+      }
+    });
+
+    child.on("error", (error) => {
+      if (!options.ignoreError) {
+        reject(error);
+      } else {
+        resolve(null);
+      }
+    });
+  });
+}
+
 function askConfirmation(question) {
   return new Promise((resolve) => {
     const rl = readline.createInterface({
@@ -80,23 +127,42 @@ export async function startNursery(options) {
   try {
     if (options.dbOnly) {
       spinner.text = "Starting nursery database services (postgres, redis)...";
-      runCommand(
-        "docker-compose -f docker-compose.nursery.yml up -d postgres redis",
+      await runCommandAsync(
+        "docker-compose -f docker-compose.nursery.yml up -d --remove-orphans postgres redis",
         { silent: true },
       );
       spinner.succeed("Nursery database services started!");
-      console.log(chalk.hex(SUCCESS_GREEN)("\n✓ PostgreSQL running on:"), "localhost:5433");
-      console.log(chalk.hex(SUCCESS_GREEN)("✓ Redis running on:"), "localhost:6380");
+      console.log(
+        chalk.hex(SUCCESS_GREEN)("\n✓ PostgreSQL running on:"),
+        "localhost:5432",
+      );
+      console.log(
+        chalk.hex(SUCCESS_GREEN)("✓ Redis running on:"),
+        "localhost:6379",
+      );
     } else {
       spinner.text =
-        "Starting nursery services (postgres, redis, migrations, api)...";
-      runCommand("docker-compose -f docker-compose.nursery.yml up -d", {
-        silent: true,
-      });
+        "Starting nursery services (api, postgres, redis)...";
+      await runCommandAsync(
+        "docker-compose -f docker-compose.nursery.yml up -d --remove-orphans && docker rm cruxgarden-nursery-migrations 2>/dev/null || true",
+        {
+          silent: true,
+        },
+      );
+
       spinner.succeed("Crux Garden Nursery environment started!");
-      console.log(chalk.hex(SUCCESS_GREEN)("\n✓ API running on:"), "http://localhost:3001");
-      console.log(chalk.hex(SUCCESS_GREEN)("✓ PostgreSQL running on:"), "localhost:5433");
-      console.log(chalk.hex(SUCCESS_GREEN)("✓ Redis running on:"), "localhost:6380");
+      console.log(
+        chalk.hex(SUCCESS_GREEN)("\n✓ API running on:"),
+        "http://localhost:3000",
+      );
+      console.log(
+        chalk.hex(SUCCESS_GREEN)("✓ PostgreSQL running on:"),
+        "localhost:5432",
+      );
+      console.log(
+        chalk.hex(SUCCESS_GREEN)("✓ Redis running on:"),
+        "localhost:6379",
+      );
       console.log(
         chalk.yellow(
           "\nℹ Nursery includes demo data for trials and showcases",
@@ -109,6 +175,11 @@ export async function startNursery(options) {
       chalk.cyan("crux nursery logs"),
       chalk.gray("to view logs"),
     );
+    console.log(
+      chalk.gray("Run"),
+      chalk.cyan("crux nursery api connect"),
+      chalk.gray("to shell into the API container"),
+    );
     console.log(
       chalk.gray("Run"),
       chalk.cyan("crux nursery db connect"),
@@ -119,11 +190,6 @@ export async function startNursery(options) {
       chalk.cyan("crux nursery redis connect"),
       chalk.gray("to connect to Redis"),
     );
-    console.log(
-      chalk.gray("Run"),
-      chalk.cyan("crux nursery api connect"),
-      chalk.gray("to shell into the API container"),
-    );
   } catch (error) {
     spinner.fail("Failed to start nursery services");
     throw error;
@@ -132,7 +198,7 @@ export async function startNursery(options) {
 
 export async function stopNursery() {
   const spinner = ora("Stopping Crux Garden Nursery environment...").start();
-  runCommand("docker-compose -f docker-compose.nursery.yml down", {
+  await runCommandAsync("docker-compose -f docker-compose.nursery.yml down", {
     silent: true,
   });
   spinner.succeed("Crux Garden Nursery environment stopped!");
@@ -186,10 +252,13 @@ export async function cleanNursery() {
     "Cleaning up nursery (removing containers and volumes)...",
   ).start();
 
-  runCommand("docker-compose -f docker-compose.nursery.yml down -v", {
-    silent: true,
-    ignoreError: true,
-  });
+  await runCommandAsync(
+    "docker-compose -f docker-compose.nursery.yml down -v",
+    {
+      silent: true,
+      ignoreError: true,
+    },
+  );
 
   spinner.succeed("Nursery cleanup complete!");
   console.log(
@@ -199,12 +268,54 @@ export async function cleanNursery() {
   );
 }
 
+export async function purgeNursery() {
+  console.log(
+    chalk.yellow(
+      "\n⚠️  This will delete ALL nursery resources (containers, volumes, AND images)!\n",
+    ),
+  );
+  console.log(
+    chalk.yellow(
+      "You will need to re-download images on next start (may take several minutes).\n",
+    ),
+  );
+
+  const confirmed = await askConfirmation(
+    chalk.red("Are you sure you want to continue? (y/N): "),
+  );
+
+  if (!confirmed) {
+    console.log(chalk.gray("\nPurge cancelled."));
+    return;
+  }
+
+  const spinner = ora(
+    "Purging nursery (removing containers, volumes, and images)...",
+  ).start();
+
+  await runCommandAsync(
+    "docker-compose -f docker-compose.nursery.yml down -v --rmi all",
+    {
+      silent: true,
+      ignoreError: true,
+    },
+  );
+
+  spinner.succeed("Nursery purge complete!");
+  console.log(chalk.gray("\nAll nursery resources have been removed."));
+  console.log(
+    chalk.gray("Run"),
+    chalk.cyan("crux nursery start"),
+    chalk.gray("to download images and start fresh."),
+  );
+}
+
 export async function pullNursery() {
   const spinner = ora(
     "Pulling latest Crux Garden API image from ghcr.io...",
   ).start();
 
-  runCommand("docker-compose -f docker-compose.nursery.yml pull", {
+  await runCommandAsync("docker-compose -f docker-compose.nursery.yml pull", {
     silent: true,
   });
 
@@ -237,27 +348,42 @@ export async function resetNursery() {
   try {
     // Stop and remove volumes
     spinner.text = "Stopping and removing containers/volumes...";
-    runCommand("docker-compose -f docker-compose.nursery.yml down -v", {
-      silent: true,
-      ignoreError: true,
-    });
+    await runCommandAsync(
+      "docker-compose -f docker-compose.nursery.yml down -v",
+      {
+        silent: true,
+        ignoreError: true,
+      },
+    );
 
     // Pull latest image
     spinner.text = "Pulling latest image...";
-    runCommand("docker-compose -f docker-compose.nursery.yml pull", {
+    await runCommandAsync("docker-compose -f docker-compose.nursery.yml pull", {
       silent: true,
     });
 
     // Start fresh
     spinner.text = "Starting fresh nursery environment...";
-    runCommand("docker-compose -f docker-compose.nursery.yml up -d", {
-      silent: true,
-    });
+    await runCommandAsync(
+      "docker-compose -f docker-compose.nursery.yml up -d --remove-orphans && docker rm cruxgarden-nursery-migrations 2>/dev/null || true",
+      {
+        silent: true,
+      },
+    );
 
     spinner.succeed("Nursery environment reset complete!");
-    console.log(chalk.hex(SUCCESS_GREEN)("\n✓ API running on:"), "http://localhost:3001");
-    console.log(chalk.hex(SUCCESS_GREEN)("✓ PostgreSQL running on:"), "localhost:5433");
-    console.log(chalk.hex(SUCCESS_GREEN)("✓ Redis running on:"), "localhost:6380");
+    console.log(
+      chalk.hex(SUCCESS_GREEN)("\n✓ API running on:"),
+      "http://localhost:3000",
+    );
+    console.log(
+      chalk.hex(SUCCESS_GREEN)("✓ PostgreSQL running on:"),
+      "localhost:5432",
+    );
+    console.log(
+      chalk.hex(SUCCESS_GREEN)("✓ Redis running on:"),
+      "localhost:6379",
+    );
     console.log(
       chalk.yellow("\nℹ Fresh nursery with latest demo data loaded"),
     );
@@ -280,23 +406,23 @@ export async function statusNursery() {
 export async function connectNurseryDb() {
   console.log(chalk.gray("Connecting to Nursery PostgreSQL...\n"));
   runCommand(
-    "docker exec -it cruxgarden-postgres-nursery psql -U cruxgarden -d cruxgarden",
+    "docker exec -it cruxgarden-nursery-postgres psql -U cruxgarden -d cruxgarden",
   );
 }
 
 export async function connectNurseryRedis() {
   console.log(chalk.gray("Connecting to Nursery Redis...\n"));
-  runCommand("docker exec -it cruxgarden-redis-nursery redis-cli");
+  runCommand("docker exec -it cruxgarden-nursery-redis redis-cli");
 }
 
 export async function connectNurseryApi() {
   console.log(chalk.gray("Opening shell in Nursery API container...\n"));
-  runCommand("docker exec -it cruxgarden-api-nursery sh");
+  runCommand("docker exec -it cruxgarden-nursery-api sh");
 }
 
 export async function stopNurseryDb() {
   const spinner = ora("Stopping nursery database services...").start();
-  runCommand(
+  await runCommandAsync(
     "docker-compose -f docker-compose.nursery.yml stop postgres redis",
     { silent: true },
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cruxgarden/cli",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Crux Garden CLI",
   "type": "module",
   "bin": {
@@ -17,9 +17,9 @@
     "docker:nursery:reset": "cd docker && docker-compose -f docker-compose.nursery.yml down -v && docker-compose -f docker-compose.nursery.yml pull && docker-compose -f docker-compose.nursery.yml up -d",
     "docker:nursery:db": "cd docker && docker-compose -f docker-compose.nursery.yml up -d postgres redis",
     "docker:nursery:db:stop": "cd docker && docker-compose -f docker-compose.nursery.yml stop postgres redis",
-    "docker:nursery:redis:connect": "docker exec -it cruxgarden-redis-nursery redis-cli",
-    "docker:nursery:db:connect": "docker exec -it cruxgarden-postgres-nursery psql -U cruxgarden -d cruxgarden",
-    "docker:nursery:api:connect": "docker exec -it cruxgarden-api-nursery sh"
+    "docker:nursery:redis:connect": "docker exec -it cruxgarden-nursery-redis redis-cli",
+    "docker:nursery:db:connect": "docker exec -it cruxgarden-nursery-postgres psql -U cruxgarden -d cruxgarden",
+    "docker:nursery:api:connect": "docker exec -it cruxgarden-nursery-api sh"
   },
   "engines": {
     "node": ">=18.0.0"