Add debug logging to Copilot engine and include expansion (#12000)

Author: github-actions[bot]

pkg/parser/include_expander.go

@@ -73,11 +73,13 @@ func ExpandIncludesWithManifest(content, baseDir string, extractTools bool) (str
 
 // ExpandIncludesForEngines recursively expands @include and @import directives to extract engine configurations
 func ExpandIncludesForEngines(content, baseDir string) ([]string, error) {
+	log.Printf("Expanding includes for engines: baseDir=%s", baseDir)
 	return expandIncludesForField(content, baseDir, extractEngineFromContent, "")
 }
 
 // ExpandIncludesForSafeOutputs recursively expands @include and @import directives to extract safe-outputs configurations
 func ExpandIncludesForSafeOutputs(content, baseDir string) ([]string, error) {
+	log.Printf("Expanding includes for safe-outputs: baseDir=%s", baseDir)
 	return expandIncludesForField(content, baseDir, extractSafeOutputsFromContent, "{}")
 }
 
@@ -106,6 +108,7 @@ func expandIncludesForField(content, baseDir string, extractFunc func(string) (s
 		currentContent = processedContent
 	}
 
+	log.Printf("Field expansion complete: results=%d", len(results))
 	return results, nil
 }
 

pkg/workflow/copilot_engine.go

@@ -16,8 +16,11 @@ package workflow
 
 import (
 	"github.com/githubnext/gh-aw/pkg/constants"
+	"github.com/githubnext/gh-aw/pkg/logger"
 )
 
+var copilotLog = logger.New("workflow:copilot_engine")
+
 const logsFolder = "/tmp/gh-aw/sandbox/agent/logs/"
 
 // CopilotEngine represents the GitHub Copilot CLI agentic engine.
@@ -28,6 +31,7 @@ type CopilotEngine struct {
 }
 
 func NewCopilotEngine() *CopilotEngine {
+	copilotLog.Print("Creating new Copilot engine instance")
 	return &CopilotEngine{
 		BaseEngine: BaseEngine{
 			id:                     "copilot",
@@ -53,15 +57,18 @@ func (e *CopilotEngine) GetDefaultDetectionModel() string {
 // GetRequiredSecretNames returns the list of secrets required by the Copilot engine
 // This includes COPILOT_GITHUB_TOKEN and optionally MCP_GATEWAY_API_KEY
 func (e *CopilotEngine) GetRequiredSecretNames(workflowData *WorkflowData) []string {
+	copilotLog.Print("Collecting required secrets for Copilot engine")
 	secrets := []string{"COPILOT_GITHUB_TOKEN"}
 
 	// Add MCP gateway API key if MCP servers are present (gateway is always started with MCP servers)
 	if HasMCPServers(workflowData) {
+		copilotLog.Print("Adding MCP_GATEWAY_API_KEY secret")
 		secrets = append(secrets, "MCP_GATEWAY_API_KEY")
 	}
 
 	// Add GitHub token for GitHub MCP server if present
 	if hasGitHubTool(workflowData.ParsedTools) {
+		copilotLog.Print("Adding GITHUB_MCP_SERVER_TOKEN secret")
 		secrets = append(secrets, "GITHUB_MCP_SERVER_TOKEN")
 	}
 
@@ -70,15 +77,22 @@ func (e *CopilotEngine) GetRequiredSecretNames(workflowData *WorkflowData) []str
 	for varName := range headerSecrets {
 		secrets = append(secrets, varName)
 	}
+	if len(headerSecrets) > 0 {
+		copilotLog.Printf("Added %d HTTP MCP header secrets", len(headerSecrets))
+	}
 
 	// Add safe-inputs secret names
 	if IsSafeInputsEnabled(workflowData.SafeInputs, workflowData) {
 		safeInputsSecrets := collectSafeInputsSecrets(workflowData.SafeInputs)
 		for varName := range safeInputsSecrets {
 			secrets = append(secrets, varName)
 		}
+		if len(safeInputsSecrets) > 0 {
+			copilotLog.Printf("Added %d safe-inputs secrets", len(safeInputsSecrets))
+		}
 	}
 
+	copilotLog.Printf("Total required secrets: %d", len(secrets))
 	return secrets
 }