Contract robustness and bottleneck test

examples/markitect-tool-contract/README.md

@@ -0,0 +1,21 @@
+# markitect-tool Contract Examples
+
+This directory is a small interface lab for the `kontextual-engine` dependency
+on `markitect-tool`.
+
+The files are intentionally ordinary Markdown/YAML fixtures rather than inline
+test strings. They should help us validate Markitect behavior before engine
+workplans depend on it, and they should be updated whenever the expected
+integration contract changes.
+
+Covered examples:
+
+- Markdown parsing with frontmatter, headings, sections, lists, and source
+  paths.
+- Selector extraction for sections, frontmatter paths, and blocks.
+- Include resolution, heading shifts, composition, and operation provenance.
+- Snapshot identity for Markdown files.
+- Context-package creation from sources and manifests.
+- Local label policy filtering for public versus internal context.
+- Basic document contract validation for decision records.
+