test(triki-controller): vitest suite + CI test job on PR

.github/workflows/test.yml

@@ -0,0 +1,48 @@
+name: Test triki-controller
+
+# Unit tests for the publishable package. Runs only when the package (or this
+# workflow) changes, so docs-only PRs stay green without a redundant Node job.
+on:
+  pull_request:
+    paths:
+      - packages/triki-controller/**
+      - .github/workflows/test.yml
+  push:
+    branches: [main]
+    paths:
+      - packages/triki-controller/**
+      - .github/workflows/test.yml
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: packages/triki-controller
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          # This job runs PR-controlled install/test steps and needs no token;
+          # don't persist checkout credentials into the local git config.
+          persist-credentials: false
+
+      # Node 24 mirrors the publish workflow, so tests run on the same runtime
+      # that ships the package.
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: npm
+          cache-dependency-path: packages/triki-controller/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Typecheck
+        run: npm run typecheck
+
+      - name: Test
+        run: npm run test

packages/triki-controller/.gitignore

@@ -1,4 +1,5 @@
 node_modules/
 dist/
+coverage/
 *.tgz
 *.tsbuildinfo