Documentation shows /latest/ syntax but pkl rejects it

Problem

The official documentation shows this example:

amends "package://github.com/jdx/hk/releases/latest/hk#/Config.pkl"

However, when using this exact syntax, pkl returns an error:

–– Pkl Error ––
Module URI `package://github.com/jdx/hk/releases/latest/hk#/Builtins.pkl` has invalid syntax.

Invalid path `/jdx/hk/releases/latest/hk`.

A package URI must have its path suffixed by its version (e.g. `package://example.com/my/package@1.0.0`).

Environment

• hk version: 1.39.0
• pkl version: 0.31.0
• OS: macOS (Darwin 25.3.0)

Steps to Reproduce

1. Create test.pkl:

amends "package://github.com/jdx/hk/releases/latest/hk#/Config.pkl"
import "package://github.com/jdx/hk/releases/latest/hk#/Builtins.pkl"

local linters = new Mapping<String, Step> {}

hooks {
    ["pre-commit"] {
        fix = true
        steps = linters
    }
}

2. Run: pkl eval test.pkl
3. Observe error

Expected Behavior

The /latest/ syntax should work as documented, automatically resolving to the latest hk release version.

Actual Behavior

pkl rejects the URL format, requiring an explicit version like @1.39.0.

Impact

Users must hardcode the version in hk.pkl, which becomes stale when upgrading hk. This creates maintenance burden and potential compatibility issues.

Proposed Solutions

Either:

1. Fix pkl package resolution to support /latest/ for hk packages
2. Update documentation to clarify that version pinning is required
3. Provide a mechanism (e.g., hk init --update-version) to auto-update the version in existing hk.pkl files

Workaround

Currently, users must manually update the version in hk.pkl after upgrading hk:

# After: mise use hk@latest
sed -i.bak "s|/v[0-9.]*|/v$(hk --version | awk '{print $2}')|g" hk.pkl