@tomkapa/tayto 0.1.0

package/README.md

@@ -0,0 +1,217 @@
+# tayto
+
+Task management for solo developers and AI agents. Two interfaces, one database.
+
+- **CLI** returns structured JSON — built for AI agents and scripting
+- **TUI** renders rich markdown in the terminal — built for humans
+
+SQLite-backed. No server. No login. Just projects and tasks.
+
+---
+
+## Quick Start
+
+```bash
+# Install
+npm install && npm run build
+
+# Create a project
+tayto project create -n "my-app" --default
+
+# Create tasks
+tayto task create -n "Fix auth bug" -t bug --priority 1
+tayto task create -n "Add dashboard" -t story --priority 2
+
+# Launch the terminal UI
+tayto
+```
+
+## Installation
+
+**Requirements:** Node.js >= 18
+
+```bash
+git clone <repo-url> && cd tayto
+npm install
+npm run build
+npm link        # makes `tayto` available globally
+```
+
+## Usage
+
+### Terminal UI
+
+Run `tayto` with no arguments to launch the interactive TUI.
+
+```bash
+tayto                          # launch TUI (default)
+tayto tui                      # explicit launch
+tayto tui -p "my-app"          # start with a specific project
+```
+
+#### Keyboard Shortcuts
+
+| Key | Action |
+|---|---|
+| `j` / `k` / `arrows` | Navigate up/down |
+| `Enter` | Open task detail |
+| `c` | Create task |
+| `e` | Edit task |
+| `d` | Delete task (with confirmation) |
+| `s` | Cycle status forward |
+| `/` | Search tasks |
+| `f` | Cycle status filter |
+| `t` | Cycle type filter |
+| `1`-`5` | Toggle priority filter |
+| `0` | Clear all filters |
+| `p` | Switch project |
+| `Esc` / `b` | Go back |
+| `?` | Show help |
+| `q` | Quit |
+
+The task detail view renders **markdown**, **code blocks**, and **technical notes** directly in the terminal.
+
+### CLI Commands
+
+All commands output JSON to stdout. Errors go to stderr with exit code 1.
+
+```jsonc
+// success
+{ "ok": true, "data": { ... } }
+
+// error
+{ "ok": false, "error": { "code": "NOT_FOUND", "message": "..." } }
+```
+
+#### Project
+
+```bash
+tayto project create -n "my-app" -d "Description" --default
+tayto project list
+tayto project update <id> -n "new-name" --default
+tayto project delete <id>
+```
+
+#### Task
+
+```bash
+# Create
+tayto task create \
+  -n "Fix login bug" \
+  -t bug \
+  -s todo \
+  --priority 1 \
+  -p "my-app" \
+  -d "Login fails on mobile" \
+  --technical-notes "Check JWT expiry" \
+  --additional-requirements "Must work on iOS Safari"
+
+# Read
+tayto task list
+tayto task list --status in-progress --type bug --search "login"
+tayto task list --priority 1 --parent <parent-id>
+tayto task show <id>
+
+# Update
+tayto task update <id> -s in-progress
+tayto task update <id> --append-notes "Root cause: token not refreshed"
+tayto task update <id> --append-requirements "Also fix on Android"
+
+# Delete
+tayto task delete <id>
+
+# Breakdown (create subtasks from JSON)
+tayto task breakdown <parent-id> -f subtasks.json
+```
+
+**subtasks.json** example:
+
+```json
+[
+  { "name": "Implement API endpoint", "type": "story", "priority": 2 },
+  { "name": "Write integration tests", "type": "story", "priority": 3 }
+]
+```
+
+## Data Model
+
+### Task Types
+
+| Type | Description |
+|---|---|
+| `story` | Feature or user story |
+| `tech-debt` | Refactoring or cleanup |
+| `bug` | Defect or issue |
+
+### Task Statuses
+
+`backlog` &rarr; `todo` &rarr; `in-progress` &rarr; `review` &rarr; `done`
+
+`cancelled` is also available for abandoned tasks.
+
+### Priority
+
+| Level | Label |
+|---|---|
+| 1 | Critical |
+| 2 | High |
+| 3 | Medium (default) |
+| 4 | Low |
+| 5 | Lowest |
+
+### Task Breakdown
+
+Tasks support a `parent_id` field for hierarchical decomposition. Use `task breakdown` to batch-create subtasks under a parent, or pass `--parent <id>` on `task create`.
+
+## Configuration
+
+Configure via environment variables.
+
+| Variable | Default | Description |
+|---|---|---|
+| `TASK_DB_PATH` | `~/.task/data.db` | Path to SQLite database |
+| `TASK_DATA_DIR` | `~/.task` | Data directory |
+| `TASK_LOG_LEVEL` | `info` | Log level (`debug`, `info`, `warn`, `error`) |
+| `OTEL_EXPORTER_OTLP_ENDPOINT` | &mdash; | OpenTelemetry collector endpoint |
+
+The database and data directory are created automatically on first run.
+
+## Architecture
+
+```
+CLI Commands ──┐
+               ├──> Service Layer ──> Repository Layer ──> SQLite
+Terminal UI ───┘
+```
+
+- **Service layer** handles validation (Zod), business logic, and project resolution
+- **Repository layer** handles SQL queries with parameterized statements
+- **Result\<T\>** return type across all layers &mdash; no thrown exceptions for business logic
+- **OpenTelemetry** spans on every service and repository operation
+- **ULID** identifiers &mdash; sortable, no database round-trip
+
+```
+src/
+  cli/              # Commander.js commands, JSON output
+  tui/              # Ink (React) terminal UI components
+  service/          # Business logic
+  repository/       # Data access
+  db/               # SQLite connection, migrations
+  types/            # Zod schemas, enums, Result type
+  errors/           # Typed error hierarchy
+  logging/          # OpenTelemetry tracer
+  config/           # Environment-based configuration
+```
+
+## Development
+
+```bash
+npm run dev          # build in watch mode
+npm run check        # prettier + eslint
+npm run test         # run tests
+npm run build        # production build
+```
+
+## License
+
+MIT

package/dist/chunk-6NQOFUIQ.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+
+// src/logging/logger.ts
+import { appendFileSync, readdirSync, unlinkSync } from "fs";
+import { join } from "path";
+import { trace, SpanStatusCode } from "@opentelemetry/api";
+var tracer = trace.getTracer("task");
+var LOG_RETENTION_DAYS = 7;
+function formatTimestamp() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function formatAttrs(attrs) {
+  if (!attrs || Object.keys(attrs).length === 0) return "";
+  return " " + JSON.stringify(attrs);
+}
+var Logger = class {
+  logFilePath = null;
+  init(logDir) {
+    const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    this.logFilePath = join(logDir, `task-${date}.log`);
+    this.pruneOldLogs(logDir);
+  }
+  info(message, attrs) {
+    this.write("INFO", message, attrs);
+    const span = trace.getActiveSpan();
+    if (span) {
+      span.addEvent(message, attrs);
+    }
+  }
+  warn(message, attrs) {
+    this.write("WARN", message, attrs);
+    const span = trace.getActiveSpan();
+    if (span) {
+      span.addEvent(`WARN: ${message}`, attrs);
+    }
+  }
+  error(message, error, attrs) {
+    const errorDetail = error instanceof Error ? ` | ${error.stack ?? error.message}` : "";
+    this.write("ERROR", `${message}${errorDetail}`, attrs);
+    const span = trace.getActiveSpan();
+    if (span) {
+      span.addEvent(`ERROR: ${message}`, attrs);
+      if (error instanceof Error) {
+        span.recordException(error);
+      }
+      span.setStatus({ code: SpanStatusCode.ERROR, message });
+    }
+  }
+  startSpan(name, fn) {
+    return tracer.startActiveSpan(name, (span) => {
+      try {
+        const result = fn(span);
+        span.end();
+        return result;
+      } catch (e) {
+        if (e instanceof Error) {
+          span.recordException(e);
+        }
+        span.setStatus({ code: SpanStatusCode.ERROR });
+        span.end();
+        throw e;
+      }
+    });
+  }
+  write(level, message, attrs) {
+    if (!this.logFilePath) return;
+    const line = `${formatTimestamp()} [${level}] ${message}${formatAttrs(attrs)}
+`;
+    try {
+      appendFileSync(this.logFilePath, line);
+    } catch {
+    }
+  }
+  pruneOldLogs(logDir) {
+    try {
+      const cutoff = Date.now() - LOG_RETENTION_DAYS * 24 * 60 * 60 * 1e3;
+      const files = readdirSync(logDir).filter((f) => f.startsWith("task-") && f.endsWith(".log"));
+      for (const file of files) {
+        const dateStr = file.slice("task-".length, -".log".length);
+        const fileDate = new Date(dateStr).getTime();
+        if (!isNaN(fileDate) && fileDate < cutoff) {
+          unlinkSync(join(logDir, file));
+        }
+      }
+    } catch {
+    }
+  }
+};
+var logger = new Logger();
+
+// src/types/enums.ts
+var TaskStatus = {
+  Backlog: "backlog",
+  Todo: "todo",
+  InProgress: "in-progress",
+  Review: "review",
+  Done: "done",
+  Cancelled: "cancelled"
+};
+var TaskType = {
+  Story: "story",
+  TechDebt: "tech-debt",
+  Bug: "bug"
+};
+var DependencyType = {
+  Blocks: "blocks",
+  RelatesTo: "relates-to",
+  Duplicates: "duplicates"
+};
+var UIDependencyType = {
+  ...DependencyType,
+  BlockedBy: "blocked-by"
+};
+var RANK_GAP = 1e3;
+var TERMINAL_STATUSES = /* @__PURE__ */ new Set([
+  TaskStatus.Done,
+  TaskStatus.Cancelled
+]);
+function isTerminalStatus(status) {
+  return TERMINAL_STATUSES.has(status);
+}
+
+export {
+  logger,
+  TaskStatus,
+  TaskType,
+  DependencyType,
+  UIDependencyType,
+  RANK_GAP,
+  TERMINAL_STATUSES,
+  isTerminalStatus
+};
+//# sourceMappingURL=chunk-6NQOFUIQ.js.map

package/dist/chunk-6NQOFUIQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logging/logger.ts","../src/types/enums.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  Story: 'story',\n  TechDebt: 'tech-debt',\n  Bug: 'bug',\n} as const;\nexport type TaskType = (typeof TaskType)[keyof typeof TaskType];\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/** 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"],"mappings":"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","names":[]}