Add fake external adapter packs

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

@@ -0,0 +1,116 @@
+---
+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.