pi-webdesk 0.1.0

package/dist/apps/daemon/src/task-review.js

@@ -0,0 +1,204 @@
+// apps/daemon/src/task-review.ts
+import { realpath } from "node:fs/promises";
+import {
+  isGitServiceError,
+  reviewWorktree
+} from "../../../packages/git/src/index.js";
+import { sanitizeApprovalDisplayText } from "../../../packages/pi-bridge/src/index.js";
+import {
+  PROTOCOL_VERSION,
+  TASK_REVIEW_MAX_FILE_DIFF_CHARS,
+  TASK_REVIEW_MAX_FILES,
+  TASK_REVIEW_MAX_TOTAL_DIFF_CHARS,
+  taskReviewSchema
+} from "../../../packages/protocol/src/index.js";
+var TaskReviewOperationError = class extends Error {
+  name = "TaskReviewOperationError";
+  code;
+  status;
+  constructor(code, message, status, options) {
+    super(message, options);
+    this.code = code;
+    this.status = status;
+  }
+};
+var MAX_PATH_DISPLAY_CHARS = 4096;
+var WORKTREE_UNAVAILABLE_CODES = /* @__PURE__ */ new Set([
+  "GIT_PATH_NOT_FOUND",
+  "GIT_PATH_NOT_DIRECTORY",
+  "GIT_NOT_A_REPOSITORY",
+  "GIT_BARE_REPOSITORY",
+  "GIT_NOT_A_WORK_TREE",
+  "GIT_HEAD_UNRESOLVED"
+]);
+var WORKTREE_UNAVAILABLE_MESSAGE = "The task worktree is missing or is no longer a healthy Git worktree. Recover it before reviewing changes.";
+function boundedDisplay(text, maxChars) {
+  const clippedInput = text.length > maxChars;
+  const safe = sanitizeApprovalDisplayText(text.slice(0, maxChars));
+  if (safe.length <= maxChars) return { text: safe, clipped: clippedInput };
+  return { text: safe.slice(0, maxChars), clipped: true };
+}
+function boundedPathDisplay(text) {
+  const bounded = boundedDisplay(text, MAX_PATH_DISPLAY_CHARS);
+  if (!bounded.clipped) return bounded.text;
+  return `${bounded.text.slice(0, MAX_PATH_DISPLAY_CHARS - 1)}\u2026`;
+}
+function createTaskReviewService(options) {
+  const deriveReview = options.reviewWorktree ?? reviewWorktree;
+  const now = options.now ?? Date.now;
+  async function resolveTask(taskId) {
+    let task;
+    try {
+      task = await options.getTask(taskId);
+    } catch (error) {
+      throw new TaskReviewOperationError(
+        "review-failed",
+        "The task could not be resolved from the local workspace.",
+        503,
+        { cause: error }
+      );
+    }
+    if (task === null) {
+      throw new TaskReviewOperationError(
+        "task-not-found",
+        "The selected task no longer exists.",
+        404
+      );
+    }
+    if (task.status !== "ready") {
+      throw new TaskReviewOperationError(
+        "task-not-ready",
+        `Only a ready task can be reviewed; this task is ${task.status}.`,
+        409
+      );
+    }
+    return task;
+  }
+  async function resolveRepository(task) {
+    let repository;
+    try {
+      repository = await options.getRepository(task.repositoryId);
+    } catch (error) {
+      throw new TaskReviewOperationError(
+        "review-failed",
+        "The task's repository could not be resolved from the local workspace.",
+        503,
+        { cause: error }
+      );
+    }
+    if (repository === null) {
+      throw new TaskReviewOperationError(
+        "task-not-ready",
+        "The task's repository is no longer registered.",
+        409
+      );
+    }
+    return repository;
+  }
+  async function review(taskId) {
+    const task = await resolveTask(taskId);
+    const repository = await resolveRepository(task);
+    let canonicalWorktree;
+    try {
+      canonicalWorktree = await realpath(task.worktreePath);
+    } catch (error) {
+      throw new TaskReviewOperationError(
+        "task-not-ready",
+        WORKTREE_UNAVAILABLE_MESSAGE,
+        409,
+        { cause: error }
+      );
+    }
+    let derived;
+    try {
+      derived = await deriveReview({
+        worktreePath: canonicalWorktree,
+        maxFiles: TASK_REVIEW_MAX_FILES,
+        maxDiffCharsPerFile: TASK_REVIEW_MAX_FILE_DIFF_CHARS,
+        maxTotalDiffChars: TASK_REVIEW_MAX_TOTAL_DIFF_CHARS
+      });
+    } catch (error) {
+      if (isGitServiceError(error) && WORKTREE_UNAVAILABLE_CODES.has(error.code)) {
+        throw new TaskReviewOperationError(
+          "task-not-ready",
+          WORKTREE_UNAVAILABLE_MESSAGE,
+          409,
+          { cause: error }
+        );
+      }
+      if (isGitServiceError(error, "GIT_REPOSITORY_CHANGED_DURING_REVIEW")) {
+        throw new TaskReviewOperationError(
+          "review-failed",
+          "The task branch or HEAD changed while Webdesk was capturing the review. Refresh to try again.",
+          409,
+          { cause: error }
+        );
+      }
+      throw new TaskReviewOperationError(
+        "review-failed",
+        "Git could not derive review facts for this worktree. Check the daemon output for details.",
+        502,
+        { cause: error }
+      );
+    }
+    if (derived.worktree.root !== canonicalWorktree || derived.worktree.commonDir !== repository.commonDir || derived.worktree.branch !== task.branch) {
+      throw new TaskReviewOperationError(
+        "task-not-ready",
+        "The recorded worktree no longer matches the task's repository. Recover it before reviewing changes.",
+        409
+      );
+    }
+    let remainingChars = TASK_REVIEW_MAX_TOTAL_DIFF_CHARS;
+    let totalDiffTruncated = derived.totalDiffTruncated;
+    const files = derived.files.map((file) => {
+      let diff = null;
+      let diffTruncated = file.diffTruncated;
+      let diffOmittedReason = file.diffOmittedReason;
+      if (file.diff !== null) {
+        if (remainingChars <= 0) {
+          diffOmittedReason = "total-budget";
+          totalDiffTruncated = true;
+        } else {
+          const perFileLimit = Math.min(TASK_REVIEW_MAX_FILE_DIFF_CHARS, remainingChars);
+          const bounded = boundedDisplay(file.diff, perFileLimit);
+          diff = bounded.text;
+          if (bounded.clipped) {
+            diffTruncated = true;
+            if (perFileLimit < TASK_REVIEW_MAX_FILE_DIFF_CHARS) totalDiffTruncated = true;
+          }
+          remainingChars -= diff.length;
+        }
+      }
+      return {
+        entryId: file.entryId,
+        path: boundedPathDisplay(file.path),
+        previousPath: file.previousPath === null ? null : boundedPathDisplay(file.previousPath),
+        kind: file.kind,
+        staged: file.staged,
+        unstaged: file.unstaged,
+        binary: file.binary,
+        diff,
+        diffTruncated,
+        diffOmittedReason
+      };
+    });
+    return taskReviewSchema.parse({
+      protocol: PROTOCOL_VERSION,
+      type: "task-review",
+      taskId: task.id,
+      headCommit: derived.worktree.headCommit,
+      branch: derived.worktree.branch,
+      clean: derived.clean,
+      files,
+      totalChangedFiles: derived.totalChangedFiles,
+      omittedFiles: derived.omittedFiles,
+      totalDiffTruncated,
+      capturedAtMs: now()
+    });
+  }
+  return { review };
+}
+export {
+  TaskReviewOperationError,
+  createTaskReviewService
+};