Skip to main content

Error Recovery Playbook

Error causes and recovery actions for this skill.

Error Recovery Table​

ErrorCauseRecovery
403 on get-datasource-metadataNo permission (do not retry)Search for same-name datasource in other projects; offer description-based fallback
403 or auth error on query-datasourceNo permission to query (do not retry)Skip profiling for that datasource; offer description-based generation from the schema in the metadata
Empty field list from metadataDatasource type not supportedExplain limitation; offer description-based generation
Profiling query returns 0 rowsEmpty datasource or query errorRetry once; if still empty, ask user for expected row count and use domain defaults, labeled "unprofiled defaults" in the proposal and validation summary
Profiling query timeoutLarge datasourceReduce profiling scope (top 20 instead of 50); skip low-priority fields
Calibration fails after 3 attemptsDistribution shape incompatibleTrigger escape hatch: present variance to user with options (accept, simplify distribution, adjust range)
Unique constraint impossibleCardinality space < row countTrigger the "Constraint Conflict Resolution" section in SKILL.md
Geographic validation failureCity/State mismatch in generated dataUse fallback: substitute state capital or largest city for that state; regenerate postal code to match
Calculated field division by zeroBase field = 0 in denominatorSet calculated field to NULL for that row; note in validation summary
Parameter-dependent profiling seems incompleteRLS or parameter filteringNote in schema proposal; ask user if results look reasonable for their access level
pantab/hyper API not availablePackage not installedAttempt pip install; if fails, offer CSV with conversion instructions
Correlation profiling inconclusiveInsufficient data or no clear patternDefault to independent generation; note in schema proposal
Temporal pattern detection failsDate range too short or irregularDefault to flat/uniform generation; note limitation