generated from coulomb/repo-seed
145 lines
9.1 KiB
Markdown
145 lines
9.1 KiB
Markdown
# Workplan Planning Map
|
|
|
|
Date: 2026-05-04
|
|
|
|
## 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` | complete | done | `MKTT-WP-0001`, `MKTT-WP-0002`, `MKTT-WP-0004` | Core toolkit implementation is complete. |
|
|
| `MKTT-WP-0006` | complete | done | `MKTT-WP-0004`; task-level trigger: `MKTT-WP-0003-T005` | Optional backend fabric is complete: manifests, capabilities, snapshot identity, interfaces, registry, provenance, and read-only CLI scaffolding. |
|
|
| `MKTT-WP-0010` | complete | done | `MKTT-WP-0004`; task-level trigger: `MKTT-WP-0003-T006` | Content references, processors, explode/implode, weave/tangle, content classes, and migration examples are complete as the first WP-0010 extension layer. |
|
|
| `MKTT-WP-0007` | complete | done | `MKTT-WP-0006` | Advanced query and local index backend is complete: AST inspection, optional JSONPath, SQLite snapshots/metadata, FTS5 search, incremental refresh, and local index CLI. |
|
|
| `MKTT-WP-0013` | complete | done | `MKTT-WP-0003`, `MKTT-WP-0004`, `MKTT-WP-0006`, `MKTT-WP-0007`, `MKTT-WP-0010` | Internal extension framework is complete: characterization tests, canonical processing model, descriptors, registries, lifecycle callbacks, query-engine registry, built-in extension catalog, CLI command specs, and authoring guide. |
|
|
| `MKTT-WP-0005` | complete | done | `MKTT-WP-0003`, `MKTT-WP-0004` | Runtime context, form state, dynamic rules, workflow integration, and provider-neutral assessment boundary are complete. |
|
|
| `MKTT-WP-0011` | complete | done | `MKTT-WP-0003`; task-level triggers: `MKTT-WP-0010-T001`, `MKTT-WP-0010-T005` | Markdown dataflow workflow layer is complete: workflow standard, source collectors, binding model, deterministic steps, assisted boundary, safe outputs, CLI, docs, and examples. |
|
|
| `MKTT-WP-0009` | complete | done | `MKTT-WP-0006` | Access-controlled knowledge gateway is complete: local labels, trust zones, path rules, policy-aware cache query/search, decisions, diagnostics, and external adapter boundaries. |
|
|
| `MKTT-WP-0014` | complete | done | `MKTT-WP-0009` | Markitect-side enterprise IAM access-control integration is complete: NetKingdom/key-cape-compatible identity claims, flex-auth resource/policy contract, directory group resolution fixtures, decision-log sink, workflow declarations, CLI commands, and external PDP request examples. |
|
|
| `MKTT-WP-0012` | complete | done | `MKTT-WP-0004`, `MKTT-WP-0010`, `MKTT-WP-0011` | Document function layer is complete: deterministic Markdown-native function descriptors, registry, inline/fenced syntax, pipelines, context bindings, CLI, docs, examples, diagnostics, provenance, and extension descriptor. |
|
|
| `MKTT-WP-0008` | complete | done | `MKTT-WP-0006`, `MKTT-WP-0007`, `MKTT-WP-0009` | Agent working-memory context cache is complete: context package schema, local registry, package creation from queries/search/manifests, deterministic summaries, namespaces, activation/deactivation/refresh/explain lifecycle, policy re-checks, CLI, docs, and examples. |
|
|
| `MKTT-WP-0015` | P2 | todo | `MKTT-WP-0010`, `MKTT-WP-0011`, `MKTT-WP-0012` | Future render and document-function extensions: typed values, richer syntax, document-local reusable functions, Quarkdown/export adapters, render-aware references, assets, and permission sandboxing. Defer unless publishing/export pressure becomes current. |
|
|
|
|
## Dependency Notes
|
|
|
|
The first 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.
|
|
|
|
The second important nuance is `MKTT-WP-0010`: it captures richer content
|
|
reference, processor, explode/implode, and weave/tangle work. Its task-level
|
|
trigger `MKTT-WP-0003-T006` is now satisfied. It should inform backend, index,
|
|
context-memory, and access-control architecture before those become rigid.
|
|
|
|
These are mixed task/workstream dependencies. State Hub does not currently model
|
|
them natively.
|
|
|
|
`MKTT-WP-0011` captures the practical workflow layer that wires existing
|
|
primitives together: Markdown sources, selectors, deterministic processors,
|
|
optional assisted generation hooks, and multiple Markdown outputs. It should not
|
|
block P3.7, but it should follow the first reference model and processor
|
|
registry decisions in `MKTT-WP-0010`.
|
|
|
|
`MKTT-WP-0013` captures internal extensibility pressure found while adding
|
|
optional query, backend, processor, and index features. It should precede major
|
|
runtime/workflow expansion because it reduces central wiring and gives future
|
|
features a canonical processing context/result/diagnostic/provenance model. It
|
|
is not a business dataflow layer; that remains `MKTT-WP-0011`.
|
|
|
|
`MKTT-WP-0012` completed the Quarkdown-inspired document function layer as a
|
|
deterministic authoring surface over existing Markitect capabilities. Assisted,
|
|
external, file, network, render/export, and provider-backed functions remain
|
|
future optional extensions behind local capability and policy gates.
|
|
|
|
`MKTT-WP-0015` captures those optional future extensions explicitly. It should
|
|
not disturb the deterministic core. Its Quarkdown lesson is the typed value
|
|
and render pipeline shape: functions can return document values that are mapped
|
|
back to renderable content, while render/export, media, permissions, and
|
|
numbering stay explicit extension concerns.
|
|
|
|
`MKTT-WP-0014` completed Markitect-side enterprise IAM integration for the
|
|
access-control gateway. Central authorization administration remains optional
|
|
external-service scope; Markitect now provides resource registration, policy
|
|
request, decision, diagnostics, local development adapter contracts, workflow
|
|
declarations, and CLI inspection/mapping commands. Remaining Markitect
|
|
workplans should depend only on Markitect-local contracts and adapter
|
|
protocols. A live flex-auth service can improve enterprise deployment, central
|
|
policy administration, and durable audit, but it is not a prerequisite for the
|
|
document function layer or local agent context packages.
|
|
|
|
Remaining Markitect workplans, including the future `MKTT-WP-0015` extension
|
|
track, should keep this policy posture:
|
|
|
|
- use `AccessPolicyGateway`, `PolicySubject`, `PolicyObject`, and
|
|
`PolicyDecision` as local contracts
|
|
- support local label policy and deterministic test fixtures first
|
|
- treat flex-auth, OpenFGA, OPA, Cedar, Keycloak, Entra, and other external
|
|
systems as optional adapters
|
|
- never make external IAM or authorization services required for core Markdown
|
|
parsing, deterministic functions, workflows, cache queries, or context
|
|
package lifecycle
|
|
|
|
`MKTT-WP-0008` completed the local agent working-memory package layer. It
|
|
deliberately implements explicit, inspectable context packages rather than
|
|
hidden ambient agent memory. LLM-assisted summaries, embeddings, vector stores,
|
|
remote registries, retention/decay, and reviewed long-term identity packages
|
|
remain future optional extensions.
|
|
|
|
## 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-0010 -> MKTT-WP-0004`
|
|
- `MKTT-WP-0007 -> MKTT-WP-0006`
|
|
- `MKTT-WP-0005 -> MKTT-WP-0003`
|
|
- `MKTT-WP-0005 -> MKTT-WP-0004`
|
|
- `MKTT-WP-0011 -> MKTT-WP-0003`
|
|
- `MKTT-WP-0009 -> MKTT-WP-0006`
|
|
- `MKTT-WP-0013 -> MKTT-WP-0003`
|
|
- `MKTT-WP-0013 -> MKTT-WP-0004`
|
|
- `MKTT-WP-0013 -> MKTT-WP-0006`
|
|
- `MKTT-WP-0013 -> MKTT-WP-0007`
|
|
- `MKTT-WP-0013 -> MKTT-WP-0010`
|
|
- `MKTT-WP-0012 -> MKTT-WP-0004`
|
|
- `MKTT-WP-0012 -> MKTT-WP-0010`
|
|
- `MKTT-WP-0012 -> MKTT-WP-0011`
|
|
- `MKTT-WP-0014 -> MKTT-WP-0009`
|
|
- `MKTT-WP-0008 -> MKTT-WP-0006`
|
|
- `MKTT-WP-0008 -> MKTT-WP-0007`
|
|
- `MKTT-WP-0008 -> MKTT-WP-0009`
|
|
- `MKTT-WP-0015 -> MKTT-WP-0010`
|
|
- `MKTT-WP-0015 -> MKTT-WP-0011`
|
|
- `MKTT-WP-0015 -> MKTT-WP-0012`
|