generated from coulomb/repo-seed
Add service readiness contracts
This commit is contained in:
@@ -44,31 +44,31 @@ not what adjacent repositories may already provide.
|
||||
|
||||
## Current Baseline - 2026-05-18
|
||||
|
||||
Overall maturity: **3.7 / 5**
|
||||
Overall maturity: **4.2 / 5**
|
||||
|
||||
The repo has crossed from intent-only into a working deterministic library
|
||||
foundation, a usable local runtime facade, a CLI, a file-backed local
|
||||
workspace, first-slice policy/review/audit gates, and a concrete Markitect
|
||||
package bridge, and deterministic activation quality helpers. It is not yet
|
||||
service-ready.
|
||||
workspace, first-slice policy/review/audit gates, a concrete Markitect package
|
||||
bridge, deterministic activation quality helpers, and first-slice service
|
||||
readiness contracts.
|
||||
|
||||
| Dimension | Current | Target | Evidence | Needed Next |
|
||||
| --- | ---: | ---: | --- | --- |
|
||||
| Intent and boundaries | 4.0 | 5.0 | `INTENT.md`, `SCOPE.md`, `README.md`, architecture doc, PMEM-WP-0001 closure | Keep boundaries current as runtime behavior expands. |
|
||||
| Package foundation | 3.0 | 4.0 | Python package, exports, runtime facade, CLI entrypoint, dependency-light tests | Add runtime configuration, service contracts, and adapter conformance. |
|
||||
| Package foundation | 4.0 | 4.0 | Python package, exports, runtime facade, CLI entrypoint, config, service contracts, dependency-light tests | Maintain public API compatibility as adapters expand. |
|
||||
| Profile contract ingress | 2.5 | 4.0 | Markitect-compatible profile loading, diagnostics, runtime envelopes | Add profile-driven runtime configuration and richer compatibility coverage. |
|
||||
| Graph/event contract ingress | 3.0 | 4.0 | Graph loading, edge endpoint diagnostics, event model, JSONL event log, export, repair diagnostics | Add service-level import/export contracts and adapter conformance. |
|
||||
| Graph/event contract ingress | 3.5 | 4.0 | Graph loading, edge endpoint diagnostics, event model, JSONL event log, export, repair diagnostics, service import/export contracts | Add broader external adapter fixtures. |
|
||||
| Phase domain model | 3.0 | 4.0 | Phases, memory kinds, lifecycle states, actions, explicit path records | Add profile-driven transition rule evaluation and migration semantics. |
|
||||
| Profile execution planning | 3.0 | 4.0 | Adapter plan, capabilities, policy gates, fallback behavior, CLI output, snapshot fixture | Add runtime configuration model and service-readiness diagnostics. |
|
||||
| Profile execution planning | 3.5 | 4.0 | Adapter plan, capabilities, policy gates, fallback behavior, CLI output, snapshot fixture, service contract | Add external config-driven adapter resolution. |
|
||||
| Lifecycle planning | 3.0 | 4.0 | Transition, retention, refresh, compaction dry-run plans, review-gated local apply | Add profile-driven rule evaluation and service apply contracts. |
|
||||
| Activation planning | 3.8 | 5.0 | Budgeted selection, Markitect-compatible selection output, package request envelope, graph neighborhoods, event paths, ranking, metadata preservation, metrics | Add semantic-index adapters and broader evaluation corpora. |
|
||||
| Local persistence | 3.0 | 4.0 | Versioned local workspace, file-backed graph store, JSONL event log, JSONL audit sink | Add migration/repair utilities and stronger durability semantics. |
|
||||
| Policy and audit | 3.2 | 5.0 | Operation points, policy gateway checks, audit schema, review records, redaction, activation denials | Add external policy adapters and richer audit retention behavior. |
|
||||
| Observability and diagnostics | 2.5 | 4.0 | Planner diagnostics, runtime diagnostics, event log corruption checks, repair diagnostics, policy denial diagnostics | Add health envelopes and adapter status diagnostics. |
|
||||
| Observability and diagnostics | 3.5 | 4.0 | Planner diagnostics, runtime diagnostics, event log corruption checks, repair diagnostics, policy denial diagnostics, health envelopes, adapter status | Add production telemetry adapters. |
|
||||
| Markitect interop | 3.5 | 4.0 | Compatible contract ingress, optional validation boundary, enriched selection metadata, package request/response envelopes | Add live optional Markitect compiler adapter when available. |
|
||||
| Kontextual/Infospace interop | 1.5 | 4.0 | Boundaries documented, small derived fixtures, activation quality report fixture | Add Kontextual delegation envelopes and broader Infospace evaluation fixture reports. |
|
||||
| Testing and evaluation | 3.7 | 4.0 | 46 deterministic tests over planners, adapters, runtime envelopes, CLI, snapshots, file-store round trips, apply denial, review records, audit schema, policy redaction, Markitect bridge fixtures, retrieval, and activation metrics | Add broader evaluation corpora. |
|
||||
| Service readiness | 0.5 | 4.0 | Runtime ports exist | Add service contracts, config, health checks, adapter conformance tests. |
|
||||
| Kontextual/Infospace interop | 2.5 | 4.0 | Boundaries documented, small derived fixtures, activation quality report fixture, Kontextual delegation envelope | Add live fake/real delegation adapters and broader Infospace reports. |
|
||||
| Testing and evaluation | 4.0 | 4.0 | 51 deterministic tests over planners, adapters, runtime envelopes, CLI, snapshots, file-store round trips, apply denial, review records, audit schema, policy redaction, Markitect bridge fixtures, retrieval, activation metrics, service contracts, config, health, and conformance | Add broader evaluation corpora. |
|
||||
| Service readiness | 3.5 | 4.0 | Runtime ports, service contracts, config model, health checks, local service runner, adapter conformance helpers | Add framework-specific bindings and production adapter packs. |
|
||||
| Developer experience | 3.3 | 4.0 | README quick start, package map, runtime facade docs, CLI examples, local persistence guide | Add troubleshooting and richer examples. |
|
||||
|
||||
## Progress Update - PMEM-WP-0002
|
||||
@@ -133,6 +133,25 @@ Remaining maturity blockers:
|
||||
- External adapter conformance tests.
|
||||
- Kontextual delegation adapter design.
|
||||
|
||||
## Progress Update - PMEM-WP-0007
|
||||
|
||||
Closed on 2026-05-18:
|
||||
|
||||
- Added service operation contract catalog.
|
||||
- Added runtime configuration model.
|
||||
- Added health reports and adapter status diagnostics.
|
||||
- Added local service runner shape without framework dependency.
|
||||
- Added adapter conformance helpers.
|
||||
- Added Kontextual delegation envelope.
|
||||
- Documented deployment modes.
|
||||
|
||||
Remaining maturity blockers:
|
||||
|
||||
- Live external adapter implementations.
|
||||
- Broader evaluation corpora.
|
||||
- Optional framework-specific service bindings.
|
||||
- Production telemetry and audit retention integrations.
|
||||
|
||||
## Progress Update - PMEM-WP-0004
|
||||
|
||||
Closed on 2026-05-18:
|
||||
|
||||
@@ -4,7 +4,7 @@ type: workplan
|
||||
title: "Service Readiness And External Adapters"
|
||||
domain: markitect
|
||||
repo: phase-memory
|
||||
status: proposed
|
||||
status: finished
|
||||
owner: phase-memory
|
||||
topic_slug: service-readiness
|
||||
planning_priority: P2
|
||||
@@ -48,11 +48,40 @@ tests, runtime configuration, health checks, or deployment guidance.
|
||||
- Do not add operational complexity before PMEM-WP-0002 through PMEM-WP-0006
|
||||
stabilize.
|
||||
|
||||
## Implementation Update - 2026-05-18
|
||||
|
||||
The service-readiness and external-adapter slice is complete.
|
||||
|
||||
Implemented outputs:
|
||||
|
||||
- `phase_memory.service` defines service contract catalog, runtime config,
|
||||
health reports, local service runner, adapter conformance helpers, and
|
||||
Kontextual delegation envelopes.
|
||||
- Service contracts cover profile planning, graph import, lifecycle planning,
|
||||
lifecycle apply, activation planning, package compile handoff, audit query,
|
||||
and health check.
|
||||
- `RuntimeConfig` models local store path, adapter registry, policy mode,
|
||||
audit sink mode, package compiler mode, semantic index mode, dry-run default,
|
||||
and trust-zone labels.
|
||||
- Health reports expose adapter availability, config diagnostics, stale memory
|
||||
counts, pending review counts, and store counts.
|
||||
- Adapter conformance helpers cover graph stores, event logs, context package
|
||||
compilers, policy gateways, and audit sinks.
|
||||
- `kontextual_delegation_envelope` documents the JSON boundary that avoids
|
||||
circular imports while preserving ownership between phase-memory and
|
||||
`kontextual-engine`.
|
||||
- `docs/service-readiness.md` documents contracts, config, health,
|
||||
conformance, delegation, and deployment modes.
|
||||
|
||||
Validation:
|
||||
|
||||
- `python3 -m pytest` -> 51 passed.
|
||||
|
||||
## T01 - Define runtime service API contracts
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0007-T01
|
||||
status: todo
|
||||
status: done
|
||||
priority: high
|
||||
state_hub_task_id: "48dc8e83-ff0f-4c25-b1c9-d94c3a2ac0eb"
|
||||
```
|
||||
@@ -74,7 +103,7 @@ Output: API contract docs and fixture request/response envelopes.
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0007-T02
|
||||
status: todo
|
||||
status: done
|
||||
priority: high
|
||||
state_hub_task_id: "da22d548-3123-46fc-acac-8bbcf8b54fb7"
|
||||
```
|
||||
@@ -95,7 +124,7 @@ Output: reusable test helpers that any external adapter must pass.
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0007-T03
|
||||
status: todo
|
||||
status: done
|
||||
priority: high
|
||||
state_hub_task_id: "2a0fc3d0-3dda-4c58-95de-3f70cf097ff1"
|
||||
```
|
||||
@@ -113,7 +142,7 @@ Output: adapter design note, envelope fixtures, and local fake adapter tests.
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0007-T04
|
||||
status: todo
|
||||
status: done
|
||||
priority: medium
|
||||
state_hub_task_id: "10934c46-db81-4a68-be4f-2ce95408d279"
|
||||
```
|
||||
@@ -128,7 +157,7 @@ clear installation extras if a framework is used.
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0007-T05
|
||||
status: todo
|
||||
status: done
|
||||
priority: medium
|
||||
state_hub_task_id: "a7129077-b736-4d69-94ab-d6921cd8ed15"
|
||||
```
|
||||
@@ -150,7 +179,7 @@ Output: config model, default local config, and validation diagnostics.
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0007-T06
|
||||
status: todo
|
||||
status: done
|
||||
priority: medium
|
||||
state_hub_task_id: "24ef8feb-90f8-454d-8c8f-7b3468454f57"
|
||||
```
|
||||
@@ -171,7 +200,7 @@ Output: health report helpers and tests.
|
||||
|
||||
```task
|
||||
id: PMEM-WP-0007-T07
|
||||
status: todo
|
||||
status: done
|
||||
priority: medium
|
||||
state_hub_task_id: "89c8802c-f536-441b-a514-8d3e56b3c6e5"
|
||||
```
|
||||
@@ -193,3 +222,26 @@ Output: service-readiness guide and scorecard update.
|
||||
- External adapters can be validated with reusable conformance tests.
|
||||
- Local library and CLI use remain first-class.
|
||||
- The Kontextual delegation boundary is explicit and avoids ownership drift.
|
||||
|
||||
## Closure Review - 2026-05-18
|
||||
|
||||
**Outcome:** All tasks completed.
|
||||
|
||||
### Completed
|
||||
|
||||
- PMEM-WP-0007-T01 - Define runtime service API contracts
|
||||
- PMEM-WP-0007-T02 - Add adapter conformance tests
|
||||
- PMEM-WP-0007-T03 - Add Kontextual delegation adapter design
|
||||
- PMEM-WP-0007-T04 - Add optional service runner
|
||||
- PMEM-WP-0007-T05 - Add runtime configuration model
|
||||
- PMEM-WP-0007-T06 - Add observability and health diagnostics
|
||||
- PMEM-WP-0007-T07 - Document deployment modes
|
||||
|
||||
### Cancelled
|
||||
|
||||
None.
|
||||
|
||||
### Carried Forward
|
||||
|
||||
Future work should focus on live external adapters, broader evaluation corpora,
|
||||
and optional framework-specific service bindings.
|
||||
|
||||
Reference in New Issue
Block a user