mini-coder 0.5.0 → 0.5.2

package/src/ui.ts

@@ -8,7 +8,7 @@
  * @module
  */
 
-import { exec } from "node:child_process";
+import { spawn } from "node:child_process";
 import { platform } from "node:os";
 import {
   cel,
@@ -57,6 +57,20 @@ const PULSE_WIDTH = 5;
 /** Maximum number of committed messages rendered before older history is chunked. */
 const CONVERSATION_CHUNK_MESSAGES = 50;
 
+/** Centralized interactive quit rules for keypresses and submitted input. */
+const QUIT_RULES: Readonly<{
+  /** Submitted raw inputs that trigger graceful quit. */
+  inputs: ReadonlySet<string>;
+  /** Keypresses that always trigger graceful quit. */
+  keysAlways: ReadonlySet<string>;
+  /** Keypresses that trigger graceful quit only when input is empty. */
+  keysWhenEmptyInput: ReadonlySet<string>;
+}> = {
+  inputs: new Set([":q"]),
+  keysAlways: new Set(["ctrl+c"]),
+  keysWhenEmptyInput: new Set(["ctrl+d"]),
+};
+
 // ---------------------------------------------------------------------------
 // UI state (module-scoped, not in AppState)
 // ---------------------------------------------------------------------------
@@ -92,6 +106,23 @@ let stdinWasRaw = false;
 /** Active overlay for interactive commands (/model, /effort, etc.). */
 let activeOverlay: ActiveOverlay | null = null;
 
+/** Determine whether a raw input line should trigger a graceful quit. */
+export function isQuitInput(raw: string): boolean {
+  const trimmed = raw.trim();
+  return QUIT_RULES.inputs.has(trimmed);
+}
+
+/** Determine whether a keypress should trigger a graceful quit. */
+export function isQuitKey(key: string, input: string): boolean {
+  if (QUIT_RULES.keysAlways.has(key)) {
+    return true;
+  }
+  if (input === "" && QUIT_RULES.keysWhenEmptyInput.has(key)) {
+    return true;
+  }
+  return false;
+}
+
 /**
  * Reset all module-scoped UI state.
  *
@@ -299,6 +330,14 @@ export function createInputController(state: AppState): InputController {
     onKeyPress: (key) => {
       if (key === "enter") {
         const raw = inputValue;
+
+        if (isQuitInput(raw)) {
+          inputValue = "";
+          cel.render();
+          requestGracefulExit(state);
+          return false;
+        }
+
         inputValue = "";
         cel.render();
         handleInput(raw, state);
@@ -338,10 +377,49 @@ export function renderInputArea(
 // Runtime helpers and controllers
 // ---------------------------------------------------------------------------
 
-/** Open a URL in the user's default browser. */
-function openInBrowser(url: string): void {
-  const cmd = platform() === "darwin" ? "open" : "xdg-open";
-  exec(`${cmd} ${JSON.stringify(url)}`);
+/** Browser process handle used by the platform opener helper. */
+interface BrowserOpenProcess {
+  /** Detach the browser opener so the app does not wait on it. */
+  unref: () => void;
+  /** Optional error listener used by real child-process implementations. */
+  on?: (event: "error", listener: (error: Error) => void) => void;
+}
+
+/** Optional runtime overrides for browser launching. */
+interface OpenInBrowserRuntime {
+  /** Platform used to choose the opener binary. */
+  platform?: NodeJS.Platform;
+  /** Process launcher used for tests. */
+  spawn?: (
+    command: string,
+    args: string[],
+    options: { detached: boolean; stdio: "ignore" },
+  ) => BrowserOpenProcess;
+}
+
+/** Open a URL in the user's default browser without invoking a shell. */
+export function openInBrowser(
+  url: string,
+  runtime?: OpenInBrowserRuntime,
+): void {
+  const command =
+    (runtime?.platform ?? platform()) === "darwin" ? "open" : "xdg-open";
+  const launch =
+    runtime?.spawn ??
+    ((
+      cmd: string,
+      args: string[],
+      options: { detached: boolean; stdio: "ignore" },
+    ) => {
+      return spawn(cmd, args, options);
+    });
+  const child = launch(command, [url], {
+    detached: true,
+    stdio: "ignore",
+  });
+
+  child.on?.("error", () => {});
+  child.unref();
 }
 
 function scrollConversationToBottom(): void {
@@ -418,6 +496,11 @@ async function gracefulExit(state: AppState): Promise<void> {
   process.exit(0);
 }
 
+/** Request a graceful exit and hard-fail if shutdown errors. */
+function requestGracefulExit(state: AppState): void {
+  gracefulExit(state).catch(() => process.exit(1));
+}
+
 /** Restore the terminal to the shell before suspending. */
 function suspendTerminalUi(): void {
   stopDividerAnimation();
@@ -490,6 +573,7 @@ function renderConversationLog(state: AppState, width: number): Node {
       gap: CONVERSATION_GAP,
       overflow: "scroll",
       scrollbar: true,
+      justifyContent: state.messages.length === 0 ? "center" : undefined,
       scrollOffset: stickToBottom ? Infinity : scrollOffset,
       onScroll: (offset, maxOffset) => {
         const wasStickToBottom = stickToBottom;
@@ -539,12 +623,8 @@ export function renderBaseLayout(
           commandController.showInputHistoryOverlay(state);
           return;
         }
-        if (key === "ctrl+c") {
-          gracefulExit(state).catch(() => process.exit(1));
-          return;
-        }
-        if (key === "ctrl+d" && inputValue === "") {
-          gracefulExit(state).catch(() => process.exit(1));
+        if (isQuitKey(key, inputValue)) {
+          requestGracefulExit(state);
           return;
         }
         if (key === "ctrl+z") {
@@ -612,4 +692,9 @@ export function startUI(state: AppState): void {
   if (state.running) {
     startDividerAnimation();
   }
+
+  // Show warnings from custom provider discovery
+  for (const warning of state.startupWarnings) {
+    appendInfoMessage(warning, state);
+  }
 }

package/src/version.ts

@@ -0,0 +1,48 @@
+/**
+ * Version helpers for the interactive empty-state banner.
+ *
+ * @module
+ */
+
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+
+/** App name shown in the empty conversation banner. */
+export const APP_NAME = "mini-coder";
+
+/** Fallback label used when running from a local checkout instead of a packaged install. */
+export const DEV_VERSION_LABEL = "dev";
+
+/**
+ * Resolve the version label shown in the empty conversation banner.
+ *
+ * Packaged installs read their version from the colocated `package.json`.
+ * Local checkouts fall back to a simple `dev` label so banner metadata never
+ * risks interfering with normal startup.
+ *
+ * @param appRoot - App root containing `package.json`.
+ * @returns A display label such as `v0.5.1` or `dev`.
+ */
+export function resolveAppVersionLabel(
+  appRoot = join(import.meta.dir, ".."),
+): string {
+  if (existsSync(join(appRoot, ".git"))) {
+    return DEV_VERSION_LABEL;
+  }
+
+  const packageJsonPath = join(appRoot, "package.json");
+  if (!existsSync(packageJsonPath)) {
+    return DEV_VERSION_LABEL;
+  }
+
+  try {
+    const parsed = JSON.parse(readFileSync(packageJsonPath, "utf-8")) as {
+      version?: unknown;
+    };
+    return typeof parsed.version === "string" && parsed.version !== ""
+      ? `v${parsed.version}`
+      : DEV_VERSION_LABEL;
+  } catch {
+    return DEV_VERSION_LABEL;
+  }
+}