@masslessai/push-todo 3.0.0

package/lib/utils/format.js

@@ -0,0 +1,253 @@
+/**
+ * Output formatting utilities for Push CLI.
+ *
+ * Formats tasks and other data for display.
+ */
+
+import { bold, dim, green, yellow, red, cyan, muted, symbols } from './colors.js';
+
+/**
+ * Format a duration in seconds to human-readable string.
+ *
+ * @param {number} seconds
+ * @returns {string} e.g., "2h 30m", "5m", "45s"
+ */
+export function formatDuration(seconds) {
+  if (seconds < 60) {
+    return `${seconds}s`;
+  } else if (seconds < 3600) {
+    const mins = Math.floor(seconds / 60);
+    const secs = seconds % 60;
+    return secs ? `${mins}m ${secs}s` : `${mins}m`;
+  } else {
+    const hours = Math.floor(seconds / 3600);
+    const mins = Math.floor((seconds % 3600) / 60);
+    return mins ? `${hours}h ${mins}m` : `${hours}h`;
+  }
+}
+
+/**
+ * Format a date for display.
+ *
+ * @param {string|Date} date - ISO date string or Date object
+ * @returns {string}
+ */
+export function formatDate(date) {
+  const d = typeof date === 'string' ? new Date(date) : date;
+  return d.toLocaleString();
+}
+
+/**
+ * Format a task for human-readable display.
+ *
+ * @param {Object} task - Task object
+ * @returns {string} Formatted task string
+ */
+export function formatTaskForDisplay(task) {
+  const lines = [];
+
+  // Build task header with display number and status indicator
+  const displayNum = task.displayNumber || task.display_number;
+
+  // Determine status prefix
+  let statusPrefix = '';
+  if (task.isCompleted || task.is_completed) {
+    statusPrefix = '✅ '; // Completed
+  } else if (task.isBacklog || task.is_backlog) {
+    statusPrefix = '📦 '; // Backlog
+  }
+
+  const numPrefix = displayNum ? `#${displayNum} ` : '';
+  const summary = task.summary || 'No summary';
+
+  lines.push(`## Task: ${numPrefix}${statusPrefix}${summary}`);
+  lines.push('');
+
+  // Project hint
+  if (task.projectHint || task.project_hint) {
+    lines.push(`**Project:** ${task.projectHint || task.project_hint}`);
+    lines.push('');
+  }
+
+  // Content
+  lines.push('### Content');
+  lines.push(task.content || task.normalizedContent || 'No content');
+  lines.push('');
+
+  // Attachments
+  const screenshots = task.screenshotAttachments || task.screenshot_attachments || [];
+  const links = task.linkAttachments || task.link_attachments || [];
+
+  if (screenshots.length > 0 || links.length > 0) {
+    lines.push('### Attachments');
+    lines.push('');
+
+    if (screenshots.length > 0) {
+      lines.push(`#### Screenshots (${screenshots.length})`);
+      screenshots.forEach((screenshot, idx) => {
+        const filename = screenshot.imageFilename || 'unknown';
+        const width = screenshot.width;
+        const height = screenshot.height;
+        const dimensions = width && height ? `(${width}x${height})` : '';
+        lines.push(`${idx + 1}. ${filename} ${dimensions}`);
+      });
+      lines.push('');
+    }
+
+    if (links.length > 0) {
+      lines.push(`#### Links (${links.length})`);
+      links.forEach(link => {
+        const url = link.url || '';
+        const title = link.title || url;
+        lines.push(`🔗 [${title}](${url})`);
+      });
+      lines.push('');
+    }
+  }
+
+  // Transcript
+  const transcript = task.transcript || task.originalTranscript;
+  if (transcript) {
+    lines.push('### Original Voice Transcript');
+    lines.push(`> ${transcript}`);
+    lines.push('');
+  }
+
+  // Metadata
+  lines.push(`**Task ID:** \`${task.id || 'unknown'}\``);
+  if (displayNum) {
+    lines.push(`**Display Number:** #${displayNum}`);
+  }
+
+  // Status
+  if (task.isCompleted || task.is_completed) {
+    lines.push('**Status:** ✅ Completed');
+    // Show session resume hint if session_id is available
+    const sessionId = task.executionSessionId || task.execution_session_id;
+    if (sessionId) {
+      lines.push(`**Session:** Available (\`push-todo resume ${displayNum}\`)`);
+    }
+  } else if (task.isBacklog || task.is_backlog) {
+    lines.push('**Status:** 📦 Backlog');
+  } else {
+    lines.push('**Status:** Active');
+  }
+
+  const createdAt = task.createdAt || task.created_at;
+  lines.push(`**Created:** ${createdAt || 'unknown'}`);
+
+  return lines.join('\n');
+}
+
+/**
+ * Format a search result for display.
+ *
+ * @param {Object} result - Search result object
+ * @returns {string}
+ */
+export function formatSearchResult(result) {
+  const lines = [];
+
+  const displayNum = result.displayNumber;
+  const isCompleted = result.isCompleted;
+  const isBacklog = result.isBacklog;
+
+  // Status indicators
+  let status = '';
+  if (isCompleted) {
+    status = ' [COMPLETED]';
+  } else if (isBacklog) {
+    status = ' [BACKLOG]';
+  }
+
+  const numPrefix = displayNum ? `#${displayNum}` : '??';
+  const title = result.summary || result.title || 'No summary';
+
+  lines.push(`**${numPrefix}**${status} ${title}`);
+
+  // Show match context if available
+  const matchContext = result.matchContext;
+  if (matchContext) {
+    lines.push(`  > ${matchContext}`);
+  }
+
+  return lines.join('\n');
+}
+
+/**
+ * Format a task list as a table.
+ *
+ * @param {Object[]} tasks - Array of tasks
+ * @returns {string}
+ */
+export function formatTaskTable(tasks) {
+  if (tasks.length === 0) {
+    return 'No tasks found.';
+  }
+
+  const lines = [];
+  lines.push('| #   | Task                          | Status    |');
+  lines.push('|-----|-------------------------------|-----------|');
+
+  for (const task of tasks) {
+    const num = String(task.displayNumber || task.display_number || '?').padEnd(3);
+    let summary = (task.summary || 'No summary').slice(0, 28);
+    if (summary.length < 28) {
+      summary = summary.padEnd(28);
+    } else {
+      summary = summary.slice(0, 27) + '…';
+    }
+
+    let status = 'Active';
+    if (task.isCompleted || task.is_completed) {
+      status = '✅ Done';
+    } else if (task.isBacklog || task.is_backlog) {
+      status = '📦 Later';
+    }
+    status = status.padEnd(9);
+
+    lines.push(`| ${num} | ${summary} | ${status} |`);
+  }
+
+  return lines.join('\n');
+}
+
+/**
+ * Format batch offer for display.
+ *
+ * @param {Object[]} tasks - Tasks to offer
+ * @returns {string}
+ */
+export function formatBatchOffer(tasks) {
+  const count = tasks.length;
+  const numbers = tasks.map(t => t.displayNumber || t.display_number).join(',');
+
+  const lines = [];
+  lines.push('='.repeat(50));
+  lines.push(`BATCH_OFFER: ${count}`);
+  lines.push(`BATCH_TASKS: ${numbers}`);
+
+  for (const task of tasks) {
+    const num = task.displayNumber || task.display_number;
+    const summary = (task.summary || 'No summary').slice(0, 50);
+    lines.push(`  #${num} - ${summary}`);
+  }
+
+  lines.push('='.repeat(50));
+
+  return lines.join('\n');
+}
+
+/**
+ * Truncate a string to a maximum length.
+ *
+ * @param {string} str
+ * @param {number} maxLength
+ * @returns {string}
+ */
+export function truncate(str, maxLength) {
+  if (!str || str.length <= maxLength) {
+    return str || '';
+  }
+  return str.slice(0, maxLength - 1) + '…';
+}

package/lib/utils/git.js

@@ -0,0 +1,149 @@
+/**
+ * Git utilities for Push CLI.
+ *
+ * Provides helpers for git operations like getting remote URLs.
+ */
+
+import { execSync } from 'child_process';
+
+/**
+ * Get the normalized git remote URL for the current directory.
+ *
+ * Normalizes URLs to a consistent format:
+ * - git@github.com:user/repo.git → github.com/user/repo
+ * - https://github.com/user/repo.git → github.com/user/repo
+ *
+ * @returns {string|null} Normalized git remote or null if not a git repo
+ */
+export function getGitRemote() {
+  try {
+    const result = execSync('git remote get-url origin', {
+      encoding: 'utf8',
+      timeout: 5000,
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+
+    let url = result.trim();
+    if (!url) {
+      return null;
+    }
+
+    // Normalize: remove protocol, convert : to /, remove .git
+    // git@github.com:user/repo.git → github.com/user/repo
+    // https://github.com/user/repo.git → github.com/user/repo
+
+    // Remove protocol prefixes
+    const prefixes = ['https://', 'http://', 'git@', 'ssh://git@'];
+    for (const prefix of prefixes) {
+      if (url.startsWith(prefix)) {
+        url = url.slice(prefix.length);
+        break;
+      }
+    }
+
+    // Convert : to / (for git@ style)
+    if (url.includes(':') && !url.includes('://')) {
+      url = url.replace(':', '/');
+    }
+
+    // Remove .git suffix
+    if (url.endsWith('.git')) {
+      url = url.slice(0, -4);
+    }
+
+    return url;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Check if the current directory is a git repository.
+ *
+ * @returns {boolean}
+ */
+export function isGitRepo() {
+  try {
+    execSync('git rev-parse --git-dir', {
+      encoding: 'utf8',
+      timeout: 5000,
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Get the current git branch name.
+ *
+ * @returns {string|null}
+ */
+export function getCurrentBranch() {
+  try {
+    const result = execSync('git rev-parse --abbrev-ref HEAD', {
+      encoding: 'utf8',
+      timeout: 5000,
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+    return result.trim() || null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Get the root directory of the git repository.
+ *
+ * @returns {string|null}
+ */
+export function getGitRoot() {
+  try {
+    const result = execSync('git rev-parse --show-toplevel', {
+      encoding: 'utf8',
+      timeout: 5000,
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+    return result.trim() || null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Get recent commit messages for context.
+ *
+ * @param {number} count - Number of commits to fetch
+ * @returns {string[]} Array of commit messages
+ */
+export function getRecentCommits(count = 5) {
+  try {
+    const result = execSync(`git log --oneline -${count}`, {
+      encoding: 'utf8',
+      timeout: 5000,
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+    return result.trim().split('\n').filter(Boolean);
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * Check if there are uncommitted changes.
+ *
+ * @returns {boolean}
+ */
+export function hasUncommittedChanges() {
+  try {
+    const result = execSync('git status --porcelain', {
+      encoding: 'utf8',
+      timeout: 5000,
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+    return result.trim().length > 0;
+  } catch {
+    return false;
+  }
+}