cognary-cli 1.0.0

package/README.md

@@ -0,0 +1,88 @@
+# Cognary CLI
+
+Command-line interface for Cognary Tasks.
+
+## Installation
+
+```bash
+cd cognary-cli
+npm install
+npm link  # Optional: makes 'cognary-cli' available globally
+```
+
+## Authentication
+
+The CLI requires an API key to authenticate with the Cognary Tasks API. You can provide it in two ways:
+
+1. **Environment variable** (recommended):
+   ```bash
+   export COGNARY_API_KEY=nts_your_api_key_here
+   ```
+
+2. **Command line option**:
+   ```bash
+   cognary-cli --api-key nts_your_api_key_here tasks list
+   ```
+
+## Configuration
+
+You can also configure the API URL:
+
+```bash
+# Environment variable
+export COGNARY_API_URL=https://your-api-url.com
+
+# Or command line option
+cognary-cli --api-url https://your-api-url.com tasks list
+```
+
+## Commands
+
+### List Tasks
+
+```bash
+cognary-cli tasks list
+```
+
+Options:
+- `-l, --limit <number>` - Number of tasks to return (default: 20)
+- `-p, --page <number>` - Page number (default: 1)
+- `-s, --status <status>` - Filter by status: active, completed, all (default: all)
+- `-c, --category <category>` - Filter by category
+- `--priority <priority>` - Filter by priority: High, Medium, Low
+- `--search <query>` - Search tasks
+- `--sort <field>` - Sort by: createdAt, updatedAt, dueDate, priority, title
+- `--order <order>` - Sort order: asc, desc (default: desc)
+- `--json` - Output as JSON
+
+Examples:
+```bash
+# List all tasks
+cognary-cli tasks list
+
+# List only active tasks
+cognary-cli tasks list --status active
+
+# Search for tasks containing "meeting"
+cognary-cli tasks list --search meeting
+
+# List high priority tasks sorted by due date
+cognary-cli tasks list --priority High --sort dueDate --order asc
+
+# Output as JSON
+cognary-cli tasks list --json
+```
+
+### Get a Single Task
+
+```bash
+cognary-cli tasks get <task-id>
+```
+
+Options:
+- `--json` - Output as JSON
+
+Example:
+```bash
+cognary-cli tasks get abc123-def456-ghi789
+```

package/bin/cognary-cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+import '../src/index.js';

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "cognary-cli",
+  "version": "1.0.0",
+  "description": "CLI for Cognary AI Tasks, Notes and Leads",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "cognary-cli": "./bin/cognary-cli.js"
+  },
+  "scripts": {
+    "start": "node bin/cognary-cli.js"
+  },
+  "keywords": [
+    "cognary",
+    "tasks",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "dotenv": "^16.4.5"
+  }
+}

package/src/api.js

@@ -0,0 +1,105 @@
+/**
+ * API client for Cognary Tasks
+ */
+export class CognaryApi {
+  constructor(apiUrl, apiKey) {
+    this.apiUrl = apiUrl;
+    this.apiKey = apiKey;
+    this.baseEndpoint = '/api/v1/public';
+  }
+
+  async request(endpoint, options = {}) {
+    const url = `${this.apiUrl}${this.baseEndpoint}${endpoint}`;
+
+    const response = await fetch(url, {
+      ...options,
+      headers: {
+        'Authorization': `Bearer ${this.apiKey}`,
+        'Content-Type': 'application/json',
+        ...options.headers,
+      },
+    });
+
+    if (!response.ok) {
+      const errorBody = await response.json().catch(() => ({}));
+      const error = new Error(errorBody.message || `API request failed with status ${response.status}`);
+      error.status = response.status;
+      error.code = errorBody.error;
+      throw error;
+    }
+
+    return response.json();
+  }
+
+  /**
+   * List tasks with optional filters
+   */
+  async listTasks(options = {}) {
+    const params = new URLSearchParams();
+
+    if (options.page) params.set('page', options.page);
+    if (options.limit) params.set('limit', options.limit);
+    if (options.status) params.set('status', options.status);
+    if (options.category) params.set('category', options.category);
+    if (options.priority) params.set('priority', options.priority);
+    if (options.search) params.set('search', options.search);
+    if (options.sort) params.set('sort', options.sort);
+    if (options.order) params.set('order', options.order);
+    if (options.completedLimit) params.set('completed_limit', options.completedLimit);
+
+    const queryString = params.toString();
+    const endpoint = `/tasks${queryString ? `?${queryString}` : ''}`;
+
+    return this.request(endpoint);
+  }
+
+  /**
+   * Get a single task by ID
+   */
+  async getTask(taskId) {
+    return this.request(`/tasks/${taskId}`);
+  }
+
+  /**
+   * Create a new task
+   */
+  async createTask({ title, notes, category, priority, dueDate }) {
+    const body = { title };
+    if (notes) body.notes = notes;
+    if (category) body.category = category;
+    if (priority) body.priority = priority;
+    if (dueDate) body.dueDate = dueDate;
+
+    return this.request('/tasks', {
+      method: 'POST',
+      body: JSON.stringify(body),
+    });
+  }
+
+  /**
+   * Update an existing task
+   */
+  async updateTask(taskId, fields) {
+    const body = {};
+    if (fields.title !== undefined) body.title = fields.title;
+    if (fields.notes !== undefined) body.notes = fields.notes;
+    if (fields.category !== undefined) body.category = fields.category;
+    if (fields.priority !== undefined) body.priority = fields.priority;
+    if (fields.dueDate !== undefined) body.dueDate = fields.dueDate;
+    if (fields.isCompleted !== undefined) body.isCompleted = fields.isCompleted;
+
+    return this.request(`/tasks/${taskId}`, {
+      method: 'PATCH',
+      body: JSON.stringify(body),
+    });
+  }
+
+  /**
+   * Delete a task
+   */
+  async deleteTask(taskId) {
+    return this.request(`/tasks/${taskId}`, {
+      method: 'DELETE',
+    });
+  }
+}

package/src/commands/tasks.js

@@ -0,0 +1,339 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { getConfig } from '../config.js';
+import { CognaryApi } from '../api.js';
+
+export const tasksCommand = new Command('tasks')
+  .description('Manage tasks');
+
+// List tasks command
+tasksCommand
+  .command('list')
+  .description('List tasks')
+  .option('-l, --limit <number>', 'Number of tasks to return', '20')
+  .option('-p, --page <number>', 'Page number', '1')
+  .option('-s, --status <status>', 'Filter by status (active, completed, all)', 'all')
+  .option('-c, --category <category>', 'Filter by category')
+  .option('--priority <priority>', 'Filter by priority (High, Medium, Low)')
+  .option('--search <query>', 'Search tasks')
+  .option('--sort <field>', 'Sort by field (createdAt, updatedAt, dueDate, priority, title)', 'createdAt')
+  .option('--order <order>', 'Sort order (asc, desc)', 'desc')
+  .option('--active-only', 'Show only active tasks')
+  .option('--completed-limit <number>', 'Limit number of completed tasks returned')
+  .option('--json', 'Output as JSON')
+  .action(async (options, cmd) => {
+    try {
+      const config = getConfig(cmd);
+      const api = new CognaryApi(config.apiUrl, config.apiKey);
+
+      const status = options.activeOnly ? 'active' : options.status;
+
+      const result = await api.listTasks({
+        limit: parseInt(options.limit, 10),
+        page: parseInt(options.page, 10),
+        status,
+        completedLimit: options.completedLimit ? parseInt(options.completedLimit, 10) : undefined,
+        category: options.category,
+        priority: options.priority,
+        search: options.search,
+        sort: options.sort,
+        order: options.order,
+      });
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      // Display tasks in a readable format
+      const { data: tasks, pagination } = result;
+
+      if (tasks.length === 0) {
+        console.log(chalk.yellow('No tasks found.'));
+        return;
+      }
+
+      console.log(chalk.bold(`\nTasks (${pagination.total} total)\n`));
+
+      for (const task of tasks) {
+        const status = task.isCompleted
+          ? chalk.green('✓')
+          : chalk.gray('○');
+
+        const priority = formatPriority(task.priority);
+        const dueDate = task.dueDate
+          ? chalk.cyan(new Date(task.dueDate).toLocaleDateString())
+          : chalk.gray('No due date');
+
+        console.log(`${status} ${chalk.bold(task.title)}`);
+        console.log(`  ${chalk.gray('ID:')} ${task.id}`);
+        console.log(`  ${chalk.gray('Category:')} ${task.category} | ${chalk.gray('Priority:')} ${priority} | ${chalk.gray('Due:')} ${dueDate}`);
+
+        if (task.notes) {
+          const truncatedNotes = task.notes.length > 100
+            ? task.notes.substring(0, 100) + '...'
+            : task.notes;
+          console.log(`  ${chalk.gray('Notes:')} ${truncatedNotes}`);
+        }
+        console.log('');
+      }
+
+      // Pagination info
+      console.log(chalk.gray(`Page ${pagination.page} of ${pagination.totalPages} (${pagination.limit} per page)`));
+
+      if (pagination.hasMore) {
+        console.log(chalk.gray(`Use --page ${pagination.page + 1} to see more`));
+      }
+
+    } catch (error) {
+      handleError(error);
+    }
+  });
+
+// Get single task command
+tasksCommand
+  .command('get <id>')
+  .description('Get a task by ID')
+  .option('--json', 'Output as JSON')
+  .action(async (id, options, cmd) => {
+    try {
+      const config = getConfig(cmd);
+      const api = new CognaryApi(config.apiUrl, config.apiKey);
+
+      const result = await api.getTask(id);
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      const task = result.data;
+      const status = task.isCompleted
+        ? chalk.green('✓ Completed')
+        : chalk.yellow('○ Active');
+
+      console.log(`\n${chalk.bold(task.title)}`);
+      console.log(chalk.gray('─'.repeat(50)));
+      console.log(`${chalk.gray('ID:')} ${task.id}`);
+      console.log(`${chalk.gray('Status:')} ${status}`);
+      console.log(`${chalk.gray('Category:')} ${task.category}`);
+      console.log(`${chalk.gray('Priority:')} ${formatPriority(task.priority)}`);
+
+      if (task.dueDate) {
+        console.log(`${chalk.gray('Due Date:')} ${new Date(task.dueDate).toLocaleString()}`);
+      }
+
+      console.log(`${chalk.gray('Created:')} ${new Date(task.createdAt).toLocaleString()}`);
+      console.log(`${chalk.gray('Updated:')} ${new Date(task.updatedAt).toLocaleString()}`);
+
+      if (task.notes) {
+        console.log(`\n${chalk.gray('Notes:')}`);
+        console.log(task.notes);
+      }
+
+      if (task.labels && task.labels.length > 0) {
+        console.log(`\n${chalk.gray('Labels:')} ${task.labels.map(l => l.name).join(', ')}`);
+      }
+
+      console.log('');
+
+    } catch (error) {
+      handleError(error);
+    }
+  });
+
+// Add task command
+tasksCommand
+  .command('add <title>')
+  .description('Create a new task')
+  .option('-n, --notes <notes>', 'Task notes')
+  .option('-c, --category <category>', 'Task category')
+  .option('--priority <priority>', 'Task priority (High, Medium, Low)')
+  .option('--due-date <date>', 'Due date')
+  .option('--json', 'Output as JSON')
+  .action(async (title, options, cmd) => {
+    try {
+      const config = getConfig(cmd);
+      const api = new CognaryApi(config.apiUrl, config.apiKey);
+
+      const result = await api.createTask({
+        title,
+        notes: options.notes,
+        category: options.category,
+        priority: options.priority,
+        dueDate: options.dueDate,
+      });
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      const task = result.data;
+      console.log(chalk.green(`\n✓ Task created successfully!\n`));
+      console.log(`${chalk.bold(task.title)}`);
+      console.log(`  ${chalk.gray('ID:')} ${task.id}`);
+      if (task.category) console.log(`  ${chalk.gray('Category:')} ${task.category}`);
+      if (task.priority) console.log(`  ${chalk.gray('Priority:')} ${formatPriority(task.priority)}`);
+      if (task.dueDate) console.log(`  ${chalk.gray('Due:')} ${chalk.cyan(new Date(task.dueDate).toLocaleDateString())}`);
+      if (task.notes) console.log(`  ${chalk.gray('Notes:')} ${task.notes}`);
+      console.log('');
+
+    } catch (error) {
+      handleError(error);
+    }
+  });
+
+// Update task command
+tasksCommand
+  .command('update <id>')
+  .description('Update an existing task')
+  .option('-t, --title <title>', 'New title')
+  .option('-n, --notes <notes>', 'New notes')
+  .option('-c, --category <category>', 'New category')
+  .option('--priority <priority>', 'New priority (High, Medium, Low)')
+  .option('--due-date <date>', 'New due date')
+  .option('--json', 'Output as JSON')
+  .action(async (id, options, cmd) => {
+    try {
+      const config = getConfig(cmd);
+      const api = new CognaryApi(config.apiUrl, config.apiKey);
+
+      const result = await api.updateTask(id, {
+        title: options.title,
+        notes: options.notes,
+        category: options.category,
+        priority: options.priority,
+        dueDate: options.dueDate,
+      });
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      const task = result.data;
+      console.log(chalk.green(`\n✓ Task updated successfully!\n`));
+      console.log(`${chalk.bold(task.title)}`);
+      console.log(`  ${chalk.gray('ID:')} ${task.id}`);
+      if (task.category) console.log(`  ${chalk.gray('Category:')} ${task.category}`);
+      if (task.priority) console.log(`  ${chalk.gray('Priority:')} ${formatPriority(task.priority)}`);
+      if (task.dueDate) console.log(`  ${chalk.gray('Due:')} ${chalk.cyan(new Date(task.dueDate).toLocaleDateString())}`);
+      console.log('');
+
+    } catch (error) {
+      handleError(error);
+    }
+  });
+
+// Delete task command
+tasksCommand
+  .command('delete <id>')
+  .description('Delete a task')
+  .option('--json', 'Output as JSON')
+  .action(async (id, options, cmd) => {
+    try {
+      const config = getConfig(cmd);
+      const api = new CognaryApi(config.apiUrl, config.apiKey);
+
+      const result = await api.deleteTask(id);
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      console.log(chalk.green(`\n✓ Task ${id} deleted successfully!\n`));
+
+    } catch (error) {
+      handleError(error);
+    }
+  });
+
+// Complete task command
+tasksCommand
+  .command('complete <id>')
+  .description('Mark a task as completed')
+  .option('--json', 'Output as JSON')
+  .action(async (id, options, cmd) => {
+    try {
+      const config = getConfig(cmd);
+      const api = new CognaryApi(config.apiUrl, config.apiKey);
+
+      const result = await api.updateTask(id, { isCompleted: true });
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      const task = result.data;
+      console.log(chalk.green(`\n✓ Task marked as completed!\n`));
+      console.log(`${chalk.green('✓')} ${chalk.bold(task.title)}`);
+      console.log(`  ${chalk.gray('ID:')} ${task.id}`);
+      console.log('');
+
+    } catch (error) {
+      handleError(error);
+    }
+  });
+
+// Uncomplete task command
+tasksCommand
+  .command('uncomplete <id>')
+  .description('Mark a task as active')
+  .option('--json', 'Output as JSON')
+  .action(async (id, options, cmd) => {
+    try {
+      const config = getConfig(cmd);
+      const api = new CognaryApi(config.apiUrl, config.apiKey);
+
+      const result = await api.updateTask(id, { isCompleted: false });
+
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+      }
+
+      const task = result.data;
+      console.log(chalk.green(`\n✓ Task marked as active!\n`));
+      console.log(`${chalk.yellow('○')} ${chalk.bold(task.title)}`);
+      console.log(`  ${chalk.gray('ID:')} ${task.id}`);
+      console.log('');
+
+    } catch (error) {
+      handleError(error);
+    }
+  });
+
+function formatPriority(priority) {
+  if (!priority) return chalk.gray('None');
+
+  switch (priority) {
+    case 'High':
+      return chalk.red('High');
+    case 'Medium':
+      return chalk.yellow('Medium');
+    case 'Low':
+      return chalk.blue('Low');
+    default:
+      return priority;
+  }
+}
+
+function handleError(error) {
+  if (error.status === 401) {
+    console.error(chalk.red('Error: Authentication failed. Please check your API key.'));
+  } else if (error.status === 403) {
+    console.error(chalk.red('Error: Access denied. Your API key may not have the required permissions.'));
+  } else if (error.status === 404) {
+    console.error(chalk.red('Error: Resource not found.'));
+  } else if (error.status === 429) {
+    console.error(chalk.red('Error: Rate limit exceeded. Please try again later.'));
+  } else if (error.code === 'ECONNREFUSED') {
+    console.error(chalk.red('Error: Could not connect to the API. Is the server running?'));
+  } else {
+    console.error(chalk.red(`Error: ${error.message}`));
+  }
+  process.exit(1);
+}

package/src/config.js

@@ -0,0 +1,25 @@
+/**
+ * Get configuration from command options or environment variables
+ */
+export function getConfig(cmd) {
+  // Walk up the command chain to find the root program options
+  let root = cmd;
+  while (root.parent) {
+    root = root.parent;
+  }
+  const opts = root.opts();
+
+  const apiKey = opts.apiKey || process.env.COGNARY_API_KEY;
+  const apiUrl = opts.apiUrl || process.env.COGNARY_API_URL || 'https://tasks.cognary.ai';
+
+  if (!apiKey) {
+    console.error('Error: API key is required.');
+    console.error('Provide it via --api-key option or set COGNARY_API_KEY environment variable.');
+    process.exit(1);
+  }
+
+  return {
+    apiKey,
+    apiUrl: apiUrl.replace(/\/$/, ''), // Remove trailing slash
+  };
+}

package/src/index.js

@@ -0,0 +1,20 @@
+import { Command } from 'commander';
+import dotenv from 'dotenv';
+import { tasksCommand } from './commands/tasks.js';
+
+// Load environment variables from .env file
+dotenv.config();
+
+const program = new Command();
+
+program
+  .name('cognary-cli')
+  .description('CLI for Cognary Tasks')
+  .version('1.0.0')
+  .option('-k, --api-key <key>', 'API key for authentication (or set COGNARY_API_KEY env var)')
+  .option('-u, --api-url <url>', 'API base URL (or set COGNARY_API_URL env var)');
+
+// Add commands
+program.addCommand(tasksCommand);
+
+program.parse();