The week of August 31, 2026 was a focused one: a single Annie theme in the Anyshift Product Updates series, precision for graph queries, delivered across Annie CLI, Graph API, and the Graph SDK.
Graph API shipped 3 releases during the window, from v0.2.87 to v0.2.89, and the change is now live in production.
Annie CLI v0.8.56 updates 3 graph tools: timeline, brief, and blast.
Last week added Cloudflare origin reachability and Annie CLI update checks. This week is about asking the graph sharper questions.
Exact time windows for graph queries
annie graph timeline now accepts paired --from and --until flags for an absolute historical window, alongside the existing relative --since.
annie graph timeline payments-api \
--from 2026-08-24T00:00:00Z \
--until 2026-08-31T00:00:00ZThe window is half-open: --from is inclusive, --until is exclusive. Graph API validates the pair and rejects partial, reversed, or mixed relative and absolute windows with a 400. Bounded queries return page-only statistics and keyset cursors, so a single page is never mistaken for the complete set.
The same bounding applies to alert-cause evidence. Graph API binds an alert cause to the exact incident interval and drops name-prefix correlation, so triage no longer surfaces unbounded change lists for an alert.
Precise resource selectors for multi-cluster projects
annie graph brief and annie graph blast now take shared --id, --type, --namespace, and --cluster flags in addition to a positional name.
annie graph brief checkout \
--type K8S_DEPLOYMENT \
--namespace apps \
--cluster stagingbrief resolves its subject once before fan-out. A missing or ambiguous subject fails immediately with at most ten candidates, instead of triggering repeated ambiguity across every downstream section. On projects that span two or more clusters, a qualified selector resolves one canonical, tenant-scoped resource.
Graph Query Language 1.22
Graph Query Language is the versioned query catalog embedded in Annie CLI and published with the Graph SDK and the Graph API OpenAPI contract. The reference moved to version 1.22 this week, regenerated from the reviewed contract with absolute event windows, exact selectors, and bounded alert-cause examples. Annie CLI v0.8.56 pins and validates 1.22, and its named graph commands (search, types, deps, changes, history, owners) now map onto the canonical project-scoped queries.
FAQ
What shipped at Anyshift the week of August 31, 2026?
One customer-facing theme: precision for graph queries. Annie CLI v0.8.56 graph timeline takes paired --from and --until flags for an exact historical window, and graph brief and graph blast accept stable IDs plus type, namespace, and cluster selectors. The Graph Query Language reference, shared by Annie CLI, Graph API, and the Graph SDK, is now at version 1.22.
How do I query an exact time window with Annie CLI?
Run annie graph timeline <resource> --from 2026-08-24T00:00:00Z --until 2026-08-31T00:00:00Z. The window is half-open, so --from is inclusive and --until is exclusive. The existing relative --since workflow is unchanged, and Graph API returns page-only statistics for the bounded query.
What are qualified selectors in the Anyshift graph?
A qualified selector pins a resource by its stable ID or by type, namespace, and cluster instead of a bare name. annie graph brief and annie graph blast resolve the subject once before fan-out, so an ambiguous name fails fast with a bounded candidate list rather than after a long workflow. This matters most on projects that span more than one Kubernetes cluster.
What is Graph Query Language 1.22?
Graph Query Language is the versioned query catalog embedded in Annie CLI and published with the Graph SDK and Graph API OpenAPI contract. Version 1.22 regenerates the full reference with absolute event windows, exact selectors, and bounded alert-cause examples. Annie CLI v0.8.56 pins and validates 1.22.
Do I need to upgrade Annie CLI?
Yes, the --from, --until, and qualified selector flags ship in Annie CLI v0.8.56. Upgrade with annie update or reinstall from the install page, then run annie update check to confirm the version. Graph API is already deployed with the matching contract.
Full query reference is at docs.anyshift.io, and you can drive all of it from app.anyshift.io.
