Cron ထည့်သွင်းမှုကို ခိုင်မာစေခြင်း နှင့် Schema ကိုက်ညီစေခြင်း¶

အကြောင်းအရာ (Context)¶

ဤအချက်က client တစ်ခု (အများအားဖြင့် agent tool call path) သည် wrapped သို့မဟုတ် အပြည့်အစုံ မသတ်မှတ်ထားသော job payloads များကို ပို့နေကြောင်း ပြသပါသည်။ ထို့အပြင် TypeScript ထဲရှိ cron provider enums, gateway schema, CLI flags, UI form types တို့အကြား မကိုက်ညီမှုများရှိပြီး cron.status အတွက် UI မကိုက်ညီမှုလည်း ရှိပါသည် (jobCount ကို မျှော်လင့်ထားသော်လည်း gateway က jobs ကို ပြန်ပေးနေသည်)။ Telegram allowlists များသည် ယခုအခါ telegram: နှင့် tg: prefixes များကို case-insensitive အနေဖြင့် လက်ခံပြီး မတော်တဆ ပါဝင်လာသော whitespace များကိုလည်း ခံနိုင်ရည်ရှိပါသည်။

ရည်မှန်းချက်များ (Goals)¶

• ပုံမှန် wrapper payload များကို normalization လုပ်ခြင်းနှင့် မရှိသော kind အကွက်များကို ခန့်မှန်းဖြည့်သွင်းခြင်းအားဖြင့် cron.add INVALID_REQUEST spam ကို ရပ်တန့်စေရန်။
• Gateway schema၊ cron types၊ CLI စာတမ်းများ၊ နှင့် UI forms တို့အကြား cron provider စာရင်းများကို ကိုက်ညီအောင် ချိန်ညှိရန်။
• Agent cron tool schema ကို ထင်ရှားစွာ သတ်မှတ်၍ LLM မှ မှန်ကန်သော job payload များကို ထုတ်လုပ်စေရန်။
• Control UI တွင် cron status job count ပြသမှုကို ပြုပြင်ရန်။
• Normalization နှင့် tool အပြုအမူကို ဖုံးလွှမ်းစေမည့် စမ်းသပ်မှုများကို ထည့်သွင်းရန်။

မပါဝင်သည့်အချက်များ (Non-goals)¶

• Cron scheduling semantics သို့မဟုတ် job အကောင်အထည်ဖော်မှု အပြုအမူကို ပြောင်းလဲခြင်း။
• Schedule အမျိုးအစားအသစ်များ ထည့်သွင်းခြင်း သို့မဟုတ် cron expression parsing ကို ထည့်သွင်းခြင်း။
• လိုအပ်သော field ပြင်ဆင်မှုများအပြင် cron အတွက် UI/UX ကို အကြီးအကျယ် ပြန်လည်ပြင်ဆင်ခြင်း။

တွေ့ရှိချက်များ (လက်ရှိအခွာအဟာ)¶

• Gateway အတွင်းရှိ CronPayloadSchema သည် signal + imessage ကို မပါဝင်စေသော်လည်း TS types တွင် ပါဝင်နေပါသည်။
• Control UI CronStatus သည် jobCount ကို မျှော်မှန်းထားသော်လည်း gateway က jobs ကို ပြန်ပို့ပါသည်။
• Agent cron tool schema သည် မည်သည့် job object မဆို ခွင့်ပြုထားသောကြောင့် မမှန်ကန်သော input များကို ဖြစ်စေပါသည်။
• Gateway သည် cron.add ကို normalization မရှိဘဲ တင်းကျပ်စွာ စစ်ဆေးသဖြင့် wrapper payload များ မအောင်မြင်ပါသည်။

ပြောင်းလဲထားသည့်အချက်များ (What changed)¶

• cron.add နှင့် cron.update သည် ယခုအခါ ပုံမှန် wrapper ပုံစံများကို normalization လုပ်ပြီး မရှိသော kind အကွက်များကို ခန့်မှန်းဖြည့်သွင်းပါသည်။
• Agent cron tool schema သည် gateway schema နှင့် ကိုက်ညီလာသောကြောင့် မမှန်ကန်သော payload များ လျော့နည်းလာပါသည်။
• Provider enums များကို gateway၊ CLI၊ UI နှင့် macOS picker တို့အကြား ကိုက်ညီအောင် ချိန်ညှိပြီးဖြစ်ပါသည်။
• Control UI သည် status အတွက် gateway ၏ jobs count field ကို အသုံးပြုပါသည်။

လက်ရှိအပြုအမူ (Current behavior)¶

• Normalization: wrapper ပါသော data/job payload များကို ဖယ်ရှားထုတ်ယူပြီး၊ လုံခြုံမှုရှိသောအခါ schedule.kind နှင့် payload.kind ကို ခန့်မှန်းဖြည့်သွင်းပါသည်။
• Defaults: မရှိသောအခါ wakeMode နှင့် sessionTarget အတွက် လုံခြုံသော default များကို အသုံးပြုပါသည်။
• Providers: Discord/Slack/Signal/iMessage ကို ယခုအခါ CLI/UI တို့အကြား တူညီစွာ ပြသထားပါသည်။

Normalization လုပ်ထားသော ပုံစံနှင့် ဥပမာများအတွက် Cron jobs ကို ကြည့်ပါ။

စစ်ဆေးအတည်ပြုခြင်း (Verification)¶

• Gateway လော့ဂ်များတွင် cron.add INVALID_REQUEST အမှားများ လျော့နည်းလာသည်ကို စောင့်ကြည့်ပါ။
• Refresh ပြုလုပ်ပြီးနောက် Control UI cron status တွင် job count ပြသထားသည်ကို အတည်ပြုပါ။

ရွေးချယ်နိုင်သော နောက်ဆက်တွဲများ (Optional Follow-ups)¶

• Control UI ကို လက်ဖြင့် စမ်းသပ်ခြင်း: provider တစ်ခုစီအတွက် cron job တစ်ခု ထည့်သွင်းပြီး status job count ကို အတည်ပြုပါ။

မဖြေရှင်းရသေးသော မေးခွန်းများ (Open Questions)¶

• cron.add သည် client များမှ explicit state ကို လက်ခံသင့်ပါသလား (လက်ရှိတွင် schema အရ ခွင့်မပြုထားပါ)?
• webchat ကို explicit delivery provider အဖြစ် ခွင့်ပြုသင့်ပါသလား (လက်ရှိတွင် delivery resolution အတွင်း စစ်ထုတ်ထားပါသည်)?