fix create on stop and add warning

Author: mafredri

registry/coder-labs/modules/archive/README.md

@@ -118,6 +118,9 @@ module "archive" {
 - `extract_on_start` (bool, default: `false`): If true, the installer waits up to `extract_wait_timeout_seconds` for the archive path to appear and extracts it on start.
 - `extract_wait_timeout_seconds` (number, default: `5`): Timeout for `extract_on_start`.
 
+> [!WARNING]
+> The `create_on_stop` feature uses the `coder_script` `run_on_stop` which may not work as expected on certain templates without additional provider configuration. The agent may be terminated before the script completes. See [coder/coder#6174](https://github.com/coder/coder/issues/6174) for provider-specific workarounds and [coder/coder#6175](https://github.com/coder/coder/issues/6175) for tracking a fix.
+
 ## Outputs
 
 - `archive_path` (string): Full archive path computed as `output_dir/archive_name + extension`, where the extension comes from `compression`:

registry/coder-labs/modules/archive/scripts/archive-lib.sh

@@ -40,7 +40,7 @@ usage_archive_create() {
   load_defaults
 
   cat >&2 << USAGE
-Usage: coder-create-archive [OPTIONS] [[PATHS] ...]
+Usage: coder-archive-create [OPTIONS] [[PATHS] ...]
 Options:
   -c, --compression <gzip|zstd|none>   Compression algorithm (default "${DEFAULT_COMPRESSION}")
   -C, --directory <DIRECTORY>          Change to directory (default "${DEFAULT_DIRECTORY}")
@@ -148,7 +148,7 @@ usage_archive_extract() {
   load_defaults
 
   cat >&2 << USAGE
-Usage: coder-extract-archive [OPTIONS]
+Usage: coder-archive-extract [OPTIONS]
 Options:
   -c, --compression <gzip|zstd|none>   Compression algorithm (default "${DEFAULT_COMPRESSION}")
   -C, --directory <DIRECTORY>          Change to directory (default "${DEFAULT_DIRECTORY}")