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.