Export & Handoff

A pkg/export a már legenerált munkacsomagokból és entitásokból állít össze ember által fogyasztható kimenetet. Pure assembler — nem regenerál, csak összefűz és formáz.

Formátumok és hatókörök

Kimeneti forma	Formátum	Hatókör (scope)	Hova ír
Rendszerspecifikáció (teljes projekt: L1–L4 + Gherkin + Flow-Mermaid + séma + assets + skill)	Markdown	project	.craftingtable/exports/<dátum>-project/
Sprint-csomag (N Work Package + tartalomjegyzék, story szerint)	Markdown	project	↑ ugyanoda
Egy entitás / egy Work Package lap	Markdown	business-case / user-story / work-package	↑
Docusaurus-kimenet (frontmatter + _category_.json)	Docusaurus	project	a projekt saját docs/craftingtable/ mappájába (verziózandó)
HTML (egyfájlos, nyomtatásra optimalizált, @media print)	HTML	project	.craftingtable/exports/ (PDF = böngésző „Mentés PDF-ként")
Változásnapló (két git-revízió közti kanonikus JSON diff → szöveg)	Markdown	changelog	.craftingtable/exports/

API: POST /api/v1/exports { format, scope, id? } · GET /api/v1/exports. MCP: export_project tool.

Képernyőkép — Export oldal

(A képernyőkép pótlása folyamatban.)

Szabályok

• Az export nem generál újra semmit — ha egy Work Package törzse nem elérhető, azt jelzi, nem tölti ki.
• Markdown → .craftingtable/exports/ (gitignore-olható). Docusaurus → a projekt docs/ mappájába (verziózandó).
• Minden exportált dokumentum lábléce: projekt, git-revízió, időpont, séma-verzió — így auditálható.
• Tartalom-alapú írás: ha semmi nem változott, az újbóli export nem ír lemezre.

Változásnapló

A git.Diff(dir, from, to, subpath) a .craftingtable/ fán name-status diffet ad; a export.ClassifyPath path→entitás fordítást csinál (levels/l1/BC-003.json → „Business Case · BC-003"), és kind/status szerint csoportosított Markdownt ír. Az id a git-tartomány (from..to, snapshot-id, rövid hash, HEAD~1; üres → HEAD a working tree ellen).