kandev/apps/cli/src/constants.ts

import os from "node:os";
import path from "node:path";

// Default service ports (will auto-fallback if busy).
// Clustered near the web port (37429) to avoid collisions with commonly used
// ports (8080, 9090, 9999, etc.) while keeping the numbers memorable.
export const DEFAULT_BACKEND_PORT = 38429;
export const DEFAULT_WEB_PORT = 37429;
export const DEFAULT_AGENTCTL_PORT = 39429;

// Random fallback range for port selection.
export const RANDOM_PORT_MIN = 10000;
export const RANDOM_PORT_MAX = 60000;
export const RANDOM_PORT_RETRIES = 10;

// Backend healthcheck timeout during startup.
export const HEALTH_TIMEOUT_MS_RELEASE = 45000;
export const HEALTH_TIMEOUT_MS_DEV = 600000;

// Kandev root directory. Single source of truth for the dotdir name and
// everything derived from it (data, tasks, bin). Dev mode uses a separate
// root under the repo (see DEV_KANDEV_DOTDIR).
export const KANDEV_DOTDIR = ".kandev";
export const KANDEV_HOME_DIR = path.join(os.homedir(), KANDEV_DOTDIR);
export const KANDEV_TASKS_DIR = path.join(KANDEV_HOME_DIR, "tasks");

// Local user cache/data directories for release bundles and DB.
export const CACHE_DIR = path.join(KANDEV_HOME_DIR, "bin");
export const DATA_DIR = path.join(KANDEV_HOME_DIR, "data");

export function resolveKandevHomeDir(env: NodeJS.ProcessEnv = process.env): string {
  return env.KANDEV_HOME_DIR?.trim() || KANDEV_HOME_DIR;
}

export function resolveDataDir(env: NodeJS.ProcessEnv = process.env): string {
  return path.join(resolveKandevHomeDir(env), "data");
}

export function resolveCacheDir(env: NodeJS.ProcessEnv = process.env): string {
  return path.join(resolveKandevHomeDir(env), "bin");
}

export function resolveDatabasePath(env: NodeJS.ProcessEnv = process.env): string {
  return env.KANDEV_DATABASE_PATH?.trim() || path.join(resolveDataDir(env), "kandev.db");
}

// Dev-mode root: an isolated kandev home inside the repo so that running
// `make dev` from inside a kandev-spawned task workspace does not touch the
// user's production state.
export const DEV_KANDEV_DOTDIR = ".kandev-dev";
export function devKandevHome(repoRoot: string): string {
  return path.join(repoRoot, DEV_KANDEV_DOTDIR);
}