resolvelisted

# Wherefore: resolve Close out an open question by updating its individual file in `wherefore/questions/`, recording what was decided, why, and which discussion (if any) contains the full context. The file's frontmatter is the single source of truth. ## Frontmatter safety When you fill `resolution`, emit it as a double-quoted, single-line string, escaping embedded `"` as `\"` and `\` as `\\`. An unquoted value containing `: ` (colon-space) or a leading `-`, `#`, `[`, `{`, or `"` makes YAML misparse and crashes the dashboard viewer. If the answer will not fit on one line, keep `resolution` to a one-line summary and move detail into a `## Resolution` body section. `status` and `resolution_slug` need no quotes. ## Workflow 1. **Find the question.** Files are named `Q-NNN-short-slug.md` (ID prefix plus a scannable slug), so glob by the ID rather than assuming the exact name: `ls wherefore/questions/Q-042-*.md wherefore/questions/Q-042.md 2>/dev/null` (the second path catches any legacy file still named `Q-NNN.md`). Expect exactly one match; open it. If nothing matches, say so clearly. To list what is open, dump the question frontmatter and filter `status: open`: ```bash for f in wherefore/questions/Q-*.md; do awk -v F="$f" 'BEGIN{print "=== " F " ==="} /^---[[:space:]]*$/ { n++; if (n==2) exit; next } n==1 { print }' "$f" done ``` Confirm the target's current `status`. If `status: resolved`, tell the user and show the exist