PuzzleTide Puzzle Generator

PuzzleTide CLI — शब्द खोज, क्रॉसवर्ड और सुडोकू जनरेटर

एक स्थानीय-प्रथम पहेली जनरेटर CLI में शब्द खोज जनरेटर, क्रॉसवर्ड जनरेटर, और सुडोकू जनरेटर + सॉल्वर — प्रिंट करने योग्य PDF वर्कशीट, स्टार्टर शब्द बैंक, सत्यापन योग्य LLM मूल्यांकन, और बंडल एजेंट कौशल के साथ। puzzletide.com के निर्माताओं से।

इंस्टॉल करें

npm install -g puzzletide
ptide --version

पैकेज दोनों बाइनरी इंस्टॉल करता है:

• ptide
• puzzletide

CLI से पहेलियाँ क्यों उत्पन्न करें

किसी भाषा मॉडल से शब्द खोज लिखने को कहें और आपको एक ग्रिड मिलता है जहाँ आधे शब्द टूटे होते हैं; उससे सुडोकू माँगें और आपको आमतौर पर कई समाधानों वाला, या कोई नहीं, मिलता है। ग्रिड बिल्कुल उसी प्रकार का आउटपुट हैं जिसमें LLM खराब हैं और नियतात्मक कोड अच्छा है।

PuzzleTide CLI वह नियतात्मक कोड है:

• प्रत्येक शब्द खोज शब्द रखा गया है और सत्यापन योग्य है — प्लेसमेंट निर्देशांक आउटपुट का हिस्सा हैं, और जनरेटर गुण-परीक्षित हैं।
• प्रत्येक उत्पन्न सुडोकू की जाँच की जाती है कि उसका ठीक एक समाधान है।
• प्रत्येक क्रॉसवर्ड को लौटाने से पहले उसके अपने संकेतों के विरुद्ध मान्य किया जाता है।
• वही --seed इनपुट, वही पहेली आउटपुट, किसी भी मशीन पर।

पैकेज SKILL.md एजेंट कौशल भी प्रदान करता है, ताकि कोडिंग एजेंट (Pi, Hermes, OpenClaw, और अन्य SKILL.md-आधारित सिस्टम) हाथ से ग्रिड लिखने के बजाय CLI का उपयोग करें।

कमांड मॉडल

ptide <namespace> <operation> [input] [options]   # for humans
ptide run <tool-id> [input] [options] --json      # canonical, for scripts/agents
ptide tools list | search <q> | info <id> | docs <id>
ptide agent manifest

इंटरैक्टिव रूप से छोटे कमांड और स्वचालन में कैनोनिकल टूल आईडी का उपयोग करें:

ptide sudoku generate --difficulty hard
ptide run puzzle.sudoku.generate --difficulty hard --json

शब्द खोज जनरेटर

आसान/मध्यम/कठिन प्रीसेट के साथ आठ प्लेसमेंट दिशाएँ, ऑटो-साइज़ ग्रिड (6–30), उच्चारण/स्पेस/हाइफ़न सामान्यीकरण। शब्द फ़्लैग, फ़ाइलों, या बंडल थीम से आते हैं:

# Word search from your own words, printed in the terminal
ptide wordsearch generate --words "coral,shark,kelp,wave,tide"

# Themed printable word search (puzzle page + solution page)
ptide wordsearch generate --theme animals/ocean-animals --pdf ocean.pdf

# Kids mode: easy = forward-only words
ptide wordsearch generate --theme seasonal/halloween --difficulty easy

क्रॉसवर्ड जनरेटर

मानक क्रॉसवर्ड नंबरिंग, संकेत-ग्रिड सत्यापन, और थीम शब्दों के लिए नियतात्मक फ़ॉलबैक संकेतों के साथ इंटरलॉकिंग प्लेसमेंट। जो शब्द इंटरलॉक नहीं हो सकते, उन्हें चुपचाप छोड़ने के बजाय रिपोर्ट किया जाता है:

# Crossword with your clues
ptide crossword generate --words "PARIS: Capital of France; TOKYO: Capital of Japan"

# From a JSON file, as a printable PDF
ptide crossword generate --file words.json --pdf review.pdf --title "Unit 4 Review"

सुडोकू जनरेटर और सॉल्वर

विशिष्टता गारंटी, एक त्वरित सॉल्वर, और एक सत्यापनकर्ता के साथ आसान, मध्यम, कठिन और विशेषज्ञ सुडोकू (17–21 दिए गए) जो विरोधों, हल करने की क्षमता और समाधान विशिष्टता की रिपोर्ट करता है:

ptide sudoku generate --difficulty expert --seed 42
ptide sudoku solve "53..7....6..195....98....6.8...6...34..8.3..17...2...6.6....28....419..5....8..79"
ptide sudoku validate --file puzzle.txt
ptide daily        # today's daily sudoku, same for everyone on a given UTC day

प्रिंट करने योग्य पहेलियाँ: PDF वर्कशीट और SVG

प्रत्येक जनरेटर प्रिंट-रेडी वर्कशीट के लिए --pdf <file> लेता है — पहेली पृष्ठ और एक समाधान पृष्ठ (--paper letter|a4, --no-solution-page के साथ उत्तर कुंजी छोड़ें) — और वेक्टर छवियों के लिए --svg <file>। कक्षा पैकेट के लिए प्रिंट करने योग्य शब्द खोज और प्रिंट करने योग्य सुडोकू शीट बस एक लूप दूर हैं:

for i in 1 2 3 4 5; do
  ptide sudoku generate --difficulty medium --seed "$i" --pdf "sudoku-$i.pdf" --title "Sudoku #$i"
done

रेडी-मेड शीट पसंद करते हैं? रहस्य और हत्या प्रिंट करने योग्य शब्द खोज पाठकों की पसंदीदा है, और भी सैकड़ों प्रिंट करने योग्य पहेलियाँ पर उपलब्ध हैं।

शब्द बैंक और शब्द उपकरण

30 स्टार्टर थीम (समुद्री जानवर, फल, अंतरिक्ष, हैलोवीन, ...) — ब्राउज़ करें, खोजें, पैटर्न-मिलान करें, अनाग्राम, यादृच्छिक चयन। --words/--file के माध्यम से अपनी सूचियाँ लाएँ, या puzzletide.com पर पूर्ण क्यूरेटेड संग्रह खेलें:

ptide words themes --search dinosaur
ptide words match "c_r_l"        # crossword-style pattern matching
ptide words anagram coral

टर्मिनल में एक हैंगमैन गेम भी है: ptide play hangman।

एजेंट कौशल

Pi इस npm पैकेज से सीधे बंडल कौशल लोड कर सकता है:

pi install npm:puzzletide

पैकेज मैनिफ़ेस्ट घोषित करता है:

{
  "pi": {
    "skills": ["./skills"]
  }
}

पाँच कौशल शामिल हैं: शब्द खोज, क्रॉसवर्ड, सुडोकू, प्रिंट करने योग्य पहेलियाँ, और एजेंट मूल्यांकन। प्रत्येक स्थानीय CLI को प्राथमिकता देता है और ptide, puzzletide, फिर npx puzzletide की जाँच करता है। कौशल कभी भी स्वतः कुछ इंस्टॉल नहीं करते; एजेंटों को इंस्टॉल करने से पहले उपयोगकर्ता से पूछना चाहिए।

Claude Desktop, Cursor, और किसी भी MCP क्लाइंट के लिए MCP सर्वर

सहयोगी पैकेज puzzletide-mcp मॉडल कॉन्टेक्स्ट प्रोटोकॉल पर हर गैर-इंटरैक्टिव टूल को उजागर करता है — वही शब्द खोज जनरेटर, क्रॉसवर्ड जनरेटर, सुडोकू जनरेटर/सॉल्वर, शब्द उपकरण, और मूल्यांकन, Claude Desktop, Cursor, Windsurf, या किसी भी MCP क्लाइंट से कॉल करने योग्य:

{
  "mcpServers": {
    "puzzletide": {
      "command": "npx",
      "args": ["-y", "puzzletide-mcp"]
    }
  }
}

टूल नाम, तर्क और प्रति-क्लाइंट सेटअप के लिए docs/mcp.md देखें।

उपकरण

MCP सर्वर (और ptide run <tool-id>) 15 उपकरण उजागर करता है:

• puzzle_wordsearch_generate: कस्टम शब्दों, फ़ाइलों, या थीम वाले शब्द बैंकों से एक शब्द खोज ग्रिड उत्पन्न करें — प्रत्येक प्लेसमेंट सत्यापन योग्य, PDF/SVG के माध्यम से प्रिंट करने योग्य।
• puzzle_crossword_generate: मानक नंबरिंग और मान्य संकेतों के साथ एक इंटरलॉकिंग क्रॉसवर्ड उत्पन्न करें।
• puzzle_sudoku_generate: गारंटीकृत अद्वितीय समाधान के साथ आसान, मध्यम, कठिन, या विशेषज्ञ सुडोकू उत्पन्न करें।
• puzzle_sudoku_solve: एक सुडोकू को उसके 81-वर्ण स्ट्रिंग से हल करें और रिपोर्ट करें कि क्या समाधान अद्वितीय है।
• puzzle_sudoku_validate: एक सुडोकू ग्रिड मान्य करें — विरोध, हल करने की क्षमता, और समाधान विशिष्टता।
• words_categories: शब्द बैंक श्रेणियाँ सूचीबद्ध करें।
• words_themes: बंडल की गई थीम वाली शब्द सूचियों को सूचीबद्ध या खोजें।
• words_list: किसी थीम में शब्दों को सूचीबद्ध करें, लंबाई या गिनती के अनुसार फ़िल्टर किया हुआ।
• words_match: क्रॉसवर्ड-शैली पैटर्न (c_r_l) से मेल खाने वाले शब्द खोजें।
• words_anagram: शब्द बैंक में दिए गए अक्षरों के अनाग्राम खोजें।
• words_random: एक यादृच्छिक शब्द चुनें, वैकल्पिक रूप से एक थीम से।
• words_stats: शब्द बैंक आँकड़े।
• eval_generate: LLM और एजेंटों के बेंचमार्किंग के लिए पुनरुत्पादनीय, वस्तुनिष्ठ रूप से ग्रेड करने योग्य पहेली कार्य उत्पन्न करें।
• eval_check: निर्माण द्वारा उत्पन्न मूल्यांकन कार्यों के उत्तरों को ग्रेड करें — किसी उत्तर कुंजी पर भरोसा नहीं।
• play_daily: आज का दैनिक सुडोकू प्रिंट करें (UTC दिन पर सभी के लिए समान)।

सत्यापन योग्य LLM मूल्यांकन

पहेली उत्तर बिना उत्तर कुंजी के जाँचे जा सकते हैं: एक सुडोकू उत्तर या तो नियमों को संतुष्ट करता है और दिए गए को संरक्षित करता है या नहीं करता; एक शब्द खोज उत्तर या तो ग्रिड में एक सीधी रेखा के साथ शब्द का उच्चारण करता है या नहीं करता। यह पहेलियों को LLM मूल्यांकन के लिए स्वच्छ बेंचमार्क कार्य बनाता है — किसी LLM न्यायाधीश की आवश्यकता नहीं:

ptide eval generate --type sudoku --n 20 --difficulty hard --seed 1 --out tasks.json
# ...run your model on tasks.json, collect [{id, answer}] ...
ptide eval check --tasks tasks.json --answers answers.json --json

(प्रकार, कठिनाई, n, बीज) टपल पूरी तरह से कार्य सेट निर्धारित करता है, इसलिए यह एक पुनरुत्पादनीय बेंचमार्क का नाम देता है।

लाइब्रेरी उपयोग

इंजन बिना CLI के आयात योग्य TypeScript हैं:

import { generateSudoku, generateWordSearch, wordSearchPdf } from 'puzzletide';

const sudoku = generateSudoku({ difficulty: 'hard', seed: 42 });
const search = generateWordSearch({
  words: ['coral', 'shark', 'kelp'],
  directions: ['E', 'S', 'SE'],
  seed: 7,
});
const pdfBytes = await wordSearchPdf(search, { title: 'Ocean Animals' });

अधिक दस्तावेज़:

• CLI कमांड
• टूल रजिस्ट्री
• एजेंट कौशल

ऑनलाइन संस्करण

ब्राउज़र पसंद करते हैं?

• PuzzleTide शब्द खोज
• PuzzleTide क्रॉसवर्ड
• PuzzleTide सुडोकू
• PuzzleTide हैंगमैन
• प्रिंट करने योग्य पहेलियाँ
• अपनी खुद की पहेली बनाएँ
• डिस्लेक्सिया-अनुकूल शब्द खोज फ़ॉन्ट और सेटिंग्स

गोपनीयता

सब कुछ स्थानीय रूप से चलता है। कोई खाता नहीं, कोई API कुंजी नहीं, कोई टेलीमेट्री नहीं, कोई नेटवर्क एक्सेस नहीं।

विकास

npm install
npm run build     # tsc → dist/
npm test          # vitest + fast-check property tests (build first: CLI tests run dist/)

स्टार्टर शब्द बैंक इस पैकेज के लिए लिखी गई सामान्य, मूल सूचियाँ हैं (scripts/wordbanks-source.json, npm run build:wordbanks के साथ संकलित)। थीम योगदान का स्वागत है — स्रोत फ़ाइल में एक प्रविष्टि जोड़ें और बिल्ड चलाएँ। पूर्ण क्यूरेटेड PuzzleTide शब्द बैंक संग्रह puzzletide.com का मालिकाना है और इस रिपॉजिटरी का हिस्सा नहीं है।

PuzzleTide CLI का हवाला देना

यदि आप अपने काम में PuzzleTide CLI का उपयोग करते हैं — उदाहरण के लिए एक मॉडल बेंचमार्क में सत्यापन योग्य पहेली मूल्यांकन — तो कृपया इसका हवाला दें (या GitHub का "इस रिपॉजिटरी का हवाला दें" बटन उपयोग करें):

@software{puzzletide_cli,
  author  = {{Caravaca Labs}},
  title   = {PuzzleTide CLI: word search, crossword \& sudoku generator with verifiable LLM evals},
  year    = {2026},
  url     = {https://github.com/Caravaca-Labs/puzzletide-cli},
  note    = {From the makers of \url{https://puzzletide.com}}
}

सादा पाठ: "PuzzleTide CLI (Caravaca Labs, 2026), https://github.com/Caravaca-Labs/puzzletide-cli — https://puzzletide.com. के निर्माताओं से"

लाइसेंस

MIT © Caravaca Labs