coulomb/markitect-tool
2
0
Fork 0
generated from coulomb/repo-seed
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Complete memory graph and document value workplans

Browse Source
This commit is contained in:
Bernd Worsch
2026-05-15 13:30:50 +02:00
parent f49ebb563b
commit 6cc44da628
25 changed files with 1546 additions and 168 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
examples/memory/conversation-path-selection.yaml Normal file
View File

@@ -0,0 +1,21 @@
schema_version: markitect.memory.selection.v1
graph: conversation-path.yaml
profile: memory-profile.local.yaml
title: Conversation Episode Package
intent: Activate the short-term path that explains why MKTT-WP-0016 is the current implementation target.
namespace:
project: markitect-tool
task: MKTT-WP-0016
node_ids:
- turn.user-correction
- interruption.direction-corrected
- plan.finish-memory-graph-profile
- observation.remaining-gap
event_ids:
- event.user-correction
budget:
max_items: 5
max_tokens: 1400
metadata:
memory_view: conversation
purpose: short-term-episode

86
examples/memory/conversation-path.yaml Normal file
View File

@@ -0,0 +1,86 @@
schema_version: markitect.memory.graph.v1
id: markitect-memory-conversation-path
title: Markitect Memory Conversation Path
intent: Preserve a short-term implementation episode with branch, tool, observation, and activation context.
namespace:
project: markitect-tool
task: MKTT-WP-0016
nodes:
- id: turn.user-correction
kind: turn
text: The requester corrected the target from the Pragmatic State Hub workplan to MKTT-WP-0016.
metadata:
title: User correction
speaker: user
- id: interruption.direction-corrected
kind: interruption
text: The implementation path changed before any file edits were made.
metadata:
title: Direction corrected
- id: plan.finish-memory-graph-profile
kind: plan
text: Finish the memory graph profile workplan by closing fixture breadth and runtime handoff gaps.
metadata:
title: Finish profile workplan
- id: tool.inspect-workplan
kind: tool_call
text: Inspect the active MKTT-WP-0016 workplan and memory graph implementation files.
metadata:
title: Inspect workplan and implementation
command_family: rg/sed
- id: observation.remaining-gap
kind: observation
text: The core graph compiler and CLI are implemented; the remaining work is fixture breadth and adapter handoff guidance.
metadata:
title: Remaining gap
- id: activation.contract-context
kind: activation
text: Activate the memory graph contract context package for follow-on implementation and cross-repo handoff.
metadata:
title: Contract context activation
edges:
- id: edge.turn-to-interruption
kind: led_to
source: turn.user-correction
target: interruption.direction-corrected
- id: edge.interruption-to-plan
kind: led_to
source: interruption.direction-corrected
target: plan.finish-memory-graph-profile
- id: edge.plan-to-tool
kind: depends_on
source: plan.finish-memory-graph-profile
target: tool.inspect-workplan
- id: edge.tool-to-observation
kind: led_to
source: tool.inspect-workplan
target: observation.remaining-gap
- id: edge.observation-to-activation
kind: activates
source: observation.remaining-gap
target: activation.contract-context
events:
- id: event.user-correction
kind: branched
timestamp: "2026-05-15T08:15:00Z"
actor: user
thread: markitect-tool
task: MKTT-WP-0016
node_updates:
- node_id: turn.user-correction
operation: create
- node_id: interruption.direction-corrected
operation: create
branch:
from: pragmatic-state-hub
to: MKTT-WP-0016
metadata:
reason: user-correction
- id: event.contract-context-activated
kind: activated
timestamp: "2026-05-15T08:20:00Z"
actor: codex
task: MKTT-WP-0016
node_updates:
- node_id: activation.contract-context
operation: create

17
examples/memory/invalid-memory-graph.yaml Normal file
View File

@@ -0,0 +1,17 @@
schema_version: markitect.memory.graph.v1
id: invalid-memory-graph
title: Invalid Memory Graph
intent: Exercise graph validation diagnostics for fixture consumers.
nodes:
- id: node.unknown-kind
kind: unknown_kind
text: This node kind is not part of the memory graph vocabulary.
edges:
- id: edge.unknown-target
kind: supports
source: node.unknown-kind
target: node.missing
events:
- id: event.unknown-kind
kind: unrecognized_event
timestamp: "2026-05-15T08:35:00Z"

11
examples/memory/invalid-memory-profile.yaml Normal file
View File

@@ -0,0 +1,11 @@
schema_version: markitect.memory.profile.v1
id: invalid-memory-profile
title: Invalid Memory Profile
intent: Exercise profile validation diagnostics for fixture consumers.
memory_kinds:
- reasoning
- telemetry
stores:
reasoning: local-event-log
metadata:
fixture: invalid-profile

23
examples/memory/knowledge-neighborhood-selection.yaml Normal file
View File

@@ -0,0 +1,23 @@
schema_version: markitect.memory.selection.v1
graph: knowledge-neighborhood.yaml
profile: memory-profile.local.yaml
title: Knowledge Neighborhood Package
intent: Activate the durable contract and runtime-boundary knowledge around memory graph profiles.
namespace:
project: markitect-tool
task: MKTT-WP-0016
node_ids:
- artifact.memory-graph-doc
- concept.graph-profile-contract
- capability.context-package-compile
- contract.schema-versions
- policy.runtime-boundary
- source_fact.workplan-out-of-scope
event_ids:
- event.knowledge-refresh
budget:
max_items: 7
max_tokens: 1800
metadata:
memory_view: knowledge
purpose: durable-neighborhood

94
examples/memory/knowledge-neighborhood.yaml Normal file
View File

@@ -0,0 +1,94 @@
schema_version: markitect.memory.graph.v1
id: markitect-memory-knowledge-neighborhood
title: Markitect Memory Knowledge Neighborhood
intent: Represent the durable knowledge neighborhood around memory graph contracts and runtime boundaries.
namespace:
project: markitect-tool
task: MKTT-WP-0016
nodes:
- id: entity.markitect-tool
kind: entity
text: Markitect Tool owns deterministic Markdown-native contracts, validation, and context package compilation.
metadata:
title: markitect-tool
- id: artifact.memory-graph-doc
kind: artifact
text: docs/memory-graph-contract.md describes the graph, profile, selection, fixture, and runtime handoff contracts.
source_spans:
- path: docs/memory-graph-contract.md
unit_kind: document
selector: document
engine: selector
metadata:
title: Memory graph contract document
- id: concept.graph-profile-contract
kind: concept
text: A memory profile declares runtime intent while a memory graph records nodes, edges, and event envelopes.
metadata:
title: Graph/profile contract
- id: capability.context-package-compile
kind: capability
text: Selected graph nodes and events compile into regular ContextPackage objects with provenance metadata.
metadata:
title: Graph selection compiler
- id: contract.schema-versions
kind: contract
text: markitect.memory.profile.v1, markitect.memory.graph.v1, and markitect.memory.selection.v1 are the stable contract versions for this slice.
metadata:
title: Memory schema versions
- id: policy.runtime-boundary
kind: policy
text: Runtime storage, retrieval, compaction, policy enforcement, audit, and service operation stay outside markitect-tool.
metadata:
title: Runtime boundary policy
- id: preference.local-deterministic
kind: preference
text: Keep first-version memory contract behavior deterministic, local-first, and service-free.
metadata:
title: Local deterministic preference
- id: source_fact.workplan-out-of-scope
kind: source_fact
text: MKTT-WP-0016 explicitly excludes durable graph stores, runtime daemons, retention enforcement, and remote registries.
source_spans:
- path: workplans/MKTT-WP-0016-agentic-memory-graphs-and-service-blueprints.md
unit_kind: section
selector: heading[Out Of Scope]
engine: selector
metadata:
title: Out-of-scope source fact
edges:
- id: edge.owner-to-doc
kind: mentions
source: entity.markitect-tool
target: artifact.memory-graph-doc
- id: edge.doc-to-contract
kind: supports
source: artifact.memory-graph-doc
target: contract.schema-versions
- id: edge.contract-to-concept
kind: supports
source: contract.schema-versions
target: concept.graph-profile-contract
- id: edge.policy-governs-compiler
kind: governs
source: policy.runtime-boundary
target: capability.context-package-compile
- id: edge.preference-supports-policy
kind: supports
source: preference.local-deterministic
target: policy.runtime-boundary
- id: edge.fact-supports-policy
kind: supports
source: source_fact.workplan-out-of-scope
target: policy.runtime-boundary
events:
- id: event.knowledge-refresh
kind: refreshed
timestamp: "2026-05-15T08:30:00Z"
actor: codex
task: MKTT-WP-0016
node_updates:
- node_id: artifact.memory-graph-doc
operation: refresh
- node_id: contract.schema-versions
operation: refresh

114
examples/memory/runtime-adapter-boundaries.yaml Normal file
View File

@@ -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.