trucontext 0.1.0

package/src/commands/login.js

@@ -0,0 +1,126 @@
+import chalk from 'chalk';
+import select from '@inquirer/select';
+import checkbox from '@inquirer/checkbox';
+import { performLogin } from '../auth.js';
+import { controlPlane } from '../client.js';
+import { setActiveApp, hasAcceptedTerms, recordTermsAcceptance } from '../config.js';
+
+async function promptTermsAcceptance() {
+  if (hasAcceptedTerms()) return true;
+
+  console.log(`
+${chalk.bold('Welcome to TruContext')}
+
+Before continuing, please review and accept our legal agreements.
+
+${chalk.cyan('Key Points:')}
+
+  ${chalk.bold('Your Data')}
+  - You own your data. We claim no ownership rights.
+  - We will NOT use your data to train AI models without
+    your separate, explicit written consent.
+  - Your data is isolated to your tenant. Other users
+    cannot access it.
+
+  ${chalk.bold('Privacy')}
+  - Content you ingest is processed by AI providers
+    (Anthropic, Google) via their APIs to operate the
+    Service. These providers do not train on API inputs.
+  - We do not sell, rent, or share your data with third
+    parties for commercial purposes.
+
+  ${chalk.bold('Liability')}
+  - The Service is provided "as is" without warranties.
+  - Our total liability is limited to fees paid in the
+    prior 12 months or $100, whichever is greater.
+`);
+
+  // Offer to view full documents
+  const viewChoice = await select({
+    message: 'Would you like to read the full legal documents?',
+    choices: [
+      { name: 'Continue to acceptance', value: 'continue' },
+      { name: 'View Terms of Service', value: 'terms' },
+      { name: 'View Privacy Policy', value: 'privacy' },
+      { name: 'View both', value: 'both' },
+    ],
+  });
+
+  if (viewChoice !== 'continue') {
+    const { default: open } = await import('open');
+    if (viewChoice === 'terms' || viewChoice === 'both') {
+      console.log(chalk.dim('Opening Terms of Service...'));
+      await open('https://trucontext.ai/terms');
+    }
+    if (viewChoice === 'privacy' || viewChoice === 'both') {
+      console.log(chalk.dim('Opening Privacy Policy...'));
+      await open('https://trucontext.ai/privacy');
+    }
+    console.log();
+  }
+
+  // Checkbox acceptance — both must be checked
+  const accepted = await checkbox({
+    message: 'To continue, check both boxes:',
+    required: true,
+    choices: [
+      { name: 'I have read and agree to the Terms of Service', value: 'terms' },
+      { name: 'I have read and agree to the Privacy Policy', value: 'privacy' },
+    ],
+  });
+
+  if (!accepted.includes('terms') || !accepted.includes('privacy')) {
+    console.log(chalk.yellow('\nYou must accept both the Terms of Service and Privacy Policy to use TruContext.'));
+    return false;
+  }
+
+  recordTermsAcceptance();
+  console.log(chalk.green('\nTerms accepted.\n'));
+  return true;
+}
+
+export async function loginCommand(options) {
+  // Terms acceptance gate — must accept before first login
+  const accepted = await promptTermsAcceptance();
+  if (!accepted) {
+    process.exit(0);
+  }
+
+  const provider = options.google ? 'Google' : undefined;
+  console.log(chalk.dim(`Opening browser for sign-in${provider ? ` (${provider})` : ''}...`));
+
+  try {
+    const creds = await performLogin({ provider });
+    console.log(chalk.green(`\nLogged in as ${chalk.bold(creds.email)}`));
+
+    // Fetch apps and select one
+    try {
+      const res = await controlPlane('GET', '/apps');
+      const apps = res.data?.apps || [];
+
+      if (apps.length === 1) {
+        setActiveApp(apps[0].appId);
+        console.log(chalk.dim(`Active app: ${apps[0].name} (${apps[0].appId})`));
+      } else if (apps.length > 1) {
+        const chosen = await select({
+          message: 'Select an app:',
+          choices: apps.map(app => ({
+            name: `${app.name}  ${chalk.dim(app.appId)}`,
+            value: app.appId,
+          })),
+        });
+        setActiveApp(chosen);
+        const app = apps.find(a => a.appId === chosen);
+        console.log(chalk.green(`Active app: ${app.name}`));
+      } else {
+        console.log(chalk.dim('\nNo apps yet. Create one with:'));
+        console.log(chalk.cyan('  trucontext init "My App"'));
+      }
+    } catch {
+      // Non-fatal — login still succeeded
+    }
+  } catch (err) {
+    console.error(chalk.red(`Login failed: ${err.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/logout.js

@@ -0,0 +1,7 @@
+import chalk from 'chalk';
+import { clearCredentials } from '../config.js';
+
+export async function logoutCommand() {
+  clearCredentials();
+  console.log(chalk.green('Logged out. Credentials cleared.'));
+}

package/src/commands/query.js

@@ -0,0 +1,51 @@
+import chalk from 'chalk';
+import { dataPlane } from '../client.js';
+
+export async function queryCommand(question, options) {
+  try {
+    const body = {
+      mode: options.mode === 'context' ? 'CONTEXT' : 'ANSWER',
+      max_results: options.limit ? parseInt(options.limit, 10) : 20,
+    };
+
+    if (body.mode === 'ANSWER') {
+      body.query = question;
+    } else {
+      body.topic = question;
+    }
+
+    if (options.context) body.context_id = options.context;
+
+    const res = await dataPlane('POST', '/v1/query', body);
+
+    // Print answer
+    if (res.answer?.summary) {
+      console.log(chalk.bold('\nAnswer:'));
+      console.log(res.answer.summary);
+      if (res.answer.confidence) {
+        console.log(chalk.dim(`\nConfidence: ${(res.answer.confidence * 100).toFixed(0)}%`));
+      }
+    }
+
+    // Print concepts
+    if (res.concepts?.length > 0) {
+      console.log(chalk.bold('\nConcepts:'));
+      for (const c of res.concepts.slice(0, 5)) {
+        console.log(`  ${c.label} ${chalk.dim(`(${c.evidence_count} evidence)`)}`);
+      }
+    }
+
+    // Print people
+    if (res.people?.length > 0) {
+      console.log(chalk.bold('\nPeople:'));
+      for (const p of res.people.slice(0, 5)) {
+        console.log(`  ${p.name} ${chalk.dim(p.relationship || '')}`);
+      }
+    }
+
+    console.log(chalk.dim(`\n${res.latency_ms}ms`));
+  } catch (err) {
+    console.error(chalk.red(`Query failed: ${err.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/recall.js

@@ -0,0 +1,42 @@
+import chalk from 'chalk';
+import { dataPlane } from '../client.js';
+
+export async function recallCommand(query, options) {
+  try {
+    const body = {
+      query,
+      maxResults: options.limit ? parseInt(options.limit, 10) : 10,
+      expansionDepth: options.depth ? parseInt(options.depth, 10) : 2,
+    };
+
+    if (options.context) body.context_id = options.context;
+
+    const res = await dataPlane('POST', '/v1/recall', body);
+
+    // Print synthesis
+    if (res.synthesis?.summary) {
+      console.log(chalk.bold('\nSynthesis:'));
+      console.log(res.synthesis.summary);
+    }
+
+    // Print seeds
+    if (res.seeds?.length > 0) {
+      console.log(chalk.bold(`\nSeeds (${res.seeds.length}):`));
+      for (const s of res.seeds) {
+        const label = s.snippet || s.label || s.id;
+        const score = (s.score * 100).toFixed(0);
+        console.log(`  ${chalk.dim(`${score}%`)} ${label.slice(0, 100)}`);
+      }
+    }
+
+    // Print graph context summary
+    if (res.context) {
+      console.log(chalk.dim(`\nGraph: ${res.context.nodes?.length || 0} nodes, ${res.context.edges?.length || 0} edges`));
+    }
+
+    console.log(chalk.dim(`${res.latency_ms}ms`));
+  } catch (err) {
+    console.error(chalk.red(`Recall failed: ${err.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/recipes.js

@@ -0,0 +1,130 @@
+import chalk from 'chalk';
+import { controlPlane } from '../client.js';
+import { getActiveApp } from '../config.js';
+
+function requireApp() {
+  const appId = getActiveApp();
+  if (!appId) {
+    console.error(chalk.red('No active app. Run: trucontext use <app>'));
+    process.exit(1);
+  }
+  return appId;
+}
+
+export async function recipesListCommand() {
+  try {
+    const appId = requireApp();
+    const res = await controlPlane('GET', `/apps/${appId}/recipes`);
+    const recipes = res.data?.recipes || [];
+
+    if (recipes.length === 0) {
+      console.log(chalk.yellow('No recipes found.'));
+      return;
+    }
+
+    for (const r of recipes) {
+      console.log(`${chalk.bold(r.recipeId)} ${chalk.dim(`[${r.type || 'custom'}]`)}`);
+      if (r.name) console.log(`  ${r.name}`);
+    }
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function recipesGetCommand(recipeId) {
+  try {
+    const appId = requireApp();
+    const res = await controlPlane('GET', `/apps/${appId}/recipes/${recipeId}`);
+    const r = res.data || res;
+
+    console.log(chalk.bold(r.recipeId || recipeId));
+    if (r.name) console.log(`  name: ${r.name}`);
+    if (r.type) console.log(`  type: ${chalk.dim(r.type)}`);
+
+    // Show interpretation (WHY) — present on both system and custom recipes
+    if (r.interpretation) {
+      console.log();
+      console.log(chalk.bold('Interpretation:'));
+      console.log(`  ${r.interpretation}`);
+    }
+
+    // System recipes have operational details (HOW)
+    if (r.type === 'system') {
+      if (r.entity_setup) {
+        console.log();
+        console.log(chalk.bold('Entity Setup:'));
+        console.log(`  ${chalk.dim(JSON.stringify(r.entity_setup, null, 2).replace(/\n/g, '\n  '))}`);
+      }
+      if (r.ingest_patterns) {
+        console.log();
+        console.log(chalk.bold('Ingest Patterns:'));
+        console.log(`  ${chalk.dim(JSON.stringify(r.ingest_patterns, null, 2).replace(/\n/g, '\n  '))}`);
+      }
+      if (r.query_patterns) {
+        console.log();
+        console.log(chalk.bold('Query Patterns:'));
+        console.log(`  ${chalk.dim(JSON.stringify(r.query_patterns, null, 2).replace(/\n/g, '\n  '))}`);
+      }
+      if (r.lifecycle) {
+        console.log();
+        console.log(chalk.bold('Lifecycle:'));
+        console.log(`  ${chalk.dim(JSON.stringify(r.lifecycle, null, 2).replace(/\n/g, '\n  '))}`);
+      }
+      if (r.example_scenario) {
+        console.log();
+        console.log(chalk.bold('Example Scenario:'));
+        console.log(`  ${r.example_scenario}`);
+      }
+    }
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function recipesCreateCommand(options) {
+  try {
+    const appId = requireApp();
+
+    if (!options.id) {
+      console.error(chalk.red('--id is required'));
+      process.exit(1);
+    }
+    if (!options.name) {
+      console.error(chalk.red('--name is required'));
+      process.exit(1);
+    }
+    if (!options.purpose) {
+      console.error(chalk.red('--purpose is required'));
+      process.exit(1);
+    }
+
+    const body = {
+      recipeId: options.id,
+      name: options.name,
+      purpose: options.purpose,
+    };
+
+    if (options.decayProfile) body.decay_profile = options.decayProfile;
+    if (options.confidenceBias) body.confidence_bias = options.confidenceBias;
+
+    const res = await controlPlane('POST', `/apps/${appId}/recipes`, body);
+    const r = res.data || res;
+    console.log(chalk.green(`Created: ${chalk.bold(r.recipeId || options.id)}`));
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function recipesDeleteCommand(recipeId) {
+  try {
+    const appId = requireApp();
+    await controlPlane('DELETE', `/apps/${appId}/recipes/${recipeId}`);
+    console.log(chalk.green(`Deleted: ${recipeId}`));
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/relationship-types.js

@@ -0,0 +1,56 @@
+import chalk from 'chalk';
+import { controlPlane } from '../client.js';
+import { getActiveApp } from '../config.js';
+
+export async function relationshipTypesListCommand(options) {
+  try {
+    const appId = getActiveApp();
+    if (!appId) {
+      console.error(chalk.red('No active app. Run: trucontext use <app>'));
+      process.exit(1);
+    }
+
+    const params = new URLSearchParams();
+    if (options.category) params.set('category', options.category);
+    const qs = params.toString();
+    const path = `/apps/${appId}/relationship-types${qs ? `?${qs}` : ''}`;
+
+    const res = await controlPlane('GET', path);
+    const types = res.data?.relationshipTypes || res.data || [];
+
+    if (Array.isArray(types) && types.length === 0) {
+      console.log(chalk.yellow('No relationship types found.'));
+      return;
+    }
+
+    // Group by category if present
+    if (Array.isArray(types)) {
+      const grouped = {};
+      for (const t of types) {
+        const cat = t.category || 'uncategorized';
+        if (!grouped[cat]) grouped[cat] = [];
+        grouped[cat].push(t);
+      }
+
+      for (const [category, items] of Object.entries(grouped)) {
+        console.log(chalk.bold(category));
+        for (const t of items) {
+          const desc = t.description ? ` — ${t.description}` : '';
+          console.log(`  ${chalk.dim(t.type || t.relationshipType)}${desc}`);
+        }
+      }
+    } else if (typeof types === 'object') {
+      // Already grouped by category
+      for (const [category, items] of Object.entries(types)) {
+        console.log(chalk.bold(category));
+        for (const t of items) {
+          const desc = t.description ? ` — ${t.description}` : '';
+          console.log(`  ${chalk.dim(t.type || t.relationshipType)}${desc}`);
+        }
+      }
+    }
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/schema.js

@@ -0,0 +1,74 @@
+import chalk from 'chalk';
+import { controlPlane } from '../client.js';
+import { getActiveApp } from '../config.js';
+
+function requireActiveApp() {
+  const appId = getActiveApp();
+  if (!appId) {
+    console.error(chalk.red('No active app. Run: trucontext use <app-id>'));
+    process.exit(1);
+  }
+  return appId;
+}
+
+export async function schemaShowCommand() {
+  const appId = requireActiveApp();
+  try {
+    const res = await controlPlane('GET', `/apps/${appId}/schema`);
+    const schema = res.data;
+
+    if (!schema) {
+      console.log(chalk.yellow('No schema configured. Generate one with: trucontext schema generate'));
+      return;
+    }
+
+    console.log(chalk.bold('Schema:'), schema.name || appId);
+    console.log(chalk.bold('Version:'), schema.version || 'v1');
+
+    if (schema.custom_node_types?.length > 0) {
+      console.log(chalk.bold('\nNode Types:'));
+      for (const t of schema.custom_node_types) {
+        console.log(`  ${chalk.cyan(t.name)} — ${t.description || ''}`);
+        if (t.properties?.length > 0) {
+          console.log(`    ${chalk.dim(t.properties.join(', '))}`);
+        }
+      }
+    }
+
+    if (schema.custom_edge_types?.length > 0) {
+      console.log(chalk.bold('\nEdge Types:'));
+      console.log(`  ${chalk.dim(schema.custom_edge_types.join(', '))}`);
+    }
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function schemaGenerateCommand(options) {
+  const appId = requireActiveApp();
+  try {
+    if (!options.description) {
+      console.error(chalk.red('Description required: trucontext schema generate --description "..."'));
+      process.exit(1);
+    }
+
+    console.log(chalk.dim('Generating schema...'));
+    const res = await controlPlane('POST', '/schema/generate', {
+      description: options.description,
+      appName: options.name || appId,
+    });
+
+    console.log(chalk.green('Schema generated.'));
+    const schema = res.data;
+    if (schema?.custom_node_types) {
+      console.log(chalk.bold('Node types:'), schema.custom_node_types.map(t => t.name).join(', '));
+    }
+    if (schema?.custom_edge_types) {
+      console.log(chalk.bold('Edge types:'), schema.custom_edge_types.join(', '));
+    }
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/whoami.js

@@ -0,0 +1,23 @@
+import chalk from 'chalk';
+import { getCredentials, getActiveApp } from '../config.js';
+
+export async function whoamiCommand() {
+  const creds = getCredentials();
+  if (!creds) {
+    console.log(chalk.yellow('Not logged in. Run: trucontext login'));
+    process.exit(1);
+  }
+
+  console.log(chalk.bold('Email:'), creds.email);
+  console.log(chalk.bold('Sub:'), chalk.dim(creds.sub));
+
+  const activeApp = getActiveApp();
+  if (activeApp) {
+    console.log(chalk.bold('Active app:'), activeApp);
+  } else {
+    console.log(chalk.bold('Active app:'), chalk.yellow('none — run: trucontext use <app-id>'));
+  }
+
+  const expiresIn = Math.max(0, Math.round((creds.expiresAt - Date.now()) / 1000));
+  console.log(chalk.bold('Token expires in:'), expiresIn > 0 ? `${expiresIn}s` : chalk.red('expired'));
+}

package/src/config.js

@@ -0,0 +1,87 @@
+// config.js — Credential and configuration management
+// Stores credentials and config in ~/.trucontext/
+
+import { readFileSync, writeFileSync, mkdirSync, unlinkSync, existsSync, chmodSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+
+const CONFIG_DIR = join(homedir(), '.trucontext');
+const CREDENTIALS_FILE = join(CONFIG_DIR, 'credentials.json');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+
+// Cognito + API endpoints
+export const COGNITO_DOMAIN = 'https://auth.trucontext.ai';
+export const CLI_CLIENT_ID = '4tn43b2p32bh3t9tcstrrsi7fo';
+export const CALLBACK_PORT = 8181;
+export const CALLBACK_URL = `http://localhost:${CALLBACK_PORT}/callback`;
+export const DATA_PLANE_URL = 'https://api.trucontext.ai';
+export const CONTROL_PLANE_URL = 'https://platform.trucontext.ai';
+
+function ensureDir() {
+  if (!existsSync(CONFIG_DIR)) {
+    mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+  }
+}
+
+// --- Credentials ---
+
+export function getCredentials() {
+  try {
+    return JSON.parse(readFileSync(CREDENTIALS_FILE, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+export function saveCredentials(creds) {
+  ensureDir();
+  writeFileSync(CREDENTIALS_FILE, JSON.stringify(creds, null, 2));
+  chmodSync(CREDENTIALS_FILE, 0o600);
+}
+
+export function clearCredentials() {
+  try {
+    unlinkSync(CREDENTIALS_FILE);
+  } catch {
+    // Already gone
+  }
+}
+
+// --- Config ---
+
+export function getConfig() {
+  try {
+    return JSON.parse(readFileSync(CONFIG_FILE, 'utf-8'));
+  } catch {
+    return {};
+  }
+}
+
+export function saveConfig(config) {
+  ensureDir();
+  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+
+export function getActiveApp() {
+  return getConfig().activeApp || null;
+}
+
+export function setActiveApp(appId) {
+  const config = getConfig();
+  config.activeApp = appId;
+  saveConfig(config);
+}
+
+// --- Terms Acceptance ---
+
+export function hasAcceptedTerms() {
+  const config = getConfig();
+  return !!config.termsAcceptedAt;
+}
+
+export function recordTermsAcceptance() {
+  const config = getConfig();
+  config.termsAcceptedAt = new Date().toISOString();
+  config.termsVersion = '2026-03-22';
+  saveConfig(config);
+}