@lifestreamdynamics/vault-cli 1.3.9 → 1.3.10

package/dist/commands/ai.js

@@ -5,6 +5,30 @@ import { createOutput, handleError } from '../utils/output.js';
 export function registerAiCommands(program) {
     const ai = program.command('ai').description('AI chat and document summarization');
     const sessions = ai.command('sessions').description('AI chat session management');
+    addGlobalFlags(sessions.command('create')
+        .description('Create a new AI chat session')
+        .option('--title <title>', 'Session title')
+        .option('--vault <vaultId>', 'Vault ID to scope the session'))
+        .action(async (_opts) => {
+        const flags = resolveFlags(_opts);
+        const out = createOutput(flags);
+        out.startSpinner('Creating AI session...');
+        try {
+            const client = await getClientAsync();
+            const session = await client.ai.createSession({
+                title: _opts.title ? String(_opts.title) : undefined,
+                vaultId: _opts.vault ? String(_opts.vault) : undefined,
+            });
+            out.success(`Session created: ${session.id}`, {
+                id: session.id,
+                title: session.title ?? 'Untitled',
+                vaultId: session.vaultId ?? null,
+            });
+        }
+        catch (err) {
+            handleError(out, err, 'Failed to create AI session');
+        }
+    });
     addGlobalFlags(sessions.command('list')
         .description('List AI chat sessions'))
         .action(async (_opts) => {

package/dist/commands/audit.js

@@ -91,8 +91,8 @@ EXAMPLES
         }
     });
     addGlobalFlags(audit.command('export')
-        .description('Export audit log entries to a CSV file or stdout')
-        .option('--format <format>', 'Export format (csv)', 'csv')
+        .description('Export audit log entries to a CSV or JSON file or stdout')
+        .option('--format <format>', 'Export format (csv or json)', 'csv')
         .option('--file <file>', 'Output file path')
         .option('--status <code>', 'Filter by HTTP status code', parseInt)
         .option('--since <date>', 'Show entries since date (ISO 8601)')
@@ -102,8 +102,8 @@ EXAMPLES
         const flags = resolveFlags(_opts);
         const out = createOutput(flags);
         try {
-            if (_opts.format !== 'csv') {
-                out.error(`Unsupported format: ${String(_opts.format)}. Only 'csv' is supported.`);
+            if (_opts.format !== 'csv' && _opts.format !== 'json') {
+                out.error(`Unsupported format: ${String(_opts.format)}. Supported: csv, json`);
                 process.exitCode = 2;
                 return;
             }
@@ -141,6 +141,26 @@ EXAMPLES
                 out.status('No audit log entries to export.');
                 return;
             }
+            if (_opts.format === 'json') {
+                const jsonOutput = JSON.stringify(entries, null, 2);
+                if (_opts.file) {
+                    const outputPath = String(_opts.file);
+                    const outputDir = path.dirname(outputPath);
+                    if (!fs.existsSync(outputDir)) {
+                        fs.mkdirSync(outputDir, { recursive: true });
+                    }
+                    fs.writeFileSync(outputPath, jsonOutput, 'utf-8');
+                    out.success(`Exported ${entries.length} entries to ${outputPath}`, {
+                        entries: entries.length,
+                        path: outputPath,
+                        format: 'json',
+                    });
+                }
+                else {
+                    out.raw(jsonOutput + '\n');
+                }
+                return;
+            }
             const csv = logger.exportCsv(entries);
             if (_opts.file) {
                 const outputPath = String(_opts.file);

package/dist/commands/links.js

@@ -100,9 +100,37 @@ export function registerLinkCommands(program) {
                 process.stdout.write(JSON.stringify({ nodes: graph.nodes, edges: graph.edges }) + '\n');
             }
             else {
-                process.stdout.write(chalk.bold(`Nodes: ${graph.nodes.length}  Edges: ${graph.edges.length}\n`));
+                process.stdout.write(chalk.bold(`Nodes: ${graph.nodes.length}  Edges: ${graph.edges.length}\n\n`));
+                // Most connected nodes (top 5)
+                const connectionCounts = new Map();
                 for (const node of graph.nodes) {
-                    process.stdout.write(`  ${chalk.cyan(String(node.path ?? node.id))}\n`);
+                    connectionCounts.set(node.id, 0);
+                }
+                for (const edge of graph.edges) {
+                    connectionCounts.set(edge.source, (connectionCounts.get(edge.source) ?? 0) + 1);
+                    connectionCounts.set(edge.target, (connectionCounts.get(edge.target) ?? 0) + 1);
+                }
+                const sorted = [...connectionCounts.entries()].sort((a, b) => b[1] - a[1]);
+                const topConnected = sorted.slice(0, 5).filter(([, count]) => count > 0);
+                if (topConnected.length > 0) {
+                    process.stdout.write(chalk.bold('Most connected:\n'));
+                    for (const [nodeId, count] of topConnected) {
+                        const node = graph.nodes.find((n) => n.id === nodeId);
+                        process.stdout.write(`  ${chalk.cyan(String(node?.path ?? nodeId))} (${count} links)\n`);
+                    }
+                    process.stdout.write('\n');
+                }
+                // Orphan nodes (no connections)
+                const orphans = sorted.filter(([, count]) => count === 0);
+                if (orphans.length > 0) {
+                    process.stdout.write(chalk.bold(`Orphan nodes (${orphans.length}):\n`));
+                    for (const [nodeId] of orphans.slice(0, 10)) {
+                        const node = graph.nodes.find((n) => n.id === nodeId);
+                        process.stdout.write(`  ${chalk.dim(String(node?.path ?? nodeId))}\n`);
+                    }
+                    if (orphans.length > 10) {
+                        process.stdout.write(chalk.dim(`  ... and ${orphans.length - 10} more\n`));
+                    }
                 }
             }
         }

package/dist/commands/publish.js

@@ -164,13 +164,16 @@ export function registerPublishCommands(program) {
             const result = await client.publish.getSubdomain(vaultId);
             out.stopSpinner();
             if (flags.output === 'json') {
-                out.record({ subdomain: result.subdomain });
+                out.raw(JSON.stringify(result, null, 2) + '\n');
             }
             else if (result.subdomain == null) {
                 out.status('No subdomain configured.');
             }
             else {
-                out.record({ subdomain: result.subdomain });
+                out.record({
+                    subdomain: result.subdomain,
+                    url: `https://${result.subdomain}.lifestreamdynamics.com`,
+                });
             }
         }
         catch (err) {

package/dist/commands/vaults.js

@@ -169,10 +169,12 @@ EXAMPLES
     // vault tree
     addGlobalFlags(vaults.command('tree')
         .description('Show vault file tree')
-        .argument('<vaultId>', 'Vault ID or slug'))
+        .argument('<vaultId>', 'Vault ID or slug')
+        .option('--depth <n>', 'Maximum display depth (0 = root only)', parseInt))
         .action(async (vaultId, _opts) => {
         const flags = resolveFlags(_opts);
         const out = createOutput(flags);
+        const maxDepth = _opts.depth;
         out.startSpinner('Fetching vault tree...');
         try {
             vaultId = await resolveVaultId(vaultId);
@@ -184,6 +186,8 @@ EXAMPLES
             }
             else {
                 function printNode(node, depth) {
+                    if (maxDepth !== undefined && depth > maxDepth)
+                        return;
                     const indent = '  '.repeat(depth);
                     const icon = node.type === 'directory' ? chalk.yellow('📁') : chalk.cyan('📄');
                     process.stdout.write(`${indent}${icon} ${node.name}\n`);

package/dist/commands/versions.js

@@ -146,7 +146,8 @@ EXAMPLES
         .argument('<version>', 'Version number to restore')
         .addHelpText('after', `
 EXAMPLES
-  lsvault versions restore abc123 notes/todo.md 2`))
+  lsvault versions restore abc123 notes/todo.md 2
+  lsvault versions restore abc123 notes/todo.md 2 --dry-run`))
         .action(async (vaultId, docPath, versionStr, _opts) => {
         const flags = resolveFlags(_opts);
         const out = createOutput(flags);
@@ -156,6 +157,31 @@ EXAMPLES
             process.exitCode = 1;
             return;
         }
+        if (flags.dryRun) {
+            out.startSpinner(`Fetching version ${versionNum} preview...`);
+            try {
+                vaultId = await resolveVaultId(vaultId);
+                const client = await getClientAsync();
+                const version = await client.documents.getVersion(vaultId, docPath, versionNum);
+                out.stopSpinner();
+                if (flags.output === 'json') {
+                    out.raw(JSON.stringify({ dryRun: true, version: { version: version.versionNum, createdAt: version.createdAt, size: version.content?.length ?? 0 } }, null, 2) + '\n');
+                }
+                else {
+                    process.stdout.write(chalk.bold('Dry run — no changes made\n\n'));
+                    process.stdout.write(`Version: ${version.versionNum}\n`);
+                    process.stdout.write(`Created: ${version.createdAt}\n`);
+                    if (version.content) {
+                        const preview = version.content.slice(0, 200);
+                        process.stdout.write(`Content preview:\n${chalk.dim(preview)}${version.content.length > 200 ? '...' : ''}\n`);
+                    }
+                }
+            }
+            catch (err) {
+                handleError(out, err, 'Failed to preview version');
+            }
+            return;
+        }
         out.startSpinner(`Restoring to version ${versionNum}...`);
         try {
             vaultId = await resolveVaultId(vaultId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lifestreamdynamics/vault-cli",
-  "version": "1.3.9",
+  "version": "1.3.10",
   "description": "Command-line interface for Lifestream Vault",
   "engines": {
     "node": ">=22"