From 2661f953e20bd70605a490e95a18549512e06e5a Mon Sep 17 00:00:00 2001
From: HadenSmith <cole.h.smith@usace.army.mil>
Date: Wed, 1 Jul 2026 10:34:27 -0600
Subject: [PATCH 1/7] Working on gallery additions

---
 docs/assets/gallery/README.md                   |   3 +--
 .../gallery/generic-date-time-color-blue.png    | Bin 0 -> 42647 bytes
 .../gallery/generic-input-controls-blue.png     | Bin 0 -> 14622 bytes
 .../gallery/generic-property-editors-blue.png   | Bin 0 -> 8559 bytes
 .../gallery/generic-property-editors-light.png  | Bin 0 -> 25747 bytes
 docs/gallery.md                                 |   9 +--------
 6 files changed, 2 insertions(+), 10 deletions(-)
 create mode 100644 docs/assets/gallery/generic-date-time-color-blue.png
 create mode 100644 docs/assets/gallery/generic-input-controls-blue.png
 create mode 100644 docs/assets/gallery/generic-property-editors-blue.png
 create mode 100644 docs/assets/gallery/generic-property-editors-light.png

diff --git a/docs/assets/gallery/README.md b/docs/assets/gallery/README.md
index 9be6eb33..cbce9b90 100644
--- a/docs/assets/gallery/README.md
+++ b/docs/assets/gallery/README.md
@@ -13,9 +13,8 @@ Save screenshots in this folder using the filenames below. Blue theme is the def
 
 - `generic-input-controls-blue.png`
 - `generic-date-time-color-blue.png`
-- `generic-property-editors-blue.png`
+- `generic-property-editors-light.png`
 - `generic-datagrid-blue.png`
-- `generic-color-collection-blue.png`
 
 ## NumericControls
 
diff --git a/docs/assets/gallery/generic-date-time-color-blue.png b/docs/assets/gallery/generic-date-time-color-blue.png
new file mode 100644
index 0000000000000000000000000000000000000000..6040f64d8fd9a7271c620b8f0944bf5bbb3f863d
GIT binary patch
literal 42647
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
VdGXsOFg^tR;C$Gra3A5y{{XC701N;C

literal 0
HcmV?d00001

diff --git a/docs/assets/gallery/generic-input-controls-blue.png b/docs/assets/gallery/generic-input-controls-blue.png
new file mode 100644
index 0000000000000000000000000000000000000000..1958946891d856c284a7eca9ce3bc5fe51f2bce7
GIT binary patch
literal 14622
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

literal 0
HcmV?d00001

diff --git a/docs/assets/gallery/generic-property-editors-blue.png b/docs/assets/gallery/generic-property-editors-blue.png
new file mode 100644
index 0000000000000000000000000000000000000000..d88a22f4fe4c7325df894b3c5fc47c17662456f6
GIT binary patch
literal 8559
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

literal 0
HcmV?d00001

diff --git a/docs/assets/gallery/generic-property-editors-light.png b/docs/assets/gallery/generic-property-editors-light.png
new file mode 100644
index 0000000000000000000000000000000000000000..1201febb230499aa80ff0f4526716397c2667515
GIT binary patch
literal 25747
zcmb?@30RWp+CMX$na-(BPBWz~CR0sixiBr3n95A0Hc=TZV=hQ#YULIpDk?BrW8+4P
zX(`I2V^$`l<bonJQ;LZ~T8f5BiHM0via>zC|G}EGeCM3+oA3JmURRg-^1jdeEcg99
z_wV<+Z+<#>!0)f~md}GgAb<U8&+bDI$op*&$ed$;{t#Rl@aMC^ulI0={B}a<0{d6s
zk3U6zx&KQDq>3_s=EMi!@4uYe6NrOA7CyB8dyf})>lC>7ae~jWgu`(W2}vj7!y$h0
z;o-5k({Tx*NB;~SIW_OA-CrI_4pk0xWS)vFbV#<W{mX|cWl`0ygX^AIUi2+ru-5sk
zd{gqv^IzZm=(`)+!afg8o@^+8mXcjn{tViyN~mi&d-Wq_?J~IRL;l$HTJeC(=cn@@
z7ImOi=p=99PoG?0bRD~zY&X-IEa2e|>^{0X#KU8Q>AYnUL1Kep4eIO+??WJ8pgx3r
zv&v@~1oGkHa0q1S!QA&C$7e6T_di^`W-H_K`HIZUOdXqO?5I@MMo-&gxaRSm#FsKY
zMUwj0laeQOJMuiu1vsL!ji~?vv446JMK6=<)iwv{&bp}vhS@%UI!r?}8g{jv49WNT
z%KHe)`x#3o`V-_h|7$y$BMNo1<cKB)$|uebCFdX$S4N2pjcw#FUh!>S9h7r~ioZb4
zjZK8)O0jwMLBsLXv-&pT$-xjwX3{_%UBRoM>?)4)q^o6<W7W@SVONE9(6|I2LV_#Y
zA04U_;!8#MXuHVSzCHHkoC$(kO5y|)7wmC>>}6E0PH%XBA>{Q(pckZY+>zX~op+4G
z+laJI!!cV*>5=aEZrxu^drwQ&>k5~21lb=RfC<ABX3U0Z++(7a;MLHnUe>2`*RyfP
zJ{Bd<Wo0>MovA;p5G|Yod6DaED|1HPrc<ykmjkoTR%P(2?qbe6R6>=QI+gLqz+V;N
zjT478)rG$DE=spfsqn*%r+77lZu6Unr;_MI&*zaHSYIE4)@B0)QXX67NZEU8%;)Tp
z+W5wx-V|(GIE!2thZ2NOy4R|VN0{>Zt*YlG{k+>;2c%q-IogWOd8&IQbu(t=Y)Re!
z+bI4+h<o^4r?x1%yOua+2wYUS5|*WX3|Gs$x_kR@_8sDU>k>7x9oAs8dg(C#B=`Y@
z$lF259C0_fy)up@LLkBC?v+saW8PJqJa%#jzvna&7Ridi*!g|{8)k`Eei6b=^N)Ll
zB6J+pXh;v+!34(>TurP;QCBP<-BV!=EbZiJnj7yn<0}(Waeg`E`22-Ixi~_%D4eyo
z)G4>rl(dpjta$EpE%0VV|9bf?zCxc9O6z1z>y6q{`PR)IqR?oOLpdV9fn1y_DUaLk
zaRAnaZ|n>K6BHekOL=)?-qX=-??E8Fyg*x7{T=;By!Rk4(u$6v1Y!?^%OVKm9%HTx
z@cDa7GB!gX3mn0JKmXZr4&=c%B@4h#@JB8_xaVl8<Z8J6Q&5YvPDRox{RfBwqqota
z3oTruRq%7d6LV;3Q`~{O#y+8$60Fc}DkSF{mOFQ#L|(%R?UTIF?|BKM>L3G7CFNBs
zRDG)ixHCCrc;2~jX=M?)BQdJ>Ri3s_6X|tW&Q{nz82D>u{8*g9doaUD)e*H`zZ`~B
z)-rKa7l~-qNMJ$OnE^PwTTW<KkKuHaw>=&aTsx}nPb|$LvTM|gzSxd!188lZY$@)2
zg%X`By>on~okui&6z~x)aDXJL9XMSWQmgGB)8Yf$^*ZyQrQz(Ly|5UWp*K_|u8dQv
zp+x}_asr8IiWi3j<jbUetoA%zShwb-WTwy(RnMkj$dzLaDLF)rw?8qql&A4D=yklP
z&_Z*8HYQKdgpl{sg>_r~2N>MQc(X@b`zQSPoHs0$f-{{&>WJzQ;yO}Yw6Az=rlJ0L
zK}fOsnYtHG>K+ey+C}p(N}8sQnTbR%Uoxjuy=-ODHs0u)QUt$@3&l^EmuIy!3V=iQ
zlc)O)glXNm?c&&k{!Ug-tpeDZPS2rjFohVUZn)uXOwk9&YLid`8~Gc^1uQ*NroZtK
z)KSyXFE5G_*WJeaiRFw~;0t}u#I5k67;aQY4VK9_Kcz@0bt8Ha?v8wu7|a2YOJ$Oi
zU7JWusY{V`+}_uy5jB!ui119@IB!%KGhI*PMK_j7U7K!pciEfZI`tSs7+u^)J51vi
zhdB%NLzAO57>@`^Y=<{e&YDhwcjE-2^}<F@B9UX(g(Z@XMqd$khbQU5P)ljjF2lX)
z=PoOgrjz2&peGPUW0k^fl%W|Hp14V~jI%WAYaQIgMpA$0Hew?uEs<`*UyG?rpqnNO
z;6w5*+<SRo!6T)~A>B4=v(FZBZQN5yFEJ2dM)xR}i+H8-L$dUv%R4Sf&vvL)>TE5v
z2qTF*BPhd{N?nv&cBG@FoLHr2l&Hf&H#v@l!YV5aQ^b*DjWM3|o*8(v&>7AopALRb
zrg7Cqs(e%xpAmCXoJ?)TPTLzcMas7<hq<WuJr0r6RBa$ldUpD`28-EVNS=;dme^EF
zWD6V4Cd_ntM~RLS2`d?16VZ(|yz5>Q(i%li?Dpkz6f5sL3I{Lf{qL8WB7DWu;Yc2)
zF;-O1Pzcv{!xS70t(4+t*oIUeHO=H{8x;+m+e#;+^<DLh;2px}cqWhNncB}oD(-O7
zXz-p`u_(KCS+-OaV=*>HSUAEimUHEbm`@B6*+yhA44VX}bta!7U}}X}1MYbe5h~1s
z6+J!8Ekp1-B@}OY*JNH#S()BA+g*Ku91VrV)Qz|!DaK@FLyb7Q<v|MATqjpuw%m#Q
zB{aLYMj2gbX8e-pU9Z(Y>5UvbNJD0r4BQV3R{~pYXxLAS6PYzL5k?K%2p4D-yz3nS
z8kvzZh(}M@Arz!Z_mMVuq%cOy?wNSXL*kAg<%7CDjiG(yx(Tk)8{M_HdE*hhez|I9
z+)crI#Xy@HLu7<!>M`L7r9P`g^TrgCWYUip)OnW^MHE5g{ednVR9QD22~Ua15B)xw
zJ<@c{WhGa2m=`4>GnG9KNoN{2=1~Tnh#ZdPxqK^_y2g=K;x_{ezs{9LW*r___l#WT
zF0Ngn4AvDEA)!3;CV@>3NBNxKC*M-AhO*uGMX-8Cv5m;-Gnc9hl_L4L++ECYh&#hM
zd!H@Xz9Tk(^0bZ*`@WOa?f@&YSna8!O51OA&+n)$>NqT1+diUFrJH?#y>H3a$i1J(
zP8W0tm;$kI{V-g&Gf(P`Aq&9CmMthNwsd(m7C)tHOl%Q5k=QT46~SZhBgu#{!ZSQl
z)r^*JeqJub@HCoH<58rzBTt7biV@Lv(N*H<FhP&fL)0nt9(40V#2p96Dvo35UN{l=
z%1wzmn}okbxKpNH$a7yOu2QJxmUqyg{gjfKA0Ew(2n|0-S{SB`YPcT@O)psAY&S}W
zCsoSRD)q)+Uj-Uje;U8}zdK3(=$Yf+qLxELFd-rRQ&TctU2Ri^w@zFq>3=@5=@Eh2
zrH4d+Te86OE8T`{q_GE&dH{pL;$qYX^8}xKGq5=P#a9jfKZQK6V<@EQ)7N+(y3ftn
z{Q5J^$JguD{c_AU;Cpp#mWY99TqcSc`Z@=#?!iu6QR~85HjR-s3Gf>2MGj^lG9mS=
z;z&;c?s^A`7Ul*0ru_7=T<*+R@HhJvv?#PoHqrirO_^u%T0{3l2AowikQ6?5E6&&D
zbvn~)j>tKsV0%=mg~ig-Id9+_EogG(d$qriZ@MhA4gUrgka?2Zu)O;7k)s2onxxx~
z0Yo$+0uAN0OQ*wz8_IA>V|xn|9<N_TW-U6-w+`p|(V(a3jHv>AX_)I0S$#uDW;`wR
zzA&1-)$c+{KW)o{!@oGr@$b5|JBR*D#ErYn)hclvrjef485*k4J6DR`EYY5YYnmI%
zG!XyUiEG*&v1~sUUuWKoX_B~;PsAo5;%G@{KtEtL8awq^_W(yS-jhix#+y#(uv3Z+
z`Z=C%8Ji#cWvtBZoAh$WIn+;mmc5wV&<0t*2lZic+8>D`{@b;`JI%!C;gEY+lacsS
z$pWY5Lgen<yK7hYEX&!AvR$;OFL80W`^P?kyLX=wqjF#FSscD-(WMwa)Q@XWxjx{=
zmH%|(<<MLSn}8!?v6F&bYjf~;e7BvAdZ;;5C)m`KqPY{darNqWt+k!AsGO1@J~pe=
z9kE-xq0KF602WUpf))>~&Dd=Jl}j5cgXWd09V}Gch!=IGh)k<>eF3|74<CuYSTZxC
zpIc`>8k4M_k_L+hkJ5}vaa?T7obq2JDT~N)es!Ne6R#Y?u4~aGW+&Sl<@JK@I;Eoe
z{>WA3{oDr3srzxc7SFHE55E|==?w+Lsg!-{!^(j18uNO~h>8Zs7y0@5b+rUXr2H?p
z?PPmwANR%B)lgfc?0H3N>+`yT5)`$8rxl*1yg+v3ZLt<Ruw7V6qd2v#UR|w;u6Crf
z*u2_A=}64Vi2p1zI!|Usl1dLXM)ixDul7?BB8}5;CthX572(cEJS{<HqyEB$3(=eW
zU~QB2Bvwmx{c>tuIGbeZ>!^?Yq%I!psyR3sl?&aHgVJSU=@oV9)21=+QZe#mAT_lJ
zLGwqDi;DwMIgh$~9SZ`#*n&Np{52`Rg@|t70s`>E@{s2NU>z^vIyy7sSNi?besVcq
zA>_mah%~{llV}(ACc#vJtS)b?Kk0sKBAsY%K)Yxs>un>8>1KXfQ>$;Fz?iZo&^J<+
zbjF^d{`x}b*+{XnZ8W)*s6NIF%K&|M^K)r4&5LP0bUgrX>>eyD3DMw9*YHFahG{7)
z_Em_{yA<o4=yv@X!%@Ty*5swL<KU!0c}Bdc>_K1mfOBW5dh`_!Z1&{qFjB-TAug~0
z16KN(8mvm(CliNqMR!-M#NBq3SAJ4z@>Nq>ur;hPqk5~RB&~h=kkjhbt93$DW_*sH
zY!mW~OF2=(F+Im`ny3qXh9`I<6^R`f-lY4yq-#ZM{3#{QV3CyeO^%Vv_Uq@L3*4hH
zwdm*LqDa@{W}T2_b;2deStslyv`9M%>VyqoVONU<zh+L|R+Q-u&U_3V*kudcU=ciR
zv20FjFw78NyzO@nQEjlSc!I=*5_JzX`50oV`ste)-iE;t$b;H$l@`4X1JLk`rT+?y
zzaHZPR1ocNAz?}!AMTwT`4||c()U03+5g~>zu3vP#|>Jyakl#4Phn^@TGRaWkro!p
z9?jGh`vG58yz{~D0)O{Gm-;FbGg25^B;ly77U}iQ4LwTJynVISPe;>qMYGSskD+p4
zopK>!sVmv2Eez&UZkrWKp1b!CU^kvYr)kEzQ~9g0g}cn?$~w<eCpz$x?ph(Xs3J}*
z3jejkNqi=^-&+vAO}I)x=wN}Dc}4(i296TOEZCn)cfF&z2E&ljz%&-7Pc0SFo<7Np
z|BT)h@vVJXUS~2j0MAT|=xoOh!0I~Q50WqQ5_~M)BIbD0Ux~+Yf<^(@Mus=xo|M?H
zW#xArGe7aEf-))4t}ur}p4-N@OU~7Sd5R^yp&n72(93mr?A7gZA)e5GRs>Tv+q3p#
zNHkn%sw-G@%JuJUWsW~!jXojGO1>0(mk(=BDfG=MJtc2Qw#N<E3+!;+FcHbYbd5;m
z35dotO-3?;;U-7P87Bj|L*9nD^98)Sj($U9XBIzn&bnT|yfN<8IAx6{e=;78=y7JU
zBGmmds?i?2to+*dcCs=aQXF}r{bWJeR$i&8`XH=hAg<{aPVUZ+%9C^wvU{=xVOz-q
zbn~2@o)dL<&UqVPYR%NLaCjbr6@F6W?jWz6-}Hl^wy+GkUe1^C+#`V*9d1Wu#Jl`J
zB#>VA$TX8(?)<ZE#t(kG!{D=UoCZ!F7y$57Ps3Y3)w4BDZ5kD_spC^sa1Jer<xxmc
zz<Oof!yL3rlgZOp964n-1y0GoEnd!{++Bka7x}3hvNcIyFX%-}$hEOsC5KP~`PS!g
zTP>&U0}3lR2zjZUENq>*SQ9_%wEWJD_`Js<p(<Vn-e@aJV^<v4n(}*^>m?~Dk*q4O
zM_It-x=wmLBOiR>`OXQ!BdwTLz6`Z6tUvRlB<T$Gyjw?X)2MuNut=`pRdTNdsMb#y
z!KGG{vFUNCdW7xx&V4hc;A6AyD|!0*qSak@FNFFKe%+K2-!9L8Q~crY9&Bgd0JfU-
z|K!8TsnU(JKCDsc*81PE#$G}Hdh|MJFn|WDEhlqfsN54}$+({`Txd-!b$oc~Z69(<
z7WkDoW&-Eh@z%M3L)PnQ9SMxkriMT$g+Zsc1*?Uh@FNr{+CFVAP9i@iG3CdLL~rOu
z<&{by`2gXrXv~`|%+m%3truq@o@%Uq91)P~2R&FC?(e1}x=b`$Zp4qPN7cH?f^nwM
zTkM@MkrJCUz$h0!<psBP!C{pv!X?V638re-$YO!oTYip4qy^2M^7>eoDhewx*<1~y
z`O&x((J2}cbmRt3glklgyokl#gFEvCgfjz<##juFMucuIKUb`SryIwO&%myAX*_uL
z_*ZWkc3DO=Mhc6Y#OrEReUajn9eX?-!ng9Gxn}zztS7}@C%-?UZxQyd%Q{r|SgL$Z
zo@Pe?2lJNO%V$_<FOsXjetEaaK<LJ`5)4!~rruBf@iNo(?2%h6zT&y?#4FVoG!P#@
zv1E<eYgpX~W{r?bdpds2t&|Yo7{Zxm`#omGo1$r*gl1_kheLv6PE7|5lbARGd<_!^
z4sE@k@exbDX{cVqn#S?RJ$PlJyB1SH$5UN}@tMfAx!PUlLH4Ghe8~}}Yo-uC)p^oF
zRy0lYsbya{9IW1Bjt?AhOg)E9&s2u#NBN}@w3sMg`TdBT2FWP=8SFPRHC{aPIYXW0
zz_Vv|UBf_{o@8rjUJOGs`Y_Ee$4^LjMVQ8V$va5|k_lh2tV4papbS-G_HG(`5u46p
z(;jw7z9nM5@1vo~4w`x|lRJ@XW=HVuF6(%TN$;%H)Kt8ZBc4YlhMGd+`y5R*$J9xH
zi1aeqM;M0*9ig;hw7eI?EaPI3>UKem5K~t{ww-jRpqbOlm<jY!-A=lKfkW`h2$2jX
z8w%pMQ<9Q?#B0OcAkvd;@6%h1(S^{4+q9?AIejEzP8k*xz&&Qb-AdVXA;xgE5N)Is
z2e_^%qbWGTQq^{ko&r;fVXAEMIfA**S**iXil>Q&H+06A6C%q2L9OsE!OWDq?TFZq
z7>xGZ;VUExDxi(|wQdX_iE61F`WSaxE)tgBWUMF(`-~C@2n2ethlnFQO?{;*Y8|CU
z@bd*VIr%-x9gKE$1;T=eBXVKaZDr<s1)zrGVsLxnBqSV;`le6h!cvg#F?QL>_N8rV
zsW!+i2R6o7KFYSyk`7$=;B}Eqy+|p?b>tQFh3Q!7qirVS8KoI1tho8Nk#yM|1CU(U
zVoFAmBd#Ay%oo)Nx38d#^vc~v$qb{xV}e)UW#ORx5fL3-lZs@~rp-Dyqan_@!lzc~
zmg*9ZrZH6r{&O`&Z;X2WZcwKZ+QCx5g{QguB;^#T@W$Bn4zD0i0v*r3A1fh*Q!P4+
z@rnY*HE4Tu#>>qmA^gZJ8p86TCy{c4w!-s=uqCqA@rTLE+Q}2weH;-7jU+cX7>#vh
z09+b_jxv=IKgCQvL?9nNHz}e%5k}ott}6C}ig1IG+yYM8wn4e@?#*K9b1<5^tsGU<
zLCd(o;4vuI3yTA8Ixr))0$ih5da2WlG`5Fk8VY<9n{1=Zt}2iG*5_(rSbI)4Q)`c7
zPwS%26!)>TdWE|KFDlsbvNZD5mWWp&kvw!zzSK>vH4O{Z525DC{a=yPQCz&jNPIk2
zLJf#Dz8eTwnKutId1rEowb?exW801AXdRoxaj)RhSkIh_74Rg|HJx(mp;xxqEzV2$
z=HurzmT`j5*pz3v2L>vq5@~x}p{5EkDHQAq()O+yqNj0-0{3j(*x;KdxIr=6GnHe>
z+DH-2PeN9zRr31^74oL=DFwqT4V#`e`5D^<PPz`<-oT5I3?D(ESR(i8!%#ZCvE$C!
zlUsxgRWKOm8sPQ9ux<X5IBledhcMaGLsj6B1gm1=in5LH=@^kfEP4z>PLWM7xzGs*
zS@Mn4Wld~02;2?KLS7&hkQn*0TBdB$oqkAe)?8zuC$7|yo`sDpnP|Wu7%2<k{<Kee
zt}O|N(`-g?1c%kZtv3ea(hJJh&x>*ysP1@n*&aUX)rRz8(JA3552<`qo7Ee4WN&I<
zC9Xx<3v<vJFB(}Id{es!Pap;UW`zHmRpKeE;@ooZkWYE;uD!UcNwUz*e}8*^Ky!HG
ztF`)DI>&TJI?x4bI^HkfN9jAliRR8tDYq*XC(Wp@7}CzFp7DUX^kqJT;;=N7m#;uZ
zxDdT6J%zjSZ1KK9L3}G*_VOt*ekSc+YOde;`)%SCB|p2yh$$!@abWyx;z~+RnIq0I
zqZ*ufuht{6xiSy$F|W43G(~d44xbD>i}VWM+AP4q(?Y*VQi|f5md0#f{%|&u9lp;z
za(T_%CO_8L`OV1FZBBLgzG#kHKr&9i@o$w`qw{T+(+iNZ;PYt*{c_rq)Ldxc$Nbx~
zAoReN#=TR&s!*ipjLqe~R@4e_y6f^7w5PA~`WnSCOr#guZ6PgR5imLOKI8yTXpu1n
z(&8+JIJ2ap<pwye;eA$4p7NDdy853~sz0u0{f9fh?P#d4uP2#jzJEDY7sqAQ%=8Xj
zGdk?3WoY|!*CwVyAcE|Y1<_wGW?9uRD`8TT=JWv&EBN_Pi6@QIv8%63@!{)_7Ka~a
zmh}33H6e>fo@daapom|1p4%R5IF$QsN83reIt+k>95!M?>im3i3zX*xr{hK{|9o3u
z#}kH|l2Jp78O@BJSf{SQ>2SByGIx<Ob>irt;A4t9Bm&4oBuMZ!=Qa#U<MQC~C=GSn
zmgPn<f&jC7)cJbg=Qz*ju=#jb+STc6jr0|_#kydaFD`Of$B;*gYboAXoC>9kT%eVv
zK58_}|ML2pA@bSf6Q~b+zY87o4cIBl<CbA<g=Z7)c6w{l{0wX&THsXx6RgU_At)h9
z`9Q4bvuCA=5DOsDSFKY4OVno)@dQbPvcbdQ>NC!MC``$`Z;2i_%_%FPGMZ0wJ7<v6
zGWgCx`cTjO7yXWH4<a-t^Uu>=8J442#Jvenp0xAo(=wvANmHUwoL#1r)f7v*8qjJX
zV0;eU4Gyxo=aaGdUSL!2d3M8fKGQyZrn#nZvCNr<r*k@@slEXrMlDidfKN-GVcIKr
zW5y1FmkwG9?Lc9~PlV9pipAmIY<Yr&L3CD<2H4Px*VZdQ@Ubuc!+OtuVrraB;{l|F
zkm!*AU+B;d7CKAvB?G9|2==J_xmGxv?bvqivl>SXz>8dhdSt+T9@aT?_qTKfh?R%8
zS_8akr#3fXu~#a?Q66S}qR9TPBX3FdKSDv59G0+3+K=JPylDz&V949j4xFLs2`PCQ
z@lDOE_o_$p7Jw%S{r2}AF`=P@xqMFA{P6fA8Daf2|C+1v7U?xWw0-C4^hopf8~tu)
zRrlw|-Pkv>WVGQfrLod;y94i*Bd=Q;_*IVc)zj7ndqIPKXT|~dv$-!b9AoFR!?Gm7
zGlvi#B5yxbIF^Q;3F)EOt>p+XLWD>@m2w^~Z`Vi45vj3EwT!JP2~i=7n_*fIvQrN%
z49yjJPe=jKEM<Nk2^UPB<~l!PrG4EMHbJt9w^QH>0V8Ch`T;^dkwdKu$}OGo{Y&WH
z+|f6U)fM|dfZzIX*wKd-nq9P{#XB@8fVavapfoI7dt1KaV{v#Og{ILzlV%GDqAEW*
zpHSh$veaGPHFy%0&nf`?M7#%lFKQuS#lwQleNb3-{$3SY`)Z2K{9H$j`Zg42CX$PD
zNQ(1TknZH?)E4-WVv1z*x}XHU92mKBKGJxXrCB{p?9|j!LJRzWtjDT^Z<G7HW%F{r
z&fS$K2nmfl(Tcga;;H~Gb-w$~#C1>+h@AAuZzgexK7?1S4ne;9=3BS|<c0^vf2IEP
ze+v0K&yj4DE{=1B92buz8D0Ms9L-9e)GG7*1(4UzG^#d0^HHnbeDM*$rwB^Pg2+*t
zMNK9lB@wf<qdpt}l3l1Q%e22`dgUxMvjFS-akdXeKtFEz#oDue1ZZWI_2XePKtc;v
z-f^^Au3>0ssHGx+F&La5$jk=IVGBUmGLIvuoT*?aFz=>14vZGF22erG)<zeia;1AG
zGwoo5+0wIE?n(QyH+{@VRZA6dd_7o>h49lT>#?3>nYWFdrk|{gS@_aQIF3+g#Ff+%
ziNz!#A1p2Dulq{l8HJi?uD6r#TP#bN?NvxTP_fst@<d=OFTE<e1GPJ_e{mOLrWBF#
zx%H91q&v2uE~}wA=>1lbuI<;1_}n2!K0Yv1uM|5Jl(gSg1YjvKM{<qZZWqfrK7EyT
zphp7u9#rVYN2s5fk6N~Av{@-NdXNDz=tAKUb3*dNJ^5Hyp(*7A1!Mux?5Io>YC@bf
zo=S<w^yq-A^u+_6B{KZJt;mtd8t5Xn;PvC$?1ueBd)^(N9S%CDfpZgJO4NB7`#dKs
z_)NzZQ${@ODWE8VJ3#-^uv*y-42s@dpVw>7{HAK4i_I*dN>gSyFlytj#j-u7xX(nv
z8_%A}IY|}QTMb&C`~70slQ_bkn?|)e3ysst>JXi*`w%L}>B&)vonYX`Y|wC602&Wn
zMCYFj$vnGK^l^x4jX)NdrfbrymR~T9bw?-feY^Vd<38|d@p{9Okz-$z&oJmhOz(;%
z{hibrdpXrKIBZ6K`})W%;MNJh%$#yHwW&7g*LoLMJGP+zW?h16fbs2!@O%5LZlMns
z&>iJ2_DCKJ#0s-9_(*xx<PBc1E%eWj2QaI->NWxa{~Z0_Fn1Z4*K;7Xm46KN|MZrD
zwC=RCqpr2m1ML}8!1`j%+Z8XnD*}i$z_qD>X?MSjLU9@z8c6Dqjz$nr9a{(1z~%~r
zYc@1Z`XfvUCX-IWt#h_E0mx<{pzmg9Xzsq5!U1PK>M}w<3=jq9O-WqhCsus7A56KG
z4VgNppML5e*A|~Eb$kpZPIqc32y^fD#>dv>eaQv6H>v!So<Sr#A&q>_WY9#aTogE-
zp*L29RW&TsR#iCi3ZHpdTe6`!@}Z<RFHe4zV_)M4J(TytK5`ie@bXFgA?!-wGn`UB
zz&jU!^nu5+4qgVloCAzTHtWId(Kj7={eWm!wFG8F5ppz9f-g}ctJ*WFjn><0F9EJ7
zbZ=>Yi;(2z&iJU@+y9o2J5&^7l=jyOig+p>|F@MC>6m8J{sgqN#NN`JSufiO&Zz?k
zo6ub5#fW7qW9$^ZAJhz%Qv>qV#lxg1UqtLgKxVwel?P8k`1M-P52dZ%=EP%{rC=cC
z*XP38nsQs}F#~_CnZD`#ux7E`WvR(L?2*(IUP|MQQzOETMIEtf9;bG|Z<qAzl-1L|
zs{~Gus+{-YxQIa1NYy)z>Z`@FG|z^ClFY6h1?6^1Z=H8tsB`uSm$w8H*i7iv({z`z
zN#+EiL9_Z1+cXawEv{qWbQnQ};v_ePU55LC_&3&S^K0+74_cX?-?w1S_Z2EqJ>lh0
zc@-8~e(Xa?bg(H_;`8sr*B`Hvv`&b*5bYB#vJNoHSBL%z10z;|1O1a(I_fUifBi4a
z8m4!~X3tf#hG}qYd;P;~FBHJO{^7<wur@n8I}zZnlH&qhxeX0tnG!xxy98`3JAsm8
zHJMTv8HD0@w{C0$!9t_ed@E&*Z4>Wq>amqs!(I+RON%H*!}T|U{zzlvLBN=yfGD)$
zd>u@3G*QK5SoiJfT1PI}a#Ib4>sK7xZ15XAb2>3p5EBP`YIm`}xajKx-y74vb8@V^
zBACCX%C*Jxb*7uqs!G74GUG$P5;*bkXjKYapz67Zu7Xh<`Y1Jw=8~C<`M>#<xwjzw
zr(Aj8HWn-a#H$-KCW2x$J*t}zD_=SYPZd>2I~&Hc0}E8*PwX<Mc7@Ipu74(fCDv$+
z4s$2Y-ge~0EG9J9!zkG0ONRP5U`~St1ttAEB0TAK2U10aOJpcYKmJ#IHhAHa{NJQY
zS@h5oIW(exw2%psF1S#;o@0QHo{_Ob9EPxH#KyK#s{&SA3_74?q5^`)k~EXw13$=t
z4joE1m1p!_DO_1Dga_N<CUAKBE_w;I**#x`>EYv<z#y$FkdnAWHhRjmGy0a@0i(~e
zKrSDvDkM%2_h(Lph0LSGs6VJ^_QYJ<>LD0Un|gDUYqz|o_h{~#$xH&CuvoT~CoFS%
z*9j`xhcFF||8otlXW_M^rKcqP$?=6hKA*2T8<d;M+J`sYx~AnB7t1bMhA*CHsW9`W
z$FJf0b?J>`R&(7w(swks?)b4>sQOUy%;DX4h2-CsULEPgCKd@tX~&L3-`W^821RN|
zzHC~M?)Yn!GYRa%up)m1Cm2>gf7a-Uf?CHpb+dl;Pga<=j?OW@H1HXmCjFV{eju>C
zhCE2oq$Xtk>;C+|&qMqVxb45DF&@7X3UU*zu|^SxlNmF}F^%+05u5GP3!J*;*in{B
zx>UI2H~_83an%pHv5Vy#G@kZb5{)RjrM4QiMkbS0#yGT9(VQOS0mL%0d&6MezQJ<H
zV5G#&FhiWV=%DU}06_cUwhi;pAw(r#eHM2|9QhtK=97|d<Wr<n9uVutsTHApIaq2K
zeMM0mjX_b@6N(#i0)#9FhAKe!SYP2Lbd!%V0$u0!Hk?42rz+y!JFwG|cBlGhP4%^A
z*SyHUyZlJ;qqNe^!F4KdiaTF!8Xm!(Wl=jMaZMNS8fxN7m~Lg|3cys(AcZx;MF=(A
z^%a>8p_GxmXLa?;)}2ewyFdd>ZKKhJA%k*;(VBX9%_(y{8o;unn0(`SDm!F*s-Tn@
zF^lV_ZI(iU0Zb~iTN@M8R}`})I8>*Uc6uY5YbZ%BDuvc7Gz3leVF|sSM{Wx(STpRh
zPBZ5Hpl1V^qf>f5wkdpd+w;+}2$ye|F$?jE=F^Rx$)c&w1~iYa#st+xnfsEr`DNgd
ziuY<~CvR`?9bIe0m*a}FFAHOy$~$&0SBL~|PS;B(>9SIMV@|$2NJzdf8D;%IERG88
zp!0$19(}!J!MSxQuReG|vf{WK0LSH7uYf-u9{R%>t$)yx{<|#M-dwIR$udziO-Mw6
z_x9#GHW^2L_R#~g^8)ZHF{-fUq-B;yNE0<&B86IYv#1pih(J_OGJ~+lEo`%xY>dNL
zeud8b+VSRv4}tc6<Eb<BGW;52ECP3n0D&YQi^`ZnyqRlxVSt&NxyeKVfw1N4T-~|1
zA2xyyP34y9o1a-~xLOgNY!Z=85q%)0V-K82P&@=i$PRX(D7>+XmeaHp>YMB0A4uaI
zqMJA=;Q+p|;jSQ<$3hEs?68GEcmbJHT)=d4jtnEXvZ1({Y%caNNED180UbN?VHB%<
zO04Tpp6$%y4^FxxBhcGZ>~WL{#Dx5+?f_#TDd8?!n(XPMV}`v4IcFc3OV%=JXiFJ)
zI-hQNjL@%F&BG4HFA9h6Rd;4gjkd*L29aSdRm?-neH!ihou3?S+UVsG8uUC#33tg>
zNXx9Pqy^?$%o2-ndzm}K!7^mWP2O%+O3ccnwR#|#+qQ-{1YGp<*&^!5h)0Bq<nx$B
z<5U?g2qd);4?rLeUpHxnpr%stG~J%pEqkN4vAjg2F+THisB!e0L^m|8j`JV&!PO4z
zLy*vex&izFd~wjAdgFAoxU&jO{ZdoD-aLsg^F(9~!`xkXc_zs$kg&{G5c(^+9zTFY
zE1Z8U?Ybs)EZmesGmXWV${GxkQ*>kG_5G#6%MFuHqa}TCnLaDFvlW~Ip0krI%8Vc0
zPF8PcSf(&$z6e9q9L3<Td~XZVvE6+@w4`Suj7-ib+PYZ^LURWjN7dscj?iDblMo?f
zeRth<ME37LDg<f4e*kl{Nv-z|&5XD}?#28c(nn6+{u^j3;_b7yjE$Xb7_Sog15j6G
zB^}x`;uk*&@(#0a)`Pz@FSH(R6Jf}v!8heJQiIuSR7ryKW@RuC3rvC-*f8XmX$@xl
zH&|nofV|Sr$WxEki!f=EK9ccu0Lp4GYtr*!2u@AM4SU5gt8TCbGn0iSE-->XV9(4z
zie~I6W@h3nZn+D^G!$vu$MJ9S7!YM2k}r2DR02p?-JE84RlYqO-iFN`rg$4h4Lm4$
zyl`L`_~pg2_%oa`eERf3-b+sx&|b*ViRN0{XUB@e8)Cu2p!1vS=_@({N@quc%$3<7
zX3kZ8=C@e(feqeX@RVL+|M=vJwY3=2Unl+9Rcy(fOFr9lw|^q$jVK<oBKU?G5NF6Q
z3K5nx@KjD{t~&9@X={kC{G@LGa0B~%Nvy@1A2UK-=~TN?na`_~f9?@W+W`e^3nvLU
zRh~w=tL7%qq&LRd4!zkS!bwWlPMd&kOXRxYtjHq_i18K9d78;lhZoNG15YWy*}zV?
z%h~UBz*g*eAWvE*9g+6lv{eC8eBBX%{nl>##HVKP<fcZileA#i7^zf$w&a*-wSzQ8
z#u9+(n#zrTQqrFpV=HaAo7c_}-ugu=b*`)k$j%=LS`PCPDAD^PvOx;VGj4fJu2#G@
z9&J*&>Oe%Z483wftr<3Tok-9G0dv?e5)GX2>)gJ+5TvwETK_(}JM3ZWAr!~oaCDZB
zI*?<{@#bny0=?;%#8SM5^U_lgO)mo}r88OjsQ1#>@;0`azW$4qyE*{oj(PuP;Fn72
zOf#EEx(?eLeOGb5HjcZs*lQuywN(A>rCqkNl&IZSjzS7hr+&k0WZJm&t$6I<oiVkS
zpzy&g-10k+V_d9D$cokN36Pl1sZX}}OUvN`-iDqz5b@VsaT4LOwftdr6aP2m5GTsa
z!A!^l?KBXWLFf#a6f07X{a+<tm6fDnu~-vGx8l5s(06wOBmR`o9tL<4>Pah_MEmFg
zuOW&XWCPB*s%<RHAs9^RjVX-?!`*IvRZgRGEoP%G&&s`ko8f!ob7h==xbb6)?{<EC
z?y$eNe%O!+<BS4}2UwhQs^YCTt@0$Bf7K{Nw5B@e9GzCV9Z)FVwF=|S-dfcbX5x-f
z5S%)eO-2v_>sTqf^d?YpSTlyp3X{CKE<J{+%O>DLD3^>fd;9@w@F(!1kqoaobeR7N
zQUR!6HD4CZ3H^>a-E-1`VsrFaq`WF><=qW!jShgV>k1KRzAFkSXMQd>*i*XXR?s%Q
z;j^}>bSSC**yS~aPHk1=Q&Up|?ntbQu!?kFg>Dywi9C)4=a#mPTpb80ZmwTf`*^4y
zsq_XW9B56SDlhm4hs%h&Q@8(-``%bOzv2Pj*y*yk=Ff6zZ!I|DNCWHSx5UHx;Ra7R
zQMd>|ojvB07+1vCs0nooc8N844m;~!k2F}@uArUFQxVH5)!7+Iw{#oi-Lhl0fJomm
z=2=Cz9SHqVI(f@czDW!B>n(ST{I(M4<5tVIJja?o_>FqlN?a_H{|vB73#n}Tv&&-L
zZ7GM|wmAfe9sCZZ@}~!69FC=_(^H)M5Qzv%8UCR1aPAsCKZ(W8lXFbO7F2GSJpyfQ
z=6d86A2>f|@lZ;Q#|XVHJS#^+0b-6bayFDdfB*?zEVd+NlQ@$0@p4&h+$Yk|tT0al
z?D%w;%RoveWmE9ntAEd|f*)XZ_3^NH_ZB85H*=?$@h4s_(MXyB$w8hI+`Dy0e$>JJ
ze$SW!xkTP}fp?AZz4^a0Bl`#C{rL|$zhhlj-Hvh&2{Y?dzgeAX`+=$jkltFu0EZuF
zJ<{r7|E8|!#c2cVsaGwD1mbT9BxhaQtJ}K)JbrQN?{yeoz}ig3FKZSq0*`-lr4t#O
zg?J+&SLJ*2(4`>5<J{(y$45cLHCwt=6&k+;w3GaE$qaC>*%GBk)x`jt0bVa@ZWfPd
z+7oRA7GIY)2lD#<^ySp7l9^zxCKyCY42veI$jyNVZU^Syfc+Vu*VMScl|pMzeh7`H
zpmNv1Fr2i2T<N4EIGwPX<oz2Qtg+son}!`K94&yV5s}q#<_-mSD!|;Pp_%$<n(pm@
z0~Ay|ChAWY9zo(=+8S$9fudBzdmnPVFy%3jy>ez+;$~Vj2xFw>E{v29UXIqS5p@-Y
zyYsPR_Wc2?npCg?@{Rfla$-~F6dh3cFtluCCB^As;05La#sFPt19?CgU7Mu#fjbYB
zvTGrKzov5rL}g!!c=v@v!N^!{+3Gq)UBKPGg`l~oU?NpRAAyBk7#MxHDUQVe`MEiw
z*tw7gdiasYUb}()gB&>TcSy}<e5?@~TfApx>$Z14gM;qP)rSuWWAd*!gDHC5`>&Yp
z|7*6~Ea41qN;7Fhs%$bi*cB?U4>pA_`#rT4-o#Fx96|@?T%LKno)$u$Y_=mZ3;#yp
zy^=lkM>K8VqjEr`G2Q7WLYUu#y^S=iL<xv5)PvPaDS47^ur&^}=Nk;@g#_1ovoT71
z!B5pQFVmr}dBd$Ju&;%`qDvhGlgY{|Fk$IGTRCoOthZ%G-F(@;Zyze>P#TEMqX@@R
z$7{sDu6jojfiM;AK(Q(=1C^gly4UfYT99=|r-|`_DZnHOHx~sI>~iVVg!I_kOzg7y
zdtagh+tKfOHjluaJl%LqG#{JMwL;vpxnI{2_CvB~gHNey%MOSBcRuZzjG~K&0Wns2
zKIOAI=#m%qa%oCq3z{-F>4vp~(L2^3%{6k6L-Wq%iM`|QRxHGN{_f4x-6#PMS%-Mk
zEp3Pk*&t9F*^}-)>5UFH6UetcvF?VbpOoiobJQE-mJiI^6bz;K@eTGyaLc>S0=n9N
zziF*^@`AS~EiTUo9@jL=f4S-%<JPxCHY4O^Pvj5sKnUB<cAtFOo7~|Jm@%8T%$RIA
z6VzaNe)umN#gA7FusINj_$gPC@7Q+l5Ss<Ki&KsN$hH0ZOy_^dz^px#i(w~Y)m)+t
zNaPx;02EGfwDkyeSuCrls8E1ZO!f-Dz?^Vv;8yT&+1uzFjylg&t(A<v#5^!l`0U@Y
zx0yb0x+CRdzO)U;^;wgF_s-F50*eWk{fA%_1S}ebaFF=Zj~uh>$>O&dF&}7k^>A7l
z>m)JSj&EovGxgBF4@A*bSJLl0P2Skl=m*ydKei8`hEW5GaT9Jl5d6T;?+!G-erRKd
zj353K925~NBT?D1B$q2m1KW}3a?~@SR@19a4&iOl*c<fIn~nr;Y}2&8cB~>dtzEMh
zKPaXK6eyYmVEpC9@6OSMhjL4=g#rOE$YE&yG(CKZZfpTsaP?x*l)XaKjuzga`9pWP
zIklDNx#`yGO6-kRV~?KzyWYY{pFYNuo{GT0LuwG#VMCSsHF-aU9>V2t{1N#FGtYU`
z#abRKrf5g8KfQuiAuJn=@1i06#kOG264!gMohEfV818`o$D>UfK%=hKy$ZF5={Zsz
zv=bLHKYYM@{u%CfE7XFKELrJyL8`-o3O>O<p6gZ$-J%0>U0lADx??^LVN*;8YwXCK
z)YUE@_-+wjL5_nn97Ms}hRQJ`pIG&rFEis?t9LZ|v2u(@2M^AVwe1Z0!Pq@;5E=LG
zpzc)p3vg|RLglyRjng5%Va2te#hRbE;>K8^b?WQv*^cQch;uMX(uTHDOuK?NUOnBy
zdgj!#DPWd$2D!u_sECn+g~>SWazV2Z+*%3(g_5`xvRcf04g;~BvdT|Q$xWwqo7uuj
zJ7n13j$Sa8fnV%udY{Uz-`@BeRp#E25t%#4elFH68%SAHGO7jSc8rAMuwLc1u*p%C
z;!13Pnm8Mqfk^zg&$49N???9E#SCcQtOvGETJxTdI?w%G82PW{*?&iQ{G0Ijk3atH
zegfF^RuJ{g&CMEX=}Ie)SXg;M%{U-qQ6EOlzh~pKtT)T?G>{&)rv!?Fz76(}G)!1?
z$cp16BR8Cj)<0k!1{o9=x{h_@gPjtPa<ND=xhthTY>wwP>!a+;)POuiL(u4$^v(6U
z&v&yX#IowN5P7OqB2)}bMvGIj4$7A*57(g^vQKRl5U1Qtz1U)={GOJIGj9}baiD~X
zJ^W_+hO1M&A;DYT<ye%C()@1cOG!o_mvbg;UJVK*c>mh@YC%2^sDWGk#3R(eTcUQ1
zkb6gAsI=2~##4o`%qSv>r8+$@PBqR%h03XGNI7j}k){7VhrJfhpv~a)EMK?xn9Dhk
z&tHxDc77DYQ#aYwK*~xE$)<C(AfZpAH#GFaC}<I{is`NcMKF!UxRt_@R+&aP?|21Z
zE<Z`xfW#AFH(uVzi1+f9L~NZ<<Y@~lSFB70>~|FE@8vM96}s3aNbNq<hX+D)D?^ia
z*>V9-bED>Nc5Ktqs}Ib{AUByp|9RqhIX(C}$h9Yun%F(+px@cLF^etacoZnP8E!t>
zg?f3X4m16JK1DtF!Wqw08j{bTp^<;tUy2)(&YWj;n%G2c8Q#=uN+wVbGA6X92zkGd
zNw?-=sI0jdAmn@Txb>tcpH>l?@?I}cH$0bNn{f&Ac`QKPP57Zc6a<+-k!xAS<1bMk
z)`Qf?{~sLju~&eO{s6L#{(lex0fezCCLE9-w8*MO3@2C#5a%V<bEGhSW~8G~m)AYX
z`AL6rA%KV1<q8Iu6gLCH4>Z|g(y3hd)}RE4ZFC1o`C`hfxHB%W3fos@j*mg1@MDb~
zCav?G(D#*9=o^zEPZ}G?llC;`SZRaphN*tl;^H}!sIPO?XQvLu7v}!N1E*R_ou`9*
zYB3bjIC3E-vFLlC&A>;jVUOM+E8c#szLetKV4mbbjS<`7k4w__MF}I%G#(>?V5KyU
zd0(>O`Ez~j<3p%HJR*LEHQfEOekx=>*7oJG!TIN!N<cN0H#o=$8Gnm~E|hpy%|@u)
zNF}NKbd<btEy#qk?Jp*Q0vu`C<`AfAOFHPo;dVKV%mJ9rCJ0mxnue@0y{<Mhc-c_o
z04(G5!1}nPUblb&7=Qe9v1bIjN7%@Bdc4X(gvWCY^~G_;!2_`g9F}WwFg=sUj4?(X
zn)Tb21HQkR0PA$>m4mEo^-8`D?7Y)(YhXYH^#Ip{{>*$5aa$2yB@ktvb*`Y~kF*Wt
zuf?4i>}=>uY_ivhVG+1z>XkrKQg=vY4QWNb@0=HrQrvG%iWjeouyki0+uq={I*+lT
z4IXM8%Y`gZu;95dgyqSPM%&3;_+b(*MNzA}Ucsmch{~@;ni4aUJsUqp(~QrZghcjz
zI<(ZAa#8LkE=P>q1KBmdNE}eA;0Z-U-Tr4-^LK;e`T7VepVR6NLe;AME~TI;?+Nv@
ziigA;4^eAZ)o;6&$WpR69jE(6SocP2Xmx>_=y2CjF6}$|l0%lnZB?P=ZM-V7Z7((K
zKKhP0pep)E7Z6}05){n^>H)VLp60CXbfNcz!rgvWt`QTSlu*OBcC-br6k%%TH}y_z
z3Gfu?r{>|?^VJg#;1JKsINf9_nFxT2f<1FU)EKqdquhIfF*n^xhk-~E;Gets=WAi|
zcWL`MB{P2>8dHwiE)>kh%hgJt0)7@Zxrb=FZPn@vx%QJ!lL!7G)cX%2=-b3TfE(QA
z|KF-?0uSec!n8zC;)Y%00Q%heYBwm-3EbEg5D>6k_NJq7yUL|PO8i9KY%S{8Ec~}r
zC0MQyFOL5PhqqZdMIaxG?ex!r{T0BkTVpk=n6ArfvKE9*ag@ugY^AykiZC{~B`R0Q
z-8}00RUBUW=T2<|H^K(i{<cTb0N}5HkH--*Y`#I`9&KwBd<k|Edo>_<2GeYO;Q+>T
z`a#i_H&P0KG4{WJFMGgdg%Ko)BNv+!&d~qaYrWl&J_M1ebuzLrARR=WE{_6#2qVBA
zXfmd{?Dfa2q};l{F)MR7v=Kh2byY~w3j+;#BN<MT?&qchojn5GZ7@MKFSOH6zt-5p
zuD&!R)2#kfeDWQ%u|{>+^V=Aoik#X5OAg0EDPe`?@M2@LH0b>>bN@QZVI3pjzL8_{
z3`2(o(iLMQ4VJhNMK>n0oS`E9P>6yctVO33`5K?a7`xLBJOnj2c@rQ<rmHHAR^qvr
zwhO$i1%!F@fYXW?yU8+Y+2+iXuBx)?Jh4X(peW3Vc%yf~n5<qx+Elp4L9Sl5MCN=a
zFhh|>V29)j!|p4`@j(UTX;1iH!S)(gc+C_5J2^0_y>N_k(@~z>F}v2*1QwSYnmaLR
z8v>Y4EljMSlVUg4{k(xpbL!qqllEO5O_`|)C^mxg4B<<3IMJbaCc*~&x4sJ;VpSZs
z^(5;^eCp%E>`2_SOfz<lRw00QQTiyBgFY;W(zq?4iiw(se#_SE0N*-62;RvpJDDKf
z4I?0>ot1W_J2^)_RcMdq895j-8@TT{JHJOWi4HC2<UD;>k^&xUy4MqaCK36i`Q%_U
zv1ko4Dz_g<!svk9utC(K$~sK@-qTIZ(qldZrQ!(B<R-oU4uAqi?(jw6wdn`mV!FjL
zujX!Xr;GiQw*W1tguQcc=#s&37^fMq*-pL(qQjTG4SDbV5oYv{hkk$P&f_?%P&=#I
z0`4YQ9E~C#SXCS;8QC<fAa0b;d3_LsJ%@eElpv!jHb(cv03Yxvl7jdUs)0flPNqR>
z4*)@SZJX2z=7Y?=3sKHS``@+No#3N2jCDF$X-ro%!9@(GD~2*+bEK2e#r+6bw=&Hh
zk;<a*N-LVHly@CPdS7|fbXsB&_*R2E!u7)NZGN8RA&D85&*$7@ywhqOj#@(Ip`M)m
z^=^2rZCe`k{Pz4v0>1<(y9DO(5fWSw=Gq}a#uk+hI($s=^Qjhef_gEvEV)Cytg_JB
zFoISFH{htR$O4E>CE0aWu|1qy#()Wj@)Q-0aiylSf#{9rqed{#%X8F|qi5q|4{Pvn
z2}ihIG@zRS_4^^A{B5)1>&@x+1M;)yom%RG*_g+iJY5VjW9>hv9y3z3*DF^P@w(KH
zgAu;Q>=DdzSjVENjh4|2_=6sxY~MV!sDgj?b|$ZMbr3%omdZTj4(>pR*Hf0AcY7v7
z;y|giCT+?dly?-6w-t9>$}^vUyj9LiKJ^Vm*5rn7+DC}`665XkZDR|un2I1TicNId
z70XP3s!r4T8bAeJnmTP~Q-c_MVSuVjy{x0tvd^mGUMgAe`in8;BHlBQnwtb@J<o3(
z=}gSfj;$a=_j4fTuHjoauXkM)rF+^wfFB0L)c*;5=w4f^sUM7Jgtf$J7NqtjneKwh
z)qMn`Uuex^s`7WsaR)(y2@x@8iOlQGcOPA<jFiBB63BlB`6@=zha1~cUw^P_b+C|w
z`M5~<CCJp%nid?%)xDU%6J&)Dxu1E^zF%D}8#gYy<*54A?gvn%X(WA>;62yp6u(cm
z<sfSCd)S{r5{TAxc{FWdhV_+^KbNr6JMA77ZjYnGTwQ<U{|53R6J6~V5pIne*LG@z
zzk;)80YVf(OJd4EKG&tUeVc||u$FHbFW<T?O-{q(YwAOQQcw*>5P+B~-Qt`P7ttXf
zh-O`A-E~SL{KAJ|14?Sg=91IS>?Q~vExGb}u<Poni+ws|Ng;8e@6gbfdGgM8_lHY_
z56++jWVgK8jEQaNXl9}qZKV(lz~$%|Yfc4V=bP|Vo;^BZUJuW+D(!x3WuM({P+Iss
zg1a<=@3Y%svvuH1;jep0wgPX}?4^xh23^7TAhA)-sew(5vYjjWiplEFDLvVzPB8c<
zX`Z1(Hl@$*2LM`wAA=bl7{`5%kgsM68~frHT}p4`(7vt6m^z&X>ZN=(F#?EDaC#Zx
ztEPBrz!e-C%5XD&cQDuIl#_K(D~JnQT<kRJ7%gGDb)*Nu?7u$X184N!3<^;sPP(_9
zjm>Yanb@)MZmAQ8a5VM4X^)F&l36SrzmwoxA!~@+V)*XDGf-~zMxA-07R>D`=JeW5
zgp(+3;Rx}u+u!=s75Sp|PDwxTX_-3`=fVT3fw<SZrBvV8fW~->BR^wo)Y%xQ6|f4v
zpTcOj`=+hz&2P7)$@cuWvxLNaY?9PwoBtYWvLA2WzQxEcbg{0zGx5V5@SRZ`^CLIW
z#XUApk8R)BLF^Z4!gS&K%;eIp9am&*@{{z=qYAVUfRamZrdmZV4yvHpv1-<$5M)1E
zod)+g{X=<VP@B`E-#gq&7e26leN@J9*kYN1VKH!*_lGA^Nm&V2dcXSWxZ!fEWYH_G
z(-3e3!Ky~@IgL%3@pMI9XqHw1wt)&m_aG>*5{D;Hms04t!&*(GY}WYEn2+`PUPL+(
zm^J*ADDrqxIS4h~DqSAp?E`KAF+#>pS-U2VbxVQk8@1ctKw5Z1lAeE(?m00!7=if+
zROUaD_tJ%ePB|So7CarW-H4lIPMmIVbI&#OhQ8)mcbbIPDww!4O|#A?C~-`$FWJ#p
za>=*OZ@fC8?3CT_Ep<i8>GPM&Iv%{RBrRj8`GejDb6;M`r<B+LHT=)iD`r-$RdDz>
z<s{xGOe47Dc?RQgDADzwe*aXG_S=xn;o%M85}SL1RNvwtcI0j?pQBplqyIq<xl*1-
zL_F|NEhC(rEMC+HGjbvq%RU*Iv#&TvYl0})k;Au}Q+-cy$Bo6PT>on}pA*jZ>E_&3
z7hfv3RV}+@s#c}?qP$OdKN!CKzj?tn10)rs@M!>{axTzXF_5a*U7HJf(qJwoOb#`_
zZhGmpMt*r0Hxg6^XeXK$sjg({vZzQc5l9^Cqo?1?!_2th?XBglgTXLh1IG7yx^?^5
zHe+@~VqCJYl{I`(b$t&fa>%PwvR+fA%Zhe;JG36egUy;bPTtQ-JR^r_)262!@CoS~
zJX5#tGxL{Q_)P0-a`eTIRm)Y&;N@W4pdxT4!1>ke_dz^u-WFA-bcMkrD-~8E)I}wq
zw0^0Hw(_J2<gE0!FT(ZUtJ2O`It|y>=jmb&M@xj89(kAQwVRBPO#K$qoC@;KKSgi&
z{f(0CgInScz<W|}a$sPtsbD%IsvIL<W><@la-wEuk<6X1jc#<lLFDw;6-U~Rbb@@G
z@sEt-hi9b8_#C2+5dl4(QB94qE>?u<db0np@lmR;U_&}d_$YM^CoGTtX{yk=X{SaU
zMLA@vqCg@6fP~Bq^N3B~1@o~k9muhxFVF#3{D%6+uoIj8#-PWS`2-4P=cH7(uRk6o
zSu@+mmeh5Zxoo>SCxWmQ9xl<f7lBgi?q_jVTa`oDCbw1dPY=}Pw}v_!2|qY;fwwoL
z6b3vrVk6G7idRPdzt+w@s>y53!!RC?ZEdU7a#0Yfj@C;s3L+#8!5h$umZG&Z+|o(`
zHC#@(Lr7xJjM5TJ4wZ}CWQ0L$!32pAZb@tfBbS5%LPP>-2@o_u43I<<lFa+Xo>^UM
zI{!@PFBVxVA>aPKz1QCF`#e9kCmOGcd3WPob4FHu4r}gj!w~5Dg~>H7fES|GA0ICc
zSHL|lsL}V%4Bu;%d*o+Sb{OH|lk5ysm*k)JYXOJ5hg>ur%2X+`PwB$eW!Xx+Qt0dT
zb3fJH8-8hAz>B_X|3N1F_u?h#_0ozE=l6N8n@Boa`^9K~VTp|K^~28^R4eM}mzK0z
zpFyF_1G%gb?X_EJR2Zup+vQHy7nDBh?HNghJ>0d!@v6dWzpY|5s7HaLm)XwBCMuyk
z%#nJqcM_A={o;79ud$Oq^727L`xBo~As`S7#QclqL+>}#%o=QZ=!!?2J*;t$OipxR
z$d7P?!y8mSSBA6uzS``<_p<)3^SNTrSeQAHItw)m`Rt2SGnQ>RpO$8qb;C8ii(T7i
zYBvZ>yRu5{q9JgjbWQzoPLDta^Z3kgd+Y=yMrTs`Yz=ZFje87@`(cm-4oLOF#Hb8T
z8BGzsX;O}CnC#mZVIUWy;+=Y8w_%5G^Re3(-ffs((OWEdh~~l<l6z2F^m(|U*{r^l
z^j+Nq>?w3Z;5ILj=D}sMS@j=SqG?@Sk1;zU`|IhsHH3pIL+G*CDNk*bSl6ZOpSrV1
zw9}goyDi)aBC3&vV>tT)?9qk2Y`Bw@9{8$BY5dsMbHU?PHMP8<**E6DYnxqfI6aRg
z@^5CQtiFUSDuhK_@Isc|;a2xwbe4N8JmM~0+kmO9a`wN-b&BARP3<w}vCpgTueyqB
zL}oiYg{K($yoa<Ay$`r0FUvbzx8pob)Or@)0k`sZKmV5%^ADHNKl|c=UlD}Pip!N9
z$$-L<3OR1~vq~VbPFGeY(s0%E*GyMMSc!mXYPbCuaq<qM&+cQokMdLoT3a|YFP_lk
znE6^4bZ%z(DJUM}mXcR_1HMuJI=_BuNGynu>ciHJUhdZ8lbsLyM*b$~ML~J_gri+k
z^T0;lu?|I6?a`t!XK6H{{!|5;JwBb?#so$P6i;QIXkQ3Z6~84=<SHH$y$ny1<B2{N
zS|mwQEg=p`_ag@esHQdat6s0SyI-|D6(au^T&_8@;QXP$#vOf4bH*XE{gYO9-;jQT
z8$*;yIch&x?ghCL22H@|5|BDFj70h#Lp9Uxuku&!E2ZlUm!}_6AYrn^tbF_VCkACd
zBJFv5^6M{V`I7lb*xktl`&uZ;4m?phx~WvLfCA}TY6WcH%2xbz&xEXRtJJL`Kpu<i
z;d^2^+pJvc_NAXb3p|6)Ydk158PbMkieH@cO(PCV`yK>}D#c@SS$H^7bMCQpPGaGH
z1oyoCe)Vp%O&BnjWqWtU5q_FbmWI8VB;%w#F!UFWjodLd2x#YUSejH%3=JXXK-Q8q
zEW&znI5Reob>S2Om#(d;d*<g({~ARbuD$<~agIxzW=v%!#{0(jr1?go^SJIKqG|;P
zGaeUF$#LbG&qPw0R3Qj9CT%U`V=je#fgB(p6A72edMV$Dzwuiw`ENJi*kFYIyrckt
zP!N#*kKvC0l>L57V0wPgpno2PQ1BUpz^^~l0CoSsdcIx*?#2PD)|z=0O2H71db;QB
zL%{J{J3l$_4V|pjGu-j4VCI%~mU$B`1P~&tAcZ^rZuH};)>Nj&`L|vICSMk<;R*>y
z<myg_!yx8a8dZM00{RBiSH(V~0!~|NYgS^!R|k}FnPNcc#^cwIN>M)2Qg31QxaS@9
z+01{n9QW^o6qt`aa^2&Oqq`d)i*r9OxEtwQy?45ai#bz<x?Mf#e7#756`h^0nNwt#
z!YMJy%p(0H*{Ex~M%u1p#H&=r-%<m5lA&(_^`reByShp1M|JAwZ71RCLkm=PV-LSy
z8(?typgWXb+D>8$=>I9{zY<Lr%ko3_C^RQyl65V{jDr5fjc&Cio6zfw%v{<vF0#M8
zU7ih4#NMZ`A^~1Q_*j#*s=aTq*;+aCrs+(-UWbi$PbfOSrOtups4N`vOwPkQK6CbI
zF_pG#ZK1jqeEDf<Y_e_&!_-!1rd9Nyw7aq@y>xRSKWuFYVmm;$?JKB`Q_f2j$WSw&
zFg@rPP%<}~N)<-Hb|W!fsCIt7R_E4T9cFtzKg=TlP2)!AXZfXyWvRx`i9M4u&t~H!
zGOzW0lurwy2yxQBtsa!f{79yeRHnS99Ms?HJAs%i04imk<|RtCrlO9t>IHtE^Yc%@
zu&5s0dZw(kkB!;F$LTQc1kj(S=STHgsxzU~Bk*sIg|nrR-5#cv;iV{%A`7A~+(eE0
zSxf-&Zk7>(Bd;vuLkGjs2@wTH!cCXMw!wzr^p>6kpF812D=8^Ik;D8XJk{e=0*+})
zl0eGMRP*@uhLr5bBD{WwNP#+6LbFSeI_JOmAZ$>1)h(=)BGyrHp$D+?58b}!<~2R-
zYrG-Iscpqqp27*Qwnc(I3i#C$gi&c1g>;9>1~Zplsa8n*GMnP%947bY;Z!OcavtFC
zC3j(>$`_|I?h<|Rv(=Ei6QLDvV3FQYMW>`(%#=E}pgc;ei>1AB^CP-^Al1t}xfs&<
zLvt*Wzj3&Ql=W2nD7kL2v%yii&KG+PAtxX_s@O%ZUTW0s>26G!ejRoR3Yw?aWZ`tp
z02Zs8bp&ZxabIAdyX;v_aJ2iewBK&};ec~Kw(l(S^I;1!_K>rff0t_i>)zdi)tIfR
zg4TF@88%(+bxMD`WUTw0o&{W#+`ML&CzX#B&tv>Dcczw^o9Q<>jjcOkA?fFc+s~;&
zL4>Dao8S>^tXQk%Y6di45}})VB~mv3-I3nSK$Bj~%U#&$i4g=jghv!amGdGx`r5Ud
zduC34I~T%?G7S`t;R9g3L|+aN<+L>iAvLyq?Nh(Z+rfnS(b=dwJ3{!){=v*C4L5R=
zgt$;<awnoHP3wr(bxz1VBZGBLulRAJm7cgi$@arM8kb7vNRVQ?ljDCM+ykgoueky;
z$B`^p)589_a!jo!L%B{03izBjC`y56Pn=k7gUd7fEIVGyM$R?}IrT>=&!6R5HvaWb
zL%~RVl@fe7DN<QyDU=Z&rH}x3blx6O*+KyN+$>qj^j9FYb0;Xo<FtQB@Jzl7R$&b?
zWWGV+2fG`fS#>1{-(sF%pbgNh`Y;#~@e#`&n5=9J(h_SU*Rkdd0@6~8zd@KZuk_%?
zBs4QX25-f2{u<j))y<By3FQEFWUAGaNKY5Bld)5mU(T67B@LJ$qt-*$USvfw<X`^}
zBxq+h|1SZWJoE$*lQbU6MXJFM7mT!?C=bdr9@t8nzSIUfPA%$(#u<p46L}A_60Xm5
zHnX<!UyDr|#i!$3;z8X?+VkIyvWJHNjus;jngZ3?h!Yvw><2ufA$(QjLE`-zb#7NT
z|7YElmOOsApN`=`0uV$IwbT*6Ws80og)u9q{H_3xK#VUI#9A$x9oSYR0>r_EmGJBL
zqaAirp)yq~p3RDd=g<4AV98N<*s6E`Turv0HG7|2ozfeIBpul@lK4TG!1E}^!bqZc
zrshCm*W*Uqbj27Ye02hPAaxvn&4-PA0z9jaU=y|BGWSy{g~i>kY|?lP4=n()z3?a*
zeA(#cqKWpE)#H^i&Xbrs6>co*1aQ_h6B|c6oFPDE?5s@hw8?dT;vaC#aL?}oZBE!5
zqK%qF|Al#s+`F%J4Z;fF0zv`9dEs9ot`*!tb;t1CqCWkqxG3jymt>Tk^zn99Kb>69
zhSN!VN_H~?(Aiu~U^dJHHKLauE!k8!5P2{P*NSbwiwo4BrH;kyXY=AF>F<D-2unsp
z9Fj)|F7B3v9z;CvsuLb{sFLY+|Cp&gFl887h|DtXGaN95H-MDN2ViPM^Xnb}g%;ED
zXl0jRuug%S>i#@1%vvCK|9vvlf(y7!_sbkm5LlrnJE&|f#H-{Wr>7t@4w$q*oN@op
zFG`+(n}i(rFK5W4l~r!nJnms2R)V_(h@+R^B66Az`%Gl~rsa%9u>6m=sgkE_m9%d#
zHi&N{IT`*fKk>&pm#Q5uhVsG964Tmbn>g4#mshmAj~0jUUks7?+ReEn{M+CPJ|Exr
zEG?DYO2k>MQALKVFIJ3EW2a{vQz7VF9{u)(o1l@sN&uayByP_Ag-xMUFI@(fr!RPe
zb9|+rCnJ{45@jx<dI{KMnUYA61d4hW=S7Yc6ehPr{Xu}#5^nSHY0I*ehzM(%einy@
z!a3D=THb0pYu<5{a3(ex$$?0}O{Dbpw}cRwQi(0%5Z@y_NfjodY1DGwdwIDt)MKi%
z<wcU0c#$l1zM5)i=B&tg16Tvp)a@0G8UFonLa%9wNB=#zNEQD&|EO;Cy=Se0xdHDv
ztg_7|`7WEduQJ}NY{f4-KY^hvjCLQQT;LX5YIZO4tKY-%+s`X89hTL7!QQ~}Q3?{y
zNwDLo^CZYNOSZwS{L{P4Ki;GU4ZB)2Akd7fO=fMPX;>X@Q30{au?z_fAyVOsPD`pu
z>}4?<geIPEOQX+o==j*+K9bWdIne90DkgNbo~AYkmy0b)CL+9>Z$=E5a73hOHW!0{
z5{Z~c#bHL<pq#2V?_F8H?Im%UL5I9ip~Wbr8*b9EOLIK=cwBO-b`?*z3WC@+TzG$5
z0`HsMUF50eV#U0#MQO=4Emm5V4J`8vT~@lvn-1d<bWC<-*-5Bz;vLiUCR%iAP*<ix
zc+<9$N+icrShcbVeJn|KMYdYgOE&~ro=(4!Qn~8!4YNrA9oxbQu{MXk6maiBCw*iK
zjm&YFD6wilTChs8NG@Mctmyp)$&qC#YC@RM51#^K<w_I+V=#=nr$a~!6LHLDbcrO?
zk!orA=uY%f=jj>zn)(wU!*ofi5LEM3n^>>CIf=}f3ev+V%?qSBHK`CJj<M0Je#!2z
z9G{e%M~Sjs9Ueksn~-8so5zZg%aGsQ5qm3dflxf8!80QcFJ`N}`%<l7=)JT~3mKgt
z{DwH7s%d6WO6b}Uy4JA9@|=|*UQsSQ7tE{`rMq=*745lBW^;FslUV$;4{Vy;%q&W9
zk)kO#l1ciA8E;n5m+1*}YjAJfuaa>j%%zhA5k#iaKIlM{uJpXth>F^IhgV>!w~KzU
z%jB<m)-oj0IwzU?TR&0eDnBW<t@qK;WeiKnL-n#mEenreT3Y><Cn5`!XyNi$+3v1m
z?zs5DDqI`3?EI}d#g0b8rS$kpC}y8?<65We1(>oygaL}i#crxK0^JQ2Zf!Vzmjb%<
z%dYwf`t}8t&<wpcnxWRqvY{F9!NxMmcVh{*#~BMJH@sCn;iQo9io2{cS<0p4reAI=
zr|&2F^qJSJFkwC=nA0~Qkn>(t_m@(iZvI{!Ir93Z!l5XKskI{4!cl5&QYE)<C9uh*
z_EYVh*Ndihe1l>8VR>^a-Mi28qpuf_0k<9@<wa~%Vje}4Y1L7B09qrLYA2|4#In1)
zBL`J~EAne`lJi3GXv2q6YLZbFqwC2I^vjSo@8LiKA_P+^pD>bqh5bY4khh#cR`Q$2
wUR8%*9{iokn(d;<e$xhb;!jR@i!be7YtQXtvs3UtLu@|s`}ipP@E3poFS~OHvH$=8

literal 0
HcmV?d00001

diff --git a/docs/gallery.md b/docs/gallery.md
index dd08e173..98e5ffa2 100644
--- a/docs/gallery.md
+++ b/docs/gallery.md
@@ -90,7 +90,7 @@ See: [Generic Controls](generic-controls.md)
 
 ### Property Editors
 
-![Generic property editors in blue theme](assets/gallery/generic-property-editors-blue.png)
+![Generic property editors in blue theme](assets/gallery/generic-property-editors-light.png)
 
 Property editors for text, numbers, booleans, fonts, colors, lines, alignment, points, dates, and custom content.
 
@@ -104,13 +104,6 @@ Data grid toolbar and copy/paste data grid controls for editable tabular workflo
 
 See: [Generic Controls](generic-controls.md)
 
-### Color Collection
-
-![Generic color collection editor in blue theme](assets/gallery/generic-color-collection-blue.png)
-
-Editable color collection with popup color editing.
-
-See: [Generic Controls](generic-controls.md)
 
 ## NumericControls
 

From ddb3df1481fa66c74e9de4c94665bd1739317586 Mon Sep 17 00:00:00 2001
From: HadenSmith <cole.h.smith@usace.army.mil>
Date: Wed, 1 Jul 2026 10:39:38 -0600
Subject: [PATCH 2/7] Changed name

---
 ...y-editors-blue.png => generic-datagrid-blue.png} | Bin
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename docs/assets/gallery/{generic-property-editors-blue.png => generic-datagrid-blue.png} (100%)

diff --git a/docs/assets/gallery/generic-property-editors-blue.png b/docs/assets/gallery/generic-datagrid-blue.png
similarity index 100%
rename from docs/assets/gallery/generic-property-editors-blue.png
rename to docs/assets/gallery/generic-datagrid-blue.png

From b8d17c75a490bb4ae23fbb4f9c1957e30815a917 Mon Sep 17 00:00:00 2001
From: Haden Smith <123974306+HadenSmith@users.noreply.github.com>
Date: Wed, 1 Jul 2026 10:40:18 -0600
Subject: [PATCH 3/7] Remove 'Color Collection' from gallery documentation

---
 docs/gallery.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/gallery.md b/docs/gallery.md
index 98e5ffa2..92dcb87a 100644
--- a/docs/gallery.md
+++ b/docs/gallery.md
@@ -15,7 +15,6 @@ Screenshots belong in `docs/assets/gallery/` using the filenames shown below.
   - [Date, Time, and Color](#date-time-and-color)
   - [Property Editors](#property-editors)
   - [Data Grid](#data-grid)
-  - [Color Collection](#color-collection)
 - [NumericControls](#numericcontrols)
   - [Distribution Selector](#distribution-selector)
   - [Uncertain Curve Editor](#uncertain-curve-editor)

From 79712b45d7116608aa34b0382d958a21716507b6 Mon Sep 17 00:00:00 2001
From: HadenSmith <cole.h.smith@usace.army.mil>
Date: Tue, 7 Jul 2026 14:42:28 -0600
Subject: [PATCH 4/7] Validate irregular time series ordering

---
 .../Time Series Editor/TimeSeriesRowItem.cs   |  13 ++-
 .../Time Series Editor/TimeSeriesTable.xaml   |  42 ++++++-
 .../TimeSeriesTable.xaml.cs                   |  75 ++++++++++--
 .../RowItems/TimeSeriesRowItemTests.cs        | 107 ++++++++++++++++++
 .../TimeSeriesTableTests.cs                   |  82 ++++++++++++++
 5 files changed, 301 insertions(+), 18 deletions(-)
 create mode 100644 tests/NumericControls.Tests/RowItems/TimeSeriesRowItemTests.cs
 create mode 100644 tests/NumericControls.Tests/TimeSeriesTableTests.cs

diff --git a/src/NumericControls/Data/Time Series Editor/TimeSeriesRowItem.cs b/src/NumericControls/Data/Time Series Editor/TimeSeriesRowItem.cs
index b29e051f..4993ba64 100644
--- a/src/NumericControls/Data/Time Series Editor/TimeSeriesRowItem.cs	
+++ b/src/NumericControls/Data/Time Series Editor/TimeSeriesRowItem.cs	
@@ -138,10 +138,21 @@ private void ReplaceOrdinate(SeriesOrdinate<DateTime, double> newOrdinate)
 
         /// <summary>
         /// Adds validation rules for the time series row item properties.
-        /// Validates that the value is a valid number.
+        /// Validates that irregular date-time entries are in ascending data order
+        /// and that the value is a valid number.
         /// </summary>
         public override void AddValidationRules()
         {
+            AddRule(nameof(DateTime),
+                () => _series != null
+                    && _series.TimeInterval == TimeInterval.Irregular
+                    && OrderRule<DateTime, TimeSeriesRowItem>(
+                        row => row.DateTime.Ticks,
+                        nameof(DateTime),
+                        ascending: true,
+                        canBeEqual: false),
+                "Date/time values must be in ascending data order. Grid sorting does not reorder the time series used by the plot.",
+                new[] { nameof(DateTime) });
             AddRule(nameof(Value), () => double.IsInfinity(Value), "The value must be a finite number.", new[] { nameof(Value) });
         }
 
diff --git a/src/NumericControls/Data/Time Series Editor/TimeSeriesTable.xaml b/src/NumericControls/Data/Time Series Editor/TimeSeriesTable.xaml
index 6c4a45b7..7194ce5b 100644
--- a/src/NumericControls/Data/Time Series Editor/TimeSeriesTable.xaml	
+++ b/src/NumericControls/Data/Time Series Editor/TimeSeriesTable.xaml	
@@ -59,6 +59,36 @@
             </Style.Triggers>
         </Style>
 
+        <Style x:Key="DateTime_CellStyleDisabled" TargetType="{x:Type DataGridCell}" BasedOn="{StaticResource Right_CellStyleDisabled}">
+            <Style.Triggers>
+                <DataTrigger Binding="{Binding RuleMap[DateTime].HasError}" Value="True">
+                    <Setter Property="ToolTip" Value="{Binding RuleMap[DateTime].ErrorMessage}"/>
+                    <Setter Property="BorderBrush" Value="{Binding ErrorCellBorderBrush, RelativeSource={RelativeSource AncestorType={x:Type cntrls:ValidationDataGrid}}}"/>
+                    <Setter Property="Background" Value="{Binding ErrorCellBackgroundBrush, RelativeSource={RelativeSource AncestorType={x:Type cntrls:ValidationDataGrid}}}"/>
+                </DataTrigger>
+            </Style.Triggers>
+        </Style>
+
+        <Style x:Key="DateTime_CellStyle" TargetType="{x:Type DataGridCell}" BasedOn="{StaticResource Right_CellStyle}">
+            <Style.Triggers>
+                <DataTrigger Binding="{Binding RuleMap[DateTime].HasError}" Value="True">
+                    <Setter Property="ToolTip" Value="{Binding RuleMap[DateTime].ErrorMessage}"/>
+                    <Setter Property="BorderBrush" Value="{Binding ErrorCellBorderBrush, RelativeSource={RelativeSource AncestorType={x:Type cntrls:ValidationDataGrid}}}"/>
+                    <Setter Property="Background" Value="{Binding ErrorCellBackgroundBrush, RelativeSource={RelativeSource AncestorType={x:Type cntrls:ValidationDataGrid}}}"/>
+                </DataTrigger>
+            </Style.Triggers>
+        </Style>
+
+        <Style x:Key="Value_CellStyle" TargetType="{x:Type DataGridCell}" BasedOn="{StaticResource Right_CellStyle}">
+            <Style.Triggers>
+                <DataTrigger Binding="{Binding RuleMap[Value].HasError}" Value="True">
+                    <Setter Property="ToolTip" Value="{Binding RuleMap[Value].ErrorMessage}"/>
+                    <Setter Property="BorderBrush" Value="{Binding ErrorCellBorderBrush, RelativeSource={RelativeSource AncestorType={x:Type cntrls:ValidationDataGrid}}}"/>
+                    <Setter Property="Background" Value="{Binding ErrorCellBackgroundBrush, RelativeSource={RelativeSource AncestorType={x:Type cntrls:ValidationDataGrid}}}"/>
+                </DataTrigger>
+            </Style.Triggers>
+        </Style>
+
         <Style x:Key="DataGridCellStyle1" TargetType="{x:Type DataGridCell}">
             <Setter Property="Background" Value="Transparent"/>
             <Setter Property="BorderBrush" Value="Transparent"/>
@@ -144,7 +174,7 @@
         </StackPanel>
 
         <!-- Time series data grid with date/time and value columns -->
-        <cntrls:CopyPasteDataGrid
+        <cntrls:ValidationDataGrid
             x:Name="TimeSeriesDataGrid"
             Grid.Row="1"
             RowHeight="25"
@@ -157,7 +187,7 @@
             PreviewPasteData="TimeSeriesDataGrid_PreviewPasteData"
             DataPasted="TimeSeriesDataGrid_DataPasted"
             PreviewKeyDown="TimeSeriesDataGrid_PreviewKeyDown">
-            <cntrls:CopyPasteDataGrid.Columns>
+            <cntrls:ValidationDataGrid.Columns>
                 <DataGridTemplateColumn 
                     x:Name="DateTimeSelectorColumn"  
                     Header="" 
@@ -227,7 +257,7 @@
                     MinWidth="30"
                     Binding="{Binding DateTime, NotifyOnTargetUpdated=True, Mode=TwoWay, FallbackValue=N/A, TargetNullValue=N/A, Converter={StaticResource DateConverter}}" 
                     HeaderStyle="{StaticResource WrappedColumnHeaderStyle}"
-                    CellStyle="{StaticResource Right_CellStyleDisabled}"/>
+                    CellStyle="{StaticResource DateTime_CellStyleDisabled}"/>
 
                 <DataGridTextColumn
                     x:Name="ValueColumn"
@@ -235,10 +265,10 @@
                     Width="*"
                     Binding="{Binding Value, UpdateSourceTrigger=LostFocus, Mode=TwoWay, FallbackValue=N/A, TargetNullValue=N/A, Converter={StaticResource NAConverter}}"
                     HeaderStyle="{StaticResource WrappedColumnHeaderStyle}"
-                    CellStyle="{StaticResource Right_CellStyle}"
+                    CellStyle="{StaticResource Value_CellStyle}"
                     EditingElementStyle="{StaticResource DataGridEditingTextBoxStyle}"/>
 
-            </cntrls:CopyPasteDataGrid.Columns>
-        </cntrls:CopyPasteDataGrid>
+            </cntrls:ValidationDataGrid.Columns>
+        </cntrls:ValidationDataGrid>
     </Grid>
 </UserControl>
diff --git a/src/NumericControls/Data/Time Series Editor/TimeSeriesTable.xaml.cs b/src/NumericControls/Data/Time Series Editor/TimeSeriesTable.xaml.cs
index d48c4f77..93286152 100644
--- a/src/NumericControls/Data/Time Series Editor/TimeSeriesTable.xaml.cs	
+++ b/src/NumericControls/Data/Time Series Editor/TimeSeriesTable.xaml.cs	
@@ -86,11 +86,31 @@ public partial class TimeSeriesTable : UserControl
         private void RebuildRowItems()
         {
             _rowItems.Clear();
-            if (Series == null) return;
-            for (int i = 0; i < Series.Count; i++)
+            if (Series != null)
             {
-                _rowItems.Add(new TimeSeriesRowItem(_rowItems, Series[i], Series, i));
+                for (int i = 0; i < Series.Count; i++)
+                {
+                    _rowItems.Add(new TimeSeriesRowItem(_rowItems, Series[i], Series, i));
+                }
             }
+            ValidateRows();
+        }
+
+        /// <summary>
+        /// Forces validation on the bound row items when the grid has been initialized.
+        /// </summary>
+        private void ValidateRows()
+        {
+            TimeSeriesDataGrid?.ValidateTable();
+        }
+
+        /// <summary>
+        /// Refreshes the grid view and revalidates the underlying row items.
+        /// </summary>
+        private void RefreshGridAndValidateRows()
+        {
+            TimeSeriesDataGrid?.Items.Refresh();
+            ValidateRows();
         }
 
         /// <summary>
@@ -113,11 +133,12 @@ private void Series_CollectionChanged(object sender, NotifyCollectionChangedEven
                         rowItem.SetOrdinate((SeriesOrdinate<DateTime, double>)e.NewItems[i]);
                     }
                 }
+                ValidateRows();
             }
             else if (e.Action == NotifyCollectionChangedAction.Reset)
             {
                 RebuildRowItems();
-                TimeSeriesDataGrid.Items.Refresh();
+                RefreshGridAndValidateRows();
             }
         }
 
@@ -153,10 +174,11 @@ private static void SetData(DependencyObject d, DependencyPropertyChangedEventAr
 
             thisControl.DateTimeColumn.IsReadOnly = true;
             thisControl.DateTimeSelectorColumn.Visibility = Visibility.Collapsed;
-            thisControl.DateTimeColumn.CellStyle = (Style)thisControl.TryFindResource("Right_CellStyleDisabled");
+            thisControl.DateTimeColumn.CellStyle = (Style)thisControl.TryFindResource("DateTime_CellStyleDisabled");
             if (e.NewValue == null)
             {
                 thisControl._rowItems.Clear();
+                thisControl.RefreshGridAndValidateRows();
                 return;
             }
             TimeSeries newSeries = e.NewValue as TimeSeries;
@@ -164,12 +186,13 @@ private static void SetData(DependencyObject d, DependencyPropertyChangedEventAr
             {
                 thisControl._rowItems.Clear();
                 thisControl.TimeSeriesDataGrid.IsEnabled = false;
+                thisControl.RefreshGridAndValidateRows();
                 return;
             }
 
             if (newSeries.TimeInterval == TimeInterval.Irregular)
             {
-                thisControl.DateTimeColumn.CellStyle = (Style)thisControl.TryFindResource("Right_CellStyle");
+                thisControl.DateTimeColumn.CellStyle = (Style)thisControl.TryFindResource("DateTime_CellStyle");
                 thisControl.DateTimeSelectorColumn.Visibility = Visibility.Visible;
                 thisControl.DateTimeColumn.IsReadOnly = false;
             }
@@ -472,6 +495,7 @@ private void MathFunctionButton_Click(object sender, RoutedEventArgs e)
 
                 // Rebuild RowItems since values changed in-place
                 RebuildRowItems();
+                RefreshGridAndValidateRows();
 
                 // Fire DataPasted as a signal to unsuppress and raise reset
                 DataPasted?.Invoke();
@@ -538,7 +562,7 @@ private void TimeSeriesDataGrid_PreviewAddRows(int startRowIndex, int nRows, ref
             // Rebuild all RowItems to sync _rowItems with Series and fix positional indices.
             // Must happen before PasteClipboard resumes so Items[rowIndex + i] finds the new rows.
             RebuildRowItems();
-            TimeSeriesDataGrid.Items.Refresh();
+            RefreshGridAndValidateRows();
 
             RowsAdded?.Invoke(startRowIndex, nRows);
         }
@@ -625,16 +649,19 @@ private void TimeSeriesDataGrid_PreviewDeleteRows(List<int> rowindices, ref bool
             // Cancel CopyPasteDataGrid's own delete — we handle both collections ourselves
             cancel = true;
 
+            var sourceRowIndices = MapVisibleRowIndicesToSourceRowIndices(rowindices);
+            if (sourceRowIndices.Count == 0) return;
+
             // Fire public event to allow consumer to suppress
             bool userCancel = false;
-            PreviewDeleteRows?.Invoke(rowindices, ref userCancel);
+            PreviewDeleteRows?.Invoke(sourceRowIndices, ref userCancel);
             if (userCancel) return;
 
             // Start Time
             DateTime startTime = (Series == null || Series.Count == 0) ? new DateTime(2020, 1, 1, 0, 0, 0) : Series[0].Index;
 
             // Delete from Series in reverse order to maintain indices
-            var sorted = rowindices.OrderByDescending(i => i).ToList();
+            var sorted = sourceRowIndices.OrderByDescending(i => i).ToList();
             foreach (int idx in sorted)
             {
                 if (idx >= 0 && idx < Series.Count)
@@ -645,9 +672,34 @@ private void TimeSeriesDataGrid_PreviewDeleteRows(List<int> rowindices, ref bool
 
             // Rebuild all RowItems to sync _rowItems with Series and fix positional indices.
             RebuildRowItems();
-            TimeSeriesDataGrid.Items.Refresh();
+            RefreshGridAndValidateRows();
+
+            RowsDeleted?.Invoke(sourceRowIndices);
+        }
+
+        /// <summary>
+        /// Converts row indices from the current sorted view to indices in the backing row collection.
+        /// </summary>
+        /// <param name="rowindices">The row indices from the current grid view.</param>
+        /// <returns>The corresponding distinct source indices in ascending order.</returns>
+        private List<int> MapVisibleRowIndicesToSourceRowIndices(IEnumerable<int> rowindices)
+        {
+            var sourceRowIndices = new HashSet<int>();
+            if (rowindices == null) return sourceRowIndices.ToList();
+
+            foreach (int rowIndex in rowindices)
+            {
+                if (rowIndex < 0 || rowIndex >= TimeSeriesDataGrid.Items.Count) continue;
+                if (TimeSeriesDataGrid.Items[rowIndex] is not TimeSeriesRowItem rowItem) continue;
+
+                int sourceIndex = _rowItems.IndexOf(rowItem);
+                if (sourceIndex >= 0)
+                {
+                    sourceRowIndices.Add(sourceIndex);
+                }
+            }
 
-            RowsDeleted?.Invoke(rowindices);
+            return sourceRowIndices.OrderBy(index => index).ToList();
         }
 
         /// <summary>
@@ -718,6 +770,7 @@ private void TimeSeriesDataGrid_DataPasted()
             // RebuildRowItems removed — Series_CollectionChanged(Reset) handles it
             // when consumer calls RaiseCollectionChangedReset() in the DataPasted handler.
             DataPasted?.Invoke();
+            ValidateRows();
         }
 
     }
diff --git a/tests/NumericControls.Tests/RowItems/TimeSeriesRowItemTests.cs b/tests/NumericControls.Tests/RowItems/TimeSeriesRowItemTests.cs
new file mode 100644
index 00000000..a6d0688e
--- /dev/null
+++ b/tests/NumericControls.Tests/RowItems/TimeSeriesRowItemTests.cs
@@ -0,0 +1,107 @@
+using System.Collections.ObjectModel;
+using Numerics.Data;
+using NumericControls;
+using Xunit;
+
+namespace NumericControls.Tests.RowItems
+{
+    /// <summary>
+    /// Tests for <see cref="TimeSeriesRowItem"/>.
+    /// </summary>
+    public class TimeSeriesRowItemTests
+    {
+        /// <summary>
+        /// Creates row items backed by a time series with the supplied interval.
+        /// </summary>
+        /// <param name="interval">The time interval for the series.</param>
+        /// <param name="dates">The date-times for the row items.</param>
+        /// <returns>The row item collection.</returns>
+        private static ObservableCollection<object> CreateRows(TimeInterval interval, params DateTime[] dates)
+        {
+            var series = new TimeSeries(interval);
+            for (int i = 0; i < dates.Length; i++)
+            {
+                series.Add(new SeriesOrdinate<DateTime, double>(dates[i], i + 1d));
+            }
+
+            var rows = new ObservableCollection<object>();
+            for (int i = 0; i < series.Count; i++)
+            {
+                rows.Add(new TimeSeriesRowItem(rows, series[i], series, i));
+            }
+
+            return rows;
+        }
+
+        /// <summary>
+        /// Gets a typed row from the row collection.
+        /// </summary>
+        /// <param name="rows">The row collection.</param>
+        /// <param name="index">The row index.</param>
+        /// <returns>The typed row item.</returns>
+        private static TimeSeriesRowItem Row(ObservableCollection<object> rows, int index)
+        {
+            return (TimeSeriesRowItem)rows[index];
+        }
+
+        /// <summary>
+        /// Verifies that ascending irregular date-times are valid.
+        /// </summary>
+        [Fact]
+        public void DateTimeRule_IrregularAscendingDates_NoValidationError()
+        {
+            var start = new DateTime(2020, 1, 1);
+            var rows = CreateRows(TimeInterval.Irregular, start, start.AddDays(1), start.AddDays(2));
+
+            Row(rows, 0).ForceValidation();
+            Row(rows, 1).ForceValidation();
+            Row(rows, 2).ForceValidation();
+
+            Assert.False(Row(rows, 0).RuleMap[nameof(TimeSeriesRowItem.DateTime)].HasError);
+            Assert.False(Row(rows, 1).RuleMap[nameof(TimeSeriesRowItem.DateTime)].HasError);
+            Assert.False(Row(rows, 2).RuleMap[nameof(TimeSeriesRowItem.DateTime)].HasError);
+        }
+
+        /// <summary>
+        /// Verifies that an earlier appended irregular date-time is invalid in backing data order.
+        /// </summary>
+        [Fact]
+        public void DateTimeRule_IrregularEarlierDateAppended_HasValidationError()
+        {
+            var start = new DateTime(2020, 1, 1);
+            var rows = CreateRows(TimeInterval.Irregular, start.AddDays(1), start.AddDays(2), start);
+
+            Row(rows, 2).ForceValidation();
+
+            Assert.True(Row(rows, 2).RuleMap[nameof(TimeSeriesRowItem.DateTime)].HasError);
+        }
+
+        /// <summary>
+        /// Verifies that duplicate irregular date-times are invalid.
+        /// </summary>
+        [Fact]
+        public void DateTimeRule_IrregularDuplicateAdjacentDate_HasValidationError()
+        {
+            var start = new DateTime(2020, 1, 1);
+            var rows = CreateRows(TimeInterval.Irregular, start, start);
+
+            Row(rows, 1).ForceValidation();
+
+            Assert.True(Row(rows, 1).RuleMap[nameof(TimeSeriesRowItem.DateTime)].HasError);
+        }
+
+        /// <summary>
+        /// Verifies that the date-time order rule is not applied to regular interval series.
+        /// </summary>
+        [Fact]
+        public void DateTimeRule_RegularSeriesOutOfOrder_NoValidationError()
+        {
+            var start = new DateTime(2020, 1, 1);
+            var rows = CreateRows(TimeInterval.OneDay, start.AddDays(1), start);
+
+            Row(rows, 1).ForceValidation();
+
+            Assert.False(Row(rows, 1).RuleMap[nameof(TimeSeriesRowItem.DateTime)].HasError);
+        }
+    }
+}
diff --git a/tests/NumericControls.Tests/TimeSeriesTableTests.cs b/tests/NumericControls.Tests/TimeSeriesTableTests.cs
new file mode 100644
index 00000000..6bc74ed4
--- /dev/null
+++ b/tests/NumericControls.Tests/TimeSeriesTableTests.cs
@@ -0,0 +1,82 @@
+using System.ComponentModel;
+using System.Reflection;
+using System.Windows;
+using GenericControls;
+using Numerics.Data;
+using NumericControls;
+using Xunit;
+
+namespace NumericControls.Tests
+{
+    /// <summary>
+    /// Tests for <see cref="TimeSeriesTable"/>.
+    /// </summary>
+    public class TimeSeriesTableTests
+    {
+        /// <summary>
+        /// Tracks whether the generic control resource dictionary has been loaded for this test process.
+        /// </summary>
+        private static bool _resourcesLoaded;
+
+        /// <summary>
+        /// Ensures a WPF application exists for control construction.
+        /// </summary>
+        private static void EnsureApplication()
+        {
+            var application = Application.Current ?? new Application();
+
+            if (_resourcesLoaded) return;
+
+            application.Resources.MergedDictionaries.Add(new ResourceDictionary
+            {
+                Source = new Uri("/GenericControls;component/Themes/GenericControlsTheme.xaml", UriKind.Relative)
+            });
+            _resourcesLoaded = true;
+        }
+
+        /// <summary>
+        /// Creates a sample irregular time series.
+        /// </summary>
+        /// <returns>A sample time series with distinct values.</returns>
+        private static TimeSeries CreateSampleSeries()
+        {
+            var start = new DateTime(2020, 1, 1);
+            var series = new TimeSeries(TimeInterval.Irregular);
+            series.Add(new SeriesOrdinate<DateTime, double>(start, 10d));
+            series.Add(new SeriesOrdinate<DateTime, double>(start.AddDays(1), 30d));
+            series.Add(new SeriesOrdinate<DateTime, double>(start.AddDays(2), 20d));
+            return series;
+        }
+
+        /// <summary>
+        /// Verifies that preview delete maps a visually sorted row index to the correct backing row.
+        /// </summary>
+        [StaFact]
+        public void PreviewDeleteRows_AfterValueSort_RemovesVisualRowFromBackingSeries()
+        {
+            EnsureApplication();
+            var series = CreateSampleSeries();
+            var table = new TimeSeriesTable { Series = series };
+            var grid = Assert.IsType<ValidationDataGrid>(table.FindName("TimeSeriesDataGrid"));
+
+            grid.Items.SortDescriptions.Clear();
+            grid.Items.SortDescriptions.Add(new SortDescription(nameof(TimeSeriesRowItem.Value), ListSortDirection.Descending));
+            grid.Items.Refresh();
+
+            Assert.Equal(30d, ((TimeSeriesRowItem)grid.Items[0]).Value);
+
+            var deleteMethod = typeof(TimeSeriesTable).GetMethod(
+                "TimeSeriesDataGrid_PreviewDeleteRows",
+                BindingFlags.Instance | BindingFlags.NonPublic);
+            Assert.NotNull(deleteMethod);
+
+            object?[] arguments = { new List<int> { 0 }, false };
+            deleteMethod.Invoke(table, arguments);
+
+            var values = Enumerable.Range(0, series.Count).Select(i => series[i].Value).ToList();
+            Assert.True((bool)arguments[1]!);
+            Assert.Equal(2, series.Count);
+            Assert.DoesNotContain(30d, values);
+        }
+    }
+}

From 0e29cee80e99fd1ab167032b543db66b0a744fa2 Mon Sep 17 00:00:00 2001
From: HadenSmith <cole.h.smith@usace.army.mil>
Date: Wed, 8 Jul 2026 11:59:57 -0600
Subject: [PATCH 5/7] Default line annotation text to start

---
 src/OxyPlotControls/OxyPlotToolbar.xaml.cs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/OxyPlotControls/OxyPlotToolbar.xaml.cs b/src/OxyPlotControls/OxyPlotToolbar.xaml.cs
index a5e51cfb..92fca570 100644
--- a/src/OxyPlotControls/OxyPlotToolbar.xaml.cs
+++ b/src/OxyPlotControls/OxyPlotToolbar.xaml.cs
@@ -1599,7 +1599,7 @@ private void PlotModelMouseDown(object? sender, OxyMouseDownEventArgs e)
 
                         if (verticalYAxis.IsReversed == false)
                         {
-                            newVLine.TextLinePosition = 1;
+                            newVLine.TextLinePosition = 0;
                             newVLine.TextHorizontalAlignment = System.Windows.HorizontalAlignment.Right;
                         }
                         else
@@ -1641,7 +1641,7 @@ private void PlotModelMouseDown(object? sender, OxyMouseDownEventArgs e)
                         }
                         else
                         {
-                            newHLine.TextLinePosition = 1;
+                            newHLine.TextLinePosition = 0;
                             newHLine.TextHorizontalAlignment = System.Windows.HorizontalAlignment.Left;
                         }
 

From 23749f24136155e32d900c8318e7dfe19497870c Mon Sep 17 00:00:00 2001
From: HadenSmith <cole.h.smith@usace.army.mil>
Date: Fri, 10 Jul 2026 09:47:49 -0600
Subject: [PATCH 6/7] Harden software updates for v1.0.1

---
 CITATION.cff                                  |    4 +-
 Directory.Build.props                         |    6 +-
 README.md                                     |    4 +-
 codemeta.json                                 |    4 +-
 docs/getting-started.md                       |    2 +-
 docs/software-update.md                       |   40 +-
 scripts/pack-wpf-framework.ps1                |   73 +-
 .../RMC.Wpf.Framework.Controls.csproj         |    2 +-
 .../RMC.Wpf.Framework.Controls.nuspec         |    1 +
 .../RMC.Wpf.Framework.Core.csproj             |    2 +-
 .../RMC.Wpf.Framework.Core.nuspec             |    1 +
 .../RMC.Wpf.Framework.Models.csproj           |    2 +-
 .../RMC.Wpf.Framework.Models.nuspec           |    1 +
 .../RMC.Wpf.Framework.Support.csproj          |    2 +-
 .../RMC.Wpf.Framework.Support.nuspec          |    1 +
 .../InstallationManager.cs                    | 1093 +++++++++++++----
 src/SoftwareUpdate.Updater/Program.cs         |    3 +-
 .../SoftwareUpdate.Updater.csproj             |    3 +
 .../UpdaterArguments.cs                       |   41 +
 src/SoftwareUpdate/Core/UpdateOptions.cs      |   53 +
 .../GitHub/GitHubUpdateService.cs             |  235 +++-
 src/SoftwareUpdate/SoftwareUpdate.csproj      |    4 +
 .../Utilities/UpdaterBootstrapper.cs          |   95 +-
 .../Core/UpdateOptionsTests.cs                |   67 +
 .../GitHub/UpdaterHardeningTests.cs           |  177 +++
 .../InstallationManagerTests.cs               |  369 +++++-
 .../UpdaterArgumentsTests.cs                  |   50 +
 27 files changed, 2035 insertions(+), 300 deletions(-)
 create mode 100644 tests/SoftwareUpdate.Tests/GitHub/UpdaterHardeningTests.cs

diff --git a/CITATION.cff b/CITATION.cff
index f8884451..565733bf 100644
--- a/CITATION.cff
+++ b/CITATION.cff
@@ -2,8 +2,8 @@ cff-version: 1.2.0
 message: "If you use this software, please cite it as below."
 type: software
 title: "WPF Framework"
-version: "1.0.0"
-date-released: "2026-06-30"
+version: "1.0.1"
+date-released: "2026-07-10"
 license: 0BSD
 repository-code: "https://github.com/USACE-RMC/WPF-Framework"
 url: "https://github.com/USACE-RMC/WPF-Framework"
diff --git a/Directory.Build.props b/Directory.Build.props
index 79ac2446..1579c77b 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -14,9 +14,9 @@
     <PackageProjectUrl>https://github.com/USACE-RMC/WPF-Framework</PackageProjectUrl>
     <RepositoryUrl>https://github.com/USACE-RMC/WPF-Framework</RepositoryUrl>
     <RepositoryType>git</RepositoryType>
-    <Version>1.0.0</Version>
-    <AssemblyVersion>1.0.0.0</AssemblyVersion>
-    <FileVersion>1.0.0.0</FileVersion>
+    <Version>1.0.1</Version>
+    <AssemblyVersion>1.0.1.0</AssemblyVersion>
+    <FileVersion>1.0.1.0</FileVersion>
 
     <GeneratePackageOnBuild>false</GeneratePackageOnBuild>
     <IsPackable>false</IsPackable>
diff --git a/README.md b/README.md
index 96259198..ede7edeb 100644
--- a/README.md
+++ b/README.md
@@ -51,7 +51,7 @@ dotnet test WPF-Framework.sln
 ### Build Packages
 
 ```bash
-.\scripts\pack-wpf-framework.ps1 -Configuration Release -Version 1.0.0
+.\scripts\pack-wpf-framework.ps1 -Configuration Release -Version 1.0.1
 ```
 
 This creates and validates the following NuGet packages in `artifacts/packages/`:
@@ -144,7 +144,7 @@ Multi-format database abstraction supporting SQLite, CSV, DBF, and in-memory tab
 
 ### Software Updates
 
-Automatic update checking and installation from GitHub Releases with SemVer 2.0, SHA256 checksum validation, and backup/recovery.
+Automatic update checking and staged installation from GitHub Releases with SemVer 2.0, SHA256 checksum validation, protected settings, transactional rollback, and safe replacement of the updater itself.
 
 ## Support
 
diff --git a/codemeta.json b/codemeta.json
index 191367de..dc43e75f 100644
--- a/codemeta.json
+++ b/codemeta.json
@@ -3,9 +3,9 @@
   "@type": "SoftwareSourceCode",
   "name": "WPF Framework",
   "description": "A free and open-source .NET 10 application framework for building Windows desktop project management applications. Provides a docking application shell with theming, project explorer, undo/redo, and specialized controls for charting, numeric input, databases, expression parsing, and directed acyclic graphs.",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "dateCreated": "2025-12-29",
-  "dateModified": "2026-06-30",
+  "dateModified": "2026-07-10",
   "license": "https://spdx.org/licenses/0BSD",
   "codeRepository": "https://github.com/USACE-RMC/WPF-Framework",
   "issueTracker": "https://github.com/USACE-RMC/WPF-Framework/issues",
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 58ca6599..31d7b06f 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -30,7 +30,7 @@ For NuGet consumption, reference the Controls bundle. It brings in Core, Models,
 
 ```xml
 <ItemGroup>
-  <PackageReference Include="RMC.Wpf.Framework.Controls" Version="1.0.0" />
+  <PackageReference Include="RMC.Wpf.Framework.Controls" Version="1.0.1" />
 </ItemGroup>
 ```
 
diff --git a/docs/software-update.md b/docs/software-update.md
index 4afa0128..c71c8737 100644
--- a/docs/software-update.md
+++ b/docs/software-update.md
@@ -54,8 +54,10 @@ var options = new UpdateOptions
     GitHubOwner = "USACE-RMC",
     GitHubRepo = "RMC-BestFit",
     CurrentVersion = new SemanticVersion(2, 0, 0),
-    AssetNamePattern = "RMC-BestFit.*.zip"
+    AssetNamePattern = "RMC-BestFit.*.zip",
+    RequireSha256Checksum = true
 };
+options.AdditionalPreservedRelativePaths.Add("data/user");
 ```
 
 ### 3. Create the update service
@@ -191,9 +193,9 @@ Assets:
 
 Mark pre-release versions as "pre-release" in GitHub. They are excluded by default unless `IncludePreReleases = true`. Draft releases are always excluded.
 
-### Optional SHA256 checksum
+### SHA256 checksum policy
 
-If the `UpdateInfo.Sha256Checksum` property is populated, the download is validated against it. Set this property via the release metadata if your build pipeline generates checksums.
+When release notes contain `SHA256: <64-character hexadecimal value>`, the download is validated against it. Set `RequireSha256Checksum = true` to reject releases that do not provide this token. The default remains optional for compatibility.
 
 ## UpdateOptions Reference
 
@@ -208,6 +210,8 @@ If the `UpdateInfo.Sha256Checksum` property is populated, the download is valida
 | `InstallDirectory` | `string?` | `null` | Installation directory. Defaults to the entry assembly's directory. |
 | `MainExecutableName` | `string?` | `null` | Executable to restart after update. Defaults to the current process name. |
 | `CreateBackup` | `bool` | `true` | Whether to create a backup before updating. |
+| `AdditionalPreservedRelativePaths` | `IList<string>` | Empty | Additional installation-relative paths that must never be changed by an update. |
+| `RequireSha256Checksum` | `bool` | `false` | Whether release notes must provide a valid SHA256 checksum. |
 | `SkippedVersionsFilePath` | `string?` | `null` | Path for storing skipped versions. Defaults to `%LOCALAPPDATA%/{repo}/skipped_versions.txt`. |
 | `RequestTimeoutSeconds` | `int` | `30` | HTTP request timeout in seconds. |
 | `UpdaterExecutablePath` | `string?` | `null` | Path to the updater executable. Defaults to `SoftwareUpdate.Updater.exe` in the install directory. |
@@ -291,7 +295,7 @@ else if (!result.Success)
 
 ### 2. Download update
 
-`DownloadUpdateAsync()` downloads the asset to a temp directory (`%TEMP%/SoftwareUpdate/{repo}/`) with progress reporting every 100ms. If a SHA256 checksum is provided, it validates the download.
+`DownloadUpdateAsync()` downloads the asset to a GUID-named directory under `%TEMP%/SoftwareUpdate/` with progress reporting every 100ms. If a SHA256 checksum is provided, it validates the download; required-checksum mode fails before network transfer when metadata is missing or malformed.
 
 ```csharp
 var downloadResult = await updateService.DownloadUpdateAsync(
@@ -321,7 +325,7 @@ else
 
 ### 3. Install and restart
 
-`InstallUpdateAndRestart()` launches the updater process with the required arguments and calls `Environment.Exit(0)`. No code executes after this call.
+`InstallUpdateAndRestart()` copies the complete updater payload to a disposable `%TEMP%/SoftwareUpdate/runner-{guid}` directory, launches that copy, and calls `Environment.Exit(0)`. Running outside the installation allows the update to replace all installed updater files. No code executes after this call.
 
 ```csharp
 updateService.InstallUpdateAndRestart(downloadResult.FilePath!);
@@ -344,24 +348,29 @@ Skipped versions are persisted to `ResolvedSkippedVersionsPath`.
 
 ## Backup and Recovery
 
-When `CreateBackup` is `true` (the default), the updater creates a backup of the current installation before extracting new files.
+When `CreateBackup` is `true` (the default), the updater backs up only existing files that the validated update manifest will overwrite.
 
 - **Backup location:** `{TargetDirectory}/.backup_{timestamp}/`
 - **Retention:** Only the 2 most recent backups are kept. Older backups are deleted during cleanup.
-- **Recovery:** If the extraction or file replacement fails, the updater automatically restores the entire backup directory.
+- **Recovery:** If file replacement fails, overwritten files are restored and files or directories introduced by the failed update are removed.
 
-To disable backups, set `UpdateOptions.CreateBackup = false`. Without backups, a failed update cannot be automatically restored.
+To disable backups, set `UpdateOptions.CreateBackup = false`. Newly introduced files are still removed after failure, but overwritten files cannot be restored.
+
+The updater always preserves root-level `settings`, `logs`, and `updates_pending` paths plus every `.backup_*` path. These built-in protections cannot be disabled by callers or archive layout.
 
 ## Deployment
 
 ### File layout
 
-Deploy `SoftwareUpdate.Updater.exe` alongside your main application:
+Deploy the complete updater payload alongside your main application:
 
 ```
 MyApp/
   MyApp.exe
-  SoftwareUpdate.Updater.exe   <-- Required for installation
+  SoftwareUpdate.Updater.exe
+  SoftwareUpdate.Updater.dll
+  SoftwareUpdate.Updater.deps.json
+  SoftwareUpdate.Updater.runtimeconfig.json
   SoftwareUpdate.dll
   ... other assemblies ...
 ```
@@ -379,6 +388,7 @@ The updater accepts these command-line arguments (built automatically by `Instal
 | `--target <dir>` | Yes | Target installation directory |
 | `--exe <name>` | Yes | Main executable name to restart |
 | `--backup` | No | Flag to create a backup before updating |
+| `--preserve <path>` | No | Repeatable installation-relative path to preserve |
 
 ### UpdaterBootstrapper
 
@@ -391,7 +401,8 @@ UpdaterBootstrapper.LaunchUpdater(
     targetDirectory: @"C:\MyApp",
     mainExecutable: "MyApp.exe",
     createBackup: true,
-    exitApplication: true  // calls Environment.Exit(0)
+    exitApplication: true,  // calls Environment.Exit(0)
+    additionalPreservedRelativePaths: new[] { "data/user" }
 );
 ```
 
@@ -452,7 +463,8 @@ The updater process itself logs all operations to `{TargetDirectory}/logs/update
 
 ### Updater process considerations
 
-- The updater waits up to 60 seconds for the main application to exit. If the application does not exit in time, the updater proceeds.
-- The updater detects single root folders in zip files and extracts their contents directly, avoiding nested directories.
-- Zip entries containing path traversal sequences (`..`) are skipped with a warning.
+- The updater waits up to 60 seconds for the main application to exit and aborts without changing files if the timeout expires.
+- The updater detects a single wrapper folder and removes it while applying protection checks both before and after removal.
+- The entire archive is preflighted and staged before installation; unsafe paths, collisions, reparse points, excessive file counts, and excessive uncompressed size abort the update.
+- Settings, logs, backups, and update staging remain untouched by archive content.
 - The updater console auto-closes after 3 seconds on success. On failure, it waits for a key press.
diff --git a/scripts/pack-wpf-framework.ps1 b/scripts/pack-wpf-framework.ps1
index b75c0107..2055bbf1 100644
--- a/scripts/pack-wpf-framework.ps1
+++ b/scripts/pack-wpf-framework.ps1
@@ -76,8 +76,22 @@ $expectedEntries = @{
         "lib/net10.0-windows7.0/Xceed.Wpf.AvalonDock.Themes.VS2013.dll")
 }
 
+$expectedReleaseNotes = @{
+    "RMC.Wpf.Framework.Core" = "Coordinated WPF Framework 1.0.1 release; no package-specific functional changes."
+    "RMC.Wpf.Framework.Models" = "Coordinated WPF Framework 1.0.1 release; no package-specific functional changes."
+    "RMC.Wpf.Framework.Support" = "Version 1.0.1 protects settings and runtime data during updates, supports transactional rollback, checksum enforcement, and safe replacement of the installed updater payload."
+    "RMC.Wpf.Framework.Controls" = "Version 1.0.1 improves irregular time-series ordering validation and defaults new OxyPlot line annotations to editable text."
+}
+
 foreach ($packageId in $expectedEntries.Keys) {
-    $package = Get-ChildItem -Path $outputPath -Filter "$packageId.*.nupkg" |
+    $packageFilter = if ([string]::IsNullOrWhiteSpace($Version)) {
+        "$packageId.*.nupkg"
+    }
+    else {
+        "$packageId.$Version.nupkg"
+    }
+
+    $package = Get-ChildItem -Path $outputPath -Filter $packageFilter |
         Sort-Object LastWriteTime -Descending |
         Select-Object -First 1
 
@@ -93,6 +107,63 @@ foreach ($packageId in $expectedEntries.Keys) {
                 throw "$($package.Name) is missing $expectedEntry."
             }
         }
+
+        $nuspecEntry = $zip.Entries | Where-Object { $_.FullName -like "*.nuspec" } | Select-Object -First 1
+        if ($nuspecEntry -eq $null) {
+            throw "$($package.Name) is missing its nuspec metadata."
+        }
+
+        $reader = [System.IO.StreamReader]::new($nuspecEntry.Open())
+        try {
+            [xml]$nuspec = $reader.ReadToEnd()
+        }
+        finally {
+            $reader.Dispose()
+        }
+
+        $namespaceManager = [System.Xml.XmlNamespaceManager]::new($nuspec.NameTable)
+        $namespaceManager.AddNamespace("n", $nuspec.DocumentElement.NamespaceURI)
+        $packageVersion = $nuspec.SelectSingleNode("/n:package/n:metadata/n:version", $namespaceManager).InnerText
+        $releaseNotes = $nuspec.SelectSingleNode("/n:package/n:metadata/n:releaseNotes", $namespaceManager).InnerText
+
+        if (-not [string]::IsNullOrWhiteSpace($Version) -and $packageVersion -ne $Version) {
+            throw "$($package.Name) declares version $packageVersion instead of $Version."
+        }
+
+        if ($releaseNotes -ne $expectedReleaseNotes[$packageId]) {
+            throw "$($package.Name) has unexpected NuGet release notes."
+        }
+
+        if ($packageId -eq "RMC.Wpf.Framework.Support") {
+            $numericVersion = ($packageVersion -split '-')[0]
+            $expectedFileVersion = "$numericVersion.0"
+            $payloadBinaryEntries = @(
+                "contentFiles/any/net10.0-windows7.0/SoftwareUpdate.Updater.exe",
+                "contentFiles/any/net10.0-windows7.0/SoftwareUpdate.Updater.dll")
+            $inspectionDirectory = Join-Path ([System.IO.Path]::GetTempPath()) "wpf-framework-package-$([Guid]::NewGuid().ToString('N'))"
+            New-Item -ItemType Directory -Path $inspectionDirectory | Out-Null
+
+            try {
+                foreach ($payloadEntryName in $payloadBinaryEntries) {
+                    $payloadEntry = $zip.GetEntry($payloadEntryName)
+                    $payloadPath = Join-Path $inspectionDirectory ([System.IO.Path]::GetFileName($payloadEntryName))
+                    [System.IO.Compression.ZipFileExtensions]::ExtractToFile($payloadEntry, $payloadPath, $false)
+                    $versionInfo = [System.Diagnostics.FileVersionInfo]::GetVersionInfo($payloadPath)
+
+                    if ($versionInfo.FileVersion -ne $expectedFileVersion) {
+                        throw "$($package.Name) payload $payloadEntryName has file version $($versionInfo.FileVersion) instead of $expectedFileVersion."
+                    }
+
+                    if ([string]::IsNullOrWhiteSpace($versionInfo.ProductVersion) -or
+                        -not $versionInfo.ProductVersion.StartsWith($packageVersion, [System.StringComparison]::OrdinalIgnoreCase)) {
+                        throw "$($package.Name) payload $payloadEntryName has product version $($versionInfo.ProductVersion) instead of $packageVersion."
+                    }
+                }
+            }
+            finally {
+                Remove-Item -LiteralPath $inspectionDirectory -Recurse -Force -ErrorAction SilentlyContinue
+            }
+        }
     }
     finally {
         $zip.Dispose()
diff --git a/src/Packaging/RMC.Wpf.Framework.Controls/RMC.Wpf.Framework.Controls.csproj b/src/Packaging/RMC.Wpf.Framework.Controls/RMC.Wpf.Framework.Controls.csproj
index fd49048e..236e6ceb 100644
--- a/src/Packaging/RMC.Wpf.Framework.Controls/RMC.Wpf.Framework.Controls.csproj
+++ b/src/Packaging/RMC.Wpf.Framework.Controls/RMC.Wpf.Framework.Controls.csproj
@@ -3,7 +3,7 @@
     <TargetFramework>net10.0-windows</TargetFramework>
     <IsPackable>true</IsPackable>
     <IncludeBuildOutput>false</IncludeBuildOutput>
-    <Version>1.0.0</Version>
+    <Version>1.0.1</Version>
     <NuspecFile>RMC.Wpf.Framework.Controls.nuspec</NuspecFile>
     <NuspecBasePath>$(MSBuildProjectDirectory)</NuspecBasePath>
     <NuspecProperties>configuration=$(Configuration);version=$(Version);rmcNumericsPackageDependencyVersion=$(RmcNumericsPackageDependencyVersion)</NuspecProperties>
diff --git a/src/Packaging/RMC.Wpf.Framework.Controls/RMC.Wpf.Framework.Controls.nuspec b/src/Packaging/RMC.Wpf.Framework.Controls/RMC.Wpf.Framework.Controls.nuspec
index 0cf01fb8..ea05ed1c 100644
--- a/src/Packaging/RMC.Wpf.Framework.Controls/RMC.Wpf.Framework.Controls.nuspec
+++ b/src/Packaging/RMC.Wpf.Framework.Controls/RMC.Wpf.Framework.Controls.nuspec
@@ -10,6 +10,7 @@
     <repository type="git" url="https://github.com/USACE-RMC/WPF-Framework" />
     <readme>README.md</readme>
     <description>WPF controls, framework UI, DAG controls, database controls, numeric controls, OxyPlot controls, and AvalonDock assemblies for the RMC WPF Framework.</description>
+    <releaseNotes>Version 1.0.1 improves irregular time-series ordering validation and defaults new OxyPlot line annotations to editable text.</releaseNotes>
     <tags>RMC WPF framework controls AvalonDock OxyPlot numeric database DAG</tags>
     <dependencies>
       <group targetFramework="net10.0-windows7.0">
diff --git a/src/Packaging/RMC.Wpf.Framework.Core/RMC.Wpf.Framework.Core.csproj b/src/Packaging/RMC.Wpf.Framework.Core/RMC.Wpf.Framework.Core.csproj
index a06d7f63..8f231e79 100644
--- a/src/Packaging/RMC.Wpf.Framework.Core/RMC.Wpf.Framework.Core.csproj
+++ b/src/Packaging/RMC.Wpf.Framework.Core/RMC.Wpf.Framework.Core.csproj
@@ -3,7 +3,7 @@
     <TargetFramework>net10.0-windows</TargetFramework>
     <IsPackable>true</IsPackable>
     <IncludeBuildOutput>false</IncludeBuildOutput>
-    <Version>1.0.0</Version>
+    <Version>1.0.1</Version>
     <NuspecFile>RMC.Wpf.Framework.Core.nuspec</NuspecFile>
     <NuspecBasePath>$(MSBuildProjectDirectory)</NuspecBasePath>
     <NuspecProperties>configuration=$(Configuration);version=$(Version)</NuspecProperties>
diff --git a/src/Packaging/RMC.Wpf.Framework.Core/RMC.Wpf.Framework.Core.nuspec b/src/Packaging/RMC.Wpf.Framework.Core/RMC.Wpf.Framework.Core.nuspec
index c32a4f6b..701a6940 100644
--- a/src/Packaging/RMC.Wpf.Framework.Core/RMC.Wpf.Framework.Core.nuspec
+++ b/src/Packaging/RMC.Wpf.Framework.Core/RMC.Wpf.Framework.Core.nuspec
@@ -10,6 +10,7 @@
     <repository type="git" url="https://github.com/USACE-RMC/WPF-Framework" />
     <readme>README.md</readme>
     <description>Core interfaces, project model contracts, undo/redo infrastructure, messaging, and WPF themes for the RMC WPF Framework.</description>
+    <releaseNotes>Coordinated WPF Framework 1.0.1 release; no package-specific functional changes.</releaseNotes>
     <tags>RMC WPF framework themes undo-redo</tags>
     <dependencies>
       <group targetFramework="net10.0-windows7.0" />
diff --git a/src/Packaging/RMC.Wpf.Framework.Models/RMC.Wpf.Framework.Models.csproj b/src/Packaging/RMC.Wpf.Framework.Models/RMC.Wpf.Framework.Models.csproj
index d7fa2d5b..f2fd1102 100644
--- a/src/Packaging/RMC.Wpf.Framework.Models/RMC.Wpf.Framework.Models.csproj
+++ b/src/Packaging/RMC.Wpf.Framework.Models/RMC.Wpf.Framework.Models.csproj
@@ -3,7 +3,7 @@
     <TargetFramework>net10.0-windows</TargetFramework>
     <IsPackable>true</IsPackable>
     <IncludeBuildOutput>false</IncludeBuildOutput>
-    <Version>1.0.0</Version>
+    <Version>1.0.1</Version>
     <NuspecFile>RMC.Wpf.Framework.Models.nuspec</NuspecFile>
     <NuspecBasePath>$(MSBuildProjectDirectory)</NuspecBasePath>
     <NuspecProperties>configuration=$(Configuration);version=$(Version);closedXmlVersion=$(ClosedXmlVersion);documentFormatOpenXmlVersion=$(DocumentFormatOpenXmlVersion);excelNumberFormatVersion=$(ExcelNumberFormatVersion);fastMemberVersion=$(FastMemberVersion);sourceGearSqlite3Version=$(SourceGearSqlite3Version);systemDataSQLiteVersion=$(SystemDataSQLiteVersion)</NuspecProperties>
diff --git a/src/Packaging/RMC.Wpf.Framework.Models/RMC.Wpf.Framework.Models.nuspec b/src/Packaging/RMC.Wpf.Framework.Models/RMC.Wpf.Framework.Models.nuspec
index 26fde9aa..d610aa44 100644
--- a/src/Packaging/RMC.Wpf.Framework.Models/RMC.Wpf.Framework.Models.nuspec
+++ b/src/Packaging/RMC.Wpf.Framework.Models/RMC.Wpf.Framework.Models.nuspec
@@ -10,6 +10,7 @@
     <repository type="git" url="https://github.com/USACE-RMC/WPF-Framework" />
     <readme>README.md</readme>
     <description>Model, graph, database, expression-parser, and vendored OxyPlot assemblies for the RMC WPF Framework.</description>
+    <releaseNotes>Coordinated WPF Framework 1.0.1 release; no package-specific functional changes.</releaseNotes>
     <tags>RMC WPF framework database expression-parser DAG OxyPlot</tags>
     <dependencies>
       <group targetFramework="net10.0-windows7.0">
diff --git a/src/Packaging/RMC.Wpf.Framework.Support/RMC.Wpf.Framework.Support.csproj b/src/Packaging/RMC.Wpf.Framework.Support/RMC.Wpf.Framework.Support.csproj
index 1389cbd4..240a3cea 100644
--- a/src/Packaging/RMC.Wpf.Framework.Support/RMC.Wpf.Framework.Support.csproj
+++ b/src/Packaging/RMC.Wpf.Framework.Support/RMC.Wpf.Framework.Support.csproj
@@ -3,7 +3,7 @@
     <TargetFramework>net10.0-windows</TargetFramework>
     <IsPackable>true</IsPackable>
     <IncludeBuildOutput>false</IncludeBuildOutput>
-    <Version>1.0.0</Version>
+    <Version>1.0.1</Version>
     <!-- The updater executable payload is intentionally packaged as deployable content, not a compile reference. -->
     <NoWarn>$(NoWarn);NU5100</NoWarn>
     <NuspecFile>RMC.Wpf.Framework.Support.nuspec</NuspecFile>
diff --git a/src/Packaging/RMC.Wpf.Framework.Support/RMC.Wpf.Framework.Support.nuspec b/src/Packaging/RMC.Wpf.Framework.Support/RMC.Wpf.Framework.Support.nuspec
index f4706aa3..1e6b0962 100644
--- a/src/Packaging/RMC.Wpf.Framework.Support/RMC.Wpf.Framework.Support.nuspec
+++ b/src/Packaging/RMC.Wpf.Framework.Support/RMC.Wpf.Framework.Support.nuspec
@@ -10,6 +10,7 @@
     <repository type="git" url="https://github.com/USACE-RMC/WPF-Framework" />
     <readme>README.md</readme>
     <description>Software update services and deployable updater helper for the RMC WPF Framework.</description>
+    <releaseNotes>Version 1.0.1 protects settings and runtime data during updates, supports transactional rollback, checksum enforcement, and safe replacement of the installed updater payload.</releaseNotes>
     <tags>RMC WPF framework software-update updater</tags>
     <dependencies>
       <group targetFramework="net10.0-windows7.0" />
diff --git a/src/SoftwareUpdate.Updater/InstallationManager.cs b/src/SoftwareUpdate.Updater/InstallationManager.cs
index 4e9c4f9b..7c9793a5 100644
--- a/src/SoftwareUpdate.Updater/InstallationManager.cs
+++ b/src/SoftwareUpdate.Updater/InstallationManager.cs
@@ -1,4 +1,5 @@
 using System;
+using System.Collections.Generic;
 using System.Diagnostics;
 using System.IO;
 using System.IO.Compression;
@@ -9,35 +10,61 @@
 namespace SoftwareUpdate.Updater
 {
     /// <summary>
-    /// Manages the installation of software updates.
+    /// Manages validation, staging, installation, rollback, and cleanup of software updates.
     /// </summary>
     internal class InstallationManager
     {
-        /// <summary>
-        /// The maximum time in milliseconds to wait for the main application process to exit
-        /// before proceeding with the update. This timeout allows sufficient time for the
-        /// application to gracefully shut down while preventing indefinite hangs if the
-        /// process becomes unresponsive.
-        /// </summary>
-        private const int ProcessExitTimeoutMs = 60 * 1000; // 60 seconds
+        private const int ProcessExitTimeoutMs = 60 * 1000;
+        private const int MaximumArchiveFileCount = 100_000;
+        private const long MaximumUncompressedBytes = 2L * 1024 * 1024 * 1024;
+
+        private static readonly string[] BuiltInProtectedRoots =
+        {
+            "settings",
+            "logs",
+            "updates_pending"
+        };
+
+        private static readonly string[] KnownInstallRoots =
+        {
+            "libraries",
+            "runtimes"
+        };
 
         private readonly UpdaterArguments _args;
         private readonly Action<string> _log;
+        private readonly Action<string>? _beforeApplyFile;
+        private readonly int _maximumArchiveFileCount;
+        private readonly long _maximumUncompressedBytes;
 
         /// <summary>
         /// Initializes a new instance of the <see cref="InstallationManager"/> class.
         /// </summary>
-        /// <param name="args">The updater arguments containing installation configuration.</param>
-        /// <param name="log">The logging action to report progress. If null, defaults to Console.WriteLine.</param>
-        /// <exception cref="ArgumentNullException">Thrown when <paramref name="args"/> is null.</exception>
-        public InstallationManager(UpdaterArguments args, Action<string> log)
+        /// <param name="args">The updater arguments.</param>
+        /// <param name="log">The logging action.</param>
+        /// <param name="beforeApplyFile">An optional test hook invoked before applying each file.</param>
+        /// <param name="maximumArchiveFileCount">The archive file-count limit.</param>
+        /// <param name="maximumUncompressedBytes">The archive uncompressed-size limit.</param>
+        public InstallationManager(
+            UpdaterArguments args,
+            Action<string> log,
+            Action<string>? beforeApplyFile = null,
+            int maximumArchiveFileCount = MaximumArchiveFileCount,
+            long maximumUncompressedBytes = MaximumUncompressedBytes)
         {
             _args = args ?? throw new ArgumentNullException(nameof(args));
             _log = log ?? Console.WriteLine;
+            _beforeApplyFile = beforeApplyFile;
+            _maximumArchiveFileCount = maximumArchiveFileCount > 0
+                ? maximumArchiveFileCount
+                : throw new ArgumentOutOfRangeException(nameof(maximumArchiveFileCount));
+            _maximumUncompressedBytes = maximumUncompressedBytes > 0
+                ? maximumUncompressedBytes
+                : throw new ArgumentOutOfRangeException(nameof(maximumUncompressedBytes));
         }
 
         /// <summary>
-        /// Executes the full update process.
+        /// Executes the complete update transaction.
         /// </summary>
         public void Execute()
         {
@@ -45,284 +72,699 @@ public void Execute()
             _log($"Target directory: {_args.TargetDirectory}");
             _log($"Update package: {_args.ZipPath}");
 
-            // Step 1: Wait for main application to exit
             WaitForProcessExit(_args.ProcessId);
 
-            // Step 2: Create backup if requested
-            string? backupDir = null;
-            if (_args.CreateBackup)
-            {
-                backupDir = CreateBackup();
-            }
+            PreparedUpdate? preparedUpdate = null;
+            string? backupDirectory = null;
+            var transaction = new TransactionState();
 
             try
             {
-                // Step 3: Extract update
-                ExtractUpdate();
+                preparedUpdate = PrepareUpdate();
 
-                // Step 4: Clean up
-                CleanUp(backupDir, success: true);
+                if (_args.CreateBackup)
+                {
+                    backupDirectory = CreateBackup(preparedUpdate.Files);
+                }
 
-                // Step 5: Restart application
+                ApplyUpdate(preparedUpdate.Files, transaction);
+                CleanUp(preparedUpdate.StagingDirectory, backupDirectory, success: true);
                 RestartApplication();
             }
             catch (Exception ex)
             {
                 _log($"ERROR: {ex.Message}");
 
-                // Attempt to restore from backup
-                if (!string.IsNullOrEmpty(backupDir) && Directory.Exists(backupDir))
+                try
                 {
-                    _log("Attempting to restore from backup...");
-                    try
-                    {
-                        RestoreFromBackup(backupDir);
-                        _log("Backup restored successfully.");
-                    }
-                    catch (Exception restoreEx)
+                    Rollback(preparedUpdate?.Files, transaction, backupDirectory);
+                }
+                catch (Exception rollbackException)
+                {
+                    _log($"Failed to roll back update: {rollbackException.Message}");
+                    if (!string.IsNullOrEmpty(backupDirectory))
                     {
-                        _log($"Failed to restore backup: {restoreEx.Message}");
-                        _log($"Backup location: {backupDir}");
+                        _log($"Backup location: {backupDirectory}");
                     }
                 }
 
+                DeleteStagingDirectory(preparedUpdate?.StagingDirectory);
                 throw;
             }
         }
 
         /// <summary>
-        /// Waits for the specified process to exit.
+        /// Waits for the main application process to exit.
         /// </summary>
-        /// <param name="processId">The process ID to wait for.</param>
+        /// <param name="processId">The process identifier.</param>
         private void WaitForProcessExit(int processId)
         {
             _log($"Waiting for process {processId} to exit...");
+            var processWasRunning = false;
 
             try
             {
                 using (var process = Process.GetProcessById(processId))
                 {
-                    if (process.WaitForExit(ProcessExitTimeoutMs))
-                    {
-                        _log("Process has exited.");
-                    }
-                    else
+                    processWasRunning = true;
+                    if (!process.WaitForExit(ProcessExitTimeoutMs))
                     {
                         throw new TimeoutException(
                             $"Process {processId} did not exit within {ProcessExitTimeoutMs / 1000} seconds. " +
                             "Update aborted to prevent file corruption from overwriting locked files.");
                     }
+
+                    _log("Process has exited.");
                 }
             }
             catch (ArgumentException)
             {
-                // Process already exited
                 _log("Process has already exited.");
             }
 
-            // Additional wait to ensure file handles are released
-            Thread.Sleep(1000);
+            if (processWasRunning)
+            {
+                Thread.Sleep(1000);
+            }
         }
 
         /// <summary>
-        /// Creates a backup of the current installation.
+        /// Preflights and extracts allowed archive entries into an isolated staging directory.
         /// </summary>
-        /// <returns>The path to the backup directory.</returns>
-        private string CreateBackup()
+        /// <returns>The prepared update manifest.</returns>
+        private PreparedUpdate PrepareUpdate()
         {
-            _log("Creating backup...");
+            _log("Validating update package...");
 
-            var timestamp = DateTime.UtcNow.ToString("yyyyMMdd_HHmmss");
-            var backupDir = Path.Combine(_args.TargetDirectory!, $".backup_{timestamp}");
+            var targetDirectory = Path.GetFullPath(_args.TargetDirectory!);
+            EnsureNoReparsePoints(targetDirectory, targetDirectory);
 
-            // Handle same-second backup name collisions by adding a suffix counter
-            if (Directory.Exists(backupDir))
+            using var archive = ZipFile.OpenRead(_args.ZipPath!);
+            var archiveFiles = new List<ArchiveFile>();
+
+            foreach (var entry in archive.Entries)
+            {
+                var isDirectory = entry.FullName.EndsWith("/", StringComparison.Ordinal) ||
+                    entry.FullName.EndsWith("\\", StringComparison.Ordinal);
+                var normalizedPath = NormalizeArchivePath(entry.FullName);
+                if (isDirectory || string.IsNullOrEmpty(normalizedPath))
+                    continue;
+
+                archiveFiles.Add(new ArchiveFile(entry, normalizedPath));
+            }
+
+            if (archiveFiles.Count > _maximumArchiveFileCount)
+            {
+                throw new InvalidDataException(
+                    $"Update archive contains more than {_maximumArchiveFileCount:N0} files.");
+            }
+
+            var preservedPaths = BuildPreservedPaths();
+            var stripPrefix = DetermineWrapperPrefix(
+                archiveFiles.Select(file => file.OriginalPath),
+                preservedPaths);
+            var plans = new List<UpdateFilePlan>();
+            long totalUncompressedBytes = 0;
+
+            foreach (var archiveFile in archiveFiles)
             {
-                int suffix = 1;
-                string backupDirWithSuffix;
-                do
+                if (IsProtectedPath(archiveFile.OriginalPath, preservedPaths))
+                    continue;
+
+                var relativePath = stripPrefix != null &&
+                    archiveFile.OriginalPath.StartsWith(stripPrefix, StringComparison.OrdinalIgnoreCase)
+                        ? archiveFile.OriginalPath.Substring(stripPrefix.Length)
+                        : archiveFile.OriginalPath;
+
+                if (string.IsNullOrEmpty(relativePath) || IsProtectedPath(relativePath, preservedPaths))
+                    continue;
+
+                totalUncompressedBytes = checked(totalUncompressedBytes + archiveFile.Entry.Length);
+                if (totalUncompressedBytes > _maximumUncompressedBytes)
                 {
-                    backupDirWithSuffix = Path.Combine(_args.TargetDirectory!, $".backup_{timestamp}_{suffix}");
-                    suffix++;
-                } while (Directory.Exists(backupDirWithSuffix));
-                backupDir = backupDirWithSuffix;
+                    throw new InvalidDataException(
+                        $"Update archive exceeds the {_maximumUncompressedBytes:N0}-byte uncompressed limit.");
+                }
+
+                var destinationPath = GetContainedPath(targetDirectory, relativePath);
+                EnsureNoReparsePoints(targetDirectory, destinationPath);
+                ValidateExistingPathShape(targetDirectory, destinationPath, relativePath);
+
+                plans.Add(new UpdateFilePlan(
+                    archiveFile.Entry,
+                    relativePath,
+                    destinationPath,
+                    File.Exists(destinationPath)));
             }
 
-            Directory.CreateDirectory(backupDir);
+            if (plans.Count == 0)
+                throw new InvalidDataException("Update archive contains no installable files.");
+
+            ValidateManifestCollisions(plans);
+
+            var stagingRoot = Path.Combine(targetDirectory, "updates_pending");
+            EnsureNoReparsePoints(targetDirectory, stagingRoot);
+            Directory.CreateDirectory(stagingRoot);
 
-            // Copy all files except the backup directory itself
-            foreach (var file in Directory.GetFiles(_args.TargetDirectory!))
+            var stagingDirectory = Path.Combine(stagingRoot, $"extract-{Guid.NewGuid():N}");
+            Directory.CreateDirectory(stagingDirectory);
+
+            try
+            {
+                foreach (var plan in plans)
+                {
+                    var stagedPath = GetContainedPath(stagingDirectory, plan.RelativePath);
+                    var stagedParent = Path.GetDirectoryName(stagedPath);
+                    if (!string.IsNullOrEmpty(stagedParent))
+                    {
+                        Directory.CreateDirectory(stagedParent);
+                    }
+
+                    ExtractWithRetry(plan.Entry, stagedPath);
+                    plan.StagedPath = stagedPath;
+                }
+            }
+            catch
+            {
+                DeleteStagingDirectory(stagingDirectory);
+                throw;
+            }
+
+            _log($"Validated and staged {plans.Count:N0} files.");
+            return new PreparedUpdate(stagingDirectory, plans);
+        }
+
+        /// <summary>
+        /// Normalizes and validates an archive entry path.
+        /// </summary>
+        /// <param name="entryPath">The raw archive entry path.</param>
+        /// <returns>The normalized path.</returns>
+        private static string NormalizeArchivePath(string entryPath)
+        {
+            if (string.IsNullOrWhiteSpace(entryPath))
+                return string.Empty;
+
+            var normalized = entryPath.Replace('\\', '/');
+            if (Path.IsPathRooted(entryPath) || normalized.StartsWith("/", StringComparison.Ordinal) ||
+                normalized.Contains(':'))
             {
-                var fileName = Path.GetFileName(file);
-                var destPath = Path.Combine(backupDir, fileName);
-                File.Copy(file, destPath, overwrite: true);
+                throw new SecurityException($"Unsafe absolute or alternate-stream path in update package: '{entryPath}'.");
             }
 
-            foreach (var dir in Directory.GetDirectories(_args.TargetDirectory!))
+            var segments = normalized.Split('/', StringSplitOptions.RemoveEmptyEntries);
+            if (segments.Any(segment => segment is "." or ".."))
             {
-                var dirName = Path.GetFileName(dir);
-                if (dirName.StartsWith(".backup_")) continue;
+                throw new SecurityException(
+                    $"Path traversal attack detected in update package entry '{entryPath}'. Update aborted.");
+            }
 
-                var destPath = Path.Combine(backupDir, dirName);
-                CopyDirectory(dir, destPath);
+            foreach (var segment in segments)
+            {
+                if (segment.IndexOfAny(Path.GetInvalidFileNameChars()) >= 0 ||
+                    segment.EndsWith(" ", StringComparison.Ordinal) ||
+                    segment.EndsWith(".", StringComparison.Ordinal))
+                {
+                    throw new SecurityException($"Unsafe file name in update package entry '{entryPath}'.");
+                }
             }
 
-            _log($"Backup created at: {backupDir}");
-            return backupDir;
+            return string.Join("/", segments);
         }
 
         /// <summary>
-        /// Extracts the update package.
+        /// Determines whether all archive files share a wrapper directory.
         /// </summary>
-        private void ExtractUpdate()
+        /// <param name="paths">The normalized archive file paths.</param>
+        /// <param name="preservedPaths">The protected installation paths.</param>
+        /// <returns>The wrapper prefix, or <see langword="null"/>.</returns>
+        private static string? DetermineWrapperPrefix(
+            IEnumerable<string> paths,
+            IReadOnlyList<string> preservedPaths)
         {
-            _log("Extracting update...");
+            var pathList = paths.ToList();
+            if (pathList.Count == 0)
+                return null;
+
+            var splitPaths = pathList.Select(path => path.Split('/')).ToList();
+            if (splitPaths.Any(segments => segments.Length < 2))
+                return null;
 
-            using (var archive = ZipFile.OpenRead(_args.ZipPath!))
+            var root = splitPaths[0][0];
+            if (KnownInstallRoots.Any(installRoot =>
+                    string.Equals(installRoot, root, StringComparison.OrdinalIgnoreCase)) ||
+                preservedPaths.Any(path =>
+                    string.Equals(path, root, StringComparison.OrdinalIgnoreCase) ||
+                    path.StartsWith(root + "/", StringComparison.OrdinalIgnoreCase)))
             {
-                var totalEntries = archive.Entries.Count;
-                var processedEntries = 0;
+                return null;
+            }
 
-                // Determine if the zip has a single root folder
-                // ZIP entries may use '/' or '\' as path separators
-                var pathSeparators = new[] { '/', '\\' };
-                var rootFolders = archive.Entries
-                    .Where(e => !string.IsNullOrEmpty(e.FullName))
-                    .Select(e => e.FullName.Split(pathSeparators)[0])
-                    .Distinct()
-                    .ToList();
+            return splitPaths.All(segments =>
+                    string.Equals(segments[0], root, StringComparison.OrdinalIgnoreCase))
+                ? root + "/"
+                : null;
+        }
 
-                var hasSingleRoot = rootFolders.Count == 1 &&
-                    archive.Entries.Any(e => e.FullName.StartsWith(rootFolders[0] + "/") ||
-                                             e.FullName.StartsWith(rootFolders[0] + "\\"));
+        /// <summary>
+        /// Builds the immutable and caller-supplied protected path list.
+        /// </summary>
+        /// <returns>Normalized protected paths.</returns>
+        private IReadOnlyList<string> BuildPreservedPaths()
+        {
+            var paths = new List<string>(BuiltInProtectedRoots);
+            foreach (var path in _args.PreservedRelativePaths)
+            {
+                var normalized = NormalizeArchivePath(path).TrimEnd('/');
+                if (string.IsNullOrEmpty(normalized))
+                    throw new ArgumentException($"Invalid preserved path: '{path}'.", nameof(_args));
 
-                var stripPrefix = hasSingleRoot ? rootFolders[0] + "/" : "";
+                paths.Add(normalized);
+            }
 
-                foreach (var entry in archive.Entries)
-                {
-                    processedEntries++;
+            return paths;
+        }
 
-                    // Skip directories
-                    if (string.IsNullOrEmpty(entry.Name))
-                        continue;
+        /// <summary>
+        /// Determines whether a relative path is protected from update writes.
+        /// </summary>
+        /// <param name="relativePath">The normalized relative path.</param>
+        /// <param name="preservedPaths">The protected paths.</param>
+        /// <returns><see langword="true"/> when the path must be preserved.</returns>
+        private static bool IsProtectedPath(string relativePath, IReadOnlyList<string> preservedPaths)
+        {
+            var normalized = relativePath.Replace('\\', '/').Trim('/');
+            var segments = normalized.Split('/', StringSplitOptions.RemoveEmptyEntries);
 
-                    // Calculate destination path, stripping root folder if present
-                    var entryPath = entry.FullName;
-                    if (!string.IsNullOrEmpty(stripPrefix) && entryPath.StartsWith(stripPrefix))
-                    {
-                        entryPath = entryPath.Substring(stripPrefix.Length);
-                    }
+            if (segments.Any(segment => segment.StartsWith(".backup_", StringComparison.OrdinalIgnoreCase)))
+                return true;
+
+            return preservedPaths.Any(path =>
+                string.Equals(normalized, path, StringComparison.OrdinalIgnoreCase) ||
+                normalized.StartsWith(path + "/", StringComparison.OrdinalIgnoreCase));
+        }
 
-                    if (string.IsNullOrEmpty(entryPath))
-                        continue;
+        /// <summary>
+        /// Resolves a relative path and verifies that it stays within the supplied root.
+        /// </summary>
+        /// <param name="rootDirectory">The containing root directory.</param>
+        /// <param name="relativePath">The normalized relative path.</param>
+        /// <returns>The contained full path.</returns>
+        private static string GetContainedPath(string rootDirectory, string relativePath)
+        {
+            var fullRoot = Path.TrimEndingDirectorySeparator(Path.GetFullPath(rootDirectory));
+            var fullPath = Path.GetFullPath(Path.Combine(
+                fullRoot,
+                relativePath.Replace('/', Path.DirectorySeparatorChar)));
 
-                    var destPath = Path.Combine(_args.TargetDirectory!, entryPath);
+            if (!fullPath.StartsWith(fullRoot + Path.DirectorySeparatorChar, StringComparison.OrdinalIgnoreCase))
+            {
+                throw new SecurityException(
+                    $"Path traversal attack detected: '{relativePath}' resolves outside the update root.");
+            }
 
-                    // Validate path doesn't escape target directory (prevent path traversal)
-                    var fullDestPath = Path.GetFullPath(destPath);
-                    var fullTargetDir = Path.GetFullPath(_args.TargetDirectory!);
-                    if (!fullDestPath.StartsWith(fullTargetDir + Path.DirectorySeparatorChar, StringComparison.OrdinalIgnoreCase) &&
-                        !string.Equals(fullDestPath, fullTargetDir, StringComparison.OrdinalIgnoreCase))
-                    {
-                        throw new SecurityException(
-                            $"Path traversal attack detected in update package. " +
-                            $"Entry '{entryPath}' resolves outside target directory. Update aborted.");
-                    }
+            return fullPath;
+        }
 
-                    // Skip backup directories - check if any path segment starts with .backup_
-                    if (entryPath.StartsWith(".backup_") ||
-                        entryPath.Contains("/.backup_") ||
-                        entryPath.Contains("\\.backup_"))
-                        continue;
+        /// <summary>
+        /// Rejects duplicate destinations and file-directory conflicts within the manifest.
+        /// </summary>
+        /// <param name="plans">The update file plans.</param>
+        private static void ValidateManifestCollisions(IReadOnlyList<UpdateFilePlan> plans)
+        {
+            var paths = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
+            foreach (var plan in plans)
+            {
+                if (!paths.Add(plan.RelativePath))
+                    throw new InvalidDataException($"Duplicate update destination: '{plan.RelativePath}'.");
+            }
 
-                    // Create directory if needed
-                    var destDir = Path.GetDirectoryName(destPath);
-                    if (!string.IsNullOrEmpty(destDir) && !Directory.Exists(destDir))
+            foreach (var path in paths)
+            {
+                var parent = path;
+                while (parent.Contains('/'))
+                {
+                    parent = parent.Substring(0, parent.LastIndexOf('/'));
+                    if (paths.Contains(parent))
                     {
-                        Directory.CreateDirectory(destDir);
+                        throw new InvalidDataException(
+                            $"Update archive contains a file-directory collision at '{parent}'.");
                     }
+                }
+            }
+        }
+
+        /// <summary>
+        /// Rejects existing file-directory shape conflicts before any writes occur.
+        /// </summary>
+        /// <param name="targetDirectory">The installation root.</param>
+        /// <param name="destinationPath">The planned destination file.</param>
+        /// <param name="relativePath">The relative destination path.</param>
+        private static void ValidateExistingPathShape(
+            string targetDirectory,
+            string destinationPath,
+            string relativePath)
+        {
+            if (Directory.Exists(destinationPath))
+            {
+                throw new InvalidDataException(
+                    $"Update file '{relativePath}' conflicts with an existing directory.");
+            }
+
+            var parent = Path.GetDirectoryName(destinationPath);
+            while (!string.IsNullOrEmpty(parent) &&
+                !string.Equals(parent, targetDirectory, StringComparison.OrdinalIgnoreCase))
+            {
+                if (File.Exists(parent))
+                {
+                    throw new InvalidDataException(
+                        $"Update file '{relativePath}' has an existing file in its directory path.");
+                }
+
+                parent = Path.GetDirectoryName(parent);
+            }
+        }
+
+        /// <summary>
+        /// Rejects existing reparse points between an installation root and candidate path.
+        /// </summary>
+        /// <param name="targetDirectory">The installation root.</param>
+        /// <param name="candidatePath">The path to inspect.</param>
+        private static void EnsureNoReparsePoints(string targetDirectory, string candidatePath)
+        {
+            var fullTarget = Path.TrimEndingDirectorySeparator(Path.GetFullPath(targetDirectory));
+            var fullCandidate = Path.GetFullPath(candidatePath);
+            if (!string.Equals(fullCandidate, fullTarget, StringComparison.OrdinalIgnoreCase) &&
+                !fullCandidate.StartsWith(fullTarget + Path.DirectorySeparatorChar, StringComparison.OrdinalIgnoreCase))
+            {
+                throw new SecurityException($"Path '{candidatePath}' is outside the installation directory.");
+            }
+
+            var relative = Path.GetRelativePath(fullTarget, fullCandidate);
+            var current = fullTarget;
+            ThrowIfReparsePoint(current);
+
+            if (relative == ".")
+                return;
+
+            foreach (var segment in relative.Split(Path.DirectorySeparatorChar, StringSplitOptions.RemoveEmptyEntries))
+            {
+                current = Path.Combine(current, segment);
+                if (!File.Exists(current) && !Directory.Exists(current))
+                    break;
+
+                ThrowIfReparsePoint(current);
+            }
+        }
+
+        /// <summary>
+        /// Throws when an existing file-system entry is a reparse point.
+        /// </summary>
+        /// <param name="path">The existing path.</param>
+        private static void ThrowIfReparsePoint(string path)
+        {
+            if ((File.GetAttributes(path) & FileAttributes.ReparsePoint) != 0)
+                throw new SecurityException($"Update path cannot traverse reparse point '{path}'.");
+        }
+
+        /// <summary>
+        /// Creates a targeted backup of files that the update will overwrite.
+        /// </summary>
+        /// <param name="plans">The update manifest.</param>
+        /// <returns>The backup directory.</returns>
+        private string CreateBackup(IReadOnlyList<UpdateFilePlan> plans)
+        {
+            _log("Creating targeted backup...");
+            var backupDirectory = CreateUniqueBackupDirectory();
+            Directory.CreateDirectory(backupDirectory);
+
+            foreach (var plan in plans.Where(plan => plan.ExistedBefore))
+            {
+                EnsureNoReparsePoints(_args.TargetDirectory!, plan.DestinationPath);
+                if (!File.Exists(plan.DestinationPath))
+                    throw new IOException($"File disappeared before backup: '{plan.DestinationPath}'.");
+
+                var backupPath = GetContainedPath(backupDirectory, plan.RelativePath);
+                var backupParent = Path.GetDirectoryName(backupPath);
+                if (!string.IsNullOrEmpty(backupParent))
+                {
+                    Directory.CreateDirectory(backupParent);
+                }
+
+                CopyFileWithRetry(plan.DestinationPath, backupPath, overwrite: false);
+            }
+
+            _log($"Backup created at: {backupDirectory}");
+            return backupDirectory;
+        }
+
+        /// <summary>
+        /// Creates a collision-free backup directory path.
+        /// </summary>
+        /// <returns>The backup directory path.</returns>
+        private string CreateUniqueBackupDirectory()
+        {
+            var timestamp = DateTime.UtcNow.ToString("yyyyMMdd_HHmmss");
+            var basePath = Path.Combine(_args.TargetDirectory!, $".backup_{timestamp}");
+            var candidate = basePath;
+            var suffix = 1;
+
+            while (Directory.Exists(candidate))
+            {
+                candidate = basePath + "_" + suffix++;
+            }
+
+            return candidate;
+        }
+
+        /// <summary>
+        /// Applies staged files to the installation and records rollback state.
+        /// </summary>
+        /// <param name="plans">The update manifest.</param>
+        /// <param name="transaction">The transaction state.</param>
+        private void ApplyUpdate(IReadOnlyList<UpdateFilePlan> plans, TransactionState transaction)
+        {
+            _log("Applying staged update...");
 
-                    // Extract file with retries (in case of locked files)
-                    ExtractWithRetry(entry, destPath);
+            foreach (var plan in plans)
+            {
+                _beforeApplyFile?.Invoke(plan.RelativePath);
+                EnsureNoReparsePoints(_args.TargetDirectory!, plan.DestinationPath);
+                EnsureDestinationDirectory(plan.DestinationPath, transaction);
+
+                if (!plan.ExistedBefore)
+                {
+                    transaction.CreatedFiles.Add(plan.DestinationPath);
+                }
+
+                CopyFileWithRetry(plan.StagedPath!, plan.DestinationPath, overwrite: true);
+            }
 
-                    if (processedEntries % 10 == 0 || processedEntries == totalEntries)
+            _log("Update applied successfully.");
+        }
+
+        /// <summary>
+        /// Creates missing destination directories and records those introduced by the update.
+        /// </summary>
+        /// <param name="destinationPath">The destination file path.</param>
+        /// <param name="transaction">The transaction state.</param>
+        private void EnsureDestinationDirectory(string destinationPath, TransactionState transaction)
+        {
+            var targetDirectory = Path.GetFullPath(_args.TargetDirectory!);
+            var directory = Path.GetDirectoryName(destinationPath);
+            if (string.IsNullOrEmpty(directory))
+                return;
+
+            var missingDirectories = new Stack<string>();
+            var current = directory;
+            while (!Directory.Exists(current))
+            {
+                if (File.Exists(current))
+                    throw new IOException($"A file blocks creation of update directory '{current}'.");
+
+                missingDirectories.Push(current);
+                current = Path.GetDirectoryName(current)
+                    ?? throw new IOException($"Cannot resolve parent directory for '{destinationPath}'.");
+
+                if (!current.StartsWith(targetDirectory, StringComparison.OrdinalIgnoreCase))
+                    throw new SecurityException($"Destination directory escapes the installation: '{directory}'.");
+            }
+
+            while (missingDirectories.Count > 0)
+            {
+                var createdDirectory = missingDirectories.Pop();
+                Directory.CreateDirectory(createdDirectory);
+                transaction.CreatedDirectories.Add(createdDirectory);
+            }
+        }
+
+        /// <summary>
+        /// Extracts an archive entry with retry handling.
+        /// </summary>
+        /// <param name="entry">The archive entry.</param>
+        /// <param name="destinationPath">The staging destination.</param>
+        /// <param name="maximumRetries">The maximum attempts.</param>
+        private void ExtractWithRetry(
+            ZipArchiveEntry entry,
+            string destinationPath,
+            int maximumRetries = 3)
+        {
+            for (var attempt = 1; attempt <= maximumRetries; attempt++)
+            {
+                try
+                {
+                    entry.ExtractToFile(destinationPath, overwrite: false);
+                    return;
+                }
+                catch (IOException) when (attempt < maximumRetries)
+                {
+                    if (File.Exists(destinationPath))
                     {
-                        _log($"Extracted {processedEntries}/{totalEntries} files...");
+                        File.Delete(destinationPath);
                     }
+                    Thread.Sleep(250 * attempt);
                 }
             }
-
-            _log("Update extracted successfully.");
         }
 
         /// <summary>
-        /// Extracts a single entry with retry logic for locked files.
+        /// Copies a file with retry handling for transient locks.
         /// </summary>
-        /// <param name="entry">The zip archive entry to extract.</param>
-        /// <param name="destPath">The destination file path.</param>
-        /// <param name="maxRetries">Maximum number of retry attempts.</param>
-        private void ExtractWithRetry(ZipArchiveEntry entry, string destPath, int maxRetries = 3)
+        /// <param name="sourcePath">The source file.</param>
+        /// <param name="destinationPath">The destination file.</param>
+        /// <param name="overwrite">Whether an existing destination may be replaced.</param>
+        /// <param name="maximumRetries">The maximum attempts.</param>
+        private void CopyFileWithRetry(
+            string sourcePath,
+            string destinationPath,
+            bool overwrite,
+            int maximumRetries = 3)
         {
-            for (int attempt = 1; attempt <= maxRetries; attempt++)
+            for (var attempt = 1; attempt <= maximumRetries; attempt++)
             {
                 try
                 {
-                    entry.ExtractToFile(destPath, overwrite: true);
+                    File.Copy(sourcePath, destinationPath, overwrite);
                     return;
                 }
-                catch (IOException) when (attempt < maxRetries)
+                catch (IOException) when (attempt < maximumRetries)
                 {
-                    _log($"File locked, retrying ({attempt}/{maxRetries}): {Path.GetFileName(destPath)}");
+                    if (!overwrite && File.Exists(destinationPath))
+                    {
+                        File.Delete(destinationPath);
+                    }
+                    _log($"File locked, retrying ({attempt}/{maximumRetries}): {Path.GetFileName(destinationPath)}");
                     Thread.Sleep(1000 * attempt);
                 }
             }
         }
 
         /// <summary>
-        /// Restores files from backup.
+        /// Restores overwritten files and removes files and directories introduced by a failed update.
         /// </summary>
-        /// <param name="backupDir">The backup directory path.</param>
-        private void RestoreFromBackup(string backupDir)
+        /// <param name="plans">The update manifest, when preparation completed.</param>
+        /// <param name="transaction">The transaction state.</param>
+        /// <param name="backupDirectory">The targeted backup directory.</param>
+        private void Rollback(
+            IReadOnlyList<UpdateFilePlan>? plans,
+            TransactionState transaction,
+            string? backupDirectory)
         {
-            var fullTargetDir = Path.GetFullPath(_args.TargetDirectory!);
+            if (plans == null)
+                return;
 
-            foreach (var file in Directory.GetFiles(backupDir))
-            {
-                var fileName = Path.GetFileName(file);
-                var destPath = Path.Combine(_args.TargetDirectory!, fileName);
+            _log("Rolling back failed update...");
+            var preservedPaths = BuildPreservedPaths();
+            var targetDirectory = Path.GetFullPath(_args.TargetDirectory!);
 
-                // Validate path stays within target directory
-                var fullDestPath = Path.GetFullPath(destPath);
-                if (!fullDestPath.StartsWith(fullTargetDir + Path.DirectorySeparatorChar, StringComparison.OrdinalIgnoreCase))
+            foreach (var file in transaction.CreatedFiles.OrderByDescending(path => path.Length))
+            {
+                var relativePath = Path.GetRelativePath(targetDirectory, file).Replace('\\', '/');
+                if (IsProtectedPath(relativePath, preservedPaths))
                     continue;
 
-                File.Copy(file, destPath, overwrite: true);
+                if (File.Exists(file))
+                {
+                    File.Delete(file);
+                }
             }
 
-            foreach (var dir in Directory.GetDirectories(backupDir))
+            if (!string.IsNullOrEmpty(backupDirectory) && Directory.Exists(backupDirectory))
             {
-                var dirName = Path.GetFileName(dir);
-                var destPath = Path.Combine(_args.TargetDirectory!, dirName);
+                RestoreFromBackup(backupDirectory);
+            }
 
-                // Validate path stays within target directory
-                var fullDestPath = Path.GetFullPath(destPath);
-                if (!fullDestPath.StartsWith(fullTargetDir + Path.DirectorySeparatorChar, StringComparison.OrdinalIgnoreCase))
-                    continue;
+            foreach (var directory in transaction.CreatedDirectories.OrderByDescending(path => path.Length))
+            {
+                var relativePath = Path.GetRelativePath(targetDirectory, directory).Replace('\\', '/');
+                if (!IsProtectedPath(relativePath, preservedPaths) && Directory.Exists(directory) &&
+                    Directory.GetFileSystemEntries(directory).Length == 0)
+                {
+                    Directory.Delete(directory);
+                }
+            }
+
+            _log("Rollback completed.");
+        }
+
+        /// <summary>
+        /// Restores all files from a targeted backup directory.
+        /// </summary>
+        /// <param name="backupDirectory">The backup directory.</param>
+        private void RestoreFromBackup(string backupDirectory)
+        {
+            var targetDirectory = Path.GetFullPath(_args.TargetDirectory!);
+            foreach (var backupFile in EnumerateFilesWithoutReparsePoints(backupDirectory))
+            {
+                var relativePath = Path.GetRelativePath(backupDirectory, backupFile).Replace('\\', '/');
+                var destinationPath = GetContainedPath(targetDirectory, relativePath);
+                EnsureNoReparsePoints(targetDirectory, destinationPath);
+
+                var destinationParent = Path.GetDirectoryName(destinationPath);
+                if (!string.IsNullOrEmpty(destinationParent))
+                {
+                    Directory.CreateDirectory(destinationParent);
+                }
+
+                CopyFileWithRetry(backupFile, destinationPath, overwrite: true);
+            }
+        }
+
+        /// <summary>
+        /// Enumerates files recursively while refusing file and directory reparse points.
+        /// </summary>
+        /// <param name="directory">The directory to enumerate.</param>
+        /// <returns>The contained regular files.</returns>
+        private static IEnumerable<string> EnumerateFilesWithoutReparsePoints(string directory)
+        {
+            ThrowIfReparsePoint(directory);
 
-                CopyDirectory(dir, destPath);
+            foreach (var file in Directory.GetFiles(directory))
+            {
+                ThrowIfReparsePoint(file);
+                yield return file;
+            }
+
+            foreach (var childDirectory in Directory.GetDirectories(directory))
+            {
+                ThrowIfReparsePoint(childDirectory);
+                foreach (var file in EnumerateFilesWithoutReparsePoints(childDirectory))
+                {
+                    yield return file;
+                }
             }
         }
 
         /// <summary>
-        /// Cleans up temporary files.
+        /// Removes update staging data and rotates successful backups.
         /// </summary>
-        /// <param name="backupDir">The backup directory path.</param>
-        /// <param name="success">Whether the update was successful.</param>
-        private void CleanUp(string? backupDir, bool success)
+        /// <param name="stagingDirectory">The extraction staging directory.</param>
+        /// <param name="backupDirectory">The current backup directory.</param>
+        /// <param name="success">Whether installation succeeded.</param>
+        private void CleanUp(string stagingDirectory, string? backupDirectory, bool success)
         {
             _log("Cleaning up...");
+            DeleteStagingDirectory(stagingDirectory);
 
-            // Delete the downloaded zip
             try
             {
                 if (File.Exists(_args.ZipPath))
@@ -331,165 +773,320 @@ private void CleanUp(string? backupDir, bool success)
                     _log("Deleted update package.");
                 }
 
-                // Best-effort: also delete the parent directory if it is the per-download
-                // staging folder created by GitHubUpdateService at "%TEMP%/SoftwareUpdate/{guid}".
-                // Restrict the cleanup to that exact pattern so we never recursively delete
-                // a user-supplied path or anything outside %TEMP%.
-                var zipDir = Path.GetDirectoryName(_args.ZipPath);
-                if (!string.IsNullOrEmpty(zipDir) && Directory.Exists(zipDir))
+                DeleteEmptyPackageDirectory();
+            }
+            catch (Exception ex) when (ex is IOException or UnauthorizedAccessException or SecurityException)
+            {
+                _log($"Warning: Could not delete update package: {ex.Message}");
+            }
+
+            if (!success || string.IsNullOrEmpty(backupDirectory))
+                return;
+
+            try
+            {
+                var oldBackups = Directory.GetDirectories(_args.TargetDirectory!, ".backup_*")
+                    .Select(path => new { Path = path, Timestamp = ParseBackupTimestamp(path) })
+                    .Where(backup => backup.Timestamp.HasValue)
+                    .OrderByDescending(backup => backup.Timestamp!.Value)
+                    .Skip(2)
+                    .Select(backup => backup.Path);
+
+                foreach (var oldBackup in oldBackups)
                 {
-                    var tempRoot = Path.GetFullPath(Path.Combine(Path.GetTempPath(), "SoftwareUpdate"));
-                    var fullZipDir = Path.GetFullPath(zipDir);
-                    var parent = Path.GetDirectoryName(fullZipDir);
-                    var isInTempStagingArea =
-                        parent != null &&
-                        string.Equals(Path.GetFullPath(parent), tempRoot, StringComparison.OrdinalIgnoreCase) &&
-                        // The leaf must be a GUID-shaped name (32 hex chars, no dashes — Guid("N")).
-                        Guid.TryParseExact(Path.GetFileName(fullZipDir), "N", out _);
-
-                    if (isInTempStagingArea && Directory.GetFileSystemEntries(fullZipDir).Length == 0)
-                    {
-                        Directory.Delete(fullZipDir);
-                        _log("Deleted empty staging directory.");
-                    }
+                    DeleteDirectoryWithoutFollowingReparsePoints(oldBackup);
+                    _log($"Deleted old backup: {Path.GetFileName(oldBackup)}");
                 }
             }
-            catch (Exception ex)
+            catch (Exception ex) when (ex is IOException or UnauthorizedAccessException or SecurityException)
             {
-                _log($"Warning: Could not delete update package: {ex.Message}");
+                _log($"Warning: Could not clean old backups: {ex.Message}");
             }
+        }
 
-            // If successful, optionally delete old backups (keep last 2)
-            if (success)
+        /// <summary>
+        /// Deletes an empty updater-owned package directory.
+        /// </summary>
+        private void DeleteEmptyPackageDirectory()
+        {
+            var packageDirectory = Path.GetDirectoryName(_args.ZipPath);
+            if (string.IsNullOrEmpty(packageDirectory) || !Directory.Exists(packageDirectory) ||
+                Directory.GetFileSystemEntries(packageDirectory).Length != 0)
             {
-                try
+                return;
+            }
+
+            var fullPackageDirectory = Path.GetFullPath(packageDirectory);
+            var targetPendingDirectory = Path.GetFullPath(Path.Combine(_args.TargetDirectory!, "updates_pending"));
+            if (string.Equals(fullPackageDirectory, targetPendingDirectory, StringComparison.OrdinalIgnoreCase))
+            {
+                Directory.Delete(fullPackageDirectory);
+                return;
+            }
+
+            var tempRoot = Path.GetFullPath(Path.Combine(Path.GetTempPath(), "SoftwareUpdate"));
+            var parent = Path.GetDirectoryName(fullPackageDirectory);
+            if (parent != null && string.Equals(Path.GetFullPath(parent), tempRoot, StringComparison.OrdinalIgnoreCase) &&
+                Guid.TryParseExact(Path.GetFileName(fullPackageDirectory), "N", out _))
+            {
+                Directory.Delete(fullPackageDirectory);
+            }
+        }
+
+        /// <summary>
+        /// Best-effort deletion of an updater-owned extraction staging directory.
+        /// </summary>
+        /// <param name="stagingDirectory">The staging directory.</param>
+        private void DeleteStagingDirectory(string? stagingDirectory)
+        {
+            if (string.IsNullOrEmpty(stagingDirectory) || !Directory.Exists(stagingDirectory))
+                return;
+
+            try
+            {
+                var fullStagingDirectory = Path.GetFullPath(stagingDirectory);
+                var pendingDirectory = Path.GetFullPath(Path.Combine(_args.TargetDirectory!, "updates_pending"));
+                var parent = Path.GetDirectoryName(fullStagingDirectory);
+                var name = Path.GetFileName(fullStagingDirectory);
+
+                if (parent == null || !string.Equals(parent, pendingDirectory, StringComparison.OrdinalIgnoreCase) ||
+                    !name.StartsWith("extract-", StringComparison.OrdinalIgnoreCase) ||
+                    !Guid.TryParseExact(name.Substring("extract-".Length), "N", out _))
                 {
-                    var backupDirs = Directory.GetDirectories(_args.TargetDirectory!, ".backup_*")
-                        .Select(d => new { Path = d, Timestamp = ParseBackupTimestamp(d) })
-                        .Where(b => b.Timestamp.HasValue)
-                        .OrderByDescending(b => b.Timestamp!.Value)
-                        .Skip(2) // Keep 2 most recent
-                        .Select(b => b.Path)
-                        .ToList();
-
-                    foreach (var dir in backupDirs)
-                    {
-                        Directory.Delete(dir, recursive: true);
-                        _log($"Deleted old backup: {Path.GetFileName(dir)}");
-                    }
+                    return;
+                }
+
+                DeleteDirectoryWithoutFollowingReparsePoints(fullStagingDirectory);
+            }
+            catch (Exception ex) when (ex is IOException or UnauthorizedAccessException or SecurityException)
+            {
+                _log($"Warning: Could not delete extraction staging directory: {ex.Message}");
+            }
+        }
+
+        /// <summary>
+        /// Deletes a directory tree without traversing directory reparse points.
+        /// </summary>
+        /// <param name="directory">The directory to delete.</param>
+        private static void DeleteDirectoryWithoutFollowingReparsePoints(string directory)
+        {
+            foreach (var file in Directory.GetFiles(directory))
+            {
+                if ((File.GetAttributes(file) & FileAttributes.ReparsePoint) == 0)
+                {
+                    File.SetAttributes(file, FileAttributes.Normal);
+                }
+                File.Delete(file);
+            }
+
+            foreach (var childDirectory in Directory.GetDirectories(directory))
+            {
+                var attributes = File.GetAttributes(childDirectory);
+                if ((attributes & FileAttributes.ReparsePoint) != 0)
+                {
+                    Directory.Delete(childDirectory);
                 }
-                catch (Exception ex)
+                else
                 {
-                    _log($"Warning: Could not clean old backups: {ex.Message}");
+                    DeleteDirectoryWithoutFollowingReparsePoints(childDirectory);
                 }
             }
+
+            Directory.Delete(directory);
         }
 
         /// <summary>
-        /// Restarts the main application.
+        /// Restarts the main application after a successful update.
         /// </summary>
         private void RestartApplication()
         {
             _log("Restarting application...");
-
-            // Sanitize MainExecutable to prevent path traversal
             var safeExecutable = Path.GetFileName(_args.MainExecutable);
-            var exePath = Path.Combine(_args.TargetDirectory!, safeExecutable!);
+            var executablePath = Path.Combine(_args.TargetDirectory!, safeExecutable!);
 
-            if (!File.Exists(exePath))
+            if (!File.Exists(executablePath))
             {
-                _log($"Warning: Main executable not found at {exePath}");
+                _log($"Warning: Main executable not found at {executablePath}");
                 _log("Update completed. Please restart the application manually.");
                 return;
             }
 
             var startInfo = new ProcessStartInfo
             {
-                FileName = exePath,
+                FileName = executablePath,
                 WorkingDirectory = _args.TargetDirectory,
                 UseShellExecute = true
             };
 
-            // Process.Start can return null when UseShellExecute redirects to an already-running
-            // instance, and can throw on AV-blocked or otherwise-unstartable executables. Log
-            // either outcome so the post-install state is auditable instead of silently treated
-            // as success — the user may otherwise see no app come back and have no idea why.
             try
             {
                 var started = Process.Start(startInfo);
                 if (started == null)
                 {
-                    _log($"Warning: Process.Start returned null for {exePath}. Update applied, but the application " +
-                         "could not be restarted automatically. Please launch it manually.");
+                    _log($"Warning: Could not restart {executablePath}. Please launch it manually.");
                     return;
                 }
+
                 started.Dispose();
                 _log("Application restarted.");
             }
             catch (Exception ex)
             {
-                _log($"Error: Failed to restart application at {exePath}: {ex.GetType().Name}: {ex.Message}. " +
-                     "Update applied successfully but please launch the application manually.");
+                _log($"Error: Failed to restart application at {executablePath}: {ex.Message}. " +
+                    "The update was applied; please launch the application manually.");
             }
         }
 
         /// <summary>
-        /// Recursively copies a directory.
+        /// Recursively copies a directory while refusing reparse points.
         /// </summary>
-        /// <param name="sourceDir">The source directory path.</param>
-        /// <param name="destDir">The destination directory path.</param>
-        private void CopyDirectory(string sourceDir, string destDir)
+        /// <param name="sourceDirectory">The source directory.</param>
+        /// <param name="destinationDirectory">The destination directory.</param>
+        private void CopyDirectory(string sourceDirectory, string destinationDirectory)
         {
-            Directory.CreateDirectory(destDir);
+            ThrowIfReparsePoint(sourceDirectory);
+            Directory.CreateDirectory(destinationDirectory);
 
-            foreach (var file in Directory.GetFiles(sourceDir))
+            foreach (var file in Directory.GetFiles(sourceDirectory))
             {
-                var destFile = Path.Combine(destDir, Path.GetFileName(file));
-                File.Copy(file, destFile, overwrite: true);
+                ThrowIfReparsePoint(file);
+                File.Copy(file, Path.Combine(destinationDirectory, Path.GetFileName(file)), overwrite: true);
             }
 
-            foreach (var dir in Directory.GetDirectories(sourceDir))
+            foreach (var childDirectory in Directory.GetDirectories(sourceDirectory))
             {
-                var destSubDir = Path.Combine(destDir, Path.GetFileName(dir));
-                CopyDirectory(dir, destSubDir);
+                CopyDirectory(
+                    childDirectory,
+                    Path.Combine(destinationDirectory, Path.GetFileName(childDirectory)));
             }
         }
 
         /// <summary>
         /// Parses the timestamp from a backup directory name.
         /// </summary>
-        /// <param name="backupPath">The full path to the backup directory.</param>
-        /// <returns>The parsed DateTime, or null if parsing fails.</returns>
-        /// <remarks>
-        /// Expects directory names in the format ".backup_yyyyMMdd_HHmmss" or ".backup_yyyyMMdd_HHmmss_N" (with suffix counter).
-        /// </remarks>
+        /// <param name="backupPath">The backup directory path.</param>
+        /// <returns>The parsed timestamp, or <see langword="null"/>.</returns>
         private static DateTime? ParseBackupTimestamp(string backupPath)
         {
-            var dirName = Path.GetFileName(backupPath);
-            if (string.IsNullOrEmpty(dirName) || !dirName.StartsWith(".backup_"))
+            var directoryName = Path.GetFileName(backupPath);
+            if (string.IsNullOrEmpty(directoryName) ||
+                !directoryName.StartsWith(".backup_", StringComparison.OrdinalIgnoreCase))
             {
                 return null;
             }
 
-            // Extract timestamp portion after ".backup_"
-            var timestampPart = dirName.Substring(".backup_".Length);
-
-            // Handle suffix counter format: yyyyMMdd_HHmmss_N
-            // Try to parse the first 15 characters as the timestamp
+            var timestampPart = directoryName.Substring(".backup_".Length);
             if (timestampPart.Length > 15 && timestampPart[15] == '_')
             {
                 timestampPart = timestampPart.Substring(0, 15);
             }
 
-            if (DateTime.TryParseExact(timestampPart, "yyyyMMdd_HHmmss",
+            return DateTime.TryParseExact(
+                timestampPart,
+                "yyyyMMdd_HHmmss",
                 System.Globalization.CultureInfo.InvariantCulture,
                 System.Globalization.DateTimeStyles.None,
-                out var timestamp))
+                out var timestamp)
+                ? timestamp
+                : null;
+        }
+
+        /// <summary>
+        /// Associates an archive entry with its normalized original path.
+        /// </summary>
+        private sealed class ArchiveFile
+        {
+            /// <summary>
+            /// Initializes a new instance of the <see cref="ArchiveFile"/> class.
+            /// </summary>
+            /// <param name="entry">The archive entry.</param>
+            /// <param name="originalPath">The normalized path.</param>
+            public ArchiveFile(ZipArchiveEntry entry, string originalPath)
+            {
+                Entry = entry;
+                OriginalPath = originalPath;
+            }
+
+            /// <summary>Gets the archive entry.</summary>
+            public ZipArchiveEntry Entry { get; }
+
+            /// <summary>Gets the normalized original path.</summary>
+            public string OriginalPath { get; }
+        }
+
+        /// <summary>
+        /// Describes one file in the prepared update manifest.
+        /// </summary>
+        private sealed class UpdateFilePlan
+        {
+            /// <summary>
+            /// Initializes a new instance of the <see cref="UpdateFilePlan"/> class.
+            /// </summary>
+            /// <param name="entry">The archive entry.</param>
+            /// <param name="relativePath">The destination-relative path.</param>
+            /// <param name="destinationPath">The full destination path.</param>
+            /// <param name="existedBefore">Whether the destination existed before application.</param>
+            public UpdateFilePlan(
+                ZipArchiveEntry entry,
+                string relativePath,
+                string destinationPath,
+                bool existedBefore)
+            {
+                Entry = entry;
+                RelativePath = relativePath;
+                DestinationPath = destinationPath;
+                ExistedBefore = existedBefore;
+            }
+
+            /// <summary>Gets the archive entry.</summary>
+            public ZipArchiveEntry Entry { get; }
+
+            /// <summary>Gets the destination-relative path.</summary>
+            public string RelativePath { get; }
+
+            /// <summary>Gets the full destination path.</summary>
+            public string DestinationPath { get; }
+
+            /// <summary>Gets whether the destination existed before installation.</summary>
+            public bool ExistedBefore { get; }
+
+            /// <summary>Gets or sets the staged source path.</summary>
+            public string? StagedPath { get; set; }
+        }
+
+        /// <summary>
+        /// Holds the staged directory and prepared file manifest.
+        /// </summary>
+        private sealed class PreparedUpdate
+        {
+            /// <summary>
+            /// Initializes a new instance of the <see cref="PreparedUpdate"/> class.
+            /// </summary>
+            /// <param name="stagingDirectory">The staging directory.</param>
+            /// <param name="files">The prepared files.</param>
+            public PreparedUpdate(string stagingDirectory, IReadOnlyList<UpdateFilePlan> files)
             {
-                return timestamp;
+                StagingDirectory = stagingDirectory;
+                Files = files;
             }
 
-            return null;
+            /// <summary>Gets the staging directory.</summary>
+            public string StagingDirectory { get; }
+
+            /// <summary>Gets the prepared update files.</summary>
+            public IReadOnlyList<UpdateFilePlan> Files { get; }
+        }
+
+        /// <summary>
+        /// Tracks installation entries that must be removed during rollback.
+        /// </summary>
+        private sealed class TransactionState
+        {
+            /// <summary>Gets files introduced by the update.</summary>
+            public HashSet<string> CreatedFiles { get; } = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
+
+            /// <summary>Gets directories introduced by the update.</summary>
+            public HashSet<string> CreatedDirectories { get; } = new HashSet<string>(StringComparer.OrdinalIgnoreCase);
         }
     }
 }
diff --git a/src/SoftwareUpdate.Updater/Program.cs b/src/SoftwareUpdate.Updater/Program.cs
index 03314c5f..4c6280d0 100644
--- a/src/SoftwareUpdate.Updater/Program.cs
+++ b/src/SoftwareUpdate.Updater/Program.cs
@@ -14,7 +14,8 @@ namespace SoftwareUpdate.Updater
     /// the update package and restarts the application.
     /// </para>
     /// <para>
-    /// Usage: SoftwareUpdate.Updater.exe --pid [pid] --zip [path] --target [dir] --exe [name] [--backup]
+    /// Usage: SoftwareUpdate.Updater.exe --pid [pid] --zip [path] --target [dir] --exe [name]
+    /// [--backup] [--preserve relative-path]
     /// </para>
     /// </remarks>
     internal class Program
diff --git a/src/SoftwareUpdate.Updater/SoftwareUpdate.Updater.csproj b/src/SoftwareUpdate.Updater/SoftwareUpdate.Updater.csproj
index 9a2e463d..87d6fc91 100644
--- a/src/SoftwareUpdate.Updater/SoftwareUpdate.Updater.csproj
+++ b/src/SoftwareUpdate.Updater/SoftwareUpdate.Updater.csproj
@@ -8,6 +8,9 @@
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
     <LangVersion>latest</LangVersion>
+    <Version>1.0.1</Version>
+    <AssemblyVersion>1.0.1.0</AssemblyVersion>
+    <FileVersion>1.0.1.0</FileVersion>
   </PropertyGroup>
 
   <ItemGroup>
diff --git a/src/SoftwareUpdate.Updater/UpdaterArguments.cs b/src/SoftwareUpdate.Updater/UpdaterArguments.cs
index e3a7e9cc..5d1124cf 100644
--- a/src/SoftwareUpdate.Updater/UpdaterArguments.cs
+++ b/src/SoftwareUpdate.Updater/UpdaterArguments.cs
@@ -1,5 +1,6 @@
 using System;
 using System.Collections.Generic;
+using System.Linq;
 
 namespace SoftwareUpdate.Updater
 {
@@ -37,6 +38,11 @@ internal class UpdaterArguments
         /// </summary>
         public bool CreateBackup { get; set; }
 
+        /// <summary>
+        /// Gets additional installation-relative paths that must be preserved.
+        /// </summary>
+        public IList<string> PreservedRelativePaths { get; } = new List<string>();
+
         /// <summary>
         /// Parses command-line arguments.
         /// </summary>
@@ -62,6 +68,15 @@ public static UpdaterArguments Parse(string[] args)
                         continue;
                     }
 
+                    if (key == "preserve")
+                    {
+                        if (i + 1 < args.Length && !args[i + 1].StartsWith("--"))
+                        {
+                            result.PreservedRelativePaths.Add(UnquoteArgument(args[++i]));
+                        }
+                        continue;
+                    }
+
                     // Get the value
                     if (i + 1 < args.Length && !args[i + 1].StartsWith("--"))
                     {
@@ -138,6 +153,14 @@ public void Validate()
             if (string.IsNullOrEmpty(MainExecutable))
                 errors.Add("--exe is required");
 
+            foreach (var preservedPath in PreservedRelativePaths)
+            {
+                if (!IsValidRelativePath(preservedPath))
+                {
+                    errors.Add($"--preserve must be a safe relative path: {preservedPath}");
+                }
+            }
+
             if (errors.Count > 0)
             {
                 throw new ArgumentException(string.Join(Environment.NewLine, errors));
@@ -162,5 +185,23 @@ private static string UnquoteArgument(string value)
 
             return value;
         }
+
+        /// <summary>
+        /// Determines whether a preserved path is relative and traversal-free.
+        /// </summary>
+        /// <param name="path">The path to validate.</param>
+        /// <returns><see langword="true"/> when the path is safe.</returns>
+        private static bool IsValidRelativePath(string path)
+        {
+            if (string.IsNullOrWhiteSpace(path) || System.IO.Path.IsPathRooted(path) || path.Contains(':'))
+                return false;
+
+            var segments = path.Replace('\\', '/').Split('/', StringSplitOptions.RemoveEmptyEntries);
+            return segments.Length > 0 && !segments.Any(segment =>
+                segment is "." or ".." ||
+                segment.IndexOfAny(System.IO.Path.GetInvalidFileNameChars()) >= 0 ||
+                segment.EndsWith(" ", StringComparison.Ordinal) ||
+                segment.EndsWith(".", StringComparison.Ordinal));
+        }
     }
 }
diff --git a/src/SoftwareUpdate/Core/UpdateOptions.cs b/src/SoftwareUpdate/Core/UpdateOptions.cs
index 60023ce3..014ff12f 100644
--- a/src/SoftwareUpdate/Core/UpdateOptions.cs
+++ b/src/SoftwareUpdate/Core/UpdateOptions.cs
@@ -1,5 +1,7 @@
 using System;
+using System.Collections.Generic;
 using System.IO;
+using System.Linq;
 using System.Reflection;
 using System.Text.RegularExpressions;
 
@@ -77,6 +79,26 @@ public class UpdateOptions
         /// </summary>
         public bool CreateBackup { get; set; } = true;
 
+        /// <summary>
+        /// Gets additional installation-relative paths that the updater must preserve.
+        /// </summary>
+        /// <remarks>
+        /// The updater always preserves its built-in runtime paths, including <c>settings</c>,
+        /// <c>logs</c>, <c>updates_pending</c>, and backup directories. Entries added here are
+        /// validated as relative paths and preserve both the path itself and its descendants.
+        /// </remarks>
+        public IList<string> AdditionalPreservedRelativePaths { get; } = new List<string>();
+
+        /// <summary>
+        /// Gets or sets whether downloads without a valid SHA256 checksum must be rejected.
+        /// </summary>
+        /// <remarks>
+        /// The default is <see langword="false"/> for compatibility. When enabled, GitHub
+        /// release notes must contain a <c>SHA256: &lt;64-character hexadecimal value&gt;</c>
+        /// token for the selected update asset.
+        /// </remarks>
+        public bool RequireSha256Checksum { get; set; }
+
         /// <summary>
         /// Gets or sets the path to store skipped version preferences.
         /// Default is in the application's local app data folder.
@@ -187,6 +209,37 @@ public void Validate()
             if (RequestTimeoutSeconds < 1 || RequestTimeoutSeconds > 300)
                 throw new ArgumentOutOfRangeException(nameof(RequestTimeoutSeconds),
                     "RequestTimeoutSeconds must be between 1 and 300.");
+
+            foreach (var preservedPath in AdditionalPreservedRelativePaths)
+            {
+                ValidatePreservedPath(preservedPath);
+            }
+        }
+
+        /// <summary>
+        /// Validates an installation-relative path that must be preserved during updates.
+        /// </summary>
+        /// <param name="path">The relative path to validate.</param>
+        private static void ValidatePreservedPath(string path)
+        {
+            if (string.IsNullOrWhiteSpace(path) || Path.IsPathRooted(path) || path.Contains(':'))
+            {
+                throw new ArgumentException(
+                    "Additional preserved paths must be non-empty relative paths.",
+                    nameof(AdditionalPreservedRelativePaths));
+            }
+
+            var segments = path.Replace('\\', '/').Split('/', StringSplitOptions.RemoveEmptyEntries);
+            if (segments.Length == 0 || segments.Any(segment =>
+                    segment is "." or ".." ||
+                    segment.IndexOfAny(Path.GetInvalidFileNameChars()) >= 0 ||
+                    segment.EndsWith(" ", StringComparison.Ordinal) ||
+                    segment.EndsWith(".", StringComparison.Ordinal)))
+            {
+                throw new ArgumentException(
+                    "Additional preserved paths cannot contain current-directory or parent-directory segments.",
+                    nameof(AdditionalPreservedRelativePaths));
+            }
         }
     }
 }
diff --git a/src/SoftwareUpdate/GitHub/GitHubUpdateService.cs b/src/SoftwareUpdate/GitHub/GitHubUpdateService.cs
index 2d1dc271..39188283 100644
--- a/src/SoftwareUpdate/GitHub/GitHubUpdateService.cs
+++ b/src/SoftwareUpdate/GitHub/GitHubUpdateService.cs
@@ -45,6 +45,19 @@ public class GitHubUpdateService : IUpdateService, IDisposable
         /// </summary>
         private const long MaxDownloadSizeBytes = 500L * 1024 * 1024;
 
+        /// <summary>
+        /// Age after which disposable updater runner directories may be removed.
+        /// </summary>
+        private static readonly TimeSpan StaleRunnerAge = TimeSpan.FromDays(1);
+
+        private static readonly string[] UpdaterPayloadSuffixes =
+        {
+            ".exe",
+            ".dll",
+            ".deps.json",
+            ".runtimeconfig.json"
+        };
+
         private readonly HttpClient _httpClient;
         private readonly object _lock = new object();
         private UpdateState _state = UpdateState.Idle;
@@ -72,6 +85,7 @@ public GitHubUpdateService(UpdateOptions options)
             }
 
             LoadSkippedVersions();
+            CleanupStaleUpdaterRunners();
         }
 
         /// <inheritdoc/>
@@ -297,6 +311,8 @@ public async Task<UpdateDownloadResult> DownloadUpdateAsync(
 
             try
             {
+                ValidateChecksumMetadata(update, Options.RequireSha256Checksum);
+
                 // Security: Enforce HTTPS on download URL to prevent MITM attacks
                 if (!string.IsNullOrEmpty(update.DownloadUrl))
                 {
@@ -386,17 +402,7 @@ public async Task<UpdateDownloadResult> DownloadUpdateAsync(
                         // Validate SHA256 checksum if provided
                         if (!string.IsNullOrEmpty(update.Sha256Checksum))
                         {
-                            fileStream.Position = 0;
-                            using (var sha256 = SHA256.Create())
-                            {
-                                var hashBytes = sha256.ComputeHash(fileStream);
-                                var actualChecksum = BitConverter.ToString(hashBytes).Replace("-", "").ToLowerInvariant();
-                                if (!string.Equals(actualChecksum, update.Sha256Checksum, StringComparison.OrdinalIgnoreCase))
-                                {
-                                    throw new InvalidOperationException(
-                                        $"Checksum validation failed. Expected: {update.Sha256Checksum}, Actual: {actualChecksum}");
-                                }
-                            }
+                            ValidateDownloadedChecksum(fileStream, update.Sha256Checksum);
                         }
                         else
                         {
@@ -446,6 +452,8 @@ public void InstallUpdateAndRestart(string downloadedFilePath)
             if (!File.Exists(downloadedFilePath))
                 throw new FileNotFoundException("Downloaded update file not found.", downloadedFilePath);
 
+            Options.Validate();
+
             EnsureState(nameof(InstallUpdateAndRestart), UpdateState.ReadyToInstall);
 
             State = UpdateState.Installing;
@@ -461,7 +469,14 @@ public void InstallUpdateAndRestart(string downloadedFilePath)
 
             // Security: Validate the updater path resides inside the install directory
             var fullUpdaterPath = Path.GetFullPath(updaterPath);
-            var fullInstallDir = Path.GetFullPath(Options.ResolvedInstallDirectory);
+            var fullInstallDir = Path.TrimEndingDirectorySeparator(
+                Path.GetFullPath(Options.ResolvedInstallDirectory));
+            if ((File.GetAttributes(fullInstallDir) & FileAttributes.ReparsePoint) != 0 ||
+                (File.GetAttributes(fullUpdaterPath) & FileAttributes.ReparsePoint) != 0)
+            {
+                throw new SecurityException("Updater launch paths cannot be reparse points.");
+            }
+
             if (!fullUpdaterPath.StartsWith(fullInstallDir + Path.DirectorySeparatorChar, StringComparison.OrdinalIgnoreCase) &&
                 !string.Equals(Path.GetDirectoryName(fullUpdaterPath), fullInstallDir, StringComparison.OrdinalIgnoreCase))
             {
@@ -484,6 +499,12 @@ public void InstallUpdateAndRestart(string downloadedFilePath)
             try
             {
                 var stagedDir = Path.Combine(targetDir, "updates_pending");
+                if (Directory.Exists(stagedDir) &&
+                    (File.GetAttributes(stagedDir) & FileAttributes.ReparsePoint) != 0)
+                {
+                    throw new SecurityException("Update staging directory cannot be a reparse point.");
+                }
+
                 Directory.CreateDirectory(stagedDir);
                 var stagedName = $"update_{Guid.NewGuid():N}{Path.GetExtension(downloadedFilePath)}";
                 stagedZipPath = Path.Combine(stagedDir, stagedName);
@@ -498,10 +519,12 @@ public void InstallUpdateAndRestart(string downloadedFilePath)
                 stagedZipPath = downloadedFilePath;
             }
 
+            var runnerUpdaterPath = CreateUpdaterRunner(fullUpdaterPath);
+
             // Use ArgumentList for safe argument passing (no manual quoting/escaping)
             var startInfo = new ProcessStartInfo
             {
-                FileName = updaterPath,
+                FileName = runnerUpdaterPath,
                 UseShellExecute = false,
                 CreateNoWindow = true
             };
@@ -516,9 +539,26 @@ public void InstallUpdateAndRestart(string downloadedFilePath)
             if (Options.CreateBackup)
                 startInfo.ArgumentList.Add("--backup");
 
-            var process = Process.Start(startInfo);
+            foreach (var preservedPath in Options.AdditionalPreservedRelativePaths)
+            {
+                startInfo.ArgumentList.Add("--preserve");
+                startInfo.ArgumentList.Add(preservedPath);
+            }
+
+            Process? process;
+            try
+            {
+                process = Process.Start(startInfo);
+            }
+            catch
+            {
+                DeleteUpdaterRunner(Path.GetDirectoryName(runnerUpdaterPath));
+                throw;
+            }
+
             if (process == null)
             {
+                DeleteUpdaterRunner(Path.GetDirectoryName(runnerUpdaterPath));
                 throw new InvalidOperationException("Failed to start the updater process.");
             }
 
@@ -527,6 +567,173 @@ public void InstallUpdateAndRestart(string downloadedFilePath)
             Environment.Exit(0);
         }
 
+        /// <summary>
+        /// Copies the complete updater payload to a disposable directory outside the installation.
+        /// </summary>
+        /// <param name="updaterPath">The installed updater executable path.</param>
+        /// <returns>The disposable updater executable path.</returns>
+        internal static string CreateUpdaterRunner(string updaterPath)
+        {
+            var fullUpdaterPath = Path.GetFullPath(updaterPath);
+            var sourceDirectory = Path.GetDirectoryName(fullUpdaterPath)
+                ?? throw new InvalidOperationException("The updater executable has no parent directory.");
+            if ((File.GetAttributes(sourceDirectory) & FileAttributes.ReparsePoint) != 0)
+                throw new SecurityException("Updater payload directory cannot be a reparse point.");
+
+            var payloadBaseName = Path.GetFileNameWithoutExtension(fullUpdaterPath);
+            var payloadFiles = UpdaterPayloadSuffixes
+                .Select(suffix => Path.Combine(sourceDirectory, payloadBaseName + suffix))
+                .ToArray();
+
+            foreach (var payloadFile in payloadFiles)
+            {
+                if (!File.Exists(payloadFile))
+                {
+                    throw new FileNotFoundException(
+                        $"Updater payload file not found at '{payloadFile}'. Ensure the complete updater payload is deployed.",
+                        payloadFile);
+                }
+
+                if ((File.GetAttributes(payloadFile) & FileAttributes.ReparsePoint) != 0)
+                    throw new SecurityException($"Updater payload file cannot be a reparse point: '{payloadFile}'.");
+            }
+
+            var runnerRoot = Path.Combine(Path.GetTempPath(), "SoftwareUpdate");
+            Directory.CreateDirectory(runnerRoot);
+            if ((File.GetAttributes(runnerRoot) & FileAttributes.ReparsePoint) != 0)
+                throw new SecurityException("Updater runner root cannot be a reparse point.");
+
+            var runnerDirectory = Path.Combine(runnerRoot, $"runner-{Guid.NewGuid():N}");
+
+            try
+            {
+                Directory.CreateDirectory(runnerDirectory);
+                foreach (var payloadFile in payloadFiles)
+                {
+                    File.Copy(
+                        payloadFile,
+                        Path.Combine(runnerDirectory, Path.GetFileName(payloadFile)),
+                        overwrite: false);
+                }
+
+                return Path.Combine(runnerDirectory, Path.GetFileName(fullUpdaterPath));
+            }
+            catch
+            {
+                DeleteUpdaterRunner(runnerDirectory);
+                throw;
+            }
+        }
+
+        /// <summary>
+        /// Removes disposable updater runners left by completed updates.
+        /// </summary>
+        internal static void CleanupStaleUpdaterRunners()
+        {
+            var runnerRoot = Path.Combine(Path.GetTempPath(), "SoftwareUpdate");
+            if (!Directory.Exists(runnerRoot))
+                return;
+
+            try
+            {
+                if ((File.GetAttributes(runnerRoot) & FileAttributes.ReparsePoint) != 0)
+                    return;
+
+                foreach (var directory in Directory.GetDirectories(runnerRoot, "runner-*"))
+                {
+                    var name = Path.GetFileName(directory);
+                    if (!Guid.TryParseExact(name.Substring("runner-".Length), "N", out _))
+                        continue;
+
+                    if (Directory.GetLastWriteTimeUtc(directory) <= DateTime.UtcNow - StaleRunnerAge)
+                    {
+                        DeleteUpdaterRunner(directory);
+                    }
+                }
+            }
+            catch (Exception ex) when (ex is IOException or UnauthorizedAccessException or SecurityException)
+            {
+                Debug.WriteLine($"[GitHubUpdateService] Failed to clean stale updater runners: {ex.Message}");
+            }
+        }
+
+        /// <summary>
+        /// Validates checksum metadata before a download begins.
+        /// </summary>
+        /// <param name="update">The update metadata.</param>
+        /// <param name="checksumRequired">Whether a checksum is required.</param>
+        internal static void ValidateChecksumMetadata(UpdateInfo update, bool checksumRequired)
+        {
+            if (string.IsNullOrWhiteSpace(update.Sha256Checksum))
+            {
+                if (checksumRequired)
+                {
+                    throw new InvalidDataException(
+                        "The selected update does not provide the required SHA256 checksum in its release notes.");
+                }
+
+                return;
+            }
+
+            if (!Regex.IsMatch(update.Sha256Checksum, "^[0-9a-fA-F]{64}$"))
+                throw new InvalidDataException("The selected update provides an invalid SHA256 checksum.");
+        }
+
+        /// <summary>
+        /// Validates downloaded content against an expected SHA256 checksum.
+        /// </summary>
+        /// <param name="stream">The seekable downloaded-content stream.</param>
+        /// <param name="expectedChecksum">The expected hexadecimal checksum.</param>
+        internal static void ValidateDownloadedChecksum(Stream stream, string expectedChecksum)
+        {
+            stream.Position = 0;
+            using var sha256 = SHA256.Create();
+            var hashBytes = sha256.ComputeHash(stream);
+            var actualChecksum = Convert.ToHexString(hashBytes).ToLowerInvariant();
+            if (!string.Equals(actualChecksum, expectedChecksum, StringComparison.OrdinalIgnoreCase))
+            {
+                throw new InvalidOperationException(
+                    $"Checksum validation failed. Expected: {expectedChecksum}, Actual: {actualChecksum}");
+            }
+        }
+
+        /// <summary>
+        /// Best-effort deletion restricted to a disposable updater runner directory.
+        /// </summary>
+        /// <param name="directory">The runner directory.</param>
+        internal static void DeleteUpdaterRunner(string? directory)
+        {
+            if (string.IsNullOrEmpty(directory) || !Directory.Exists(directory))
+                return;
+
+            try
+            {
+                var fullDirectory = Path.GetFullPath(directory);
+                var runnerRoot = Path.GetFullPath(Path.Combine(Path.GetTempPath(), "SoftwareUpdate"));
+                if (!string.Equals(
+                        Path.GetDirectoryName(fullDirectory),
+                        runnerRoot,
+                        StringComparison.OrdinalIgnoreCase))
+                {
+                    return;
+                }
+
+                var name = Path.GetFileName(directory);
+                if (!name.StartsWith("runner-", StringComparison.OrdinalIgnoreCase) ||
+                    !Guid.TryParseExact(name.Substring("runner-".Length), "N", out _))
+                {
+                    return;
+                }
+
+                var attributes = File.GetAttributes(directory);
+                Directory.Delete(directory, recursive: (attributes & FileAttributes.ReparsePoint) == 0);
+            }
+            catch (Exception ex) when (ex is IOException or UnauthorizedAccessException or SecurityException)
+            {
+                Debug.WriteLine($"[GitHubUpdateService] Failed to delete updater runner '{directory}': {ex.Message}");
+            }
+        }
+
         /// <inheritdoc/>
         public void SkipVersion(SemanticVersion? version)
         {
diff --git a/src/SoftwareUpdate/SoftwareUpdate.csproj b/src/SoftwareUpdate/SoftwareUpdate.csproj
index 4ab322a7..07eb06ed 100644
--- a/src/SoftwareUpdate/SoftwareUpdate.csproj
+++ b/src/SoftwareUpdate/SoftwareUpdate.csproj
@@ -17,4 +17,8 @@
     <PackageTags>auto-update; github-releases; semver; software-update; installer; usace-rmc</PackageTags>
   </PropertyGroup>
 
+  <ItemGroup>
+    <InternalsVisibleTo Include="SoftwareUpdate.Tests" />
+  </ItemGroup>
+
 </Project>
diff --git a/src/SoftwareUpdate/Utilities/UpdaterBootstrapper.cs b/src/SoftwareUpdate/Utilities/UpdaterBootstrapper.cs
index 2dd5fab4..d14223c4 100644
--- a/src/SoftwareUpdate/Utilities/UpdaterBootstrapper.cs
+++ b/src/SoftwareUpdate/Utilities/UpdaterBootstrapper.cs
@@ -1,6 +1,8 @@
 using System;
+using System.Collections.Generic;
 using System.Diagnostics;
 using System.IO;
+using SoftwareUpdate.GitHub;
 
 namespace SoftwareUpdate.Utilities
 {
@@ -22,9 +24,9 @@ public static class UpdaterBootstrapper
         /// </summary>
         /// <remarks>
         /// <para>
-        /// This method spawns the SoftwareUpdate.Updater.exe process which handles the actual file replacement.
-        /// The updater will wait for the current process to exit before extracting files, then optionally
-        /// restart the main application.
+        /// This method copies the complete updater payload to a disposable directory and launches that copy
+        /// to handle file replacement. The updater waits for the current process to exit before applying
+        /// staged files, then optionally restarts the main application.
         /// </para>
         /// <para>
         /// If <paramref name="exitApplication"/> is true (the default), this method will call
@@ -71,6 +73,39 @@ public static void LaunchUpdater(
             string mainExecutable,
             bool createBackup = true,
             bool exitApplication = true)
+        {
+            LaunchUpdater(
+                updaterPath,
+                zipPath,
+                targetDirectory,
+                mainExecutable,
+                createBackup,
+                exitApplication,
+                additionalPreservedRelativePaths: null);
+        }
+
+        /// <summary>
+        /// Launches the updater while preserving additional installation-relative paths.
+        /// </summary>
+        /// <param name="updaterPath">The full path to the updater executable.</param>
+        /// <param name="zipPath">The full path to the downloaded update archive.</param>
+        /// <param name="targetDirectory">The installation directory to update.</param>
+        /// <param name="mainExecutable">The main executable filename to restart.</param>
+        /// <param name="createBackup">Whether to create a targeted backup.</param>
+        /// <param name="exitApplication">Whether to exit the current application after launch.</param>
+        /// <param name="additionalPreservedRelativePaths">
+        /// Optional installation-relative paths that the updater must preserve.
+        /// </param>
+        /// <exception cref="ArgumentNullException">Thrown when a required path or name is empty.</exception>
+        /// <exception cref="FileNotFoundException">Thrown when the updater or update archive is missing.</exception>
+        public static void LaunchUpdater(
+            string updaterPath,
+            string zipPath,
+            string targetDirectory,
+            string mainExecutable,
+            bool createBackup,
+            bool exitApplication,
+            IEnumerable<string>? additionalPreservedRelativePaths)
         {
             if (string.IsNullOrEmpty(updaterPath))
                 throw new ArgumentNullException(nameof(updaterPath));
@@ -86,12 +121,23 @@ public static void LaunchUpdater(
             if (!File.Exists(zipPath))
                 throw new FileNotFoundException("Update zip file not found.", zipPath);
 
+            var preservedPaths = new List<string>();
+            if (additionalPreservedRelativePaths != null)
+            {
+                foreach (var preservedPath in additionalPreservedRelativePaths)
+                {
+                    ValidatePreservedPath(preservedPath);
+                    preservedPaths.Add(preservedPath);
+                }
+            }
+
             var currentPid = Process.GetCurrentProcess().Id;
+            var runnerUpdaterPath = GitHubUpdateService.CreateUpdaterRunner(updaterPath);
 
             // Use ArgumentList for safe argument passing (no manual quoting/escaping)
             var startInfo = new ProcessStartInfo
             {
-                FileName = updaterPath,
+                FileName = runnerUpdaterPath,
                 UseShellExecute = false,
                 CreateNoWindow = true
             };
@@ -106,9 +152,26 @@ public static void LaunchUpdater(
             if (createBackup)
                 startInfo.ArgumentList.Add("--backup");
 
-            var process = Process.Start(startInfo);
+            foreach (var preservedPath in preservedPaths)
+            {
+                startInfo.ArgumentList.Add("--preserve");
+                startInfo.ArgumentList.Add(preservedPath);
+            }
+
+            Process? process;
+            try
+            {
+                process = Process.Start(startInfo);
+            }
+            catch
+            {
+                GitHubUpdateService.DeleteUpdaterRunner(Path.GetDirectoryName(runnerUpdaterPath));
+                throw;
+            }
+
             if (process == null)
             {
+                GitHubUpdateService.DeleteUpdaterRunner(Path.GetDirectoryName(runnerUpdaterPath));
                 throw new InvalidOperationException("Failed to start the updater process.");
             }
 
@@ -117,5 +180,27 @@ public static void LaunchUpdater(
                 Environment.Exit(0);
             }
         }
+
+        /// <summary>
+        /// Validates an installation-relative path passed to the updater.
+        /// </summary>
+        /// <param name="path">The path to validate.</param>
+        private static void ValidatePreservedPath(string path)
+        {
+            if (string.IsNullOrWhiteSpace(path) || Path.IsPathRooted(path) || path.Contains(':'))
+                throw new ArgumentException("Preserved paths must be non-empty relative paths.", nameof(path));
+
+            var segments = path.Replace('\\', '/').Split('/', StringSplitOptions.RemoveEmptyEntries);
+            if (segments.Length == 0 || Array.Exists(segments, segment =>
+                    segment is "." or ".." ||
+                    segment.IndexOfAny(Path.GetInvalidFileNameChars()) >= 0 ||
+                    segment.EndsWith(" ", StringComparison.Ordinal) ||
+                    segment.EndsWith(".", StringComparison.Ordinal)))
+            {
+                throw new ArgumentException(
+                    "Preserved paths cannot contain current-directory or parent-directory segments.",
+                    nameof(path));
+            }
+        }
     }
 }
diff --git a/tests/SoftwareUpdate.Tests/Core/UpdateOptionsTests.cs b/tests/SoftwareUpdate.Tests/Core/UpdateOptionsTests.cs
index 874aa739..9ea1aa45 100644
--- a/tests/SoftwareUpdate.Tests/Core/UpdateOptionsTests.cs
+++ b/tests/SoftwareUpdate.Tests/Core/UpdateOptionsTests.cs
@@ -77,6 +77,28 @@ public void DefaultInstance_CreateBackup_IsTrue()
             Assert.True(options.CreateBackup);
         }
 
+        /// <summary>
+        /// Verifies that checksum enforcement is opt-in for compatibility.
+        /// </summary>
+        [Fact]
+        public void DefaultInstance_RequireSha256Checksum_IsFalse()
+        {
+            var options = new UpdateOptions();
+
+            Assert.False(options.RequireSha256Checksum);
+        }
+
+        /// <summary>
+        /// Verifies that additional preserved paths are empty by default.
+        /// </summary>
+        [Fact]
+        public void DefaultInstance_AdditionalPreservedRelativePaths_IsEmpty()
+        {
+            var options = new UpdateOptions();
+
+            Assert.Empty(options.AdditionalPreservedRelativePaths);
+        }
+
         /// <summary>
         /// Verifies that a default instance of <see cref="UpdateOptions"/> has RequestTimeoutSeconds set to 30.
         /// </summary>
@@ -181,6 +203,29 @@ public void CreateBackup_SetAndGet()
             Assert.False(options.CreateBackup);
         }
 
+        /// <summary>
+        /// Verifies that checksum enforcement can be enabled.
+        /// </summary>
+        [Fact]
+        public void RequireSha256Checksum_SetAndGet()
+        {
+            var options = new UpdateOptions { RequireSha256Checksum = true };
+
+            Assert.True(options.RequireSha256Checksum);
+        }
+
+        /// <summary>
+        /// Verifies that additional preserved paths can be configured.
+        /// </summary>
+        [Fact]
+        public void AdditionalPreservedRelativePaths_AddAndGet()
+        {
+            var options = new UpdateOptions();
+            options.AdditionalPreservedRelativePaths.Add("data/user");
+
+            Assert.Equal("data/user", Assert.Single(options.AdditionalPreservedRelativePaths));
+        }
+
         /// <summary>
         /// Verifies that the RequestTimeoutSeconds property can be set and retrieved correctly.
         /// </summary>
@@ -322,6 +367,28 @@ public void Validate_ValidOptions_DoesNotThrow()
             Assert.Null(exception);
         }
 
+        /// <summary>
+        /// Verifies that unsafe additional preserved paths are rejected.
+        /// </summary>
+        /// <param name="preservedPath">The invalid path.</param>
+        [Theory]
+        [InlineData(@"C:\settings")]
+        [InlineData("../settings")]
+        [InlineData("data/./settings")]
+        [InlineData("file:stream")]
+        public void Validate_InvalidAdditionalPreservedPath_ThrowsArgumentException(string preservedPath)
+        {
+            var options = new UpdateOptions
+            {
+                GitHubOwner = "USACE-RMC",
+                GitHubRepo = "RMC-BestFit",
+                CurrentVersion = new SemanticVersion(1, 0, 0)
+            };
+            options.AdditionalPreservedRelativePaths.Add(preservedPath);
+
+            Assert.Throws<ArgumentException>(() => options.Validate());
+        }
+
         /// <summary>
         /// Verifies that the Validate method accepts various valid GitHub owner name formats.
         /// </summary>
diff --git a/tests/SoftwareUpdate.Tests/GitHub/UpdaterHardeningTests.cs b/tests/SoftwareUpdate.Tests/GitHub/UpdaterHardeningTests.cs
new file mode 100644
index 00000000..9268d9e5
--- /dev/null
+++ b/tests/SoftwareUpdate.Tests/GitHub/UpdaterHardeningTests.cs
@@ -0,0 +1,177 @@
+using System;
+using System.IO;
+using System.Security.Cryptography;
+using System.Text;
+using SoftwareUpdate.GitHub;
+using SoftwareUpdate.Utilities;
+using Xunit;
+
+namespace SoftwareUpdate.Tests.GitHub
+{
+    /// <summary>
+    /// Tests updater runner preparation and checksum hardening helpers.
+    /// </summary>
+    public class UpdaterHardeningTests
+    {
+        /// <summary>
+        /// Verifies that a disposable runner contains the complete updater payload.
+        /// </summary>
+        [Fact]
+        public void CreateUpdaterRunner_CopiesCompletePayloadOutsideInstallation()
+        {
+            var sourceDirectory = Path.Combine(Path.GetTempPath(), "UpdaterRunnerTests", Guid.NewGuid().ToString("N"));
+            Directory.CreateDirectory(sourceDirectory);
+            var payloadNames = new[]
+            {
+                "SoftwareUpdate.Updater.exe",
+                "SoftwareUpdate.Updater.dll",
+                "SoftwareUpdate.Updater.deps.json",
+                "SoftwareUpdate.Updater.runtimeconfig.json"
+            };
+
+            foreach (var payloadName in payloadNames)
+            {
+                File.WriteAllText(Path.Combine(sourceDirectory, payloadName), payloadName);
+            }
+
+            string? runnerPath = null;
+            try
+            {
+                runnerPath = GitHubUpdateService.CreateUpdaterRunner(
+                    Path.Combine(sourceDirectory, "SoftwareUpdate.Updater.exe"));
+                var runnerDirectory = Path.GetDirectoryName(runnerPath)!;
+
+                Assert.NotEqual(sourceDirectory, runnerDirectory);
+                Assert.StartsWith("runner-", Path.GetFileName(runnerDirectory), StringComparison.OrdinalIgnoreCase);
+                foreach (var payloadName in payloadNames)
+                {
+                    Assert.Equal(
+                        payloadName,
+                        File.ReadAllText(Path.Combine(runnerDirectory, payloadName)));
+                }
+            }
+            finally
+            {
+                if (runnerPath != null)
+                {
+                    Directory.Delete(Path.GetDirectoryName(runnerPath)!, recursive: true);
+                }
+
+                Directory.Delete(sourceDirectory, recursive: true);
+            }
+        }
+
+        /// <summary>
+        /// Verifies that stale disposable runner directories are removed.
+        /// </summary>
+        [Fact]
+        public void CleanupStaleUpdaterRunners_RemovesOwnedStaleDirectory()
+        {
+            var runnerDirectory = Path.Combine(
+                Path.GetTempPath(),
+                "SoftwareUpdate",
+                $"runner-{Guid.NewGuid():N}");
+            Directory.CreateDirectory(runnerDirectory);
+            File.WriteAllText(Path.Combine(runnerDirectory, "payload.txt"), "stale");
+            Directory.SetLastWriteTimeUtc(runnerDirectory, DateTime.UtcNow.AddDays(-2));
+
+            GitHubUpdateService.CleanupStaleUpdaterRunners();
+
+            Assert.False(Directory.Exists(runnerDirectory));
+        }
+
+        /// <summary>
+        /// Verifies required, optional, and malformed checksum metadata behavior.
+        /// </summary>
+        [Fact]
+        public void ValidateChecksumMetadata_EnforcesConfiguredPolicy()
+        {
+            var update = new UpdateInfo();
+
+            GitHubUpdateService.ValidateChecksumMetadata(update, checksumRequired: false);
+            Assert.Throws<InvalidDataException>(() =>
+                GitHubUpdateService.ValidateChecksumMetadata(update, checksumRequired: true));
+
+            update.Sha256Checksum = "not-a-checksum";
+            Assert.Throws<InvalidDataException>(() =>
+                GitHubUpdateService.ValidateChecksumMetadata(update, checksumRequired: false));
+
+            update.Sha256Checksum = new string('a', 64);
+            GitHubUpdateService.ValidateChecksumMetadata(update, checksumRequired: true);
+        }
+
+        /// <summary>
+        /// Verifies successful and mismatched SHA256 content validation.
+        /// </summary>
+        [Fact]
+        public void ValidateDownloadedChecksum_AcceptsMatchAndRejectsMismatch()
+        {
+            var content = Encoding.UTF8.GetBytes("verified update");
+            var checksum = Convert.ToHexString(SHA256.HashData(content)).ToLowerInvariant();
+
+            using var matchingStream = new MemoryStream(content);
+            GitHubUpdateService.ValidateDownloadedChecksum(matchingStream, checksum);
+
+            using var mismatchedStream = new MemoryStream(content);
+            Assert.Throws<InvalidOperationException>(() =>
+                GitHubUpdateService.ValidateDownloadedChecksum(mismatchedStream, new string('0', 64)));
+        }
+
+        /// <summary>
+        /// Verifies that the advanced bootstrapper rejects unsafe preserved paths before launch.
+        /// </summary>
+        [Fact]
+        public void UpdaterBootstrapper_UnsafePreservedPath_IsRejectedBeforeLaunch()
+        {
+            var root = Path.Combine(Path.GetTempPath(), "UpdaterBootstrapperTests", Guid.NewGuid().ToString("N"));
+            var updaterDirectory = Path.Combine(root, "updater");
+            var targetDirectory = Path.Combine(root, "target");
+            Directory.CreateDirectory(updaterDirectory);
+            Directory.CreateDirectory(targetDirectory);
+            var updaterPath = Path.Combine(updaterDirectory, "SoftwareUpdate.Updater.exe");
+            var zipPath = Path.Combine(root, "update.zip");
+            File.WriteAllText(updaterPath, "exe");
+            File.WriteAllText(Path.Combine(updaterDirectory, "SoftwareUpdate.Updater.dll"), "dll");
+            File.WriteAllText(Path.Combine(updaterDirectory, "SoftwareUpdate.Updater.deps.json"), "deps");
+            File.WriteAllText(Path.Combine(updaterDirectory, "SoftwareUpdate.Updater.runtimeconfig.json"), "runtime");
+            File.WriteAllText(zipPath, "zip");
+
+            try
+            {
+                Assert.Throws<ArgumentException>(() => UpdaterBootstrapper.LaunchUpdater(
+                    updaterPath,
+                    zipPath,
+                    targetDirectory,
+                    "app.exe",
+                    createBackup: true,
+                    exitApplication: false,
+                    additionalPreservedRelativePaths: new[] { "../settings" }));
+            }
+            finally
+            {
+                Directory.Delete(root, recursive: true);
+            }
+        }
+
+        /// <summary>
+        /// Verifies that the original bootstrapper method remains available for binary compatibility.
+        /// </summary>
+        [Fact]
+        public void UpdaterBootstrapper_OriginalLaunchSignature_RemainsAvailable()
+        {
+            var method = typeof(UpdaterBootstrapper).GetMethod(
+                nameof(UpdaterBootstrapper.LaunchUpdater),
+                new[]
+                {
+                    typeof(string),
+                    typeof(string),
+                    typeof(string),
+                    typeof(string),
+                    typeof(bool),
+                    typeof(bool)
+                });
+
+            Assert.NotNull(method);
+        }
+    }
+}
diff --git a/tests/SoftwareUpdate.Updater.Tests/InstallationManagerTests.cs b/tests/SoftwareUpdate.Updater.Tests/InstallationManagerTests.cs
index 4e35bd5f..30009971 100644
--- a/tests/SoftwareUpdate.Updater.Tests/InstallationManagerTests.cs
+++ b/tests/SoftwareUpdate.Updater.Tests/InstallationManagerTests.cs
@@ -211,7 +211,11 @@ public void ParseBackupTimestamp_NullPath_ReturnsNull()
         public void CreateBackup_CreatesBackupDirectory()
         {
             var targetDir = CreateSubDir("target");
-            var zipPath = CreateTestZip("update.zip", new[] { ("file.txt", "content") });
+            var zipPath = CreateTestZip("update.zip", new[]
+            {
+                ("existing.txt", "updated"),
+                ("subdir/nested.txt", "updated nested")
+            });
 
             // Create some files in target directory
             File.WriteAllText(Path.Combine(targetDir, "existing.txt"), "original");
@@ -236,10 +240,12 @@ public void CreateBackup_CreatesBackupDirectory()
             var backupDirs = Directory.GetDirectories(targetDir, ".backup_*");
             Assert.NotEmpty(backupDirs);
 
-            // Check backup contains original files
+            // Check backup contains only files targeted for replacement
             var backupDir = backupDirs[0];
             Assert.True(File.Exists(Path.Combine(backupDir, "existing.txt")));
             Assert.True(File.Exists(Path.Combine(backupDir, "subdir", "nested.txt")));
+            Assert.Equal("original", File.ReadAllText(Path.Combine(backupDir, "existing.txt")));
+            Assert.Equal("nested", File.ReadAllText(Path.Combine(backupDir, "subdir", "nested.txt")));
         }
 
         /// <summary>
@@ -249,7 +255,7 @@ public void CreateBackup_CreatesBackupDirectory()
         public void CreateBackup_SkipsExistingBackupDirectories()
         {
             var targetDir = CreateSubDir("target");
-            var zipPath = CreateTestZip("update.zip", new[] { ("file.txt", "content") });
+            var zipPath = CreateTestZip("update.zip", new[] { ("current.txt", "updated") });
 
             // Create an existing backup directory
             var existingBackup = Path.Combine(targetDir, ".backup_20240101_000000");
@@ -284,6 +290,32 @@ public void CreateBackup_SkipsExistingBackupDirectories()
             Assert.True(File.Exists(Path.Combine(newBackup, "current.txt")));
         }
 
+        /// <summary>
+        /// Verifies that protected settings are neither overwritten nor copied into a targeted backup.
+        /// </summary>
+        [Fact]
+        public void CreateBackup_ExcludesProtectedSettings()
+        {
+            var targetDir = CreateSubDir("target");
+            var settingsDir = Directory.CreateDirectory(Path.Combine(targetDir, "settings")).FullName;
+            File.WriteAllText(Path.Combine(settingsDir, "UserSettings.xml"), "original-settings");
+            File.WriteAllText(Path.Combine(targetDir, "app.dll"), "original-app");
+            var zipPath = CreateTestZip("settings-backup.zip", new[]
+            {
+                ("settings/UserSettings.xml", "malicious-settings"),
+                ("app.dll", "updated-app")
+            });
+            var arguments = CreateArguments(zipPath, targetDir);
+            arguments.CreateBackup = true;
+
+            new InstallationManager(arguments, Log).Execute();
+
+            var backupDir = Assert.Single(Directory.GetDirectories(targetDir, ".backup_*"));
+            Assert.Equal("original-settings", File.ReadAllText(Path.Combine(settingsDir, "UserSettings.xml")));
+            Assert.False(Directory.Exists(Path.Combine(backupDir, "settings")));
+            Assert.Equal("original-app", File.ReadAllText(Path.Combine(backupDir, "app.dll")));
+        }
+
         #endregion
 
         #region ExtractUpdate Path Traversal Tests
@@ -384,6 +416,24 @@ public void ExtractUpdate_SingleRootFolder_StripsRoot()
             Assert.False(Directory.Exists(Path.Combine(targetDir, "MyApp-v1.0.0")));
         }
 
+        /// <summary>
+        /// Verifies that a known installation root is not mistaken for a release wrapper.
+        /// </summary>
+        [Fact]
+        public void ExtractUpdate_SingleKnownInstallRoot_DoesNotFlattenFiles()
+        {
+            var targetDir = CreateSubDir("target");
+            var zipPath = CreateTestZip("libraries-only.zip", new[]
+            {
+                ("libraries/dependency.dll", "dependency")
+            });
+
+            new InstallationManager(CreateArguments(zipPath, targetDir), Log).Execute();
+
+            Assert.True(File.Exists(Path.Combine(targetDir, "libraries", "dependency.dll")));
+            Assert.False(File.Exists(Path.Combine(targetDir, "dependency.dll")));
+        }
+
         /// <summary>
         /// Verifies that ExtractUpdate skips backup directories found within update archives.
         /// </summary>
@@ -422,6 +472,288 @@ public void ExtractUpdate_SkipsBackupDirectories()
 
         #endregion
 
+        #region Hardened Update Transaction Tests
+
+        /// <summary>
+        /// Verifies that built-in runtime paths remain unchanged for direct and wrapped archives.
+        /// </summary>
+        /// <param name="wrapped">Whether entries are nested beneath a release wrapper.</param>
+        [Theory]
+        [InlineData(false)]
+        [InlineData(true)]
+        public void Execute_BuiltInProtectedPaths_AreNeverOverwritten(bool wrapped)
+        {
+            var targetDir = CreateSubDir("target");
+            var settingsDir = Directory.CreateDirectory(Path.Combine(targetDir, "settings")).FullName;
+            var logsDir = Directory.CreateDirectory(Path.Combine(targetDir, "logs")).FullName;
+            var pendingDir = Directory.CreateDirectory(Path.Combine(targetDir, "updates_pending")).FullName;
+            var backupDir = Directory.CreateDirectory(Path.Combine(targetDir, ".backup_user")).FullName;
+            File.WriteAllText(Path.Combine(settingsDir, "UserSettings.xml"), "settings-original");
+            File.WriteAllText(Path.Combine(logsDir, "history.log"), "log-original");
+            File.WriteAllText(Path.Combine(pendingDir, "keep.dat"), "pending-original");
+            File.WriteAllText(Path.Combine(backupDir, "backup.txt"), "backup-original");
+            File.WriteAllText(Path.Combine(targetDir, "app.dll"), "app-original");
+
+            var prefix = wrapped ? "release\\" : string.Empty;
+            var zipPath = CreateTestZip("protected.zip", new[]
+            {
+                ($"{prefix}SeTtInGs/UserSettings.xml", "settings-malicious"),
+                ($"{prefix}LOGS\\history.log", "log-malicious"),
+                ($"{prefix}updates_pending/keep.dat", "pending-malicious"),
+                ($"{prefix}.backup_user/backup.txt", "backup-malicious"),
+                ($"{prefix}nested/.backup_hidden/file.txt", "hidden-malicious"),
+                ($"{prefix}app.dll", "app-updated")
+            });
+
+            var manager = new InstallationManager(CreateArguments(zipPath, targetDir), Log);
+            manager.Execute();
+
+            Assert.Equal("settings-original", File.ReadAllText(Path.Combine(settingsDir, "UserSettings.xml")));
+            Assert.Equal("log-original", File.ReadAllText(Path.Combine(logsDir, "history.log")));
+            Assert.Equal("pending-original", File.ReadAllText(Path.Combine(pendingDir, "keep.dat")));
+            Assert.Equal("backup-original", File.ReadAllText(Path.Combine(backupDir, "backup.txt")));
+            Assert.False(Directory.Exists(Path.Combine(targetDir, "nested")));
+            Assert.Equal("app-updated", File.ReadAllText(Path.Combine(targetDir, "app.dll")));
+        }
+
+        /// <summary>
+        /// Verifies that caller-supplied preserved paths and descendants remain unchanged.
+        /// </summary>
+        [Fact]
+        public void Execute_AdditionalPreservedPath_IsNeverOverwritten()
+        {
+            var targetDir = CreateSubDir("target");
+            var dataDir = Directory.CreateDirectory(Path.Combine(targetDir, "data", "user")).FullName;
+            File.WriteAllText(Path.Combine(dataDir, "config.json"), "original");
+            var zipPath = CreateTestZip("preserve.zip", new[]
+            {
+                ("data/user/config.json", "malicious"),
+                ("app.dll", "updated")
+            });
+            var arguments = CreateArguments(zipPath, targetDir);
+            arguments.PreservedRelativePaths.Add("data/user");
+
+            new InstallationManager(arguments, Log).Execute();
+
+            Assert.Equal("original", File.ReadAllText(Path.Combine(dataDir, "config.json")));
+            Assert.Equal("updated", File.ReadAllText(Path.Combine(targetDir, "app.dll")));
+        }
+
+        /// <summary>
+        /// Verifies that unsafe absolute, traversal, and alternate-stream paths are rejected.
+        /// </summary>
+        /// <param name="entryPath">The unsafe entry path.</param>
+        [Theory]
+        [InlineData("../escaped.txt")]
+        [InlineData("/absolute.txt")]
+        [InlineData("file.txt:stream")]
+        public void Execute_UnsafeArchivePath_IsRejectedBeforeWrites(string entryPath)
+        {
+            var targetDir = CreateSubDir("target");
+            File.WriteAllText(Path.Combine(targetDir, "app.dll"), "original");
+            var zipPath = CreateTestZip("unsafe.zip", new[]
+            {
+                ("app.dll", "updated"),
+                (entryPath, "malicious")
+            });
+
+            Assert.Throws<SecurityException>(() =>
+                new InstallationManager(CreateArguments(zipPath, targetDir), Log).Execute());
+            Assert.Equal("original", File.ReadAllText(Path.Combine(targetDir, "app.dll")));
+        }
+
+        /// <summary>
+        /// Verifies that duplicate case-insensitive destinations are rejected before writes.
+        /// </summary>
+        [Fact]
+        public void Execute_DuplicateDestinations_AreRejectedBeforeWrites()
+        {
+            var targetDir = CreateSubDir("target");
+            var zipPath = CreateTestZip("duplicate.zip", new[]
+            {
+                ("App.dll", "one"),
+                ("app.dll", "two")
+            });
+
+            Assert.Throws<InvalidDataException>(() =>
+                new InstallationManager(CreateArguments(zipPath, targetDir), Log).Execute());
+            Assert.False(File.Exists(Path.Combine(targetDir, "app.dll")));
+        }
+
+        /// <summary>
+        /// Verifies that archive file-directory collisions are rejected before writes.
+        /// </summary>
+        [Fact]
+        public void Execute_FileDirectoryCollision_IsRejectedBeforeWrites()
+        {
+            var targetDir = CreateSubDir("target");
+            var zipPath = CreateTestZip("collision.zip", new[]
+            {
+                ("item", "file"),
+                ("item/child.txt", "child")
+            });
+
+            Assert.Throws<InvalidDataException>(() =>
+                new InstallationManager(CreateArguments(zipPath, targetDir), Log).Execute());
+            Assert.False(File.Exists(Path.Combine(targetDir, "item")));
+        }
+
+        /// <summary>
+        /// Verifies that an archive file cannot replace an existing installation directory.
+        /// </summary>
+        [Fact]
+        public void Execute_ExistingDirectoryFileCollision_IsRejectedBeforeWrites()
+        {
+            var targetDir = CreateSubDir("target");
+            Directory.CreateDirectory(Path.Combine(targetDir, "app.dll"));
+            var zipPath = CreateTestZip("existing-collision.zip", new[] { ("app.dll", "file") });
+
+            Assert.Throws<InvalidDataException>(() =>
+                new InstallationManager(CreateArguments(zipPath, targetDir), Log).Execute());
+            Assert.True(Directory.Exists(Path.Combine(targetDir, "app.dll")));
+        }
+
+        /// <summary>
+        /// Verifies that file-count and uncompressed-size limits are enforced during preflight.
+        /// </summary>
+        [Fact]
+        public void Execute_ArchiveSafetyLimits_AreEnforcedBeforeWrites()
+        {
+            var targetDir = CreateSubDir("target");
+            var countZipPath = CreateTestZip("count.zip", new[]
+            {
+                ("one.txt", "1"),
+                ("two.txt", "2")
+            });
+            var sizeZipPath = CreateTestZip("size.zip", new[] { ("large.txt", "1234") });
+
+            Assert.Throws<InvalidDataException>(() =>
+                new InstallationManager(
+                    CreateArguments(countZipPath, targetDir),
+                    Log,
+                    maximumArchiveFileCount: 1).Execute());
+            Assert.Throws<InvalidDataException>(() =>
+                new InstallationManager(
+                    CreateArguments(sizeZipPath, targetDir),
+                    Log,
+                    maximumUncompressedBytes: 3).Execute());
+            Assert.Empty(Directory.GetFiles(targetDir, "*", SearchOption.AllDirectories));
+        }
+
+        /// <summary>
+        /// Verifies that rollback restores overwritten files and removes newly introduced files.
+        /// </summary>
+        [Fact]
+        public void Execute_MidApplyFailure_RestoresOriginalInstallation()
+        {
+            var targetDir = CreateSubDir("target");
+            var settingsDir = Directory.CreateDirectory(Path.Combine(targetDir, "settings")).FullName;
+            File.WriteAllText(Path.Combine(targetDir, "app.dll"), "original-app");
+            File.WriteAllText(Path.Combine(settingsDir, "UserSettings.xml"), "original-settings");
+            var zipPath = CreateTestZip("rollback.zip", new[]
+            {
+                ("app.dll", "updated-app"),
+                ("newdir/new.txt", "new-file"),
+                ("fail.txt", "trigger"),
+                ("settings/UserSettings.xml", "malicious-settings")
+            });
+            var arguments = CreateArguments(zipPath, targetDir);
+            arguments.CreateBackup = true;
+            var manager = new InstallationManager(
+                arguments,
+                Log,
+                relativePath =>
+                {
+                    if (relativePath == "fail.txt")
+                        throw new IOException("Injected apply failure.");
+                });
+
+            Assert.Throws<IOException>(() => manager.Execute());
+
+            Assert.Equal("original-app", File.ReadAllText(Path.Combine(targetDir, "app.dll")));
+            Assert.Equal("original-settings", File.ReadAllText(Path.Combine(settingsDir, "UserSettings.xml")));
+            Assert.False(File.Exists(Path.Combine(targetDir, "newdir", "new.txt")));
+            Assert.False(Directory.Exists(Path.Combine(targetDir, "newdir")));
+        }
+
+        /// <summary>
+        /// Verifies that successful installation removes updater-owned package staging.
+        /// </summary>
+        [Fact]
+        public void Execute_Success_CleansStagedPackageAndPendingDirectory()
+        {
+            var targetDir = CreateSubDir("target");
+            var pendingDir = Directory.CreateDirectory(Path.Combine(targetDir, "updates_pending")).FullName;
+            var zipPath = CreateTestZipAtPath(Path.Combine(pendingDir, "update.zip"), new[]
+            {
+                ("app.dll", "updated")
+            });
+
+            new InstallationManager(CreateArguments(zipPath, targetDir), Log).Execute();
+
+            Assert.Equal("updated", File.ReadAllText(Path.Combine(targetDir, "app.dll")));
+            Assert.False(File.Exists(zipPath));
+            Assert.False(Directory.Exists(pendingDir));
+        }
+
+        /// <summary>
+        /// Verifies that all installed updater payload files can be replaced by an update.
+        /// </summary>
+        [Fact]
+        public void Execute_UpdateContainsUpdaterPayload_ReplacesAllInstalledPayloadFiles()
+        {
+            var targetDir = CreateSubDir("target");
+            var payloadNames = new[]
+            {
+                "SoftwareUpdate.Updater.exe",
+                "SoftwareUpdate.Updater.dll",
+                "SoftwareUpdate.Updater.deps.json",
+                "SoftwareUpdate.Updater.runtimeconfig.json"
+            };
+            foreach (var payloadName in payloadNames)
+            {
+                File.WriteAllText(Path.Combine(targetDir, payloadName), "old");
+            }
+
+            var zipPath = CreateTestZip(
+                "self-update.zip",
+                payloadNames.Select(name => (name, "new")).ToArray());
+
+            new InstallationManager(CreateArguments(zipPath, targetDir), Log).Execute();
+
+            foreach (var payloadName in payloadNames)
+            {
+                Assert.Equal("new", File.ReadAllText(Path.Combine(targetDir, payloadName)));
+            }
+        }
+
+        /// <summary>
+        /// Verifies that an existing directory reparse point is rejected before extraction.
+        /// </summary>
+        [Fact]
+        public void Execute_ReparsePointInDestination_IsRejected()
+        {
+            var targetDir = CreateSubDir("target");
+            var outsideDir = CreateSubDir("outside");
+            var linkPath = Path.Combine(targetDir, "linked");
+            try
+            {
+                Directory.CreateSymbolicLink(linkPath, outsideDir);
+            }
+            catch (Exception ex) when (ex is IOException or UnauthorizedAccessException or PlatformNotSupportedException)
+            {
+                return;
+            }
+
+            var zipPath = CreateTestZip("reparse.zip", new[] { ("linked/escaped.txt", "malicious") });
+
+            Assert.Throws<SecurityException>(() =>
+                new InstallationManager(CreateArguments(zipPath, targetDir), Log).Execute());
+            Assert.False(File.Exists(Path.Combine(outsideDir, "escaped.txt")));
+        }
+
+        #endregion
+
         #region RestoreFromBackup Tests
 
         /// <summary>
@@ -584,6 +916,19 @@ private string CreateTestZip(string name, (string path, string content)[] entrie
         {
             var zipPath = Path.Combine(_testDir, name);
 
+            return CreateTestZipAtPath(zipPath, entries);
+        }
+
+        /// <summary>
+        /// Creates a test ZIP archive at an explicit path.
+        /// </summary>
+        /// <param name="zipPath">The output ZIP path.</param>
+        /// <param name="entries">The archive entries.</param>
+        /// <returns>The ZIP path.</returns>
+        private static string CreateTestZipAtPath(string zipPath, (string path, string content)[] entries)
+        {
+            Directory.CreateDirectory(Path.GetDirectoryName(zipPath)!);
+
             using (var archive = ZipFile.Open(zipPath, ZipArchiveMode.Create))
             {
                 foreach (var (entryPath, content) in entries)
@@ -597,6 +942,24 @@ private string CreateTestZip(string name, (string path, string content)[] entrie
             return zipPath;
         }
 
+        /// <summary>
+        /// Creates standard arguments for an installation test.
+        /// </summary>
+        /// <param name="zipPath">The update package.</param>
+        /// <param name="targetDirectory">The target installation.</param>
+        /// <returns>The updater arguments.</returns>
+        private static UpdaterArguments CreateArguments(string zipPath, string targetDirectory)
+        {
+            return new UpdaterArguments
+            {
+                ProcessId = -1,
+                ZipPath = zipPath,
+                TargetDirectory = targetDirectory,
+                MainExecutable = "missing.exe",
+                CreateBackup = false
+            };
+        }
+
         /// <summary>
         /// Creates a malicious ZIP archive containing path traversal attempts for security testing.
         /// </summary>
diff --git a/tests/SoftwareUpdate.Updater.Tests/UpdaterArgumentsTests.cs b/tests/SoftwareUpdate.Updater.Tests/UpdaterArgumentsTests.cs
index 33b00a62..49a18b41 100644
--- a/tests/SoftwareUpdate.Updater.Tests/UpdaterArgumentsTests.cs
+++ b/tests/SoftwareUpdate.Updater.Tests/UpdaterArgumentsTests.cs
@@ -133,6 +133,21 @@ public void Parse_AllArguments()
             Assert.True(args.CreateBackup);
         }
 
+        /// <summary>
+        /// Verifies that repeatable preserve arguments are retained in order.
+        /// </summary>
+        [Fact]
+        public void Parse_RepeatablePreserveArguments()
+        {
+            var args = Parse(new[]
+            {
+                "--preserve", "data/user",
+                "--preserve", @"cache\local"
+            });
+
+            Assert.Equal(new[] { "data/user", @"cache\local" }, args.PreservedRelativePaths);
+        }
+
         /// <summary>
         /// Verifies that argument parsing is case-insensitive.
         /// </summary>
@@ -409,6 +424,41 @@ public void Validate_ValidArguments_DoesNotThrow()
             }
         }
 
+        /// <summary>
+        /// Verifies that absolute and traversal-based preserved paths are rejected.
+        /// </summary>
+        /// <param name="preservedPath">The invalid preserved path.</param>
+        [Theory]
+        [InlineData(@"C:\settings")]
+        [InlineData("../settings")]
+        [InlineData("data/./settings")]
+        [InlineData("file:stream")]
+        public void Validate_InvalidPreservedPath_ThrowsArgumentException(string preservedPath)
+        {
+            var tempFile = Path.GetTempFileName();
+            var tempDirectory = Path.Combine(Path.GetTempPath(), Guid.NewGuid().ToString("N"));
+            Directory.CreateDirectory(tempDirectory);
+
+            try
+            {
+                var args = new UpdaterArguments
+                {
+                    ProcessId = 1234,
+                    ZipPath = tempFile,
+                    TargetDirectory = tempDirectory,
+                    MainExecutable = "app.exe"
+                };
+                args.PreservedRelativePaths.Add(preservedPath);
+
+                Assert.Throws<ArgumentException>(() => Validate(args));
+            }
+            finally
+            {
+                File.Delete(tempFile);
+                Directory.Delete(tempDirectory);
+            }
+        }
+
         #endregion
 
         #region UnquoteArgument Tests (Via Parse)

From d5bb4b6aac284c952eb3c9d05b658b4996a0dab2 Mon Sep 17 00:00:00 2001
From: HadenSmith <cole.h.smith@usace.army.mil>
Date: Fri, 10 Jul 2026 10:02:20 -0600
Subject: [PATCH 7/7] Fix updater wrapper detection

---
 .../InstallationManager.cs                    | 11 ++++++++---
 .../InstallationManagerTests.cs               | 19 +++++++++++++++++++
 2 files changed, 27 insertions(+), 3 deletions(-)

diff --git a/src/SoftwareUpdate.Updater/InstallationManager.cs b/src/SoftwareUpdate.Updater/InstallationManager.cs
index 7c9793a5..bd8c6765 100644
--- a/src/SoftwareUpdate.Updater/InstallationManager.cs
+++ b/src/SoftwareUpdate.Updater/InstallationManager.cs
@@ -182,7 +182,8 @@ private PreparedUpdate PrepareUpdate()
             var preservedPaths = BuildPreservedPaths();
             var stripPrefix = DetermineWrapperPrefix(
                 archiveFiles.Select(file => file.OriginalPath),
-                preservedPaths);
+                preservedPaths,
+                targetDirectory);
             var plans = new List<UpdateFilePlan>();
             long totalUncompressedBytes = 0;
 
@@ -296,10 +297,12 @@ private static string NormalizeArchivePath(string entryPath)
         /// </summary>
         /// <param name="paths">The normalized archive file paths.</param>
         /// <param name="preservedPaths">The protected installation paths.</param>
+        /// <param name="targetDirectory">The installation root.</param>
         /// <returns>The wrapper prefix, or <see langword="null"/>.</returns>
         private static string? DetermineWrapperPrefix(
             IEnumerable<string> paths,
-            IReadOnlyList<string> preservedPaths)
+            IReadOnlyList<string> preservedPaths,
+            string targetDirectory)
         {
             var pathList = paths.ToList();
             if (pathList.Count == 0)
@@ -314,7 +317,9 @@ private static string NormalizeArchivePath(string entryPath)
                     string.Equals(installRoot, root, StringComparison.OrdinalIgnoreCase)) ||
                 preservedPaths.Any(path =>
                     string.Equals(path, root, StringComparison.OrdinalIgnoreCase) ||
-                    path.StartsWith(root + "/", StringComparison.OrdinalIgnoreCase)))
+                    path.StartsWith(root + "/", StringComparison.OrdinalIgnoreCase)) ||
+                File.Exists(Path.Combine(targetDirectory, root)) ||
+                Directory.Exists(Path.Combine(targetDirectory, root)))
             {
                 return null;
             }
diff --git a/tests/SoftwareUpdate.Updater.Tests/InstallationManagerTests.cs b/tests/SoftwareUpdate.Updater.Tests/InstallationManagerTests.cs
index 30009971..9ccc74c4 100644
--- a/tests/SoftwareUpdate.Updater.Tests/InstallationManagerTests.cs
+++ b/tests/SoftwareUpdate.Updater.Tests/InstallationManagerTests.cs
@@ -434,6 +434,25 @@ public void ExtractUpdate_SingleKnownInstallRoot_DoesNotFlattenFiles()
             Assert.False(File.Exists(Path.Combine(targetDir, "dependency.dll")));
         }
 
+        /// <summary>
+        /// Verifies that an existing installation directory is not mistaken for a release wrapper.
+        /// </summary>
+        [Fact]
+        public void ExtractUpdate_SingleExistingInstallRoot_DoesNotFlattenFiles()
+        {
+            var targetDir = CreateSubDir("target");
+            Directory.CreateDirectory(Path.Combine(targetDir, "plugins"));
+            var zipPath = CreateTestZip("plugins-only.zip", new[]
+            {
+                ("plugins/new-plugin.dll", "plugin")
+            });
+
+            new InstallationManager(CreateArguments(zipPath, targetDir), Log).Execute();
+
+            Assert.True(File.Exists(Path.Combine(targetDir, "plugins", "new-plugin.dll")));
+            Assert.False(File.Exists(Path.Combine(targetDir, "new-plugin.dll")));
+        }
+
         /// <summary>
         /// Verifies that ExtractUpdate skips backup directories found within update archives.
         /// </summary>