Publish quixos-nix-helpers from b384206b9c01a9ac50030a583d028b71291bc8c5

- define and validate the capability and resource-lock languages
- provision workspace source repositories through Central Gitea
- build package runtimes from pinned standalone sources
- replace legacy schema compilation with workspace persistence plans
- add stable optimistic registers and Automerge CRDT documents
- modernize TypeScript/Nix package builds and runtime activation readiness

.quixos-subtree-source.json

@@ -1,7 +1,7 @@
 {
   "version": 1,
   "sourceRepo": "https://gitea-external.egads.tutti.syntaxblitz.net/quixos/quixos.git",
-  "sourceCommit": "eb407e5a3bbd4ae2f810a0cee0d45b5c7e8d7db1",
+  "sourceCommit": "b384206b9c01a9ac50030a583d028b71291bc8c5",
   "sourcePath": "quixos-instance/quixos-nix-helpers",
   "exportName": "quixos-nix-helpers",
   "mirrorRemote": "https://gitea-external.egads.tutti.syntaxblitz.net/quixos/quixos-nix-helpers.git"

quixos-package-helpers.nix

@@ -521,7 +521,6 @@ EOF
       promptName ? null,
       nodejsAttr ? "nodejs_24",
       buildCommand ? "yarn build",
-      sourcePortals ? { },
       buildEnv ? { },
       nativeBuildInputs ? [ ],
       devShellPackages ? [ ],
@@ -561,19 +560,20 @@ EOF
               attrs
           );
 
-        portalLinksFor = attrs:
-          lib.concatStringsSep "\n" (
-            lib.mapAttrsToList
-              (target: source: "ln -sfn ${source} ${lib.escapeShellArg target}")
-              attrs
-          );
-
         bundleConfig = if bundle == null then { } else bundle;
         bundleOutfile = bundleConfig.outfile or "server.mjs";
         bundlePlatform = bundleConfig.platform or "node";
         bundleTarget = bundleConfig.target or "node24";
         bundleFormat = bundleConfig.format or "esm";
         bundleBanner = bundleConfig.banner or nodeRequireBanner;
+        bundleAliases = bundleConfig.aliases or {
+          "@automerge/automerge" = "./node_modules/@automerge/automerge/dist/mjs/entrypoints/fullfat_base64.js";
+        };
+        bundleAliasArgs = lib.concatStringsSep " " (
+          lib.mapAttrsToList
+            (from: to: "--alias:${from}=${lib.escapeShellArg to}")
+            bundleAliases
+        );
         nodeRequireBanner = "import { createRequire } from 'module';const require = createRequire(import.meta.url);";
         bundleCommand =
           if bundle == null
@@ -584,6 +584,7 @@ EOF
               --platform=${bundlePlatform} \
               --target=${bundleTarget} \
               --format=${bundleFormat} \
+              ${bundleAliasArgs} \
               ${lib.optionalString (bundleConfig.preserveSymlinks or true) "--preserve-symlinks \\"}
               --banner:js=${lib.escapeShellArg bundleBanner} \
               --outfile=${lib.escapeShellArg bundleOutfile}
@@ -595,12 +596,31 @@ EOF
           installConfig.libexecName or (lib.strings.sanitizeDerivationName packageNameFinal);
         serverFile = installConfig.serverFile or bundleOutfile;
         descriptorPath = installConfig.descriptorPath or "descriptor.quixos-package.txtpb";
+        extraFiles = installConfig.extraFiles or [ ];
+        installExtraFile = file:
+          let
+            source = toString file.source;
+            target = file.target or (baseNameOf source);
+            mode = file.mode or "0644";
+          in ''
+            install -Dm${toString mode} ${lib.escapeShellArg source} "$out/libexec/${serverLibexecName}/${target}"
+          '';
         installServerPhase =
           if installServer == null
           then null
           else ''
             runHook preInstall
             install -Dm755 ${lib.escapeShellArg serverFile} "$out/libexec/${serverLibexecName}/${serverFile}"
+            # Browser entrypoints are runtime artifacts too. Package build scripts
+            # conventionally emit them as top-level .mjs files in dist/. Install
+            # the complete set so adding an entrypoint cannot produce a descriptor
+            # that resolves successfully but fails when Web Studio opens the file.
+            for browserModule in dist/*.mjs; do
+              if [ -f "$browserModule" ]; then
+                install -Dm644 "$browserModule" "$out/libexec/${serverLibexecName}/$(basename "$browserModule")"
+              fi
+            done
+            ${lib.concatMapStringsSep "\n" installExtraFile extraFiles}
             mkdir -p "$out/bin"
             cat > "$out/bin/${serverBin}" <<EOF
 #!${pkgs.runtimeShell}
@@ -620,9 +640,6 @@ EOF
               (old.nativeBuildInputs or [ ])
               ++ lib.optional (bundle != null) pkgs.esbuild
               ++ callOption nativeBuildInputs;
-            preConfigure = (old.preConfigure or "") + ''
-              ${portalLinksFor (callOption sourcePortals)}
-            '';
             buildPhase = ''
               runHook preBuild
               ${exportsFor (callOption buildEnv)}
@@ -662,7 +679,7 @@ EOF
         devShells.default = pkgs.mkShell {
           packages = [
             nodejs
-            pkgs.yarn-berry_4
+            project.yarn-freestanding
           ] ++ callOption devShellPackages;
           shellHook = devShellHookBase + callOption devShellHook;
         };