Production launch
NO-GO
static readiness cannot launch production.
F068 · compatibility
Versioned embed compatibility contract
Freezes loader.js v1 compatibility, snippet attributes, deprecation policy and upgrade notes.
Scope
F068 report
Blocked phases
0
Warning phases
1
F068
Versioned Embed Compatibility Contract
loader.js v1 compatibility policy is frozen at contract level; real regression fixtures are still required.
Required evidence
- • loader.js v1 endpoint returns stable version header
- • snippet parser accepts current v1 attributes
- • deprecated attributes do not break old embeds
- • upgrade notes and compatibility window
PASS
Loader v1 contract
F058 route emits x-kline-loader-version=v1 and versioned data attributes.
WARNING
Backward-compatible snippet parser
Current parser supports v1 attributes; legacy fixture coverage still needs browser regression.
WARNING
Deprecation policy
Policy is documented as readiness; release notes must be published before customers update.
Global production gates
BLOCKED
Frontend green gate
Run pnpm install/typecheck/lint/build/test/dev/test:e2e in local or staging.
BLOCKED
Backend green gate
Run npm ci, prisma generate/validate, typecheck, lint, test, start/dev and migration check.
BLOCKED
Browser/embed QA
Plain HTML, Next.js, WordPress-like, mobile, multi-widget and no-token checks require real browser evidence.
BLOCKED
Security/observability evidence
Token redaction, CSP, iframe sandbox, postMessage allowlist and trace id propagation must be proven.
WARNING
Release/docs evidence
Customer install guides, troubleshooting, known limitations and rollback docs need final review.
Launch blocking reasons
- Blocker 1
- F066: Production Deployment / Environment Freeze is WARNING / not production-promotable from static evidence.
- Blocker 2
- F067: Observability / Logs / Metrics / Trace IDs is WARNING / not production-promotable from static evidence.
- Blocker 3
- F068: Versioned Embed Compatibility Contract is WARNING / not production-promotable from static evidence.
- Blocker 4
- F069: Customer Onboarding / Install Guide QA is WARNING / not production-promotable from static evidence.
- Blocker 5
- F070: Production Security Hardening is BLOCKED / not production-promotable from static evidence.
- Blocker 6
- F071: Production Data Reliability is BLOCKED / not production-promotable from static evidence.
- Blocker 7
- F072: Regression Suite Freeze is WARNING / not production-promotable from static evidence.
- Blocker 8
- F073: Release Candidate / RC1 is BLOCKED / not production-promotable from static evidence.
- Blocker 9
- F074: Beta Feedback / Bugfix Window is WARNING / not production-promotable from static evidence.
- Blocker 10
- F075: Production Launch Readiness is BLOCKED / not production-promotable from static evidence.
Commands required outside sandbox
- Command 1
- pnpm install
- Command 2
- pnpm typecheck
- Command 3
- pnpm lint
- Command 4
- pnpm build
- Command 5
- pnpm test
- Command 6
- pnpm dev
- Command 7
- pnpm test:e2e
- Command 8
- npm ci
- Command 9
- npx prisma generate
- Command 10
- npm run prisma:validate
- Command 11
- npm run typecheck
- Command 12
- npm run lint
- Command 13
- npm run test
- Command 14
- npm run start:dev
- Command 15
- migration check
Next safe action
Run F066-F075 as a production-track readiness/handoff, then collect real local/staging frontend, backend and browser evidence before RC1 or production launch.