@hiroleague/taskmanager 0.0.1 → 0.0.2

package/src/shared/runtimeConfig.ts

@@ -1,237 +1,256 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import path from "node:path";
-
-export type RuntimeKind = "installed" | "dev";
-
-export interface RuntimeConfigFile {
-  api_key?: string;
-  port?: number;
-  data_dir?: string;
-  auth_dir?: string;
-  open_browser?: boolean;
-}
-
-export interface RuntimeConfigOverrides {
-  kind?: RuntimeKind;
-  profile?: string;
-  port?: number;
-  dataDir?: string;
-  authDir?: string;
-  openBrowser?: boolean;
-}
-
-let selectedRuntimeKind: RuntimeKind | undefined;
-let selectedProfileName: string | undefined;
-
-function normalizeProfileName(profile: string | undefined): string | undefined {
-  const trimmed = profile?.trim();
-  return trimmed ? trimmed : undefined;
-}
-
-function inferRuntimeKindFromProfile(profile: string | undefined): RuntimeKind | undefined {
-  return profile === "dev" ? "dev" : undefined;
-}
-
-function readRuntimeKindFromEnv(): RuntimeKind | undefined {
-  const value = process.env.TASKMANAGER_RUNTIME?.trim().toLowerCase();
-  if (value === "installed" || value === "dev") return value;
-  return undefined;
-}
-
-function resolveHomeDir(): string {
-  return process.env.HOME ?? process.env.USERPROFILE ?? process.cwd();
-}
-
-function normalizePort(value: unknown): number | undefined {
-  if (typeof value === "number" && Number.isInteger(value) && value > 0) {
-    return value;
-  }
-
-  if (typeof value === "string" && value.trim()) {
-    const parsed = Number(value);
-    if (Number.isInteger(parsed) && parsed > 0) return parsed;
-  }
-
-  return undefined;
-}
-
-function normalizeBoolean(value: unknown): boolean | undefined {
-  if (typeof value === "boolean") return value;
-  if (typeof value === "string") {
-    const normalized = value.trim().toLowerCase();
-    if (normalized === "true" || normalized === "1") return true;
-    if (normalized === "false" || normalized === "0") return false;
-  }
-  return undefined;
-}
-
-export function setRuntimeConfigSelection(selection: {
-  kind?: RuntimeKind;
-  profile?: string;
-}): void {
-  if (selection.kind) selectedRuntimeKind = selection.kind;
-  if (selection.profile !== undefined) {
-    selectedProfileName = normalizeProfileName(selection.profile);
-  }
-}
-
-export function resolveRuntimeKind(overrides: RuntimeConfigOverrides = {}): RuntimeKind {
-  const inferredFromProfile =
-    inferRuntimeKindFromProfile(normalizeProfileName(overrides.profile)) ??
-    inferRuntimeKindFromProfile(selectedProfileName) ??
-    inferRuntimeKindFromProfile(normalizeProfileName(process.env.TASKMANAGER_PROFILE));
-
-  return (
-    overrides.kind ??
-    selectedRuntimeKind ??
-    readRuntimeKindFromEnv() ??
-    inferredFromProfile ??
-    "installed"
-  );
-}
-
-export function resolveProfileName(overrides: RuntimeConfigOverrides = {}): string {
-  return (
-    normalizeProfileName(overrides.profile) ??
-    selectedProfileName ??
-    normalizeProfileName(process.env.TASKMANAGER_PROFILE) ??
-    (resolveRuntimeKind(overrides) === "dev" ? "dev" : "default")
-  );
-}
-
-export function getTaskManagerHomeDir(): string {
-  return path.join(resolveHomeDir(), ".taskmanager");
-}
-
-export function getProfileRootDir(overrides: RuntimeConfigOverrides = {}): string {
-  return path.join(getTaskManagerHomeDir(), "profiles", resolveProfileName(overrides));
-}
-
-export function ensureProfileRootDir(overrides: RuntimeConfigOverrides = {}): string {
-  const profileRootDir = getProfileRootDir(overrides);
-  mkdirSync(profileRootDir, { recursive: true });
-  return profileRootDir;
-}
-
-export function ensureRuntimeDirectories(
-  overrides: RuntimeConfigOverrides = {},
-): {
-  profileRootDir: string;
-  dataDir: string;
-  authDir: string;
-} {
-  const profileRootDir = ensureProfileRootDir(overrides);
-  const dataDir = resolveDataDir(overrides);
-  const authDir = resolveAuthDir(overrides);
-
-  mkdirSync(dataDir, { recursive: true });
-  mkdirSync(authDir, { recursive: true });
-
-  return {
-    profileRootDir,
-    dataDir,
-    authDir,
-  };
-}
-
-export function getProfileConfigFilePath(overrides: RuntimeConfigOverrides = {}): string {
-  return path.join(getProfileRootDir(overrides), "config.json");
-}
-
-export function hasProfileConfigFile(overrides: RuntimeConfigOverrides = {}): boolean {
-  return existsSync(getProfileConfigFilePath(overrides));
-}
-
-export function readProfileConfig(
-  overrides: RuntimeConfigOverrides = {},
-): RuntimeConfigFile {
-  const configFilePath = getProfileConfigFilePath(overrides);
-  if (!existsSync(configFilePath)) return {};
-
-  try {
-    const raw = readFileSync(configFilePath, "utf8").trim();
-    if (!raw) return {};
-    return JSON.parse(raw) as RuntimeConfigFile;
-  } catch {
-    return {};
-  }
-}
-
-export function writeProfileConfig(
-  config: RuntimeConfigFile,
-  overrides: RuntimeConfigOverrides = {},
-): string {
-  const configFilePath = path.join(ensureProfileRootDir(overrides), "config.json");
-  writeFileSync(configFilePath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
-  return configFilePath;
-}
-
-export function getDefaultPort(overrides: RuntimeConfigOverrides = {}): number {
-  return resolveRuntimeKind(overrides) === "dev" ? 3002 : 3001;
-}
-
-export function getDefaultDataDir(overrides: RuntimeConfigOverrides = {}): string {
-  if (resolveRuntimeKind(overrides) === "dev") {
-    // Keep repository development pointed at the tracked local SQLite file
-    // without relying on env vars in the normal dev workflow.
-    return path.resolve(import.meta.dir, "../..", "data");
-  }
-  return path.join(getProfileRootDir(overrides), "data");
-}
-
-export function getDefaultAuthDir(overrides: RuntimeConfigOverrides = {}): string {
-  return path.join(getProfileRootDir(overrides), "auth");
-}
-
-export function getServerPidFilePath(overrides: RuntimeConfigOverrides = {}): string {
-  return path.join(getProfileRootDir(overrides), "server.pid.json");
-}
-
-export function resolvePort(overrides: RuntimeConfigOverrides = {}): number {
-  const config = readProfileConfig(overrides);
-  return (
-    normalizePort(overrides.port) ??
-    normalizePort(process.env.TASKMANAGER_PORT) ??
-    normalizePort(config.port) ??
-    getDefaultPort(overrides)
-  );
-}
-
-export function resolveDataDir(overrides: RuntimeConfigOverrides = {}): string {
-  const config = readProfileConfig(overrides);
-  return path.resolve(
-    overrides.dataDir ??
-      process.env.TASKMANAGER_DATA_DIR ??
-      config.data_dir ??
-      getDefaultDataDir(overrides),
-  );
-}
-
-export function resolveAuthDir(overrides: RuntimeConfigOverrides = {}): string {
-  const config = readProfileConfig(overrides);
-  return path.resolve(
-    overrides.authDir ??
-      process.env.TASKMANAGER_AUTH_DIR ??
-      config.auth_dir ??
-      getDefaultAuthDir(overrides),
-  );
-}
-
-export function resolveOpenBrowser(overrides: RuntimeConfigOverrides = {}): boolean {
-  const config = readProfileConfig(overrides);
-  return (
-    normalizeBoolean(overrides.openBrowser) ??
-    normalizeBoolean(process.env.TASKMANAGER_OPEN_BROWSER) ??
-    normalizeBoolean(config.open_browser) ??
-    true
-  );
-}
-
-export function resolveApiKey(overrides: RuntimeConfigOverrides = {}): string | undefined {
-  const config = readProfileConfig(overrides);
-
-  if (process.env.API_KEY?.trim()) return process.env.API_KEY;
-  if (config.api_key?.trim()) return config.api_key;
-
-  return undefined;
-}
+import {
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  writeFileSync,
+} from "node:fs";
+import path from "node:path";
+
+export type RuntimeKind = "installed" | "dev";
+
+export interface RuntimeConfigFile {
+  api_key?: string;
+  port?: number;
+  data_dir?: string;
+  auth_dir?: string;
+  open_browser?: boolean;
+}
+
+export interface RuntimeConfigOverrides {
+  kind?: RuntimeKind;
+  profile?: string;
+  port?: number;
+  dataDir?: string;
+  authDir?: string;
+  openBrowser?: boolean;
+}
+
+let selectedRuntimeKind: RuntimeKind | undefined;
+let selectedProfileName: string | undefined;
+/** Set from global `hirotm --port` (parsed before Commander); not read from any env var. */
+let selectedCliPort: number | undefined;
+
+function normalizeProfileName(profile: string | undefined): string | undefined {
+  const trimmed = profile?.trim();
+  return trimmed ? trimmed : undefined;
+}
+
+function readRuntimeKindFromEnv(): RuntimeKind | undefined {
+  const value = process.env.TASKMANAGER_RUNTIME?.trim().toLowerCase();
+  if (value === "installed" || value === "dev") return value;
+  return undefined;
+}
+
+function resolveHomeDir(): string {
+  return process.env.HOME ?? process.env.USERPROFILE ?? process.cwd();
+}
+
+function normalizePort(value: unknown): number | undefined {
+  if (typeof value === "number" && Number.isInteger(value) && value > 0) {
+    return value;
+  }
+
+  if (typeof value === "string" && value.trim()) {
+    const parsed = Number(value);
+    if (Number.isInteger(parsed) && parsed > 0) return parsed;
+  }
+
+  return undefined;
+}
+
+function normalizeBoolean(value: unknown): boolean | undefined {
+  if (typeof value === "boolean") return value;
+  if (typeof value === "string") {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "true" || normalized === "1") return true;
+    if (normalized === "false" || normalized === "0") return false;
+  }
+  return undefined;
+}
+
+export function setRuntimeConfigSelection(selection: {
+  kind?: RuntimeKind;
+  profile?: string;
+  port?: number;
+}): void {
+  if (selection.kind) selectedRuntimeKind = selection.kind;
+  if (selection.profile !== undefined) {
+    selectedProfileName = normalizeProfileName(selection.profile);
+  }
+  if (selection.port !== undefined) {
+    const p = normalizePort(selection.port);
+    selectedCliPort = p;
+  }
+}
+
+// Runtime kind is set explicitly via --dev flag, setRuntimeConfigSelection, or
+// TASKMANAGER_RUNTIME env. Profile name no longer implies runtime kind.
+export function resolveRuntimeKind(overrides: RuntimeConfigOverrides = {}): RuntimeKind {
+  return (
+    overrides.kind ??
+    selectedRuntimeKind ??
+    readRuntimeKindFromEnv() ??
+    "installed"
+  );
+}
+
+export function resolveProfileName(overrides: RuntimeConfigOverrides = {}): string {
+  return (
+    normalizeProfileName(overrides.profile) ??
+    selectedProfileName ??
+    "default"
+  );
+}
+
+export function getTaskManagerHomeDir(): string {
+  return path.join(resolveHomeDir(), ".taskmanager");
+}
+
+/** True if any `~/.taskmanager/profiles/<name>/config.json` exists (any named profile). */
+export function hasAnyProfileConfigOnDisk(): boolean {
+  const profilesRoot = path.join(getTaskManagerHomeDir(), "profiles");
+  if (!existsSync(profilesRoot)) return false;
+  try {
+    for (const ent of readdirSync(profilesRoot, { withFileTypes: true })) {
+      if (!ent.isDirectory()) continue;
+      if (existsSync(path.join(profilesRoot, ent.name, "config.json"))) {
+        return true;
+      }
+    }
+  } catch {
+    return false;
+  }
+  return false;
+}
+
+export function getProfileRootDir(overrides: RuntimeConfigOverrides = {}): string {
+  return path.join(getTaskManagerHomeDir(), "profiles", resolveProfileName(overrides));
+}
+
+export function ensureProfileRootDir(overrides: RuntimeConfigOverrides = {}): string {
+  const profileRootDir = getProfileRootDir(overrides);
+  mkdirSync(profileRootDir, { recursive: true });
+  return profileRootDir;
+}
+
+export function ensureRuntimeDirectories(
+  overrides: RuntimeConfigOverrides = {},
+): {
+  profileRootDir: string;
+  dataDir: string;
+  authDir: string;
+} {
+  const profileRootDir = ensureProfileRootDir(overrides);
+  const dataDir = resolveDataDir(overrides);
+  const authDir = resolveAuthDir(overrides);
+
+  mkdirSync(dataDir, { recursive: true });
+  mkdirSync(authDir, { recursive: true });
+
+  return {
+    profileRootDir,
+    dataDir,
+    authDir,
+  };
+}
+
+export function getProfileConfigFilePath(overrides: RuntimeConfigOverrides = {}): string {
+  return path.join(getProfileRootDir(overrides), "config.json");
+}
+
+export function hasProfileConfigFile(overrides: RuntimeConfigOverrides = {}): boolean {
+  return existsSync(getProfileConfigFilePath(overrides));
+}
+
+export function readProfileConfig(
+  overrides: RuntimeConfigOverrides = {},
+): RuntimeConfigFile {
+  const configFilePath = getProfileConfigFilePath(overrides);
+  if (!existsSync(configFilePath)) return {};
+
+  try {
+    const raw = readFileSync(configFilePath, "utf8").trim();
+    if (!raw) return {};
+    return JSON.parse(raw) as RuntimeConfigFile;
+  } catch {
+    return {};
+  }
+}
+
+export function writeProfileConfig(
+  config: RuntimeConfigFile,
+  overrides: RuntimeConfigOverrides = {},
+): string {
+  const configFilePath = path.join(ensureProfileRootDir(overrides), "config.json");
+  writeFileSync(configFilePath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+  return configFilePath;
+}
+
+export function getDefaultPort(overrides: RuntimeConfigOverrides = {}): number {
+  return resolveRuntimeKind(overrides) === "dev" ? 3002 : 3001;
+}
+
+// All profiles (including dev) use the profile-based data dir under
+// ~/.taskmanager/profiles/<name>/data. Use --data-dir or config.json
+// data_dir to override.
+export function getDefaultDataDir(overrides: RuntimeConfigOverrides = {}): string {
+  return path.join(getProfileRootDir(overrides), "data");
+}
+
+export function getDefaultAuthDir(overrides: RuntimeConfigOverrides = {}): string {
+  return path.join(getProfileRootDir(overrides), "auth");
+}
+
+export function getServerPidFilePath(overrides: RuntimeConfigOverrides = {}): string {
+  return path.join(getProfileRootDir(overrides), "server.pid.json");
+}
+
+export function resolvePort(overrides: RuntimeConfigOverrides = {}): number {
+  const config = readProfileConfig(overrides);
+  return (
+    normalizePort(overrides.port) ??
+    normalizePort(selectedCliPort) ??
+    normalizePort(config.port) ??
+    getDefaultPort(overrides)
+  );
+}
+
+export function resolveDataDir(overrides: RuntimeConfigOverrides = {}): string {
+  const config = readProfileConfig(overrides);
+  return path.resolve(
+    overrides.dataDir ??
+      process.env.TASKMANAGER_DATA_DIR ??
+      config.data_dir ??
+      getDefaultDataDir(overrides),
+  );
+}
+
+export function resolveAuthDir(overrides: RuntimeConfigOverrides = {}): string {
+  const config = readProfileConfig(overrides);
+  return path.resolve(
+    overrides.authDir ??
+      process.env.TASKMANAGER_AUTH_DIR ??
+      config.auth_dir ??
+      getDefaultAuthDir(overrides),
+  );
+}
+
+export function resolveOpenBrowser(overrides: RuntimeConfigOverrides = {}): boolean {
+  const config = readProfileConfig(overrides);
+  return (
+    normalizeBoolean(overrides.openBrowser) ??
+    normalizeBoolean(process.env.TASKMANAGER_OPEN_BROWSER) ??
+    normalizeBoolean(config.open_browser) ??
+    true
+  );
+}
+
+export function resolveApiKey(overrides: RuntimeConfigOverrides = {}): string | undefined {
+  const config = readProfileConfig(overrides);
+
+  if (process.env.API_KEY?.trim()) return process.env.API_KEY;
+  if (config.api_key?.trim()) return config.api_key;
+
+  return undefined;
+}

package/src/shared/runtimeIdentity.test.ts

@@ -0,0 +1,47 @@
+import { afterEach, describe, expect, test } from "bun:test";
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { resolveRuntimeSource } from "./runtimeIdentity";
+
+describe("resolveRuntimeSource", () => {
+  const tempRoots: string[] = [];
+
+  afterEach(() => {
+    for (const tempRoot of tempRoots.splice(0)) {
+      try {
+        rmSync(tempRoot, { recursive: true, force: true });
+      } catch {
+        /* Windows may briefly keep temp files open */
+      }
+    }
+  });
+
+  test("reports repo when the package root contains .git", () => {
+    const tempRoot = mkdtempSync(path.join(tmpdir(), "runtime-source-repo-"));
+    tempRoots.push(tempRoot);
+    const srcDir = path.join(tempRoot, "src", "server");
+    mkdirSync(srcDir, { recursive: true });
+    mkdirSync(path.join(tempRoot, ".git"), { recursive: true });
+    writeFileSync(path.join(tempRoot, "package.json"), "{}\n");
+    writeFileSync(path.join(srcDir, "index.ts"), "export {};\n");
+
+    expect(
+      resolveRuntimeSource(pathToFileURL(path.join(srcDir, "index.ts")).href),
+    ).toBe("repo");
+  });
+
+  test("reports installed when the package root has no .git", () => {
+    const tempRoot = mkdtempSync(path.join(tmpdir(), "runtime-source-installed-"));
+    tempRoots.push(tempRoot);
+    const srcDir = path.join(tempRoot, "src", "server");
+    mkdirSync(srcDir, { recursive: true });
+    writeFileSync(path.join(tempRoot, "package.json"), "{}\n");
+    writeFileSync(path.join(srcDir, "index.ts"), "export {};\n");
+
+    expect(
+      resolveRuntimeSource(pathToFileURL(path.join(srcDir, "index.ts")).href),
+    ).toBe("installed");
+  });
+});

package/src/shared/runtimeIdentity.ts

@@ -0,0 +1,35 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import type { RuntimeKind } from "./runtimeConfig";
+
+export type RuntimeSource = "repo" | "installed";
+
+export interface RuntimeIdentity {
+  kind: RuntimeKind;
+  source: RuntimeSource;
+}
+
+function findPackageRoot(startDir: string): string {
+  let currentDir = path.resolve(startDir);
+
+  for (;;) {
+    if (existsSync(path.join(currentDir, "package.json"))) {
+      return currentDir;
+    }
+
+    const parentDir = path.dirname(currentDir);
+    if (parentDir === currentDir) {
+      return startDir;
+    }
+    currentDir = parentDir;
+  }
+}
+
+export function resolveRuntimeSource(fromMetaUrl: string = import.meta.url): RuntimeSource {
+  const sourceFilePath = fileURLToPath(fromMetaUrl);
+  const packageRoot = findPackageRoot(path.dirname(sourceFilePath));
+  // The repo checkout includes `.git`; packed/global installs do not. This keeps
+  // runtime/source reporting aligned with the user's repo-vs-installed question.
+  return existsSync(path.join(packageRoot, ".git")) ? "repo" : "installed";
+}

package/src/shared/serverStatus.ts

@@ -0,0 +1,21 @@
+import type { RuntimeKind } from "./runtimeConfig";
+import type { RuntimeSource } from "./runtimeIdentity";
+
+export interface RunningServerStatus {
+  pid: number;
+  port: number;
+  running: true;
+  runtime: RuntimeKind;
+  source: RuntimeSource;
+  url: string;
+}
+
+export interface StoppedServerStatus {
+  running: false;
+}
+
+export type ServerStatus = RunningServerStatus | StoppedServerStatus;
+
+export function buildLocalServerUrl(port: number): string {
+  return `http://127.0.0.1:${port}`;
+}