feat: add multi-language hook support (Phase 1 — Python)

cli/azd/.gitignore

@@ -10,6 +10,7 @@ azd.sln
 **/target
 
 # Coverage artifacts (generated by mage coverage:* targets)
+cover
 cover-local.out
 cover-ci-combined.out
 coverage.html

cli/azd/.vscode/cspell.yaml

@@ -262,6 +262,11 @@ overrides:
       - println
       - myext
       - Fatalf
+  - filename: extensions/microsoft.azd.ai.builder/internal/cmd/start.go
+    words:
+      - dall
+      - datasource
+      - vectorizing
   - filename: pkg/project/dockerfile_builder.go
     words:
       - WORKDIR
@@ -307,6 +312,12 @@ overrides:
   - filename: pkg/extensions/manager.go
     words:
       - myext
+  - filename: extensions/microsoft.azd.extensions/internal/resources/languages/**/.gitignore
+    words:
+      - rsuser
+      - userosscache
+      - docstates
+      - dylib
   - filename: docs/recording-functional-tests-guide.md
     words:
       - httptest
@@ -342,18 +353,36 @@ overrides:
     words:
       - WORKDIR
       - workdir
+  - filename: extensions/microsoft.azd.demo/internal/cmd/metadata.go
+    words:
+      - invopop
+  - filename: extensions/microsoft.azd.concurx/internal/cmd/prompt_model.go
+    words:
+      - textinput
   - filename: pkg/azdext/scope_detector.go
     words:
       - fakeazure
   - filename: "{pkg/azapi/permissions.go,pkg/infra/provisioning/bicep/bicep_provider.go}"
     words:
       - ABAC
+  - filename: extensions/azure.ai.models/internal/cmd/custom_create.go
+    words:
+      - Qwen
   - filename: pkg/infra/provisioning/bicep/local_preflight.go
     words:
       - actioned
   - filename: pkg/project/project.go
     words:
       - copylocks
+  - filename: pkg/ext/models.go
+    words:
+      - unvalidated
+      - venvs
+      - workdir
+  - filename: docs/code-coverage-guide.md
+    words:
+      - covdata
+      - GOWORK
 ignorePaths:
   - "**/*_test.go"
   - "**/mock*.go"

cli/azd/cmd/container.go

@@ -67,14 +67,17 @@ import (
 	"github.com/azure/azure-dev/cli/azd/pkg/state"
 	"github.com/azure/azure-dev/cli/azd/pkg/templates"
 	"github.com/azure/azure-dev/cli/azd/pkg/tools/az"
+	"github.com/azure/azure-dev/cli/azd/pkg/tools/bash"
 	"github.com/azure/azure-dev/cli/azd/pkg/tools/docker"
 	"github.com/azure/azure-dev/cli/azd/pkg/tools/dotnet"
 	"github.com/azure/azure-dev/cli/azd/pkg/tools/git"
 	"github.com/azure/azure-dev/cli/azd/pkg/tools/github"
 	"github.com/azure/azure-dev/cli/azd/pkg/tools/javac"
 	"github.com/azure/azure-dev/cli/azd/pkg/tools/kubectl"
+	"github.com/azure/azure-dev/cli/azd/pkg/tools/language"
 	"github.com/azure/azure-dev/cli/azd/pkg/tools/maven"
 	"github.com/azure/azure-dev/cli/azd/pkg/tools/node"
+	"github.com/azure/azure-dev/cli/azd/pkg/tools/powershell"
 	"github.com/azure/azure-dev/cli/azd/pkg/tools/python"
 	"github.com/azure/azure-dev/cli/azd/pkg/tools/swa"
 	"github.com/azure/azure-dev/cli/azd/pkg/workflow"
@@ -811,6 +814,18 @@ func registerCommonDependencies(container *ioc.NestedContainer) {
 
 	container.MustRegisterNamedScoped(string(project.ServiceLanguageDocker), project.NewDockerProjectAsFrameworkService)
 
+	// Hook executors registered by language name (transient — fresh per hook invocation).
+	// The HooksRunner resolves these via serviceLocator.ResolveNamed().
+	hookExecutorMap := map[language.HookKind]any{
+		language.HookKindBash:       bash.NewExecutor,
+		language.HookKindPowerShell: powershell.NewExecutor,
+		language.HookKindPython:     language.NewPythonExecutor,
+	}
+
+	for kind, constructor := range hookExecutorMap {
+		container.MustRegisterNamedTransient(string(kind), constructor)
+	}
+
 	// Pipelines
 	container.MustRegisterScoped(pipeline.NewPipelineManager)
 	container.MustRegisterSingleton(func(flags *pipelineConfigFlags) *pipeline.PipelineManagerArgs {

cli/azd/cmd/hooks.go

@@ -337,7 +337,7 @@ func (hra *hooksRunAction) execHook(
 		hooksManager, hra.commandRunner, hra.envManager, hra.console, cwd, hooksMap, hra.env, hra.serviceLocator)
 
 	// Always run in interactive mode for 'azd hooks run', to help with testing/debugging
-	runOptions := &tools.ExecOptions{
+	runOptions := &tools.ExecutionContext{
 		Interactive: new(true),
 	}
 

cli/azd/cmd/hooks_test.go

@@ -16,14 +16,22 @@ import (
 	"github.com/azure/azure-dev/cli/azd/pkg/ext"
 	"github.com/azure/azure-dev/cli/azd/pkg/infra/provisioning"
 	"github.com/azure/azure-dev/cli/azd/pkg/project"
+	"github.com/azure/azure-dev/cli/azd/pkg/tools/language"
 	"github.com/azure/azure-dev/cli/azd/test/mocks"
 	"github.com/azure/azure-dev/cli/azd/test/mocks/mockenv"
+	"github.com/azure/azure-dev/cli/azd/test/mocks/mocktools"
 	"github.com/stretchr/testify/mock"
 	"github.com/stretchr/testify/require"
 )
 
+// registerHookExecutors delegates to the shared test helper in test/mocks/mocktools.
+func registerHookExecutors(mockCtx *mocks.MockContext) {
+	mocktools.RegisterHookExecutors(mockCtx)
+}
+
 func Test_HooksRunAction_RunsLayerHooks(t *testing.T) {
 	mockContext := mocks.NewMockContext(context.Background())
+	registerHookExecutors(mockContext)
 	env := environment.NewWithValues("test", nil)
 	envManager := &mockenv.MockEnvManager{}
 	envManager.On("Reload", mock.Anything, mock.Anything).Return(nil)
@@ -42,7 +50,7 @@ func Test_HooksRunAction_RunsLayerHooks(t *testing.T) {
 					Path: "infra/core",
 					Hooks: provisioning.HooksConfig{
 						"preprovision": {{
-							Shell: ext.ShellTypeBash,
+							Shell: string(language.HookKindBash),
 							Run:   "echo core",
 						}},
 					},
@@ -52,7 +60,7 @@ func Test_HooksRunAction_RunsLayerHooks(t *testing.T) {
 					Path: absoluteLayerPath,
 					Hooks: provisioning.HooksConfig{
 						"preprovision": {{
-							Shell: ext.ShellTypeBash,
+							Shell: string(language.HookKindBash),
 							Run:   "echo shared",
 						}},
 					},
@@ -92,6 +100,7 @@ func Test_HooksRunAction_RunsLayerHooks(t *testing.T) {
 
 func Test_HooksRunAction_FiltersLayerHooks(t *testing.T) {
 	mockContext := mocks.NewMockContext(context.Background())
+	registerHookExecutors(mockContext)
 	env := environment.NewWithValues("test", nil)
 	envManager := &mockenv.MockEnvManager{}
 	envManager.On("Reload", mock.Anything, mock.Anything).Return(nil)
@@ -109,7 +118,7 @@ func Test_HooksRunAction_FiltersLayerHooks(t *testing.T) {
 					Path: "infra/core",
 					Hooks: provisioning.HooksConfig{
 						"preprovision": {{
-							Shell: ext.ShellTypeBash,
+							Shell: string(language.HookKindBash),
 							Run:   "echo core",
 						}},
 					},
@@ -119,7 +128,7 @@ func Test_HooksRunAction_FiltersLayerHooks(t *testing.T) {
 					Path: "infra/shared",
 					Hooks: provisioning.HooksConfig{
 						"preprovision": {{
-							Shell: ext.ShellTypeBash,
+							Shell: string(language.HookKindBash),
 							Run:   "echo shared",
 						}},
 					},
@@ -158,6 +167,7 @@ func Test_HooksRunAction_FiltersLayerHooks(t *testing.T) {
 
 func Test_HooksRunAction_SetsTelemetryTypeForLayer(t *testing.T) {
 	mockContext := mocks.NewMockContext(context.Background())
+	registerHookExecutors(mockContext)
 	env := environment.NewWithValues("test", nil)
 	envManager := &mockenv.MockEnvManager{}
 	envManager.On("Reload", mock.Anything, mock.Anything).Return(nil)
@@ -178,7 +188,7 @@ func Test_HooksRunAction_SetsTelemetryTypeForLayer(t *testing.T) {
 					Path: "infra/core",
 					Hooks: provisioning.HooksConfig{
 						"preprovision": {{
-							Shell: ext.ShellTypeBash,
+							Shell: string(language.HookKindBash),
 							Run:   "echo core",
 						}},
 					},
@@ -272,5 +282,6 @@ func Test_HooksRunAction_ValidatesLayerHooksRelativeToLayerPath(t *testing.T) {
 	err := action.validateAndWarnHooks(*mockContext.Context)
 	require.NoError(t, err)
 	require.False(t, layerHook.IsUsingDefaultShell())
-	require.Equal(t, ext.ScriptTypeUnknown, layerHook.Shell)
+	// validate() infers language from the .sh file extension
+	require.Equal(t, language.HookKindBash, layerHook.Kind)
 }