Function parseContextInvocation

cli/plugins/builtin_context.go:415–448

parseContextInvocation accepts the {cmd, args} envelope, a flat object whose shape implies the subcommand, or ` --flag value` argv.

(args []string)

// parseContextInvocation accepts the {cmd, args} envelope, a flat object whose
// shape implies the subcommand, or `<sub> --flag value` argv.
func parseContextInvocation(args []string) (string, map[string]json.RawMessage, error) {
	payload := strings.TrimSpace(strings.Join(args, " "))
	if strings.HasPrefix(payload, "{") {
		var top map[string]json.RawMessage
		if err := json.Unmarshal([]byte(payload), &top); err != nil {
			return "", nil, fmt.Errorf("malformed JSON args: %w", err)
		}
		cmd := canonicalContextCmd(rawJSONString(top, "cmd", "command", "action"))
		inner := top
		if rargs, ok := top["args"]; ok && len(rargs) > 0 {
			var im map[string]json.RawMessage
			if err := json.Unmarshal(rargs, &im); err == nil {
				inner = im
			}
		}
		if cmd == "" {
			cmd = inferContextCmd(inner)
		}
		if cmd == "" {
			return "", nil, fmt.Errorf("missing or unknown cmd (valid: create|update|attach|detach|list|show|inspect|merge|status|export|import|delete|metrics)")
		}
		return cmd, inner, nil
	}

	// argv form: first token is the subcommand.
	if len(args) == 0 {
		return "", nil, fmt.Errorf("no subcommand")
	}
	cmd := canonicalContextCmd(strings.TrimSpace(args[0]))
	if cmd == "" {
		return "", nil, fmt.Errorf("unknown subcommand %q", args[0])
	}
	return cmd, contextArgvToMap(args[1:]), nil
}

// canonicalContextCmd normalizes subcommand aliases.
func canonicalContextCmd(s string) string {