Files
united-workforce/packages/workflow-template-solve-issue
xiaoju e9e4960714 refactor(workflow): migrate downstream packages to workflow-runtime (Phase 2+3)
- Verify createWorkflow in runtime has zero I/O imports
- Migrate agent-cursor, agent-hermes to pure workflow-runtime dependency
- Migrate agent-llm, util-agent, templates to dual dependency
  (runtime for types, engine for CAS/merkle/buildDescriptor)
- All 377 tests passing

Refs #121, relates #123 #124
2026-05-08 06:33:52 +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).

createSolveIssueRun wires the developer role to workflowAsAgent("develop") by default; binding.overrides.developer wins if you pass one (for tests or custom hosts).

Install

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

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

Usage

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

const run = createSolveIssueRun(binding, extract, llmProvider);

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
createSolveIssueRun Merges developer override with workflowAsAgent("develop"), then createWorkflow
solveIssueWorkflowDefinition description, roles, solveIssueModerator
solveIssueModerator Linear Moderator<SolveIssueMeta>
buildSolveIssueDescriptor Descriptor helper for bundles
SOLVE_ISSUE_WORKFLOW_DESCRIPTION Human-readable one-liner