gflows 0.1.18 → 1.0.1

package/src/tui/prompts.tsx

@@ -0,0 +1,207 @@
+/**
+ * Ink-native prompts used inside the hub (no Clack drop-out).
+ * @module tui/prompts
+ */
+
+import { Box, Text, useInput } from "ink";
+import type React from "react";
+import { useState } from "react";
+
+const ACCENT = "#E88C4A";
+const MUTED = "#8A8A8A";
+const FG = "#E6E6E6";
+
+/** Option for {@link InkSelect}. */
+export interface InkSelectOption<T extends string> {
+  value: T;
+  label: string;
+  hint?: string;
+}
+
+/**
+ * Arrow-key select list.
+ */
+export function InkSelect<T extends string>({
+  message,
+  options,
+  initialIndex = 0,
+  onSubmit,
+  onCancel,
+}: {
+  message: string;
+  options: InkSelectOption<T>[];
+  initialIndex?: number;
+  onSubmit: (value: T) => void;
+  onCancel?: () => void;
+}): React.ReactElement {
+  const [selected, setSelected] = useState(
+    Math.min(Math.max(0, initialIndex), Math.max(0, options.length - 1)),
+  );
+
+  useInput((ch, key) => {
+    if (key.escape || (key.ctrl && ch === "c")) {
+      onCancel?.();
+      return;
+    }
+    if (key.upArrow) {
+      setSelected((i) => Math.max(0, i - 1));
+      return;
+    }
+    if (key.downArrow) {
+      setSelected((i) => Math.min(options.length - 1, i + 1));
+      return;
+    }
+    if (key.return) {
+      const opt = options[selected];
+      if (opt) onSubmit(opt.value);
+    }
+  });
+
+  return (
+    <Box flexDirection="column">
+      <Text bold color={FG}>
+        {message}
+      </Text>
+      {options.map((opt, i) => {
+        const active = i === selected;
+        return (
+          <Text key={opt.value} color={active ? FG : MUTED} bold={active}>
+            {active ? <Text color={ACCENT}>❯ </Text> : "  "}
+            {opt.label}
+            {opt.hint ? <Text color={MUTED}>{`  ${opt.hint}`}</Text> : null}
+          </Text>
+        );
+      })}
+      <Text color={MUTED}>↑↓ · enter · esc cancel</Text>
+    </Box>
+  );
+}
+
+/**
+ * Yes/no confirm (←/→ or y/n).
+ */
+export function InkConfirm({
+  message,
+  initialValue = true,
+  onSubmit,
+  onCancel,
+}: {
+  message: string;
+  initialValue?: boolean;
+  onSubmit: (value: boolean) => void;
+  onCancel?: () => void;
+}): React.ReactElement {
+  const [value, setValue] = useState(initialValue);
+
+  useInput((ch, key) => {
+    if (key.escape || (key.ctrl && ch === "c")) {
+      onCancel?.();
+      return;
+    }
+    if (key.leftArrow || key.rightArrow || ch === " ") {
+      setValue((v) => !v);
+      return;
+    }
+    if (ch === "y" || ch === "Y") {
+      onSubmit(true);
+      return;
+    }
+    if (ch === "n" || ch === "N") {
+      onSubmit(false);
+      return;
+    }
+    if (key.return) onSubmit(value);
+  });
+
+  return (
+    <Box flexDirection="column">
+      <Text bold color={FG}>
+        {message}
+      </Text>
+      <Text>
+        <Text color={value ? ACCENT : MUTED} bold={value}>
+          {value ? "●" : "○"} Yes
+        </Text>
+        {"   "}
+        <Text color={!value ? ACCENT : MUTED} bold={!value}>
+          {!value ? "●" : "○"} No
+        </Text>
+      </Text>
+      <Text color={MUTED}>←→ / y n · enter · esc cancel</Text>
+    </Box>
+  );
+}
+
+/**
+ * Single-line text input.
+ */
+export function InkText({
+  message,
+  placeholder,
+  initialValue = "",
+  onSubmit,
+  onCancel,
+}: {
+  message: string;
+  placeholder?: string;
+  initialValue?: string;
+  onSubmit: (value: string) => void;
+  onCancel?: () => void;
+}): React.ReactElement {
+  const [value, setValue] = useState(initialValue);
+
+  useInput((ch, key) => {
+    if (key.escape || (key.ctrl && ch === "c")) {
+      onCancel?.();
+      return;
+    }
+    if (key.return) {
+      const out = value.trim() || (placeholder ?? "");
+      if (out) onSubmit(out);
+      return;
+    }
+    if (key.backspace || key.delete) {
+      setValue((s) => [...s].slice(0, -1).join(""));
+      return;
+    }
+    if (ch && !key.ctrl && !key.meta && ch >= " ") {
+      setValue((s) => s + ch);
+    }
+  });
+
+  return (
+    <Box flexDirection="column">
+      <Text bold color={FG}>
+        {message}
+      </Text>
+      <Text>
+        <Text color={ACCENT}>❯ </Text>
+        {value || <Text color={MUTED}>{placeholder ?? ""}</Text>}
+        <Text color={ACCENT}>█</Text>
+      </Text>
+      <Text color={MUTED}>type · enter · esc cancel</Text>
+    </Box>
+  );
+}
+
+/**
+ * Framed wizard chrome around a prompt step.
+ */
+export function WizardFrame({
+  title,
+  children,
+}: {
+  title: string;
+  children: React.ReactNode;
+}): React.ReactElement {
+  return (
+    <Box flexDirection="column" borderStyle="round" borderColor={ACCENT} paddingX={1} paddingY={0}>
+      <Text bold color={ACCENT}>
+        {title}
+      </Text>
+      <Box marginTop={1} flexDirection="column">
+        {children}
+      </Box>
+    </Box>
+  );
+}

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 ? " " : ""}`;
+}

package/src/types.ts

@@ -34,7 +34,42 @@ export type Command =
   | "completion"
   | "status"
   | "help"
-  | "version";
+  | "version"
+  | "sync"
+  | "pr"
+  | "doctor"
+  | "config"
+  | "schema"
+  | "continue"
+  | "undo"
+  | "abort"
+  | "mcp"
+  | "viz";
+
+/** All CLI commands in display order. */
+export const ALL_COMMANDS: Command[] = [
+  "init",
+  "start",
+  "finish",
+  "switch",
+  "delete",
+  "list",
+  "bump",
+  "sync",
+  "pr",
+  "viz",
+  "doctor",
+  "config",
+  "schema",
+  "continue",
+  "undo",
+  "abort",
+  "completion",
+  "status",
+  "help",
+  "version",
+  "mcp",
+];
 
 /** Branch prefix overrides per type (e.g. "feature" -> "feature/"). */
 export interface BranchPrefixes {
@@ -75,6 +110,9 @@ export type BumpDirection = "up" | "down";
 /** Bump type (semver segment). */
 export type BumpType = "patch" | "minor" | "major";
 
+/** Config subcommand for `gflows config`. */
+export type ConfigAction = "get" | "set";
+
 /** Parsed CLI arguments after resolving command, type, name, and flags. */
 export interface ParsedArgs {
   command: Command;
@@ -92,6 +130,12 @@ export interface ParsedArgs {
   bumpDirection?: BumpDirection;
   /** Bump type (patch | minor | major). */
   bumpType?: BumpType;
+  /** Config get/set action. */
+  configAction?: ConfigAction;
+  /** Config key (main, dev, remote, or prefixes.<type>). */
+  configKey?: string;
+  /** Config value for set. */
+  configValue?: string;
   // Common flags
   push: boolean;
   noPush: boolean;
@@ -107,7 +151,9 @@ export interface ParsedArgs {
   quiet: boolean;
   force: boolean;
   path: string | undefined;
-  // start
+  /** Raw --from / -o value (base branch override). */
+  from: string | undefined;
+  /** True when --from points at main (configured or literal). */
   fromMain: boolean;
   // finish
   noFf: boolean;
@@ -117,8 +163,21 @@ export interface ParsedArgs {
   noTag: boolean;
   tagMessage: string | undefined;
   message: string | undefined;
-  // list
+  squash: boolean;
+  preview: boolean;
+  bumpOnFinish: boolean;
+  // list / status
   includeRemote: boolean;
+  json: boolean;
+  // sync
+  rebase: boolean;
   // switch: explicit mode when uncommitted (overrides prompt)
   switchMode?: "restore" | "clean" | "cancel" | "move" | "destroy";
+  /**
+   * Optional package.json script name to wire to `gflows` during init
+   * (e.g. `"g"` → `bun run g -- start feature x`). Undefined = ask (TTY) or skip.
+   */
+  scriptAlias: string | undefined;
+  /** When true, never add a package.json script alias during init. */
+  noScriptAlias: boolean;
 }

package/src/ui.ts

@@ -0,0 +1,132 @@
+/**
+ * Modern terminal chrome shared by viz and the interactive hub.
+ * Lightweight ANSI panels (Claude Code / Codex–style), no TUI framework.
+ * @module ui
+ */
+
+const RESET = "\x1b[0m";
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+const CYAN = "\x1b[36m";
+const GREEN = "\x1b[32m";
+const YELLOW = "\x1b[33m";
+const MAGENTA = "\x1b[35m";
+const BLUE = "\x1b[34m";
+
+/**
+ * Whether stdout can use ANSI color.
+ */
+export function colorEnabled(): boolean {
+  if (process.env.NO_COLOR) return false;
+  return typeof process.stdout.isTTY === "boolean" && process.stdout.isTTY;
+}
+
+/**
+ * Wraps text in an ANSI code when color is enabled.
+ */
+export function paint(code: string, text: string): string {
+  return colorEnabled() ? `${code}${text}${RESET}` : text;
+}
+
+/** Shared ANSI codes for callers that compose styles. */
+export const ansi = {
+  reset: RESET,
+  bold: BOLD,
+  dim: DIM,
+  cyan: CYAN,
+  green: GREEN,
+  yellow: YELLOW,
+  magenta: MAGENTA,
+  blue: BLUE,
+} as const;
+
+const ESC = "\u001b";
+const ANSI_RE = new RegExp(`${ESC}\\[[0-9;]*m`, "g");
+const ANSI_PREFIX_RE = new RegExp(`^${ESC}\\[[0-9;]*m`);
+
+/**
+ * Visible length of a string ignoring ANSI escape sequences.
+ */
+export function visibleLength(text: string): number {
+  return text.replace(ANSI_RE, "").length;
+}
+
+/**
+ * Pads or soft-truncates a line to a target visible width.
+ */
+export function padVisible(text: string, width: number): string {
+  const len = visibleLength(text);
+  if (len === width) return text;
+  if (len < width) return text + " ".repeat(width - len);
+  let out = "";
+  let vis = 0;
+  let i = 0;
+  while (i < text.length && vis < width - 1) {
+    if (text[i] === ESC) {
+      const m = text.slice(i).match(ANSI_PREFIX_RE);
+      if (m) {
+        out += m[0];
+        i += m[0].length;
+        continue;
+      }
+    }
+    out += text[i];
+    vis++;
+    i++;
+  }
+  return `${out}…`;
+}
+
+/**
+ * Renders a rounded status panel (title bar + body rows).
+ */
+export function renderPanel(title: string, body: string[], width = 56): string[] {
+  const inner = Math.max(24, width - 2);
+  const labeled = `─ ${title} `;
+  const fill = Math.max(0, inner - visibleLength(labeled));
+  const top = paint(CYAN + BOLD, `╭${labeled}${"─".repeat(fill)}╮`);
+  const bottom = paint(DIM, `╰${"─".repeat(inner)}╯`);
+  const rows = body.map((line) => {
+    const content = padVisible(` ${line}`, inner);
+    return `${paint(DIM, "│")}${content}${paint(DIM, "│")}`;
+  });
+  return [top, ...rows, bottom];
+}
+
+/**
+ * Section header.
+ */
+export function section(title: string): string {
+  return paint(BOLD, title);
+}
+
+/**
+ * Dim horizontal rule.
+ */
+export function rule(width = 56): string {
+  return paint(DIM, "─".repeat(width));
+}
+
+/**
+ * Accent arrow for recommended next step.
+ */
+export function recommendLine(label: string): string {
+  return `${paint(GREEN + BOLD, "→")} ${paint(BOLD, label)}`;
+}
+
+/**
+ * Chip / badge text.
+ */
+export function chip(text: string, tone: "ok" | "warn" | "info" | "muted" = "muted"): string {
+  const code = tone === "ok" ? GREEN : tone === "warn" ? YELLOW : tone === "info" ? CYAN : DIM;
+  return paint(code, `[${text}]`);
+}
+
+/**
+ * Keyboard hint footer.
+ */
+export function keyHints(pairs: Array<[string, string]>): string {
+  return pairs
+    .map(([key, label]) => `${paint(BOLD, key)} ${paint(DIM, label)}`)
+    .join(paint(DIM, "  ·  "));
+}

package/src/version.ts

@@ -0,0 +1,24 @@
+/**
+ * Package version helper for CLI chrome and schema.
+ * @module version
+ */
+
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+/**
+ * Reads the installed/package version from package.json.
+ */
+export function getVersion(): string {
+  try {
+    const pkgPath = join(__dirname, "..", "package.json");
+    const raw = readFileSync(pkgPath, "utf-8");
+    const pkg = JSON.parse(raw) as { version?: string };
+    return pkg.version ?? "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}