trucontext 0.3.1 → 0.4.1

package/README.md

@@ -168,6 +168,8 @@ Observe → Capture → Sleep → Wake → Query → Observe → ...
 | `relationship-types` | List all relationship types |
 | `schema show` | Show current app schema |
 | `schema generate` | AI-generate a schema from description |
+| `docs` | List all API documentation sections |
+| `docs show <slug>` | View a specific doc section (no auth required) |
 
 ## API
 

package/bin/cli.js

@@ -1,7 +1,10 @@
 #!/usr/bin/env node
 
+import { readFileSync } from 'fs';
 import { program } from 'commander';
 import { loginCommand } from '../src/commands/login.js';
+
+const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
 import { logoutCommand } from '../src/commands/logout.js';
 import { whoamiCommand } from '../src/commands/whoami.js';
 import { appsCommand, useCommand } from '../src/commands/apps.js';
@@ -14,11 +17,12 @@ import { schemaShowCommand, schemaGenerateCommand, schemaSetAuthorshipCommand }
 import { entitiesListCommand, entitiesGetCommand, entitiesCreateCommand, entitiesUpdateCommand, entitiesDeleteCommand, entitiesEdgesCommand } from '../src/commands/entities.js';
 import { recipesListCommand, recipesGetCommand, recipesCreateCommand, recipesDeleteCommand } from '../src/commands/recipes.js';
 import { relationshipTypesListCommand } from '../src/commands/relationship-types.js';
+import { docsListCommand, docsShowCommand } from '../src/commands/docs.js';
 
 program
   .name('trucontext')
   .description('TruContext CLI — contextual memory for AI applications')
-  .version('0.3.1');
+  .version(pkg.version);
 
 // Auth
 program.command('login')
@@ -101,6 +105,7 @@ entities.command('create')
   .requiredOption('--type <Type>', 'Entity type (PascalCase)')
   .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 (default)')
@@ -164,4 +169,9 @@ schema.command('set-authorship <model>')
   .description('Set authorship model (single_author, multi_author, anonymous)')
   .action(schemaSetAuthorshipCommand);
 
+// Docs (public — no auth required)
+const docs = program.command('docs').description('Browse API documentation').action(docsListCommand);
+docs.command('list').description('List all doc sections').action(docsListCommand);
+docs.command('show <slug>').description('Show a specific doc section').action(docsShowCommand);
+
 program.parse();

package/package.json

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

package/src/client.js

@@ -75,3 +75,18 @@ export function dataPlane(method, path, body) {
 export function controlPlane(method, path, body) {
   return request(CONTROL_PLANE_URL, method, path, body);
 }
+
+export async function publicApi(method, path) {
+  const ac = new AbortController();
+  const timeout = setTimeout(() => ac.abort(), 15000);
+  try {
+    const res = await fetch(`${CONTROL_PLANE_URL}${path}`, {
+      method,
+      headers: { 'Content-Type': 'application/json' },
+      signal: ac.signal,
+    });
+    return handleResponse(res);
+  } finally {
+    clearTimeout(timeout);
+  }
+}

package/src/commands/docs.js

@@ -0,0 +1,113 @@
+import chalk from 'chalk';
+import { publicApi } from '../client.js';
+
+export async function docsListCommand() {
+  try {
+    const res = await publicApi('GET', '/public/docs');
+    const sections = res.data?.sections || res.sections || [];
+
+    if (sections.length === 0) {
+      console.log(chalk.yellow('No documentation available.'));
+      return;
+    }
+
+    console.log(chalk.bold('TruContext Documentation\n'));
+    for (const section of sections) {
+      const slug = section.sectionId || section.layerId || section.slug || section.id;
+      console.log(`  ${chalk.cyan(slug.padEnd(28))} ${chalk.bold(section.title)}`);
+    }
+    console.log();
+    console.log(chalk.dim(`${sections.length} sections. Use: trucontext docs show <slug>`));
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+export async function docsShowCommand(slug) {
+  try {
+    const res = await publicApi('GET', `/public/docs/${slug}`);
+    const doc = res.data || res;
+
+    if (!doc || !doc.title) {
+      console.error(chalk.red(`No doc found for slug: ${slug}`));
+      process.exit(1);
+    }
+
+    // Title
+    console.log(chalk.bold.underline(`\n${doc.title}\n`));
+
+    // Main content
+    if (doc.content) {
+      console.log(renderMarkdown(doc.content));
+      console.log();
+    }
+
+    // Callouts
+    for (const callout of (doc.callouts || [])) {
+      const icon = callout.variant === 'warning' ? '!' : 'i';
+      console.log(chalk.yellow(`  [${icon}] ${chalk.bold(callout.title)}`));
+      console.log(`  ${chalk.dim(callout.content.replace(/\n/g, '\n  '))}`);
+      console.log();
+    }
+
+    // Subsections
+    for (const sub of (doc.subsections || [])) {
+      if (sub.title) {
+        console.log(chalk.cyan.bold(`## ${sub.title}`));
+      }
+      if (sub.content) {
+        console.log(renderMarkdown(sub.content));
+        console.log();
+      }
+
+      // Steps
+      for (const step of (sub.steps || [])) {
+        console.log(`  ${chalk.green(step.number + '.')} ${renderMarkdown(step.content)}`);
+      }
+
+      // Endpoints
+      for (const ep of (sub.endpoints || [])) {
+        console.log(`  ${chalk.green(ep.method)} ${chalk.bold(ep.path)}`);
+        if (ep.description) console.log(`    ${chalk.dim(ep.description)}`);
+        if (ep.auth) console.log(`    ${chalk.dim(`Auth: ${ep.auth}`)}`);
+        if (ep.body) {
+          console.log(`    ${chalk.dim('Body:')} ${JSON.stringify(ep.body, null, 2).split('\n').join('\n    ')}`);
+        }
+        if (ep.response) {
+          console.log(`    ${chalk.dim('Response:')} ${JSON.stringify(ep.response, null, 2).split('\n').join('\n    ')}`);
+        }
+        console.log();
+      }
+
+      // Code blocks
+      for (const block of (sub.codeBlocks || [])) {
+        if (block.title) console.log(`  ${chalk.dim(block.title)}`);
+        console.log(chalk.green(`  ${block.code}`));
+        console.log();
+      }
+
+      // Items (relationship types, node types, etc.)
+      for (const item of (sub.items || [])) {
+        const label = item.type || item.name || item.recipeId || '';
+        const desc = item.description || '';
+        if (label) {
+          console.log(`  ${chalk.yellow(label.padEnd(24))} ${desc}`);
+        }
+      }
+
+      if (sub.steps?.length || sub.items?.length) console.log();
+    }
+  } catch (err) {
+    console.error(chalk.red(`Failed: ${err.message}`));
+    process.exit(1);
+  }
+}
+
+// Simple markdown-to-terminal renderer
+function renderMarkdown(text) {
+  return text
+    .replace(/\*\*(.+?)\*\*/g, (_, m) => chalk.bold(m))
+    .replace(/`(.+?)`/g, (_, m) => chalk.green(m))
+    .replace(/\[(.+?)\]\(.+?\)/g, (_, m) => chalk.underline(m));
+}