farming-code 2.2.29 → 2.2.32

package/backend/review-session-store.cjs

@@ -0,0 +1,161 @@
+// Generated by scripts/build-backend-runtime.ts. Do not edit.
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var review_session_store_exports = {};
+__export(review_session_store_exports, {
+  OBJECT_ID_PATTERN: () => OBJECT_ID_PATTERN,
+  REVIEW_ID_PATTERN: () => REVIEW_ID_PATTERN,
+  ReviewSessionStore: () => ReviewSessionStore
+});
+module.exports = __toCommonJS(review_session_store_exports);
+var import_atomic_json_store = require("./atomic-json-store.cjs");
+var storageLayout = __toESM(require("./storage-layout.cjs"));
+const crypto = require("crypto");
+const fs = require("fs");
+const path = require("path");
+const REVIEW_ID_PATTERN = /^review-[a-f0-9]{32}$/;
+const OBJECT_ID_PATTERN = /^[a-f0-9]{40,64}$/;
+function isObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function clone(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+function validRevision(value) {
+  return isObject(value) && typeof value.tree === "string" && OBJECT_ID_PATTERN.test(value.tree) && typeof value.number === "number" && Number.isInteger(value.number) && value.number > 0 && typeof value.createdAt === "string" && (value.previousTree === void 0 || typeof value.previousTree === "string" && OBJECT_ID_PATTERN.test(value.previousTree));
+}
+function validStoredPath(value) {
+  return typeof value === "string" && value.length > 0 && value.length <= 4096 && !value.startsWith("/") && !value.includes("\0") && value.split(/[\\/]/).every((segment) => segment && segment !== "." && segment !== "..");
+}
+function validSession(value) {
+  return isObject(value) && typeof value.id === "string" && REVIEW_ID_PATTERN.test(value.id) && typeof value.root === "string" && path.isAbsolute(value.root) && typeof value.base === "string" && OBJECT_ID_PATTERN.test(value.base) && typeof value.createdAt === "string" && typeof value.updatedAt === "string" && (value.scope === void 0 || value.scope === "tracked" || value.scope === "untracked") && (value.modifiedWithinDays === void 0 || typeof value.modifiedWithinDays === "number" && Number.isInteger(value.modifiedWithinDays) && value.modifiedWithinDays >= 1 && value.modifiedWithinDays <= 3650) && (value.paths === void 0 || Array.isArray(value.paths) && value.paths.length <= 256 && value.paths.every(validStoredPath)) && Array.isArray(value.revisions) && value.revisions.length > 0 && value.revisions.every(validRevision);
+}
+function normalizeState(value) {
+  const sessions = isObject(value) && isObject(value.sessions) ? value.sessions : {};
+  return {
+    sessions: Object.fromEntries(Object.entries(sessions).filter((entry) => {
+      const [id, session] = entry;
+      return REVIEW_ID_PATTERN.test(id) && validSession(session) && session.id === id;
+    }))
+  };
+}
+class ReviewSessionStore {
+  file;
+  writeJson;
+  state;
+  constructor(configDir, options = {}) {
+    this.file = options.file || storageLayout.reviewSessionsFile(configDir);
+    this.writeJson = typeof options.writeJson === "function" ? options.writeJson : (file, value) => (0, import_atomic_json_store.atomicWriteJson)(file, value, { trailingNewline: true });
+    this.state = null;
+  }
+  ensureState() {
+    if (this.state) return this.state;
+    try {
+      this.state = fs.existsSync(this.file) ? normalizeState(JSON.parse(fs.readFileSync(this.file, "utf8"))) : { sessions: {} };
+    } catch (error) {
+      console.warn(
+        "Failed to read Farming review sessions:",
+        error instanceof Error ? error.message : error
+      );
+      this.state = { sessions: {} };
+    }
+    return this.state;
+  }
+  newId() {
+    return `review-${crypto.randomUUID().replace(/-/g, "")}`;
+  }
+  get(reviewId) {
+    if (!REVIEW_ID_PATTERN.test(reviewId)) return null;
+    const session = this.ensureState().sessions[reviewId];
+    return session ? clone(session) : null;
+  }
+  create({
+    id,
+    root,
+    base,
+    tree,
+    scope,
+    modifiedWithinDays,
+    paths,
+    createdAt = (/* @__PURE__ */ new Date()).toISOString()
+  }) {
+    if (!REVIEW_ID_PATTERN.test(id) || !path.isAbsolute(root) || !OBJECT_ID_PATTERN.test(base) || !OBJECT_ID_PATTERN.test(tree)) {
+      throw new TypeError("invalid review session");
+    }
+    const currentState = this.ensureState();
+    if (currentState.sessions[id]) throw new TypeError("review session already exists");
+    const session = {
+      base,
+      createdAt,
+      id,
+      revisions: [{ createdAt, number: 1, tree }],
+      root,
+      ...scope === "tracked" || scope === "untracked" ? { scope } : {},
+      ...Number.isInteger(modifiedWithinDays) ? { modifiedWithinDays } : {},
+      ...Array.isArray(paths) ? { paths: [...paths] } : {},
+      updatedAt: createdAt
+    };
+    const nextState = {
+      sessions: { ...currentState.sessions, [id]: session }
+    };
+    this.writeJson(this.file, nextState);
+    this.state = nextState;
+    return clone(session);
+  }
+  appendRevision(reviewId, tree, createdAt = (/* @__PURE__ */ new Date()).toISOString()) {
+    if (!OBJECT_ID_PATTERN.test(tree)) throw new TypeError("invalid review revision");
+    const currentState = this.ensureState();
+    const currentSession = currentState.sessions[reviewId];
+    if (!currentSession) throw new TypeError("review session not found");
+    const previous = currentSession.revisions[currentSession.revisions.length - 1];
+    if (previous.tree === tree) return { added: false, session: clone(currentSession) };
+    const nextSession = {
+      ...currentSession,
+      revisions: [...currentSession.revisions, {
+        createdAt,
+        number: previous.number + 1,
+        previousTree: previous.tree,
+        tree
+      }],
+      updatedAt: createdAt
+    };
+    const nextState = {
+      sessions: { ...currentState.sessions, [reviewId]: nextSession }
+    };
+    this.writeJson(this.file, nextState);
+    this.state = nextState;
+    return { added: true, session: clone(nextSession) };
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  OBJECT_ID_PATTERN,
+  REVIEW_ID_PATTERN,
+  ReviewSessionStore
+});

package/backend/review-state-router.cjs

@@ -0,0 +1,132 @@
+// Generated by scripts/build-backend-runtime.ts. Do not edit.
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var review_state_router_exports = {};
+__export(review_state_router_exports, {
+  createReviewStateRouter: () => createReviewStateRouter
+});
+module.exports = __toCommonJS(review_state_router_exports);
+const express = require("express");
+const expressFactory = express;
+function sendError(res, error) {
+  if (error instanceof TypeError) {
+    res.status(400).json({ error: error.message });
+    return;
+  }
+  console.error("Review state API error:", error);
+  res.status(500).json({ error: "review state operation failed" });
+}
+function isReviewedQuery(value) {
+  return value === "" || value === true || value === "true" || value === "1";
+}
+function createReviewStateRouter(reviewStateStore) {
+  const router = expressFactory.Router();
+  router.use(expressFactory.json({ limit: "32kb" }));
+  router.get("/:reviewId/revisions/:patchset/files", (req, res) => {
+    try {
+      if (req.query.reviewed === void 0) {
+        res.status(400).json({ error: "reviewed query is required" });
+        return;
+      }
+      if (!isReviewedQuery(req.query.reviewed)) {
+        res.status(400).json({ error: "reviewed query must be bare or true" });
+        return;
+      }
+      const state = reviewStateStore.getPatchsetState(req.params.reviewId, req.params.patchset);
+      res.set("X-Farming-Review-Revision", String(state.revision));
+      res.json(state.reviewedPaths);
+    } catch (error) {
+      sendError(res, error);
+    }
+  });
+  router.put("/:reviewId/revisions/:patchset/files/:filePath/reviewed", (req, res) => {
+    try {
+      const result = reviewStateStore.setFileReviewedGerrit({
+        reviewId: req.params.reviewId,
+        patchset: req.params.patchset,
+        path: req.params.filePath,
+        reviewed: true
+      });
+      res.set("X-Farming-Review-Revision", String(result.state.revision));
+      res.status(result.changed ? 201 : 200).send();
+    } catch (error) {
+      sendError(res, error);
+    }
+  });
+  router.delete("/:reviewId/revisions/:patchset/files/:filePath/reviewed", (req, res) => {
+    try {
+      const result = reviewStateStore.setFileReviewedGerrit({
+        reviewId: req.params.reviewId,
+        patchset: req.params.patchset,
+        path: req.params.filePath,
+        reviewed: false
+      });
+      res.set("X-Farming-Review-Revision", String(result.state.revision));
+      res.status(204).send();
+    } catch (error) {
+      sendError(res, error);
+    }
+  });
+  router.get("/:reviewId/patchsets/:patchset/comments", (req, res) => {
+    try {
+      res.json({ comments: reviewStateStore.getComments(req.params.reviewId, req.params.patchset) });
+    } catch (error) {
+      sendError(res, error);
+    }
+  });
+  router.post("/:reviewId/patchsets/:patchset/comments", (req, res) => {
+    try {
+      res.status(201).json(reviewStateStore.saveComment({
+        reviewId: req.params.reviewId,
+        patchset: req.params.patchset,
+        comment: req.body
+      }));
+    } catch (error) {
+      sendError(res, error);
+    }
+  });
+  router.delete("/:reviewId/patchsets/:patchset/comments/:commentId", (req, res) => {
+    try {
+      res.json({ comments: reviewStateStore.deleteComment({
+        reviewId: req.params.reviewId,
+        patchset: req.params.patchset,
+        commentId: req.params.commentId
+      }) });
+    } catch (error) {
+      sendError(res, error);
+    }
+  });
+  router.patch("/:reviewId/patchsets/:patchset/comments/:commentId", (req, res) => {
+    try {
+      res.json(reviewStateStore.updateCommentStatus({
+        reviewId: req.params.reviewId,
+        patchset: req.params.patchset,
+        commentId: req.params.commentId,
+        status: req.body?.status
+      }));
+    } catch (error) {
+      sendError(res, error);
+    }
+  });
+  return router;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createReviewStateRouter
+});

package/backend/review-state-store.cjs

@@ -0,0 +1,299 @@
+// Generated by scripts/build-backend-runtime.ts. Do not edit.
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var review_state_store_exports = {};
+__export(review_state_store_exports, {
+  ReviewStateStore: () => ReviewStateStore,
+  isSafeKey: () => isSafeKey,
+  isSafeRepositoryPath: () => isSafeRepositoryPath
+});
+module.exports = __toCommonJS(review_state_store_exports);
+var import_atomic_json_store = require("./atomic-json-store.cjs");
+var storageLayout = __toESM(require("./storage-layout.cjs"));
+const fs = require("fs");
+const MAX_KEY_LENGTH = 200;
+const MAX_PATH_LENGTH = 4096;
+const MAX_COMMENT_ID_LENGTH = 256;
+const MAX_COMMENT_BODY_LENGTH = 2e4;
+function isObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function ownValue(object, key) {
+  return object && Object.prototype.hasOwnProperty.call(object, key) ? object[key] : void 0;
+}
+function isSafeKey(value) {
+  return typeof value === "string" && value.length > 0 && value.length <= MAX_KEY_LENGTH && /^[A-Za-z0-9]/.test(value) && !/[\\\0\r\n\t]/.test(value);
+}
+function isSafeRepositoryPath(value) {
+  if (value === "/COMMIT_MSG" || value === "/MERGE_LIST") return true;
+  if (typeof value !== "string" || !value || value.length > MAX_PATH_LENGTH || value.includes("\0")) return false;
+  if (value.startsWith("/") || value.startsWith("\\")) return false;
+  return value.split(/[\\/]/).every((segment) => segment && segment !== "." && segment !== "..");
+}
+function uniquePaths(paths) {
+  if (!Array.isArray(paths)) return [];
+  return [...new Set(paths.filter(isSafeRepositoryPath))];
+}
+function isSafeCommentId(value) {
+  return typeof value === "string" && value.length > 0 && value.length <= MAX_COMMENT_ID_LENGTH && /^[A-Za-z0-9][A-Za-z0-9._:-]*$/.test(value);
+}
+function normalizeCommentRange(value) {
+  if (!isObject(value)) return null;
+  const range = {
+    end_character: value.end_character,
+    end_line: value.end_line,
+    start_character: value.start_character,
+    start_line: value.start_line
+  };
+  if (typeof range.start_line !== "number" || !Number.isInteger(range.start_line) || range.start_line < 1 || typeof range.end_line !== "number" || !Number.isInteger(range.end_line) || range.end_line < 1 || typeof range.start_character !== "number" || !Number.isInteger(range.start_character) || range.start_character < 0 || typeof range.end_character !== "number" || !Number.isInteger(range.end_character) || range.end_character < 0 || range.start_line > range.end_line || range.start_line === range.end_line && range.start_character >= range.end_character) return null;
+  return {
+    end_character: range.end_character,
+    end_line: range.end_line,
+    start_character: range.start_character,
+    start_line: range.start_line
+  };
+}
+function normalizeComment(value, patchset) {
+  if (!isObject(value)) return null;
+  const body = typeof value.body === "string" ? value.body.trim() : "";
+  if (!isSafeCommentId(value.id) || !isSafeRepositoryPath(value.path) || typeof value.line !== "number" || !Number.isInteger(value.line) || value.line < 1 || value.line > 1e8 || !body || body.length > MAX_COMMENT_BODY_LENGTH || value.side !== "left" && value.side !== "right" && value.side !== "unified" || value.patchset !== patchset) return null;
+  const range = value.range === void 0 ? void 0 : normalizeCommentRange(value.range);
+  if (value.range !== void 0 && !range) return null;
+  const status = value.status === "open" || value.status === "resolved" || value.status === "outdated" ? value.status : void 0;
+  return {
+    body,
+    id: value.id,
+    line: value.line,
+    patchset,
+    path: value.path,
+    ...range ? { range } : {},
+    side: value.side,
+    ...status ? { status } : {},
+    ...isSafeKey(value.sourcePatchset) ? { sourcePatchset: value.sourcePatchset } : {}
+  };
+}
+function normalizeComments(value, patchset) {
+  if (!Array.isArray(value)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  return value.reduce((comments, item) => {
+    const comment = normalizeComment(item, patchset);
+    if (!comment || seen.has(comment.id)) return comments;
+    seen.add(comment.id);
+    comments.push(comment);
+    return comments;
+  }, []);
+}
+function normalizePatchsets(value) {
+  if (!isObject(value)) return {};
+  return Object.fromEntries(Object.entries(value).filter(([patchset]) => isSafeKey(patchset)).map(([patchset, entry]) => {
+    const candidate = isObject(entry) ? entry : {};
+    const revision = typeof candidate.revision === "number" && Number.isInteger(candidate.revision) && candidate.revision >= 0 ? candidate.revision : 0;
+    return [patchset, {
+      comments: normalizeComments(candidate.comments, patchset),
+      reviewedPaths: uniquePaths(candidate.reviewedPaths),
+      revision
+    }];
+  }));
+}
+function normalizeReviews(value) {
+  if (!isObject(value)) return {};
+  return Object.fromEntries(Object.entries(value).filter(([reviewId]) => isSafeKey(reviewId)).map(([reviewId, entry]) => {
+    const candidate = isObject(entry) ? entry : {};
+    return [reviewId, { patchsets: normalizePatchsets(candidate.patchsets) }];
+  }));
+}
+function clone(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+class ReviewStateStore {
+  file;
+  seedReviews;
+  writeJson;
+  state;
+  constructor(configDir, options = {}) {
+    this.file = options.file || storageLayout.reviewStateFile(configDir);
+    this.seedReviews = normalizeReviews(options.seedReviews);
+    this.writeJson = typeof options.writeJson === "function" ? options.writeJson : (file, value) => (0, import_atomic_json_store.atomicWriteJson)(file, value, { trailingNewline: true });
+    this.state = null;
+  }
+  readState() {
+    try {
+      if (!fs.existsSync(this.file)) return { reviews: {} };
+      const parsed = JSON.parse(fs.readFileSync(this.file, "utf8"));
+      return { reviews: normalizeReviews(isObject(parsed) ? parsed.reviews : void 0) };
+    } catch (error) {
+      console.warn(
+        "Failed to read Farming review state:",
+        error instanceof Error ? error.message : error
+      );
+      return { reviews: {} };
+    }
+  }
+  ensureState() {
+    if (!this.state) this.state = this.readState();
+    return this.state;
+  }
+  initialPatchsetState(reviewId, patchset) {
+    const review = ownValue(this.seedReviews, reviewId);
+    const patchsets = review?.patchsets;
+    return ownValue(patchsets, patchset) || { comments: [], reviewedPaths: [], revision: 0 };
+  }
+  getPatchsetState(reviewId, patchset) {
+    if (!isSafeKey(reviewId) || !isSafeKey(patchset)) throw new TypeError("reviewId and patchset are required");
+    const state = this.ensureState();
+    const review = ownValue(state.reviews, reviewId);
+    const patchsets = review?.patchsets;
+    const stored = ownValue(patchsets, patchset);
+    return clone(stored || this.initialPatchsetState(reviewId, patchset));
+  }
+  setFileReviewedGerrit({
+    reviewId,
+    patchset,
+    path: filePath,
+    reviewed
+  }) {
+    if (!isSafeKey(reviewId) || !isSafeKey(patchset) || !isSafeRepositoryPath(filePath) || typeof reviewed !== "boolean") {
+      throw new TypeError("invalid review status request");
+    }
+    const current = this.getPatchsetState(reviewId, patchset);
+    const reviewedPaths = new Set(current.reviewedPaths);
+    const alreadyReviewed = reviewedPaths.has(filePath);
+    if (alreadyReviewed === reviewed) return { changed: false, state: current };
+    if (reviewed) reviewedPaths.add(filePath);
+    else reviewedPaths.delete(filePath);
+    const next = {
+      comments: current.comments,
+      reviewedPaths: [...reviewedPaths],
+      revision: current.revision + 1
+    };
+    this.writePatchsetState(reviewId, patchset, next);
+    return { changed: true, state: clone(next) };
+  }
+  getComments(reviewId, patchset) {
+    return this.getPatchsetState(reviewId, patchset).comments;
+  }
+  saveComment({
+    reviewId,
+    patchset,
+    comment
+  }) {
+    if (!isSafeKey(reviewId) || !isSafeKey(patchset)) throw new TypeError("reviewId and patchset are required");
+    const normalizedComment = normalizeComment(comment, patchset);
+    if (!normalizedComment) throw new TypeError("invalid review comment");
+    const current = this.getPatchsetState(reviewId, patchset);
+    const existing = current.comments.find((item) => item.id === normalizedComment.id);
+    if (existing) {
+      if (JSON.stringify(existing) === JSON.stringify(normalizedComment)) return clone(existing);
+      throw new TypeError("review comment id already exists");
+    }
+    const next = { ...current, comments: [...current.comments, normalizedComment] };
+    this.writePatchsetState(reviewId, patchset, next);
+    return clone(normalizedComment);
+  }
+  deleteComment({
+    reviewId,
+    patchset,
+    commentId
+  }) {
+    if (!isSafeKey(reviewId) || !isSafeKey(patchset) || !isSafeCommentId(commentId)) {
+      throw new TypeError("invalid review comment request");
+    }
+    const current = this.getPatchsetState(reviewId, patchset);
+    if (!current.comments.some((comment) => comment.id === commentId)) return clone(current.comments);
+    const next = { ...current, comments: current.comments.filter((comment) => comment.id !== commentId) };
+    this.writePatchsetState(reviewId, patchset, next);
+    return clone(next.comments);
+  }
+  updateCommentStatus({
+    reviewId,
+    patchset,
+    commentId,
+    status
+  }) {
+    if (!isSafeKey(reviewId) || !isSafeKey(patchset) || !isSafeCommentId(commentId) || status !== "open" && status !== "resolved") {
+      throw new TypeError("invalid review comment status request");
+    }
+    const current = this.getPatchsetState(reviewId, patchset);
+    const existing = current.comments.find((comment2) => comment2.id === commentId);
+    if (!existing) throw new TypeError("review comment not found");
+    if ((existing.status || "open") === status) return clone(existing);
+    const comment = { ...existing, status };
+    const next = {
+      ...current,
+      comments: current.comments.map((item) => item.id === commentId ? comment : item)
+    };
+    this.writePatchsetState(reviewId, patchset, next);
+    return clone(comment);
+  }
+  inheritPatchset({
+    reviewId,
+    previousPatchset,
+    nextPatchset,
+    changedPaths
+  }) {
+    if (!isSafeKey(reviewId) || !isSafeKey(previousPatchset) || !isSafeKey(nextPatchset) || !Array.isArray(changedPaths)) {
+      throw new TypeError("invalid review patchset inheritance");
+    }
+    const state = this.ensureState();
+    const review = ownValue(state.reviews, reviewId);
+    const existing = review && ownValue(review.patchsets, nextPatchset);
+    if (existing) return clone(existing);
+    const previous = this.getPatchsetState(reviewId, previousPatchset);
+    const changed = new Set(uniquePaths(changedPaths));
+    const next = {
+      comments: previous.comments.map((comment) => ({
+        ...comment,
+        patchset: nextPatchset,
+        ...changed.has(comment.path) ? { sourcePatchset: previousPatchset, status: "outdated" } : { status: comment.status || "open" }
+      })),
+      reviewedPaths: previous.reviewedPaths.filter((filePath) => !changed.has(filePath)),
+      revision: 0
+    };
+    this.writePatchsetState(reviewId, nextPatchset, next);
+    return clone(next);
+  }
+  writePatchsetState(reviewId, patchset, patchsetState) {
+    const currentState = this.ensureState();
+    const review = ownValue(currentState.reviews, reviewId) || { patchsets: {} };
+    const nextState = {
+      reviews: { ...currentState.reviews, [reviewId]: {
+        ...review,
+        patchsets: { ...review.patchsets, [patchset]: patchsetState }
+      } }
+    };
+    this.writeJson(this.file, nextState);
+    this.state = nextState;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ReviewStateStore,
+  isSafeKey,
+  isSafeRepositoryPath
+});

package/backend/run-history-store.cjs

@@ -0,0 +1,97 @@
+// Generated by scripts/build-backend-runtime.ts. Do not edit.
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var run_history_store_exports = {};
+__export(run_history_store_exports, {
+  RunHistoryStore: () => RunHistoryStore
+});
+module.exports = __toCommonJS(run_history_store_exports);
+var import_atomic_json_store = require("./atomic-json-store.cjs");
+var storageLayout = __toESM(require("./storage-layout.cjs"));
+const fs = require("fs");
+class RunHistoryStore {
+  configDir;
+  historyDir;
+  normalizeTaskHistory;
+  runsFile;
+  writeJson;
+  entries = null;
+  constructor(configDir, options = {}) {
+    this.configDir = configDir;
+    this.historyDir = storageLayout.historyDir(configDir);
+    this.runsFile = storageLayout.runHistoryFile(configDir);
+    this.normalizeTaskHistory = typeof options.normalizeTaskHistory === "function" ? options.normalizeTaskHistory : (entries) => Array.isArray(entries) ? entries.slice(0, 200) : [];
+    this.writeJson = typeof options.writeJson === "function" ? options.writeJson : import_atomic_json_store.atomicWriteJson;
+  }
+  init({ legacyTaskHistory = [] } = {}) {
+    fs.mkdirSync(this.historyDir, { recursive: true });
+    const current = this.readEntries();
+    const nextEntries = current.length > 0 ? current : this.normalizeTaskHistory(legacyTaskHistory);
+    this.writeEntries(nextEntries);
+    this.entries = nextEntries;
+  }
+  readEntries() {
+    try {
+      if (!fs.existsSync(this.runsFile)) return [];
+      return this.normalizeTaskHistory(JSON.parse(fs.readFileSync(this.runsFile, "utf8")));
+    } catch (error) {
+      console.warn(
+        "Failed to read Farming run history:",
+        error instanceof Error ? error.message : error
+      );
+      return [];
+    }
+  }
+  ensureEntries() {
+    if (!this.entries) this.init();
+    return this.entries ?? [];
+  }
+  writeEntries(entries = this.ensureEntries()) {
+    this.writeJson(this.runsFile, entries);
+  }
+  getEntries() {
+    return this.ensureEntries().slice();
+  }
+  setEntries(entries) {
+    const nextEntries = this.normalizeTaskHistory(entries);
+    this.writeEntries(nextEntries);
+    this.entries = nextEntries;
+    return this.getEntries();
+  }
+  appendEntry(entry) {
+    const nextEntries = this.normalizeTaskHistory([entry, ...this.ensureEntries()]);
+    this.writeEntries(nextEntries);
+    this.entries = nextEntries;
+    return this.getEntries();
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RunHistoryStore
+});