Complete memory graph and document value workplans

This commit is contained in:
2026-05-15 13:30:50 +02:00
parent f49ebb563b
commit 6cc44da628
25 changed files with 1546 additions and 168 deletions

View File

@@ -42,10 +42,10 @@ validation so that cross-repository contracts do not drift silently.
Valid node kinds include `question`, `claim`, `assumption`, `evidence`,
`decision`, `alternative`, `outcome`, `risk`, `follow_up`, `turn`, `plan`,
`tool_call`, `observation`, `edit`, `validation`, `task`, `topic`, `document`,
`entity`, `artifact`, `concept`, `capability`, `contract`, `policy`,
`preference`, `source_fact`, `episode`, `finding`, `constraint`, `profile`,
`context_package`, and `memory`.
`tool_call`, `observation`, `edit`, `validation`, `interruption`,
`activation`, `task`, `topic`, `document`, `entity`, `artifact`, `concept`,
`capability`, `contract`, `policy`, `preference`, `source_fact`, `episode`,
`finding`, `constraint`, `profile`, `context_package`, and `memory`.
Valid edge kinds include `supports`, `contradicts`, `depends_on`,
`derived_from`, `led_to`, `affects`, `references`, `relates_to`, `supersedes`,
@@ -70,6 +70,42 @@ mkt memory graph validate examples/memory/decision-graph.yaml
mkt memory graph pack examples/memory/decision-graph-selection.yaml --format yaml
```
## Fixture Catalog
The memory fixtures cover the three intended memory views:
| Files | View | Purpose |
| --- | --- | --- |
| `examples/memory/decision-graph.yaml`, `examples/memory/decision-graph-selection.yaml` | reasoning | Decision and constraint path that pins the contract/runtime boundary. |
| `examples/memory/conversation-path.yaml`, `examples/memory/conversation-path-selection.yaml` | conversation | Short-term branch/plan/tool/observation episode with event activation. |
| `examples/memory/knowledge-neighborhood.yaml`, `examples/memory/knowledge-neighborhood-selection.yaml` | knowledge | Durable neighborhood around schema versions, docs, compiler capability, and runtime policy. |
| `examples/memory/memory-profile.local.yaml` | mixed profile | Local profile declaring reasoning, knowledge, and package stores plus activation limits. |
| `examples/memory/invalid-memory-graph.yaml`, `examples/memory/invalid-memory-profile.yaml` | invalid | Negative fixtures for validation diagnostics and handoff contract tests. |
The valid selections compile to standard `ContextPackage` output. Invalid
fixtures are deliberately small so downstream runtimes can assert diagnostic
codes without needing Markitect-owned durable storage.
## Runtime Adapter Handoff
`examples/memory/runtime-adapter-boundaries.yaml` is a non-executing descriptor
catalog for external memory runtimes and stores. It names the contracts that
runtime packages should accept or emit while keeping Markitect limited to local
validation, planning, and package compilation.
The descriptor catalog covers:
| Boundary | Responsibility |
| --- | --- |
| `memory.runtime.kontextual-engine` | Durable graph snapshots, event append, selection resolution, and refresh execution. |
| `memory.runtime.phased-memory` | Future lifecycle policies such as compaction, retention intent, and observability. |
| `memory.store.external-graph` | External graph database path and neighborhood queries. |
| `memory.store.vector` | Embedding and vector retrieval flows that return graph selections. |
| `memory.extract.llm-assisted` | Optional graph extraction proposals from transcripts or source artifacts. |
| `memory.policy.enterprise-pdp` | Runtime policy authorization and activation reauthorization. |
| `memory.registry.remote` | Future remote profile/package registry interactions. |
| `memory.audit.sink` | Durable audit and policy decision event sinks. |
This keeps Markitect as the compiler/contract boundary. `kontextual-engine`
should implement runtime stores and event production against these schemas, and
`infospace-bench` should benchmark generated context packages and runtime