Plans & scheduling

A plan is a named, ordered bundle of suites you run as a single regression pass — on demand, or automatically on a cron schedule. It's how you go from "I have 20 suites" to "run the whole nightly regression and tell me what broke."

What a plan is

• An ordered list of items, each { suite, cases? } (omit cases to run the whole suite).
• Running a plan enqueues its items in order onto the run queue; each suite keeps its own shared fixtures/state, exactly like a normal run.
• An optional cron schedule so the plan fires itself.
• An optional auth test account that's logged in before each suite (for flows behind login).

Create and run

From the dashboard's Plans page (build a plan from your suites, or have generation produce a whole plan at once), or over the API:

# Create a plan
curl -X POST http://127.0.0.1:8400/api/v1/plans \
  -H "Authorization: Bearer $TOKEN" -H 'content-type: application/json' \
  -d '{
        "name": "Nightly regression",
        "items": [
          { "suite": "01-storefront.tripwire.yaml" },
          { "suite": "03-checkout.tripwire.yaml", "cases": ["t1-de-checkout"] }
        ],
        "schedule": "0 2 * * *"
      }'

# Run it now — enqueues every item in order
curl -X POST http://127.0.0.1:8400/api/v1/plans/<plan_id>/run \
  -H "Authorization: Bearer $TOKEN"

See the Plans API.

Scheduling

Set schedule to a standard cron expression (0 2 * * * = 02:00 daily). A scheduler daemon polls and fires each due plan onto the run queue, then stamps last_run. The dashboard shows the computed next run; an invalid cron is flagged rather than silently skipped.

Newly-saved schedules arm for their next boundary (a plan saved at 01:59 with 0 2 * * * runs at 02:00, not retroactively). Pair scheduled plans with notifications so a failed nightly pass pings Slack or Teams — and with issue filing so failures land as triaged tickets while you sleep.

How to use it

• One plan per environment or cadence — e.g. a fast smoke plan per push, a full regression plan nightly.
• Order matters — put setup/auth-establishing suites first; later suites inherit nothing across suites, but ordering keeps the report readable.
• Scope with cases — a plan can run just the critical cases of a large suite.

Related: Runs & assertions · Notifications · Filing issues