Configurable Scope

Overview

Large codebase? Too many PRs? GitSpectra lets you filter exactly which commits and branches to monitor, so you only see conflicts that matter to you.

Scope Options

Branch Filtering

Control which branches to check for conflicts:

{
  "gitspectra.scope.branches": [
    "origin/main",
    "origin/develop",
    "origin/release/*"
  ]
}

Pattern Matching

• Exact match: origin/main
• Wildcard: origin/feature/*
• Multiple patterns: ["origin/main", "origin/develop"]

Exclude Branches

{
  "gitspectra.scope.excludeBranches": [
    "origin/dependabot/*",
    "origin/renovate/*",
    "origin/revert-*"
  ]
}

Exclude automated branches like Dependabot or Renovate.

Time Window

How far back should GitSpectra look for changes?

{
  "gitspectra.scope.timeWindow": "14d"
}

Supported Formats

Recommendations

Author Filtering

Only check commits from specific people:

{
  "gitspectra.scope.authors": [
    "alice@company.com",
    "bob@company.com"
  ]
}

Use Cases

• Small team within large org: Only track your immediate team
• Specific collaborator: Watch one person's changes closely
• Self-only: Set to your own email to see where you might conflict with yourself

Exclude Authors

{
  "gitspectra.scope.excludeAuthors": [
    "bot@ci.com",
    "dependabot[bot]@users.noreply.github.com"
  ]
}

Ignore commits from bots and automation.

Configuration Methods

VS Code Settings

Use the Settings UI or settings.json:

{
  "gitspectra.scope.branches": ["origin/main"],
  "gitspectra.scope.timeWindow": "14d",
  "gitspectra.scope.authors": []
}

Team Configuration File

Share settings via .gitspectra.json:

{
  "scope": {
    "branches": ["origin/main", "origin/develop"],
    "excludeBranches": ["origin/dependabot/*"],
    "timeWindow": "14d"
  }
}

See Team Configuration for details.

Practical Examples

{
  "scope": {
    "branches": ["origin/main", "origin/develop"],
    "authors": ["@frontend-team"],
    "timeWindow": "7d"
  }
}

{
  "scope": {
    "branches": ["origin/main"],
    "excludeBranches": ["origin/team-*"],
    "timeWindow": "14d"
  }
}

{
  "scope": {
    "branches": ["origin/main"],
    "excludeAuthors": ["dependabot[bot]"],
    "timeWindow": "30d"
  }
}

{
  "scope": {
    "branches": ["origin/main"],
    "timeWindow": "3d",
    "authors": ["alice@company.com", "bob@company.com"]
  }
}

Performance Impact

Narrower scope = faster analysis:

For very large repos, consider aggressive filtering.