Rename _wheels_jobs to wheels_jobs for Oracle compatibility and fix BoxLang claim

Oracle requires unquoted identifiers to start with a letter, making _wheels_jobs
invalid. Renamed to wheels_jobs across all SQL, tests, and docs.

Removed transaction {} from $claimJob — auto-commit is sufficient and avoids
failures on BoxLang + PostgreSQL.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: bpamiri

.ai/wheels/jobs/overview.md

@@ -1,7 +1,7 @@
 # Background Jobs
 
 ## Description
-Wheels provides a database-backed job queue system for running tasks asynchronously. Jobs are persisted to a `_wheels_jobs` table, processed in priority order, and automatically retried with exponential backoff on failure.
+Wheels provides a database-backed job queue system for running tasks asynchronously. Jobs are persisted to a `wheels_jobs` table, processed in priority order, and automatically retried with exponential backoff on failure.
 
 ## Key Points
 - Jobs extend `wheels.Job` and implement a `perform()` method
@@ -17,7 +17,7 @@ Wheels provides a database-backed job queue system for running tasks asynchronou
 ```bash
 wheels dbmigrate latest
 ```
-This creates the `_wheels_jobs` table. The migration is at `app/migrator/migrations/20260221000001_create_wheels_jobs_table.cfc`.
+This creates the `wheels_jobs` table. The migration is at `app/migrator/migrations/20260221000001_createwheels_jobs_table.cfc`.
 
 ### 2. Create a Job
 ```cfm
@@ -177,7 +177,7 @@ count = job.purgeCompleted(days=30, queue="reports");
 
 ## Database Schema
 
-The `_wheels_jobs` table has these columns:
+The `wheels_jobs` table has these columns:
 
 | Column | Type | Description |
 |--------|------|-------------|

CLAUDE.md

@@ -368,7 +368,7 @@ wheels jobs monitor                        # live dashboard
 
 **Configurable backoff**: `this.baseDelay = 2` and `this.maxDelay = 3600` in job `config()`. Formula: `Min(baseDelay * 2^attempt, maxDelay)`.
 
-Requires migration: `20260221000001_create_wheels_jobs_table.cfc`. Run with `wheels dbmigrate latest`.
+Requires migration: `20260221000001_createwheels_jobs_table.cfc`. Run with `wheels dbmigrate latest`.
 
 ## Server-Sent Events (SSE) Quick Reference
 

design_docs/FRAMEWORK-REVIEW.md

@@ -137,7 +137,7 @@ The native MCP server (`vendor/wheels/public/mcp/McpServer.cfc`) is a genuine di
 
 **Impact:** Without a persistent job runner, background jobs cannot reliably execute. Email sending, report generation, and API syncs all require this.
 
-**Recommendation:** Implement a database-backed job queue (following Rails' Solid Queue approach). Store jobs in a `_wheels_jobs` table with status, retry count, scheduled_at, and error tracking. A poll-based worker running as a CLI daemon (`wheels jobs work`) would complete the picture.
+**Recommendation:** Implement a database-backed job queue (following Rails' Solid Queue approach). Store jobs in a `wheels_jobs` table with status, retry count, scheduled_at, and error tracking. A poll-based worker running as a CLI daemon (`wheels jobs work`) would complete the picture.
 
 #### Gap 3: No Nested Resource Routes
 
@@ -234,7 +234,7 @@ Implement Server-Sent Events (SSE) as a lightweight first step:
 ### Priority 2: Complete the Job System (High Impact)
 
 Turn the existing `wheels.Job` skeleton into a full system:
-1. Database-backed queue table (`_wheels_jobs`)
+1. Database-backed queue table (`wheels_jobs`)
 2. CLI worker: `wheels jobs work --queue=default,high`
 3. Retry with exponential backoff, max attempts, dead letter storage
 4. `wheels jobs status` command for monitoring

design_docs/MODERNIZE-WHEELS-RIM.md

@@ -473,7 +473,7 @@ wheels jobs purge --completed --older-than=7d
 ```
 
 **Implementation steps:**
-1. Ensure `_wheels_jobs` table auto-creates on first use (already designed in `Job.cfc`)
+1. Ensure `wheels_jobs` table auto-creates on first use (already designed in `Job.cfc`)
 2. Implement `wheels.JobWorker` class that polls the job table
 3. Create CLI commands: `work`, `status`, `retry`, `purge`
 4. Add exponential backoff retry: delay = `min(baseDelay * 2^attempt, maxDelay)`

docs/src/command-line-tools/commands/jobs/jobs-purge.md

@@ -4,7 +4,7 @@ description: Purge old completed or failed jobs from the queue table.
 
 # wheels jobs purge
 
-Delete old jobs from the `_wheels_jobs` table to prevent table bloat. By default, purges completed jobs older than 7 days.
+Delete old jobs from the `wheels_jobs` table to prevent table bloat. By default, purges completed jobs older than 7 days.
 
 ## Usage
 

docs/src/working-with-wheels/background-jobs.md

@@ -20,7 +20,7 @@ First, create the jobs table by running the included migration:
 wheels dbmigrate latest
 ```
 
-This creates the `_wheels_jobs` table. The migration file is at `app/migrator/migrations/20260221000001_create_wheels_jobs_table.cfc`.
+This creates the `wheels_jobs` table. The migration file is at `app/migrator/migrations/20260221000001_createwheels_jobs_table.cfc`.
 
 ### 2. Create a Job
 
@@ -228,7 +228,7 @@ Each job goes through these statuses:
 
 ## Database Schema
 
-The `_wheels_jobs` table contains:
+The `wheels_jobs` table contains:
 
 | Column | Type | Description |
 |--------|------|-------------|
@@ -355,4 +355,4 @@ The formula is `baseDelay * 2^attempt`, capped at `maxDelay`:
 5. **Monitor the queue**: Use `wheels jobs monitor` or `queueStats()` to track queue health and alert on growing `failed` counts.
 6. **Purge old jobs**: Run `wheels jobs purge` or `purgeCompleted()` on a schedule to prevent table bloat.
 7. **Run multiple workers**: For higher throughput, run multiple `wheels jobs work` processes — optimistic locking prevents duplicate processing.
-8. **Handle missing tables gracefully**: If the `_wheels_jobs` table doesn't exist yet, `enqueue()` will log a warning and return `persisted=false` instead of throwing an error.
+8. **Handle missing tables gracefully**: If the `wheels_jobs` table doesn't exist yet, `enqueue()` will log a warning and return `persisted=false` instead of throwing an error.

vendor/wheels/Job.cfc

@@ -3,7 +3,7 @@
  * Provides background job processing with database-backed persistence,
  * retry logic with exponential backoff, and priority queue support.
  *
- * The _wheels_jobs table is auto-created on first use — no migration needed.
+ * The wheels_jobs table is auto-created on first use — no migration needed.
  *
  * Usage:
  *   // In app/jobs/SendWelcomeEmailJob.cfc
@@ -136,7 +136,7 @@ component {
 
 		try {
 			queryExecute(
-				"INSERT INTO _wheels_jobs (id, jobClass, queue, data, priority, status, attempts, maxRetries, runAt, createdAt, updatedAt)
+				"INSERT INTO wheels_jobs (id, jobClass, queue, data, priority, status, attempts, maxRetries, runAt, createdAt, updatedAt)
 				VALUES (:id, :jobClass, :queue, :data, :priority, 'pending', 0, :maxRetries, :runAt, :createdAt, :updatedAt)",
 				{
 					id = {value = local.id, cfsqltype = "cf_sql_varchar"},
@@ -156,7 +156,7 @@ component {
 			if ($ensureJobTable()) {
 				try {
 					queryExecute(
-						"INSERT INTO _wheels_jobs (id, jobClass, queue, data, priority, status, attempts, maxRetries, runAt, createdAt, updatedAt)
+						"INSERT INTO wheels_jobs (id, jobClass, queue, data, priority, status, attempts, maxRetries, runAt, createdAt, updatedAt)
 						VALUES (:id, :jobClass, :queue, :data, :priority, 'pending', 0, :maxRetries, :runAt, :createdAt, :updatedAt)",
 						{
 							id = {value = local.id, cfsqltype = "cf_sql_varchar"},
@@ -202,7 +202,7 @@ component {
 		};
 
 		local.sql = "SELECT id, jobClass, queue, data, attempts, maxRetries
-			FROM _wheels_jobs
+			FROM wheels_jobs
 			WHERE status = 'pending' AND runAt <= :runAt";
 
 		if (Len(arguments.queue)) {
@@ -242,7 +242,7 @@ component {
 		// Mark as processing
 		try {
 			queryExecute(
-				"UPDATE _wheels_jobs
+				"UPDATE wheels_jobs
 				SET status = 'processing', attempts = attempts + 1, updatedAt = :updatedAt
 				WHERE id = :id",
 				{
@@ -264,7 +264,7 @@ component {
 
 			// Mark as completed
 			queryExecute(
-				"UPDATE _wheels_jobs
+				"UPDATE wheels_jobs
 				SET status = 'completed', completedAt = :completedAt, updatedAt = :updatedAt
 				WHERE id = :id",
 				{
@@ -294,7 +294,7 @@ component {
 				local.nextRunAt = DateAdd("s", local.backoffSeconds, $now());
 
 				queryExecute(
-					"UPDATE _wheels_jobs
+					"UPDATE wheels_jobs
 					SET status = 'pending',
 						lastError = :lastError,
 						runAt = :runAt,
@@ -317,7 +317,7 @@ component {
 			} else {
 				// Max retries exceeded — mark as failed (dead letter)
 				queryExecute(
-					"UPDATE _wheels_jobs
+					"UPDATE wheels_jobs
 					SET status = 'failed',
 						failedAt = :failedAt,
 						lastError = :lastError,
@@ -353,7 +353,7 @@ component {
 		local.stats = {pending = 0, processing = 0, completed = 0, failed = 0, total = 0};
 
 		try {
-			local.sql = "SELECT status, COUNT(*) as cnt FROM _wheels_jobs";
+			local.sql = "SELECT status, COUNT(*) as cnt FROM wheels_jobs";
 			local.params = {};
 
 			if (Len(arguments.queue)) {
@@ -383,7 +383,7 @@ component {
 	 * @queue Optional queue name to filter by.
 	 */
 	public numeric function retryFailed(string queue = "") {
-		local.sql = "UPDATE _wheels_jobs
+		local.sql = "UPDATE wheels_jobs
 			SET status = 'pending', attempts = 0, lastError = NULL, failedAt = NULL,
 				runAt = :runAt, updatedAt = :updatedAt
 			WHERE status = 'failed'";
@@ -413,7 +413,7 @@ component {
 	 */
 	public numeric function purgeCompleted(numeric days = 7, string queue = "") {
 		local.cutoff = DateAdd("d", -arguments.days, $now());
-		local.sql = "DELETE FROM _wheels_jobs WHERE status = 'completed' AND completedAt < :cutoff";
+		local.sql = "DELETE FROM wheels_jobs WHERE status = 'completed' AND completedAt < :cutoff";
 		local.params = {
 			cutoff = {value = local.cutoff, cfsqltype = "cf_sql_timestamp"}
 		};
@@ -433,14 +433,14 @@ component {
 	}
 
 	/**
-	 * Auto-create the _wheels_jobs table if it doesn't exist.
+	 * Auto-create the wheels_jobs table if it doesn't exist.
 	 * Uses database-agnostic SQL compatible with MySQL, PostgreSQL, SQL Server, H2, and SQLite.
 	 * Returns true if the table was created or already exists, false if creation failed.
 	 */
 	private boolean function $ensureJobTable() {
 		try {
 			// Check if table already exists by querying it
-			queryExecute("SELECT COUNT(*) AS cnt FROM _wheels_jobs WHERE 1=0", {}, {datasource = variables.$datasource});
+			queryExecute("SELECT COUNT(*) AS cnt FROM wheels_jobs WHERE 1=0", {}, {datasource = variables.$datasource});
 			return true;
 		} catch (any e) {
 			// Table doesn't exist — create it
@@ -472,7 +472,7 @@ component {
 			}
 
 			queryExecute("
-				CREATE TABLE _wheels_jobs (
+				CREATE TABLE wheels_jobs (
 					id #local.varcharType#(36) NOT NULL PRIMARY KEY,
 					jobClass #local.varcharType#(255) NOT NULL,
 					queue #local.varcharType#(100) DEFAULT 'default' NOT NULL,
@@ -492,17 +492,17 @@ component {
 
 			// Add indexes for efficient queue processing
 			try {
-				queryExecute("CREATE INDEX idx_wheels_jobs_processing ON _wheels_jobs (status, runAt, priority)", {}, {datasource = variables.$datasource});
-				queryExecute("CREATE INDEX idx_wheels_jobs_queue ON _wheels_jobs (queue, status)", {}, {datasource = variables.$datasource});
-				queryExecute("CREATE INDEX idx_wheels_jobs_cleanup ON _wheels_jobs (status, completedAt)", {}, {datasource = variables.$datasource});
+				queryExecute("CREATE INDEX idx_wjobs_processing ON wheels_jobs (status, runAt, priority)", {}, {datasource = variables.$datasource});
+				queryExecute("CREATE INDEX idx_wjobs_queue ON wheels_jobs (queue, status)", {}, {datasource = variables.$datasource});
+				queryExecute("CREATE INDEX idx_wjobs_cleanup ON wheels_jobs (status, completedAt)", {}, {datasource = variables.$datasource});
 			} catch (any indexError) {
 				// Indexes are optional — don't fail if they can't be created
 			}
 
-			writeLog(text = "Auto-created _wheels_jobs table", type = "information", file = "wheels_jobs");
+			writeLog(text = "Auto-created wheels_jobs table", type = "information", file = "wheels_jobs");
 			return true;
 		} catch (any createError) {
-			writeLog(text = "Failed to auto-create _wheels_jobs table: #createError.message#", type = "error", file = "wheels_jobs");
+			writeLog(text = "Failed to auto-create wheels_jobs table: #createError.message#", type = "error", file = "wheels_jobs");
 			return false;
 		}
 	}