@softize/opus 8.6.6

package/src/core/schedules.ts

@@ -0,0 +1,41 @@
+/**
+ * tbdlib — `defineSchedule` factory + type guards.
+ *
+ * Schedule é a primitiva pra **ação iniciada pelo próprio sistema** — sem
+ * trigger externo (HTTP, evento, AI). Usado pra monitoramento, relatórios,
+ * BI, varreduras periódicas.
+ *
+ * Pareado com Action e Reaction:
+ *   - Action   = humano/AI/integração dispara
+ *   - Reaction = evento dispara
+ *   - Schedule = tempo dispara
+ *
+ * Runtime registra no SchedulerAdapter no `start()`. Quando o tempo
+ * configurado bate, o scheduler chama `runtime.execute(action, input, ctx)`
+ * com `ctx.provenance = { kind: 'schedule', scheduleName }`.
+ *
+ * Ver §16 do protocolo.
+ */
+
+import type { ScheduleDef } from './types.ts'
+
+/**
+ * Constrói uma `ScheduleDef`. Identity function pra inferência.
+ */
+export function defineSchedule(spec: ScheduleDef): ScheduleDef {
+  return spec
+}
+
+/**
+ * Type guard pra distinguir schedules de actions/reactions quando
+ * registrados misturados em `runtime.register([...])`.
+ */
+export function isSchedule(value: unknown): value is ScheduleDef {
+  if (typeof value !== 'object' || value === null) return false
+  const c = value as { name?: unknown; cron?: unknown; every?: unknown; action?: unknown }
+  return (
+    typeof c.name === 'string' &&
+    (typeof c.cron === 'string' || typeof c.every === 'string') &&
+    typeof c.action === 'string'
+  )
+}