markitect-filter/registry/capabilities/capability.communication.markitect-source-adapters.md

id, name, summary, owner, status, domain, tags, maturity, external_evidence, discovery, availability, relations, evidence, consumer_guidance, promotion_history

id	name	summary	owner	status	domain	tags	maturity	external_evidence	discovery	availability	relations	evidence	consumer_guidance	promotion_history
capability.communication.markitect-source-adapters	Markitect Source-Format Adapters	Concrete source-format adapters (EPUB3, PDF) converting external document formats into canonical Markitect Markdown, implementing the markitect-tool source adapter contract.	markitect-filter	draft	communication	markitect adapter document-conversion	discovery availability current target confidence rationale D2 D4 medium README documents the two shipped adapters (source.epub3, source.pdf), their registration via Python entry points, and explicit conformance to the markitect-tool source adapter contract. current target confidence rationale A1 A3 medium Registered as pip entry points (`markitect_tool.source_adapters`) consumed by markitect-tool; requires a sibling markitect-tool checkout on PYTHONPATH to run tests.	completeness reliability level confidence basis satisfied_expectations broken_expectations out_of_scope_expectations C1 low scope_vs_intent_and_consumer_expectations EPUB3 and PDF read-only source adapters implementing the documented contract level confidence basis known_reliability_risks R0 low consumer_quality_signals tightly coupled to markitect-tool's source adapter contract version; no independent versioning story documented	intent includes excludes assumptions use_cases research_memos Provide concrete, contract-conformant adapters converting EPUB3/PDF into canonical Markitect Markdown, without markitect-tool needing to know about specific external formats. EPUB3 source adapter (source.epub3) PDF source adapter (source.pdf) the markitect-tool source adapter contract itself (owned by markitect-tool) write/export adapters (read-only source adapters only)	current_level target_level current_artifacts target_artifacts consumption_modes A1 A3 Python package (`markitect-filter`) registering entry points library import (plugin/entry-point)	depends_on supports related_to	documentation tests consumer_feedback bug_reports incidents README.md tests/	recommended_for not_recommended_for known_limitations markitect-tool consumers needing EPUB3 or PDF ingestion needs for markdown output/export adapters (not in scope here) tests require a sibling markitect-tool checkout on PYTHONPATH; not standalone-runnable

Markitect Source-Format Adapters

Overview

markitect-filter implements concrete, read-only source-format adapters — EPUB3 and PDF — that convert external document formats into canonical Markitect Markdown, registered as Python entry points against the markitect-tool source adapter contract.

Assessment notes

Discovery

README documents the two shipped adapters (source.epub3, source.pdf), their registration via Python entry points, and explicit conformance to the markitect-tool source adapter contract.

Availability

Registered as pip entry points (markitect_tool.source_adapters) consumed by markitect-tool; requires a sibling markitect-tool checkout on PYTHONPATH to run tests.

Completeness

First-pass honest assessment from the REUSE-WP-0017 coverage campaign (reuse-surface). No external consumer feedback exists yet; levels reflect scope-vs-intent documentation quality, not internal code quality.

Reliability

No production consumer telemetry exists yet; reliability level is intentionally conservative pending REUSE-WP-0019 reuse-telemetry evidence.

Promotion checklist

• ID follows capability.<domain>.<name> pattern
• Maturity enums match specs/CapabilityMaturityStandard.md
• external_evidence is populated separately from maturity
• Relations reference valid capability IDs (none yet)
• Index entry added in registry/indexes/capabilities.yaml