fix: workflow-authoring flat schema, bootstrap PATH guidance #111

2026-06-05T11:44:42Z

xiaoju commented

2026-06-05 11:44:42 +00:00

What

Fix remaining issues from 小糯's onboarding testing (#110).

#110.3 — flat schema `$status: { const: "done" }` 过不了 validator

workflow-authoring reference 的 "Flat Schema (Single Status)" 示例用了 bare const，但 validate-semantic.ts 的 hasStatusEnum() 要求 enum 或 oneOf + const。

Fix: 改为 enum: [done] 格式，加注释说明 bare const 不合法。

#110.4 — `hermes` CLI 不在 PATH

uwf-hermes 直接 spawn hermes，但 venv 安装的 hermes 不在 PATH。

Fix: bootstrap 加 which hermes 检查和 venv PATH 指引。

Already fixed in rc.1

#110.1 — examples/eval-simple.yaml 不存在 → 已换成 inline hello.yaml
#110.2 — 缺 capabilities → 已有 capabilities: []

Ref

Fixes #110

## What Fix remaining issues from 小糯's onboarding testing (#110). ### #110.3 — flat schema `$status: { const: "done" }` 过不了 validator `workflow-authoring` reference 的 "Flat Schema (Single Status)" 示例用了 bare `const`，但 `validate-semantic.ts` 的 `hasStatusEnum()` 要求 `enum` 或 `oneOf` + `const`。 **Fix:** 改为 `enum: [done]` 格式，加注释说明 bare `const` 不合法。 ### #110.4 — `hermes` CLI 不在 PATH `uwf-hermes` 直接 spawn `hermes`，但 venv 安装的 hermes 不在 PATH。 **Fix:** bootstrap 加 `which hermes` 检查和 venv PATH 指引。 ### Already fixed in rc.1 - #110.1 — `examples/eval-simple.yaml` 不存在 → 已换成 inline `hello.yaml` - #110.2 — 缺 `capabilities` → 已有 `capabilities: []` ## Ref Fixes #110

xiaoju added 1 commit 2026-06-05 11:44:42 +00:00

fix: workflow-authoring flat schema, bootstrap PATH guidance

CI / check (pull_request) Successful in 2m18s

Details

5450bc1230

- #110.3: flat schema example uses enum: [done] instead of bare const
  (bare const fails validate-semantic hasStatusEnum check)
- #110.4: bootstrap adds 'which hermes' PATH check and venv guidance
- #110.1: already fixed in rc.1 (inline hello.yaml)
- #110.2: already fixed in rc.1 (capabilities: [] present)

Fixes #110

xiaomo approved these changes 2026-06-05 11:49:47 +00:00

xiaomo left a comment

LGTM ✅

flat schema — const → enum: [done]，加了 type: object 包裹，还注释说明了 const 只在 oneOf 里合法。新手不会再踩这个坑。

PATH 指引 — which hermes + venv bin 路径提示，解决 hermes 装在 venv 但不在 PATH 的常见场景。

LGTM ✅ **flat schema** — `const` → `enum: [done]`，加了 `type: object` 包裹，还注释说明了 `const` 只在 `oneOf` 里合法。新手不会再踩这个坑。 **PATH 指引** — `which hermes` + venv bin 路径提示，解决 hermes 装在 venv 但不在 PATH 的常见场景。

xiaomo merged commit 8d6f480b0f into main

2026-06-05 11:49:49 +00:00

xiaomo deleted branch fix/110-bootstrap-workflow-fixes

2026-06-05 11:49:49 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: shazhou/united-workforce#111

fix: workflow-authoring flat schema, bootstrap PATH guidance #111

What

#110.3 — flat schema $status: { const: "done" } 过不了 validator

#110.4 — hermes CLI 不在 PATH

Already fixed in rc.1

Ref

#110.3 — flat schema `$status: { const: "done" }` 过不了 validator

#110.4 — `hermes` CLI 不在 PATH