Merge pull request #2 from synadia-labs/claude/add-taskfile-and-gh-actions-6mflx

Add Taskfile.yaml and CI workflow

Author: philpennock

.github/workflows/ci.yaml

@@ -0,0 +1,41 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          persist-credentials: false
+      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+        with:
+          node-version-file: .tool-versions
+          cache: npm
+      - run: npm ci
+      - uses: tree-sitter/setup-action@eeb902ac2f1be576edc296309872cf476a209b7f # v2
+        with:
+          install-lib: false
+      - uses: arduino/setup-task@b91d5d2c96a56797b48ac1e0e89220bf64044611 # v2.0.0
+        with:
+          version: 3.x
+      - run: task ci:test
+
+  check-github:
+    name: Check GitHub Actions
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          persist-credentials: false
+      - name: Run zizmor
+        uses: zizmorcore/zizmor-action@71321a20a9ded102f6e9ce5718a2fcec2c4f70d8 # v0.5.2

.gitignore

@@ -6,6 +6,11 @@ build/
 prebuilds/
 target/
 
+tree-sitter-nats_server_conf.wasm
+libtree-*.a
+libtree-*.so
+src/*.o
+
 # OS files
 .DS_Store
 *.swp
@@ -18,3 +23,4 @@ target/
 
 # Logs
 *.log
+.task/

.tool-versions

@@ -0,0 +1 @@
+nodejs 22.16.0

README.md

@@ -24,15 +24,18 @@ The grammar handles the full NATS server configuration format:
 ```bash
 # Install dependencies
 npm install
+# This is more reliable than the npm approach, so we've split it out.
+# Assumes that you have rust/cargo installed and ~/.cargo/bin in $PATH already.
+command -v tree-sitter || cargo install tree-sitter-cli
 
 # Generate the parser
-npx tree-sitter generate
+tree-sitter generate
 
 # Run tests
-npx tree-sitter test
+tree-sitter test
 
 # Parse a file
-npx tree-sitter parse examples/basic.conf
+tree-sitter parse examples/basic.conf
 ```
 
 ## Building

Taskfile.yaml

@@ -0,0 +1,125 @@
+# https://taskfile.dev
+
+version: "3"
+
+vars:
+  TS: tree-sitter
+
+# Editor install tasks are intentionally omitted.
+#
+# All supported editors (Neovim, Helix, Emacs, VS Code, Zed, Nova) require
+# editing user configuration files (init.lua, languages.toml, init.el, etc.)
+# in addition to copying files.  Because there is no safe, idempotent way to
+# merge into an arbitrary user config, and getting it wrong could break the
+# user's editor setup, we do not automate these installs.  See docs/editors/
+# for per-editor instructions.
+
+tasks:
+  default:
+    desc: List available tasks
+    cmds:
+      - task --list
+
+  # ── Internal ───────────────────────────────────────────────────────
+
+  _check-tools:
+    internal: true
+    preconditions:
+      - sh: command -v node
+        msg: "node is not installed — install Node.js 22 LTS (see .tool-versions)"
+      - sh: |
+          major=$(node -p "process.versions.node.split(\".\")[0]")
+          test "$major" -ge 22 -a "$major" -lt 24
+        msg: >-
+          Node.js >=22, <24 is required (found {{.NODE_VERSION}}).
+          tree-sitter-cli 0.25.x does not work with Node 24+.
+          Use asdf, fnm, or nvm to switch: see .tool-versions
+      - sh: command -v tree-sitter
+        msg: >-
+          tree-sitter CLI is not installed.
+          Install via: cargo install tree-sitter-cli
+    vars:
+      NODE_VERSION:
+        sh: node --version 2>/dev/null || echo "not found"
+
+  _npm-deps:
+    internal: true
+    sources:
+      - package.json
+      - package-lock.json
+    generates:
+      - node_modules/.package-lock.json
+    cmds:
+      - npm ci
+
+  # ── Build ──────────────────────────────────────────────────────────
+
+  generate:
+    desc: Regenerate the parser from the grammar
+    deps: [_check-tools, _npm-deps]
+    sources:
+      - grammar.js
+    generates:
+      - src/parser.c
+    cmds:
+      - "{{.TS}} generate"
+
+  build:
+    desc: Build the shared and static C libraries
+    deps: [generate]
+    cmds:
+      - make
+
+  clean:
+    desc: Remove build artifacts
+    cmds:
+      - make clean
+
+  # ── Test ───────────────────────────────────────────────────────────
+
+  test:
+    desc: Run the tree-sitter test corpus
+    deps: [_check-tools, _npm-deps, generate]
+    cmds:
+      - "{{.TS}} test"
+
+  test:parse-examples:
+    desc: Parse all example files and report errors
+    deps: [_check-tools, _npm-deps, generate]
+    cmds:
+      - "{{.TS}} parse examples/*.conf --stat"
+
+  # ── Install (system) ───────────────────────────────────────────────
+
+  install:
+    desc: Install the C library and query files system-wide (may need sudo)
+    deps: [build]
+    cmds:
+      - make install
+
+  uninstall:
+    desc: Remove the system-wide installation (may need sudo)
+    cmds:
+      - make uninstall
+
+  # ── CI ─────────────────────────────────────────────────────────────
+
+  ci:
+    desc: Run all CI checks
+    cmds:
+      - task: ci:test
+      - task: ci:check-github
+
+  ci:test:
+    desc: Build, test, and parse examples (used in CI)
+    cmds:
+      - task: test
+      - task: test:parse-examples
+
+  ci:check-github:
+    desc: Validate GitHub Actions workflows with zizmor
+    preconditions:
+      - sh: command -v zizmor
+        msg: "zizmor is not installed — pip install zizmor"
+    cmds:
+      - zizmor --format plain .github/workflows/

docs/editors/vscode.md

@@ -6,6 +6,12 @@ This guide explains how to add NATS server configuration file support to Visual
 
 The [anycode extension](https://marketplace.visualstudio.com/items?itemName=nicolo-ribaudo.vscode-anycode) provides tree-sitter support in VS Code.
 
+This relies upon the tree-sitter command (install however you wish, we show
+this assuming the `cargo` command) and the `tree-sitter build --wasm` step
+relies upon being able to run an OCI image (`emscripten/emsdk`); this will
+implicitly require `docker` or `podman` or some other command which
+tree-sitter supports for that invocation.
+
 ### Setup
 
 1. Install the anycode extension
@@ -15,8 +21,9 @@ The [anycode extension](https://marketplace.visualstudio.com/items?itemName=nico
    ```
 3. Build the WASM module:
    ```bash
-   cd tree-sitter-nats-server-conf
-   npx tree-sitter build --wasm
+   cd treesitter-nats-server
+   command -v tree-sitter || cargo install tree-sitter-cli
+   tree-sitter build --wasm
    ```
 4. Configure anycode in your VS Code `settings.json`:
    ```json