gflows 1.2.0 → 1.2.1

package/AGENTS.md

@@ -46,8 +46,9 @@ gflows start release v1.2.0
 # … changelog / commits …
 gflows finish release -y -p
 
-# Quick release from dev (bump + merge main + tag, no release/* branch)
-gflows release up patch -y -p   # or -P; must be on dev
+# Quick release from dev (bump or keep version + merge main + tag, no release/* branch)
+gflows release up patch -y -p      # or -P; must be on dev
+gflows release current -y -p       # after a manual bump; tags package version as-is
 
 # Stuck
 gflows doctor --json

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.1] - 2026-07-25
+
+### Added
+
+- Quick release can keep the package version already on disk: `gflows release current -y -p` (or choose **keep current** in the hub / interactive prompt)
+- MCP `gflows_release` accepts `keepCurrent: true` as an alternative to `bumpType`
+
 ## [1.2.0] - 2026-07-25
 
 ### Added

package/README.md

@@ -130,7 +130,7 @@ main  ←  release / hotfix only          (production)
 | **dev**                              | Integration (created by `init` from main)                   |
 | **feature / bugfix / chore / spike** | Day-to-day work → merge to **dev**                          |
 | **release / hotfix**                 | Versioned (`vX.Y.Z`) → **main**, then **main → dev**, + tag |
-| **quick release** (`gflows release`) | From **dev** only: bump → **main** → tag → sync **dev**     |
+| **quick release** (`gflows release`) | From **dev** only: bump or keep → **main** → tag → sync **dev** |
 
 
 **Lifecycle:** `init` → `start` → commit → (`sync`) → (`pr`) → `finish`
@@ -217,11 +217,13 @@ Hub: `g` → select the action. Typed short form assumes `alias g=gflows`.
 | `gflows start release v1.4.0` | `g -S -r v1.4.0` |
 | `gflows finish release -y -p` | `g -F -r -y -p` |
 
-**Quick release from `dev`** — bump, merge **main**, tag, sync **main → dev** (no `release/*` branch)
+**Quick release from `dev`** — merge **main**, tag, sync **main → dev** (no `release/*` branch). Choose a bump, or keep a version you already set manually.
 
 | Long | Short |
 |------|-------|
-| `gflows release up patch -y -p` | — |
+| `gflows release up patch -y -p` | — (bump, then ship) |
+| `gflows release up minor -y -p` | — |
+| `gflows release current -y -p` | — (keep `package.json` version; no bump commit) |
 
 **Hotfix**
 
@@ -274,7 +276,7 @@ Bare `gflows` / `g` in a **TTY** opens the Ink hub (see [Way 1](#way-1--hub-reco
 | `init` `-I`                   | Ensure main; create dev                     |
 | `start` `-S`                  | Create typed branch                         |
 | `finish` `-F`                 | Merge + close (plan; delete default **on**) |
-| `release`                     | Quick release from `dev` (bump + main + tag)|
+| `release`                     | Quick release from `dev` (bump/keep + main + tag)|
 | `sync`                        | Update branch from its base                 |
 | `pr`                          | Open PR/MR (`gh` / `glab`)                  |
 | `switch` `-W`                 | Switch branch                               |

package/llms.txt

@@ -14,6 +14,7 @@
 - `gflows viz`: scrollback status panel — lifecycle, branches, recommended next step
 - `gflows init` / `start` / `finish` / `release` / `sync` / `pr`
 - `gflows release up patch -y -p` — quick ship from `dev` (bump + merge main + tag)
+- `gflows release current -y -p` — same, but keep the package version already on disk (after a manual bump)
 - `gflows continue` / `undo` / `abort` — recovery after conflicts
 - `gflows doctor` / `info` / `config` / `status --json` / `mcp`
 

package/package.json

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

package/src/commands/completion.ts

@@ -135,8 +135,8 @@ _gflows() {
       ;;
     release)
       if (( cword == cmd_idx + 1 )); then
-        COMPREPLY=($(compgen -W "up" -- "$cur"))
-      elif (( cword == cmd_idx + 2 )); then
+        COMPREPLY=($(compgen -W "up current" -- "$cur"))
+      elif (( cword == cmd_idx + 2 )) && [[ "${D}words[cmd_idx + 1]}" == "up" ]]; then
         COMPREPLY=($(compgen -W "${BUMP_TYPES.join(" ")}" -- "$cur"))
       else
         COMPREPLY=()
@@ -226,7 +226,7 @@ _gflows() {
           if [[ "${D}words[CURRENT-1]}" == "up" ]]; then
             _values "bump-type" ${BUMP_TYPES.map((t) => `"${t}"`).join(" ")}
           else
-            _values "direction" "up"
+            _values "mode" "up" "current"
           fi
           ;;
       esac
@@ -334,9 +334,11 @@ complete -c gflows -f -n "__fish_seen_subcommand_from bump; and not __fish_seen_
 complete -c gflows -f -n "__fish_seen_subcommand_from bump; and __fish_seen_subcommand_from up down" \\
   -a "patch minor major"
 
-# release up [patch|minor|major]
-complete -c gflows -f -n "__fish_seen_subcommand_from release; and not __fish_seen_subcommand_from up" \\
-  -a "up"
+# release up [patch|minor|major] | current
+complete -c gflows -f -n "__fish_seen_subcommand_from release; and not __fish_seen_subcommand_from up current" \\
+  -a "up" -d "Bump then release"
+complete -c gflows -f -n "__fish_seen_subcommand_from release; and not __fish_seen_subcommand_from up current" \\
+  -a "current" -d "Keep current version (no bump)"
 complete -c gflows -f -n "__fish_seen_subcommand_from release; and __fish_seen_subcommand_from up" \\
   -a "patch minor major"
 

package/src/commands/help.ts

@@ -19,7 +19,7 @@ Commands:
   init, -I       Ensure main, create dev (TTY: wizard; optional package.json script alias)
   start, -S      Create workflow branch (TTY: prompts if args missing)
   finish, -F     Merge and close branch (plan + delete by default)
-  release        Quick release from dev (bump + merge main + tag)
+  release        Quick release from dev (bump or keep version + merge main + tag)
   sync           Update current branch from its base
   pr             Open PR/MR via gh or glab (correct base)
   switch, -W     Switch branch (picker or name)
@@ -62,7 +62,7 @@ Init:   --script-alias <name>  Add package.json script (e.g. g → "gflows")
 Start:  --force         Allow dirty working tree
 Finish: --no-ff         Always create merge commit; -D/--delete, -N/--no-delete;
         --squash, --preview, --bump; -s/--sign, -T/--no-tag, -M/--tag-message, -m/--message
-Release: up <patch|minor|major>  (from dev only); -y -p|-P; --preview; -s/--sign
+Release: up <patch|minor|major> | current  (from dev only); -y -p|-P; --preview; -s/--sign
 Sync:   --rebase, --force
 List:   -r, --include-remote   Include remote-tracking branches
 Switch: --move | --restore | --clean | --destroy | --cancel

package/src/commands/mcp.ts

@@ -96,19 +96,22 @@ const TOOLS = [
   {
     name: "gflows_release",
     description:
-      "Quick release from dev: bump package version, merge into main, tag, sync main→dev. Requires bumpType.",
+      "Quick release from dev: optional bump (or keep current version), merge into main, tag, sync main→dev. Pass bumpType or keepCurrent.",
     inputSchema: {
       type: "object",
       properties: {
         path: { type: "string" },
         bumpType: {
           type: "string",
-          description: "Semver segment to bump: patch, minor, or major",
+          description: "Semver segment to bump: patch, minor, or major (omit when keepCurrent)",
+        },
+        keepCurrent: {
+          type: "boolean",
+          description: "Tag the package version already on disk (no bump commit)",
         },
         push: { type: "boolean" },
         preview: { type: "boolean" },
       },
-      required: ["bumpType"],
     },
   },
   {
@@ -178,8 +181,13 @@ async function runTool(
       else argv.push("-P");
       break;
     case "gflows_release": {
-      const bumpType = String(args.bumpType ?? "patch");
-      argv.push("release", "up", bumpType);
+      if (args.keepCurrent === true) {
+        argv.push("release", "current");
+      } else if (typeof args.bumpType === "string" && args.bumpType.trim() !== "") {
+        argv.push("release", "up", args.bumpType.trim());
+      } else {
+        throw new Error("gflows_release: pass bumpType (patch|minor|major) or keepCurrent: true");
+      }
       if (args.preview) argv.push("--preview");
       if (args.push) argv.push("-p");
       else argv.push("-P");

package/src/commands/release.ts

@@ -1,5 +1,5 @@
 /**
- * Quick release from the long-lived `dev` branch: bump, merge into main, tag, sync main→dev.
+ * Quick release from the long-lived `dev` branch: bump (or keep), merge into main, tag, sync main→dev.
  * @module commands/release
  */
 
@@ -21,9 +21,18 @@ import {
 import { hint, success } from "../out.js";
 import { PACKAGE_JSON } from "../packages.js";
 import type { BumpType, ParsedArgs } from "../types.js";
-import { applyVersionToPackages, computeBump, JSR_JSON } from "../version-bump.js";
+import {
+  applyVersionToPackages,
+  computeBump,
+  JSR_JSON,
+  readPackageVersion,
+  sortedPackageRoots,
+} from "../version-bump.js";
 import { type FinishContext, runFinishPlan } from "./finish.js";
 
+/** Interactive choice: keep package version as-is, or bump a semver segment. */
+type ReleaseVersionChoice = "current" | BumpType;
+
 /**
  * Runs quick release: only valid when HEAD is the configured `dev` branch.
  */
@@ -66,24 +75,30 @@ export async function run(args: ParsedArgs): Promise<void> {
     );
   }
 
+  let keepCurrent = args.keepCurrent === true;
   let bumpType: BumpType | undefined = args.bumpType;
+
   if (args.bumpDirection === "down") {
     console.error(
-      "gflows release: only 'up' is supported (not 'down'). Example: gflows release up patch",
+      "gflows release: only 'up' or 'current' is supported (not 'down'). Example: gflows release up patch",
     );
     process.exit(EXIT_USER);
   }
   if (args.bumpDirection && args.bumpDirection !== "up") {
     console.error(
-      "gflows release: expected 'up <patch|minor|major>'. Example: gflows release up patch",
+      "gflows release: expected 'up <patch|minor|major>' or 'current'. Example: gflows release up patch",
     );
     process.exit(EXIT_USER);
   }
+  if (keepCurrent && (args.bumpDirection || bumpType)) {
+    console.error("gflows release: use either 'current' or 'up <patch|minor|major>', not both.");
+    process.exit(EXIT_USER);
+  }
 
-  if (!bumpType) {
+  if (!keepCurrent && !bumpType) {
     if (!isTTY) {
       console.error(
-        "gflows release: when not in a TTY, bump type is required. Example: gflows release up patch -y -P",
+        "gflows release: when not in a TTY, specify version mode. Examples: gflows release current -y -P  or  gflows release up patch -y -P",
       );
       process.exit(EXIT_USER);
     }
@@ -96,14 +111,32 @@ export async function run(args: ParsedArgs): Promise<void> {
       }
     })();
     const currentVer = computedPreview?.oldVersion ?? "?";
-    bumpType = await selectPrompt<"patch" | "minor" | "major">({
-      message: `Bump version (current ${currentVer})`,
-      options: [
-        { label: "patch (x.y.Z)", value: "patch" },
-        { label: "minor (x.Y.0)", value: "minor" },
-        { label: "major (X.0.0)", value: "major" },
-      ],
-    });
+    // `release up` already chose bumping — only ask which segment.
+    if (args.bumpDirection === "up") {
+      bumpType = await selectPrompt<BumpType>({
+        message: `Bump version (current ${currentVer})`,
+        options: [
+          { label: "patch (x.y.Z)", value: "patch" },
+          { label: "minor (x.Y.0)", value: "minor" },
+          { label: "major (X.0.0)", value: "major" },
+        ],
+      });
+    } else {
+      const choice = await selectPrompt<ReleaseVersionChoice>({
+        message: `Version for release (current ${currentVer})`,
+        options: [
+          { label: `keep current (${currentVer})`, value: "current" },
+          { label: "bump patch (x.y.Z)", value: "patch" },
+          { label: "bump minor (x.Y.0)", value: "minor" },
+          { label: "bump major (X.0.0)", value: "major" },
+        ],
+      });
+      if (choice === "current") {
+        keepCurrent = true;
+      } else {
+        bumpType = choice;
+      }
+    }
   }
 
   let doPush = false;
@@ -123,18 +156,56 @@ export async function run(args: ParsedArgs): Promise<void> {
     doPush = false;
   }
 
-  const { oldVersion, newVersion, roots } = computeBump(repoRoot, "up", bumpType);
+  let oldVersion: string;
+  let newVersion: string;
+  let roots: string[];
+
+  if (keepCurrent) {
+    roots = sortedPackageRoots(repoRoot);
+    if (roots.length === 0) {
+      console.error(
+        `gflows release: no package.json found under ${repoRoot}. Run from project root or use -C <dir>.`,
+      );
+      process.exit(EXIT_USER);
+    }
+    const primaryRoot = roots[0];
+    if (primaryRoot === undefined) {
+      console.error(
+        `gflows release: no package.json found under ${repoRoot}. Run from project root or use -C <dir>.`,
+      );
+      process.exit(EXIT_USER);
+    }
+    oldVersion = readPackageVersion(primaryRoot).raw;
+    newVersion = oldVersion;
+  } else {
+    if (!bumpType) {
+      console.error(
+        "gflows release: expected 'up <patch|minor|major>' or 'current'. Example: gflows release up patch",
+      );
+      process.exit(EXIT_USER);
+    }
+    ({ oldVersion, newVersion, roots } = computeBump(repoRoot, "up", bumpType));
+  }
+
   const tagName = normalizeTagVersion(newVersion);
 
   if (await tagExists(repoRoot, tagName, opts)) {
     console.error(`gflows release: tag '${tagName}' already exists.`);
-    hint("Use a different bump (minor/major), or delete the tag if you intend to recreate it.");
+    hint(
+      keepCurrent
+        ? "Bump the version first, or delete the tag if you intend to recreate it."
+        : "Use a different bump (minor/major), or delete the tag if you intend to recreate it.",
+    );
     process.exit(2);
   }
 
   console.error("gflows release plan:");
   console.error(`  from:    ${config.dev}`);
-  console.error(`  bump:    ${oldVersion} → ${newVersion}`);
+  if (keepCurrent) {
+    console.error(`  version: ${newVersion} (keep current, no bump)`);
+  } else {
+    console.error(`  bump:    ${oldVersion} → ${newVersion}`);
+  }
   console.error(`  merge:   → ${config.main}, then ${config.main} → ${config.dev}`);
   console.error(`  tag:     ${tagName}`);
   console.error(`  push:    ${doPush ? "yes" : "no"}`);
@@ -159,7 +230,7 @@ export async function run(args: ParsedArgs): Promise<void> {
     process.exit(EXIT_USER);
   }
 
-  if (!opts.dryRun) {
+  if (!keepCurrent && !opts.dryRun) {
     applyVersionToPackages(repoRoot, roots, newVersion);
     for (const dir of roots) {
       await runGit(["add", "--", join(dir, PACKAGE_JSON)], {

package/src/commands/schema.ts

@@ -57,7 +57,7 @@ export async function run(_args: ParsedArgs): Promise<void> {
         "-m/--message",
       ],
       release: [
-        "up patch|minor|major",
+        "up patch|minor|major | current",
         "-y",
         "-p/--push",
         "-P/--no-push",
@@ -74,7 +74,7 @@ export async function run(_args: ParsedArgs): Promise<void> {
     agentNotes: [
       "Always pass explicit flags in non-TTY (never assume interactive hub).",
       "Prefer -y to accept finish plan (delete defaults on); pass -P or -p for push.",
-      "Quick release from dev: gflows release up patch -y -p (or -P).",
+      "Quick release from dev: gflows release up patch -y -p (or -P); or gflows release current -y -p after a manual bump.",
       "On conflict: gflows continue | gflows abort | gflows undo.",
       "Use gflows schema and AGENTS.md as source of truth.",
     ],
@@ -87,7 +87,10 @@ function commandMeta(command: string): { summary: string; interactiveOk: boolean
     init: { summary: "Ensure main; create dev", interactiveOk: true },
     start: { summary: "Create workflow branch", interactiveOk: true },
     finish: { summary: "Merge and close workflow branch", interactiveOk: true },
-    release: { summary: "Quick release from dev (bump, merge main, tag)", interactiveOk: true },
+    release: {
+      summary: "Quick release from dev (bump or keep version, merge main, tag)",
+      interactiveOk: true,
+    },
     switch: { summary: "Switch workflow branch", interactiveOk: true },
     delete: { summary: "Delete local workflow branches", interactiveOk: true },
     list: { summary: "List workflow branches", interactiveOk: false },

package/src/interactive.ts

@@ -127,16 +127,21 @@ async function runHubAction(cwd: string, action: string): Promise<void> {
     return;
   }
   if (action === "release") {
-    const bumpType = await selectPrompt<"patch" | "minor" | "major">({
-      message: "Bump version",
+    const choice = await selectPrompt<"current" | "patch" | "minor" | "major">({
+      message: "Version for release",
       options: [
-        { label: "patch (x.y.Z)", value: "patch" },
-        { label: "minor (x.Y.0)", value: "minor" },
-        { label: "major (X.0.0)", value: "major" },
+        { label: "keep current", value: "current" },
+        { label: "bump patch (x.y.Z)", value: "patch" },
+        { label: "bump minor (x.Y.0)", value: "minor" },
+        { label: "bump major (X.0.0)", value: "major" },
       ],
     });
     const push = await confirmPrompt({ message: "Push after release?", initialValue: false });
-    await dispatch(cwd, ["release", "up", bumpType, "-y", push ? "-p" : "-P"]);
+    const releaseArgv =
+      choice === "current"
+        ? (["release", "current", "-y", push ? "-p" : "-P"] as string[])
+        : (["release", "up", choice, "-y", push ? "-p" : "-P"] as string[]);
+    await dispatch(cwd, releaseArgv);
     return;
   }
   if (action === "sync") {

package/src/parse.ts

@@ -236,7 +236,9 @@ function resolveName(
   }
   if (command === "bump" || command === "release") {
     const dir = positionals[skip];
-    if (dir === "up" || dir === "down") return dir;
+    if (dir === "up" || dir === "down" || (command === "release" && dir === "current")) {
+      return dir;
+    }
     return undefined;
   }
   if (command === "switch" || command === "pr" || command === "sync") {
@@ -248,11 +250,15 @@ function resolveName(
 function resolveBump(positionals: string[]): {
   direction?: "up" | "down";
   type?: "patch" | "minor" | "major";
+  keepCurrent?: boolean;
 } {
   // Skip leading command when present; with -U, positionals start at up/down
   const skip = positionals[0] === "bump" || positionals[0] === "release" ? 1 : 0;
   const a = positionals[skip];
   const b = positionals[skip + 1];
+  if (positionals[0] === "release" && a === "current") {
+    return { keepCurrent: true };
+  }
   const direction = a === "up" || a === "down" ? a : undefined;
   const type = b === "patch" || b === "minor" || b === "major" ? b : undefined;
   return { direction, type };
@@ -297,6 +303,7 @@ function emptyArgs(cwd: string, pathStr: string | undefined): ParsedArgs {
     squash: false,
     preview: false,
     bumpOnFinish: false,
+    keepCurrent: false,
     includeRemote: false,
     json: false,
     rebase: false,
@@ -336,10 +343,13 @@ export function parse(
 
   const type = resolveType(command, positionals, v);
   const name = resolveName(command, positionals, v);
-  const { direction: bumpDirection, type: bumpType } =
+  const bumpResolved =
     command === "bump" || command === "release"
       ? resolveBump(positionals)
-      : { direction: undefined, type: undefined };
+      : { direction: undefined, type: undefined, keepCurrent: undefined };
+  const bumpDirection = bumpResolved.direction;
+  const bumpType = bumpResolved.type;
+  const keepCurrent = bumpResolved.keepCurrent === true;
   const configArgs = command === "config" ? resolveConfigArgs(positionals) : {};
 
   const branchNames =
@@ -395,6 +405,7 @@ export function parse(
     branchNames,
     bumpDirection,
     bumpType,
+    keepCurrent,
     configAction: configArgs.action,
     configKey: configArgs.key,
     configValue: configArgs.value,

package/src/tui/flows.tsx

@@ -135,21 +135,22 @@ export function ReleaseFlow({
   onCancel: () => void;
 }): React.ReactElement {
   const [step, setStep] = useState<"type" | "push">("type");
-  const [bumpType, setBumpType] = useState<"patch" | "minor" | "major">("patch");
+  const [choice, setChoice] = useState<"current" | "patch" | "minor" | "major">("current");
 
   if (step === "type") {
     return (
       <WizardFrame title="Quick release from dev">
-        <InkSelect<"patch" | "minor" | "major">
-          message="Bump version"
+        <InkSelect<"current" | "patch" | "minor" | "major">
+          message="Version for release"
           options={[
-            { value: "patch", label: "patch (x.y.Z)" },
-            { value: "minor", label: "minor (x.Y.0)" },
-            { value: "major", label: "major (X.0.0)" },
+            { value: "current", label: "keep current" },
+            { value: "patch", label: "bump patch (x.y.Z)" },
+            { value: "minor", label: "bump minor (x.Y.0)" },
+            { value: "major", label: "bump major (X.0.0)" },
           ]}
           onCancel={onCancel}
           onSubmit={(t) => {
-            setBumpType(t);
+            setChoice(t);
             setStep("push");
           }}
         />
@@ -157,14 +158,20 @@ export function ReleaseFlow({
     );
   }
 
+  const title = choice === "current" ? "Release · keep current" : `Release · up ${choice}`;
+
   return (
-    <WizardFrame title={`Release · up ${bumpType}`}>
+    <WizardFrame title={title}>
       <InkConfirm
         message="Push after release?"
         initialValue={false}
         onCancel={onCancel}
         onSubmit={(push) => {
-          onDone(["release", "up", bumpType, "-y", push ? "-p" : "-P"]);
+          onDone(
+            choice === "current"
+              ? ["release", "current", "-y", push ? "-p" : "-P"]
+              : ["release", "up", choice, "-y", push ? "-p" : "-P"],
+          );
         }}
       />
     </WizardFrame>

package/src/types.ts

@@ -134,6 +134,11 @@ export interface ParsedArgs {
   bumpDirection?: BumpDirection;
   /** Bump type (patch | minor | major). */
   bumpType?: BumpType;
+  /**
+   * Quick release: tag the package version already on disk (no bump commit).
+   * From `gflows release current`.
+   */
+  keepCurrent?: boolean;
   /** Config get/set action. */
   configAction?: ConfigAction;
   /** Config key (main, dev, remote, or prefixes.<type>). */