Function fetchFrontmatterImportsRecursive

pkg/cli/includes.go:200–408

fetchFrontmatterImportsRecursive is the internal worker for fetchAndSaveRemoteFrontmatterImports. Parameters that change per recursion level: - content: the text of the file whose imports are being processed - currentBaseDir: directory of that file inside the source repo (used to resolve relative p

(content, currentBaseDir string, opts frontmatterImportsOpts)

//   - targetDir: the `.github/workflows` directory in the user's repo
//   - seen: shared visited set (keyed by fully-resolved remote path) — prevents cycles & duplicates
func fetchFrontmatterImportsRecursive(content, currentBaseDir string, opts frontmatterImportsOpts) {
	result, err := parser.ExtractFrontmatterFromContent(content)
	if err != nil || result.Frontmatter == nil {
		return
	}

	importsField, exists := result.Frontmatter["imports"]
	if !exists {
		return
	}

	var importPaths []string
	switch v := importsField.(type) {
	case []any:
		for _, item := range v {
			switch importItem := item.(type) {
			case string:
				importPaths = append(importPaths, importItem)
			case map[string]any:
				// Handle uses: and path: forms (mirrors GitHub Actions reusable workflow syntax)
				if usesVal, ok := importItem["uses"]; ok {
					if p, ok := usesVal.(string); ok {
						importPaths = append(importPaths, p)
					}
				} else if pathVal, ok := importItem["path"]; ok {
					if p, ok := pathVal.(string); ok {
						importPaths = append(importPaths, p)
					}
				}
			}
		}
	case []string:
		importPaths = v
	}

	if len(importPaths) == 0 {
		return
	}

	remoteWorkflowLog.Printf("Processing %d frontmatter imports recursively: owner=%s, repo=%s, ref=%s", len(importPaths), opts.owner, opts.repo, opts.ref)

	// Pre-compute the absolute target directory once for path-traversal boundary checks.
	absTargetDir, err := filepath.Abs(opts.targetDir)
	if err != nil {
		return
	}

	for _, importPath := range importPaths {
		// Skip workflowspec-format imports (already pinned to a remote ref)
		if isWorkflowSpecFormat(importPath) {
			continue
		}

		// Strip any section reference (file.md#Section → file.md)
		filePath := importPath
		if before, _, hasSec := strings.Cut(importPath, "#"); hasSec {
			filePath = before
		}