From a0c779e022e42b862b3da566692786285a04c45b Mon Sep 17 00:00:00 2001 From: cflmy Date: Wed, 18 Nov 2026 09:36:31 +0800 Subject: [PATCH] fix(ai): declare function parameters in Marqdo prose syntax --- ext/ai/recovery.mq.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/ext/ai/recovery.mq.md b/ext/ai/recovery.mq.md index c38867e..afe2e47 100644 --- a/ext/ai/recovery.mq.md +++ b/ext/ai/recovery.mq.md @@ -24,6 +24,8 @@ current permission and source revision; a saved checkpoint is not authorization. |---|---|---| | result | map | Safe recovery action with budget | +Use `error`, `attempts`=0, `effect_class`="read", `cancelled`=False, `fingerprint_repeats`=0 as the inputs for this operation. + This returns an action, not an automatic retry or permission to execute. For write or unknown effect, consult the effect ledger before taking another step. @@ -42,6 +44,8 @@ Return *[Select a bounded recovery action](agent.error_decide_retry(error=`error |---|---|---| | result | map | CheckpointV2 write result | +Use `id`, `task`=None, `status`="waiting_input", `effect_ledger_watermark`=None as the inputs for this operation. + Use the existing atomic checkpoint writer. When ledger evidence is absent, a resumed writer requires manual review rather than automatic repetition. This function saves metadata; it does not suspend a Rust execution frame. @@ -58,6 +62,8 @@ Return *[Save a versioned checkpoint](agent.resume_save(id=`id`, task=`task`, st |---|---|---| | result | map | Checkpoint or missing/unsafe recovery status | +Use `id` as the inputs for this operation. + Loading a checkpoint does not execute any saved step. The caller must inspect recovery_mode and write_auto_resume before dispatching any effectful operation.