Function TestResolveIncludePath_DotGithubRepo

pkg/parser/frontmatter_utils_test.go:244–332

TestResolveIncludePath_DotGithubRepo tests import path resolution when the repository itself is named ".github" (e.g. an org's `org/.github` repository). In that case the on-disk layout is /.github/.github/workflows/ and the traversal logic must correctly treat the inner ".github" directory

(t *testing.T)

// correctly treat the inner ".github" directory as the special folder and
// <parent>/.github/ as the repository root.
func TestResolveIncludePath_DotGithubRepo(t *testing.T) {
	tempDir, err := os.MkdirTemp("", "test_resolve_dotgithub_repo")
	require.NoError(t, err, "should create temp dir")
	defer os.RemoveAll(tempDir)

	// Simulate a repo whose name is ".github": the repo root is <tempDir>/.github
	// and the GitHub Actions folder lives at <tempDir>/.github/.github/workflows/.
	dotGithubRepoRoot := filepath.Join(tempDir, ".github")
	workflowsDir := filepath.Join(dotGithubRepoRoot, ".github", "workflows")
	agentsDir := filepath.Join(dotGithubRepoRoot, ".github", "agents")
	dotAgentsDir := filepath.Join(dotGithubRepoRoot, ".agents")

	for _, dir := range []string{workflowsDir, agentsDir, dotAgentsDir} {
		require.NoError(t, os.MkdirAll(dir, 0755), "should create dir %s", dir)
	}

	workflowFile := filepath.Join(workflowsDir, "workflow.md")
	agentFile := filepath.Join(agentsDir, "planner.md")
	dotAgentFile := filepath.Join(dotAgentsDir, "agent.md")

	require.NoError(t, os.WriteFile(workflowFile, []byte("workflow"), 0644), "should write workflow file")
	require.NoError(t, os.WriteFile(agentFile, []byte("planner"), 0644), "should write agent file")
	require.NoError(t, os.WriteFile(dotAgentFile, []byte("dot-agents"), 0644), "should write .agents file")

	tests := []struct {
		name     string
		filePath string
		baseDir  string
		expected string
		wantErr  bool
	}{
		{
			name:     "relative path still resolves within workflows dir",
			filePath: "workflow.md",
			baseDir:  workflowsDir,
			expected: workflowFile,
		},
		{
			name:     "dotgithub-prefixed path resolves from repo root inside .github repo",
			filePath: ".github/agents/planner.md",
			baseDir:  workflowsDir,
			expected: agentFile,
		},
		{
			name:     "slash-dotgithub-prefixed path resolves from repo root inside .github repo",
			filePath: "/.github/agents/planner.md",
			baseDir:  workflowsDir,
			expected: agentFile,
		},
		{
			name:     "slash-dotagents-prefixed path resolves from repo root inside .github repo",
			filePath: "/.agents/agent.md",
			baseDir:  workflowsDir,
			expected: dotAgentFile,
		},
		{
			name:     "slash-prefixed path outside .github or .agents is rejected inside .github repo",
			filePath: "/agents/agent.md",