generated from coulomb/repo-seed
115 lines
3.9 KiB
YAML
115 lines
3.9 KiB
YAML
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.
|