generated from coulomb/repo-seed
117 lines
3.1 KiB
Markdown
117 lines
3.1 KiB
Markdown
---
|
|
id: PMEM-WP-0010
|
|
type: workplan
|
|
title: "Fake External Adapter Packs"
|
|
domain: markitect
|
|
repo: phase-memory
|
|
status: finished
|
|
owner: codex
|
|
topic_slug: phase-memory
|
|
created: "2026-05-18"
|
|
updated: "2026-05-18"
|
|
---
|
|
|
|
# PMEM-WP-0010: Fake External Adapter Packs
|
|
|
|
## Goal
|
|
|
|
Provide a deterministic fake external adapter pack that exercises the same
|
|
adapter injection path live Markitect, Kontextual, semantic index, policy, and
|
|
telemetry integrations will use.
|
|
|
|
This refines the external adapter workplan direction into a testable first
|
|
slice: no live service dependency, but no silent fallback either.
|
|
|
|
## Current Evidence
|
|
|
|
PMEM-WP-0008 made `external` adapter modes explicit and blocked unresolved
|
|
external adapters. PMEM-WP-0009 added profile-driven lifecycle planning. The
|
|
remaining service-readiness gap was a supplied external adapter pack that could
|
|
pass public conformance helpers and run through the service/runtime wiring.
|
|
|
|
## Non-Goals
|
|
|
|
- Call live Markitect, Kontextual, telemetry, or policy services.
|
|
- Add credentials, network dependencies, or deployment configuration.
|
|
- Replace the local file-backed adapters.
|
|
|
|
## Implementation Update - 2026-05-18
|
|
|
|
Implemented the fake external adapter pack:
|
|
|
|
- Added `ExternalAdapterPack`.
|
|
- Added fake external graph store and event log adapters.
|
|
- Added fake Markitect package compiler.
|
|
- Added fake external policy gateway.
|
|
- Added fake telemetry audit sink with retention metadata.
|
|
- Added fake semantic index and Kontextual runtime registry.
|
|
- Added `fake_external_adapter_pack()` and `fake_external_runtime_config()`.
|
|
- Added conformance and runtime wiring tests.
|
|
- Added docs and README links.
|
|
|
|
## T01 - Add fake external adapter pack model
|
|
|
|
```task
|
|
id: PMEM-WP-0010-T01
|
|
status: done
|
|
priority: high
|
|
```
|
|
|
|
Add a small pack record with adapter instances, capabilities, and metadata.
|
|
|
|
## T02 - Add fake Markitect and Kontextual adapters
|
|
|
|
```task
|
|
id: PMEM-WP-0010-T02
|
|
status: done
|
|
priority: high
|
|
```
|
|
|
|
Provide fake package compiler and runtime registry adapters that match the
|
|
public ports.
|
|
|
|
## T03 - Add fake policy, audit, semantic, graph, and event adapters
|
|
|
|
```task
|
|
id: PMEM-WP-0010-T03
|
|
status: done
|
|
priority: high
|
|
```
|
|
|
|
Provide deterministic fake implementations for the remaining runtime ports.
|
|
|
|
## T04 - Prove external config wiring
|
|
|
|
```task
|
|
id: PMEM-WP-0010-T04
|
|
status: done
|
|
priority: high
|
|
```
|
|
|
|
Resolve an all-external runtime config with the supplied fake pack and verify
|
|
runtime package compilation plus registry publication.
|
|
|
|
## T05 - Document adapter pack usage
|
|
|
|
```task
|
|
id: PMEM-WP-0010-T05
|
|
status: done
|
|
priority: medium
|
|
```
|
|
|
|
Document fake pack usage, conformance expectations, and the relationship to
|
|
future live adapters.
|
|
|
|
## Acceptance Criteria
|
|
|
|
- The fake pack satisfies all public conformance helpers.
|
|
- An all-external runtime config resolves when the pack is supplied.
|
|
- Missing external adapter behavior remains unchanged.
|
|
- Runtime envelopes can compile packages through the fake Markitect adapter.
|
|
- Runtime envelopes can be published through the fake Kontextual registry.
|
|
|
|
## Closure Review - 2026-05-18
|
|
|
|
Closed after adding fake external adapter implementations, adapter pack helpers,
|
|
runtime wiring coverage, and documentation.
|