trucontext 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alpha Collective LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/PRIVACY.md

@@ -0,0 +1,119 @@
+# TruContext Privacy Policy
+
+**Effective Date:** March 22, 2026
+**Last Updated:** March 22, 2026
+
+Alpha Collective LLC ("Company," "we," "us," or "our") operates the TruContext platform, APIs, CLI tools, and related services (collectively, the "Service"). This Privacy Policy describes how we collect, use, and protect information when you use the Service.
+
+## 1. Information We Collect
+
+### Account Information
+When you create an account, we collect:
+- Email address (via OAuth through AWS Cognito)
+- Authentication tokens (stored locally on your device, not on our servers)
+
+We do not collect passwords. Authentication is handled entirely through OAuth providers (Google, email-based magic links).
+
+### Your Data (User Content)
+When you use the Service, you may ingest, store, and process:
+- Text content, documents, images, audio, and other files
+- Entities, relationships, and structural data
+- Metadata you provide (author hints, source medium, filenames)
+- Confidence scores, temporal flags, and context relationships
+
+**You own Your Data.** See Section 2.
+
+### Usage Data
+We automatically collect:
+- API request logs (endpoint, method, timestamp, response status)
+- Error logs for debugging and service reliability
+- Aggregate usage metrics (ingest volume, query count, API key usage)
+
+We do not collect or log the content of your API requests or responses in our usage analytics.
+
+### Device and CLI Information
+The CLI tool stores authentication tokens locally at `~/.trucontext/credentials.json` with restricted file permissions (readable only by your user account). We do not collect device identifiers, IP addresses for tracking purposes, or telemetry from the CLI tool.
+
+## 2. How We Use Your Data
+
+### Your Content
+- **To provide the Service:** We process your content through our AI pipeline (extraction, classification, enrichment) solely to operate the features you use.
+- **Within your tenant only:** Your Data is isolated to your tenant. Other users cannot access it. Our systems enforce tenant isolation at every layer.
+- **Not for training:** We do not use Your Data to train, fine-tune, or improve machine learning models — ours or anyone else's — unless you provide separate, explicit written consent.
+- **Not for sale:** We do not sell, rent, or share Your Data with third parties for their commercial purposes.
+
+### Account Information
+- To authenticate your access to the Service
+- To communicate with you about your account, service updates, and security notices
+
+### Usage Data
+- To monitor and improve Service reliability and performance
+- To detect and prevent abuse, fraud, and security threats
+- To generate aggregate, anonymized statistics about Service usage (which cannot be used to identify you or your content)
+
+## 3. Third-Party Services
+
+We use the following third-party services to operate the platform:
+
+| Service | Purpose | Data Shared |
+|---------|---------|-------------|
+| **AWS** (DynamoDB, S3, Lambda, Cognito) | Infrastructure and authentication | Your Data is stored and processed in AWS US regions |
+| **Neo4j Aura** | Graph database | Your Data is stored in the intelligent knowledge graph |
+| **Anthropic** (Claude API) | AI processing pipeline | Content you ingest is sent to Claude for extraction and classification |
+| **Google AI** (Gemini API) | Alternative AI processing | Content may be sent to Gemini if configured by admin |
+| **Stripe** | Payment processing | Email and billing information for paid plans |
+
+When your content is processed by AI providers (Anthropic, Google), it is sent via their APIs under their respective data processing terms. These providers have committed to not training on API inputs. We select providers whose data practices align with our commitment to your privacy.
+
+## 4. Data Retention
+
+- **Your Data:** Retained as long as your account is active. Upon account termination, you may request data export within 30 days. After 30 days, Your Data may be permanently deleted.
+- **Heartbeat events:** Automatically expire after 30 days (TTL).
+- **Heartbeat thoughts:** Automatically expire after 90 days (TTL).
+- **Usage logs:** Retained for up to 12 months for operational purposes, then deleted.
+- **Account information:** Retained until you delete your account.
+
+## 5. Data Security
+
+We implement industry-standard security measures:
+
+- **Encryption at rest:** All data stored in DynamoDB, S3, and Neo4j is encrypted.
+- **Encryption in transit:** All API communication uses TLS/HTTPS.
+- **Tenant isolation:** Every database query is scoped to your tenant ID. Cross-tenant access is architecturally prevented.
+- **API key security:** API keys are managed through AWS API Gateway with usage plans and throttling.
+- **Authentication:** OAuth 2.0 with PKCE flow. No passwords stored.
+- **Access control:** Role-based access with system admin separation.
+- **Local credential security:** CLI tokens stored with 600 file permissions (user-read-only).
+
+## 6. Your Rights
+
+You have the right to:
+
+- **Access** your data at any time through the API, CLI, or dashboard.
+- **Export** your data in structured format upon request.
+- **Delete** your data by deleting entities, content, or your entire account.
+- **Correct** your data by updating entities and ingesting corrections.
+- **Object** to specific processing by contacting us.
+- **Withdraw consent** for any optional processing at any time.
+
+For data subject requests, contact us at privacy@alphacollective.com.
+
+## 7. Children's Privacy
+
+The Service is not directed to individuals under 16. We do not knowingly collect information from children under 16. If you become aware that a child has provided us with personal information, please contact us and we will take steps to delete such information.
+
+## 8. International Data Transfers
+
+Your Data is processed and stored in the United States (AWS US-East-1 region). If you are located outside the United States, your data will be transferred to and processed in the United States. By using the Service, you consent to this transfer.
+
+## 9. Changes to This Policy
+
+We may update this Privacy Policy from time to time. We will notify you of material changes via email or through the Service. Your continued use of the Service after changes take effect constitutes acceptance of the updated policy.
+
+## 10. Contact
+
+For privacy-related questions or data subject requests:
+
+**Alpha Collective LLC**
+Email: privacy@alphacollective.com
+Website: https://trucontext.ai

package/README.md

@@ -0,0 +1,183 @@
+# TruContext CLI
+
+Persistent, intelligent memory for AI agents.
+
+Your agent forgets everything. Every session starts from zero. Context compaction destroys what it learned. Memory plugins store facts but can't connect them. Your agent retrieves text snippets and hopes for the best.
+
+**TruContext is different.** It's an intelligent knowledge graph — not flat storage, not keyword search, not GraphRAG. Your agent doesn't just *remember*. It *understands*.
+
+## Install
+
+```bash
+npx trucontext login
+```
+
+That's it. No API keys to copy, no config files to edit. Browser-based OAuth, then you're in.
+
+## 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
+
+# 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
+npx trucontext query "What does Dustin prefer?"
+```
+
+The response isn't a list of matching documents. It's structured understanding — concepts with confidence scores, emotional signatures, relationship context, and temporal awareness.
+
+## What Makes TruContext Different
+
+### Intelligent Knowledge Graph, Not Flat Storage
+
+Memory plugins give you key-value pairs. TruContext gives you an intelligent knowledge graph where every piece of knowledge is connected to the entities, concepts, and emotions it relates to. When you ask "What does Dustin believe about AI?", the system traverses from the Person node through relationships to concepts, content, and emotional primitives — returning structured understanding, not text matches.
+
+### Confidence + Temporal Decay
+
+Not all memory is equal. A stated preference has higher confidence than an inferred pattern. A fact ("attended the Super Bowl") never decays. A preference ("likes morning meetings") fades if not reinforced. TruContext tracks both — so your agent knows what it's sure about and what's getting stale.
+
+```bash
+# High confidence, temporal — a strong preference that may change
+npx trucontext ingest "Dustin prefers dark mode" \
+  --context dustin:ABOUT --confidence 0.9 --temporal
+
+# Low confidence, permanent — an unverified fact
+npx trucontext ingest "Dustin attended the Super Bowl in 2024" \
+  --context dustin:ABOUT --confidence 0.3 --no-temporal
+```
+
+### Curiosity — The System Asks What's Missing
+
+Most memory systems only answer questions. TruContext also asks them. The heartbeat — a background intelligence layer — dreams about your data and surfaces what's missing, what's contradictory, and what needs more evidence. It generates attention directives that make every future interaction smarter.
+
+### Recipes — Cognitive Templates
+
+Recipes teach your agent *how to think* about a use case. Attach a recipe to a context node, and the heartbeat dreams about that data through the recipe's lens.
+
+12 built-in recipes:
+
+| Recipe | What It Does |
+|--------|-------------|
+| `personal-assistant-memory` | Persistent 1:1 user memory with preference tracking |
+| `meeting-memory` | Cross-meeting decisions, action items, position tracking |
+| `competitive-intelligence` | Competitor tracking, strategic early warning |
+| `customer-voice` | Sentiment tracking, churn signals, feature request aggregation |
+| `ai-agent-self-reflection` | The agent learns about itself — decisions, errors, feedback |
+| `behavioral-observation` | Actions vs words — say-do gap analysis |
+| `organizational-context` | Living org charts, relationship mapping |
+| `customer-persona` | Aggregate archetypes that evolve with evidence |
+| `decision-archive` | Decisions + rationale + rejected alternatives |
+| `curiosity-loop` | The graph's gaps as the primary signal |
+| `values-alignment` | Tension between stated values and actions |
+| `temporal-drift` | Belief evolution tracking over time |
+
+```bash
+# See all recipes
+npx trucontext recipes list
+
+# Read the full recipe — WHY (how the system interprets) + HOW (implementation guide)
+npx trucontext recipes get recipe:personal-assistant-memory
+```
+
+### Model-Agnostic Memory
+
+TruContext doesn't care which LLM reads or writes to it. An OpenClaw agent using GPT can ingest. A Claude Code agent can query. A custom Gemini pipeline can recall. Switch models — keep the knowledge. The intelligent knowledge graph is the constant. The model is the variable.
+
+### Self-Reflection
+
+Your agent can track its own learning — what decisions it made, where it was wrong, what feedback it received. Attach the `ai-agent-self-reflection` recipe and the agent builds meta-cognition over time. It doesn't just learn about the world. It learns about itself.
+
+### 36 Relationship Types
+
+Content connects to entities through typed relationships — not just "related to" but *how*. BY, ABOUT, CAPTURES, RESPONDS_TO, REINFORCES, OPPOSES, DERIVED_FROM, and 29 more. Your agent speaks a rich vocabulary about how knowledge connects.
+
+```bash
+# See all relationship types
+npx trucontext relationship-types
+
+# Link content to multiple entities with different relationships
+npx trucontext ingest "Session summary..." \
+  --context dustin:ABOUT \
+  --context agent-claude:BY \
+  --context session-mar-22:CAPTURES
+```
+
+## The Lifecycle
+
+The ideal loop for an AI agent using TruContext:
+
+```
+Observe → Capture → Sleep → Wake → Query → Observe → ...
+```
+
+1. **Observe** during the session — accumulate signal
+2. **Capture** before compaction — ingest summaries, decisions, preferences
+3. **Sleep** — the heartbeat dreams about your data (decay, patterns, curiosity)
+4. **Wake** — query to rebuild working memory
+5. **Repeat** — each cycle makes the agent smarter
+
+## Commands
+
+### Auth
+| Command | Description |
+|---------|-------------|
+| `login` | Sign in via browser (OAuth + PKCE) |
+| `logout` | Clear stored credentials |
+| `whoami` | Show current user and active app |
+
+### Apps
+| Command | Description |
+|---------|-------------|
+| `init [name]` | Create a new app with AI-generated schema |
+| `apps` | List your apps |
+| `use <app>` | Set the active app |
+
+### 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 |
+
+### Structure
+| Command | Description |
+|---------|-------------|
+| `entities list` | List entities |
+| `entities create` | Create entity with recipe, confidence, temporal, contexts |
+| `entities get <id>` | Get entity details |
+| `entities update <id>` | Update entity properties, recipe, heartbeat settings |
+| `entities delete <id>` | Delete entity |
+| `contexts list` | List contexts |
+| `contexts create <name>` | Create a scoping context |
+| `contexts delete <id>` | Delete context |
+
+### Intelligence
+| Command | Description |
+|---------|-------------|
+| `recipes list` | List all recipes (system + custom) |
+| `recipes get <id>` | Get recipe details (WHY + HOW) |
+| `recipes create` | Create a custom recipe |
+| `recipes delete <id>` | Delete a custom recipe |
+| `relationship-types` | List all relationship types |
+| `schema show` | Show current app schema |
+| `schema generate` | AI-generate a schema from description |
+
+## API
+
+TruContext has two API surfaces:
+
+- **Data Plane** (`api.trucontext.ai`) — ingest, query, recall, entities, contexts. Authenticated with API keys.
+- **Control Plane** (`platform.trucontext.ai`) — apps, schema, recipes, settings. Authenticated with JWT.
+
+Full API documentation: [app.trucontext.ai/docs](https://app.trucontext.ai/docs)
+
+## License
+
+MIT

package/TERMS.md

@@ -0,0 +1,101 @@
+# TruContext Terms of Service
+
+**Effective Date:** March 22, 2026
+**Last Updated:** March 22, 2026
+
+These Terms of Service ("Terms") govern your access to and use of the TruContext platform, APIs, CLI tools, and related services (collectively, the "Service") provided by Alpha Collective LLC ("Company," "we," "us," or "our").
+
+By creating an account, accessing the Service, or using the CLI tool, you agree to be bound by these Terms. If you do not agree, do not use the Service.
+
+## 1. Your Data, Your Ownership
+
+**You own your data.** All content, entities, relationships, and knowledge graph data that you or your applications create, ingest, or store through the Service ("Your Data") remains your property. We claim no ownership rights over Your Data.
+
+We will not use Your Data to train machine learning models, improve our AI systems, or for any purpose beyond providing and maintaining the Service to you — unless you provide separate, explicit written consent.
+
+## 2. What We Do With Your Data
+
+We process Your Data solely to provide the Service:
+
+- **Storage:** Your Data is stored in encrypted databases (DynamoDB, Neo4j, S3) within AWS infrastructure.
+- **Processing:** When you ingest content, our AI pipeline extracts concepts, relationships, and patterns as part of the Service's core functionality. This processing is done exclusively for your benefit within your tenant.
+- **Heartbeat:** Our background intelligence layer ("heartbeat") analyzes patterns in Your Data to surface insights, manage confidence decay, and generate attention directives — all within your tenant boundary.
+
+We do not access, review, or analyze Your Data for any purpose other than operating the Service, unless required by law or with your explicit consent.
+
+## 3. Account and Security
+
+- You are responsible for maintaining the security of your account credentials.
+- You must not share API keys or authentication tokens with unauthorized parties.
+- You are responsible for all activity that occurs under your account.
+- You must notify us promptly of any unauthorized access to your account.
+
+## 4. Acceptable Use
+
+You agree not to:
+
+- Use the Service for any unlawful purpose or in violation of any applicable laws.
+- Ingest content that you do not have the right to use or that infringes third-party intellectual property rights.
+- Attempt to access another user's data, circumvent tenant isolation, or probe the Service's security.
+- Use the Service to store or process data subject to specific regulatory requirements (e.g., HIPAA, PCI-DSS) unless you have obtained a separate written agreement with us for such use.
+- Reverse engineer, decompile, or attempt to extract the source code of our proprietary systems.
+- Resell, redistribute, or sublicense access to the Service without our written consent.
+
+## 5. Service Availability
+
+We strive to maintain high availability but do not guarantee uninterrupted access. The Service is provided on an "as available" basis. We may perform maintenance, updates, or modifications that temporarily affect availability. We will make reasonable efforts to provide advance notice of planned downtime.
+
+## 6. API Usage and Rate Limits
+
+- API usage is subject to rate limits and quotas based on your plan tier.
+- We reserve the right to throttle or suspend access if usage patterns indicate abuse or threaten the stability of the Service.
+- Plan tiers, pricing, and associated limits are published on our website and may be updated with reasonable notice.
+
+## 7. Intellectual Property
+
+- The Service, including its architecture, algorithms, documentation, recipes, and all related intellectual property, is owned by Alpha Collective LLC and protected by applicable intellectual property laws.
+- Your use of the Service does not grant you any rights to our intellectual property except the limited right to use the Service in accordance with these Terms.
+- The TruContext CLI is licensed under the MIT License. This license applies to the CLI software only, not to the Service.
+
+## 8. Limitation of Liability
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, IN NO EVENT SHALL ALPHA COLLECTIVE LLC, ITS OFFICERS, DIRECTORS, EMPLOYEES, OR AGENTS BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR PUNITIVE DAMAGES, INCLUDING BUT NOT LIMITED TO LOSS OF PROFITS, DATA, USE, OR GOODWILL, ARISING OUT OF OR IN CONNECTION WITH YOUR USE OF THE SERVICE, REGARDLESS OF THE THEORY OF LIABILITY.
+
+OUR TOTAL AGGREGATE LIABILITY ARISING OUT OF OR RELATING TO THESE TERMS OR THE SERVICE SHALL NOT EXCEED THE GREATER OF (A) THE AMOUNTS YOU PAID TO US IN THE TWELVE MONTHS PRECEDING THE CLAIM, OR (B) ONE HUNDRED DOLLARS ($100).
+
+## 9. Indemnification
+
+You agree to indemnify, defend, and hold harmless Alpha Collective LLC and its officers, directors, employees, and agents from and against any claims, liabilities, damages, losses, costs, or expenses (including reasonable attorneys' fees) arising out of or relating to:
+
+- Your use of the Service.
+- Your violation of these Terms.
+- Your violation of any third-party rights, including intellectual property rights.
+- Any content you ingest, store, or process through the Service.
+
+## 10. Disclaimer of Warranties
+
+THE SERVICE IS PROVIDED "AS IS" AND "AS AVAILABLE" WITHOUT WARRANTIES OF ANY KIND, WHETHER EXPRESS, IMPLIED, OR STATUTORY, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+WE DO NOT WARRANT THAT THE SERVICE WILL BE UNINTERRUPTED, ERROR-FREE, OR SECURE, OR THAT ANY DEFECTS WILL BE CORRECTED. THE AI-GENERATED OUTPUTS OF THE SERVICE (INCLUDING EXTRACTED CONCEPTS, INSIGHTS, AND HEARTBEAT ANALYSES) ARE PROVIDED FOR INFORMATIONAL PURPOSES AND SHOULD NOT BE RELIED UPON AS THE SOLE BASIS FOR DECISIONS.
+
+## 11. Termination
+
+- You may terminate your account at any time by contacting us or deleting your account through the dashboard.
+- We may suspend or terminate your access if you violate these Terms, upon reasonable notice where practicable.
+- Upon termination, you may request export of Your Data within 30 days. After 30 days, we may delete Your Data from our systems.
+
+## 12. Changes to These Terms
+
+We may update these Terms from time to time. We will notify you of material changes via email or through the Service. Your continued use of the Service after changes take effect constitutes acceptance of the updated Terms.
+
+## 13. Governing Law
+
+These Terms are governed by and construed in accordance with the laws of the State of Colorado, United States, without regard to conflict of law principles. Any disputes arising under these Terms shall be resolved in the state or federal courts located in Colorado.
+
+## 14. Contact
+
+For questions about these Terms, contact us at:
+
+**Alpha Collective LLC**
+Email: legal@alphacollective.com
+Website: https://trucontext.ai

package/bin/cli.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import { loginCommand } from '../src/commands/login.js';
+import { logoutCommand } from '../src/commands/logout.js';
+import { whoamiCommand } from '../src/commands/whoami.js';
+import { appsCommand, useCommand } from '../src/commands/apps.js';
+import { initCommand } from '../src/commands/init.js';
+import { ingestCommand } from '../src/commands/ingest.js';
+import { queryCommand } from '../src/commands/query.js';
+import { recallCommand } from '../src/commands/recall.js';
+import { contextsListCommand, contextsCreateCommand, contextsDeleteCommand } from '../src/commands/contexts.js';
+import { schemaShowCommand, schemaGenerateCommand } from '../src/commands/schema.js';
+import { entitiesListCommand, entitiesGetCommand, entitiesCreateCommand, entitiesUpdateCommand, entitiesDeleteCommand } from '../src/commands/entities.js';
+import { recipesListCommand, recipesGetCommand, recipesCreateCommand, recipesDeleteCommand } from '../src/commands/recipes.js';
+import { relationshipTypesListCommand } from '../src/commands/relationship-types.js';
+
+program
+  .name('trucontext')
+  .description('TruContext CLI — contextual memory for AI applications')
+  .version('0.1.0');
+
+// Auth
+program.command('login')
+  .description('Sign in via browser')
+  .option('-g, --google', 'Sign in with Google (skip hosted UI)')
+  .action(loginCommand);
+
+program.command('logout')
+  .description('Clear stored credentials')
+  .action(logoutCommand);
+
+program.command('whoami')
+  .description('Show current user and active app')
+  .action(whoamiCommand);
+
+// Init
+program.command('init [name]')
+  .description('Create a new app and set it as active')
+  .option('-d, --description <text>', 'App description')
+  .action(initCommand);
+
+// Apps
+program.command('apps')
+  .description('List your apps')
+  .action(appsCommand);
+
+program.command('use <app>')
+  .description('Set active app (by ID or name)')
+  .action(useCommand);
+
+// Ingest
+program.command('ingest <source>')
+  .description('Ingest a file or text string')
+  .option('-c, --context <entry>', 'Link to context node (entity-id:RELATIONSHIP, repeatable)', (val, prev) => [...prev, val], [])
+  .option('--confidence <n>', 'Confidence level (0.0-1.0)')
+  .option('--temporal', 'Content can decay over time (default)')
+  .option('--no-temporal', 'Content is a permanent fact')
+  .action(ingestCommand);
+
+// Query
+program.command('query <question>')
+  .description('Query the knowledge graph')
+  .option('-c, --context <id>', 'Scope to a context')
+  .option('-m, --mode <mode>', 'Query mode: answer (default) or context', 'answer')
+  .option('-l, --limit <n>', 'Max results', '20')
+  .action(queryCommand);
+
+// Recall
+program.command('recall <query>')
+  .description('Semantic memory recall')
+  .option('-c, --context <id>', 'Scope to a context')
+  .option('-l, --limit <n>', 'Max seed results', '10')
+  .option('-d, --depth <n>', 'Graph expansion depth', '2')
+  .action(recallCommand);
+
+// Contexts
+const contexts = program.command('contexts').description('Manage contexts');
+contexts.command('list').description('List contexts').action(contextsListCommand);
+contexts.command('create <name>')
+  .description('Create a context')
+  .option('--metadata <json>', 'JSON metadata object')
+  .action(contextsCreateCommand);
+contexts.command('delete <id>').description('Delete a context').action(contextsDeleteCommand);
+
+// Entities
+const entities = program.command('entities').description('Manage entities');
+entities.command('list')
+  .description('List entities')
+  .option('--type <type>', 'Filter by entity type')
+  .option('-l, --limit <n>', 'Max results')
+  .action(entitiesListCommand);
+entities.command('get <entityId>')
+  .description('Get an entity')
+  .action(entitiesGetCommand);
+entities.command('create')
+  .description('Create an entity')
+  .requiredOption('--id <entityId>', 'Entity ID')
+  .requiredOption('--type <Type>', 'Entity type (PascalCase)')
+  .option('--properties <json>', 'JSON properties object')
+  .option('--recipe <recipeId>', 'Recipe ID')
+  .option('--no-heartbeat', 'Disable heartbeat')
+  .option('--confidence <n>', 'Confidence level (0.0-1.0)')
+  .option('--temporal', 'Content can decay over time (default)')
+  .option('--no-temporal', 'Content is a permanent fact')
+  .option('-c, --context <entry>', 'Link to context (entity-id:RELATIONSHIP, repeatable)', (val, prev) => [...prev, val], [])
+  .action(entitiesCreateCommand);
+entities.command('update <entityId>')
+  .description('Update an entity')
+  .option('--properties <json>', 'JSON properties object')
+  .option('--recipe <recipeId>', 'Recipe ID')
+  .option('--heartbeat', 'Enable heartbeat')
+  .option('--no-heartbeat', 'Disable heartbeat')
+  .option('--confidence <n>', 'Confidence level (0.0-1.0)')
+  .option('--temporal', 'Content can decay over time')
+  .option('--no-temporal', 'Content is a permanent fact')
+  .action(entitiesUpdateCommand);
+entities.command('delete <entityId>')
+  .description('Delete an entity')
+  .action(entitiesDeleteCommand);
+
+// Recipes
+const recipes = program.command('recipes').description('Manage recipes');
+recipes.command('list')
+  .description('List recipes')
+  .action(recipesListCommand);
+recipes.command('get <recipeId>')
+  .description('Get recipe details')
+  .action(recipesGetCommand);
+recipes.command('create')
+  .description('Create a recipe')
+  .requiredOption('--id <recipeId>', 'Recipe ID')
+  .requiredOption('--name <name>', 'Recipe name')
+  .requiredOption('--purpose <text>', 'Recipe purpose')
+  .option('--decay-profile <text>', 'Decay profile description')
+  .option('--confidence-bias <text>', 'Confidence bias description')
+  .action(recipesCreateCommand);
+recipes.command('delete <recipeId>')
+  .description('Delete a recipe')
+  .action(recipesDeleteCommand);
+
+// Relationship Types
+program.command('relationship-types')
+  .description('List relationship types')
+  .option('--category <cat>', 'Filter by category')
+  .action(relationshipTypesListCommand);
+
+// Schema
+const schema = program.command('schema').description('Manage app schema');
+schema.command('show').description('Show current schema').action(schemaShowCommand);
+schema.command('generate')
+  .description('AI-generate a schema')
+  .requiredOption('-d, --description <text>', 'App description for schema generation')
+  .option('-n, --name <name>', 'App name')
+  .action(schemaGenerateCommand);
+
+program.parse();

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "trucontext",
+  "version": "0.1.0",
+  "description": "TruContext CLI — contextual memory for AI applications",
+  "type": "module",
+  "bin": {
+    "trucontext": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md",
+    "LICENSE",
+    "TERMS.md",
+    "PRIVACY.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@inquirer/checkbox": "^5.1.2",
+    "@inquirer/input": "^5.0.10",
+    "@inquirer/select": "^5.1.2",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "open": "^10.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AlphaCollectiveLLC/trucontext-cli"
+  },
+  "homepage": "https://trucontext.ai",
+  "bugs": {
+    "url": "https://github.com/AlphaCollectiveLLC/trucontext-cli/issues"
+  },
+  "keywords": [
+    "trucontext",
+    "memory",
+    "ai",
+    "graph",
+    "knowledge-graph",
+    "cli",
+    "context"
+  ]
+}