johno/gastown
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Add sparse checkout to exclude Claude context files from source repos

Browse Source 
Excludes all Claude Code context files to prevent source repo instructions
from interfering with Gas Town agent configuration:
- .claude/       : settings, rules, agents, commands
- CLAUDE.md      : primary context file
- CLAUDE.local.md: personal context file
- .mcp.json      : MCP server configuration

Legacy configurations (only excluding .claude/) are detected and upgraded
by gt doctor --fix.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
julianknutsen
2026-01-06 15:05:19 -08:00
parent fc4b9de02c
commit 81a7d04239
3 changed files with 370 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
internal/doctor/sparse_checkout_check.go
View File

@@ -4,13 +4,15 @@ import (
"fmt"
"os"
"path/filepath"
"strings"
"github.com/steveyegge/gastown/internal/git"
)
// SparseCheckoutCheck verifies that git clones/worktrees have sparse checkout configured
// to exclude .claude/ from source repos. This ensures source repo settings don't override
// Gas Town agent settings.
// to exclude Claude Code context files from source repos. This ensures source repo settings
// and instructions don't override Gas Town agent configuration.
// Excluded files: .claude/, CLAUDE.md, CLAUDE.local.md, .mcp.json
type SparseCheckoutCheck struct {
FixableCheck
rigPath string
@@ -23,7 +25,7 @@ func NewSparseCheckoutCheck() *SparseCheckoutCheck {
FixableCheck: FixableCheck{
BaseCheck: BaseCheck{
CheckName: "sparse-checkout",
CheckDescription: "Verify sparse checkout is configured to exclude .claude/",
CheckDescription: "Verify sparse checkout excludes Claude context files (.claude/, CLAUDE.md, etc.)",
},
},
}
@@ -84,7 +86,7 @@ func (c *SparseCheckoutCheck) Run(ctx *CheckContext) *CheckResult {
return &CheckResult{
Name: c.Name(),
Status: StatusOK,
Message: "All repos have sparse checkout configured to exclude .claude/",
Message: "All repos have sparse checkout configured to exclude Claude context files",
}
}
@@ -107,13 +109,22 @@ func (c *SparseCheckoutCheck) Run(ctx *CheckContext) *CheckResult {
}
}
// Fix configures sparse checkout for affected repos to exclude .claude/.
// Fix configures sparse checkout for affected repos to exclude Claude context files.
func (c *SparseCheckoutCheck) Fix(ctx *CheckContext) error {
for _, repoPath := range c.affectedRepos {
if err := git.ConfigureSparseCheckout(repoPath); err != nil {
relPath, _ := filepath.Rel(c.rigPath, repoPath)
return fmt.Errorf("failed to configure sparse checkout for %s: %w", relPath, err)
}
// Check if any excluded files remain (untracked or modified files won't be removed by git read-tree)
if remaining := git.CheckExcludedFilesExist(repoPath); len(remaining) > 0 {
relPath, _ := filepath.Rel(c.rigPath, repoPath)
return fmt.Errorf("sparse checkout configured for %s but these files still exist: %s\n"+
"These files are untracked or modified and were not removed by git.\n"+
"Please manually remove or revert these files in %s",
relPath, strings.Join(remaining, ", "), repoPath)
}
}
return nil
}