minima-cli 0.4.9__tar.gz → 0.4.10__tar.gz

{minima_cli-0.4.9 → minima_cli-0.4.10}/.github/workflows/prod.yml

@@ -156,3 +156,36 @@ jobs:
             --region ${{ env.REGION }} \
             --format 'value(status.url)')
           echo "::notice::Minima docs (prod) deployed to: $URL"
+
+  # ── 3. Publish minima-cli to PyPI ────────────────────────────────────────────
+  # Builds the sdist+wheel at the release tag and uploads to PyPI (the dist bundles the
+  # `minima_client` SDK). --skip-existing makes a manual re-deploy of an already-published
+  # version a no-op instead of an error. Needs no GCP — only the PYPI_API_TOKEN secret.
+  publish-pypi:
+    name: Publish → PyPI
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout @ release tag
+        uses: actions/checkout@v5
+        with:
+          ref: ${{ env.RELEASE_TAG }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Build sdist + wheel
+        run: |
+          python -m pip install --upgrade build twine
+          python -m build
+
+      - name: Check metadata
+        run: python -m twine check dist/*
+
+      - name: Publish to PyPI
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: python -m twine upload --skip-existing dist/*

{minima_cli-0.4.9 → minima_cli-0.4.10}/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to Minima are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/), and the project aims to follow
 [Semantic Versioning](https://semver.org/).
 
+## [0.4.10] - 2026-06-26
+
+### Changed
+- **`minima-cli` is now published to PyPI automatically on every release** — `pip install minima-cli`
+  is the official install (it bundles the `minima_client` SDK). A new CI job builds + uploads the
+  sdist/wheel alongside the GitHub release and prod deploy.
+
+### Fixed
+- **Docs (API reference):** corrected the `GET /v1/health` response example (it returns `mubit`
+  not `memory`, `version 0.4.9`, plus `auth`/`reasoner` blocks and `catalog.cost_source`) and
+  clarified `status` is only `degraded` on a key-bearing probe; documented the real
+  `summary.realized` field set (it differs from `summary.estimated`); and fixed the `days`
+  parameter bound (`>0–365`) on `/v1/savings` and `/v1/calibration`. Added a PyPI install link to
+  the Client SDK page.
+
 ## [0.4.9] - 2026-06-26
 
 ### Fixed

{minima_cli-0.4.9 → minima_cli-0.4.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: minima-cli
-Version: 0.4.9
+Version: 0.4.10
 Summary: Minima CLI: cost-aware LLM model routing — recommend cheaper models, backed by Mubit memory.
 Project-URL: Homepage, https://docs.minima.sh
 Project-URL: Documentation, https://docs.minima.sh

{minima_cli-0.4.9 → minima_cli-0.4.10}/docs-site/src/content/docs/api-reference.mdx

@@ -310,7 +310,7 @@ Two baselines are always reported side by side, explicitly labeled: **`vs premiu
 | Param | Type | Default | Notes |
 |-------|------|---------|-------|
 | `namespace` | string | — | Restrict to one namespace. |
-| `days` | float `0–365` | `30` | Lookback window. |
+| `days` | float `>0–365` | `30` | Lookback window (must be greater than 0). |
 | `group_by` | enum | — | `cluster` \| `task_type` \| `lane` — optional breakdown. |
 
 ### Response
@@ -318,7 +318,7 @@ Two baselines are always reported side by side, explicitly labeled: **`vs premiu
 | Field | Type | Notes |
 |-------|------|-------|
 | `summary.estimated` | object | `n`, `cost_recommended_usd`, `cost_premium_usd`, `savings_vs_premium_usd`, plus `n_declared` / `cost_declared_usd` / `savings_vs_declared_usd` over the declared-baseline subset. |
-| `summary.realized` | object | Same shape over the **reconciled** subset (feedback received with `actual_cost_usd`), using your realized cost against the estimated baselines. |
+| `summary.realized` | object | A **different** field set over the **reconciled** subset (feedback received with `actual_cost_usd`): `n_reconciled`, `realized_cost_usd`, `est_cost_recommended_usd`, `est_cost_premium_usd`, `savings_vs_premium_est_usd`, plus `n_declared` / `est_cost_declared_usd` / `savings_vs_declared_est_usd` — your realized cost measured against the estimated baselines. |
 | `health` | object | `recommendations`, `feedback_coverage` (share of recommendations that ever got feedback — the number that decides how much to trust `realized`), `late_feedback_share`, `escalation_rate`, `exploration_share`, `epsilon_policy_share`. |
 | `groups` | array | Per-`group_by` key: the same `summary` + `health`. |
 
@@ -342,7 +342,7 @@ Is `predicted_success` telling the truth for your traffic? Compares each recomme
 | Param | Type | Default | Notes |
 |-------|------|---------|-------|
 | `namespace` | string | — | Restrict to one namespace. |
-| `days` | float `0–365` | `30` | Lookback window. |
+| `days` | float `>0–365` | `30` | Lookback window (must be greater than 0). |
 
 ### Response
 
@@ -366,10 +366,12 @@ Always returns `200`; reports degraded state in the body. The only endpoint that
 ```json
 {
   "status": "ok",
-  "memory": {"reachable": true, "latency_ms": 12},
-  "catalog": {"version": "…", "stale": false, "models": 42},
-  "version": "0.1.0"
+  "mubit": {"reachable": true, "latency_ms": 12, "endpoint": "https://api.mubit.ai", "org_id": "…"},
+  "auth": "passthrough",
+  "catalog": {"version": "…", "cost_source": "litellm", "stale": false, "models": 42},
+  "reasoner": {"provider": "gemini", "configured": true},
+  "version": "0.4.9"
 }
 ```
 
-`status` is `degraded` when the memory backend is unreachable. In that state `/recommend` still serves prior-only recommendations.
+An unauthenticated probe (no key) returns `"mubit": {"reachable": null, "scope": "unauthenticated"}` and `status: "ok"` — liveness only. `status` is `degraded` only when a **key-bearing** probe finds your memory backend unreachable (`mubit.reachable == false`); in that state `/recommend` still serves prior-only recommendations.

{minima_cli-0.4.9 → minima_cli-0.4.10}/docs-site/src/content/docs/client-sdk.mdx

@@ -9,6 +9,14 @@ import { Aside, Code } from '@astrojs/starlight/components';
 
 The `minima_client` package is the official thin, typed Python client for the hosted Minima API, plus an optional zero-code intake helper.
 
+## Install
+
+```bash
+pip install minima-cli
+```
+
+The SDK is published on PyPI as part of [**`minima-cli`**](https://pypi.org/project/minima-cli/) — one package that ships both the CLI agent and the `minima_client` SDK (also available via `brew install mubit-ai/minima/minima`). Import it as `minima_client`:
+
 ```python
 from minima_client import MinimaClient, AsyncMinimaClient, MinimaError, autocapture
 ```

{minima_cli-0.4.9 → minima_cli-0.4.10}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "hatchling.build"
 # Distribution name on PyPI (the `minima` name is taken by an unrelated project). The import
 # package stays `minima`; the CLI is `minima` / `minima-harness`.
 name = "minima-cli"
-version = "0.4.9"
+version = "0.4.10"
 description = "Minima CLI: cost-aware LLM model routing — recommend cheaper models, backed by Mubit memory."
 readme = "README.md"
 requires-python = ">=3.11"

{minima_cli-0.4.9 → minima_cli-0.4.10}/src/minima/version.py

@@ -1,3 +1,3 @@
 # Keep in sync with [project].version in pyproject.toml — this is what /v1/health and the
 # FastAPI app report at runtime.
-__version__ = "0.4.9"
+__version__ = "0.4.10"

minima_cli-0.4.9/.claude/settings.local.json

@@ -1,12 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(gcloud sql instances describe *)",
-      "Bash(gcloud redis *)",
-      "Bash(gcloud run services describe *)",
-      "Bash(curl -s -H 'Authorization: Bearer GkqgKc3c0eFMK1LwgNhXV60GuXNJYXE1gDulAIyuWOuerymE' https://minima-staging-ftvjoyasma-ez.a.run.app/v1/health)",
-      "Bash(python3 -m json.tool)",
-      "Bash(curl -s -H 'Authorization: Bearer mbt_shankha-dev_cavgtceg2cyxzzkb_Omvp2p4l3bGxhoxzYBDoCYYyzylKM8hmyYzarJuzfduf1NdlDBL5pXgR86IodpGz' https://minima-staging-ftvjoyasma-ez.a.run.app/v1/health)"
-    ]
-  }
-}