Prepare logs for AI debugging

# Synthetic debugging-log preparation

All data is fictional. The example.invalid address cannot identify a real customer. Authorization and cookie strings are obvious fake markers, not credentials.

Compare synthetic-raw.log with expected-minimised.log and complete excerpt-review.md. The optional prepare_example.py uses only the unchanged bundled raw file, refuses any other content by hash and prints a fixed demonstration transformation. It performs no network calls and is not a production redactor. Do not replace the fixture with real logs.

Debugging question: why did the fictional request return a missing-quantity error after a retry? Observe that the status, time sequence, error text and stack frames remain useful without the original marker values.

## Guide and source references

Canonical guide: https://aona.ai/resources/guides/production-logs-ai-debugging/
Source review: 2026-09-21
- OAIC: Use of commercially available AI products: https://www.oaic.gov.au/privacy/privacy-guidance-for-organisations-and-government-agencies/guidance-on-privacy-and-the-use-of-commercially-available-ai-products
- Claude Code: Data usage: https://code.claude.com/docs/en/data-usage
- Aona: AI security coverage: https://aona.ai/resources/ai-security-coverage/

2030-01-01T00:00:00.000Z SYNTHETIC request=SYNTHETIC_REQ_004 GET /orders/SYNTHETIC_ORDER_071 status=500 email=person@example.invalid Authorization="Bearer SYNTHETIC_AUTH_D08" Cookie="session=SYNTHETIC_COOKIE_D08"
2030-01-01T00:00:00.012Z SYNTHETIC request=SYNTHETIC_REQ_004 retry=1 error="ValueError: missing required field quantity"
  at parse_order(payload) in parser.py:18
  at handle_request() in app.py:42

2030-01-01T00:00:00.000Z SYNTHETIC request=[REQUEST_1] GET /orders/[ORDER_1] status=500 email=[EMAIL_1] Authorization="Bearer [AUTH_REMOVED]" Cookie="session=[COOKIE_REMOVED]"
2030-01-01T00:00:00.012Z SYNTHETIC request=[REQUEST_1] retry=1 error="ValueError: missing required field quantity"
  at parse_order(payload) in parser.py:18
  at handle_request() in app.py:42

# Offline transformation for the bundled synthetic fixture only.
import hashlib
from pathlib import Path
import sys

source = Path(__file__).with_name("synthetic-raw.log").read_text()
if hashlib.sha256(source.encode()).hexdigest() != "5fed748badd05d428a1e56db0a121ccb8cbf3f3c2212084ac3b34a25b04166cf":
    raise SystemExit("Refusing input: use only the unchanged bundled synthetic fixture.")
replacements = {'SYNTHETIC_REQ_004': '[REQUEST_1]', 'SYNTHETIC_ORDER_071': '[ORDER_1]', 'person@example.invalid': '[EMAIL_1]', 'SYNTHETIC_AUTH_D08': '[AUTH_REMOVED]', 'SYNTHETIC_COOKIE_D08': '[COOKIE_REMOVED]'}
for old, new in replacements.items():
    source = source.replace(old, new)
sys.stdout.write(source)

# Debugging excerpt review

Question: ____________________
Minimum time window and events: ____________________
Error/status and frames retained: ____________________
Repeated values requiring consistent replacement: ____________________
Credentials, cookies and unnecessary identifiers removed: ____________________
Remaining architecture or business context to review: ____________________
Service/account and submission path: ____________________
Owner decision: NOT YET REVIEWED
Control test, if applicable: UNTESTED
Evidence: ____________________

This record does not certify a real excerpt as safe or authorize disclosure.