❌ Common Errors & Ritual Interruptions

Even in blessed environments, the rot may resist. This page collects common problems encountered during render, bless, or verify phases, and how to exorcise them.

🔧 Dependency Missing

Symptom: Scripts fail with command not found: yq or similar.

Fix: Install missing tool via Homebrew:

brew install yq jq pandoc

📂 Path or Directory Not Found

Symptom: Errors like No such file or directory: bones/logs/rc-render.log

Fix: Ensure rotkeeper.sh init has been run. If folders are still missing, create them manually:

mkdir -p bones/logs home/content output

🔐 Permissions Denied

Symptom: Scripts fail with Permission denied.

Fix: Ensure scripts are executable:

chmod +x scripts/rc-*.sh rotkeeper.sh

🧟 Weird Output or Render Fails

Symptom: HTML output is empty or broken, or Pandoc errors.

Fix: Check the Markdown frontmatter. You may be missing title, template, or tomb-version.

📉 Logfile Not Rotating

Symptom: Multiple logs pile up in root folder.

Fix: Ensure all rc-*.sh scripts are updated to write logs to bones/logs/.

“Every failed ritual is a lesson. Every log a confession.”