decision-toolkit 0.4.0__tar.gz → 0.4.2__tar.gz

{decision_toolkit-0.4.0 → decision_toolkit-0.4.2}/CHANGELOG.md

@@ -1,8 +1,22 @@
 # Changelog
 
-All notable changes to this project are documented here. Version `0.4.0` is
+All notable changes to this project are documented here. Version `0.4.2` is
 published on PyPI.
 
+## [0.4.2] — 2026-10-21
+
+Documentation cleanup: removed internal project language (`m0`, phase numbers,
+waitlist), removed the public catalog proposal and roadmap pages, and rewrote
+the model-card index for users. Every model card now includes library, CLI and
+REST snippets for every variant. No runtime changes.
+
+## [0.4.1] — 2026-10-21
+
+Catalog presentation patch: every variant now carries its REST alias
+(`id@variant`) in `dtk models list`, `--json` and `dtk models variants`. Model
+cards include copy-paste loading examples for library, CLI and REST for every
+variant. No model or runtime changes.
+
 ## [0.4.0] — 2026-10-21
 
 REST variant-selection correction. Quantizations are selected through standard
@@ -209,6 +223,8 @@ README correction. No code or model behavior changed.
 - Typed `DecisionModel` API with lifecycle, batching, async, usage, warnings,
   normalized confidence, capabilities, structured events and atomic model store.
 
+[0.4.2]: https://pypi.org/project/decision-toolkit/0.4.2/
+[0.4.1]: https://pypi.org/project/decision-toolkit/0.4.1/
 [0.4.0]: https://pypi.org/project/decision-toolkit/0.4.0/
 [0.3.1]: https://pypi.org/project/decision-toolkit/0.3.1/
 [0.3.0]: https://pypi.org/project/decision-toolkit/0.3.0/

{decision_toolkit-0.4.0 → decision_toolkit-0.4.2}/CONTRIBUTING.md

@@ -76,9 +76,11 @@ uv run dtk --version
 uv run pip-audit                # dependency scan (CI runs this)
 ```
 
-CI runs these on Python 3.12 and 3.13, plus `pip-audit`. The tag-triggered
-release workflow builds and publishes the wheel with uv; see
-[RELEASE.md](docs/RELEASE.md). For rate limits, metrics, tracing and the load
+CI runs these on Python 3.12 and 3.13, plus `pip-audit`. `tests/test_help_examples.py`
+parses every example printed by `dtk --help` and checks referenced catalog
+models/variants; run the full examples against a populated cache before a
+release. The tag-triggered release workflow builds and publishes the wheel with
+uv; see [RELEASE.md](docs/RELEASE.md). For rate limits, metrics, tracing and the load
 probe see [OPERATIONS.md](docs/OPERATIONS.md).
 
 ## Commits

{decision_toolkit-0.4.0 → decision_toolkit-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: decision-toolkit
-Version: 0.4.0
+Version: 0.4.2
 Summary: Local-first toolkit for open-weights decision models: one ONNX engine, one adapter per model contract, typed choice/yes-no/score decisions with probabilities on CPU.
 Project-URL: Homepage, https://github.com/gia-uh/decision-toolkit
 Project-URL: Repository, https://github.com/gia-uh/decision-toolkit
@@ -59,7 +59,7 @@ and CLI. `dtk --help` and every subcommand help also include runnable examples.
 ## Installation
 
 ```bash
-uv pip install decision-toolkit              # library + CLI (0.4.0 on PyPI)
+uv pip install decision-toolkit              # library + CLI (0.4.2 on PyPI)
 uv pip install "decision-toolkit[onnx]"      # + onnxruntime, tokenizers (the model runtime)
 uv pip install "decision-toolkit[server]"    # + REST server (FastAPI)
 ```
@@ -67,7 +67,7 @@ uv pip install "decision-toolkit[server]"    # + REST server (FastAPI)
 The project is managed with [uv](https://docs.astral.sh/uv/) and ships a committed `uv.lock`. Published
 wheels remain compatible with `pip` for environments that do not use uv.
 
-PyPI: <https://pypi.org/project/decision-toolkit/0.4.0/>. See
+PyPI: <https://pypi.org/project/decision-toolkit/0.4.2/>. See
 [docs/RELEASE.md](https://github.com/gia-uh/decision-toolkit/blob/main/docs/RELEASE.md)
 for the Trusted Publishing flow and clean-install checks.
 
@@ -135,7 +135,7 @@ decision.truncated, decision.warnings
 validated before inference (`box`/assets are rejected by text-only models).
 Custom adapters can be registered with `register_adapter`; local ONNX models
 can be opened with `DecisionModel.from_onnx(...)`. See
-[docs/CORE.md](https://github.com/gia-uh/decision-toolkit/blob/main/docs/CORE.md) for the full phase 1 contract, error taxonomy,
+[docs/CORE.md](https://github.com/gia-uh/decision-toolkit/blob/main/docs/CORE.md) for the full API contract, error taxonomy,
 logging events and the expressiveness inventory.
 
 **2. As a CLI**
@@ -186,34 +186,25 @@ current text-only subset.
 See [docs/REST.md](https://github.com/gia-uh/decision-toolkit/blob/main/docs/REST.md) for the pinned contracts, limits, auth and
 the standard-evolution process.
 
-## The catalog is curated
+## Models and variants
 
-The catalog is **ours**, not a mirror of HuggingFace. A model enters only when it
-is understood and verified:
+The catalog lists models that are runnable with the toolkit today. Every entry
+has a real ONNX export, verified files and measured behavior; nothing is listed
+as a placeholder.
 
-1. clean commercial license;
-2. an adapter whose contract we can implement **from a real export**;
-3. a real ONNX export on the Hub;
-4. measured parity against the original on a fixed sample;
-5. CPU-viable latency.
-
-Every variant points to files that exist. No placeholders, no speculative
-adapters (there is no generic "any ONNX" adapter).
-
-| id | adapter | status | variants (default *) |
+| id | adapter | verification | variants (default *) |
 | --- | --- | --- | --- |
-| `gliner2.5-multi` | `gliner2` | **m0** — verified end-to-end (9/15, 353 ms) | `fp16`* (577 MB); `fp32` (1132 MB) |
-| `gliner2.5-decide` | `gliner2-decide` | **m0** — fused export verified (refund 0.944, 912 ms; English-only) | `q4f16`* (524 MB) |
-| `laya` | `laya` | **m0** — verified against torch (Δp ≤ 0.005) | `q8`* (528 MB) |
-| `julia-1` | `julia` | **m0** — verified: 100/100 argmax parity, 329 ms | `fp32`* (618 MB) |
-| `opendecider-nano` | `opendecider` | **m0** — official build; prompt ported from pinned code (530 ms) | `q8f16`* (469 MB); `fp16` (792 MB) |
-| `laya-multilingual` | `laya` | **m0** — fused ONNX; upstream parity (37 ms) | `fp16`* (682 MB); `fp32` (1326 MB) |
-| `open-jev-deberta-v3-large` | `open-jev` | **m0** — Open-Jev DeBERTa v3 large repro; 0.854 in-domain (241 ms) | `fp16`* (884 MB); `fp32` (1758 MB); `q4` (487 MB); `q4f16` (357 MB) |
-| `strands-decider-2b` | `strands-decider` | **m0** — reference fixture match (719 ms) | `q4f16`* (1114 MB); `q8` (1821 MB) |
-
-**Only `m0` models are in the catalog.** Researched-but-unavailable models
-(planned, conversion pending, broken exports) are listed in
-[docs/ROADMAP.md](https://github.com/gia-uh/decision-toolkit/blob/main/docs/ROADMAP.md) and are not downloadable through the toolkit.
+| `gliner2.5-multi` | `gliner2` | verified end-to-end (9/15, 353 ms) | `fp16`* (577 MB); `fp32` (1132 MB) |
+| `gliner2.5-decide` | `gliner2-decide` | fused export verified (refund 0.944, 912 ms; English-only) | `q4f16`* (524 MB) |
+| `laya` | `laya` | verified against torch (Δp ≤ 0.005) | `q8`* (528 MB) |
+| `julia-1` | `julia` | verified: 100/100 argmax parity, 329 ms | `fp32`* (618 MB) |
+| `opendecider-nano` | `opendecider` | official build; prompt ported from pinned code (530 ms) | `q8f16`* (469 MB); `fp16` (792 MB) |
+| `laya-multilingual` | `laya` | fused ONNX; upstream parity (37 ms) | `fp16`* (682 MB); `fp32` (1326 MB) |
+| `open-jev-deberta-v3-large` | `open-jev` | Open-Jev DeBERTa v3 large reproduction; 0.854 in-domain (241 ms) | `fp16`* (884 MB); `fp32` (1758 MB); `q4` (487 MB); `q4f16` (357 MB) |
+| `strands-decider-2b` | `strands-decider` | reference fixture match (719 ms) | `q4f16`* (1114 MB); `q8` (1821 MB) |
+
+Each variant has a REST alias in the form `id@variant`; `dtk models list` prints
+the alias next to every variant.
 
 Per-model cards with the contract, measured evidence and known limitations:
 [docs/models](https://github.com/gia-uh/decision-toolkit/tree/main/docs/models).
@@ -254,7 +245,7 @@ standard `model` field. The base id uses the server/persisted default. There is
 no `variant` field in the request body; `/v1/models` lists both the base model
 and every alias, and two aliases can be loaded concurrently.
 
-A variant becomes default only after passing the parity gate (top-1 ≥ 99%,
+A variant becomes default only after passing the verification criteria (top-1 ≥ 99%,
 mean |Δp| ≤ 0.02, accuracy delta ≤ 1 pp against the fp32 build on a fixed
 sample) and measuring latency on CPU. Unverified conversions are not catalogued
 and never become a silent fallback. See [Variants and quantization](https://gia-uh.github.io/decision-toolkit/VARIANTS/)
@@ -300,7 +291,7 @@ See [CHANGELOG.md](https://github.com/gia-uh/decision-toolkit/blob/main/CHANGELO
 
 ## Custom ONNX (at your own risk)
 
-You can run any ONNX file with an adapter you trust — outside the curated
+You can run any ONNX file with an adapter you trust — outside the
 catalog:
 
 ```python

{decision_toolkit-0.4.0 → decision_toolkit-0.4.2}/README.md

@@ -21,7 +21,7 @@ and CLI. `dtk --help` and every subcommand help also include runnable examples.
 ## Installation
 
 ```bash
-uv pip install decision-toolkit              # library + CLI (0.4.0 on PyPI)
+uv pip install decision-toolkit              # library + CLI (0.4.2 on PyPI)
 uv pip install "decision-toolkit[onnx]"      # + onnxruntime, tokenizers (the model runtime)
 uv pip install "decision-toolkit[server]"    # + REST server (FastAPI)
 ```
@@ -29,7 +29,7 @@ uv pip install "decision-toolkit[server]"    # + REST server (FastAPI)
 The project is managed with [uv](https://docs.astral.sh/uv/) and ships a committed `uv.lock`. Published
 wheels remain compatible with `pip` for environments that do not use uv.
 
-PyPI: <https://pypi.org/project/decision-toolkit/0.4.0/>. See
+PyPI: <https://pypi.org/project/decision-toolkit/0.4.2/>. See
 [docs/RELEASE.md](https://github.com/gia-uh/decision-toolkit/blob/main/docs/RELEASE.md)
 for the Trusted Publishing flow and clean-install checks.
 
@@ -97,7 +97,7 @@ decision.truncated, decision.warnings
 validated before inference (`box`/assets are rejected by text-only models).
 Custom adapters can be registered with `register_adapter`; local ONNX models
 can be opened with `DecisionModel.from_onnx(...)`. See
-[docs/CORE.md](https://github.com/gia-uh/decision-toolkit/blob/main/docs/CORE.md) for the full phase 1 contract, error taxonomy,
+[docs/CORE.md](https://github.com/gia-uh/decision-toolkit/blob/main/docs/CORE.md) for the full API contract, error taxonomy,
 logging events and the expressiveness inventory.
 
 **2. As a CLI**
@@ -148,34 +148,25 @@ current text-only subset.
 See [docs/REST.md](https://github.com/gia-uh/decision-toolkit/blob/main/docs/REST.md) for the pinned contracts, limits, auth and
 the standard-evolution process.
 
-## The catalog is curated
+## Models and variants
 
-The catalog is **ours**, not a mirror of HuggingFace. A model enters only when it
-is understood and verified:
+The catalog lists models that are runnable with the toolkit today. Every entry
+has a real ONNX export, verified files and measured behavior; nothing is listed
+as a placeholder.
 
-1. clean commercial license;
-2. an adapter whose contract we can implement **from a real export**;
-3. a real ONNX export on the Hub;
-4. measured parity against the original on a fixed sample;
-5. CPU-viable latency.
-
-Every variant points to files that exist. No placeholders, no speculative
-adapters (there is no generic "any ONNX" adapter).
-
-| id | adapter | status | variants (default *) |
+| id | adapter | verification | variants (default *) |
 | --- | --- | --- | --- |
-| `gliner2.5-multi` | `gliner2` | **m0** — verified end-to-end (9/15, 353 ms) | `fp16`* (577 MB); `fp32` (1132 MB) |
-| `gliner2.5-decide` | `gliner2-decide` | **m0** — fused export verified (refund 0.944, 912 ms; English-only) | `q4f16`* (524 MB) |
-| `laya` | `laya` | **m0** — verified against torch (Δp ≤ 0.005) | `q8`* (528 MB) |
-| `julia-1` | `julia` | **m0** — verified: 100/100 argmax parity, 329 ms | `fp32`* (618 MB) |
-| `opendecider-nano` | `opendecider` | **m0** — official build; prompt ported from pinned code (530 ms) | `q8f16`* (469 MB); `fp16` (792 MB) |
-| `laya-multilingual` | `laya` | **m0** — fused ONNX; upstream parity (37 ms) | `fp16`* (682 MB); `fp32` (1326 MB) |
-| `open-jev-deberta-v3-large` | `open-jev` | **m0** — Open-Jev DeBERTa v3 large repro; 0.854 in-domain (241 ms) | `fp16`* (884 MB); `fp32` (1758 MB); `q4` (487 MB); `q4f16` (357 MB) |
-| `strands-decider-2b` | `strands-decider` | **m0** — reference fixture match (719 ms) | `q4f16`* (1114 MB); `q8` (1821 MB) |
-
-**Only `m0` models are in the catalog.** Researched-but-unavailable models
-(planned, conversion pending, broken exports) are listed in
-[docs/ROADMAP.md](https://github.com/gia-uh/decision-toolkit/blob/main/docs/ROADMAP.md) and are not downloadable through the toolkit.
+| `gliner2.5-multi` | `gliner2` | verified end-to-end (9/15, 353 ms) | `fp16`* (577 MB); `fp32` (1132 MB) |
+| `gliner2.5-decide` | `gliner2-decide` | fused export verified (refund 0.944, 912 ms; English-only) | `q4f16`* (524 MB) |
+| `laya` | `laya` | verified against torch (Δp ≤ 0.005) | `q8`* (528 MB) |
+| `julia-1` | `julia` | verified: 100/100 argmax parity, 329 ms | `fp32`* (618 MB) |
+| `opendecider-nano` | `opendecider` | official build; prompt ported from pinned code (530 ms) | `q8f16`* (469 MB); `fp16` (792 MB) |
+| `laya-multilingual` | `laya` | fused ONNX; upstream parity (37 ms) | `fp16`* (682 MB); `fp32` (1326 MB) |
+| `open-jev-deberta-v3-large` | `open-jev` | Open-Jev DeBERTa v3 large reproduction; 0.854 in-domain (241 ms) | `fp16`* (884 MB); `fp32` (1758 MB); `q4` (487 MB); `q4f16` (357 MB) |
+| `strands-decider-2b` | `strands-decider` | reference fixture match (719 ms) | `q4f16`* (1114 MB); `q8` (1821 MB) |
+
+Each variant has a REST alias in the form `id@variant`; `dtk models list` prints
+the alias next to every variant.
 
 Per-model cards with the contract, measured evidence and known limitations:
 [docs/models](https://github.com/gia-uh/decision-toolkit/tree/main/docs/models).
@@ -216,7 +207,7 @@ standard `model` field. The base id uses the server/persisted default. There is
 no `variant` field in the request body; `/v1/models` lists both the base model
 and every alias, and two aliases can be loaded concurrently.
 
-A variant becomes default only after passing the parity gate (top-1 ≥ 99%,
+A variant becomes default only after passing the verification criteria (top-1 ≥ 99%,
 mean |Δp| ≤ 0.02, accuracy delta ≤ 1 pp against the fp32 build on a fixed
 sample) and measuring latency on CPU. Unverified conversions are not catalogued
 and never become a silent fallback. See [Variants and quantization](https://gia-uh.github.io/decision-toolkit/VARIANTS/)
@@ -262,7 +253,7 @@ See [CHANGELOG.md](https://github.com/gia-uh/decision-toolkit/blob/main/CHANGELO
 
 ## Custom ONNX (at your own risk)
 
-You can run any ONNX file with an adapter you trust — outside the curated
+You can run any ONNX file with an adapter you trust — outside the
 catalog:
 
 ```python

{decision_toolkit-0.4.0 → decision_toolkit-0.4.2}/docs/BENCH.md

@@ -66,7 +66,7 @@ and
 The model cards retain the historical cold-start measurements used when each
 variant was admitted. The harness reports **post-warmup steady-state** latency,
 which is lower. Compare like with like: use the harness when comparing commits
-or machines; use the card values only as historical admission evidence.
+or machines; use the card values only as historical reference measurements.
 
 ## Adding a case
 

{decision_toolkit-0.4.0 → decision_toolkit-0.4.2}/docs/CLI.md

@@ -1,4 +1,4 @@
-# CLI (phase 3)
+# CLI
 
 `dtk` is our own operational surface. Unlike REST, it has **no external
 standard** to comply with: it is consistent with itself, script-friendly, and a
@@ -9,7 +9,7 @@ CLI.
 
 | Command | Purpose |
 | --- | --- |
-| `dtk models` | Inspect the local cache and the curated catalog. |
+| `dtk models` | Inspect the local cache and the model catalog. |
 | `dtk models list` | Every catalog variant, default (`*`) and cached variants (`--license`, `--quant`, `--adapter`). |
 | `dtk models variants <id>` | Every real variant of one model, with size, role and exact install command. |
 | `dtk models download <id>` | Download the default or `--variant` quantization (`--force`, `--dry-run`). |
@@ -151,6 +151,9 @@ are already downloaded.
 | `open-jev-deberta-v3-large` | `fp16`*, `fp32`, `q4`, `q4f16` | fp16 / fp32 / q4 / q4-fp16 | 883.5 / 1757.9 / 486.7 / 357.0 MB |
 | `strands-decider-2b` | `q4f16`*, `q8` | q4-fp16 / int8 | 1113.6 / 1821.4 MB |
 
+Each row is also addressable over REST as `model = "<id>@<variant>"`; the alias
+is printed by `dtk models list` and by `dtk models variants <id>`.
+
 ```bash
 # inspect, including the exact download command for each variant
 dtk models list --quant
@@ -241,8 +244,7 @@ dtk serve --model gliner2.5-multi --warmup \
 - `--workers N` and `--reload` use an internal uvicorn factory; `--reload`
   is for development and cannot be combined with `--workers > 1`.
 - `--max-models`, `--max-body-mb`, `--timeout`, `--warmup`, `--api-key`,
-  `--cors-origin`, `--log-level` and `--log-format` are the server's phase 2
-  controls.
+  `--cors-origin`, `--log-level` and `--log-format` are server controls.
 - Custom `--adapter`/`--files` also apply to the server's default model.
 
 ## Completion
@@ -278,6 +280,6 @@ dtk doctor --json
   config), but still does not reimplement inference.
 - It does not have a compatibility obligation to System One/OpenAI; those are
   REST contracts.
-- Metrics/rate limiting are server-side phase 5 features; see
+- Metrics and rate limiting are server-side features; see
   [OPERATIONS.md](OPERATIONS.md). Wheel/PyPI releases are documented in
   [RELEASE.md](RELEASE.md).

{decision_toolkit-0.4.0 → decision_toolkit-0.4.2}/docs/CORE.md

@@ -1,4 +1,4 @@
-# Core programmatic API (phase 1)
+# Core API
 
 The programmatic API is the **superset**: the most expressive layer of the
 toolkit. The REST server is a documented, conformance-tested projection of a subset of
@@ -207,7 +207,7 @@ Events emitted by `decision_toolkit.*` loggers:
 Each event is a compact JSON object with `event`, `request_id`, model identity,
 variant, adapter, question count, token counts, latency, truncation and error
 code. State and question text are **not** logged by default. The CLI/REST
-layers configure formatting and destinations in later phases.
+layers configure formatting and destinations separately.
 
 ## Extensibility
 
@@ -254,9 +254,9 @@ Registration is in-process (no daemon, no plugin server).
 - `resolve(id, variant=...)`: local directory + role → file map + adapter for
   the core.
 
-## Phase 1 expressiveness inventory
+## Capabilities and limits
 
-This is the checklist against which the REST projection will be verified:
+The core exposes the following capabilities:
 
 | Capability | Core status |
 | --- | --- |
@@ -280,13 +280,12 @@ This is the checklist against which the REST projection will be verified:
 | Model store | atomic download, hashes, verify, import metadata |
 | Multi-label | capability flag + validation; no adapter yet |
 
-## Out of scope for phase 1
+## Not part of the core
 
-- REST contract projection and standard compliance — implemented in phase 2
-  (see [REST.md](REST.md)).
-- CLI workflows across the whole catalog — implemented in phase 3 (see
-  [CLI.md](CLI.md)).
-- Pin/hash enforcement and source CI are implemented in phase 4; wheel,
-  PyPI and distribution tagging are documented in [RELEASE.md](RELEASE.md).
-- Metrics server, rate limiting and load/fuzz testing are server-side phase 5
-  features; see [OPERATIONS.md](OPERATIONS.md).
+- REST contract projection and standard compliance are implemented in the
+  server; see [REST.md](REST.md).
+- CLI workflows across the catalog are implemented in [CLI.md](CLI.md).
+- Catalog pinning and source CI are implementation details; packaging is
+  documented in [RELEASE.md](RELEASE.md).
+- Metrics, rate limiting and load/fuzz testing are server-side features; see
+  [OPERATIONS.md](OPERATIONS.md).

{decision_toolkit-0.4.0 → decision_toolkit-0.4.2}/docs/OPERATIONS.md

@@ -1,6 +1,6 @@
-# Operations (phase 5)
+# Operations
 
-This document covers the operational behavior added in phase 5: rate limits,
+This document covers operational behavior: rate limits,
 backpressure, metrics, tracing, load testing and the PII contract. Packaging is
 still a later milestone.
 

{decision_toolkit-0.4.0 → decision_toolkit-0.4.2}/docs/RELEASE.md

@@ -39,7 +39,7 @@ Clean install test (no `PYTHONPATH`):
 ```bash
 uv venv --python 3.12 /tmp/dtk-wheel
 uv pip install --python /tmp/dtk-wheel/bin/python \
-  dist/decision_toolkit-0.4.0-py3-none-any.whl
+  dist/decision_toolkit-0.4.2-py3-none-any.whl
 uv pip check --python /tmp/dtk-wheel/bin/python
 /tmp/dtk-wheel/bin/dtk --version
 /tmp/dtk-wheel/bin/dtk models list --json
@@ -50,7 +50,7 @@ With inference and server extras:
 
 ```bash
 uv pip install --python /tmp/dtk-wheel/bin/python \
-  "dist/decision_toolkit-0.4.0-py3-none-any.whl[onnx,server,tracing]"
+  "dist/decision_toolkit-0.4.2-py3-none-any.whl[onnx,server,tracing]"
 /tmp/dtk-wheel/bin/dtk decide --model gliner2.5-decide ...
 /tmp/dtk-wheel/bin/dtk serve --model gliner2.5-decide --warmup --port 8016
 curl -s http://127.0.0.1:8016/health
@@ -84,8 +84,8 @@ No long-lived PyPI token is needed; the workflow uses GitHub OIDC
 4. Create and push an annotated tag:
 
    ```bash
-   git tag -a v0.4.0 -m "decision-toolkit 0.4.0"
-   git push origin v0.4.0
+   git tag -a v0.4.2 -m "decision-toolkit 0.4.2"
+   git push origin v0.4.2
    ```
 
 5. `.github/workflows/release.yml` builds once, publishes to **TestPyPI**, then
@@ -134,9 +134,9 @@ to TestPyPI without publishing to PyPI or creating a GitHub release.
 
 ## Published release
 
-`0.4.0` is published through Trusted Publishing on 2026-10-21:
+`0.4.2` is published through Trusted Publishing on 2026-10-21:
 
-<https://pypi.org/project/decision-toolkit/0.4.0/>
+<https://pypi.org/project/decision-toolkit/0.4.2/>
 
 `0.1.0` was the first release; `0.1.1` refreshed the PyPI description; `0.1.2`
 validated the OIDC TestPyPI → PyPI flow; `0.1.3` added post-publish install
@@ -147,7 +147,9 @@ complete variant/quantization visibility and CLI selection; `0.1.7` aligned
 selection across library, CLI and REST; `0.2.0` corrected the REST conformance
 claims and wire shapes; `0.2.1` changed the public documentation URLs; `0.3.0`
 added the three new ONNX decision models; `0.3.1` made the catalog list one row per variant; `0.4.0` moved REST variant
-selection to standard model aliases.
+selection to standard model aliases; `0.4.1` exposed aliases in the catalog and
+per-variant loading examples in every model card; `0.4.2` removed internal
+project language and public proposal/roadmap pages.
 
 The tag-triggered workflow remains the preferred path for future releases once
 the TestPyPI/PyPI trusted publishers and protected environments are configured.

{decision_toolkit-0.4.0 → decision_toolkit-0.4.2}/docs/REST.md

@@ -1,4 +1,4 @@
-# REST projection (phase 2)
+# REST API
 
 REST is a **documented projection** of the programmatic core, not a second
 implementation. The core remains the superset; the server selects a supported
@@ -337,11 +337,11 @@ at `http://localhost:8000/v1`.
 - Transport tests cover auth, request ids, 413, CORS, readiness and per-request
   model selection.
 
-## Out of scope for phase 2
+## Not implemented by this server
 
-- Metrics/Prometheus, rate limiting and load tests are implemented in phase 5
-  (see [OPERATIONS.md](OPERATIONS.md)).
-- CLI batch/JSONL and custom-model workflows are implemented in phase 3
-  (see [CLI.md](CLI.md)).
-- Pinned catalog hashes and source CI are implemented in phase 4; wheel,
-  PyPI and distribution tagging are documented in [RELEASE.md](RELEASE.md).
+- Metrics, rate limiting and load testing are implemented as server-side
+  features; see [OPERATIONS.md](OPERATIONS.md).
+- CLI batch/JSONL and custom-model workflows are in the CLI; see [CLI.md](CLI.md).
+- Pinned catalog hashes and CI are implementation details; packaging is
+  documented in [RELEASE.md](RELEASE.md).
+- Images/assets and `box` are rejected because the current catalog is text-only.

{decision_toolkit-0.4.0 → decision_toolkit-0.4.2}/docs/VARIANTS.md

@@ -11,34 +11,34 @@ local model cache. Variants of the same model coexist, so you can compare them
 without deleting the default.
 
 Only catalogued and verified builds are selectable. Community conversions that
-have not passed the catalog gates are not exposed as variants.
+have not passed the catalog checks are not exposed as variants.
 
 ## Available variants
 
 A `*` marks the default variant. It is used when `--variant` is omitted and no
 other variant was selected with `dtk models use`.
 
-| Model | Variant | Quantization | Size | Role | Download |
-| --- | --- | --- | ---: | --- | --- |
-| `gliner2.5-multi` | `fp16` * | fp16 encoder + fp32 classifier | 577.1 MB | default | `dtk models download gliner2.5-multi --variant fp16` |
-| `gliner2.5-multi` | `fp32` | fp32 encoder + fp32 classifier | 1131.9 MB | quality | `dtk models download gliner2.5-multi --variant fp32` |
-| `gliner2.5-decide` | `q4f16` * | q4/fp16 | 523.5 MB | default | `dtk models download gliner2.5-decide --variant q4f16` |
-| `laya` | `q8` * | int8 | 527.9 MB | default | `dtk models download laya --variant q8` |
-| `julia-1` | `fp32` * | fp32 | 618.2 MB | default | `dtk models download julia-1 --variant fp32` |
-| `opendecider-nano` | `q8f16` * | int8/fp16 | 468.8 MB | default | `dtk models download opendecider-nano --variant q8f16` |
-| `opendecider-nano` | `fp16` | fp16 | 791.9 MB | quality | `dtk models download opendecider-nano --variant fp16` |
-| `laya-multilingual` | `fp16` * | fp16 | 681.8 MB | default | `dtk models download laya-multilingual --variant fp16` |
-| `laya-multilingual` | `fp32` | fp32 | 1325.6 MB | quality | `dtk models download laya-multilingual --variant fp32` |
-| `open-jev-deberta-v3-large` | `fp16` * | fp16 | 883.5 MB | default | `dtk models download open-jev-deberta-v3-large --variant fp16` |
-| `open-jev-deberta-v3-large` | `fp32` | fp32 | 1757.9 MB | quality | `dtk models download open-jev-deberta-v3-large --variant fp32` |
-| `open-jev-deberta-v3-large` | `q4` | q4 | 486.7 MB | edge | `dtk models download open-jev-deberta-v3-large --variant q4` |
-| `open-jev-deberta-v3-large` | `q4f16` | q4/fp16 | 357.0 MB | edge | `dtk models download open-jev-deberta-v3-large --variant q4f16` |
-| `strands-decider-2b` | `q4f16` * | q4/fp16 | 1113.6 MB | default | `dtk models download strands-decider-2b --variant q4f16` |
-| `strands-decider-2b` | `q8` | int8 | 1821.4 MB | quality | `dtk models download strands-decider-2b --variant q8` |
+| Model | Variant | REST alias | Quantization | Size | Role | Download |
+| --- | --- | --- | --- | ---: | --- | --- |
+| `gliner2.5-multi` | `fp16` * | `gliner2.5-multi@fp16` | fp16 | 577.1 MB | default | `dtk models download gliner2.5-multi --variant fp16` |
+| `gliner2.5-multi` | `fp32` | `gliner2.5-multi@fp32` | fp32 | 1131.9 MB | quality | `dtk models download gliner2.5-multi --variant fp32` |
+| `gliner2.5-decide` | `q4f16` * | `gliner2.5-decide@q4f16` | q4/fp16 | 523.5 MB | default | `dtk models download gliner2.5-decide --variant q4f16` |
+| `laya` | `q8` * | `laya@q8` | int8 | 527.9 MB | default | `dtk models download laya --variant q8` |
+| `julia-1` | `fp32` * | `julia-1@fp32` | fp32 | 618.2 MB | default | `dtk models download julia-1 --variant fp32` |
+| `opendecider-nano` | `q8f16` * | `opendecider-nano@q8f16` | int8/fp16 | 468.8 MB | default | `dtk models download opendecider-nano --variant q8f16` |
+| `opendecider-nano` | `fp16` | `opendecider-nano@fp16` | fp16 | 791.9 MB | quality | `dtk models download opendecider-nano --variant fp16` |
+| `laya-multilingual` | `fp16` * | `laya-multilingual@fp16` | fp16 | 681.8 MB | default | `dtk models download laya-multilingual --variant fp16` |
+| `laya-multilingual` | `fp32` | `laya-multilingual@fp32` | fp32 | 1325.6 MB | quality | `dtk models download laya-multilingual --variant fp32` |
+| `open-jev-deberta-v3-large` | `q4f16` | `open-jev-deberta-v3-large@q4f16` | q4/fp16 | 357.0 MB | edge | `dtk models download open-jev-deberta-v3-large --variant q4f16` |
+| `open-jev-deberta-v3-large` | `fp16` * | `open-jev-deberta-v3-large@fp16` | fp16 | 883.5 MB | default | `dtk models download open-jev-deberta-v3-large --variant fp16` |
+| `open-jev-deberta-v3-large` | `q4` | `open-jev-deberta-v3-large@q4` | q4 | 486.7 MB | edge | `dtk models download open-jev-deberta-v3-large --variant q4` |
+| `open-jev-deberta-v3-large` | `fp32` | `open-jev-deberta-v3-large@fp32` | fp32 | 1757.9 MB | quality | `dtk models download open-jev-deberta-v3-large --variant fp32` |
+| `strands-decider-2b` | `q4f16` * | `strands-decider-2b@q4f16` | q4/fp16 | 1113.6 MB | default | `dtk models download strands-decider-2b --variant q4f16` |
+| `strands-decider-2b` | `q8` | `strands-decider-2b@q8` | int8 | 1821.4 MB | quality | `dtk models download strands-decider-2b --variant q8` |
 
 Models with a single row have only one catalogued, verified build. That does
 not mean other conversions do not exist upstream; it means they have not passed
-the parity, hash and license gates for this catalog.
+the parity, hash and license checks for this catalog.
 
 ## One selection model across surfaces
 
@@ -202,7 +202,7 @@ The variant currently in use cannot be deleted.
 
 ## Why some models have only one variant
 
-The catalog is curated, not a mirror. A variant is admitted only with a pinned
+The catalog is verified, not a mirror. A variant is admitted only with a pinned
 revision, a real ONNX export, SHA256 per file, a clean license and measured
 parity/latency. An upstream repository may contain fp32, fp16, int8 or q4
 builds that are not in the toolkit because they have not been validated.

{decision_toolkit-0.4.0 → decision_toolkit-0.4.2}/docs/index.md

@@ -23,8 +23,7 @@ PyPI: <https://pypi.org/project/decision-toolkit/>
 - [Variants and quantization](VARIANTS.md) — every catalogued build and how to download/select it.
 - [Operations](OPERATIONS.md) — rate limits, metrics, tracing and runbook.
 - [Benchmarks](BENCH.md) — reproducible latency/parity/calibration.
-- [Models](models/README.md) — the curated catalog.
-- [Catalog proposal](CATALOG_PROPOSAL.md) — analysis and evidence for the latest model additions.
+- [Models](models/README.md) — the model catalog.
 - [Release](RELEASE.md) — build, TestPyPI/PyPI and Trusted Publishing.
 
 ## One example

{decision_toolkit-0.4.0 → decision_toolkit-0.4.2}/docs/models/README.md

@@ -1,8 +1,8 @@
 # Model cards
 
-Verified `m0` models. Each card documents the adapter contract, the real download,
-the measured evidence and the known limitations. Models that are not `m0` have no
-card on purpose: they are not part of the curated library yet.
+These are the models available through `decision-toolkit`. Each card explains
+how to load and use the model, its variants, the measured evidence and its
+known limitations.
 
 | Model | Adapter | Variants (default *) | Pinned | Latency (CPU) | Evidence |
 |---|---|---|---|---|---|
@@ -18,16 +18,5 @@ card on purpose: they are not part of the curated library yet.
 A `*` marks the default. To inspect sizes, hashes and exact commands, run
 `dtk models variants <id>` or read [Variants and quantization](../VARIANTS.md).
 
-Latencies above are the historical admission measurements. Reproducible
-post-warmup measurements and the exact command are in
-[BENCH.md](../BENCH.md).
-
-## What a card must contain
-
-1. Status and adapter (the model contract).
-2. Every catalogued variant: repo, files, quantization, download size and role.
-3. Measured evidence: latency on CPU, parity/accuracy against a named baseline.
-4. Known limitations (language, export layout, quantization, benchmark scope).
-5. A runnable usage example.
-6. Provenance of the export.
-7. The pinned revision and SHA256 per file, plus the verify/bench command.
+Latencies above are CPU measurements. Reproducible post-warmup measurements
+and the exact command are in [BENCH.md](../BENCH.md).

{decision_toolkit-0.4.0 → decision_toolkit-0.4.2}/docs/models/gliner2.5-decide.md

@@ -1,6 +1,5 @@
 # GLiNER2.5-Decide
 
-- **Status:** `m0` (verified end-to-end)
 - **Adapter:** `gliner2-decide` — fused graph with `[L]` label markers and `[SEP_STRUCT]`
 - **License:** Apache-2.0
 - **Parameters:** 340M · **Architecture:** DeBERTa-v3-large · **Language:** English only
@@ -54,6 +53,40 @@ in the toolkit; see [Variants and quantization](../VARIANTS.md).
 - Quantized q4f16; the fp16/fp32 builds may resolve the sentiment example differently.
 - The model card's examples are "potential outputs", not guarantees; validate on your data.
 
+## Loading each variant
+
+REST selects the quantization through the standard `model` field using the
+alias `gliner2.5-decide@variant`; there is no `variant` field in the request body.
+
+### `q4f16` (q4/fp16, default)
+
+**Library**
+
+```python
+from decision_toolkit import DecisionModel
+
+model = DecisionModel("gliner2.5-decide", variant="q4f16")
+```
+
+**CLI**
+
+```bash
+dtk models download gliner2.5-decide --variant q4f16
+dtk models use gliner2.5-decide --variant q4f16
+dtk decide --model gliner2.5-decide --variant q4f16 \
+  --state "..." --q 'urgent=noul:Is this urgent?'
+```
+
+**REST**
+
+```bash
+curl -s http://127.0.0.1:8000/v1/systemone \
+  -H "Content-Type: application/json" \
+  -d '{"model": "gliner2.5-decide@q4f16", "state": "...",
+       "questions": {"urgent": {"type": "noul",
+                     "instructions": "Is this urgent?"}}}}'
+```
+
 ## Usage
 
 ```bash