Metadata-Version: 2.4
Name: lx-tooling
Version: 0.1.0
Summary: Labinetix workflow CLI for humans and AI agents
Project-URL: Homepage, https://github.com/labinetix/lx-tooling
Project-URL: Repository, https://github.com/labinetix/lx-tooling
Project-URL: Documentation, https://github.com/labinetix/lx-tooling/blob/main/docs/design/lx-tooling.md
Author-email: Fabian Müller <fabianmueller100295@gmail.com>
License: MIT
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: typer>=0.26.8
Description-Content-Type: text/markdown

# lx-tooling

**Tag:** Org and orchestration

**Labinetix workflow CLI** for humans and AI agents. `lx-tooling` orchestrates GitHub issues, branches, pull requests, releases, local verification, and repository policy checks without owning domain logic.

**Non-goals:** model semantics, ABI schema ownership, runtime algorithms, or protocol implementations.

## Stability

Milestone 0 — read-only commands only. Branch creation, PR creation, tags, and releases come in later milestones.

## Quickstart

Prerequisites:

- Python 3.11+
- [`uv`](https://docs.astral.sh/uv/)
- [`gh`](https://cli.github.com/) for `lx issue view`

Local development:

```bash
git clone git@github.com:labinetix/lx-tooling.git
cd lx-tooling
uv sync --all-groups
uv run lx --version
```

Local checks (same as CI):

```bash
just check
```

Or explicitly:

```bash
uv sync --all-groups
uv run ruff check .
uv run ruff format --check .
uv run pytest
```

## Install

From PyPI after release:

```bash
uv tool install lx-tooling
lx --version
```

From a checkout:

```bash
uv sync --all-groups
uv run lx --help
```

## Commands (Milestone 0)

Inspect the current repository:

```bash
lx repo inspect
lx repo inspect --json
```

Run conservative pre-PR checks:

```bash
lx workflow check
```

Read a GitHub issue with Labinetix readiness hints:

```bash
gh auth login
lx issue view 123
```

See [`docs/examples/repo-inspect.md`](docs/examples/repo-inspect.md) for sample output.

## Design and Agent Rules

- Design: [`docs/design/lx-tooling.md`](docs/design/lx-tooling.md)
- Agent rules: [`AGENTS.md`](AGENTS.md)

## Releases and Artifacts

- Package name on PyPI: `lx-tooling`
- CLI command: `lx`
- Latest release: see [GitHub Releases](https://github.com/labinetix/lx-tooling/releases)
- Release artifacts: built by CI on protected SemVer tags (`v*`), published to PyPI via trusted publishing (`pypi.yml`, environment `pypi`)

Release checklist for maintainers:

1. Merge changes to `main`
2. Tag `v0.y.z` on `main`
3. CI builds wheel/sdist, creates GitHub Release, publishes to PyPI
