Reconcile a Cypher grammar / semantic-analysis artifact bump — the monthly "Automated update of artifacts" bot PR or any change to Cypher25*.g4 / semanticAnalysis.js. Covers regenerating and committing cypher.json, categorizing new lexer tokens, fixing completion/highlighting/formatting wiring, and updating tests. Use when working on an artifact-bump PR, when the build breaks after grammar files changed, or when CI fails the "TextMate grammar is up to date" check.
Inspect how a Cypher query is parsed by the ANTLR grammar — print the parse tree or token stream for any query straight from the .g4 grammar files, without building the project. Use when debugging why a query parses a certain way, investigating grammar/lexer behavior, checking which rule or token matches some syntax, or after a grammar bump.
How this repo versions and publishes — changesets in pre-release ("next") mode for the five npm packages, lint-worker's special neo4j-version dist-tag, canary snapshots, and the VS Code extension's separate tag-push stable + odd-minor pre-release flow. Use when asked about releasing, publishing, versioning, changesets, dist-tags, why a version looks odd, or why a merged change hasn't shipped. ADVISORY skill — never publish, push tags, or create changesets unless the user explicitly asks.
Run and debug the VS Code extension test suites — the API/unit tests (@vscode/test-electron + mocha + testcontainers Neo4j) and the webview tests (wdio) — including their prerequisites, the two-module-graph stubbing gotcha, the linter download cache, and known flakiness patterns. Use when a change touches packages/vscode-extension, or when asked to run, debug, or de-flake those suites.