Workplan refinement and examples

workplans/MKTT-WP-0018-source-adapter-contract.md

@@ -3,10 +3,10 @@ id: MKTT-WP-0018
 type: workplan
 title: "Source Adapter Interface And Markdown Normalization Contract"
 domain: markitect
-status: todo
+status: active
 owner: markitect-tool
 topic_slug: markitect
-planning_priority: P1
+planning_priority: P0
 planning_order: 145
 depends_on_workplans:
   - MKTT-WP-0013
@@ -70,7 +70,8 @@ new `markitect-filter` repo.
 `MKTT-WP-0019` must run first and pin the v1 contract details for this
 implementation: field-level normalized model semantics, read-only protocol
 shape, external package entry point discovery, CLI/API output envelopes, and
-fake adapter contract-test expectations.
+fake adapter contract-test expectations. Those decisions are captured in
+`docs/source-adapter-contract.md`.
 
 `markitect-tool` should define:
 
@@ -120,8 +121,8 @@ Implement the cross-repo architecture pinned by `MKTT-WP-0019`:
 - `kontextual-engine` can ingest adapter outputs into durable knowledge assets
 
 Output: architecture note covering responsibilities, extension package shape,
-the pinned entry point contract, dependency policy, and migration path from the
-current `infospace-bench` EPUB spike.
+the `docs/source-adapter-contract.md` entry point contract, dependency policy,
+and migration path from the current `infospace-bench` EPUB spike.
 
 ## P18.2 - Canonical source-to-markdown data model
 
@@ -132,7 +133,8 @@ priority: high
 state_hub_task_id: "f8164264-a9c1-4c82-8617-76bbb84a51bb"
 ```
 
-Implement the normalized output model specified by `MKTT-WP-0019`:
+Implement the normalized output model specified by
+`docs/source-adapter-contract.md`:
 
 - `SourceAsset`
 - `SourceMetadata`
@@ -154,7 +156,8 @@ The model should represent:
 - lossiness/quality signals
 - adapter name/version/options
 
-Output: public data model, serialization tests, and normalization contract
+Output: public data model, serialization tests using
+`examples/source-adapters/normalized-document.json`, and normalization contract
 documentation matching the field-level v1 specification.
 
 ## P18.3 - Source adapter protocol and capability descriptors
@@ -199,7 +202,7 @@ Wire source adapters into the existing internal extension framework:
 
 - register source adapter descriptors
 - discover package-provided adapters through the entry point group pinned by
-  `MKTT-WP-0019`
+  `docs/source-adapter-contract.md`
 - expose adapter capabilities via extension listing/inspection
 - report missing optional dependency diagnostics
 - ensure adapter packages can remain independently versioned
@@ -284,3 +287,5 @@ Output: migration note and follow-up workplan seeds for `markitect-filter` and
   `markitect-tool` or `infospace-bench`.
 - Writer/export adapter support is explicitly deferred beyond the v1 read
   adapter contract.
+- Implementation behavior matches `docs/source-adapter-contract.md` and the
+  fixtures in `examples/source-adapters/`.