For AI agents: the complete documentation index is available at https://docs.flezise.com/llms.txt, the full documentation bundle is available at https://docs.flezise.com/llms-full.txt, and this page is available as Markdown at https://docs.flezise.com/artifacts/status-lifecycle.md.
Docs

Status lifecycle

An artifact's status controls what actions are available on it and whether downstream artifacts can generate. The lifecycle runs from Draft through approval to either Approved or Superseded.

Statuses

On screenAPI valueWhat it means
DraftdraftGenerated, uploaded, after Reject, or after New Version. Editable.
In Reviewin_reviewSubmitted for approval. Approvers at the current level have a pending action. Not editable.
Revisechanges_requestedSent back for targeted fixes. The author edits in place and resubmits.
ApprovedapprovedAll approval levels signed off. Downstream generation dispatches.
SupersededsupersededReplaced by a later version. Terminal.

The status filter also shows Locked (locked). Locked artifacts behave as Approved for every dependency check and knowledge-base lookup. The code treats approved and locked as one group for all retrieval and dependency logic; the filter shows them separately for visibility.

archived exists in code as a terminal status but no UI action archives an artifact. Do not confuse it with Superseded.

Transitions

The valid transitions are:

FromToTriggered by
DraftIn ReviewSubmit for Review
In ReviewDraftReject
In ReviewReviseRequest Changes
In ReviewApprovedApprove (all levels pass)
ReviseIn ReviewResubmit for Review
ApprovedLockedinternal
ApprovedSupersededMark Obsolete
LockedSupersededMark Obsolete
generated / uploadedSubmit for ReviewRejectRequest ChangesApprove (all levels)Resubmit for ReviewMark ObsoleteMark Obsolete

draft

in_review

changes_requested

approved

locked

superseded

Node labels are the API values; the on-screen labels are in the table above.

Dependency gate

An artifact in Draft cannot be submitted for review if any artifact it lists as a dependency (depends_on) is not yet in approved or locked status. Attempting to submit names the blocking dependency in the error.

This gate keeps each document in the pipeline building on approved foundations before it enters review.

Next steps