@bastani/atomic 0.5.31-0 → 0.5.32-0

package/dist/sdk/runtime/tmux.d.ts

@@ -65,6 +65,19 @@ export declare function tmuxRun(args: string[]): TmuxResult;
  * @returns The pane ID of the initial pane (e.g., "%0")
  */
 export declare function createSession(sessionName: string, initialCommand: string, windowName?: string, cwd?: string, envVars?: Record<string, string>): string;
+/**
+ * Install a hook that kills the entire session when the given pane's
+ * process exits. Used by chat sessions so the session is torn down
+ * when the agent CLI exits — whether via `/exit`, a deliberate double
+ * Ctrl+C, or a crash — without leaving the footer pane keeping the
+ * session alive.
+ *
+ * The hook is session-scoped (pane-scoped hooks don't fire because the
+ * pane is already gone when `pane-exited` would run) and guarded with
+ * `#{hook_pane}` so the footer pane's eventual exit cascade doesn't
+ * re-trigger it. `kill-session` is idempotent in any case.
+ */
+export declare function killSessionOnPaneExit(sessionName: string, paneId: string): void;
 /**
  * Create a new window in an existing session without switching focus.
  *

package/dist/sdk/runtime/tmux.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tmux.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/tmux.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tmux.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/tmux.ts"],"names":[],"mappings":"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"}

package/dist/sdk/workflows/builtin/ralph/claude/index.d.ts

@@ -1,11 +1,16 @@
 /**
- * Ralph workflow for Claude Code — plan → orchestrate → review → debug loop.
+ * Ralph workflow for Claude Code — plan → orchestrate → review loop.
  *
  * Each sub-agent invocation spawns its own visible session in the graph,
  * so users can see each iteration's progress in real time. The loop
  * terminates when:
  *   - `max_loops` iterations have completed (defaults to {@link DEFAULT_MAX_LOOPS}), OR
- *   - Two parallel reviewer passes both return zero findings.
+ *   - Both parallel reviewer passes return `overall_correctness === "patch is correct"`.
+ *
+ * On a failed review the merged findings are formatted into a markdown
+ * brief by {@link formatReviewForReplan} and fed into the next iteration's
+ * planner, which is responsible for validating, deduping, and clustering
+ * them into shared root causes before revising the RFC.
  *
  * The reviewer stages run **headless** via the Claude Agent SDK with
  * `outputFormat: { type: "json_schema", schema: REVIEW_RESULT_JSON_SCHEMA }`,

package/dist/sdk/workflows/builtin/ralph/claude/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;;;;;;;;;;AA+CH,wBAuMa"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;;;;;;;;;;AA8CH,wBA6Ka"}

package/dist/sdk/workflows/builtin/ralph/copilot/index.d.ts

@@ -1,11 +1,16 @@
 /**
- * Ralph workflow for Copilot — plan → orchestrate → review → debug loop.
+ * Ralph workflow for Copilot — plan → orchestrate → review loop.
  *
  * Each sub-agent invocation spawns its own visible session in the graph,
  * so users can see each iteration's progress in real time. The loop
  * terminates when:
  *   - `max_loops` iterations have completed (defaults to {@link DEFAULT_MAX_LOOPS}), OR
- *   - Two parallel reviewer passes both return zero findings.
+ *   - Both parallel reviewer passes return `overall_correctness === "patch is correct"`.
+ *
+ * On a failed review the merged findings are formatted into a markdown
+ * brief by {@link formatReviewForReplan} and fed into the next iteration's
+ * planner, which is responsible for validating, deduping, and clustering
+ * them into shared root causes before revising the RFC.
  *
  * The reviewer stages use a `submit_review` custom tool (defined via
  * `defineTool` with Zod schema validation) to guarantee the review result

package/dist/sdk/workflows/builtin/ralph/copilot/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/copilot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;;;;;;;;;;;;AA6DH,wBA0Ma"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/copilot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;;;;;;;;;;AA4DH,wBAsLa"}

package/dist/sdk/workflows/builtin/ralph/helpers/prompts.d.ts

@@ -1,17 +1,29 @@
 /**
  * Ralph Prompt Utilities
  *
- * Prompts used by the Ralph plan → orchestrate → review → debug loop:
- *   - buildPlannerPrompt:           initial planning OR re-planning from a debugger report
+ * Prompts used by the Ralph plan → orchestrate → review loop:
+ *   - buildPlannerPrompt:           initial planning OR re-planning from reviewer findings
  *   - buildOrchestratorPrompt:      spawn workers to execute the task list
  *   - buildInfraDiscoveryPrompts:   prompts for parallel sub-agent infrastructure discovery
  *   - buildReviewPrompt:            structured code review with injected changeset + discovery context
- *   - buildDebuggerReportPrompt:    diagnose review findings, produce a re-plan brief
  *
  * Plus Zod schemas for structured output, parsing helpers for the reviewer
- * JSON output, and the debugger markdown report.
+ * JSON output, and {@link formatReviewForReplan} which renders the merged
+ * reviewer output as the markdown brief consumed by the next planner
+ * iteration.
  */
 import { z } from "zod";
+/**
+ * Caveman response-style directive injected into every Ralph prompt.
+ *
+ * Goal: shrink free-form prose across many loop iterations to cut tokens
+ * without dropping technical substance. Carve-outs preserve every
+ * machine-consumed contract (schemas, headers, enums, tool args, code).
+ *
+ * Placement: appended via {@link withCaveman} so each builder's strict
+ * output-format block remains the final instruction the model reads.
+ */
+export declare const CAVEMAN_INSTRUCTION = "## Response Style \u2014 Terse Caveman\n\nRespond terse like smart caveman. All technical substance stay. Only fluff die.\n\n### Persistence\nACTIVE EVERY RESPONSE. No revert after many turns. No filler drift. Still active if unsure.\n\n### Rules\nDrop: articles (a/an/the), filler (just/really/basically/actually/simply), pleasantries (sure/certainly/of course/happy to), hedging. Fragments OK. Short synonyms (big not extensive, fix not \"implement a solution for\"). Technical terms exact. Code blocks unchanged. Errors quoted exact.\n\nPattern: `[thing] [action] [reason]. [next step].`\n\nNot: \"Sure! I'd be happy to help you with that. The issue you're experiencing is likely caused by...\"\nYes: \"Bug in auth middleware. Token expiry check use `<` not `<=`. Fix:\"\n\n### Intensity\nDrop articles, fragments OK, short synonyms.\n\nExample \u2014 \"Why React component re-render?\"\n\"New object ref each render. Inline object prop = new ref = re-render. Wrap in `useMemo`.\"\n\nExample \u2014 \"Explain database connection pooling.\"\n\"Pool reuse open DB connections. No new connection per request. Skip handshake overhead.\"\n\n### Auto-Clarity\nDrop caveman for: security warnings, irreversible action confirmations, multi-step sequences where fragment order risks misread, user asks to clarify or repeats question. Resume caveman after clear part done.\n\nExample \u2014 destructive op:\n> **Warning:** This will permanently delete all rows in the `users` table and cannot be undone.\n> ```sql\n> DROP TABLE users;\n> ```\n> Caveman resume. Verify backup exist first.\n\n### Boundaries \u2014 caveman MUST NOT touch\nCaveman compresses free-form prose only. Leave the following exactly as the prompt or schema specifies:\n\n- Code blocks, commit messages, PR descriptions: write normal.\n- Exact enum / literal strings the schema or prompt specifies (e.g. `\"patch is correct\"`, `\"patch is incorrect\"`, task statuses `pending` / `in_progress` / `completed` / `error`).\n- Required section headers and template scaffolding (e.g. `# Debugger Report`, `## Issues Identified`, RFC section names) \u2014 verbatim.\n- Tool names, tool arguments, JSON keys, schema field names.\n- File paths, URLs, command invocations, error text quoted from tools.\n- SQL, JSON, Markdown templates: compress prose inside, never the structure.\n- Task titles / descriptions persisted via task-management tools: keep them self-contained and unambiguous.\n- When the prompt says output ONLY a path / ONLY a fenced block / ONLY a JSON payload, obey that exactly \u2014 caveman does not override output contracts.";
 /** Zod schema for a single review finding. */
 export declare const ReviewFindingSchema: z.ZodObject<{
     title: z.ZodString;
@@ -41,7 +53,10 @@ export declare const ReviewResultSchema: z.ZodObject<{
             }, z.core.$strip>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
-    overall_correctness: z.ZodString;
+    overall_correctness: z.ZodEnum<{
+        "patch is correct": "patch is correct";
+        "patch is incorrect": "patch is incorrect";
+    }>;
     overall_explanation: z.ZodString;
     overall_confidence_score: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -68,7 +83,10 @@ export declare const REVIEW_RESULT_JSON_SCHEMA: z.core.ZodStandardJSONSchemaPayl
             }, z.core.$strip>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
-    overall_correctness: z.ZodString;
+    overall_correctness: z.ZodEnum<{
+        "patch is correct": "patch is correct";
+        "patch is incorrect": "patch is incorrect";
+    }>;
     overall_explanation: z.ZodString;
     overall_confidence_score: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>>;
@@ -93,17 +111,23 @@ export declare function mergeReviewResults(a: StructuredReviewResult, b: Structu
 export interface PlannerContext {
     /** 1-indexed loop iteration. Iteration 1 = initial plan; >1 = re-plan. */
     iteration: number;
-    /** Markdown report from the previous iteration's debugger sub-agent. */
-    debuggerReport?: string;
+    /**
+     * Markdown rendering of the previous iteration's merged reviewer
+     * findings. Produced by {@link formatReviewForReplan}. The planner is
+     * responsible for validating, deduping, and clustering findings into
+     * shared root causes before revising the RFC — there is no separate
+     * debugger stage.
+     */
+    reviewReport?: string;
 }
 /**
  * Build the planner prompt. The first iteration authors an RFC from the
- * original spec; subsequent iterations revise the RFC using the debugger
- * report from the previous loop iteration.
+ * original spec; subsequent iterations revise the RFC using the merged
+ * reviewer findings from the previous loop iteration.
  *
  * The planner's deliverable is a filled-in Technical Design Document / RFC
- * rendered as markdown text
- * consumes the RFC as design context
+ * rendered as markdown text; the orchestrator consumes the RFC as design
+ * context.
  */
 export declare function buildPlannerPrompt(spec: string, context?: PlannerContext): string;
 export interface OrchestratorContext {
@@ -203,28 +227,6 @@ export interface ReviewContext {
  * both committed and uncommitted — without expensive tool calls.
  */
 export declare function buildReviewPrompt(spec: string, context: ReviewContext): string;
-export interface DebuggerContext {
-    /** 1-indexed loop iteration the debugger is investigating. */
-    iteration: number;
-    /**
-     * Branch changeset captured immediately before the review. Provides the
-     * debugger with the same file-level context as the reviewer.
-     */
-    changeset: {
-        baseBranch: string;
-        diffStat: string;
-        uncommitted: string;
-        nameStatus: string;
-        errors: string[];
-    };
-}
-/**
- * Build a prompt asking the debugger sub-agent to investigate a set of review
- * findings and produce a structured report. The debugger MUST NOT apply
- * fixes — its only deliverable is the report, which the next iteration's
- * planner consumes.
- */
-export declare function buildDebuggerReportPrompt(review: ReviewResult | null, rawReview: string, context: DebuggerContext): string;
 export declare function filterActionable(parsed: {
     findings: ReviewFinding[];
     overall_correctness: string;
@@ -232,12 +234,18 @@ export declare function filterActionable(parsed: {
     overall_confidence_score?: number;
 }): ReviewResult;
 /**
- * Extract the LAST fenced ```markdown block from a piece of text. Used for
- * parsing the debugger's structured report out of a long Claude pane
- * scrollback or any other output that may include extra prose.
+ * Render the merged reviewer result as the markdown brief consumed by the
+ * next iteration's planner.
+ *
+ * Findings are grouped by file path so the planner sees clusters of related
+ * symptoms together (often a hint at a shared root cause). Within each
+ * group findings are ordered by ascending priority (P0 first). The
+ * `overall_explanation` is included verbatim so the planner has the
+ * reviewers' overall narrative.
  *
- * Falls back to the trimmed full input when no fenced block is present, so
- * the planner still receives the debugger's content even if formatting drifts.
+ * When `parsed === null` (SDK validation failed) the raw transcript is
+ * surfaced inside a clearly-labelled fenced block so the planner knows the
+ * data is unstructured and must be investigated rather than trusted.
  */
-export declare function extractMarkdownBlock(content: string): string;
+export declare function formatReviewForReplan(parsed: ReviewResult | null, rawText: string): string;
 //# sourceMappingURL=prompts.d.ts.map

package/dist/sdk/workflows/builtin/ralph/helpers/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/helpers/prompts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/helpers/prompts.ts"],"names":[],"mappings":"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"}

package/dist/sdk/workflows/builtin/ralph/helpers/review.d.ts

@@ -6,14 +6,18 @@
  */
 import type { ReviewResult } from "./prompts.ts";
 /**
- * Check whether the reviewer produced actionable findings.
+ * Check whether the loop should iterate again.
  *
  * Returns true when:
- * 1. The parsed ReviewResult has one or more findings, OR
- * 2. The review could not be parsed (null) but the raw response
- *    text is non-empty (treat unparseable output as actionable).
+ * 1. The review could not be parsed (null) but the raw response text is
+ *    non-empty — treat unparseable output as actionable so the loop keeps
+ *    iterating instead of silently exiting on a missing reviewer.
+ * 2. The merged review reports `overall_correctness === "patch is incorrect"`.
+ *    {@link mergeReviewResults} sets the merged value to "patch is incorrect"
+ *    if EITHER reviewer flagged it, so "patch is correct" here means BOTH
+ *    reviewers signed off — the only stop condition.
  *
- * @param review  - Parsed ReviewResult, or null if parsing failed.
+ * @param review  - Parsed (merged) ReviewResult, or null if parsing failed.
  * @param rawText - The raw reviewer response text.
  */
 export declare function hasActionableFindings(review: ReviewResult | null, rawText: string): boolean;

package/dist/sdk/workflows/builtin/ralph/helpers/review.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/helpers/review.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,GAAG,IAAI,EAC3B,OAAO,EAAE,MAAM,GACd,OAAO,CAQT"}
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/helpers/review.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,GAAG,IAAI,EAC3B,OAAO,EAAE,MAAM,GACd,OAAO,CAKT"}

package/dist/sdk/workflows/builtin/ralph/opencode/index.d.ts

@@ -1,11 +1,16 @@
 /**
- * Ralph workflow for OpenCode — plan → orchestrate → review → debug loop.
+ * Ralph workflow for OpenCode — plan → orchestrate → review loop.
  *
  * Each sub-agent invocation spawns its own visible session in the graph,
  * so users can see each iteration's progress in real time. The loop
  * terminates when:
  *   - `max_loops` iterations have completed (defaults to {@link DEFAULT_MAX_LOOPS}), OR
- *   - Two parallel reviewer passes both return zero findings.
+ *   - Both parallel reviewer passes return `overall_correctness === "patch is correct"`.
+ *
+ * On a failed review the merged findings are formatted into a markdown
+ * brief by {@link formatReviewForReplan} and fed into the next iteration's
+ * planner, which is responsible for validating, deduping, and clustering
+ * them into shared root causes before revising the RFC.
  *
  * The reviewer stages use the OpenCode SDK's structured output
  * (`format: { type: "json_schema" }`) to guarantee the review result

package/dist/sdk/workflows/builtin/ralph/opencode/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;;;;;;;;;;;;AAyDH,wBAmMa"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/ralph/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;;;;;;;;;;AAwDH,wBAyKa"}

package/dist/sdk/workflows/index.d.ts

@@ -15,7 +15,7 @@ export type { ClaudeSessionOptions, ClaudeQueryOptions } from "../providers/clau
 export { validateCopilotWorkflow } from "../providers/copilot.ts";
 export { validateOpenCodeWorkflow } from "../providers/opencode.ts";
 export type { TmuxResult, TmuxSession, SessionType } from "../runtime/tmux.ts";
-export { SOCKET_NAME, isTmuxInstalled, getMuxBinary, resetMuxBinaryCache, isInsideTmux, isInsideAtomicSocket, createSession, createWindow, createPane, sendLiteralText, sendSpecialKey, capturePane, capturePaneVisible, capturePaneScrollback, killSession, killWindow, sessionExists, listSessions, attachSession, spawnMuxAttach, switchClient, getCurrentSession, attachOrSwitch, detachAndAttachAtomic, selectWindow, setSessionEnv, getSessionEnv, parseSessionName, tmuxRun, normalizeTmuxCapture, normalizeTmuxLines, } from "../runtime/tmux.ts";
+export { SOCKET_NAME, isTmuxInstalled, getMuxBinary, resetMuxBinaryCache, isInsideTmux, isInsideAtomicSocket, createSession, createWindow, createPane, sendLiteralText, sendSpecialKey, capturePane, capturePaneVisible, capturePaneScrollback, killSession, killSessionOnPaneExit, killWindow, sessionExists, listSessions, attachSession, spawnMuxAttach, switchClient, getCurrentSession, attachOrSwitch, detachAndAttachAtomic, selectWindow, setSessionEnv, getSessionEnv, parseSessionName, tmuxRun, normalizeTmuxCapture, normalizeTmuxLines, } from "../runtime/tmux.ts";
 export { AGENTS, discoverWorkflows, findWorkflow, loadWorkflowsMetadata, WORKFLOWS_GITIGNORE, } from "../runtime/discovery.ts";
 export type { DiscoveredWorkflow, WorkflowWithMetadata, WorkflowMetadataStatus, } from "../runtime/discovery.ts";
 export { WorkflowLoader } from "../runtime/loader.ts";

package/dist/sdk/workflows/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sdk/workflows/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExE,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,YAAY,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,qBAAqB,IAAI,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC3F,YAAY,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAG7F,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC5I,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAGpE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EACL,WAAW,EACX,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,UAAU,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,OAAO,EACP,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,MAAM,EACN,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sdk/workflows/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExE,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,YAAY,EAAE,YAAY,IAAI,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,qBAAqB,IAAI,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC3F,YAAY,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAG7F,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAC5I,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAGpE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EACL,WAAW,EACX,eAAe,EACf,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,EACX,qBAAqB,EACrB,UAAU,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,OAAO,EACP,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,MAAM,EACN,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/atomic",
-  "version": "0.5.31-0",
+  "version": "0.5.32-0",
   "description": "Configuration management CLI and SDK for coding agents",
   "type": "module",
   "license": "MIT",
@@ -43,14 +43,14 @@
     "src",
     "dist",
     "assets/settings.schema.json",
-    ".agents/skills",
     ".claude/agents",
     ".claude/settings.json",
     ".opencode/agents",
     ".opencode/opencode.json",
     ".github/agents",
     ".github/lsp.json",
-    ".mcp.json"
+    ".mcp.json",
+    ".agents/skills"
   ],
   "scripts": {
     "dev": "bun run src/cli.ts",

package/src/commands/cli/chat/index.ts

@@ -37,6 +37,7 @@ import {
   createSession,
   detachAndAttachAtomic,
   killSession,
+  killSessionOnPaneExit,
   setSessionEnv,
   spawnMuxAttach,
   switchClient,
@@ -263,6 +264,12 @@ export async function chatCommand(options: ChatCommandOptions = {}): Promise<num
     const paneId = createSession(windowName, shellCmd, undefined, projectRoot);
     setSessionEnv(windowName, "ATOMIC_AGENT", agentType);
 
+    // When the agent CLI exits (via `/exit`, double Ctrl+C, or crash),
+    // tear down the whole session so the footer pane doesn't keep it
+    // alive in the background. Pane-scoped so the footer's own exit
+    // (which cascades from the kill-session) doesn't re-trigger.
+    killSessionOnPaneExit(windowName, paneId);
+
     // Split the pane so the agent CLI runs on top and the React footer
     // (provider pill + window name) runs in a 5% bottom pane. Matches
     // the workflow-window layout, minus the keyboard hints (chat sessions

package/src/sdk/runtime/tmux.conf

@@ -53,14 +53,17 @@ bind -n C-g select-window -t :0
 # Ctrl+\: cycle to next agent window from anywhere
 bind -n C-\\ next-window
 
-# Ctrl+C debounce — forward the first press of a burst and swallow the
-# rest while the user is still pressing, preventing the "double-tap to
-# exit" behaviour of Claude Code / OpenCode / Copilot from firing on
-# accidental spam. Runs via bun so the same TypeScript helper works on
-# Linux, macOS, and Windows psmux. @atomic-bun and @atomic-cc-debounce
-# are set to absolute paths by tmux.ts on session creation — no PATH
-# lookup needed inside run-shell.
-bind -n C-c run-shell -b '"#{@atomic-bun}" "#{@atomic-cc-debounce}" "#{pane_id}"'
+# Ctrl+C handling — for workflow sessions, debounce bursts so the agent's
+# "double-tap to exit" doesn't trigger on accidental spam. For chat
+# sessions (atomic-chat-*) the user is in direct control of the single
+# agent CLI and a deliberate double-tap exit must reach the agent
+# verbatim, so we forward Ctrl+C unmodified.
+#
+# @atomic-bun and @atomic-cc-debounce are set to absolute paths by
+# tmux.ts on session creation — no PATH lookup needed inside run-shell.
+bind -n C-c if-shell -F '#{m:atomic-chat-*,#{session_name}}' \
+  'send-keys C-c' \
+  'run-shell -b "\"#{@atomic-bun}\" \"#{@atomic-cc-debounce}\" \"#{pane_id}\""'
 
 # Escape exits copy-mode (clear selection first if one exists, otherwise cancel)
 bind-key -T copy-mode-vi Escape if-shell -F "#{selection_present}" "send-keys -X clear-selection" "send-keys -X cancel"

package/src/sdk/runtime/tmux.ts

@@ -220,6 +220,28 @@ export function createSession(
   return paneId || tmux(["list-panes", "-t", sessionName, "-F", "#{pane_id}"]).split("\n")[0]!;
 }
 
+/**
+ * Install a hook that kills the entire session when the given pane's
+ * process exits. Used by chat sessions so the session is torn down
+ * when the agent CLI exits — whether via `/exit`, a deliberate double
+ * Ctrl+C, or a crash — without leaving the footer pane keeping the
+ * session alive.
+ *
+ * The hook is session-scoped (pane-scoped hooks don't fire because the
+ * pane is already gone when `pane-exited` would run) and guarded with
+ * `#{hook_pane}` so the footer pane's eventual exit cascade doesn't
+ * re-trigger it. `kill-session` is idempotent in any case.
+ */
+export function killSessionOnPaneExit(sessionName: string, paneId: string): void {
+  const guard = `if -F '#{==:#{hook_pane},${paneId}}' 'kill-session -t ${sessionName}'`;
+  tmuxRun([
+    "set-hook",
+    "-t", sessionName,
+    "pane-exited",
+    guard,
+  ]);
+}
+
 /**
  * Create a new window in an existing session without switching focus.
  *

package/src/sdk/workflows/builtin/ralph/claude/index.ts

@@ -1,11 +1,16 @@
 /**
- * Ralph workflow for Claude Code — plan → orchestrate → review → debug loop.
+ * Ralph workflow for Claude Code — plan → orchestrate → review loop.
  *
  * Each sub-agent invocation spawns its own visible session in the graph,
  * so users can see each iteration's progress in real time. The loop
  * terminates when:
  *   - `max_loops` iterations have completed (defaults to {@link DEFAULT_MAX_LOOPS}), OR
- *   - Two parallel reviewer passes both return zero findings.
+ *   - Both parallel reviewer passes return `overall_correctness === "patch is correct"`.
+ *
+ * On a failed review the merged findings are formatted into a markdown
+ * brief by {@link formatReviewForReplan} and fed into the next iteration's
+ * planner, which is responsible for validating, deduping, and clustering
+ * them into shared root causes before revising the RFC.
  *
  * The reviewer stages run **headless** via the Claude Agent SDK with
  * `outputFormat: { type: "json_schema", schema: REVIEW_RESULT_JSON_SCHEMA }`,
@@ -25,9 +30,8 @@ import {
   buildOrchestratorPrompt,
   buildInfraDiscoveryPrompts,
   buildReviewPrompt,
-  buildDebuggerReportPrompt,
-  extractMarkdownBlock,
   filterActionable,
+  formatReviewForReplan,
   mergeReviewResults,
   REVIEW_RESULT_JSON_SCHEMA,
   type ReviewResult,
@@ -65,8 +69,7 @@ function extractReview(
 
 export default defineWorkflow({
   name: "ralph",
-  description:
-    "Plan → orchestrate → review → debug loop with bounded iteration",
+  description: "Plan → orchestrate → review loop with bounded iteration",
   inputs: [
     {
       name: "prompt",
@@ -86,7 +89,7 @@ export default defineWorkflow({
   .run(async (ctx) => {
     const prompt = ctx.inputs.prompt ?? "";
     const maxLoops = ctx.inputs.max_loops ?? DEFAULT_MAX_LOOPS;
-    let debuggerReport = "";
+    let reviewReport = "";
 
     for (let iteration = 1; iteration <= maxLoops; iteration++) {
       // ── Plan ────────────────────────────────────────────────────────────
@@ -105,7 +108,7 @@ export default defineWorkflow({
           await s.session.query(
             buildPlannerPrompt(prompt, {
               iteration,
-              debuggerReport: debuggerReport || undefined,
+              reviewReport: reviewReport || undefined,
             }),
           );
           s.save(s.sessionId);
@@ -233,33 +236,8 @@ export default defineWorkflow({
       // Both reviewers agree the code is clean → done
       if (!hasActionableFindings(parsed, reviewRaw)) break;
 
-      // ── Debug (only if another iteration is allowed) ────────────────────
-      if (iteration < maxLoops) {
-        const debugger_ = await ctx.stage(
-          { name: `debugger-${iteration}` },
-          {
-            chatFlags: [
-              "--agent",
-              "debugger",
-              "--allow-dangerously-skip-permissions",
-              "--dangerously-skip-permissions",
-            ],
-          },
-          {},
-          async (s) => {
-            const result = await s.session.query(
-              buildDebuggerReportPrompt(parsed, reviewRaw, {
-                iteration,
-                changeset,
-              }),
-            );
-            s.save(s.sessionId);
-            return extractAssistantText(result, 0);
-          },
-        );
-
-        debuggerReport = extractMarkdownBlock(debugger_.result);
-      }
+      // Findings exist — format them for the next iteration's planner.
+      reviewReport = formatReviewForReplan(parsed, reviewRaw);
     }
   })
   .compile();

package/src/sdk/workflows/builtin/ralph/copilot/index.ts

@@ -1,11 +1,16 @@
 /**
- * Ralph workflow for Copilot — plan → orchestrate → review → debug loop.
+ * Ralph workflow for Copilot — plan → orchestrate → review loop.
  *
  * Each sub-agent invocation spawns its own visible session in the graph,
  * so users can see each iteration's progress in real time. The loop
  * terminates when:
  *   - `max_loops` iterations have completed (defaults to {@link DEFAULT_MAX_LOOPS}), OR
- *   - Two parallel reviewer passes both return zero findings.
+ *   - Both parallel reviewer passes return `overall_correctness === "patch is correct"`.
+ *
+ * On a failed review the merged findings are formatted into a markdown
+ * brief by {@link formatReviewForReplan} and fed into the next iteration's
+ * planner, which is responsible for validating, deduping, and clustering
+ * them into shared root causes before revising the RFC.
  *
  * The reviewer stages use a `submit_review` custom tool (defined via
  * `defineTool` with Zod schema validation) to guarantee the review result
@@ -24,9 +29,8 @@ import {
   buildOrchestratorPrompt,
   buildInfraDiscoveryPrompts,
   buildReviewPrompt,
-  buildDebuggerReportPrompt,
-  extractMarkdownBlock,
   filterActionable,
+  formatReviewForReplan,
   mergeReviewResults,
   ReviewResultSchema,
   type ReviewResult,
@@ -76,8 +80,7 @@ function getAssistantText(messages: SessionEvent[]): string {
 
 export default defineWorkflow({
   name: "ralph",
-  description:
-    "Plan → orchestrate → review → debug loop with bounded iteration",
+  description: "Plan → orchestrate → review loop with bounded iteration",
   inputs: [
     {
       name: "prompt",
@@ -97,7 +100,7 @@ export default defineWorkflow({
   .run(async (ctx) => {
     const userPromptText = ctx.inputs.prompt ?? "";
     const maxLoops = ctx.inputs.max_loops ?? DEFAULT_MAX_LOOPS;
-    let debuggerReport = "";
+    let reviewReport = "";
 
     for (let iteration = 1; iteration <= maxLoops; iteration++) {
       // ── Plan ──────────────────────────────────────────────────────────
@@ -109,7 +112,7 @@ export default defineWorkflow({
           await s.session.send({
             prompt: buildPlannerPrompt(userPromptText, {
               iteration,
-              debuggerReport: debuggerReport || undefined,
+              reviewReport: reviewReport || undefined,
             }),
           });
           const messages = await s.session.getMessages();
@@ -253,27 +256,8 @@ export default defineWorkflow({
       // Both reviewers agree the code is clean → done
       if (!hasActionableFindings(parsed, reviewRaw)) break;
 
-      // ── Debug (only if another iteration is allowed) ──────────────────
-      if (iteration < maxLoops) {
-        const debugger_ = await ctx.stage(
-          { name: `debugger-${iteration}` },
-          {},
-          { agent: "debugger" },
-          async (s) => {
-            await s.session.send({
-              prompt: buildDebuggerReportPrompt(parsed, reviewRaw, {
-                iteration,
-                changeset,
-              }),
-            });
-            const messages = await s.session.getMessages();
-            s.save(messages);
-            return getAssistantText(messages);
-          },
-        );
-
-        debuggerReport = extractMarkdownBlock(debugger_.result);
-      }
+      // Findings exist — format them for the next iteration's planner.
+      reviewReport = formatReviewForReplan(parsed, reviewRaw);
     }
   })
   .compile();