@cruxgarden/cli 0.0.10 → 0.0.11

package/README.md

@@ -2,6 +2,27 @@
   <img src=".github/banner.jpg" alt="Crux Garden - Where Ideas Grow" width="100%">
 </div>
 
+## What is Crux Garden?
+
+Crux Garden is a model of how ideas manifest and develop over time. The heart of the model is the **Crux**, an atomic representation of an idea. In our implementation, a Crux can be text, media, code, or any digital content worth preserving. But Cruxes, just like ideas, don't exist in isolation. Ideas have origins. They lead to new ideas. They evolve. And often, they randomly connect. So it is with Cruxes. In Crux Garden, there are four types of relationships Cruxes can have with each other. These are called **Dimensions**:
+
+- **GATES** — Cruxes which influenced or inspired a Crux; its origins and sources.
+- **GARDENS** — Cruxes which emerged or grew from a Crux, its creations and consequences.
+- **GROWTH** — How a Crux developed over time, its transformation and refinement.
+- **GRAFTS** — Cruxes which connect to a Crux laterally, its associations and resonances.
+
+These four Dimensions capture the fundamental ways that Cruxes, or ideas, relate to one another.
+
+The power of a system that models ideas at such a primitive scale is that literally any idea or framework of ideas can be realized inside Crux Garden: interactive fiction with evolving storylines, personal knowledge bases connecting insights across domains, product development roadmaps linking requirements to releases, research systems tracking citations and discoveries, or anything else where ideas have origins, consequences, transformation, and connection.
+
+Along with Cruxes and Dimensions, there are several other types including Tags, Themes, and Paths. See the database schema in `db/schema.sql` or the API documentation at `/docs` for details.
+
+For further reading on the goals and ambitions of Crux Garden, explore the history of the [Digital Garden](https://maggieappleton.com/garden-history) movement and the 1945 essay [As We May Think](https://en.wikipedia.org/wiki/As_We_May_Think) by Vannevar Bush.
+
+Will Stepp, October 2025
+
+## CLI
+
 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.

package/docker/docker-compose.nursery.yml

@@ -77,6 +77,7 @@ services:
 
       # Security
       JWT_SECRET: ${JWT_SECRET:-your-super-secret-jwt-key-min-32-chars-for-development-only}
+      NURSERY_MODE: ${NURSERY_MODE:-true}
 
       # AWS SES (optional for nursery)
       AWS_ACCESS_KEY_ID: ${AWS_ACCESS_KEY_ID:-dummy}

package/lib/commands.js

@@ -196,6 +196,9 @@ function parseAndSetEnvVars(envArgs = []) {
 export async function startNursery(options, envVars) {
   ensureDockerRunning();
 
+  // Ensure NURSERY_MODE is always set to true for nursery environment
+  process.env.NURSERY_MODE = 'true';
+
   // Parse and set environment variables from command line
   if (envVars && envVars.length > 0) {
     console.log(chalk.cyan("\nApplying environment variables:"));
@@ -536,6 +539,9 @@ export async function resetNursery(envVars) {
     return;
   }
 
+  // Ensure NURSERY_MODE is always set to true for nursery environment
+  process.env.NURSERY_MODE = 'true';
+
   // Parse and set environment variables from command line
   if (envVars && envVars.length > 0) {
     console.log(chalk.cyan("\nApplying environment variables:"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cruxgarden/cli",
-  "version": "0.0.10",
+  "version": "0.0.11",
   "description": "Crux Garden CLI",
   "type": "module",
   "bin": {