Hartmut
4a5edeef3e
CI / Unit Tests (pull_request) Successful in 5m46s
CI / Lint (pull_request) Failing after 3m49s
CI / E2E Tests (pull_request) Has been skipped
CI / Fresh-Linux Docker Deploy (pull_request) Has been skipped
CI / Assistant Split Regression (pull_request) Failing after 35s
CI / Architecture Guardrails (pull_request) Failing after 2m14s
CI / Typecheck (pull_request) Successful in 4m22s
CI / Build (pull_request) Has been skipped
CI / Release Images (pull_request) Has been skipped
- @capakraken/* → @nexus/* across 12 packages (root + 11 workspaces),
1551 import lines migrated via codemod
- User-visible brand strings renamed (emails, page titles, PWA
manifest, mobile header, MFA backup-codes header, tooltips, signin
page, invite page, weekly digest, install prompt)
- TOTP issuer "CapaKraken" → "Nexus" (existing secrets still valid;
re-enrollment relabels them in users' authenticator apps)
- Function rename: assertCapaKrakenDbTarget → assertNexusDbTarget
- LocalStorage migration shim in apps/web/src/app/layout.tsx copies
capakraken_* → nexus_* on first load (guarded by nexus_migrated_v1
sentinel; runs once per browser, then never again)
- Service-worker cache name capakraken-v2 → nexus-v2 with one-time
caches.delete('capakraken-v2') from the same shim
- Email-domain fixtures @capakraken.{dev,app} → @nexus.{dev,app} in
seed data, e2e specs, SMTP default fallback
- Dockerfile.dev / Dockerfile.prod / all .github/workflows/*.yml
pnpm --filter @capakraken/* → @nexus/*
- README, CLAUDE.md, LEARNINGS.md, all docs/*.md, .env.example,
tooling/deploy/.env.production.example brand sweep
Phase 1 deliberately leaves untouched (handled in Phase 3 cutover):
- PostgreSQL DB name "capakraken" and POSTGRES_USER "capakraken"
- Volume names capakraken_pgdata etc.
- Compose project name "capakraken" / "capakraken-prod"
- db-target-guard default expectedDatabase
- env-var CAPAKRAKEN_EXPECTED_DB_NAME
- Container DNS names in docker-compose.ci.yml
Quality gates green: pnpm typecheck (7/7), pnpm test:unit (7/7),
pnpm lint (0 errors), check:exports/imports/architecture all pass.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
6.0 KiB
6.0 KiB
Assistant Tool Test Split Migration
Stand: 2026-04-01
Diese Notiz hält fest, wie die alten Assistant-Tool-Monolith-Tests in kleinere, fachlich geschnittene Suiten aufgeteilt wurden und wie die Regression dafür reproduzierbar ausgeführt wird.
Ziel
- Alte Sammeltests waren konfliktanfällig und schwer gezielt zu regressieren.
- Neue Split-Tests schneiden entlang fachlicher Domänen und realer Access-/Mutation-Verträge.
- Die Regression soll explizit und reproduzierbar laufen, statt implizit über breite Dateiglob-Matches.
Regression ausführen
Im Paket @nexus/api:
pnpm test:assistant-split
Der Runner führt fünf explizite Vitest-Batches plus abschließenden API-Typecheck aus:
- Allocation und Quick Assign
- Timeline und Advanced Ranking
- Dispo
- Estimate
- Insights und Misc
Die explizite Regression enthält dabei auch dedizierte Suites für:
export_projects_csv- Holiday-Resolution-Fehlerpfade
get_timeline_holiday_overlays
Legacy-zu-Split-Mapping
assistant-tool-policy.test.ts
Aufgeteilt in:
assistant-tool-policy-access.test.tsassistant-tool-policy-admin.test.tsassistant-tool-policy-planning.test.ts- ergänzend domänische Guards in
assistant-tools-auth-guard.test.ts
Abgedeckt werden damit insbesondere:
- Sichtbarkeit von Tools je Rolle
- Permission-Gates für Planning, Costs und
useAssistantAdvancedTools - Trennung zwischen Self-Service, Admin- und Controller-Surface
assistant-tools-advanced.test.ts
Aufgeteilt in:
assistant-tools-advanced-resource-ranking.test.tsassistant-tools-advanced-timeline-entries-view.test.tsassistant-tools-advanced-timeline-holiday-overlays.test.tsassistant-tools-advanced-project-timeline-context.test.tsassistant-tools-advanced-project-shift-preview.test.tsassistant-tools-timeline-resource-selection.test.ts
Abgedeckt werden damit insbesondere:
- Advanced-Ranking und Project-Resource-Selection
- Timeline-Readmodels, Holiday-Overlays und Shift-Preview
- Access-Gates für
viewPlanning,viewCostsunduseAssistantAdvancedTools
assistant-tools-audit.test.ts
Aufgeteilt in:
assistant-tools-audit-log-list.test.tsassistant-tools-audit-read.test.tsassistant-tools-audit-entity-summary.test.tsassistant-tools-audit-errors-auth.test.ts- ergänzend
assistant-tools-query-change-history.test.ts
Abgedeckt werden damit insbesondere:
- Listen-, Detail- und Summary-Reads
- stabile Auth-/Role-Fehler für Controller-only Reads
- Query-Change-History als separates Controller-Readmodel
assistant-tools-country.test.ts
Aufgeteilt in:
assistant-tools-country-list.test.tsassistant-tools-country-get.test.tsassistant-tools-country-mutations-success.test.tsassistant-tools-country-mutations-errors.test.tsassistant-tools-metro-city-mutations-success.test.tsassistant-tools-metro-city-mutations-errors.test.ts
Abgedeckt werden damit insbesondere:
- Country-Readmodels
- Fehleroberflächen für Not Found und Duplikate
- Country- und Metro-City-Mutationen
Hinweis:
get_country verlangt inzwischen explizit VIEW_ALL_RESOURCES; die neuen Split-Tests sind an diesem aktuellen Vertrag ausgerichtet.
assistant-tools-holidays.test.ts
Aufgeteilt in:
assistant-tools-holiday-calendar-get.test.tsassistant-tools-holiday-calendar-get-errors.test.tsassistant-tools-holiday-calendars-list.test.tsassistant-tools-holiday-calendar-mutations-success.test.tsassistant-tools-holiday-calendar-mutations-guards.test.tsassistant-tools-holiday-entry-mutations-success.test.tsassistant-tools-holiday-entry-mutations-errors.test.tsassistant-tools-holiday-resolution-calendar-preview.test.tsassistant-tools-holiday-resolution-regional-resource.test.tsassistant-tools-holiday-resolution-errors.test.tsassistant-tools-holiday-capacity.test.tsassistant-tools-holiday-chargeability.test.tsassistant-tools-holiday-budget-shoring.test.tsassistant-tools-holiday-simulation.test.tsassistant-tools-holiday-staffing-suggestions.test.ts
Abgedeckt werden damit insbesondere:
- Holiday-Calendars und deren CRUD
- Region-/Resource-spezifische Auflösung
- negative Pfade für unvollständige Perioden, unbekannte Ressourcen und unbekannte Preview-Länder
- Holiday-Einfluss auf Capacity, Chargeability, Budget und Staffing
assistant-tools-import-export.test.ts
Aufgeteilt in:
assistant-tools-import.test.tsassistant-tools-export.test.tsassistant-tools-export-projects.test.tsassistant-tools-dispo-import.test.tsassistant-tools-dispo-import-batch-list-cancel.test.tsassistant-tools-dispo-import-batch-delegation.test.tsassistant-tools-dispo-staged-listings-resources-projects.test.tsassistant-tools-dispo-staged-unresolved-read.test.tsassistant-tools-dispo-staged-vacations-read.test.tsassistant-tools-dispo-staged-assignments-read.test.tsassistant-tools-dispo-staged-resolution.test.ts
Abgedeckt werden damit insbesondere:
- CSV-Import-/Export-Pfade
- dedizierte Execution-Coverage für
export_resources_csvundexport_projects_csv - Permission-Gates wie
importData - Dispo-Import-Staging, Delegation, Commit und Cancel
Verifikationsstand
Der aktuelle Split-Runner wurde gegen die genannten Batches, die dedizierten Gap-Closure-Suiten und den API-Typecheck validiert.
Migration abgeschlossen
Der Legacy-Scope der entfernten Monolith-Suiten ist vollständig auf fachlich geschnittene Split-Suiten gemappt. Neue Assistant-Regressionen sollen direkt in die fachlich passende Split-Suite eingeordnet werden. Der explizite Split-Runner bleibt für diesen Scope der kanonische Regressionspfad; breite Glob-Runs und eine Wiederbelebung der alten Monolith-Dateien sind bewusst nicht vorgesehen.
Bewusst noch nicht Teil dieses Dokuments:
- konfliktträchtige, bereits separat bearbeitete Notification-/Timeline-Support-Dateien
- breit gefächerte Repo-weite Vitest-Globs, weil diese in der Vergangenheit versehentlich mehr als die Ziel-Suite eingesammelt haben