generated from coulomb/repo-seed
Implement live-shaped readiness workplan
This commit is contained in:
@@ -4,11 +4,11 @@ type: workplan
|
||||
title: "Live Adapter And Service Binding Readiness"
|
||||
domain: markitect
|
||||
repo: phase-memory
|
||||
status: ready
|
||||
status: finished
|
||||
owner: codex
|
||||
topic_slug: phase-memory
|
||||
created: "2026-05-18"
|
||||
updated: "2026-05-18"
|
||||
updated: "2026-05-19"
|
||||
state_hub_workstream_id: "427b91ad-9df1-4053-aeb0-54ee39b6bf62"
|
||||
---
|
||||
|
||||
@@ -38,7 +38,7 @@ evaluation fixtures, adapter pack manifests, and operational recipes.
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0012-T01
|
||||
status: todo
|
||||
status: done
|
||||
priority: high
|
||||
state_hub_task_id: "1244aabb-b8a3-4053-8454-499e8772f5bf"
|
||||
```
|
||||
@@ -56,7 +56,7 @@ Acceptance:
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0012-T02
|
||||
status: todo
|
||||
status: done
|
||||
priority: high
|
||||
state_hub_task_id: "b8d3e7a0-c538-4d6c-b2f8-7c33b17c850a"
|
||||
```
|
||||
@@ -73,7 +73,7 @@ Acceptance:
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0012-T03
|
||||
status: todo
|
||||
status: done
|
||||
priority: high
|
||||
state_hub_task_id: "e385af31-13f2-4be0-8fcf-89586e2d3954"
|
||||
```
|
||||
@@ -91,7 +91,7 @@ Acceptance:
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0012-T04
|
||||
status: todo
|
||||
status: done
|
||||
priority: medium
|
||||
state_hub_task_id: "d203294a-bf5a-43d0-a88c-086a3406940d"
|
||||
```
|
||||
@@ -108,7 +108,7 @@ Acceptance:
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0012-T05
|
||||
status: todo
|
||||
status: done
|
||||
priority: medium
|
||||
state_hub_task_id: "305729e2-23ff-4043-9356-0df83f8e6d7b"
|
||||
```
|
||||
@@ -127,7 +127,7 @@ Acceptance:
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0012-T06
|
||||
status: todo
|
||||
status: done
|
||||
priority: medium
|
||||
state_hub_task_id: "78f9d0d8-dc9d-4f43-a32d-92e17b3c5122"
|
||||
```
|
||||
@@ -149,4 +149,26 @@ Acceptance:
|
||||
|
||||
## Closure Review
|
||||
|
||||
Pending implementation.
|
||||
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.
|
||||
|
||||
@@ -0,0 +1,150 @@
|
||||
---
|
||||
id: PMEM-WP-0013
|
||||
type: workplan
|
||||
title: "Credentialed Adapter Drills And Deployment Packaging"
|
||||
domain: markitect
|
||||
repo: phase-memory
|
||||
status: ready
|
||||
owner: codex
|
||||
topic_slug: phase-memory
|
||||
created: "2026-05-19"
|
||||
updated: "2026-05-19"
|
||||
state_hub_workstream_id: "3343c4bf-40f4-42c9-9713-2a441349f723"
|
||||
---
|
||||
|
||||
# PMEM-WP-0013: Credentialed Adapter Drills And Deployment Packaging
|
||||
|
||||
## Goal
|
||||
|
||||
Move from live-shaped local fixtures to optional credentialed operational
|
||||
drills, deployable service packaging, and compatibility release discipline.
|
||||
|
||||
## Current Evidence
|
||||
|
||||
`PMEM-WP-0012` added service binding, executable local-store migrations,
|
||||
live-shaped adapter packs, audit retention/export plans, evaluation threshold
|
||||
reports, and public API snapshots. The scorecard now rates the repo at
|
||||
**4.2 / 5**.
|
||||
|
||||
## Non-Goals
|
||||
|
||||
- Require live credentials in default tests.
|
||||
- Store credentials, tokens, or endpoints in Git.
|
||||
- Make one hosted service topology mandatory.
|
||||
- Move Markitect or Kontextual ownership into phase-memory.
|
||||
|
||||
## T01 - Add credential-gated adapter smoke drills
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0013-T01
|
||||
status: todo
|
||||
priority: high
|
||||
state_hub_task_id: "e4940a9d-130e-47ea-ba16-7b090841855c"
|
||||
```
|
||||
|
||||
Add optional smoke tests for credentialed Markitect/Kontextual adapters that
|
||||
skip unless explicit environment variables are present.
|
||||
|
||||
Acceptance:
|
||||
|
||||
- Default test suite remains offline and deterministic.
|
||||
- Credentialed drills reuse adapter manifest validation and conformance helpers.
|
||||
- Skipped tests clearly list the required environment variables.
|
||||
|
||||
## T02 - Package the service binding for deployment
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0013-T02
|
||||
status: todo
|
||||
priority: high
|
||||
state_hub_task_id: "bf8d2159-761a-47f5-b7be-41ad52460b64"
|
||||
```
|
||||
|
||||
Add a deployable service entrypoint around the framework-neutral binding.
|
||||
|
||||
Acceptance:
|
||||
|
||||
- The package can expose health, readiness, contracts, and operation dispatch
|
||||
over a local service process.
|
||||
- Deployment remains optional and dependency-light.
|
||||
- Tests cover entrypoint construction without opening a real listener.
|
||||
|
||||
## T03 - Add operator readiness runbook
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0013-T03
|
||||
status: todo
|
||||
priority: medium
|
||||
state_hub_task_id: "7e39e894-8754-4977-abdd-00f3bf1a73d1"
|
||||
```
|
||||
|
||||
Document service startup, readiness checks, migration apply, audit export, and
|
||||
rollback expectations for operators.
|
||||
|
||||
Acceptance:
|
||||
|
||||
- Runbook covers happy path and failure triage.
|
||||
- It distinguishes local fixture mode, live-shaped mode, and credentialed live
|
||||
mode.
|
||||
- It links back to API compatibility and maturity gates.
|
||||
|
||||
## T04 - Enforce audit retention pruning plans
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0013-T04
|
||||
status: todo
|
||||
priority: medium
|
||||
state_hub_task_id: "b23e3126-bbfa-44b1-b2a1-22cda968f5d8"
|
||||
```
|
||||
|
||||
Move from retention planning to explicit retention apply behavior.
|
||||
|
||||
Acceptance:
|
||||
|
||||
- Audit sinks can produce and apply deterministic pruning plans.
|
||||
- Apply behavior records an audit event.
|
||||
- Tests cover no-op, eligible-record, and unsupported-sink paths.
|
||||
|
||||
## T05 - Add evaluation trend artifacts
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0013-T05
|
||||
status: todo
|
||||
priority: medium
|
||||
state_hub_task_id: "2e71fedd-aac6-42c9-822c-6305412ea064"
|
||||
```
|
||||
|
||||
Persist deterministic evaluation reports as trendable artifacts.
|
||||
|
||||
Acceptance:
|
||||
|
||||
- Reports include run metadata and threshold deltas.
|
||||
- Fixtures can be compared without live dependencies.
|
||||
- Regression diagnostics remain actionable.
|
||||
|
||||
## T06 - Add compatibility release notes template
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0013-T06
|
||||
status: todo
|
||||
priority: low
|
||||
state_hub_task_id: "c1a8f699-9a0b-4983-8d35-e59cd124dd58"
|
||||
```
|
||||
|
||||
Add release-note and migration-note templates for public API changes.
|
||||
|
||||
Acceptance:
|
||||
|
||||
- Template calls out changed exports, changed service operations, migration
|
||||
needs, and operator action.
|
||||
- API snapshot updates require a release note reference.
|
||||
|
||||
## Acceptance Criteria
|
||||
|
||||
- The project has concrete evidence toward the 4.3+ scorecard gate.
|
||||
- Credentialed adapter drills are available but never required by default.
|
||||
- Service binding can be packaged and exercised as an operator-facing service.
|
||||
|
||||
## Closure Review
|
||||
|
||||
Pending implementation.
|
||||
Reference in New Issue
Block a user