summercms/.planning/phases/14.2.1-translate-plugin/14.2.1-03-SUMMARY.md

phase, plan, subsystem, tags, requires, provides, affects, actuals, plan_head_before, plan_head_after, plugin_repo_head_after, host_repo_head_after, tech-stack, key-files, key-decisions, patterns-established, requirements-completed, coverage, duration, completed, status

phase	plan	subsystem	tags	requires	provides	affects	actuals	plan_head_before	plan_head_after	plugin_repo_head_after	host_repo_head_after	tech-stack	key-files	key-decisions	patterns-established	requirements-completed	coverage	duration	completed	status
14.2.1-translate-plugin	03	i18n	translate cabana markdown mltext mlmarkdown TranslationWriter proof-host sm-grzybyfunkcjonalne-app	phase provides 14.2.1-02 Translatable SetTranslated/Translated/WithLocale and permissioned Locales admin	cabana markdown, mltext, and mlmarkdown field types with nested locale-map lifting Framework-owned cabana.TranslationWriter plus sm-translate-plugin Boot adapter Safe cabana.RenderMarkdown (goldmark, no unsafe HTML) SPA MarkdownField, MLTextField, MLMarkdownField with shared locale selector Docs, regenerated OpenAPI/TS, committed boardwalk dist sm-grzybyfunkcjonalne-app boots golem15.user + golem15.translate from durable submodules	14.2.1-04 tests 15-journal-plugin	tokens tasks commits 27343 3 2	234111d245	e3b3475b1c	a3553b9c4b8a9c83debe950198f568ee9b6000a6	4d32e86	added patterns ML locale maps are lifted before ProjectWritableFields; default locale fills the host scalar; other locales go through TranslationWriter inside the host save transaction Proof host mounts compiled plugins as git submodules at plugins/golem15/{user,translate} with go.work use plus host and workspace replaces	created modified modules/cabana/field_ml.go modules/cabana/field_markdown.go modules/cabana/ml_smoke_test.go admin/src/components/form/fields/MarkdownField.vue admin/src/components/form/fields/MLTextField.vue admin/src/components/form/fields/MLMarkdownField.vue admin/tests/form/MLFields.test.ts ../sm-translate-plugin/classes/admin_writer.go ../sm-grzybyfunkcjonalne-app/summer.yaml ../sm-grzybyfunkcjonalne-app/go.work ../sm-grzybyfunkcjonalne-app/.gitmodules ../sm-grzybyfunkcjonalne-app/boot_test.go modules/cabana/form_schema.go modules/cabana/crud.go modules/cabana/README.md docs/backend/forms.md docs/backend/admin-controllers.md admin/src/components/form/registry.ts admin/src/components/form/formState.ts admin/tests/form/registry.test.ts modules/boardwalk/dist/ ../sm-translate-plugin/plugin.go	Task 2 locked grzyby-submodules: the proof host is sm-grzybyfunkcjonalne-app with plugins/golem15/user and plugins/golem15/translate Host go.work replace points at ../summercms.go so the plugin sibling replace is overridden when mounted	cabana.TranslationWriter lives in the framework; the translate plugin Boot-publishes an adapter; there is no public translate-write endpoint mlmarkdown composes MarkdownField; goldmark stays in cabana.RenderMarkdown without html.WithUnsafe	D-06 D-09 D-12 D-13 D-14 D-15 D-16 D-17	id description requirement verification human_judgment D1 Nested mltext save lifts the locale map, writes English on the host column, and Polish through TranslationWriter D-06 kind ref status unit modules/cabana#TestMLNestedSaveSmoke pass false id description requirement verification human_judgment D2 SPA registry resolves markdown/mltext/mlmarkdown, sends nested locale records, and sanitizes markdown preview D-06 kind ref status unit admin/tests/form/MLFields.test.ts pass kind ref status unit admin/tests/form/registry.test.ts pass false id description verification human_judgment D3 Cabana README, forms/admin docs, OpenAPI, generated TS types, and boardwalk dist stay in sync with application-neutral examples kind ref status other go test ./cmd/summer -run TestDocsTree && go run ./cmd/summer docs:build --check pass kind ref status other scripts/check-admin-openapi.sh && npm --prefix admin run build pass false id description requirement verification human_judgment D4 sm-grzybyfunkcjonalne-app mounts user and translate as submodules, generates the plugin list, and registers Locales admin D-13 kind ref status integration sm-grzybyfunkcjonalne-app#TestBootUserTranslate pass false id description requirement verification human_judgment rationale D5 Task 2 proof-host layout locked as grzyby-submodules D-13 true Layout choice is a recorded human decision, not an automated assertion	5min	2026-10-06	complete

Phase 14.2.1 Plan 03: Cabana ML fields and proof-host boot Summary

Cabana markdown/mltext/mlmarkdown with transactional TranslationWriter saves, regenerated admin artifacts, and sm-grzybyfunkcjonalne-app booting user+translate from durable submodules

Performance

• Duration: 5 min (continuation from Task 2; Task 1 landed in a prior executor)
• Started: 2026-10-06T11:23:45Z
• Completed: 2026-10-06T11:29:17Z
• Tasks: 3
• Files modified: 40
• Token actuals: 27343 (chars/4 excluding rebuilt modules/boardwalk/dist; 320645 including it)

Accomplishments

• Cabana accepts markdown, mltext, and mlmarkdown. Nested locale maps are lifted before ProjectWritableFields; the default locale fills the host scalar; other locales reach cabana.TranslationWriter inside the permissioned host save transaction. cabana.RenderMarkdown uses goldmark without unsafe HTML.
• The SPA sends Record<string,string> per ML field, shares one locale selector across controls, copies from another locale, and composes mlmarkdown from MarkdownField.
• Cabana README, docs/backend/forms.md, and admin-controller save semantics are updated with acme/blog examples. OpenAPI was regenerated (unchanged), TypeScript types regenerated, and modules/boardwalk/dist/ rebuilt.
• Task 2 recorded grzyby-submodules. sm-grzybyfunkcjonalne-app mounts plugins/golem15/user @ 0fe5b91 and plugins/golem15/translate @ a3553b9, uses go.work plus host replaces, lists only golem15.user and golem15.translate, and TestBootUserTranslate activates both plugins and sees Locales admin. Journal is absent. Go tables remain golem15_translate_*.

Task Commits

Each task was committed atomically:

1. Task 1: Submit one mltext map through cabana and persist default plus Polish values
   • a04116d (feat) summercms.go — markdown and multilingual cabana fields
   • a3553b9 (feat) sm-translate-plugin — publish cabana TranslationWriter adapter
2. Task 2: Confirm the one-way proof-host submodule layout — decision grzyby-submodules (no code commit)
3. Task 3: Complete docs/OpenAPI/TS/dist and boot the user+translate proof host
   • e3b3475 (feat) summercms.go — docs, registry tests, boardwalk dist
   • 4d32e86 (feat) sm-grzybyfunkcjonalne-app — host layout and boot smoke

Plan metadata: (this commit)

The proof host was not pushed. summercms.go was not pushed.

Files Created/Modified

• modules/cabana/field_ml.go — locale-map lift and TranslationWriter bridge
• modules/cabana/field_markdown.go — RenderMarkdown
• modules/cabana/ml_smoke_test.go — nested {en,pl} save smoke
• admin/src/components/form/fields/{Markdown,MLText,MLMarkdown}Field.vue
• admin/tests/form/MLFields.test.ts and registry.test.ts
• modules/cabana/README.md, docs/backend/forms.md, docs/backend/admin-controllers.md
• modules/boardwalk/dist/ — regenerated Vite output
• ../sm-translate-plugin/classes/admin_writer.go and plugin.go Boot publish
• ../sm-grzybyfunkcjonalne-app/{summer.yaml,go.mod,go.work,.gitmodules,main.go,plugins.gen.go,boot_test.go}

Decisions Made

• Task 2 selected grzyby-submodules: durable proof-host layout is sm-grzybyfunkcjonalne-app with plugins/golem15/user and plugins/golem15/translate, matching D-13/D-16 and sm-bm-app. fonoteka-host and vendored-copy were not taken.
• Host go.work replace git.golem15.com/golem15/summercms => ../summercms.go overrides the translate plugin's sibling ../summercms.go replace when the plugin is mounted at plugins/golem15/translate.
• OpenAPI/TS were regenerated with scripts/check-admin-openapi.sh; the document did not change because no swag annotations were added. Dist was rebuilt, not hand-edited.

Deviations from Plan

Auto-fixed Issues

1. [Rule 3 - Blocking] Vitest --run paths are relative to admin/

• Found during: Task 3 verify
• Issue: npm --prefix admin test -- --run admin/tests/form/registry.test.ts ... reports no test files because Vitest's cwd is admin/ and include is tests/**/*.test.ts.
• Fix: Ran tests/form/registry.test.ts tests/form/MLFields.test.ts (50 passed).
• Files modified: none
• Verification: Vitest Test Files 2 passed (2), Tests 50 passed (50)
• Committed in: n/a (command-only)

---

Total deviations: 1 auto-fixed (1 blocking) Impact on plan: Required for the written verify command's intent. No API or layout change.

Issues Encountered

None beyond the Vitest path mismatch.

Authentication Gates

None.

User Setup Required

None - no external service configuration required.

Next Phase Readiness

• Ready for 14.2.1-04 unit/integration tests.
• Journal (Phase 15) can mount on this host using the same submodule paths.
• Proof host commit 4d32e86 is local only; push when a later plan requires it.

---

Phase: 14.2.1-translate-plugin Completed: 2026-10-06

Self-Check: PASSED