taskair-cli 1.0.0

package/README.md

@@ -0,0 +1,186 @@
+# TaskAir CLI ✦
+
+> Space-themed, privacy-first task management CLI with zero-knowledge, client-side end-to-end encryption.
+
+TaskAir CLI is the developer's command-line interface for the TaskAir ecosystem. It features a stunning space-themed terminal UI built with [Ink](https://github.com/vadimdemedes/ink) and React, zero-knowledge client-side E2E encryption using AES-256-GCM, and seamless cloud synchronization with Supabase.
+
+---
+
+## 🚀 Installation
+
+Install the package globally via npm:
+
+```bash
+npm install -g taskair-cli
+```
+
+---
+
+## 🪐 Setup & Configuration
+
+Before managing your tasks, you need to point the CLI to your TaskAir Web server and set up your encryption master password.
+
+### 1. Configure the CLI
+
+Run the configuration command and follow the prompts:
+
+```bash
+taskair configure
+```
+
+You will be prompted to enter:
+*   **API URL**: The URL of your running TaskAir server (e.g., `http://localhost:4321` or your production domain).
+*   **Email**: Your TaskAir account email address.
+*   **Master Password**: Your local master password. This password is used client-side to derive the encryption keys for E2E encryption. *It is never sent to the server.*
+
+### 2. Log In
+
+Log in to establish a session with the remote backend:
+
+```bash
+taskair login
+```
+
+### 3. Verify Session
+
+You can check your configuration and login status at any time:
+
+```bash
+taskair whoami
+```
+
+---
+
+## ⌨️ Command Reference
+
+TaskAir CLI provides a complete set of commands to manage, filter, analyze, and sync your tasks.
+
+### 1. Add a Task
+
+Create a new task with options for priority, due date, and tags.
+
+```bash
+taskair add "Launch satellite orbit phase 1" --priority high --tags "space,work" --due "2026-07-01"
+```
+
+*   **Alias**: `-a`
+*   **Options**:
+    *   `-p, --priority <level>`: Priority level (`high` | `medium` | `low`, default: `medium`).
+    *   `-d, --due <datetime>`: Due date in ISO 8601 or `YYYY-MM-DD` format.
+    *   `-t, --tags <tags>`: Comma-separated list of tags.
+
+### 2. List Tasks
+
+View your tasks in a table or list format with optional status and priority filtering.
+
+```bash
+# List all pending high priority tasks
+taskair list --status pending --priority high
+
+# List tasks in JSON format for scripting/exporting
+taskair list --format json
+```
+
+*   **Alias**: `-l`
+*   **Options**:
+    *   `-s, --status <status>`: Filter by status (`pending` | `in_progress` | `completed` | `all`, default: `all`).
+    *   `-p, --priority <priority>`: Filter by priority (`high` | `medium` | `low` | `all`, default: `all`).
+    *   `-t, --tags <tags>`: Filter by comma-separated tags.
+    *   `-f, --format <format>`: Output format (`table` | `compact` | `json`, default: `table`).
+
+### 3. Mark a Task as Completed
+
+Complete a task and optionally add a completion note.
+
+```bash
+taskair done <task-id-prefix> --note "Orbit established successfully."
+```
+
+*   **Alias**: `-d`
+*   **Options**:
+    *   `-n, --note <note>`: Optional completion note.
+
+### 4. Edit a Task
+
+Modify any field of an existing task using its ID.
+
+```bash
+taskair edit <task-id-prefix> --priority high --tags "milestone,space"
+```
+
+*   **Alias**: `-e`
+*   **Options**:
+    *   `--description <text>`: Set a new description.
+    *   `--priority <level>`: Change priority (`high` | `medium` | `low`).
+    *   `--status <status>`: Update status (`pending` | `in_progress` | `completed`).
+    *   `--due <datetime>`: Set or update due date.
+    *   `--tags <tags>`: Overwrite tags with a comma-separated list.
+    *   `--note <note>`: Add/update completion note.
+
+### 5. Delete a Task
+
+Remove a task from your database. By default, this will ask for confirmation unless the `--force` flag is passed.
+
+```bash
+taskair remove <task-id-prefix> --force
+```
+
+*   **Alias**: `-r`
+*   **Options**:
+    *   `--force`: Skip confirmation prompt.
+
+### 6. Synchronize with Cloud
+
+Push local offline changes and pull updates from your Supabase cloud database.
+
+```bash
+taskair sync --password <your-master-password>
+```
+
+*   **Options**:
+    *   `--password <password>`: The master password to encrypt/decrypt task bundles.
+    *   `--dry-run`: View what would be synced without modifying local or remote data.
+
+### 7. View Analytics & Stats
+
+See task counts, priority breakdowns, and completion rate progress bars directly in your terminal:
+
+```bash
+taskair stats
+```
+
+### 8. Export Tasks
+
+Export your entire task database to JSON, CSV, or Markdown format.
+
+```bash
+taskair export --format csv --output ./tasks_backup.csv
+```
+
+*   **Options**:
+    *   `-f, --format <format>`: Export format (`json` | `csv` | `markdown`, default: `json`).
+    *   `-o, --output <file>`: Target file path. If omitted, outputs to stdout.
+
+### 9. Log Out
+
+End your session and clear local access tokens:
+
+```bash
+taskair logout
+```
+
+---
+
+## 🔒 Security Architecture
+
+TaskAir is built on **zero-knowledge architecture**:
+1.  **Local Storage**: Tasks are stored locally on your machine.
+2.  **Client-side Encryption**: During sync, your tasks are serialized into a JSON bundle, encrypted using **AES-256-GCM** with a key derived from your **Master Password** via PBKDF2.
+3.  **Encrypted Sync**: The encrypted ciphertext along with a SHA-256 checksum is uploaded to the Supabase Cloud.
+4.  **Zero Server Knowledge**: Neither Supabase nor the web application server ever holds your master password or the encryption key. Your data remains completely private and secure.
+
+---
+
+## 📄 License
+
+This project is licensed under the MIT License.

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node