diff --git a/CHANGELOG.md b/CHANGELOG.md index 6809373..9d1ce91 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file. Format follows [Keep a Changelog](https://keepachangelog.com/). This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [0.6.1] - 2026-07-11 + +### Added + +- README "Reference deployment" note (Meaning Gradient section) and a matching + `coherence/meaning/embed.py` docstring addition: the lobes gateway serves an + `embedder` role, discoverable via `GET /capabilities` (lobes-cli >= 0.38 + advertises a client-reachable endpoint per role); consumers such as + colleague resolve the endpoint from lobes and inject `COHERENCE_EMBED_URL` / + `COHERENCE_EMBED_MODEL` when armed. Also notes that each meaning score is a + model-relative, anchor-defined measurement — the embedding model and + anchors are the score's reference frame (gauge), never a model-independent + absolute (issues #10, #11). Documentation only; no defaults, code behavior, or tests + changed. + ## [0.6.0] - 2026-07-07 ### Added diff --git a/README.md b/README.md index 8306553..e78d62c 100644 --- a/README.md +++ b/README.md @@ -178,6 +178,18 @@ environment error — an unreachable embedding endpoint makes `score` exit `2` with a hint naming `COHERENCE_EMBED_URL`, while the offline diagnostics still run. +### Reference deployment + +The lobes gateway serves an `embedder` role, discoverable via `GET /capabilities` +(lobes-cli >= 0.38 advertises a client-reachable endpoint per role). Consumers +such as colleague resolve the endpoint from lobes and inject +`COHERENCE_EMBED_URL` / `COHERENCE_EMBED_MODEL` when armed. + +Each meaning score is a model-relative, anchor-defined measurement: the +embedding model and anchors constitute the score's reference frame (gauge). +A score carries no model-independent semantics — it is a semantic measurement +declared relative to the chosen model and anchor set (issues #10, #11). + `coherence meaning score --json` emits exactly: ```json diff --git a/coherence/meaning/embed.py b/coherence/meaning/embed.py index 4532934..03a0a8d 100644 --- a/coherence/meaning/embed.py +++ b/coherence/meaning/embed.py @@ -15,6 +15,16 @@ Transport failures (connect/timeout/transport) are wrapped in :class:`~coherence.meaning.EmbedUnavailable` with an actionable message that names both environment variables; raw ``httpx`` errors never escape. + +Reference deployment: the lobes gateway serves an ``embedder`` role, discoverable +via ``GET /capabilities`` (lobes-cli >= 0.38 advertises a client-reachable endpoint +per role). Consumers such as colleague resolve the endpoint from lobes and inject +``COHERENCE_EMBED_URL`` / ``COHERENCE_EMBED_MODEL`` when armed. + +Each meaning score is a model-relative, anchor-defined measurement: the embedding +model and anchors constitute the score's reference frame (gauge). A score carries +no model-independent semantics — it is a semantic measurement declared relative to +the chosen model and anchor set (issues #10, #11). """ from __future__ import annotations diff --git a/pyproject.toml b/pyproject.toml index ca64553..98fcd12 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "coherence-cli" -version = "0.6.0" +version = "0.6.1" description = "Maintains information quality for agentic workflows — assesses the freshness, provenance, fidelity, and task-specific validity of claims, then refreshes or repairs degraded ones before agents consume them." readme = "README.md" license = "Apache-2.0" diff --git a/uv.lock b/uv.lock index 350d60b..e76d54e 100644 --- a/uv.lock +++ b/uv.lock @@ -85,7 +85,7 @@ wheels = [ [[package]] name = "coherence-cli" -version = "0.6.0" +version = "0.6.1" source = { editable = "." } dependencies = [ { name = "httpx" },