# @oshun/memory-iris

Canonical Iris memory adapter contracts for OSHUN.

This package defines the product-facing memory substrate interface that OSHUN
surfaces use when they need assistant identity, continuity, consent-aware memory
scopes, searchable recall, review/delete controls, and exportability.

It deliberately normalizes the mismatches that already exist across Iris memory
packages:

- `@iris/contracts` uses `core` / `working` / `archival` / `episodic`
- `@iris/memory-core` uses `stm` / `ltm` / `episodic` / `semantic`
- `@iris/privacy` review tooling uses `@iris/memory-core` tiers

The adapter contract exposes one canonical tier model, one scope model, one
consent rollup, and one review/search/export surface for OSHUN shell and admin
integration work.

## Scope

- canonical assistant-profile, continuity, consent, search, review, deletion,
  and export DTOs
- low-level adapter interface for Iris memory, privacy, personalization, and
  export primitives
- canonical adapter factory (`createCanonicalIrisMemoryAdapter`) that wraps an
  injected low-level Iris adapter
- normalization helpers that align `@iris/*` memory tiers and content models
  with OSHUN contracts

## Usage

```ts
import { createCanonicalIrisMemoryAdapter } from '@oshun/memory-iris';

const iris = createCanonicalIrisMemoryAdapter({ apiAdapter });

const continuity = await iris.getContinuityState({
  userId: 'user-123',
  consumer: 'assistant',
  activeDomain: 'nisaba',
});
```