@happyvertical/smrt-reports 0.36.5

package/dist/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sources":["../src/scheduler.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { EventEmitter } from 'node:events';\nimport {\n  field,\n  GlobalInterceptors,\n  type InterceptorContext,\n  ObjectRegistry,\n  SmrtObject,\n  smrt,\n} from '@happyvertical/smrt-core';\nimport {\n  backgroundEligible,\n  getNextCronDate,\n  type SmrtJob,\n  SmrtJobCollection,\n  validateCronExpression,\n} from '@happyvertical/smrt-jobs';\nimport {\n  getTenantId,\n  TenantScoped,\n  tenantId,\n} from '@happyvertical/smrt-tenancy';\nimport type { DatabaseInterface, SqlAdapterType } from '@happyvertical/sql';\nimport { buildReportDefinition } from './compiler.js';\nimport { refreshReport } from './refresh.js';\nimport {\n  assertReportTablesReady,\n  REPORT_SCHEDULER_TABLES,\n  REPORT_SCHEDULES_TABLE,\n  scopeKeyForTenant,\n} from './state.js';\nimport type {\n  ReportDefinition,\n  ReportRefreshMode,\n  ReportRefreshTrigger,\n  ReportSource,\n} from './types.js';\n\ntype ReportCtor = new (...args: any[]) => SmrtObject;\n\nexport interface ReportRefreshJobArgs {\n  reportClass?: string;\n  mode?: ReportRefreshMode;\n  trigger?: ReportRefreshTrigger;\n  tenantId?: string | null;\n  tenantIds?: string[];\n  scheduleId?: string;\n  adapterType?: SqlAdapterType;\n  changedRows?: Record<string, unknown>[];\n  _scheduleId?: string;\n}\n\nexport interface EnqueueReportRefreshOptions extends ReportRefreshJobArgs {\n  report?: ReportCtor;\n  reportClass: string;\n  db: DatabaseInterface;\n  queue?: string;\n  priority?: number;\n  timeout?: number;\n  maxAttempts?: number;\n  tenantJobCap?: number;\n}\n\nexport interface EnsureReportSchedulesOptions {\n  db: DatabaseInterface;\n  reports: ReportCtor[];\n  tenantIds?: string[];\n  queue?: string;\n  priority?: number;\n  timeout?: number;\n}\n\nexport interface ReportScheduleRunnerConfig {\n  id?: string;\n  pollInterval?: number;\n  batchSize?: number;\n}\n\nexport interface ReportScheduleInfo {\n  id: string;\n  reportClass: string;\n  tenantId: string | null;\n  cron: string;\n  mode: ReportRefreshMode;\n}\n\nexport interface ReportScheduleRunnerEvents {\n  'schedule:triggered': (schedule: ReportScheduleInfo) => void;\n  'schedule:error': (schedule: ReportScheduleInfo, error: Error) => void;\n  'schedule:completed': (scheduleId: string) => void;\n  'schedule:failed': (scheduleId: string, error: string) => void;\n  'runner:started': () => void;\n  'runner:stopped': () => void;\n  'runner:error': (error: Error) => void;\n}\n\nexport interface ReportRefreshInterceptorOptions {\n  db: DatabaseInterface;\n  reports: ReportCtor[];\n  enqueue?: boolean;\n  queue?: string;\n  priority?: number;\n  timeout?: number;\n  tenantJobCap?: number;\n  name?: string;\n}\n\nconst INTERNAL_SURFACE = {\n  api: false,\n  cli: {\n    include: ['list', 'get'],\n    skipApiCheck: true,\n    http: false,\n  },\n  mcp: false,\n};\n\nfunction stableUuid(values: unknown[]): string {\n  const hash = createHash('sha256')\n    .update(JSON.stringify(values))\n    .digest('hex');\n  const variant = ((Number.parseInt(hash[16], 16) & 0x3) | 0x8).toString(16);\n  return [\n    hash.slice(0, 8),\n    hash.slice(8, 12),\n    `4${hash.slice(13, 16)}`,\n    `${variant}${hash.slice(17, 20)}`,\n    hash.slice(20, 32),\n  ].join('-');\n}\n\nfunction canonicalClassName(reportCtor: ReportCtor): string {\n  const registered =\n    ObjectRegistry.getClassByConstructor(reportCtor) ??\n    ObjectRegistry.getClass(reportCtor.name);\n  return registered?.qualifiedName ?? registered?.name ?? reportCtor.name;\n}\n\nfunction resolveReportClass(name: string): ReportCtor {\n  const registered =\n    ObjectRegistry.getClassByQualifiedName(name) ??\n    ObjectRegistry.getClass(name);\n  if (!registered) {\n    throw new Error(`Unknown report class: ${name}`);\n  }\n  return registered.constructor as unknown as ReportCtor;\n}\n\nfunction reportSourceName(source: ReportSource): string {\n  if (typeof source === 'string') return source;\n  return source.name;\n}\n\nfunction sourceMatches(\n  definition: ReportDefinition,\n  instance: SmrtObject,\n  context: InterceptorContext,\n): boolean {\n  const configured = definition.refresh?.onChange;\n  if (!configured || configured.length === 0) return false;\n\n  const eventNames = new Set<string>([\n    context.className,\n    instance.constructor.name,\n  ]);\n  const registered = ObjectRegistry.getClassByConstructor(\n    instance.constructor as ReportCtor,\n  );\n  if (registered?.qualifiedName) eventNames.add(registered.qualifiedName);\n  if (registered?.name) eventNames.add(registered.name);\n\n  for (const source of configured) {\n    const name = reportSourceName(source);\n    const registeredSource =\n      ObjectRegistry.getClassByQualifiedName(name) ??\n      ObjectRegistry.getClass(name);\n    if (\n      eventNames.has(name) ||\n      (registeredSource?.name && eventNames.has(registeredSource.name)) ||\n      (registeredSource?.qualifiedName &&\n        eventNames.has(registeredSource.qualifiedName))\n    ) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nfunction tenantIdFromInstance(instance: SmrtObject): string | null {\n  const value = (instance as unknown as { tenantId?: unknown }).tenantId;\n  return typeof value === 'string' && value.length > 0\n    ? value\n    : (getTenantId() ?? null);\n}\n\nfunction changedRowSnapshot(instance: SmrtObject): Record<string, unknown> {\n  const serializable = instance.toJSON();\n  return serializable && typeof serializable === 'object'\n    ? (serializable as Record<string, unknown>)\n    : {};\n}\n\n@TenantScoped({ mode: 'optional' })\n@smrt({\n  tableName: '_smrt_report_refresh_tasks',\n  ...INTERNAL_SURFACE,\n})\nexport class SmrtReportRefreshTask extends SmrtObject {\n  @tenantId({ nullable: true })\n  tenantId: string | null = null;\n\n  @field({ type: 'text', required: true })\n  reportClass: string = '';\n\n  @field({ type: 'text', required: true })\n  mode: ReportRefreshMode = 'incremental';\n\n  @field({ type: 'text', required: true })\n  trigger: ReportRefreshTrigger = 'job';\n\n  @field({ type: 'json' })\n  args: ReportRefreshJobArgs = {};\n\n  @backgroundEligible()\n  async run(args: ReportRefreshJobArgs = {}): Promise<unknown> {\n    const reportClass = args.reportClass || this.reportClass;\n    if (!reportClass) {\n      throw new Error('Report refresh job requires reportClass');\n    }\n\n    const reportCtor = resolveReportClass(reportClass);\n    return refreshReport(reportCtor, {\n      db: this.db,\n      mode: args.mode ?? this.mode,\n      trigger: args.trigger ?? this.trigger,\n      tenantId: args.tenantId,\n      tenantIds: args.tenantIds,\n      adapterType: args.adapterType,\n      scheduleId: args.scheduleId ?? args._scheduleId,\n      changedRows: args.changedRows,\n    });\n  }\n}\n\nexport async function enqueueReportRefresh(\n  options: EnqueueReportRefreshOptions,\n): Promise<SmrtJob> {\n  await ObjectRegistry.ensureManifestLoaded('SmrtJob');\n  const collection = await SmrtJobCollection.create({ db: options.db });\n  const taskType = canonicalClassName(SmrtReportRefreshTask);\n  const scheduleId = options.scheduleId ?? options._scheduleId;\n\n  return collection.enqueueJob(\n    {\n      tenantId: options.tenantId ?? null,\n      queue: options.queue ?? 'reports',\n      objectType: taskType,\n      objectId: null,\n      method: 'run',\n      args: {\n        reportClass: options.reportClass,\n        mode: options.mode,\n        trigger: options.trigger ?? 'job',\n        tenantId: options.tenantId,\n        tenantIds: options.tenantIds,\n        adapterType: options.adapterType,\n        changedRows: options.changedRows,\n        scheduleId,\n        _scheduleId: scheduleId,\n      },\n      priority: options.priority ?? 70,\n      timeout: options.timeout ?? 3600000,\n      maxAttempts: options.maxAttempts ?? 3,\n    },\n    { tenantJobCap: options.tenantJobCap },\n  );\n}\n\nexport async function ensureReportRefreshSchedules(\n  options: EnsureReportSchedulesOptions,\n): Promise<void> {\n  await assertReportTablesReady(options.db, REPORT_SCHEDULER_TABLES);\n\n  for (const reportCtor of options.reports) {\n    const definition = await buildReportDefinition(reportCtor);\n    const refresh = definition.refresh;\n    if (!refresh || refresh.manual) continue;\n\n    const reportClass = canonicalClassName(reportCtor);\n    const targetTenants = refresh.tenantFanout\n      ? options.tenantIds\n      : [null as string | null];\n    if (\n      refresh.tenantFanout &&\n      (!targetTenants || targetTenants.length === 0)\n    ) {\n      throw new Error(\n        `${definition.reportClassName} refresh.tenantFanout requires tenantIds when creating schedules.`,\n      );\n    }\n\n    const schedules = [\n      refresh.schedule\n        ? {\n            cron: refresh.schedule,\n            mode: refresh.mode ?? 'incremental',\n            trigger: 'schedule' as const,\n          }\n        : null,\n      refresh.fullRebuildSchedule\n        ? {\n            cron: refresh.fullRebuildSchedule,\n            mode: 'rebuild' as const,\n            trigger: 'schedule' as const,\n          }\n        : null,\n    ].filter(Boolean) as Array<{\n      cron: string;\n      mode: ReportRefreshMode;\n      trigger: ReportRefreshTrigger;\n    }>;\n\n    for (const schedule of schedules) {\n      validateCronExpression(schedule.cron);\n      for (const tenantId of targetTenants ?? []) {\n        const scopeKey = scopeKeyForTenant(tenantId);\n        const id = stableUuid([\n          'schedule',\n          reportClass,\n          scopeKey,\n          schedule.cron,\n          schedule.mode,\n        ]);\n        const now = new Date().toISOString();\n        await options.db.upsert(\n          REPORT_SCHEDULES_TABLE,\n          ['report_class', 'scope_key', 'cron', 'mode'],\n          {\n            id,\n            slug: id,\n            context: scopeKey,\n            tenant_id: tenantId,\n            scope_key: scopeKey,\n            report_class: reportClass,\n            cron: schedule.cron,\n            trigger: schedule.trigger,\n            mode: schedule.mode,\n            enabled: true,\n            status: 'active',\n            next_run: getNextCronDate(schedule.cron).toISOString(),\n            last_run: null,\n            last_status: null,\n            last_error: null,\n            run_count: 0,\n            success_count: 0,\n            failure_count: 0,\n            running_count: 0,\n            max_concurrent: 1,\n            queue: options.queue ?? 'reports',\n            priority: options.priority ?? 70,\n            timeout: options.timeout ?? 3600000,\n            created_at: now,\n            updated_at: now,\n          },\n        );\n      }\n    }\n  }\n}\n\nexport class ReportScheduleRunner extends EventEmitter {\n  readonly id: string;\n  private readonly config: Required<ReportScheduleRunnerConfig>;\n  private db: DatabaseInterface | null = null;\n  private running = false;\n  private pollTimer: NodeJS.Timeout | null = null;\n\n  constructor(config: ReportScheduleRunnerConfig = {}) {\n    super();\n    this.config = {\n      id: config.id || `reports_${stableUuid([Date.now()]).slice(0, 8)}`,\n      pollInterval: config.pollInterval ?? 60000,\n      batchSize: config.batchSize ?? 50,\n    };\n    this.id = this.config.id;\n  }\n\n  async initialize(db: DatabaseInterface): Promise<void> {\n    this.db = db;\n    await assertReportTablesReady(db, REPORT_SCHEDULER_TABLES);\n  }\n\n  async start(): Promise<void> {\n    if (this.running) return;\n    if (!this.db) {\n      throw new Error(\n        'ReportScheduleRunner not initialized. Call initialize() first.',\n      );\n    }\n    this.running = true;\n    this.startPolling();\n    this.emit('runner:started');\n  }\n\n  async stop(): Promise<void> {\n    if (!this.running) return;\n    this.running = false;\n    if (this.pollTimer) {\n      clearTimeout(this.pollTimer);\n      this.pollTimer = null;\n    }\n    this.emit('runner:stopped');\n  }\n\n  isRunning(): boolean {\n    return this.running;\n  }\n\n  async handleJobCompletion(\n    scheduleId: string,\n    success: boolean,\n    errorMessage?: string,\n  ): Promise<void> {\n    if (!this.db) return;\n    const now = new Date().toISOString();\n    if (success) {\n      await this.db.query(\n        `UPDATE ${REPORT_SCHEDULES_TABLE}\n            SET running_count = CASE WHEN COALESCE(running_count, 0) > 0 THEN running_count - 1 ELSE 0 END,\n                last_run = ?,\n                last_status = 'success',\n                last_error = NULL,\n                run_count = COALESCE(run_count, 0) + 1,\n                success_count = COALESCE(success_count, 0) + 1,\n                updated_at = ?\n          WHERE id = ?`,\n        now,\n        now,\n        scheduleId,\n      );\n      this.emit('schedule:completed', scheduleId);\n      return;\n    }\n\n    const safeError = errorMessage ?? 'Unknown error';\n    await this.db.query(\n      `UPDATE ${REPORT_SCHEDULES_TABLE}\n          SET running_count = CASE WHEN COALESCE(running_count, 0) > 0 THEN running_count - 1 ELSE 0 END,\n              last_run = ?,\n              last_status = 'failed',\n              last_error = ?,\n              run_count = COALESCE(run_count, 0) + 1,\n              failure_count = COALESCE(failure_count, 0) + 1,\n              updated_at = ?\n        WHERE id = ?`,\n      now,\n      safeError,\n      now,\n      scheduleId,\n    );\n    this.emit('schedule:failed', scheduleId, safeError);\n  }\n\n  private startPolling(): void {\n    const poll = async () => {\n      if (!this.running) return;\n      try {\n        await this.poll();\n      } catch (error) {\n        this.emit('runner:error', error as Error);\n      }\n      if (this.running) {\n        this.pollTimer = setTimeout(poll, this.config.pollInterval);\n        if (typeof this.pollTimer.unref === 'function') {\n          this.pollTimer.unref();\n        }\n      }\n    };\n    poll();\n  }\n\n  async poll(): Promise<void> {\n    if (!this.db) return;\n    const result = await this.db.query(\n      `SELECT * FROM ${REPORT_SCHEDULES_TABLE}\n        WHERE enabled = true\n          AND status = 'active'\n          AND next_run <= ?\n          AND COALESCE(running_count, 0) < COALESCE(max_concurrent, 1)\n        ORDER BY next_run ASC\n        LIMIT ?`,\n      new Date().toISOString(),\n      this.config.batchSize,\n    );\n\n    for (const row of result.rows) {\n      await this.triggerSchedule(row as ReportScheduleRow);\n    }\n  }\n\n  private async triggerSchedule(row: ReportScheduleRow): Promise<void> {\n    if (!this.db) return;\n    const schedule: ReportScheduleInfo = {\n      id: String(row.id),\n      reportClass: String(row.report_class),\n      tenantId:\n        typeof row.tenant_id === 'string' && row.tenant_id.length > 0\n          ? row.tenant_id\n          : null,\n      cron: String(row.cron),\n      mode: (row.mode as ReportRefreshMode) || 'incremental',\n    };\n\n    try {\n      const nextRun = getNextCronDate(schedule.cron);\n      await enqueueReportRefresh({\n        db: this.db,\n        reportClass: schedule.reportClass,\n        mode: schedule.mode,\n        trigger: (row.trigger as ReportRefreshTrigger) || 'schedule',\n        tenantId: schedule.tenantId,\n        scheduleId: schedule.id,\n        queue: String(row.queue || 'reports'),\n        priority: Number(row.priority ?? 70),\n        timeout: Number(row.timeout ?? 3600000),\n      });\n      await this.db.query(\n        `UPDATE ${REPORT_SCHEDULES_TABLE}\n            SET running_count = COALESCE(running_count, 0) + 1,\n                next_run = ?,\n                updated_at = ?\n          WHERE id = ?`,\n        nextRun.toISOString(),\n        new Date().toISOString(),\n        schedule.id,\n      );\n      this.emit('schedule:triggered', schedule);\n    } catch (error) {\n      await this.db.query(\n        `UPDATE ${REPORT_SCHEDULES_TABLE}\n            SET last_error = ?,\n                updated_at = ?\n          WHERE id = ?`,\n        error instanceof Error ? error.message : String(error),\n        new Date().toISOString(),\n        schedule.id,\n      );\n      this.emit('schedule:error', schedule, error as Error);\n    }\n  }\n}\n\ninterface ReportScheduleRow {\n  id: unknown;\n  tenant_id: unknown;\n  report_class: unknown;\n  cron: unknown;\n  trigger: unknown;\n  mode: unknown;\n  queue: unknown;\n  priority: unknown;\n  timeout: unknown;\n}\n\nexport function registerReportRefreshInterceptor(\n  options: ReportRefreshInterceptorOptions,\n): () => boolean {\n  const name = options.name ?? 'smrt-reports-refresh';\n  GlobalInterceptors.register({\n    name,\n    priority: -10,\n    async afterSave(instance, context) {\n      await triggerReportsForInstance(options, instance, context);\n    },\n    async afterDelete(instance, context) {\n      await triggerReportsForInstance(options, instance, context);\n    },\n  });\n  return () => GlobalInterceptors.unregister(name);\n}\n\nasync function triggerReportsForInstance(\n  options: ReportRefreshInterceptorOptions,\n  instance: SmrtObject,\n  context: InterceptorContext,\n): Promise<void> {\n  for (const reportCtor of options.reports) {\n    const definition = await buildReportDefinition(reportCtor);\n    if (definition.refresh?.manual) continue;\n    if (!sourceMatches(definition, instance, context)) continue;\n\n    const mode = definition.refresh?.mode ?? 'incremental';\n    const tenantId = tenantIdFromInstance(instance);\n    const changedRows = [changedRowSnapshot(instance)];\n    if (options.enqueue === false) {\n      await refreshReport(reportCtor, {\n        db: options.db,\n        mode,\n        trigger: 'change',\n        tenantId,\n        changedRows,\n      });\n      continue;\n    }\n\n    await enqueueReportRefresh({\n      db: options.db,\n      reportClass: canonicalClassName(reportCtor),\n      mode,\n      trigger: 'change',\n      tenantId,\n      queue: options.queue,\n      priority: options.priority,\n      timeout: options.timeout,\n      tenantJobCap: options.tenantJobCap,\n      changedRows,\n    });\n  }\n}\n"],"names":["tenantId"],"mappings":"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"}

package/dist/smrt-knowledge.json

@@ -0,0 +1,584 @@
+{
+  "schemaVersion": 1,
+  "generatedAt": "2026-06-26T14:50:49.071Z",
+  "packageName": "@happyvertical/smrt-reports",
+  "packageVersion": "0.36.5",
+  "sourceManifestPath": "dist/manifest.json",
+  "agentDocPath": "AGENTS.md",
+  "sourceHashes": {
+    "manifest": "d900b3fec866546ff0fc51c734d1f2eed3745ee7824e2907f8bf92f60ec03d09",
+    "packageJson": "749901e81a0bdcc9c7916cdeda483bd4e94c0a4bac2e1de051c55e1fbaef5414",
+    "agents": "bf851be60baab2fd98149165885f70c4f4979123ff72bf8f4b43edfae4478e87"
+  },
+  "exports": [
+    ".",
+    "./aggregate",
+    "./compiler",
+    "./decorators",
+    "./manifest",
+    "./manifest.json",
+    "./refresh",
+    "./scheduler",
+    "./state"
+  ],
+  "dependencies": {
+    "@happyvertical/smrt-core": "workspace:*",
+    "@happyvertical/smrt-jobs": "workspace:*",
+    "@happyvertical/smrt-tenancy": "workspace:*",
+    "@happyvertical/sql": "catalog:",
+    "@happyvertical/smrt-vitest": "workspace:*",
+    "@types/node": "25.0.9",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vitest": "^4.0.17"
+  },
+  "smrtDependencies": [
+    "@happyvertical/smrt-core",
+    "@happyvertical/smrt-jobs",
+    "@happyvertical/smrt-tenancy",
+    "@happyvertical/smrt-vitest"
+  ],
+  "sdkDependencies": [
+    "@happyvertical/sql"
+  ],
+  "tags": [],
+  "risks": [],
+  "objects": [
+    {
+      "name": "SmrtReport",
+      "qualifiedName": "@happyvertical/smrt-reports:SmrtReport",
+      "collection": "smrtreports",
+      "packageName": "@happyvertical/smrt-reports",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "refreshedAt",
+          "type": "datetime",
+          "required": false
+        }
+      ],
+      "relationships": [],
+      "methods": [
+        "isStale",
+        "refresh"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "SmrtReportCollection",
+      "qualifiedName": "@happyvertical/smrt-reports:SmrtReportCollection",
+      "collection": "smrtreports",
+      "packageName": "@happyvertical/smrt-reports",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [
+        "get",
+        "list",
+        "refresh"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "SmrtReportRefreshTask",
+      "qualifiedName": "@happyvertical/smrt-reports:SmrtReportRefreshTask",
+      "collection": "smrtreportrefreshtasks",
+      "tableName": "_smrt_report_refresh_tasks",
+      "packageName": "@happyvertical/smrt-reports",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": false,
+          "columnType": "UUID"
+        },
+        {
+          "name": "reportClass",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "mode",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "trigger",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "args",
+          "type": "json",
+          "required": false,
+          "columnType": "JSON"
+        }
+      ],
+      "relationships": [],
+      "methods": [
+        "run"
+      ],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "SmrtReportRun",
+      "qualifiedName": "@happyvertical/smrt-reports:SmrtReportRun",
+      "collection": "smrtreportruns",
+      "tableName": "_smrt_report_runs",
+      "packageName": "@happyvertical/smrt-reports",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": false,
+          "columnType": "UUID"
+        },
+        {
+          "name": "scopeKey",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "reportClass",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "sourceClass",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "mode",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "trigger",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "status",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "startedAt",
+          "type": "datetime",
+          "required": true,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "completedAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "rowCount",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER"
+        },
+        {
+          "name": "changedGroupCount",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER"
+        },
+        {
+          "name": "watermarkBefore",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "watermarkAfter",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "error",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "metadata",
+          "type": "json",
+          "required": false,
+          "columnType": "JSON"
+        }
+      ],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "SmrtReportRunCollection",
+      "qualifiedName": "@happyvertical/smrt-reports:SmrtReportRunCollection",
+      "collection": "smrtreportruns",
+      "tableName": "_smrt_report_runs",
+      "packageName": "@happyvertical/smrt-reports",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "SmrtReportWatermark",
+      "qualifiedName": "@happyvertical/smrt-reports:SmrtReportWatermark",
+      "collection": "smrtreportwatermarks",
+      "tableName": "_smrt_report_watermarks",
+      "packageName": "@happyvertical/smrt-reports",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": false,
+          "columnType": "UUID"
+        },
+        {
+          "name": "scopeKey",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "reportClass",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "sourceClass",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "watermarkColumn",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "watermarkValue",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "lastRunId",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        }
+      ],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "SmrtReportWatermarkCollection",
+      "qualifiedName": "@happyvertical/smrt-reports:SmrtReportWatermarkCollection",
+      "collection": "smrtreportwatermarks",
+      "tableName": "_smrt_report_watermarks",
+      "packageName": "@happyvertical/smrt-reports",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "SmrtReportLock",
+      "qualifiedName": "@happyvertical/smrt-reports:SmrtReportLock",
+      "collection": "smrtreportlocks",
+      "tableName": "_smrt_report_locks",
+      "packageName": "@happyvertical/smrt-reports",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": false,
+          "columnType": "UUID"
+        },
+        {
+          "name": "scopeKey",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "reportClass",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "ownerId",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "acquiredAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "heartbeatAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "expiresAt",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        }
+      ],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "SmrtReportLockCollection",
+      "qualifiedName": "@happyvertical/smrt-reports:SmrtReportLockCollection",
+      "collection": "smrtreportlocks",
+      "tableName": "_smrt_report_locks",
+      "packageName": "@happyvertical/smrt-reports",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "SmrtReportSchedule",
+      "qualifiedName": "@happyvertical/smrt-reports:SmrtReportSchedule",
+      "collection": "smrtreportschedules",
+      "tableName": "_smrt_report_schedules",
+      "packageName": "@happyvertical/smrt-reports",
+      "extends": "SmrtObject",
+      "fields": [
+        {
+          "name": "tenantId",
+          "type": "text",
+          "required": false,
+          "columnType": "UUID"
+        },
+        {
+          "name": "scopeKey",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "reportClass",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "cron",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "trigger",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "mode",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "enabled",
+          "type": "boolean",
+          "required": true,
+          "columnType": "BOOLEAN"
+        },
+        {
+          "name": "status",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "nextRun",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "lastRun",
+          "type": "datetime",
+          "required": false,
+          "columnType": "TIMESTAMP"
+        },
+        {
+          "name": "lastStatus",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "lastError",
+          "type": "text",
+          "required": false,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "runCount",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER"
+        },
+        {
+          "name": "successCount",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER"
+        },
+        {
+          "name": "failureCount",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER"
+        },
+        {
+          "name": "runningCount",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER"
+        },
+        {
+          "name": "maxConcurrent",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER"
+        },
+        {
+          "name": "queue",
+          "type": "text",
+          "required": true,
+          "columnType": "TEXT"
+        },
+        {
+          "name": "priority",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER"
+        },
+        {
+          "name": "timeout",
+          "type": "integer",
+          "required": true,
+          "columnType": "INTEGER"
+        }
+      ],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    },
+    {
+      "name": "SmrtReportScheduleCollection",
+      "qualifiedName": "@happyvertical/smrt-reports:SmrtReportScheduleCollection",
+      "collection": "smrtreportschedules",
+      "tableName": "_smrt_report_schedules",
+      "packageName": "@happyvertical/smrt-reports",
+      "extends": "SmrtCollection",
+      "fields": [],
+      "relationships": [],
+      "methods": [],
+      "surfaces": [],
+      "relationshipFeatures": [
+        "uuidColumns"
+      ],
+      "tags": [],
+      "risks": []
+    }
+  ],
+  "surfaces": [],
+  "prompts": [],
+  "relationshipsV2": {
+    "foreignKeyFields": 0,
+    "crossPackageRefFields": 0,
+    "junctionCollections": 0,
+    "hierarchicalObjects": 0,
+    "polymorphicAssociations": 0,
+    "uuidColumns": 14
+  },
+  "agentDoc": "# @happyvertical/smrt-reports\n\nMaterialized aggregate report models for SMRT.\n\n## Key Pieces\n\n| Module | Purpose |\n| --- | --- |\n| `SmrtReport` | Abstract report row base with `refreshedAt`, `isStale()`, and manual `refresh()` |\n| decorators | `@report`, grouping decorators, time buckets, and aggregate measure decorators |\n| compiler | Pure `ReportDefinition -> AggregateSpec` compiler and ObjectRegistry adapter |\n| aggregate | Compatibility re-export of the SDK aggregate query builder |\n| refresh | Rebuild and incremental refresh engine with run tracking, watermarks, locks, and tenant scoping |\n| state | Internal `_smrt_report_*` system models for runs, watermarks, locks, schedules, and refresh tasks |\n| scheduler | Cron schedule runner, durable refresh job enqueueing, and `onChange` interceptor registration |\n\n## Conventions\n\n- Report cache tables are normal `@smrt()` tables. Runtime refresh must not create schema.\n- Store report metadata under field `_meta.__report`; scanner and runtime decorators must stay aligned.\n- Keep SQL generation portable. Use the SDK `buildAggregate()`/`bucketExpr()` helpers for time buckets and `$N` placeholders.\n- Do not add a local aggregate SQL builder here; the implementation lives in `@happyvertical/sql`.\n- Refresh runtime tables are schema-managed. Runtime refresh must fail clearly when `_smrt_report_runs`, `_smrt_report_watermarks`, or `_smrt_report_locks` have not been migrated.\n- Incremental refresh requires a source watermark column (default `updatedAt`) and soft-delete column (default `deletedAt`); it recomputes affected groups and deletes empty report groups instead of applying aggregate deltas.\n- Raw aggregate refreshes must explicitly filter `tenant_id`; the tenancy interceptor only protects normal collection reads.\n- Scheduled/on-change refreshes enqueue `SmrtReportRefreshTask.run()` through `@happyvertical/smrt-jobs`; do not add a separate report queue.\n"
+}