Files
united-workforce/packages/workflow-template-solve-issue
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
..

@uncaged/workflow-template-solve-issue

Reference solve-issue workflow template: prepare a repo, delegate implementation to the develop workflow, then submit (e.g. open a PR).

This package exports a pure WorkflowDefinition (solveIssueWorkflowDefinition). Workflow instantiation (createWorkflow(definition, binding)) and any role-specific agent wiring (for example delegating developer to workflowAsAgent("develop")) are done in the workflow instance layer.

Install

bun add @uncaged/workflow-template-solve-issue @uncaged/workflow zod

In this monorepo: workspace:* for this package and @uncaged/workflow.

Usage

import { createWorkflow } from "@uncaged/workflow";
import { solveIssueWorkflowDefinition } from "@uncaged/workflow-template-solve-issue";

const run = createWorkflow(solveIssueWorkflowDefinition, binding);

Roles

Role Purpose
preparer Set up context / repo state for the issue
developer Implementation; default runs the registered develop workflow as a sub-agent
submitter Finalize and submit the outcome (e.g. PR)

Also exported: preparerRole, developerRole, submitterRole and their Zod meta schemas, SolveIssueMeta, solveIssueRoles.

Moderator flow

  1. Startpreparer
  2. After preparerdeveloper
  3. After developersubmitter
  4. After submitterEND

API overview

Export Description
solveIssueWorkflowDefinition description, roles, solveIssueModerator
solveIssueModerator Linear Moderator<SolveIssueMeta>
buildSolveIssueDescriptor Descriptor helper for bundles
SOLVE_ISSUE_WORKFLOW_DESCRIPTION Human-readable one-liner