State-hub connect and initial workplans

workplans/MKTT-WP-0001-repo-foundation.md

@@ -0,0 +1,82 @@
+---
+id: MKTT-WP-0001
+type: workplan
+title: "markitect-tool Repository Foundation"
+domain: markitect
+status: active
+owner: markitect-tool
+topic_slug: markitect
+created: "2026-05-03"
+updated: "2026-05-03"
+state_hub_workstream_id: "4d405d74-faec-440e-873e-692ff9ca96e7"
+---
+
+# MKTT-WP-0001: markitect-tool Repository Foundation
+
+## Purpose
+
+Establish this repository as the State Hub-connected successor workspace for
+the in-scope core of `markitect-main`.
+
+## P1.1 - Integrate State Hub repository registration
+
+```task
+id: MKTT-WP-0001-T001
+status: done
+priority: high
+state_hub_task_id: "34d2fba4-a03c-4d8f-a25c-b19a1c2f698d"
+```
+
+Register `markitect-tool` under the `markitect` domain, record the repo slug,
+and preserve the integration details in repository documentation.
+
+## P1.2 - Add agent-facing repo rules
+
+```task
+id: MKTT-WP-0001-T002
+status: done
+priority: high
+state_hub_task_id: "b19f88a0-850e-428e-8131-4c4af2cbfc42"
+```
+
+Create `CLAUDE.md` and `.claude/rules/` material so future sessions start from
+the new PRD/FRS and the State Hub-backed workplan convention.
+
+## P1.3 - Establish workplan convention
+
+```task
+id: MKTT-WP-0001-T003
+status: done
+priority: high
+state_hub_task_id: "4a770e4f-81b0-4f82-8f46-5886ee2fae36"
+```
+
+Create `workplans/` and seed source-of-truth workplans for foundation,
+migration assessment, and implementation.
+
+## P1.4 - Add initial project packaging decision
+
+```task
+id: MKTT-WP-0001-T004
+status: todo
+priority: medium
+state_hub_task_id: "c15f8492-93d0-43aa-ba12-0d4aaff97c03"
+```
+
+Choose package/module names, Python version target, dependency manager, and
+test runner. Keep the decision lightweight and aligned with the future `mkt`
+CLI entry point.
+
+## P1.5 - Add SBOM source once manifests exist
+
+```task
+id: MKTT-WP-0001-T005
+status: blocked
+priority: medium
+state_hub_task_id: "e77a5e46-aaa2-4717-922f-a871fa2fd1cc"
+```
+
+After packaging files are introduced, generate or identify the SBOM source and
+update State Hub registration metadata.
+
+Blocked because the repository has no implementation package manifest yet.

workplans/MKTT-WP-0002-markitect-main-migration.md

@@ -0,0 +1,87 @@
+---
+id: MKTT-WP-0002
+type: workplan
+title: "markitect-main Scope Extraction"
+domain: markitect
+status: active
+owner: markitect-tool
+topic_slug: markitect
+created: "2026-05-03"
+updated: "2026-05-03"
+state_hub_workstream_id: "0fe54d2c-d579-4b03-a647-7a15bb835893"
+---
+
+# MKTT-WP-0002: markitect-main Scope Extraction
+
+## Purpose
+
+Inventory `markitect-main`, identify which behavior belongs in the new
+syntax-layer toolkit, and prepare migration/reimplementation slices.
+
+## P2.1 - Complete first-pass scope assessment
+
+```task
+id: MKTT-WP-0002-T001
+status: done
+priority: high
+state_hub_task_id: "950de9fd-7540-4e0f-bc4a-2fa86fc9fccc"
+```
+
+Compare the old repo against the new PRD/FRS and document candidate modules,
+out-of-scope areas, and migration principles.
+
+## P2.2 - Extract reusable behavior test list
+
+```task
+id: MKTT-WP-0002-T002
+status: todo
+priority: high
+state_hub_task_id: "994a8c17-bd13-476b-9b8e-86c50e1c4897"
+```
+
+Review `markitect-main/tests`, `testdata`, schema fixtures, and CLI integration
+tests. Create a candidate test migration list organized by FRS section.
+
+Technical debt: `TD-MKTT-002`.
+
+## P2.3 - Map legacy commands to `mkt`
+
+```task
+id: MKTT-WP-0002-T003
+status: todo
+priority: high
+state_hub_task_id: "f82b1f2c-887b-4378-b70b-84c1cb051742"
+```
+
+Inventory old `markitect` CLI commands and classify each as migrate,
+reimplement, rename, defer, or out of scope for `mkt`.
+
+## P2.4 - Decide compatibility policy
+
+```task
+id: MKTT-WP-0002-T004
+status: todo
+priority: medium
+state_hub_task_id: "56a12905-c3ec-42b0-893a-47ef023ea10a"
+```
+
+Define whether any old module paths, command names, file formats, or schema
+names deserve compatibility shims in the successor.
+
+## Extension Points
+
+`EP-MKTT-002` tracks the query backend adapter boundary: keep the initial query
+API small, but leave room for JSONPath-like or alternate selectors if they fit
+the provider-neutral contract.
+
+## P2.5 - Identify external dependencies
+
+```task
+id: MKTT-WP-0002-T005
+status: todo
+priority: medium
+state_hub_task_id: "4d51e763-bf5f-483b-8948-6306ff5a58bb"
+```
+
+Separate core dependencies from optional integrations. Initial candidates:
+`markdown-it-py`, `PyYAML`, `jsonpath-ng`, and optional `llm-connect`.

workplans/MKTT-WP-0003-core-toolkit-implementation.md

@@ -0,0 +1,117 @@
+---
+id: MKTT-WP-0003
+type: workplan
+title: "Core Markdown Toolkit Implementation"
+domain: markitect
+status: active
+owner: markitect-tool
+topic_slug: markitect
+created: "2026-05-03"
+updated: "2026-05-03"
+state_hub_workstream_id: "9fefb57d-985e-4125-8daf-03554844f45e"
+---
+
+# MKTT-WP-0003: Core Markdown Toolkit Implementation
+
+## Purpose
+
+Build the first usable `markitect-tool` implementation around the PRD/FRS
+contract and the `mkt` CLI.
+
+## P3.1 - Bootstrap package and tests
+
+```task
+id: MKTT-WP-0003-T001
+status: todo
+priority: high
+state_hub_task_id: "9d9501fe-6809-4b4f-bda6-ec5e5952ddc7"
+```
+
+Create project metadata, package layout, test structure, and a minimal CLI
+entry point that can be installed or run locally.
+
+## P3.2 - Implement structured markdown parse contract
+
+```task
+id: MKTT-WP-0003-T002
+status: todo
+priority: high
+state_hub_task_id: "7dead033-e249-46b0-9eb3-908ae231a987"
+```
+
+Implement FR-001 and FR-002: parse markdown files, preserve headings,
+frontmatter, sections, and content blocks, and expose structured output via
+API and CLI.
+
+## P3.3 - Implement schema load and validation
+
+```task
+id: MKTT-WP-0003-T003
+status: todo
+priority: high
+state_hub_task_id: "36a22def-d415-4c08-a793-836ee52e4308"
+```
+
+Implement FR-010 through FR-012: define/derive schemas, validate documents,
+and report structured violations with file/location context.
+
+## P3.4 - Implement query and extraction
+
+```task
+id: MKTT-WP-0003-T004
+status: todo
+priority: medium
+state_hub_task_id: "e4f72218-601e-488f-a5df-171b91a747d2"
+```
+
+Implement FR-030 and FR-031 over the structured representation. Start with a
+small query language or JSONPath-like adapter only if it remains simple.
+
+## P3.5 - Implement transform, compose, and include primitives
+
+```task
+id: MKTT-WP-0003-T005
+status: todo
+priority: medium
+state_hub_task_id: "205d69eb-dd34-46a5-af0b-cc2de9d213d0"
+```
+
+Implement FR-020 through FR-022 as deterministic document operations. Keep
+transclusion syntax and resolution rules explicit and testable.
+
+## P3.6 - Implement templating and generation hooks
+
+```task
+id: MKTT-WP-0003-T006
+status: todo
+priority: medium
+state_hub_task_id: "307fa072-b1ce-42e8-9309-e2a92e130ae1"
+```
+
+Implement FR-040 through FR-042 with deterministic templates first and optional
+LLM-assisted hooks supplied by external providers.
+
+Extension point: `EP-MKTT-001`.
+
+## P3.7 - Add caching and incremental processing
+
+```task
+id: MKTT-WP-0003-T007
+status: todo
+priority: low
+state_hub_task_id: "236f90e3-1d79-473f-8c57-bcbbde9ece02"
+```
+
+Implement FR-070 and FR-071 after the parse/schema contracts are stable.
+
+## Known Technical Debt
+
+```task
+id: MKTT-WP-0003-T008
+status: todo
+priority: medium
+state_hub_task_id: "94067c7e-e68b-45be-a1d6-90547eb15422"
+```
+
+Resolve `TD-MKTT-001` by adding the implementation scaffold: package metadata,
+module layout, test runner, and `mkt` CLI entry point.