Add render reference asset manifest contract

This commit is contained in:
2026-05-15 14:08:26 +02:00
parent 03e5ae00cc
commit 305d75177a
14 changed files with 1405 additions and 20 deletions

View File

@@ -3,10 +3,10 @@ id: MKTT-WP-0021
type: workplan
title: "Render Reference And Asset Manifest Contract"
domain: markitect
status: todo
status: done
owner: markitect-tool
topic_slug: markitect
planning_priority: P2
planning_priority: complete
planning_order: 155
depends_on_workplans:
- MKTT-WP-0010
@@ -55,11 +55,31 @@ Renderer packages own:
`markitect-filter` owns only read-side source asset and attachment metadata
needed by normalized Markdown inputs.
## Implementation Summary
Completed in `markitect-tool` as a passive render reference and asset manifest
contract:
- `RenderUnitReference`, `RenderCrossReference`, and `RenderTocEntry` model
renderable units, requested cross-references, and TOC planning without final
numbering.
- `RenderAsset`, `RenderAssetManifest`, and `RenderAssetProvenance` model
static assets, copy-policy declarations, output placeholders, and source
adapter attachment provenance without asset copying.
- `RenderSourceMap` and `RenderReferenceManifest` tie Markitect source spans,
generated function outputs, render units, assets, and artifact references
together under `markitect.render.reference.v1`.
- `RenderExportRequest` can carry a passive render manifest; `render.fake`
echoes manifest and asset counts into result/artifact metadata without
invoking a renderer.
- Docs, examples, extension catalog metadata, generated API reference, and
tests were added.
## P21.1 - Define render unit references
```task
id: MKTT-WP-0021-T001
status: todo
status: done
priority: high
state_hub_task_id: "3d33d387-633e-4ffb-962e-1a5061d3db01"
```
@@ -79,7 +99,7 @@ Output: render reference model, serialization tests, and examples.
```task
id: MKTT-WP-0021-T002
status: todo
status: done
priority: medium
state_hub_task_id: "4a96e27b-9165-450c-899c-f7af484d9438"
```
@@ -93,7 +113,7 @@ Output: manifest model and tests that keep final numbering outside core.
```task
id: MKTT-WP-0021-T003
status: todo
status: done
priority: high
state_hub_task_id: "ba917e45-1912-4bdb-bf3f-5946c20957b2"
```
@@ -114,7 +134,7 @@ Output: model, examples, and compatibility note for `MKTF-WP-0003`.
```task
id: MKTT-WP-0021-T004
status: todo
status: done
priority: high
state_hub_task_id: "dd9f1128-af1e-44a8-961b-3aba6104ec9a"
```
@@ -128,7 +148,7 @@ Output: source map model, fake-renderer fixture integration, and tests.
```task
id: MKTT-WP-0021-T005
status: todo
status: done
priority: medium
state_hub_task_id: "1d472c44-d970-4403-9f0b-18e6192da737"
```