// tier: vasic-util-secondary · order 27

Herald activelicense: UNVERIFIED

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

Source

• vasic-digital/Herald

// architecture

Кожнае апавяшчэнне даходзіць да правільнага месца — без неабходнасці ўводзіць камандны сінтаксіс.

Herald прымае сістэмныя падзеі і надзейна распаўсюджвае іх па некалькіх каналах апавяшчэнняў, каб кожнае апавяшчэнне дасягала свайго месца. Абаненты ўзаемадзейнічаюць на простай натуральнай мове; Herald вызначае намеры праз трохузроўневую дысцыпліну (хуткі шлях каманд → вызначэнне намеры праз LLM → рэжым удакладнення).

Сістэма прыёму падзей і распаўсюджвання апавяшчэнняў па некалькіх каналах. Herald надзейна накіроўвае сістэмныя падзеі па правільных адрасах праз каналы абмену паведамленнямі і дазваляе абанентам карыстацца простай натуральнай мовай, вызначаючы намеры праз хуткі шлях каманд, вывад намеры праз LLM і рэжым удакладняльных пытанняў.

Herald — гэта апорная сістэма апавяшчэнняў, якая гарантуе, што сістэмная падзея дасягне месца, дзе чалавек зможа на яе адрэагаваць. Гэта несамавітая, але крытычна важная ланка, дзе большасць самаробных сістэм апавяшчэнняў няўмольна правальваюцца. Яна прымае падзеі і надзейна распаўсюджвае іх па некалькіх каналах апавяшчэнняў, выключаючы тыповыя праблемы: страту апавяшчэння, няправільнае накіраванне ў мёртвы канал ці затапленне шумам, пакуль яно не перастане мець значэнне. Але надзейная дастаўка — гэта толькі палова справы; другая палова — тое, што адбываецца, калі чалавек хоча адрэагаваць. Тут Herald адмаўляецца ад звыклага падыходу, калі карыстальнікі павінны запамінаць жорсткі сінтаксіс каманд для ўзаемадзеяння з ботам-апавяшчальнікам. Абаненты проста пішуць на звычайнай натуральнай мове, а Herald вызначае, што яны мелі на ўвазе, праз наўмысную трохузроўневую дысцыпліну: хуткі шлях, які імгненна распазнае відавочныя каманды, затым вывад намеры на аснове LLM (праз Claude Code) для свабодных паведамленняў і, нарэшце, рэжым удакладнення, які адказвае, пазначае і задае пытанне, калі намер сапраўды нявызначаны. Гэтая лесвіца «распазнаць → вывесці → удакладніць» — гэта ўвесь дызайн філасофіі ў мініяцюры: звычайны выпадак застаецца імгненным і дэтэрмініраваным, гнуткі выпадак апрацоўваецца мадэллю, а нявызначаны выпадак ніколі не вырашаецца сляпым здагадваннем, якое можа выклікаць няправільнае дзеянне. Herald таксама мадэлюе ўдзел і прыналежнасць: зменная асяроддзя з імем аператара (HERALD_<CHANNEL>_OPERATOR_USERNAME) і кантракт удзельніка/прыналежнасці кіруюць палямі created_by/assigned_to і пазначэннем апавяшчэнняў праз @, каб было зразумела, хто што зрабіў і каго апавяшчаюць. З пункту гледжання кіравання Herald успадкоўвае Helix Constitution як сумешчаны падмадуль і падпарадкоўваецца яго правілам, а таксама з’яўляецца адным з першых вытворчых спажыўцоў Docs Chain — увесь яго 66-дакументны корпус Markdown→HTML/PDF/DOCX праходзіць праз exec:-трансфармацыі Docs Chain і правяраецца на чысціню. Herald у асноўным з’яўляецца інструментам Shell/Go з шматслойнымі спецыфікацыямі (V1→V2→V3→V4 замяшчэнне) і кіраўніцтвамі па наладцы аператараў для кожнага канала ў месэнджарах і дыспетчарах LLM/агентаў.

Апавяшчэнні няўмольна правальваюцца — адпраўляюцца ў няправільны канал, губляюцца ці патрабуюць жорсткага сінтаксісу каманд, які карыстальнікі не запомняць. Herald створаны, каб гарантаваць надзейнае распаўсюджванне і дазволіць людзям адказваць на натуральнай мове, каб апавяшчэнні былі як надзейнымі, так і лёгкімі для рэагавання.

Змест

Гэтае рашэнне аб’ядноўвае дзве рэчы, якія звычайна купляюць паасобку — надзейную маршрутызацыю падзей па некалькіх каналах і інтэрфейс на натуральнай мове — у адну сістэму, дзе аператары проста гавораць, а праграма разумее, што яны маюць на ўвазе. Ключавым элементам, які робіць яе надзейнай у працы, з’яўляецца механізм удакладнення: сістэма апавяшчэнняў, якая лепш перапытае, чым памыліцца, — гэта сістэма, якой можна даверыць кіраванне рэальнымі працэсамі.

• Трохузроўневая дысцыпліна інтэнту: хуткі шлях каманды → вывад LLM → удакладненне і пытанне.
• Узаемадзеянне з падпісчыкамі на натуральнай мове (няма патрэбы вывучаць сінтаксіс каманд).
• Кантракт прывязкі ўдзельнікаў, які кіруе палямі created_by/assigned_to і @-тэгіраваннем.
• Рэальны спажывец Docs Chain (карпус з 66 дакументаў, некалькі фарматаў, правераны).

• Неадназначны інтэнт на натуральнай мове: вырашана з дапамогай трохузроўневай лесвіцы распазнавання/вываду/удакладнення замест сляпога здагадвання.
• Надзейнае распаўсюджванне: вырашана праз дызайн прыёму→маршрутызацыі па некалькіх каналах, каб апавяшчэнні даходзілі да правільнага месца прызначэння.
• Карэктная прывязка аўтарства паміж каналамі: вырашана праз зменную асяроддзя з імем аператара і кантракт прывязкі ўдзельнікаў.
• Адхіленне дакументацыі: вырашана шляхам інтэграцыі карпуса дакументаў праз Docs Chain з праверанымі трансфармацыямі.

• Go — асноўная логіка падзей і маршрутызацыі (пад мовы арганізацыі).
• Shell — інструменты для аператараў і скрыпты наладкі.
• Код Claude (LLM) — узровень вываду інтэнту для свабодных паведамленняў.
• Адаптары каналаў Messenger — распаўсюджванне апавяшчэнняў па некалькіх каналах.
• Docs Chain — канвеер зборкі і праверкі дакументацыі (Markdown→HTML/PDF/DOCX).
• Падмадуль Helix Constitution — атрыманыя правілы кіравання.