Rewrite Using AI

.circleci/config.yml

@@ -1,96 +1,33 @@
-# Ruby CircleCI 2.0 configuration file
-#
-# Check https://circleci.com/docs/2.0/language-ruby/ for more details
-#
-version: 2
+version: 2.1
 jobs:
-  build:
+  build_website:
     docker:
-      # specify the version you desire here
-       - image: cimg/ruby:2.5
-    environment:
-      BUNDLE_PATH: ~/vendor/bundle
-
-    working_directory: ~/repo
-
+      - image: cimg/node:lts
     steps:
       - checkout
       - run:
-          name: a merge PR
-          command: |
-            if [[ -n "${CIRCLE_PR_NUMBER}" ]]; then
-              git fetch origin +refs/pull/$CIRCLE_PR_NUMBER/merge:pr/$CIRCLE_PR_NUMBER/merge
-              git checkout -qf pr/$CIRCLE_PR_NUMBER/merge
-            fi
-
-      - run:
-          name: fetch submodules
-          command: git submodule init && git submodule update
-
-      # Download and cache dependencies
-      - restore_cache:
-          keys:
-          - rubygems-v1-latest
-
-      - run:
-          name: install dependencies
-          command: bundle check || bundle install --jobs=4 --retry=3
-
-      - run:
-          name: Jekyll build
-          command: bundle exec jekyll build -d html 2> std.err
-
-      - run:
-          name: Check Jekyll build
-          command: |
-            cat std.err
-            exit $(wc -l std.err | awk '{print $1}')
-
-      - run:
-          name: HTMLProofer tests
-          command: |
-            bundle exec htmlproofer ./html \
-              --allow-hash-href \
-              --check-html \
-              --disable-external \
-              --file-ignore "/.+\/gsoc\/display\/partials.+/"
-              # Ignores the path for the angular magic
-
+          name: Install dependencies
+          command: npm ci
       - run:
-          name: HTMLProofer with external
-          command: |
-            if [ "${CIRCLE_BRANCH}" = "main" ]; then
-             bundle exec htmlproofer ./html \
-               --allow-hash-href \
-               --check-html \
-               --file-ignore "/.+\/gsoc\/display\/partials.+/","/.+\/gsoc\/gsoc201[5-9].+/","/.+\/html/projects/201[5-9].+/","/.+\/gsoc\/gsoc202[0-2].+/","/.+\/html/projects/202[0-2].+/" \
-               --http-status-ignore 302
-               # Ignore old ideas pages and ssl certificates that error.
-            fi
-
-
+          name: Build site
+          command: npm run build
       - run:
-          name: Jekyll re-build for local
+          name: Patch asset paths for artifact viewer
+          # Astro emits processed assets at absolute /_astro/ paths. In CircleCI's
+          # artifact viewer these must be prefixed with the full artifact URL path.
+          # Navigation links and CSS use relative paths (fromSiteRoot) so they
+          # already resolve correctly and need no changes.
           command: |
-            echo "url: https://output.circle-artifacts.com" > circle.yml
-            bundle exec jekyll build -d html -b "/output/job/${CIRCLE_WORKFLOW_JOB_ID}/artifacts/0/html"  --config _config.yml,circle.yml
-            find ./html/ -type f -iname '*html' | xargs -I{} sed -i \
-              -e 's|href="\(\.\/.*\/\)"|href="\1index.html"|g' \
-              -e '/0\/html/ s|href="\(\/.*\/\)"|href="\1index.html"|g' {}
-            # Replace pages ending on `/` from our site to direct to index.html
-
-
-      - run:
-          name: "Built documentation is available at:"
-          command: DOCS_URL="${CIRCLE_BUILD_URL}/artifacts/${CIRCLE_NODE_INDEX}/html/index.html"; echo $DOCS_URL
-
-
-      - save_cache:
-          paths:
-            - ~/vendor/bundle
-          key: rubygems-v1-latest
-
-      # collect reports
+            node scripts/circleci-preview.mjs \
+              "/output/job/${CIRCLE_WORKFLOW_JOB_ID}/artifacts/${CIRCLE_NODE_INDEX}/html"
       - store_artifacts:
-          path: ~/repo/html
+          path: html
           destination: html
+      - run:
+          name: "Preview URL"
+          command: echo "https://output.circle-artifacts.com/output/job/${CIRCLE_WORKFLOW_JOB_ID}/artifacts/${CIRCLE_NODE_INDEX}/html/index.html"
+
+workflows:
+  preview_website:
+    jobs:
+      - build_website

.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: monthly

.github/workflows/ci.yml

@@ -0,0 +1,118 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  # --- parallel quality checks ---
+
+  format:
+    name: Formatting
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          cache: npm
+      - run: npm ci
+      - name: Check formatting
+        run: npm run format:check
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          cache: npm
+      - run: npm ci
+      - name: Lint source
+        run: npm run lint -- --max-warnings=0
+      - name: Lint Markdown
+        run: npm run lint:md
+
+  typecheck:
+    name: Type check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          cache: npm
+      - run: npm ci
+      - name: Astro type check
+        run: npm run astro:check
+
+  test:
+    name: Unit tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          cache: npm
+      - run: npm ci
+      - name: Run unit tests
+        run: npm test
+
+  # --- build (runs after all quality checks pass) ---
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    needs: [format, lint, typecheck, test]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          cache: npm
+      - run: npm ci
+      - name: Build site
+        run: npm run build
+      - name: Upload site artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: site
+          path: html/
+          retention-days: 1
+
+  # --- link checks (share the single build artifact) ---
+
+  linkcheck:
+    name: Link check (${{ matrix.mode }})
+    runs-on: ubuntu-latest
+    needs: build
+    strategy:
+      fail-fast: false
+      matrix:
+        mode:
+          - internal
+          - external
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          cache: npm
+      - run: npm ci
+      - name: Download site artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: site
+          path: html/
+      - name: Run link checks
+        run: npm run linkcheck:${{ matrix.mode }}

.gitignore

@@ -1,7 +1,10 @@
-*~
 _site/
-.sass-cache/
-Gemfile.lock
-vendor/
+.astro/
 .bundle
 .history
+.sass-cache/
+*~
+dist/
+html/
+node_modules/
+vendor/

.markdownlint-cli2.jsonc

@@ -0,0 +1,4 @@
+{
+  "globs": ["**/*.{md,mdx}"],
+  "ignores": ["**/node_modules/**", "**/html/**", "**/.history/**"],
+}

.markdownlint.json

@@ -0,0 +1,11 @@
+{
+  "MD013": false,
+  "MD033": false,
+  "MD041": false,
+  "MD024": {
+    "siblings_only": true
+  },
+  "MD025": {
+    "front_matter_title": ""
+  }
+}

.prettierignore

@@ -0,0 +1 @@
+html/

.prettierrc.cjs

@@ -0,0 +1,11 @@
+module.exports = {
+  plugins: ["prettier-plugin-astro"],
+  overrides: [
+    {
+      files: "*.astro",
+      options: {
+        parser: "astro",
+      },
+    },
+  ],
+};