Function Build

internal/aiagentconfig/builder.go:35–85

Build reads discovered files and constructs the AI agent config payload. basePath is the base directory, discovered contains files relative to basePath with their kinds. agentName identifies the AI agent (e.g. "claude", "cursor"). gitCtx may be nil if not in a git repository.

(basePath string, discovered []DiscoveredFile, agentName string, gitCtx *GitContext)

// agentName identifies the AI agent (e.g. "claude", "cursor").
// gitCtx may be nil if not in a git repository.
func Build(basePath string, discovered []DiscoveredFile, agentName string, gitCtx *GitContext) (*Data, error) {
	// Resolve basePath to its real path so symlink comparisons are reliable
	realRoot, err := filepath.EvalSymlinks(basePath)
	if err != nil {
		return nil, fmt.Errorf("resolving root dir: %w", err)
	}

	configFiles := make([]ConfigFile, 0, len(discovered))
	hashes := make([]string, 0, len(discovered))
	// Collect raw content from settings.json files to avoid base64 round-trip during MCP extraction.
	var rawSettingsFiles []rawConfigContent

	for _, df := range discovered {
		relPath := df.Path
		absPath := filepath.Join(basePath, relPath)

		content, _, err := safeReadFile(absPath, realRoot)
		if err != nil {
			return nil, fmt.Errorf("%s: %w", relPath, err)
		}

		hash := sha256.Sum256(content)
		hexHash := hex.EncodeToString(hash[:])
		hashes = append(hashes, fmt.Sprintf("%s:%s", relPath, hexHash))

		configFiles = append(configFiles, ConfigFile{
			Path:    relPath,
			Kind:    df.Kind,
			SHA256:  hexHash,
			Size:    int64(len(content)),
			Content: base64.StdEncoding.EncodeToString(content),
		})

		// Keep raw bytes for settings.json files to avoid base64 round-trip
		if df.Kind == ConfigFileKindConfiguration && filepath.Base(relPath) == "settings.json" {
			rawSettingsFiles = append(rawSettingsFiles, rawConfigContent{path: relPath, content: content})
		}
	}

	mcpServers := extractMCPServers(realRoot, rawSettingsFiles)

	data := Data{
		Agent:       Agent{Name: agentName},
		ConfigHash:  computeCombinedHash(hashes),
		GitContext:  gitCtx,
		ConfigFiles: configFiles,
		MCPServers:  mcpServers,
	}

	return &data, nil
}

// rawConfigContent holds a file's raw bytes alongside its relative path,
// used to pass already-read content to MCP extraction without re-decoding.