eblume/blumeops
1
1
Fork 0
Code Issues Pull requests Projects Releases 83 Packages Wiki Activity Actions
blumeops/docs/reference/tools/mise-tasks.md
Erich Blume 4f0476a851
All checks were successful
Build Container / detect (push) Successful in 3s
Details
Build Container (Nix) / detect (push) Successful in 1s
Details
Build Container (Nix) / build (quartz) (push) Successful in 1s
Details
Build Container / build (quartz) (push) Successful in 10s
Details
Fix spider trap: disable SPA mode, remove index files, relax wiki-links (#290) 
## Summary

Fixes the Facebook crawler spider trap that's been generating infinite recursive URLs like `/how-to/tutorials/tutorials/how-to/explanation/...` for several days.

**Root cause:** Quartz SPA mode + nginx `try_files` fallback to `index.html` meant any fabricated URL returned the root HTML shell with HTTP 200. Crawlers followed relative links from those fake URLs, creating infinite recursion.

**Fix:**
- Disable Quartz SPA mode (`enableSPA: false`) — all pages are now fully static HTML
- Replace nginx SPA fallback with `=404` + Quartz's static `404.html`
- Remove `robots.txt` exclusions (no longer needed)

**Docs cleanup (Obsidian.nvim compat no longer needed):**
- Delete hand-curated category index files (`tutorials.md`, `reference.md`, `how-to.md`, `explanation.md`) — Quartz auto-generates folder pages
- Delete `postgresql-storage.md` (redirect stub) and `migrate-forgejo-from-brew.md` (stale history)
- Drop `docs-check-index` and `docs-check-filenames` prek hooks
- Rewrite `docs-check-links` to allow path-based wiki-links (`[[path/to/file]]`) and only error on true ambiguity
- Add `ai-docs` doc tree listing to replace index files for AI context
- Add natural cross-links from reference cards to fix orphan docs

## Deployment and Testing

- [ ] Merge and let the build pipeline run
- [ ] Verify docs.eblu.me serves pages correctly with full page loads
- [ ] Verify non-existent URLs return 404
- [ ] Monitor crawler traffic — should drop to near zero for fabricated URLs

Reviewed-on: #290
2026-03-09 11:59:43 -07:00

3.3 KiB
Raw Blame History

title modified tags
Mise Tasks 2026-02-24
reference
tools
mise

Mise Tasks

Operational tasks for BlumeOps, run via mise run <task>. Tasks live in mise-tasks/ and use #USAGE directives for argument parsing.

Run mise tasks --sort name for the live list with descriptions.

AI & Documentation

Task Description
ai-docs Prime AI context with key documentation and doc tree
docs-check-frontmatter Check required frontmatter fields
docs-check-links Validate wiki-links resolve correctly (supports path-based links)
docs-mikado View active Mikado dependency chains (C2 changes)
docs-review Review the most stale doc by last-reviewed date
docs-review-stale Report docs by last-modified date
docs-review-tags Print frontmatter tag inventory

Deployment & Provisioning

Task Description
provision-indri Run Ansible playbook for indri
provision-ringtail Run Ansible playbook for ringtail (NixOS)
provision-sifaka Run Ansible playbook for sifaka
fly-deploy Deploy Fly.io public proxy
fly-setup One-time Fly.io secrets and certs setup
fly-shutoff Emergency shutoff: stop all Fly.io proxy machines
dns-preview Preview DNS changes with pulumi
dns-up Apply DNS changes with pulumi
tailnet-preview Preview Tailscale ACL changes with pulumi
tailnet-up Apply Tailscale ACL changes with pulumi

Containers & Registry

Task Description
container-list List containers and their recent tags
container-build-and-release Trigger container build workflows via Forgejo API
container-version-check Validate version consistency across Dockerfiles, nix, and manifests
mirror-create Create an upstream mirror in the mirrors/ Forgejo org
mirror-update-pats Update GitHub PAT on all mirror repos on indri

Git & Forge

Task Description
branch-cleanup Delete merged branches (local and remote)
pr-comments List unresolved PR comments
runner-logs View Forgejo Actions workflow logs
validate-workflows Validate workflow files against runner schema
mikado-branch-invariant-check Validate Mikado Branch Invariant on mikado/* branches

Operations & Monitoring

Task Description
services-check Check all services are online and responding
service-review Review the most stale service for version freshness
blumeops-tasks List tasks from Todoist sorted by priority
op-backup Encrypt 1Password export and send to indri for borgmatic

Infrastructure Setup

Task Description
ensure-minikube-indri-kubectl-config Set up kubectl config for minikube-indri
ensure-k3s-ringtail-kubectl-config Set up kubectl config for k3s-ringtail

ML & Hardware

Task Description
frigate-export-model Export YOLOv9 model weights to ONNX via dagger

Related

  • dagger — CI/CD build engine (containers, docs)
  • ansible — Configuration management
  • argocd-cli — ArgoCD deployment workflows
  • pulumi — DNS and Tailscale IaC