@nijaru/tk 0.0.5 → 0.1.1

package/src/lib/time.ts

@@ -1,138 +0,0 @@
-import type { Status } from "../types";
-
-export const DUE_SOON_THRESHOLD = 7;
-
-/**
- * Determines if a task is overdue.
- * Done tasks are never overdue.
- */
-export function isTaskOverdue(dueDate: string | null, status: Status): boolean {
-  if (!dueDate || status === "done") return false;
-  const today = new Date();
-  today.setHours(0, 0, 0, 0);
-  const parts = dueDate.split("-").map(Number);
-  const year = parts[0];
-  const month = parts[1];
-  const day = parts[2];
-  if (year === undefined || !month || !day) return false;
-  const due = new Date(year, month - 1, day);
-  return due < today;
-}
-
-/**
- * Returns the number of days until a task is due (0 = today), or null if:
- * - No due date
- * - Task is done
- * - Task is already overdue
- */
-export function daysUntilDue(dueDate: string | null, status: Status): number | null {
-  if (!dueDate || status === "done") return null;
-  const today = new Date();
-  today.setHours(0, 0, 0, 0);
-  const parts = dueDate.split("-").map(Number);
-  const year = parts[0];
-  const month = parts[1];
-  const day = parts[2];
-  if (year === undefined || !month || !day) return null;
-  const due = new Date(year, month - 1, day);
-  const diffMs = due.getTime() - today.getTime();
-  if (diffMs < 0) return null; // already overdue
-  return Math.round(diffMs / (1000 * 60 * 60 * 24));
-}
-
-/**
- * Format a timestamp into a human-readable relative time (e.g., "2d", "5h").
- */
-export function formatRelativeTime(timestamp: string): string {
-  const now = new Date();
-  const date = new Date(timestamp);
-  const diffMs = now.getTime() - date.getTime();
-  const diffSec = Math.floor(diffMs / 1000);
-  const diffMin = Math.floor(diffSec / 60);
-  const diffHour = Math.floor(diffMin / 60);
-  const diffDay = Math.floor(diffHour / 24);
-
-  if (diffDay > 0) return `${diffDay}d`;
-  if (diffHour > 0) return `${diffHour}h`;
-  if (diffMin > 0) return `${diffMin}m`;
-  return "now";
-}
-
-/**
- * Format a timestamp into a localized date string.
- */
-export function formatDate(timestamp: string): string {
-  return new Date(timestamp).toLocaleString();
-}
-
-/**
- * Format a Date object into YYYY-MM-DD.
- */
-export function formatLocalDate(date: Date): string {
-  const year = date.getFullYear();
-  const month = String(date.getMonth() + 1).padStart(2, "0");
-  const day = String(date.getDate()).padStart(2, "0");
-  return `${year}-${month}-${day}`;
-}
-
-/**
- * Parse a due date input string. Supports YYYY-MM-DD and relative formats like +7d.
- */
-export function parseDueDate(input: string | undefined): string | undefined {
-  if (!input) return undefined;
-  if (input === "-") return undefined;
-
-  // Handle relative dates like +7d
-  if (input.startsWith("+")) {
-    const match = input.match(/^\+(\d+)([dwmh])$/);
-    if (match && match[1] && match[2]) {
-      const num = match[1];
-      const unit = match[2] as "h" | "d" | "w" | "m";
-      const n = Number(num);
-      const now = new Date();
-      now.setSeconds(0, 0); // Normalize to start of minute for predictability
-      switch (unit) {
-        case "h":
-          now.setHours(now.getHours() + n);
-          break;
-        case "d":
-          now.setDate(now.getDate() + n);
-          break;
-        case "w":
-          now.setDate(now.getDate() + n * 7);
-          break;
-        case "m":
-          now.setMonth(now.getMonth() + n);
-          break;
-      }
-      return formatLocalDate(now);
-    }
-    throw new Error(`Invalid relative date: ${input}. Use format like +7d, +2w, +1m`);
-  }
-
-  // Validate YYYY-MM-DD format
-  const dateMatch = input.match(/^(\d{4})-(\d{2})-(\d{2})$/);
-  if (dateMatch) {
-    const [, year, month, day] = dateMatch;
-    const y = parseInt(year!, 10);
-    const m = parseInt(month!, 10);
-    const d = parseInt(day!, 10);
-    const date = new Date(y, m - 1, d);
-    if (date.getFullYear() === y && date.getMonth() === m - 1 && date.getDate() === d) {
-      return input;
-    }
-  }
-
-  throw new Error(`Invalid date format: ${input}. Use YYYY-MM-DD or relative like +7d`);
-}
-
-/**
- * Parse an estimate string (number of minutes/hours/etc. depending on convention).
- */
-export function parseEstimate(input: string | undefined): number | undefined {
-  if (!input) return undefined;
-  if (!/^\d+$/.test(input)) {
-    throw new Error(`Invalid estimate: ${input}. Must be a non-negative number.`);
-  }
-  return Number(input);
-}

package/src/types.ts

@@ -1,130 +0,0 @@
-export type Status = "open" | "active" | "done";
-export type Priority = 0 | 1 | 2 | 3 | 4;
-
-export interface LogEntry {
-  ts: string; // ISO 8601 timestamp
-  msg: string;
-}
-
-export interface ExternalLink {
-  number?: number;
-  repo?: string;
-  synced_at?: string;
-}
-
-export interface Task {
-  project: string;
-  ref: string; // random 4-char alphanumeric
-  title: string;
-  description: string | null;
-  status: Status;
-  priority: Priority;
-  labels: string[];
-  assignees: string[];
-  parent: string | null; // full ID like "api-a7b3"
-  blocked_by: string[];
-  estimate: number | null;
-  due_date: string | null; // ISO date string "2026-01-15"
-  logs: LogEntry[];
-  created_at: string; // ISO 8601
-  updated_at: string; // ISO 8601
-  completed_at: string | null; // ISO 8601
-  external: {
-    github?: ExternalLink;
-    linear?: ExternalLink;
-    jira?: ExternalLink;
-  };
-}
-
-// Computed ID from project + ref
-export function taskId(task: { project: string; ref: string }): string {
-  return `${task.project}-${task.ref}`;
-}
-
-// Parse "api-a7b3" into {project: "api", ref: "a7b3"}
-export function parseId(id: string): { project: string; ref: string } | null {
-  const match = id.match(/^([a-z][a-z0-9]*)-([a-z0-9]+)$/);
-  if (!match || !match[1] || !match[2]) return null;
-  return { project: match[1], ref: match[2] };
-}
-
-// Generate random 4-char ref (a-z0-9)
-export function generateRef(): string {
-  const chars = "abcdefghijklmnopqrstuvwxyz0123456789"; // 36 chars
-  const charsetLen = chars.length; // 36
-  const maxValid = charsetLen * Math.floor(256 / charsetLen); // 252: reject >= maxValid to avoid modulo bias
-  const result: string[] = [];
-
-  while (result.length < 4) {
-    const bytes = new Uint8Array(4);
-    crypto.getRandomValues(bytes);
-    for (const b of bytes) {
-      if (b < maxValid && result.length < 4) {
-        result.push(chars[b % charsetLen]!);
-      }
-    }
-  }
-  return result.join("");
-}
-
-export interface TaskWithMeta extends Task {
-  id: string; // computed from project-ref
-  blocked_by_incomplete: boolean;
-  is_overdue: boolean;
-  days_until_due: number | null;
-}
-
-export interface Config {
-  version: number;
-  project: string; // default project
-  defaults: {
-    priority: Priority;
-    labels: string[];
-    assignees: string[];
-  };
-  clean_after: number | false; // days to keep done tasks, or false to disable
-}
-
-export const DEFAULT_CONFIG: Config = {
-  version: 1,
-  project: "tk",
-  defaults: {
-    priority: 3,
-    labels: [],
-    assignees: [],
-  },
-  clean_after: 14,
-};
-
-export const PRIORITY_LABELS: Record<Priority, string> = {
-  0: "none",
-  1: "urgent",
-  2: "high",
-  3: "medium",
-  4: "low",
-};
-
-export const PRIORITY_FROM_NAME: Record<string, Priority> = {
-  none: 0,
-  urgent: 1,
-  high: 2,
-  medium: 3,
-  low: 4,
-};
-
-export const STATUS_COLORS: Record<Status, string> = {
-  open: "\x1b[33m", // yellow
-  active: "\x1b[36m", // cyan
-  done: "\x1b[32m", // green
-};
-
-export const PRIORITY_COLORS: Record<Priority, string> = {
-  0: "\x1b[90m", // gray (none)
-  1: "\x1b[31m", // red (urgent)
-  2: "\x1b[33m", // yellow (high)
-  3: "\x1b[0m", // default (medium)
-  4: "\x1b[90m", // gray (low)
-};
-
-export const OVERDUE_COLOR = "\x1b[31m"; // red
-export const RESET = "\x1b[0m";