ubume 0.1.0

package/src/config/appVersion.ts

@@ -0,0 +1,69 @@
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { APP_VERSION as BUILD_INFO_VERSION } from "./buildInfo.js";
+
+// Leaf module: must not import settings.ts or anything under src/core/version
+// (settings.ts re-exports APP_VERSION from here, so that would be a cycle).
+
+export const UBUME_PACKAGE_NAME = "ubume";
+export const LEGACY_CODEXA_PACKAGE_NAME = "@golba98/codexa";
+const SEMVER_RE = /^\d+\.\d+\.\d+(-[\w.]+)?$/;
+
+function readPackageVersion(packageJsonPath: string, allowedNames?: readonly string[]): string | null {
+  try {
+    const parsed = JSON.parse(readFileSync(packageJsonPath, "utf8")) as {
+      name?: unknown;
+      version?: unknown;
+    };
+    if (allowedNames && typeof parsed.name === "string" && !allowedNames.includes(parsed.name)) {
+      return null;
+    }
+    if (typeof parsed.version !== "string") return null;
+    const version = parsed.version.trim();
+    return SEMVER_RE.test(version) ? version : null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Resolves the version of the running Ubume install:
+ * 1. `UBUME_PACKAGE_ROOT` / `CODEXA_PACKAGE_ROOT` (set by bin/ubume.js) → that package.json's version
+ * 2. Walk up from this module for a package.json named "ubume" (or legacy "@golba98/codexa")
+ * 3. The committed buildInfo.ts APP_VERSION as the last resort
+ *
+ * `startDir` overrides the walk-up starting directory (test seam).
+ */
+export function resolveAppVersion(
+  env: NodeJS.ProcessEnv = process.env,
+  startDir?: string,
+): string {
+  const packageRoot = env.UBUME_PACKAGE_ROOT?.trim() || env.CODEXA_PACKAGE_ROOT?.trim();
+  if (packageRoot) {
+    const version = readPackageVersion(join(packageRoot, "package.json"));
+    if (version) return version;
+  }
+
+  let dir = startDir ?? dirname(fileURLToPath(import.meta.url));
+  const allowedNames = [UBUME_PACKAGE_NAME, LEGACY_CODEXA_PACKAGE_NAME] as const;
+  for (;;) {
+    const version = readPackageVersion(join(dir, "package.json"), allowedNames);
+    if (version) return version;
+    const parent = dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+
+  return BUILD_INFO_VERSION;
+}
+
+let cachedVersion: string | null = null;
+
+/** Cached form of resolveAppVersion() — the installed version cannot change mid-process. */
+export function getAppVersion(): string {
+  if (cachedVersion === null) {
+    cachedVersion = resolveAppVersion();
+  }
+  return cachedVersion;
+}

package/src/config/buildInfo.ts

@@ -0,0 +1,3 @@
+// Generated by scripts/gen-build-info.mjs — do not edit manually.
+export const BUILD_COMMIT = "cf100a7e97313dce7d66fab2424dc3ff55695db7" as const;
+export const APP_VERSION = "0.1.0" as const;

package/src/config/launchArgs.ts

@@ -0,0 +1,196 @@
+const FLAG_HELP = "--help";
+const FLAG_HELP_SHORT = "-h";
+const FLAG_VERSION = "--version";
+const FLAG_VERSION_SHORT = "-v";
+const FLAG_PROFILE = "--profile";
+const FLAG_CONFIG = "--config";
+const FLAG_CONFIG_SHORT = "-c";
+const FLAG_MODEL = "--model";
+const FLAG_MODEL_SHORT = "-m";
+const FLAG_NO_CLEAR = "--no-clear";
+
+export interface LaunchArgs {
+  help: boolean;
+  version: boolean;
+  initialPrompt: string | null;
+  profile: string | null;
+  configOverrides: string[];
+  passthroughArgs: string[];
+  /** Explicitly set when --model / -m was passed on the command line. Null when no model flag was given. */
+  modelOverride: string | null;
+  /** True when --no-clear was passed. Suppresses the startup terminal clear. */
+  noClear: boolean;
+}
+
+export type LaunchArgsParseResult =
+  | { ok: true; value: LaunchArgs }
+  | { ok: false; error: string };
+
+function normalizeProfileValue(value: string | undefined): string | null {
+  const trimmed = value?.trim();
+  return trimmed ? trimmed : null;
+}
+
+function parseConfigFlagValue(raw: string | undefined): string | null {
+  const trimmed = raw?.trim();
+  if (!trimmed) {
+    return null;
+  }
+
+  // Require non-empty key and non-empty value on both sides of "="
+  const separatorIndex = trimmed.indexOf("=");
+  if (separatorIndex <= 0 || separatorIndex === trimmed.length - 1) {
+    return null;
+  }
+
+  return trimmed;
+}
+
+function quoteTomlString(value: string): string {
+  return JSON.stringify(value);
+}
+
+export function parseLaunchArgs(argv: readonly string[]): LaunchArgsParseResult {
+  const passthroughArgs: string[] = [];
+  const configOverrides: string[] = [];
+  const promptArgs: string[] = [];
+  let help = false;
+  let version = false;
+  let noClear = false;
+  let profile: string | null = null;
+  let modelOverride: string | null = null;
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (!arg) {
+      continue;
+    }
+
+    if (arg === "--") {
+      promptArgs.push(...argv.slice(index + 1));
+      break;
+    }
+
+    if (arg === FLAG_HELP || arg === FLAG_HELP_SHORT) {
+      help = true;
+      continue;
+    }
+
+    if (arg === FLAG_VERSION || arg === FLAG_VERSION_SHORT) {
+      version = true;
+      continue;
+    }
+
+    if (arg === FLAG_NO_CLEAR) {
+      noClear = true;
+      continue;
+    }
+
+    // --profile <value> and --profile=<value> both supported.
+    if (arg === FLAG_PROFILE) {
+      const value = normalizeProfileValue(argv[index + 1]);
+      if (!value) {
+        return { ok: false, error: `Missing value for ${FLAG_PROFILE}.` };
+      }
+      profile = value;
+      passthroughArgs.push(arg, value);
+      index += 1;
+      continue;
+    }
+
+    if (arg.startsWith(`${FLAG_PROFILE}=`)) {
+      const value = normalizeProfileValue(arg.slice(`${FLAG_PROFILE}=`.length));
+      if (!value) {
+        return { ok: false, error: `Missing value for ${FLAG_PROFILE}.` };
+      }
+      profile = value;
+      passthroughArgs.push(`${FLAG_PROFILE}=${value}`);
+      continue;
+    }
+
+    // --config / -c accept key=value pairs; both space-separated and inline = forms supported.
+    if (arg === FLAG_CONFIG_SHORT || arg === FLAG_CONFIG) {
+      const value = parseConfigFlagValue(argv[index + 1]);
+      if (!value) {
+        return { ok: false, error: `Missing key=value payload for ${arg}.` };
+      }
+      configOverrides.push(value);
+      passthroughArgs.push(arg, value);
+      index += 1;
+      continue;
+    }
+
+    if (arg.startsWith(`${FLAG_CONFIG}=`)) {
+      const value = parseConfigFlagValue(arg.slice(`${FLAG_CONFIG}=`.length));
+      if (!value) {
+        return { ok: false, error: `Missing key=value payload for ${FLAG_CONFIG}.` };
+      }
+      configOverrides.push(value);
+      passthroughArgs.push(`${FLAG_CONFIG}=${value}`);
+      continue;
+    }
+
+    if (arg.startsWith(`${FLAG_CONFIG_SHORT}=`)) {
+      const value = parseConfigFlagValue(arg.slice(`${FLAG_CONFIG_SHORT}=`.length));
+      if (!value) {
+        return { ok: false, error: `Missing key=value payload for ${FLAG_CONFIG_SHORT}.` };
+      }
+      configOverrides.push(value);
+      passthroughArgs.push(`${FLAG_CONFIG_SHORT}=${value}`);
+      continue;
+    }
+
+    // --model / -m set the model via a config override, quoted for TOML.
+    // Also captured in modelOverride so callers can distinguish "was --model given?"
+    // from "what does layered config resolve to?" (which always has a default value).
+    if (arg === FLAG_MODEL || arg === FLAG_MODEL_SHORT) {
+      const value = normalizeProfileValue(argv[index + 1]);
+      if (!value) {
+        return { ok: false, error: `Missing value for ${arg}.` };
+      }
+      configOverrides.push(`model=${quoteTomlString(value)}`);
+      passthroughArgs.push(arg, value);
+      modelOverride = value;
+      index += 1;
+      continue;
+    }
+
+    if (arg.startsWith(`${FLAG_MODEL}=`)) {
+      const value = normalizeProfileValue(arg.slice(`${FLAG_MODEL}=`.length));
+      if (!value) {
+        return { ok: false, error: `Missing value for ${FLAG_MODEL}.` };
+      }
+      configOverrides.push(`model=${quoteTomlString(value)}`);
+      passthroughArgs.push(`${FLAG_MODEL}=${value}`);
+      modelOverride = value;
+      continue;
+    }
+
+    if (!arg.startsWith("-")) {
+      promptArgs.push(arg, ...argv.slice(index + 1));
+      break;
+    }
+
+    passthroughArgs.push(arg);
+  }
+
+  const initialPrompt = promptArgs
+    .map((part) => part.trim())
+    .filter(Boolean)
+    .join(" ")
+    .trim() || null;
+
+  return {
+    ok: true,
+    value: {
+      help,
+      version,
+      initialPrompt,
+      profile,
+      configOverrides,
+      passthroughArgs,
+      modelOverride,
+      noClear,
+    },
+  };
+}