# Drafts, publications, and Live

Source: https://openflow.run/en/docs/concepts/versions/
Language: en
Product version: 0.1.0-beta.77

Know which definition you are editing, testing, and running in production.

A Flow has one mutable **Draft head**, pointing to an immutable **Revision**. A successful **Publication** fixes a Revision for production use. **Live** points to the current production publication.

## Draft and Revision

A semantic edit creates a new Revision and advances the Draft head. The edit uses an expected Revision and a stable request identity, preventing silent overwrites and duplicate commits when a response is uncertain.

Saved Drafts can be incomplete. Saving a node is separate from proving that the whole workflow is valid or ready to execute.

## Publication

Publication validates the full graph and prepares required external resources. It becomes a Publication only after every preparation step succeeds. While preparation is pending or failed, the previous Live remains active.

Draft edits made during or after publication do not mutate the published Revision.

## Live execution

Automatic Triggers use the current Live definition and its matching runtime bindings. Explicit Live Run calls select Start. A Run fixes its version, inputs, authorization snapshot, and execution scope at admission.

Disabling the Flow prevents new production admission without canceling accepted Runs. To stop work already accepted, use the Run’s cancellation interface.

## History and rollback

Historical publications and Runs retain their fixed definitions. Rollback creates a new publication rather than editing history. It does not undo external effects or reset separately stored Flow State.

Presentation is versioned separately from execution content and fixed with a publication for viewing. See [Flows and presentation](https://openflow.run/en/docs/concepts/flows-and-nodes/index.md).

## Sources

*   [docs/architecture.md](https://github.com/oomol-lab/open-flow/blob/e25a738d170322734572a0b8a1323cb00b9d355a/docs/architecture.md#flow-revision-and-presentation)
*   [docs/architecture.md](https://github.com/oomol-lab/open-flow/blob/e25a738d170322734572a0b8a1323cb00b9d355a/docs/architecture.md#publication-and-trigger)
*   [docs/control/contracts/control-api.md](https://github.com/oomol-lab/open-flow/blob/e25a738d170322734572a0b8a1323cb00b9d355a/docs/control/contracts/control-api.md#4-validation-publication-and-live)
