Function wrapDocInputFileErr

shortcuts/doc/doc_errors.go:27–34

wrapDocInputFileErr wraps a --file Stat/read failure via the shared typed helper (which sets the cause) and tags it with the --file param so agents learn which flag to fix. The common helper is flag-agnostic, so the param is attached here at the Doc call site rather than mutating shared behavior.

(err error, readMsg string)

// learn which flag to fix. The common helper is flag-agnostic, so the param is
// attached here at the Doc call site rather than mutating shared behavior.
func wrapDocInputFileErr(err error, readMsg string) error {
	wrapped := common.WrapInputStatErrorTyped(err, readMsg)
	var ve *errs.ValidationError
	if errors.As(wrapped, &ve) {
		ve.Param = "--file"
	}
	return wrapped
}