kuri-memory-guard/messages.py

119 lines
5.9 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

"""Message templates for kuri-memory-guard — soft/hard block guidance."""
# ── Action-specific intro prefixes ─────────────────────────────────────
# Prepended to non-length soft messages to differentiate add vs replace.
_MSG_ADD_INTRO = "〔add〕"
_MSG_REPLACE_INTRO = "〔replace〕"
# ── Shared soft block template ────────────────────────────────────────
# Used by all non-length soft guards (work_verb, user_quote, cron_session, meta).
_MSG_SOFT_TEMPLATE = """\
〔SOFT BLOCK:需要重新判斷,不是最終拒絕〕
命中 guard:{guard_name}
觸發片段:「{matched_text}」
不得只因收到本訊息就停止。現在必須採取以下其中一項:
A. 內容仍含 transcript、事故敘事、短期狀態、測試內容或低密度背景:
改寫後立即再次呼叫 memory。
B. 內容已經是單一、穩定、高密度、未來可直接使用的規則或偏好:
在允許的 retry 時間內,原封不動重送完全相同的 operation;系統將放行一次。
C. 確認內容沒有 future reader,確實不值得保存:
放棄寫入,但必須在當前回覆明確說明原因;不得默默停止。
{guard_specific_note}"""
# ── Guard-specific notes ───────────────────────────────────────────────
_MSG_USER_QUOTE_NOTE = (
"此 guard 擋「主人說/主人回/主人要求」這類轉述開頭。"
"改寫重點:留下事實與規則,把「主人」拿掉——"
"「主人要求以 Codex 審查時 scope 嚴格限制」改成"
"「以 Codex 審查指定 skill 時,scope 嚴格限制在該 skill 及其 references」。"
"變成自己對自己說的規則,不是轉述主人的話。"
"改寫後重送;只有改寫會破壞語意的精確規則才原樣重送(B)。"
)
_MSG_WORK_VERB_NOTE = (
"此 guard 用來防止當前進度、已完成工作、PR/issue 與下一步被寫入。"
"若內容是在描述通用條件或長期操作原則,選擇 B。"
)
_MSG_CRON_SESSION_NOTE = (
"此 guard 用來防止 cron 執行結果、平行 session 紀錄、trigger 與 coverage 殘留。"
"只有長期固定的操作規則可以選擇 B。"
)
_MSG_META_NOTE = (
"此 guard 用來防止 cleanup 反省、版本快照及可從 canonical source 重取的內容沉澱。"
"若內容本身是未來要遵守的規則,而不是來源內容的複製,選擇 B。"
)
# ── Length guard messages ──────────────────────────────────────────────
# S1 — refine threshold (80 chars)
_MSG_LENGTH_S1 = """\
〔SOFT LENGTH:80 字精煉檢查〕
本條共 {n} 字。不得直接放棄。
模型自行擬定:刪除對話背景、原因、事故經過、道歉與推論,只留下未來可直接使用的一條規則,然後再次呼叫 memory。
主人提供或逐字核准,且壓縮會改變語意:原封不動重送一次。
若沒有 future reader,明確說明後放棄;不得默默停止。"""
# S2 — split threshold (120 chars)
_MSG_LENGTH_S2 = """\
〔SOFT LENGTH:120 字拆分檢查〕
本條共 {n} 字。判斷是否包含兩個以上可獨立檢索、修改或使用的規則。
是:拆成多筆後再次呼叫。
否:若已是不可拆的單一規則,原樣重送一次。
不得只因本訊息停止寫入。"""
# S3 — document/narrative threshold (150 chars)
_MSG_LENGTH_S3 = """\
〔SOFT LENGTH:150 字文件/敘事檢查〕
本條共 {n} 字,高度疑似 SOP、事故報告、對話摘要或多條規則。
抽出一條短規則、拆成多筆,或改放 skill/docs。
只有確定是單一且無法安全縮短的精確規則,才原樣重送一次。"""
# ── Hard ceiling message ───────────────────────────────────────────────
_MSG_HARD_CEILING = """\
〔HARD BLOCK:180 字絕對上限〕
本條共 {n} 字。原樣重送不會放行。
拆成多條短記憶、只抽取核心規則,或改放 skill/docs。
若是對話摘要、事故經過或工作紀錄,放棄寫入。"""
# ── Date hard block ────────────────────────────────────────────────────
_MSG_DATE_HARD = """\
〔HARD BLOCK:日期或疑似日期〕
觸發片段:「{matched}」
日期與相對時間不得寫入長期記憶,原樣重送不會放行。
如果這其實是比例、全天候或其他非日期表示,請改成不含日期形狀的等價寫法後重新送出,例如 16:9、全年全天候。"""
# ── Placeholder hard block ─────────────────────────────────────────────
_MSG_PLACEHOLDER = """\
〔HARD BLOCK:暫存/測試內容〕
觸發片段:「{matched}」
TODO、placeholder、temp、probe、WIP、session note、proc session ID、commit SHA——
這些都是短期記號,不是長期記憶,沒有 future reader。
請移除這類內容後再試。
{list_warning}"""
_MSG_LIST_WARNING = (
"如果你是在用 add 測試或嘗試列出現有記憶:停止此操作。\n"
"memory tool 不支援 list;add 不會回傳既有條目。\n"
"非沙箱 agent 應直接讀取 memories/MEMORY 與 USER.md;沙箱 agent 無法取得完整清單。"
)
# ── Batch block message parts ──────────────────────────────────────────
_MSG_BATCH_HEADER = "批次記憶操作中有多筆內容命中防護:"
_MSG_BATCH_FOOTER = (
"\n\n批次操作無法透過原樣重送繞過。請拆成單筆操作重新處理;每筆可以各自使用 soft retry 協議。"
)