Samon: Designing a Zen Garden Raking Puzzle

Samon (砂紋, “sand crest”) is a Zen garden raking puzzle inspired by the meditative act of restoring order to sand. Originally sketched in 2023, this design turns that concept into a full game with a solver, level generator, and playable prototype. The puzzle challenges players to rake sand into prescribed patterns using a rake that yields parallel lines, mirroring the aesthetic and satisfying nature of actual Zen gardens. The system includes rules for ripple rings, wave bands, ichimatsu blocks, grooves, and pebbles, with constraints like no-U-turns and fixed rake starts. Difficulty scales through deductive grading and par solutions, with tools to enumerate all valid rakings and measure aesthetic beauty.

The project includes open-source code: src/zgsolve.c for exact DFS solving, src/zg.py for garden modeling and solver logic, src/zcp.py for CP-SAT proofs, and src/grader.py for deductive evaluation. All 223 files (1.8 MB) are available as a .zip download, including logs, poems, and test data. Build instructions require gcc, ortools, cairosvg, playwright, and ffmpeg. Paths are configured for /home/claude/zen/ but can be adjusted via sed. The single-file edition embeds the entire codebase in its appendix.

سامون (الخط الرملي، والتي تُترجم إلى “crest of sand”) هي لعبة حديقة زن رقمية تحاكي tarea meditative تمشيط الرمل. تم رسم المخطط الأصلي في 2023، ويحول هذا التصميم المفهوم إلى لعبة كاملة مع Solver، generator مستويات وبروتوتايب.playable. تتحدى اللعبة اللاعبين لرصف الرمل إلى أنماط محددة باستخدام راسم ينتج خطوطًا موازية، محاكيًا الجمال والطبيعة المرضية لحدائق الزن الحقيقية. يتضمن النظام قواعد للحلقات التموجية، والأشرطة الموجية، والمربعات الأيقام، والخلجان، والحصى، مع قيود مثل منع الانعطاف للخلف ونقاط البداية الثابتة للراسم. تتدرج الصعوبة من خلال التصنيف الاستنتاجي والحلول القياسية، مع أدوات لحصر جميع الراسمات الصالحة وقياس الجمال الجمالي.

يتضمن المشروع كود مفتوح المصدر: src/zgsolve.c لحل DFS exact، src/zg.py لنمذجة الحديقة ومنطق الحل، src/zcp.py لإثبات CP-SAT، و src/grader.py للتقييم الاستنتاجي. جميع ملفات 223 (1.8 MB) متاحة كتحميل .zip، بما في ذلك السجلات، القصائد، وبيانات الاختبار. تتطلب تعليمات البناء gcc، ortools، cairosvg، playwright، و ffmpeg. المسارات مُحددة لـ /home/claude/zen/ ولكن يمكن تعديلها عبر sed. النسخة أحادية الملف تضمّن entire codebase في ملحقها.

Samon（砂紋，意为“沙 crest”）是一款基于冥想还原沙艺的禅庭耙图谜题游戏。最早于2023年草图绘制，该设计将该概念转化为包含求解器、关卡生成器和可玩原型的完整游戏。该谜题挑战玩家使用产生平行线的耙子将沙子耙入规定图案，模仿实际禅庭的美学和令人满足的特性。系统包含波纹环、波带、一字格块、沟渠和鹅卵石的规则，以及无掉头和固定耙起点等约束。难度通过演绎等级和标准解进行缩放，并提供枚举所有有效耙图和测量美学美感的工具。

该项目包含开源代码：src/zgsolve.c用于精确DFS求解，src/zg.py用于庭院建模和求解逻辑，src/zcp.py用于CP-SAT证明，以及src/grader.py用于演绎评估。所有223个文件（1.8 MB）均可作为.zip下载，其中包括日志、诗歌和测试数据。构建说明需要gcc、ortools、cairosvg、playwright和ffmpeg。路径默认配置为 /home/claude/zen/，但可通过sed调整。单文件版本在其附录中嵌入整个代码库。