@nijaru/tk 0.0.4 → 0.1.1

package/src/lib/help.ts

@@ -1,249 +0,0 @@
-import { version } from "../../package.json";
-
-export const MAIN_HELP = `tk v${version} - Task tracker for AI agents
-
-USAGE:
-  tk <command> [options]
-
-COMMANDS:
-  init         Initialize .tasks/ directory
-  add          Create task
-  ls, list     List tasks
-  ready        List ready tasks (active/open + unblocked)
-  show         Show task details
-  start        Start working (open -> active)
-  done         Complete task
-  reopen       Reopen task
-  edit         Edit task
-  log          Add log entry
-  block        Add blocker
-  unblock      Remove blocker
-  rm, remove   Delete task
-  clean        Remove old done tasks
-  check        Check for data issues
-  config       Show/set configuration
-  completions  Output shell completions
-
-GLOBAL OPTIONS:
-  -C <dir>     Run in different directory
-  --json       Output as JSON
-  -h, --help   Show help
-  -V           Show version
-
-Run 'tk <command> --help' for command-specific options.
-`;
-
-export const COMMAND_HELP: Record<string, string> = {
-  init: `tk init - Initialize .tasks/ directory
-
-USAGE:
-  tk init [options]
-
-OPTIONS:
-  -P, --project <name>   Set default project name
-`,
-  add: `tk add - Create a new task
-
-USAGE:
-  tk add <title> [options]
-
-OPTIONS:
-  -p, --priority <0-4>       Priority (0=none, 1=urgent, 2=high, 3=medium, 4=low)
-  -P, --project <name>       Project prefix for ID
-  -d, --description <text>   Description
-  -l, --labels <csv>         Labels (comma-separated)
-  -A, --assignees <csv>      Assignees (comma-separated, @me for git user)
-  --parent <id>              Parent task ID
-  --estimate <n>             Estimate (user-defined units)
-  --due <date>               Due date (YYYY-MM-DD or +Nh/+Nd/+Nw/+Nm)
-
-EXAMPLES:
-  tk add "Fix login bug" -p 1
-  tk add "New feature" -P api -l bug,urgent
-  tk add "Sprint task" --due +7d
-`,
-  ls: `tk ls - List tasks
-
-USAGE:
-  tk ls [options]
-
-OPTIONS:
-  -s, --status <status>   Filter by status (open, active, done)
-  -p, --priority <0-4>    Filter by priority
-  -P, --project <name>    Filter by project
-  -l, --label <label>     Filter by label
-  --assignee <name>       Filter by assignee
-  --parent <id>           Filter by parent
-  --roots                 Show only root tasks (no parent)
-  --overdue               Show only overdue tasks
-  -n, --limit <n>         Limit results (default: 20)
-  -a, --all               Show all (no limit)
-
-EXAMPLES:
-  tk ls -s open -p 1      # Urgent open tasks
-  tk ls --overdue         # Overdue tasks
-  tk ls -P api --roots    # Root tasks in api project
-`,
-  list: `tk list - List tasks (alias for 'ls')
-
-Run 'tk ls --help' for options.
-`,
-  ready: `tk ready - List ready tasks (active/open + unblocked)
-
-USAGE:
-  tk ready
-
-Shows active or open tasks that are not blocked by any incomplete task.
-`,
-  show: `tk show - Show task details
-
-USAGE:
-  tk show <id>
-
-EXAMPLES:
-  tk show tk-1
-  tk show 1        # If unambiguous
-`,
-  start: `tk start - Start working on a task
-
-USAGE:
-  tk start <id>
-
-Changes status from open to active.
-`,
-  done: `tk done - Complete a task
-
-USAGE:
-  tk done <id>
-
-Changes status to done.
-`,
-  reopen: `tk reopen - Reopen a task
-
-USAGE:
-  tk reopen <id>
-
-Changes status back to open.
-`,
-  edit: `tk edit - Edit a task
-
-USAGE:
-  tk edit <id> [options]
-
-OPTIONS:
-  -t, --title <text>         New title
-  -d, --description <text>   New description
-  -p, --priority <0-4>       New priority
-  -l, --labels <csv>         Replace labels (use +tag/-tag to add/remove)
-  -A, --assignees <csv>      Replace assignees
-  --parent <id>              Set parent (use - to clear)
-  --estimate <n>             Set estimate (use - to clear)
-  --due <date>               Set due date (use - to clear)
-
-EXAMPLES:
-  tk edit tk-1 -t "New title"
-  tk edit tk-1 -l +urgent     # Add label
-  tk edit tk-1 --due -        # Clear due date
-`,
-  log: `tk log - Add a log entry to a task
-
-USAGE:
-  tk log <id> "<message>"
-
-Message must be quoted.
-
-EXAMPLES:
-  tk log tk-1 "Started implementation"
-  tk log tk-1 "Blocked on API changes"
-`,
-  block: `tk block - Add a blocker dependency
-
-USAGE:
-  tk block <task> <blocker>
-
-The first task becomes blocked by the second.
-
-EXAMPLES:
-  tk block tk-2 tk-1    # tk-2 is blocked by tk-1
-`,
-  unblock: `tk unblock - Remove a blocker dependency
-
-USAGE:
-  tk unblock <task> <blocker>
-
-EXAMPLES:
-  tk unblock tk-2 tk-1
-`,
-  rm: `tk rm - Delete a task
-
-USAGE:
-  tk rm <id>
-
-EXAMPLES:
-  tk rm tk-1
-`,
-  remove: `tk remove - Delete a task (alias for 'rm')
-
-USAGE:
-  tk remove <id>
-`,
-  clean: `tk clean - Remove old completed tasks
-
-USAGE:
-  tk clean [options]
-
-OPTIONS:
-  --older-than <days>   Age threshold in days (default: from config, 14)
-  -f, --force           Remove all done tasks (ignores age and disabled state)
-
-EXAMPLES:
-  tk clean                  # Remove done tasks older than config.clean_after days
-  tk clean --older-than 30  # Remove done tasks older than 30 days
-  tk clean --force          # Remove all done tasks regardless of age
-`,
-  check: `tk check - Check for data issues
-
-USAGE:
-  tk check
-
-Scans all tasks for issues. Auto-fixable issues (orphaned references, ID
-mismatches) are fixed automatically. Unfixable issues (corrupted JSON) are
-reported for manual intervention.
-
-Note: Auto-fixing also happens during normal task operations (show, done,
-edit, etc.) - this command is for bulk cleanup or diagnostics.
-
-EXAMPLES:
-  tk check                  # Scan and fix all tasks
-`,
-  config: `tk config - Show or set configuration
-
-USAGE:
-  tk config                              Show all config
-  tk config project                      Show default project
-  tk config project <name>               Set default project
-  tk config project <new> --rename <old> Rename project (old-* → new-*)
-  tk config alias                        List aliases
-  tk config alias <name> <path>          Add alias
-  tk config alias --rm <name>            Remove alias
-
-EXAMPLES:
-  tk config project api
-  tk config project lsmvec --rename cloudlsmvec
-  tk config alias web src/web
-`,
-  completions: `tk completions - Output shell completions
-
-USAGE:
-  tk completions <shell>
-
-SHELLS:
-  bash   Bash completion script
-  zsh    Zsh completion script
-  fish   Fish completion script
-
-EXAMPLES:
-  eval "$(tk completions bash)"   # Add to ~/.bashrc
-  eval "$(tk completions zsh)"    # Add to ~/.zshrc
-`,
-};

package/src/lib/priority.test.ts

@@ -1,105 +0,0 @@
-import { test, expect, describe } from "bun:test";
-import { parsePriority, formatPriority, formatPriorityName } from "./priority";
-
-describe("parsePriority", () => {
-  describe("valid inputs", () => {
-    test("returns 3 (medium) for undefined", () => {
-      expect(parsePriority(undefined)).toBe(3);
-    });
-
-    test("parses numeric strings 0-4", () => {
-      expect(parsePriority("0")).toBe(0);
-      expect(parsePriority("1")).toBe(1);
-      expect(parsePriority("2")).toBe(2);
-      expect(parsePriority("3")).toBe(3);
-      expect(parsePriority("4")).toBe(4);
-    });
-
-    test("parses numbers 0-4", () => {
-      expect(parsePriority(0)).toBe(0);
-      expect(parsePriority(1)).toBe(1);
-      expect(parsePriority(2)).toBe(2);
-      expect(parsePriority(3)).toBe(3);
-      expect(parsePriority(4)).toBe(4);
-    });
-
-    test("parses p0-p4 format (lowercase)", () => {
-      expect(parsePriority("p0")).toBe(0);
-      expect(parsePriority("p1")).toBe(1);
-      expect(parsePriority("p2")).toBe(2);
-      expect(parsePriority("p3")).toBe(3);
-      expect(parsePriority("p4")).toBe(4);
-    });
-
-    test("parses P0-P4 format (uppercase)", () => {
-      expect(parsePriority("P0")).toBe(0);
-      expect(parsePriority("P1")).toBe(1);
-      expect(parsePriority("P2")).toBe(2);
-      expect(parsePriority("P3")).toBe(3);
-      expect(parsePriority("P4")).toBe(4);
-    });
-
-    test("parses named priorities", () => {
-      expect(parsePriority("none")).toBe(0);
-      expect(parsePriority("urgent")).toBe(1);
-      expect(parsePriority("high")).toBe(2);
-      expect(parsePriority("medium")).toBe(3);
-      expect(parsePriority("low")).toBe(4);
-    });
-
-    test("parses named priorities case-insensitively", () => {
-      expect(parsePriority("URGENT")).toBe(1);
-      expect(parsePriority("High")).toBe(2);
-      expect(parsePriority("MEDIUM")).toBe(3);
-    });
-  });
-
-  describe("invalid inputs", () => {
-    test("throws for out of range numbers", () => {
-      expect(() => parsePriority("5")).toThrow("Invalid priority");
-      expect(() => parsePriority("-1")).toThrow("Invalid priority");
-      expect(() => parsePriority("99")).toThrow("Invalid priority");
-    });
-
-    test("throws for out of range pX format", () => {
-      expect(() => parsePriority("p5")).toThrow("Invalid priority");
-      expect(() => parsePriority("p6")).toThrow("Invalid priority");
-      expect(() => parsePriority("p-1")).toThrow("Invalid priority");
-    });
-
-    test("throws for invalid named priorities", () => {
-      expect(() => parsePriority("critical")).toThrow("Invalid priority");
-      expect(() => parsePriority("abc")).toThrow("Invalid priority");
-    });
-
-    test("throws for empty string", () => {
-      expect(() => parsePriority("")).toThrow("Invalid priority");
-    });
-
-    test("error message includes valid formats", () => {
-      expect(() => parsePriority("invalid")).toThrow(
-        "Use 0-4, p0-p4, or none/urgent/high/medium/low",
-      );
-    });
-  });
-});
-
-describe("formatPriority", () => {
-  test("formats priorities as pX", () => {
-    expect(formatPriority(0)).toBe("p0");
-    expect(formatPriority(1)).toBe("p1");
-    expect(formatPriority(2)).toBe("p2");
-    expect(formatPriority(3)).toBe("p3");
-    expect(formatPriority(4)).toBe("p4");
-  });
-});
-
-describe("formatPriorityName", () => {
-  test("formats priorities as names", () => {
-    expect(formatPriorityName(0)).toBe("none");
-    expect(formatPriorityName(1)).toBe("urgent");
-    expect(formatPriorityName(2)).toBe("high");
-    expect(formatPriorityName(3)).toBe("medium");
-    expect(formatPriorityName(4)).toBe("low");
-  });
-});

package/src/lib/priority.ts

@@ -1,40 +0,0 @@
-import type { Priority } from "../types";
-import { PRIORITY_FROM_NAME, PRIORITY_LABELS } from "../types";
-
-/**
- * Parse priority from various formats:
- * - Number: 0-4
- * - Prefixed: p0-p4
- * - Named: none, urgent, high, medium, low
- */
-export function parsePriority(input: string | number | undefined): Priority {
-  if (input === undefined) return 3; // default: medium
-
-  const str = String(input).toLowerCase();
-
-  // Handle named format
-  const named = PRIORITY_FROM_NAME[str];
-  if (named !== undefined) {
-    return named;
-  }
-
-  // Handle pX format
-  if (str.startsWith("p")) {
-    const num = parseInt(str.slice(1), 10);
-    if (num >= 0 && num <= 4) return num as Priority;
-  }
-
-  // Handle numeric format
-  const num = parseInt(str, 10);
-  if (num >= 0 && num <= 4) return num as Priority;
-
-  throw new Error(`Invalid priority: ${input}. Use 0-4, p0-p4, or none/urgent/high/medium/low.`);
-}
-
-export function formatPriority(p: Priority): string {
-  return `p${p}`;
-}
-
-export function formatPriorityName(p: Priority): string {
-  return PRIORITY_LABELS[p];
-}

package/src/lib/root.ts

@@ -1,79 +0,0 @@
-import { existsSync } from "fs";
-import { join, dirname, resolve } from "path";
-
-const TASKS_DIR = ".tasks";
-const GIT_DIR = ".git";
-
-// Global override for working directory (set via -C flag)
-let workingDir: string | null = null;
-
-export function setWorkingDir(dir: string | null): void {
-  workingDir = dir ? resolve(dir) : null;
-}
-
-export function getWorkingDir(): string {
-  return workingDir ?? process.cwd();
-}
-
-export interface RootInfo {
-  root: string;
-  tasksDir: string;
-  exists: boolean;
-}
-
-/**
- * Find the project root by walking up directories.
- * Looks for existing .tasks/ or .git/ directory.
- * Returns cwd if neither found.
- */
-export function findRoot(): RootInfo {
-  let current = getWorkingDir();
-
-  while (true) {
-    const tasksPath = join(current, TASKS_DIR);
-    if (existsSync(tasksPath)) {
-      return { root: current, tasksDir: tasksPath, exists: true };
-    }
-
-    const gitPath = join(current, GIT_DIR);
-    if (existsSync(gitPath)) {
-      return {
-        root: current,
-        tasksDir: join(current, TASKS_DIR),
-        exists: false,
-      };
-    }
-
-    const parent = dirname(current);
-    if (parent === current) break; // Reached filesystem root
-    current = parent;
-  }
-
-  // No .git or .tasks found, use working dir
-  const wd = getWorkingDir();
-  return {
-    root: wd,
-    tasksDir: join(wd, TASKS_DIR),
-    exists: false,
-  };
-}
-
-/**
- * Get the tasks directory path, optionally requiring it to exist.
- */
-export function getTasksDir(requireExists = false): string {
-  const info = findRoot();
-  if (requireExists && !info.exists) {
-    throw new TasksNotFoundError(info.root);
-  }
-  return info.tasksDir;
-}
-
-export class TasksNotFoundError extends Error {
-  constructor(searchedFrom: string) {
-    super(
-      `No .tasks/ directory found. Run 'tk add' to create one, or initialize with 'tk init'.\nSearched from: ${searchedFrom}`,
-    );
-    this.name = "TasksNotFoundError";
-  }
-}

package/src/lib/time.ts

@@ -1,115 +0,0 @@
-import type { Status } from "../types";
-
-/**
- * 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 || !month || !day) return false;
-  const due = new Date(year, month - 1, day);
-  return due < today;
-}
-
-/**
- * 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);
-}