Function buildCacheMemoryPromptSection

pkg/workflow/cache.go:785–904

buildCacheMemoryPromptSection builds a PromptSection for cache memory instructions Returns a PromptSection that references a template file with substitutions, or nil if no cache is configured

(config *CacheMemoryConfig)

// buildCacheMemoryPromptSection builds a PromptSection for cache memory instructions
// Returns a PromptSection that references a template file with substitutions, or nil if no cache is configured
func buildCacheMemoryPromptSection(config *CacheMemoryConfig) *PromptSection {
	if config == nil || len(config.Caches) == 0 {
		return nil
	}

	// Check if there's only one cache with ID "default" to use singular template
	if len(config.Caches) == 1 && config.Caches[0].ID == "default" {
		cache := config.Caches[0]
		// Trailing slash makes the path look like a directory in prompt context.
		cacheDir := cacheMemoryDirFor(cache.ID) + "/"

		// Build description text
		descriptionText := ""
		if cache.Description != "" {
			descriptionText = cache.Description
		}

		// Build allowed extensions text.
		// When non-empty, add a compact plain-text restriction line.
		// When empty (all extensions allowed), the placeholder is replaced with nothing.
		var allowedExtsText string
		if len(cache.AllowedExtensions) > 0 {
			allowedExtsText = "\nAllowed file extensions: " + strings.Join(cache.AllowedExtensions, ", ") + "."
		}

		cacheLog.Printf("Building cache memory prompt section with env vars: cache_dir=%s, description=%s, allowed_extensions=%v", cacheDir, descriptionText, cache.AllowedExtensions)

		// Return prompt section with template file and environment variables for substitution
		return &PromptSection{
			Content: cacheMemoryPromptFile,
			IsFile:  true,
			EnvVars: map[string]string{
				"GH_AW_CACHE_DIR":          cacheDir,
				"GH_AW_CACHE_DESCRIPTION":  descriptionText,
				"GH_AW_ALLOWED_EXTENSIONS": allowedExtsText,
			},
		}
	}

	// Multiple caches or non-default single cache - use template file with substitutions
	cacheLog.Print("Building cache memory prompt section for multiple caches using template")

	// Build cache list
	var cacheList strings.Builder
	for _, cache := range config.Caches {
		// Trailing slash makes the path look like a directory in prompt context.
		cacheDir := cacheMemoryDirFor(cache.ID) + "/"
		if cache.Description != "" {
			fmt.Fprintf(&cacheList, "- **%s**: `%s` - %s\n", cache.ID, cacheDir, cache.Description)
		} else {
			fmt.Fprintf(&cacheList, "- **%s**: `%s`\n", cache.ID, cacheDir)
		}
	}

	// Build allowed extensions text.
	// Compute the union of all allowed extensions across all caches.
	// When non-empty, add a compact plain-text restriction line.
	// When empty (all extensions allowed for all caches), the placeholder is replaced with nothing.