feat(workflow-world): dual-engine workflows — Vercel SDK 'world' (Postgres/MongoDB) behind WorkflowKit

[Killian-Aidalinfo]

Résumé

Ajoute un second moteur de workflow à ai-kit : le moteur "world" (Vercel Workflow SDK, persistance durable Postgres/MongoDB) à côté du moteur legacy en mémoire, exposé via une façade unifiée WorkflowKit (défaut : legacy).

import { WorkflowKit } from '@ai_kit/core';

const kit = new WorkflowKit({ engine: 'world', world: { type: 'postgres', url } });
await kit.start();
const handle = await kit.run(myWorldWorkflow, [arg]);
await kit.stop();

Contenu

• @ai_kit/core — façade WorkflowKit (engine legacy|world, start/stop/run, validation), contrat d'adapter, exports publics. Lazy-load du package world via specifier variable + seam de test → aucune dépendance dure sur le SDK Vercel.
• @ai_kit/workflow-world (nouveau package optionnel) — createWorldAdapter (injection programmatique : createWorld + setWorld + start(fn,args,{world})), mapping worlds.ts, helpers de typage WorldStep/WorldWorkflow, README, docker-compose de test.

Décisions clés

• Injection programmatique (pas de variables d'env) → supprime le gotcha d'ordre des env.
• Spike "directive-in-arrow" → verdict type-only : le compilo Vercel n'instrumente pas les arrows passées à un wrapper, donc pas de defineWorldStep runtime ; on fournit les types WorldStep/WorldWorkflow et l'utilisateur écrit une liaison top-level avec la directive "use step" / "use workflow".
• Contrat dupliqué localement dans le package world (au lieu d'importer de core) → casse un cycle de build pnpm ; types structurellement identiques.
• Backends world en peerDependencies optionnelles → "pay-for-what-you-use".
• Provisioning Postgres requis avant 1er run (npx workflow-postgres-setup) — documenté.

Vérification

• Tests unitaires @ai_kit/workflow-world : 15 passed (+2 intégration skip par défaut)
• Tests @ai_kit/core (kit + workflows) : 36 passed — sans régression
• Tests @ai_kit/server (gated CI) : 19 passed
• Builds workflow-world / core / server : verts
• Intégration réelle (Docker) : Postgres ✅ et MongoDB ✅ (lifecycle start/stop validé end-to-end)

Docs

• Design : docs/superpowers/specs/2026-06-02-workflow-world-engine-design.md
• Plan d'implémentation : docs/superpowers/plans/2026-06-02-workflow-world-engine.md
• Notes SDK + spike : docs/superpowers/notes/2026-06-02-vercel-sdk-signatures.md

Notes

• Le moteur legacy est inchangé ; aucun utilisateur legacy ne tire les dépendances Vercel.
• Le SDK Vercel impose une étape de build (Nitro) + un worker long-vivant côté app hôte (documenté dans le spec §5).

🤖 Generated with Claude Code