generated from coulomb/repo-seed
123 lines
3.5 KiB
Markdown
123 lines
3.5 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"
|
|
state_hub_workstream_id: "59eb9132-f7f3-4d94-81ee-e0636a325a7c"
|
|
---
|
|
|
|
# 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
|
|
state_hub_task_id: "3d6a94bc-0802-43fb-8ba8-d177075ca740"
|
|
```
|
|
|
|
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
|
|
state_hub_task_id: "301c96ec-dced-4802-8db6-7e451bee6e80"
|
|
```
|
|
|
|
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
|
|
state_hub_task_id: "6b54315e-7430-465e-9450-22595b52d0ea"
|
|
```
|
|
|
|
Provide deterministic fake implementations for the remaining runtime ports.
|
|
|
|
## T04 - Prove external config wiring
|
|
|
|
```task
|
|
id: PMEM-WP-0010-T04
|
|
status: done
|
|
priority: high
|
|
state_hub_task_id: "60774397-8384-45bd-9ccc-5926034ffa46"
|
|
```
|
|
|
|
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
|
|
state_hub_task_id: "23a7d8ba-13ce-4400-ad14-d0b94c134082"
|
|
```
|
|
|
|
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.
|