Files
marqdo/lib/writeback.mq.md
T
cflmyandCursor 1f23e2ed93 Add module namespaces and harden L1/agent after the import redesign.
Bind imports to library names with bare path calls (and use), forward optional host args through mq wrappers, stabilize writeback replacement newlines, and document the M1/M2 decisions.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-07 13:28:32 +08:00

1.4 KiB

title, description
title description
lib/writeback Persist run output in .mq.md (Jupyter-style writeback)

record

+ `value`
+ `at_end`=False
+ `key`=None
+ `line`=None

Write value to <!-- marqdo-out … --> in the entry file. Default: insert or replace the block immediately below the call; at_end=true replaces the unkeyed EOF block. With key= (e.g. ok / error), replace or create that named slot only — slots do not overwrite each other. Optional line= anchors the block under that source line (needed when writing from a subtask).

> host_writeback_record value=value at_end=at_end key=key line=line

get

+ `at_end`=False
+ `key`=None
+ `line`=None

Read persisted output for the current call site (adjacent unkeyed block), the unkeyed EOF block when at_end=true, or a named slot when key= is set.

> host_writeback_get at_end=at_end key=key line=line

clear

+ `at_end`=False
+ `key`=None
+ `line`=None

Remove the adjacent, EOF, or named output block.

> host_writeback_clear at_end=at_end key=key line=line

ensure

+ `key`
+ `placeholder`=pending
+ `line`=None

Create a named slot with placeholder if missing. Never overwrites an existing slot body.

> host_writeback_ensure key=key placeholder=placeholder line=line

list

List all output blocks in the entry file (includes key when named).

> host_writeback_list