phase-memory/workplans/PMEM-WP-0010-fake-external-adapter-packs.md

id, type, title, domain, repo, status, owner, topic_slug, created, updated, state_hub_workstream_id

id	type	title	domain	repo	status	owner	topic_slug	created	updated	state_hub_workstream_id
PMEM-WP-0010	workplan	Fake External Adapter Packs	markitect	phase-memory	finished	codex	phase-memory	2026-05-18	2026-05-18	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

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

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

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

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

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.