مرجع استجابات الأتمتة

أغلفة JSON وقنوات الإخراج ورموز الخروج وحقول النتائج المشروطة في SubFT CLI.

أغلفة بإصدارات محددة

مع --json يصدر استدعاء أمر عادي مستنداً واحداً بإصدار schema_version 1 على stdout. إخراج المساعدة والإصدار تابع لـClick، لذلك لا تحلله كغلاف استجابة أمر. تستخدم الأسئلة والتشخيصات stderr ويُحجب عرض التقدم. قد يطلب --json إدخالاً. يوفر البرنامج الكامل دون تدخل أيضاً --yes والاختيارات غير الحتمية صراحةً.

يتضمن النجاح schema_version (عدد صحيح) وok (true) وcommand (نص) وresult (كائن). يتضمن الفشل schema_version وok (false) وcommand وerror؛ ويحتوي error على code (نص قابل للقراءة آلياً) وmessage (نص تقني) وdetails (كائن). تحتاج الرموز غير المعروفة إلى رسالة عامة مترجمة في الواجهة العامة. تتفرع الأتمتة وفق code/details وحالة الخروج، وليس صياغة الرسالة. هذا الغلاف مستقل عن تسلسل الترجمة النصية SRT/VTT/ASS.

مثال على المخرجات

{
  "schema_version": 1,
  "ok": true,
  "command": "project.bindings",
  "result": {
    "bindings": []
  }
}

مثال على المخرجات

{
  "schema_version": 1,
  "ok": false,
  "command": "operation.start",
  "error": {
    "code": "input_required",
    "message": "",
    "details": {}
  }
}

تحذف message الفارغة أعلاه صياغة التشخيص التقني عمداً؛ المثال يوضح البنية. قد تكون الأوامر الناجحة ملغاة مع رمز خروج 0 وresult.cancelled=true. تعتمد تفاصيل الخطأ على الأمر والفرع.

جرد حقول الغلاف

الحقول مطلوبة في فرع النجاح أو الفشل المذكور. result وerror.details كائنان مفتوحان خاصان بالأمر؛ error.message نص تشخيص تقني. يُفحص إصدار المخطط في المثالين مقابل المسلسل.

الفرع	الحقل	المعنى
`success`	`schema_version`	حقل غلاف مطلوب؛ راجع شرح الأنواع أعلاه.
`success`	`ok`	حقل غلاف مطلوب؛ راجع شرح الأنواع أعلاه.
`success`	`command`	حقل غلاف مطلوب؛ راجع شرح الأنواع أعلاه.
`success`	`result`	حقل غلاف مطلوب؛ راجع شرح الأنواع أعلاه.
`failure`	`schema_version`	حقل غلاف مطلوب؛ راجع شرح الأنواع أعلاه.
`failure`	`ok`	حقل غلاف مطلوب؛ راجع شرح الأنواع أعلاه.
`failure`	`command`	حقل غلاف مطلوب؛ راجع شرح الأنواع أعلاه.
`failure`	`error`	حقل غلاف مطلوب؛ راجع شرح الأنواع أعلاه.
`failure`	`error.code`	حقل غلاف مطلوب؛ راجع شرح الأنواع أعلاه.
`failure`	`error.message`	حقل غلاف مطلوب؛ راجع شرح الأنواع أعلاه.
`failure`	`error.details`	حقل غلاف مطلوب؛ راجع شرح الأنواع أعلاه.

رموز الخروج

استخدم حالة العملية للمعالجة العامة ورمز الخطأ الثابت للاسترداد المحدد. لا يعني الرمز غير الصفري عدم اعتماد عملية أو عدم كتابة ملف.

الخروج	الثابت	المعنى
`0`	`SUCCESS`	نجاح أو إلغاء تفاعلي؛ افحص result.cancelled قبل استخدام معرّف عملية.
`1`	`EXIT_INTERNAL`	internal_failure أو command_failed: افحص التشخيص الداخلي ولا تفترض التراجع عن العمل المقبول.
`2`	`EXIT_USAGE`	invalid_usage: أصلح صيغة الأمر أو الخيارات؛ لا تكرر تلقائياً.
`3`	`EXIT_AUTH`	authentication_failed: تحقق من الرمز الفعلي والبوابة والإعداد المحمي.
`4`	`EXIT_INPUT_REQUIRED`	input_required: وفر الاختيار أو الموافقة المفقودة؛ لا يستطيع --yes اختراع اختيار.
`5`	`EXIT_LOCAL`	local_failure: افحص الملفات المحلية وتوفر FFmpeg أو القفل المحلي.
`6`	`EXIT_GATEWAY`	gateway_failure: فشل النقل أو بروتوكول البوابة؛ طابق أي اعتماد قد يكون مقبولاً قبل التكرار.
`7`	`EXIT_REMOTE`	remote_rejection: حالة قديمة أو إجراء بعيد مطلوب. يحدد preparation_incomplete توفير مصادر قابلاً للاسترداد.
`8`	`EXIT_OPERATION`	operation_failed: عمل نهائي فاشل أو ملغى، بما في ذلك بعد تطبيق مخرجات جزئية ناجحة صراحةً.
`130`	`EXIT_INTERRUPTED`	interrupted: انفصل المستدعي؛ يستمر العمل المقبول لدى الخادم ما لم يُلغ بشكل منفصل.

تعيينات الأخطاء الثابتة

ترتبط رموز الآلة هذه برموز الخروج أعلاه. عالج الرموز المجهولة بخطأ عام مترجم؛ قد تحفظ التفاصيل معرّفات عمليات مقبولة أو نتائج جزئية مكتوبة.

الرمز	الخروج	المعنى
`authentication_failed`	`3`	authentication_failed: تحقق من الرمز الفعلي والبوابة والإعداد المحمي.
`command_failed`	`1`	internal_failure أو command_failed: افحص التشخيص الداخلي ولا تفترض التراجع عن العمل المقبول.
`gateway_failure`	`6`	gateway_failure: فشل النقل أو بروتوكول البوابة؛ طابق أي اعتماد قد يكون مقبولاً قبل التكرار.
`input_required`	`4`	input_required: وفر الاختيار أو الموافقة المفقودة؛ لا يستطيع --yes اختراع اختيار.
`internal_failure`	`1`	internal_failure أو command_failed: افحص التشخيص الداخلي ولا تفترض التراجع عن العمل المقبول.
`interrupted`	`130`	interrupted: انفصل المستدعي؛ يستمر العمل المقبول لدى الخادم ما لم يُلغ بشكل منفصل.
`invalid_usage`	`2`	invalid_usage: أصلح صيغة الأمر أو الخيارات؛ لا تكرر تلقائياً.
`local_failure`	`5`	local_failure: افحص الملفات المحلية وتوفر FFmpeg أو القفل المحلي.
`operation_failed`	`8`	operation_failed: عمل نهائي فاشل أو ملغى، بما في ذلك بعد تطبيق مخرجات جزئية ناجحة صراحةً.
`remote_rejection`	`7`	remote_rejection: حالة قديمة أو إجراء بعيد مطلوب. يحدد preparation_incomplete توفير مصادر قابلاً للاسترداد.

حقول نتائج الأوامر

هذه القوائم اتحاد لحقول فروع النتائج الفعلية وليست حقولاً مطلوبة في كل استجابة. تصف الأنواع القيم المتسلسلة الموثقة؛ تبقى الخرائط مفتوحة حين يعلن المصدر Any. يُستخدم آخر ناتج مرحلة ناجح افتراضياً للتصدير ما لم تغيره محددات النواتج الصريحة.

`login`

التحقق من رمز API وتخزينه لبوابته. استخدم الإدخال المخفي أو البيئة المحمية.

الحقل	نوع التسلسل	المعنى
`api_url`	`string`	بوابة أو حساب متحقق منه أو مصدر بيانات الاعتماد؛ لا يعاد سر الرمز.
`credential_source`	`string`	بوابة أو حساب متحقق منه أو مصدر بيانات الاعتماد؛ لا يعاد سر الرمز.
`user_id`	`string`	بوابة أو حساب متحقق منه أو مصدر بيانات الاعتماد؛ لا يعاد سر الرمز.

`logout`

إزالة الرمز المحفوظ محلياً فقط. تبقى مصادقة البيئة نشطة؛ إلغاء الرمز على الخادم منفصل.

الحقل	نوع التسلسل	المعنى
`api_url`	`string`	بوابة أو حساب متحقق منه أو مصدر بيانات الاعتماد؛ لا يعاد سر الرمز.
`environment_authentication_active`	`boolean`	علامة قرار أو حالة خاصة بالفرع؛ لا يعني غيابها False. قد ينجح الإلغاء دون إنشاء عمل.
`stored_token_removed`	`boolean`	علامة قرار أو حالة خاصة بالفرع؛ لا يعني غيابها False. قد ينجح الإلغاء دون إنشاء عمل.

`operation.apply`

الانتظار عند الحاجة واختيار نواتج ناجحة محفوظة وكتابة المخرجات المحلية وتسجيلها. لا تتاح المدخلات الفاشلة؛ يحتاج التصدير الجزئي إلى موافقة صريحة.

الحقل	نوع التسلسل	المعنى
`allowed_actions`	`array<string>`	إجراءات مسموح بها في حالة العملية المعتمدة الحالية.
`cancelled`	`boolean`	علامة قرار أو حالة خاصة بالفرع؛ لا يعني غيابها False. قد ينجح الإلغاء دون إنشاء عمل.
`content_counts`	`object`	عدادات معتمدة مسماة لعناصر المصدر أو المراحل أو التحضير؛ ليست حالات دورة حياة مستقلة.
`display_status`	`string \| null`	التنفيذ أو العرض أو النتيجة النهائية المعتمدة؛ قد تغيب النتيجة أثناء النشاط.
`event_sequence`	`integer`	رقم تسلسل أحداث أو مراجعة حالة معتمدة متزايد.
`execution_state`	`string \| null`	التنفيذ أو العرض أو النتيجة النهائية المعتمدة؛ قد تغيب النتيجة أثناء النشاط.
`finished_at`	`string \| null`	أوقات معتمدة؛ تعني null عدم تسجيل وقت لهذا الحدث.
`operation_id`	`string \| null`	معرّف المورد الذي يوفره هذا الفرع. احفظ معرّف العملية قبل استئناف التحضير أو المراقبة.
`outcome`	`string \| null`	التنفيذ أو العرض أو النتيجة النهائية المعتمدة؛ قد تغيب النتيجة أثناء النشاط.
`output_target`	`string`	محدد خرج الترجمة النصية، وليس تنسيق غلاف --json.
`outputs`	`array<string>`	مسارات المخرجات المحلية؛ عند الفشل الجزئي افحص error.details.result.outputs.
`partial`	`boolean`	علامة قرار أو حالة خاصة بالفرع؛ لا يعني غيابها False. قد ينجح الإلغاء دون إنشاء عمل.
`path`	`string`	المسار المحلي الموحّد لهذا الارتباط أو المزامنة.
`phase_counts`	`object`	عدادات معتمدة مسماة لعناصر المصدر أو المراحل أو التحضير؛ ليست حالات دورة حياة مستقلة.
`preparation_counts`	`object`	عدادات معتمدة مسماة لعناصر المصدر أو المراحل أو التحضير؛ ليست حالات دورة حياة مستقلة.
`project_id`	`string \| null`	معرّف المورد الذي يوفره هذا الفرع. احفظ معرّف العملية قبل استئناف التحضير أو المراقبة.
`selected_artifact_ids`	`array<string>`	معرّفات مراحل ناجحة وثابتة مختارة لهذا التصدير.
`started_at`	`string \| null`	أوقات معتمدة؛ تعني null عدم تسجيل وقت لهذا الحدث.
`state_version`	`integer`	رقم تسلسل أحداث أو مراجعة حالة معتمدة متزايد.
`unchanged_outputs`	`integer`	عدد المصادر المقبولة أو المخرجات المطابقة غير المعدلة أو المخرجات المكتوبة حديثاً؛ احتفظ بالأعداد بعد الفشل الجزئي.
`updated_at`	`string \| null`	أوقات معتمدة؛ تعني null عدم تسجيل وقت لهذا الحدث.
`written_outputs`	`integer`	عدد المصادر المقبولة أو المخرجات المطابقة غير المعدلة أو المخرجات المكتوبة حديثاً؛ احتفظ بالأعداد بعد الفشل الجزئي.

`operation.start`

فحص الوسائط المتزامنة وتحضير المصادر والتقدير وتأكيد الخصم والاعتماد والتوفير. انتظر أو انفصل بعد القبول؛ التصدير منفصل.

الحقل	نوع التسلسل	المعنى
`allowed_actions`	`array<string>`	إجراءات مسموح بها في حالة العملية المعتمدة الحالية.
`available_credits`	`integer`	رصيد الحساب أو الخصم المقدّر قبل الاعتماد؛ قارنه بالموافقة وليس بمدة المعالجة.
`cancelled`	`boolean`	علامة قرار أو حالة خاصة بالفرع؛ لا يعني غيابها False. قد ينجح الإلغاء دون إنشاء عمل.
`content_counts`	`object`	عدادات معتمدة مسماة لعناصر المصدر أو المراحل أو التحضير؛ ليست حالات دورة حياة مستقلة.
`detached`	`boolean`	علامة قرار أو حالة خاصة بالفرع؛ لا يعني غيابها False. قد ينجح الإلغاء دون إنشاء عمل.
`display_status`	`string \| null`	التنفيذ أو العرض أو النتيجة النهائية المعتمدة؛ قد تغيب النتيجة أثناء النشاط.
`event_sequence`	`integer`	رقم تسلسل أحداث أو مراجعة حالة معتمدة متزايد.
`execution_state`	`string \| null`	التنفيذ أو العرض أو النتيجة النهائية المعتمدة؛ قد تغيب النتيجة أثناء النشاط.
`finished_at`	`string \| null`	أوقات معتمدة؛ تعني null عدم تسجيل وقت لهذا الحدث.
`operation_id`	`string \| null`	معرّف المورد الذي يوفره هذا الفرع. احفظ معرّف العملية قبل استئناف التحضير أو المراقبة.
`outcome`	`string \| null`	التنفيذ أو العرض أو النتيجة النهائية المعتمدة؛ قد تغيب النتيجة أثناء النشاط.
`path`	`string`	المسار المحلي الموحّد لهذا الارتباط أو المزامنة.
`phase_counts`	`object`	عدادات معتمدة مسماة لعناصر المصدر أو المراحل أو التحضير؛ ليست حالات دورة حياة مستقلة.
`preparation_counts`	`object`	عدادات معتمدة مسماة لعناصر المصدر أو المراحل أو التحضير؛ ليست حالات دورة حياة مستقلة.
`preparation_failures`	`array<object>`	أخطاء مصادر مع media_path وcontent_id وfailure_code؛ أعد توفير التحضيرات المؤهلة فقط.
`preparation_incomplete`	`boolean`	علامة قرار أو حالة خاصة بالفرع؛ لا يعني غيابها False. قد ينجح الإلغاء دون إنشاء عمل.
`project_id`	`string \| null`	معرّف المورد الذي يوفره هذا الفرع. احفظ معرّف العملية قبل استئناف التحضير أو المراقبة.
`required_credits`	`integer`	رصيد الحساب أو الخصم المقدّر قبل الاعتماد؛ قارنه بالموافقة وليس بمدة المعالجة.
`sources_accepted`	`boolean`	علامة قرار أو حالة خاصة بالفرع؛ لا يعني غيابها False. قد ينجح الإلغاء دون إنشاء عمل.
`started_at`	`string \| null`	أوقات معتمدة؛ تعني null عدم تسجيل وقت لهذا الحدث.
`state_version`	`integer`	رقم تسلسل أحداث أو مراجعة حالة معتمدة متزايد.
`updated_at`	`string \| null`	أوقات معتمدة؛ تعني null عدم تسجيل وقت لهذا الحدث.

`operation.supply`

استئناف مصادر awaiting_client أو awaiting_retry المؤهلة في العملية المعتمدة نفسها. يتطلب استرداد فشل المعالجة النهائي عملية جديدة.

الحقل	نوع التسلسل	المعنى
`allowed_actions`	`array<string>`	إجراءات مسموح بها في حالة العملية المعتمدة الحالية.
`content_counts`	`object`	عدادات معتمدة مسماة لعناصر المصدر أو المراحل أو التحضير؛ ليست حالات دورة حياة مستقلة.
`display_status`	`string \| null`	التنفيذ أو العرض أو النتيجة النهائية المعتمدة؛ قد تغيب النتيجة أثناء النشاط.
`event_sequence`	`integer`	رقم تسلسل أحداث أو مراجعة حالة معتمدة متزايد.
`execution_state`	`string \| null`	التنفيذ أو العرض أو النتيجة النهائية المعتمدة؛ قد تغيب النتيجة أثناء النشاط.
`finished_at`	`string \| null`	أوقات معتمدة؛ تعني null عدم تسجيل وقت لهذا الحدث.
`operation_id`	`string \| null`	معرّف المورد الذي يوفره هذا الفرع. احفظ معرّف العملية قبل استئناف التحضير أو المراقبة.
`outcome`	`string \| null`	التنفيذ أو العرض أو النتيجة النهائية المعتمدة؛ قد تغيب النتيجة أثناء النشاط.
`phase_counts`	`object`	عدادات معتمدة مسماة لعناصر المصدر أو المراحل أو التحضير؛ ليست حالات دورة حياة مستقلة.
`preparation_counts`	`object`	عدادات معتمدة مسماة لعناصر المصدر أو المراحل أو التحضير؛ ليست حالات دورة حياة مستقلة.
`preparation_failures`	`array<object>`	أخطاء مصادر مع media_path وcontent_id وfailure_code؛ أعد توفير التحضيرات المؤهلة فقط.
`preparation_incomplete`	`boolean`	علامة قرار أو حالة خاصة بالفرع؛ لا يعني غيابها False. قد ينجح الإلغاء دون إنشاء عمل.
`project_id`	`string \| null`	معرّف المورد الذي يوفره هذا الفرع. احفظ معرّف العملية قبل استئناف التحضير أو المراقبة.
`sources_supplied`	`integer`	عدد المصادر المقبولة أو المخرجات المطابقة غير المعدلة أو المخرجات المكتوبة حديثاً؛ احتفظ بالأعداد بعد الفشل الجزئي.
`started_at`	`string \| null`	أوقات معتمدة؛ تعني null عدم تسجيل وقت لهذا الحدث.
`state_version`	`integer`	رقم تسلسل أحداث أو مراجعة حالة معتمدة متزايد.
`updated_at`	`string \| null`	أوقات معتمدة؛ تعني null عدم تسجيل وقت لهذا الحدث.

يسرد الجرد المتحقق منه التالي الحقول داخل فروع الكائنات والمصفوفات. إنه جرد وليس غلاف استجابة. تستخدم عناصر المصفوفة []. قد يغيب الكائن كله عند الإلغاء. تتبع الأنواع والمعاني أوصاف الحقول أعلاه؛ تستخدم العدادات مخططات دورة الحياة المتداخلة.

JSON

{
  "preparation_failures[]": [
    "content_id",
    "failure_code",
    "path"
  ]
}

`operation.watch`

إعادة الاتصال بحالة العملية المعتمدة مع أحداث فورية واستعلام HTTP. يفصل Ctrl-C دون إلغاء العمل المقبول.

الحقل	نوع التسلسل	المعنى
`allowed_actions`	`array<string>`	إجراءات مسموح بها في حالة العملية المعتمدة الحالية.
`content_counts`	`object`	عدادات معتمدة مسماة لعناصر المصدر أو المراحل أو التحضير؛ ليست حالات دورة حياة مستقلة.
`display_status`	`string \| null`	التنفيذ أو العرض أو النتيجة النهائية المعتمدة؛ قد تغيب النتيجة أثناء النشاط.
`event_sequence`	`integer`	رقم تسلسل أحداث أو مراجعة حالة معتمدة متزايد.
`execution_state`	`string \| null`	التنفيذ أو العرض أو النتيجة النهائية المعتمدة؛ قد تغيب النتيجة أثناء النشاط.
`failures`	`array<object>`	عناصر غير متاحة مع media_path وcontent_id وسبب تقني؛ لا تصدر المدخلات الفاشلة.
`finished_at`	`string \| null`	أوقات معتمدة؛ تعني null عدم تسجيل وقت لهذا الحدث.
`operation_id`	`string \| null`	معرّف المورد الذي يوفره هذا الفرع. احفظ معرّف العملية قبل استئناف التحضير أو المراقبة.
`outcome`	`string \| null`	التنفيذ أو العرض أو النتيجة النهائية المعتمدة؛ قد تغيب النتيجة أثناء النشاط.
`phase_counts`	`object`	عدادات معتمدة مسماة لعناصر المصدر أو المراحل أو التحضير؛ ليست حالات دورة حياة مستقلة.
`preparation_counts`	`object`	عدادات معتمدة مسماة لعناصر المصدر أو المراحل أو التحضير؛ ليست حالات دورة حياة مستقلة.
`project_id`	`string \| null`	معرّف المورد الذي يوفره هذا الفرع. احفظ معرّف العملية قبل استئناف التحضير أو المراقبة.
`started_at`	`string \| null`	أوقات معتمدة؛ تعني null عدم تسجيل وقت لهذا الحدث.
`state_version`	`integer`	رقم تسلسل أحداث أو مراجعة حالة معتمدة متزايد.
`updated_at`	`string \| null`	أوقات معتمدة؛ تعني null عدم تسجيل وقت لهذا الحدث.

JSON

{
  "failures[]": [
    "content_id",
    "media_path",
    "reason"
  ]
}

`project.bind`

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

الحقل	نوع التسلسل	المعنى
`binding`	`object`	ارتباط محدد: api_url وuser_id وpath وpath_kind وproject_id وproject_name وproject_mode. يتضمن فرع قائمة الارتباطات أيضاً bound_at وvalidated_at.
`cancelled`	`boolean`	علامة قرار أو حالة خاصة بالفرع؛ لا يعني غيابها False. قد ينجح الإلغاء دون إنشاء عمل.
`path`	`string`	المسار المحلي الموحّد لهذا الارتباط أو المزامنة.

JSON

{
  "binding": [
    "api_url",
    "path",
    "path_kind",
    "project_id",
    "project_mode",
    "project_name",
    "user_id"
  ]
}

`project.bindings`

قراءة الارتباطات المخزنة دون تحقق من الخادم أو مصادقة. يرشح PATH الاختياري القائمة المحلية.

الحقل	نوع التسلسل	المعنى
`bindings`	`array<object>`	ارتباطات مخزنة مقروءة أو محذوفة ضمن هذا النطاق المحلي؛ لا يغير حذفها مشروع الخادم.

JSON

{
  "bindings[]": [
    "api_url",
    "bound_at",
    "path",
    "path_kind",
    "project_id",
    "project_mode",
    "project_name",
    "user_id",
    "validated_at"
  ]
}

`project.forget`

إزالة ارتباطات محلية ضمن نطاق البوابة والحساب؛ قبول المسارات المفقودة وعدم حذف مشاريع الخادم أو أرشفتها.

الحقل	نوع التسلسل	المعنى
`cancelled`	`boolean`	علامة قرار أو حالة خاصة بالفرع؛ لا يعني غيابها False. قد ينجح الإلغاء دون إنشاء عمل.
`path`	`string`	المسار المحلي الموحّد لهذا الارتباط أو المزامنة.
`removed`	`array<object>`	ارتباطات مخزنة مقروءة أو محذوفة ضمن هذا النطاق المحلي؛ لا يغير حذفها مشروع الخادم.

JSON

{
  "removed[]": [
    "api_url",
    "project_id",
    "project_name",
    "user_id"
  ]
}

`project.sync`

فحص الإدخال المحلي بالكامل ومطابقة جرد المشروع. تمنع أخطاء الفحص إرسال جزء فقط؛ يتطلب التطبيق القديم معاينة جديدة.

الحقل	نوع التسلسل	المعنى
`action`	`string`	إجراء مزامنة ملف مثل add أو replace أو up_to_date.
`applied`	`boolean`	علامة قرار أو حالة خاصة بالفرع؛ لا يعني غيابها False. قد ينجح الإلغاء دون إنشاء عمل.
`auto_apply_safe`	`boolean`	علامة قرار أو حالة خاصة بالفرع؛ لا يعني غيابها False. قد ينجح الإلغاء دون إنشاء عمل.
`binding`	`object`	ارتباط محدد: api_url وuser_id وpath وpath_kind وproject_id وproject_name وproject_mode. يتضمن فرع قائمة الارتباطات أيضاً bound_at وvalidated_at.
`cancelled`	`boolean`	علامة قرار أو حالة خاصة بالفرع؛ لا يعني غيابها False. قد ينجح الإلغاء دون إنشاء عمل.
`confirmed_moves`	`array<object>`	خرائط مسارات وسائط تمت مراجعتها؛ احتفظ بمعرّفات المعاينة وأدلتها.
`media`	`object`	ملخص الوسائط المتزامنة مع id وpath وstatus؛ يظهر في فروع مزامنة الملفات المناسبة.
`media_id`	`string \| null`	معرّف المورد الذي يوفره هذا الفرع. احفظ معرّف العملية قبل استئناف التحضير أو المراقبة.
`mode`	`string`	وضع المشروع file أو directory المحدد من الإدخال المحلي.
`path`	`string`	المسار المحلي الموحّد لهذا الارتباط أو المزامنة.
`preview`	`boolean`	علامة قرار أو حالة خاصة بالفرع؛ لا يعني غيابها False. قد ينجح الإلغاء دون إنشاء عمل.
`summary`	`object`	أعداد تغييرات المجلد وملخص المعاينة؛ افحص التغييرات قبل الموافقة.
`up_to_date`	`boolean`	علامة قرار أو حالة خاصة بالفرع؛ لا يعني غيابها False. قد ينجح الإلغاء دون إنشاء عمل.

JSON

{
  "binding": [
    "api_url",
    "path",
    "path_kind",
    "project_id",
    "project_mode",
    "project_name",
    "user_id"
  ],
  "confirmed_moves[]": [
    "new_path",
    "old_path"
  ],
  "media": [
    "id",
    "path",
    "status"
  ],
  "media[]": [
    "id",
    "path",
    "status"
  ]
}

`status`

التحقق من بيانات الاعتماد الفعلية والبوابة؛ لا تُحفظ تجاوزات البيئة.

الحقل	نوع التسلسل	المعنى
`api_url`	`string`	بوابة أو حساب متحقق منه أو مصدر بيانات الاعتماد؛ لا يعاد سر الرمز.
`credential_source`	`string`	بوابة أو حساب متحقق منه أو مصدر بيانات الاعتماد؛ لا يعاد سر الرمز.
`user_id`	`string`	بوابة أو حساب متحقق منه أو مصدر بيانات الاعتماد؛ لا يعاد سر الرمز.

فروع التحضير والمخرجات الجزئية

يستخدم start أو supply غير المكتمل رمز الخروج 7 وerror.code=remote_rejection وerror.details مع operation_id وpreparation_incomplete=true وpreparation_failures. يسمي كل فشل تحضير path وcontent_id وfailure_code؛ تستخدم أخطاء المراقبة بدلاً منها media_path وcontent_id وreason. احتفظ بمعرّف العملية واستخدم استرداد تحضير المصدر المؤهل.

تستخدم أخطاء المراقبة رمز 8 وdetails.operation_id وstatus وfailures. قد يكتب التطبيق الجزئي ملفات ناجحة ويبقى رمز الخروج 8؛ يحتفظ details.result بـoutputs وwritten_outputs وunchanged_outputs وselected_artifact_ids مع حقول دورة الحياة. احتفظ بهذه النتيجة المتداخلة قبل الإبلاغ عن الفشل. لا يمكن تصدير عناصر المصدر الفاشلة نفسها. يوافق --yes --allow-partial على هذا الفرع صراحةً؛ لا يمنح --allow-partial وحده موافقة دون تدخل.

يتطلب العمل الفاشل نهائياً عملية جديدة بتقدير مستقل. لا تكرر operation start كاستجابة عامة لكل رمز خروج غير صفري.