Archived

This repository has been archived on 2026-07-08. You can view files and clone it. You cannot open issues or pull requests or push a commit.

Go to file

tegwick 7031369d76 Draft capability entry (reuse-surface REUSE-WP-0017-T04, cohort 2)

Honest first-pass maturity vector grounded in README/docs/tests present
in this repo; no invented evidence. Flagged for human review before
publish. See reuse-surface history/2026-07-06-coverage-classification.md.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

2026-07-06 19:41:37 +02:00

.claude/rules

Normalize agent instructions and workplan frontmatter (STATE-WP-0067)

2026-06-22 23:16:27 +02:00

docs

Add source attachment metadata compatibility

2026-05-15 14:36:24 +02:00

examples/source-attachments

Add source attachment metadata compatibility

2026-05-15 14:36:24 +02:00

registry

Draft capability entry (reuse-surface REUSE-WP-0017-T04, cohort 2)

2026-07-06 19:41:37 +02:00

src/markitect_filter

Add source attachment metadata compatibility

2026-05-15 14:36:24 +02:00

tests

Add source attachment metadata compatibility

2026-05-15 14:36:24 +02:00

workplans

Normalize agent instructions and workplan frontmatter (STATE-WP-0067)

2026-06-22 23:16:27 +02:00

.custodian-brief.md

chore(consistency): sync task status from DB [auto]

2026-07-03 18:48:30 +02:00

.gitignore

Initial commit

2026-05-14 18:06:43 +00:00

.repo-classification.yaml

Add .repo-classification.yaml (CUST-WP-0050 T11 agent first-pass)

2026-06-22 17:47:38 +02:00

AGENTS.md

Normalize agent instructions and workplan frontmatter (STATE-WP-0067)

2026-06-22 23:16:27 +02:00

CLAUDE.md

Add credential routing instructions for all agent runtimes

2026-06-18 22:48:38 +02:00

INTENT.md

Added intent specification

2026-05-14 20:40:24 +02:00

LICENSE

Initial commit

2026-05-14 18:06:43 +00:00

pyproject.toml

feat(source): add pdf read adapter

2026-05-14 23:33:31 +02:00

README.md

Add source attachment metadata compatibility

2026-05-15 14:36:24 +02:00

SCOPE.md

Add repository scope profile

2026-05-15 15:20:33 +02:00

README.md

markitect-filter

markitect-filter provides concrete source-format adapters for converting external document formats into canonical Markitect Markdown representations.

The first adapters are read-only source adapters that implement the markitect-tool source adapter contract:

source.epub3 for EPUB3 packages
source.pdf for digitally-readable PDFs

Development

Run tests from this checkout:

PYTHONPATH=src:/home/worsch/markitect-tool/src python3 -m pytest

The EPUB3 adapter is registered through:

[project.entry-points."markitect_tool.source_adapters"]
epub3 = "markitect_filter.adapters:epub3_adapter_descriptor"
pdf = "markitect_filter.adapters:pdf_adapter_descriptor"

The first PDF slice is stdlib-only and targets deterministic text extraction from local, digitally-readable PDFs. OCR, scanned-document recognition, and layout-perfect reconstruction are intentionally deferred.

Read-side attachment metadata is exposed through NormalizedMarkdownDocument.attachments for EPUB3 package resources, PDF embedded files, and PDF image-resource signals. See docs/source-attachment-metadata.md for the handoff contract to passive render asset manifests.