feat: use Typer for flowsh CLI

Author: Tom Brandenburg

.gitignore

@@ -16,4 +16,5 @@ venv/
 .env.*
 
 .harness/
+.flowsh/
 dev/

Makefile

@@ -5,17 +5,19 @@ help:
 		'flowsh - minimal workflow-to-harness generator' \
 		'' \
 		'Commands:' \
-		'  make install  Create/update the uv environment' \
-		'  make lint     Compile-check Python files' \
+		'  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 qa       Run lint and tests' \
 		'  make clean    Remove local test/build artifacts'
 
 install:
-	uv sync
+	uv tool install --force .
 
 lint:
-	uv run python -m py_compile scripts/workflow_to_harness.py tests/test_workflow_to_harness.py
+	uv run ruff check .
+	uv run ruff format --check .
+	uv run python -m py_compile src/flowsh/*.py scripts/workflow_to_harness.py tests/test_workflow_to_harness.py
 
 test:
 	uv run pytest
@@ -24,4 +26,4 @@ qa: lint test
 	@printf '%s\n' 'QA passed'
 
 clean:
-	rm -rf .pytest_cache .harness scripts/__pycache__ tests/__pycache__ dist build
+	rm -rf .pytest_cache .ruff_cache .harness .flowsh src/flowsh/__pycache__ scripts/__pycache__ tests/__pycache__ dist build

README.md

@@ -1,9 +1,9 @@
 # flowsh
 
-`flowsh` is now deliberately reduced to one tool:
+`flowsh` is a small `uv` Python CLI deliberately reduced to one tool:
 
 ```bash
-uv run flowsh .made/workflows.yml --output-root .
+uv run flowsh .made/workflows.yml
 ```
 
 It reads MADE workflow YAML and writes executable Bash harness scripts for OpenCode.
@@ -16,9 +16,6 @@ Only this top-level shape is supported:
 workflows:
   - id: wf_example
     name: Example
-    enabled: true
-    schedule: manual
-    shellScriptPath: .harness/example.sh
     steps:
       - type: vars
         name: Capture date
@@ -37,30 +34,34 @@ workflows:
 
 Supported step types are only `vars`, `bash`, and `agent`.
 
+Harness paths are derived from workflow ids. `wf_example` writes `.harness/example.sh`.
+
 ## Commands
 
 ```bash
 # Generate every workflow harness
-uv run flowsh .made/workflows.yml --output-root .
+uv run flowsh .made/workflows.yml
 
-# Generate one workflow by id or name
+# Generate one workflow by id
 uv run flowsh .made/workflows.yml --workflow wf_example
 
 # Show planned outputs without writing files
 uv run flowsh .made/workflows.yml --dry-run
 
 # Overwrite existing harness files
 uv run flowsh .made/workflows.yml --force
-
-# Print JSON Schema for the supported workflow file
-uv run flowsh .made/workflows.yml --print-schema
 ```
 
+Generated harness logs go to `.flowsh/logs` by default. Set `FLOWSH_LOG_DIR` when running a harness to use another local log directory.
+
 ## Development
 
 ```bash
+uv sync
 make install
 make qa
 ```
 
-`make qa` only validates the Python blueprint and its tests. There is no TypeScript compiler, template system, DSL explorer, or legacy node registry.
+`make install` installs `flowsh` into the user PATH with `uv tool install --force .`.
+
+`make qa` runs Ruff, Python compile checks, and pytest. There is no TypeScript compiler, template system, DSL explorer, or legacy node registry.

pyproject.toml

@@ -1,6 +1,6 @@
 [build-system]
-requires = ["hatchling>=1.27"]
-build-backend = "hatchling.build"
+requires = ["uv_build>=0.9.9,<0.10.0"]
+build-backend = "uv_build"
 
 [project]
 name = "flowsh"
@@ -11,18 +11,24 @@ requires-python = ">=3.11"
 dependencies = [
   "PyYAML>=6,<7",
   "pydantic>=2,<3",
+  "typer>=0.20,<0.21",
 ]
 
 [project.scripts]
-flowsh = "scripts.workflow_to_harness:main"
+flowsh = "flowsh.cli:main"
 
 [dependency-groups]
 dev = [
   "pytest>=8,<9",
+  "ruff>=0.14,<0.15",
 ]
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
 
-[tool.hatch.build.targets.wheel]
-packages = ["scripts"]
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]