chore: release flowsh-cli 0.2.2

Author: Tom Brandenburg

AGENTS.md

@@ -1,6 +1,6 @@
 # AGENTS.md
 
-This repository has been intentionally reduced to `scripts/workflow_to_harness.py`.
+This repository has been intentionally reduced to the Python CLI blueprint.
 
 ## Scope
 
@@ -14,3 +14,8 @@ This repository has been intentionally reduced to `scripts/workflow_to_harness.p
 - Use `make qa` after code changes.
 - Keep tests focused on the current blueprint behavior.
 - Prefer deletion over compatibility layers when reducing legacy project remnants.
+
+## Publishing
+
+- Published on PyPI as `flowsh-cli`. Run with `uvx flowsh-cli` (no install needed).
+- Bump: `make bump-patch` (or `bump-minor`/`bump-major`) — runs qa then publishes.

Makefile

@@ -1,29 +1,38 @@
-.PHONY: help install publish lint test build qa clean hygiene
+.PHONY: help install publish lint test build qa clean hygiene bump-patch bump-minor bump-major
 
 help:
 	@printf '%s\n' \
-		'flowsh - minimal workflow-to-harness generator' \
+		'flowsh-cli - minimal workflow-to-harness generator' \
 		'' \
 		'Commands:' \
-		'  make install  Install flowsh into the user PATH with uv tool' \
-		'  make lint     Run Ruff and compile-check Python files' \
-		'  make test     Run tests' \
-		'  make build    Build source and wheel distributions' \
-		'  make publish  Build and publish to PyPI' \
-		'  make qa       Run lint, tests, and package build' \
-		'  make clean    Remove local test/build artifacts' \
-		'  make hygiene  Show tracked, untracked, and ignored files'
+		'  make install   Install flowsh-cli into the user PATH with uv tool' \
+		'  make lint      Run Ruff and compile-check Python files' \
+		'  make test      Run tests' \
+		'  make build     Build source and wheel distributions' \
+		'  make publish   Build and publish to PyPI' \
+		'  make qa        Run lint, tests, and package build' \
+		'  make clean     Remove local test/build artifacts' \
+		'  make hygiene   Show tracked, untracked, and ignored files' \
+		'  make bump-patch|minor|major  Bump version in pyproject.toml, build, publish'
 
 install:
 	uv tool install --force .
 
 publish:
+	rm -rf dist
 	uv build && uv publish
 
+bump-patch bump-minor bump-major:
+	$(eval PART := $(@:bump-%=%))
+	python3 scripts/bump_version.py $(PART)
+	uv lock
+	$(MAKE) qa
+	$(MAKE) publish
+
 lint:
 	uv run --locked ruff check .
 	uv run --locked ruff format --check .
-	uv run --locked python -m py_compile src/flowsh_cli/*.py scripts/workflow_to_harness.py tests/test_workflow_to_harness.py
+	uv run --locked python -m py_compile src/flowsh_cli/*.py scripts/*.py tests/test_workflow_to_harness.py
 
 test:
 	uv run --locked pytest
@@ -38,4 +47,4 @@ hygiene:
 	git status --short --ignored
 
 clean:
-	rm -rf .pytest_cache .ruff_cache .harness .flowsh src/flowsh/__pycache__ scripts/__pycache__ tests/__pycache__ dist build
+	rm -rf .pytest_cache .ruff_cache .harness .flowsh src/flowsh_cli/__pycache__ scripts/__pycache__ tests/__pycache__ dist build

README.md

@@ -1,12 +1,6 @@
-# flowsh
+# flowsh-cli
 
-`flowsh` is a small `uv` Python CLI deliberately reduced to one tool:
-
-```bash
-uv run flowsh .made/workflows.yml
-```
-
-It reads MADE workflow YAML and writes executable Bash harness scripts for OpenCode.
+`flowsh-cli` is a small `uv` Python CLI that reads workflow YAML and writes executable Bash harness scripts for OpenCode.
 
 ## Supported YAML
 
@@ -42,29 +36,31 @@ Harness paths are derived from workflow ids. `wf_example` writes `.harness/examp
 
 ```bash
 # Generate every workflow harness
-uv run flowsh .made/workflows.yml
+uvx flowsh-cli .made/workflows.yml
 
 # Generate one workflow by id
-uv run flowsh .made/workflows.yml --workflow wf_example
+uvx flowsh-cli .made/workflows.yml --workflow wf_example
 
 # Show planned outputs without writing files
-uv run flowsh .made/workflows.yml --dry-run
+uvx flowsh-cli .made/workflows.yml --dry-run
 
 # Overwrite existing harness files
-uv run flowsh .made/workflows.yml --force
+uvx flowsh-cli .made/workflows.yml --force
 
 # Show version
-uv run flowsh --version
+uvx flowsh-cli --version
 ```
 
+You can also run it via `uv run flowsh-cli` if installed locally.
+
 ## CLI Contract
 
-`flowsh` is non-interactive. It never prompts for missing information.
+`flowsh-cli` is non-interactive. It never prompts for missing information.
 
 Current help output is plain text and deterministic across repeated runs:
 
 ```text
-Usage: flowsh [OPTIONS] WORKFLOW_YAML
+Usage: flowsh-cli [OPTIONS] WORKFLOW_YAML
 
   Generate reproducible OpenCode Bash harness scripts from MADE workflow YAML.
 
@@ -75,7 +71,7 @@ Options:
   --workflow TEXT  Optional workflow id to generate. Defaults to all workflows.
   --dry-run        Print planned output paths without writing scripts.
   --force          Overwrite existing files. Without this, existing files cause a failure.
-  --version        Show the flowsh version and exit.
+  --version        Show the flowsh-cli version and exit.
   --help           Show this message and exit.
 ```
 
@@ -87,7 +83,7 @@ Exit codes:
 | Case | Exit | stdout | stderr |
 |---|---:|---|---|
 | `--help` | `0` | Help text | Empty |
-| `--version` | `0` | `flowsh <version>` | Empty |
+| `--version` | `0` | `flowsh-cli <version>` | Empty |
 | Valid generation | `0` | One `Wrote <path>` line per harness | Empty |
 | Valid `--dry-run` | `0` | One `DRY-RUN would write <path>` line per selected workflow | Empty |
 | Missing required CLI argument | `2` | Empty | Typer usage error |
@@ -113,11 +109,11 @@ make hygiene
 make clean
 ```
 
-`make install` installs `flowsh` into the user PATH with `uv tool install --force .`.
+`make install` installs `flowsh-cli` into the user PATH with `uv tool install --force .`.
 `make build` creates reproducible source and wheel distributions under ignored `dist/`.
 
 `make qa` runs Ruff, Python compile checks, and pytest with locked dependencies, then builds packages locally and in CI.
-The pytest suite also verifies `python -m flowsh`, `uv run flowsh`, and the direct
+The pytest suite also verifies `python -m flowsh_cli`, `uvx flowsh-cli`, and the direct
 `scripts/workflow_to_harness.py` entrypoint against the same help contract.
 `make hygiene` prints tracked, untracked, and ignored files with
 `git status --short --ignored`; review it before release to confirm only intended

pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "uv_build"
 
 [project]
 name = "flowsh-cli"
-version = "0.1.0"
-description = "Generate Bash harness scripts from MADE workflow YAML files."
+version = "0.2.2"
+description = "Generate Bash harness scripts from workflow YAML files."
 readme = "README.md"
 requires-python = ">=3.11"
 license = "MIT"
@@ -25,7 +25,7 @@ Homepage = "https://github.com/tbrandenburg/flowsh"
 Source = "https://github.com/tbrandenburg/flowsh"
 
 [project.scripts]
-flowsh = "flowsh_cli.cli:main"
+flowsh-cli = "flowsh_cli.cli:main"
 
 [dependency-groups]
 dev = [

scripts/bump_version.py

@@ -0,0 +1,43 @@
+#!/usr/bin/env python3
+import re
+import sys
+from pathlib import Path
+
+USAGE = "usage: bump_version.py patch|minor|major"
+PYPROJECT = Path("pyproject.toml")
+INIT = Path("src/flowsh_cli/__init__.py")
+
+
+def main() -> int:
+    if len(sys.argv) != 2 or sys.argv[1] not in {"patch", "minor", "major"}:
+        sys.exit(USAGE)
+
+    pyproject = PYPROJECT.read_text(encoding="utf-8")
+    match = re.search(r'^version = "(.+?)"', pyproject, re.M)
+    if match is None:
+        sys.exit("version not found in pyproject.toml")
+
+    parts = [int(part) for part in match.group(1).split(".")]
+    index = {"major": 0, "minor": 1, "patch": 2}[sys.argv[1]]
+    parts[index] += 1
+    for reset_index in range(index + 1, 3):
+        parts[reset_index] = 0
+    version = ".".join(str(part) for part in parts)
+
+    PYPROJECT.write_text(
+        re.sub(r'^version = ".*?"', f'version = "{version}"', pyproject, count=1, flags=re.M),
+        encoding="utf-8",
+    )
+
+    init = INIT.read_text(encoding="utf-8")
+    INIT.write_text(
+        re.sub(r'^__version__ = ".*?"', f'__version__ = "{version}"', init, count=1, flags=re.M),
+        encoding="utf-8",
+    )
+
+    print(f"Bumped to {version}")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

src/flowsh_cli/__init__.py

@@ -1,9 +1,9 @@
-"""flowsh: generate OpenCode Bash harness scripts from workflow YAML."""
+"""flowsh-cli: generate OpenCode Bash harness scripts from workflow YAML."""
 
 from flowsh_cli.models import Workflow, WorkflowParseError, parse_workflows
 from flowsh_cli.render import harness_path, render_harness
 
-__version__ = "0.1.0"
+__version__ = "0.2.2"
 
 __all__ = [
     "Workflow",

src/flowsh_cli/cli.py

@@ -25,7 +25,7 @@
 
 def main(argv: Sequence[str] | None = None) -> int:
     try:
-        app(args=list(argv) if argv is not None else None, prog_name="flowsh")
+        app(args=list(argv) if argv is not None else None, prog_name="flowsh-cli")
     except SystemExit as error:
         return error.code if isinstance(error.code, int) else 1
 
@@ -58,7 +58,7 @@ def generate(
         typer.Option(
             "--version",
             callback=lambda value: print_version(value),
-            help="Show the flowsh version and exit.",
+            help="Show the flowsh-cli version and exit.",
             is_eager=True,
         ),
     ] = False,
@@ -95,7 +95,7 @@ def print_version(value: bool) -> None:
     if not value:
         return
 
-    print(f"flowsh {__version__}")
+    print(f"flowsh-cli {__version__}")
     raise typer.Exit
 
 

tests/test_workflow_to_harness.py

@@ -12,7 +12,7 @@
 
 runner = CliRunner()
 
-EXPECTED_HELP = """Usage: flowsh [OPTIONS] WORKFLOW_YAML
+EXPECTED_HELP = """Usage: flowsh-cli [OPTIONS] WORKFLOW_YAML
 
   Generate reproducible OpenCode Bash harness scripts from MADE workflow YAML.
 
@@ -23,7 +23,7 @@
   --workflow TEXT  Optional workflow id to generate. Defaults to all workflows.
   --dry-run        Print planned output paths without writing scripts.
   --force          Overwrite existing files. Without this, existing files cause a failure.
-  --version        Show the flowsh version and exit.
+  --version        Show the flowsh-cli version and exit.
   --help           Show this message and exit.
 """
 
@@ -393,7 +393,7 @@ def test_cli_exposes_version_without_workflow_argument() -> None:
     result = runner.invoke(app, ["--version"])
 
     assert result.exit_code == 0, result.output
-    assert result.output.strip().startswith("flowsh ")
+    assert result.output.strip().startswith("flowsh-cli ")
 
 
 def test_cli_reports_missing_required_workflow_argument() -> None:
@@ -848,15 +848,15 @@ def test_cli_help_is_deterministic_across_repeated_runs() -> None:
 
 def test_uv_console_entrypoint_help_matches_contract() -> None:
     result = subprocess.run(
-        ["uv", "run", "flowsh", "--help"],
+        ["uv", "run", "flowsh-cli", "--help"],
         check=False,
         capture_output=True,
         text=True,
         env={**os.environ, "COLUMNS": "200"},
     )
 
     assert result.returncode == 0, result.stderr
-    assert "Usage: flowsh [OPTIONS] WORKFLOW_YAML" in result.stdout
+    assert "Usage: flowsh-cli [OPTIONS] WORKFLOW_YAML" in result.stdout
     assert "Path to .made/workflows.yml" in result.stdout
     assert "--dry-run" in result.stdout
     assert "--force" in result.stdout