Function NewTrialCommand

pkg/cli/trial_command.go:11–131

NewTrialCommand creates the trial command

(validateEngine func(string) error)

// NewTrialCommand creates the trial command
func NewTrialCommand(validateEngine func(string) error) *cobra.Command {
	cmd := &cobra.Command{
		Use:   "trial <workflow-spec>...",
		Short: "Run one or more agentic workflows in trial mode against a simulated repository",
		Long: `Run one or more agentic workflows in trial mode against a simulated repository.

This command creates a temporary private repository in your GitHub account, installs the specified
workflow(s) from their source repositories, and runs them in "trial mode" to capture safe outputs without
making actual changes to the "simulated" host repository.

Repository modes:
- Default mode (no flags): Creates a temporary trial repository and simulates execution as if running against the current repository (github.repository context points to current repo)
- --logical-repo REPO: Simulates execution against a specified repository (github.repository context points to REPO while actually running in a temporary trial repository)
- --host-repo REPO: Uses the specified repository as the host for trial execution instead of creating a temporary one
- --clone-repo REPO: Clones the specified repository's contents into the trial repository before execution (useful for testing against actual repository state)

All workflows must support workflow_dispatch trigger to be used in trial mode.
The host repository will be created as private and kept by default unless --delete-host-repo-after is specified.
Trial results are saved both locally (in trials/ directory) and in the host repository for future reference.`,
		Example: `  ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/weekly-research                         # Run a single workflow in a temporary trial repository
  ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/daily-plan githubnext/agentics/weekly-research # Compare multiple workflows
  ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/daily-plan myorg/myrepo/custom-workflow # Run workflows from different repositories
  ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --host-repo myorg/myrepo    # Use an existing host repository
  ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --logical-repo myorg/myrepo # Simulate a different github.repository value
  ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --clone-repo myorg/myrepo   # Clone repository contents into the trial host
  ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --repeat 3                  # Run 4 times total (1 initial + 3 repeats)
  ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --delete-host-repo-after    # Delete the trial host repository when done
  ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --dry-run                   # Preview changes without executing
  ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --json                      # Output trial results in JSON format
  ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --auto-merge-prs            # Auto-merge PRs created during the trial
  ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --host-repo .               # Use the current repository as the host
  ` + string(constants.CLIExtensionPrefix) + ` trial ./local-workflow.md --clone-repo upstream/repo --repeat 2   # Run a local workflow against cloned contents
  ` + string(constants.CLIExtensionPrefix) + ` trial githubnext/agentics/my-workflow --trigger-context https://github.com/owner/repo/issues/123 # Provide issue context for issue-triggered workflows
`,
		Args: func(cmd *cobra.Command, args []string) error {
			if len(args) < 1 {
				return fmt.Errorf("missing workflow specification\n\nUsage:\n  %s <workflow-spec>...\n\nExample:\n  %[1]s githubnext/agentics/daily-plan             Trial a workflow from a repository\n  %[1]s ./local-workflow.md                         Trial a local workflow\n\nRun '%[1]s --help' for more information", cmd.CommandPath())
			}
			return nil
		},
		RunE: func(cmd *cobra.Command, args []string) error {
			workflowSpecs := args
			trialLog.Printf("Trial command invoked: workflow_count=%d", len(workflowSpecs))
			logicalRepoSpec, _ := cmd.Flags().GetString("logical-repo")
			cloneRepoSpec, _ := cmd.Flags().GetString("clone-repo")
			hostRepoSpec, _ := cmd.Flags().GetString("host-repo")
			deleteHostRepo, _ := cmd.Flags().GetBool("delete-host-repo-after")
			forceDeleteHostRepo, _ := cmd.Flags().GetBool("force-delete-host-repo-before")
			yes, _ := cmd.Flags().GetBool("yes")
			dryRun, _ := cmd.Flags().GetBool("dry-run")
			jsonOutput, _ := cmd.Flags().GetBool("json")
			timeout, _ := cmd.Flags().GetInt("timeout")
			triggerContext, _ := cmd.Flags().GetString("trigger-context")
			repeatCount, _ := cmd.Flags().GetInt("repeat")
			autoMergePRs, _ := cmd.Flags().GetBool("auto-merge-prs")
			engineOverride, _ := cmd.Flags().GetString("engine")
			appendText, _ := cmd.Flags().GetString("append")
			verbose, _ := cmd.Root().PersistentFlags().GetBool("verbose")