dsh-remote-cluster 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -8
- package/cordis.patch.yml +2 -0
- package/lib/client.js +1520 -2613
- package/lib/contracts.d.ts +84 -389
- package/lib/host/artifacts.d.ts +0 -1
- package/lib/host/artifacts.js +4 -4
- package/lib/host/helper.js +19 -4
- package/lib/host/notification-state.d.ts +2 -2
- package/lib/host/notification-state.js +4 -2
- package/lib/host/notifications.d.ts +4 -2
- package/lib/host/notifications.js +14 -4
- package/lib/host/plugin-upgrade.d.ts +2 -2
- package/lib/host/plugin-upgrade.js +3 -3
- package/lib/host/policy.d.ts +1 -6
- package/lib/host/policy.js +6 -21
- package/lib/host/runtime.d.ts +3 -3
- package/lib/host/runtime.js +16 -17
- package/lib/host/trust-stream.js +4 -4
- package/lib/index.js +1004 -1958
- package/lib/remote-web/assets/{b7f316f5fb0833db75e64ce8b7175fed9f7c183ecde8cbefeed176d486bed045.js → 0084c52f62a385e6094e5dfa889de8c7099e915b1ef0c5119c91745ac29ea890.js} +24 -24
- package/lib/remote-web/assets/{d21d232ead8f68e0e469830b95f6453508ed06591fd6cdb5f0b01f3ea61c24c7.js → 02ea64b75b5ebef3caa1dc974cc4e1e4e524c9cddaf60fd88f058f483bce03be.js} +100 -100
- package/lib/remote-web/assets/{098bde291652f9081cfecf174e69dba72fdf314d723e9e5c3e3b8ef492ef060c.js → 08034715255f7a5edb4b26ddedbad14f7972f25bb1ce9fb3e8740c66bb9ad956.js} +1 -1
- package/lib/remote-web/assets/{0a35520ffc7be23507ad92b1356c324e16e67816207fe53f7148fb129e3f7b16.js → 087bed002531649ed2b202ef468b6bdf42b3ce77848316fc3377741e52fa2f84.js} +1 -1
- package/lib/remote-web/assets/{adfdafc2983dd8062d21830340ae64002b98a0b73112397c1e18b87e50981eb5.js → 08ccb052f1bf6514d581ea35581c796a8b72b119a3ede4c49659569d4ba2b390.js} +14 -14
- package/lib/remote-web/assets/{334885a21328d9e13b7b2a55291f3029eb7e643be2193c72bc1d92b93f5e8124.js → 09d0199543b952650a5fc2822fa3f1f1b11ec40fb6821be4e4a4957a54462fa5.js} +13 -13
- package/lib/remote-web/assets/{15a481b4185010cf0070c1765cff4ae70803c47009b46b969ed23245d47d8d1b.js → 0c7796fb3d285a3e952108018f50ca54f6f9abe12cd5d113abfdda6ca0a9c291.js} +210 -210
- package/lib/remote-web/assets/{3fa1e622c06d545d0397d9294797e08af723cf89efcf27ba0b6a06ab3178b74b.js → 0cde6b99667f8398fc0b93679218518296de65e93c7add4e514fb84b037288fb.js} +1 -1
- package/lib/remote-web/assets/{1c98cd48db7795f939b6f60e34e476c5cdb987b74591c888221bc3cffcd039b9.js → 0d98fb17a975a69e1a44a15a6a7a598f51e4ec7e87d63c5dbba20c937b79b278.js} +536 -536
- package/lib/remote-web/assets/{7e81b7468feb6d690a5ae7bdc9f6d39764372cd64ffac39e5903ccd2de452bb2.js → 0df770f50561c1809781b6df2e39cdd9955bf85a0078b890965e1b5f4a8a644a.js} +35 -35
- package/lib/remote-web/assets/{b96274d6ccca084c0ecddbe2b511899ee8170bdb07f0443b78ed04aee136a9ea.js → 122d30bcfc3f574de9cef4216d1bae603158b8c362157107856a90b224bfa4d6.js} +163 -163
- package/lib/remote-web/assets/{cebafc997b717b6e4129067181e893f3a8789b5b57d22ab0b42ac9228b824281.js → 139b0cb0e366fa40d529e32c7dc7bef81fa9242d5814c77b20399c022b26b657.js} +1 -1
- package/lib/remote-web/assets/{5d58a7f2c9328dff985f169ff9b1d11e19341e1fc195364336c6d19d9944e919.js → 15133b18c27254c4071409497f17ce289290096f02444f776579322822e056fa.js} +11 -11
- package/lib/remote-web/assets/{e9275df5d01fa592536ef387b19c25aebc136aac8e3faa310bca203a43aee10b.js → 18a1bfce18b181785c5722a84fa68c2448c5c293845a54463608c249052231fa.js} +8 -8
- package/lib/remote-web/assets/{1adb6da8d7880db5639471451e8f1a734fd2a3a9366b1564b6d1df7626461b55.js → 18e7fca36248d92ede2e900db36d1caa20a1fc4ef228cff27ce1432a96df4edf.js} +77 -77
- package/lib/remote-web/assets/{01973d1544b193546badc3d3a5b3f3e4ff25c0f97f5dbe31419d8e847dcd1efb.js → 1c14db1f0a14adeb85ae8f71ce1b3c48437014fea4647a28191ec9aeec8e9d64.js} +1 -1
- package/lib/remote-web/assets/{f444d2cee7fc1bdac53f7114a920c659842cdf99e28a24bbd47bb24680bbea9e.js → 1d1aa9c727ce764d8dfdbe2419497486fce7acd87b5208ba38401e51bba343da.js} +43 -43
- package/lib/remote-web/assets/{2c542544e16be5db63d680b340dc54945c5f1c118b9d2bdff9d1cd86e119bccd.js → 1da0fcc4e8c98734daabe0b842ae647c5b31603595932c7679ec0fa5d26530a3.js} +20 -20
- package/lib/remote-web/assets/{e034cf380b694c73636b3b0806ba7373e1801855aacb940f72c15fa229de2b49.js → 1dc4ca74265350d289728f94a067f90af7b0512ff57a11ccc1592cad93b9dc05.js} +1 -1
- package/lib/remote-web/assets/{43a4cc3e142648f4ac9f9be6935c483d45ca25e93509a743ad52893179707a52.js → 2760cb3815b4db58d919c994e60adf195e4cffadbb5a7bb7864e5e38f0e9c4cc.js} +1 -1
- package/lib/remote-web/assets/{f1525fc764d1075eb7e514eef4c8727f861268ca1cd13a7932fe346c783928c1.js → 3b7e8eedc420d0f92c8e02f4f76d2770335cd6886deb43a21c7a055236389ce2.js} +2033 -2018
- package/lib/remote-web/assets/{e02bf19583b6a625934e7a3f186d9501b7643cf66fb8842c112aec334d6c6fb2.js → 3bdb86657b39a44141e195454ff97175c002e6645e854cf5a53e79e14f62d1a7.js} +1 -1
- package/lib/remote-web/assets/{2468f65781a1ed70cba018fd39cc67a752b1bab369a5cea6496979d953469a98.js → 44359122d19e49d937a2479a03fa4b54487ad56333bc8ea3af88ecb93f343a57.js} +56 -56
- package/lib/remote-web/assets/{b951fa440cfa468b10993fc6ab7ff26049c3feeb2555508d3314941ce61d1688.js → 48ee5453fb22d299af902f2f16d392fc3f0fd1c7a61d529af3c8ec2d852d0ef9.js} +1 -1
- package/lib/remote-web/assets/{12e7dcb173cae94664df91583dfee627aff9e6274330cf4ceb8a71848015b1f5.js → 4a9fb8705a24728082865ef72044ed52f7dc8af7958a6c59e2f54a322ea159d3.js} +81 -81
- package/lib/remote-web/assets/{fe588c75b14b5b80a8b1e2ed3d427a018b0478a710ff1158285299a118c68552.js → 4b1f01ce0e6cdf3427082b0ea09f5b4444c5f33becb2e61fcff036be6caecf61.js} +39 -39
- package/lib/remote-web/assets/{94dc298a4c0b13582626b568744d73438379611c70c94f27276de5524a764646.js → 4b5bbd08c07143177017aec55b9c3cfa99f7ac2b7e7df41eb711e5686e8fc45c.js} +1 -1
- package/lib/remote-web/assets/{adb35a440db8d19c4c4259db43a2581dc976973a18c33a21537c7a4f134c3751.js → 4d62ec73c613195dbcc605687437075d9ae69abfff46f2222828ef6552aeb7fb.js} +198 -198
- package/lib/remote-web/assets/{ddfab7b1b5a26429dec5bce358ed59cbfde9abb4163d799cc21dd0c81bbf0039.js → 4fba08815fd76d75051f8cd3a8422efaddaabd35916b782b8c3a6c5efca37df7.js} +1 -1
- package/lib/remote-web/assets/{6b47fdd8a6f11322c7b05295cc13333968713fb6d31afd3aaff2ff472e779899.js → 51df9318706eec62dd9ac25b3e177f27b381b2badd74c9105b4ecd19fd9d8a7f.js} +187 -187
- package/lib/remote-web/assets/{f95c2501d2da00fc152537c126ec680b4ce0d1bbe11439e34d39906400e0d314.js → 5448433f82ecf21d6c836ad57deddf1794ba63eee14e7380d3f61f84e12e5fdb.js} +38 -38
- package/lib/remote-web/assets/{d60e1fc1a4c2fd58f0e8bdba92181866c6a91dbe78f246ff13a7f36f322fe2e0.js → 5513a63c1c3db2570ffc3d4247838e1fdd74720aea7f6fc31ae2e5e7803f55ba.js} +10 -10
- package/lib/remote-web/assets/{a5fbb399f54ed13ab75612b231af21361747b2aa647d74f9643d09ebf6850cf4.js → 61aefa00f389470ac6c115e3235e098fd748b96305383a2d1bd6ce44cea0fec5.js} +17 -17
- package/lib/remote-web/assets/{77466b3f709f3db981e917e814f6a994525b19e6549a9cd39329242cba39a8ec.js → 633253522c4782e41100d66490ce6cdecabeca111378fbc37584a4cfceccfb15.js} +8 -8
- package/lib/remote-web/assets/{859bc5e8483c0b551734cf5b56d293ffac7c6ad861753115ed3e614b7063f875.js → 6e4e15365f3e55613ce8287ad50e74b10b45b9a93e8e3ea0432a84d3339a0814.js} +4 -4
- package/lib/remote-web/assets/{49d4a89c9a9c14f512853f602a6a48677fc2bfaccb285968dbbf7a5bce9cca23.js → 7b45fae07f4e474e34e468c8e2d6ec357ccbd6cfa3874e9f1f16852975bf7b70.js} +28 -28
- package/lib/remote-web/assets/{02fa8868185ded075a4fc747a57779bb44693016716e7f5cf15118d5e277f67d.js → 7b668aebc28b5370196dc974f744a9b73ee22fb64ac86644bbd3f6d35e30a9c3.js} +1 -1
- package/lib/remote-web/assets/{86f233ebd933cc27cd1fd375eadaef756258ec6ef3f1ec6bbc8a74bd749b25cf.js → 81a52db264b358f8a0571c1a21df44d005711d3070edab12b01718962f237daa.js} +19 -19
- package/lib/remote-web/assets/{27049d2062e1559c71c12312b3bd4a3d12b7551aa1cae18d0eabef42b15f22e3.js → 85674b722e9ddd3a7fb57729957619a72c125c6444b8067bedaf736a083e8870.js} +66 -66
- package/lib/remote-web/assets/{7c12a1642113ad6e6fef1215ece81f8119e6eda32c933d0e6d0cdf45b955dcf6.js → 8ec58a658326c139649a5fa4337d716d487a19eb53cefef6ab33a8f170cbb937.js} +12 -12
- package/lib/remote-web/assets/{ac1eeb4080e4ceeb19b90bae0449d11cf3bca7bb10865f75d22234b193e3c71f.js → 8ee1f0abb65b41bdae842afcf92fd5423227ff79190064d16d72e3cf5d663ccb.js} +66 -66
- package/lib/remote-web/assets/{76df7944d9167c8570be01943f4c4fa388c231ce28679391478a621a2b992302.js → 93e5328c86c55d0f5f572c52e301a94edb6ff183e59a088c807cb003acf19b3e.js} +40 -40
- package/lib/remote-web/assets/{af8d8b6d4866268a09ab3fa3a7b4207ee05a679acab4b0fdcb636573d4362cd4.js → 95db94d22c7fbb20288fd23f7300f237a32eef01fb14d080ce2ba5a4056cb58b.js} +5 -2
- package/lib/remote-web/assets/{8d9390f9055cae8f6cb9007160df46e927206e8bc6be2b85ad2cded69c55c258.js → 971050ba209a083dc0f76aae76c920b0cf6f39833caa9eac04d5e7c098b10294.js} +6 -6
- package/lib/remote-web/assets/{65245e000893241e7bb501a9a74f817e7127d3ac52f9498f426729e33b936042.css → 9b651fa4a96aae97c23e1e7774719c275901770622525feddee8982f881d30cb.css} +1 -1
- package/lib/remote-web/assets/{5f7c0da75b7d175568413e9252b489e38e1a105dc5cba4ee2af5c14614b19636.js → 9be52bd9e34016d26eac150a60864792bac13cedeb610134847c3750fe6d7d65.js} +1 -1
- package/lib/remote-web/assets/{fad9547b869d68c968df3a4c6223547dea854d82ba9d03b5bed7cb1b6f5a863a.js → a46ac5f37d4d56a6f3ef55f9d1c22afe79ae6e6486cac58d1a8b5f4aa35e3454.js} +4 -4
- package/lib/remote-web/assets/{b4795c75852caa38530903f2f5c6a068245769ca598519062ef8c84ee952dcbb.js → a902a4629188498d3de6c11bdab9d6331ebc78ac84f1eed1426808e152324eef.js} +1 -1
- package/lib/remote-web/assets/{3c58d660556f04bf959a80a68ceb24f9ca271effa47d4c11bf80a2a7298e094b.js → b14165b5a2b7ea65983dd50bb4d2a812e742902d215ac0838e4acb6e9d2219cb.js} +29 -29
- package/lib/remote-web/assets/{e9c84734488eb05a5046cdadc91c42eead837ebba2c347382afb6b6a928ff453.js → bc71bf8433d22d5044fc0a1d23cf3da7249e1d4d68a28403cdcdeb62f6c06fd0.js} +8 -8
- package/lib/remote-web/assets/{4452b5457ed9ef75852ed655421678a4c9761a8ba665a6acb76a7bee9591f80a.js → c19cad32a941358746573aa8775bfa25bb039ab11c0dbc8609472e4954d99569.js} +1 -1
- package/lib/remote-web/assets/{1dc7a20ec252e349870f557514a7400c40204ec2843b5465f2566fbda4c2c6d7.js → c3c64c8c168f764e3179ddc5756b784bae721d76425f2bed1be8c94c2981c023.js} +105 -105
- package/lib/remote-web/assets/{642d744b2336ffdca7f6ef2142b982d7583dc16a8f0fa6336a3ad342ae2e92bf.js → c9b9443fe4210c5c7e9c473b18516d12972136bc2158944009e64f378d6a0f76.js} +61 -61
- package/lib/remote-web/assets/{9ad4c375e58485513f0bb245c565dde8d9e377daa743973c2ffbd1db6edf5c14.js → ca4eacba163e6456f16b51db159f5bb8022d77f769d997e71542a8a462526f89.js} +1 -1
- package/lib/remote-web/assets/{19fdc5bfa9eb27746a52d4136d82432adad1fc5c05da343375c47e9eb1e0ff6d.js → cb63e257fb5d660613f44875d534ed8b2ca3d84ea23a7c2126a32b48848bb952.js} +1 -1
- package/lib/remote-web/assets/{18be6c6b00a6cebc5d61c987d345c295670aba2c448824b89394ef0225a9ad8f.js → d091b2f2d7a7405446aa3cf3e9222ab01c9108c51d8bdaddac35e1c0787f5d9e.js} +17 -17
- package/lib/remote-web/assets/{a9136a821ffdecfbb7da3181201a294599113fde30a9194d300a0ebd04265777.js → d1702ad9988e1f43af19d6222173fcd19df5eeb818178d0121965cb28c4aac79.js} +32 -32
- package/lib/remote-web/assets/{3ca829260281ebaa7e63eacb26fb5d6f9b3d2536424f17602f43eca797236daf.js → d2214a70ac36fce2f7f9f4fc955d487fdb7b2fac778eb6768bafefbf9d483756.js} +96 -96
- package/lib/remote-web/assets/{32eac0da1495da50f652018ac86c7dfeb5623a5aad823b876f42220667f1e7ed.js → d5a949b16e3425e396fbb9da6c72b7753c712d7a6e2f7cd82ee149ea5dddaf46.js} +19 -19
- package/lib/remote-web/assets/{6381af51cd1f1ff8f74971e145d78efbbb0a91ee04c08b67b0d826807410ce6c.js → d89ab139a3c4c779fcd0f7d90178e1e40b6918df5ff3ee88bf2e21ff4f4a408c.js} +23 -23
- package/lib/remote-web/assets/{52ac36b862f86e3fb3484b4cf739c2814e10c48be9a2ff0628a7ca41fc58286a.js → dad39c89eb29f99a02c2af23d3a8311b91f0b5a6ec46ef82e6e9dccdbb5ee6fc.js} +46 -46
- package/lib/remote-web/assets/{6e976052085dd6ca0696d3a8af15c019d603ffbebd7025e4296adde26392b610.js → dc5ab043cebd5fea48e4986e9702c1e7e80474ff9d9d169ac0cc3e5011d2a577.js} +14 -14
- package/lib/remote-web/assets/{005428c618c289f581815d719452c1d079fde087ab7597f1f4c9612cc9a58a4d.js → e1ae1c76c261fb7942bbcb954a2daf44b19e441c43a1e01bec909e11a0e3a112.js} +17 -17
- package/lib/remote-web/assets/{18f57f2be1c19d9ef485ceb00726357034de63728633c69d63ca2e2308e5958b.js → e2588f4df22316a5592393a5d6a846477deb9a7e61e2bb275bffdbdc2aceeb18.js} +1 -1
- package/lib/remote-web/assets/{c597d36a6b01cd4210733f7646be58b0868d3daa52d99430c5af5d28c89657b4.js → e2b04a76c8759e5147bbdd901106b4c52abdf7a930b50fc1b9db0abfde6943d4.js} +55 -55
- package/lib/remote-web/assets/{a1ec080e7d44c62ef90702af75eeeb076d07fe038c0520cad58bd3dbd423292d.js → e473d6a294c1c3e8dc0de53d575c5dfb819e7ac17276c2a1a6857f00926cca23.js} +248 -236
- package/lib/remote-web/assets/{9e5285630189b8e0b0a05ff063c168a7529bdc050577951adfb83d259211da24.js → e49b263f1d23afca80ae12e6b22bad8160d7af4040e67f651e118716501c9877.js} +7 -7
- package/lib/remote-web/assets/{e199929a866f9546c5f82ffa151f6360c31fae41e50594eb6d581f332a3e6b0c.js → e5c3c7acacaa3a8fe1a751fe18efd6971ed08da4bcfe22552b5ab2acdffbdda0.js} +10 -10
- package/lib/remote-web/assets/{6e8987340a515a088aca1ac7a058497830773028608c13ce2534d879148cd4e1.js → e97c5e1b2d22345551b36963fa0732dd2d3b35b2151c325afa5383a92274a46b.js} +1 -1
- package/lib/remote-web/assets/{64b30fa405d0e970e2cd9965e6885cf0a51d3e9405620cb9b7475dcd201567e8.js → e9dc6f3cb84e3cbbbf89f784935ddb888998996c6a821cdd6034813519d5b805.js} +40 -40
- package/lib/remote-web/assets/{940768cc4030ed48826915533c051037bf0cc7abe1cf7beb848209117e9e1e8c.js → eca547fd17bc209b737202e26038f067f5e7343d03853c03c522a7ffce1478e9.js} +27 -27
- package/lib/remote-web/assets/{cafa7df812524a60fdd7a87a5e2a999d30a3db98020be2215d3911e971b82703.js → eda44f09786da18ba9e1565add234c28dc6ce7921f8015c0d1802d41fab65830.js} +48 -48
- package/lib/remote-web/assets/{a2d62f5423b1fa2be3fa79c3f7242ae5152a993ac5179767aebb5c494eb23a31.js → fad9a550005adba79006e476f4542fb0946734ceaf44963d7dcdf6b671f5366c.js} +1 -1
- package/lib/remote-web/assets/{679ca4f6d055b4e3f42552bc908312a3a2a9639cc0ebdd26559de02051b2d720.js → fbc51e4c027ee369392bf78c535d4713e226dd65e4be60c0e7466205f3cb514f.js} +193 -193
- package/lib/remote-web/assets/{d780f0181c73771dade5f793f0a81fc914cc45cae63d1dc4cb04c2c34f2ddbe4.js → fe91c282e5695c3920bcb5168c49c0038909b22b040269802b348889d07ac6e1.js} +1 -1
- package/lib/remote-web/index.html +2 -2
- package/lib/remote-web/manifest.json +461 -461
- package/package.json +24 -23
- package/lib/host/awake-timeout.d.ts +0 -24
- package/lib/host/awake-timeout.js +0 -45
package/README.md
CHANGED
|
@@ -4,11 +4,11 @@
|
|
|
4
4
|
|
|
5
5
|
Host → helper control and business traffic use the authenticated loopback HTTP server. The helper announces its random loopback origin once on stdout before initialization. The inherited secret pipe carries the 256-bit key; stdin stays open only to establish parent ownership. Parent EOF or shutdown cancels and joins the runtime. No routine commands or business bytes travel over stdio.
|
|
6
6
|
|
|
7
|
-
Control resources consolidate status/identity, plugin check/upgrade, and durable storage role submissions. Catalog
|
|
7
|
+
Control resources consolidate status/identity, plugin check/upgrade, and durable storage role submissions. Catalog snapshots and subscriptions read one helper-owned local view maintained by background snapshot/watch; trust remains the separate authority stream. Embedded/mobile callers retain the in-process `Runtime.Handle` API. The resource table is documented in [local process contracts](../../docs/design/technical-contracts-v1.md).
|
|
8
8
|
|
|
9
9
|
Lifecycle diagnostics use `schemaVersion: 2`. The host writes `Remote helper process`, `Remote helper supervisor`, `Remote helper trust`, and `Remote runtime` JSON records through the host logger; the helper writes JSON to inherited stderr. Match `hostPid`, child `pid` (helper `ppid` is its immediate parent), `generation`, timestamps and `correlationId`. On Windows the immediate parent may be the launcher. Correlation IDs are SHA-256 hashes of IPC IDs; raw IDs, payloads, trust projections and credentials are excluded.
|
|
10
10
|
|
|
11
|
-
Neither process samples scheduling gaps or emits periodic clock records. Control requests have a 30-second deadline. Independent health probes run every five seconds with a two-second deadline and restart after three consecutive failures. Trust reconnects on actual stream failure or an initial-snapshot timeout;
|
|
11
|
+
Neither process samples scheduling gaps or emits periodic clock records. The helper samples its embedded etcd backend size every ten seconds and updates cached leader facts from native Raft notifications. Control requests have a 30-second deadline. Independent health probes run every five seconds with a two-second deadline and restart after three consecutive failures. Trust reconnects on actual stream failure or an initial-snapshot timeout; the last valid durable membership remains usable while disconnected without expiring. A clock jump alone does not clear authorization or reset request deadlines.
|
|
12
12
|
|
|
13
13
|
For an unexpected shutdown, start at the host supervisor's `restart-requested` or runtime's `stop-requested`. The original cause continues through `generation-stop`, `helper-close-start`, process `stop-requested`, and the shutdown `request-sent`. Match its hash to helper `control-request` and `operation:shutdown`. `owner-close`, `plugin-dispose` and `startup-failed` distinguish disposal from health-driven restarts. `reconnect-start`, `reconnect-connected`, `reconnect-failed`, `stream-recovered` (first accepted frame), and `stream-failed` explain stream recovery. A connected socket alone is not successful authority recovery.
|
|
14
14
|
|
|
@@ -26,21 +26,27 @@ D3 supplies the file implementations used by the D4 runtime. The runtime creates
|
|
|
26
26
|
|
|
27
27
|
## Lifecycle and installation
|
|
28
28
|
|
|
29
|
-
Development dependencies intentionally use local `link:` references. Keep the local development installation linked. On a macOS signing host, run `node scripts/
|
|
29
|
+
Development dependencies intentionally use local `link:` references. Keep the local development installation linked. On a macOS signing host, run `node scripts/prepare-go.mjs` followed by `node scripts/build.mjs plugin --all` to prepare current helpers with embedded checksum-locked etcd 3.6.5 for Windows, macOS and Linux, each on x86-64 and arm64, and build the shared Host/Web code once. `pnpm package:plugin` writes seven npm tarballs and a `publish-plan.json` to `build/dist/npm/`: the shared `dsh-remote-cluster` package plus six `dsh-remote-cluster-<darwin|linux|win32>-<x64|arm64>` native packages. It preserves the development manifest, removes development dependencies and local build scripts, verifies native SHA256 values and public exports, and requires all six native targets before staging the main package. The main package contains no native binaries and pins all six packages in `optionalDependencies`. Each native package declares one `os` and one `cpu`, so npm downloads only the matching native helper. No installation scripts or runtime downloads are used. Runtime verifies the optional package's name/version and native SHA256 values. Keep optional dependencies enabled.
|
|
30
30
|
|
|
31
|
-
Publish all six native tarballs before publishing the main tarball, using the order in `publish-plan.json`. Every package must have the same version. Pass `--os darwin --arch arm64` explicitly to prepare a standalone single-target test archive under
|
|
31
|
+
Publish all six native tarballs before publishing the main tarball, using the order in `publish-plan.json`. Every package must have the same version. Pass `--os darwin --arch arm64` explicitly to prepare a standalone single-target test archive under `build/dist/npm/darwin-arm64/`; these test archives bundle their native pair and do not require unpublished registry dependencies. Linked development also resolves its bundled native files.
|
|
32
32
|
|
|
33
33
|
Inspect the exact tarball with `npm publish --dry-run /absolute/path/to/package.tgz --registry=https://registry.npmjs.org/`. Once the registry package name and publishing access are confirmed, publish that same tarball with `npm publish /absolute/path/to/package.tgz --access=public --registry=https://registry.npmjs.org/`. Do not publish directly from the linked development directory. Registry installation uses `dsh plugin --profile web add <package-name>@<version>`; installing the tarball uses the same command with its absolute path. The registry package name is `dsh-remote-cluster`; the development workspace remains linked.
|
|
34
34
|
|
|
35
|
-
The runtime requirement and all fourteen DSH peer dependencies use `>=0.2.1-rc.3 <=0.2.2-
|
|
35
|
+
The runtime requirement and all fourteen DSH peer dependencies use `>=0.2.1-rc.3 <=0.2.2-rc.1`, inclusive. Host adapters compose public Connection/Gateway dispatch, directory browsing and streamed file uploads; the plugin owns its WebSocket mux and an approval presentation lifetime through a public Cordis accessor. No patched runtime is required. Each desktop remote surface runs the plugin-owned, pinned client graph in its own authenticated same-origin frame, preserving DOM, module and storage isolation independently of the installed DSH UI. Build inputs remain pinned for reproducibility. See [runtime compatibility evidence](../../docs/verification/version-range.md).
|
|
36
36
|
|
|
37
|
-
For a
|
|
37
|
+
For local linking, a successful package build whose targets include the build host also assembles `build/artifacts/local/`. It contains the complete package and the host's helper with embedded etcd, with runtime dependency links to the installed workspace dependencies. `node scripts/build.mjs plugin` prepares and refreshes this directory; `node scripts/package-plugin.mjs --os darwin --arch arm64` refreshes it from existing verified products on a Darwin arm64 host. Cross-target packaging leaves it unchanged. The directory is disposable, workspace-dependent, and removed by `pnpm clean`; rebuild and restart the DSH profile to use updated code.
|
|
38
38
|
|
|
39
|
-
|
|
39
|
+
```sh
|
|
40
|
+
dsh plugin --profile web add link:/absolute/path/to/dsh-remote/build/artifacts/local
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
For a host-only build and standalone package, run `node scripts/build.mjs plugin`; it prepares the host helper with embedded checksum-locked etcd 3.6.5; no separate etcd executable is required. For JS/Web-only development, `node scripts/build-plugin.mjs` reuses independent native products. The build emits the Host entry, public Client lazy-CJS factory, local declarations, scoped design-system token styles, with independent native manifests beside their canonical products. This host-only build can be packed with explicit `--os` / `--arch`; the default release pack requires the preceding `build.mjs plugin --all` build. Install a standalone test tarball with `dsh plugin --profile web add /absolute/path/to/package.tgz`; the command enables the bundle automatically; `dsh.bundle.patch` points to the enabled bare-package Loader row. Use `node scripts/build-platform.mjs --os <linux|darwin|windows> --arch <amd64|arm64>` for target-specific desktop acceptance packages. Each of those archives contains only its selected native slice and a matching single-target manifest. Build verification checks actual bytes and source provenance; native runtime and publisher acceptance remain separate requirements. Unsupported/missing/corrupted platform artifacts fail explicitly with `VERSION_UNSUPPORTED`; nothing downloads latest.
|
|
44
|
+
|
|
45
|
+
The plugin chooses stable profile-specific instance storage and shared per-device identity storage by default. Host configuration may explicitly supply `helperBinary`, `dataDirectory`, `deviceDirectory`, and `credentialNamespace`. Activation initializes local identity. Creating or joining a cluster requires an explicit UI action; bootstrap selects currently available etcd ports and persists them for recovery rather than requiring 2379/2380 to be free. Where no native credential provider exists, only structured first-use file-vault consent keeps management available for an immutable-configuration retry; locked providers fail closed. The sidebar opens the `remote-control` page. The initial remote-access choice is off; create/join/skip persists that choice, while paired settings survive reload.
|
|
40
46
|
|
|
41
47
|
A single supervisor owns helper generations. Unexpected exit invalidates old target mounts, callers, trust and notification subscriptions before a bounded-backoff restart using the original identity and configuration. Management status continues to expose the last sanitized snapshot with `runtimeHealth`, never presenting it as live. Intentional close does not restart the helper, and no management operation, prompt, approval, file transaction or terminal input is replayed during recovery.
|
|
42
48
|
|
|
43
|
-
|
|
49
|
+
Build preparation verifies and reuses the helper with embedded etcd when its inputs, SHA256 and required signatures match. The standalone `node scripts/build-etcd.mjs --host` product is only an interoperability test fixture, and is not packaged or launched in production. Packaging only consumes prepared artifacts and fails with a preparation command if an input is missing, stale or corrupted.
|
|
44
50
|
|
|
45
51
|
On macOS, helper builds require a valid code-signing certificate with its private key in Keychain. A paid developer account is not required: an existing Apple Development identity or a local code-signing certificate can be used. Run `security find-identity -v -p codesigning` to list available fingerprints. The first build pins an available certificate in repository-local Git config `dshRemote.helperSigningIdentity`, shared by worktrees. To choose explicitly, run `DSH_REMOTE_SIGNING_IDENTITY=<40-character-SHA1> node scripts/build-helper.mjs --host`. This also updates the pin; changing certificates is deliberate and can require Keychain reauthorization. Subsequent builds reuse the pin and fail if its certificate/private key is unavailable; they never fall back to ad-hoc signing.
|
|
46
52
|
|