Metadata-Version: 2.4
Name: gateflow
Version: 0.1.0a4
Summary: Standalone GateFlow planning CLI
Project-URL: Homepage, https://github.com/0202alcc/gateflow
Project-URL: Documentation, https://github.com/0202alcc/gateflow
Keywords: planning,workflow,cli,gateflow
Requires-Python: <3.15,>=3.14
Description-Content-Type: text/markdown

# gateflow

Standalone GateFlow CLI package extracted from Luvatrix.

Current pre-release version: `0.1.0a4`.

## Install and Run

### `uvx` (current pre-release workflow)

```bash
UV_CACHE_DIR=./.uv-cache UV_TOOL_DIR=./gateflow/.uv-tools uvx --from ./gateflow gateflow --help
```

### Local editable install

```bash
cd gateflow
uv sync
uv run gateflow --help
```

### Future `pipx` path

After publishing pre-release distributions to an index, install with:

```bash
pipx install gateflow
gateflow --help
```

## Command Surface

The standalone CLI exposes the extracted command groups:

- `init`
- `config`
- `validate`
- `api`
- `render`
- `import-luvatrix`
- `backend`
- `connect`
- `sync`
- `close`
- `milestones`
- `tasks`
- `boards`
- `frameworks`
- `backlog`
- `closeout-refs`

`import-luvatrix` supports `--check` to emit deterministic drift output and non-zero exit when `.gateflow/*` diverges from `ops/planning/*`.

`init` now defaults new workspaces to `storage.mode=local-external` and records deterministic workspace connection metadata in `.gateflow/connection.json`.
