Lefix2 · Lefix2 · Apr 30, 2026 · Apr 30, 2026 · Apr 30, 2026 · Apr 30, 2026
diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml
@@ -0,0 +1,56 @@
+name: GitHub Pages
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - '.github/workflows/pages.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    name: Deploy to GitHub Pages
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+
+      - name: Build site
+        run: |
+          mkdir -p _site
+          # Convert markdown to HTML with a minimal Jekyll-free approach using pandoc
+          sudo apt-get install -y pandoc > /dev/null 2>&1
+          pandoc docs/index.md \
+            --standalone \
+            --metadata title="CodeClimate Visualiser — Technical Docs" \
+            --css https://cdnjs.cloudflare.com/ajax/libs/github-markdown-css/5.5.1/github-markdown-dark.min.css \
+            --html-q-tags \
+            -o _site/index.html
+          # Embed body in a centred container
+          sed -i 's/<body>/<body><article class="markdown-body" style="max-width:900px;margin:40px auto;padding:0 24px">/' _site/index.html
+          sed -i 's/<\/body>/<\/article><\/body>/' _site/index.html
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: _site
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -4,26 +4,49 @@ on:
   push:
     tags:
       - 'v*'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to package (e.g. 1.2.3) — defaults to latest git tag'
+        required: false
+      publish:
+        description: 'Publish to VS Code Marketplace'
+        required: false
+        default: 'true'
+        type: choice
+        options: ['true', 'false']
 
 jobs:
   release:
-    name: Build, Test & Release
+    name: Package & Publish
     runs-on: ubuntu-latest
     permissions:
       contents: write
 
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
 
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
+      - uses: actions/setup-node@v4
         with:
           node-version: '20'
           cache: npm
 
       - name: Install dependencies
         run: npm ci
 
+      - name: Sync version
+        run: |
+          if [[ "$GITHUB_REF" == refs/tags/v* ]]; then
+            npm version --no-git-tag-version "${GITHUB_REF_NAME#v}"
+          elif [[ -n "${{ github.event.inputs.version }}" ]]; then
+            npm version --no-git-tag-version "${{ github.event.inputs.version }}"
+          else
+            LATEST=$(git tag --sort=-v:refname | grep -E '^v[0-9]' | head -1)
+            [[ -n "$LATEST" ]] && npm version --no-git-tag-version "${LATEST#v}"
+          fi
+
       - name: Compile TypeScript
         run: npm run compile
 
@@ -33,8 +56,22 @@ jobs:
       - name: Package extension
         run: npm run package
 
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v2
-        with:
-          files: '*.vsix'
-          generate_release_notes: true
+      - name: Create GitHub Release if absent
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: gh release view "$GITHUB_REF_NAME" || gh release create "$GITHUB_REF_NAME" --generate-notes
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Upload VSIX to GitHub Release
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: gh release upload "$GITHUB_REF_NAME" *.vsix --clobber
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Publish to VS Code Marketplace
+        if: >
+          (github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')) ||
+          (github.event_name == 'workflow_dispatch' && github.event.inputs.publish == 'true')
+        env:
+          VSCE_PAT: ${{ secrets.VSCE_PAT }}
+        run: npm run publish
diff --git a/.github/workflows/semantic-release.yml b/.github/workflows/semantic-release.yml
@@ -0,0 +1,43 @@
+name: Semantic Release
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  release:
+    name: Semantic Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      issues: write
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Compile TypeScript
+        run: npm run compile
+
+      - name: Run tests
+        run: npm test
+
+      - name: Semantic Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GIT_AUTHOR_NAME: github-actions[bot]
+          GIT_AUTHOR_EMAIL: github-actions[bot]@users.noreply.github.com
+          GIT_COMMITTER_NAME: github-actions[bot]
+          GIT_COMMITTER_EMAIL: github-actions[bot]@users.noreply.github.com
+        run: npx semantic-release
diff --git a/.releaserc.json b/.releaserc.json
@@ -0,0 +1,9 @@
+{
+  "branches": ["main"],
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    ["@semantic-release/npm", { "npmPublish": false }],
+    ["@semantic-release/github", { "assets": [] }]
+  ]
+}
diff --git a/.vscode/launch.json b/.vscode/launch.json
@@ -7,7 +7,7 @@
       "request": "launch",
       "args": ["--extensionDevelopmentPath=${workspaceFolder}", "${workspaceFolder}/testdata"],
       "outFiles": ["${workspaceFolder}/out/**/*.js"],
-      "preLaunchTask": "${defaultBuildTask}"
+      "preLaunchTask": "Build & seed history"
     }
   ]
 }
diff --git a/.vscode/tasks.json b/.vscode/tasks.json
@@ -2,16 +2,27 @@
   "version": "2.0.0",
   "tasks": [
     {
+      "label": "npm: compile",
       "type": "npm",
       "script": "compile",
-      "group": {
-        "kind": "build",
-        "isDefault": true
-      },
-      "presentation": {
-        "reveal": "silent"
-      },
+      "group": { "kind": "build", "isDefault": true },
+      "presentation": { "reveal": "silent" },
       "problemMatcher": "$tsc"
+    },
+    {
+      "label": "Seed test snapshots",
+      "type": "shell",
+      "command": "node scripts/gen-test-snapshots.js",
+      "presentation": { "reveal": "silent", "panel": "shared" },
+      "problemMatcher": []
+    },
+    {
+      "label": "Build & seed history",
+      "dependsOrder": "sequence",
+      "dependsOn": ["npm: compile", "Seed test snapshots"],
+      "group": { "kind": "build", "isDefault": false },
+      "presentation": { "reveal": "silent" },
+      "problemMatcher": []
     }
   ]
 }
diff --git a/.vscodeignore b/.vscodeignore
@@ -4,8 +4,13 @@ src/**
 testdata/**
 out/**/*.map
 node_modules/**
+!node_modules/@vscode/codicons/dist/codicon.css
+!node_modules/@vscode/codicons/dist/codicon.ttf
 **/.gitignore
 **/.vscodeignore
 tsconfig.json
 *.vsix
 .claude/**
+tmp_for_claude/**
+media/icon-color.svg
+docs/**