Controlled Forgetting

Aionis does not only add memory. It controls memory lifecycle so old, harmful, or low-value memory does not keep polluting future Agent context.

Lifecycle Actions

Action	Meaning
`suppress`	Keep the memory but block direct use.
`unsuppress`	Restore a suppressed memory to normal consideration.
`archive`	Move colder memory out of hot recall.
`rehydrate`	Restore archived or pointer-only evidence when needed.
`activate`	Record positive outcome evidence so useful memory stays warm.

Controlled forgetting is not blind deletion. The goal is to preserve evidence while controlling whether it can steer an Agent.

When To Use It

Situation	Recommended action
A memory is stale but still useful as evidence	Suppress or inspect-first.
A memory is large and rarely needed	Archive with rehydrate pointer.
A memory was useful in a recent guide	Activate through feedback.
A memory is contested	Keep evidence, block direct use until revalidated.

API Shape


curl -s http://127.0.0.1:3001/v1/forget \
  -H 'content-type: application/json' \
  -d '{
    "tenant_id": "default",
    "scope": "checkout-migration",
    "operation": "suppress",
    "memory_ids": ["mem_123"],
    "reason": "This branch was rejected by verifier feedback."
  }'

Rehydrate when an Agent needs raw payload:


curl -s http://127.0.0.1:3001/v1/rehydrate \
  -H 'content-type: application/json' \
  -d '{
    "tenant_id": "default",
    "scope": "checkout-migration",
    "memory_ids": ["mem_123"],
    "mode": "partial"
  }'

Boundary

Forgetting does not erase audit history by default. If the product decision was visible to an Agent or operator, the audit chain should remain explainable.

Guide: AIONIS_CONTROLLED_FORGETTING_QUICKSTART.md .