tools

type ErrSemver struct {
	ToolName    string
	VersionInfo VersionInfo
}

type ExecutionContext struct {
	// Cwd is the working directory for execution.
	Cwd string

	// EnvVars is the merged environment for the process, including
	// resolved secrets and the azd environment.
	EnvVars []string

	// BoundaryDir is the project or service root directory.
	// Executors may walk upward from the script to BoundaryDir
	// to discover dependency files (requirements.txt, package.json).
	BoundaryDir string

	// Interactive controls whether stdin is attached.
	Interactive *bool

	// StdOut overrides the default stdout for the process.
	StdOut io.Writer

	// InlineScript contains the raw script content for inline hooks.
	// When set, the executor creates a temp file in Prepare() with
	// the appropriate extension and content wrapper (e.g., shebang
	// for bash). When empty, scriptPath is used directly as a file
	// path.
	InlineScript string

	// HookName is the descriptive name of the hook (e.g.,
	// "preprovision"). Used by executors for temp file naming to
	// aid debuggability.
	HookName string
}

type ExternalTool interface {
	CheckInstalled(ctx context.Context) error
	InstallUrl() string
	Name() string
}

type HookExecutor interface {
	// Prepare performs pre-execution setup such as runtime validation,
	// virtual environment creation, dependency installation, or temp
	// file creation for inline scripts.
	Prepare(ctx context.Context, scriptPath string, execCtx ExecutionContext) error

	// Execute runs the hook at the given path.
	Execute(ctx context.Context, scriptPath string, execCtx ExecutionContext) (exec.RunResult, error)

	// Cleanup removes any temporary resources created during Prepare.
	// Called by the hooks runner after Execute completes, regardless
	// of success or failure. Implementations must be safe to call
	// even when Prepare was not called or created no resources.
	Cleanup(ctx context.Context) error
}

type MissingToolErrors struct {
	Errs      []error
	ToolNames []string
}

type VersionInfo struct {
	MinimumVersion semver.Version
	UpdateCommand  string
}