Repository navigation
Releases
Releases · kksat/zals
v0.3.1
Immutable
release. Only release title and notes can be modified.
0.3.1 (2026-11-05)
Fixed
- Install the 0.3.0 feature set as 0.3.1. This release provides the binary
archives, Python wheels, and platform-specific VS Code packages missing from
the 0.3.0 GitHub release. Use 0.3.1 for installations and upgrades. There are
no language-server feature or editor interaction changes from
0.3.0.
v0.3.0
Immutable
release. Only release title and notes can be modified.
0.3.0 (2026-11-04)
Added
- Rename a root variable across its Workspace. Use your editor's Rename
action on a variable read or binding, such as{{ app_port }}or
app_port: 8080, to update same-named reads and bindings in playbooks, roles,
templates, loaded variable files, and argument specs. Unsaved buffers are
included, and quoted YAML bindings retain their surrounding quotes. Rename
matches by name across the owning Workspace, not by Ansible runtime scope:
review the edits when unrelated roles reuse a name. Reads without a known
definition can also be renamed, but definitions supplied outside the searched
files, such as inventory or extra vars, need a separate update. - Rename with explicit boundaries. Rename requires a Workspace root marker
(by default,.git) and a completed index; wait for indexing and retry if the
server reports that it is still loading. Installed collections and excluded
files are not edited. Field names such asservice.port, runtime-supplied
names such asitemandansible_user, and role or file references are not
rename targets. Invalid identifiers, reserved names, and names already used
by another variable are rejected. See the
variable navigation scope guide.
Changed
- Keep editor requests available during validation. Lint, syntax-check
fallback, and schema validation run in the background instead of blocking
request handling. Diagnostics are published when validation completes. - Read the same release notes in VS Code and on GitHub. The extension now
includes a changelog, and GitHub releases use the matching user-facing notes.
Detailed commit history remains available in
TECHNICAL_CHANGELOG.md.
Fixed
- Keep metadata out of variable navigation. Keys in
galaxy.yml,
requirements.yml, Molecule configuration, YAML inventories, and other
unrelated YAML maps no longer appear as variable definitions or structured
fields unless the file is in a recognized variable directory or statically
loaded as variable data. Role defaults and vars,group_vars/,host_vars/,
vars/, and statically loaded variable files remain navigable. For files used
only through dynamic loads,include_vars: dir:, or-e @file, put them under
vars/and update the Ansible load paths if you need key-based navigation;
those load forms are not resolved. - Keep standalone playbook variables local. Without an owning Workspace,
playbooks in a role'smolecule/ortests/directories use their own bindings
and direct variable-file loads instead of the enclosing role's file set. Open
the owning Workspace if you need project-wide navigation. - Recognize fully qualified playbook imports.
ansible.builtin.import_playbookandansible.legacy.import_playbookare
treated as playbook entries rather than module tasks in hover, completion,
and outlines; task-only debug and extract actions are not offered there.
Variables passed on playbook imports no longer appear as definitions
belonging to the importing playbook. Navigation does not yet trace those
values into the imported plays. - Identify handlers in outlines and Workspace symbols. Tasks nested inside
handlerblock,rescue, andalwayssections retain handler labels. Handler
files belowroles/NAME/handlers/are recognized in subdirectories, without
mistaking unrelated ancestor folders namedhandlersfor handler files. - Use unsaved edits through symlinked folders. Workspace queries match open
documents to indexed files when the editor opens the project through a
symlink, rather than falling back to stale disk content. Saves and watched
deletions through the symlink also update the resolved Workspace index. - Refresh the Workspace after a root-marker change. Changing
ansible.workspace.rootMarkerschedules one rescan instead of duplicate
scans, even when the resolved root directory stays the same, so nested
Workspace boundaries use the selected marker. - Ignore Jinja call keyword names. A keyword such as
attributein
map(attribute='name')is no longer treated as a variable read or rename
target.
Known limitations
- Standalone roles outside a
roles/NAME/directory report handler files as
ordinary tasks in document outlines. Workspace symbol search still labels
these entries as handlers.
v0.2.0
0.2.0 (2026-10-16)
Features
- add workspace (e34846f)
- allow a configurable workspace root marker (57847c1)
- code-actions: add and remove debug statements for variables (ec23358)
- code-actions: extract tasks to a task file (1405b3f)
- code-actions: surround debug tasks with blank lines (3755dd3)
- collections: navigate collection references (9f70c43)
- config: resolve role and collection paths per file (6d01ef9)
- cursor: classify a document position once for hover, completion, and tokens (73abec5)
- docs: background prefetch, on-disk cache, and thread pool (94e6681)
- document-symbols: semantic outline for Ansible documents (3384b28)
- navigation: navigate task files and vars files (a702577)
- navigation: resolve concrete variable implementations (2ae4bbb)
- navigation: resolve fields by name and parsed keys (9cb40b6)
- navigation: resolve passed fields in callee path context (448adf3)
- parity: reach >=0.9 on all comparison cases (448e32e)
- recognize static quoted Jinja field subscripts (da9561e)
- release: add release-please, cross-platform binaries, Homebrew, and PyPI (06703e1)
- release: publish VSIXs to Marketplace and Open VSX (3007350)
- release: support explicit Marketplace PAT publishing (7171059)
- roles: find role references across the Workspace and hover roles (c9bdbac)
- roles: go-to-definition and go-to-implementation for roles (3925efe)
- roles: hover role parameters with their argument spec (e383036)
- roles: resolve roles in Ansible's search order (63d70ee)
- schema: support JSON Schema pattern via in-tree regex engine (3cf86b2)
- symbols: search Workspace symbols (c777dde)
- v1 implementation (c7c984d)
- variables: find references and go-to-definition for variables (4b3b7e1)
- variables: find variable references and definitions across the Workspace (9d40205)
- variables: hover variables with their active definition (e599740)
- vscode: add Zig ember extension icon (a1c1927)
- vscode: integrate bundled extension for 0.1.0 packaging (6da07ce)
- workspace: discover the Ansible files of a Workspace (3f88f20)
- workspace: expose collection module and plugin symbols (eecb5b8)
- workspace: keep a persistent Workspace index (cc4ec1e)
- yaml: add tree-sitter-yaml backend behind YamlParser seam (8ffe557)
Bug Fixes
- collections: normalize direct ansible_collections search paths (f1eb2d9)
- collections: search all selected venv installation layouts (c6a5bca)
- docs: isolate module lookup by effective per-file collection paths (20ed5b4)
- docs: run ansible-doc without a per-file cwd or ansible.cfg (c83ae0a)
- exclude called Jinja methods from field reads (50b19d2)
- exclude Jinja template filter-block names from navigation (5cba024)
- exclude qualified Jinja filter and test names from fields (d10f3e2)
- homebrew: capture version output in formula test (a737371)
- ignore escaped single-quoted Jinja field lookalikes (d330e30)
- ignore quoted Jinja closing delimiters (d489063)
- lsp: enforce queued writer ownership for outgoing messages (77b9cda)
- navigation: escape file URI paths and decode targets once (18d0fb0)
- navigation: exclude Jinja set field targets from reads (a738e8a)
- navigation: exclude quotes from escaped binding ranges (be72339)
- navigation: exclude raw-block literals from field reads (48648c6)
- navigation: honor Jinja whitespace preservation markers (b287931)
- navigation: make relative filesystem targets absolute file URIs (181d11a)
- navigation: match role references by resolved targets (dc8e47e)
- navigation: normalize YAML scalar quoting with source spans (5a873ed)
- navigation: preserve standalone role scope and variable precedence (8b2548c)
- navigation: rank loaded vars by their source (7e407ad)
- navigation: resolve passed role parameters in callee context (ce2470a)
- navigation: resolve variable definitions from binding keys (317b4ba)
- navigation: resolve variable loads like file links (4cb0582)
- navigation: resolve variable role invokers by directory (c71f1dc)
- navigation: retain explicit JSON callee vars loads (7f6f519)
- neovim: attach zals to collection variable files (d69b446)
- neovim: detect standalone role repositories (cff2140)
- perf: clear Darwin override before launching nested make (f2b96a8)
- performance: attest a narrow pinned baseline build repair (71b2ed2)
- preserve keyword-like Jinja member names ([dfc68bc](dfc68bc...
zals: v0.2.0
Immutable
release. Only release title and notes can be modified.
0.2.0 (2026-10-16)
Features
- add workspace (e34846f)
- allow a configurable workspace root marker (57847c1)
- code-actions: add and remove debug statements for variables (ec23358)
- code-actions: extract tasks to a task file (1405b3f)
- code-actions: surround debug tasks with blank lines (3755dd3)
- collections: navigate collection references (9f70c43)
- config: resolve role and collection paths per file (6d01ef9)
- cursor: classify a document position once for hover, completion, and tokens (73abec5)
- docs: background prefetch, on-disk cache, and thread pool (94e6681)
- document-symbols: semantic outline for Ansible documents (3384b28)
- navigation: navigate task files and vars files (a702577)
- navigation: resolve concrete variable implementations (2ae4bbb)
- navigation: resolve fields by name and parsed keys (9cb40b6)
- navigation: resolve passed fields in callee path context (448adf3)
- parity: reach >=0.9 on all comparison cases (448e32e)
- recognize static quoted Jinja field subscripts (da9561e)
- release: add release-please, cross-platform binaries, Homebrew, and PyPI (06703e1)
- release: publish VSIXs to Marketplace and Open VSX (3007350)
- release: support explicit Marketplace PAT publishing (7171059)
- roles: find role references across the Workspace and hover roles (c9bdbac)
- roles: go-to-definition and go-to-implementation for roles (3925efe)
- roles: hover role parameters with their argument spec (e383036)
- roles: resolve roles in Ansible's search order (63d70ee)
- schema: support JSON Schema pattern via in-tree regex engine (3cf86b2)
- symbols: search Workspace symbols (c777dde)
- v1 implementation (c7c984d)
- variables: find references and go-to-definition for variables (4b3b7e1)
- variables: find variable references and definitions across the Workspace (9d40205)
- variables: hover variables with their active definition (e599740)
- vscode: add Zig ember extension icon (a1c1927)
- vscode: integrate bundled extension for 0.1.0 packaging (6da07ce)
- workspace: discover the Ansible files of a Workspace (3f88f20)
- workspace: expose collection module and plugin symbols (eecb5b8)
- workspace: keep a persistent Workspace index (cc4ec1e)
- yaml: add tree-sitter-yaml backend behind YamlParser seam (8ffe557)
Bug Fixes
- collections: normalize direct ansible_collections search paths (f1eb2d9)
- collections: search all selected venv installation layouts (c6a5bca)
- docs: isolate module lookup by effective per-file collection paths (20ed5b4)
- docs: run ansible-doc without a per-file cwd or ansible.cfg (c83ae0a)
- exclude called Jinja methods from field reads (50b19d2)
- exclude Jinja template filter-block names from navigation (5cba024)
- exclude qualified Jinja filter and test names from fields (d10f3e2)
- homebrew: capture version output in formula test (a737371)
- ignore escaped single-quoted Jinja field lookalikes (d330e30)
- ignore quoted Jinja closing delimiters (d489063)
- lsp: enforce queued writer ownership for outgoing messages (77b9cda)
- navigation: escape file URI paths and decode targets once (18d0fb0)
- navigation: exclude Jinja set field targets from reads (a738e8a)
- navigation: exclude quotes from escaped binding ranges (be72339)
- navigation: exclude raw-block literals from field reads (48648c6)
- navigation: honor Jinja whitespace preservation markers (b287931)
- navigation: make relative filesystem targets absolute file URIs (181d11a)
- navigation: match role references by resolved targets (dc8e47e)
- navigation: normalize YAML scalar quoting with source spans (5a873ed)
- navigation: preserve standalone role scope and variable precedence (8b2548c)
- navigation: rank loaded vars by their source (7e407ad)
- navigation: resolve passed role parameters in callee context (ce2470a)
- navigation: resolve variable definitions from binding keys (317b4ba)
- navigation: resolve variable loads like file links (4cb0582)
- navigation: resolve variable role invokers by directory (c71f1dc)
- navigation: retain explicit JSON callee vars loads (7f6f519)
- neovim: attach zals to collection variable files (d69b446)
- neovim: detect standalone role repositories (cff2140)
- perf: clear Darwin override before launching nested make (f2b96a8)
- performance: attest a narrow pinned baseline build repair (71b2ed2)
- preserve keyword-like Jinja member names ([dfc68bc](dfc68bc...
v0.1.0
Immutable
release. Only release title and notes can be modified.
Full Changelog: https://github.com/kksat/zals/commits/v0.1.0