15 KiB
Handoff — Stand 2026-05-20
Historical snapshot only (2026-05-25 cleanup). This file is preserved for audit/history. Do not treat its "start", "push", "deploy" or operator instructions as current work. Use
PROGRESS.md,OPERATOR-CHECKLIST.mdand the latest session notes for live status.
Vorgänger-Agent: Claude Opus 4.7 (1M context) Letzte aktive Session: Phase 06 Plugin-System — von "audit-package zusammenstellen" bis "fast alle internen Findings remediated" Ziel des Handoffs: Nachfolge-Agent soll in 3 Minuten wissen wo wir stehen, was gerade kein Code-Problem sondern Operator-Arbeit ist, und welche Tracks Code-Arbeit brauchen.
1. Was die letzte Session bewegt hat (29 commits auf main)
Phase 06 (Plugin-System) #23 von pending → in_progress (operator-audit-pending). Audit-Package-Layer + 12 interne Findings remediated mit Tests.
Schlüssel-Artefakte:
docs/security/plugin-threat-model.md— 14 Assets × STRIDE, jede Mitigation perfile:linean Code gehängtdocs/security/plugin-attack-surface.md— 9 Capabilities, Manifest-Felder, DB-Tabellen, Routes, Envdocs/security/plugin-internal-findings.md— 24 F-NNN Findings, 23 davon disposed (closed / accepted-residual / blocked-on-precondition / blocked-architecturally)docs/security/plugin-audit-rfp.md— RFP mit Vendor-Empfehlung Cure53 (Alternates: Trail of Bits / NCC Group / SySS / secfault), 25k EUR Capdocs/security/plugin-runtime-signoff.md— Joint Sign-Off-Templatescripts/build-plugin-audit-package.sh— bündelt In-Scope-Code + Docs + SHA-256-Manifest in ein tar.gz (smoke-getestet ~209 KB)docs/improvement-plan/06-plugin-system/security-findings/README.md— Folder-Convention für künftige Findings-Files
Code-Remediations diese Session (alle mit Tests + grünem Lefthook-Pre-Commit):
- F-015 Critical (worker bootstrap unwired) —
handlePluginInvokeJobjetzt wirklich an BullMQ angeschlossen - F-005 Phase A + B — Install-Path Trust-Store-Gate + binary-on-disk verify
- F-017 — Manifest-Schema um
minHostVersion/maxHostVersionerweitert - F-010 — CSRF-body-consumption immunity verifiziert
- F-014 — sanitize total-size budget
- F-011 — install-route per-tenant rate limit
- F-008/F-009/F-021/F-023 — Medium-Sweep (statement cap, install cap, tenantId regex, circular-ref WeakSet)
- F-007/F-020 — per-stmt migration audit + audit-table-size warning
- F-006 — Token-aware migration scan (ersetzt substring-only Forbidden-Token-Check)
- F-003 —
PluginCapabilityUseper-tenant hash chain (Prisma migration + verifier) - F-001 backend —
TenantPluginCapabilityGrantModell + enable-time consent-gate (UI deferred) - F-013/F-016/F-018/F-019/F-012 — als accepted-residual / documented / blocked-on-precondition geschlossen
Nur F-002 bleibt offen — per-instruction fuel braucht Wasmtime-Swap (multi-week, architektur). Konkrete Two-Track-Remediation steht in der Findings-Datei.
2. Gesamt-Projekt-Status
Total Tasks: 63 aktiv + 7 Backlog
Completed: 35 / 63 (56%)
In Progress: 28 / 63
Pending: 0
Backlog: 7
Blocked-hart: 0 (siehe BLOCKERS.md für Operator-Anfragen)
Die "In Progress: 28" zerfallen in drei sehr unterschiedliche Buckets — das ist das wichtigste was der nächste Agent verstehen muss.
Bucket A — Operator-Pending (~14 Tasks, KEINE Code-Arbeit)
Code ist fertig + getestet, was fehlt ist eine Operator-Aktion (env flip, deploy, account setup, store submission, live E2E test). Nicht anpacken ohne klaren Operator-Auftrag.
| Task | Operator-Aktion |
|---|---|
| #16 / #17 AV-Layer 1+2 | Erste echte EICAR-Upload-Smoke auf staging |
| #19 / #20 Magic-Link / Invitation | Live E2E-Flow auf staging |
| #23 Phase 06 #23 | External pen-test dispatch (B-006) — siehe Section 4 |
| #26 TOTP | Live MFA enroll/challenge E2E |
| #29 / #30 / #32 Sentry | Workflow-Smoke + Project-Setup |
| #40 PgBouncer | App DATABASE_URL flip |
| #41 R/W-Split | Replica deploy + connection-string flip |
| #51 Asset-CDN | CDN-Zone provisionieren |
| #56 AI-Cost Phase 3 | Stripe-Account Meter-Setup (siehe docs/ops/stripe-meters-migration.md) |
| #65 Mobile | Native-builds + App Store / Play Store submission |
| #27 Password-Policy | Login-Soft-Banner (Code-Stub existiert, UI-Polish deferred) |
Bucket B — Code-Sprint-Deferred (~13 Tasks, ECHTE Code-Arbeit)
Foundation ist da, Feature-Vervollständigung steht aus. Diese sind die echten "weitermachen"-Kandidaten.
| Task | Was zu tun ist | Aufwand |
|---|---|---|
| #21 / #22 Plugin Phase 1+2 | Hot-reload, marketplace, sandboxed iframe, output-hooks, 13 zusätzliche hook-points, global crash counter | 2-3 Wochen |
| #38 Shared-Store | 3 von 6 Stores migriert; idempotency + subscription-cache + session offen | 1 Woche |
| #42 Outbox | Foundation shipped; call-site migrations, admin UI, CLI re-queue, e2e tests offen | 1 Woche |
| #39 Pub/Sub | feature-flag invalidation in Phase 05 wired-up | 2-3 Tage |
| #53 Feature-Flags | Visual rule builder UI | 3-5 Tage |
| #55 AI-Cost Quota | Admin + tenant UI + CLI | 3-5 Tage |
| #59 Realtime-Collab | Andere Editoren als Novel anbinden (Hocuspocus) | 1 Woche |
| #62 Storybook | a11y / visual-regression / test-runner | 3-5 Tage |
| #72 i18n | 200+ jsx-text + prop-literal extractions (/72 i18n migration sprint in D1) |
3-5 Tage |
| #73 WCAG | Axe-violation Backlog abarbeiten | 5-7 Tage |
| #76 Test-Coverage | Per-Module-Gates ratchet | 5-10 Tage |
| #78 Marketing-Funnel | Admin-Sidebar wiring + Turnstile staging-verify | 1-2 Tage |
| F-002 (Phase 06) | Per-instruction fuel via Wasmtime-Swap ODER worker-thread + wall-clock kill | multi-week |
Bucket C — Backlog (7 Tasks, on-demand)
#24 (Marketplace), #52, #57, #64, #66, #74, #77 — explizit "nur wenn jemand fragt", nicht auf der aktiven Roadmap.
3. Offene Operator-Blocker (BLOCKERS.md)
Superseded blocker status (2026-05-28): this section is preserved as the 2026-05-20 snapshot. Current truth: B-006 remains the external plugin production gate; B-008 is closed by operator disk-pressure alerting; B-012 is a mitigated runner-host recurrence risk, not an active deploy/code blocker. Use
../../OPERATOR-CHECKLIST.mdand../../BLOCKERS.md.
Aktuell open:
- B-006 — External Security Review of WASM Sandbox (Phase 06 production rollout gate)
- Audit-Package + RFP + Vendor-Memo + Sign-Off-Template alle ready (siehe Section 4)
- Operator: Cure53 (oder einer der 4 Alternates) engagieren, 3-5 Tage Pen-Test, ~15-25k EUR
- B-008 — Disk-pressure monitoring (Aftermath: containers wieder up, prevention pending)
- Operator: Grafana-Alert + automated
docker system prunecron
- Operator: Grafana-Alert + automated
- B-012 — Gitea-runner Docker default-address-pool (mitigated 2026-05-18, permanent fix operator-owed)
- Operator:
/etc/docker/daemon.jsonaufhomeservereditieren + dockerd restart
- Operator:
Resolved (siehe BLOCKERS.md für Archiv):
B-001 (Stripe 13→19), B-002 (Staging-Access), B-003 (Push-Strategie), B-005 (Sentry OTLP), B-007 (Authentik blueprints), B-009 (Lighthouse session-cookie), B-010 (pgvector + migrations), B-011 (Worker Dockerfile), B-013 (Vite node:crypto)
4. Phase 06 — Production-Rollout-Path (konkrete Schritte)
Archived superseded notes: this rollout path predates later plugin readiness and worker-topology docs. Use
docs/operations/plugin-lifecycle.md,docs/worker.md,docs/ops/worker-queues.md, anddocs/security/plugin-runtime-signoff.mdfor current runtime gates. In particular, the production gate is nowPLUGIN_RUNTIME_PRODUCTION_ENABLED, not the olderPLUGIN_RUNTIME_ENABLEDwording below.
Phase 06 ist der einzige Track der gerade "audit-ready" ist und auf eine externe Operator-Aktion wartet. Der Pfad zur completed-Markierung:
git push— die 29 lokalen commits aufmainmüssen nachorigin(Pre-Push-Hook ist grün seit3afbb257)bash scripts/build-plugin-audit-package.sh— erzeugtartifacts/plugin-audit/2026-05-20/plugin-audit-<sha>.tar.gz- RFP + Archive an Cure53 verschicken per
docs/security/plugin-audit-rfp.md§ 9 (E-Mail-Template am Ende der RFP-Datei) - Während des Audits (~3 Wochen): Findings werden unter
docs/improvement-plan/06-plugin-system/security-findings/F-NNN-….mdabgelegt. Pro Critical/High einen eigenen File mit Reproduction + Remediation-Plan. - Fixes pushen → Re-Test anfragen (Cure53 macht typischerweise 1× Re-Test im Engagement)
docs/security/plugin-runtime-signoff.mdausgefüllt + von Operator + Lead Auditor signiert- Production-Env-Vars setzen bevor
PLUGIN_RUNTIME_ENABLED=true:PLUGIN_TRUSTED_PUBLIC_KEYS=<CSV von hex Ed25519 keys>(Operator-Aktion)PLUGIN_INSTALL_SKIP_BINARY_VERIFY=false(Default — NICHT auf true setzen in Prod)PLUGIN_REQUIRE_CAPABILITY_CONSENT=true(Default — NICHT auf false setzen in Prod)PLUGIN_BINARY_BASE_PATH=/app/var/plugins(oder operator-gewählt)WORKER_QUEUE_GROUP=pluginContainer provisionieren (separatesworker-plugindeploy)
- PROGRESS.md Status für #23 von
in_progress (operator-audit-pending)→completed - F-002 bleibt nach Audit als deferred — entweder direkt im selben Rollout angegangen ODER als Phase-06-follow-up
5. Was der nächste Agent zuerst tun sollte
Lies in dieser Reihenfolge (max 15 Minuten):
- Dieses Handoff-Dokument (bis hierhin)
docs/improvement-plan/PROGRESS.mdAggregat-Sektion (Zeilen 1-50)docs/improvement-plan/BLOCKERS.md(alleOpenEinträge)docs/improvement-plan/OPERATOR-CHECKLIST.md§ A (operator-env-flip-pending Items)docs/security/plugin-internal-findings.mdSummary-Tabelle (Section "Summary").claude/CLAUDE.md(React Router v7 conventions — die werden im Repo strikt enforced)AGENTS.mdim Repo-Root (Workflow + Branch-Strategie)
Dann sprich mit dem User über die Richtung:
"Vorgänger hat Phase 06 audit-ready übergeben. Open Bucket-B Tracks sind A, B, C, D — welcher davon ist priorität, oder gibt es einen anderen Track der dich gerade interessiert?"
NICHT einfach in Phase-06-Follow-Up-Code reingehen ohne expliziten Auftrag — F-002 ist Multi-Wochen-Architektur (Wasmtime), nichts zum "kurz mal machen". Auch nicht in Bucket-A-Operator-Tracks reinarbeiten ohne klaren Anlass — der Code ist fertig, das Warten ist beabsichtigt.
6. Workflow-Konventionen (NICHT vergessen)
Archived superseded notes: these workflow conventions were session-local for 2026-05-20. They do not override current repository instructions, conversation constraints, branch policy, verification scope, or commit/push decisions.
Aus AGENTS.md + Session-Erfahrung:
- Alle Commits direkt auf
main— keine Branches, Coolify deployed auto auf staging git pull --rebasevor Workflow-Start — andere Agenten arbeiten parallel- Lefthook Pre-Commit ist hart —
test-density,eslint-baseline,secrets,lint-stagedmüssen grün - Lefthook Pre-Push ist hart — full
pnpm typecheck. Bricht den Push wenn TS-Fehler. Diese Session hatte einen Push-Fail wegen F-001 Set-Type — fix in3afbb257. - React Router v7 — Route-Type-Imports IMMER als
./+types/<routeName>, nie relativ. Nach Route-Addnpm run typecheckausführen. - Niemals
git add -A— nur explizite Paths. Parallel-Agenten-Disziplin. - Co-Author-Trailer:
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> pnpm, nicht npm — pnpm-workspace-Setup,pnpm -F <pkg>für package-scoped scripts- Tests via
npx vitest run <path>, NICHTpnpm test(zu breit für TDD)
7. Push-Status (jetzt-aktuell)
Archived superseded notes: the push status below is a point-in-time snapshot from 2026-05-20, not current repository state.
HEAD: 3afbb257 fix(plugins): widen capability-name Set type in F-001 grant check
local-main vs origin/main: 29 commits ahead
worktree: nur auto-generated Prisma client modifications (packages/db/generated/prisma/*)
Operator sollte als allererstes git push durchziehen. Die 29 Commits sind lokal, getestet, hooks-grün, aber noch nicht auf origin. Bis die nicht oben sind ist nichts deployed.
Wenn der Push erneut scheitert: Pre-Push-Hook Output lesen, das ist ein neuer Bug, kein bekannter Fehler.
8. Was diese Session NICHT geleistet hat (ehrlich)
- F-002 nicht angegangen — Wasmtime-Swap ist multi-week, nicht session-scoped. Konkrete Two-Path-Remediation in
plugin-internal-findings.mdF-002 dokumentiert. - Phase 06 UI — Capability-Consent-Dialog, Sandboxed-iframe-Settings, Audit-Trail-Filter-UI sind alle deferred (#22 Deviations + F-001 backend-only)
- 13 weitere Hook-Points — Phase 06 #22 hat 5/18 wired; 13 deferred
- Marketplace — Phase 11 Backlog #24, nicht aktiv
- Andere Tracks außerhalb Phase 06 — diese Session war Phase-06-fokussiert. Bucket B (Sprint-Deferred) Items sind unverändert seit vor 2026-05-19.
9. Sofort-Sanity-Check für nächsten Agent
# Im Repo-Root
git log --oneline -5 # sollte mit 3afbb257 starten
git status -s # sollte nur Prisma-generated zeigen
pnpm -F @toolctrl/plugin-runtime test 2>&1 | tail -5 # sollte 168 tests passing
bash scripts/build-plugin-audit-package.sh # sollte tar.gz erzeugen
Wenn alle 4 grün: Repo ist in dem Zustand der diesem Handoff entspricht.
Ende des Handoffs. Bei Unklarheit den User fragen, nicht raten.