phase-memory/workplans/PMEM-WP-0012-live-adapter-and-service-binding-readiness.md

id, type, title, domain, repo, status, owner, topic_slug, created, updated, state_hub_workstream_id

id	type	title	domain	repo	status	owner	topic_slug	created	updated	state_hub_workstream_id
PMEM-WP-0012	workplan	Live Adapter And Service Binding Readiness	markitect	phase-memory	finished	codex	phase-memory	2026-05-18	2026-05-19	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

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

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

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

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

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

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.