Add Markitect bridge and activation quality

workplans/PMEM-MATURITY-SCORECARD.md

@@ -44,30 +44,30 @@ not what adjacent repositories may already provide.
 
 ## Current Baseline - 2026-05-18
 
-Overall maturity: **3.1 / 5**
+Overall maturity: **3.7 / 5**
 
 The repo has crossed from intent-only into a working deterministic library
 foundation, a usable local runtime facade, a CLI, a file-backed local
-workspace, and first-slice policy/review/audit gates. It is not yet an
-interop-complete runtime because richer Markitect package bridge, activation
-quality, and service contracts remain ahead.
+workspace, first-slice policy/review/audit gates, and a concrete Markitect
+package bridge, and deterministic activation quality helpers. It is not yet
+service-ready.
 
 | Dimension | Current | Target | Evidence | Needed Next |
 | --- | ---: | ---: | --- | --- |
 | Intent and boundaries | 4.0 | 5.0 | `INTENT.md`, `SCOPE.md`, `README.md`, architecture doc, PMEM-WP-0001 closure | Keep boundaries current as runtime behavior expands. |
-| Package foundation | 3.0 | 4.0 | Python package, exports, runtime facade, CLI entrypoint, dependency-light tests | Add local persistence and richer adapter configuration. |
-| Profile contract ingress | 2.5 | 4.0 | Markitect-compatible profile loading, diagnostics, runtime envelopes | Add validation adapter boundary and compatibility fixture catalog. |
-| Graph/event contract ingress | 3.0 | 4.0 | Graph loading, edge endpoint diagnostics, event model, JSONL event log, export, repair diagnostics | Add richer policy-aware import/export checks. |
-| Phase domain model | 3.0 | 4.0 | Phases, memory kinds, lifecycle states, actions, explicit path records | Add transition rule profiles and review records. |
-| Profile execution planning | 3.0 | 4.0 | Adapter plan, capabilities, policy gates, fallback behavior, CLI output, snapshot fixture | Add profile-driven runtime configuration and compatibility validation. |
-| Lifecycle planning | 3.0 | 4.0 | Transition, retention, refresh, compaction dry-run plans, review-gated local apply | Add profile-driven rule evaluation and full review records. |
-| Activation planning | 2.5 | 5.0 | Budgeted selection, Markitect-compatible selection output, package request envelope, CLI output | Add graph neighborhoods, event paths, ranking, metadata preservation, metrics. |
+| Package foundation | 3.0 | 4.0 | Python package, exports, runtime facade, CLI entrypoint, dependency-light tests | Add runtime configuration, service contracts, and adapter conformance. |
+| Profile contract ingress | 2.5 | 4.0 | Markitect-compatible profile loading, diagnostics, runtime envelopes | Add profile-driven runtime configuration and richer compatibility coverage. |
+| Graph/event contract ingress | 3.0 | 4.0 | Graph loading, edge endpoint diagnostics, event model, JSONL event log, export, repair diagnostics | Add service-level import/export contracts and adapter conformance. |
+| Phase domain model | 3.0 | 4.0 | Phases, memory kinds, lifecycle states, actions, explicit path records | Add profile-driven transition rule evaluation and migration semantics. |
+| Profile execution planning | 3.0 | 4.0 | Adapter plan, capabilities, policy gates, fallback behavior, CLI output, snapshot fixture | Add runtime configuration model and service-readiness diagnostics. |
+| Lifecycle planning | 3.0 | 4.0 | Transition, retention, refresh, compaction dry-run plans, review-gated local apply | Add profile-driven rule evaluation and service apply contracts. |
+| Activation planning | 3.8 | 5.0 | Budgeted selection, Markitect-compatible selection output, package request envelope, graph neighborhoods, event paths, ranking, metadata preservation, metrics | Add semantic-index adapters and broader evaluation corpora. |
 | Local persistence | 3.0 | 4.0 | Versioned local workspace, file-backed graph store, JSONL event log, JSONL audit sink | Add migration/repair utilities and stronger durability semantics. |
 | Policy and audit | 3.2 | 5.0 | Operation points, policy gateway checks, audit schema, review records, redaction, activation denials | Add external policy adapters and richer audit retention behavior. |
 | Observability and diagnostics | 2.5 | 4.0 | Planner diagnostics, runtime diagnostics, event log corruption checks, repair diagnostics, policy denial diagnostics | Add health envelopes and adapter status diagnostics. |
-| Markitect interop | 1.5 | 4.0 | Compatible schema constants and selection handoff | Add package bridge envelopes, optional validation/compiler adapters. |
-| Kontextual/Infospace interop | 1.0 | 4.0 | Boundaries documented and small derived fixtures | Add delegation envelope design and evaluation fixture reports. |
-| Testing and evaluation | 3.2 | 4.0 | 36 deterministic tests over planners, adapters, runtime envelopes, CLI, snapshots, file-store round trips, apply denial, review records, audit schema, and policy redaction | Add activation metrics. |
+| Markitect interop | 3.5 | 4.0 | Compatible contract ingress, optional validation boundary, enriched selection metadata, package request/response envelopes | Add live optional Markitect compiler adapter when available. |
+| Kontextual/Infospace interop | 1.5 | 4.0 | Boundaries documented, small derived fixtures, activation quality report fixture | Add Kontextual delegation envelopes and broader Infospace evaluation fixture reports. |
+| Testing and evaluation | 3.7 | 4.0 | 46 deterministic tests over planners, adapters, runtime envelopes, CLI, snapshots, file-store round trips, apply denial, review records, audit schema, policy redaction, Markitect bridge fixtures, retrieval, and activation metrics | Add broader evaluation corpora. |
 | Service readiness | 0.5 | 4.0 | Runtime ports exist | Add service contracts, config, health checks, adapter conformance tests. |
 | Developer experience | 3.3 | 4.0 | README quick start, package map, runtime facade docs, CLI examples, local persistence guide | Add troubleshooting and richer examples. |
 
@@ -113,6 +113,26 @@ Remaining maturity blockers:
 - Activation quality metrics.
 - Service readiness and external adapter conformance.
 
+## Progress Update - PMEM-WP-0006
+
+Closed on 2026-05-18:
+
+- Added deterministic graph-neighborhood retrieval.
+- Added event-path selection from structured memory paths.
+- Added candidate scoring and explanation reasons.
+- Added pluggable token estimator protocol with deterministic word-count
+  default.
+- Added activation quality report metrics and fixture.
+- Documented retrieval and evaluation behavior.
+
+Remaining maturity blockers:
+
+- Service API contracts.
+- Runtime configuration model.
+- Health diagnostics.
+- External adapter conformance tests.
+- Kontextual delegation adapter design.
+
 ## Progress Update - PMEM-WP-0004
 
 Closed on 2026-05-18:
@@ -133,6 +153,25 @@ Remaining maturity blockers:
 - Activation ranking and evaluation metrics.
 - Service contracts, health diagnostics, and external adapter conformance.
 
+## Progress Update - PMEM-WP-0005
+
+Closed on 2026-05-18:
+
+- Added Markitect package request and response envelopes.
+- Added local and optional Markitect validation adapter boundary.
+- Preserved selected item source spans, provenance, confidence, freshness,
+  namespace, policy metadata, and selection reasons through activation.
+- Added compatibility fixtures and tests for invalid contracts, activation
+  package requests, and opaque package responses.
+- Documented the Markitect boundary.
+
+Remaining maturity blockers:
+
+- Graph-neighborhood retrieval and event-path activation.
+- Ranking signals and token accounting.
+- Activation quality metrics and evaluation fixtures.
+- Service readiness and external adapter conformance.
+
 ## Score Movement Rules
 
 A dimension should move up only when executable behavior and tests exist.