Vela show fails to generate parameter on docs generation command for workflow definitions containing imports
Author: rohank2002Created Aug 4, 2025Updated Aug 19, 2026
Labelsarea/cuepriority/nice-to-have
Describe the bug Vela show docs command does not generate parameters from the definitions into the docs if the definition contains external cue packages.
To Reproduce Apply sample workflow definition to the cluster:
import (
"vela/kube"
)
testwf: {
alias: ""
annotations: {}
attributes: {}
description: ""
labels: {}
type: "workflow-step"
}
template: {
configMap: kube.#Read & {
$params: {
value: {
apiVersion: "v1"
kind: "ConfigMap"
metadata: {
name: "test"
namespace: context.namespace
}
}
}
} @step(1)
parameter: {
foo: string
}
}
Run the following command to generate the docs:
vela show testwf --format markdown
The markdown generated does not contain the description or any mention about the parameters. Removing the imports fixes the issue.
Expected behavior Vela show command should generate parameters table with description.
Version details CLI Version: 1.10.2 Core Version: 1.10.2 GitRevision: 424e433963551eac070b4369829c4c674fce7ff1 GolangVersion: go1.24.0
Source: kubevela/kubevela