# Script Failure Logging

**Last Updated:** 2026-02-12

## Overview

The `log_script_failure()` helper flags failing scripts and API calls so they can be monitored and fixed. Failures are written to `logs/script-failures/YYYY-MM-DD.log`.

## Usage

```php
require_once __DIR__ . '/../../helpers/script-failure-logger.php';

// Log a failure (no email)
log_script_failure('generate-faq-answers-optimized', 'Failed to generate FAQ answer', [
    'post' => $slug,
    'category' => $category,
    'question' => substr($question, 0, 80),
]);

// Log and send email alert (for complete/critical failures)
log_script_failure('generate-faq-answers-optimized', 'Complete failure: 0 answers', [
    'post' => $slug,
    'category' => $category,
], true);
```

## When to Use

- **Individual API failures** (e.g. one FAQ question failed): `log_script_failure(..., false)` – log only
- **Complete script failure** (e.g. 0 answers generated): `log_script_failure(..., true)` – log and email hady@ordio.com

## Log Location

- `logs/script-failures/YYYY-MM-DD.log`
- One line per failure with timestamp and context

## Scripts Using This

- `generate-faq-answers-optimized.php` – logs per-question failures and complete failures

## Adding to New Scripts

1. Require `v2/helpers/script-failure-logger.php`
2. Call `log_script_failure()` when API calls or critical steps fail
3. Use `$sendEmail = true` for total failures that need attention