brachio 0.0.0__tar.gz

brachio-0.0.0/.changenote/README.md

@@ -0,0 +1,10 @@
+# Change notes
+
+Package `brachio` uses `Cargo.toml` as its version source for crates.io and PyPI.
+
+Read [the change-note policy and commands](../docs/publishing.md#change-notes) before adding a note or preparing a release.
+Run `changenote status` after adding or changing notes.
+
+Keep pending notes in this directory.
+Do not create empty notes or edit generated release files by hand.
+`changenote version` consumes notes only during an authorized release.

brachio-0.0.0/.changenote/agent-grouping.md

@@ -0,0 +1,5 @@
+---
+brachio: minor
+---
+
+Add optional Agent, Status, CWD, and Session grouping while keeping None and the original sort as the default. Use g/G to cycle modes and Tab/Shift+Tab to jump between groups. Show foldable headers with filtered counts only for multiple groups; preserve selected IDs through folds and expand without navigation on Enter. Add incremental case-insensitive AND filtering with agent:/cwd:/session:/status: terms, Blocked/Error attention jumps, and scrollable help and diagnostics. Use compact content-measured Status/Agent/CWD/Session/Tab/Pane columns with two-cell gaps and fit-based visibility, display-only HOME abbreviation, status symbols, and a compact bounded footer. Keep selected Idle statuses visible and preserve whitespace-separated pasted filter terms. Keep reported status meanings and exact-ID navigation unchanged.

brachio-0.0.0/.changenote/config.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://raw.githubusercontent.com/narumiruna/changenote/f4423760122463bf03a8d161c6f0bc4173afb6e0/schema.json",
+  "base_branch": "origin/main",
+  "changed_file_patterns": [
+    "src/**",
+    "Cargo.toml",
+    "Cargo.lock",
+    "pyproject.toml",
+    "uv.lock",
+    ".github/workflows/publish.yml"
+  ],
+  "packages": {
+    "brachio": {
+      "path": ".",
+      "version_file": "Cargo.toml",
+      "tag_prefix": "v"
+    }
+  }
+}

brachio-0.0.0/.github/workflows/changenote.yml

@@ -0,0 +1,27 @@
+name: Change notes
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, labeled, unlabeled]
+
+permissions:
+  contents: read
+
+jobs:
+  notes:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+      - uses: dtolnay/rust-toolchain@b725eda525362e7cf34af9a7243cac1e3f01a7ec # stable
+      - name: Install changenote
+        run: cargo install --git https://github.com/narumiruna/changenote --rev f4423760122463bf03a8d161c6f0bc4173afb6e0 --locked
+      - name: Check PR notes
+        uses: narumiruna/changenote/check@f4423760122463bf03a8d161c6f0bc4173afb6e0
+        with:
+          since: refs/remotes/origin/${{ github.base_ref }}
+          coverage: package
+          skip-release: ${{ contains(github.event.pull_request.labels.*.name, 'skip-changenote') }}
+          reason: ${{ contains(github.event.pull_request.labels.*.name, 'skip-changenote') && 'Maintainer approved a note exemption; see the PR description.' || '' }}

brachio-0.0.0/.github/workflows/check.yml

@@ -0,0 +1,37 @@
+name: Checks
+on:
+  push:
+  pull_request:
+permissions:
+  contents: read
+jobs:
+  rust:
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+        with:
+          persist-credentials: false
+      - uses: dtolnay/rust-toolchain@b725eda525362e7cf34af9a7243cac1e3f01a7ec # stable
+        with:
+          components: rustfmt, clippy
+      - run: cargo fmt --all -- --check
+      - run: cargo clippy --locked --all-targets -- -D warnings
+      - run: cargo test --locked --all-targets
+      - run: cargo build --locked --release
+      - uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        with:
+          python-version: "3.12"
+          enable-cache: false
+      - run: uv lock --check
+      - name: Build Python source distribution and wheel
+        run: uv build
+      - name: Check installed wheel
+        shell: bash
+        run: |
+          expected=$(uv run --no-project python -c 'import tomllib; print(tomllib.load(open("Cargo.toml", "rb"))["package"]["version"])')
+          actual=$(uvx --isolated --no-index --find-links dist brachio --version)
+          test "$actual" = "brachio $expected"
+          uvx --isolated --no-index --find-links dist brachio --help

brachio-0.0.0/.github/workflows/publish.yml

@@ -0,0 +1,156 @@
+name: Publish
+
+on:
+  push:
+    tags: ["v*.*.*"]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: publish-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        with:
+          python-version: "3.12"
+          enable-cache: false
+      - name: Validate release tag and version
+        id: version
+        env:
+          RELEASE_REF_TYPE: ${{ github.ref_type }}
+          RELEASE_TAG: ${{ github.ref_name }}
+        run: |
+          uv run --no-project python - <<'PY'
+          import os
+          import re
+          import tomllib
+          from pathlib import Path
+
+          package = tomllib.loads(Path("Cargo.toml").read_text())["package"]
+          version = package["version"]
+          if not re.fullmatch(r"(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)", version):
+              raise SystemExit("Publication requires a stable SemVer version")
+          if os.environ["RELEASE_REF_TYPE"] != "tag" or os.environ["RELEASE_TAG"] != f"v{version}":
+              raise SystemExit("Publication requires a tag matching Cargo.toml: v" + version)
+          locked = [
+              entry for entry in tomllib.loads(Path("Cargo.lock").read_text())["package"]
+              if entry["name"] == "brachio" and "source" not in entry
+          ]
+          if len(locked) != 1 or locked[0]["version"] != version:
+              raise SystemExit("Cargo.lock must match Cargo.toml")
+          with open(os.environ["GITHUB_OUTPUT"], "a") as output:
+              output.write(f"version={version}\n")
+          PY
+      - uses: dtolnay/rust-toolchain@b725eda525362e7cf34af9a7243cac1e3f01a7ec # stable
+        with:
+          components: rustfmt, clippy
+      - run: uv lock --check
+      - run: cargo fmt --all -- --check
+      - run: cargo clippy --locked --all-targets -- -D warnings
+      - run: cargo test --locked --all-targets
+      - run: cargo build --locked --release
+      - run: cargo publish --locked --dry-run
+
+  wheels:
+    needs: validate
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+          - runner: ubuntu-24.04-arm
+            target: aarch64-unknown-linux-gnu
+          - runner: macos-15-intel
+            target: x86_64-apple-darwin
+          - runner: macos-14
+            target: aarch64-apple-darwin
+    runs-on: ${{ matrix.runner }}
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+        with:
+          persist-credentials: false
+      - uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        with:
+          python-version: "3.12"
+          enable-cache: false
+      - name: Build platform wheel
+        uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1.51.0
+        with:
+          maturin-version: v1.15.0
+          target: ${{ matrix.target }}
+          manylinux: 2_28
+          args: --release --locked --out dist --compatibility pypi
+      - name: Check installed wheel
+        shell: bash
+        env:
+          EXPECTED_VERSION: ${{ needs.validate.outputs.version }}
+        run: |
+          actual=$(uvx --isolated --no-index --find-links dist brachio --version)
+          test "$actual" = "brachio $EXPECTED_VERSION"
+          uvx --isolated --no-index --find-links dist brachio --help
+      - name: Build source distribution
+        if: matrix.target == 'x86_64-unknown-linux-gnu'
+        uses: PyO3/maturin-action@e83996d129638aa358a18fbd1dfb82f0b0fb5d3b # v1.51.0
+        with:
+          maturin-version: v1.15.0
+          command: sdist
+          args: --out dist
+      - uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+        with:
+          name: python-${{ matrix.target }}
+          path: dist/*
+          if-no-files-found: error
+
+  crates-io:
+    needs: [validate, wheels]
+    runs-on: ubuntu-latest
+    environment:
+      name: crates-io
+      url: https://crates.io/crates/brachio
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+        with:
+          persist-credentials: false
+      - uses: dtolnay/rust-toolchain@b725eda525362e7cf34af9a7243cac1e3f01a7ec # stable
+      - name: Authenticate with crates.io
+        id: auth
+        uses: rust-lang/crates-io-auth-action@3268eb413133e2960fa4ae0e963ca76380c54cd9 # v1.0.6
+      - name: Publish to crates.io
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ steps.auth.outputs.token }}
+        run: cargo publish --locked
+
+  pypi:
+    needs: [validate, wheels]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/brachio/
+    steps:
+      - uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4
+        with:
+          pattern: python-*
+          merge-multiple: true
+          path: dist
+      - uses: astral-sh/setup-uv@37802adc94f370d6bfd71619e3f0bf239e1f3b78 # v7
+        with:
+          enable-cache: false
+      - name: Publish to PyPI
+        env:
+          UV_PUBLISH_TOKEN: ${{ secrets.PYPI_TOKEN }}
+        run: uv publish --trusted-publishing never --check-url https://pypi.org/simple/ dist/*

brachio-0.0.0/.gitignore

@@ -0,0 +1,29 @@
+# Python packaging
+.venv/
+dist/
+__pycache__/
+
+# Generated by Cargo
+# will have compiled files and executables
+debug
+target
+
+# These are backup files generated by rustfmt
+**/*.rs.bk
+
+# MSVC Windows builds of rustc generate these, which store debugging information
+*.pdb
+
+# Generated by cargo mutants
+# Contains mutation testing data
+**/mutants.out*/
+
+# rustc will dump stack traces when hitting an internal compiler error to PWD
+rustc-ice-*.txt
+
+# RustRover
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/

brachio-0.0.0/AGENTS.md

@@ -0,0 +1,14 @@
+# Repository instructions
+
+## Documentation
+
+- [UNREVIEWED] Read `docs/publishing.md` before changing release tooling, change notes, or release outputs.
+
+## Boundaries
+
+- [UNREVIEWED] Run `changenote version`, `changenote tag`, tag pushes, GitHub Releases, or registry uploads only when the user explicitly requests that specific release action.
+
+## Git and commits
+
+- [UNREVIEWED] Before committing a release-relevant change, add or update a `brachio` note in `.changenote/` under the policy in `docs/publishing.md#change-notes` and validate it with `changenote status`.
+- [UNREVIEWED] For changes that need no release, create no note and state the reason in the completion report.