{"record":{"id":"8f50ed4c6f0c2bd7","repo":"larksuite/cli","slug":"s-field-q-description-is-required","errorCode":null,"errorMessage":"%s field %q Description is required","messagePattern":"(.+?) field %q Description is required","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"shortcuts/common/typed_compile_data.go","lineNumber":311,"sourceCode":"\t\t\treturn fmt.Errorf(\"%s item lengths must be nonnegative\", path)\n\t\t}\n\t\tif value.MinItems != nil && value.MaxItems != nil && *value.MinItems > *value.MaxItems {\n\t\t\treturn fmt.Errorf(\"%s minItems exceeds maxItems\", path)\n\t\t}\n\t\treturn validateShape(value.Items, path+\".Items\")\n\tcase typedObjectShape:\n\t\tseen := make(map[string]struct{})\n\t\tfor i := range value.Fields {\n\t\t\tfield := &value.Fields[i]\n\t\t\tif field.Name == \"\" {\n\t\t\t\treturn fmt.Errorf(\"%s.Fields[%d].Name is required\", path, i)\n\t\t\t}\n\t\t\tif _, duplicate := seen[field.Name]; duplicate {\n\t\t\t\treturn fmt.Errorf(\"%s contains duplicate field %q\", path, field.Name)\n\t\t\t}\n\t\t\tseen[field.Name] = struct{}{}\n\t\t\tif strings.TrimSpace(field.Description) == \"\" {\n\t\t\t\treturn fmt.Errorf(\"%s field %q Description is required\", path, field.Name)\n\t\t\t}\n\t\t\tif err := validateShape(field.Shape, path+\"/\"+field.Name); err != nil {\n\t\t\t\treturn err\n\t\t\t}\n\t\t}\n\t\tif value.AdditionalPropertiesShape != nil && !value.AdditionalProperties {\n\t\t\treturn fmt.Errorf(\"%s AdditionalPropertiesShape requires AdditionalProperties\", path)\n\t\t}\n\t\tif value.AdditionalPropertiesShape != nil {\n\t\t\treturn validateShape(value.AdditionalPropertiesShape, path+\".AdditionalPropertiesShape\")\n\t\t}\n\tcase typedOneOfShape:\n\t\tif len(value.Variants) < 2 {\n\t\t\treturn fmt.Errorf(\"%s oneOf requires at least two variants\", path)\n\t\t}\n\t\tfor i, variant := range value.Variants {\n\t\t\tif err := validateShape(variant, fmt.Sprintf(\"%s.Variants[%d]\", path, i)); err != nil {\n\t\t\t\treturn err","sourceCodeStart":293,"sourceCodeEnd":329,"githubUrl":"https://github.com/larksuite/cli/blob/7fd6ef3c07182257ce776cdc5a614e122d5bd4b3/shortcuts/common/typed_compile_data.go#L293-L329","documentation":"Shape validation guard: a typed object field's Description is empty or whitespace-only; descriptions are required for generated schema/help quality.","triggerScenarios":"Thrown at shortcuts/common/typed_compile_data.go:311 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Add a Description to the field"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"7fd6ef3c07182257ce776cdc5a614e122d5bd4b3","analyzedAt":"2026-09-04T21:17:44.649Z","contentChangedAt":"2026-09-04T21:17:44.649Z","schemaVersion":2},"datasetVersion":"2026-09-12T02:17:10.037Z"}