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

A3S Cloud ایک سیلف ہوسٹڈ، Agent-first ڈویلپر پلیٹ فارم ہے۔ اس کا README ایک کنٹرول پلین کی وضاحت کرتا ہے جہاں پروڈکٹ اور مطلوبہ حالت (desired-state) کی حقیقت Cloud میں رہتی ہے، پائیدار کام A3S Flow کے ذریعے مربوط ہوتا ہے، لائف سائیکل کنٹریکٹس A3S Runtime کے ذریعے بیان کیے جاتے ہیں، ایگزیکیوشن A3S Box کے ذریعے سنبھالا جاتا ہے، اور A3S Gateway واحد عوامی ایج (public edge) ہے۔ یہ ریپوزٹری MIT لائسنس کے تحت ہے اور Rust 1.88 یا اس سے بعد کے ورژن، PostgreSQL 17 یا ہم آہنگ ریلیز، A3S Box، A3S Gateway کے ایک مخصوص ورژن، اور پروڈکشن کے لیے تمام Worker یا Relay رولز کے لیے NATS JetStream کو ٹارگٹ کرتی ہے۔ Bun صرف TypeScript کلائنٹ یا CLI ڈویلپمنٹ کے لیے درج ہے۔ آرکیٹیکچر ہر سروس کے لیے ایک ہی راستہ اختیار کرتا ہے: Gateway اور Identity کے ذریعے عوامی ٹریفک کو قبول کرنا؛ A3S ORM کے ذریعے PostgreSQL میں مطلوبہ حالت، idempotency، آڈٹ شواہد اور Outbox حقائق کو کمٹ کرنا؛ A3S Flow اور Operations کے ذریعے پائیدار انتظار، ری ٹرائی، ری پلے، منظوری، معاوضے اور منسوخی کو مربوط کرنا؛ Box پر Runtime Task یا Service یونٹس کے ساتھ Workloads اور Fleet کے ذریعے جگہ بنانا اور ایگزیکیٹ کرنا؛ پھر Edge اور Gateway کے ذریعے ورژن شدہ روٹ اسنیپ شاٹس شائع کرنا۔ Cloud کبھی بھی دوسرا ریکویسٹ بائٹ پراکسی نہیں بنتا۔ چھ پروڈکٹ نتائج دو ایگزیکیوشن کلاسز میں تقسیم ہیں۔ AaaS میں گفتگو، ایگزیکیوشنز، ایونٹس، منظوری، چیک پوائنٹس، فورکس اور پرووائیڈر بائنڈنگز شامل ہیں۔ WaaS میں اونٹولوجی، ناقابلِ تبدیلی تعریفیں اور پلانز، WorkflowRun، HumanTask اور ٹائپڈ نوڈ آرڈر شامل ہیں۔ FaaS ناقابلِ تبدیلی Function ریلیز پروفائلز کا مالک ہے اور انووکیشنز کو Executions، Workloads یا Connectors کے سپرد کرتا ہے۔ Durable Cell لوگوں اور متعدد Agents کے لیے ایک نامزد، سیریلائزڈ، ہائبرنیٹ ایبل اسٹیٹ اسپیس فراہم کرتا ہے۔ Model Inference ماڈل ریویژن، تعیناتی، روٹنگ پالیسی، استعمال اور تشخیص کا مالک ہے، جس میں آزاد ریپلیکا اور ملٹی نوڈ prefill/decode گروپس شامل ہیں۔ Static Web براہ راست Gateway سے ناقابلِ تبدیلی React، Vue اور دیگر منظور شدہ ریلیزز فراہم کرتا ہے، جس میں SSR ایک عام Service پروفائل کے طور پر کام کرتا ہے۔ واحد جنرل ایگزیکیوشن کلاسز Task اور Service ہیں۔ کوئیک اسٹارٹ کے لیے صرف dependencies کے لیے 'up' اور ایک الگ کنٹرول پلین استعمال ہوتا ہے، جس میں /api/v1/health/live اور /api/v1/health/ready پر ہیلتھ اینڈ پوائنٹس، /api/v1/openapi.json پر ایک OpenAPI اینڈ پوائنٹ، اور ایک ون شاٹ مائیگریٹر ہوتا ہے جسے سرونگ پراسیسز سے پہلے چلانا ضروری ہے۔ Bootstrap پہلی Organization، سروس Principal، مالک Membership، API ٹوکن، بیس لائن پلیٹ فارم رول پالیسی اور PlatformOwner بائنڈنگ تخلیق کرتا ہے۔ Mutations میں Bearer اتھارائزیشن اور ایک idempotency کی استعمال ہوتی ہے۔ CLI کو Bun کے ساتھ چلایا جاتا ہے اور یہ کریڈنشلز کو انوائرمنٹ ویری ایبلز یا اسٹینڈرڈ ان پٹ سے پڑھتا ہے، نہ کہ CLI کنٹیکسٹ فائل سے۔ پروڈکشن میں API صرف A3S Gateway کے ذریعے شائع کی جاتی ہے۔ README میں بیان کردہ پلیٹ فارم کی صلاحیتوں میں ہوسٹڈ Git اتھارٹی کے ساتھ بیرونی سورس ریویژنز، ویب ہکس، ریپروڈیوس ایبل Box بلڈز، پروویننس، پل ریکویسٹ پری ویوز، ناقابلِ تبدیلی آرٹفیکٹس اور ڈائجسٹ پریزروینگ پروموشن شامل ہیں۔ Supply میں Git، OCI Registry اور A3S Use Registry اتھارٹیز کو الگ کیا گیا ہے۔ رن اور اسکیل کے لیے CPU پولز، GPU پولز، ایکسیلیریٹر اور ٹوپولوجی کنسٹرینٹس، Claims، اینٹی افینیٹی، گینگ پلیسمنٹ، مینٹیننس، کوٹاز اور پری ایمپشن کے لیے ایک ہی ہیٹروجینیس شیڈولر استعمال ہوتا ہے، جس میں اسٹیٹ لیس scale-to-zero اور اسٹیٹ فل ڈرین، فینسنگ، چیک پوائنٹ اور ریکوری شامل ہے۔ اسٹور اور سرونگ بیرونی S3 ہم آہنگ اسٹوریج پر ایک ٹائپڈ immutable-object کلائنٹ، Gateway کے زیرِ انتظام TLS اور روٹنگ، اور لاگز، میٹرکس، ٹریسز، SLOs اور حادثات کے لیے OpenTelemetry کا استعمال کرتے ہیں۔ گورننس میں ٹیننٹ آئسولیشن، ممبرشپس، Resource Grants، کوٹاز، کریڈنشلز، آڈٹ، Outbox، لائف سائیکل کلین اپ، سسٹم ایڈمنسٹریٹر RBAC پلین، مختصر مدت کے سپورٹ گرانٹس، اور ورک لوڈ آئیڈینٹیٹی ریویژنز شامل ہیں۔ README میں بتایا گیا ہے کہ A3S Cloud کوئی مینجمنٹ ڈیش بورڈ فراہم نہیں کرتا؛ یہ ایپلی کیشنز اور Agents کے لیے ناقابلِ تبدیلی React/Vue اور دیگر ٹیننٹ ویب ریلیزز ہوسٹ کرتا ہے، جو دیگر کلائنٹس کی طرح وہی Gateway اور APIs استعمال کرتے ہیں۔ خودکار CI اور Box کنفورمنس صرف ریلیز کے لیے پشز اور ریلیز کو ٹارگٹ کرنے والی پل ریکویسٹس کے لیے چلتے ہیں؛ main ان ورک فلو کو خود بخود شروع نہیں کرتا۔ ڈیلیوری اسٹیٹس گیٹ پر مبنی ہے، فیصد پر نہیں۔ 2026-09-06 تک، README ٹیننٹ اسکوپڈ Identity، PostgreSQL/A3S ORM، Operations/Flow، Outbox، عوامی API اور مائیگریشنز کو ایک Verified بنیاد کے طور پر فہرست بند کرتا ہے۔ انسٹالیشن اسکوپ اور سسٹم ایڈمنسٹریٹر RBAC ایک Verified کور ہیں جس کا ایک وسیع گیٹ جاری ہے۔ Workloads، Fleet، Runtime/Box، Gateway، سپلائی، تعاون اور انٹرپرائز کنٹرولز ابھی جاری ہیں، جس میں A0.4 رئیل پرووائیڈر گیٹ ویریفائیڈ ہے۔ Agent اور ہوسٹڈ MCP پروڈکٹ لینز جاری ہیں جن میں A0.4 ویریفائیڈ ہے۔ Ontology Workflow اور AI Applications/Files جاری ہیں۔ آٹومیشنز کی ایک کمپوننٹ بنیاد جاری ہے۔ Data/S0 اور Durable Cell کی بنیادیں جاری ہیں۔ ورک لوڈ آئیڈینٹیٹی میں ویریفائیڈ ٹرسٹ اور WI2-C1/C2/C3a/C3b بنیادیں ہیں، جبکہ فلیٹ ہارڈویئر اٹیسٹیشن اور مکمل ایشوئنس ابھی کھلے ہیں۔ FaaS، ڈسٹری بیوٹڈ انفرنس، ماڈل سپلائی، Static Web، Runtime CI/CD اور مکمل HA آپریشنز پلانڈ ہیں یا ابتدائی بنیاد میں ہیں۔ آرکیٹیکچر ٹارگٹس دستیابی کے دعوے نہیں ہیں؛ ایک صلاحیت صرف تب ریلیز کی جاتی ہے جب real-provider، ناکامی، ریکوری، کلین اپ، اپ گریڈ اور ریلیز گیٹس کو ROADMAP.md میں Verified مارک کر دیا جائے۔