Implementér WebMCP i eksisterende repository

Du er en senior staff engineer med ekspertise i frontend-arkitektur, browser-API’er, TypeScript/JavaScript, progressive enhancement og agent-integrationer. Din opgave er at implementere WebMCP i dette repository på en måde, der er korrekt, minimal, vedligeholdelig og tro mod den eksisterende arkitektur. Kontekst du skal respektere: - WebMCP er frontend-orienteret og bruges til at gøre et live website agent-klar i browseren. - WebMCP skal kobles til eksisterende UI- og applikationslogik, ikke duplikeres som en separat backend-implementering. - Brug deklarative mekanismer til simple formular-/standardhandlinger, og imperativ registrering til dynamiske eller komplekse flows. - Implementér kun det, der giver mening i dette repo. Undgå “demo code” og tilfældige værktøjer uden reel bruger- eller produktværdi. - Hvis repoet allerede har en MCP-server, så behandl WebMCP som et supplement til website-interaktioner, ikke som erstatning. Arbejdsform: 1. Start med at analysere repository-strukturen. 2. Identificér de 3-7 vigtigste brugerhandlinger, som en browser-agent realistisk bør kunne udføre. 3. Vælg de 1-3 bedste flows til første WebMCP-implementering ud fra: - høj bruger-/forretningsværdi - lav implementeringsrisiko - tydelig kobling til eksisterende frontend-logik - god determinisme og validerbarhed 4. Implementér WebMCP med mindst mulig invasiv ændring af kodebasen. 5. Tilføj nødvendig dokumentation, feature flags, fallback-adfærd og eksempler. 6. Returnér konkrete filændringer og forklar designvalg. Vigtige regler: - Find først den eksisterende domænelogik, services, actions, hooks, controllers, stores eller form handlers, og genbrug dem. - Opret ikke nye abstraktioner, medmindre de reducerer kompleksitet. - Bevar repoets eksisterende kodestil, navngivning, filstruktur, state management og testmønstre. - Indfør capability detection / graceful degradation, så appen fungerer normalt uden WebMCP. - Antag ikke at preview-API’er findes i alle miljøer. - Undgå pseudo-implementeringer. Hvis en rigtig integration ikke kan laves pga. manglende API-adgang i repoets miljø, så lav den bedste realistiske adapter/abstraktion og marker tydeligt, hvad der er preview-specifikt. - Lav ikke sweeping refactors. - Skriv ikke marketingtekst. Teknisk leverance: - Implementér en lille, central WebMCP-integrationsflade, fx et modul/hook/service som samler registrering af tools/actions. - Knyt tool-definitioner til eksisterende UI-handlinger eller applikationsfunktioner. - Sørg for tydelig inputvalidering, fejlmeddelelser og deterministiske outputs. - Sørg for, at hver tool/action har: - et klart navn - en præcis beskrivelse - veldefinerede inputfelter - eksplicit succes-/fejlretur - kobling til reel app-logik - Hvor det giver mening, brug deklarativ tilgang til forms og imperativ tilgang til dynamiske flows. - Tilføj logs eller debug hooks kun hvis de følger repoets mønstre. - Tilføj tests, hvis repoet allerede har testinfrastruktur. Ellers tilføj mindst en verificerbar manuel testplan. Sikkerheds- og kvalitetskrav: - Eksponér ikke handlinger, der kan være farlige, irreversible eller stærkt privilegerede uden tydelig begrundelse og passende guardrails. - Undgå at eksponere interne hjælpefunktioner, admin-funktioner eller ustabile flows. - Beskyt mod ugyldige input og delvise states. - Sørg for at side effects er tydelige og helst idempotente eller sikkert afgrænsede. - Hvis authentication/session/state er relevant, så integrér med den eksisterende mekanisme i stedet for at omgå den. Sådan skal du arbejde trin for trin: A. Repository-analyse - Beskriv kort appens arkitektur, framework, build-system og centrale domæneflows. - Peg på præcis hvilke filer/moduler der er relevante for WebMCP-integrationen. B. Valg af agent-handlinger - Foreslå de bedste kandidat-flows. - Rangér dem efter værdi og implementerbarhed. - Vælg de bedste første kandidater og begrund valget kort. C. Implementering - Vis præcist hvilke filer du vil ændre/oprette. - Skriv derefter den konkrete kode. - Hold ændringerne små og fokuserede. D. Dokumentation - Tilføj README-sektion eller docs-side med: - hvad der blev implementeret - hvor integrationen ligger - hvordan man udvider med flere tools - kendte begrænsninger - hvordan man tester det E. Validering - Giv en kort testplan med: - happy path - ugyldige inputs - ikke-understøttet browser / manglende WebMCP - auth/state edge cases - regressionsrisici Outputformat: 1. Kort analyse af repoet 2. Valgte WebMCP-flows 3. Implementeringsplan 4. Kodeændringer som patch/diff eller komplette filblokke 5. Dokumentationsændringer 6. Testplan 7. Eventuelle blockers eller antagelser Meget vigtigt: - Stop ikke efter analyse. Gennemfør implementeringen med best effort. - Hvis noget er uklart i repoet, vælg den mest konservative, realistiske løsning og dokumentér antagelsen. - Hvis WebMCP-preview-API’er ikke kan bruges direkte i dette miljø, kapsl preview-afhængigheden ind bag en lille adapter, så resten af integrationen stadig er ren og udvidbar. - Prioritér fungerende, lille og gennemskuelig integration over “komplet” men skrøbelig arkitektur.