Blinkin Legacy Docs Docs
Porting · porting/2026-05-05-platform-e2e-evidence.md Docs Home

Platform E2E Evidence

Date: 2026-05-05

Objective

Define the manual product-flow evidence needed before the Hetzner port can be considered complete.

Server health checks prove that services respond. They do not prove that the legacy platform flow works for a real user. The missing product proof is:

Studio Editor -> published Houston App -> Zweistein Agent/AI runtime

What Was Added

  • scripts/platform-e2e-evidence.mjs Read-only helper for the manual E2E evidence contract.
  • package.json scripts:
    • platform:e2e:plan
    • platform:e2e:template
    • platform:e2e:check

Safety Rules

  • The helper does not start servers.
  • The helper does not click through the product.
  • The helper does not create fake evidence.
  • The template uses Status: pending.
  • The completion gate accepts only Status: complete evidence with a published App URL and an observed Agent/AI response.

Commands

Print the manual verification plan:

npm run platform:e2e:plan

Print the evidence template:

npm run platform:e2e:template

Check whether valid E2E evidence exists:

npm run platform:e2e:check

Evidence Contract

The final evidence file must live at:

docs/evidence/<timestamp>-platform-e2e.md

It must include:

# End-to-End Platform Verification
Status: complete
Target: Hetzner staging
Published App URL:
Verifier:
Studio Editor
Houston
Zweistein
Agent/AI response observed: yes
Password protection checked:

Manual Flow

  1. Open Studio Editor on Hetzner staging.
  2. Create or open a visual flow.
  3. Attach an Agentic App or Agent-backed step that reaches Zweistein.
  4. Publish the App to Houston.
  5. Open the published Houston App URL.
  6. Check password protection if the published App is protected.
  7. Submit a real prompt or form input.
  8. Observe a Zweistein Agent/AI response in the published App.
  9. Record the Published App URL and verifier name in docs/evidence/.

Current Local Verification Evidence

  • node --check scripts/platform-e2e-evidence.mjs passed.
  • npm run platform:e2e:plan prints the manual verification plan.
  • npm run platform:e2e:template prints a pending evidence template.
  • npm run platform:e2e:check fails locally as expected because no completed platform E2E evidence file exists yet.

Current Boundary

No E2E product flow has been verified on Hetzner staging yet.

The product-flow evidence must be created only after the stack is running and a real published Houston App can reach Zweistein Agent/AI runtime.