@spec-this/cli

//force update

Official CLI tool for the Spec-This code intelligence platform.

Debug Mode

The CLI includes comprehensive debug logging to help troubleshoot issues, especially with API calls.

Enabling Debug Mode

You can enable debug logging in several ways:

1. Using the --debug flag:

spec-this scan --debug

2. Using the --log-level flag:

spec-this scan --log-level debug

3. Using environment variables:

export SPEC_THIS_DEBUG=true
spec-this scan

Or:

export SPEC_THIS_LOG_LEVEL=debug
spec-this scan

4. For a single command:

SPEC_THIS_DEBUG=true spec-this scan

Log Levels

Available log levels (from most to least verbose):

• trace - Very detailed trace information
• debug - Detailed debug information (includes all API calls and responses)
• info - General informational messages (default)
• warn - Warning messages
• error - Error messages
• fatal - Application crashes

What Debug Mode Shows

When debug mode is enabled, you'll see:

• Every API request with method, endpoint, URL, and authentication status
• Request body size and preview (for POST/PUT requests)
• Response status, timing, and preview
• Detailed error information including 413 errors with payload size
• Batch splitting information (when scan data is split into batches)
• Scan statistics (file counts, symbol counts, etc.)

Troubleshooting 413 Errors

If you're getting 413 (Payload Too Large) errors, debug mode will show:

• The exact size of the request that failed
• Whether batching is being used
• How many batches are being sent and their sizes

This information can help determine if the batch size needs to be reduced or if there's an issue with the API server configuration.