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

SparkLang (ریپوزٹری sparklang، CLI spark، پروڈکٹ کا نام SparkLang) ایک MIT-لائسنس یافتہ پروگرامنگ زبان اور رن ٹائم ہے جو سادہ .spark فائلوں کو چلاتا ہے۔ README میں dry-run fixtures، compile/bytecode ہینڈلنگ، پلے بکس اور Spark IDE کو بنیادی کہانی کے طور پر پیش کیا گیا ہے، جبکہ نیٹ ورک/ویب، وائس/PSTN اور لائیو ماڈل کالز کو اختیاری سرفسز کے طور پر رکھا گیا ہے۔ یہ واضح طور پر بیان کرتا ہے کہ یہ Apache Spark نہیں ہے، AdaCore SPARK نہیں ہے، اور نہ ہی Bifrost پلگ ان ہے۔ ڈیفالٹ رویہ آف لائن ہے: dry-run کے لیے کسی کی (key) یا نیٹ ورک کی ضرورت نہیں ہوتی، اور صرف ایک opt-in --live فلیگ ایک ساتھی HTTP ہیلپر کا استعمال کرتا ہے جس میں AI_GATEWAY_URL اور API key کے ذریعے OpenAI کے ہم آہنگ گیٹ وے کو کنفیگر کیا جاتا ہے۔ ماحول کے متغیرات (Environment variables) جیسے SPARK_STT_URL / SPARK_TTS_URL اور SPARK_TRAIN_* اختیاری اسپیچ اور ٹریننگ اینڈ پوائنٹس کو کنٹرول کرتے ہیں۔ README میں بیان کردہ زبان کی سطح میں سلاٹس کے ساتھ ask/generate ماڈل کالز، سنگل یا ملٹی لیبل enums اور اعتماد (confidence) کے ساتھ classify، ان لائن اسکیمات کے ساتھ extract، پائپ لائن چیننگ، ٹول ڈیکلریشنز، listen/speak/voice سیشنز، static review اور out/ میں codegen کے لیے review/builder/implement، ماڈل آپریشنز (train, build, status, analyze, compare, improve, plan)، مقامی ماڈلز پر IDK گیٹ کے لیے head abstain/train/attach/ask، binary open/elf/disasm/understand، نیٹ ورک کیپچر اور pcap تجزیہ، os design/specify/generate بلیو پرنٹس، browser/mitm آپریشنز، cuda/memory/pcie پروبز، اور AES-256-GCM کا استعمال کرتے ہوئے encrypt-to-model envelopes کے لیے crypto/encrypt/gateway شامل ہیں۔ ریپوزٹری ایک دستاویزی authoring plan کے گرد منظم ہے جسے A+B+C لیبل کیا گیا ہے: ایک طویل مدتی self-host منزل، ایک پتلا C bootstrap VM (bootstrap/)، اور ایک Spark-native اسمبلر (sparkasm/)۔ asm/ کے تحت GAS x86_64 اسمبلی ٹری کو مستقل سورس آف ٹروتھ کے بجائے ایک عارضی رننگ اسکیفولڈ کے طور پر بیان کیا گیا ہے۔ لے آؤٹ انٹریز میں asm/، tools/ask/، tools/engine/، tools/browser/، selfhost/، hdl/classify_score.v، examples/*.spark، docs/*.md اور مارکیٹنگ سائٹ کے لیے website/ ڈائریکٹری شامل ہیں۔ تصدیق ٹھوس کمانڈز کے ذریعے پیش کی گئی ہے: make، make machine-proof (جو asm-to-ELF آؤٹ پٹ کا دعویٰ کرتا ہے، جسے file کے ساتھ تصدیق کیا گیا ہے)، dry-run مثالیں جیسے hello.spark، http_get.spark، classify_intent.spark اور model_improve.spark، پلس make test، make test-e2e-browser، make sparkbc-e2e اور make test-ide-paint۔ run() کے لیے Python اور Node انٹری پوائنٹس دکھائے گئے ہیں۔ حفاظت اور ایمانداری کے بیانات نمایاں ہیں: review کبھی بھی ویب JavaScript کا جائزہ نہیں لیتا؛ ریموٹ review URLs کے لیے --allow-net کی ضرورت ہوتی ہے ورنہ یہ واضح غلطی کے ساتھ ختم ہو جاتا ہے؛ نیٹ ورک کیپچر --allow-net-capture کے پیچھے رہتا ہے جس میں CAP_NET_RAW کی عدم موجودگی پر دستاویزی exit code 4 ہوتا ہے؛ dry-run نیٹ ورک پروبز claimed:false رپورٹ کرتے ہیں؛ os generate صرف تعلیمی stubs لکھتا ہے اور کبھی بھی OS کو ری بوٹ یا انسٹال نہیں کرتا؛ dry-run میں ماڈل ٹریننگ کبھی بھی جابز شروع نہیں کرتی۔ دستاویزی غیر اہداف (non-goals) میں ایک کسٹم CPU ISA، ایک پروڈکشن bare-metal OS، مکمل ES/CSS رینڈرنگ، ایک مکمل self-host کمپائلر، FPGA bitstream شپنگ کے دعوے، اور کوئی بھی خاموش GPU ٹریننگ شامل ہے۔ README میں بیان کردہ ورژن 0.6.2 ہے، جبکہ انسٹالر کٹ 0.6.0 کے طور پر درج ہے۔