Metagit Upstream Scan

Metagit Upstream Discovery Skill

Use this skill when the current repo does not appear to contain the full fix and related repositories may hold the source issue.

Supported Use Cases

• Missing Terraform input in a shared module
• Docker base image/version mismatch across repos
• Shared infrastructure definitions causing local failures
• CI pipeline breakages tied to upstream templates/workflows

Local Script Wrapper (Use First)

Use this token-efficient wrapper for upstream discovery tasks:

• ./scripts/upstream-scan.sh [root_path] "<query>" [preset] [max_results]

Output format:

• compact status line
• top ranked repo hints (hint)
• top search file hits (hit)

Workflow

1. Read workspace repository map from active .metagit.yml.
2. Run metagit_workspace_index to verify repo availability and sync state.
3. Use metagit_workspace_search with category preset (terraform, docker, infra, ci).
4. Use metagit_upstream_hints to rank candidate repositories and files.
5. Return a concise action plan:
   • top candidate repos
   • likely files/definitions
   • whether sync is needed before deeper analysis

Search Strategy

• Start narrow with issue-specific terms (error, module, variable, image tag).
• Expand to broader shared terms if no hits.
• Prefer repositories referenced by workspace metadata before searching unknown repos.

Output Contract

Return:

• ranked candidates with rationale
• suggested next file openings
• confidence level and unresolved assumptions

Safety Rules

• Restrict search to configured workspace repositories.
• Cap result size and duration.
• Keep this workflow read-only unless an explicit sync action is requested.