SnapMemoryBank (SAM) – Persistent audit memory

The SnapMemoryBank (SAM) is a central element of SnapOS: it stores audit data, SnapCuts and SnapOrbits permanently so that audits can be reproduced and verified even years later. While other frameworks merely store log files, SAM stores structured semantic snapshots and makes them available with versioning.

Functions of SAM

Function	Description	Distinctive advantage
Persistent SnapCuts	Stores time‑layered audit snapshots, including SnapScore, drift parameters and ethics status.	Reproducibility of every audit chain because all intermediate states are available.
Audit‑orbit trajectories	Documents the path of a witness through semantic orbit phases (init, stabilisation, emergence).	Enables deeper analysis of the semantic course than simple time series.
Hash signatures	Each SnapCut is cryptographically signed; a global ReproKey ensures integrity.	Unalterable audit trails – unique compared with conventional logs.
Metadata & versioning	Stores version information, DOIs and licence notes for each audit.	Facilitates citability and legal clarity.
Query interface	Provides an API access to search for SnapCuts, SnapOrbits or complete audit trails.	External auditors can search specifically for semantic events.

Example endpoints

`GET /sam/:id` – Read SnapCut

Retrieves a stored SnapCut by its ID.

{
  "snapcut_id": "sc-0023",
  "timestamp": "2025-10-31T09:45Z",
  "snapshot_id": "snap-uuid",
  "SnapScore": 78,
  "drift_state": { "D": 0.11, "phi": 0.02 },
  "ethics_level": "moderate",
  "hash": "0x91ac…",
  "previous": "sc-0022"
}

`GET /sam/list?since=2025-10-01` – Search SnapCuts

Returns a list of all SnapCuts stored after a specified date.

[
  {
    "snapcut_id": "sc-0023",
    "timestamp": "2025-10-31T09:45Z",
    "snapshot_id": "snap-uuid"
  },
  {
    "snapcut_id": "sc-0024",
    "timestamp": "2025-11-02T14:12Z",
    "snapshot_id": "snap-uuid-2"
  }
]

Differentiation from other systems

While many frameworks only have logs or export functions, SAM turns the audit history into a comprehensible time journey. Through hash signatures, semantic orbits and query interfaces, SnapOS combines transparency with scientific reproducibility. No other audit framework provides such a detailed, semantically enriched memory bank.

Back to API documentation | W functions | Ethics & re‑entry | Reproducibility