Controlled Forgetting

Aionis controls memory lifecycle so old, harmful, or low-value memory can be suppressed, archived, rehydrated, restored, or activated with evidence.

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 preserves 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 keeps audit history explainable when the product decision was visible to an Agent or operator.

Guide: AIONIS_CONTROLLED_FORGETTING_QUICKSTART.md .