Skip to content

docs(ai-memory): MemPalace → MIF Level-1 mapping + examples - #206

Open
perlowja wants to merge 2 commits into
modeled-information-format:mainfrom
perlowja:feat/mempalace-level1
Open

docs(ai-memory): MemPalace → MIF Level-1 mapping + examples#206
perlowja wants to merge 2 commits into
modeled-information-format:mainfrom
perlowja:feat/mempalace-level1

Conversation

@perlowja

@perlowja perlowja commented Jul 3, 2026

Copy link
Copy Markdown

Reopened against main per @zircote's request (2026-07-02) now that develop/v1.0.0 is promoted and stable. Supersedes #65, auto-closed when the develop/v1.0.0 base was deleted. Rebased cleanly onto main (single commit, 3 files under profiles/ai-memory/).

Per the discussion in #60 — the Level-1 first step of the MemPalace → MIF AI-Memory mapping (OKF-valid + cognitive-triad typing).

What's here

  • profiles/ai-memory/MEMPALACE-MAPPING.md — the draft field mapping (open for your feedback).
  • profiles/ai-memory/examples/mempalace-observation.md — a MemPalace entitysemantic observation, with a KG triple rendered as a typed MIF relationship.
  • profiles/ai-memory/examples/mempalace-session.md — a MemPalace drawerepisodic session.

Mapping at a glance

MemPalace MIF type Rationale
entity (person/project/topic) semantic (observation) decontextualized, stably-true world knowledge
drawer (filed_at/source/added_by) episodic (session) time-anchored record of a lived event
procedural (skill) declared gap — no native MemPalace construct
  • Triples: entity-object → typed relationships[] (predicate→type, object→target path, confidence→strength); literal-object → the first-class scalar properties field (now in v1.0.0).
  • IDs: UUIDv5 derived from the MemPalace id under a fixed MemPalace namespace UUID (deterministic across re-exports).
  • Deferred: bitemporal valid_from/valid_toLevel-3 version-DAG sidecar; trust tiers → L2; compression manifest → L3.

Validation

python scripts/okf_validate.py profiles/ai-memory/examples   # conformance + relationship sync + round-trip
python scripts/mif_convert.py roundtrip profiles/ai-memory/examples   # lossless markdown↔json-ld

Draft — the mapping is the discussion basis from #60. Happy to adjust triad assignment, namespacing, or literal-object handling before layering up to L2/L3. Related #60.

Add a draft MemPalace -> MIF AI-Memory profile mapping at Level 1 (OKF-valid +
cognitive-triad typing), with two worked example concepts:

- mempalace-observation.md: a MemPalace entity -> semantic observation, with a
  knowledge-graph triple rendered as a typed MIF relationship.
- mempalace-session.md: a MemPalace drawer -> episodic session (filed_at ->
  created; wing/room -> namespace path).

MEMPALACE-MAPPING.md documents the structure/field mapping, the triple ->
relationship rules (entity-object vs literal-object), the UUIDv5 id derivation,
and what is deferred to Levels 2/3 (bitemporal validity -> version-DAG sidecar,
trust tiers, compression manifest).

Both examples pass scripts/okf_validate.py and the scripts/mif_convert.py
roundtrip lossless check.

Related modeled-information-format#60.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a Level-1 documentation draft that maps MemPalace concepts onto the MIF AI-Memory profile (cognitive triad typing), plus two worked Markdown examples intended to validate under OKF and round-trip conversion.

Changes:

  • Introduces a MemPalace → MIF Level-1 field/structure mapping reference document.
  • Adds an episodic “session” example derived from a MemPalace drawer.
  • Adds a semantic “observation” example with a relationship illustrating cross-concept linkage.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 5 comments.

File Description
profiles/ai-memory/MEMPALACE-MAPPING.md Documents the Level-1 MemPalace → MIF mapping and references worked examples.
profiles/ai-memory/examples/mempalace-session.md New episodic session example representing a MemPalace drawer.
profiles/ai-memory/examples/mempalace-observation.md New semantic observation example intended to demonstrate MemPalace entity/triple mapping.

---
id: 897fbf98-a6cd-5e0d-b719-18095c15ab5c
type: semantic
created: '2025-03-04T12:00:00Z'
Comment on lines +18 to +22
Derived from a MemPalace **entity** (`name: "Alice Chen"`, `type: person`) and the
knowledge-graph **triple** `Alice Chen — works-on — Project Phoenix`. A MemPalace
entity is decontextualized, stably-true world knowledge, so it maps to the
cognitive-triad `semantic` type (the AI-memory `observation` reinterpretation).
The triple is rendered as a typed MIF relationship to the concept it references.
id: 0c523a47-28b3-559f-94ce-692cf88c2d9f
type: episodic
created: '2026-01-15T10:30:00Z'
namespace: _episodic/sessions
Comment on lines +45 to +48
- **object is an entity** → a typed MIF `relationships[]` entry on the subject
concept: `type` = predicate, `target` = the object concept's bundle-relative
path, `strength` = `confidence`. Mirrored in the body `## Relationships` section
(frontmatter ↔ body must stay in sync).
Comment on lines +66 to +68
See [`examples/mempalace-observation.md`](examples/mempalace-observation.md)
(entity → `semantic` observation, with a triple rendered as a `derived-from`
relationship) and [`examples/mempalace-session.md`](examples/mempalace-session.md)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants