package workflow

import "strings"

// Command names the host-specific invocation forms for one DevRites workflow step.
// The engine must not bake Claude slash commands into its decisions: Claude Code
// uses /rite-*, while Codex uses $rite-* skills. Keep the verb as the canonical
// key and render host forms only at the edge.
type Command struct {
	Verb   string
	Claude string
	Codex  string
	Skill  string
}

// ForVerb returns native invocation forms for a public rite verb. The empty
// verb returns an empty command so callers can omit suggestions safely.
func ForVerb(verb string) Command {
	verb = strings.TrimSpace(strings.TrimPrefix(strings.TrimPrefix(verb, "/"), "$"))
	verb = strings.TrimPrefix(verb, "skill:")
	verb = strings.TrimPrefix(verb, "rite-")
	if verb == "" {
		return Command{}
	}
	name := "rite-" + verb
	return Command{Verb: verb, Claude: "/" + name, Codex: "$" + name, Skill: "/skill:" + name}
}

// ForAction extracts the first explicit rite invocation from a cursor action.
// Cursor values may append a short reason after the command.
func ForAction(action string) Command {
	for _, field := range strings.Fields(action) {
		field = strings.Trim(field, "`'\"()[]{}<>,.;:")
		if strings.HasPrefix(field, "/rite-") || strings.HasPrefix(field, "$rite-") || strings.HasPrefix(field, "/skill:rite-") {
			return ForVerb(field)
		}
	}
	return Command{}
}

// SourceIsFirstArgument distinguishes workspace slugs from phase-local
// slice/mode/scope/target arguments. Plan's optional source follows its mode.
func (c Command) SourceIsFirstArgument() bool {
	switch c.Verb {
	case "", "build", "plan", "review", "polish":
		return false
	default:
		return true
	}
}

// SourceInvocation renders an executable cursor command, never display prose.
// Commands without a slug argument retain the caller's selected SOURCE.
func (c Command) SourceInvocation(source string) string {
	if source != "" && c.SourceIsFirstArgument() {
		return c.Claude + " " + source
	}
	return c.Claude
}

// Both renders a command in host-neutral prose for engine stderr/stdout messages.
func (c Command) Both() string {
	if c.Verb == "" {
		return ""
	}
	return c.Claude + " (Claude) / " + c.Codex + " (Codex)"
}