Function addAgentFileWithTracking

pkg/cli/add_command.go:801–846

addAgentFileWithTracking installs a single agent file from a package to the agentic engine agents directory.

(resolved *ResolvedWorkflow, tracker *FileTracker, opts AddOptions, gitRoot string)

// addAgentFileWithTracking installs a single agent file from a package to the agentic engine
// agents directory.
func addAgentFileWithTracking(resolved *ResolvedWorkflow, tracker *FileTracker, opts AddOptions, gitRoot string) error {
	engineAgentsDir := workflow.GetEngineSubAgentDir(opts.EngineOverride)
	agentsDir := filepath.Join(gitRoot, engineAgentsDir)
	if err := os.MkdirAll(agentsDir, constants.DirPermPublic); err != nil {
		return fmt.Errorf("failed to create agents directory %s: %w", agentsDir, err)
	}

	fileName := filepath.Base(resolved.Spec.WorkflowPath)
	destFile := filepath.Join(agentsDir, fileName)

	addLog.Printf("Adding agent file: dest=%s, content_size=%d bytes", destFile, len(resolved.Content))

	if opts.Verbose {
		fmt.Fprintln(os.Stderr, console.FormatInfoMessage(fmt.Sprintf("Adding agent file to %s: %s", engineAgentsDir, fileName)))
	}

	fileExists := false
	if fileutil.FileExists(destFile) {
		fileExists = true
		if !opts.Force {
			if opts.Verbose {
				fmt.Fprintln(os.Stderr, console.FormatWarningMessage(fmt.Sprintf("Agent file '%s' already exists. Skipping.", destFile)))
			}
			return nil
		}
		fmt.Fprintln(os.Stderr, console.FormatInfoMessage("Overwriting existing agent file: "+destFile))
	}

	if tracker != nil {
		if fileExists {
			tracker.TrackModified(destFile)
		} else {
			tracker.TrackCreated(destFile)
		}
	}

	if err := os.WriteFile(destFile, resolved.Content, constants.FilePermPublic); err != nil {
		return fmt.Errorf("failed to write agent file '%s': %w", destFile, err)
	}

	if !opts.Quiet {
		fmt.Fprintln(os.Stderr, console.FormatSuccessMessage(fmt.Sprintf("Added agent file: %s/%s", engineAgentsDir, fileName)))
	}

	return nil
}

// printCompilationError formats and writes a compilation error to stderr.
// Redirect-only workflow errors are treated as informational messages rather than errors,