infospace-bench/workplans/IB-WP-0006-markitect-tool-adapter.md

id, type, title, domain, repo, status, owner, topic_slug, created, updated, state_hub_workstream_slug, state_hub_workstream_id

id	type	title	domain	repo	status	owner	topic_slug	created	updated	state_hub_workstream_slug	state_hub_workstream_id
IB-WP-0006	workplan	Markitect Tool Adapter And Markdown Artifact Validation	markitect	infospace-bench	done	markitect	markitect	2026-05-14	2026-05-14	ib-wp-0006-markitect-tool-adapter	713415b0-0c14-4367-8217-26c729648aec

IB-WP-0006 — Markitect Tool Adapter And Markdown Artifact Validation

Goal

Make markitect-tool the syntax-layer dependency of infospace-bench through a thin application adapter.

Tasks

T01 — Add dependency and adapter boundary

id: IB-WP-0006-T01
status: done
priority: high
state_hub_task_id: "b438be61-6d2a-44f9-b235-2b415e9f4bca"

• Add a local development dependency on markitect-tool
• Create src/infospace_bench/markdown_adapter.py
• Keep the adapter narrow: parse, section extraction, schema/contract validation, diagnostics

T02 — Parse Markdown artifacts through markitect-tool

id: IB-WP-0006-T02
status: done
priority: high
state_hub_task_id: "d37d6be3-ea04-4279-a113-086ab4fb617d"

• Replace ad hoc assumptions about Markdown artifacts with parsed document objects from markitect-tool
• Preserve KnowledgeArtifact as the application-level manifest object
• Add tests for heading extraction and frontmatter handling

T03 — Validate artifact contracts

id: IB-WP-0006-T03
status: done
priority: high
state_hub_task_id: "74a78679-4ef2-4b6b-a80c-b40119d9f90e"

• Support configured schema/contract references from infospace.yaml
• Return validation diagnostics in InfospaceError-compatible shapes
• Add tests for valid and invalid artifact fixtures

T04 — CLI inspection integration

id: IB-WP-0006-T04
status: done
priority: medium
state_hub_task_id: "99b4e2ca-d9be-40a5-8b10-0b0f3c18fb19"

• Extend inspect or add validate CLI behavior
• Keep output JSON and scriptable
• Document how infospace-bench delegates syntax behavior to markitect-tool

Acceptance

• infospace-bench imports markitect_tool only through the adapter
• Markdown parsing and validation are tested through real artifact fixtures
• No low-level Markdown parser logic is introduced in infospace-bench