Workplan dependencies and prio for text research lab workplans

docs/workplan-planning-map.md

@@ -0,0 +1,68 @@
+# Workplan Planning Map
+
+Date: 2026-05-03
+
+## Purpose
+
+This document captures the current sequencing and priority view for
+`markitect-tool` workplans.
+
+State Hub currently supports workstream dependency edges, but it does not yet
+have native workstream priority/order fields and does not ingest dependency
+metadata from workplan frontmatter. Until that exists, this file and the
+workplan frontmatter are the repo source of truth; State Hub dependency edges
+and descriptions mirror the operational view.
+
+## Priority Scale
+
+| Priority | Meaning |
+| --- | --- |
+| `P0` | Current mainline work. |
+| `P1` | Next enabling architecture or implementation work. |
+| `P2` | High-value follow-on work, start when trigger conditions are met. |
+| `P3` | Research-lab or security-sensitive extension work. |
+| `complete` | Finished foundation or completed decision work. |
+
+## Current Ordering
+
+| Workplan | Priority | Status | Depends On | Current View |
+| --- | --- | --- | --- | --- |
+| `MKTT-WP-0001` | complete | done | none | Repository foundation is complete. |
+| `MKTT-WP-0002` | complete | done | `MKTT-WP-0001` | Legacy scope extraction is complete. |
+| `MKTT-WP-0004` | complete | done | `MKTT-WP-0001`, `MKTT-WP-0002` | Contract framework is complete and informs later validation/generation work. |
+| `MKTT-WP-0003` | P0 | active | `MKTT-WP-0001`, `MKTT-WP-0002`, `MKTT-WP-0004` | Mainline implementation. Continue with P3.5 transform/compose/include. |
+| `MKTT-WP-0006` | P1 | todo | `MKTT-WP-0004`; task-level trigger: `MKTT-WP-0003-T005` | Start after transform/composition shape is clear and before serious cache work. |
+| `MKTT-WP-0007` | P2 | todo | `MKTT-WP-0006` | First practical cache backend use case: AST/JSONPath/SQLite/FTS. |
+| `MKTT-WP-0005` | P2 | todo | `MKTT-WP-0003`, `MKTT-WP-0004` | Pick up when generation/form/context or semantic assessment pressure appears. |
+| `MKTT-WP-0009` | P2 | todo | `MKTT-WP-0006` | Establish access-control gateway before security-sensitive cache/context use. |
+| `MKTT-WP-0008` | P3 | todo | `MKTT-WP-0006`, `MKTT-WP-0007`, `MKTT-WP-0009` | Agent working-memory cache after backend and policy floor are available. |
+
+## Dependency Notes
+
+The most important nuance is `MKTT-WP-0006`: it should not wait for every task
+in `MKTT-WP-0003`, because it should shape cache architecture before `P3.7`.
+It should wait until `MKTT-WP-0003-T005` gives transform/composition enough
+shape to know what cached identities and invalidation rules must preserve.
+
+This is a mixed task/workstream dependency. State Hub does not currently model
+that natively.
+
+## State Hub Mirror
+
+Native State Hub dependency edges should mirror the whole-workstream
+dependencies:
+
+- `MKTT-WP-0002 -> MKTT-WP-0001`
+- `MKTT-WP-0004 -> MKTT-WP-0001`
+- `MKTT-WP-0004 -> MKTT-WP-0002`
+- `MKTT-WP-0003 -> MKTT-WP-0001`
+- `MKTT-WP-0003 -> MKTT-WP-0002`
+- `MKTT-WP-0003 -> MKTT-WP-0004`
+- `MKTT-WP-0006 -> MKTT-WP-0004`
+- `MKTT-WP-0007 -> MKTT-WP-0006`
+- `MKTT-WP-0005 -> MKTT-WP-0003`
+- `MKTT-WP-0005 -> MKTT-WP-0004`
+- `MKTT-WP-0009 -> MKTT-WP-0006`
+- `MKTT-WP-0008 -> MKTT-WP-0006`
+- `MKTT-WP-0008 -> MKTT-WP-0007`
+- `MKTT-WP-0008 -> MKTT-WP-0009`