{"record":{"id":"8611a05212710b0c","repo":"coleam00/Archon","slug":"node-loop-until-deprecated","errorCode":"node_loop_until_deprecated","errorMessage":"Node '${id}': the prose 'loop.until' completion signal is deprecated. Declare 'loop.until_bash' (deterministic check) or 'loop.until_field' (a declared boolean in output_format) instead (#2707 step 3). While supported, emit legacy signals as '<promise>SIGNAL</promise>' or a final standalone signal line.","messagePattern":"Node '(.+?)': the prose 'loop\\.until' completion signal is deprecated\\. Declare 'loop\\.until_bash' \\(deterministic check\\) or 'loop\\.until_field' \\(a declared boolean in output_format\\) instead \\(#2707 step 3\\)\\. While supported, emit legacy signals as '<promise>SIGNAL</promise>' or a final standalone signal line\\.","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"packages/workflows/src/loader.ts","lineNumber":489,"sourceCode":"    warnings.push(message);\n    getLog().warn({ id, warning: message }, 'node_loop_interactive_deprecated');\n  }\n\n  // The prose `until:` completion channel is deprecated for EVERY loop/loop_group,\n  // not only interactive ones (#2707 step 3, \"What gets deleted\"): its one stated\n  // reason to exist — \"the iteration output is a message a human reads at an\n  // interactive gate\" (#2563) — evaporates once that human interaction is a gate\n  // node with structured decision output rather than a prose sentinel. `until_bash`\n  // and (loop: only) `until_field` are the declared, structured replacements. This\n  // keeps running exactly as before; only the guidance is new.\n  if (isLoopNode(node) && node.loop.until !== undefined) {\n    const message =\n      `Node '${id}': the prose 'loop.until' completion signal is deprecated. Declare ` +\n      \"'loop.until_bash' (deterministic check) or 'loop.until_field' (a declared boolean \" +\n      'in output_format) instead (#2707 step 3). While supported, emit legacy signals as ' +\n      \"'<promise>SIGNAL</promise>' or a final standalone signal line.\";\n    warnings.push(message);\n    getLog().warn({ id, warning: message }, 'node_loop_until_deprecated');\n  } else if (isLoopGroupNode(node) && node.loop_group.until !== undefined) {\n    const message =\n      `Node '${id}': the prose 'loop_group.until' completion signal is deprecated. ` +\n      \"Declare 'loop_group.until_bash' instead — it can read a body node's structured \" +\n      'output (e.g. \\'test $body-node.output.field = \"true\"\\') (#2707 step 3). While ' +\n      \"supported, emit legacy signals as '<promise>SIGNAL</promise>' or a final standalone \" +\n      'signal line.';\n    warnings.push(message);\n    getLog().warn({ id, warning: message }, 'node_loop_group_until_deprecated');\n  }\n\n  // A gate node inside a loop_group body only pauses the enclosing loop when it is\n  // the body's SOLE terminal sink (#2707 step 3, target-model decision (b)) — a\n  // mid-body or co-terminal gate has no defined resume semantics and silently does\n  // not stop iteration (mid-body resume-to-node is deferred to #2708). This is\n  // guidance for the new authoring pattern, not a rejection: the file keeps loading\n  // either way, matching the grow-then-deprecate posture used throughout this\n  // function — including for a gate placed here via the legacy `on_reject`","sourceCodeStart":471,"sourceCodeEnd":507,"githubUrl":"https://github.com/coleam00/Archon/blob/0773b9745896ef0612e709c80845a0f7db315b19/packages/workflows/src/loader.ts#L471-L507","documentation":"The prose `loop.until` completion signal — the model emits a free-text signal the loop matches — is deprecated in favor of deterministic checks: `loop.until_bash` (a bash predicate) or `loop.until_field` (a declared boolean in the node's output_format). The loader warns; prose signals still work while supported, emitted as `<promise>SIGNAL</promise>` or a final standalone signal line.","triggerScenarios":"collectGateAndLoopDeprecationWarnings on a loop node whose `loop.until` is defined (loader.ts:489); fires at parse time. Prose matching is fragile because vendor/model rewording can silently break signal detection.","commonSituations":"Loops authored before until_bash/until_field existed; loops relying on the model to declare 'DONE'; intermittent non-termination because the model phrased the completion signal differently.","solutions":["Replace `loop.until: SIGNAL` with `loop.until_bash:` running a deterministic predicate against the node's structured output.","Or declare a boolean in the loop body's output_format and use `loop.until_field:` on it.","If keeping prose until temporarily, ensure the signal is emitted as `<promise>SIGNAL</promise>` or a final standalone signal line.","Migrate before the prose channel is deleted (#2707 step 3) — after removal it will stop matching with no fallback."],"exampleFix":"# before\nloop:\n  until: TASK_COMPLETE\n# after\nloop:\n  until_field: done   # body declares `done: boolean` in output_format","handlingStrategy":"validation","validationCode":"// Require deterministic loop completion before loading:\nfor (const node of workflow.nodes) {\n  if (node.type === 'loop' && node.loop?.until !== undefined) {\n    throw new Error(`Node '${node.id}': replace prose loop.until with until_bash or until_field`);\n  }\n}","typeGuard":"function usesProseUntil(node: { type: string; loop?: { until?: unknown } }): boolean {\n  return node.type === 'loop' && node.loop?.until !== undefined;\n}","tryCatchPattern":null,"preventionTips":["Default new loops to until_bash/until_field; never author prose until signals.","Declare completion booleans in the loop body's output_format so checks are deterministic.","If keeping prose until temporarily, enforce the <promise>SIGNAL</promise> emission form in prompts.","Re-verify loops after model/provider changes — prose signals are the first thing rewording breaks."],"tags":["workflow","deprecation","loop","completion-signal"],"backgroundTag":"deprecated-workflow-field","analyzedSha":"0773b9745896ef0612e709c80845a0f7db315b19","analyzedAt":"2026-09-01T02:28:07.064Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-08T05:18:18.240Z"}