stratanodex 0.1.0

package/README.md

@@ -0,0 +1,251 @@
+# StrataNodex CLI
+
+> A keyboard-driven, terminal-based task manager for power users.
+
+[![npm version](https://img.shields.io/npm/v/stratanodex)](https://www.npmjs.com/package/stratanodex)
+[![Node.js >=20](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+---
+
+## What is StrataNodex CLI?
+
+StrataNodex CLI is the terminal-first interface for **StrataNodex** — a hierarchical task manager built around the idea that tasks live in a **tree**, not a flat list.
+
+```
+  ██▀▀ ▀█▀ █▀█ ▄▀█ ▀█▀ ▄▀█   █▄ █ █▀█ █▀▄ █▀▀ ▀▄▀
+  ▄██  █  █▀▄ █▀█  █  █▀█   █ ▀█ █▄█ █▄▀ ██▄ █ █       v0.1.0 ● connected
+  ──────────────────────────────────────────────────────
+  📁 Folders
+
+  › my project
+  › side hustle
+
+  [↑↓] navigate  [Enter] open  [n] new  [e] edit  [d] delete  [q] quit
+  ──────────────────────────────────────────────────────
+  > type / for commands
+  / for commands  ↑↓ navigate  TAB complete  ESC close  Enter execute
+```
+
+**3-panel TUI layout:**
+
+- **Top** — fixed header with version and login state
+- **Middle** — scrollable content (folders → lists → nodes)
+- **Bottom** — smart command bar with live autocomplete
+
+---
+
+## Quick Setup
+
+> **Prerequisites:** [Node.js ≥20](https://nodejs.org) must be installed.
+
+### Install from npm (recommended)
+
+```bash
+npm install -g stratanodex
+stratanodex
+```
+
+### Run from source
+
+```bash
+# 1. Clone the repo
+git clone https://github.com/pranavdadhe1806/StrataNodex-CLI.git
+cd StrataNodex-CLI
+
+# 2. Install dependencies
+npm install
+
+# 3. Run the CLI
+npm run dev
+```
+
+On first launch you'll see the login screen. It opens your browser to [stratanodex.online](https://stratanodex.online) for authentication, and once you log in, the CLI picks it up automatically and drops you into the home screen.
+
+---
+
+## How It Works
+
+```
+┌─────────────┐        ┌──────────────────────┐        ┌────────────────────────┐
+│  CLI (you)  │───────▶│  Backend (Render)     │◀───────│  Landing Page (Vercel) │
+│  npm run dev│  API   │  REST API + Auth      │  Auth  │  Browser-based login   │
+└─────────────┘        └──────────────────────┘        └────────────────────────┘
+```
+
+1. You run `npm run dev` — the CLI starts in your terminal
+2. On first use, it opens your browser to the StrataNodex landing page
+3. You log in (email + password) — the CLI detects the login automatically
+4. You're now authenticated and can manage folders, lists, and tasks
+
+**The backend and landing page are already deployed.** You only need this CLI repo.
+
+---
+
+## Usage
+
+### Navigation
+
+| Key       | Action                     |
+| --------- | -------------------------- |
+| `↑` / `↓` | Move cursor                |
+| `Enter`   | Open selected item         |
+| `b`       | Go back                    |
+| `q`       | Quit                       |
+| `/`       | Open command bar           |
+| `TAB`     | Complete autocomplete      |
+| `ESC`     | Close autocomplete overlay |
+
+### Commands
+
+Every command starts with `/`. Type `/` in the command bar to see suggestions.
+
+#### Global (available on all screens)
+
+| Command      | Description                  |
+| ------------ | ---------------------------- |
+| `/back`      | Go back to previous screen   |
+| `/home`      | Jump to Folders screen       |
+| `/folders`   | Navigate to Folders screen   |
+| `/dashboard` | Score + streak + 7-day chart |
+| `/help`      | Show available commands      |
+| `/logout`    | Log out and clear token      |
+| `/whoami`    | Show username + streak       |
+| `/tags`      | List all tags                |
+
+#### Folders screen
+
+| Command          | Args                | Description         |
+| ---------------- | ------------------- | ------------------- |
+| `/new folder`    | `name`              | Create a new folder |
+| `/edit folder`   | `name` → `new-name` | Rename a folder     |
+| `/delete folder` | `name`              | Delete a folder     |
+
+#### Lists screen (inside a folder)
+
+| Command        | Args                | Description       |
+| -------------- | ------------------- | ----------------- |
+| `/new list`    | `name`              | Create a new list |
+| `/edit list`   | `name` → `new-name` | Rename a list     |
+| `/delete list` | `name`              | Delete a list     |
+
+#### Nodes screen (inside a list)
+
+| Command                     | Args                                  | Description                            |
+| --------------------------- | ------------------------------------- | -------------------------------------- |
+| `/add node`                 | `title`                               | Add a new root task                    |
+| `/add sub-node`             | `title`                               | Add sub-task under selected node       |
+| `/add sub-node`             | `index title`                         | Add sub-task under node at index (1.2) |
+| `/done`                     | `index or title`                      | Mark a task as DONE                    |
+| `/delete node`              | `index or title`                      | Delete a task                          |
+| `/move node`                | `ref` → `list-name`                   | Move to another list                   |
+| `/edit node ... title`      | `ref` → `new title`                   | Rename a task                          |
+| `/edit node ... status`     | `ref` → `NOT-DONE\|IN-PROGRESS\|DONE` | Change status                          |
+| `/edit node ... priority`   | `ref` → `LOW\|MEDIUM\|HIGH`           | Change priority                        |
+| `/edit node ... start-date` | `ref` → `DD-MM-YYYY`                  | Set start date                         |
+| `/edit node ... end-date`   | `ref` → `DD-MM-YYYY`                  | Set end date                           |
+| `/add node ... tag`         | `ref` → `tag-name`                    | Add a tag                              |
+| `/add node ... note`        | `ref` → `text`                        | Add a note                             |
+| `/delete node ... note`     | `ref`                                 | Remove note                            |
+
+---
+
+## Autocomplete
+
+Autocomplete is **context-aware** — it knows which screen you're on and which nodes are in the current list.
+
+```
+Stage 1  /edit no         → /edit node
+Stage 2  /edit node       → 1. Fix login bug  2. Review PR
+Stage 3  /edit node 1     → title / status / priority / start-date ...
+Stage 4  /edit node 1 sta → start-date (DD-MM-YYYY hint)
+```
+
+- `↑`/`↓` to navigate suggestions
+- `TAB` fills the selected suggestion
+- `ESC` closes without clearing input
+
+---
+
+## Example Workflow
+
+```bash
+npm run dev                        # Launch the CLI
+
+# After logging in:
+/new folder Work                   # Create a folder
+# Press Enter on "Work" to open it
+/new list Sprint 1                 # Create a list
+# Press Enter on "Sprint 1"
+/add node Fix login bug            # Add tasks
+/add node Review PR
+/add node Write docs
+/done 1                            # Mark "Fix login bug" as done
+/edit node 2 priority HIGH         # Set priority
+/add node 1 tag frontend           # Tag a task
+/dashboard                         # View your score + streaks
+```
+
+---
+
+## Environment Variables (optional)
+
+These are only needed if you want to override defaults. For normal use, **you don't need any env file.**
+
+| Variable              | Default                          | Description            |
+| --------------------- | -------------------------------- | ---------------------- |
+| `STRATANODEX_API_URL` | `https://api.stratanodex.online` | Override API base URL  |
+| `STRATANODEX_VERBOSE` | `false`                          | Enable verbose logging |
+| `NO_COLOR`            | unset                            | Disable all colors     |
+
+To use local overrides, copy the example file:
+
+```bash
+cp .env.example .env
+# Edit .env with your values
+```
+
+---
+
+## Project Structure
+
+```
+src/
+  api/          ← Axios client + ApiError (all HTTP calls)
+  commands/     ← Command registry, resolver, executor + individual commands
+  tui/          ← Ink React TUI (screens, hooks, components)
+  types/        ← Shared TypeScript types
+  utils/        ← Numbering, tree, scoring, logger, auth helpers
+  config.ts     ← Config resolution (env → store → defaults)
+  index.ts      ← Entry point
+```
+
+---
+
+## Development Scripts
+
+```bash
+npm run dev          # Run with tsx (no build step)
+npm run build        # Compile TypeScript to dist/
+npm run test         # Run tests (Vitest)
+npm run typecheck    # Type-check without emitting
+npm run lint         # ESLint
+npm run format       # Prettier
+```
+
+---
+
+## Tech Stack
+
+- **Runtime:** Node.js ≥ 20
+- **Language:** TypeScript (ESM)
+- **TUI Framework:** [Ink](https://github.com/vadimdemedes/ink) (React for terminals)
+- **HTTP Client:** Axios
+- **Config:** [Conf](https://github.com/sindresorhus/conf) (persistent local config)
+- **Testing:** Vitest
+
+---
+
+## License
+
+MIT © 2024 pranavdadhe1806

package/dist/api/ApiError.js

@@ -0,0 +1,10 @@
+export class ApiError extends Error {
+    statusCode;
+    raw;
+    constructor(statusCode, message, raw) {
+        super(message);
+        this.statusCode = statusCode;
+        this.raw = raw;
+        this.name = 'ApiError';
+    }
+}

package/dist/api/client.js

@@ -0,0 +1,96 @@
+import axios from 'axios';
+import { getConfig } from '../config.js';
+import { getToken, clearToken } from '../utils/auth.js';
+import { logger } from '../utils/logger.js';
+import { ApiError } from './ApiError.js';
+const http = axios.create({
+    timeout: 30_000, // 30s — Render free-tier cold starts can take up to ~30s
+});
+http.interceptors.request.use((config) => {
+    config.baseURL = getConfig().apiUrl;
+    const token = getToken();
+    if (token) {
+        config.headers.Authorization = `Bearer ${token}`;
+    }
+    return config;
+});
+http.interceptors.response.use((response) => response, (error) => {
+    if (axios.isAxiosError(error) && error.response) {
+        const { status, data } = error.response;
+        const rawError = data?.error;
+        const msg = typeof rawError === 'string'
+            ? rawError
+            : rawError && typeof rawError === 'object' && 'fieldErrors' in rawError
+                ? Object.entries(rawError.fieldErrors)
+                    .map(([k, v]) => `${k}: ${v.join(', ')}`)
+                    .join('; ')
+                : 'An unexpected error occurred.';
+        logger.error(`API ${status}: ${msg}`, { status, url: error.config?.url });
+        if (status === 401) {
+            clearToken();
+            throw new ApiError(401, 'Session expired. Please log in again.', error);
+        }
+        if (status === 429) {
+            throw new ApiError(429, 'Too many requests, please wait a moment.', error);
+        }
+        if (status >= 500) {
+            throw new ApiError(status, typeof rawError === 'string' ? rawError : 'Server error. Try again later.', error);
+        }
+        throw new ApiError(status, msg, error);
+    }
+    logger.error('Network error: cannot reach server');
+    throw new ApiError(0, 'Cannot reach server. Check your connection.', error);
+});
+// ── Health ────────────────────────────────────────────────────────────────────
+export const healthCheck = () => http.get('/health').then((r) => r.data);
+// ── Auth ──────────────────────────────────────────────────────────────────────
+export const login = (email, password) => http.post('/api/auth/login', { email, password }).then((r) => r.data);
+export const verify2FA = (userId, code) => http
+    .post('/api/auth/2fa/verify', { userId, code })
+    .then((r) => r.data);
+export const getMe = () => http.get('/api/auth/me').then((r) => r.data);
+// ── Folders ───────────────────────────────────────────────────────────────────
+export const getFolders = () => http.get('/api/folders').then((r) => r.data);
+export const createFolder = (name, position) => http.post('/api/folders', { name, position }).then((r) => r.data);
+export const updateFolder = (id, data) => http.patch(`/api/folders/${id}`, data).then((r) => r.data);
+export const deleteFolder = (id) => http.delete(`/api/folders/${id}`).then(() => undefined);
+// ── Lists ─────────────────────────────────────────────────────────────────────
+export const getLists = (folderId) => http.get(`/api/folders/${folderId}/lists`).then((r) => r.data);
+export const createList = (name, folderId, position) => http.post('/api/lists', { name, folderId, position }).then((r) => r.data);
+export const updateList = (id, data) => http.patch(`/api/lists/${id}`, data).then((r) => r.data);
+export const deleteList = (id) => http.delete(`/api/lists/${id}`).then(() => undefined);
+// ── Nodes ─────────────────────────────────────────────────────────────────────
+export const getNodes = (listId) => http.get(`/api/lists/${listId}/nodes`).then((r) => r.data);
+export const getNode = (id) => http.get(`/api/nodes/${id}`).then((r) => r.data);
+export const createRootNode = (listId, data) => http.post(`/api/lists/${listId}/nodes`, { ...data, listId }).then((r) => r.data);
+export const createChildNode = (parentId, data) => http.post(`/api/nodes/${parentId}/children`, data).then((r) => r.data);
+export const updateNode = (id, data) => http.patch(`/api/nodes/${id}`, data).then((r) => r.data);
+export const moveNode = (id, parentId, position) => http.patch(`/api/nodes/${id}/move`, { parentId, position }).then((r) => r.data);
+export const deleteNode = (id) => http.delete(`/api/nodes/${id}`).then(() => undefined);
+// ── Tags ──────────────────────────────────────────────────────────────────────
+export const getTags = (listId) => http.get('/api/tags', { params: listId ? { listId } : {} }).then((r) => r.data);
+export const createTag = (name, color, listId) => http.post('/api/tags', { name, color, listId }).then((r) => r.data);
+export const updateTag = (id, data) => http.patch(`/api/tags/${id}`, data).then((r) => r.data);
+export const deleteTag = (id) => http.delete(`/api/tags/${id}`).then(() => undefined);
+export const attachTag = (nodeId, tagId) => http.post(`/api/nodes/${nodeId}/tags/${tagId}`).then(() => undefined);
+export const detachTag = (nodeId, tagId) => http.delete(`/api/nodes/${nodeId}/tags/${tagId}`).then(() => undefined);
+// ── Daily ─────────────────────────────────────────────────────────────────────
+export const getDailyToday = () => http.get('/api/daily/today').then((r) => r.data);
+export const getDailyOverdue = () => http.get('/api/daily/overdue').then((r) => r.data);
+export const getDailyScore = (date) => http.get(`/api/daily/${date}`).then((r) => r.data);
+// ── Scores ────────────────────────────────────────────────────────────────────
+export const getScores = (limit, listId) => http.get('/api/scores', { params: { limit, listId } }).then((r) => r.data);
+export const getStreak = () => http.get('/api/scores/streak').then((r) => r.data);
+// ── CLI Session (browser-based auth handshake) ────────────────────────────────
+// Backend mounts these at /api/auth/cli-session (see app.ts)
+export const createCliSession = () => http
+    .post('/api/auth/cli-session')
+    .then((r) => ({
+    code: r.data.code,
+}));
+export const pollCliSession = (code) => http.get(`/api/auth/cli-session/${code}`).then((r) => {
+    // Backend returns { pending: true } or { token: string }
+    if (r.data.token)
+        return { status: 'complete', token: r.data.token };
+    return { status: 'pending' };
+});

package/dist/commands/add.js

@@ -0,0 +1,45 @@
+import Conf from 'conf';
+import chalk from 'chalk';
+import { getNodes, createRootNode, createChildNode } from '../api/client.js';
+import { assignNumbers, flattenTree } from '../utils/numbering.js';
+import { ApiError } from '../api/ApiError.js';
+const store = new Conf({ projectName: 'stratanodex' });
+export async function runAdd(title, options) {
+    if (!options.list) {
+        console.log(chalk.red('✗ --list <listId> is required. Use: stratanodex list to see list IDs.'));
+        return;
+    }
+    const listId = options.list;
+    try {
+        if (!options.parent) {
+            const node = await createRootNode(listId, { title });
+            store.set('lastListId', listId);
+            console.log(chalk.green(`✓ Added: ${node.title}`));
+            return;
+        }
+        const nodes = await getNodes(listId);
+        const flat = flattenTree(nodes);
+        const numberMap = assignNumbers(nodes);
+        const byNumber = new Map();
+        for (const [id, num] of numberMap) {
+            byNumber.set(num, id);
+        }
+        const parentId = byNumber.get(options.parent);
+        if (!parentId) {
+            console.log(chalk.red(`✗ Node "${options.parent}" not found in list.`));
+            return;
+        }
+        const parentNode = flat.find((n) => n.id === parentId);
+        const child = await createChildNode(parentId, { title });
+        store.set('lastListId', listId);
+        console.log(chalk.green(`✓ Added: ${child.title}  (under: ${parentNode?.title ?? parentId})`));
+    }
+    catch (err) {
+        if (err instanceof ApiError) {
+            console.log(chalk.red(`✗ ${err.message}`));
+        }
+        else {
+            console.log(chalk.red('✗ Unexpected error.'));
+        }
+    }
+}

package/dist/commands/config.js

@@ -0,0 +1,41 @@
+import Conf from 'conf';
+import chalk from 'chalk';
+import { getConfig, saveApiUrl } from '../config.js';
+const ALLOWED_KEYS = ['apiUrl', 'verbose'];
+const store = new Conf({ projectName: 'stratanodex' });
+export function runConfig(subcommand, key, value) {
+    if (subcommand === 'list') {
+        const cfg = getConfig();
+        console.log(`apiUrl    ${cfg.apiUrl}`);
+        console.log(`verbose   ${cfg.verbose}`);
+        return;
+    }
+    if (subcommand === 'get') {
+        if (!key || !ALLOWED_KEYS.includes(key)) {
+            console.log(chalk.red(`✗ Unknown config key: ${key}`));
+            return;
+        }
+        const cfg = getConfig();
+        console.log(cfg[key]);
+        return;
+    }
+    if (subcommand === 'set') {
+        if (!key || !ALLOWED_KEYS.includes(key)) {
+            console.log(chalk.red(`✗ Unknown config key: ${key}`));
+            return;
+        }
+        if (value === undefined) {
+            console.log(chalk.red('✗ A value is required.'));
+            return;
+        }
+        if (key === 'apiUrl') {
+            saveApiUrl(value);
+        }
+        else {
+            store.set(key, value);
+        }
+        console.log(chalk.green(`✓ Set ${key} = ${value}`));
+        return;
+    }
+    console.log(chalk.red(`✗ Unknown subcommand: ${subcommand}`));
+}

package/dist/commands/done.js

@@ -0,0 +1,39 @@
+import Conf from 'conf';
+import chalk from 'chalk';
+import { getNodes, updateNode } from '../api/client.js';
+import { assignNumbers } from '../utils/numbering.js';
+import { flattenTree } from '../utils/tree.js';
+import { ApiError } from '../api/ApiError.js';
+const store = new Conf({ projectName: 'stratanodex' });
+export async function runDone(number, options) {
+    const listId = options.list ?? store.get('lastListId');
+    if (!listId) {
+        console.log(chalk.red('✗ No active list. Run: stratanodex list -d 1 first, or use: stratanodex done <number> --list <listId>'));
+        return;
+    }
+    try {
+        const nodes = await getNodes(listId);
+        const numberMap = assignNumbers(nodes);
+        const flat = flattenTree(nodes);
+        const byNumber = new Map();
+        for (const [id, num] of numberMap) {
+            byNumber.set(num, id);
+        }
+        const nodeId = byNumber.get(number);
+        if (!nodeId) {
+            console.log(chalk.red(`✗ Node "${number}" not found.`));
+            return;
+        }
+        const updated = await updateNode(nodeId, { status: 'DONE' });
+        const found = flat.find((n) => n.id === nodeId);
+        console.log(chalk.green(`✓ Done: ${updated.title ?? found?.title}`));
+    }
+    catch (err) {
+        if (err instanceof ApiError) {
+            console.log(chalk.red(`✗ ${err.message}`));
+        }
+        else {
+            console.log(chalk.red('✗ Unexpected error.'));
+        }
+    }
+}