Repository navigation
Waymark 0.2.0 is the cross-item write consent release. Updating your work items
is a statement about your own items; reaching into someone else's now needs
both consent and ownership.
Added
--cascadeonarchive,link add,link remove, andcreate, and the
same optional boolean on the MCP tools that map to them. It is the consent a
command gives for writing a second work item, and it authorizes only the
caller's own items.- Two error codes for a cross-item write:
OWNED_BY_OTHER(the other item
belongs to someone else, so re-running cannot help) and
CASCADE_CONSENT_REQUIRED(registered for callers that can supply consent;
no current command raises it). ONE_SIDED_SOFT_LINK:doctorandshowreport a soft link that one side
records and the other does not, naming the side that is missing it.CLOSED_PARENT: an active item whose direct parent is closed is labelled in
listandready, and reported as an informational finding bydoctor.
Nothing is written and no readiness changes.- Archive results list the documents it left untouched and who still references
the archived item, so retiring one item no longer hides who was affected. createandlink addresults report the documents they left untouched,
with each partner's owner and whether it is the operator's.
Changed
- Archive no longer rewrites another owner's document. It strips inbound
references only from documents the operator owns, and leaves the rest in place
with adoctorfinding for its owner to resolve.HAS_ACTIVE_CHILDRENstill
refuses an item with live children. link addwithout--cascadeno longer writes the other item. It records the
link on the caller's item and reports the partner as one-sided; re-running
from the other side completes the pair.link removewithout--cascaderemoves the link from the caller's item
only. Removing a link is a statement about one's own item; adding one is a
claim about both.create --linkwithout--cascadeno longer rewrites the referenced item.- Ownership for cross-item writes resolves the operator the same way everything
else does:.waymark/user.toml, then Gituser.name. A project with no
operator refuses a cross-item write rather than silently skipping it.
Breaking
- A command that rewrites a second document without
--cascadenow leaves that
document alone; a caller relying on the old two-sided write must pass the flag
and own the other item.
Install
Prebuilt archives are attached below for Linux, macOS (Apple silicon and
Intel), and Windows. Verify each archive against its .sha256 sidecar before
running it: the macOS and Windows binaries are unsigned.
With a Rust toolchain, the same binaries also install from crates.io:
cargo install waymark-cli # the `waymark` binary
cargo install waymark-mcp # the MCP serverThe CLI crate is waymark-cli, not waymark: waymark on crates.io is an
unrelated crate.
Full Changelog: v0.1.4...v0.2.0