Nomad changes

.task/tools/docs.yml

@@ -0,0 +1,79 @@
+version: "3"
+
+includes:
+  _cfg:
+    taskfile: ../config/vars.yml
+    internal: true
+
+vars:
+  ALEF_SNIPPETS_TAG: v0.16.69
+
+tasks:
+  build:
+    desc: Build documentation
+    cmds:
+      - uv run --no-sync --group doc zensical build --clean
+
+  build:strict:
+    desc: Build documentation in strict mode (CI-equivalent)
+    cmds:
+      - uv run --no-sync --group doc zensical build --strict --clean
+
+  serve:
+    desc: Serve documentation locally with live reload
+    cmds:
+      - uv run --no-sync --group doc zensical serve
+
+  lint:links:
+    desc: Check links with lychee
+    cmds:
+      # docs/overrides/main.html contains Jinja template variables (e.g.
+      # `{{ page.edit_url }}`) that lychee interprets as broken local file
+      # links — skip that path; the rendered site is link-checked separately.
+      - lychee --offline --root-dir "$PWD/docs" --exclude-path "docs/overrides" docs/ README.md
+
+  lint:prose:
+    desc: Lint prose with textlint (via prek hook)
+    cmds:
+      - prek run textlint --all-files
+
+  snippets:install:
+    desc: Install alef CLI (which now includes the snippets subcommand) if missing
+    cmds:
+      - cmd: |
+          if ! command -v alef >/dev/null 2>&1; then
+            cargo install --locked --git https://github.com/kreuzberg-dev/alef --tag {{.ALEF_SNIPPETS_TAG}} alef-cli
+          fi
+        ignore_error: false
+
+  snippets:validate:
+    desc: Validate all docs/snippets via `alef snippets` (syntax level)
+    deps: ["snippets:install"]
+    cmds:
+      - alef snippets validate --snippets docs/snippets --level syntax --timeout 120 -j 4
+
+  snippets:validate:lang:
+    desc: "Validate snippets for one language (set LANG=dart|kotlin|swift|...)"
+    deps: ["snippets:install"]
+    cmds:
+      - alef snippets validate --snippets docs/snippets --level syntax --languages {{.LANG}} --timeout 120 -j 4
+    requires:
+      vars: [LANG]
+
+  snippets:list:
+    desc: List all snippets discovered under docs/snippets
+    deps: ["snippets:install"]
+    cmds:
+      - alef snippets list --snippets docs/snippets
+
+  snippets:audit:
+    desc: Audit snippet metadata and coverage
+    deps: ["snippets:install"]
+    cmds:
+      - alef snippets audit --snippets docs/snippets
+
+  snippets:gaps:
+    desc: Report missing snippet variants across languages
+    deps: ["snippets:install"]
+    cmds:
+      - alef snippets gaps --snippets docs/snippets