@tomkapa/tayto 0.7.0 → 0.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomkapa/tayto",
-  "version": "0.7.0",
+  "version": "0.8.1",
   "description": "CLI tool for task management - for solo devs and AI agents",
   "type": "module",
   "bin": {
@@ -19,7 +19,7 @@
     "test:watch": "vitest"
   },
   "engines": {
-    "node": ">=25"
+    "node": ">=22"
   },
   "keywords": [
     "cli",

package/dist/chunk-5V4TBQ5S.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/logging/logger.ts","../src/types/enums.ts","../src/utils/git.ts","../src/types/common.ts","../src/types/git-remote.ts"],"sourcesContent":["import { appendFileSync, readdirSync, unlinkSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { trace, type Span, SpanStatusCode } from '@opentelemetry/api';\n\nconst tracer = trace.getTracer('task');\nconst LOG_RETENTION_DAYS = 7;\n\nexport interface LogAttributes {\n  [key: string]: string | number | boolean;\n}\n\ntype LogLevel = 'INFO' | 'WARN' | 'ERROR';\n\nfunction formatTimestamp(): string {\n  return new Date().toISOString();\n}\n\nfunction formatAttrs(attrs?: LogAttributes): string {\n  if (!attrs || Object.keys(attrs).length === 0) return '';\n  return ' ' + JSON.stringify(attrs);\n}\n\nclass Logger {\n  private logFilePath: string | null = null;\n\n  init(logDir: string): void {\n    const date = new Date().toISOString().slice(0, 10); // YYYY-MM-DD\n    this.logFilePath = join(logDir, `task-${date}.log`);\n    this.pruneOldLogs(logDir);\n  }\n\n  info(message: string, attrs?: LogAttributes): void {\n    this.write('INFO', message, attrs);\n    const span = trace.getActiveSpan();\n    if (span) {\n      span.addEvent(message, attrs);\n    }\n  }\n\n  warn(message: string, attrs?: LogAttributes): void {\n    this.write('WARN', message, attrs);\n    const span = trace.getActiveSpan();\n    if (span) {\n      span.addEvent(`WARN: ${message}`, attrs);\n    }\n  }\n\n  error(message: string, error?: unknown, attrs?: LogAttributes): void {\n    const errorDetail = error instanceof Error ? ` | ${error.stack ?? error.message}` : '';\n    this.write('ERROR', `${message}${errorDetail}`, attrs);\n    const span = trace.getActiveSpan();\n    if (span) {\n      span.addEvent(`ERROR: ${message}`, attrs);\n      if (error instanceof Error) {\n        span.recordException(error);\n      }\n      span.setStatus({ code: SpanStatusCode.ERROR, message });\n    }\n  }\n\n  startSpan<T>(name: string, fn: (span: Span) => T): T {\n    return tracer.startActiveSpan(name, (span) => {\n      try {\n        const result = fn(span);\n        span.end();\n        return result;\n      } catch (e) {\n        if (e instanceof Error) {\n          span.recordException(e);\n        }\n        span.setStatus({ code: SpanStatusCode.ERROR });\n        span.end();\n        throw e;\n      }\n    });\n  }\n\n  private write(level: LogLevel, message: string, attrs?: LogAttributes): void {\n    if (!this.logFilePath) return;\n    const line = `${formatTimestamp()} [${level}] ${message}${formatAttrs(attrs)}\\n`;\n    try {\n      appendFileSync(this.logFilePath, line);\n    } catch {\n      // Swallowing here is intentional: logging must never crash the app.\n      // If the log file is unwritable, the OTel span still captures the event.\n    }\n  }\n\n  private pruneOldLogs(logDir: string): void {\n    try {\n      const cutoff = Date.now() - LOG_RETENTION_DAYS * 24 * 60 * 60 * 1000;\n      const files = readdirSync(logDir).filter((f) => f.startsWith('task-') && f.endsWith('.log'));\n      for (const file of files) {\n        const dateStr = file.slice('task-'.length, -'.log'.length);\n        const fileDate = new Date(dateStr).getTime();\n        if (!isNaN(fileDate) && fileDate < cutoff) {\n          unlinkSync(join(logDir, file));\n        }\n      }\n    } catch {\n      // Best-effort cleanup — don't crash if pruning fails\n    }\n  }\n}\n\nexport const logger = new Logger();\n","export const TaskStatus = {\n  Backlog: 'backlog',\n  Todo: 'todo',\n  InProgress: 'in-progress',\n  Review: 'review',\n  Done: 'done',\n  Cancelled: 'cancelled',\n} as const;\nexport type TaskStatus = (typeof TaskStatus)[keyof typeof TaskStatus];\n\nexport const TaskType = {\n  Epic: 'epic',\n  Story: 'story',\n  TechDebt: 'tech-debt',\n  Bug: 'bug',\n} as const;\nexport type TaskType = (typeof TaskType)[keyof typeof TaskType];\n\n/**\n * Task level derived from type.\n * Level 1: epics (grouping/planning layer)\n * Level 2: stories, tech-debt, bugs (execution layer)\n */\nexport const TaskLevel = {\n  Epic: 1,\n  Work: 2,\n} as const;\nexport type TaskLevel = (typeof TaskLevel)[keyof typeof TaskLevel];\n\nconst TYPE_TO_LEVEL: Record<string, TaskLevel> = {\n  [TaskType.Epic]: TaskLevel.Epic,\n  [TaskType.Story]: TaskLevel.Work,\n  [TaskType.TechDebt]: TaskLevel.Work,\n  [TaskType.Bug]: TaskLevel.Work,\n};\n\nexport function getTaskLevel(type: string): TaskLevel {\n  return TYPE_TO_LEVEL[type] ?? TaskLevel.Work;\n}\n\n/** Types that belong to the work (level 2) execution layer. */\nexport const WORK_TYPES: ReadonlySet<string> = new Set([\n  TaskType.Story,\n  TaskType.TechDebt,\n  TaskType.Bug,\n]);\n\n/** Types stored in the database. */\nexport const DependencyType = {\n  Blocks: 'blocks',\n  RelatesTo: 'relates-to',\n  Duplicates: 'duplicates',\n} as const;\nexport type DependencyType = (typeof DependencyType)[keyof typeof DependencyType];\n\n/**\n * UI-level dependency types — includes BlockedBy which is a reverse-Blocks\n * relationship resolved before persisting to the database.\n */\nexport const UIDependencyType = {\n  ...DependencyType,\n  BlockedBy: 'blocked-by',\n} as const;\nexport type UIDependencyType = (typeof UIDependencyType)[keyof typeof UIDependencyType];\n\n/** Gap between consecutive rank values, used for insertion between neighbors. */\nexport const RANK_GAP = 1000.0;\n\n/**\n * Collapse-safe midpoint between two rank values. Returns `null` when\n * IEEE 754 double precision cannot represent a strictly-between value —\n * callers use this as a signal to rebalance the rank grid and retry.\n * Returning a number unconditionally would silently collide with an\n * endpoint and corrupt the task ordering.\n */\nexport function midpoint(a: number, b: number): number | null {\n  const m = (a + b) / 2;\n  return m > a && m < b ? m : null;\n}\n\n/** Statuses that represent terminal/completed task states. */\nexport const TERMINAL_STATUSES: ReadonlySet<string> = new Set([\n  TaskStatus.Done,\n  TaskStatus.Cancelled,\n]);\n\nexport function isTerminalStatus(status: string): boolean {\n  return TERMINAL_STATUSES.has(status);\n}\n","import { spawnSync } from 'node:child_process';\nimport type { Result } from '../types/common.js';\nimport { ok } from '../types/common.js';\nimport { GitRemote } from '../types/git-remote.js';\nimport { logger } from '../logging/logger.js';\n\n/**\n * Detect the git origin remote URL from the given directory.\n * Returns ok(GitRemote) if found, ok(null) if no git repo or no origin remote.\n * Never returns err() — all git failures are silent fallbacks.\n */\nexport function detectGitRemote(cwd?: string): Result<GitRemote | null> {\n  try {\n    const result = spawnSync('git', ['remote', 'get-url', 'origin'], {\n      cwd: cwd ?? process.cwd(),\n      encoding: 'utf-8',\n      timeout: 5000,\n    });\n\n    if (result.status !== 0 || result.error) {\n      logger.info('detectGitRemote: no git remote found (non-zero exit or error)');\n      return ok(null);\n    }\n\n    const raw = result.stdout.trim();\n    if (!raw) {\n      logger.info('detectGitRemote: empty stdout from git remote get-url');\n      return ok(null);\n    }\n\n    const remote = GitRemote.parse(raw);\n    logger.info(`detectGitRemote: found remote=${remote.value}`);\n    return ok(remote);\n  } catch (e: unknown) {\n    logger.info(`detectGitRemote: exception during git detection: ${String(e)}`);\n    return ok(null);\n  }\n}\n","import type { AppError } from '../errors/app-error.js';\n\nexport type Result<T, E = AppError> = { ok: true; value: T } | { ok: false; error: E };\n\nexport function ok<T>(value: T): Result<T, never> {\n  return { ok: true, value };\n}\n\nexport function err<E>(error: E): Result<never, E> {\n  return { ok: false, error };\n}\n\nexport interface CLIOutput<T> {\n  ok: boolean;\n  data?: T;\n  error?: { code: string; message: string };\n}\n","/**\n * Value object representing a normalized git remote URL.\n * Accepts any common format (SSH or HTTPS, with or without .git suffix)\n * and stores the canonical `host/owner/repo` form.\n */\nexport class GitRemote {\n  readonly value: string;\n\n  private constructor(normalized: string) {\n    this.value = normalized;\n  }\n\n  static parse(raw: string): GitRemote {\n    return new GitRemote(GitRemote.normalize(raw));\n  }\n\n  private static normalize(url: string): string {\n    const trimmed = url.trim();\n\n    // SSH format: git@github.com:owner/repo.git or git@github.com:owner/repo\n    const sshMatch = trimmed.match(/^git@([^:]+):(.+?)(?:\\.git)?$/);\n    if (sshMatch) {\n      const [, host, path] = sshMatch;\n      return `${host}/${path}`.toLowerCase();\n    }\n\n    // HTTPS/HTTP format: https://github.com/owner/repo.git or without .git\n    try {\n      const parsed = new URL(trimmed);\n      const path = parsed.pathname.replace(/\\.git$/, '').replace(/^\\//, '');\n      return `${parsed.host}/${path}`.toLowerCase();\n    } catch {\n      return trimmed.toLowerCase();\n    }\n  }\n\n  equals(other: GitRemote): boolean {\n    return this.value === other.value;\n  }\n\n  toString(): string {\n    return this.value;\n  }\n}\n"],"mappings":"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","names":[]}