Fix documentation to match actual implementation

- Use correct template names: conda-pixi/v1, conda-micromamba/v2
- Update default pixi image to 0.59.0-noble
- Fix shell-hook path from /opt/wave/entry.sh to /shell-hook.sh

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: pditommaso

adr/20251203-multi-stage-build-templates.md

@@ -43,8 +43,8 @@ Wave's default container builds using Micromamba v1 include the package manager
 | Value | Template | Package Manager |
 |-------|----------|-----------------|
 | `null` (default) | micromamba v1 | micromamba (single-stage) |
-| `pixi/v1` | pixi v1 | pixi (multi-stage) |
-| `micromamba/v2` | micromamba v2 | micromamba (multi-stage) |
+| `conda-pixi/v1` | pixi v1 | pixi (multi-stage) |
+| `conda-micromamba/v2` | micromamba v2 | micromamba (multi-stage) |
 
 **Rationale:**
 - Explicit selection avoids ambiguity
@@ -57,7 +57,7 @@ Wave's default container builds using Micromamba v1 include the package manager
 
 | Option | Default | Description |
 |--------|---------|-------------|
-| `pixiImage` | `ghcr.io/prefix-dev/pixi:latest` | Build stage image |
+| `pixiImage` | `ghcr.io/prefix-dev/pixi:0.59.0-noble` | Build stage image |
 | `baseImage` | `ubuntu:24.04` | Final stage base |
 | `basePackages` | `conda-forge::procps-ng` | Additional runtime packages |
 | `commands` | (empty) | Custom commands |
@@ -85,7 +85,7 @@ Wave's default container builds using Micromamba v1 include the package manager
 
 **Decision:** Generate shell-hook script for automatic environment activation
 
-- Pixi: `/opt/wave/entry.sh` generated via `pixi shell-hook`
+- Pixi: `/shell-hook.sh` generated via `pixi shell-hook`
 - Micromamba: Standard `/opt/conda` activation
 
 **Rationale:**
@@ -116,13 +116,13 @@ Wave's default container builds using Micromamba v1 include the package manager
 | Template | `condaOpts` | `pixiOpts` |
 |----------|-------------|------------|
 | Default (v1) | Yes | No |
-| `micromamba/v2` | Yes | No |
-| `pixi/v1` | No | Yes |
+| `conda-micromamba/v2` | Yes | No |
+| `conda-pixi/v1` | No | Yes |
 
 ## Template Comparison
 
-| Aspect | Default (v1) | `micromamba/v2` | `pixi/v1` |
-|--------|--------------|-----------------|-----------|
+| Aspect | Default (v1) | `conda-micromamba/v2` | `conda-pixi/v1` |
+|--------|--------------|----------------------|-----------------|
 | Build stages | 1 | 2 | 2 |
 | Package manager in final | Yes | No | No |
 | Lock file | No | Yes | Yes |

docs/api.md

@@ -194,11 +194,11 @@ The endpoint returns the name of the container request made available by Wave.
 | `commands`                          | Command to be included in the container.                                                                                                                       |
 | `basePackages`                      | Names of base packages.                                                                                                                                        |
 | `baseImage`                         | Base image for the final stage of multi-stage builds (for Conda/Pixi).                                                                                        |
-| `pixiOpts`                          | Pixi build options (when type is CONDA and buildTemplate is `pixi/v1`).                                                                                        |
+| `pixiOpts`                          | Pixi build options (when type is CONDA and buildTemplate is `conda-pixi/v1`).                                                                                  |
 | `pixiImage`                         | Name of the Docker image used for Pixi package manager (e.g., `ghcr.io/prefix-dev/pixi:latest`).                                                              |
 | `cranOpts`                          | CRAN build options (when type is CRAN).                                                                                                                        |
 | `rImage`                            | Name of the R Docker image used to build CRAN containers (e.g., `rocker/r-ver:4.4.1`).                                                                         |
-| `buildTemplate`                     | The build template to use for container builds. Supported values: `pixi/v1` (Pixi with multi-stage builds), `micromamba/v2` (Micromamba 2.x with multi-stage builds). Default: standard conda/micromamba v1 template. |
+| `buildTemplate`                     | The build template to use for container builds. Supported values: `conda-pixi/v1` (Pixi with multi-stage builds), `conda-micromamba/v2` (Micromamba 2.x with multi-stage builds). Default: standard conda/micromamba v1 template. |
 | `nameStrategy`                      | The name strategy to be used to create the name of the container built by Wave. Its values can be `none`, `tagPrefix`, or `imageSuffix`.                       |                                                     |
 
 ### Response
@@ -376,13 +376,13 @@ curl --location 'https://wave.seqera.io/v1alpha2/container' \
 --data '{
     "containerPlatform": "linux/amd64",
     "format": "docker",
-    "buildTemplate": "pixi/v1",
+    "buildTemplate": "conda-pixi/v1",
     "packages":{
         "type": "CONDA",
         "entries": ["numpy", "pandas", "scikit-learn"],
         "channels": ["conda-forge"],
         "pixiOpts": {
-            "pixiImage": "ghcr.io/prefix-dev/pixi:latest",
+            "pixiImage": "ghcr.io/prefix-dev/pixi:0.59.0-noble",
             "basePackages": "conda-forge::procps-ng",
             "baseImage": "ubuntu:24.04",
             "commands": []
@@ -418,7 +418,7 @@ curl --location 'https://wave.seqera.io/v1alpha2/container' \
 --data '{
     "containerPlatform": "linux/amd64",
     "format": "docker",
-    "buildTemplate": "micromamba/v2",
+    "buildTemplate": "conda-micromamba/v2",
     "packages":{
         "type": "CONDA",
         "entries": ["bwa=0.7.15", "salmon=1.10.0", "samtools=1.17"],
@@ -460,13 +460,13 @@ curl --location 'https://wave.seqera.io/v1alpha2/container' \
 --data '{
     "containerPlatform": "linux/amd64",
     "format": "sif",
-    "buildTemplate": "pixi/v1",
+    "buildTemplate": "conda-pixi/v1",
     "packages":{
         "type": "CONDA",
         "entries": ["numpy", "pandas", "scikit-learn"],
         "channels": ["conda-forge"],
         "pixiOpts": {
-            "pixiImage": "ghcr.io/prefix-dev/pixi:latest",
+            "pixiImage": "ghcr.io/prefix-dev/pixi:0.59.0-noble",
             "basePackages": "conda-forge::procps-ng",
             "baseImage": "ubuntu:24.04",
             "commands": []
@@ -502,7 +502,7 @@ curl --location 'https://wave.seqera.io/v1alpha2/container' \
 --data '{
     "containerPlatform": "linux/amd64",
     "format": "sif",
-    "buildTemplate": "micromamba/v2",
+    "buildTemplate": "conda-micromamba/v2",
     "packages":{
         "type": "CONDA",
         "entries": ["bwa=0.7.15", "salmon=1.10.0", "samtools=1.17"],
@@ -535,7 +535,7 @@ curl --location 'https://wave.seqera.io/v1alpha2/container' \
 ```
 
 :::note
-Multi-stage build templates (`pixi/v1` and `micromamba/v2`) create optimized container images by separating the build environment from the final runtime environment. This results in smaller container images that only contain the installed packages and runtime dependencies, without the build tools.
+Multi-stage build templates (`conda-pixi/v1` and `conda-micromamba/v2`) create optimized container images by separating the build environment from the final runtime environment. This results in smaller container images that only contain the installed packages and runtime dependencies, without the build tools.
 :::
 
 ## GET `/v1alpha1/builds/{buildId}/status`

typespec/models/ContainerRequest.tsp

@@ -33,13 +33,13 @@ import "./ScanLevel.tsp";
             entries: #["numpy", "pandas"],
             channels: #["conda-forge"],
             pixiOpts: #{
-                pixiImage: "ghcr.io/prefix-dev/pixi:latest",
+                pixiImage: "ghcr.io/prefix-dev/pixi:0.59.0-noble",
                 basePackages: "conda-forge::procps-ng",
                 baseImage: "ubuntu:24.04",
                 commands: #[]
             }
         },
-        buildTemplate: "pixi/v1",
+        buildTemplate: "conda-pixi/v1",
         format: "docker",
         containerPlatform:"linux/amd64"
 })
@@ -55,7 +55,7 @@ import "./ScanLevel.tsp";
                 commands: #[]
             }
         },
-        buildTemplate: "micromamba/v2",
+        buildTemplate: "conda-micromamba/v2",
         format: "docker",
         containerPlatform:"linux/amd64"
 })
@@ -101,6 +101,6 @@ model ContainerRequest {
   towerWorkspaceId?: int64;
   @doc("ID of the Seqera Platform workspace from which this container request originates (optional).")
   workflowId?: string;
-  @doc("The build template that should be used to build the container image. Supported templates:\n- 'pixi/v1': Uses Pixi package manager for modern, reproducible conda environments with multi-stage builds\n- 'micromamba/v2': Uses Micromamba 2.x with multi-stage builds for optimized conda environments\n- Default: Uses standard conda/micromamba v1 template when not specified")
+  @doc("The build template that should be used to build the container image. Supported templates:\n- 'conda-pixi/v1': Uses Pixi package manager for modern, reproducible conda environments with multi-stage builds\n- 'conda-micromamba/v2': Uses Micromamba 2.x with multi-stage builds for optimized conda environments\n- Default: Uses standard conda/micromamba v1 template when not specified")
   buildTemplate?: string;
 }