@devbrevity/note-cli 1.0.0 → 1.1.0

package/README.md

@@ -1,15 +1,21 @@
 # @devbrevity/note-cli
 
+[![npm](https://img.shields.io/npm/v/@devbrevity/note-cli)](https://www.npmjs.com/package/@devbrevity/note-cli)
+
 A terminal-based CLI for [LifeBrevity](https://www.lifebrevity.com) journal entries. Create, list, search, and manage your notes from the command line.
 
+## Requirements
+
+- [Node.js](https://nodejs.org/) 18 or later
+- An active [LifeBrevity](https://www.lifebrevity.com) subscription
+- Register for an account at [lifebrevity.com/register](https://www.lifebrevity.com/register)
+
 ## Install
 
 ```bash
 npm install -g @devbrevity/note-cli
 ```
 
-Requires Node.js 18+ and an active [LifeBrevity](https://www.lifebrevity.com) subscription.
-
 ## Quick Start
 
 ```bash
@@ -93,6 +99,14 @@ Show current user, token expiry, and config location.
 
 Clear all stored credentials.
 
+### `note --help`
+
+Show all available commands and options.
+
+### `note --version`
+
+Show the installed version.
+
 ## Authentication
 
 The CLI uses browser-based OAuth (same as the LifeBrevity web app). When you run `note login`, your browser opens to the LifeBrevity sign-in page. After authenticating, you're redirected back and the CLI stores your session locally.
@@ -101,6 +115,17 @@ The CLI uses browser-based OAuth (same as the LifeBrevity web app). When you run
 - **Session duration:** 7 days
 - **API key:** Provided automatically at login
 
+## Uninstall
+
+```bash
+npm uninstall -g @devbrevity/note-cli
+```
+
+## Links
+
+- [npm package](https://www.npmjs.com/package/@devbrevity/note-cli)
+- [LifeBrevity](https://www.lifebrevity.com)
+
 ## License
 
 MIT

package/bin/note.mjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import { program } from 'commander';
 import { loginCommand } from '../src/commands/login.mjs';
@@ -8,6 +8,7 @@ import { getCommand } from '../src/commands/get.mjs';
 import { searchCommand } from '../src/commands/search.mjs';
 import { logoutCommand } from '../src/commands/logout.mjs';
 import { whoamiCommand } from '../src/commands/whoami.mjs';
+import { importCommand } from '../src/commands/import.mjs';
 
 program
   .name('note')
@@ -21,5 +22,6 @@ program.addCommand(getCommand);
 program.addCommand(searchCommand);
 program.addCommand(logoutCommand);
 program.addCommand(whoamiCommand);
+program.addCommand(importCommand);
 
 program.parse();

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@devbrevity/note-cli",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "CLI tool for notesBrevity journal entries",
   "type": "module",
   "bin": {
-    "note": "./bin/note.mjs"
+    "note": "bin/note.mjs"
   },
   "files": [
     "bin/",

package/src/auth/cognitoLogin.mjs

@@ -1,170 +1,210 @@
-import { createServer } from 'http';
-import { randomBytes } from 'crypto';
-import { URL } from 'url';
-import open from 'open';
-import { CONFIG } from '../config.mjs';
-import { saveAuth } from './tokenStore.mjs';
-
-const TIMEOUT_MS = 120_000; // 2 minutes
-
-/**
- * Browser-based Cognito login flow.
- * Opens the Cognito Hosted UI, catches the callback on a local server,
- * exchanges the auth code via LifeBrevity backend for a local JWT.
- */
-export async function cognitoLogin() {
-  const state = randomBytes(32).toString('hex');
-  const redirectUri = `http://localhost:${CONFIG.CALLBACK_PORT}${CONFIG.CALLBACK_PATH}`;
-
-  const authorizeUrl = new URL(`https://${CONFIG.COGNITO_DOMAIN}/oauth2/authorize`);
-  authorizeUrl.searchParams.set('response_type', 'code');
-  authorizeUrl.searchParams.set('client_id', CONFIG.COGNITO_CLIENT_ID);
-  authorizeUrl.searchParams.set('redirect_uri', redirectUri);
-  authorizeUrl.searchParams.set('scope', CONFIG.COGNITO_SCOPES);
-  authorizeUrl.searchParams.set('state', state);
-
-  return new Promise((resolve, reject) => {
-    let timeout;
-
-    const server = createServer(async (req, res) => {
-      try {
-        const url = new URL(req.url, `http://localhost:${CONFIG.CALLBACK_PORT}`);
-
-        if (url.pathname !== CONFIG.CALLBACK_PATH) {
-          res.writeHead(404);
-          res.end('Not found');
-          return;
-        }
-
-        const code = url.searchParams.get('code');
-        const returnedState = url.searchParams.get('state');
-        const error = url.searchParams.get('error');
-
-        if (error) {
-          const errorDesc = url.searchParams.get('error_description') || error;
-          res.writeHead(200, { 'Content-Type': 'text/html' });
-          res.end(errorPage(errorDesc));
-          cleanup();
-          reject(new Error(`Login failed: ${errorDesc}`));
-          return;
-        }
-
-        if (returnedState !== state) {
-          res.writeHead(200, { 'Content-Type': 'text/html' });
-          res.end(errorPage('Security validation failed (state mismatch). Please try again.'));
-          cleanup();
-          reject(new Error('State mismatch - possible CSRF attack'));
-          return;
-        }
-
-        if (!code) {
-          res.writeHead(200, { 'Content-Type': 'text/html' });
-          res.end(errorPage('No authorization code received.'));
-          cleanup();
-          reject(new Error('No authorization code in callback'));
-          return;
-        }
-
-        // Exchange the code for a local JWT via LifeBrevity backend
-        const tokenResult = await exchangeCodeForToken(code, redirectUri);
-
-        // Save the token and API key (if returned by backend)
-        saveAuth({
-          token: tokenResult.token,
-          email: tokenResult.user.email,
-          apiKey: tokenResult.apiKeys?.notesBrevity,
-        });
-
-        res.writeHead(200, { 'Content-Type': 'text/html' });
-        res.end(successPage(tokenResult.user.email));
-        cleanup();
-        resolve(tokenResult);
-      } catch (err) {
-        res.writeHead(200, { 'Content-Type': 'text/html' });
-        res.end(errorPage(err.message));
-        cleanup();
-        reject(err);
-      }
-    });
-
-    function cleanup() {
-      clearTimeout(timeout);
-      server.close();
-    }
-
-    server.on('error', (err) => {
-      if (err.code === 'EADDRINUSE') {
-        reject(new Error(
-          `Port ${CONFIG.CALLBACK_PORT} is already in use. ` +
-          `Close the process using it and try again.`
-        ));
-      } else {
-        reject(err);
-      }
-    });
-
-    server.listen(CONFIG.CALLBACK_PORT, async () => {
-      // Open the browser
-      await open(authorizeUrl.toString());
-
-      timeout = setTimeout(() => {
-        cleanup();
-        reject(new Error('Login timed out after 2 minutes. Please try again.'));
-      }, TIMEOUT_MS);
-    });
-  });
-}
-
-/**
- * Exchange the Cognito authorization code for a local JWT
- * via the LifeBrevity backend's /api/oidc/callback endpoint.
- */
-async function exchangeCodeForToken(code, redirectUri) {
-  const response = await fetch(`${CONFIG.LIFEBREVITY_BACKEND}/api/oidc/callback`, {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ code, redirectUri }),
-  });
-
-  const data = await response.json();
-
-  if (!response.ok || !data.success) {
-    if (data.code === 'SubscriptionRequired') {
-      throw new Error(
-        'Active LifeBrevity subscription required.\n' +
-        'Subscribe at: https://www.lifebrevity.com/subscribe'
-      );
-    }
-    throw new Error(data.message || `Authentication failed (HTTP ${response.status})`);
-  }
-
-  return data;
-}
-
-function successPage(email) {
-  return `<!DOCTYPE html>
-<html>
-<head><title>Login Successful</title></head>
-<body style="font-family: -apple-system, sans-serif; display: flex; justify-content: center; align-items: center; height: 100vh; margin: 0; background: #f5f5f5;">
-  <div style="text-align: center; padding: 40px; background: white; border-radius: 12px; box-shadow: 0 2px 10px rgba(0,0,0,0.1);">
-    <h1 style="color: #2e7d32; margin-bottom: 8px;">Login Successful</h1>
-    <p style="color: #666; font-size: 18px;">Signed in as <strong>${email}</strong></p>
-    <p style="color: #999; margin-top: 20px;">You can close this window and return to your terminal.</p>
-  </div>
-</body>
-</html>`;
-}
-
-function errorPage(message) {
-  return `<!DOCTYPE html>
-<html>
-<head><title>Login Failed</title></head>
-<body style="font-family: -apple-system, sans-serif; display: flex; justify-content: center; align-items: center; height: 100vh; margin: 0; background: #f5f5f5;">
-  <div style="text-align: center; padding: 40px; background: white; border-radius: 12px; box-shadow: 0 2px 10px rgba(0,0,0,0.1);">
-    <h1 style="color: #c62828;">Login Failed</h1>
-    <p style="color: #666; font-size: 16px;">${message}</p>
-    <p style="color: #999; margin-top: 20px;">Close this window and try <code>note login</code> again.</p>
-  </div>
-</body>
-</html>`;
-}
+import { createServer } from 'http';
+import { randomBytes } from 'crypto';
+import { URL } from 'url';
+import open from 'open';
+import { CONFIG } from '../config.mjs';
+import { saveAuth } from './tokenStore.mjs';
+
+const TIMEOUT_MS = 120_000; // 2 minutes
+
+/**
+ * Browser-based Cognito login flow.
+ * Opens the Cognito Hosted UI, catches the callback on a local server,
+ * exchanges the auth code via LifeBrevity backend for a local JWT.
+ */
+export async function cognitoLogin() {
+  const state = randomBytes(32).toString('hex');
+  const redirectUri = `http://localhost:${CONFIG.CALLBACK_PORT}${CONFIG.CALLBACK_PATH}`;
+
+  const authorizeUrl = new URL(`https://${CONFIG.COGNITO_DOMAIN}/oauth2/authorize`);
+  authorizeUrl.searchParams.set('response_type', 'code');
+  authorizeUrl.searchParams.set('client_id', CONFIG.COGNITO_CLIENT_ID);
+  authorizeUrl.searchParams.set('redirect_uri', redirectUri);
+  authorizeUrl.searchParams.set('scope', CONFIG.COGNITO_SCOPES);
+  authorizeUrl.searchParams.set('state', state);
+
+  return new Promise((resolve, reject) => {
+    let timeout;
+
+    const server = createServer(async (req, res) => {
+      try {
+        const url = new URL(req.url, `http://localhost:${CONFIG.CALLBACK_PORT}`);
+
+        if (url.pathname !== CONFIG.CALLBACK_PATH) {
+          res.writeHead(404);
+          res.end('Not found');
+          return;
+        }
+
+        const code = url.searchParams.get('code');
+        const returnedState = url.searchParams.get('state');
+        const error = url.searchParams.get('error');
+
+        if (error) {
+          const errorDesc = url.searchParams.get('error_description') || error;
+          res.writeHead(200, { 'Content-Type': 'text/html' });
+          res.end(errorPage(errorDesc));
+          cleanup();
+          reject(new Error(`Login failed: ${errorDesc}`));
+          return;
+        }
+
+        if (returnedState !== state) {
+          res.writeHead(200, { 'Content-Type': 'text/html' });
+          res.end(errorPage('Security validation failed (state mismatch). Please try again.'));
+          cleanup();
+          reject(new Error('State mismatch - possible CSRF attack'));
+          return;
+        }
+
+        if (!code) {
+          res.writeHead(200, { 'Content-Type': 'text/html' });
+          res.end(errorPage('No authorization code received.'));
+          cleanup();
+          reject(new Error('No authorization code in callback'));
+          return;
+        }
+
+        // Exchange the code for a local JWT via LifeBrevity backend
+        const tokenResult = await exchangeCodeForToken(code, redirectUri);
+
+        // Save the token and API key (if returned by backend)
+        saveAuth({
+          token: tokenResult.token,
+          email: tokenResult.user.email,
+          apiKey: tokenResult.apiKeys?.notesBrevity,
+        });
+
+        res.writeHead(200, { 'Content-Type': 'text/html' });
+        res.end(successPage(tokenResult.user.email));
+        cleanup();
+        resolve(tokenResult);
+      } catch (err) {
+        res.writeHead(200, { 'Content-Type': 'text/html' });
+        res.end(errorPage(err.message));
+        cleanup();
+        reject(err);
+      }
+    });
+
+    function cleanup() {
+      clearTimeout(timeout);
+      server.close();
+    }
+
+    server.on('error', (err) => {
+      if (err.code === 'EADDRINUSE') {
+        reject(new Error(
+          `Port ${CONFIG.CALLBACK_PORT} is already in use. ` +
+          `Close the process using it and try again.`
+        ));
+      } else {
+        reject(err);
+      }
+    });
+
+    server.listen(CONFIG.CALLBACK_PORT, async () => {
+      // Open the browser
+      await open(authorizeUrl.toString());
+
+      timeout = setTimeout(() => {
+        cleanup();
+        reject(new Error('Login timed out after 2 minutes. Please try again.'));
+      }, TIMEOUT_MS);
+    });
+  });
+}
+
+/**
+ * Exchange the Cognito authorization code for a local JWT
+ * via the LifeBrevity backend's /api/oidc/callback endpoint.
+ */
+async function exchangeCodeForToken(code, redirectUri) {
+  const response = await fetch(`${CONFIG.LIFEBREVITY_BACKEND}/api/oidc/callback`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ code, redirectUri }),
+  });
+
+  const data = await response.json();
+
+  if (!response.ok || !data.success) {
+    if (data.code === 'SubscriptionRequired') {
+      throw new Error(
+        'Active LifeBrevity subscription required.\n' +
+        'Subscribe at: https://www.lifebrevity.com/subscribe'
+      );
+    }
+    throw new Error(data.message || `Authentication failed (HTTP ${response.status})`);
+  }
+
+  return data;
+}
+
+const PAGE_STYLES = `
+  <link href="https://fonts.googleapis.com/css2?family=Roboto:wght@300;400;500&display=swap" rel="stylesheet">
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: 'Roboto', 'Segoe UI', -apple-system, sans-serif;
+      display: flex; justify-content: center; align-items: center;
+      height: 100vh; background: #f5f5f5;
+    }
+    .card {
+      text-align: center; padding: 48px 40px; background: white;
+      border-radius: 8px; box-shadow: 0 2px 8px rgba(0,0,0,0.05);
+      max-width: 420px; width: 90%;
+      animation: fadeInUp 0.8s ease-out;
+    }
+    .subtitle { color: #999; font-size: 12px; font-weight: 300; letter-spacing: 1px; text-transform: uppercase; margin-bottom: 24px; }
+    .divider { width: 40px; height: 2px; background: #2A6A88; margin: 0 auto 24px; }
+    .status { font-size: 22px; font-weight: 500; margin-bottom: 8px; }
+    .status.success { color: #2A6A88; }
+    .status.error { color: #FF5252; }
+    .detail { color: #666; font-size: 16px; margin-bottom: 4px; }
+    .hint { color: #999; font-size: 14px; margin-top: 20px; }
+    .hint code { background: #f0f0f0; padding: 2px 6px; border-radius: 3px; font-size: 13px; }
+    .countdown { color: #bbb; font-size: 12px; margin-top: 12px; }
+    @keyframes fadeInUp {
+      from { opacity: 0; transform: translateY(20px); }
+      to { opacity: 1; transform: translateY(0); }
+    }
+  </style>`;
+
+function successPage(email) {
+  return `<!DOCTYPE html>
+<html>
+<head><title>LifeBrevity - Login Successful</title><link rel="icon" href="data:,">${PAGE_STYLES}</head>
+<body>
+  <div class="card">
+    <div class="subtitle">note CLI</div>
+    <div class="divider"></div>
+    <div class="status success">Login Successful</div>
+    <p class="detail">Signed in as <strong>${email}</strong></p>
+    <p class="hint">You can close this window and return to your terminal.</p>
+    <p class="countdown" id="countdown">This window will close in 3 seconds...</p>
+  </div>
+  <script>
+    let s = 3;
+    const el = document.getElementById('countdown');
+    const t = setInterval(() => { if (--s <= 0) { clearInterval(t); window.close(); } el.textContent = 'This window will close in ' + s + ' seconds...'; }, 1000);
+  </script>
+</body>
+</html>`;
+}
+
+function errorPage(message) {
+  return `<!DOCTYPE html>
+<html>
+<head><title>LifeBrevity - Login Failed</title><link rel="icon" href="data:,">${PAGE_STYLES}</head>
+<body>
+  <div class="card">
+    <div class="subtitle">note CLI</div>
+    <div class="divider"></div>
+    <div class="status error">Login Failed</div>
+    <p class="detail">${message}</p>
+    <p class="hint">Close this window and try <code>note login</code> again.</p>
+  </div>
+</body>
+</html>`;
+}

package/src/commands/import.mjs

@@ -0,0 +1,80 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { readFileSync, existsSync } from 'fs';
+import { resolve, basename, extname } from 'path';
+import { apiRequest } from '../auth/apiClient.mjs';
+
+const SUPPORTED_EXTENSIONS = ['.md', '.txt'];
+
+export const importCommand = new Command('import')
+  .description('Import a markdown or text file as a journal entry')
+  .argument('<file>', 'Path to a .md or .txt file')
+  .option('-t, --title <title>', 'Entry title (defaults to filename)')
+  .option('-s, --summarize', 'Generate AI summary')
+  .option('--tags <tags>', 'Comma-separated tags (e.g. "work,ideas")')
+  .action(async (file, options) => {
+    const filePath = resolve(file);
+    const ext = extname(filePath).toLowerCase();
+
+    if (!existsSync(filePath)) {
+      console.error(chalk.red(`File not found: ${filePath}`));
+      process.exit(1);
+    }
+
+    if (!SUPPORTED_EXTENSIONS.includes(ext)) {
+      console.error(chalk.red(`Unsupported file type "${ext}". Use .md or .txt files.`));
+      process.exit(1);
+    }
+
+    let body;
+    try {
+      body = readFileSync(filePath, 'utf8');
+    } catch (err) {
+      console.error(chalk.red(`Could not read file: ${err.message}`));
+      process.exit(1);
+    }
+
+    if (!body.trim()) {
+      console.error(chalk.red('File is empty.'));
+      process.exit(1);
+    }
+
+    const title = options.title || basename(filePath, ext);
+
+    const spinner = ora('Importing entry...').start();
+
+    try {
+      const payload = {
+        title,
+        body,
+        generateSummary: !!options.summarize,
+      };
+
+      if (options.tags) {
+        payload.tags = options.tags.split(',').map(t => t.trim());
+      }
+
+      const data = await apiRequest('POST', '/entries', payload);
+      const entry = data.entry;
+
+      spinner.succeed(chalk.green('Entry imported!'));
+      console.log('');
+      console.log(`  ${chalk.dim('ID:')}      ${entry.entryId}`);
+      console.log(`  ${chalk.dim('Title:')}   ${entry.title}`);
+      console.log(`  ${chalk.dim('Created:')} ${new Date(entry.createdAt).toLocaleString()}`);
+
+      if (entry.tags?.length > 0) {
+        console.log(`  ${chalk.dim('Tags:')}    ${entry.tags.join(', ')}`);
+      }
+
+      if (entry.summary) {
+        console.log('');
+        console.log(`  ${chalk.dim('Summary:')}`);
+        console.log(`  ${entry.summary}`);
+      }
+    } catch (err) {
+      spinner.fail(chalk.red(err.message));
+      process.exit(1);
+    }
+  });

package/src/commands/list.mjs

@@ -32,7 +32,7 @@ export const listCommand = new Command('list')
       for (const entry of data.entries) {
         const date = new Date(entry.createdAt).toLocaleDateString();
         const tags = entry.tags?.length ? chalk.dim(` [${entry.tags.join(', ')}]`) : '';
-        console.log(`  ${chalk.cyan(entry.entryId.slice(0, 8))}  ${date}  ${chalk.bold(entry.title)}${tags}`);
+        console.log(`  ${chalk.cyan(entry.entryId)}  ${date}  ${chalk.bold(entry.title)}${tags}`);
         if (entry.summary) {
           console.log(`           ${chalk.dim(entry.summary.slice(0, 80))}${entry.summary.length > 80 ? '...' : ''}`);
         }