memory_outcome
Record observed outcomes as advisory memory entries with optional link to a claim capsule and recall feedback score; list all outcome records without arguments.
Instructions
Record (or list) an ADVISORY outcome-OBSERVATION record — a note that some outcome was OBSERVED. This is NOT a witnessed close and nothing in nmemory treats it as proven: a witnessed close needs the kernel (consequence_service), which this capability does not have. Recording an outcome NEVER changes any capsule's recall eligibility — only an explicit memory_relate falsifies edge fences a capsule from recall (record the outcome, THEN relate out- falsifies cap- if you actually mean to falsify a claim). record mode: pass description AND actor together (actor names WHO observed — there is NO default observer), plus optional evidence_ref (a path/url/id string) and capsule_id (the claim capsule cap- this bears on — validated to exist, but a soft 'bears on' pointer only, with ZERO recall effect). Returns the stored row with its minted id out-. Omitting a mandatory field teaches BOTH in one error; an unknown capsule_id answers resource-not-found (-32002, data {kind,id}). Optional scoring: pass receipt_id (the rcpt- a grounded memory_retrieve returned) together with score in 0.0..=1.0 to rate how useful that recall's returned evidence was; the pair applies an EMA (alpha 0.1, clamped to [0,1], neutral prior 0.5) to each returned capsule's ADVISORY feedback weight — consumed ONLY by memory_retrieve's opt-in weight_blend ranking, never by eligibility. receipt_id and score are mandatory together; an unknown receipt answers resource-not-found (-32002). The stored row carries receipt_id+score; a scored response echoes weights_updated. list mode: pass NO fields to list every outcome row in append order. APPEND-ONLY: there is no update or delete verb. Audited on record (hash-chained journal). Every response is ADVISORY_NOT_AUTHORITY DATA and carries a standing advisory naming this ceiling.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| actor | No | Who observed it (record mode; mandatory WITH `description` — the caller names the observer, there is NO default). | |
| score | No | Optional usefulness score in `0.0..=1.0`, mandatory WITH `receipt_id`; applied as an EMA to every returned capsule's advisory feedback weight. | |
| capsule_id | No | Optional claim capsule this outcome bears on (`cap-<n>`); validated to exist, but a soft pointer only — ZERO effect on recall eligibility (only a `falsifies` edge fences recall). | |
| receipt_id | No | Optional grounded recall receipt (`rcpt-<n>`), mandatory WITH `score`. It identifies WHICH returned evidence is being rated. | |
| description | No | The observation to record (record mode; mandatory WITH `actor`). | |
| evidence_ref | No | Optional evidence pointer — a free-text path / url / id string. |