Add docs-tools: lint, image optimization, OG generation

- package.json with docs-lint, docs-images, docs-og scripts
- GitHub Actions workflow for CI lint + image optimization
- Pre-push hook via postinstall
- .gitignore: node_modules, .docs-tools

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: spicyfalafel

.github/workflows/docs.yml

@@ -0,0 +1,42 @@
+name: docs
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - run: bun install
+      - run: bun lint
+
+  images:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - run: bun install
+      - run: bun images:optimize
+      - run: bun og:generate
+
+      - name: Commit optimized assets
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add assets/ docs/
+          git diff --cached --quiet || git commit -m "chore: optimize images + generate OG previews"
+          git push

.gitignore

@@ -3,3 +3,7 @@
 *~
 .idea/
 .vscode/
+
+# docs-tools
+node_modules/
+.docs-tools/

bun.lock

@@ -0,0 +1,19 @@
+{
+  "name": "formbox-docs",
+  "private": true,
+  "scripts": {
+    "postinstall": "install-hooks",
+    "lint": "docs-lint",
+    "lint:check": "docs-lint --check",
+    "lint:json": "docs-lint --json",
+    "images:check": "docs-images check",
+    "images:optimize": "docs-images optimize",
+    "images:dry-run": "docs-images optimize --dry-run",
+    "og:generate": "docs-og generate",
+    "og:dry-run": "docs-og generate --dry-run",
+    "og:diff": "docs-og generate --diff"
+  },
+  "devDependencies": {
+    "docs-tools": "github:HealthSamurai/docs-tools"
+  }
+}