stratanodex 0.1.0

package/dist/commands/registry.js

@@ -0,0 +1,351 @@
+// Command Registry — single source of truth for all CLI commands.
+// Drives both autocomplete suggestions and executor dispatch.
+export const COMMAND_REGISTRY = [
+    // ─── GLOBAL ───────────────────────────────────────────────────────────────
+    {
+        command: '/back',
+        args: [],
+        screens: ['global'],
+        description: 'Go back to previous screen',
+    },
+    {
+        command: '/home',
+        args: [],
+        screens: ['global'],
+        description: 'Jump to Folders screen',
+    },
+    {
+        command: '/folders',
+        args: [],
+        screens: ['global'],
+        description: 'Navigate to Folders screen',
+    },
+    {
+        command: '/dashboard',
+        args: [],
+        screens: ['global'],
+        description: 'Navigate to dashboard (score + streaks + weekly graph)',
+    },
+    {
+        command: '/help',
+        args: [],
+        screens: ['global'],
+        description: 'Show available commands for current screen',
+    },
+    {
+        command: '/logout',
+        args: [],
+        screens: ['global'],
+        description: 'Log out of current CLI session',
+    },
+    {
+        command: '/whoami',
+        args: [],
+        screens: ['global'],
+        description: 'Show logged-in user + current streak info',
+    },
+    {
+        command: '/tags',
+        args: [],
+        screens: ['global'],
+        description: 'List all tags used across all lists',
+    },
+    // ─── FOLDERS SCREEN ────────────────────────────────────────────────────────
+    {
+        command: '/new folder',
+        args: [{ name: 'folder-name', type: 'text', placeholder: 'folder name' }],
+        screens: ['folders'],
+        description: 'Create a new folder',
+    },
+    {
+        command: '/edit folder',
+        args: [
+            { name: 'folder-name', type: 'text', placeholder: 'existing folder name' },
+            { name: 'new-folder-name', type: 'text', placeholder: 'new name' },
+        ],
+        screens: ['folders'],
+        description: 'Rename a folder',
+    },
+    {
+        command: '/delete folder',
+        args: [{ name: 'folder-name', type: 'text', placeholder: 'folder name' }],
+        screens: ['folders'],
+        description: 'Delete a folder',
+    },
+    // ─── LISTS SCREEN ──────────────────────────────────────────────────────────
+    {
+        command: '/new list',
+        args: [{ name: 'list-name', type: 'text', placeholder: 'list name' }],
+        screens: ['lists'],
+        description: 'Create a new list',
+    },
+    {
+        command: '/edit list',
+        args: [
+            { name: 'list-name', type: 'text', placeholder: 'existing list name' },
+            { name: 'new-list-name', type: 'text', placeholder: 'new name' },
+        ],
+        screens: ['lists'],
+        description: 'Rename a list',
+    },
+    {
+        command: '/delete list',
+        args: [{ name: 'list-name', type: 'text', placeholder: 'list name' }],
+        screens: ['lists'],
+        description: 'Delete a list',
+    },
+    // ─── NODES SCREEN ─────────────────────────────────────────────────────────
+    {
+        command: '/add node',
+        args: [{ name: 'node-title', type: 'text', placeholder: 'node title' }],
+        screens: ['nodes'],
+        description: 'Create a new root node',
+    },
+    {
+        command: '/add sub-node',
+        args: [{ name: 'node-title', type: 'text', placeholder: '[parent-index] sub-node title' }],
+        screens: ['nodes'],
+        description: 'Add sub-node under selected node (or specify parent index)',
+    },
+    {
+        command: '/done',
+        args: [{ name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' }],
+        screens: ['nodes'],
+        description: 'Shorthand: set node status to DONE',
+    },
+    {
+        command: '/delete node',
+        args: [{ name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' }],
+        screens: ['nodes'],
+        description: 'Delete a node',
+    },
+    {
+        command: '/move node',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'list-name', type: 'text', placeholder: 'destination list name' },
+        ],
+        screens: ['nodes'],
+        description: 'Move node to another list',
+    },
+    // /edit node ... <property>
+    {
+        command: '/edit node ... title',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'new-title', type: 'text', placeholder: 'new title' },
+        ],
+        screens: ['nodes'],
+        description: 'Edit node title',
+    },
+    {
+        command: '/edit node ... position',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'new-index', type: 'number', placeholder: '2' },
+        ],
+        screens: ['nodes'],
+        description: 'Reorder node',
+    },
+    {
+        command: '/edit node ... status',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'status', type: 'status', placeholder: 'NOT-DONE | IN-PROGRESS | DONE' },
+        ],
+        screens: ['nodes'],
+        description: 'Change node status',
+    },
+    {
+        command: '/edit node ... priority',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'priority', type: 'priority', placeholder: 'LOW | MEDIUM | HIGH' },
+        ],
+        screens: ['nodes'],
+        description: 'Change node priority',
+    },
+    {
+        command: '/edit node ... start-date',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'start-date', type: 'date', placeholder: 'DD-MM-YYYY' },
+        ],
+        screens: ['nodes'],
+        description: 'Edit start date',
+    },
+    {
+        command: '/edit node ... start-time',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'start-time', type: 'time', placeholder: 'HH:MM AM/PM' },
+        ],
+        screens: ['nodes'],
+        description: 'Edit start time',
+    },
+    {
+        command: '/edit node ... end-date',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'end-date', type: 'date', placeholder: 'DD-MM-YYYY' },
+        ],
+        screens: ['nodes'],
+        description: 'Edit end date',
+    },
+    {
+        command: '/edit node ... end-time',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'end-time', type: 'time', placeholder: 'HH:MM AM/PM' },
+        ],
+        screens: ['nodes'],
+        description: 'Edit end time',
+    },
+    {
+        command: '/edit node ... tag',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'tag-name', type: 'text', placeholder: 'tag name' },
+        ],
+        screens: ['nodes'],
+        description: 'Edit node tag',
+    },
+    {
+        command: '/edit node ... note',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'new-note', type: 'text', placeholder: 'note text' },
+        ],
+        screens: ['nodes'],
+        description: 'Edit note',
+    },
+    // /add node ... <property>
+    {
+        command: '/add node ... start-date',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'start-date', type: 'date', placeholder: 'DD-MM-YYYY' },
+        ],
+        screens: ['nodes'],
+        description: 'Add start date',
+    },
+    {
+        command: '/add node ... start-time',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'start-time', type: 'time', placeholder: 'HH:MM AM/PM' },
+        ],
+        screens: ['nodes'],
+        description: 'Add start time (default 12:00 AM)',
+    },
+    {
+        command: '/add node ... end-date',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'end-date', type: 'date', placeholder: 'DD-MM-YYYY' },
+        ],
+        screens: ['nodes'],
+        description: 'Add end date',
+    },
+    {
+        command: '/add node ... end-time',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'end-time', type: 'time', placeholder: 'HH:MM AM/PM' },
+        ],
+        screens: ['nodes'],
+        description: 'Add end time (default 12:00 AM)',
+    },
+    {
+        command: '/add node ... tag',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'tag-name', type: 'text', placeholder: 'tag name' },
+        ],
+        screens: ['nodes'],
+        description: 'Add tag to node',
+    },
+    {
+        command: '/add node ... note',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'note-text', type: 'text', placeholder: 'note text' },
+        ],
+        screens: ['nodes'],
+        description: 'Add note',
+    },
+    {
+        command: '/add node ... status',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'status', type: 'status', placeholder: 'NOT-DONE | IN-PROGRESS | DONE' },
+        ],
+        screens: ['nodes'],
+        description: 'Set status',
+    },
+    {
+        command: '/add node ... priority',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'priority', type: 'priority', placeholder: 'LOW | MEDIUM | HIGH' },
+        ],
+        screens: ['nodes'],
+        description: 'Set priority',
+    },
+    // /delete node ... <property>
+    {
+        command: '/delete node ... start-date',
+        args: [{ name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' }],
+        screens: ['nodes'],
+        description: 'Remove start date',
+    },
+    {
+        command: '/delete node ... start-time',
+        args: [{ name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' }],
+        screens: ['nodes'],
+        description: 'Remove start time',
+    },
+    {
+        command: '/delete node ... end-date',
+        args: [{ name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' }],
+        screens: ['nodes'],
+        description: 'Remove end date',
+    },
+    {
+        command: '/delete node ... end-time',
+        args: [{ name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' }],
+        screens: ['nodes'],
+        description: 'Remove end time',
+    },
+    {
+        command: '/delete node ... tag',
+        args: [
+            { name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' },
+            { name: 'tag-name', type: 'text', placeholder: 'tag name' },
+        ],
+        screens: ['nodes'],
+        description: 'Remove tag from node',
+    },
+    {
+        command: '/delete node ... note',
+        args: [{ name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' }],
+        screens: ['nodes'],
+        description: 'Remove note',
+    },
+    {
+        command: '/delete node ... status',
+        args: [{ name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' }],
+        screens: ['nodes'],
+        description: 'Remove status',
+    },
+    {
+        command: '/delete node ... priority',
+        args: [{ name: 'index-or-title', type: 'index-or-title', placeholder: '1 or "task title"' }],
+        screens: ['nodes'],
+        description: 'Remove priority',
+    },
+];
+/** Returns commands valid for a given screen (global always included). */
+export function getCommandsForScreen(screen) {
+    return COMMAND_REGISTRY.filter((c) => c.screens.includes('global') || c.screens.includes(screen));
+}

package/dist/commands/resolver.js

@@ -0,0 +1,184 @@
+// resolver.ts — Parses the current input string and returns stage + suggestions.
+// This is the core brain of the autocomplete system.
+import { COMMAND_REGISTRY, getCommandsForScreen } from './registry.js';
+import { assignNumbers } from '../utils/numbering.js';
+/** DFS flatten for suggestions — walks the full nested tree. */
+function flattenForSuggestions(nodes) {
+    const result = [];
+    function dfs(children) {
+        const sorted = [...children].sort((a, b) => a.position - b.position);
+        for (const node of sorted) {
+            result.push(node);
+            if ((node.children ?? []).length > 0)
+                dfs(node.children);
+        }
+    }
+    dfs(nodes);
+    return result;
+}
+// The ordered list of sub-properties for "/edit node ..." style commands.
+const NODE_PROPERTIES = [
+    'title',
+    'start-date',
+    'start-time',
+    'end-date',
+    'end-time',
+    'tag',
+    'note',
+    'status',
+    'priority',
+    'position',
+];
+const STATUS_VALUES = ['NOT-DONE', 'IN-PROGRESS', 'DONE'];
+const PRIORITY_VALUES = ['LOW', 'MEDIUM', 'HIGH'];
+/** Fuzzy prefix match — input must be a prefix of label (case-insensitive). */
+function prefixMatch(input, label) {
+    return label.toLowerCase().startsWith(input.toLowerCase());
+}
+/** Find which registered command best matches a fully-typed command prefix. */
+function matchingCommands(input, screen) {
+    const all = getCommandsForScreen(screen);
+    return all.filter((c) => prefixMatch(input, c.command));
+}
+export function resolve(input, screen, currentNodes) {
+    // ── Stage 0: no slash, no overlay ─────────────────────────────────────────
+    if (!input.startsWith('/')) {
+        return { stage: 'command', suggestions: [], filledTokens: [] };
+    }
+    const trimmed = input.trimEnd();
+    // ─── Stage 1: command selection ───────────────────────────────────────────
+    // We're still typing the command name — no trailing space yet after the
+    // command, or no command matched yet.
+    const allForScreen = getCommandsForScreen(screen);
+    // Check if the current input has moved past Stage 1 by seeing if the input
+    // exactly matches a registered command prefix + a space.
+    const matchedCmd = COMMAND_REGISTRY.find((c) => trimmed.toLowerCase().startsWith(c.command.toLowerCase()) && input.length > c.command.length);
+    if (!matchedCmd) {
+        // Still typing the command — show matching commands as suggestions.
+        const matches = allForScreen.filter((c) => c.command.toLowerCase().startsWith(trimmed.toLowerCase()));
+        return {
+            stage: 'command',
+            filledTokens: [],
+            suggestions: matches.map((c) => ({
+                label: c.command,
+                fillValue: c.command + ' ',
+                hint: c.description,
+            })),
+        };
+    }
+    // ─── We have a matched command. Now determine which arg we're filling. ────
+    // Strip the command prefix + trailing space.
+    const afterCmd = input.slice(matchedCmd.command.length + 1);
+    const args = matchedCmd.args;
+    // ─── Commands that need a node-ref as first arg ──────────────────────────
+    const needsNodeRef = args.length > 0 && args[0].type === 'index-or-title';
+    if (needsNodeRef) {
+        // Stage 2: node-ref input
+        const nodeRefInput = afterCmd;
+        const propertyStart = nodeRefInput.indexOf(' ');
+        if (propertyStart === -1) {
+            // User is still typing the node ref
+            const query = nodeRefInput.toLowerCase();
+            // Build hierarchical number map and flatten the tree for display
+            const numberMap = assignNumbers(currentNodes);
+            const flatNodes = flattenForSuggestions(currentNodes);
+            const matchedNodes = flatNodes.filter((n) => {
+                if (!nodeRefInput)
+                    return true;
+                const num = numberMap.get(n.id) ?? '';
+                return n.title.toLowerCase().includes(query) || num.startsWith(query);
+            });
+            if (nodeRefInput.length > 0 && matchedNodes.length === 0) {
+                return {
+                    stage: 'node-ref',
+                    filledTokens: [matchedCmd.command],
+                    suggestions: [{ label: '✕ No match found', fillValue: '', isNoMatch: true }],
+                };
+            }
+            return {
+                stage: 'node-ref',
+                filledTokens: [matchedCmd.command],
+                suggestions: matchedNodes.map((n) => {
+                    const num = numberMap.get(n.id) ?? '?';
+                    return {
+                        label: `${num}. ${n.title}`,
+                        fillValue: num + ' ',
+                        hint: n.status,
+                    };
+                }),
+            };
+        }
+        // Node ref is filled. Now figure out which property arg we're on.
+        const nodeRef = nodeRefInput.slice(0, propertyStart);
+        const afterNodeRef = nodeRefInput.slice(propertyStart + 1);
+        const filledTokens = [matchedCmd.command, nodeRef];
+        // If the command has exactly 2 args (node-ref + value), go to value-hint
+        if (args.length === 2) {
+            const valueArg = args[1];
+            const valueInput = afterNodeRef;
+            // Stage 3 for value typing
+            if (valueArg.type === 'status') {
+                const matches = STATUS_VALUES.filter((v) => prefixMatch(valueInput, v));
+                return {
+                    stage: 'value-hint',
+                    filledTokens,
+                    suggestions: matches.map((v) => ({
+                        label: v,
+                        fillValue: v + ' ',
+                        hint: valueArg.placeholder,
+                    })),
+                };
+            }
+            if (valueArg.type === 'priority') {
+                const matches = PRIORITY_VALUES.filter((v) => prefixMatch(valueInput, v));
+                return {
+                    stage: 'value-hint',
+                    filledTokens,
+                    suggestions: matches.map((v) => ({
+                        label: v,
+                        fillValue: v + ' ',
+                        hint: valueArg.placeholder,
+                    })),
+                };
+            }
+            // Date / time / text / number — just show format hint
+            return {
+                stage: 'value-hint',
+                filledTokens,
+                suggestions: [{ label: valueArg.placeholder, fillValue: '', hint: valueArg.placeholder }],
+            };
+        }
+        // Command has only 1 arg (just node-ref, no further arg) — nothing more to suggest
+        return { stage: 'value-hint', filledTokens, suggestions: [] };
+    }
+    // ─── Commands without node-ref (folder/list commands + global) ───────────
+    // If command has args and no node-ref, show property suggestions.
+    if (args.length > 0) {
+        const firstArg = args[0];
+        const valueInput = afterCmd;
+        if (firstArg.type === 'status') {
+            const matches = STATUS_VALUES.filter((v) => prefixMatch(valueInput, v));
+            return {
+                stage: 'value-hint',
+                filledTokens: [matchedCmd.command],
+                suggestions: matches.map((v) => ({ label: v, fillValue: v, hint: firstArg.placeholder })),
+            };
+        }
+        if (firstArg.type === 'priority') {
+            const matches = PRIORITY_VALUES.filter((v) => prefixMatch(valueInput, v));
+            return {
+                stage: 'value-hint',
+                filledTokens: [matchedCmd.command],
+                suggestions: matches.map((v) => ({ label: v, fillValue: v, hint: firstArg.placeholder })),
+            };
+        }
+        // text / number — show format hint
+        return {
+            stage: 'value-hint',
+            filledTokens: [matchedCmd.command],
+            suggestions: [{ label: firstArg.placeholder, fillValue: '', hint: firstArg.placeholder }],
+        };
+    }
+    // No args needed — command is complete.
+    return { stage: 'command', filledTokens: [matchedCmd.command], suggestions: [] };
+}

package/dist/config.js

@@ -0,0 +1,16 @@
+import 'dotenv/config';
+import Conf from 'conf';
+const store = new Conf({ projectName: 'stratanodex' });
+const DEFAULT_API_URL = 'https://api.stratanodex.online';
+let runtimeApiUrl;
+export function getConfig() {
+    const apiUrl = runtimeApiUrl ?? process.env['STRATANODEX_API_URL'] ?? store.get('apiUrl') ?? DEFAULT_API_URL;
+    const verbose = process.env['STRATANODEX_VERBOSE'] === 'true';
+    return { apiUrl, verbose };
+}
+export function setRuntimeApiUrl(url) {
+    runtimeApiUrl = url;
+}
+export function saveApiUrl(url) {
+    store.set('apiUrl', url);
+}

package/dist/index.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import { createRequire } from 'module';
+import { setRuntimeApiUrl } from './config.js';
+import { runLogin } from './commands/login.js';
+import { runLogout } from './commands/logout.js';
+import { runConfig } from './commands/config.js';
+import { runList } from './commands/list.js';
+import { runAdd } from './commands/add.js';
+import { runDone } from './commands/done.js';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+program
+    .name('stratanodex')
+    .description('CLI-first productivity and task management system')
+    .version(pkg.version);
+program.option('--api-url <url>', 'Override API base URL').hook('preAction', (thisCommand) => {
+    const opts = thisCommand.opts();
+    if (opts.apiUrl)
+        setRuntimeApiUrl(opts.apiUrl);
+});
+program
+    .command('login')
+    .description('Log in to your StrataNodex account')
+    .action(async () => {
+    await runLogin();
+});
+program
+    .command('logout')
+    .description('Log out and clear stored credentials')
+    .action(() => {
+    runLogout();
+});
+const configCmd = program.command('config').description('Manage CLI configuration');
+configCmd
+    .command('list')
+    .description('Show all config values')
+    .action(() => runConfig('list'));
+configCmd
+    .command('get <key>')
+    .description('Get a config value')
+    .action((key) => runConfig('get', key));
+configCmd
+    .command('set <key> <value>')
+    .description('Set a config value')
+    .action((key, value) => runConfig('set', key, value));
+program
+    .command('list')
+    .description('List folders, lists, and tasks')
+    .option('-d, --depth <number>', 'Depth of nodes to show (0=none, 1=top-level, 2=two levels)', '0')
+    .action(async (options) => {
+    await runList({ depth: parseInt(options.depth ?? '0', 10) });
+});
+program
+    .command('add <title>')
+    .description('Add a new task')
+    .option('--list <listId>', 'List ID to add the task to')
+    .option('--parent <number>', 'Parent node number (e.g. 1.2) to add as sub-task')
+    .action(async (title, options) => {
+    await runAdd(title, options);
+});
+program
+    .command('done <number>')
+    .description('Mark a task as done by its number')
+    .option('--list <listId>', 'List ID (optional, uses last active list if omitted)')
+    .action(async (number, options) => {
+    await runDone(number, options);
+});
+if (process.argv.length === 2) {
+    const { render } = await import('ink');
+    const React = (await import('react')).default;
+    const { App } = await import('./tui/App.js');
+    const { waitUntilExit } = render(React.createElement(App));
+    await waitUntilExit();
+    process.exit(0);
+}
+program.parse();