ralphctl 0.4.0 → 0.4.1

package/dist/{chunk-JYCGQA2D.mjs → chunk-3HJNVQ7N.mjs}

@@ -1681,6 +1681,37 @@ function collectRepoIds(tasks) {
 
 // src/business/usecases/execute.ts
 import { basename } from "path";
+
+// src/business/usecases/recover-dirty-tree.ts
+async function recoverDirtyTree(deps, params) {
+  const { external, logger, signalBus } = deps;
+  const { sprintId, taskId, taskName, repoPath } = params;
+  if (!external.hasUncommittedChanges(repoPath)) return;
+  logger.warn(
+    `Dirty tree after "${taskName}" \u2014 auto-committing on the harness's behalf. The agent should commit its own work; see prompt guidance.`,
+    { taskId, projectPath: repoPath }
+  );
+  signalBus.emit({
+    type: "signal",
+    signal: {
+      type: "note",
+      text: `harness auto-commit: dirty tree after task "${taskName}" settlement`,
+      timestamp: /* @__PURE__ */ new Date()
+    },
+    ctx: { sprintId, taskId, projectPath: repoPath }
+  });
+  const message = `chore(harness): auto-commit leftover changes from "${taskName}"`;
+  try {
+    await external.autoCommit(repoPath, message);
+  } catch (err) {
+    logger.error(`Auto-commit failed in ${repoPath}: ${err instanceof Error ? err.message : String(err)}`, {
+      taskId,
+      projectPath: repoPath
+    });
+  }
+}
+
+// src/business/usecases/execute.ts
 var ExecuteTasksUseCase = class {
   constructor(persistence, aiSession, promptBuilder, parser, ui, logger, external, fs, signalParser2, signalHandler, signalBus) {
     this.persistence = persistence;
@@ -1940,6 +1971,10 @@ ${instructions}`;
           );
           if (finishStatus === "done") finishStatus = "failed";
         }
+        await recoverDirtyTree(
+          { external: this.external, logger: this.logger, signalBus: this.signalBus },
+          { sprintId: sprint.id, taskId: syntheticTask.id, taskName: syntheticTask.name, repoPath }
+        );
         this.signalBus.emit({
           type: "task-finished",
           sprintId: sprint.id,
@@ -2760,6 +2795,19 @@ function evaluateTask(deps) {
   });
 }
 
+// src/business/pipelines/execute/steps/recover-dirty-tree.ts
+function recoverDirtyTree2(deps) {
+  return step("recover-dirty-tree", async (ctx) => {
+    const { task, sprint } = ctx;
+    const repoPath = await deps.persistence.resolveRepoPath(task.repoId);
+    await recoverDirtyTree(
+      { external: deps.external, logger: deps.logger, signalBus: deps.signalBus },
+      { sprintId: sprint.id, taskId: task.id, taskName: task.name, repoPath }
+    );
+    return Result.ok({});
+  });
+}
+
 // src/business/pipelines/execute/steps/mark-done.ts
 function markDone(deps) {
   return step("mark-done", async (ctx) => {
@@ -2823,6 +2871,14 @@ function createPerTaskPipeline(deps, useCase, options = {}) {
         options
       })
     ),
+    trace(
+      recoverDirtyTree2({
+        persistence: deps.persistence,
+        external: deps.external,
+        logger: deps.logger,
+        signalBus: deps.signalBus
+      })
+    ),
     trace(markDone({ persistence: deps.persistence, logger: deps.logger, signalBus: deps.signalBus }))
   ]);
 }
@@ -5217,6 +5273,25 @@ function hasUncommittedChanges(cwd) {
   }
   return result.stdout.trim().length > 0;
 }
+function autoCommit(cwd, message) {
+  assertSafeCwd(cwd);
+  const add = spawnSync3("git", ["add", "-A"], {
+    cwd,
+    encoding: "utf-8",
+    stdio: ["pipe", "pipe", "pipe"]
+  });
+  if (add.status !== 0) {
+    throw new Error(`Failed to stage changes in ${cwd}: ${add.stderr.trim()}`);
+  }
+  const commit = spawnSync3("git", ["commit", "-m", message], {
+    cwd,
+    encoding: "utf-8",
+    stdio: ["pipe", "pipe", "pipe"]
+  });
+  if (commit.status !== 0) {
+    throw new Error(`Failed to commit in ${cwd}: ${commit.stderr.trim() || commit.stdout.trim()}`);
+  }
+}
 function generateBranchName(sprintId) {
   return `ralphctl/${sprintId}`;
 }
@@ -5276,6 +5351,10 @@ var DefaultExternalAdapter = class {
   hasUncommittedChanges(projectPath) {
     return hasUncommittedChanges(projectPath);
   }
+  autoCommit(projectPath, message) {
+    autoCommit(projectPath, message);
+    return Promise.resolve();
+  }
   createAndCheckoutBranch(projectPath, branchName) {
     createAndCheckoutBranch(projectPath, branchName);
   }

package/dist/{chunk-MRN3Z2XC.mjs → chunk-SM4GGZSU.mjs}

@@ -52,7 +52,7 @@ import {
   updateTask,
   updateTaskStatus,
   validateImportTasks
-} from "./chunk-JYCGQA2D.mjs";
+} from "./chunk-3HJNVQ7N.mjs";
 import {
   fetchIssueFromUrl,
   formatIssueContext,
@@ -177,7 +177,7 @@ import {
 // package.json
 var package_default = {
   name: "ralphctl",
-  version: "0.4.0",
+  version: "0.4.1",
   description: "Agent harness for long-running AI coding tasks \u2014 orchestrates Claude Code & GitHub Copilot across repositories",
   homepage: "https://github.com/lukas-grigis/ralphctl",
   type: "module",

package/dist/cli.mjs

@@ -41,7 +41,7 @@ import {
   ticketRefineCommand,
   ticketRemoveCommand,
   ticketShowCommand
-} from "./chunk-MRN3Z2XC.mjs";
+} from "./chunk-SM4GGZSU.mjs";
 import {
   projectAddCommand
 } from "./chunk-D2YGPLIV.mjs";
@@ -55,7 +55,7 @@ import "./chunk-NUYQK5MN.mjs";
 import {
   getTasks,
   sprintStartCommand
-} from "./chunk-JYCGQA2D.mjs";
+} from "./chunk-3HJNVQ7N.mjs";
 import {
   truncate
 } from "./chunk-JOQO4HMM.mjs";
@@ -705,7 +705,7 @@ async function main() {
   const isBare = argv.length <= 2;
   const isInteractive = argv[2] === "interactive";
   if (isBare || isInteractive) {
-    const { mountInkApp } = await import("./mount-XMN3S4W6.mjs");
+    const { mountInkApp } = await import("./mount-2N6H5CWA.mjs");
     const { fallback } = await mountInkApp({ initialView: "repl" });
     if (!fallback) return;
     printBanner();
@@ -716,10 +716,10 @@ async function main() {
     return;
   }
   if (argv[2] === "sprint" && argv[3] === "start") {
-    const { parseSprintStartArgs } = await import("./start-D35SOXMM.mjs");
+    const { parseSprintStartArgs } = await import("./start-IUDCXIEA.mjs");
     const parsed = parseSprintStartArgs(argv.slice(4));
     if (parsed.ok) {
-      const { mountInkApp } = await import("./mount-XMN3S4W6.mjs");
+      const { mountInkApp } = await import("./mount-2N6H5CWA.mjs");
       const { getSharedDeps } = await import("./bootstrap-FMHG6DRY.mjs");
       let sprintId;
       try {

package/dist/{mount-XMN3S4W6.mjs → mount-2N6H5CWA.mjs}

@@ -62,7 +62,7 @@ import {
   ticketShowCommand,
   useCurrentPrompt,
   validateConfigValue
-} from "./chunk-MRN3Z2XC.mjs";
+} from "./chunk-SM4GGZSU.mjs";
 import {
   PromptCancelledError,
   projectAddCommand
@@ -109,7 +109,7 @@ import {
   sprintStartCommand,
   updateTaskStatus,
   withSuspendedTui
-} from "./chunk-JYCGQA2D.mjs";
+} from "./chunk-3HJNVQ7N.mjs";
 import {
   addTicket,
   allRequirementsApproved,

package/dist/prompts/sprint-feedback.md

@@ -31,7 +31,10 @@ something entirely new (create a file, add a feature, tweak a script), do exactl
    it passes. If no check script is configured, skip this step.
 4. **Output verification results** — Wrap any verification output in `<task-verified>...</task-verified>`. If you
    skipped step 3, emit `<task-verified>no check script configured; change applied</task-verified>`.
-5. **Signal completion** — Output `<task-complete>` once the change is applied and verification (if any) passed.
+5. **Commit your work** — Stage the modified files and create a git commit with a descriptive message summarising the
+   feedback you implemented. The harness refuses to mark the task done with a dirty working tree.
+6. **Signal completion** — Output `<task-complete>` once the change is applied, verification (if any) passed, and the
+   commit has landed.
 
 Only signal `<task-blocked>reason</task-blocked>` if the feedback is literally impossible to carry out (e.g., asks
 you to edit a file in a repository you don't have access to). Ambiguity is **not** a blocker — make a reasonable
@@ -42,6 +45,8 @@ interpretation and proceed.
 - **The feedback is the authoritative instruction** — implement it even if it seems unrelated to the completed tasks.
 - **Do the smallest change that fully satisfies the feedback** — no speculative refactors, no adjacent cleanup.
 - **Make the edits — don't just describe them** — the harness does not apply edits for you; you must write the files.
+- **Must commit** — Create a git commit before signaling completion. Uncommitted changes leave the sprint branch dirty
+  and block sprint close.
 
 </constraints>
 

package/dist/prompts/task-evaluation.md

@@ -21,6 +21,11 @@ These verification criteria are the pre-agreed definition of "done" — your pri
 
 ## Review Protocol
 
+**You are a reviewer — do not edit files.** If you believe a fix is needed, emit `<evaluation-failed>` with a concrete
+critique; the harness will resume the generator to apply the fix. Do not run `git stash`, do not edit tests, do not
+create commits. Your tools are read-only: `git status`, `git log`, `git diff`, file reads, and running existing check
+scripts. Any write operation is a protocol violation.
+
 You are working in this project directory:
 
 ```
@@ -37,7 +42,8 @@ Run deterministic checks first — these are cheap, fast, and authoritative.
 
 1. **Run the check script** (if provided above) — this is the same gate the harness uses post-task. If it fails, the
    implementation fails regardless of how good the code looks. Record the output.
-2. **Run `git status`** — uncommitted changes may indicate incomplete work
+2. **Run `git status`** — the tree MUST be clean. Uncommitted changes from the generator are a Completeness failure;
+   uncommitted changes from you are a protocol violation.
 3. **Run `git log --oneline -10`** — identify which commits belong to this task
 
 Computational results are ground truth. If the check script fails, stop early — the implementation does not pass.

package/dist/{start-D35SOXMM.mjs → start-IUDCXIEA.mjs}

@@ -2,7 +2,7 @@
 import {
   parseSprintStartArgs,
   sprintStartCommand
-} from "./chunk-JYCGQA2D.mjs";
+} from "./chunk-3HJNVQ7N.mjs";
 import "./chunk-JOQO4HMM.mjs";
 import "./chunk-CFUVE2BP.mjs";
 import "./chunk-747KW2RW.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralphctl",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Agent harness for long-running AI coding tasks — orchestrates Claude Code & GitHub Copilot across repositories",
   "homepage": "https://github.com/lukas-grigis/ralphctl",
   "type": "module",