A spec validation job runs the test cases attached to a rule draft (its
.spec.md file) against the CodeCharter engine, and reports which cases passed
or failed. You start a job with the Run specs button in the portal rule
editor — it saves any unsaved edits first and then runs the specs against the
current draft, without publishing anything. You can also re-run an earlier job
from this page (see Actions).
The /spec-jobs page lists every spec-validation job that was submitted by your account. Use it to inspect historical results, re-trigger failed runs, or cancel queued jobs.
Table columns
| Column | Description |
|---|---|
| Job ID | Short suffix of the unique job identifier (hover to see the full UUID). |
| Rule + version | Rule slug and draft revision the job was based on. The slug links to the rule's detail page. Jobs without an associated rule show Ad-hoc. |
| Status | Current processing state (see below). |
| Engine version | CodeCharter engine version that executed the job. |
| Duration | Wall-clock time from when a worker started the job until it finished. |
| Started | UTC timestamp when a worker claimed the job (or enqueue time when not yet started). |
Job statuses
- Queued — waiting for a worker to pick it up.
- Running — a worker is actively executing the spec cases.
- Passed — all cases passed.
- Failed — one or more cases produced an unexpected result.
- Timeout — the job exceeded the engine time limit.
- Cancelled — manually cancelled before or during execution.
- Error — the worker encountered an unrecoverable error.
Filtering
Use the filter bar to narrow down the list:
- Status — show only jobs in a specific state.
- Rule slug — filter by rule slug (partial match).
- Since — show only jobs created on or after this date.
Click Apply to reload the table with the current filters.
Actions
- Refresh — manually reload the job list.
- Auto-refresh — poll for new jobs every 5 seconds.
- Re-run (failed, timeout, or error jobs) — submits a new job for the same rule using the current draft. Only available for jobs tied to a rule; Ad-hoc jobs cannot be re-run.
- Cancel (queued or running jobs) — cancels the job before it completes.
The list shows 50 jobs per page; use Previous and Next below the table to move between pages.
Submitting and cancelling spec jobs is recorded in your account's audit log.