lx-tooling 0.1.0__tar.gz

lx_tooling-0.1.0/.github/pull_request_template.md

@@ -0,0 +1,27 @@
+## Summary
+
+-
+
+## Scope
+
+- In scope:
+- Out of scope:
+
+## Verification
+
+- [ ] Local checks:
+- [ ] CI:
+- [ ] Docs/examples:
+- [ ] Contract drift check:
+
+## Release Impact
+
+- Version impact:
+- Artifact impact:
+- Deploy impact:
+
+## Links
+
+- Issue:
+- ADR:
+- Related PRs:

lx_tooling-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,34 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          python-version: "3.11"
+
+      - name: Sync environment
+        run: uv sync --all-groups
+
+      - name: Ruff check
+        run: uv run ruff check .
+
+      - name: Ruff format (check only)
+        run: uv run ruff format --check .
+
+      - name: Pytest
+        run: uv run pytest

lx_tooling-0.1.0/.github/workflows/pypi.yml

@@ -0,0 +1,50 @@
+name: PyPI
+
+on:
+  push:
+    tags:
+      - "v[0-9]+.[0-9]+.[0-9]+"
+      - "v[0-9]+.[0-9]+.[0-9]+.*"
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/lx-tooling/
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          python-version: "3.11"
+
+      - name: Sync environment
+        run: uv sync --all-groups
+
+      - name: Build sdist and wheel
+        run: uv build
+
+      - name: Upload build artefacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist-${{ github.ref_name }}
+          path: dist/
+
+      - name: Create GitHub Release with assets
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

lx_tooling-0.1.0/.gitignore

@@ -0,0 +1,24 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.eggs/
+build/
+dist/
+.venv/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+
+# uv
+# uv.lock is committed; the environment is not.
+
+# MkDocs (local build; add when docs site lands)
+site/
+
+# Editor / OS
+.DS_Store
+.idea/
+.vscode/

lx_tooling-0.1.0/.labinetix/repo.toml

@@ -0,0 +1,14 @@
+[repo]
+name = "lx-tooling"
+type = "python-tool"
+release = true
+artifacts = true
+
+[workflow]
+local_check = "just check"
+docs_check = ""
+pr_base = "main"
+
+[github]
+ready_labels = ["status:ready-for-agent", "agent:allowed"]
+release_labels = ["release:patch", "release:minor", "release:major"]

lx_tooling-0.1.0/.python-version

@@ -0,0 +1 @@
+3.11

lx_tooling-0.1.0/AGENTS.md

@@ -0,0 +1,179 @@
+# lx-tooling Agent Guidelines
+
+This file defines repository-local guidance for humans and AI coding agents working on `lx-tooling`.
+
+Read these first:
+
+- [`../AGENTS.md`](../AGENTS.md) — company-wide Labinetix agent rules
+- [`../.VAULT/adr_and_concepts/everyday-development-workflow.md`](../.VAULT/adr_and_concepts/everyday-development-workflow.md) — everyday development workflow
+- [`../.VAULT/adr_and_concepts/gh-workflows.md`](../.VAULT/adr_and_concepts/gh-workflows.md) — GitHub CI/CD workflow
+- [`../.VAULT/adr_and_concepts/programming-language-specific/python-codebase-agents.md`](../.VAULT/adr_and_concepts/programming-language-specific/python-codebase-agents.md) — Python repository manifesto
+- [`docs/design/lx-tooling.md`](docs/design/lx-tooling.md) — authoritative initial design for this repository
+
+## What This Repository Is
+
+`lx-tooling` is the Labinetix workflow CLI for humans and AI agents. It orchestrates issue start, workflow checks, pull request preparation, release planning, and repository policy checks.
+
+It should make the correct Labinetix workflow easy to follow by wrapping `git`, `gh`, repository metadata, templates, and local policy checks.
+
+## What This Repository Is Not
+
+`lx-tooling` does not own:
+
+- build implementation details, owned by `lx-toolchains`
+- deployment implementation details, owned by `lx-deploy`
+- hardware validation, owned by `lx-testbench`
+- contract schemas, owned by `lx-contracts`, `lx-interface`, or `lx-parser`
+- runtime behavior, owned by runtime repositories
+- GitHub repository administration as an accidental side effect
+
+Do not expand scope without updating `docs/design/lx-tooling.md` and adding an ADR or explicit design note.
+
+## Language and Tooling
+
+Start with **Python via `uv`**.
+
+- **PyPI distribution:** `lx-tooling`
+- **Import package:** `lx_tooling`
+- **CLI command:** `lx`
+- **Supported Python:** 3.11+
+
+Use `uv` for all Python environment, dependency, and run operations:
+
+```bash
+uv sync --all-groups
+uv add <package>
+uv add --dev <package>
+uv remove <package>
+uv run <command>
+uv build
+```
+
+Do not hand-edit dependency sections in `pyproject.toml` when `uv add` or `uv remove` can perform the change. It is acceptable to edit project metadata, CLI entry points, and tool configuration directly.
+
+Local checks (must match CI):
+
+```bash
+uv sync --all-groups
+uv run ruff check .
+uv run ruff format --check .
+uv run pytest
+```
+
+Equivalent shortcut:
+
+```bash
+just check
+```
+
+## Initial Implementation Direction
+
+Follow `docs/design/lx-tooling.md`.
+
+Milestone 0 should stay read-only and low risk:
+
+- Python project with `uv`
+- CLI entry point `lx`
+- `lx repo inspect`
+- `lx workflow check`
+- read-only `lx issue view <number>` wrapper around `gh issue view`
+- tests for policy checks
+- documentation for local development
+
+Do not add branch creation, PR creation, tag creation, release creation, or deployment triggers in the first milestone.
+
+## Architecture Rules
+
+- Keep pure policy checks separate from filesystem, subprocess, GitHub, and CLI I/O.
+- Wrap `git` and `gh` through small adapter modules.
+- Default risky workflows to dry-run or explanation.
+- Print actionable errors and missing prerequisites.
+- Keep command output deterministic where agents or CI may parse it.
+- Prefer clear policy checks over hidden automation.
+
+Suggested package shape:
+
+```text
+src/lx_tooling/
+├── cli.py
+├── git.py
+├── github.py
+├── policy.py
+├── repo.py
+├── templates.py
+└── checks/
+```
+
+## GitHub CLI Policy
+
+`lx-tooling` should use `gh` as the GitHub transport.
+
+Allowed early behavior:
+
+- read issues
+- read pull requests
+- inspect labels and checks
+- prepare summaries and PR bodies
+
+Risky behavior must wait for later milestones and explicit confirmation:
+
+- branch creation
+- PR creation
+- tag creation
+- release creation
+- label or milestone edits
+- workflow dispatch
+
+Never bypass GitHub branch protection, review requirements, status checks, or environment approvals.
+
+## Testing
+
+Use `pytest`.
+
+Prioritize:
+
+- unit tests for policy checks
+- tests for repository inspection
+- tests for branch-name and label rules
+- tests for command rendering and dry-run behavior
+- CLI smoke tests once the CLI framework is selected
+
+Normal PR tests must not require live GitHub calls. Mock `gh` output or use small fixture JSON files.
+
+## Documentation
+
+Update `docs/design/lx-tooling.md` when CLI semantics, milestones, or scope change.
+
+Add user-facing docs and examples as commands become real:
+
+- install and setup
+- authentication expectations for `gh`
+- command examples
+- dry-run examples
+- expected labels and repository metadata
+
+## Release Policy
+
+When `lx-tooling` becomes a package, publish installable artifacts to PyPI or a dedicated private PyPI-compatible registry through CI/CD.
+
+Release artifacts should be built by CI from protected refs, not by developer machines.
+
+## Agent Safety Rules
+
+Agents must not:
+
+- publish packages
+- create tags or releases
+- trigger deployment workflows
+- edit GitHub settings
+- store GitHub tokens
+- store device credentials
+- weaken policy checks to make a workflow pass
+
+Agents should:
+
+- keep work in small slices
+- update tests and docs with behavior changes
+- explain release impact
+- run local checks with `uv run` when practical
+- ask for explicit approval before any mutating GitHub workflow

lx_tooling-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Labinetix
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

lx_tooling-0.1.0/PKG-INFO

@@ -0,0 +1,115 @@
+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

lx_tooling-0.1.0/README.md

@@ -0,0 +1,101 @@
+# 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