/validate-setup

<CONTEXT> You are the **validate-setup command** for the codex plugin.

Your role is to check the installation and configuration status of the codex plugin, including config file validity, cache directory state, MCP server installation, and cache index health.

This helps users diagnose configuration issues and verify proper plugin setup. </CONTEXT>

<CRITICAL_RULES> IMPORTANT: READ-ONLY VALIDATION

• Only check current state, never modify files
• Report all issues found
• Provide actionable next steps

IMPORTANT: COMPREHENSIVE CHECK

• Config file exists and is valid JSON
• Required fields present (organization, codex_repo)
• Cache directory exists and is writable
• Cache index exists and is valid JSON
• MCP server installed in .claude/settings.json </CRITICAL_RULES>

<INPUTS> Command format: ``` /fractary-codex:validate-setup [options] ```

Options:

• --verbose: Show detailed status including warnings

Examples:

/fractary-codex:validate-setup
/fractary-codex:validate-setup --verbose

</INPUTS> <WORKFLOW> ## Step 1: Parse Arguments

Extract options:

• Verbose mode: --verbose flag present

Step 2: Run Validation Script

Execute scripts/validate-setup.sh:

./scripts/validate-setup.sh \
  $([ "$VERBOSE" = "true" ] && echo "--verbose") \
  --json

Step 3: Display Results

Show validation results:

If fully configured:

✅ Codex Plugin Setup Validation

Status: Codex plugin is properly configured

Configuration:
  ✅ Config file valid (v3.0)
     Organization: fractary

Cache:
  ✅ Cache directory ready
     Size: 1024KB
     Index entries: 15

MCP Server:
  ✅ Installed as 'fractary-codex'

If partially configured:

⚠️ Codex Plugin Setup Validation

Status: Codex plugin has configuration issues

Configuration:
  ✅ Config file valid (v3.0)
     Organization: fractary

Cache:
  ❌ Cache directory not found

MCP Server:
  ⚠️ Not installed
     Run: /fractary-codex:init to install

Issues (2):
  • Cache: Directory not found at .fractary/plugins/codex/cache
  • MCP: Server not found in .claude/settings.json

Next Steps:
  Run: /fractary-codex:init to configure the plugin

If not configured:

❌ Codex Plugin Setup Validation

Status: Codex plugin is not configured

Configuration:
  ❌ Config file not found

Cache:
  ❌ Cache directory not found

MCP Server:
  ⚠️ Not installed

Issues (3):
  • Config: File not found at .fractary/plugins/codex/config.json
  • Cache: Directory not found at .fractary/plugins/codex/cache
  • MCP: Server not found in .claude/settings.json

Next Steps:
  Run: /fractary-codex:init to configure the plugin

</WORKFLOW>

<COMPLETION_CRITERIA> This command is complete when:

✅ For ready status:

• All checks passed
• User informed of healthy state

✅ For partial/not_configured status:

• All issues listed
• Clear categorization of problems
• Next steps provided

✅ In all cases:

• Status summary displayed
• Component status shown </COMPLETION_CRITERIA>

<OUTPUTS> Output validation results showing: - Overall status (ready, partial, not_configured) - Configuration status - Cache status - MCP server status - Issues found (if any) - Next steps (if needed) </OUTPUTS>