Function ResolveWorkflowPath

pkg/cli/resolver.go:22–64

ResolveWorkflowPath resolves a workflow file path from various formats: - Absolute path to .md file - Relative path to .md file - Workflow name or subpath (e.g., "a.md" -> ".github/workflows/a.md", "shared/b.md" -> ".github/workflows/shared/b.md")

(workflowFile string)

// - Relative path to .md file
// - Workflow name or subpath (e.g., "a.md" -> ".github/workflows/a.md", "shared/b.md" -> ".github/workflows/shared/b.md")
func ResolveWorkflowPath(workflowFile string) (string, error) {
	resolverLog.Printf("Resolving workflow path: %s", workflowFile)
	workflowsDir := constants.GetWorkflowDir()

	// Add .md extension if not present
	searchPath := workflowFile
	if !strings.HasSuffix(searchPath, ".md") {
		searchPath += ".md"
	}

	// 1. If it's a path that exists as-is (absolute or relative), use it
	if _, err := os.Stat(searchPath); err == nil {
		resolverLog.Printf("Found workflow at direct path: %s", searchPath)
		return searchPath, nil
	}

	// 2. Try exact relative path under .github/workflows
	workflowPath := filepath.Join(workflowsDir, searchPath)
	if fileutil.FileExists(workflowPath) {
		resolverLog.Printf("Found workflow at: %s", workflowPath)
		return workflowPath, nil
	}

	// No matches found - suggest similar workflow names
	resolverLog.Printf("Workflow file not found: %s", workflowPath)

	suggestions := []string{
		fmt.Sprintf("Run '%s status' to see all available workflows", string(constants.CLIExtensionPrefix)),
		"Check for typos in the workflow name",
		"Ensure the workflow file exists in .github/workflows/",
	}

	// Add fuzzy match suggestions if available
	similarNames := suggestWorkflowNames(searchPath)
	if len(similarNames) > 0 {
		suggestions = append([]string{fmt.Sprintf("Did you mean: %s?", strings.Join(similarNames, ", "))}, suggestions...)
	}

	return "", errors.New(console.FormatErrorWithSuggestions(
		"workflow file not found: "+workflowPath,
		suggestions,
	))
}