@goodandready/dsh-cron 0.3.25 → 0.3.26

package/lib/routes.js

@@ -1,549 +1 @@
-import { readFileSync } from 'node:fs';
-import { handleTaskWebhookRoute } from './api-task-webhook.js';
-import { calculateCostHeatmap } from './timeline.js';
-import { buildAnalyticsDigest, formatDigestMarkdown, sendAnalyticsDigest } from './analytics-digest.js';
-import { listVerifiedRecipes } from './recipes-catalog.js';
-import { randomUUID } from 'node:crypto';
-import { createCronApiHandler } from './api.js';
-import { createMetricsHandler } from './metrics.js';
-import { createExternalApiHandler, EXTERNAL_API_PREFIX } from './external-api.js';
-import { getModelsHandler } from './models-handler.js';
-import { chatStartHandler } from './chat-start.js';
-import { sendJson, rejectCrossOrigin, readBody, parseJsonBody } from './http-utils.js';
-import { recipesByCategory } from './recipes.js';
-import { sendTelegramMessage, createTelegramTaskKeyboard } from './telegram.js';
-import { createKanbanCard } from './integrations.js';
-import { sanitizeSettingsPayload, applySettingsToScope } from './settings.js';
-import { buildTaskGraphModel } from './dag.js';
-
-
-const CLIENT_CSS = readFileSync(new URL('./client.css', import.meta.url), 'utf8');
-const LOCALES_JSON = readFileSync(new URL('./locales.json', import.meta.url), 'utf8');
-
-
-export function registerRoutes(ctx, { store, scheduler, recommendations }) {
-  // Monthly history archives collection route (#391)
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'exact',
-    path: '/dsh-cron/history/archives',
-    handler: (req, res) => {
-      if (req.method !== 'GET') {
-        res.writeHead(405, { 'content-type': 'text/plain; charset=utf-8' });
-        res.end('GET only');
-        return;
-      }
-      res.writeHead(200, {
-        'content-type': 'application/json; charset=utf-8',
-        'cache-control': 'no-store',
-      });
-      const archives = typeof store?.listMonthlyArchives === 'function' ? store.listMonthlyArchives() : [];
-      res.end(JSON.stringify({ ok: true, archives }));
-    }
-  }), 'dsh-cron: /history/archives');
-
-  // Specific monthly history archive route (#391)
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'prefix',
-    path: '/dsh-cron/history/archive/',
-    handler: (req, res) => {
-      if (req.method !== 'GET') {
-        res.writeHead(405, { 'content-type': 'text/plain; charset=utf-8' });
-        res.end('GET only');
-        return;
-      }
-      const url = new URL(req.url, 'http://127.0.0.1');
-      const month = url.pathname.replace(/^\/dsh-cron\/history\/archive\//, '').replace(/\/$/, '');
-      if (!/^\d{4}-\d{2}$/.test(month)) {
-        res.writeHead(400, { 'content-type': 'application/json; charset=utf-8' });
-        res.end(JSON.stringify({ ok: false, error: 'Invalid month format, expected YYYY-MM' }));
-        return;
-      }
-      const archive = typeof store?.getMonthlyArchive === 'function' ? store.getMonthlyArchive(month) : null;
-      if (!archive) {
-        res.writeHead(404, { 'content-type': 'application/json; charset=utf-8' });
-        res.end(JSON.stringify({ ok: false, error: `Archive for month "${month}" not found` }));
-        return;
-      }
-      res.writeHead(200, {
-        'content-type': 'application/json; charset=utf-8',
-        'cache-control': 'public, max-age=3600',
-      });
-      res.end(JSON.stringify({ ok: true, month, archive }));
-    }
-  }), 'dsh-cron: /history/archive/:month');
-
-  // Health probe route (#384)
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'exact',
-    path: '/dsh-cron/health',
-    handler: (req, res) => {
-      if (req.method !== 'GET') {
-        res.writeHead(405, { 'content-type': 'text/plain; charset=utf-8' });
-        res.end('GET only');
-        return;
-      }
-      res.writeHead(200, {
-        'content-type': 'application/json; charset=utf-8',
-        'cache-control': 'no-store'
-      });
-      const tasks = typeof store?.list === 'function' ? store.list().length : 0;
-      res.end(JSON.stringify({
-        status: 'ok',
-        plugin: '@goodandready/dsh-cron',
-        tasks,
-        uptimeSec: Math.floor(process.uptime()),
-      }));
-    }
-  }), 'dsh-cron: /health');
-
-  // Client locales route (#374)
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'exact',
-    path: '/dsh-cron/locales.json',
-    handler: (req, res) => {
-      if (req.method !== 'GET') {
-        res.writeHead(405, { 'content-type': 'text/plain; charset=utf-8' });
-        res.end('GET only');
-        return;
-      }
-      res.writeHead(200, {
-        'content-type': 'application/json; charset=utf-8',
-        'cache-control': 'public, max-age=300'
-      });
-      res.end(LOCALES_JSON);
-    }
-  }), 'dsh-cron: /locales.json');
-
-  // Client CSS stylesheet route (#374)
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'exact',
-    path: '/dsh-cron/client.css',
-    handler: (req, res) => {
-      if (req.method !== 'GET') {
-        res.writeHead(405, { 'content-type': 'text/plain; charset=utf-8' });
-        res.end('GET only');
-        return;
-      }
-      res.writeHead(200, {
-        'content-type': 'text/css; charset=utf-8',
-        'cache-control': 'public, max-age=300'
-      });
-      res.end(CLIENT_CSS);
-    }
-  }), 'dsh-cron: /client.css');
-
-  // handler per route family; registered WITHOUT the trailing slash (#96)
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'prefix',
-    path: '/dsh-cron/tasks',
-    handler: createCronApiHandler(store, scheduler, { recommendations, ctx })
-  }), 'dsh-cron: /tasks[...]');
-
-  // Alias route /dsh-cron/action/:id/:action for backward compatibility (#66)
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'prefix',
-    path: '/dsh-cron/action',
-    handler: createCronApiHandler(store, scheduler, { ctx })
-  }), 'dsh-cron: /action/:id/:action');
-
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'prefix',
-    path: '/dsh-cron/telegram',
-    handler: createCronApiHandler(store, scheduler, { ctx })
-  }), 'dsh-cron: /telegram[...]');
-
-  // Incoming HTTP Webhook triggers (#348)
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'prefix',
-    path: '/dsh-cron/webhook',
-    handler: (req, res) => handleTaskWebhookRoute({ store, scheduler, req, res })
-  }), 'dsh-cron: /webhook[...]');
-
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'prefix',
-    path: '/dsh-cron/heartbeat-ping',
-    handler: createCronApiHandler(store, scheduler, { ctx })
-  }), 'dsh-cron: /heartbeat-ping[...]');
-
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'prefix',
-    path: '/dsh-cron/schedule',
-    handler: createCronApiHandler(store, scheduler, { ctx })
-  }), 'dsh-cron: /schedule[...]');
-
-
-  // Chain retry from failed step (#319)
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'prefix',
-    path: '/dsh-cron/chains',
-    handler: (req, res) => handleChainRoutes(store, scheduler, req, res, ctx)
-  }), 'dsh-cron: /chains[...]');
-
-  // Run artifacts listing, download and safe preview (#321)
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'prefix',
-    path: '/dsh-cron/runs',
-    handler: (req, res) => handleRunArtifactRoutes(store, req, res, ctx)
-  }), 'dsh-cron: /runs[...]');
-
-  // GET /dsh-cron/metrics (#53) — Prometheus text exposition
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'exact',
-    path: '/dsh-cron/metrics',
-    handler: createMetricsHandler({ store, scheduler })
-  }), 'dsh-cron: /metrics');
-
-  // External REST API under /dsh-cron/api/* (#54, ADR-0001): the only surface
-  // guarded by a bearer token, so CI and host automation can drive the
-  // scheduler without a browser session. The token is read per request, so a
-  // settings change applies without a restart.
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'prefix',
-    path: EXTERNAL_API_PREFIX,
-    handler: createExternalApiHandler({
-      store,
-      scheduler,
-      getToken: () => store.getSettings().apiToken || ''
-    })
-  }), 'dsh-cron: /api[...]');
-
-  // GET /dsh-cron/models
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'exact',
-    path: '/dsh-cron/models',
-    handler: async (req, res) => {
-      const settings = store && typeof store.getSettings === 'function' ? store.getSettings() : {};
-      const apiToken = settings.apiToken;
-      if (rejectCrossOrigin(req, res, { apiToken, ctx })) return;
-      await getModelsHandler(ctx, req, res, sendJson);
-    }
-  }), 'dsh-cron: /models');
-
-  // POST /dsh-cron/chat/start
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'exact',
-    path: '/dsh-cron/chat/start',
-    handler: async (req, res) => {
-      if (req.method === 'POST' && rejectCrossOrigin(req, res, { ctx })) return;
-      await chatStartHandler(ctx, req, res, parseJsonBody, sendJson, randomUUID);
-    }
-  }), 'dsh-cron: /chat/start');
-
-  // Analytics digest routes (#330)
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'prefix',
-    path: '/dsh-cron/analytics',
-    handler: async (req, res) => {
-      try {
-        const settings = store && typeof store.getSettings === 'function' ? store.getSettings() : {};
-        const apiToken = settings.apiToken;
-        if (rejectCrossOrigin(req, res, { apiToken, ctx })) return;
-
-        const url = new URL(req.url, 'http://127.0.0.1');
-        const path = url.pathname;
-
-        if (req.method === 'GET') {
-          if (path === '/dsh-cron/analytics/heatmap') {
-            const modelFilter = url.searchParams.get('model') || null;
-            const providerFilter = url.searchParams.get('provider') || null;
-            const costLedger = store.costLedger || [];
-            let history = [];
-            if (store.history) {
-              if (typeof store.history.values === 'function') {
-                for (const runs of store.history.values()) {
-                  if (Array.isArray(runs)) history.push(...runs);
-                }
-              } else if (typeof store.history === 'object') {
-                for (const runs of Object.values(store.history)) {
-                  if (Array.isArray(runs)) history.push(...runs);
-                }
-              }
-            }
-            const heatmap = calculateCostHeatmap({ costLedger, history, modelFilter, providerFilter });
-            sendJson(res, 200, { ok: true, heatmap });
-            return;
-          }
-          const days = parseInt(url.searchParams.get('days') || '7', 10);
-          const tasks = store.list ? store.list() : Object.values(store.tasks || {});
-          let history = [];
-          if (store.history) {
-            if (typeof store.history.values === 'function') {
-              for (const runs of store.history.values()) {
-                if (Array.isArray(runs)) history.push(...runs);
-              }
-            } else if (typeof store.history === 'object') {
-              for (const runs of Object.values(store.history)) {
-                if (Array.isArray(runs)) history.push(...runs);
-              }
-            }
-          }
-          const costLedger = store.costLedger || [];
-          const digest = buildAnalyticsDigest({ tasks, history, costLedger, periodDays: days });
-          const markdown = formatDigestMarkdown(digest);
-          sendJson(res, 200, { ok: true, digest, markdown });
-          return;
-        }
-
-        if (req.method === 'POST') {
-          if (rejectCrossOrigin(req, res, { ctx })) return;
-          const { body } = await readBody(req, res);
-          const days = parseInt(body?.days || url.searchParams.get('days') || '7', 10);
-          const tasks = store.list ? store.list() : Object.values(store.tasks || {});
-          let history = [];
-          if (store.history) {
-            if (typeof store.history.values === 'function') {
-              for (const runs of store.history.values()) {
-                if (Array.isArray(runs)) history.push(...runs);
-              }
-            } else if (typeof store.history === 'object') {
-              for (const runs of Object.values(store.history)) {
-                if (Array.isArray(runs)) history.push(...runs);
-              }
-            }
-          }
-          const costLedger = store.costLedger || [];
-          const digest = buildAnalyticsDigest({ tasks, history, costLedger, periodDays: days });
-          const settings = store.getSettings ? store.getSettings() : {};
-          const deliveryConfig = {
-            telegram: body?.telegram !== false && Boolean(settings.botToken && settings.chatId),
-            webhookUrl: body?.webhookUrl || settings.webhookUrl,
-          };
-          const channels = {
-            sendTelegram: async (text) => sendTelegramMessage({ botToken: settings.botToken, chatId: settings.chatId, text }),
-            sendWebhook: async (targetUrl, payload) => {
-              const r = await fetch(targetUrl, {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify(payload),
-              });
-              return { ok: r.ok, status: r.status };
-            },
-          };
-          const delivery = await sendAnalyticsDigest({ digest, channels, deliveryConfig });
-          sendJson(res, 200, { ok: true, digest, delivery });
-          return;
-        }
-
-        sendJson(res, 405, { ok: false, error: 'Method not allowed' });
-      } catch (err) {
-        sendJson(res, 500, { ok: false, error: err.message });
-      }
-    }
-  }), 'dsh-cron: /analytics');
-
-  // GET /dsh-cron/recipes (#48): the built-in recipe catalog.
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'exact',
-    path: '/dsh-cron/recipes',
-    handler: async (req, res) => {
-      try {
-        if ((req.method || 'GET') !== 'GET') {
-          sendJson(res, 405, { ok: false, error: 'Method not allowed' });
-          return;
-        }
-        const settings = store.getSettings ? store.getSettings() : {};
-        const apiToken = settings.apiToken;
-        if (rejectCrossOrigin(req, res, { apiToken, ctx })) return;
-        const categories = recipesByCategory();
-        const recipes = listVerifiedRecipes(settings);
-        sendJson(res, 200, { ok: true, categories, recipes });
-      } catch (err) {
-        sendJson(res, err.statusCode || 500, { ok: false, error: err.message });
-      }
-    }
-  }), 'dsh-cron: /recipes');
-
-  // GET /dsh-cron/heartbeat (#16): liveness probe for external monitors.
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'exact',
-    path: '/dsh-cron/heartbeat',
-    handler: async (req, res) => {
-      try {
-        if ((req.method || 'GET') !== 'GET') {
-          sendJson(res, 405, { ok: false, error: 'Method not allowed' });
-          return;
-        }
-        const settings = store.getSettings ? store.getSettings() : {};
-        const apiToken = settings.apiToken;
-        if (rejectCrossOrigin(req, res, { apiToken, ctx })) return;
-
-        const tasks = store.list({ status: 'active' });
-        const lastRuns = tasks.map((t) => t.lastRunAt || 0);
-        sendJson(res, 200, {
-          ok: true,
-          activeTasks: tasks.length,
-          running: scheduler.runningCount(),
-          lastRunAt: lastRuns.length ? Math.max(...lastRuns) : null,
-          serverTime: Date.now(),
-        });
-      } catch (err) {
-        sendJson(res, 500, { ok: false, error: err.message });
-      }
-    }
-  }), 'dsh-cron: /heartbeat');
-
-  // POST /dsh-cron/telegram/test
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'exact',
-    path: '/dsh-cron/telegram/test',
-    handler: async (req, res) => {
-      try {
-        if (req.method !== 'POST') {
-          sendJson(res, 405, { ok: false, error: 'Method not allowed' });
-          return;
-        }
-        if (rejectCrossOrigin(req, res, { ctx })) return;
-        const { body, error } = await readBody(req, res);
-        if (error) return;
-        const settings = store.getSettings();
-        const botToken = body.botToken || settings.botToken;
-        const chatId = body.chatId || settings.chatId;
-
-        if (!botToken || !chatId) {
-          sendJson(res, 400, { ok: false, error: 'botToken or chatId is not configured' });
-          return;
-        }
-
-        const text = `🔔 *dsh-cron test notification*\n\nConnection between DSH Cron and Telegram is working! Checked at: \`${new Date().toISOString()}\``;
-        const replyMarkup = createTelegramTaskKeyboard(undefined, undefined);
-        await sendTelegramMessage({ botToken, chatId, text, replyMarkup });
-        sendJson(res, 200, { ok: true, message: 'Test message sent successfully' });
-      } catch (err) {
-        sendJson(res, 500, { ok: false, error: err.message });
-      }
-    }
-  }), 'dsh-cron: /telegram/test');
-
-  // POST /dsh-cron/kanban/test
-  ctx.effect(() => ctx.webServer.register({
-    kind: 'exact',
-    path: '/dsh-cron/kanban/test',
-    handler: async (req, res) => {
-      try {
-        if (req.method !== 'POST') {
-          sendJson(res, 405, { ok: false, error: 'Method not allowed' });
-          return;
-        }
-        if (rejectCrossOrigin(req, res, { ctx })) return;
-        const { body, error } = await readBody(req, res);
-        if (error) return;
-        const settings = store.getSettings();
-        const kanbanBaseUrl = body.kanbanBaseUrl || settings.kanbanBaseUrl || 'http://127.0.0.1:3000';
-
-        const result = await createKanbanCard({
-          title: '[Test] dsh-cron -> Kanban connectivity check',
-          body: `Test card created automatically by the \`dsh-cron\` module at ${new Date().toISOString()}.`,
-          board: 'main',
-          column: 'backlog',
-          labels: ['cron', 'test'],
-          kanbanBaseUrl
-        });
-
-        if (result.success) {
-          sendJson(res, 200, { ok: true, task: result.task });
-        } else {
-          sendJson(res, 500, { ok: false, error: result.error });
-        }
-      } catch (err) {
-        sendJson(res, 500, { ok: false, error: err.message });
-      }
-    }
-  }), 'dsh-cron: /kanban/test');
-}
-
-
-/**
- * Handler for chain step retries (#319)
- */
-export async function handleChainRoutes(store, scheduler, req, res, ctx) {
-  const settings = store && typeof store.getSettings === 'function' ? store.getSettings() : {};
-  const apiToken = settings.apiToken;
-  if (rejectCrossOrigin(req, res, { apiToken, ctx })) return;
-  const url = new URL(req.url, 'http://localhost');
-
-  // GET /dsh-cron/chains/:chainRunId (#334)
-  const getMatch = url.pathname.match(/^\/dsh-cron\/chains\/([^\/]+)$/);
-  if (getMatch && req.method === 'GET') {
-    const chainRunId = getMatch[1];
-    const snapshots = store.chainCheckpointManager ? store.chainCheckpointManager.getChainSnapshots(chainRunId) : [];
-    const relevantTasks = [];
-    const stepIds = new Set(snapshots.map((s) => s.stepTaskId));
-    if (store.tasks) {
-      for (const t of Object.values(store.tasks)) {
-        if (t && (stepIds.has(t.id) || t.onSuccess || t.onFailure || t.dependsOn)) {
-          relevantTasks.push(t);
-        }
-      }
-    }
-    const graph = buildTaskGraphModel(relevantTasks, snapshots);
-    sendJson(res, 200, { ok: true, chainRunId, snapshots, graph });
-    return;
-  }
-
-  // POST /dsh-cron/chains/:chainRunId/retry-from/:stepTaskId (#319, #328)
-  const m = url.pathname.match(/^\/dsh-cron\/chains\/([^\/]+)\/retry-from\/([^\/]+)$/);
-  if (!m) {
-    sendJson(res, 404, { ok: false, error: 'Route not found' });
-    return;
-  }
-  if (req.method !== 'POST') {
-    sendJson(res, 405, { ok: false, error: 'Method not allowed' });
-    return;
-  }
-  const [, chainRunId, stepTaskId] = m;
-  const result = await store.chainCheckpointManager.retryChainFromStep(scheduler, chainRunId, stepTaskId);
-  if (!result.ok) {
-    sendJson(res, 400, result);
-    return;
-  }
-  sendJson(res, 200, result);
-}
-
-/**
- * Handler for run artifacts (#321)
- */
-export async function handleRunArtifactRoutes(store, req, res, ctx) {
-  const url = new URL(req.url, 'http://localhost');
-  const m = url.pathname.match(/^\/dsh-cron\/runs\/([^\/]+)\/artifacts(?:\/([^\/]+)(?:\/(preview))?)?$/);
-  if (!m) {
-    sendJson(res, 404, { ok: false, error: 'Route not found' });
-    return;
-  }
-  if (req.method !== 'GET') {
-    sendJson(res, 405, { ok: false, error: 'Method not allowed' });
-    return;
-  }
-  const settings = store && typeof store.getSettings === 'function' ? store.getSettings() : {};
-  const apiToken = settings.apiToken;
-  if (rejectCrossOrigin(req, res, { apiToken, ctx })) return;
-
-  const [, runId, artifactId, action] = m;
-  if (!artifactId) {
-    const artifacts = store.getArtifactsForRun(runId);
-    sendJson(res, 200, { ok: true, runId, artifacts });
-    return;
-  }
-  const artifacts = store.getArtifactsForRun(runId);
-  const record = artifacts.find((a) => a.id === artifactId);
-  if (!record) {
-    sendJson(res, 404, { ok: false, error: 'Artifact record not found' });
-    return;
-  }
-  if (action === 'preview') {
-    const preview = store.artifactManager.generatePreview(artifactId, record.name);
-    sendJson(res, preview.ok ? 200 : 404, preview);
-    return;
-  }
-  const buf = store.artifactManager.readArtifact(artifactId, record.name);
-  if (!buf) {
-    sendJson(res, 404, { ok: false, error: 'Artifact file missing from disk (expired or removed)' });
-    return;
-  }
-  res.writeHead(200, {
-    'Content-Type': record.mimeType || 'application/octet-stream',
-    'Content-Disposition': `attachment; filename="${encodeURIComponent(record.name)}"`,
-    'Content-Length': buf.length,
-    'X-Content-Type-Options': 'nosniff',
-  });
-  res.end(buf);
-}
+export * from './routes/routes.js';