baraline · baraline · Sep 2, 2026 · Aug 17, 2026 · Aug 17, 2026 · Aug 17, 2026
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -135,9 +135,10 @@ jobs:
       # easyvista_python_client.__version__ -- and the git tag is a third. PyPI
       # takes whatever pyproject says, so a tag that disagrees publishes a
       # release nobody can find by version, and a __version__ that disagrees
-      # misreports at runtime. Both are unfixable after upload. Tags in this
-      # repo are v-prefixed (see the CHANGELOG compare links), so the leading v
-      # is stripped before comparing.
+      # misreports at runtime. Both are unfixable after upload. The repo's only
+      # existing tag, 0.1.0, is UNPREFIXED; v-prefixing starts at v0.2.0. The
+      # leading v is therefore stripped before comparing, so both forms
+      # validate.
       - name: Validate release tag matches package version
         if: github.event_name == 'release'
         shell: bash

diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/README.md b/README.md
@@ -2,15 +2,16 @@
 
 [![CI](https://github.com/baraline/easyvista_python_client/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/baraline/easyvista_python_client/actions/workflows/ci.yml)
 [![Coverage](https://codecov.io/gh/baraline/easyvista_python_client/branch/main/graph/badge.svg)](https://codecov.io/gh/baraline/easyvista_python_client)
-[![License](https://img.shields.io/github/license/baraline/easyvista_python_client)](LICENSE)
+[![License](https://img.shields.io/github/license/baraline/easyvista_python_client)](https://github.com/baraline/easyvista_python_client/blob/main/LICENSE)
 [![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://github.com/baraline/easyvista_python_client)
 [![Docs](https://readthedocs.org/projects/easyvista-python-client/badge/?version=latest)](https://easyvista-python-client.readthedocs.io/en/latest/)
 
 
 Typed Python client for the EasyVista Service Manager REST API. Sync + async,
 Pydantic models, Bearer or Basic auth.
 
-While the package is preparing for 1.0, alot of potential breaking change might happen between versions. A deprecation policy will be put in place once 1.0 is out and the package have been stabilized.
+While the package is preparing for 1.0, breaking changes may land between
+minor versions; a deprecation policy will follow the 1.0 release.
 
 ## Documentation
 
@@ -78,6 +79,7 @@ from easyvista_python_client import (
     EasyvistaClient,
     EasyvistaConfig,
     PostAsset,
+    ev_contains_filter,
     ev_equals_filter,
 )
 
@@ -86,6 +88,13 @@ with EasyvistaClient(EasyvistaConfig.from_env()) as client:
     tag_filter = ev_equals_filter("ASSET_TAG", "LAPTOP-001")
     found = client.search_assets(search=tag_filter, max_rows=50)
 
+    # `~` needs an explicit wildcard to mean "contains" -- a bare value is exact
+    # match, identical to `:`. ev_contains_filter adds the wildcard for you, and
+    # raises ValueError if the value itself carries one of * % _ [ (all four are
+    # metacharacters to `~`, with no escape). For an exact match on a tag like
+    # "LAPTOP_01", use ev_equals_filter: `:` does not expand a wildcard.
+    partial = client.search_assets(search=ev_contains_filter("ASSET_TAG", "LAPTOP"))
+
     # attach a file to a ticket (uploaded as base64 inside the JSON body)
     pdf = Path("report.pdf")
     client.add_document("I240101_0001", filename=pdf.name, content=pdf.read_bytes())
@@ -112,19 +121,19 @@ then call `EasyvistaConfig.from_env()`.
 `skills/` holds Agent Skills for driving this client from an AI agent — one per
 domain (client setup, search syntax, tickets, actions, documents, assets,
 directory, reporting and context). Each is a directory with a `SKILL.md`
-following the Agent Skills specification; see [skills/README.md](skills/README.md)
+following the Agent Skills specification; see [skills/README.md](https://github.com/baraline/easyvista_python_client/blob/main/skills/README.md)
 for the index.
 
 They are source-tree material: present in the git repository and the source
 distribution, absent from the installed wheel.
 
 ## Contributing
 
-See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and quality checks.
+See [CONTRIBUTING.md](https://github.com/baraline/easyvista_python_client/blob/main/CONTRIBUTING.md) for development setup and quality checks.
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+MIT — see [LICENSE](https://github.com/baraline/easyvista_python_client/blob/main/LICENSE).
 
 ## Sponsoring
 

diff --git a/docs/api_reference.rst b/docs/api_reference.rst
@@ -26,6 +26,8 @@ Models
 
 .. autoclass:: easyvista_python_client.models.action.PostAction
 
+.. autoclass:: easyvista_python_client.models.action.ActionUpdate
+
 .. autoclass:: easyvista_python_client.models.asset.Asset
 
 .. autoclass:: easyvista_python_client.models.asset.PostAsset
@@ -61,17 +63,35 @@ Filters
 -------
 
 Build ``search`` expressions with these rather than f-strings: EasyVista ignores a filter it cannot
-parse and returns every record, and ``,`` combines conditions — so an unescaped value fails silently
-or widens the result rather than raising.
+parse and returns every record, ``,`` combines conditions so an unescaped value can silently widen
+the result, and there is no comparison operator — a range must be expressed as an interval.
 
 .. autofunction:: easyvista_python_client.filters.ev_equals_filter
 
 .. autofunction:: easyvista_python_client.filters.ev_in_filter
 
+.. autofunction:: easyvista_python_client.filters.ev_contains_filter
+
+.. autofunction:: easyvista_python_client.filters.ev_starts_with_filter
+
+.. autofunction:: easyvista_python_client.filters.ev_since_filter
+
+.. autofunction:: easyvista_python_client.filters.ev_between_filter
+
 .. autofunction:: easyvista_python_client.filters.escape_ev_value
 
 .. autofunction:: easyvista_python_client.filters.is_safe_ev_value
 
+Timestamps
+----------
+
+EasyVista's timestamp format, parsed and rendered in one place — see
+:ref:`timestamps` for how the read models use these.
+
+.. autofunction:: easyvista_python_client.timestamps.parse_ev_datetime
+
+.. autofunction:: easyvista_python_client.timestamps.format_ev_datetime
+
 References
 ----------
 

diff --git a/docs/publishing.rst b/docs/publishing.rst
@@ -12,15 +12,26 @@ the workflow's OIDC identity.
 Cutting a release
 -----------------
 
-#. Bump the version in **both** places -- ``pyproject.toml`` (``project.version``) and
-   ``easyvista_python_client.__version__``. The release workflow refuses to build if they
-   disagree, or if they disagree with the tag.
+#. Bump the version in **all four** places, or CI goes red on an otherwise correct
+   bump:
+
+   * ``pyproject.toml`` (``project.version``);
+   * ``easyvista_python_client.__version__``;
+   * the hardcoded literal in ``easyvista_python_client/testing/test_public_api.py``
+     (asserted by the unit suite);
+   * every ``skills/*/SKILL.md`` ``metadata.version`` (asserted by
+     ``scripts/tests/test_skills_contract.py``).
+
+   The release workflow additionally refuses to build if the first two disagree with
+   each other or with the tag.
 #. Move the ``CHANGELOG.md`` ``[Unreleased]`` entries under the new version and update the
    compare links at the bottom of the file.
 #. Merge to ``main`` and let CI go green.
 #. Publish a GitHub release whose tag is the version, ``v``-prefixed --
    ``v0.2.0`` for version ``0.2.0``. (The workflow strips a leading ``v`` before comparing,
-   so an unprefixed tag also passes; the repository's existing tags are prefixed.)
+   so an unprefixed tag also passes. The only tag that exists today, ``0.1.0``, is
+   **unprefixed** -- ``v``-prefixing starts at ``v0.2.0``, which is why the
+   ``CHANGELOG.md`` link for ``0.1.0`` points at the bare tag.)
 
 The workflow then runs the test matrix (3.10--3.14) and the quality gates -- Ruff, mypy,
 the generated-``_sync``-tree check, the hand-written-twin lint and a warnings-as-errors