stage-tui 1.1.0 → 1.1.2

package/README.md

@@ -12,7 +12,7 @@ What it does:
 - Fast branch switching and commit history view
 - Optional AI-generated conventional commits
 
-<video src="https://github.com/user-attachments/assets/5f61e323-bb5e-4b11-9352-182d1a884feb" controls></video>
+<video src="https://github.com/user-attachments/assets/45b376bb-09a1-4666-929a-40017ec7748d" controls></video>
 
 ## Get Started
 
@@ -40,8 +40,10 @@ stage --dev
 ## Use
 
 ```bash
-stage            # use installed npm package
+stage            # launches immediately and updates in background for next run
 stage --dev      # use local checkout at STAGE_DEV_PATH
+stage update     # update global install using the same package manager used to install stage
+stage update --dry-run   # show detected package manager + update command only
 ```
 
 AI commit evals:

package/bin/stage

@@ -1,6 +1,11 @@
 #!/usr/bin/env bun
 import { existsSync } from "node:fs"
 import { join, resolve } from "node:path"
+import { fileURLToPath } from "node:url"
+
+const PACKAGE_NAME = "stage-tui"
+type PackageManager = "bun" | "npm" | "pnpm" | "yarn"
+type UpdateBehavior = "background" | "foreground"
 
 function resolveDevEntry(): string {
   const envPath = process.env.STAGE_DEV_PATH
@@ -23,6 +28,109 @@ function resolveDevEntry(): string {
   )
 }
 
+function detectPackageManager(scriptPath: string): PackageManager | null {
+  const normalizedPath = scriptPath.replaceAll("\\", "/")
+
+  if (normalizedPath.includes("/.bun/")) {
+    return "bun"
+  }
+
+  if (normalizedPath.includes("/.pnpm/") || normalizedPath.includes("/pnpm/global/")) {
+    return "pnpm"
+  }
+
+  if (normalizedPath.includes("/.config/yarn/") || normalizedPath.includes("/yarn/")) {
+    return "yarn"
+  }
+
+  if (normalizedPath.includes("/node_modules/")) {
+    return "npm"
+  }
+
+  return null
+}
+
+function buildUpdateCommand(packageManager: PackageManager): string[] {
+  const packageSpecifier = `${PACKAGE_NAME}@latest`
+
+  switch (packageManager) {
+    case "bun":
+      return ["bun", "add", "-g", packageSpecifier]
+    case "pnpm":
+      return ["pnpm", "add", "-g", packageSpecifier]
+    case "yarn":
+      return ["yarn", "global", "add", packageSpecifier]
+    case "npm":
+      return ["npm", "install", "-g", packageSpecifier]
+  }
+}
+
+async function runUpdateModeWithOptions(options: { dryRun: boolean }): Promise<void> {
+  const scriptPath = fileURLToPath(import.meta.url)
+  const packageManager = detectPackageManager(scriptPath)
+  if (options.dryRun) {
+    if (!packageManager) {
+      throw new Error(`Unable to detect how ${PACKAGE_NAME} was installed from ${scriptPath}.`)
+    }
+    const command = buildUpdateCommand(packageManager)
+    console.error(`Detected package manager: ${packageManager}`)
+    console.error(`Would run: ${command.join(" ")}`)
+    return
+  }
+
+  return runUpdateForManager(packageManager, scriptPath, {
+    strict: true,
+    behavior: "foreground",
+  })
+}
+
+function runAutoUpdateOnLaunch(): void {
+  const scriptPath = fileURLToPath(import.meta.url)
+  const packageManager = detectPackageManager(scriptPath)
+  void runUpdateForManager(packageManager, scriptPath, {
+    strict: false,
+    behavior: "background",
+  })
+}
+
+async function runUpdateForManager(
+  packageManager: PackageManager | null,
+  scriptPath: string,
+  options: {
+    strict: boolean
+    behavior: UpdateBehavior
+  },
+): Promise<void> {
+  if (!packageManager) {
+    if (!options.strict) {
+      // Launch path can be a local checkout (`bun run bin/stage` / `stage --dev`) with no package-manager signature.
+      // In that case auto-update cannot be resolved safely and must be skipped.
+      return
+    }
+    throw new Error(`Unable to detect how ${PACKAGE_NAME} was installed from ${scriptPath}.`)
+  }
+
+  const command = buildUpdateCommand(packageManager)
+  if (options.behavior === "background") {
+    Bun.spawn(command, {
+      stdin: "ignore",
+      stdout: "ignore",
+      stderr: "ignore",
+    })
+    return
+  }
+
+  console.error(`Updating ${PACKAGE_NAME} via ${packageManager}...`)
+  const child = Bun.spawn(command, { stdin: "inherit", stdout: "inherit", stderr: "inherit" })
+
+  const exitCode = await child.exited
+  if (exitCode !== 0) {
+    throw new Error(
+      `Failed to update ${PACKAGE_NAME} via ${packageManager} (exit code ${exitCode}).`,
+    )
+  }
+}
+
 async function runDevMode(args: string[]) {
   const entry = resolveDevEntry()
   const child = Bun.spawn(["bun", "run", entry, ...args], {
@@ -36,6 +144,21 @@ async function runDevMode(args: string[]) {
 
 try {
   const args = process.argv.slice(2)
+  const updateModeIndex = args.findIndex((arg) => arg === "update" || arg === "--update")
+  if (updateModeIndex >= 0) {
+    const isDryRun = args.includes("--dry-run")
+    const isValidUsage =
+      updateModeIndex === 0 &&
+      (args.length === 1 || (args.length === 2 && isDryRun && args[1] === "--dry-run"))
+    if (!isValidUsage) {
+      throw new Error('Usage: stage update [--dry-run]')
+    }
+    await runUpdateModeWithOptions({ dryRun: isDryRun })
+    process.exit(0)
+  }
+
+  runAutoUpdateOnLaunch()
+
   const devModeIndex = args.indexOf("--dev")
 
   if (devModeIndex >= 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stage-tui",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "private": false,
   "description": "Minimalist TUI Git client",
   "homepage": "https://github.com/jenslys/stage",

package/src/app.tsx

@@ -7,7 +7,6 @@ import { useGitTuiController } from "./hooks/use-git-tui-controller"
 import { CommitDialog } from "./ui/components/commit-dialog"
 import { DiffWorkspace } from "./ui/components/diff-workspace"
 import { FooterBar } from "./ui/components/footer-bar"
-import { SplashScreen } from "./ui/components/splash-screen"
 import { ShortcutsDialog } from "./ui/components/shortcuts-dialog"
 import { TopBar } from "./ui/components/top-bar"
 import { resolveUiTheme } from "./ui/theme"
@@ -46,36 +45,32 @@ export function App({ config }: AppProps) {
       />
 
       {activeScreen === "main" ? (
-        controller.hasSnapshot ? (
-          <DiffWorkspace
-            hasSnapshot={controller.hasSnapshot}
-            fileRows={controller.fileRows}
-            fileIndex={controller.fileIndex}
-            selectedFilePath={controller.selectedFilePath}
-            focus={controller.focus}
-            terminalWidth={terminalWidth}
-            terminalHeight={terminalHeight}
-            diffText={controller.diffText}
-            diffMessage={controller.diffMessage}
-            diffFiletype={controller.diffFiletype}
-            diffView={config.ui.diffView}
-            onFileClick={(index) => {
-              controller.focusFiles()
-              controller.setMainFileSelection(index)
-            }}
-            onFileScroll={(direction) => {
-              controller.focusFiles()
-              if (direction === "up") {
-                controller.moveToPreviousMainFile()
-              } else {
-                controller.moveToNextMainFile()
-              }
-            }}
-            theme={theme}
-          />
-        ) : (
-          <SplashScreen theme={theme} />
-        )
+        <DiffWorkspace
+          hasSnapshot={controller.hasSnapshot}
+          fileRows={controller.fileRows}
+          fileIndex={controller.fileIndex}
+          selectedFilePath={controller.selectedFilePath}
+          focus={controller.focus}
+          terminalWidth={terminalWidth}
+          terminalHeight={terminalHeight}
+          diffText={controller.diffText}
+          diffMessage={controller.diffMessage}
+          diffFiletype={controller.diffFiletype}
+          diffView={config.ui.diffView}
+          onFileClick={(index) => {
+            controller.focusFiles()
+            controller.setMainFileSelection(index)
+          }}
+          onFileScroll={(direction) => {
+            controller.focusFiles()
+            if (direction === "up") {
+              controller.moveToPreviousMainFile()
+            } else {
+              controller.moveToNextMainFile()
+            }
+          }}
+          theme={theme}
+        />
       ) : null}
 
       {activeScreen === "branch" ? (

package/src/ui/components/branch-dialog.tsx

@@ -1,6 +1,7 @@
 import type { InputRenderable, SelectOption } from "@opentui/core"
 import type { RefObject } from "react"
 
+import { SectionDivider } from "./section-divider"
 import type { UiTheme } from "../theme"
 import type { BranchDialogMode, FocusTarget } from "../types"
 import { getVisibleRange } from "../list-range"
@@ -80,6 +81,7 @@ export function BranchDialog({
       <box style={{ width: "100%", maxWidth: 88, gap: 1, flexDirection: "column", flexGrow: 1 }}>
         <text fg={theme.colors.title}>change branch</text>
         <text fg={theme.colors.subtleText}>current: {currentBranch}</text>
+        <SectionDivider theme={theme} />
         {mode === "select" ? (
           <>
             <text fg={theme.colors.subtleText}>

package/src/ui/components/commit-history-dialog.tsx

@@ -1,11 +1,11 @@
 import type { SelectOption } from "@opentui/core"
 
 import { getPaneWidths, resolveRowBackground, resolveRowTextColor } from "./commit-history/layout"
+import { SectionDivider } from "./section-divider"
 import { getVisibleRange } from "../list-range"
-import type { FocusTarget } from "../types"
+import type { CommitHistoryMode, FocusTarget } from "../types"
 import { fitLine, fitPathForWidth } from "../utils"
 import type { UiTheme } from "../theme"
-import type { CommitHistoryMode } from "../types"
 
 type CommitHistoryDialogProps = {
   open: boolean
@@ -96,6 +96,7 @@ export function CommitHistoryDialog({
             ? "tab: commits/files | enter: choose action | esc: close"
             : "up/down choose action | enter confirm | esc back"}
         </text>
+        <SectionDivider theme={theme} />
 
         <box style={{ flexDirection: "row", flexGrow: 1, gap: 1 }}>
           <box style={{ width: commitsPaneWidth, flexDirection: "column" }}>

package/src/ui/components/diff-workspace.tsx

@@ -1,4 +1,5 @@
 import type { UiTheme } from "../theme"
+import { SectionDivider } from "./section-divider"
 import { getVisibleRange } from "../list-range"
 import type { FileRow, FocusTarget } from "../types"
 import { fitPathPartsForWidth } from "../utils"
@@ -52,6 +53,7 @@ export function DiffWorkspace({
     <box style={{ flexDirection: "row", flexGrow: 1, gap: 1, paddingLeft: 1, paddingRight: 1 }}>
       <box style={{ width: changesPaneWidth, flexDirection: "column" }}>
         <text fg={theme.colors.mutedText}>changes ({fileRows.length})</text>
+        <SectionDivider theme={theme} />
         <box
           style={{ flexDirection: "column", flexGrow: 1 }}
           onMouseScroll={(event) => {
@@ -113,6 +115,7 @@ export function DiffWorkspace({
       </box>
       <box style={{ flexGrow: 1, flexDirection: "column" }}>
         <text fg={theme.colors.mutedText}>{paneLabel}</text>
+        <SectionDivider theme={theme} />
         {showLoadingState ? (
           <EmptyStatePanel
             title="loading repository state..."

package/src/ui/components/section-divider.tsx

@@ -0,0 +1,15 @@
+import type { UiTheme } from "../theme"
+
+const DIVIDER_LINE = "─".repeat(256)
+
+type SectionDividerProps = {
+  theme: UiTheme
+}
+
+export function SectionDivider({ theme }: SectionDividerProps) {
+  return (
+    <box style={{ width: "100%", height: 1 }}>
+      <text fg={theme.colors.subtleText}>{DIVIDER_LINE}</text>
+    </box>
+  )
+}

package/src/ui/components/splash-screen.tsx

@@ -1,24 +0,0 @@
-import type { UiTheme } from "../theme"
-
-type SplashScreenProps = {
-  theme: UiTheme
-}
-
-export function SplashScreen({ theme }: SplashScreenProps) {
-  return (
-    <box
-      style={{
-        flexGrow: 1,
-        justifyContent: "center",
-        alignItems: "center",
-        paddingLeft: 2,
-        paddingRight: 2,
-      }}
-    >
-      <box style={{ flexDirection: "column", alignItems: "center", gap: 1 }}>
-        <ascii-font text="STAGE" font="slick" color={theme.colors.footerReady} />
-        <text fg={theme.colors.subtleText}>loading repository...</text>
-      </box>
-    </box>
-  )
-}