uncaged/workflow
Archived
10
0
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update all documentation for status-based routing (#490) #497

New Issue
Closed
opened 2026-05-25 05:43:33 +00:00 by xiaoju · 0 comments
xiaoju commented 2026-05-25 05:43:33 +00:00
Owner
Copy Link
Copy Source

Background

#490 refactored the workflow engine from JSONata condition-based routing to status-based map routing. All code is updated, but documentation still references the old system.

Files to update

Repo docs (high priority)

  • README.md — 3 refs to JSONata
  • CLAUDE.md — 2 refs to JSONata graph evaluator
  • docs/architecture.md — 12+ refs, full old YAML examples
  • docs/wf-stateless-design.md — 25+ refs, old type definitions, old YAML examples

Package READMEs

  • packages/workflow-moderator/README.md — jsonata dependency, old Transition type
  • packages/workflow-protocol/README.md — ConditionDefinition, Transition, old WorkflowPayload

Dashboard docs

  • packages/workflow-dashboard/context.md — 20+ refs to ConditionalEdge, condition field

Plan docs (low priority)

  • docs/plans/2026-05-12-dashboard-workflow-graph.md — condition in type
  • docs/superpowers/plans/2026-05-18-office-agent-document-template.md — old graph format
  • docs/builtin-agent-research.md — 2 JSONata refs

Skills to update

  • uncaged-workflow-cli skill — mentions conditions in workflow definition
  • workflow-smoke-test skill + template — uses old condition/edge format in code

What changed (#490)

Before After
conditions block + JSONata expressions Deleted
graph[role] = Transition[] graph[role] = Record<status, Target>
Transition.condition status is the map key
ConditionDefinition Deleted
ConditionalEdge StatusEdge
jsonata dependency mustache dependency
evaluate(workflow, context) async evaluate(graph, lastRole, lastOutput) sync

—— 小橘 🍊（NEKO Team）

## Background #490 refactored the workflow engine from JSONata condition-based routing to status-based map routing. All code is updated, but documentation still references the old system. ## Files to update ### Repo docs (high priority) - [ ] `README.md` — 3 refs to JSONata - [ ] `CLAUDE.md` — 2 refs to JSONata graph evaluator - [ ] `docs/architecture.md` — 12+ refs, full old YAML examples - [ ] `docs/wf-stateless-design.md` — 25+ refs, old type definitions, old YAML examples ### Package READMEs - [ ] `packages/workflow-moderator/README.md` — jsonata dependency, old Transition type - [ ] `packages/workflow-protocol/README.md` — ConditionDefinition, Transition, old WorkflowPayload ### Dashboard docs - [ ] `packages/workflow-dashboard/context.md` — 20+ refs to ConditionalEdge, condition field ### Plan docs (low priority) - [ ] `docs/plans/2026-05-12-dashboard-workflow-graph.md` — condition in type - [ ] `docs/superpowers/plans/2026-05-18-office-agent-document-template.md` — old graph format - [ ] `docs/builtin-agent-research.md` — 2 JSONata refs ## Skills to update - [ ] `uncaged-workflow-cli` skill — mentions conditions in workflow definition - [ ] `workflow-smoke-test` skill + template — uses old condition/edge format in code ## What changed (#490) | Before | After | |--------|-------| | `conditions` block + JSONata expressions | Deleted | | `graph[role]` = `Transition[]` | `graph[role]` = `Record<status, Target>` | | `Transition.condition` | status is the map key | | `ConditionDefinition` | Deleted | | `ConditionalEdge` | `StatusEdge` | | `jsonata` dependency | `mustache` dependency | | `evaluate(workflow, context)` async | `evaluate(graph, lastRole, lastOutput)` sync | —— 小橘 🍊（NEKO Team）
This repo is archived. You cannot comment on issues.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
aobing jiashuang (Jia Shuang) jiayi (Jiayi) luming scottwei tuanzi xiaoju xiaomo xiaonuo xingyue
No Assignees
1 Participants
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: uncaged/workflow#497
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?