ERROR CODE

TVO-FLOW-002: Lane matches no role in the declared workflow

Lane matches no role in the declared workflow. This page shows what TOVIO prints.

Last updated September 22, 2026

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: `scratch/experiment` matches no role in the repository workflow

  Workflow `com.tovio.gitflow@1` declares these roles:
    trunk, integration, release, hotfix

  No role pattern matches `scratch/experiment`, so no transition can apply.

  Rename the lane to match a declared role, or land from one that does:
    tovio lane
  See the declared roles and their patterns:
    tovio policy workflow show

  [TVO-FLOW-002]

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