Files

T

xiaoju 2b587612d5 refactor: replace maxRounds with supervisor check interval

Removes maxRounds as a hard stop limit from the entire stack. The supervisor
(already configured via workflow.yaml supervisorInterval) is now the sole
termination authority.

Changes across 27 files in 11 packages:
- workflow-protocol: StartStep.meta is now empty, StartNodePayload drops maxRounds
- workflow-cas: isStartPayload no longer checks maxRounds
- workflow-execute: engine, worker, fork-thread all stripped of maxRounds plumbing
- cli-workflow: --max-rounds flag removed from CLI and HTTP API
- workflow-runtime: build-context and create-workflow no longer reference maxRounds
- workflow-dashboard: UI no longer sends maxRounds
- workflow-template-develop/solve-issue: moderator no longer checks rounds remaining
- All tests updated

Fixes #185

2026-05-11 08:51:35 +00:00

__tests__

refactor: replace maxRounds with supervisor check interval

2026-05-11 08:51:35 +00:00

src

refactor: replace maxRounds with supervisor check interval

2026-05-11 08:51:35 +00:00

bundle-entry.ts

feat(workflow): add declarative ModeratorTable type and migrate templates

2026-05-11 06:25:39 +00:00

package.json

refactor(workflow): fix tsconfig references, template imports, delete old packages/workflow

2026-05-09 11:46:57 +08:00

README.md

refactor(workflow-runtime): use full ThreadContext in WorkflowFn

2026-05-08 17:08:01 +08:00

tsconfig.json

feat: Phase 3 — engine read path + runtime context builder

2026-05-09 08:00:24 +00:00

README.md

@uncaged/workflow-template-develop

Reference develop workflow template: plan phases, implement in a loop, review, test, then commit.

Export a pure WorkflowDefinition (developWorkflowDefinition) and role/moderator pieces. Workflow instantiation (createWorkflow(definition, binding)) happens in the workflow instance layer, not in this template package.

Install

bun add @uncaged/workflow-template-develop @uncaged/workflow zod

In this monorepo: workspace:* for @uncaged/workflow-template-develop and @uncaged/workflow.

Usage

import { createWorkflow } from "@uncaged/workflow";
import { developWorkflowDefinition } from "@uncaged/workflow-template-develop";

const run = createWorkflow(developWorkflowDefinition, binding);

Roles

Role	Purpose
planner	Break work into ordered phases (hashes)
coder	Implement current phase; repeats until phases complete or limits hit
reviewer	Code review gate (`approved` vs send back to coder)
tester	Verify via tests/build/lint (`passed` vs send back to coder)
committer	Final commit step

Also exported: role factories/meta schemas (plannerRole, coderRole, …), DevelopMeta, developRoles.

Moderator flow

Start → planner
After planner → coder
After coder → if all planned phases are done (or last phase completed) → reviewer; else coder again, until maxRounds then END
After reviewer → if approved → tester; else coder (or END if out of rounds)
After tester → if passed → committer; else coder (or END if out of rounds)
After committer → END

API overview

Export	Description
`developWorkflowDefinition`	`description`, `roles`, `developModerator`
`developModerator`	`Moderator<DevelopMeta>`
`buildDevelopDescriptor`	`buildDescriptor({ … })` for bundle metadata
`DEVELOP_WORKFLOW_DESCRIPTION`	Human-readable one-liner