TVO-FLOW-005: The stage a forward-only promotion requires has no live lane

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: the workflow requires a `staging` lane, and none exists

  Workflow `com.tovio.gitlab-flow-env@1` requires transitions into `env/prod` to
  descend from role `staging`, but no live lane matches that role.

  Declaring the stage is the fix — an absent stage cannot be treated as passed.

  Create the stage lane:
    tovio lane <name>
  See the declared roles and their patterns:
    tovio policy workflow show

  [TVO-FLOW-005]

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-005 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