refactor!: rename RoleDefinition.meta → frontmatter #375

2026-05-22T06:05:29Z

xiaoju commented

2026-05-22 06:05:29 +00:00

What

Rename RoleDefinition.meta → frontmatter across the entire stack.

Why

meta is vague — the field defines the frontmatter schema that agents must output. Calling it frontmatter makes the contract self-documenting.

Changes

workflow-protocol — types.ts: meta: CasRef → frontmatter: CasRef; schemas.ts: schema field renamed
cli-workflow — validate.ts: validation logic updated; workflow.ts: resolveMetaRef → resolveFrontmatterRef
workflow-agent-kit — run.ts: metaSchema → frontmatterSchema, roleDef.meta → roleDef.frontmatter
YAML files — all examples/ and .workflows/ updated

BREAKING CHANGE: All workflow YAML files must use frontmatter instead of meta.

Ref

Fixes #374

## What Rename `RoleDefinition.meta` → `frontmatter` across the entire stack. ## Why `meta` is vague — the field defines the frontmatter schema that agents must output. Calling it `frontmatter` makes the contract self-documenting. ## Changes - **workflow-protocol** — `types.ts`: `meta: CasRef` → `frontmatter: CasRef`; `schemas.ts`: schema field renamed - **cli-workflow** — `validate.ts`: validation logic updated; `workflow.ts`: `resolveMetaRef` → `resolveFrontmatterRef` - **workflow-agent-kit** — `run.ts`: `metaSchema` → `frontmatterSchema`, `roleDef.meta` → `roleDef.frontmatter` - **YAML files** — all `examples/` and `.workflows/` updated BREAKING CHANGE: All workflow YAML files must use `frontmatter` instead of `meta`. ## Ref Fixes #374

xiaoju added 1 commit 2026-05-22 06:05:29 +00:00

refactor!: rename RoleDefinition.meta → frontmatter 02f7f0b708

BREAKING CHANGE: All workflow YAML files must use 'frontmatter' instead of 'meta'.

- workflow-protocol: RoleDefinition.meta → frontmatter, schema updated
- cli-workflow: validate.ts, workflow.ts — resolveMetaRef → resolveFrontmatterRef
- workflow-agent-kit: run.ts — metaSchema → frontmatterSchema
- All YAML files updated (examples/, .workflows/)

Fixes #374

xiaomo approved these changes 2026-05-22 06:06:02 +00:00

xiaomo left a comment

LGTM ✅ 干净的全栈重命名，类型、schema、validate、YAML 全部一致。

— 小墨 🖊️

LGTM ✅ 干净的全栈重命名，类型、schema、validate、YAML 全部一致。 — 小墨 🖊️

xiaomo merged commit bdafaf3aa1 into main

2026-05-22 06:06:06 +00:00

xiaomo referenced this issue from a commit

2026-05-22 06:06:07 +00:00

Merge pull request 'refactor!: rename RoleDefinition.meta → frontmatter' (#375) from refactor/374-meta-to-frontmatter into main

xiaoju referenced this issue from a commit

2026-05-22 09:04:42 +00:00