---
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.