# Journal — 2026-06-23

## Grouped OKF fields in the document-view margin

Regrouped the `doc-meta` margin (web reading room) so the OKF section holds **only** OKF-spec fields.

**Gotcha (got it wrong twice):** demarkus catalog metadata ≠ OKF. Grounded the split in the actual OKF v0.1 spec (GoogleCloudPlatform/knowledge-catalog/okf/SPEC.md), not the demarkus policy doc. OKF v0.1 frontmatter = `type` (required) + optional `title`, `description`, `resource`, `tags`, `timestamp`.

Mapping onto the doc view:
- **OKF group:** `type` (kind), `tags` (pills), `timestamp` (← demarkus `modified`, "last meaningful change"). `title` stays the `<h1>`.
- **NOT OKF** (demarkus catalog/provenance, render outside the OKF box): `status` badge, `version`, `agent`, `importance`.

The original error was sweeping `status`/`importance` into "OKF" while leaving `tags`/`modified` out — exactly backwards.

**Threading:** `type` was never surfaced in the view model. Added `Type` to `domain.Document` (from `raw.Metadata["type"]` in `reading.go`), and to both VMs that share the `doc-meta` template: `page` (reading_handlers.go) and `paneVM` (trail_handlers.go — the canvas mirrors page VM). Forgetting the canvas/paneVM copy is an easy miss since `doc-meta` is shared.

`description`/`resource` aren't carried in the demarkus metadata channel, so they're absent from the OKF group for now.

Files: `internal/core/domain/document.go`, `internal/core/service/reading.go`, `internal/adapter/inbound/web/reading_handlers.go`, `trail_handlers.go`, `templates/content.html`, `templates/page.html` (`.okf`/`.meta-head` CSS).