Complete memory graph and document value workplans

examples/memory/runtime-adapter-boundaries.yaml

@@ -0,0 +1,114 @@
+schema_version: markitect.memory.runtime-adapter-boundaries.v1
+id: markitect-memory-runtime-adapter-boundaries
+title: Memory Runtime Adapter Boundaries
+intent: Document non-executing handoff descriptors for external memory runtimes and stores.
+boundary:
+  markitect_tool:
+    owns:
+      - validate memory profiles, graph snapshots, events, and selections
+      - compile selected graph context into ContextPackage objects
+      - emit deterministic provenance and diagnostics
+    does_not_own:
+      - durable graph or event persistence
+      - vector search, embedding generation, or graph database queries
+      - runtime retention, deletion, compaction, policy enforcement, or audit sinks
+descriptors:
+  - id: memory.runtime.kontextual-engine
+    kind: memory-runtime-adapter
+    target_repo: kontextual-engine
+    operations:
+      - persist_graph_snapshot
+      - append_memory_event
+      - resolve_graph_selection
+      - refresh_memory_profile
+    input_contracts:
+      - markitect.memory.profile.v1
+      - markitect.memory.graph.v1
+      - markitect.memory.selection.v1
+    output_contracts:
+      - markitect.memory.graph.v1
+      - markitect.memory.selection.v1
+    notes: Durable graph and event persistence belongs here, not in markitect-tool.
+  - id: memory.runtime.phased-memory
+    kind: memory-runtime-adapter
+    target_repo: phased-memory
+    operations:
+      - compact_memory_window
+      - enforce_retention_intent
+      - produce_profile_observability
+    input_contracts:
+      - markitect.memory.profile.v1
+      - markitect.memory.graph.v1
+    output_contracts:
+      - markitect.memory.graph.v1
+    notes: Future phased-memory runtimes may implement lifecycle policies described by profiles.
+  - id: memory.store.external-graph
+    kind: graph-store-adapter
+    operations:
+      - query_neighborhood
+      - query_path
+      - resolve_edges
+    input_contracts:
+      - markitect.memory.graph.v1
+    output_contracts:
+      - markitect.memory.graph.v1
+    notes: External graph databases are queried by runtime packages and returned as contract snapshots.
+  - id: memory.store.vector
+    kind: vector-store-adapter
+    operations:
+      - embed_text
+      - retrieve_similar_nodes
+      - return_ranked_selection
+    input_contracts:
+      - markitect.memory.profile.v1
+    output_contracts:
+      - markitect.memory.selection.v1
+    notes: Embeddings and vector retrieval are optional runtime concerns.
+  - id: memory.extract.llm-assisted
+    kind: extraction-adapter
+    operations:
+      - propose_nodes
+      - propose_edges
+      - propose_event_summary
+    input_contracts:
+      - conversational transcript
+      - source artifact
+    output_contracts:
+      - markitect.memory.graph.v1
+    notes: LLM-assisted extraction must stay adapter-only and emit reviewable graph contracts.
+  - id: memory.policy.enterprise-pdp
+    kind: policy-adapter
+    operations:
+      - authorize_memory_read
+      - authorize_memory_write
+      - reauthorize_activation
+    input_contracts:
+      - profile policy block
+      - graph node and edge policy metadata
+    output_contracts:
+      - policy decision envelope
+    notes: Enterprise policy decisions are external; Markitect preserves policy metadata only.
+  - id: memory.registry.remote
+    kind: remote-registry-adapter
+    operations:
+      - publish_profile_descriptor
+      - resolve_remote_package
+      - list_available_memory_views
+    input_contracts:
+      - markitect.memory.profile.v1
+      - ContextPackage metadata
+    output_contracts:
+      - markitect.memory.selection.v1
+    notes: Remote registries are future scope and must not be required for local validation.
+  - id: memory.audit.sink
+    kind: audit-adapter
+    operations:
+      - record_memory_event
+      - record_policy_decision
+      - record_activation
+    input_contracts:
+      - markitect.memory.graph.v1 event envelope
+      - policy decision envelope
+    output_contracts:
+      - audit receipt
+    notes: Durable audit/event sinks belong to runtime or governance packages.