gflows 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -7,14 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.1] - 2026-07-25
+
 ### Added
 
 - Fullscreen **Ink** TUI hub (`gflows` on TTY): bordered frame, tips / what’s next, actions, `❯` slash prompt, status bar
 - Slash commands: `/init` `/start` `/sync` `/pr` `/finish` `/doctor` `/help` …
+- In-hub `/` autocomplete (↑↓ select, Tab complete, Enter run)
 - Interactive prompts via **@clack/prompts** (Inquirer removed)
 - Legacy Clack menu fallback when TUI cannot run; `gflows viz` for scrollback panel
 - `gflows init`: optional `package.json` script alias (`--script-alias g`, TTY prompt); docs recommend shell `alias g=gflows` for shortest DX
-- Hub wizards (`/start`, `/finish`, `/sync`) run **inside Ink** (fewer Clack drop-outs); only git dispatch leaves the TUI
+- Hub wizards (`/start`, `/finish`, `/sync`, `/list`) run **inside Ink** (fewer drop-outs); only git dispatch leaves the TUI
+
+### Fixed
+
+- Hub no longer exits after dispatch (`stdin.ref` after Ink unmount; alternate screen)
+- `/list` renders a styled in-hub branch view instead of plain stdout under a tall gap
 
 ## [1.0.0] - 2026-07-24
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gflows",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "author": "Ali AlNaghmoush (https://github.com/alialnaghmoush)",
   "repository": {
     "type": "git",

package/src/commands/mcp.ts

@@ -5,6 +5,7 @@
 
 import { EXIT_OK } from "../constants.js";
 import type { ParsedArgs } from "../types.js";
+import { getVersion } from "../version.js";
 
 interface JsonRpcRequest {
   jsonrpc?: string;
@@ -197,7 +198,7 @@ export async function run(_args: ParsedArgs): Promise<void> {
         respond(req.id, {
           protocolVersion: "2024-11-05",
           capabilities: { tools: {} },
-          serverInfo: { name: "gflows", version: "1.0.0" },
+          serverInfo: { name: "gflows", version: getVersion() },
         });
         continue;
       }

package/src/commands/schema.ts

@@ -5,6 +5,7 @@
 
 import type { ParsedArgs } from "../types.js";
 import { ALL_COMMANDS, BRANCH_TYPE_SHORTS } from "../types.js";
+import { getVersion } from "../version.js";
 
 /**
  * Emits JSON schema for agents and tooling.
@@ -12,7 +13,7 @@ import { ALL_COMMANDS, BRANCH_TYPE_SHORTS } from "../types.js";
 export async function run(_args: ParsedArgs): Promise<void> {
   const schema = {
     name: "gflows",
-    version: "1.0.0",
+    version: getVersion(),
     description: "Git branching workflow CLI (main + dev + typed short-lived branches)",
     exitCodes: {
       "0": "success",

package/src/tui/HubHome.tsx

@@ -11,6 +11,7 @@ import { getCurrentBranch, resolveRepoRoot } from "../git.js";
 import { type RecommendAction, recommend } from "../recommend.js";
 import { getVersion } from "../version.js";
 import { collectVizSnapshot, type VizSnapshot } from "../viz.js";
+import { completeSlashInput, filterSlashCommands } from "./slash.js";
 
 const ACCENT = "#E88C4A";
 const MUTED = "#8A8A8A";
@@ -50,9 +51,12 @@ export function HubHome({
   const [repoPath, setRepoPath] = useState(cwd);
   const [selected, setSelected] = useState(0);
   const [input, setInput] = useState("");
+  const [slashIndex, setSlashIndex] = useState(0);
   const [showHelp, setShowHelp] = useState(false);
   const [loading, setLoading] = useState(true);
   const version = useMemo(() => getVersion(), []);
+  const slashMatches = useMemo(() => filterSlashCommands(input), [input]);
+  const slashMode = input.startsWith("/");
 
   useEffect(() => {
     let cancelled = false;
@@ -87,6 +91,17 @@ export function HubHome({
     if (selected >= actions.length) setSelected(Math.max(0, actions.length - 1));
   }, [actions.length, selected]);
 
+  useEffect(() => {
+    if (slashIndex >= slashMatches.length) {
+      setSlashIndex(Math.max(0, slashMatches.length - 1));
+    }
+  }, [slashMatches.length, slashIndex]);
+
+  const setSlashInput = (next: string) => {
+    setInput(next);
+    setSlashIndex(0);
+  };
+
   useInput((ch, key) => {
     if (key.ctrl && ch === "c") {
       onQuit();
@@ -94,7 +109,7 @@ export function HubHome({
     }
     if (key.escape) {
       if (input || showHelp) {
-        setInput("");
+        setSlashInput("");
         setShowHelp(false);
         return;
       }
@@ -109,23 +124,41 @@ export function HubHome({
       onQuit();
       return;
     }
+    if (key.tab && slashMode) {
+      const next = completeSlashInput(input, slashIndex);
+      if (next !== null) setSlashInput(next);
+      return;
+    }
     if (key.upArrow) {
+      if (slashMode && slashMatches.length > 0) {
+        setSlashIndex((i) => Math.max(0, i - 1));
+        return;
+      }
       setSelected((i) => Math.max(0, i - 1));
       return;
     }
     if (key.downArrow) {
+      if (slashMode && slashMatches.length > 0) {
+        setSlashIndex((i) => Math.min(slashMatches.length - 1, i + 1));
+        return;
+      }
       setSelected((i) => Math.min(actions.length - 1, i + 1));
       return;
     }
     if (key.backspace || key.delete) {
-      setInput((s) => [...s].slice(0, -1).join(""));
+      setSlashInput([...input].slice(0, -1).join(""));
       return;
     }
     if (key.return) {
       const cmd = input.trim();
       if (cmd.startsWith("/")) {
-        setInput("");
-        onSlash(cmd);
+        const match = slashMatches[slashIndex];
+        const body = cmd.slice(1);
+        const token = (body.split(/\s+/)[0] ?? "").toLowerCase();
+        const hasArgs = body.includes(" ");
+        const resolved = match && !hasArgs && token !== match.name ? `/${match.name}` : cmd;
+        setSlashInput("");
+        onSlash(resolved);
         return;
       }
       const action = actions[selected];
@@ -137,7 +170,7 @@ export function HubHome({
       return;
     }
     if (ch && !key.ctrl && !key.meta && ch >= " ") {
-      setInput((s) => s + ch);
+      setSlashInput(input + ch);
     }
   });
 
@@ -237,14 +270,29 @@ export function HubHome({
         <Box marginTop={1} flexDirection="column">
           <Text>
             <Text color={ACCENT}>❯ </Text>
-            {input || <Text color={MUTED}>type /start /finish /sync …</Text>}
+            {input || <Text color={MUTED}>type / for commands…</Text>}
             {input ? <Text color={ACCENT}>█</Text> : null}
           </Text>
-          <Text color={MUTED}>
-            {showHelp
-              ? "/init /start /sync /pr /finish /doctor /help  ·  esc clear  ·  ctrl+c quit"
-              : "? for shortcuts"}
-          </Text>
+          {slashMode && slashMatches.length > 0 ? (
+            <Box flexDirection="column" marginTop={0}>
+              {slashMatches.slice(0, 8).map((item, i) => {
+                const active = i === slashIndex;
+                return (
+                  <Text key={item.name} color={active ? FG : MUTED} bold={active}>
+                    {active ? <Text color={ACCENT}>› </Text> : "  "}/{item.name}
+                    <Text color={MUTED}>{`  ${item.hint}`}</Text>
+                  </Text>
+                );
+              })}
+              <Text color={MUTED}>↑↓ · tab complete · enter run · esc clear</Text>
+            </Box>
+          ) : (
+            <Text color={MUTED}>
+              {showHelp
+                ? "/init /start /sync /pr /finish /doctor /help  ·  esc clear  ·  ctrl+c quit"
+                : "? for shortcuts · / for command menu"}
+            </Text>
+          )}
         </Box>
       </Box>
 

package/src/tui/HubShell.tsx

@@ -6,9 +6,10 @@
 import { Box, Text, useApp, useInput } from "ink";
 import type React from "react";
 import { useState } from "react";
-import { FinishFlow, StartFlow, SyncFlow } from "./flows.js";
+import { FinishFlow, ListFlow, StartFlow, SyncFlow } from "./flows.js";
 import { HubHome } from "./HubHome.js";
 import { WizardFrame } from "./prompts.js";
+import { SLASH_COMMANDS } from "./slash.js";
 
 const ACCENT = "#E88C4A";
 const MUTED = "#8A8A8A";
@@ -22,8 +23,15 @@ type Screen =
   | { id: "start" }
   | { id: "finish" }
   | { id: "sync" }
+  | { id: "list" }
   | { id: "notice"; message: string };
 
+const DISPATCH_COMMANDS = new Set(
+  SLASH_COMMANDS.map((c) => c.name).filter(
+    (name) => !["start", "finish", "sync", "list", "viz", "quit", "exit", "q"].includes(name),
+  ),
+);
+
 /**
  * Props for the hub shell.
  */
@@ -83,27 +91,19 @@ export function HubShell({ cwd, onDone }: HubShellProps): React.ReactElement {
       setScreen({ id: "sync" });
       return;
     }
+    if (cmd === "list") {
+      setScreen({ id: "list" });
+      return;
+    }
     if (cmd === "viz") {
       setScreen({ id: "home", flash: "Branch map is shown on this screen." });
       return;
     }
 
-    const known = new Set([
-      "init",
-      "pr",
-      "continue",
-      "switch",
-      "list",
-      "doctor",
-      "help",
-      "config",
-      "bump",
-      "status",
-    ]);
-    if (!known.has(cmd)) {
+    if (!DISPATCH_COMMANDS.has(cmd)) {
       setScreen({
         id: "notice",
-        message: `Unknown /${cmd} — press ? on the home screen for shortcuts.`,
+        message: `Unknown /${cmd} — type / for command hints.`,
       });
       return;
     }
@@ -128,6 +128,10 @@ export function HubShell({ cwd, onDone }: HubShellProps): React.ReactElement {
       setScreen({ id: "sync" });
       return;
     }
+    if (action === "list") {
+      setScreen({ id: "list" });
+      return;
+    }
     runArgv([action]);
   };
 
@@ -140,6 +144,9 @@ export function HubShell({ cwd, onDone }: HubShellProps): React.ReactElement {
   if (screen.id === "sync") {
     return <SyncFlow onCancel={cancelWizard} onDone={runArgv} />;
   }
+  if (screen.id === "list") {
+    return <ListFlow cwd={cwd} onDone={cancelWizard} />;
+  }
   if (screen.id === "notice") {
     return (
       <PressEnter

package/src/tui/flows.tsx

@@ -1,13 +1,20 @@
 /**
- * Multi-step Ink wizards for hub actions (start / finish / sync).
+ * Multi-step Ink wizards for hub actions (start / finish / sync / list).
  * @module tui/flows
  */
 
+import { Box, Text, useInput } from "ink";
 import type React from "react";
-import { useState } from "react";
+import { useEffect, useState } from "react";
 import type { BranchType } from "../types.js";
+import { collectVizSnapshot, type VizSnapshot } from "../viz.js";
 import { InkConfirm, InkSelect, InkText, WizardFrame } from "./prompts.js";
 
+const MUTED = "#8A8A8A";
+const FG = "#E6E6E6";
+const GREEN = "#78C88C";
+const ACCENT = "#E88C4A";
+
 const BRANCH_TYPES: BranchType[] = ["feature", "bugfix", "chore", "release", "hotfix", "spike"];
 
 /**
@@ -138,3 +145,85 @@ export function SyncFlow({
     </WizardFrame>
   );
 }
+
+/**
+ * Styled branch list inside the hub (no drop-out to plain stdout).
+ */
+export function ListFlow({ cwd, onDone }: { cwd: string; onDone: () => void }): React.ReactElement {
+  const [lines, setLines] = useState<string[] | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    let cancelled = false;
+    void (async () => {
+      try {
+        const snap = await collectVizSnapshot(cwd);
+        if (!cancelled) setLines(formatListLines(snap));
+      } catch (err) {
+        if (!cancelled) {
+          setError(err instanceof Error ? err.message : String(err));
+          setLines([]);
+        }
+      }
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [cwd]);
+
+  useInput((_ch, key) => {
+    if (key.return || key.escape || (key.ctrl && _ch === "c")) onDone();
+  });
+
+  return (
+    <WizardFrame title="Branches">
+      {lines === null ? (
+        <Text color={MUTED}>Loading…</Text>
+      ) : error ? (
+        <Text color={FG}>{error}</Text>
+      ) : (
+        <Box flexDirection="column">
+          {lines.map((line) => {
+            const current = line.includes("●");
+            return (
+              <Text key={line} color={current ? GREEN : FG} bold={current}>
+                {line}
+              </Text>
+            );
+          })}
+        </Box>
+      )}
+      <Box marginTop={1}>
+        <Text color={MUTED}>enter / esc return to hub</Text>
+        <Text color={ACCENT}> █</Text>
+      </Box>
+    </WizardFrame>
+  );
+}
+
+/**
+ * Formats a viz snapshot into hub list rows.
+ */
+function formatListLines(snap: VizSnapshot): string[] {
+  const lines: string[] = [];
+  if (snap.suspended) lines.push(`⚠ suspended: ${snap.suspended}`);
+  for (const row of snap.rows) {
+    if (row.type !== "main" && row.type !== "dev") continue;
+    const mark = row.current ? "●" : "○";
+    lines.push(`${mark} ${row.name}  [${row.type}]`);
+  }
+  const workflow = snap.rows.filter((r) => r.type !== "main" && r.type !== "dev");
+  if (workflow.length === 0) {
+    lines.push("  (no workflow branches)");
+  } else {
+    for (let i = 0; i < workflow.length; i++) {
+      const row = workflow[i];
+      if (!row) continue;
+      const elbow = i === workflow.length - 1 ? "└─" : "├─";
+      const mark = row.current ? "●" : "○";
+      const ab = row.ahead === 0 && row.behind === 0 ? "synced" : `+${row.ahead}/-${row.behind}`;
+      lines.push(`${elbow} ${mark} ${row.name}  (${row.type}) ${ab}`);
+    }
+  }
+  return lines;
+}

package/src/tui/hub.ts

@@ -57,6 +57,12 @@ function runHubSession(cwd: string): Promise<HubSessionResult> {
           instance.unmount();
         },
       }),
+      {
+        // Keep hub off the primary scrollback so command output isn't stranded
+        // under a full-height cleared frame when we drop out for dispatch.
+        alternateScreen: true,
+        exitOnCtrlC: false,
+      },
     );
     void instance.waitUntilExit().then(() => {
       done({ kind: "quit" });
@@ -66,24 +72,43 @@ function runHubSession(cwd: string): Promise<HubSessionResult> {
 
 /**
  * Raw stdin “press enter” (no Clack / no Ink).
+ * Ink unrefs stdin on unmount — we must ref it again or the process exits
+ * before the user can return to the hub.
  */
 function waitEnterRaw(label: string): Promise<void> {
   return new Promise((resolve) => {
+    const stdin = process.stdin;
     process.stdout.write(`${label}\n`);
-    if (typeof process.stdin.setRawMode === "function") {
-      process.stdin.setRawMode(true);
+    if (typeof stdin.setRawMode === "function") {
+      stdin.setRawMode(true);
     }
-    process.stdin.resume();
+    stdin.resume();
+    stdin.ref();
+
+    // Drop buffered Enter from the hub key that launched this command.
+    if (typeof stdin.read === "function") {
+      for (;;) {
+        const pending = stdin.read();
+        if (pending === null) break;
+      }
+    }
+
+    const cleanup = () => {
+      stdin.off("data", onData);
+      if (typeof stdin.setRawMode === "function") {
+        stdin.setRawMode(false);
+      }
+      stdin.pause();
+      stdin.unref();
+    };
+
     const onData = (chunk: string | Buffer) => {
       const s = typeof chunk === "string" ? chunk : chunk.toString("utf8");
-      if (s === "\r" || s === "\n" || s === "\x03") {
-        process.stdin.off("data", onData);
-        if (typeof process.stdin.setRawMode === "function") {
-          process.stdin.setRawMode(false);
-        }
+      if (s.includes("\r") || s.includes("\n") || s.includes("\x03")) {
+        cleanup();
         resolve();
       }
     };
-    process.stdin.on("data", onData);
+    stdin.on("data", onData);
   });
 }

package/src/tui/slash.ts

@@ -0,0 +1,63 @@
+/**
+ * Slash-command catalog for the Ink hub prompt.
+ * @module tui/slash
+ */
+
+/** One slash command shown in hub autocomplete. */
+export interface SlashCommand {
+  /** Command name without leading `/`. */
+  name: string;
+  /** Short description for the suggestion list. */
+  hint: string;
+}
+
+/**
+ * Hub slash commands (order = suggestion priority).
+ */
+export const SLASH_COMMANDS: readonly SlashCommand[] = [
+  { name: "init", hint: "Initialize repo" },
+  { name: "start", hint: "Start new work (wizard)" },
+  { name: "sync", hint: "Sync with base (wizard)" },
+  { name: "pr", hint: "Open pull request" },
+  { name: "finish", hint: "Finish / merge (wizard)" },
+  { name: "continue", hint: "Continue suspended run" },
+  { name: "switch", hint: "Switch branch" },
+  { name: "list", hint: "List branches" },
+  { name: "doctor", hint: "Doctor checks" },
+  { name: "help", hint: "Show help" },
+  { name: "status", hint: "Repo status" },
+  { name: "config", hint: "Show config" },
+  { name: "bump", hint: "Bump version" },
+  { name: "viz", hint: "Branch map (on home)" },
+  { name: "quit", hint: "Leave hub" },
+] as const;
+
+/**
+ * Filters slash commands by the typed buffer (e.g. `/st` → start, status, switch).
+ */
+export function filterSlashCommands(input: string): SlashCommand[] {
+  if (!input.startsWith("/")) return [];
+  const body = input.slice(1);
+  const token = (body.split(/\s+/)[0] ?? "").toLowerCase();
+  // After a completed command + space, stop suggesting names
+  if (body.includes(" ") && token.length > 0) {
+    const exact = SLASH_COMMANDS.some((c) => c.name === token);
+    if (exact) return [];
+  }
+  if (token.length === 0) return [...SLASH_COMMANDS];
+  return SLASH_COMMANDS.filter((c) => c.name.startsWith(token));
+}
+
+/**
+ * Completes the command portion of a slash buffer (Tab).
+ * @returns updated input, or null if nothing to complete.
+ */
+export function completeSlashInput(input: string, selectedIndex = 0): string | null {
+  const matches = filterSlashCommands(input);
+  if (matches.length === 0) return null;
+  const pick = matches[Math.min(selectedIndex, matches.length - 1)];
+  if (!pick) return null;
+  const rest = input.includes(" ") ? input.slice(input.indexOf(" ")) : "";
+  if (rest.trim().length > 0) return null;
+  return `/${pick.name}${matches.length === 1 ? " " : ""}`;
+}