نشر التطبيق بمساعدة موجز

ما تفعله الميزة

نقطة prompt-to-app الحالية تجمع موجزا مكتوبا مع مستودع قالب Git قائم وتضع ذلك المستودع في قائمة خط أنابيب نشر التطبيق غير القابل للتغيير المعتاد. يُحفظ الموجز كأصل للتكرارات اللاحقة.

لا تولّد مستودع تطبيق جديدا من الموجز. URL القالب مطلوب، والنشر الأول يحتوي مصدر القالب عند المراجعة المحلولة ما لم يكن ذلك المصدر ينفّذ الطلب أصلا.

أنشئ من موجز وقالب


POST /api/apps/from-prompt
Content-Type: application/json
 
{
  "brief": "A private reading-list app with a health endpoint",
  "template_git_url": "https://github.com/example/reviewed-template.git",
  "branch": "main",
  "visibility": "private"
}

تتضمن الاستجابة معرفات دائمة للتطبيق والنشر والبناء إضافة إلى URL لبث البناء. الإنشاء غير متزامن. تابع سجل النشر أو بث البناء حتى يصل إلى حالة نهائية؛ لا تقدّم نشرا مكررا لمجرد هدوء التقدم.

قبل تقديم الطلب:

راجع المستودع ورخصته؛
ثبّت أو سجّل مراجعة المصدر الدقيقة التي يستخدمها النشر؛
تحقق من سلوك التثبيت، والبناء، والتشغيل، والمنفذ، والصحة؛ و
أبقِ الأسرار خارج الموجز والمستودع.

الموجز سياق، وليس دليلا على أن المصدر الناتج يستوفيه. اختبر السلوك المنشور مقابل معايير قبول مشتقة من الموجز.

اطلب تغييرا لاحقا


POST /api/apps/{app_id}/iterate
Content-Type: application/json
 
{
  "instruction": "Add an authenticated export endpoint and a regression test"
}

هذا يرسل مهمة وكيل إصلاح غير متزامنة لتطبيق تملكه وله مصدر Git. استطلع:


GET /api/apps/{app_id}/agent-status?thread_id={thread_id}

تجمع استجابة الحالة أحدث حالة نشر مع حالة خيط التكرار وأي أدلة نتيجة مبلّغ عنها.

حد التكرار المهم

يمكن لمسار الإصلاح الحالي العمل في عزلته وطلب نشر جديد، لكن الثبات عودة إلى مستودع Git للمطوّر ليس بعد مرحلة مضمونة. لذلك خيط وكيل done لا يثبت بمفرده أن:

التغيير المطلوب موجود في المستودع الأعلى؛
بُني commit معيّن؛
اجتازت الاختبارات؛
أصبح النشر الجديد نشطا؛ أو
يمكن استعادة النشر القديم.

لكل تكرار، سجّل بشكل مستقل commit الأعلى، ومعرف النشر، ومعرف البناء، ونتيجة الصحة، وأدلة اختبار القبول. إذا لم يُحدَّث المستودع الأعلى، احفظ الرقعة عبر سير تحكم بالمصدر يراجعه المشغّل قبل الاعتماد على التغيير.

تسلسل قبول آمن

حوّل الموجز إلى معايير قبول قابلة للرصد.
راجع القالب المختار والمراجعة الدقيقة.
ضع نشرا واحدا في قائمة الانتظار وتابع معرفاته الدائمة.
أكد البناء، وفحص صحة المرشح، وتحويل المسار بشكل منفصل.
مارس معايير القبول مقابل URL المنشور.
أكد وجود commit المصدر في المستودع الذي تتحكم به.
احتفظ بالأدلة وهدف تراجع.

راجع نشر التطبيق لمراحل النشر غير القابل للتغيير ومعالجة الفشل.