observe
Reopen a settled memory for review when new evidence contradicts it, without overwriting the current record. Flags the discrepancy for a steward to resolve, so contradictory observations are not blindly trusted or ignored.
Instructions
READ-PATH review trigger — the mirror of a write-time hold-for-review. Feed it an OBSERVATION (evidence,
NOT an authoritative write) that CONTRADICTS a settled memory: a different value for key, or object=""
for a value-obscuring revert ("go back to what we had", names no value). Instead of silently trusting or
ignoring it, this REOPENS that settled record for review. A NAMED contradiction (a different value) reopens
only once it is CORROBORATED, so a lone stray restatement stays an echo and does not reopen: support (a
list of the distinct grounds the observation rests on) is what corroboration counts, a restatement whose
grounds were already seen is an echo, and it takes >= reopen_corroboration distinct novel grounds. A
VALUE-OBSCURING revert (object="") reopens on FIRST sight: it names no value, so there is nothing a
second observation could corroborate or echo, and the only safe outcome is a steward's decision. The
record stays current meanwhile; nothing is restored until resolve_reopened says so. observe() NEVER supersedes or
writes — it only flags; a steward closes the review with resolve_reopened(). Use it for contradicting
evidence you don't want to act on blindly. Returns {reopened, key, pending, need, surfaced_prior, review_id}.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | ||
| text | Yes | ||
| object | No | ||
| support | No |