---
id: PMEM-WP-0012
type: workplan
title: "Live Adapter And Service Binding Readiness"
domain: communication
repo: phase-memory
status: finished
owner: codex
topic_slug: phase-memory
created: "2026-05-18"
updated: "2026-05-19"
state_hub_workstream_id: "427b91ad-9df1-4053-aeb0-54ee39b6bf62"
---

# PMEM-WP-0012: Live Adapter And Service Binding Readiness

## Goal

Move phase-memory from local integration readiness toward operational
readiness by adding deployable service bindings, executable migration behavior,
and live-shaped adapter compatibility gates while preserving the dependency-light
local runtime.

## Current Evidence

`PMEM-WP-0011` brought the scorecard to **4.0 / 5** by closing local service
runner parity, queryable audit behavior, persistence diagnostics, multi-scenario
evaluation fixtures, adapter pack manifests, and operational recipes.

## Non-Goals

- Require live external credentials in default tests.
- Make a specific web framework mandatory for library users.
- Move Markitect or Kontextual ownership into this repo.
- Replace deterministic fake adapters with network-dependent defaults.

## T01 - Add optional service binding

```task
id: PMEM-WP-0012-T01
status: done
priority: high
state_hub_task_id: "1244aabb-b8a3-4053-8454-499e8772f5bf"
```

Add an optional framework binding or adapter shell around `LocalServiceRunner`
for health, readiness, and operation dispatch.

Acceptance:

- Binding preserves the framework-neutral `LocalServiceRunner` API.
- Health/readiness endpoints cover config diagnostics and adapter availability.
- Tests run without starting a network listener by default.

## T02 - Add executable local-store migrations

```task
id: PMEM-WP-0012-T02
status: done
priority: high
state_hub_task_id: "b8d3e7a0-c538-4d6c-b2f8-7c33b17c850a"
```

Turn migration diagnostics into explicit migration planning and apply behavior.

Acceptance:

- Store metadata can produce deterministic migration plans.
- Migration apply updates metadata atomically and records an audit event.
- Tests cover no-op, old-schema, planned-migration, and corrupt-metadata paths.

## T03 - Add live-shaped adapter compatibility fixtures

```task
id: PMEM-WP-0012-T03
status: done
priority: high
state_hub_task_id: "e385af31-13f2-4be0-8fcf-89586e2d3954"
```

Add adapter fixtures that model Markitect and Kontextual live behavior behind
the same manifest and conformance helpers used by fake packs.

Acceptance:

- Adapter manifest validation covers fake and live-shaped packs.
- Capability and ownership failures remain explicit diagnostics.
- The runtime can resolve live-shaped packs without changing local code paths.

## T04 - Add audit retention and telemetry export drills

```task
id: PMEM-WP-0012-T04
status: done
priority: medium
state_hub_task_id: "d203294a-bf5a-43d0-a88c-086a3406940d"
```

Make audit retention policy and telemetry export inspectable beyond metadata.

Acceptance:

- Audit sinks expose retention eligibility or pruning plans.
- Telemetry export emits deterministic local event batches.
- Tests cover review-gated apply, policy denial, and package compile traces.

## T05 - Grow evaluation threshold reporting

```task
id: PMEM-WP-0012-T05
status: done
priority: medium
state_hub_task_id: "305729e2-23ff-4043-9356-0df83f8e6d7b"
```

Promote the evaluation scenarios into a threshold report suitable for regression
tracking.

Acceptance:

- Evaluation report includes policy, lifecycle, path, semantic, and budget
  metrics.
- Threshold assertions produce actionable diagnostics.
- Fixture additions do not require live dependencies.

## T06 - Add public API compatibility checks

```task
id: PMEM-WP-0012-T06
status: done
priority: medium
state_hub_task_id: "78f9d0d8-dc9d-4f43-a32d-92e17b3c5122"
```

Protect the embedding surface now documented as stable.

Acceptance:

- Public exports have a compatibility snapshot or explicit changelog gate.
- Service operation catalog and local runner handlers stay in parity by test.
- Docs identify how breaking changes should be handled.

## Acceptance Criteria

- Scorecard has concrete evidence toward the 4.3+ gate.
- Optional operational surfaces stay optional and dependency-light by default.
- Live-shaped adapters can be validated by the same compatibility contract as
  fake packs.

## Closure Review

Completed on 2026-05-19.

Implemented:

- Optional framework-neutral `ServiceBinding` with health, readiness,
  contracts, operation dispatch, and WSGI callable coverage without starting a
  listener.
- Executable local-store migration planning and apply behavior with atomic
  metadata updates and audited `store.migration.apply` events.
- Live-shaped Markitect, Kontextual, policy, telemetry, semantic-index, and
  runtime-registry adapter fixtures behind the same manifest and conformance
  suite used by fake packs.
- Audit export batches and retention plans for recording, JSONL, and telemetry
  audit sinks.
- Evaluation threshold reporting over the policy/lifecycle/path/semantic/budget
  scenario corpus.
- Public API and service operation compatibility snapshots with documentation.
- Scorecard update from 4.0 to 4.2 and PMEM-WP-0013 as the next ready
  refinement workplan.

Verification:

- Focused PMEM-WP-0012 tests passed: 38 tests.