claudekit-cli 3.41.4-dev.48 → 3.41.4-dev.49

package/README.md

@@ -656,6 +656,25 @@ bun test
 bun run test:integration
 ```
 
+## E2E Tests
+
+Playwright E2E tests cover the `ck migrate` dashboard (3 scenarios). Tests run against the local dev server and use API mocking — no real filesystem state is modified.
+
+**Prerequisites:** Node 18+ or Bun 1.0+, Chromium (installed automatically).
+
+```bash
+# One-time browser setup (if not already installed)
+./node_modules/.bin/playwright install chromium
+
+# Run all E2E specs
+bun run test:e2e
+
+# Interactive UI mode (watch + trace viewer)
+bun run test:e2e:ui
+```
+
+Note: The dev server starts automatically via `bun run dashboard:dev`. CI wiring is a separate follow-up (local-only for now).
+
 ## FAQ
 
 **Q: Do I need GitHub CLI?**

package/cli-manifest.json

@@ -1,6 +1,6 @@
 {
-	"version": "3.41.4-dev.48",
-	"generatedAt": "2026-04-24T02:15:04.014Z",
+	"version": "3.41.4-dev.49",
+	"generatedAt": "2026-04-24T05:30:24.953Z",
 	"commands": {
 		"agents": {
 			"name": "agents",
@@ -1254,19 +1254,40 @@
 			"usage": "ck migrate [options]",
 			"examples": [
 				{
-					"command": "ck migrate --agent codex --dry-run",
-					"description": "Preview the destination-aware migration plan before writing files"
+					"command": "ck migrate --install",
+					"description": "Pick items to install interactively (install picker mode)"
 				},
 				{
-					"command": "ck migrate --agent codex -g",
-					"description": "Write to Codex global paths such as ~/.codex/ and ~/.agents/skills"
+					"command": "ck migrate --agent codex --dry-run",
+					"description": "Preview the destination-aware reconcile plan before writing files"
 				},
 				{
-					"command": "CK_FORCE_ASCII=1 ck migrate --agent codex",
-					"description": "Force ASCII borders on legacy Windows terminals (cmd.exe, older PowerShell)"
+					"command": "ck migrate --respect-deletions",
+					"description": "Preserve empty directories — do not auto-reinstall deleted items"
 				}
 			],
 			"optionGroups": [
+				{
+					"title": "Mode Options",
+					"options": [
+						{
+							"flags": "--install",
+							"description": "Opt-in install picker mode — interactively select which items to install (default when registry is empty or has unknown checksums)"
+						},
+						{
+							"flags": "--reconcile",
+							"description": "Force reconcile mode — compute diff vs registry and apply only changes (default when registry is valid)"
+						},
+						{
+							"flags": "--reinstall-empty-dirs",
+							"description": "Reinstall all items when their type directory is empty or missing (default: true). Use --respect-deletions to disable."
+						},
+						{
+							"flags": "--respect-deletions",
+							"description": "Preserve deletion even when a type directory is empty — skip reinstall heuristic. Mutually exclusive with --reinstall-empty-dirs."
+						}
+					]
+				},
 				{
 					"title": "Target Options",
 					"options": [
@@ -1329,6 +1350,12 @@
 						}
 					]
 				}
+			],
+			"sections": [
+				{
+					"title": "Gotchas",
+					"content": "  --install and --reconcile are mutually exclusive — pass only one\n  --reinstall-empty-dirs and --respect-deletions are mutually exclusive — pass only one\n  Default mode is smart-detected: no/stale registry → install, valid registry → reconcile\n  --respect-deletions disables the auto-reinstall heuristic for empty directories\n  --force overrides skip decisions per item; --reinstall-empty-dirs is a per-directory heuristic"
+				}
 			]
 		},
 		"new": {