Lifecycle Transition
lifecycle_transitionTransitions an item through guarded lifecycle states—in_work, in_review, released, obsolete—rejects illegal state changes, and stamps/freezes the first revision on release.
Instructions
Move an item through the lifecycle state machine in_work -> in_review -> released -> obsolete, guarded by a transition table (#141 C2). An illegal edge (e.g. skipping review, or re-opening a released item in place) is rejected loudly; releasing stamps the item's first revision and freezes it.
registry: path to the items.json sidecar (written back on success). item: the item id to transition. to: the target lifecycle state. actor / note: optional provenance recorded in the item's transition log.
Returns {ok, state, rev}, or {ok:false, problems} on an illegal transition.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"registry": "<registry>",
"item": "<item>",
"to": "<to>"
},
"name": "lifecycle_transition"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | ||
| item | Yes | ||
| note | No | ||
| actor | No | ||
| registry | Yes | ||
| workspace | No | Run this call in this named workspace |