عیب‌یابی#

خطاهای الامر را از روی شواهد ساختاریافته تشخیص دهید: code نمادین، exitCode عددی، وضعیت HTTP و شناسهٔ درخواست. برای ناپدیدکردن خطا، شناسهٔ تغییرناپذیر، چکیده، نسخهٔ انتشار، فایل قفل یا وضعیت Registry را دستی ویرایش نکنید. هر مورد زیر یک کد پایدار واقعی، امکان تکرار همان‌طور و اقدام بعدی را مشخص می‌کند.

واکنش نخست#

از داخل پروژهٔ Environment، App یا Plugin این نتایج را جمع کنید:

alamr doctor --json --non-interactive
alamr inspect --json --non-interactive
alamr validate --json --non-interactive
alamr status --json --non-interactive

doctor نسخهٔ Node.js، مدیر بستهٔ تشخیص‌داده‌شده، مانیفست و فایل قفل محلی و سلامت Registry را بررسی می‌کند. inspect اعلان محلی را نشان می‌دهد. validate مشکلات سطح فیلد را برمی‌گرداند. status به پیوند معتبر و اعتبارنامهٔ مدیریتی نیاز دارد و وضعیت انتشار Registry را برمی‌گرداند.

این موارد را ثبت کنید: schemaVersion، فرمان، code نمادین، exitCode عددی، ok، diagnostics، nextActions، artifacts، data، مبدأ Registry، شناسهٔ Project، شناسهٔ مقصد، نسخه و در صورت وجود شناسهٔ درخواست. پیش از اشتراک شواهد، توکن‌های دسترسی، headerهای احراز هویت، cookieها و رازها را حذف کنید.

کدهای خروج CLI#

کد	رده	کد نمادین نتیجه	اقدام نخست
0	موفق	ALAMR_OK	data ساختاریافته را بخوانید؛ وضعیت انتشار بعدی را حدس نزنید
1	خطای اعتبارسنجی یا اجرا	ALAMR_ERROR	خطاهای فیلد، نتایج بررسی یا کد خطای سرور را بخوانید و ورودی یا عملیات شکست‌خورده را اصلاح کنید
2	شیوهٔ استفادهٔ نادرست	ALAMR_USAGE	alamr --help را اجرا و آرگومان‌ها یا گزینه‌های پشتیبانی‌شده را اصلاح کنید
3	احراز هویت یا مجوز	ALAMR_AUTH_REQUIRED	مبدأ Registry، انقضای اعتبارنامه، مالکیت و دامنهٔ توکن را بررسی کنید
4	شبکه	ALAMR_NETWORK_ERROR	مبدأ تمیز Registry، DNS، TLS، پراکسی و سلامت سرویس را بررسی کنید
5	تعارض وضعیت	ALAMR_CONFLICT	پیش از تلاش مجدد وضعیت فعلی Registry را بخوانید؛ از تغییرناپذیری و وضعیت خوش‌بینانه محافظت کنید

HTTP 401 و 403 به کد خروج 3 و HTTP 409 به کد خروج 5 نگاشت می‌شود. پاسخ 429 از Registry فقط پس از مکث کوتاه باید تکرار شود. سایر پاسخ‌های ناموفق معمولاً به کد خروج 1 نگاشت می‌شوند.

کدهای احراز هویت و حساب#

کد	HTTP / خروج	معنی	تکرار همان‌طور	اقدام بعدی
authentication_required	401 / 3	درخواست نشست یا توکن معتبر همراه نداشت	خیر	برای Registry موردنظر alamr login اجرا یا توکن پروژهٔ محدود و دارای انقضا بدهید
management_token_invalid	401 / 3	اعتبارنامهٔ مدیریتی منقضی است یا برای این Registry نیست	خیر	دوباره وارد شوید یا توکن تازه برای همان Registry و Project دقیق بسازید
csrf_failed	403 / 3	mutation کنسول/BFF توکن CSRF معتبر نداشت	خیر	نشست کنسول را تازه و عمل را از مسیر UI یا قرارداد API تکرار کنید
rate_limited	429 / 1	محدودیت نرخ Registry	بله، پس از مکث کوتاه	شناسهٔ درخواست را نگه دارید، مکث کنید و یک‌بار تکرار کنید؛ حلقهٔ تکرار بی‌کنترل نسازید
project_access_denied	403 / 3	کاربر مالک یا مدیر این Project نیست	خیر	از Project متعلق به خود یا حسابی با نقش لازم در Project استفاده کنید
project_token_scope_denied	403 / 3	توکن پروژه دامنهٔ این عملیات را ندارد	خیر	توکن با حداقل دامنهٔ لازم بسازید؛ نوشتن انتشار به publish:write نیاز دارد
ALAMR_LOGIN_APPROVAL_REQUIRED	- / 0	handoff ورود device ساخته شده؛ انسان باید تأیید کند	نامربوط	مکث کنید؛ انسان نشانی تأیید را باز و کد کاربر را تأیید می‌کند
ALAMR_LOGIN_APPROVAL_PENDING	- / 1	انسان هنوز handoff را تأیید نکرده است	بله، با فاصلهٔ بازگشتی	retryAfterSeconds صبر کنید و همان فرمان resume دقیق را دوباره اجرا کنید
ALAMR_AUTHORIZATION_DENIED	- / 1	انسان احراز را رد کرد	خیر	فقط با توافق انسان alamr login --device --json را از نو شروع کنید

ورود CLI، SSO مرورگر، توکن‌های Runtime محیط، نشست‌های کنسول و توکن‌های پروژهٔ CI رده‌های جداگانه‌ای از اعتبارنامه‌اند. یکی را به‌جای دیگری به کار نبرید.

کدهای شبکه و دسترس‌پذیری#

کد	HTTP / خروج	معنی	تکرار همان‌طور	اقدام بعدی
ALAMR_NETWORK_ERROR	- / 4	مشکل DNS، TLS، پراکسی، فایروال، مهلت یا قطعی Registry	بله، پس از برقراری ارتباط	doctor --json را اجرا کنید؛ ارتباط را برقرار یا Registry سالم موردنظر را انتخاب کنید
artifact_store_unavailable	503 / 1	مخزن عمومی بسته در دسترس نیست	بله، پس از بازیابی	صبر و تکرار کنید؛ بسته‌ها را با فایل ساختگی جایگزین نکنید
managed_artifact_store_unavailable	503 / 1	ذخیره‌ساز بستهٔ مدیریت‌شده در دسترس نیست	بله، پس از بازیابی	صبر کنید و همان عملیات را تکرار کنید
external_npm_registry_unavailable	502 / 1	رجیستری npm بالادست پاسخ نداد	بله، پس از بازیابی	گردش‌کار npm-ingestion را بعداً تکرار کنید
presence_unavailable	503 / 1	ذخیرهٔ Presence در دسترس نیست	بله، پس از بازیابی	منتظر بازیابی Presence بمانید؛ مدرک باید از ذخیرهٔ Registry بیاید، نه از نامزد

شکست خواندن کاتالوگ با runtime_coordination_unavailable دو مسئلهٔ متفاوت‌اند: مسیر، وضعیت HTTP و کد مشکل را حفظ کنید. هرگز از وضعیت انتشار Registry به متادیتای npm، ثابت‌های صحنه، نمای cacheشدهٔ کنسول یا نام بسته برنگردید.

کدهای پیوند پروژه و مانیفست#

کد	HTTP / خروج	معنی	تکرار همان‌طور	اقدام بعدی
project_not_found	404 / 1	projectId پیوندشده روی این Registry وجود ندارد	خیر	.al-amr/project.json را با رکورد Project در کنسول/API مقایسه و Project متعلق به خود را پیوند دهید
not_environment_project	409 / 5	نوع Project پیوندشده با مانیفست محلی فرق دارد	خیر	Project متعلق به خود را با همان نوع پیوند دهید
not_app_project	409 / 5	Project پیوندشده از نوع App نیست	خیر	یک App Project متعلق به خود را پیوند دهید
not_plugin_project	409 / 5	Project پیوندشده از نوع Plugin نیست	خیر	یک Plugin Project متعلق به خود را پیوند دهید
slug_already_exists	409 / 5	slug درخواستی زیر این Publisher قبلاً گرفته شده	خیر	slug آزاد انتخاب کنید؛ رکورد موجود را بازنویسی نکنید
invalid_environment_manifest	422 / 1	یک فیلد قرارداد، نشانی، نصب یا قاعدهٔ ترکیب نقض شده	خیر	همهٔ موارد data.errors را بخوانید و فیلد منبع نام‌برده را اصلاح کنید؛ دوباره اعتبارسنجی کنید
invalid_plugin_manifest	422 / 1	مانیفست Plugin قرارداد را نقض کرده	خیر	فیلدهای نام‌برده را اصلاح کنید؛ اگر نسخه‌ای موجود است SemVer را افزایش دهید
invalid_app_manifest	422 / 1	مانیفست App قرارداد را نقض کرده	خیر	فیلدهای نام‌برده را اصلاح و نسل build تازه آماده کنید
invalid_environment_composition	422 / 1	اتصال‌های ترکیب اعلام‌شده نامعتبر است؛ علت‌ها در details.issues[] است	خیر	اتصال port، آداپتر یا protocol-artifact گزارش‌شده را اصلاح کنید
plugin_release_not_found	404 / 1	نسخهٔ Plugin نصب‌شده وجود ندارد یا دیده نمی‌شود	خیر	مقصد منتشرشدهٔ موجود انتخاب کنید؛ هویت را از نام بستهٔ npm حدس نزنید

کدهای آزمون و انتشار#

کد	HTTP / خروج	معنی	تکرار همان‌طور	اقدام بعدی
publication_target_frozen	409 / 5	درخواست مشابه یا متعارضی همین مقصد را ثابت کرده است	خیر	alamr status --json را بخوانید؛ همان درخواست موجود را ادامه دهید و تکراری نسازید
submission_checks_not_allowed	409 / 5	بررسی خارج از draft یا checks_failed درخواست شده	خیر	وضعیت فعلی را بخوانید و عمل مجاز آن را انجام دهید
submission_not_ready	409 / 5	ارسال پیش از ready_for_review درخواست شده یا قبلاً جلو رفته	خیر	وضعیت را با status تأیید کنید؛ in_review برای گام ارسال موفقیت است
publication_state_changed	409 / 5	عامل یا درخواست دیگری submission را جلو برده	خیر	از وضعیت فعلی Registry ارزیابی کنید؛ گذار کهنهٔ from را دوباره پخش نکنید
artifact_snapshot_changed	409 / 5	مجموعهٔ بسته با چکیدهٔ ثابت درخواست دیگر نمی‌خواند	خیر	متوقف شوید؛ صحت Registry را بررسی و در صورت تغییر واقعی محتوا مقصد تغییرناپذیر تازه بسازید
snapshot_digest_mismatch	409 / 5	شواهد بازبینی با چکیدهٔ نسخهٔ ثابت دیگر نمی‌خواند	خیر	متوقف شوید؛ چکیده را هرگز بازنویسی نکنید
artifact_digest_mismatch	409 / 5	شواهد بازبینی با چکیدهٔ بستهٔ ثابت دیگر نمی‌خواند	خیر	متوقف شوید؛ چکیده را هرگز بازنویسی نکنید
dedicated_publication_action_required	403 / 3	مسیر عمومی گذار برای بررسی، ارسال یا بازبینی به کار رفته	خیر	مسیر اختصاصی /checks، /submit یا /review را صدا بزنید
backend_protocol_reference_missing	409 / 1	مولفهٔ بک‌اند جدید به شواهد تغییرناپذیر پروتکل اشاره ندارد	خیر	اعلان OpenAPI/AsyncAPI منطبق و فایل داخل بسته را افزوده و نسخهٔ تازه را آزمون کنید
backend_protocol_artifact_bytes_missing	409 / 1	بایت‌های پروتکل مرجع در بسته نیست	خیر	مسیر دقیق پروتکل را بسته‌بندی و چکیده را از همان بایت‌ها بازتولید کنید
backend_protocol_artifact_digest_mismatch	409 / 1	بایت‌های پروتکل داخل بسته با SHA-256 اعلام‌شده فرق دارد	خیر	چکیده را از بایت‌های داخل بسته بازتولید کنید؛ شواهد صرفاً متادیتا منتشر نمی‌شود
plugin_release_not_published	409 / 1	نسخهٔ Plugin نصب‌شده منتشر نشده	خیر	نسخهٔ منتشرشده نصب کنید یا ابتدا وابستگی را منتشر کنید
plugin_artifact_not_valid	409 / 1	نسخهٔ نصب‌شده بستهٔ معتبر ندارد	خیر	ناشر Plugin باید نسخه/بستهٔ معتبر تازه بسازد
plugin_contract_incompatible	409 / 1	نسخهٔ نصب‌شده range فعلی Contracts پلتفرم را نمی‌پذیرد	خیر	با اعلان‌های سازگار ترفیع‌یافته بازسازی کنید؛ دروازهٔ Registry را تضعیف نکنید
plugin_sdk_incompatible	409 / 1	SemVer دقیق SDK میزبانی‌شده یا نصب‌شده پذیرفته نیست	خیر	با SDK سازگار ترفیع‌یافته بازسازی کنید
backend_unreachable	409 / 1	نشانی سلامت بک‌اند در دسترس نیست	بله، پس از رفع endpoint	دسترس‌پذیری سلامت را برقرار و alamr test را دوباره اجرا کنید
backend_health_url_required	422 / 1	اعلان استقرار نشانی سلامت ندارد	خیر	endpoint سلامت غیرمحرمانه روی مبدأ بک‌اند اعلام کنید
runtime_verification_deferred	- / 0	راستی‌آزمایی معتبر Runtime/Presence تا پس از تأیید به تعویق افتاده	نامربوط	چرخه را ادامه دهید؛ این نتیجهٔ اطلاع‌رسان بررسی است، نه شکست

برای روند بازیابی هر وضعیت، چرخهٔ انتشار و بازیابی و بازگردانی را ببینید.

کدهای بازبینی و مدیریت انتشار#

کد	HTTP / خروج	معنی	تکرار همان‌طور	اقدام بعدی
reviewer_required	403 / 3	فراخوان بازبین یا مدیر مجاز این مسیر نیست	خیر	از حساب بازبین/مدیر استفاده کنید؛ توکن Project رد می‌شود
reviewer_separation_of_duty	403 / 3	ارسال‌کننده خواسته درخواست خودش را بازبینی کند	خیر	منتظر بازبین مستقل بمانید
publisher_separation_of_duty	403 / 3	بازبین تأییدکننده خواسته همان درخواست را منتشر کند	خیر	انتشار را به مدیر پلتفرم دیگری تحویل دهید
review_work_item_not_found	404 / 1	آیتم بازبینی وجود ندارد	خیر	شناسهٔ submission را تأیید کنید
review_work_item_snapshot_mismatch	409 / 5	چکیدهٔ نسخهٔ ثابت آیتم به‌طور هم‌زمان تغییر کرده	خیر	آیتم را دوباره بخوانید و با چکیده‌های فعلی تصمیم بگیرید
review_work_item_artifact_mismatch	409 / 5	چکیدهٔ بستهٔ آیتم به‌طور هم‌زمان تغییر کرده	خیر	آیتم را دوباره بخوانید و با چکیده‌های فعلی تصمیم بگیرید
review_plugin_artifact_inspection_unavailable	409 / 1	جریان بستهٔ بازبین برای بازرسی سرو نمی‌شود	بله، پس از بازیابی	مسیر بازرسی هم‌مبدأ را تکرار کنید؛ بایت‌های راستی‌آزمایی‌نشده را نپذیرید
publication_approval_evidence_unavailable	409 / 5	شواهد تأیید لازم برای انتشار گم‌شده یا کهنه است	خیر	به بازبینی برگردید؛ انتشار بدون شواهد تأیید جاری ممکن نیست
invalid_review	422 / 1	بدنهٔ درخواست بازبینی قرارداد را نقض کرده (مثلاً رد بدون توضیح)	خیر	تصمیم، توضیح و چکیده‌های موردانتظار لازم را بدهید
environment_runtime_preview_expired	409 / 5	یک رکورد قدیمیِ پیش‌نمایش Environment منقضی شده است	خیر	این کد فقط برای داده‌های سازگاری قدیمی است؛ همان باندل را دوباره build و test کنید
environment_runtime_preview_not_renewable	409 / 5	یک رکورد قدیمیِ پیش‌نمایش قابل تمدید نیست	خیر	جریان فعلی باندل را اجرا کنید؛ انتشار جدید به تمدید پیش‌نمایش نیاز ندارد
environment_runtime_preview_state_changed	409 / 5	وضعیت یک رکورد قدیمیِ پیش‌نمایش تغییر کرده است	خیر	وضعیت را دوباره بخوانید و انتشار فعلی مبتنی بر باندل را از نو شروع کنید
environment_runtime_proof_required	409 / 5	یک جریان قدیمیِ بازبینی هنوز اثبات Runtime میزبانی‌شده می‌خواهد	خیر	بازبینی تازه‌ای با باندل ثابت ایجاد کنید؛ جریان فعلی heartbeat یا callback انتشار ندارد
invalid_environment_preview_renewal	422 / 1	یک درخواست تمدید قدیمی قرارداد را نقض کرده است	خیر	از تمدید صرف‌نظر و همان Environment را با جریان فعلی باندل دوباره منتشر کنید
managed_artifact_cache_unavailable	503 / 1	cache بستهٔ منتشرشده نمی‌تواند بایت راستی‌آزمایی‌شده سرو کند	بله، پس از بازیابی	صبر و تکرار کنید؛ cache به‌جای سرو بایت راستی‌آزمایی‌نشده fail-closed می‌شود
project_recovery_admin_required	403 / 3	بازگردانی به مدیر نیاز دارد	خیر	از حساب مدیر پلتفرم استفاده کنید
invalid_rollback	422 / 1	درخواست بازگردانی قرارداد را نقض کرده	خیر	نوع مقصد، شناسهٔ مقصد، دلیل و چکیدهٔ برنامه را اصلاح کنید
rollback_target_not_eligible	409 / 5	مقصد بازگردانی، مقصد هنوز منتشرشده و block‌نشدهٔ همین Project نیست	خیر	مقصد منتشرشدهٔ واجد شرایط دیگری انتخاب یا مقصد تازه‌ای منتشر کنید
admin_required	403 / 3	عملیات به مدیر پلتفرم نیاز دارد	خیر	از حساب مدیر استفاده کنید؛ توکن Project رد می‌شود
invalid_app_availability	422 / 1	بدنهٔ درخواست availability قرارداد را نقض کرده	خیر	appId، revisionId، enabled و دلیل ۳ تا ۱۰۰۰ نویسه‌ای بدهید

کدهای Runtime و Presence#

خطاهای مجوز Runtime با قالب application/problem+json و کدهای پایدار برمی‌گردند. وضعیت HTTP و code را حفظ کنید.

کد	HTTP	معنی	تکرار همان‌طور	اقدام بعدی
runtime_token_invalid	401	توکن bearer یا اتصال نشست Runtime گم‌شده یا نامعتبر است	خیر	از راه SDK احراز را از نو شروع کنید؛ هرگز اعتبارنامهٔ CLI، CI یا کنسول را جایگزین نکنید
runtime_authorization_expired	401	مجوز، grant یا نشست Runtime منقضی یا باطل شده	خیر	از مسیر retry/احراز مجدد SDK استفاده کنید؛ شکست، شخص را خارج می‌کند نه تنزل
account_required	403	نشست Runtime حسابی حمل نمی‌کند و هر دنیایی یکی می‌خواهد	خیر	وارد حساب شوید. ورودی که حساب نخواهد وجود ندارد؛ سیاستی که اینجا بود حذف شد
runtime_origin_required	403	header مرورگر Origin نیست	خیر	باندل را از راه کلاینت دسکتاپ اجرا کنید؛ Origin را جعل نکنید
runtime_origin_mismatch	403	Origin مرورگر با مبدأ نشست فرق دارد	خیر	همان باندل دقیق را از راه کلاینت دسکتاپ دوباره اجرا کنید
runtime_origin_unregistered	403	درخواست از مبدأ وبیِ قدیمی آمده است	خیر	به‌جای میزبانی frontend، باندل فعلی را منتشر و از مبدأ اختصاص‌یافتهٔ پلتفرم اجرا کنید
environment_not_available	403	Environment فعلاً برای مجوز Runtime در دسترس نیست	خیر	وضعیت انتشار را بررسی کنید؛ بازبینی yank یا suspendشده نمی‌تواند مجوز دهد
runtime_session_standby	409	صفحهٔ مجازشده مالک lease فعال نیست	خیر	پیش از فراخوانی APIهای محافظت‌شدهٔ Runtime، صراحتاً این صفحه را فعال کنید
runtime_session_superseded	409	صفحه یا دستگاه جدیدتری فعال شده	خیر	در Runtime جدیدتر ادامه دهید یا صراحتاً Activate this page را بزنید
runtime_lease_stale	409	شناسه/نسخهٔ lease منقضی شده یا با fence فعال نمی‌خواند	خیر	از راه SDK دوباره فعال کنید و کار fenceشده را از نو شروع کنید
runtime_coordination_unavailable	503	Registry نمی‌تواند Runtime فعال واحد را امن هماهنگ کند	بله، پس از بازیابی	صبر کنید و از راه SDK تکرار کنید؛ این شکست عمداً بسته است
environment_preview_access_denied	403	فراخوان عضو Project یا مدیر این پیش‌نمایش نیست	خیر	با حساب مجاز وارد شوید
invalid_presence_heartbeat	422	heartbeat قرارداد را نقض کرده	خیر	heartbeat را فقط از راه SDK بفرستید

SDK توکن‌های مرورگر را در حافظه نگه می‌دارد. reload یا از دست رفتن وضعیت تراکنش ممکن است احراز دوباره بخواهد؛ این از نگهداشت توکن bearer در local storage امن‌تر است.

کدهای Plugin Grant و استقرار بک‌اند#

کد	HTTP	معنی	تکرار همان‌طور	اقدام بعدی
plugin_not_installed	403	Plugin در این بازبینی Environment نصب نیست	خیر	نسخهٔ دقیق را با alamr add نصب کنید
plugin_release_version_mismatch	409	درخواست Grant نسخه‌ای متفاوت از نصب را نام می‌برد	خیر	برای همان نسخهٔ نصب‌شدهٔ دقیق Grant بخواهید
plugin_release_unavailable	409	نسخهٔ نصب‌شده فعلاً منتشر نشده	خیر	نسخهٔ منتشرشده نصب کنید
plugin_release_emergency_blocked	403	نسخه زیر مسدودسازی اضطراری فعال است	خیر؛ تا حل block صبر کنید	منتظر بمانید تا بازبین پلتفرم مسدودسازی اضطراری را حل کند
backend_component_not_declared	409	مولفه توسط نسخهٔ نصب‌شده اعلام نشده	خیر	مولفه را در نسخهٔ Plugin تازه اعلام کنید
backend_deployment_not_found	409	استقراری برای مولفه وجود ندارد	خیر	بازبینی استقرار بک‌اند را بسازید و منتشر کنید
backend_deployment_pending	503	بازبینی استقرار هنوز منتشر نشده	بله، پس از انتشار	بازبینی استقرار را منتشر و سپس تکرار کنید
backend_deployment_unhealthy	503	بررسی سلامت استقرار شکست می‌خورد	بله، پس از بهبود endpoint	سلامت بک‌اند را برقرار کنید؛ شواهد هنگام تکرار تازه می‌شود
backend_deployment_suspended	403	استقرار مدیریتی تعلیق شده	خیر	پس از تأیید بازبین، بازبینی استقرار جایگزین منتشر کنید
backend_deployment_emergency_blocked	403	استقرار زیر مسدودسازی اضطراری فعال است	خیر؛ تا حل block صبر کنید	منتظر بمانید تا بازبین پلتفرم مسدودسازی اضطراری را حل کند
grant_scope_denied	403	دامنهٔ Grant درخواستی توسط نصب اعلام نشده	خیر	فقط دامنه‌های بررسی‌شده و اعلام‌شده بخواهید
scope_denied	403	پذیرش scope رد شده، مهلت گذشته یا پاسخ بدشکل بوده	خیر	endpoint پذیرش scope بک‌اند Environment را بررسی کنید؛ رد به‌صورت generic fail-closed است

کدهای build و launch اپ#

کد	HTTP / خروج	معنی	تکرار همان‌طور	اقدام بعدی
app_build_artifact_required	409 / 5	بازبینی App به باندل تغییرناپذیر متصل نیست	خیر	alamr build و سپس alamr test --yes --json را برای یک باندل واحد اجرا کنید
app_build_snapshot_changed	409 / 5	درخواست، چکیدهٔ باندل متفاوتی از مقدار متصل را نام می‌برد	خیر	همان باندل را تغییر ندهید؛ نسخهٔ تازه را build و test کنید
app_build_artifact_invalid	409 / 5	فهرست متصل دیگر به چکیده‌ای که با آن متصل شد نمی‌رسد	خیر	بازبینی App تازه بسازید؛ فهرست متصل هرگز در جا ویرایش نمی‌شود
app_contract_incompatible	409 / 1	range قراردادهای مانیفست پلتفرم فعلی را نمی‌پذیرد	خیر	با اعلان‌های Contracts سازگار ترفیع‌یافته بازسازی کنید
app_build_artifact_immutable	409 / 5	تلاش برای اتصال دوبارهٔ بستهٔ build موجود	خیر	برای بایت‌های تغییرکرده بازبینی App تازه بسازید
app_build_artifact_binding_closed	409 / 5	اتصال واحد build این بازبینی قبلاً بسته شده	خیر	برای بایت‌های تغییرکرده بازبینی App تازه بسازید
app_not_available	404 یا 403	بازبینی App برای Runtime فعال نیست	خیر	مدیر پلتفرم باید همان بازبینی منتشرشدهٔ دقیق را فعال کند
app_account_required	403	App به اصیل حساب‌محور نیاز دارد	خیر	با نشست حساب وارد شوید
parent_runtime_not_active	409	Runtime محیط والد فعال نیست	خیر	پیش از launch اپ، Runtime والد را فعال کنید
parent_runtime_lease_stale	409	lease Runtime والد با fence فعال نمی‌خواند	خیر	Runtime والد را دوباره برقرار و launch را تکرار کنید
app_origin_required	403	launch از مبدأ اختصاص‌یافتهٔ پلتفرم نیامده	خیر	باندل نگه‌داشته‌شده را از راه AppHost دوباره اجرا کنید؛ frontend را خودتان میزبانی نکنید
app_launch_code_invalid	401	کد یک‌بارمصرف launch گم‌شده، مصرف‌شده یا منقضی است	خیر	launch را از راه Widget میزبان از نو شروع کنید

کدهای جای‌گذاری در Hub#

کد	HTTP / خروج	معنی	تکرار همان‌طور	اقدام بعدی
invalid_hub_placement	422 / 1	درخواست جای‌گذاری قرارداد را نقض کرده	خیر	شناسه‌ها و دلیل ۳ تا ۱۰۰۰ نویسه‌ای را اصلاح کنید
hub_placement_zone_not_found	404 / 1	Hub یا Zone وجود ندارد	خیر	شناسه‌های Hub و Zone را با alamr admin hubs list --json تأیید کنید
hub_placement_target_already_assigned	409 / 5	مقصد قبلاً به اسلات دیگری در Hub تخصیص یافته	خیر	Environment واجد شرایط دیگری انتخاب یا تخصیص متعارض را clear کنید

تعارض‌های جای‌گذاری اسلات fixed، انتخاب خود Hub به‌عنوان مقصد و مقصدهای فاقد شرایط یا گم‌شده را هم دربر می‌گیرد. آن‌ها را با ویرایش شناسه یا سورس Hub دور نزنید؛ عملیات جای‌گذاری در هاب را ببینید.

کدهای Portal و Release Set#

کد	HTTP	معنی	تکرار همان‌طور	اقدام بعدی
ALAMR_PLATFORM_RELEASE_UNAVAILABLE	503	Release Set ترفیع‌یافتهٔ معتبر طرح‌واره وجود ندارد؛ فرمان‌های عمومی غیرفعال‌اند	بله، پس از ترفیع	منتظر Release Set ترفیع‌یافته بمانید؛ هرگز نسخه یا dist-tag حدسی جایگزین نکنید
ALAMR_RELEASE_VERIFICATION_UNAVAILABLE	503	Release Set تأییدشدهٔ کاتالوگ در مسیر راستی‌آزمایی در دسترس نیست	بله، پس از راستی‌آزمایی	منتظر تکمیل راستی‌آزمایی نسخه بمانید

شواهد برای ارجاع#

ارائه دهید:

• زمان UTC و مبدأ Registry؛
• فرمان دقیق و نسخهٔ CLI؛
• کد فرایند و نتیجهٔ JSON پاک‌سازی‌شده؛
• شناسهٔ درخواست و کد خطای پایدار Registry؛
• شناسه‌های مرتبط Project، Environment، Plugin، release/revision، submission، deployment و artifact؛
• چکیده‌های مانیفست و بسته یا مقادیر integrity؛
• وضعیت فعلی از alamr status --json؛
• حداقل بازتولید و اینکه خطا محلی است، مرورگری، مربوط به Registry یا مختص مولفهٔ بک‌اند.

هرگز توکن bearer، کد احراز، PKCE verifier، cookie، کلید خصوصی، راز توکن پروژه یا پیکربندی محرمانهٔ استقرار ارائه ندهید.

برای اصطلاحات واژه‌نامهٔ محصول و امنیت را ببینید. برای شواهد بازبینی بازبینی انسانی و برای روند بازیابی هر وضعیت بازیابی و بازگردانی را بخوانید.