Migrating from LessonKit 1.5.x to 1.6.0¶

Summary¶

Area	1.5.x	1.6.0
Portable archive	—	`.lkcourse` via `lessonkit export`
Block registry CLI	—	`lessonkit blocks list` (catalog v3)
`@lessonkit/lxpack`	LMS packaging	+ `exportLkcourse`, `validateLkcourse`, `importLkcourse`
Breaking API changes	—	None (additive minor)

New commands¶

# Archive a built course for handoff or tooling
lessonkit build
lessonkit export --out my-course.lkcourse

# Optional static block inventory for AI/codegen
lessonkit export --with-block-tree

# Discover runtime blocks
lessonkit blocks list --json

Programmatic interchange¶

import { exportLkcourse, importLkcourse, validateLkcourse } from "@lessonkit/lxpack";

See Portable interchange reference.

Import expectations¶

.lkcourse import restores lessonkit.json + dist/ only. React src/ is not bundled in the archive — keep source in git or copy separately.

Upgrade checklist¶

Bump all @lessonkit/* packages to 1.6.0 (or latest 1.6.x patch).
Run npm install.
lessonkit build and lessonkit package --target scorm12 (unchanged workflow).
Optionally try lessonkit export on a golden path course.

Patch releases (1.6.x)¶

Later 1.6.x patches are additive — no breaking API changes. They add Tier C–E content blocks (Table, Timeline, Crossword, GameMap, and others) and expand block catalog v3. Bump all @lessonkit/* packages to the same patch; no manifest or migration steps beyond npm install unless you adopt new blocks.

LMS delivery unchanged¶

lessonkit package targets (scorm12, xapi, cmi5, standalone) are unchanged. .lkcourse is for archival and team interchange, not LMS upload.