Yeachan-Heo/oh-my-codex · error

[ ] must match the selected value label

Error message

${path}[${mismatchIndex}] must match the selected value label

What it means

assertSelectedLabelsMatch compares each selected_labels[i] against the label the schema expects for selected_values[i]. On the first index where they differ it throws with that index, pinpointing the misaligned label.

Solutions

1. Derive labels from the current question schema at submit time rather than caching them
2. When appending/removing a selection, update both arrays together (derive labels from values)

Example fix

// before
answer.selected_labels = cachedLabels; // stale/order mismatch
// after
answer.selected_labels = answer.selected_values.map((v) => question.options.find((o) => o.value === v)!.label);

const expected = answer.selected_values.map((v) => question.options.find((o) => o.value === v)?.label ?? question.other_label);
if (expected.some((l, i) => l !== answer.selected_labels[i])) answer.selected_labels = expected;

function labelsMatchSchema(q: NormalizedQuestionItem, values: string[], labels: string[]): boolean {
  return values.every((v, i) => labels[i] === (q.options.find((o) => o.value === v)?.label ?? q.other_label));
}

try { await submit(p, answers); } catch (e) { const m = /answers\[\d+\]\.answer\.selected_labels\[(\d+)\] must match/.exec((e as Error).message); if (m) { fixLabelAt(+m[1]); return submit(p, answers); } throw e; }

When it happens

Trigger: selected_labels[i] does not equal question option label (or other_label for other answers) for the value at the same index; e.g. reordered values without reordering labels, or outdated label text after schema localization changes.

Common situations: Reordering one array but not the other; stale cached labels after the question's labels were updated; localization mismatch between client and server label text.

Understand the failure class

Background: Schema validation failed / invalid input schema: payload rejected because its shape doesn't match the expected schema — this error's family across 28 libraries.

Related errors

• cardinality must match selected values
• answers[ ].answer.kind=option is only valid for…
• answers[ ].answer.kind=other is not allowed for this…
• answers[ ].answer must select exactly one option
• answers[ ].question_id is unknown for this question

AI-assisted analysis of Yeachan-Heo/oh-my-codex@3ad79a8a6f (2026-08-27). Data as JSON: /api/errors/bd42871cfa49f7eb. Report an issue: GitHub.

Appendix: source

Thrown at src/question/state.ts:335

  return selectedValues.map((value) => {
    const optionLabel = optionLabelsByValue.get(value);
    if (optionLabel) return optionLabel;
    if (question.allow_other && otherText && value === otherText) return question.other_label;
    throw new Error(`selected value is not in the option schema: ${value}`);
  });
}

function assertSelectedLabelsMatch(
  selectedLabels: string[],
  expectedLabels: string[],
  path: string,
): void {
  if (selectedLabels.length !== expectedLabels.length) {
    throw new Error(`${path} cardinality must match selected values`);
  }
  const mismatchIndex = selectedLabels.findIndex((label, index) => label !== expectedLabels[index]);
  if (mismatchIndex !== -1) {
    throw new Error(`${path}[${mismatchIndex}] must match the selected value label`);
  }
}

function questionForAnswer(record: QuestionRecord, entry: QuestionAnswerEntry): NormalizedQuestionItem {
  const question = (record.questions ?? []).find((item) => item.id === entry.question_id);
  if (question) return question;
  if (entry.question_id === 'q-1') {
    return {
      id: 'q-1',
      ...(record.header ? { header: record.header } : {}),
      question: record.question,
      options: record.options,
      allow_other: record.allow_other,
      other_label: record.other_label,
      multi_select: record.multi_select,
      type: getNormalizedQuestionType(record),
    };
  }

View on GitHub (pinned to 3ad79a8a6f)