0.3.0

.gitignore

@@ -52,6 +52,7 @@ TestResults.xml
 .kun-design/
 .kun/images/
 .kun-canvas/
+.kun-whiteboards/
 .kunsdd/
 openspec/
 

AGENTS.md

@@ -70,6 +70,7 @@ This guide is for AI agents working in this repository. It collects the project
 - Unit tests: `npm run test`
 - Build: `npm run build`
 - Lint: `npm run lint`
+- File-size gate: `npm run check:file-lines` (every tracked non-binary, non-lockfile text file must be at most 700 physical lines)
 - Changes under `kun/` should pass `npm run build:kun`; top-level `dev` and `build` both run it first.
 - Before committing, run the smallest checks that cover the change. Cross-layer contracts, runtime behavior, settings, providers, and packaging changes usually need `npm run typecheck`, relevant `vitest` coverage, and `npm run build`.
 - If a check fails, separate newly introduced failures from existing baseline failures. Do not silently treat unrelated baseline failures as passing.
@@ -121,6 +122,7 @@ gh pr create --base develop --head <branch> --title "<title>" --body-file <file>
 
 ## Repository Hygiene
 
+- Keep every tracked authored text file at or below 700 physical lines. Split files by cohesive feature or operation before they cross the limit; do not bypass the gate with generated formatting or line compaction.
 - Do not commit build artifacts, extracted apps, temporary logs, or local investigation notes.
 - Keep changes local to the requested area. Do not reformat the whole repository, reorder unrelated files, or remove existing comments as drive-by cleanup.
 - New content should stay ASCII unless the surrounding file or user-facing requirement clearly needs otherwise.

build/installer.nsh

@@ -5,7 +5,6 @@ Var /GLOBAL KunInstallerSecondarySourceDir
 Var /GLOBAL KunInstallerTargetDir
 Var /GLOBAL KunInstallerResultPath
 Var /GLOBAL KunInstallerResultHandle
-Var /GLOBAL KunInstallerJournalPath
 Var /GLOBAL KunInstallerMigrationPrepared
 Var /GLOBAL KunInstallerSnapshotMode
 Var /GLOBAL KunInstallerPrimarySourceStale
@@ -22,6 +21,7 @@ Var /GLOBAL KunInstallerCurrentUserShortcutName
 Var /GLOBAL KunInstallerCurrentUserMenuDirectory
 !endif
 Var /GLOBAL KunInstallerHelperPath
+Var /GLOBAL KunInstallerJournalPath
 Var /GLOBAL KunInstallerPowerShellPath
 Var /GLOBAL KunInstallerHelperExitCode
 Var /GLOBAL KunInstallerHelperOutput
@@ -62,6 +62,10 @@ Var /GLOBAL KunInstallerStopResult
   InitPluginsDir
   StrCpy $KunInstallerPowerShellPath "$SYSDIR\WindowsPowerShell\v1.0\powershell.exe"
   File /oname=$PLUGINSDIR\kun-windows-installer-migration.ps1 "${PROJECT_DIR}\build\windows-installer-migration.ps1"
+  File /oname=$PLUGINSDIR\windows-installer-migration-paths.ps1 "${PROJECT_DIR}\build\windows-installer-migration-paths.ps1"
+  File /oname=$PLUGINSDIR\windows-installer-migration-journal.ps1 "${PROJECT_DIR}\build\windows-installer-migration-journal.ps1"
+  File /oname=$PLUGINSDIR\windows-installer-migration-filesystem.ps1 "${PROJECT_DIR}\build\windows-installer-migration-filesystem.ps1"
+  File /oname=$PLUGINSDIR\windows-installer-migration-actions.ps1 "${PROJECT_DIR}\build\windows-installer-migration-actions.ps1"
   StrCpy $KunInstallerHelperPath "$PLUGINSDIR\kun-windows-installer-migration.ps1"
   StrCpy $KunInstallerResultPath "$PLUGINSDIR\kun-windows-installer-result.txt"
   System::Call 'kernel32::GetCurrentProcessId() i .r0'
@@ -113,6 +117,10 @@ Var /GLOBAL KunInstallerStopResult
     InitPluginsDir
     StrCpy $KunInstallerPowerShellPath "$SYSDIR\WindowsPowerShell\v1.0\powershell.exe"
     File /oname=$PLUGINSDIR\kun-windows-installer-migration.ps1 "${PROJECT_DIR}\build\windows-installer-migration.ps1"
+    File /oname=$PLUGINSDIR\windows-installer-migration-paths.ps1 "${PROJECT_DIR}\build\windows-installer-migration-paths.ps1"
+    File /oname=$PLUGINSDIR\windows-installer-migration-journal.ps1 "${PROJECT_DIR}\build\windows-installer-migration-journal.ps1"
+    File /oname=$PLUGINSDIR\windows-installer-migration-filesystem.ps1 "${PROJECT_DIR}\build\windows-installer-migration-filesystem.ps1"
+    File /oname=$PLUGINSDIR\windows-installer-migration-actions.ps1 "${PROJECT_DIR}\build\windows-installer-migration-actions.ps1"
     StrCpy $KunInstallerHelperPath "$PLUGINSDIR\kun-windows-installer-migration.ps1"
     System::Call 'kernel32::GetCurrentProcessId() i .r0'
     StrCpy $KunInstallerCurrentPid $0
@@ -245,6 +253,19 @@ Var /GLOBAL KunInstallerStopResult
   nsExec::ExecToLog `"$PowerShellPath" -NoProfile -ExecutionPolicy Bypass -Command "$$p=[Environment]::GetEnvironmentVariable('Path','User');$$parts=@($$p -split ';' | ? { $$_.Trim() -ne '' -and -not $$_.TrimEnd('\').Equals($$env:KUN_CLI_BIN.TrimEnd('\'),'OrdinalIgnoreCase') });[Environment]::SetEnvironmentVariable('Path',($$parts -join ';'),'User')"`
   Pop $0
   System::Call 'user32::SendMessageTimeout(i 0xffff, i 0x001A, i 0, t "Environment", i 2, i 5000, *i .r0)'
+  ${ifNot} ${isUpdated}
+    StrCpy $KunInstallerJournalPath "$APPDATA\KunInstallerRecovery\${APP_GUID}.json"
+    System::Call 'kernel32::SetEnvironmentVariable(t, t)i ("KUN_INSTALLER_SOURCE", "$INSTDIR").r0'
+    System::Call 'kernel32::SetEnvironmentVariable(t, t)i ("KUN_INSTALLER_SECONDARY_SOURCE", "").r0'
+    System::Call 'kernel32::SetEnvironmentVariable(t, t)i ("KUN_INSTALLER_TARGET", "$INSTDIR").r0'
+    System::Call 'kernel32::SetEnvironmentVariable(t, t)i ("KUN_INSTALLER_JOURNAL", "$KunInstallerJournalPath").r0'
+    System::Call 'kernel32::SetEnvironmentVariable(t, t)i ("KUN_INSTALLER_INSTALL_MODE", "$installMode").r0'
+    System::Call 'kernel32::SetEnvironmentVariable(t, t)i ("KUN_INSTALLER_APP_GUID", "${APP_GUID}").r0'
+    !insertmacro kunRunMigrationHelper CleanupJournal
+    ${if} $KunInstallerHelperExitCode != 0
+      DetailPrint "Kun preserved installer recovery state during uninstall: $KunInstallerHelperOutput"
+    ${endif}
+  ${endif}
 !macroend
 
 # installer.nsi inserts customHeader after common.nsh, multiUser.nsh, and the