Method markReferencesFailedByRowIds

src/db/queries.ts:2319–2332

* Park refs as status='failed' by row id — the precise counterpart of * markReferencesFailed, for the same reason as deleteReferencesByRowIds: * the key-tuple variant also flips same-key sibling rows in later batches * to 'failed' before they were ever attempted (#1269). Resolution outcome

(refs: Array<{ rowId: number; referenceName: string }>)

   * so a sibling must not inherit this row's failure.
   */
  markReferencesFailedByRowIds(refs: Array<{ rowId: number; referenceName: string }>): number {
    if (refs.length === 0) return 0;
    const stmt = this.db.prepare(
      "UPDATE unresolved_refs SET status = 'failed', name_tail = ? WHERE id = ?"
    );
    let changed = 0;
    const markMany = this.db.transaction((items: typeof refs) => {
      for (const ref of items) {
        changed += stmt.run(referenceNameTail(ref.referenceName), ref.rowId).changes;
      }
    });
    markMany(refs);
    return changed;
  }

  /**
   * Failed refs whose name tail matches one of the given symbol names — the