codestrain 0.1.0__tar.gz → 0.1.2__tar.gz

codestrain-0.1.2/.github/workflows/release.yml

@@ -0,0 +1,80 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tooling
+        run: python -m pip install --upgrade build
+
+      - name: Build sdist and wheel
+        working-directory: .
+        run: python -m build
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI via Trusted Publisher
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  bump-homebrew:
+    name: Bump Homebrew Formula
+    needs: publish
+    runs-on: ubuntu-latest
+    if: ${{ !contains(github.ref_name, 'rc') && !contains(github.ref_name, 'a') && !contains(github.ref_name, 'b') }}
+    steps:
+      # Wait briefly so the new sdist is queryable on PyPI's CDN.
+      - name: Wait for PyPI propagation
+        run: sleep 30
+
+      - name: Open PR against codestrain/homebrew-tap
+        uses: mislav/bump-homebrew-formula-action@v3
+        with:
+          formula-name: codestrain
+          formula-path: Formula/codestrain.rb
+          homebrew-tap: codestrain/homebrew-tap
+          base-branch: main
+          # Compute download URL from the just-published PyPI sdist.
+          # mislav/bump-homebrew-formula-action auto-strips `v` prefix from
+          # github.ref_name, so v0.1.2 → 0.1.2 in the URL.
+          download-url: https://files.pythonhosted.org/packages/source/c/codestrain/codestrain-${{ github.ref_name }}.tar.gz
+          commit-message: |
+            codestrain {{version}}
+
+            Auto-bumped by mislav/bump-homebrew-formula-action.
+            Source: https://github.com/codestrain/codestrain-cli/releases/tag/${{ github.ref_name }}
+        env:
+          # Fine-grained PAT with `Contents: write` on codestrain/homebrew-tap.
+          # Stored as a repo secret in codestrain/codestrain-cli.
+          COMMITTER_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}

codestrain-0.1.0/README.md → codestrain-0.1.2/PKG-INFO

@@ -1,3 +1,28 @@
+Metadata-Version: 2.4
+Name: codestrain
+Version: 0.1.2
+Summary: Your AI coding recovery score, from the terminal.
+Project-URL: Homepage, https://codestrain.dev
+Project-URL: Repository, https://github.com/codestrain/codestrain-cli
+Author: Ivan Kononov
+License-Expression: MIT
+License-File: LICENSE
+Keywords: burnout,claude-code,developer-tools,drs,wellness
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: Utilities
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
 <p align="center"><img src="https://raw.githubusercontent.com/codestrain/codestrain-cli/main/.assets/logo.png" alt="CodeStrain" width="200"/></p>
 
 # CodeStrain CLI
@@ -5,10 +30,10 @@
 *Your AI coding recovery score, from the terminal.*
 
 <p align="center">
-  <a href="https://pypi.org/project/codestrain/"><img src="https://img.shields.io/pypi/v/codestrain.svg" alt="PyPI version"/></a>
-  <a href="https://pypi.org/project/codestrain/"><img src="https://img.shields.io/pypi/pyversions/codestrain.svg" alt="Python versions"/></a>
-  <a href="https://github.com/codestrain/codestrain-cli/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/codestrain.svg" alt="License: MIT"/></a>
-  <a href="https://github.com/codestrain/codestrain-cli/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/codestrain/codestrain-cli/ci.yml?branch=main" alt="CI status"/></a>
+  <a href="https://pypi.org/project/codestrain/"><img src="https://img.shields.io/pypi/v/codestrain.svg?v=2" alt="PyPI version"/></a>
+  <a href="https://pypi.org/project/codestrain/"><img src="https://img.shields.io/pypi/pyversions/codestrain.svg?v=2" alt="Python versions"/></a>
+  <a href="https://github.com/codestrain/codestrain-cli/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/codestrain.svg?v=2" alt="License: MIT"/></a>
+  <a href="https://github.com/codestrain/codestrain-cli/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/codestrain/codestrain-cli/ci.yml?branch=main&v=2" alt="CI status"/></a>
 </p>
 
 ## What is this
@@ -17,21 +42,56 @@ CodeStrain parses the Claude Code JSONL session logs already on your disk (`~/.c
 
 ## Install
 
+The CLI is a single command. Pick the install path your machine prefers — all three put `codestrain` on your `$PATH`:
+
 ```bash
-# one-liner (recommended)
-curl -fsSL codestrain.dev/install | sh
+# macOS — recommended (Homebrew)
+brew install codestrain/tap/codestrain
+codestrain --help
 ```
 
 ```bash
-# pipx
+# any OS — pipx, isolated venv + symlink on PATH
 pipx install codestrain
+codestrain --help
 ```
 
 ```bash
-# uv
+# any OS — uv tool, fastest
 uv tool install codestrain
+codestrain --help
 ```
 
+```bash
+# one-liner installer — detects pipx/uv/pip and adds PATH automatically
+curl -fsSL codestrain.dev/install | sh
+```
+
+`pip install codestrain` works too, but leaves the binary off your `$PATH` on macOS (PEP 668 / user-install convention). See troubleshooting below.
+
+<details>
+<summary>If <code>codestrain: command not found</code> after <code>pip install codestrain</code></summary>
+
+That's the macOS / PEP 668 quirk — pip installed the wheel but didn't put the entry-point on PATH. Three fixes, in order of preference:
+
+```bash
+# (a) run it as a module — works without any PATH change
+python3 -m codestrain_cli --all
+
+# (b) switch to pipx (installs in isolated venv, fixes PATH)
+brew install pipx        # or:  python3 -m pip install --user pipx
+pipx ensurepath          # adds ~/.local/bin to PATH
+pipx install codestrain
+
+# (c) find where pip put the binary and add that dir to PATH
+pip show -f codestrain | grep -E 'bin/codestrain'
+# typical macOS user-install path:
+echo 'export PATH="$HOME/Library/Python/3.11/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+</details>
+
 ## Quick start
 
 ```bash

codestrain-0.1.0/PKG-INFO → codestrain-0.1.2/README.md

@@ -1,23 +1,3 @@
-Metadata-Version: 2.4
-Name: codestrain
-Version: 0.1.0
-Summary: Your AI coding recovery score, from the terminal.
-Project-URL: Homepage, https://codestrain.dev
-Project-URL: Repository, https://github.com/codestrain/codestrain-cli
-Author: Ivan Kononov
-License-Expression: MIT
-License-File: LICENSE
-Keywords: burnout,claude-code,developer-tools,drs,wellness
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Topic :: Software Development
-Classifier: Topic :: Utilities
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-
 <p align="center"><img src="https://raw.githubusercontent.com/codestrain/codestrain-cli/main/.assets/logo.png" alt="CodeStrain" width="200"/></p>
 
 # CodeStrain CLI
@@ -25,10 +5,10 @@ Description-Content-Type: text/markdown
 *Your AI coding recovery score, from the terminal.*
 
 <p align="center">
-  <a href="https://pypi.org/project/codestrain/"><img src="https://img.shields.io/pypi/v/codestrain.svg" alt="PyPI version"/></a>
-  <a href="https://pypi.org/project/codestrain/"><img src="https://img.shields.io/pypi/pyversions/codestrain.svg" alt="Python versions"/></a>
-  <a href="https://github.com/codestrain/codestrain-cli/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/codestrain.svg" alt="License: MIT"/></a>
-  <a href="https://github.com/codestrain/codestrain-cli/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/codestrain/codestrain-cli/ci.yml?branch=main" alt="CI status"/></a>
+  <a href="https://pypi.org/project/codestrain/"><img src="https://img.shields.io/pypi/v/codestrain.svg?v=2" alt="PyPI version"/></a>
+  <a href="https://pypi.org/project/codestrain/"><img src="https://img.shields.io/pypi/pyversions/codestrain.svg?v=2" alt="Python versions"/></a>
+  <a href="https://github.com/codestrain/codestrain-cli/blob/main/LICENSE"><img src="https://img.shields.io/pypi/l/codestrain.svg?v=2" alt="License: MIT"/></a>
+  <a href="https://github.com/codestrain/codestrain-cli/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/codestrain/codestrain-cli/ci.yml?branch=main&v=2" alt="CI status"/></a>
 </p>
 
 ## What is this
@@ -37,21 +17,56 @@ CodeStrain parses the Claude Code JSONL session logs already on your disk (`~/.c
 
 ## Install
 
+The CLI is a single command. Pick the install path your machine prefers — all three put `codestrain` on your `$PATH`:
+
 ```bash
-# one-liner (recommended)
-curl -fsSL codestrain.dev/install | sh
+# macOS — recommended (Homebrew)
+brew install codestrain/tap/codestrain
+codestrain --help
 ```
 
 ```bash
-# pipx
+# any OS — pipx, isolated venv + symlink on PATH
 pipx install codestrain
+codestrain --help
 ```
 
 ```bash
-# uv
+# any OS — uv tool, fastest
 uv tool install codestrain
+codestrain --help
 ```
 
+```bash
+# one-liner installer — detects pipx/uv/pip and adds PATH automatically
+curl -fsSL codestrain.dev/install | sh
+```
+
+`pip install codestrain` works too, but leaves the binary off your `$PATH` on macOS (PEP 668 / user-install convention). See troubleshooting below.
+
+<details>
+<summary>If <code>codestrain: command not found</code> after <code>pip install codestrain</code></summary>
+
+That's the macOS / PEP 668 quirk — pip installed the wheel but didn't put the entry-point on PATH. Three fixes, in order of preference:
+
+```bash
+# (a) run it as a module — works without any PATH change
+python3 -m codestrain_cli --all
+
+# (b) switch to pipx (installs in isolated venv, fixes PATH)
+brew install pipx        # or:  python3 -m pip install --user pipx
+pipx ensurepath          # adds ~/.local/bin to PATH
+pipx install codestrain
+
+# (c) find where pip put the binary and add that dir to PATH
+pip show -f codestrain | grep -E 'bin/codestrain'
+# typical macOS user-install path:
+echo 'export PATH="$HOME/Library/Python/3.11/bin:$PATH"' >> ~/.zshrc
+source ~/.zshrc
+```
+
+</details>
+
 ## Quick start
 
 ```bash

{codestrain-0.1.0 → codestrain-0.1.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codestrain"
-version = "0.1.0"
+version = "0.1.2"
 description = "Your AI coding recovery score, from the terminal."
 requires-python = ">=3.9"
 readme = "README.md"
@@ -13,6 +13,11 @@ classifiers = [
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Topic :: Software Development",
     "Topic :: Utilities",
 ]

codestrain-0.1.0/.github/workflows/release.yml

@@ -1,49 +0,0 @@
-name: Release
-
-on:
-  push:
-    tags:
-      - "v*"
-
-jobs:
-  build:
-    name: Build distributions
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.12"
-
-      - name: Install build tooling
-        run: python -m pip install --upgrade build
-
-      - name: Build sdist and wheel
-        working-directory: .
-        run: python -m build
-
-      - name: Upload distributions
-        uses: actions/upload-artifact@v4
-        with:
-          name: dist
-          path: dist/
-
-  publish:
-    name: Publish to PyPI
-    needs: build
-    runs-on: ubuntu-latest
-    environment: pypi
-    permissions:
-      id-token: write
-    steps:
-      - name: Download distributions
-        uses: actions/download-artifact@v4
-        with:
-          name: dist
-          path: dist/
-
-      - name: Publish to PyPI via Trusted Publisher
-        uses: pypa/gh-action-pypi-publish@release/v1