TVO-FLOW-003: Forward-only promotion: the source has not passed the required stage

If this error reveals a permission or cryptography flaw, do not post it — follow coordinated disclosure. Do not report security vulnerabilities here. This board is public and operated by a third-party vendor. Read https://tovio.dev/security and use the private channel it names. Never paste repository contents, file paths, diffs, tokens, keys, or other people's data — describe the behaviour instead.

What TOVIO prints

The catalog's example of what TOVIO prints for this code in a terminal. Names, paths and counts in it are illustrative.

✗ Cannot land: `env/prod` may only receive content that already landed on a `staging` lane

  Workflow `com.tovio.gitlab-flow-env@1` requires transitions into `env/prod` to
  descend from role `staging`.

  Source lane:        release/2.4
  Staging lane(s):    env/staging
  The source tip is not a descendant of any of them.

  Land onto the staging lane first, then promote forward:
    tovio land --into env/staging
  See where the lanes stand:
    tovio health

  [TVO-FLOW-003]

What to read

• Error reference — the three-part message standard (what happened, why, what to do next), the exit-code classes, the --json shape, and the everyday codes. It is a curated subset, so it may not name this one: TVO-FLOW-003 is in the FLOW area and carries the same three-part message either way.
• Troubleshooting — the diagnostic commands and recovery paths behind the most common failures.

Still stuck, or is the message wrong?

Report it. The link carries only this code and the surface; describe the behaviour in your own words and never paste secrets, capability tokens, session strings, or private repository data.

Report this error

All error codes