@cat-factory/node-server 0.6.0

package/dist/server.js

@@ -0,0 +1,138 @@
+import { serve } from '@hono/node-server';
+import { handleError, logger, mountAuthGate, registerCoreControllers, resolveCorsOrigin, } from '@cat-factory/server';
+import { Hono } from 'hono';
+import { cors } from 'hono/cors';
+import { PgBoss } from 'pg-boss';
+import { buildNodeContainer } from './container.js';
+import { createDbClient } from './db/client.js';
+import { migrate } from './db/migrate.js';
+import { executionRuntime } from './execution/config.js';
+import { startDecisionTimeoutWorker, startExecutionWorker, startStaleRunSweeper, } from './execution/pgBossRunner.js';
+import { startBootstrapWorker } from './execution/bootstrapRunner.js';
+import { startEnvironmentSweeper } from './environments.js';
+import { startScheduleSweeper } from './recurring.js';
+import { NodeRealtimeHub, attachRealtime } from './realtime.js';
+import { createDrizzleRepositories } from './repositories/drizzle.js';
+import { DrizzleSubscriptionActivationRepository } from './repositories/personalSubscription.js';
+import { startRetentionSweeper } from './retention.js';
+import { SystemClock } from './runtime.js';
+/** Build the Hono app around a ready container (shared by `createServer` + `start`). */
+export function createApp(container, env = process.env) {
+    const app = new Hono();
+    app.use('*', cors({ origin: (origin) => resolveCorsOrigin(origin, env.CORS_ALLOWED_ORIGINS) }));
+    app.use('*', async (c, next) => {
+        c.set('container', container);
+        await next();
+    });
+    app.get('/health', (c) => c.json({ status: 'ok' }));
+    // Default-deny session gate + per-workspace authz, shared verbatim with the Worker
+    // (one implementation in @cat-factory/server so the runtimes can't drift).
+    mountAuthGate(app);
+    registerCoreControllers(app);
+    app.onError(handleError);
+    return app;
+}
+/**
+ * Build the app from container options (convenience, e.g. embedding / tests).
+ *
+ * WARNING: unless a started `boss` is passed in `options`, the container wires the
+ * engine's NoopWorkRunner — a started execution then returns `running` but is never
+ * driven to completion. Use {@link start} for a fully-wired service (durable pg-boss
+ * worker + stale-run sweeper); pass `boss` here only if you drive runs yourself.
+ */
+export function createServer(options) {
+    return createApp(buildNodeContainer(options), options.env);
+}
+/**
+ * Boot the Node HTTP server: connect to Postgres (`DATABASE_URL`), ensure the schema,
+ * start pg-boss + the durable execution worker + the stale-run sweeper, build the app,
+ * and listen. Registers SIGTERM/SIGINT handlers for a clean, ordered shutdown.
+ */
+export async function start(options = {}) {
+    const env = options.env ?? process.env;
+    const databaseUrl = env.DATABASE_URL;
+    if (!databaseUrl) {
+        throw new Error('DATABASE_URL is required to start the Node server');
+    }
+    const { db, pool } = createDbClient(databaseUrl);
+    await migrate(db, pool);
+    const boss = new PgBoss(databaseUrl);
+    await boss.start();
+    // Build the repositories once and share them with both the container and the
+    // retention sweeper (so the sweeper prunes the very stores the app writes to).
+    const clock = new SystemClock();
+    const repos = createDrizzleRepositories(db, clock);
+    const buildContainer = options.buildContainer ?? buildNodeContainer;
+    // The per-workspace real-time subscriber registry. Created here (not in the container
+    // builder) because it must be shared between the engine's event publisher — wired
+    // inside the container — and the HTTP server's WebSocket upgrade listener attached
+    // below. The local facade's builder forwards this option to buildNodeContainer
+    // unchanged, so local mode gets live updates too.
+    const realtimeHub = new NodeRealtimeHub();
+    const container = buildContainer({ db, boss, env, repos, realtimeHub });
+    const runtime = executionRuntime(container.config, env);
+    // The decision-timeout worker creates its queue first so the advance worker's send to
+    // it (when a run parks on a decision) always has a target.
+    await startDecisionTimeoutWorker(boss, container, logger);
+    await startExecutionWorker(boss, container, runtime.drive, logger, {
+        concurrency: runtime.concurrency,
+        decisionTimeoutSeconds: runtime.decisionTimeoutSeconds,
+    });
+    // Durably drive bootstrap runs too (the Worker uses a per-run BootstrapWorkflow);
+    // a no-op queue when the bootstrap module isn't wired.
+    await startBootstrapWorker(boss, container, runtime.drive, logger, {
+        concurrency: runtime.concurrency,
+    });
+    const stopSweeper = startStaleRunSweeper(boss, container, runtime.sweeper, runtime.queue, logger);
+    // Bound the unbounded tables (`token_usage`, the heavy `llm_call_metrics`): the Worker
+    // prunes these from cron, Node has none, so a timer mirrors it. Without this the
+    // observability sink — full per-call prompt/response — grows forever on Postgres.
+    const stopRetention = startRetentionSweeper({
+        tokenUsageRepository: repos.tokenUsageRepository,
+        llmCallMetricRepository: repos.llmCallMetricRepository,
+        pipelineScheduleRepository: repos.pipelineScheduleRepository,
+        subscriptionActivationRepository: new DrizzleSubscriptionActivationRepository(db),
+    }, container.config.retention, clock, logger);
+    // Fire due recurring pipelines on a one-minute timer (the Worker uses cron).
+    const stopScheduleSweeper = startScheduleSweeper(container, clock, logger);
+    // Tear down expired ephemeral environments (the Worker uses cron); no-op unless the
+    // environments integration is wired.
+    const stopEnvironmentSweeper = startEnvironmentSweeper(container, clock, logger);
+    const app = createApp(container, env);
+    const port = Number(env.PORT ?? 8787);
+    const host = options.host ?? env.HOST?.trim() ?? undefined;
+    const server = serve({ fetch: app.fetch, port, ...(host ? { hostname: host } : {}) });
+    // Accept the SPA's WebSocket event-stream upgrades on the same listener and push the
+    // engine's events to subscribers (the Worker uses a per-workspace Durable Object;
+    // `@hono/node-server` doesn't upgrade on its own, so we attach a `ws` server here).
+    const stopRealtime = attachRealtime(server, realtimeHub, container.config.auth, logger);
+    logger.info({ port, host: host ?? '0.0.0.0' }, 'cat-factory node server listening');
+    // Ordered graceful shutdown: stop accepting connections, halt the sweeper + pg-boss
+    // worker, release the pool, then exit. Without closing the HTTP server the process
+    // would keep the event loop alive and hang until the orchestrator SIGKILLs it.
+    let shuttingDown = false;
+    const shutdown = async (signal) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        logger.info({ signal }, 'shutting down cat-factory node server');
+        stopSweeper();
+        stopRetention();
+        stopScheduleSweeper();
+        stopEnvironmentSweeper();
+        stopRealtime();
+        await new Promise((resolve) => server.close(() => resolve()));
+        try {
+            await boss.stop();
+            await pool.end();
+        }
+        catch (err) {
+            logger.error({ err: err instanceof Error ? err.message : String(err) }, 'shutdown error');
+        }
+        process.exit(0);
+    };
+    process.once('SIGTERM', () => void shutdown('SIGTERM'));
+    process.once('SIGINT', () => void shutdown('SIGINT'));
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tasks/JiraProvider.d.ts

@@ -0,0 +1,27 @@
+import { type TaskContent, type TaskCredentials, type TaskSourceProvider, type NormalizedTaskConnection } from '@cat-factory/kernel';
+export declare class JiraApiError extends Error {
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+export declare class JiraProvider implements TaskSourceProvider {
+    readonly kind: 'jira';
+    readonly descriptor: {
+        source: "github" | "jira";
+        label: string;
+        icon: string;
+        credentialFields: {
+            key: string;
+            label: string;
+            help?: string | undefined;
+            placeholder?: string | undefined;
+            secret?: boolean | undefined;
+        }[];
+        refLabel: string;
+        refPlaceholder: string;
+        searchable?: boolean | undefined;
+    };
+    normalizeConnection(input: TaskCredentials): NormalizedTaskConnection;
+    parseRef(input: string): string | null;
+    fetchTask(credentials: TaskCredentials, externalId: string): Promise<TaskContent>;
+}
+//# sourceMappingURL=JiraProvider.d.ts.map

package/dist/tasks/JiraProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JiraProvider.d.ts","sourceRoot":"","sources":["../../src/tasks/JiraProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC9B,MAAM,qBAAqB,CAAA;AAY5B,qBAAa,YAAa,SAAQ,KAAK;IAEnC,QAAQ,CAAC,MAAM,EAAE,MAAM;IADzB,YACW,MAAM,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EAIhB;CACF;AAsBD,qBAAa,YAAa,YAAW,kBAAkB;IACrD,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAS;IAC/B,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;MAAkB;IAErC,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,wBAAwB,CAapE;IAED,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAErC;IAEK,SAAS,CAAC,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA4CtF;CACF"}

package/dist/tasks/JiraProvider.js

@@ -0,0 +1,79 @@
+import { ValidationError, atlassianLogic, } from '@cat-factory/kernel';
+import { JIRA_DESCRIPTOR, jiraLogic } from '@cat-factory/integrations';
+// JiraProvider for the Node facade — a faithful copy of the Cloudflare facade's
+// provider (`runtimes/cloudflare/src/infrastructure/tasks/JiraProvider.ts`). Both
+// are thin `fetch` shells around the shared Jira *pure* logic in
+// `@cat-factory/integrations` (ref parsing, ADF→Markdown); only the HTTP shell is
+// runtime-bound. Node exposes the same global `fetch` + `btoa`, so the two stay
+// behaviourally identical (see CLAUDE.md "Keep the runtimes symmetric").
+const USER_AGENT = 'cat-factory';
+export class JiraApiError extends Error {
+    status;
+    constructor(status, message) {
+        super(message);
+        this.status = status;
+        this.name = 'JiraApiError';
+    }
+}
+export class JiraProvider {
+    kind = 'jira';
+    descriptor = JIRA_DESCRIPTOR;
+    normalizeConnection(input) {
+        const baseUrlRaw = input.baseUrl?.trim();
+        const accountEmail = input.accountEmail?.trim();
+        const apiToken = input.apiToken?.trim();
+        if (!baseUrlRaw || !accountEmail || !apiToken) {
+            throw new ValidationError('Jira requires a site URL, account email and API token');
+        }
+        const baseUrl = atlassianLogic.normalizeAtlassianBaseUrl(baseUrlRaw);
+        atlassianLogic.assertSafeAtlassianBaseUrl(baseUrl);
+        return {
+            credentials: { baseUrl, accountEmail, apiToken },
+            label: baseUrl,
+        };
+    }
+    parseRef(input) {
+        return jiraLogic.parseJiraRef(input);
+    }
+    async fetchTask(credentials, externalId) {
+        const base = credentials.baseUrl.replace(/\/+$/, '');
+        const fields = 'summary,description,status,issuetype,assignee,priority,labels,comment';
+        const url = `${base}/rest/api/3/issue/${encodeURIComponent(externalId)}?fields=${fields}`;
+        const auth = btoa(`${credentials.accountEmail}:${credentials.apiToken}`);
+        const res = await fetch(url, {
+            method: 'GET',
+            headers: {
+                authorization: `Basic ${auth}`,
+                accept: 'application/json',
+                'user-agent': USER_AGENT,
+            },
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => '');
+            throw new JiraApiError(res.status, `Jira GET ${url} → ${res.status}: ${text.slice(0, 300)}`);
+        }
+        const json = (await res.json().catch(() => null));
+        if (!json || !json.key || !json.fields) {
+            throw new JiraApiError(502, `Jira returned an unexpected body for issue ${externalId}`);
+        }
+        const f = json.fields;
+        const comments = (f.comment?.comments ?? []).map((c) => ({
+            author: c.author?.displayName ?? '',
+            createdAt: c.created ?? '',
+            body: jiraLogic.adfToMarkdown(c.body),
+        }));
+        return {
+            externalId: json.key,
+            url: `${base}/browse/${json.key}`,
+            title: f.summary ?? '(untitled)',
+            status: f.status?.name ?? '',
+            type: f.issuetype?.name ?? '',
+            assignee: f.assignee?.displayName ?? null,
+            priority: f.priority?.name ?? null,
+            labels: Array.isArray(f.labels) ? f.labels : [],
+            description: jiraLogic.adfToMarkdown(f.description),
+            comments,
+        };
+    }
+}
+//# sourceMappingURL=JiraProvider.js.map

package/dist/tasks/JiraProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JiraProvider.js","sourceRoot":"","sources":["../../src/tasks/JiraProvider.ts"],"names":[],"mappings":"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"}