Files

T

xiaoju 1e9900bed3 feat(#194 ): Phase 2 — Engine layer Merkle call stack wiring

- Protocol: AgentFnResult = string | { output, childThread }, RoleOutput.childThread,
  ThreadContext.bundleHash for parent state lookup
- Runtime: create-workflow normalizes AgentFnResult, propagates childThread in RoleOutput
- Engine: ExecuteThreadOptions.parentStateHash, appendStateForStep writes childThread,
  putStartNode uses parentStateHash
- workflowAsAgent: reads parent head state from threads.json, passes parentStateHash
  to child, returns { output, childThread: rootHash }
- Integration test: 4 cases verifying bidirectional Merkle links (306 lines)

Phase 2 of #194 (Merkle Call Stack). Closes #196.

小橘 <xiaoju@shazhou.work>

2026-05-12 02:10:06 +00:00

__tests__

feat(#194 ): Phase 2 — Engine layer Merkle call stack wiring

2026-05-12 02:10:06 +00:00

src

refactor: remove dead hasRoundsRemaining condition, use FALLBACK

2026-05-11 08:59:14 +00:00

bundle-entry.ts

feat: cursor agent auto-extracts workspace from context via LLM

2026-05-11 13:51:41 +00:00

package.json

chore: bump to v0.3.1, fix workspace:* in published packages

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

pnpm-lock.yaml

fix: login.tsx use new gateway endpoint path

2026-05-11 16:46:38 +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