generated from coulomb/repo-seed
Implement refinement hardening workplan
This commit is contained in:
@@ -4,7 +4,7 @@ type: workplan
|
||||
title: "Refinement Hardening And Operational Readiness"
|
||||
domain: markitect
|
||||
repo: phase-memory
|
||||
status: ready
|
||||
status: finished
|
||||
owner: codex
|
||||
topic_slug: phase-memory
|
||||
created: "2026-05-18"
|
||||
@@ -34,7 +34,7 @@ The repo now has:
|
||||
- fake external adapter packs.
|
||||
|
||||
The refined scorecard in `docs/maturity-scorecard.md` scores the project at
|
||||
**3.8 / 5** overall, with stronger local integration maturity than operational
|
||||
**4.0 / 5** overall, with stronger local integration maturity than operational
|
||||
maturity.
|
||||
|
||||
## Non-Goals
|
||||
@@ -48,7 +48,7 @@ maturity.
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0011-T01
|
||||
status: todo
|
||||
status: done
|
||||
priority: high
|
||||
state_hub_task_id: "2b3c6eb4-8d3f-4c73-ab53-74e1bed8b93f"
|
||||
```
|
||||
@@ -68,7 +68,7 @@ Acceptance:
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0011-T02
|
||||
status: todo
|
||||
status: done
|
||||
priority: high
|
||||
state_hub_task_id: "2c19cfb0-e147-40b8-b964-6c617bddb90e"
|
||||
```
|
||||
@@ -86,7 +86,7 @@ Acceptance:
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0011-T03
|
||||
status: todo
|
||||
status: done
|
||||
priority: high
|
||||
state_hub_task_id: "cdce1c6a-4581-4184-87c6-f7bec6c3fcbd"
|
||||
```
|
||||
@@ -105,7 +105,7 @@ Acceptance:
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0011-T04
|
||||
status: todo
|
||||
status: done
|
||||
priority: medium
|
||||
state_hub_task_id: "602c22bb-d440-4d38-a51f-bf6ed504fd1e"
|
||||
```
|
||||
@@ -123,7 +123,7 @@ Acceptance:
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0011-T05
|
||||
status: todo
|
||||
status: done
|
||||
priority: medium
|
||||
state_hub_task_id: "c4fa6001-b20c-4ec1-b885-af9b80c832de"
|
||||
```
|
||||
@@ -140,7 +140,7 @@ Acceptance:
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0011-T06
|
||||
status: todo
|
||||
status: done
|
||||
priority: medium
|
||||
state_hub_task_id: "f4674eaf-cbc1-4eac-b1d1-b07ae51289cf"
|
||||
```
|
||||
@@ -162,4 +162,24 @@ Acceptance:
|
||||
|
||||
## Closure Review
|
||||
|
||||
Pending implementation.
|
||||
Completed on 2026-05-18.
|
||||
|
||||
Implemented:
|
||||
|
||||
- Full `LocalServiceRunner` handling for every `SERVICE_OPERATIONS` entry.
|
||||
- Runtime and service audit queries with queryable recording/JSONL/fake audit
|
||||
sinks and retention metadata.
|
||||
- Review-gated `lifecycle.apply` and `package.compile` service coverage.
|
||||
- Atomic JSON writes for file-backed store records plus metadata migration,
|
||||
planned-migration, corrupt-record, missing-reference, and orphaned-path
|
||||
diagnostics.
|
||||
- Three evaluation scenario families covering policy-denied activation,
|
||||
profile lifecycle rules, event-path activation, semantic-index hints, and
|
||||
budget pressure.
|
||||
- Adapter pack compatibility manifests and explicit missing-capability
|
||||
diagnostics.
|
||||
- Operational readiness docs and scorecard update from 3.8 to 4.0.
|
||||
|
||||
Verification:
|
||||
|
||||
- `python3 -m pytest` passes with 70 tests.
|
||||
|
||||
@@ -0,0 +1,152 @@
|
||||
---
|
||||
id: PMEM-WP-0012
|
||||
type: workplan
|
||||
title: "Live Adapter And Service Binding Readiness"
|
||||
domain: markitect
|
||||
repo: phase-memory
|
||||
status: ready
|
||||
owner: codex
|
||||
topic_slug: phase-memory
|
||||
created: "2026-05-18"
|
||||
updated: "2026-05-18"
|
||||
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: todo
|
||||
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: todo
|
||||
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: todo
|
||||
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: todo
|
||||
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: todo
|
||||
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: todo
|
||||
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
|
||||
|
||||
Pending implementation.
|
||||
Reference in New Issue
Block a user