e0f3d3d14c
Renames the default-workflow intake column's display label from "Triage" to "Planning" across the built-in coding, stepwise-coding, and PR workflows, while keeping the column id as `triage` for lifecycle/DB/type stability. - builtin-coding-workflow-ir.ts: intake column name "Triage" -> "Planning" - builtin-pr-workflow-ir.ts: intake column name "Triage" -> "Planning" - builtin-stepwise-coding-workflow-ir.ts: intake column name "Triage" -> "Planning" - Added regression tests asserting the intake column is labeled "Planning" with id "triage" in builtin-coding and hand-authored default workflows (stepwise-coding, pr-workflow) - Added changeset (patch) documenting the label change for @runfusion/fusion Files changed: .changeset/fn-7599-planning-column-rename.md | 7 +++++++ .../core/src/__tests__/builtin-coding-workflow-ir.test.ts | 7 +++++++ packages/core/src/__tests__/builtin-workflows.test.ts | 12 ++++++++++++ packages/core/src/builtin-coding-workflow-ir.ts | 3 ++- packages/core/src/builtin-pr-workflow-ir.ts | 2 +- packages/core/src/builtin-stepwise-coding-workflow-ir.ts | 2 +- 6 files changed, 30 insertions(+), 3 deletions(-) Fusion-Task-Id: FN-7599 Fusion-Task-Lineage: 5de8abc4-2407-4f9a-b97c-bd5b900d8fd9 Co-authored-by: Fusion (runfusion.ai) <noreply@runfusion.ai>
243 lines
13 KiB
TypeScript
243 lines
13 KiB
TypeScript
import type { WorkflowIr } from "./workflow-ir-types.js";
|
|
import { parseWorkflowIr } from "./workflow-ir.js";
|
|
import { BUILTIN_WORKFLOW_SETTINGS } from "./builtin-workflow-settings.js";
|
|
import { builtinPromptConfig } from "./builtin-workflow-prompts.js";
|
|
import { browserVerificationOptionalGroupNode } from "./builtin-browser-verification-group.js";
|
|
import { codeReviewOptionalGroupNode } from "./builtin-code-review-group.js";
|
|
import { completionSummaryNode } from "./builtin-completion-summary-node.js";
|
|
import { postMergeVerificationOptionalGroupNode } from "./builtin-post-merge-group.js";
|
|
import { planReviewOptionalGroupNode } from "./builtin-plan-review-group.js";
|
|
import {
|
|
browserVerificationRemediationNode,
|
|
codeReviewRemediationNode,
|
|
planReplanNode,
|
|
} from "./builtin-workflow-remediation-nodes.js";
|
|
|
|
/**
|
|
* The built-in **stepwise** coding workflow (KTD-9) — the demonstration of step
|
|
* inversion and the parity-comparison subject for the engine's
|
|
* `stepwise-workflow-parity.test.ts`.
|
|
*
|
|
* Unlike the default `builtin-coding-workflow-ir` (which keeps a single monolithic
|
|
* `execute` seam and is the byte-identity parity oracle, KTD-1), this workflow
|
|
* models per-step policy explicitly as graph structure:
|
|
*
|
|
* plan seam
|
|
* → parse-steps(PROMPT.md, step-headings) (KTD-12: graph-native parse)
|
|
* → foreach(task-steps, sequential, shared) { (KTD-3: runtime expansion)
|
|
* step-execute (KTD-2: run one step)
|
|
* → step-review(code): (KTD-4: verdicts as edges)
|
|
* approve → step-done (template exit) (APPROVE auto-completes)
|
|
* revise → rework back to step-execute (revise in place, no reset)
|
|
* rethink → rework back to step-execute (reset semantics handler-side)
|
|
* unavailable → (advisory) routes onward
|
|
* }
|
|
* rework-exhausted → hold(manual) (KTD-5: bounded escalation)
|
|
* → review seam
|
|
* → merge seam
|
|
*
|
|
* The columns/traits are identical to the default builtin so the full lifecycle
|
|
* (merge-blocker, human review, capacity, hold, complete, archived) behaves
|
|
* exactly as it does for the default workflow — only the in-progress step
|
|
* modeling differs.
|
|
*
|
|
* It declares its step-source artifact (KTD-12): PROMPT.md produced by the
|
|
* planning seam. The IR is v2-only (foreach/step-review/parse-steps are v2 node
|
|
* kinds), so `downgradeIrToV1IfPure` refuses it and the flag-OFF rollback contract
|
|
* (KTD-8) is preserved automatically.
|
|
*
|
|
* FNXC:PlanReviewStep 2026-06-28-23:29:
|
|
* Coding (per-step review) also needs the default-on optional Plan Review gate before
|
|
* execution. The group sits between `plan` and `parse` so operators can toggle plan
|
|
* review independently while preserving the per-step code review/rework loop.
|
|
*
|
|
* FNXC:WorkflowReviewGates 2026-06-29-23:27:
|
|
* Per-step review should inherit the regular Coding workflow's graph-native suffix:
|
|
* completion summary flows directly to the merge gate, with the final optional Code
|
|
* Review group providing the only end-of-task automated review gate.
|
|
*/
|
|
const RAW_BUILTIN_STEPWISE_CODING_WORKFLOW_IR: WorkflowIr = {
|
|
version: "v2",
|
|
name: "builtin-stepwise-coding",
|
|
columns: [
|
|
{ id: "triage", name: "Planning", traits: [{ trait: "intake" }] },
|
|
{
|
|
id: "todo",
|
|
name: "Todo",
|
|
traits: [{ trait: "hold", config: { release: "capacity" } }, { trait: "reset-on-entry" }],
|
|
},
|
|
{
|
|
id: "in-progress",
|
|
name: "In progress",
|
|
traits: [{ trait: "wip" }, { trait: "abort-on-exit" }, { trait: "timing" }],
|
|
},
|
|
{
|
|
id: "in-review",
|
|
name: "In review",
|
|
traits: [{ trait: "merge-blocker" }, { trait: "human-review" }, { trait: "stall-detection" }, { trait: "merge" }],
|
|
},
|
|
{ id: "done", name: "Done", traits: [{ trait: "complete" }] },
|
|
{ id: "archived", name: "Archived", traits: [{ trait: "archived" }] },
|
|
],
|
|
// KTD-12: PROMPT.md is the planning-produced step-source artifact this workflow
|
|
// parses into task steps.
|
|
artifacts: [{ key: "PROMPT.md", title: "Plan", producedBy: "planning", role: "step-source" }],
|
|
nodes: [
|
|
{ id: "start", kind: "start", column: "triage" },
|
|
// Planning seam: produces PROMPT.md (the declared step-source artifact).
|
|
{ id: "plan", kind: "prompt", column: "in-progress", config: builtinPromptConfig("planning", "Plan") },
|
|
planReviewOptionalGroupNode("in-progress", { requireExternalIntegrationEvidence: true }),
|
|
planReplanNode("triage"),
|
|
// KTD-12: parse the planned PROMPT.md into the task step list. This node must
|
|
// dominate the foreach (validator-enforced).
|
|
{
|
|
id: "parse",
|
|
kind: "parse-steps",
|
|
column: "in-progress",
|
|
config: { artifact: "PROMPT.md", parser: "step-headings" },
|
|
},
|
|
// KTD-3: runtime-expanding per-step region. Sequential + shared isolation is
|
|
// the default baseline physics (one step at a time in the task's worktree).
|
|
{
|
|
id: "steps",
|
|
kind: "foreach",
|
|
column: "in-progress",
|
|
config: {
|
|
source: "task-steps",
|
|
mode: "sequential",
|
|
isolation: "shared",
|
|
maxReworkCycles: 3,
|
|
template: {
|
|
nodes: [
|
|
// KTD-2: run exactly this step inside the task's session/worktree.
|
|
{ id: "step-execute", kind: "prompt", config: builtinPromptConfig("step-execute", "Step execute") },
|
|
// KTD-4: per-step code review; verdicts become outcome edges.
|
|
{ id: "step-review", kind: "step-review", config: { type: "code" } },
|
|
// Template exit (the single sink the validator requires): a config-less
|
|
// gate is a pure pass-through (createGateHandler → success), so APPROVE
|
|
// routes here and the instance exits. The step is already marked done by
|
|
// the step-review APPROVE verdict (projection authority, KTD-4/KTD-7).
|
|
{ id: "step-done", kind: "gate", config: {} },
|
|
],
|
|
edges: [
|
|
{ from: "step-execute", to: "step-review", condition: "success" },
|
|
// APPROVE → template exit (step-done). The step-review verdict already
|
|
// marked the step done through the projection.
|
|
{ from: "step-review", to: "step-done", condition: "outcome:approve" },
|
|
// REVISE → rework back to step-execute, revise in place (no reset).
|
|
{
|
|
from: "step-review",
|
|
to: "step-execute",
|
|
condition: "outcome:revise",
|
|
kind: "rework",
|
|
},
|
|
// RETHINK → rework back to step-execute; the traversal triggers
|
|
// resetStepToBaseline (reset semantics are handler-side, KTD-4/U5).
|
|
{
|
|
from: "step-review",
|
|
to: "step-execute",
|
|
condition: "outcome:rethink",
|
|
kind: "rework",
|
|
},
|
|
],
|
|
},
|
|
},
|
|
},
|
|
// KTD-5: rework exhaustion escalates to a manual hold (a human releases it).
|
|
{ id: "rework-hold", kind: "hold", column: "in-progress", config: { release: "manual" } },
|
|
// FNXC:WorkflowOptionalGroup 2026-06-21-15:10:
|
|
// Pre-merge optional browser-verification as an `optional-group` container
|
|
// (default OFF), parity with builtin-coding-workflow-ir (U6). It REPLACES the
|
|
// prior `workflow-step` seam + `optionalSteps` declaration. R-3 run-once
|
|
// guarantee: the group sits on the post-foreach success path (steps → here →
|
|
// review), so when enabled the browser-verification step runs EXACTLY ONCE
|
|
// after every step-instance completes — never per step-instance — and when
|
|
// disabled the group passes through inert. Both the normal foreach-success path
|
|
// and the rework-exhausted manual-release path flow through this node.
|
|
browserVerificationOptionalGroupNode("in-progress"),
|
|
browserVerificationRemediationNode("in-progress"),
|
|
// FNXC:CodeReviewStep 2026-06-25-15:00:
|
|
// Pre-merge Code Review as a DEFAULT-ON optional-group (blocking gate), on the post-foreach
|
|
// success path between browser-verification and review (steps → browser-verification →
|
|
// code-review → review). It sits after the foreach so it runs EXACTLY ONCE pre-merge
|
|
// (never per step-instance); both the foreach-success and rework-exhausted manual-
|
|
// release paths flow through it. Runs for every task by default (defaultOn:true) but is
|
|
// toggleable off per task; disabled → byte-inert pass-through.
|
|
codeReviewOptionalGroupNode("in-progress"),
|
|
codeReviewRemediationNode("in-progress"),
|
|
completionSummaryNode("in-review"),
|
|
{ id: "merge-gate", kind: "merge-gate", column: "in-review", config: { gate: "auto-merge" } },
|
|
{ id: "merge-retry", kind: "retry-backoff", column: "in-review", config: { policy: "merge", maxAttempts: 3 } },
|
|
{ id: "merge-manual-hold", kind: "manual-merge-hold", column: "in-review", config: { release: "manual" } },
|
|
{
|
|
id: "branch-group-member-integration",
|
|
kind: "branch-group-member-integration",
|
|
column: "in-review",
|
|
config: { reworkRegion: true, maxReworkCycles: 3 },
|
|
},
|
|
{ id: "branch-group-promotion", kind: "branch-group-promotion", column: "in-review" },
|
|
{
|
|
id: "merge-attempt",
|
|
kind: "merge-attempt",
|
|
column: "in-review",
|
|
config: { capability: "task-merge", reworkRegion: true, maxReworkCycles: 3 },
|
|
},
|
|
{ id: "recovery-router", kind: "recovery-router", column: "in-review", config: { surfaces: ["merge", "retry"] } },
|
|
postMergeVerificationOptionalGroupNode("done"),
|
|
{ id: "end", kind: "end", column: "done" },
|
|
],
|
|
edges: [
|
|
{ from: "start", to: "plan" },
|
|
{ from: "plan", to: "plan-review", condition: "success" },
|
|
{ from: "plan", to: "end", condition: "failure" },
|
|
{ from: "plan-review", to: "parse", condition: "success" },
|
|
{ from: "plan-review", to: "plan-replan", condition: "failure" },
|
|
{ from: "plan-replan", to: "plan-review", condition: "success", kind: "rework" },
|
|
{ from: "parse", to: "steps", condition: "success" },
|
|
// parse-steps no-steps defaults to success; route it explicitly to the foreach
|
|
// (zero steps → foreach no-ops through its success edge, KTD-8/R8).
|
|
{ from: "parse", to: "steps", condition: "outcome:no-steps" },
|
|
{ from: "parse", to: "end", condition: "failure" },
|
|
{ from: "parse", to: "end", condition: "outcome:parse-error" },
|
|
// Implementation complete → pre-merge browser-verification optional-group →
|
|
// review. Both the normal foreach-success path and the rework-exhausted
|
|
// manual-release path flow through the group so an enabled task runs the step
|
|
// ONCE after the foreach (R-3), and a disabled task passes through to review.
|
|
{ from: "steps", to: "browser-verification", condition: "success" },
|
|
// KTD-5: bounded rework exhaustion → manual hold; release re-enters the group.
|
|
{ from: "steps", to: "rework-hold", condition: "outcome:rework-exhausted" },
|
|
{ from: "rework-hold", to: "browser-verification", condition: "success" },
|
|
// browser-verification → code-review → completion-summary → merge-gate; each
|
|
// optional-group passes through (outcome=success) when disabled, so a task with
|
|
// both off routes straight to completion summary and merge policy.
|
|
{ from: "browser-verification", to: "code-review", condition: "success" },
|
|
{ from: "code-review", to: "completion-summary", condition: "success" },
|
|
{ from: "completion-summary", to: "merge-gate", condition: "success" },
|
|
{ from: "browser-verification", to: "browser-verification-remediation", condition: "failure" },
|
|
{ from: "browser-verification-remediation", to: "browser-verification", condition: "success", kind: "rework" },
|
|
{ from: "code-review", to: "code-review-remediation", condition: "failure" },
|
|
{ from: "code-review-remediation", to: "code-review", condition: "success", kind: "rework" },
|
|
{ from: "steps", to: "end", condition: "failure" },
|
|
{ from: "merge-gate", to: "branch-group-member-integration", condition: "outcome:auto-on" },
|
|
{ from: "merge-gate", to: "merge-manual-hold", condition: "outcome:auto-off" },
|
|
{ from: "merge-retry", to: "merge-attempt", condition: "success", kind: "rework" },
|
|
{ from: "merge-manual-hold", to: "branch-group-member-integration", condition: "success", kind: "rework" },
|
|
{ from: "branch-group-member-integration", to: "branch-group-promotion", condition: "success" },
|
|
{ from: "branch-group-member-integration", to: "merge-manual-hold", condition: "outcome:manual-required" },
|
|
{ from: "branch-group-promotion", to: "merge-attempt", condition: "success" },
|
|
{ from: "branch-group-promotion", to: "merge-manual-hold", condition: "outcome:manual-required" },
|
|
{ from: "merge-attempt", to: "post-merge-verification", condition: "success" },
|
|
{ from: "post-merge-verification", to: "end", condition: "success" },
|
|
{ from: "merge-attempt", to: "merge-retry", condition: "outcome:transient-failure" },
|
|
{ from: "merge-attempt", to: "merge-manual-hold", condition: "outcome:manual-required" },
|
|
{ from: "recovery-router", to: "merge-attempt", condition: "outcome:wake-merge", kind: "rework" },
|
|
{ from: "merge-attempt", to: "end", condition: "failure" },
|
|
],
|
|
// Workflow-settings (U1, R4): same moved-key catalog as the default builtin.
|
|
settings: BUILTIN_WORKFLOW_SETTINGS,
|
|
};
|
|
|
|
export const BUILTIN_STEPWISE_CODING_WORKFLOW_IR = parseWorkflowIr(
|
|
RAW_BUILTIN_STEPWISE_CODING_WORKFLOW_IR,
|
|
);
|