@bastani/atomic 0.9.2-alpha.1 → 0.9.3-alpha.1

package/dist/builtin/workflows/builtin/goal-prompts.ts

@@ -9,8 +9,9 @@ export { WORKER_PREFLIGHT_CONTRACT };
 
 export const GOAL_CONTINUATION_REFERENCE = [
   "Continuation behavior:",
-  "- This goal persists across turns. Ending this turn does not require shrinking the objective to what fits now.",
-  "- Keep the full objective intact. If it cannot be finished now, make concrete progress toward the real requested end state, leave the goal active, and do not redefine success around a smaller or easier task.",
+  "- This goal persists across workflow continuations. A worker session ending does not require shrinking the objective to what fits immediately.",
+  "- Keep the full objective intact and do not stop until the objective is complete. Do not intentionally leave known required implementation, validation, documentation, or cleanup for a later worker session.",
+  "- If the full objective genuinely cannot be finished with available context/tools, make the most concrete progress toward the real requested end state, leave the goal active, and do not redefine success around a smaller or easier task.",
   "- Temporary rough edges are acceptable while the work is moving in the right direction. Completion still requires the requested end state to be true and verified.",
   "",
   "Work from evidence:",
@@ -20,7 +21,7 @@ export const GOAL_CONTINUATION_REFERENCE = [
   "If todo management is available and the next work is meaningfully multi-step, use it to show a concise plan tied to the real objective. Keep the plan current as steps complete or the next best action changes. Skip planning overhead for trivial one-step progress, and do not treat a todo update as a substitute for doing the work.",
   "",
   "Fidelity:",
-  "- Optimize each turn for movement toward the requested end state, not for the smallest stable-looking subset or easiest passing change.",
+  "- Optimize worker effort for full completion of the requested end state, not for the smallest stable-looking subset or easiest passing change.",
   "- Do not substitute a narrower, safer, smaller, merely compatible, or easier-to-test solution because it is more likely to pass current tests.",
   "- Treat alignment as movement toward the requested end state. An edit is aligned only if it makes the requested final state more true; useful-looking behavior that preserves a different end state is misaligned.",
   "",
@@ -39,20 +40,21 @@ export const GOAL_CONTINUATION_REFERENCE = [
   "",
   "Blocked audit:",
   "- Do not report blocked the first time a blocker appears.",
-  "- Only use blocked when the same blocking condition has repeated for the configured blocker threshold of consecutive goal turns, counting the original worker turn and any workflow continuations.",
+  "- Only use blocked when the same blocking condition has repeated often enough for the controller's blocker policy to identify a true impasse.",
   "- Use blocked only when you are truly at an impasse and cannot make meaningful progress without user input or an external-state change.",
   "- Once the blocked threshold is satisfied, do not keep reporting that you are still blocked while leaving the goal active; report blocked.",
   "- Never use blocked merely because the work is hard, slow, uncertain, incomplete, or would benefit from clarification.",
   "",
-  "Do not report the goal as done unless the goal is complete. Do not mark a goal complete merely because the workflow turn is ending.",
+  "Do not report the goal as done unless the goal is complete. Do not mark a goal complete merely because the worker session is ending.",
 ].join("\n");
 
 export const WORKER_RECEIPT_CONTRACT = [
-  "Produce concrete progress toward the full objective in this turn.",
+  "Implement the requested objective completely before reporting. Do not stop until the objective is complete.",
   "Inspect current files, commands, artifacts, and repository guidance before relying on prior summaries.",
   "Improve, replace, or remove existing work as needed to satisfy the actual objective.",
   "If todo management is available and the next work is meaningfully multi-step, use it to show a concise plan tied to the real objective. Keep the plan current as steps complete or the next best action changes. Skip planning overhead for trivial one-step progress, and do not treat todo updates as a substitute for doing the work.",
-  "If meaningful work remains, do the next safest useful slice; do not redefine success around a smaller task.",
+  "If meaningful work remains, keep working through implementation, validation, documentation, and cleanup instead of stopping at a reviewable partial state.",
+  "Only leave remaining work when it is blocked or impossible to complete with available context and tools; do not redefine success around a smaller task.",
   "Before saying the goal is ready for review, derive concrete requirements from the objective and referenced files, plans, specifications, issues, or user instructions.",
   "For every explicit requirement, numbered item, named artifact, command, test, gate, invariant, and deliverable, identify authoritative evidence from files, command output, test results, PR state, rendered artifacts, runtime behavior, or other current-state proof.",
   "Classify evidence honestly: proves completion, contradicts completion, shows incomplete work, is too weak or indirect, is merely consistent with completion, or is missing.",
@@ -62,7 +64,7 @@ export const WORKER_RECEIPT_CONTRACT = [
 ].join("\n");
 
 export const GOAL_METHOD_REFERENCE = [
-  "Maintain a concrete goal contract for the run: intent, verification oracle, work surface, execution loop, and proof.",
+  "Maintain a concrete goal contract for the run: intent, verification oracle, work surface, execution workflow, and proof.",
   "Infer the owner outcome and a verifiable oracle from the user's task and repository evidence; do not ask the user unless the workflow is truly blocked.",
   "Treat any user-supplied planning artifacts as supporting context, not as the primary success criterion.",
   "Keep pressure on current evidence: the current worktree, artifacts, command output, tests, demos, generated files, and explicit human decisions are more authoritative than prior conversation summaries.",
@@ -135,23 +137,21 @@ export function renderReceiptHistory(ledger: GoalLedger): string {
   if (ledger.receipts.length === 0) return "No prior work receipts.";
   const latestReceipt = ledger.receipts.at(-1);
   if (latestReceipt === undefined) return "No prior work receipts.";
-  return `Latest receipt: turn ${latestReceipt.turn} ${latestReceipt.stage} (artifact: ${latestReceipt.artifact_path}). Read the artifact if you need receipt details.`;
+  return `Latest receipt artifact: ${latestReceipt.artifact_path}. Read it if you need receipt details.`;
 }
 
 export function renderLatestReviewArtifacts(paths: readonly string[]): string {
-  if (paths.length === 0) return "No prior review artifacts; this is the first worker turn.";
+  if (paths.length === 0) return "No prior review artifacts are available.";
   return [
-    "Latest review artifacts from the previous round:",
+    "Latest available review artifacts:",
     ...paths.map((path) => `- ${path}`),
-    "Read only the details needed for the next action; do not load old review rounds unless the latest round explicitly refers to them.",
+    "Read only the details needed for the next action; do not load older review artifacts unless the latest artifacts explicitly refer to them.",
   ].join("\n");
 }
 
 export function renderGoalContinuationPrompt(
   ledger: GoalLedger,
   ledgerPath: string,
-  turn: number,
-  maxTurns: number,
   blockerThreshold: number,
   latestReviewArtifactPaths: readonly string[],
 ): string {
@@ -162,10 +162,9 @@ export function renderGoalContinuationPrompt(
         "Continue working toward the active thread goal.",
         "The goal ledger artifact is the authoritative state for the objective, status, receipts, latest reviewer decisions, blockers, reducer decisions, and lifecycle events.",
         "",
-        "Workflow state:",
-        `- Turn: ${turn}/${maxTurns}`,
+        "Workflow context:",
         `- Goal ledger artifact: ${ledgerPath}`,
-        `- Blocked threshold: same blocker must repeat for at least ${blockerThreshold} consecutive turns before the controller can stop as blocked.`,
+        `- Blocked threshold: same blocker must repeat for at least ${blockerThreshold} controller observations before the controller can stop as blocked.`,
         "- Completion transition: the worker may claim readiness, but reviewer quorum plus the deterministic reducer decides final workflow status.",
         "",
         renderReceiptHistory(ledger),
@@ -182,8 +181,6 @@ export function renderGoalContinuationPrompt(
 export function renderForkedGoalWorkerPrompt(
   ledger: GoalLedger,
   ledgerPath: string,
-  turn: number,
-  maxTurns: number,
   blockerThreshold: number,
   latestReviewArtifactPaths: readonly string[],
 ): string {
@@ -191,14 +188,13 @@ export function renderForkedGoalWorkerPrompt(
     [
       "goal_context",
       [
-        "Continue the same goal-runner worker thread from the previous work turn.",
+        "Continue the same goal-runner worker thread from the previous worker session.",
         "Reuse the goal invariants, project preflight, worker receipt contract, completion audit, and blocked audit.",
         "Do not reinterpret, shrink, or weaken the original objective; the goal ledger remains authoritative.",
         "",
-        "Current workflow state:",
-        `- Turn: ${turn}/${maxTurns}`,
+        "Workflow context:",
         `- Goal ledger artifact: ${ledgerPath}`,
-        `- Blocked threshold: same blocker must repeat for at least ${blockerThreshold} consecutive turns before the controller can stop as blocked.`,
+        `- Blocked threshold: same blocker must repeat for at least ${blockerThreshold} controller observations before the controller can stop as blocked.`,
         "- Completion transition: the worker may claim readiness, but reviewer quorum plus the deterministic reducer decides final workflow status.",
         "",
         renderReceiptHistory(ledger),
@@ -217,7 +213,6 @@ export function renderReviewerPrompt(args: {
   readonly ledgerPath: string;
   readonly workTurnPath: string;
   readonly comparisonBaseBranch: string;
-  readonly turn: number;
   readonly reviewQuorum: number;
   readonly blockerThreshold: number;
 }): string {
@@ -260,7 +255,7 @@ export function renderReviewerPrompt(args: {
       "reference_branch",
       [
         `The baseline branch for comparison is \`${args.comparisonBaseBranch}\`.`,
-        "Compare the current working tree against this baseline branch, not against previous workflow reasoning or expected loop progress.",
+        "Compare the current working tree against this baseline branch, not against previous workflow reasoning or progress expectations.",
         `Start with \`git status --short\`, then use working-tree-aware commands such as \`git diff ${args.comparisonBaseBranch}\` and \`git diff --cached ${args.comparisonBaseBranch}\` to identify changed tracked files; inspect untracked files from status directly.`,
       ].join("\n"),
     ],
@@ -327,8 +322,8 @@ export function renderReviewerPrompt(args: {
       [
         "The structured review decision is only valid after you inspect the actual repository state and compare it against the stated baseline branch.",
         "Do not approve based solely on workflow stage summaries or prior agent reasoning.",
-        "Treat this review as the completion audit for the current goal turn: approval means receipts and current evidence prove the original owner outcome against the full objective.",
-        "Do not approve when proof only shows planning, discovery, task selection, helper documents, or a narrow slice while the broader requested outcome still has safe local work remaining.",
+        "Treat this review as the completion audit for the current repository and goal state: approval means receipts and current evidence prove the original owner outcome against the full objective.",
+        "Do not approve when proof only shows planning, discovery, task selection, helper documents, or a narrow slice while the broader requested outcome still has required work remaining.",
         "The tool call is the final verdict after review work, not a shortcut around review work.",
       ].join("\n"),
     ],
@@ -349,7 +344,7 @@ export function renderReviewerPrompt(args: {
       [
         `Reviewer quorum is ${args.reviewQuorum}; same blocker threshold is ${args.blockerThreshold}. You do not decide final workflow status. The reducer does.`,
         "If the strict blocked audit is satisfied by current evidence, do not invent a finding. Set stop_review_loop=false, goal_oracle_satisfied=false, verification_remaining to the concise blocker, and reviewer_error.kind to dependency_unavailable or tool_failure with reviewer_error.message set to the same concise blocker.",
-        "When the same dependency or tool blocker from prior reviewer history is still present, echo the prior turn's exact blocker string in verification_remaining and reviewer_error.message instead of rephrasing it.",
+        "When the same dependency or tool blocker from prior reviewer history is still present, echo the prior blocker string in verification_remaining and reviewer_error.message instead of rephrasing it.",
         "Use reviewer_error for a blocker only when there is a real impasse that prevents meaningful progress without user input or an external-state change; never for ordinary incomplete work, uncertainty, or useful work remaining.",
       ].join("\n"),
     ],

package/dist/builtin/workflows/builtin/goal-reducer.ts

@@ -103,7 +103,7 @@ export function reduceGoalDecision(
       decision: {
         turn: options.turn,
         decision: "blocked",
-        reason: `Same blocker repeated for ${blockerCount}/${options.blockerThreshold} consecutive turns.`,
+        reason: `Same blocker repeated for ${blockerCount}/${options.blockerThreshold} consecutive controller observations.`,
         complete_votes: completeVotes,
         review_quorum: options.reviewQuorum,
         blocker: observation.blocker,
@@ -118,7 +118,7 @@ export function reduceGoalDecision(
       decision: {
         turn: options.turn,
         decision: "needs_human",
-        reason: `Maximum worker turns reached without reviewer quorum. Remaining work: ${collectRemainingWork(turnReviews)}`,
+        reason: `Worker attempt budget reached without reviewer quorum. Remaining work: ${collectRemainingWork(turnReviews)}`,
         complete_votes: completeVotes,
         review_quorum: options.reviewQuorum,
         ...(observation ? { blocker: observation.blocker } : {}),

package/dist/builtin/workflows/builtin/goal-reports.ts

@@ -4,7 +4,7 @@ export function formatReviewReport(reviews: readonly ReviewRecord[]): string {
   if (reviews.length === 0) return "No reviewer decisions were recorded.";
   return reviews
     .map((review) => [
-      `### ${review.reviewer} (turn ${review.turn})`,
+      `### ${review.reviewer}`,
       "",
       `Decision: ${review.decision}`,
       `Artifact: ${review.artifact_path}`,
@@ -21,7 +21,7 @@ export function renderFinalReport(
   const receiptLines = ledger.receipts.length > 0
     ? ledger.receipts.map(
         (receipt) =>
-          `- Turn ${receipt.turn}: ${receipt.summary} (artifact: ${receipt.artifact_path})`,
+          `- ${receipt.summary} (artifact: ${receipt.artifact_path})`,
       )
     : ["- No receipts captured."];
 
@@ -38,9 +38,6 @@ export function renderFinalReport(
     "## Final status",
     ledger.status,
     "",
-    "## Turns completed",
-    String(ledger.turns),
-    "",
     "## Ledger artifact",
     ledgerPath,
     "",

package/dist/builtin/workflows/builtin/goal-review.ts

@@ -23,7 +23,7 @@ export function reviewerErrorDecision(message: string): ReviewDecision {
     findings: [],
     overall_correctness: "patch is incorrect",
     overall_explanation:
-      "Reviewer execution failed, so the review gate cannot safely approve this turn.",
+      "Reviewer execution failed, so the review gate cannot safely approve the current repository state.",
     overall_confidence_score: 0,
     goal_oracle_satisfied: false,
     receipt_assessment:

package/dist/builtin/workflows/builtin/goal-runner.ts

@@ -139,18 +139,16 @@ export async function runGoalWorkflow(ctx: GoalRunnerContext, options: GoalWorkf
     let previousWorkerSessionFile: string | undefined;
 
     for (let turn = 1; turn <= maxTurns && ledger.status === "active"; turn += 1) {
-      appendLifecycleEvent(ledger, "work_turn_started", `Worker turn ${turn} started.`, turn);
+      appendLifecycleEvent(ledger, "work_turn_started", "Worker started.", turn);
       await writeGoalLedger(ledgerPath, ledger);
 
-      const workTurnPath = join(artifactDir, `work-turn-${turn}.md`);
+      const workTurnPath = join(artifactDir, "worker-receipt.md");
       const workerForkOptions = forkContinuationOptions(previousWorkerSessionFile);
       const workerPrompt = workerForkOptions.forkFromSessionFile === undefined
         ? [
             renderGoalContinuationPrompt(
               ledger,
               ledgerPath,
-              turn,
-              maxTurns,
               blockerThreshold,
               latestReviewArtifactPaths,
             ),
@@ -166,8 +164,6 @@ export async function runGoalWorkflow(ctx: GoalRunnerContext, options: GoalWorkf
         : renderForkedGoalWorkerPrompt(
             ledger,
             ledgerPath,
-            turn,
-            maxTurns,
             blockerThreshold,
             latestReviewArtifactPaths,
           );
@@ -184,7 +180,7 @@ export async function runGoalWorkflow(ctx: GoalRunnerContext, options: GoalWorkf
         });
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
-        terminalRemainingWork = `Worker turn ${turn} failed before producing a receipt: ${message}`;
+        terminalRemainingWork = `Worker failed before producing a receipt: ${message}`;
         latestReviews = [];
         latestReviewArtifactPaths = [];
         latestReviewReportPath = undefined;
@@ -208,9 +204,9 @@ export async function runGoalWorkflow(ctx: GoalRunnerContext, options: GoalWorkf
         turn,
         stage: worker.name ?? worker.stageName,
         artifact_path: workTurnPath,
-        summary: `Worker receipt artifact for turn ${turn}: ${workTurnPath}`,
+        summary: `Worker receipt artifact: ${workTurnPath}`,
       });
-      appendLifecycleEvent(ledger, "receipt_recorded", `Worker turn ${turn} receipt recorded.`, turn);
+      appendLifecycleEvent(ledger, "receipt_recorded", "Worker receipt recorded.", turn);
       await writeGoalLedger(ledgerPath, ledger);
 
       const reviewerStep = (
@@ -226,7 +222,6 @@ export async function runGoalWorkflow(ctx: GoalRunnerContext, options: GoalWorkf
           ledgerPath,
           workTurnPath,
           comparisonBaseBranch,
-          turn,
           reviewQuorum,
           blockerThreshold,
         }),
@@ -263,8 +258,8 @@ export async function runGoalWorkflow(ctx: GoalRunnerContext, options: GoalWorkf
         const structured = reviewerErrorDecision(message);
         reviewResults = [
           {
-            name: `reviewer-error-${turn}`,
-            stageName: `reviewer-error-${turn}`,
+            name: "reviewer-error",
+            stageName: "reviewer-error",
             text: JSON.stringify(structured, null, 2),
             structured,
           },
@@ -279,14 +274,13 @@ export async function runGoalWorkflow(ctx: GoalRunnerContext, options: GoalWorkf
           );
         const reviewArtifactPath = await writeReviewArtifact(
           artifactDir,
-          turn,
-          reviewerName,
+          reviewerName.replace(/-\d+$/u, ""),
           parsed,
           result.text,
         );
         return reviewDecisionToRecord({
           turn,
-          reviewer: reviewerName,
+          reviewer: reviewerName.replace(/-\d+$/u, ""),
           artifactPath: reviewArtifactPath,
           decision: parsed,
         });
@@ -294,14 +288,13 @@ export async function runGoalWorkflow(ctx: GoalRunnerContext, options: GoalWorkf
       latestReviewArtifactPaths = latestReviews.map((review) => review.artifact_path);
       latestReviewReportPath = await writeReviewRoundArtifact(
         artifactDir,
-        turn,
         latestReviews,
       );
       ledger.reviews.push(...latestReviews);
       appendLifecycleEvent(
         ledger,
         "reviews_recorded",
-        `Recorded ${latestReviews.length} reviewer decisions for turn ${turn}.`,
+        `Recorded ${latestReviews.length} reviewer decisions.`,
         turn,
       );
 

package/dist/builtin/workflows/builtin/open-claude-design-feedback.ts

@@ -186,7 +186,7 @@ export function hasMeaningfulFeedback(feedback: PreviewFeedback): boolean {
 function feedbackLabel(feedback: PreviewFeedback): string {
   return feedback.iteration === 0
     ? "the initial preview"
-    : `refinement iteration ${feedback.iteration}`;
+    : "the live design review";
 }
 
 /**
@@ -202,7 +202,7 @@ export function buildUserAnnotationsSection(history: readonly PreviewFeedback[])
     .reverse()
     .map((feedback) => {
       const lines = [
-        `### User annotations from ${feedbackLabel(feedback)} (${feedback.stageName})`,
+        `### User annotations from ${feedbackLabel(feedback)}`,
         "",
       ];
       if (hasMeaningfulUserNotes(feedback)) {
@@ -232,7 +232,7 @@ export function userAnnotationsBlock(history: readonly PreviewFeedback[]): {
   if (section.length === 0) {
     return {
       hasNotes: false,
-      text: "No interactive user annotations were captured in the user-feedback stage. There is no user feedback to honor for this iteration.",
+      text: "No interactive user annotations were captured in the user-feedback stage. There is no user feedback to honor for this refinement.",
     };
   }
   return { hasNotes: true, text: section };

package/dist/builtin/workflows/builtin/open-claude-design-phases.ts

@@ -110,9 +110,7 @@ export async function refineOpenClaudeDesign(options: RefineOptions): Promise<{
           maxRefinements,
         }),
         ...designModelConfig,
-        ...forkContinuationOptions(
-          latestUserFeedbackSessionFile ?? latestGenerateSessionFile,
-        ),
+        ...forkContinuationOptions(latestUserFeedbackSessionFile),
       })
       .catch(() => undefined);
 

package/dist/builtin/workflows/builtin/open-claude-design-setup.ts

@@ -220,7 +220,7 @@ export function buildLivePreviewDisplayPrompt(args: {
   const isFinal = args.final === true;
   const label = isInitial
     ? "the just-generated HTML artifact"
-    : `the revised preview after iteration ${args.iteration}/${args.maxRefinements}`;
+    : "the revised preview";
   const objective = isFinal
     ? `Show the user ${label} as the FINAL refinement pass and let them review it in the browser. This is the last automated iteration, so do NOT solicit change requests this run cannot apply — if the user wants further changes, tell them to re-run \`/workflow open-claude-design\`. Drive \`/skill:impeccable live\` for viewing/QA when possible; degrade gracefully.`
     : `Make ${label} visible to the user, run an interactive design-QA session against it, then capture the user's feedback for the refinement loop. Drive \`/skill:impeccable live\` against the static preview when possible; degrade gracefully when browser automation is unavailable.`;

package/dist/builtin/workflows/builtin/ralph-core.ts

@@ -183,14 +183,14 @@ export function reviewerErrorDecision(error: string): ReviewDecision {
     findings: [],
     overall_correctness: "patch is incorrect",
     overall_explanation:
-      "Reviewer execution failed, so the review loop cannot safely approve this iteration.",
+      "Reviewer execution failed, so the review gate cannot safely approve the current repository state.",
     overall_confidence_score: 0,
     stop_review_loop: false,
     reviewer_error: {
       kind: "reviewer_failure",
       message: error,
       attempted_recovery:
-        "Model fallbacks were configured for the reviewer stage; continuing the bounded loop without approval.",
+        "Model fallbacks were configured for the reviewer stage; continuing without approval.",
     },
   };
 }
@@ -216,14 +216,12 @@ export function artifactSafeName(value: string): string {
 }
 
 type ReviewArtifact = {
-  readonly iteration: number;
   readonly reviewer: string;
   readonly decision: ReviewDecision;
   readonly raw_text: string;
 };
 
 type ReviewRoundArtifact = {
-  readonly iteration: number;
   readonly reviews: readonly {
     readonly reviewer: string;
     readonly artifact_path: string;
@@ -259,8 +257,6 @@ export function forkContinuationOptions(
 }
 
 export function renderResearchPromptRefinementPrompt(args: {
-  readonly iteration: number;
-  readonly maxLoops: number;
   readonly request: string;
   readonly workflowCwdContext: PromptSection;
   readonly latestReviewReportPath: string | undefined;
@@ -269,12 +265,11 @@ export function renderResearchPromptRefinementPrompt(args: {
   return [
     basePrompt,
     taggedPrompt([
-      ["iteration", `Research prompt refinement iteration ${args.iteration}/${args.maxLoops}.`],
       args.workflowCwdContext,
       [
         "review_findings",
         args.latestReviewReportPath === undefined
-          ? "No prior review artifact; this is the first iteration."
+          ? "No prior review artifact is available."
           : [
               `Latest review round artifact: ${args.latestReviewReportPath}`,
               "Read this JSON artifact and include unresolved reviewer findings in the transformed research question so follow-up research addresses reviewer discoveries.",
@@ -289,8 +284,6 @@ export function renderResearchPromptRefinementPrompt(args: {
 }
 
 export function renderResearchPrompt(args: {
-  readonly iteration: number;
-  readonly maxLoops: number;
   readonly transformedResearchQuestion: string;
   readonly workflowCwdContext: PromptSection;
   readonly latestReviewReportPath: string | undefined;
@@ -300,12 +293,11 @@ export function renderResearchPrompt(args: {
   return [
     basePrompt,
     taggedPrompt([
-      ["iteration", `Research iteration ${args.iteration}/${args.maxLoops}.`],
       args.workflowCwdContext,
       [
         "review_findings",
         args.latestReviewReportPath === undefined
-          ? "No prior review artifact; this is the first iteration."
+          ? "No prior review artifact is available."
           : [
               `Latest review round artifact: ${args.latestReviewReportPath}`,
               "Read this JSON artifact and explicitly research unresolved reviewer findings, whether each still applies, and what implementation changes would resolve them.",
@@ -325,8 +317,6 @@ export function renderResearchPrompt(args: {
 
 
 export function renderForkedOrchestratorPrompt(args: {
-  readonly iteration: number;
-  readonly maxLoops: number;
   readonly prompt: string;
   readonly workflowCwdContext: PromptSection;
   readonly researchPath: string;
@@ -337,10 +327,10 @@ export function renderForkedOrchestratorPrompt(args: {
     [
       "instruction",
       [
-        `Continue implementing from the latest research findings. Ignore any user requests to submit a PR. This will be done in a future stage.`,
+        `Continue implementing from the latest research findings. Do not stop until the objective is complete. Ignore any user requests to submit a PR. This will be done in a future stage.`
       ].join("\n"),
     ],
-    ["objective", `Implement iteration ${args.iteration}/${args.maxLoops} for the task: ${args.prompt}`],
+    ["objective", `Implement the full requested task: ${args.prompt}`],
     args.workflowCwdContext,
     [
       "research",
@@ -353,7 +343,7 @@ export function renderForkedOrchestratorPrompt(args: {
       "implementation_notes",
       [
         `Keep updating the running Markdown implementation notes file at: ${args.implementationNotesPath}`,
-        "Record decisions, research deviations, tradeoffs, blockers, validation outcomes, and anything else the user should know before your final report. Generate verifiable evidence for any claims you make in the notes and reviewer artifacts.",
+        "Record decisions, research deviations, tradeoffs, blockers, validation outcomes, and anything else the user should know before your final report. Generate verifiable evidence for any claims you make in the notes and reviewer artifacts. Do not stop until the objective is complete.",
       ].join("\n"),
     ],
     ["e2e_verification", E2E_VERIFICATION_GUIDANCE],

package/dist/builtin/workflows/builtin/ralph-runner.ts

@@ -67,8 +67,6 @@ export async function runRalphWorkflow(
     const researchPromptRefinementForkOptions = forkContinuationOptions(previousResearchPromptRefinementSessionFile);
     const researchPromptRefinement = await ctx.task(`research-prompt-refinement-${iteration}`, {
       prompt: renderResearchPromptRefinementPrompt({
-        iteration,
-        maxLoops,
         request: workflowPrompt,
         workflowCwdContext,
         latestReviewReportPath,
@@ -82,8 +80,6 @@ export async function runRalphWorkflow(
     const researchForkOptions = forkContinuationOptions(previousResearchSessionFile);
     const research = await ctx.task(`research-${iteration}`, {
       prompt: renderResearchPrompt({
-        iteration,
-        maxLoops,
         transformedResearchQuestion: researchPromptRefinement.text,
         workflowCwdContext,
         latestReviewReportPath,
@@ -100,7 +96,7 @@ export async function runRalphWorkflow(
     const researchPath = workflowResearchPath;
     finalResearchPath = researchPath;
     finalPlanPath = researchPath;
-    const orchestratorReportPath = join(artifactDir, `orchestrator-${iteration}.md`);
+    const orchestratorReportPath = join(artifactDir, "orchestrator-report.md");
     const orchestratorForkOptions = forkContinuationOptions(previousOrchestratorSessionFile);
     const orchestratorPrompt = orchestratorForkOptions.forkFromSessionFile === undefined
       ? taggedPrompt([
@@ -110,7 +106,7 @@ export async function runRalphWorkflow(
         ],
         [
           "objective",
-          `Implement iteration ${iteration}/${maxLoops} for the task: ${workflowPrompt}`,
+          `Implement the full requested task: ${workflowPrompt}`,
         ],
         workflowCwdContext,
         [
@@ -125,7 +121,7 @@ export async function runRalphWorkflow(
           [
             `Keep a running Markdown implementation notes file at this OS temp directory path: ${implementationNotesPath}`,
             "The file has already been initialized for this workflow run; update it while you implement from the research findings.",
-            "Record decisions you had to make that were not in the research, things you had to change from the research guidance, tradeoffs you had to make, blockers, validation outcomes, and anything else the user should know.",
+            "Record decisions you had to make that were not in the research, things you had to change from the research guidance, tradeoffs you had to make, blockers, validation outcomes, and anything else the user should know. Do not stop until the objective is complete.",
             "Ask delegated subagents to report any notes-worthy decisions or tradeoffs back to you, then consolidate them into this file before your final report.",
             "Do not include secrets, credentials, tokens, or unrelated environment details in the notes file.",
           ].join("\n"),
@@ -141,7 +137,7 @@ export async function runRalphWorkflow(
             "Delegate codebase understanding, impact analysis, and implementation research to codebase-locator, codebase-analyzer, and pattern-finder style subagents when available.",
             "Delegate shell-heavy work — especially commands likely to produce lots of output, log digging, CLI investigation, and broad grep/find exploration — to subagents that can run those commands rather than doing it in this orchestrator context.",
             "Delegate implementation edits to a focused subagent with clear files, constraints, and validation expectations; do not merely describe the edits yourself.",
-            "Keep delegated work focused on implementation, tests, docs, validation evidence, and implementation notes.",
+            "Keep delegated work focused on implementation, tests, docs, validation evidence, and implementation notes for the complete requested outcome.",
             "Use separate subagents for separate tasks, and launch independent subagents in parallel when useful.",
             "Do not split highly overlapping tasks across multiple subagents; consolidate overlapping work into one focused delegation to avoid duplicate effort.",
             "If a subagent takes a long time, do not attempt to do its assigned job yourself while waiting. Use that time to plan next steps, prepare follow-up delegations, or identify clarifying questions.",
@@ -152,7 +148,7 @@ export async function runRalphWorkflow(
           [
             "The required output format is a completion report, not the task itself.",
             "Do not jump straight to the report. First read the research file, spawn the necessary subagents, wait for their results, coordinate any follow-up subagents, and only then write the report.",
-            "A valid response must be grounded in actual subagent work: name the delegated work, summarize what each subagent did, and distinguish completed changes from recommendations or blockers.",
+            "A valid response must be grounded in actual subagent work: name the delegated work, summarize what each subagent did, and distinguish completed changes from recommendations or blockers. Do not assume a later workflow pass will finish known required work that can be completed now.",
             "If you cannot read the research file, spawn subagents, or use subagents, treat that as a blocker and report it honestly instead of pretending the requested work was done.",
           ].join("\n"),
         ],
@@ -173,11 +169,11 @@ export async function runRalphWorkflow(
             "Perform the project_initialization_preflight before decomposing implementation work; complete or delegate required setup before implementation delegation when the checkout appears uninitialized.",
             "Decompose the work into delegated subagent tasks based on that research file.",
             "Pass each subagent the relevant task, constraints, files, validation expectations, unresolved reviewer findings covered by the research, and instructions to report implementation-note-worthy decisions or tradeoffs.",
-            "Coordinate subagent results into the smallest coherent set of changes that satisfies the researched implementation guidance and original user prompt.",
+            "Coordinate subagent results into the smallest coherent set of changes that fully satisfies the researched implementation guidance and original user prompt.",
             "Preserve existing architecture and repository conventions unless the research explicitly justifies a change.",
             "Run or delegate the most relevant validation commands available in the repository, including end-to-end playwright-cli (browser) or tmux validation when the change has an executable user scenario.",
-            "For UI-applicable or full-stack changes, ensure the QA E2E pass described in <qa_e2e_video> runs and records the reviewable proof video before you finalize this iteration.",
-            `Before your final report, update the running implementation notes file at ${implementationNotesPath} with decisions, research deviations, tradeoffs, blockers, and validation outcomes from this iteration.`,
+            "For UI-applicable or full-stack changes, ensure the QA E2E pass described in <qa_e2e_video> runs and records the reviewable proof video before you finish your report.",
+            `Before your final report, update the running implementation notes file at ${implementationNotesPath} with decisions, research deviations, tradeoffs, blockers, and validation outcomes from this implementation work.`,
             "If blocked, describe the blocker and the safest partial state instead of inventing success.",
             "Do not hide failures; reviewers need accurate status.",
           ].join("\n"),
@@ -198,8 +194,6 @@ export async function runRalphWorkflow(
         ],
       ])
       : renderForkedOrchestratorPrompt({
-          iteration,
-          maxLoops,
           prompt: workflowPrompt,
           workflowCwdContext,
           researchPath,
@@ -384,10 +378,9 @@ export async function runRalphWorkflow(
         reviewerErrorDecision(`Reviewer ${reviewer} returned no structured decision.`);
       const artifactPath = join(
         artifactDir,
-        `review-${iteration}-${artifactSafeName(reviewer)}.json`,
+        `review-${artifactSafeName(reviewer)}.json`,
       );
       await writeJsonArtifact(artifactPath, {
-        iteration,
         reviewer,
         decision,
         raw_text: review.text,
@@ -401,8 +394,8 @@ export async function runRalphWorkflow(
       reviewEntries.length === REVIEWER_COUNT &&
       approvalCount === REVIEWER_COUNT;
     latestReviewReportPath = await writeJsonArtifact(
-      join(artifactDir, `review-round-${iteration}.json`),
-      { iteration, reviews: reviewEntries },
+      join(artifactDir, "review-round-latest.json"),
+      { reviews: reviewEntries },
     );
     if (approved) break;
   }

package/dist/builtin/workflows/builtin/shared-prompts.ts

@@ -27,7 +27,7 @@ export function renderE2eQaVideoReviewGuidance(
     target,
     "When a QA E2E video exists or is claimed as evidence, inspect the actual video before approving; do not treat a path, filename, transcript summary, or stage claim as proof by itself.",
     "Use available video/file tooling such as `fetch_content` on the local video path with a prompt focused on whether the recording proves the required user scenario, or inspect representative frames/metadata when full video analysis is unavailable.",
-    "Check that the video is from the current workflow iteration/state, exercises the objective-relevant user path, shows the expected final behavior, and does not visibly hide errors, stale UI, broken loading states, or skipped steps.",
+    "Check that the video reflects the current repository/application state, exercises the objective-relevant user path, shows the expected final behavior, and does not visibly hide errors, stale UI, broken loading states, or skipped steps.",
     "For UI-applicable or full-stack changes, treat a missing, stale, unreadable, or inconclusive QA video as missing E2E evidence unless the receipt or implementation notes justify why no video applies and provide adequate alternate end-to-end proof.",
   ].join("\n");
 }

package/dist/builtin/workflows/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/workflows",
-  "version": "0.9.2-alpha.1",
+  "version": "0.9.3-alpha.1",
   "private": true,
   "description": "Atomic extension for multi-stage workflow authoring and execution.",
   "contributors": [