@zintrust/trace 0.4.75

package/README.md

@@ -0,0 +1,288 @@
+# @zintrust/trace
+
+A debug assistant for ZinTrust. Records HTTP requests, database queries, exceptions, jobs, cache operations, scheduled tasks, mail, auth events, and more — all surfaced through a built-in web dashboard.
+
+Works with both `zin s` (Node.js) and `zin s --wg` (Cloudflare Workers).
+
+---
+
+## Installation
+
+```bash
+yarn add @zintrust/trace
+```
+
+Run the provided migrations to create the three required tables (`zin_trace_entries`, `zin_trace_entries_tags`, `zin_trace_monitoring`):
+
+```bash
+zin migrate:trace
+```
+
+You can still import the package migrations manually if you prefer to keep them inside your project migration entrypoint.
+
+---
+
+## Quick start
+
+### 1. Enable via environment variables
+
+```env
+TRACE_ENABLED=true
+TRACE_DB_CONNECTION=d1        # optional — omit to inherit DB_CONNECTION
+TRACE_PRUNE_HOURS=24          # how long entries are kept (default: 24)
+TRACE_SLOW_QUERY_MS=100       # slow-query threshold in ms (default: 100)
+TRACE_LOG_LEVEL=info          # minimum log level captured (default: info)
+```
+
+### 2. Enable the plugin in `zintrust.plugins.*`
+
+The supported setup is to opt in through your ZinTrust plugin files, not a custom `src/start.ts` import.
+
+For Node / standard runtime:
+
+```ts
+// src/zintrust.plugins.ts
+import '@zintrust/trace/plugin';
+```
+
+For Cloudflare Workers / `zin s --wg`, add the same plugin import to your Worker plugin file too:
+
+```ts
+// src/zintrust.plugins.wg.ts
+import '@zintrust/trace/plugin';
+
+import { ProjectRuntime } from '@zintrust/core';
+import serviceManifest from './bootstrap/service-manifest';
+
+ProjectRuntime.set({ serviceManifest });
+```
+
+Why this is the preferred path:
+
+- The plugin files are the framework-owned opt-in point that ZinTrust already auto-loads during boot.
+- The core runtime can then lazy-load the trace only after databases and the kernel are ready.
+- The plugin activates trace runtime logic only; the dashboard route stays inactive until you register it yourself.
+
+With the stock ZinTrust bootstrap, `TRACE_ENABLED=true` plus the plugin import above activates the watchers and storage integration. Dashboard UI/routes are a separate route-level opt-in.
+
+### 3. Mount the dashboard
+
+Register the dashboard explicitly in your route file when you want the UI. Restrict access with middleware — the trace does **not** apply auth automatically.
+
+```ts
+// routes/api.ts
+import { registerTraceDashboard } from '@zintrust/trace/ui';
+
+registerTraceDashboard(router, {
+  basePath: '/trace', // default
+  middleware: ['admin'], // apply your auth middleware here
+});
+```
+
+The dashboard SPA will be available at `GET /trace` (or your chosen `basePath`).
+
+If you need custom storage wiring, keep using the low-level route registrar:
+
+```ts
+import { useDatabase } from '@zintrust/core';
+import { registerTraceRoutes } from '@zintrust/trace/ui';
+import { TraceStorage } from '@zintrust/trace';
+
+const db = useDatabase();
+
+registerTraceRoutes(router, TraceStorage.resolveStorage(db), {
+  basePath: '/trace',
+  middleware: ['admin'],
+});
+```
+
+If you need a manual late bootstrap instead of plugin-driven activation, you can still import `@zintrust/trace/register` yourself, but that is the advanced path rather than the default project setup.
+
+## CLI commands
+
+When the optional package is installed, ZinTrust auto-registers these commands:
+
+```bash
+zin migrate:trace
+zin trace:status
+zin trace:prune --hours 24
+zin trace:clear
+```
+
+`zin trace:status` reports the active connection, retention window, current entry counts, and the expected dashboard URL derived from your current env and route choices.
+
+---
+
+## Watchers
+
+All 20 watchers are enabled by default when `TRACE_ENABLED=true`. Disable individual watchers via `TraceConfig.merge()` or environment-based overrides.
+
+| Watcher               | Captures                                            |
+| --------------------- | --------------------------------------------------- |
+| `HttpWatcher`         | Incoming HTTP requests and responses                |
+| `QueryWatcher`        | SQL queries, execution time, slow-query flag        |
+| `ExceptionWatcher`    | Unhandled exceptions with stack traces              |
+| `LogWatcher`          | Application log entries (filtered by `logMinLevel`) |
+| `JobWatcher`          | Background job dispatches and completions           |
+| `CacheWatcher`        | Cache hits, misses, writes, and deletes             |
+| `ScheduleWatcher`     | Scheduled task runs                                 |
+| `MailWatcher`         | Outgoing mail dispatches                            |
+| `AuthWatcher`         | Login, logout, and auth attempts                    |
+| `EventWatcher`        | Application events fired and listeners called       |
+| `ModelWatcher`        | ORM model creates, updates, and deletes             |
+| `NotificationWatcher` | Notification dispatches                             |
+| `RedisWatcher`        | Redis commands                                      |
+| `GateWatcher`         | Gate and policy checks                              |
+| `MiddlewareWatcher`   | Middleware chain execution                          |
+| `CommandWatcher`      | CLI command invocations                             |
+| `BatchWatcher`        | Batch job processing                                |
+| `DumpWatcher`         | Explicit `dump()` calls                             |
+| `ViewWatcher`         | View renders                                        |
+| `HttpClientWatcher`   | Outgoing HTTP client requests                       |
+
+---
+
+## Programmatic / custom wiring
+
+If you need fine-grained control instead of auto-registration, compose the pieces manually:
+
+```ts
+import {
+  TraceConfig,
+  TraceStorage,
+  TraceContext,
+  HttpWatcher,
+  QueryWatcher,
+  ExceptionWatcher,
+} from '@zintrust/trace';
+
+const config = TraceConfig.merge({
+  enabled: true,
+  pruneAfterHours: 48,
+  slowQueryThreshold: 200,
+  watchers: {
+    // disable specific watchers
+    redis: false,
+    view: false,
+  },
+  redaction: {
+    body: ['password', 'secret', 'token'],
+  },
+});
+
+const db = useDatabase();
+const storage = TraceStorage.resolveStorage(db);
+
+HttpWatcher.register({ storage, config, db });
+QueryWatcher.register({ storage, config, db });
+ExceptionWatcher.register({ storage, config, db });
+```
+
+---
+
+## Configuration reference
+
+`TraceConfig.merge(overrides?)` accepts the following options:
+
+| Option               | Type                                                | Default                            | Description                                                          |
+| -------------------- | --------------------------------------------------- | ---------------------------------- | -------------------------------------------------------------------- |
+| `enabled`            | `boolean`                                           | `false`                            | Master switch — no watchers activate when `false`                    |
+| `connection`         | `string \| undefined`                               | `undefined`                        | Named DB connection for storing entries; uses `'default'` if omitted |
+| `pruneAfterHours`    | `number`                                            | `24`                               | Entries older than this are pruned                                   |
+| `slowQueryThreshold` | `number`                                            | `100`                              | Queries taking longer (ms) are flagged as slow                       |
+| `logMinLevel`        | `'debug' \| 'info' \| 'warn' \| 'error' \| 'fatal'` | `'info'`                           | Minimum log severity captured                                        |
+| `ignoreRoutes`       | `string[]`                                          | `['/trace', '/health', '/ping']`   | Routes excluded from HTTP watcher                                    |
+| `watchers`           | `Record<string, boolean>`                           | `{}`                               | Per-watcher enable/disable flags (`false` = disabled)                |
+| `redaction.headers`  | `string[]`                                          | `['authorization', 'cookie', ...]` | Request header names to redact                                       |
+| `redaction.body`     | `string[]`                                          | `['password', 'token', ...]`       | Request body keys to redact                                          |
+| `redaction.query`    | `string[]`                                          | `[]`                               | Query-string keys to redact                                          |
+
+---
+
+## Entry types
+
+```ts
+import { EntryType } from '@zintrust/trace';
+
+EntryType.REQUEST; // 'request'
+EntryType.QUERY; // 'query'
+EntryType.EXCEPTION; // 'exception'
+EntryType.LOG; // 'log'
+EntryType.JOB; // 'job'
+EntryType.CACHE; // 'cache'
+EntryType.SCHEDULE; // 'schedule'
+EntryType.MAIL; // 'mail'
+EntryType.AUTH; // 'auth'
+EntryType.EVENT; // 'event'
+EntryType.MODEL; // 'model'
+EntryType.NOTIFICATION; // 'notification'
+EntryType.REDIS; // 'redis'
+EntryType.GATE; // 'gate'
+EntryType.MIDDLEWARE; // 'middleware'
+EntryType.COMMAND; // 'command'
+EntryType.BATCH; // 'batch'
+EntryType.DUMP; // 'dump'
+EntryType.VIEW; // 'view'
+EntryType.CLIENT_REQUEST; // 'client_request'
+```
+
+---
+
+## API surface
+
+```ts
+// Preferred plugin opt-in for stock ZinTrust boot
+import '@zintrust/trace/plugin';
+
+// Advanced late bootstrap import for runtime hooks only
+import '@zintrust/trace/register';
+
+// Lightweight dashboard/UI-only entrypoint
+import { registerTraceDashboard, registerTraceRoutes } from '@zintrust/trace/ui';
+
+// Named exports
+import {
+  TraceConfig, // configuration factory + merge helper
+  TraceStorage, // storage facade (read/write entries)
+  TraceContext, // per-request context (userId, batchId)
+  EntryType, // sealed enum of entry types
+  // individual watchers...
+  HttpWatcher,
+  QueryWatcher,
+  ExceptionWatcher,
+  LogWatcher,
+  JobWatcher,
+  CacheWatcher,
+  ScheduleWatcher,
+  MailWatcher,
+  AuthWatcher,
+  EventWatcher,
+  ModelWatcher,
+  NotificationWatcher,
+  RedisWatcher,
+  GateWatcher,
+  MiddlewareWatcher,
+  CommandWatcher,
+  BatchWatcher,
+  DumpWatcher,
+  ViewWatcher,
+  HttpClientWatcher,
+} from '@zintrust/trace';
+```
+
+---
+
+## Security considerations
+
+- **Always** protect the dashboard with middleware (e.g. `middleware: ['admin']`). `@zintrust/trace/ui` exports `registerTraceDashboard(...)` and `registerTraceRoutes(...)`, and neither applies any authentication by default.
+- Sensitive fields in request headers and body are redacted using the `redaction` config before being stored. Review and extend the default redaction lists to match your application's data model.
+- Use a **dedicated database connection** (`TRACE_DB_CONNECTION`) in production so trace writes cannot impact your primary DB connection pool.
+- Keep `TRACE_ENABLED=false` (or unset) in production unless actively investigating an issue.
+
+---
+
+## Peer dependencies
+
+| Package          | Version   |
+| ---------------- | --------- |
+| `@zintrust/core` | `^0.4.41` |

package/dist/build-manifest.json

@@ -0,0 +1,365 @@
+{
+  "name": "@zintrust/system-debugger",
+  "version": "0.4.67",
+  "buildDate": "2026-04-06T10:12:33.243Z",
+  "buildEnvironment": {
+    "node": "v22.22.1",
+    "platform": "darwin",
+    "arch": "arm64"
+  },
+  "git": {
+    "commit": "f5a9d786",
+    "branch": "release"
+  },
+  "package": {
+    "engines": {
+      "node": ">=20.0.0"
+    },
+    "dependencies": [],
+    "peerDependencies": [
+      "@zintrust/core"
+    ]
+  },
+  "files": {
+    "build-manifest.json": {
+      "size": 12633,
+      "sha256": "48f282e5d70a41bc87dc0f365f17991f1887b1267e899d7de80b7c05a28ebed9"
+    },
+    "cli-register.d.ts": {
+      "size": 258,
+      "sha256": "6dd21781558f8510fabce9c896cb8ad6e4039476e4f7c25147ad490bbcf44427"
+    },
+    "cli-register.js": {
+      "size": 1177,
+      "sha256": "8476ce194444b0d3eca24bf4ac5fcb29361bafcc586435bc95981f2e217842d3"
+    },
+    "config.d.ts": {
+      "size": 409,
+      "sha256": "73920648d0eb12e4b0da36dc230c238974cc686ed3233f48046eb8d1404dfa0f"
+    },
+    "config.js": {
+      "size": 1233,
+      "sha256": "351e181e7a9dc30f730509b3b926be200c3959093267e71953a490b7c6da32d0"
+    },
+    "context.d.ts": {
+      "size": 602,
+      "sha256": "feb15eda59bc67096d7f25fe71fbf6617c82bcb6970df5cb156a29bd5302da50"
+    },
+    "context.js": {
+      "size": 2523,
+      "sha256": "ed3766652a62b7d7374309d75aa99fdb846de3d577d636d3e3d85ffd06b93455"
+    },
+    "dashboard/handlers.d.ts": {
+      "size": 1005,
+      "sha256": "8babac3cb64bbafe95e2af9027c455883975ff12fa94e0c2595144ce0de23c00"
+    },
+    "dashboard/handlers.js": {
+      "size": 5393,
+      "sha256": "e5721a46d4ff7f21ad63b99b0e9aa292990625ce112a0eb369298da1d76efca5"
+    },
+    "dashboard/routes.d.ts": {
+      "size": 1046,
+      "sha256": "5b9e394b3da713c1a92d403fa381cb52941504b8835e454a243cd73514999d0b"
+    },
+    "dashboard/routes.js": {
+      "size": 2525,
+      "sha256": "36949c49bb24344512e1149e63a2c0053df90fafe1e1d6d1533744d684ab8755"
+    },
+    "dashboard/ui.d.ts": {
+      "size": 117,
+      "sha256": "4862b41e0477f01afa0dbb446d4553b65c22ed774cd1e2db3489059ced392f94"
+    },
+    "dashboard/ui.js": {
+      "size": 61060,
+      "sha256": "e3a8bbde4374b2452321250a0a9f827bfef268c2407588191049578863f4f135"
+    },
+    "index.d.ts": {
+      "size": 2324,
+      "sha256": "838f8ad0e67c1b262c6001aa11528431e004b96ca601358b435610ffc2611d34"
+    },
+    "index.js": {
+      "size": 3079,
+      "sha256": "eef7c370b293a2ac1f29e8c89e3af17d78d6b8ed59e877171f443e20e4095296"
+    },
+    "migrations/20260331000001_create_zin_debugger_entries_table.d.ts": {
+      "size": 317,
+      "sha256": "40fd91bf69322477f21e68a11f4c403062743d1f83cdabf57ae6238485ef7de9"
+    },
+    "migrations/20260331000001_create_zin_debugger_entries_table.js": {
+      "size": 971,
+      "sha256": "f399cf9e7549c58323fb624e894fc10affa49f30ceabfeaf6d19df0bfa78f6e6"
+    },
+    "migrations/20260331000002_create_zin_debugger_entries_tags_table.d.ts": {
+      "size": 317,
+      "sha256": "01b5ea90fe3702829f7b57cfd1dd0f8a0675b69025bae378bf9c3049007118c8"
+    },
+    "migrations/20260331000002_create_zin_debugger_entries_tags_table.js": {
+      "size": 759,
+      "sha256": "04e90930ca434eba6b84df1ff43d1fc3888e4c276088f496b25b619c52ef383e"
+    },
+    "migrations/20260331000003_create_zin_debugger_monitoring_table.d.ts": {
+      "size": 321,
+      "sha256": "955a2e7581187333726cb7a9812fd88d47b5b15caa83445e614a8830c4574e2b"
+    },
+    "migrations/20260331000003_create_zin_debugger_monitoring_table.js": {
+      "size": 541,
+      "sha256": "d391e864f39b32b2274a56edceddb2c9a99e2ec0717c58d748a1027376178552"
+    },
+    "migrations/index.d.ts": {
+      "size": 296,
+      "sha256": "c13325fc4a2b24e4fd315c1cce7acdecc058c18e18214491c0f18e1f8683bb4b"
+    },
+    "migrations/index.js": {
+      "size": 395,
+      "sha256": "06943fc21aac77f4abc674ad8ee5b3e99f9b0288c81418b1e0a7414c05644f76"
+    },
+    "plugin.d.ts": {
+      "size": 16,
+      "sha256": "71d366165dd36f1675aa253a76262b226fb6c62e5ab632746b8aea61c0c625fc"
+    },
+    "plugin.js": {
+      "size": 137,
+      "sha256": "5bffe9afc797c089441795f49f1526f16b0e67518264289e399866fc04835aa8"
+    },
+    "register.d.ts": {
+      "size": 16,
+      "sha256": "71d366165dd36f1675aa253a76262b226fb6c62e5ab632746b8aea61c0c625fc"
+    },
+    "register.js": {
+      "size": 6737,
+      "sha256": "9348c5b08f47174e61da3c73ec26ad524c9672e0bea35d5c20d99b1884083c6d"
+    },
+    "storage/DebuggerStorage.d.ts": {
+      "size": 535,
+      "sha256": "315bf62a9ea1ba379f0ebcbf9cebff1dea3a53af07995755e21d7b692001c9b9"
+    },
+    "storage/DebuggerStorage.js": {
+      "size": 7454,
+      "sha256": "f01ea439b2d9218abeba9308b5d10ee9ad96cec7cd9466dc7ce3105e7f0440f4"
+    },
+    "storage/index.d.ts": {
+      "size": 112,
+      "sha256": "a791dcfbe0a0aaf714cd6cc40815219ad480e93bc89dbd7395806ec0e4e1ecb8"
+    },
+    "storage/index.js": {
+      "size": 56,
+      "sha256": "5984122a9c183fd8e18e076d586d518051a5c3f095a839ce6a9db4126e416c9d"
+    },
+    "types.d.ts": {
+      "size": 6993,
+      "sha256": "73f034b042bee2e230160f5008e05a12b7cae5d0feecb121d836615eb6d43b1b"
+    },
+    "types.js": {
+      "size": 699,
+      "sha256": "585b7580ced5db88092befebd23b5b94da7ce7730f678958a349bff1579a3f79"
+    },
+    "ui.d.ts": {
+      "size": 408,
+      "sha256": "e672daee8f407a58d070b155724f6834df13588f40799d50f951ee884b5081b0"
+    },
+    "ui.js": {
+      "size": 304,
+      "sha256": "5bdc5a3e6ad6693fd39b154fba693de16fae93d5e95ef908c77ba03b53dd1e81"
+    },
+    "utils/authTag.d.ts": {
+      "size": 150,
+      "sha256": "db7ed89155df453650ad2805d8cd7069a70b14eacac2d97c4b0bebd45df4bdd4"
+    },
+    "utils/authTag.js": {
+      "size": 540,
+      "sha256": "ec3bdfd3bbc9ae820964caa21b061907321d0d9c6b9ce24275cf7c5408387b8d"
+    },
+    "utils/familyHash.d.ts": {
+      "size": 60,
+      "sha256": "c94f85390c52470df6946a39576c720ea92c89797ae62fff913191c45580248f"
+    },
+    "utils/familyHash.js": {
+      "size": 266,
+      "sha256": "f60526423e69fa5c461b0f5d8dac90b1f0c18149609cd1109226f1c8d985f223"
+    },
+    "utils/redact.d.ts": {
+      "size": 376,
+      "sha256": "0ce4549ec31a9b2858d095d4ff5bf677e9fd99f3ff62c065b92cc01fdf38da47"
+    },
+    "utils/redact.js": {
+      "size": 1633,
+      "sha256": "2ee18d55a77935ac32b04f40dea1257781293fe13f0ea8a2858b0e2631800159"
+    },
+    "utils/requestFilter.d.ts": {
+      "size": 195,
+      "sha256": "467f6ed959bd25731649b4afc6d555d316c4724f9586e0bd922881af41ba6746"
+    },
+    "utils/requestFilter.js": {
+      "size": 1026,
+      "sha256": "67448f03631a349572f6f3ddfcb2545e868138501dff3775ecb2e218000a39d4"
+    },
+    "utils/stackFrame.d.ts": {
+      "size": 149,
+      "sha256": "55008bb0bf16e96c7b4f706fa3aa2d3a5bb3a68d0b8bcbd046d23462a7f620e8"
+    },
+    "utils/stackFrame.js": {
+      "size": 1413,
+      "sha256": "ca651d04eaea48a240ec7c5714a0f8f1d92f2fcdaa6e735df0009b56de8c29ed"
+    },
+    "watchers/AuthWatcher.d.ts": {
+      "size": 231,
+      "sha256": "8ceed9e2f794611da26676e44886efdb20728f9082736e62127edac4582033a8"
+    },
+    "watchers/AuthWatcher.js": {
+      "size": 1338,
+      "sha256": "2312a54a86d6639ccd03db8a7988dc5b4d24ad75322c07b185542b323a7d5507"
+    },
+    "watchers/BatchWatcher.d.ts": {
+      "size": 283,
+      "sha256": "c86b597d8c118fbcf9f870b633dfe7fbff7db77df3681bc6c70beabba2d77e1b"
+    },
+    "watchers/BatchWatcher.js": {
+      "size": 1239,
+      "sha256": "5e7f9c4ed9276661939743ed447374832906293a357cdf7350f33575e897d59f"
+    },
+    "watchers/CacheWatcher.d.ts": {
+      "size": 271,
+      "sha256": "325d3c9e513776f2b763f24b3f0146a2a8c1d16e3e9349ae051891396b33cd4f"
+    },
+    "watchers/CacheWatcher.js": {
+      "size": 1530,
+      "sha256": "2011020f7b5d9c651a5bcc85727603c37a58b5a739b9b6303589d1417d40e542"
+    },
+    "watchers/CommandWatcher.d.ts": {
+      "size": 273,
+      "sha256": "6760a69c45927c1b381edf9fee86f236931845f0537f90c0ba160853b6972369"
+    },
+    "watchers/CommandWatcher.js": {
+      "size": 1412,
+      "sha256": "7d6766391d1f1f6ffa86f7bd29803918f1b396af29a85f4082575e796c40450f"
+    },
+    "watchers/DumpWatcher.d.ts": {
+      "size": 314,
+      "sha256": "72910ff111e35a442a97b1fda784c952af7d77a6790cbdd39ddf8c5c7d7c2ce4"
+    },
+    "watchers/DumpWatcher.js": {
+      "size": 1342,
+      "sha256": "30276e196458caee34d6192c73d1b6e3ab93c09c7edd93d61688a075d5efd6e5"
+    },
+    "watchers/EventWatcher.d.ts": {
+      "size": 229,
+      "sha256": "245ba4b27c890d0b18dcce2b8c7e1fd64347372160c6ebd0a79fca9b097f01b8"
+    },
+    "watchers/EventWatcher.js": {
+      "size": 1200,
+      "sha256": "a4730b74510b8eb2446ec78b0f5be4076f93945c7c68e50354a84141f8b7af74"
+    },
+    "watchers/ExceptionWatcher.d.ts": {
+      "size": 150,
+      "sha256": "90509da30a621cef3a101a7f0dc482ca9faa9f92b4158989a66133644cd080c0"
+    },
+    "watchers/ExceptionWatcher.js": {
+      "size": 3466,
+      "sha256": "30d8fd9042625e7a5e9619b02bf8d60eff8e3f515269067ec5ab9d281c13de62"
+    },
+    "watchers/GateWatcher.d.ts": {
+      "size": 268,
+      "sha256": "c8e440c0a32d0b3a96c8304fa2b70db72b9148f35f481446c31cc87f7e801d89"
+    },
+    "watchers/GateWatcher.js": {
+      "size": 1231,
+      "sha256": "62618a9526870f7bc9a7e5242a61798f74cda3f7da798b10bc20512a86e2692c"
+    },
+    "watchers/HttpClientWatcher.d.ts": {
+      "size": 289,
+      "sha256": "e577a28bf4335fb6bdc222c8d6b07fd8ba8ec1ca627ba42e3f7c52e76d6f5450"
+    },
+    "watchers/HttpClientWatcher.js": {
+      "size": 1597,
+      "sha256": "f8b6b0accd8a7fdc6e2e5cf1ee953e0543c9a11f4eba497b00d2c47066529e54"
+    },
+    "watchers/HttpWatcher.d.ts": {
+      "size": 102,
+      "sha256": "b1da47d14a79f8be7be60a4ca105f1be579383d33a4da71eb26a703ea37934d2"
+    },
+    "watchers/HttpWatcher.js": {
+      "size": 2652,
+      "sha256": "2af67c9201a881150c0d715d226a831689663f8be0b6fe462fea0f0a04b046a8"
+    },
+    "watchers/JobWatcher.d.ts": {
+      "size": 447,
+      "sha256": "4e391ba756706ab54b6978e4a3ff928a13cd0128435aa8a2d5131124ea7a2d6b"
+    },
+    "watchers/JobWatcher.js": {
+      "size": 3218,
+      "sha256": "6d645f3296a0dc6e95b3e5f4b093e0cda19f7e16c8990692232314fc55c4e68e"
+    },
+    "watchers/LogWatcher.d.ts": {
+      "size": 101,
+      "sha256": "4c843b1d1f47b04dc98ff4e77c70324082b1eaeea36a387656640f39aa8e33b9"
+    },
+    "watchers/LogWatcher.js": {
+      "size": 1682,
+      "sha256": "8f56fae11c27026919c883f5aa69a64c0898a09c40bd3ca2d6bdb5a5df47d50f"
+    },
+    "watchers/MailWatcher.d.ts": {
+      "size": 220,
+      "sha256": "82d97e040c1def5d7c7a0617898587b176ddef11678eb5961bb6305652ae29f6"
+    },
+    "watchers/MailWatcher.js": {
+      "size": 1226,
+      "sha256": "382d6ebf6c2007b8f25fc0029c359af2854791612dd1bcdb006c942001bd486a"
+    },
+    "watchers/MiddlewareWatcher.d.ts": {
+      "size": 265,
+      "sha256": "b793df7db674284ee2b406d63cfb3493e2f027ff4a131acf6730256efc1dc9f0"
+    },
+    "watchers/MiddlewareWatcher.js": {
+      "size": 1145,
+      "sha256": "0ffc126f57593679afdc60f5c37ee29d41cff8eb8cb86824a94c727468750c72"
+    },
+    "watchers/ModelWatcher.d.ts": {
+      "size": 291,
+      "sha256": "1c77882b7d83f1aabe402bafb19e8d2d3a69afb1e336846ce009842ad9c735e4"
+    },
+    "watchers/ModelWatcher.js": {
+      "size": 1142,
+      "sha256": "ac16fa35e3f51e5a5fffcdb9c1057335935d3ab0178abe9394e2da8842a96d46"
+    },
+    "watchers/NotificationWatcher.d.ts": {
+      "size": 243,
+      "sha256": "9b1a5196c24ce523f677c88360653d269f8ba14cbf28ad4aeb732f7611fb9294"
+    },
+    "watchers/NotificationWatcher.js": {
+      "size": 1254,
+      "sha256": "3743860c1b8b1c91eff006b2c111c0a9d7c4ac84efc5968edd8fb830a66321c7"
+    },
+    "watchers/QueryWatcher.d.ts": {
+      "size": 103,
+      "sha256": "28f53ebfbbaf011e0eae5bc4cf1a496d7d998adda5b2f3bb8fa06a77a52acc4f"
+    },
+    "watchers/QueryWatcher.js": {
+      "size": 2674,
+      "sha256": "cfce3dce30c8ea0317b4e53bcfb65e2fd9de235af261cbee16888618933b8987"
+    },
+    "watchers/RedisWatcher.d.ts": {
+      "size": 300,
+      "sha256": "22ad070105d663137226843ac7a8ff74f96aed5f20a79529b1973d5378ffff3b"
+    },
+    "watchers/RedisWatcher.js": {
+      "size": 1250,
+      "sha256": "275346fa5c2c1920b3a6b3f7aa99fdb2b4ad4e5237f6718c906ac1d8f570a907"
+    },
+    "watchers/ScheduleWatcher.d.ts": {
+      "size": 297,
+      "sha256": "00a4033c4dbaaac35db0c9171c617980515e25d63a446a6ec1819a47fee110d8"
+    },
+    "watchers/ScheduleWatcher.js": {
+      "size": 1294,
+      "sha256": "c74b0f03e325e9fed019630f30dc434cd95987305d2c09e8cbd5e73f15ef07dc"
+    },
+    "watchers/ViewWatcher.d.ts": {
+      "size": 208,
+      "sha256": "75f352277853b3a1980c95332556aacbf9b438d4595d9071655b1afc82df3bf0"
+    },
+    "watchers/ViewWatcher.js": {
+      "size": 1081,
+      "sha256": "cead371420d111c59655cce113c8dfe56c08367b3ef5e2136e6c407bc0fbe7e8"
+    }
+  }
+}

package/dist/cli-register.d.ts

@@ -0,0 +1,9 @@
+type Registry = {
+    register: (id: string, provider: CliCommandProvider) => void;
+};
+type CliCommandProvider = {
+    getCommand: () => unknown;
+    name?: string;
+};
+export declare function registerTraceCliCommands(registry: Registry): void;
+export {};

package/dist/cli-register.js

@@ -0,0 +1,32 @@
+const commandModule = (await import('@zintrust/core/cli'));
+const getTraceProviders = () => {
+    const { TraceCommands } = commandModule;
+    return [
+        ['trace:prune', TraceCommands.createTracePruneProvider()],
+        ['trace:clear', TraceCommands.createTraceClearProvider()],
+        ['trace:status', TraceCommands.createTraceStatusProvider()],
+        ['migrate:trace', TraceCommands.createTraceMigrateProvider()],
+    ];
+};
+export function registerTraceCliCommands(registry) {
+    for (const [id, provider] of getTraceProviders()) {
+        registry.register(id, provider);
+    }
+}
+const globalWithRegistry = globalThis;
+const globalRegistry = globalWithRegistry.__zintrust_cli_command_registry__ ??
+    (globalWithRegistry.__zintrust_cli_command_registry__ = new Map());
+registerTraceCliCommands({
+    register: (id, provider) => {
+        globalRegistry.set(id, provider);
+    },
+});
+try {
+    const coreCli = (await import('@zintrust/core/cli'));
+    if (coreCli.OptionalCliCommandRegistry !== undefined) {
+        registerTraceCliCommands(coreCli.OptionalCliCommandRegistry);
+    }
+}
+catch {
+    // no-op
+}