generated from coulomb/repo-seed
175 lines
5.1 KiB
Markdown
175 lines
5.1 KiB
Markdown
---
|
|
id: PMEM-WP-0012
|
|
type: workplan
|
|
title: "Live Adapter And Service Binding Readiness"
|
|
domain: markitect
|
|
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.
|