منصوبے کے بارے میں

CLI Printing Press ایک جنریٹر ہے جو صوابدیدی APIs یا ویب سائٹس کے لیے کمانڈ لائن ٹولز اور MCP سرورز تیار کرتا ہے، جس میں AI ایجنٹس کے استعمال پر خاص زور دیا گیا ہے۔ یہ Go میں لکھا گیا ہے اور بائنری کے ساتھ ساتھ ایجنٹ سکلز (سلیش کمانڈز) کے سیٹ کے طور پر تقسیم کیا جاتا ہے جو بائنری کو چلاتے ہیں۔ یہ کیا کرتا ہے - سرکاری API دستاویزات پڑھتا ہے، مشہور کمیونٹی CLIs اور MCP سرورز کا مطالعہ کرتا ہے، اور براؤزر ٹریفک کو کیپچر کرکے غیر دستاویزی APIs کو ریورس انجینئر بھی کر سکتا ہے۔ - ان پٹ کے طور پر OpenAPI spec، ویب سائٹ URL، یا HAR فائل قبول کرتا ہے۔ - ہر API کے لیے دو بائنریز تیار کرتا ہے: ایک Cobra-based CLI (`<api>-pp-cli`) اور ایک MCP سرور (`<api>-pp-mcp`)، جو ایک ہی کلائنٹ، اسٹور، اور auth کوڈ شیئر کرتے ہیں۔ - کوڈ کے ساتھ تحقیقی دستاویزات، تصدیقی ثبوت، اور معیار کا اسکور بھی تیار کرتا ہے۔ کلیدی ڈیزائن پوائنٹس - Local-first ڈیٹا پرت: domain-specific SQLite ٹیبلز، FTS5 مکمل متن تلاش، کرسر ٹریکنگ کے ساتھ اضافی sync، اور براہ راست سوالات کے لیے `sql` کمانڈ۔ `sync`، `search`، اور `sql` جیسی کمانڈز آف لائن کام کرتی ہیں۔ - مرکب کمانڈز: ایک بار ڈیٹا مقامی ہو جائے تو، `stale`، `health`، `bottleneck`، اور `reconcile` جیسی کمانڈز وسائل کے درمیان جوڑ سکتی ہیں اور تاریخ کا تجزیہ کر سکتی ہیں۔ - Agent-native آؤٹ پٹ: ٹرمینل میں انسانی پڑھنے کے قابل ٹیبلز، پائپ ہونے پر خودکار JSON، ٹوکن آؤٹ پٹ کم کرنے کے لیے `--compact`، ٹائپڈ ایگزٹ کوڈز (0/2/3/4/5/7)، `--dry-run`، `--select`، `--csv`، `--stdin`، اور ہر کمانڈ پر دیگر فلیگز۔ - دوہری انٹرفیس: CLI شیل-based ایجنٹس کو نشانہ بناتا ہے، جبکہ MCP سرور IDE انٹیگریشنز جیسے Claude Desktop اور Cursor کو نشانہ بناتا ہے۔ - تصدیق: اسکور کارڈ، dogfooding، proof-of-behavior، اور اختیاری لائیو API smoke ٹیسٹ hallucinated paths، dead flags، اور auth mismatches کو پکڑنے کے لیے استعمال ہوتے ہیں۔ ورک فلو - انسٹالیشن ایک شیل اسکرپٹ کے ذریعے ہوتی ہے جو جنریٹر کے لیے `go install` چلاتا ہے اور `skills` npm CLI کے ذریعے سکلز انسٹال کرتا ہے۔ Claude Code ڈیفالٹ اور بہترین آزمودہ ہدف ہے؛ Codex کو `--agent codex` فلیگ کے ساتھ سپورٹ کیا جاتا ہے۔ - ایجنٹ سیشن کے اندر، `/printing-press <app-name>` جنریشن رن شروع کرتا ہے۔ اضافی کمانڈز میں `/printing-press-reprint`، `/printing-press-polish`، `/printing-press-publish`، اور `/printing-press-amend` شامل ہیں۔ - پائپ لائن مراحل سے گزرتی ہے: resolve/reuse، research brief، ecosystem absorb gate، browser-sniff gate، generate، build the GOAT، shipcheck، اور اختیاری لائیو smoke test۔ ایک طویل 9-مرحلہ منظم پائپ لائن ان صارفین کے لیے دستاویز کی گئی ہے جو انفرادی مراحل کو روکنا، دوبارہ شروع کرنا، یا دوبارہ چلانا چاہتے ہیں۔ - آؤٹ پٹ `~/printing-press/` کے تحت منظم ہوتا ہے جس میں فعال رنز، شائع شدہ CLIs، اور محفوظ شدہ manuscripts کے لیے الگ ڈائریکٹریاں ہوتی ہیں۔ قابل ذکر تصورات - "Non-Obvious Insight" (NOI): ایک جملے میں API کی اصل افادیت کی نئی تشریح، جو تیار کردہ کمانڈز کی تخلیقی بنیاد کے طور پر استعمال ہوتی ہے۔ - "Absorb and transcend": موجودہ ٹولز اور MCP سرورز کی خصوصیات کی فہرست بنانا، ان کا ملاپ کرنا، اور پھر مقامی ڈیٹا سے فعال مرکب صلاحیتیں شامل کرنا۔ - سادہ endpoint wrappers سے لے کر رویے کی بصیرت کمانڈز تک ایک "creativity ladder"۔ تقاضے اور احتیاطیں - Go 1.26.6 یا نیا، `npx` کے لیے Node/npm، اور skills-supported ایجنٹ (Claude Code آزمودہ) درکار ہے۔ - README کارکردگی اور معیار کے دعوے کرتا ہے (مثال کے طور پر، ٹوکن بچت اور رفتار) جو کہ پروجیکٹ کے اپنے بیانات ہیں نہ کہ آزادانہ تصدیق شدہ بینچ مارکس۔ - ریپوزٹری میں اب سورس کیٹلاگ نہیں ہے؛ شائع شدہ CLIs کو ایک علیحدہ لائبریری ریپوزٹری میں برقرار رکھا جاتا ہے۔