# UMP memory.ump.json — actual schema (verified 2026-07-12)

**File:** `/root/.openclaw/agents/main/workspace/state/ump-local/memory.ump.json`
**Format:** JSON array, 851 records
**Total records:** 851 (not 846 — was 768 in Qdrant backfill, 846 in watcher's last run; real total is 851)

## Top-level fields per record

```jsonc
{
  "ump": "0.1",                          // schema version (string)
  "id": "urn:ump:jzbhzerwqn23hfzre...",  // URN string (not "urn"!)
  "kind": "procedural",                  // see kinds below
  "body": {
    "subject": "...",                    // short title
    "text": "..."                        // full content
  },
  "scope": {
    "owner": "did:key:z6Mk...",          // actor DID
    "project": "openclaw/workspace",
    "visibility": "private",
    "tags": ["..."]
  },
  "time": {
    "created": "2026-06-06T21:49:57.806Z",  // ISO 8601
    "modified": "...",
    "observed": "...",
    "valid_from": "...",
    "valid_to": null
  },
  "lifecycle": {                         // NESTED, not flat!
    "status": "active",                  // see statuses below
    "confidence": 0.6                    // 0.0 - 1.0
  },
  "superseded_by": [],                   // array or null
  "provenance": {...},
  "integrity": {...}
}
```

## Kinds (distribution)

| kind | count |
|---|---|
| procedural | 245 |
| semantic | 231 |
| identity | 152 |
| episodic | 152 |
| note | 42 |
| working | 29 |

(Total: 851)

## Lifecycle statuses (distribution)

| status | count | meaning |
|---|---|---|
| active | 708 | normal, queryable |
| candidate | 53 | pending promotion |
| archived | 42 | kept but deprioritized |
| tombstoned | 48 | deleted logically — skip in retrieval |

## Critical corrections vs spec

- Field is **`id`**, NOT `urn`
- `lifecycle.status` is **nested** in `lifecycle.status`, NOT flat `status`
- `lifecycle.confidence` is **nested**, NOT flat
- `kind` values include `note` (in addition to standard 5)
- Status values: `active`, `candidate`, `archived`, `tombstoned` (not just `active`/`archived`)
- No `topic` field — uses `scope.project` and `scope.tags`
- No `access_count` or `last_accessed_at` fields yet (would need to be added)

## Code patterns

```js
import fs from 'node:fs';
const data = JSON.parse(fs.readFileSync(UMP_FILE, 'utf-8'));
for (const r of data) {
  const urn = r.id;                      // NOT r.urn
  const text = r.body?.text ?? r.body?.subject ?? '';
  const kind = r.kind;                   // procedural|note|semantic|working|identity|episodic
  const status = r.lifecycle?.status ?? 'active';
  const confidence = r.lifecycle?.confidence ?? 1.0;
  const createdAt = r.time?.created ?? null;
}
```