// سطح: vasic-util-secondary · سفارش 27

Herald activeاجازه‌نامه: UNVERIFIED

GoShellClaude Code (LLM intent inference)Messenger channel adaptersDocs ChainHelix Constitution submodule

منبع

• vasic-digital/Herald

// معماری

محتوا هر هشدار به مقصد درست می‌رسد — بدون نیاز به دستور زبان دستوری.

Herald رویدادهای سیستمی را دریافت و به‌طور قابل اعتماد به چندین کانال اعلان توزیع می‌کند تا هر هشدار به جای درست برسد. مشترکین با زبان طبیعی ساده تعامل می‌کنند؛ Herald قصد آن‌ها را از طریق یک سازوکار سه‌لایه تشخیص می‌دهد (مسیر سریع دستور → استنتاج قصد LLM → بازگشت به شفاف‌سازی).

سیستمی برای دریافت رویداد و توزیع اعلان به چندین کانال. Herald رویدادهای سیستمی را به‌طور قابل اعتماد به مقصدهای درست در کانال‌های پیام‌رسان هدایت می‌کند و به مشترکین اجازه می‌دهد با زبان طبیعی ساده صحبت کنند — قصد آن‌ها از طریق مسیر سریع دستور، استنتاج LLM و بازگشت به پرسش برای شفاف‌سازی تشخیص داده می‌شود.

Herald ستون فقرات اعلان‌ها است که تضمین می‌کند یک رویداد سیستمی واقعاً به جایی برسد که یک انسان بتواند بر اساس آن اقدام کند — لایه‌ای نه چندان جذاب اما حیاتی که بیشتر سیستم‌های هشدار خانگی در آن بی‌صدا شکست می‌خورند. این سیستم رویدادها را دریافت و به‌طور قابل اعتماد به چندین کانال اعلان توزیع می‌کند و از حالت‌های شکست آشنا جلوگیری می‌کند: جایی که یک هشدار گم می‌شود، به کانال مرده هدایت می‌شود یا در میان نویز دفن می‌شود تا زمانی که دیگر دیر شده باشد. اما تحویل قابل اعتماد تنها نیمی از ماجرا است؛ نیمه دیگر به اتفاقی مربوط می‌شود که وقتی یک انسان می‌خواهد پاسخ دهد رخ می‌دهد. در اینجا Herald از معامله معمولی که کاربران باید دستور زبان دستوری سخت را برای تعامل با ربات هشدار به خاطر بسپارند سر باز می‌زند. مشترکین به‌سادگی با زبان طبیعی ساده می‌نویسند و Herald از طریق یک سازوکار سه‌لایه حساب‌شده منظور آن‌ها را تشخیص می‌دهد: مسیری سریع که دستورات صریح را فوراً شناسایی می‌کند، سپس استنتاج قصد مبتنی بر LLM (از طریق کد Claude) برای پیام‌های آزاد، و در نهایت بازگشت به شفاف‌سازی که وقتی قصد واقعاً مبهم است، پاسخ می‌دهد، برچسب می‌زند و سؤال می‌پرسد. این نردبان «شناسایی → استنتاج → شفاف‌سازی» کل فلسفه طراحی را در یک نگاه نشان می‌دهد — حالت رایج فوراً و قطعی باقی می‌ماند، حالت انعطاف‌پذیر توسط یک مدل مدیریت می‌شود و حالت نامطمئن هرگز با حدس کورکورانه‌ای که منجر به اقدام اشتباه شود حل نمی‌شود.

Herald همچنین مشارکت و انتساب را مدل‌سازی می‌کند: یک متغیر محیطی نام کاربری اپراتور (HERALD_<CHANNEL>_OPERATOR_USERNAME) و یک قرارداد مشارکت/انتساب، فیلدهای created_by/assigned_to و برچسب‌گذاری اعلان با @ را هدایت می‌کند تا مشخص باشد چه کسی چه کاری انجام داده و به چه کسی اطلاع‌رسانی می‌شود. از نظر حاکمیت، Herald ماژول Helix Constitution را به‌عنوان زیرماژول هم‌مکان به ارث می‌برد و قوانین آن را دنبال می‌کند و یکی از مصرف‌کنندگان اولیه تولید Docs Chain است — کل پیکره ۶۶ سندیش از مارک‌داون به HTML/PDF/DOCX از طریق تبدیل‌های exec: سیستم Docs Chain متصل شده و به‌طور تمیز تأیید می‌شود. Herald عمدتاً ابزاری از نوع Shell/Go با مشخصات لایه‌ای (جایگزینی V1→V2→V3→V4) و راهنماهای راه‌اندازی اپراتور برای هر کانال در پیام‌رسان‌ها و ارسال‌کننده‌های LLM/agent است.

هشدارها بی‌صدا شکست می‌خورند — به کانال اشتباه ارسال می‌شوند، گم می‌شوند یا به دستور زبان دستوری سختی نیاز دارند که کاربران آن را به خاطر نمی‌سپارند. Herald برای تضمین توزیع قابل اعتماد و امکان پاسخگویی با زبان طبیعی ساخته شد تا اعلان‌ها هم قابل اعتماد باشند و هم اقدام بر اساس آن‌ها آسان.

محتوا

این سیستم دو چیزی را که معمولاً به‌عنوان محصولات جداگانه خریداری می‌شوند — مسیریابی چندکاناله و قابل‌اعتماد رویدادها و یک رابط زبان طبیعی — در یک سامانه ادغام می‌کند که در آن اپراتورها صرفاً صحبت می‌کنند و نرم‌افزار منظورشان را درک می‌کند. جزئیاتی که آن را در محیط عملیاتی قابل‌اعتماد می‌سازد، سازوکار هشداردهی است: سیستمی که ترجیح می‌دهد بپرسد تا اینکه به‌اشتباه فعال شود، سیستمی است که واقعاً می‌توان به آن اجازه داد با داده‌های واقعی کار کند.

• نظم سه‌لایه‌ای قصد: مسیر سریع فرمان → استنتاج LLM → شفاف‌سازی و پرسش.
• تعامل مشترکین با زبان طبیعی (بدون نیاز به یادگیری نحو فرمان‌ها).
• قرارداد انتساب مشارکت‌کننده که created_by/assigned_to و تگ‌گذاری با @ را هدایت می‌کند.
• مصرف‌کننده واقعی Docs Chain (مجموعه‌ای از ۶۶ سند، چندفرمت، تأییدشده).

• ابهام در قصد زبان طبیعی: با نردبان سه‌مرحله‌ای شناسایی/استنتاج/شفاف‌سازی حل شده است، نه با حدس کورکورانه.
• توزیع مطمئن: با طراحی دریافت→توزیع چندکاناله حل شده تا هشدارها به مقصد صحیح برسند.
• انتساب صحیح در کانال‌های مختلف: با متغیر محیطی نام کاربری اپراتور و قرارداد انتساب مشارکت‌کننده حل شده است.
• انحراف مستندات: با اتصال مستندات از طریق Docs Chain با تبدیل‌های تأییدشده حل شده است.

• Go — منطق اصلی رویداد/توزیع (بر اساس الگوهای زبانی هر سازمان).
• Shell — ابزارها و اسکریپت‌های راه‌اندازی اپراتورها.
• کد Claude (LLM) — لایهٔ استنتاج قصد برای پیام‌های آزاد.
• آداپتورهای کانال پیام‌رسان — توزیع چندکاناله اعلان‌ها.
• Docs Chain — خط لولهٔ ساخت/تأیید مستندات (Markdown→HTML/PDF/DOCX).
• زیرماژول Helix Constitution — حاکمیت/قوانین به ارث رسیده.