chore: add ci, publish workflow, and git hooks

Author: ClaudiuCeia

.github/workflows/ci.yml

@@ -0,0 +1,28 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Deno
+        uses: denoland/setup-deno@v2
+        with:
+          deno-version: v2.x
+
+      - name: Verify formatting
+        run: deno fmt --check
+
+      - name: Run linter
+        run: deno lint
+
+      - name: Run tests
+        run: deno test --ignore=npm

.github/workflows/publish.yml

@@ -0,0 +1,99 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish-jsr:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Setup Deno
+        uses: denoland/setup-deno@v2
+        with:
+          deno-version: v2.x
+
+      - name: Verify tag matches deno.json version
+        shell: bash
+        run: |
+          set -euo pipefail
+          tag="${GITHUB_REF_NAME}"
+          version="${tag#v}"
+          deno_version="$(node -p "require('./deno.json').version")"
+          if [[ "${deno_version}" != "${version}" ]]; then
+            echo "Tag '${tag}' does not match deno.json version '${deno_version}'."
+            exit 1
+          fi
+
+      - name: Verify formatting
+        run: deno fmt --check
+
+      - name: Lint
+        run: deno lint
+
+      - name: Test
+        run: deno test --ignore=npm
+
+      - name: Publish to JSR
+        run: npx jsr publish
+
+  github-release:
+    runs-on: ubuntu-latest
+    needs: [publish-jsr]
+
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Generate changelog
+        shell: bash
+        run: |
+          set -euo pipefail
+          tag="${GITHUB_REF_NAME}"
+
+          prev_tag="$(
+            git tag --list "v*" --sort=-version:refname \
+              | grep -v "^${tag}$" \
+              | head -n 1 || true
+          )"
+
+          {
+            echo "# ${tag}"
+            echo
+            if [[ -n "${prev_tag}" ]]; then
+              echo "Changes since ${prev_tag}:"
+              echo
+              git log --no-merges --pretty=format:"- %s (%h)" "${prev_tag}..${tag}"
+            else
+              echo "Changes:"
+              echo
+              git log --no-merges --pretty=format:"- %s (%h)" "${tag}"
+            fi
+            echo
+          } > RELEASE_NOTES.md
+
+      - name: Create GitHub release
+        uses: softprops/action-gh-release@v2
+        with:
+          name: ${{ github.ref_name }}
+          tag_name: ${{ github.ref_name }}
+          body_path: RELEASE_NOTES.md

README.md

@@ -394,6 +394,25 @@ import { formatCaret } from "jsr:@claudiu-ceia/exp";
 console.log(formatCaret("1 + ", 4));
 ```
 
+This package also exports a richer report-style formatter (used by the CLI):
+
+```ts
+import { formatDiagnosticReport } from "jsr:@claudiu-ceia/exp";
+
+console.log(
+  formatDiagnosticReport("1 + ", {
+    message: "expected expression at 1:4",
+    index: 4,
+  }),
+);
+```
+
+Diagnostics helpers exported from `mod.ts`:
+
+- `formatCaret` / `formatSpanCaret`
+- `formatDiagnosticCaret` (prefers `index`, falls back to `span.start`)
+- `formatDiagnosticReport` (Elm/OCaml-inspired report output)
+
 - `ExpParseError`: includes `index` (byte index into the input string)
 - `ExpEvalError`: includes `span` (AST span) and `steps` (budget counter)
 

deno.json

@@ -6,16 +6,25 @@
   },
   "publish": {
     "exclude": [
+      ".github/",
       "bench/",
+      "cli/",
+      "coverage/",
+      "scripts/",
       "tests/",
       "npm/"
     ]
   },
   "tasks": {
+    "fmt": "deno fmt",
+    "lint": "deno lint",
+    "test": "deno test --ignore=npm",
     "check": "deno fmt && deno lint && deno test --ignore=npm",
     "build:npm": "deno run -A scripts/build-npm.ts",
     "exp": "deno run -A cli/exp.ts",
-    "repl": "deno task exp -- repl"
+    "repl": "deno task exp -- repl",
+    "hooks:install": "ln -sf ../../scripts/pre-commit .git/hooks/pre-commit && chmod +x scripts/pre-commit",
+    "hooks:uninstall": "rm -f .git/hooks/pre-commit"
   },
   "imports": {
     "@std/assert": "jsr:@std/assert@^1.0.17",

scripts/pre-commit

@@ -0,0 +1,16 @@
+#!/bin/sh
+
+set -e
+
+echo "Running pre-commit checks..."
+
+echo "Formatting..."
+deno fmt --check
+
+echo "Linting..."
+deno lint
+
+echo "Testing..."
+deno test --ignore=npm
+
+echo "All checks passed!"