@jlmarcos99/todos 0.0.0-stage → 1.1.0

package/dist/app/src/tui/theme.js

@@ -0,0 +1,17 @@
+import { truncateToWidth, visibleWidth } from '@earendil-works/pi-tui';
+function color(code, text) {
+    if (process.env.NO_COLOR !== undefined)
+        return text;
+    return `\x1b[${code}m${text}\x1b[0m`;
+}
+export const theme = {
+    accent: (text) => color('38;5;115', text),
+    muted: (text) => color('38;5;245', text),
+    bold: (text) => color('1', text),
+    selected: (text) => color('48;5;236;38;5;115', text),
+};
+export function padLine(text, width) {
+    const clipped = truncateToWidth(text, Math.max(0, width));
+    const padding = ' '.repeat(Math.max(0, width - visibleWidth(clipped)));
+    return clipped + padding;
+}

package/dist/app/src/tui/view.js

@@ -0,0 +1,279 @@
+import { truncateToWidth, wrapTextWithAnsi } from '@earendil-works/pi-tui';
+import { padLine, theme } from "./theme.js";
+const MIN_COLUMNS = 40;
+const MIN_ROWS = 17;
+export const SIDEBAR_BREAKPOINT = 85;
+const SIDEBAR_WIDTH = 23;
+const COLUMN_SEPARATOR_WIDTH = 3;
+const FOOTER_ROWS = 3;
+const WORKSPACE_HEADER_ROWS = 8;
+const TASK_DETAIL_ROWS = 5;
+const ACTIVITY_HEADER_ROWS = 4;
+const DAILY_SCROLL_HINT_ROWS = 1;
+const STATUS_LABELS = {
+    todo: 'To do',
+    'in-progress': 'In progress',
+    done: 'Done',
+};
+const ACTIVITY_LABELS = {
+    started: 'Started', completed: 'Completed', reopened: 'Reopened', note: 'Progress note',
+};
+const STATUS_SYMBOLS = {
+    todo: '○', 'in-progress': '◐', done: '✓',
+};
+const VIEW_LABELS = {
+    current: 'Tasks', daily: 'Daily', history: 'History',
+};
+export function mainColumnWidth(width) {
+    return width >= SIDEBAR_BREAKPOINT
+        ? width - SIDEBAR_WIDTH - COLUMN_SEPARATOR_WIDTH
+        : width;
+}
+export function activityViewportHeight(terminalRows) {
+    return Math.max(1, terminalRows - 1 - FOOTER_ROWS - ACTIVITY_HEADER_ROWS);
+}
+export function dailyViewportHeight(terminalRows) {
+    return Math.max(1, terminalRows - 1 - FOOTER_ROWS - WORKSPACE_HEADER_ROWS - DAILY_SCROLL_HINT_ROWS);
+}
+export function renderScreen(session, options) {
+    const { width, rows, showHelp, inputLine } = options;
+    const height = Math.max(1, rows - 1);
+    if (width < MIN_COLUMNS || rows < MIN_ROWS) {
+        return [' TODOS', '', ' Resize your terminal to 40 × 17.', ' q quit']
+            .slice(0, height)
+            .map(line => truncateToWidth(line, width));
+    }
+    const mainWidth = mainColumnWidth(width);
+    const contentHeight = height - FOOTER_ROWS;
+    let content;
+    if (showHelp) {
+        content = renderHelp();
+    }
+    else if (options.showActivity) {
+        content = renderActivity(session, mainWidth, contentHeight, options.activityOffset ?? 0, options.activityTaskId);
+    }
+    else if (session.view === 'daily') {
+        content = renderDailyWorkspace(session, mainWidth, rows, options.dailyOffset ?? 0);
+    }
+    else {
+        content = renderWorkspace(session, mainWidth, contentHeight);
+    }
+    const body = content.slice(0, contentHeight);
+    while (body.length < contentHeight)
+        body.push('');
+    body.push(...renderFooter(session, inputLine, options.showActivity));
+    if (width < SIDEBAR_BREAKPOINT)
+        return body.map(line => truncateToWidth(line, width));
+    const sidebar = renderSidebar(session);
+    const separator = ` ${theme.muted('│')} `;
+    return body.map((line, index) => {
+        const left = padLine(sidebar[index] ?? '', SIDEBAR_WIDTH);
+        return left + separator + padLine(line, mainWidth);
+    });
+}
+function renderWorkspace(session, width, height) {
+    const lines = renderHeader(session, width);
+    const listHeight = Math.max(1, height - WORKSPACE_HEADER_ROWS - TASK_DETAIL_ROWS);
+    const pageStart = Math.max(0, session.selected - listHeight + 1);
+    const tasks = session.tasks;
+    const page = tasks.slice(pageStart, pageStart + listHeight);
+    if (!tasks.length)
+        lines.push('', theme.muted(emptyMessage(session)));
+    page.forEach((task, index) => {
+        const taskIndex = pageStart + index;
+        lines.push(renderTaskRow(task.name, task.status, taskIndex === session.selected, width));
+    });
+    while (lines.length < WORKSPACE_HEADER_ROWS + listHeight)
+        lines.push('');
+    lines.push(` ${theme.muted('─'.repeat(width - 2))}`);
+    lines.push(...renderTaskDetails(session, width - 4));
+    return lines;
+}
+/** Task row offsets let keyboard navigation follow variable-height note lists. */
+export function dailyListLayout(session, width) {
+    const lines = [];
+    const taskRows = [];
+    session.dailyItems.forEach((item, index) => {
+        taskRows.push(lines.length);
+        lines.push(renderTaskRow(item.name, item.status, index === session.selected, width));
+        const notes = item.entries.filter(entry => entry.note);
+        for (const entry of notes) {
+            const date = entry.date.toLocaleDateString('en-GB', { day: '2-digit', month: 'short' });
+            const time = entry.date.toLocaleTimeString('en-GB', { hour: '2-digit', minute: '2-digit' });
+            const prefix = `     • ${date} · ${time}  `;
+            const wrapped = wrapTextWithAnsi(entry.note, Math.max(1, width - prefix.length - 1));
+            wrapped.forEach((line, lineIndex) => {
+                const indent = lineIndex === 0 ? prefix : ' '.repeat(prefix.length);
+                lines.push(theme.muted(indent + line));
+            });
+        }
+        if (!notes.length)
+            lines.push(theme.muted('     No notes for this day.'));
+        lines.push('');
+    });
+    return { lines, taskRows };
+}
+function renderDailyWorkspace(session, width, rows, offset) {
+    const header = renderHeader(session, width);
+    const { lines } = dailyListLayout(session, width);
+    const viewportHeight = dailyViewportHeight(rows);
+    const start = Math.min(offset, Math.max(0, lines.length - viewportHeight));
+    const page = lines.slice(start, start + viewportHeight);
+    if (!lines.length)
+        page.push(theme.muted(emptyMessage(session)));
+    while (page.length < viewportHeight)
+        page.push('');
+    const directions = [
+        ...(start > 0 ? ['↑ More above'] : []),
+        ...(start + viewportHeight < lines.length ? ['↓ More below'] : []),
+    ];
+    const hint = directions.length ? ` ${directions.join(' · ')} · Ctrl+d/u scroll` : '';
+    return [...header, ...page, theme.muted(hint)];
+}
+function renderHeader(session, width) {
+    const { vault, view } = session;
+    const title = `${vault.name} / ${VIEW_LABELS[view]}`;
+    const currentCount = vault.tasks.filter(task => !session.isInHistory(task)).length;
+    const historyCount = vault.tasks.length - currentCount;
+    const tabs = [
+        renderTab(`1 Tasks ${currentCount}`, view === 'current'),
+        renderTab('2 Daily', view === 'daily'),
+        renderTab(`3 History ${historyCount}`, view === 'history'),
+    ].join('  ');
+    let subtitle = vault.description;
+    let context = session.syncMessage;
+    if (view === 'daily') {
+        const date = session.dailyDate.toLocaleDateString('en-US', {
+            weekday: 'short', month: 'short', day: 'numeric', year: 'numeric',
+        });
+        const previousDay = new Date(session.dailyDate);
+        previousDay.setDate(previousDay.getDate() - 1);
+        const startDate = previousDay.toLocaleDateString('en-US', { month: 'short', day: 'numeric' });
+        const completed = session.dailyItems.filter(item => item.status === 'done').length;
+        const ongoing = session.dailyItems.filter(item => item.status === 'in-progress').length;
+        const noteCount = session.dailyItems.reduce((count, item) => count + item.entries.filter(entry => entry.note).length, 0);
+        subtitle = `${startDate} – ${date}  ·  [ / ] change window · t today`;
+        context = `${session.syncMessage} · ${completed} done · ${ongoing} in progress · ${noteCount} notes`;
+    }
+    return [
+        ` ${theme.accent(theme.bold('◈ TODOS'))} ${theme.muted('/ your work, day by day')}`,
+        ` ${theme.muted(context)}`,
+        '',
+        ` ${theme.bold(title)}`,
+        ` ${theme.muted(subtitle)}`,
+        '',
+        ` ${tabs}`,
+        ` ${theme.muted('─'.repeat(width - 2))}`,
+    ];
+}
+function renderTab(label, active) {
+    return active ? theme.accent(theme.bold(label)) : theme.muted(label);
+}
+function renderTaskRow(name, status, selected, width) {
+    const cursor = selected ? '›' : ' ';
+    const label = `${STATUS_SYMBOLS[status]} ${STATUS_LABELS[status].padEnd(11)}`;
+    const row = ` ${cursor} ${label} ${truncateToWidth(name, width - 20)}`;
+    if (selected)
+        return theme.selected(padLine(row, width - 1));
+    return status === 'done' ? theme.muted(row) : row;
+}
+function renderTaskDetails(session, width) {
+    const task = session.selectedTask;
+    if (!task)
+        return [];
+    const description = task.description ?? 'Press n to record a progress note.';
+    const hint = 's: start · n: progress note · space: complete/reopen';
+    return [
+        ` ${theme.bold(truncateToWidth(task.name, width))}`,
+        ...wrapTextWithAnsi(description, width).slice(0, 2).map(line => ` ${theme.muted(line)}`),
+        ` ${theme.accent(`${STATUS_LABELS[task.status]} · ${hint}`)}`,
+    ];
+}
+function emptyMessage(session) {
+    if (session.query)
+        return ' No matches. Press Esc to clear the search.';
+    if (session.view === 'history')
+        return ' No archived tasks yet.';
+    if (session.view === 'daily')
+        return ' No updates on this day. Try [ or ] to browse.';
+    return ' All clear. Press a to add a task.';
+}
+function renderSidebar(session) {
+    const lines = ['', '', '', ` ${theme.muted('VAULTS')}`, ''];
+    session.vaults.forEach((vault, index) => {
+        const pending = vault.tasks.filter(task => task.status !== 'done').length;
+        const label = index === session.vaultIndex
+            ? theme.accent(theme.bold(` ▸ ${vault.name}`))
+            : theme.muted(`   ${vault.name}`);
+        lines.push(label, theme.muted(`   ${pending} open tasks`), '');
+    });
+    lines.push('', theme.muted(' Tab / ⇧Tab switch · V new vault'), '', theme.muted(' ──────────────────'), theme.muted(` ${session.syncMessage}`));
+    return lines;
+}
+function renderHelp() {
+    return [
+        ' ◈ TODOS / KEYBOARD SHORTCUTS', '',
+        ' j/k · gg/G   Move · first/last task',
+        ' Tab / ⇧Tab   Switch vault',
+        ' h/l · 1/2/3  Tasks / Daily / History',
+        ' Space        Complete / reopen task',
+        ' s            Start working on a task',
+        ' n            Write a progress note',
+        ' Enter        Read task activity',
+        ' [ / ]        Previous / next two-day window',
+        ' Ctrl+d/u     Scroll daily notes',
+        ' t            Today’s daily',
+        ' d            Delete task; press d again to confirm',
+        ' a · V · /     Add task · vault · search',
+        ' r            Sync, or link a Git remote if local-only',
+        ' Esc · ?      Back / clear · help',
+        ' q / Ctrl+C   Quit', '',
+        ' Daily keeps progress by local calendar date.',
+        ' Completed tasks move to History after 24 h.',
+    ].map(theme.muted);
+}
+export function taskActivityLines(session, width, taskId = session.selectedTask?.id) {
+    const task = session.vault.tasks.find(task => task.id === taskId);
+    if (!task)
+        return [];
+    const entries = session.view === 'daily'
+        ? session.dailyItems.find(item => item.task.id === task.id)?.entries ?? []
+        : session.vault.activity.filter(entry => entry.taskId === task.id);
+    return entries.flatMap(entry => renderActivityEntry(entry, Math.max(1, width - 4)));
+}
+function renderActivityEntry(entry, width) {
+    const date = entry.date.toLocaleString('en-US', {
+        month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit', hour12: false,
+    });
+    const heading = ` ${date} · ${ACTIVITY_LABELS[entry.kind]}`;
+    const note = entry.note ? wrapTextWithAnsi(entry.note, width).map(line => `   ${line}`) : [];
+    return [theme.accent(heading), ...note, ''];
+}
+function renderActivity(session, width, height, offset, taskId) {
+    const task = session.vault.tasks.find(task => task.id === taskId);
+    const title = task?.name ?? 'Task activity';
+    const allLines = taskActivityLines(session, width, taskId);
+    const availableRows = Math.max(1, height - ACTIVITY_HEADER_ROWS);
+    const start = Math.min(offset, Math.max(0, allLines.length - availableRows));
+    const count = `${Math.min(start + 1, allLines.length)}–${Math.min(start + availableRows, allLines.length)} / ${allLines.length}`;
+    return [
+        ` ${theme.bold(truncateToWidth(title, width - 3))}`,
+        ` ${theme.muted(`ACTIVITY · ${count} · j/k scroll · Esc back`)}`,
+        ` ${theme.muted('─'.repeat(width - 2))}`,
+        '',
+        ...(allLines.length ? allLines.slice(start, start + availableRows) : [theme.muted(' No activity yet. Press Esc, then n to add a note.')]),
+    ];
+}
+function renderFooter(session, inputLine, showActivity) {
+    const message = session.query
+        ? ` ${theme.accent(`/ ${session.query}`)} ${theme.muted('· Esc clear')}`
+        : ` ${theme.muted(session.message)}`;
+    if (showActivity) {
+        return [message, ' j/k scroll · gg/G first/last update', ' Esc / Enter back · q quit'];
+    }
+    return [
+        inputLine ?? message,
+        ` ${theme.accent('j/k')} move  ${theme.accent('Tab')} vault  ${theme.accent('h/l')} views  ${theme.accent('space')} done`,
+        ` ${theme.accent('s')} start  ${theme.accent('n')} note  ${theme.accent('d')} delete  ${theme.accent('V')} vault  ${theme.accent('r')} sync  ${theme.accent('?')} help`,
+    ];
+}

package/dist/index.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { main } from "./app/src/cli.js";
+void main();

package/package.json

@@ -1,6 +1,57 @@
 {
   "name": "@jlmarcos99/todos",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.1.0",
+  "description": "A keyboard-first task manager and daily work log for the terminal",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jlmarcos99/todos.git"
+  },
+  "homepage": "https://github.com/jlmarcos99/todos#readme",
+  "bugs": {
+    "url": "https://github.com/jlmarcos99/todos/issues"
+  },
+  "author": "jlmarcos99",
+  "bin": {
+    "todos": "dist/index.js"
+  },
+  "files": [
+    "dist/index.js",
+    "dist/app/src/",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "start": "npm run build && node dist/index.js",
+    "dev": "npm run build && node dist/index.js",
+    "init": "npm run build && node dist/index.js init",
+    "typecheck": "tsc --noEmit",
+    "build": "tsc && node scripts/prepare-bin.mjs",
+    "start:prod": "node dist/index.js",
+    "test": "npm run build && node --test dist/app/tests/*.test.js",
+    "changeset": "changeset",
+    "release": "npm run build && changeset publish"
+  },
+  "keywords": [
+    "todo",
+    "task-manager",
+    "daily-log",
+    "terminal",
+    "tui"
+  ],
+  "license": "ISC",
+  "type": "module",
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.20.0",
+    "typescript": "5.9.3",
+    "@changesets/cli": "^2.31.0"
+  },
+  "dependencies": {
+    "@earendil-works/pi-tui": "0.83.0"
+  }
+}