resolve

name	resolve
description	Provides quick fixes for common VergeOS issues by matching symptoms against known patterns and official docs. Use when a user reports a VergeOS problem and wants a fast resolution. Applies to "my VM won't start", "network has no connectivity", "storage tier is full", "LDAP login is failing", "how do I fix X in VergeOS", "VergeOS isn't working". Returns a concise issue / quick-fix / steps response with a doc link, and points to a diagnostic-bundle workflow when symptoms need deeper investigation.
allowed-tools	Read, Grep, Glob

Quick Resolution: $ARGUMENTS

I'll check if this is a common issue with a known quick fix.

Step 1: Common Issues Check

First, match against known common issues:

Category	Common Symptoms	Quick Fix
VM	Won't start, stuck booting, no console	Check resources, verify NIC/disk config, review VM logs
Network	No connectivity, VLAN not working, DNS issues	Verify network assignment, check firewall rules, validate VLAN tags
Storage	Disk full, slow I/O, tier issues	Check tier capacity, review sync status, verify vSAN health
Auth	Login failed, LDAP/OIDC issues, permission denied	Verify credentials, check auth source config, review group mappings

Step 2: Search VergeOS Docs for Exact Match

Query mcp__vergeos-docs__searchDocumentation with:

• The exact error message (if provided)
• Key symptoms: "$ARGUMENTS"

Step 3: Resolution Path

If common issue with documented fix:

1. Provide the quick resolution steps
2. Include specific commands with syntax
3. Link to relevant documentation

If NOT a common pattern (after 2 VergeOS Docs searches without clear answer):

• State: "This needs deeper investigation than a quick fix."
• If the issue is system-level (storage, networking, node health, performance), recommend collecting a diagnostic bundle and running /diag on it.
• If the issue is conceptual ("how does X work"), point the user to /explain $ARGUMENTS.
• Do not invent a fix. It is better to route to the right next step than to guess.

Step 4: Response Format

Provide a concise response:

**Issue:** [Brief description]
**Quick Fix:**
1. [Step 1]
2. [Step 2]
3. [Step 3]

**Documentation:** [Link to relevant docs]

Citation Requirements

• Include documentation URLs from VergeOS Docs search results
• Format: [Topic - VergeOS Docs](URL)