@stacksjs/defaults 0.75.484 → 0.75.487

package/ai/skills/stacks-actions/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: stacks-actions
-description: Use when working with Stacks server actions - creating actions in app/Actions/, auto-generated API actions from the useApi model trait, the 683 default framework actions (auth, dashboard, commerce, content, deployment, jobs), action request/response handling, or action registration. Covers @stacksjs/actions and storage/framework/defaults/app/Actions/.
+description: Use when working with Stacks server actions - creating actions in app/Actions/, auto-generated API actions from the useApi model trait, the 685 default framework actions (auth, dashboard, commerce, content, deployment, jobs), action request/response handling, or action registration. Covers @stacksjs/actions and storage/framework/defaults/app/Actions/.
 license: MIT
 compatibility: Bun >= 1.3.0, TypeScript
 allowed-tools: Read Edit Write Bash Grep Glob

package/ai/skills/stacks-auto-imports/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: stacks-auto-imports
-description: Use before adding imports in Stacks app code, checking available runtime functions, browser/server delivery, model globals, or registry generation. Covers Stacks auto-imports, the generated runtime inventory, stx client delivery and server boot (107 models).
+description: Use before adding imports in Stacks app code, checking available runtime functions, browser/server delivery, model globals, or registry generation. Covers Stacks auto-imports, the generated runtime inventory, stx client delivery and server boot (108 models).
 license: MIT
 compatibility: Bun >= 1.3.0, TypeScript
 allowed-tools: Read Edit Write Bash Grep Glob

package/ai/skills/stacks-dashboard/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: stacks-dashboard
-description: Use when building or customizing the Stacks admin dashboard, including dashboard pages, model management views, analytics widgets, commerce dashboards, content management, settings panels, deployment monitoring, job/queue management, or the 414 built-in dashboard components. Covers the dashboard system at storage/framework/defaults/.
+description: Use when building or customizing the Stacks admin dashboard, including dashboard pages, model management views, analytics widgets, commerce dashboards, content management, settings panels, deployment monitoring, job/queue management, or the 415 built-in dashboard components. Covers the dashboard system at storage/framework/defaults/.
 license: MIT
 compatibility: Bun >= 1.3.0, TypeScript
 allowed-tools: Read Edit Write Bash Grep Glob
@@ -8,7 +8,7 @@ allowed-tools: Read Edit Write Bash Grep Glob
 
 # Stacks Dashboard
 
-The Stacks admin dashboard provides a full-featured admin panel with 100+ route views, 414 components, and a multi-section layout.
+The Stacks admin dashboard provides a full-featured admin panel with 100+ route views, 415 components, and a multi-section layout.
 
 ## Key Paths
 - Dashboard components: `storage/framework/defaults/resources/components/Dashboard/`
@@ -684,3 +684,34 @@ or separate routes generated by `useApi`. Configure `security.api.models` or
 `STACKS_MODEL_APIS`, middleware, ownership and policies for those APIs. The
 new boundary does not provide row ownership or permission checks for models
 that remain exposed.
+
+
+## Application observability
+
+The sidebar, model catalog and global search use the database's native model
+scope: application overrides and discovered package models, with framework
+models as a fallback. Global search uses the configured ORM connection on
+PostgreSQL, SQLite and MySQL. Only stored, visible fields from `useSearch`
+are queried; projected search-document fields are not assumed to be SQL columns.
+
+`/search-engine` inspects the configured driver, provider indexes and model
+`useSearch` settings, including custom index names. Provider failure leaves the
+model inventory visible with an unavailable state. It never reindexes on a read.
+`/jobs` discovers application definitions even before they have queued rows.
+Definition import failures are operational failures, not a successful empty list.
+
+Queue workers publish snapshots to the model-backed `queue_workers` table every
+10 seconds and on graceful exit. Publish `QueueWorker` into an application's
+model scope and generate/migrate its schema before using worker metrics. The
+dashboard reads snapshots across processes. A heartbeat older than 60 seconds
+marks the worker stopped and clears live throughput; sessions are retained for
+seven days. Completion/failure totals describe those retained worker sessions,
+not a durable per-job completion history. Queues containing only failed jobs
+stay visible. Database queue rows are authoritative for pending/reserved work.
+
+The local error page reads `errors`. An Error model does not capture exceptions
+by itself: configure `createDatabaseErrorReporter()` from
+`@stacksjs/database/error-reporter` in `monitoring.reporters`, publish
+`Error`, and migrate it. Reporting is bounded, buffered, identity-deduplicated
+by `captureError`, and flushed by `flushErrorReporters`/the logger. The database
+reporter stores allowlisted operational context and excludes bodies and headers.

package/ai/skills/stacks-database/SKILL.md

@@ -12,7 +12,7 @@ allowed-tools: Read Edit Write Bash Grep Glob
 - Database package: `storage/framework/core/database/src/`
 - Configuration: `config/database.ts`
 - QB config: `config/query-builder.ts`
-- Migrations: `database/migrations/` (247 migration files, `.sql` format)
+- Migrations: `database/migrations/` (248 migration files, `.sql` format)
 - QB state: `.qb/`
 - ORM: `storage/framework/orm/`
 

package/ai/skills/stacks-error-handling/SKILL.md

@@ -82,3 +82,11 @@ http.ts, error-page.ts, reporters.ts, bughq.ts and unique-violation.ts.
 Tests: result-type.test.ts, http-errors.test.ts, error-page-render.test.ts,
 custom-error-pages.test.ts and reporters.test.ts under core/error-handling/tests.
 Keep error payloads and credentials out of public responses and diagnostics.
+
+
+For the local dashboard error store, add `createDatabaseErrorReporter()` from
+`@stacksjs/database/error-reporter` to `monitoring.reporters`. Publish
+and migrate the native Error model in an application with its own schema.
+The bounded reporter buffers at most 100 writes, isolates storage failures,
+stores only allowlisted operational context, and drains through
+`flushErrorReporters()`. Remote reporters may coexist with the local store.

package/ai/skills/stacks-migrations/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: stacks-migrations
-description: Use when working with database migrations in a Stacks application - creating migration files, running migrations, fresh migration (drop + recreate), seeding after migration, migration file naming conventions, or the 247 built-in migration files. For the database API itself (queries, connections, SQL helpers), see stacks-database.
+description: Use when working with database migrations in a Stacks application - creating migration files, running migrations, fresh migration (drop + recreate), seeding after migration, migration file naming conventions, or the 248 built-in migration files. For the database API itself (queries, connections, SQL helpers), see stacks-database.
 license: MIT
 compatibility: Bun >= 1.3.0, TypeScript, SQLite >= 3.47.2
 allowed-tools: Read Edit Write Bash Grep Glob
@@ -236,7 +236,7 @@ lossless widenings; reports everything destructive), then
 - Do not commit a second snapshot under `.qb/`; that indicates a missing `snapshotDir` configuration
 - If a generated SQLite migration rebuilds tables, test it against a copy of the current database and run `PRAGMA integrity_check` plus `PRAGMA foreign_key_check`
 - `--seed` flag after `migrate:fresh` seeds the database with factory data
-- 247 migration files exist by default for all framework models
+- 248 migration files exist by default for all framework models
 - SQLite >= 3.47.2 is required (system requirement)
 - For the database API (queries, connections), see the `stacks-database` skill
 

package/ai/skills/stacks-models/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: stacks-models
-description: Use when defining or extending Stacks models, deriving migrations and CRUD, configuring attributes/relationships/traits/ownership, or preserving model inference. Covers defineModel, extendModel, model types, native data workflows, and the 107 built-in framework models.
+description: Use when defining or extending Stacks models, deriving migrations and CRUD, configuring attributes/relationships/traits/ownership, or preserving model inference. Covers defineModel, extendModel, model types, native data workflows, and the 108 built-in framework models.
 license: MIT
 compatibility: Bun >= 1.3.0, TypeScript, SQLite >= 3.47.2
 allowed-tools: Read Edit Write Bash Grep Glob
@@ -420,7 +420,7 @@ honoured: fewer rows are seeded rather than a duplicate combination.
 ## Built-in models by category
 
 The ones below are worth knowing by name. They are a selection, not the set:
-`storage/framework/defaults/app/Models/` holds 107, and that directory is the
+`storage/framework/defaults/app/Models/` holds 108, and that directory is the
 authority. This section said "All 62 built-in models by category" while
 listing fewer than that against 102 on disk, so an agent reading to the end
 had no way to tell it was short.

package/ai/skills/stacks-native/CATALOG.md

@@ -637,7 +637,7 @@ Evidence directory: [10 retained tests](https://github.com/stacksjs/stacks/blob/
 
 Guidance: [`stacks-orm`](../stacks-orm/SKILL.md). Source: [storage/framework/core/orm/src/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/index.ts).
 
-Declared runtime exports: `Activity`, `AnalyticsEvent`, `Auction`, `AuctionItem`, `Author`, `Automation`, `AutomationRun`, `BILLABLE_INSTANCE_METHODS`, `Bid`, `Board`, `BoardColumn`, `Campaign`, `CampaignSend`, `CampaignVariant`, `Card`, `CardAttachment`, `CardComment`, `Cart`, `CartItem`, `Categorizable`, `Category`, `Comment`, `CommunicationSuppression`, `ConsentEvent`, `Coupon`, `Courier`, `CourierPing`, `Customer`, `DeliveryRoute`, `DeliveryStop`, `Deployment`, `DigitalDelivery`, `EmailIdempotency`, `EmailList`, `EmailListSubscriber`, `EmailSuppression`, `EmailWebhookEvent`, `ErrorModel`, `FailedJob`, `FeedbackToken`, `Form`, `FormField`, `FormSubmission`, `GdprRequest`, `GiftCard`, `Job`, `Label`, `LicenseKey`, `Log`, `LoyaltyPoint`, `LoyaltyReward`, `MagicLinkToken`, `MailPreference`, `Manufacturer`, `Menu`, `MenuItem`, `ModelUnavailableError`, `Notification`, `NotificationDelivery`, `Order`, `OrderIdempotency`, `OrderItem`, `Page`, `PageRevision`, `Payment`, `PaymentMethod`, `PaymentProduct`, `PaymentTransaction`, `PaymentWebhookEvent`, `PersonalAccessToken`, `Pledge`, `Post`, `PrintDevice`, `Product`, `ProductUnit`, `ProductVariant`, `QueryLog`, `Receipt`, `Redirect`, `Referral`, `ReferralCode`, `Release`, `Request`, `Review`, `SenderDomain`, `ShippingMethod`, `ShippingRate`, `ShippingZone`, `Site`, `SiteDomain`, `SmsOptOut`, `SocialAccount`, `SocialPost`, `StorageItem`, `StorageItemTask`, `Subscriber`, `SubscriberEmail`, `Subscription`, `SubscriptionNotOwnedError`, `Tag`, `TaxRate`, `Team`, `TeamInvitation`, `TeamMember`, `Transaction`, `UsageEvent`, `User`, `WaitlistProduct`, `WaitlistRestaurant`, `Websocket`, `buildDatabaseSchema`, `collectEncryptedAttributes`, `createAuditMethods`, `createCategorizableMethods`, `createCommentableMethods`, `createLikeableMethods`, `createTaggableMethods`, `customerOwnership`, `decryptValue`, `encryptValue`, `enrichPaginatorUrls`, `filterFillable`, `frameworkModelFeature`, `getWritableFields`, `isBillable`, `isCursorPaginator`, `isEncrypted`, `isPaginator`, `isSimplePaginator`, `isUniqueViolation`, `mapWriteError`, `modelGlobalNames`, `ormReady`, `parentOwnership`, `parseCursor`, `renderDatabaseTypeFile`, `resolveCursorArgs`, `resolvePageArgs`, `selfOwnership`, `setAuditUser`, `siteOwnership`, `teamMembershipOwnership`, `toCursorPaginator`, `toPaginator`, `toSimplePaginator`, `toSnakeCaseKeys`.
+Declared runtime exports: `Activity`, `AnalyticsEvent`, `Auction`, `AuctionItem`, `Author`, `Automation`, `AutomationRun`, `BILLABLE_INSTANCE_METHODS`, `Bid`, `Board`, `BoardColumn`, `Campaign`, `CampaignSend`, `CampaignVariant`, `Card`, `CardAttachment`, `CardComment`, `Cart`, `CartItem`, `Categorizable`, `Category`, `Comment`, `CommunicationSuppression`, `ConsentEvent`, `Coupon`, `Courier`, `CourierPing`, `Customer`, `DeliveryRoute`, `DeliveryStop`, `Deployment`, `DigitalDelivery`, `EmailIdempotency`, `EmailList`, `EmailListSubscriber`, `EmailSuppression`, `EmailWebhookEvent`, `ErrorModel`, `FailedJob`, `FeedbackToken`, `Form`, `FormField`, `FormSubmission`, `GdprRequest`, `GiftCard`, `Job`, `Label`, `LicenseKey`, `Log`, `LoyaltyPoint`, `LoyaltyReward`, `MagicLinkToken`, `MailPreference`, `Manufacturer`, `Menu`, `MenuItem`, `ModelUnavailableError`, `Notification`, `NotificationDelivery`, `Order`, `OrderIdempotency`, `OrderItem`, `Page`, `PageRevision`, `Payment`, `PaymentMethod`, `PaymentProduct`, `PaymentTransaction`, `PaymentWebhookEvent`, `PersonalAccessToken`, `Pledge`, `Post`, `PrintDevice`, `Product`, `ProductUnit`, `ProductVariant`, `QueryLog`, `QueueWorker`, `Receipt`, `Redirect`, `Referral`, `ReferralCode`, `Release`, `Request`, `Review`, `SenderDomain`, `ShippingMethod`, `ShippingRate`, `ShippingZone`, `Site`, `SiteDomain`, `SmsOptOut`, `SocialAccount`, `SocialPost`, `StorageItem`, `StorageItemTask`, `Subscriber`, `SubscriberEmail`, `Subscription`, `SubscriptionNotOwnedError`, `Tag`, `TaxRate`, `Team`, `TeamInvitation`, `TeamMember`, `Transaction`, `UsageEvent`, `User`, `WaitlistProduct`, `WaitlistRestaurant`, `Websocket`, `buildDatabaseSchema`, `collectEncryptedAttributes`, `createAuditMethods`, `createCategorizableMethods`, `createCommentableMethods`, `createLikeableMethods`, `createTaggableMethods`, `customerOwnership`, `decryptValue`, `encryptValue`, `enrichPaginatorUrls`, `filterFillable`, `frameworkModelFeature`, `getWritableFields`, `isBillable`, `isCursorPaginator`, `isEncrypted`, `isPaginator`, `isSimplePaginator`, `isUniqueViolation`, `mapWriteError`, `modelGlobalNames`, `ormReady`, `parentOwnership`, `parseCursor`, `renderDatabaseTypeFile`, `resolveCursorArgs`, `resolvePageArgs`, `selfOwnership`, `setAuditUser`, `siteOwnership`, `teamMembershipOwnership`, `toCursorPaginator`, `toPaginator`, `toSimplePaginator`, `toSnakeCaseKeys`.
 
 Local source modules: [src/auto-crud.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/auto-crud.ts), [src/batch-loader.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/batch-loader.ts), [src/db.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/db.ts), [src/define-model.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/define-model.ts), [src/extend-model.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/extend-model.ts), [src/gdpr/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/gdpr/index.ts), [src/generate-database-schema.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/generate-database-schema.ts), [src/locked-row.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/locked-row.ts), [src/messaging.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/messaging.ts), [src/model-types.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/model-types.ts), [src/ownership.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/ownership.ts), [src/paginator-request.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/paginator-request.ts), [src/row-token.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/row-token.ts), [src/subquery.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/subquery.ts), [src/traits/audit.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/audit.ts), [src/traits/billable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/billable.ts), [src/traits/categorizable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/categorizable.ts), [src/traits/commentable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/commentable.ts), [src/traits/likeable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/likeable.ts), [src/traits/taggable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/traits/taggable.ts), [src/transaction.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/transaction.ts), [src/types.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/types.ts), [src/utils/encrypted.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/utils/encrypted.ts), [src/utils/prunable.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/utils/prunable.ts).
 
@@ -695,9 +695,9 @@ Evidence directory: [7 retained tests](https://github.com/stacksjs/stacks/blob/m
 
 Guidance: [`stacks-queue`](../stacks-queue/SKILL.md). Source: [storage/framework/core/queue/src/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/index.ts).
 
-Declared runtime exports: `Batch`, `DispatchedBatch`, `FailedJobNotifier`, `JOB_ENVELOPE_VERSION`, `Job`, `Jobs`, `OnQueueEvent`, `PendingBatch`, `QueueEvents`, `QueueMetrics`, `QueueTester`, `assertEnvelopeSerializable`, `cancelJob`, `checkQueueHealth`, `claimDispatchKey`, `clearEnvelopeWarnings`, `clearJobState`, `configureFailedJobNotifications`, `createEnvelope`, `createHealthCheckHandler`, `createQueueTester`, `discoverJobs`, `emitQueueEvent`, `executeFailedJobs`, `executeJob`, `expectJobToFail`, `fake`, `getActionRunner`, `getActiveJobCount`, `getAllJobs`, `getBatchCallbacks`, `getFailedJobNotifier`, `getFakeQueue`, `getGlobalMetrics`, `getJob`, `getJobProgress`, `getQueueEvents`, `getRedisQueue`, `getRegisteredJobs`, `getScheduledJobs`, `getSchedulerStatus`, `getWorkerTracker`, `hasDispatchedKey`, `hashPayload`, `isBatchCancelled`, `isCircuitOpen`, `isFaked`, `isJobCancelled`, `isQuarantined`, `isQueueHealthy`, `isSchedulerRunning`, `isWorkerRunning`, `job`, `jobBatch`, `jobRegistry`, `listCircuitState`, `listDeadLetterJobs`, `listQuarantined`, `moveToDeadLetter`, `notifyJobFailed`, `onQueueEvent`, `parseEnvelope`, `pauseQueue`, `purgeDeadLetterJobs`, `quarantineJob`, `queuedJobState`, `recordBatchJobCompletion`, `recordBatchJobFailure`, `recordCircuitFailure`, `recordCircuitSuccess`, `recordDispatchedKey`, `recordFailureForPoison`, `releaseDispatchKey`, `resolveQueueDriver`, `restore`, `resumeQueue`, `retryDeadLetterJob`, `retryFailedJob`, `runJob`, `runTestJob`, `serializeEnvelope`, `setActionRunner`, `setJobProgress`, `startProcessor`, `startScheduler`, `stopProcessor`, `stopScheduler`, `toJobOptions`, `triggerJob`, `unquarantineJob`, `withEvents`.
+Declared runtime exports: `Batch`, `DispatchedBatch`, `FailedJobNotifier`, `JOB_ENVELOPE_VERSION`, `Job`, `Jobs`, `OnQueueEvent`, `PendingBatch`, `QueueEvents`, `QueueMetrics`, `QueueTester`, `aggregateWorkerMetrics`, `assertEnvelopeSerializable`, `cancelJob`, `checkQueueHealth`, `claimDispatchKey`, `clearEnvelopeWarnings`, `clearJobState`, `configureFailedJobNotifications`, `createEnvelope`, `createHealthCheckHandler`, `createQueueTester`, `discoverJobs`, `emitQueueEvent`, `executeFailedJobs`, `executeJob`, `expectJobToFail`, `fake`, `getActionRunner`, `getActiveJobCount`, `getAllJobs`, `getBatchCallbacks`, `getFailedJobNotifier`, `getFakeQueue`, `getGlobalMetrics`, `getJob`, `getJobProgress`, `getQueueEvents`, `getRedisQueue`, `getRegisteredJobs`, `getScheduledJobs`, `getSchedulerStatus`, `getWorkerTracker`, `hasDispatchedKey`, `hashPayload`, `isBatchCancelled`, `isCircuitOpen`, `isFaked`, `isJobCancelled`, `isQuarantined`, `isQueueHealthy`, `isSchedulerRunning`, `isWorkerRunning`, `job`, `jobBatch`, `jobRegistry`, `listCircuitState`, `listDeadLetterJobs`, `listQuarantined`, `moveToDeadLetter`, `notifyJobFailed`, `onQueueEvent`, `parseEnvelope`, `pauseQueue`, `purgeDeadLetterJobs`, `quarantineJob`, `queuedJobState`, `readWorkerSnapshots`, `recordBatchJobCompletion`, `recordBatchJobFailure`, `recordCircuitFailure`, `recordCircuitSuccess`, `recordDispatchedKey`, `recordFailureForPoison`, `releaseDispatchKey`, `resolveQueueDriver`, `restore`, `resumeQueue`, `retryDeadLetterJob`, `retryFailedJob`, `runJob`, `runTestJob`, `serializeEnvelope`, `setActionRunner`, `setJobProgress`, `startProcessor`, `startScheduler`, `stopProcessor`, `stopScheduler`, `toJobOptions`, `triggerJob`, `unquarantineJob`, `withEvents`.
 
-Local source modules: [src/action-runner.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/action-runner.ts), [src/action.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/action.ts), [src/batch.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/batch.ts), [src/bun-queue.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/bun-queue.ts), [src/circuit-breaker.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/circuit-breaker.ts), [src/dead-letter.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/dead-letter.ts), [src/discovery.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/discovery.ts), [src/driver.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/driver.ts), [src/drivers/redis.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/drivers/redis.ts), [src/envelope.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/envelope.ts), [src/events.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/events.ts), [src/health.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/health.ts), [src/idempotency.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/idempotency.ts), [src/job-progress.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/job-progress.ts), [src/job.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/job.ts), [src/notifications.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/notifications.ts), [src/poison.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/poison.ts), [src/scheduler.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/scheduler.ts), [src/testing.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/testing.ts), [src/worker.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/worker.ts).
+Local source modules: [src/action-runner.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/action-runner.ts), [src/action.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/action.ts), [src/batch.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/batch.ts), [src/bun-queue.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/bun-queue.ts), [src/circuit-breaker.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/circuit-breaker.ts), [src/dead-letter.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/dead-letter.ts), [src/discovery.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/discovery.ts), [src/driver.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/driver.ts), [src/drivers/redis.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/drivers/redis.ts), [src/envelope.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/envelope.ts), [src/events.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/events.ts), [src/health.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/health.ts), [src/idempotency.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/idempotency.ts), [src/job-progress.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/job-progress.ts), [src/job.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/job.ts), [src/notifications.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/notifications.ts), [src/poison.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/poison.ts), [src/scheduler.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/scheduler.ts), [src/testing.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/testing.ts), [src/worker-monitor.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/worker-monitor.ts), [src/worker.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/worker.ts).
 
 Evidence directory: [56 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 

package/ai/skills/stacks-orm/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: stacks-orm
-description: Use when querying or writing Stacks models, using transactions and relationships, preserving inferred model types, or enabling native model traits. Covers @stacksjs/orm, the model runtime, and 107 built-in models.
+description: Use when querying or writing Stacks models, using transactions and relationships, preserving inferred model types, or enabling native model traits. Covers @stacksjs/orm, the model runtime, and 108 built-in models.
 license: MIT
 compatibility: Bun >= 1.3.0, TypeScript
 allowed-tools: Read Edit Write Bash Grep Glob
@@ -10,7 +10,7 @@ allowed-tools: Read Edit Write Bash Grep Glob
 
 `defineModel` produces an immediately usable query surface over
 `bun-query-builder`. Model-driven migrations change the schema; there are no
-per-model ORM classes to generate. The framework declares 107 models on disk,
+per-model ORM classes to generate. The framework declares 108 models on disk,
 but optional feature gates determine which built-ins load in a running app.
 
 ## Definitions and typed rows

package/app/Actions/Dashboard/Content/CategoryDestroyAction.ts

@@ -25,7 +25,7 @@ export default new Action({
     try {
       const deleted = await transaction(async (rawTrx) => {
         const trx = rawTrx as unknown as typeof db
-        const category = await trx.selectFrom('categories').select(['id']).where('id', '=', id).executeTakeFirst()
+        const category = await trx.selectFrom('categorizables').where('categorizable_type', '=', 'posts').select(['id']).where('id', '=', id).executeTakeFirst()
         if (!category)
           return false
 
@@ -34,7 +34,7 @@ export default new Action({
           .where('category_id', '=', id)
           .where('categorizable_type', '=', 'posts')
           .execute()
-        await trx.deleteFrom('categories').where('id', '=', id).execute()
+        await trx.deleteFrom('categorizables').where('categorizable_type', '=', 'posts').where('id', '=', id).execute()
         return true
       })
 

package/app/Actions/Dashboard/Content/CategoryIndexAction.ts

@@ -12,18 +12,7 @@ interface CategoryRow {
   updated_at: string | null
 }
 
-/**
- * `GET /api/dashboard/categories` — backs `views/dashboard/content/categories/index.stx`.
- *
- * Reads the `categories` table via `db`. The previous `Category.all()` call
- * threw on every request (the ORM model exposes no query methods) and the catch
- * turned that into an empty list, so a broken read was indistinguishable from a
- * CMS with no categories. It also mapped `parent_id` and `post_count`, neither
- * of which this table has.
- *
- * Note this is the same `categories` table the commerce `Category` model owns —
- * CMS and commerce categories are not separated in the schema today.
- */
+/** The CMS catalog owns categorizables; commerce's categories have a separate id space. */
 export default new Action({
   name: 'CategoryIndexAction',
   description: 'Returns CMS categories for the dashboard.',
@@ -32,7 +21,7 @@ export default new Action({
   async handle() {
     try {
       const rows = await db
-        .selectFrom('categories')
+        .selectFrom('categorizables').where('categorizable_type', '=', 'posts')
         .selectAll()
         .orderBy('created_at', 'desc')
         .execute() as unknown as CategoryRow[]

package/app/Actions/Dashboard/Content/CategoryStoreAction.ts

@@ -3,7 +3,6 @@ import { Action } from '@stacksjs/actions/runtime'
 import { db } from '@stacksjs/database/runtime'
 import { transaction } from '@stacksjs/orm'
 import { response } from '@stacksjs/router'
-import { randomUUIDv7 } from 'bun'
 import { dashboardOperationalError } from '../dashboard-response'
 import { findRow, insertedId, slugify, str, timestamp } from './content-input'
 
@@ -32,7 +31,7 @@ export default new Action({
       const category = await transaction(async (rawTrx) => {
         const trx = rawTrx as unknown as typeof db
         const duplicate = await trx
-          .selectFrom('categories')
+          .selectFrom('categorizables').where('categorizable_type', '=', 'posts')
           .select(['id'])
           .where('slug', '=', slug)
           .executeTakeFirst()
@@ -41,21 +40,16 @@ export default new Action({
           return null
 
         const now = timestamp()
-        const displayOrder = await trx
-          .selectFrom('categories')
-          .select(db.fn.max('display_order').as('max_display_order'))
-          .executeTakeFirst()
-
         const result = await trx
-          .insertInto('categories')
+          .insertInto('categorizables')
           .values({
-            uuid: randomUUIDv7(),
             name,
             slug,
             description,
             // A real boolean: on PostgreSQL the column is boolean and refuses 1.
             is_active: true,
-            display_order: Number(displayOrder?.max_display_order || 0) + 1,
+            categorizable_type: 'posts',
+            categorizable_id: 0,
             created_at: now,
             updated_at: now,
           } as any)
@@ -68,7 +62,7 @@ export default new Action({
         if (!id)
           throw new Error('Category insert did not return an id.')
 
-        const created = await findRow('categories', id, trx)
+        const created = await findRow('categorizables', id, trx)
         if (!created)
           throw new Error('Created category could not be loaded.')
         return created

package/app/Actions/Dashboard/Content/ContentDashboardAction.ts

@@ -230,7 +230,7 @@ export default new Action({
         (since ? postQuery.where('created_at', '>=', since) : postQuery).execute() as unknown as Promise<ContentOverviewPostRow[]>,
         (since ? pageQuery.where('created_at', '>=', since) : pageQuery).execute() as unknown as Promise<ContentOverviewPageRow[]>,
         (since ? commentQuery.where('created_at', '>=', since) : commentQuery).execute() as unknown as Promise<ContentOverviewCommentRow[]>,
-        db.selectFrom('categories').select(['id', 'name']).execute() as unknown as Promise<NamedRow[]>,
+        db.selectFrom('categorizables').where('categorizable_type', '=', 'posts').select(['id', 'name']).execute() as unknown as Promise<NamedRow[]>,
         db.selectFrom('authors').select(['id', 'name']).execute() as unknown as Promise<NamedRow[]>,
       ])
 

package/app/Actions/Dashboard/Content/PostIndexAction.ts

@@ -76,7 +76,7 @@ export default new Action({
 
       const postIds = posts.map(post => post.id)
       const [categories, tags, authors, categoryRelations, tagRelations] = await Promise.all([
-        db.selectFrom('categories').select(['id', 'name', 'slug']).orderBy('name').execute(),
+        db.selectFrom('categorizables').where('categorizable_type', '=', 'posts').select(['id', 'name', 'slug']).orderBy('name').execute(),
         db.selectFrom('tags').select(['id', 'name', 'slug']).orderBy('name').execute(),
         db.selectFrom('authors').select(['id', 'name', 'email']).orderBy('name').execute(),
         postIds.length

package/app/Actions/Dashboard/Content/post-input.ts

@@ -89,7 +89,7 @@ export async function invalidPostReference(payload: PostPayload, database: typeo
       ? database.selectFrom('authors').select(['id']).where('id', '=', payload.authorId).executeTakeFirst()
       : Promise.resolve(undefined),
     payload.categoryIds.length
-      ? database.selectFrom('categories').whereIn('id', payload.categoryIds).select(['id']).execute()
+      ? database.selectFrom('categorizables').where('categorizable_type', '=', 'posts').whereIn('id', payload.categoryIds).select(['id']).execute()
       : Promise.resolve([]),
     payload.tagIds.length
       ? database.selectFrom('tags').whereIn('id', payload.tagIds).select(['id']).execute()

package/app/Actions/Dashboard/Jobs/JobDefinitionsAction.ts

@@ -0,0 +1,26 @@
+import { Action } from '@stacksjs/actions/runtime'
+import { discoverJobs } from '@stacksjs/queue'
+import { dashboardOperationalError } from '../dashboard-response'
+
+export default new Action({
+  name: 'Job Definitions',
+  description: 'Discover application jobs and their queue, schedule and retry conventions without dispatching them.',
+  method: 'GET',
+  async handle() {
+    try {
+      const jobs = await discoverJobs(undefined, { strict: true })
+      return { data: jobs.map(job => ({
+        name: job.name,
+        description: job.config.description ?? '',
+        queue: job.config.queue ?? 'default',
+        tries: job.config.tries ?? 3,
+        timeout: job.config.timeout ?? null,
+        schedule: job.config.rate ?? job.config.schedule ?? '',
+        enabled: job.config.enabled !== false,
+      })).sort((a, b) => a.name.localeCompare(b.name)) }
+    }
+    catch (error) {
+      return dashboardOperationalError(error, 'Job definitions could not be loaded.', 'JobDefinitionsAction')
+    }
+  },
+})

package/app/Actions/Dashboard/Jobs/JobStatsAction.ts

@@ -1,6 +1,6 @@
 import { Action } from '@stacksjs/actions/runtime'
 import { FailedJob, Job } from '@stacksjs/orm'
-import { getGlobalMetrics } from '@stacksjs/queue'
+import { aggregateWorkerMetrics, readWorkerSnapshots } from '@stacksjs/queue'
 import { dashboardOperationalError } from '../dashboard-response'
 
 export default new Action({
@@ -14,7 +14,7 @@ export default new Action({
         FailedJob.count(),
       ])
 
-      const metrics = getGlobalMetrics().getMetrics()
+      const metrics = aggregateWorkerMetrics(await readWorkerSnapshots())
       const completedSeen = metrics.counts.completed
       const failedSeen = metrics.counts.failed
       const totalSeen = completedSeen + failedSeen

package/app/Actions/Dashboard/Models/ModelShowAction.ts

@@ -1,3 +1,4 @@
+import { hiddenModelColumns } from '../../../../resources/functions/dashboard/model-columns'
 import type { RequestInstance } from '@stacksjs/types'
 import { Action } from '@stacksjs/actions/runtime'
 import { response as routerResponse } from '@stacksjs/router'
@@ -83,17 +84,6 @@ function humanize(column: string): string {
 // dropped from the response body AND from the sort/filter allowlist: a
 // column you cannot see is still an enumeration oracle if you can sort or
 // filter by it.
-const HIDDEN_COLUMNS = new Set(['password', 'remember_token', 'api_token', 'access_token', 'refresh_token', 'secret', 'two_factor_secret'])
-
-function hiddenModelColumns(Model: any): Set<string> {
-  const hidden = new Set(HIDDEN_COLUMNS)
-  for (const [name, definition] of Object.entries(Model?.attributes ?? {})) {
-    if ((definition as { hidden?: boolean })?.hidden)
-      hidden.add(pascalToSnake(name))
-  }
-  return hidden
-}
-
 /**
  * Column identifiers reach the query builder as raw, unquoted SQL, so only
  * valid identifiers from the table's own column list may ever be used.

package/app/Actions/Dashboard/Models/ModelsIndexAction.ts

@@ -1,8 +1,6 @@
 import { Action } from '@stacksjs/actions/runtime'
-import { existsSync, readdirSync } from 'node:fs'
-import { join } from 'node:path'
-import process from 'node:process'
-import { frameworkDefaultsRoot } from '@stacksjs/path'
+import { overridesReady } from '@stacksjs/config'
+import { resolveModelSources } from '@stacksjs/database/model-sources'
 import { countRows } from '../../../../resources/functions/dashboard/data'
 import { dashboardOperationalError, dashboardOperationalIssue } from '../dashboard-response'
 import { resolveDashboardModel } from '../../../../resources/functions/dashboard/model-access'
@@ -64,25 +62,6 @@ function pluralize(word: string): string {
   return `${word}s`
 }
 
-function walkModels(dir: string, recursive: boolean): Array<{ name: string, file: string }> {
-  const out: Array<{ name: string, file: string }> = []
-  if (!existsSync(dir))
-    return out
-
-  const entries = readdirSync(dir, { withFileTypes: true })
-  for (const ent of entries) {
-    const full = join(dir, ent.name)
-    if (ent.isDirectory()) {
-      if (recursive) out.push(...walkModels(full, true))
-      continue
-    }
-    if (!ent.name.endsWith('.ts')) continue
-    if (ent.name.startsWith('_') || ent.name === 'index.ts' || ent.name === 'README.ts') continue
-    out.push({ name: ent.name.replace('.ts', ''), file: full })
-  }
-  return out
-}
-
 function categorize(model: { source: 'userland' | 'framework', file: string }): string {
   if (model.source === 'userland') return 'userland'
   const segs = model.file.split('/Models/')[1]?.split('/') ?? []
@@ -122,30 +101,19 @@ export default new Action({
   method: 'GET',
   apiResponse: true,
   async handle() {
-    const cwd = process.cwd()
-    const userlandDir = join(cwd, 'app', 'Models')
-    const defaultsDir = join(frameworkDefaultsRoot(), 'app/Models')
-
-    let userland: Array<Omit<DiscoveredModel, 'source'>>
-    let defaults: Array<Omit<DiscoveredModel, 'source'>>
+    await overridesReady
+    let merged: DiscoveredModel[]
     try {
-      userland = walkModels(userlandDir, true)
-      defaults = walkModels(defaultsDir, true)
+      merged = (resolveModelSources()?.models ?? []).map(model => ({
+        name: model.name,
+        file: model.file,
+        source: model.origin === 'framework' ? 'framework' : 'userland',
+      }))
     }
     catch (error) {
       return dashboardOperationalError(error, 'Model catalog could not be loaded.', 'ModelsIndexAction.catalog')
     }
 
-    const seen = new Set<string>()
-    const merged: DiscoveredModel[] = []
-    for (const list of [userland, defaults]) {
-      for (const m of list) {
-        if (seen.has(m.name)) continue
-        seen.add(m.name)
-        merged.push({ ...m, source: list === userland ? 'userland' : 'framework' })
-      }
-    }
-
     const candidates = await Promise.all(merged.map(async (m): Promise<ModelRow | null> => {
       let Model: any
       try {

package/app/Actions/Dashboard/Queue/QueueStatsAction.ts

@@ -1,6 +1,6 @@
 import { Action } from '@stacksjs/actions/runtime'
 import { FailedJob, Job } from '@stacksjs/orm'
-import { getGlobalMetrics } from '@stacksjs/queue'
+import { aggregateWorkerMetrics, readWorkerSnapshots } from '@stacksjs/queue'
 import { dashboardOperationalError } from '../dashboard-response'
 import { readQueueCounts } from './queue-stats'
 
@@ -32,18 +32,16 @@ export default new Action({
         total: queue.total,
       }))
       const active = counts.reduce((sum, queue) => sum + queue.active, 0)
-      const completed = 0
 
-      // The in-memory metrics tracker only sees jobs processed since the
-      // current API process started, so it complements (not replaces) the DB
-      // counts. If the process just booted there's nothing here yet.
-      const metrics = getGlobalMetrics().getMetrics()
+      // Workers publish bounded snapshots through their native QueueWorker model.
+      // The dashboard reads those across processes rather than its own empty tracker.
+      const metrics = aggregateWorkerMetrics(await readWorkerSnapshots())
 
       const stats = {
         totalQueues: queues.length,
         totalJobs,
         activeJobs: active,
-        completedJobs: completed,
+        completedJobs: metrics.counts.completed,
         failedJobs: failedJobCount,
         throughputPerMinute: metrics.throughputPerMinute,
         averageProcessingTimeMs: Math.round(metrics.averageDuration),

package/app/Actions/Dashboard/Queue/QueueWorkersAction.ts

@@ -1,5 +1,5 @@
 import { Action } from '@stacksjs/actions/runtime'
-import { getActiveJobCount, getWorkerTracker, isWorkerRunning } from '@stacksjs/queue'
+import { readWorkerSnapshots } from '@stacksjs/queue'
 import { dashboardOperationalError } from '../dashboard-response'
 
 export default new Action({
@@ -8,8 +8,8 @@ export default new Action({
   method: 'GET',
   async handle() {
     try {
-      const tracker = getWorkerTracker()
-      const tracked = tracker.getAll()
+      const snapshots = await readWorkerSnapshots()
+      const tracked = snapshots.map(snapshot => snapshot.worker)
 
       // Translate the tracker's internal status into the dashboard's vocabulary
       // ("running" | "paused" | "stopped") so the existing UI badges keep working.
@@ -29,15 +29,15 @@ export default new Action({
           jobs_processed: w.processedCount,
           failed_jobs: w.failedCount,
           uptime,
-          last_heartbeat: w.lastActivityAt,
+          last_heartbeat: new Date(snapshots.find(snapshot => snapshot.worker.id === w.id)!.heartbeatAt).toISOString(),
           memory: '-',
         }
       })
 
       return {
         data,
-        worker_running: isWorkerRunning(),
-        active_jobs: getActiveJobCount(),
+        worker_running: tracked.some(worker => worker.status !== 'stopped'),
+        active_jobs: snapshots.reduce((sum, snapshot) => sum + snapshot.activeJobs, 0),
       }
     }
     catch (error) {

package/app/Actions/Dashboard/Queue/queue-stats.ts

@@ -22,7 +22,7 @@ const queueName = (value: unknown): string => String(value || 'default')
  * worker has reserved it, which is `queuedJobState`'s rule in
  * `@stacksjs/queue`: a `reserved_at` that is set and not 0, so the filter
  * below is `!= 0`, which NULL never matches. Queues are listed in the order of
- * their first job, and a queue with only failures is not listed, as before.
+ * their first job, including queues whose only remaining records are failures.
  */
 export async function readQueueCounts(database: typeof db = db): Promise<QueueCounts[]> {
   const [jobRows, failedRows] = await Promise.all([
@@ -57,6 +57,10 @@ export async function readQueueCounts(database: typeof db = db): Promise<QueueCo
     })
   }
 
+  for (const name of failed.keys()) {
+    if (!queues.has(name)) queues.set(name, { total: 0, active: 0, firstId: Number.POSITIVE_INFINITY })
+  }
+
   return [...queues.entries()]
     .sort(([, a], [, b]) => a.firstId - b.firstId)
     .map(([name, counts]) => ({