Method GetInstallationSteps

pkg/workflow/pi_engine.go:211–256

GetInstallationSteps returns the GitHub Actions steps needed to install the Pi CLI. If engine.extensions is configured, additional `pi install ` steps are emitted after the main CLI install step.

(workflowData *WorkflowData)

// If engine.extensions is configured, additional `pi install <extension>` steps are emitted
// after the main CLI install step.
func (e *PiEngine) GetInstallationSteps(workflowData *WorkflowData) []GitHubActionStep {
	piLog.Printf("Generating installation steps for Pi engine: workflow=%s", workflowData.Name)

	if workflowData.EngineConfig != nil && workflowData.EngineConfig.Command != "" {
		piLog.Printf("Skipping installation steps: custom command specified (%s)", workflowData.EngineConfig.Command)
		return []GitHubActionStep{}
	}

	version := string(constants.DefaultPiVersion)
	if workflowData.EngineConfig != nil && workflowData.EngineConfig.Version != "" {
		version = workflowData.EngineConfig.Version
	}

	npmSteps := GenerateNpmInstallSteps(
		"@earendil-works/pi-coding-agent",
		version,
		"Install Pi CLI",
		"pi",
		true,  // Include Node.js setup
		false, // Engine CLI installs must never run install scripts
		false, // Pi installs should not apply the default npm release-age cooldown
	)

	steps := BuildNpmEngineInstallStepsWithAWF(npmSteps, workflowData)

	// Install extensions declared in engine.extensions: [...]
	// Each extension is installed via `pi install <extension>` before the agent runs.
	if workflowData.EngineConfig != nil && len(workflowData.EngineConfig.Extensions) > 0 {
		commandName := "pi"
		if workflowData.EngineConfig.Command != "" {
			commandName = workflowData.EngineConfig.Command
		}

		for _, ext := range workflowData.EngineConfig.Extensions {
			installCmd := fmt.Sprintf("%s install %s", commandName, shellEscapeArg(ext))
			stepLines := []string{
				"      - name: Install Pi extension " + ext,
			}
			stepLines = FormatStepWithCommandAndEnv(stepLines, installCmd, nil)
			steps = append(steps, GitHubActionStep(stepLines))
		}
		piLog.Printf("Added %d Pi extension install steps", len(workflowData.EngineConfig.Extensions))
	}

	return steps
}

// GetDeclaredOutputFiles returns the output files that Pi may produce.
// The streaming JSONL log is the primary artifact for post-run analysis.