Function IsRunnable

pkg/cli/run_workflow_validation.go:34–83

IsRunnable checks if a workflow can be run (has schedule or workflow_dispatch trigger) This function checks the compiled .lock.yml file because that's what GitHub Actions uses.

(markdownPath string)

// IsRunnable checks if a workflow can be run (has schedule or workflow_dispatch trigger)
// This function checks the compiled .lock.yml file because that's what GitHub Actions uses.
func IsRunnable(markdownPath string) (bool, error) {
	// Convert markdown path to lock file path
	lockPath := getLockFilePath(markdownPath)
	cleanLockPath := filepath.Clean(lockPath)

	validationLog.Printf("Checking if workflow is runnable: markdown=%s, lock=%s", markdownPath, lockPath)

	// Check if the lock file exists
	if _, err := os.Stat(cleanLockPath); os.IsNotExist(err) {
		validationLog.Printf("Lock file does not exist: %s", cleanLockPath)
		return false, errors.New("workflow has not been compiled yet - run 'gh aw compile' first")
	}

	// Read the lock file - path is sanitized using filepath.Clean() to prevent path traversal attacks.
	// The lockPath is derived from markdownPath which comes from trusted sources (CLI arguments, validated workflow paths).
	contentBytes, err := os.ReadFile(cleanLockPath) // #nosec G304 -- path is sanitized with filepath.Clean() and derived from trusted CLI argument
	if err != nil {
		return false, fmt.Errorf("failed to read lock file: %w", err)
	}

	// Parse the YAML content
	var workflowYAML map[string]any
	if err := yaml.Unmarshal(contentBytes, &workflowYAML); err != nil {
		return false, fmt.Errorf("failed to parse lock file YAML: %w", err)
	}

	// Check if 'on' section is present
	onSection, exists := workflowYAML["on"]
	if !exists {
		validationLog.Printf("No 'on' section found in lock file")
		// If no 'on' section, it's not runnable
		return false, nil
	}

	// Convert to map if possible
	onMap, ok := onSection.(map[string]any)
	if !ok {
		// If 'on' is not a map, check if it's a string/list that might indicate workflow_dispatch
		onStr := fmt.Sprintf("%v", onSection)
		onStrLower := strings.ToLower(onStr)
		hasWorkflowDispatch := strings.Contains(onStrLower, "workflow_dispatch")
		validationLog.Printf("On section is not a map, checking string: hasWorkflowDispatch=%v", hasWorkflowDispatch)
		return hasWorkflowDispatch, nil
	}

	// Check if workflow_dispatch trigger exists
	_, hasWorkflowDispatch := onMap["workflow_dispatch"]
	validationLog.Printf("Workflow runnable check: hasWorkflowDispatch=%v", hasWorkflowDispatch)
	return hasWorkflowDispatch, nil
}

// getWorkflowInputs extracts workflow_dispatch inputs from the compiled lock file
// This function checks the .lock.yml file because that's what GitHub Actions uses.