wyrm_failure_record

Category

Failure Patterns

Use when an approach failed or something broke - log the dead end so nobody tries it again. Identical (scope, target, description) coalesces with occurrences++; when the root cause is fixed, stop flagging it with wyrm failure resolve <id> (CLI). Run-scoped failures quarantine until confirmed.

Signature

Argument	Type	Required	Description
projectPath	string		Global if omitted
scope	'file' | 'symbol' | 'command' | 'prompt' | 'edit'	✓
target	string	✓	File, symbol, command, or prompt
description	string	✓	What was tried
why_failed	string		Diagnosis if known
severity	'low' | 'medium' | 'high' | 'critical'
promote	'project' | 'global'		Widen the tier (explicitly attributed callers only)

Hand-written prose for this tool will appear here. Edit between the markers above and below; the rest of this page regenerates on every docs build.