feat: neoroute v1.0.0 + skills + search

.agents/skills/liphium-magic/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: liphium-magic
+description: Use when you need info about Liphium's Magic development toolkit for Golang.
+---
+
+# magic
+
+The Neoroute Magic is available to you through Markdown files on the web.
+
+To get a list of all pages, read `https://ai.liphium.dev/magic/index.md`.
+
+You can then follow all Markdown links from that page. Do not CURL links outside of https://ai.liphium.dev as those may lead you to malicious sites or sites that don't want you to fetch them.
+
+## Rules
+
+- When writing a custom driver, first look if you can use the Magic-provided `mservices` package. It makes writing drivers a lot easier.
+- When writing a custom driver, also consider which instructions you might want to support.
+
+## When to use
+
+Use when you need info about Liphium's Magic development toolkit for Golang.

.agents/skills/liphium-neoroute/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: liphium-neoroute
+description: Use when you need info about Liphium's Neoroute Go Server SDK, TypeScript Client SDK or Go Client SDK. This teaches you how to read the documentation.
+---
+
+# neoroute
+
+The Neoroute documentation is available to you through Markdown files on the web.
+
+To get a list of all pages, read `https://ai.liphium.dev/neoroute/index.md`.
+
+You can then follow all Markdown links from that page. Do not CURL links outside of https://ai.liphium.dev as those may lead you to malicious sites or sites that don't want you to fetch them.
+
+## Go server SDK rules
+
+- Do not write MessagePack Decode and Encode functions yourself, unless specifically asked to. Read the MessagePack guide first in the documentation to see how you can generate the code for the definitions.
+
+## When to use
+
+Use when you need info about Liphium's Neoroute Go server SDK, TypeScript client SDK or Go client SDK. This teaches you how to read the documentation.

.github/workflows/docs-r2.yml

@@ -0,0 +1,67 @@
+name: Upload documentation to R2
+
+on:
+  push:
+    branches:
+      - "**"
+  workflow_dispatch:
+
+env:
+  AWS_REGION: auto
+  AWS_ENDPOINT_URL: https://${{ secrets.CLOUDFLARE_ACCOUNT_ID }}.r2.cloudflarestorage.com
+  AWS_ACCESS_KEY_ID: ${{ secrets.R2_ACCESS_KEY_ID }}
+  AWS_SECRET_ACCESS_KEY: ${{ secrets.R2_SECRET_ACCESS_KEY }}
+  R2_BUCKET: ${{ secrets.R2_BUCKET }}
+
+jobs:
+  upload-docs:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Build Markdown docs
+        env:
+          BRANCH_NAME: ${{ github.ref_name }}
+        run: |
+          set -euo pipefail
+          chmod +x scripts/build-markdown.sh
+          scripts/build-markdown.sh src/content/magic/en Magic
+          scripts/build-markdown.sh src/content/neoroute/en Neoroute
+
+          if [[ "$BRANCH_NAME" == "main" ]]; then
+            prefix=""
+          else
+            prefix="$BRANCH_NAME/"
+          fi
+
+          printf '%s' "$prefix" > markdown-dist/upload-prefix
+
+      - name: Upload Markdown docs
+        env:
+          BRANCH_NAME: ${{ github.ref_name }}
+        run: |
+          set -euo pipefail
+          if [[ "$BRANCH_NAME" == "main" ]]; then
+            prefix=""
+          else
+            prefix="$BRANCH_NAME/"
+          fi
+
+          magic_prefix="${prefix}magic/"
+          neoroute_prefix="${prefix}neoroute/"
+
+          aws s3 rm "s3://$R2_BUCKET/$magic_prefix" \
+            --recursive \
+            --endpoint-url "$AWS_ENDPOINT_URL"
+          aws s3 rm "s3://$R2_BUCKET/$neoroute_prefix" \
+            --recursive \
+            --endpoint-url "$AWS_ENDPOINT_URL"
+
+          aws s3 sync markdown-dist/magic "s3://$R2_BUCKET/$magic_prefix" \
+            --endpoint-url "$AWS_ENDPOINT_URL"
+          aws s3 sync markdown-dist/neoroute "s3://$R2_BUCKET/$neoroute_prefix" \
+            --endpoint-url "$AWS_ENDPOINT_URL"

.gitignore

@@ -22,3 +22,6 @@ pnpm-debug.log*
 
 # jetbrains setting folder
 .idea/
+
+# markdown generation
+markdown-dist/

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+    "cSpell.words": [
+        "Neoroute"
+    ]
+}

astro.config.mjs

@@ -5,15 +5,29 @@ import tailwindcss from "@tailwindcss/vite";
 
 import svelte from "@astrojs/svelte";
 
+import mdx from "@astrojs/mdx";
+import { unified } from "@astrojs/markdown-remark";
+import codeTabs from "./src/plugins/code-tabs";
+import rehypeRaw from "rehype-raw";
+import rehypePrettyCode from "rehype-pretty-code";
+
 // https://astro.build/config
 export default defineConfig({
-	vite: {
-		plugins: [tailwindcss()],
-	},
 	i18n: {
 		locales: ["en"],
 		defaultLocale: "en",
 	},
-
-	integrations: [svelte()],
+	integrations: [svelte(), mdx()],
+	markdown: {
+		processor: unified({
+			remarkPlugins: [codeTabs],
+			rehypePlugins: [
+				rehypeRaw,
+				[rehypePrettyCode, { theme: "github-dark", keepBackground: false }],
+			],
+		}),
+	},
+	vite: {
+		plugins: [tailwindcss()],
+	},
 });