@stacksjs/defaults 0.75.120 → 0.75.122

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

@@ -468,3 +468,58 @@ those operations.
 - Each driver module exports a pre-instantiated `driver` singleton and both class-based and function-based APIs
 - Discord embed default color is `0x5865F2` (Discord blurple), not customizable via the auto-build path
 - Teams Adaptive Cards use version `1.4` with the official JSON schema URL
+
+
+## Persistent direct messaging
+
+`@stacksjs/orm` and `@stacksjs/chat` export `createMessenger`. Enable
+`traits: { useMessaging: true }` to bind `record.messenger(options)` to a
+hydrated model's identity. Trait migrations create `chat_conversations` and
+`chat_messages` with a cascading conversation foreign key and a unique send key.
+
+```ts
+import { createMessenger } from '@stacksjs/chat'
+
+const messenger = createMessenger({
+  actorId: authenticatedUser.id,
+  scope: `gym:${authorizedGym.id}`,
+  authorize: (actorId, recipientId) => canMessage(actorId, recipientId),
+  maxLength: 4000,
+  pageSize: 50,
+  enabled: true,
+})
+const thread = await messenger.direct(recipient.id)
+await messenger.send(thread.id, 'How did the session feel?', retryKey)
+const page = await messenger.messages(thread.id)
+await messenger.markRead(thread.id, page.messages.at(-1)!.id)
+```
+
+Select actor and scope on the server. Authorization is required and is checked
+for every inbox, history, send and read receipt operation. Use a stable retry
+key for one attempted message; a different body with the same key returns 409.
+History is chronological, with `has_more` and a `before` message-id cursor.
+Receipts acknowledge only messages through the id actually displayed.
+`MessagingError.status` provides safe HTTP statuses for application handlers.
+
+For the UI, STX ships `ChatInbox`, `ChatMessage`, and `ChatUnreadBadge` in
+`@stacksjs/components`. Browser stores import `createChat` from
+`@stacksjs/components/chat` and inject their authenticated HTTP transport.
+
+### Native broadcasting
+
+`createMessenger` emits `messaging.sent` after a new persisted message and
+`messaging.read` when acknowledged messages first become read. Retried sends and
+unchanged receipts emit nothing. Set `broadcast: false` to disable. Initialize
+Stacks realtime before delivery, using `createServer` for WebSockets or
+`createBroadcastHub` for authenticated HTTP streams.
+
+`messagingChannel(participantType, userId)` selects that person's private inbox.
+Authorize subscription using the authenticated person's server-owned ID. Events
+carry only `conversation_id`; always re-read message text through current
+relationship and tenant policy. This prevents a revoked relationship's old socket
+from receiving private message contents.
+
+The native STX controller accepts `broadcastEndpoint`. `chat.observe(active)`
+shares one stream across inboxes, launchers and unread badges, returns a cleanup,
+and reconciles after reconnect. Only an active visible inbox acknowledges reads.
+It clears account/tenant state and reconnects when the scope changes.

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

@@ -107,7 +107,7 @@ export default defineCommands({
 // app/Listeners/Console.ts
 export default function(cli: CLI) {
   cli.on('custom:command', () => {
-    console.log('Custom command executed!')
+    log.info('Custom command executed!')
   })
 
   cli.on('my:*', () => {
@@ -120,14 +120,23 @@ export default function(cli: CLI) {
 }
 ```
 
+## Plain command output
+
+Import `print` and `printError` from `@stacksjs/cli/output` for command results,
+test tallies and diagnostics that must be visible even when logging is filtered.
+They write synchronously to stdout and stderr, preserve Node formatting and
+inspection, append a newline, and complete before an immediate `process.exit()`.
+The narrow import needs no application configuration. Use `log` for application
+logging with levels, context and transports.
+
 ## Output Formatting
 
 Via `@stacksjs/utils` color functions (available in CLI context):
 ```typescript
 import { bold, green, red, yellow, dim, underline } from '@stacksjs/utils'
 
-console.log(green('✓ Success'))
-console.log(red('✗ Error'))
+print(green('✓ Success'))
+printError(red('✗ Error'))
 console.log(yellow('⚠ Warning'))
 console.log(bold('Important'))
 console.log(dim('Subtle info'))

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

@@ -1,184 +1,51 @@
 ---
 name: stacks-lint
-description: Use when linting or formatting code in a Stacks project. CRITICAL - always use pickier, NEVER eslint directly. Run 'bunx --bun pickier .' to lint, 'bunx --bun pickier . --fix' to auto-fix. For unused variables, prefer eslint-disable-next-line comments over underscore prefix. Covers @stacksjs/lint and config/code-style.ts.
+description: Use when linting or formatting a Stacks project. Always use Pickier through buddy or its native CLI, never ESLint directly.
 license: MIT
 compatibility: Bun >= 1.3.0, TypeScript
-allowed-tools: Read Edit Write Bash Grep Glob
 ---
 
 # Stacks Linting
 
-## CRITICAL RULES
-1. **ALWAYS** use `bunx --bun pickier .` to lint -- **NEVER** use `eslint` directly
-2. **Auto-fix**: `bunx --bun pickier . --fix`
-3. For unused variable warnings: prefer `// eslint-disable-next-line` comments over prefixing with `_`
-
-## Key Paths
-- Lint package: `storage/framework/core/lint/` (package: `@stacksjs/lint`)
-- Configuration: `config/code-style.ts` (auto-loaded via pickier's bunfig alias `code-style`; pickier handles both linting and formatting)
-- Lint command source: `storage/framework/core/buddy/src/commands/lint.ts`
-
-## Package Details
-- Package name: `@stacksjs/lint`
-- Version: tracks framework version (currently 0.70.23)
-- The lint package is a thin wrapper -- the actual linting is done by pickier
-- `storage/framework/core/lint/build.ts` is a no-op (nothing to build)
-- Dev dependencies: `better-dx`, `@stacksjs/gitlint`, `bun-git-hooks`
+Use `./buddy lint`, `./buddy lint:fix` and `./buddy format`. The code-style
+commands call Pickier's SDK directly. Pickier is the linter and formatter;
+it does not wrap ESLint. ESLint-style disable comments are compatibility syntax.
 
 ## Commands
 
-### Via buddy CLI
-The buddy `lint` command internally runs pickier with the project's pickier config:
-
-```bash
-# Lint (runs: bunx --bun pickier run --mode lint --config ./pickier.config.ts)
-buddy lint
-
-# Auto-fix (runs: bunx --bun pickier run --mode lint --config ./pickier.config.ts --fix)
-buddy lint --fix
-buddy lint:fix
-
-# Format (runs: bunx --bun pickier run --mode format --config ./pickier.config.ts --write)
-buddy format
-buddy format --write        # same as above (write is default)
-
-# Check formatting without changes
-buddy format --check        # runs: pickier run --mode format --config ./pickier.config.ts --check
-buddy format:check
-```
-
-### Direct pickier usage
-```bash
-# Lint entire project
-bunx --bun pickier .
-
-# Auto-fix
-bunx --bun pickier . --fix
-
-# Via npm scripts
-bun run lint
-bun run lint:fix
-bun run format
-bun run format:check
-```
-
-## config/code-style.ts (PickierOptions)
-
-The actual configuration used by the project. This is the source of truth for all lint settings:
-
-```typescript
-import type { PickierOptions } from 'pickier'
-
-const config: PickierOptions = {
-  format: {
-    extensions: ['ts', 'js', 'stx', 'json', 'yaml', 'md'],
-    indent: 2,
-    quotes: 'single',
-    semi: false,
-  },
-
-  rules: {
-    // TypeScript rules
-    noDebugger: 'off',
-    noConsole: 'off',
-  },
-
-  pluginRules: {
-    // Regexp rules disabled (false positives on route definitions)
-    'regexp/no-unused-capturing-group': 'off',
-    'regexp/no-super-linear-backtracking': 'off',
-    'regexp/optimal-quantifier-concatenation': 'off',
-    // Style rules disabled (conflict with common patterns or generated code)
-    'style/brace-style': 'off',
-    'style/max-statements-per-line': 'off',
-    'style/quotes': 'off',
-    'indent': 'off',
-    'quotes': 'off',
-    // TypeScript rules
-    'ts/no-top-level-await': 'off',
-    // Console is intentional
-    'no-console': 'off',
-    // Markdown rules
-    'markdown/heading-increment': 'off',
-    'markdown/no-empty-links': 'off',
-  },
-
-  ignores: [
-    '**/fixtures/**',
-    '**/coverage/**',
-    '**/temp/**',
-  ],
-}
-
-export default config
-```
-
-## Format Settings (enforced)
-- **Indent**: 2 spaces
-- **Quotes**: single quotes
-- **Semicolons**: none (no semicolons)
-- **Extensions**: ts, js, stx, json, yaml, md
-
-## Handling Unused Variables
-
-When pickier/eslint reports unused variables, use eslint-disable comments -- do NOT prefix with underscore:
-
-```typescript
-// CORRECT: Use eslint-disable comment
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-const unusedVar = someFunction()
+- `./buddy lint`: report errors and warnings; errors fail the command.
+- `./buddy lint --max-warnings 0`: require zero errors and warnings.
+- `./buddy lint:fix --max-warnings 0`: fix supported findings and enforce the warning budget.
+- `./buddy format`: write formatting; `./buddy format --check` checks without writing.
+- `./buddy lint --stx`: run the separate stx conformance checks from `config/lint.ts`.
 
-// ALSO CORRECT: Use eslint-disable for next line only
-// eslint-disable-next-line no-unused-vars
-function handler(req, res, next) {
-  res.send('ok')
-}
+For direct CLI use, run `bunx --bun pickier .`, adding `--fix` for supported
+fixes. Re-run without `--fix` to confirm remaining findings. Only apply fixes
+that preserve the source behavior; investigate false positives at Pickier's source.
 
-// INCORRECT: Don't prefix with underscore
-const _unusedVar = someFunction()  // DON'T DO THIS
-```
+## Configuration and discovery
 
-## Internal Implementation
+Pickier discovers its own configuration (`pickier.config.ts`, `.config/pickier.ts`,
+and other supported names). `config/code-style.ts` is the framework's policy;
+applications may supply their own Pickier config. An explicit CLI `--config`
+selects that file. Keep the command and CI on the same policy.
 
-The buddy `lint` command (in `storage/framework/core/buddy/src/commands/lint.ts`) delegates entirely to pickier:
+Buddy discovers tracked files plus untracked files allowed by `.gitignore`.
+Its extension and path predicate lives in `@stacksjs/actions/lint/files`;
+code-style discovery currently includes ts, js, json, md, yaml and yml.
+Use Pickier directly to include stx and shell sources. Generated framework
+assets belong to the upstream framework's checks, not application edits.
 
-```typescript
-// lint.ts internals
-buddy
-  .command('lint', 'Automagically lints your project codebase')
-  .option('-f, --fix', 'Automagically fixes all lint errors', { default: false })
-  .action(async (options: LintOptions) => {
-    if (options.fix)
-      await runCommand('bunx --bun pickier run --mode lint --config ./pickier.config.ts --fix', { cwd: path.projectPath() })
-    else
-      await runCommand('bunx --bun pickier run --mode lint --config ./pickier.config.ts', { cwd: path.projectPath() })
-  })
-```
+## Conventions
 
-The `format` command uses pickier in format mode:
+Use two spaces, single quotes and no optional semicolons. Use Crosswind classes
+and stx signals/directives in templates. Fix real findings in source, rather than
+turning off rules to obtain a clean report. For intentional unused variables,
+prefer a targeted `// eslint-disable-next-line` over an underscore prefix.
 
-```typescript
-buddy
-  .command('format', 'Format your project codebase')
-  .option('-w, --write', 'Write changes to files', { default: false })
-  .option('-c, --check', 'Check formatting without making changes', { default: false })
-  .action(async (options) => {
-    if (options.check)
-      await runCommand('bunx --bun pickier run --mode format --config ./pickier.config.ts --check', { cwd: path.projectPath() })
-    else
-      await runCommand('bunx --bun pickier run --mode format --config ./pickier.config.ts --write', { cwd: path.projectPath() })
-  })
-```
+## Source
 
-## Gotchas
-- Pickier is the Stacks linting tool -- it wraps eslint with Stacks-specific config
-- **NEVER** run `eslint` directly -- always go through `bunx --bun pickier` or `buddy lint`
-- The `config/code-style.ts` file exports a `PickierOptions` object -- not an eslint config (auto-discovered by pickier via bunfig alias `code-style`)
-- The project intentionally allows `console.*` calls (`noConsole: 'off'`, `'no-console': 'off'`)
-- The project intentionally allows `debugger` statements (`noDebugger: 'off'`)
-- Top-level await is allowed (`'ts/no-top-level-await': 'off'`)
-- Brace style and max-statements-per-line rules are disabled to avoid conflicts with generated code
-- Run `bunx --bun pickier . --fix` after code generation to clean up
-- `buddy lint` exits through the `lint:*` wildcard handler if an invalid sub-command is used
-- `buddy format` defaults to `--write` mode (writes changes) unless `--check` is specified
-- The lint package (`@stacksjs/lint`) itself has no source files to build -- it is a configuration-only package
+- Actions: `storage/framework/core/actions/src/lint/lint.ts`
+- CLI: `storage/framework/core/buddy/src/commands/lint.ts`
+- Discovery: `storage/framework/core/actions/src/lint/files.ts`
+- Formatter/linter: the first-party Pickier repository

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

@@ -11,7 +11,7 @@ Browser runtime bindings are documented separately in `stacks-auto-imports`.
 | Package | Task guidance | Source entry | Retained tests |
 |---|---|---|---|
 | `@stacksjs/action-runner` | [`stacks-actions`](../stacks-actions/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/action-runner/src/index.ts) | 1 |
-| `@stacksjs/actions` | [`stacks-actions`](../stacks-actions/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/index.ts) | 64 |
+| `@stacksjs/actions` | [`stacks-actions`](../stacks-actions/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/index.ts) | 65 |
 | `@stacksjs/ai` | [`stacks-ai`](../stacks-ai/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/ai/src/index.ts) | 15 |
 | `@stacksjs/alias` | [`stacks-alias`](../stacks-alias/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/alias/src/index.ts) | 1 |
 | `@stacksjs/analytics` | [`stacks-analytics`](../stacks-analytics/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/analytics/src/index.ts) | 6 |
@@ -27,7 +27,7 @@ Browser runtime bindings are documented separately in `stacks-auto-imports`.
 | `@stacksjs/calendar-api` | [`stacks-calendar`](../stacks-calendar/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/calendar-api/src/index.ts) | 2 |
 | `@stacksjs/charts` | [`stacks-charts`](../stacks-charts/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/charts/src/index.ts) | 3 |
 | `@stacksjs/chat` | [`stacks-chat`](../stacks-chat/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/chat/src/index.ts) | 5 |
-| `@stacksjs/cli` | [`stacks-cli`](../stacks-cli/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/index.ts) | 9 |
+| `@stacksjs/cli` | [`stacks-cli`](../stacks-cli/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/index.ts) | 10 |
 | `@stacksjs/cloud` | [`stacks-cloud`](../stacks-cloud/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cloud/src/index.ts) | 10 |
 | `@stacksjs/cms` | [`stacks-cms`](../stacks-cms/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cms/src/index.ts) | 5 |
 | `@stacksjs/collections` | [`stacks-collections`](../stacks-collections/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/collections/src/index.ts) | 2 |
@@ -65,14 +65,14 @@ Browser runtime bindings are documented separately in `stacks-auto-imports`.
 | `@stacksjs/newsletter` | [`stacks-newsletter`](../stacks-newsletter/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/newsletter/src/index.ts) | 7 |
 | `@stacksjs/notifications` | [`stacks-notifications`](../stacks-notifications/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/notifications/src/index.ts) | 11 |
 | `@stacksjs/objects` | [`stacks-objects`](../stacks-objects/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/objects/src/index.ts) | 4 |
-| `@stacksjs/orm` | [`stacks-orm`](../stacks-orm/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/index.ts) | 60 |
+| `@stacksjs/orm` | [`stacks-orm`](../stacks-orm/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/index.ts) | 61 |
 | `@stacksjs/pagination` | [`stacks-pagination`](../stacks-pagination/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/pagination/src/index.ts) | 0 |
 | `@stacksjs/path` | [`stacks-path`](../stacks-path/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/path/src/index.ts) | 9 |
 | `@stacksjs/payments` | [`stacks-payments`](../stacks-payments/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/payments/src/index.ts) | 20 |
 | `@stacksjs/push` | [`stacks-push`](../stacks-push/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/push/src/index.ts) | 5 |
 | `@stacksjs/query-builder` | [`stacks-query-builder`](../stacks-query-builder/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/query-builder/src/index.ts) | 6 |
 | `@stacksjs/queue` | [`stacks-queue`](../stacks-queue/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/queue/src/index.ts) | 48 |
-| `@stacksjs/realtime` | [`stacks-realtime`](../stacks-realtime/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/src/index.ts) | 10 |
+| `@stacksjs/realtime` | [`stacks-realtime`](../stacks-realtime/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/src/index.ts) | 11 |
 | `@stacksjs/registry` | [`stacks-registry`](../stacks-registry/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/registry/src/index.ts) | 1 |
 | `@stacksjs/repl` | [`stacks-repl`](../stacks-repl/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/repl/src/index.ts) | 2 |
 | `@stacksjs/router` | [`stacks-router`](../stacks-router/SKILL.md) | [entrypoint](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/router/src/index.ts) | 86 |
@@ -119,7 +119,7 @@ Declared runtime exports: `BlogAdminError`, `DEFAULT_STX_LINT_CONFIG`, `blogSlug
 
 Local source modules: [src/action.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/action.ts), [src/add.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/add.ts), [src/blog-admin.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/blog-admin.ts), [src/commit.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/commit.ts), [src/dev/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/dev/index.ts), [src/discover-packages.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/discover-packages.ts), [src/generate/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/generate/index.ts), [src/helpers/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/helpers/index.ts), [src/library/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/library/index.ts), [src/lint/lint.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/lint/lint.ts), [src/lint/stx-gate.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/lint/stx-gate.ts), [src/make-command.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/make-command.ts), [src/make-job.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/make-job.ts), [src/make-policy.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/make-policy.ts), [src/make-resource.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/make-resource.ts), [src/make.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/make.ts), [src/scaffold-crud.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/scaffold-crud.ts), [src/setup/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/setup/index.ts), [src/stacks.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/stacks.ts), [src/upgrade/package-project.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/upgrade/package-project.ts), [src/upgrade/route-actions.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/src/upgrade/route-actions.ts).
 
-Evidence directory: [64 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
+Evidence directory: [65 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/actions/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 
 ### @stacksjs/ai
 
@@ -259,7 +259,7 @@ Evidence directory: [3 retained tests](https://github.com/stacksjs/stacks/blob/m
 
 Guidance: [`stacks-chat`](../stacks-chat/SKILL.md). Source: [storage/framework/core/chat/src/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/chat/src/index.ts).
 
-Declared runtime exports: `configureDiscord`, `configureSlack`, `configureTeams`, `discord`, `inbox`, `send`, `sendToDiscord`, `sendToSlack`, `sendToTeams`, `slack`, `teams`.
+Declared runtime exports: `MessagingError`, `configureDiscord`, `configureSlack`, `configureTeams`, `createMessenger`, `discord`, `inbox`, `messagingChannel`, `send`, `sendToDiscord`, `sendToSlack`, `sendToTeams`, `slack`, `teams`.
 
 Local source modules: [src/drivers/discord.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/chat/src/drivers/discord.ts), [src/drivers/slack.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/chat/src/drivers/slack.ts), [src/drivers/teams.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/chat/src/drivers/teams.ts), [src/inbox/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/chat/src/inbox/index.ts).
 
@@ -271,9 +271,9 @@ Guidance: [`stacks-cli`](../stacks-cli/SKILL.md). Source: [storage/framework/cor
 
 Read the entrypoint and package export map for re-exported or type-only surfaces.
 
-Local source modules: [src/actions/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/actions/index.ts), [src/cli.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/cli.ts), [src/commands.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/commands.ts), [src/exec.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/exec.ts), [src/helpers.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/helpers.ts), [src/parse.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/parse.ts), [src/prompts.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/prompts.ts), [src/run.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/run.ts), [src/signals.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/signals.ts), [src/spinner.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/spinner.ts), [src/terminal.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/terminal.ts), [src/utils.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/utils.ts).
+Local source modules: [src/actions/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/actions/index.ts), [src/cli.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/cli.ts), [src/commands.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/commands.ts), [src/exec.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/exec.ts), [src/helpers.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/helpers.ts), [src/output.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/output.ts), [src/parse.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/parse.ts), [src/prompts.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/prompts.ts), [src/run.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/run.ts), [src/signals.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/signals.ts), [src/spinner.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/spinner.ts), [src/terminal.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/terminal.ts), [src/utils.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/src/utils.ts).
 
-Evidence directory: [9 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
+Evidence directory: [10 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/cli/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 
 ### @stacksjs/cloud
 
@@ -629,9 +629,9 @@ Guidance: [`stacks-orm`](../stacks-orm/SKILL.md). Source: [storage/framework/cor
 
 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`, `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`, `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/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/compiled-binary.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/utils/compiled-binary.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).
+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/compiled-binary.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/src/utils/compiled-binary.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).
 
-Evidence directory: [60 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
+Evidence directory: [61 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/orm/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 
 ### @stacksjs/pagination
 
@@ -691,11 +691,11 @@ Evidence directory: [48 retained tests](https://github.com/stacksjs/stacks/blob/
 
 Guidance: [`stacks-realtime`](../stacks-realtime/SKILL.md). Source: [storage/framework/core/realtime/src/index.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/src/index.ts).
 
-Declared runtime exports: `LegacyBroadcast`, `StacksChannel`, `channel`, `createChannel`, `createServer`, `debugSnapshot`, `dispatchBroadcast`, `emit`, `emitToUser`, `emitToUsers`, `getReplayBuffer`, `getServer`, `getWsAuthenticator`, `pruneExpired`, `recordBroadcast`, `replaySince`, `runBroadcast`, `setReplayBuffer`, `setServer`, `setWsAuthenticator`, `stopServer`, `storeWebSocketEvent`.
+Declared runtime exports: `LegacyBroadcast`, `StacksChannel`, `channel`, `createBroadcastHub`, `createBroadcastResponse`, `createChannel`, `createServer`, `debugSnapshot`, `dispatchBroadcast`, `emit`, `emitToUser`, `emitToUsers`, `getReplayBuffer`, `getServer`, `getWsAuthenticator`, `pruneExpired`, `recordBroadcast`, `replaySince`, `runBroadcast`, `setReplayBuffer`, `setServer`, `setWsAuthenticator`, `stopServer`, `storeWebSocketEvent`.
 
-Local source modules: [src/broadcast.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/src/broadcast.ts), [src/channel.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/src/channel.ts), [src/emit.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/src/emit.ts), [src/replay-buffer.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/src/replay-buffer.ts), [src/server-instance.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/src/server-instance.ts), [src/ws.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/src/ws.ts).
+Local source modules: [src/broadcast.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/src/broadcast.ts), [src/channel.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/src/channel.ts), [src/emit.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/src/emit.ts), [src/replay-buffer.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/src/replay-buffer.ts), [src/server-instance.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/src/server-instance.ts), [src/stream.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/src/stream.ts), [src/ws.ts](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/src/ws.ts).
 
-Evidence directory: [10 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
+Evidence directory: [11 retained tests](https://github.com/stacksjs/stacks/blob/main/storage/framework/core/realtime/tests). These files are evidence pointers, not a claim that all tests were run for this catalog.
 
 ### @stacksjs/registry
 

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

@@ -375,3 +375,21 @@ private/presence channel authorization are separate checks. Replay is in-memory
 and per process, not durable recovery or a cluster-wide sequence.
 Retained tests: `core/realtime/tests/ws-auth.test.ts`,
 `websocket-options.test.ts`, and replay/exclusion tests in that directory.
+
+## Authenticated HTTP broadcast transport
+
+`createBroadcastHub()` initializes the same ts-broadcasting engine without opening
+an extra WebSocket listener. It reuses an existing server. This is an explicit
+single-process HTTP transport; it does not initialize Redis or a cluster.
+`emit()`, model broadcasts and private chat invalidations all reach its hooks.
+
+`createBroadcastResponse({ channels, authorize, signal })` returns an SSE Response.
+Select channel names on the server. Authorization is mandatory and runs before
+subscription, before each event, and at every heartbeat. Pass the request's abort
+signal. Cancellation, failed authorization and slow consumers remove the hook.
+Streams bound both queued events and pending authorization work (64 by default).
+
+STX's `useBroadcastStream({ request, endpoint, onMessage, onConnected })` makes
+fresh authenticated requests using the application's injected transport, reconnects
+with backoff, and cancels on `close()`. Re-read durable state in `onConnected`;
+this stream does not promise durable replay. Credentials stay in HTTP headers.

package/ide/vscode/package.json

@@ -2,7 +2,7 @@
   "publisher": "Stacks",
   "name": "vscode-stacks",
   "displayName": "Stacks",
-  "version": "0.75.120",
+  "version": "0.75.122",
   "description": "Stacks, built into VS Code: stx templates, pickier linting and formatting, encrypted env files, the dev server preview and every buddy command. No other extensions required.",
   "license": "MIT",
   "funding": "https://github.com/sponsors/chrisbbreuer",

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/defaults",
   "type": "module",
   "sideEffects": false,
-  "version": "0.75.120",
+  "version": "0.75.122",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/stacksjs/stacks.git",
@@ -55,7 +55,7 @@
   "dependencies": {
     "@iconify-json/f7": "^1.2.2",
     "@iconify-json/hugeicons": "^1.2.35",
-    "@stacksjs/mobile": "^0.75.120",
+    "@stacksjs/mobile": "^0.75.122",
     "@stacksjs/sanitizer": "^0.2.422",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/xterm": "^6.0.0",

package/resources/plugins/preloader.ts

@@ -308,7 +308,8 @@ export async function loadAutoImports() {
           Reflect.set(globalThis, name, value)
         }
       }
-    } catch {
+    }
+    catch {
       // Package might not exist or not be built yet
     }
   }
@@ -328,7 +329,8 @@ export async function loadAutoImports() {
           Reflect.set(globalThis, name, value)
         }
       }
-    } catch {
+    }
+    catch {
       // Some files may have client-side dependencies, skip them
     }
   }
@@ -361,11 +363,13 @@ export async function loadAutoImports() {
             Reflect.set(globalThis, modelName, module.default)
             loadedModels.add(modelName)
           }
-        } catch {
+        }
+        catch {
           // Model may have unresolved dependencies during bootstrap
         }
       }
-    } catch {
+    }
+    catch {
       // Directory may not exist
     }
   }
@@ -392,11 +396,13 @@ export async function loadAutoImports() {
           Reflect.set(globalThis, jobName, module.default)
           loadedJobs.add(jobName)
         }
-      } catch {
+      }
+      catch {
         // Job may have unresolved dependencies during bootstrap
       }
     }
-  } catch {
+  }
+  catch {
     // Directory may not exist
   }
 
@@ -427,11 +433,13 @@ export async function loadAutoImports() {
             Reflect.set(globalThis, controllerName, module.default)
             loadedControllers.add(controllerName)
           }
-        } catch {
+        }
+        catch {
           // Controller may have unresolved dependencies during bootstrap
         }
       }
-    } catch {
+    }
+    catch {
       // Directory may not exist
     }
   }