trucontext 0.7.0 → 0.7.1

package/README.md

@@ -17,17 +17,20 @@ That's it. No API keys to copy, no config files to edit. Browser-based OAuth, th
 ## The 30-Second Version
 
 ```bash
-# Create an entity for the person your agent works with
-npx trucontext entities create --id dustin --type Person \
-  --properties '{"name": "Dustin", "role": "founder"}' \
-  --recipe recipe:personal-assistant-memory
+# Create a root node — the intelligence boundary for your agent's memory
+npx trucontext roots create --id dustin --type Person \
+  --recipe recipe:personal-assistant-memory \
+  --properties '{"name": "Dustin", "role": "founder"}'
+
+# Set it as the active root for queries
+npx trucontext roots use dustin
 
 # Ingest what your agent learned
 npx trucontext ingest "Dustin prefers async communication and dark mode. \
   He values clean code over backwards compatibility." \
   --context dustin:ABOUT --confidence 0.85 --temporal
 
-# Ask an intelligent question
+# Ask an intelligent question (scoped to the root's ego network)
 npx trucontext query "What does Dustin prefer?"
 ```
 
@@ -135,28 +138,35 @@ Observe → Capture → Sleep → Wake → Query → Observe → ...
 ### Apps
 | Command | Description |
 |---------|-------------|
-| `init [name]` | Create a new app with AI-generated schema |
+| `init [name]` | Create a new app with schema + root node |
 | `apps` | List your apps |
 | `use <app>` | Set the active app |
 
+### Root Nodes
+| Command | Description |
+|---------|-------------|
+| `roots create` | Create a root node with recipe and dreamers |
+| `roots list` | List all root nodes |
+| `roots show <id>` | Show root node details and linked roots |
+| `roots update <id>` | Update recipe, dreamers, or properties |
+| `roots delete <id>` | Demote to regular entity |
+| `roots use <id>` | Set active root for queries |
+
 ### Data
 | Command | Description |
 |---------|-------------|
-| `ingest <source>` | Ingest text or file with confidence, temporal, and context linking |
-| `query <question>` | Query the intelligent knowledge graph |
-| `recall <query>` | Semantic memory recall with graph expansion |
+| `ingest <source>` | Ingest text or file (requires `--context`) |
+| `query <question>` | Query the graph (requires active root or `--root`) |
+| `recall <query>` | Semantic recall (requires active root or `--root`) |
 
-### Structure
+### Entities
 | Command | Description |
 |---------|-------------|
 | `entities list` | List entities |
-| `entities create` | Create entity with recipe, confidence, temporal, contexts |
+| `entities create` | Create entity (requires `--context`) |
 | `entities get <id>` | Get entity details |
-| `entities update <id>` | Update entity properties, recipe, heartbeat settings |
+| `entities update <id>` | Update properties, recipe, heartbeat |
 | `entities delete <id>` | Delete entity |
-| `contexts list` | List contexts |
-| `contexts create <name>` | Create a scoping context |
-| `contexts delete <id>` | Delete context |
 
 ### Intelligence
 | Command | Description |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trucontext",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "TruContext CLI — contextual memory for AI applications",
   "type": "module",
   "bin": {

package/src/commands/roots.js

@@ -20,7 +20,7 @@ export function registerRootsCommand(program) {
     .requiredOption('--id <entityId>', 'Unique identifier for the root node')
     .requiredOption('--type <type>', 'Node type (e.g., Person, Agent, Organization)')
     .requiredOption('--recipe <recipeId>', 'Recipe ID (e.g., recipe:personal-assistant-memory)')
-    .option('--dreamers <list>', 'Dreamers: "all" or comma-separated (e.g., decay,curiosity)', 'all')
+    .option('--dreamers <list>', 'Dreamers: "all" or comma-separated. Valid: decay, concepts, people, primitives, curiosity, entity-linking, consolidation, fitness', 'all')
     .option('--hop-depth <n>', 'Max traversal depth for ego network (default: unlimited)', parseInt)
     .option('--do-not-follow', 'Mark as structural root — do not traverse into from other roots')
     .option('--properties <json>', 'JSON properties object')
@@ -128,7 +128,7 @@ export function registerRootsCommand(program) {
     .command('update <rootId>')
     .description('Update a root node')
     .option('--recipe <recipeId>', 'New recipe ID')
-    .option('--dreamers <list>', 'New dreamers: "all" or comma-separated')
+    .option('--dreamers <list>', 'New dreamers: "all" or comma-separated. Valid: decay, concepts, people, primitives, curiosity, entity-linking, consolidation, fitness')
     .option('--hop-depth <n>', 'New hop depth', parseInt)
     .option('--do-not-follow', 'Set do-not-follow flag')
     .option('--no-do-not-follow', 'Clear do-not-follow flag')