@tomkapa/tayto 0.3.2 → 0.4.0

package/dist/{chunk-STYT4TGJ.js → chunk-74Q55TOV.js}

@@ -143,8 +143,46 @@ function isTerminalStatus(status) {
   return TERMINAL_STATUSES.has(status);
 }
 
+// src/utils/git.ts
+import { spawnSync } from "child_process";
+
+// src/types/common.ts
+function ok(value) {
+  return { ok: true, value };
+}
+function err(error) {
+  return { ok: false, error };
+}
+
+// src/utils/git.ts
+function detectGitRemote(cwd) {
+  try {
+    const result = spawnSync("git", ["remote", "get-url", "origin"], {
+      cwd: cwd ?? process.cwd(),
+      encoding: "utf-8",
+      timeout: 5e3
+    });
+    if (result.status !== 0 || result.error) {
+      logger.info("detectGitRemote: no git remote found (non-zero exit or error)");
+      return ok(null);
+    }
+    const remote = result.stdout.trim();
+    if (!remote) {
+      logger.info("detectGitRemote: empty stdout from git remote get-url");
+      return ok(null);
+    }
+    logger.info(`detectGitRemote: found remote=${remote}`);
+    return ok(remote);
+  } catch (e) {
+    logger.info(`detectGitRemote: exception during git detection: ${String(e)}`);
+    return ok(null);
+  }
+}
+
 export {
   logger,
+  ok,
+  err,
   TaskStatus,
   TaskType,
   TaskLevel,
@@ -155,6 +193,7 @@ export {
   RANK_GAP,
   midpoint,
   TERMINAL_STATUSES,
-  isTerminalStatus
+  isTerminalStatus,
+  detectGitRemote
 };
-//# sourceMappingURL=chunk-STYT4TGJ.js.map
+//# sourceMappingURL=chunk-74Q55TOV.js.map

package/dist/chunk-74Q55TOV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/logging/logger.ts","../src/types/enums.ts","../src/utils/git.ts","../src/types/common.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 { logger } from '../logging/logger.js';\n\n/**\n * Detect the git origin remote URL from the given directory.\n * Returns ok(url) 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<string | 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 remote = result.stdout.trim();\n    if (!remote) {\n      logger.info('detectGitRemote: empty stdout from git remote get-url');\n      return ok(null);\n    }\n\n    logger.info(`detectGitRemote: found remote=${remote}`);\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"],"mappings":"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","names":[]}

package/dist/index.js

@@ -8,11 +8,14 @@ import {
   TaskType,
   UIDependencyType,
   WORK_TYPES,
+  detectGitRemote,
+  err,
   getTaskLevel,
   isTerminalStatus,
   logger,
-  midpoint
-} from "./chunk-STYT4TGJ.js";
+  midpoint,
+  ok
+} from "./chunk-74Q55TOV.js";
 
 // src/config/index.ts
 import { mkdirSync } from "fs";
@@ -106,14 +109,6 @@ async function shutdownTelemetry() {
   }
 }
 
-// src/types/common.ts
-function ok(value) {
-  return { ok: true, value };
-}
-function err(error) {
-  return { ok: false, error };
-}
-
 // src/errors/app-error.ts
 var AppError = class extends Error {
   constructor(code, message, cause) {
@@ -156,6 +151,7 @@ function rowToProject(row) {
     name: row.name,
     description: row.description,
     isDefault: row.is_default === 1,
+    gitRemote: row.git_remote,
     createdAt: row.created_at,
     updatedAt: row.updated_at
   };
@@ -174,14 +170,15 @@ var SqliteProjectRepository = class {
           this.db.prepare("UPDATE projects SET is_default = 0 WHERE is_default = 1").run();
         }
         this.db.prepare(
-          `INSERT INTO projects (id, key, name, description, is_default, created_at, updated_at)
-             VALUES (?, ?, ?, ?, ?, ?, ?)`
+          `INSERT INTO projects (id, key, name, description, is_default, git_remote, created_at, updated_at)
+             VALUES (?, ?, ?, ?, ?, ?, ?, ?)`
         ).run(
           id,
           input.key,
           input.name,
           input.description ?? "",
           input.isDefault ? 1 : 0,
+          input.gitRemote ?? null,
           now,
           now
         );
@@ -192,6 +189,15 @@ var SqliteProjectRepository = class {
         return ok(rowToProject(row));
       } catch (e) {
         if (e instanceof Error && e.message.includes("UNIQUE constraint")) {
+          if (e.message.includes("git_remote")) {
+            return err(
+              new AppError(
+                "DUPLICATE",
+                `Git remote already linked to another project: ${input.gitRemote}`,
+                e
+              )
+            );
+          }
           return err(new AppError("DUPLICATE", `Project name already exists: ${input.name}`, e));
         }
         return err(new AppError("DB_ERROR", "Failed to insert project", e));
@@ -222,6 +228,14 @@ var SqliteProjectRepository = class {
       return err(new AppError("DB_ERROR", "Failed to find project by name", e));
     }
   }
+  findByGitRemote(remote) {
+    try {
+      const row = this.db.prepare(`SELECT * FROM projects WHERE git_remote = ? AND ${NOT_DELETED}`).get(remote);
+      return ok(row ? rowToProject(row) : null);
+    } catch (e) {
+      return err(new AppError("DB_ERROR", "Failed to find project by git remote", e));
+    }
+  }
   findDefault() {
     try {
       const row = this.db.prepare(`SELECT * FROM projects WHERE is_default = 1 AND ${NOT_DELETED}`).get();
@@ -251,12 +265,13 @@ var SqliteProjectRepository = class {
         }
         this.db.prepare(
           `UPDATE projects SET
-               name = ?, description = ?, is_default = ?, updated_at = ?
+               name = ?, description = ?, is_default = ?, git_remote = ?, updated_at = ?
              WHERE id = ?`
         ).run(
           input.name ?? existing.name,
           input.description ?? existing.description,
           input.isDefault !== void 0 ? input.isDefault ? 1 : 0 : existing.is_default,
+          input.gitRemote !== void 0 ? input.gitRemote : existing.git_remote,
           now,
           id
         );
@@ -267,6 +282,11 @@ var SqliteProjectRepository = class {
         return ok(rowToProject(row));
       } catch (e) {
         if (e instanceof Error && e.message.includes("UNIQUE constraint")) {
+          if (e.message.includes("git_remote")) {
+            return err(
+              new AppError("DUPLICATE", `Git remote already linked to another project`, e)
+            );
+          }
           return err(new AppError("DUPLICATE", `Project name already exists`, e));
         }
         return err(new AppError("DB_ERROR", "Failed to update project", e));
@@ -942,20 +962,24 @@ var CreateProjectSchema = z.object({
   name: z.string().min(1, "Project name is required").max(255),
   key: z.string().min(2, "Project key must be at least 2 characters").max(7, "Project key must be at most 7 characters").regex(/^[A-Za-z0-9]+$/, "Project key must contain only letters and digits").transform((v) => v.toUpperCase()).optional(),
   description: z.string().max(5e3).optional(),
-  isDefault: z.boolean().optional()
+  isDefault: z.boolean().optional(),
+  gitRemote: z.string().min(1, "Git remote URL must not be empty").nullable().optional()
 });
 var UpdateProjectSchema = z.object({
   name: z.string().min(1).max(255).optional(),
   description: z.string().max(5e3).optional(),
-  isDefault: z.boolean().optional()
+  isDefault: z.boolean().optional(),
+  gitRemote: z.string().min(1, "Git remote URL must not be empty").nullable().optional()
 });
 
 // src/service/project.service.ts
 var ProjectServiceImpl = class {
-  constructor(repo) {
+  constructor(repo, detectRemote = detectGitRemote) {
     this.repo = repo;
+    this.detectRemote = detectRemote;
   }
   repo;
+  detectRemote;
   createProject(input) {
     return logger.startSpan("ProjectService.createProject", () => {
       const parsed = CreateProjectSchema.safeParse(input);
@@ -1037,6 +1061,58 @@ var ProjectServiceImpl = class {
       );
     });
   }
+  resolveProjectWithGit(idOrName, cwd) {
+    return logger.startSpan("ProjectService.resolveProjectWithGit", () => {
+      if (idOrName) {
+        return this.resolveProject(idOrName);
+      }
+      const remoteResult = this.detectRemote(cwd);
+      if (remoteResult.ok && remoteResult.value) {
+        const byRemote = this.repo.findByGitRemote(remoteResult.value);
+        if (!byRemote.ok) return byRemote;
+        if (byRemote.value) {
+          logger.info(
+            `resolveProjectWithGit: matched git remote to project key=${byRemote.value.key}`
+          );
+          return ok(byRemote.value);
+        }
+      }
+      return this.resolveProject();
+    });
+  }
+  linkGitRemote(idOrName, remote) {
+    return logger.startSpan("ProjectService.linkGitRemote", () => {
+      const resolved = this.resolveProject(idOrName);
+      if (!resolved.ok) return resolved;
+      let url = remote;
+      if (!url) {
+        const detected = this.detectRemote();
+        if (!detected.ok) return detected;
+        if (!detected.value) {
+          return err(
+            new AppError(
+              "NOT_FOUND",
+              "No git remote detected in current directory. Use --remote <url> to specify one explicitly."
+            )
+          );
+        }
+        url = detected.value;
+      }
+      return this.repo.update(resolved.value.id, { gitRemote: url });
+    });
+  }
+  unlinkGitRemote(idOrName) {
+    return logger.startSpan("ProjectService.unlinkGitRemote", () => {
+      const resolved = this.resolveProject(idOrName);
+      if (!resolved.ok) return resolved;
+      if (!resolved.value.gitRemote) {
+        return err(
+          new AppError("NOT_FOUND", `Project "${resolved.value.name}" has no linked git remote.`)
+        );
+      }
+      return this.repo.update(resolved.value.id, { gitRemote: null });
+    });
+  }
   nextTaskId(project) {
     return logger.startSpan("ProjectService.nextTaskId", () => {
       const counterResult = this.repo.incrementTaskCounter(project.id);
@@ -1168,12 +1244,12 @@ var TaskServiceImpl = class {
       if (!parsed.success) {
         return err(new AppError("VALIDATION", parsed.error.message));
       }
-      let resolvedFilter = parsed.data;
-      if (parsed.data.projectId) {
-        const projectResult = this.projectService.resolveProject(parsed.data.projectId);
-        if (!projectResult.ok) return projectResult;
-        resolvedFilter = { ...resolvedFilter, projectId: projectResult.value.id };
-      }
+      const projectResult = this.projectService.resolveProject(parsed.data.projectId);
+      if (!projectResult.ok) return projectResult;
+      const resolvedFilter = {
+        ...parsed.data,
+        projectId: projectResult.value.id
+      };
       return this.repo.findMany(resolvedFilter);
     });
   }
@@ -1453,13 +1529,9 @@ var TaskServiceImpl = class {
       if (!query.trim()) {
         return err(new AppError("VALIDATION", "Search query cannot be empty"));
       }
-      let projectId;
-      if (projectIdOrName) {
-        const projectResult = this.projectService.resolveProject(projectIdOrName);
-        if (!projectResult.ok) return projectResult;
-        projectId = projectResult.value.id;
-      }
-      return this.repo.search(query, projectId);
+      const projectResult = this.projectService.resolveProject(projectIdOrName);
+      if (!projectResult.ok) return projectResult;
+      return this.repo.search(query, projectResult.value.id);
     });
   }
   /**
@@ -1953,11 +2025,11 @@ var PortabilityServiceImpl = class {
 };
 
 // src/cli/container.ts
-function createContainer(db, dbPath) {
+function createContainer(db, dbPath, detectGitRemote2) {
   const projectRepo = new SqliteProjectRepository(db);
   const taskRepo = new SqliteTaskRepository(db);
   const depRepo = new SqliteDependencyRepository(db);
-  const projectService = new ProjectServiceImpl(projectRepo);
+  const projectService = new ProjectServiceImpl(projectRepo, detectGitRemote2);
   const dependencyService = new DependencyServiceImpl(depRepo, taskRepo);
   const taskService = new TaskServiceImpl(taskRepo, projectService, () => dependencyService);
   const portabilityService = new PortabilityServiceImpl(
@@ -1993,16 +2065,19 @@ function handleResult(result) {
 function registerProjectCreate(parent, container) {
   parent.command("create").description("Create a new project").requiredOption("-n, --name <name>", "Project name").option(
     "-k, --key <key>",
-    "Project key (2-10 alphanumeric chars, defaults to first 3 chars of name)"
-  ).option("-d, --description <description>", "Project description").option("--default", "Set as default project").action((opts) => {
-    const result = container.projectService.createProject({
-      name: opts.name,
-      key: opts.key,
-      description: opts.description,
-      isDefault: opts.default
-    });
-    handleResult(result);
-  });
+    "Project key (2-7 uppercase alphanumeric chars, defaults to first 3 chars of name)"
+  ).option("-d, --description <description>", "Project description").option("--default", "Set as default project").option("--git-remote <url>", "Git remote URL to associate with the project").action(
+    (opts) => {
+      const result = container.projectService.createProject({
+        name: opts.name,
+        key: opts.key,
+        description: opts.description,
+        isDefault: opts.default,
+        gitRemote: opts.gitRemote
+      });
+      handleResult(result);
+    }
+  );
 }
 
 // src/cli/commands/project/list.ts
@@ -2060,6 +2135,22 @@ function registerProjectSetDefault(parent, container) {
   });
 }
 
+// src/cli/commands/project/link.ts
+function registerProjectLink(parent, container) {
+  parent.command("link <idOrKeyOrName>").description("Link a project to a git remote (auto-detects from cwd if --remote omitted)").option("-r, --remote <url>", "Git remote URL").action((idOrKeyOrName, opts) => {
+    const result = container.projectService.linkGitRemote(idOrKeyOrName, opts.remote);
+    handleResult(result);
+  });
+}
+
+// src/cli/commands/project/unlink.ts
+function registerProjectUnlink(parent, container) {
+  parent.command("unlink <idOrKeyOrName>").description("Remove git remote link from a project").action((idOrKeyOrName) => {
+    const result = container.projectService.unlinkGitRemote(idOrKeyOrName);
+    handleResult(result);
+  });
+}
+
 // src/cli/commands/task/create.ts
 function registerTaskCreate(parent, container) {
   parent.command("create").description("Create a new task (appended to bottom of backlog)").requiredOption("-n, --name <name>", "Task name").option("-p, --project <project>", "Project id or name").option("-d, --description <description>", "Task description").option("-t, --type <type>", "Task type: epic, story, tech-debt, bug", "story").option("-s, --status <status>", "Task status", "backlog").option("--parent <parentId>", "Parent task id for subtask").option("--technical-notes <notes>", "Technical notes (markdown)").option("--additional-requirements <requirements>", "Additional requirements (markdown)").option("--depends-on <ids...>", "Task ids this task depends on (blocks relationship)").action(
@@ -2302,6 +2393,8 @@ function buildCLI(container) {
   registerProjectUpdate(project, container);
   registerProjectDelete(project, container);
   registerProjectSetDefault(project, container);
+  registerProjectLink(project, container);
+  registerProjectUnlink(project, container);
   const task = program.command("task").description("Manage tasks");
   registerTaskCreate(task, container);
   registerTaskList(task, container);
@@ -2319,7 +2412,7 @@ function buildCLI(container) {
   registerDepList(dep, container);
   registerDepGraph(dep, container);
   program.command("tui").description("Launch interactive terminal UI").option("-p, --project <project>", "Start with specific project").action(async (opts) => {
-    const { launchTUI } = await import("./tui-JEP3F4JS.js");
+    const { launchTUI } = await import("./tui-4GNIGMCK.js");
     await launchTUI(container, opts.project);
   });
   return program;
@@ -2335,7 +2428,7 @@ async function main() {
   const container = createContainer(db, config.dbPath);
   const args = process.argv.slice(2);
   if (args.length === 0) {
-    const { launchTUI } = await import("./tui-JEP3F4JS.js");
+    const { launchTUI } = await import("./tui-4GNIGMCK.js");
     await launchTUI(container);
   } else {
     const program = buildCLI(container);