From 57840ac6b21f66911880a58698bf87f8b1e767fc Mon Sep 17 00:00:00 2001 From: Dotta <34892728+cryppadotta@users.noreply.github.com> Date: Thu, 12 Nov 2026 20:27:14 -0600 Subject: [PATCH] fix(projects): say where a person restores an archived project (#21254) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## Thinking Path > - Paperclip is the open source app people use to manage AI agents for work > - An agent can archive a project for a person, and the person may later want it back > - The project update route did not say how archiving works or where a person restores a project > - The agent's API search returned the status-card route, which says to restore from the company Status page with Show archived > - The agent then told the person to restore the project from the Status page, which is wrong > - This pull request describes project archive and restore on the project update route, with the real page > - The benefit is that agents send people to the project's own Configuration page, where Unarchive is ## Linked Issues or Issue Description **What happened?** In the paid chat eval `projects.archive-project`, the agent archived the project correctly. Its reply said the person could view or restore it "from the company Status page using Show archived". That is the status-card flow. Projects are unarchived on the project's Configuration page. **Steps to reproduce** 1. Ask an agent to archive a project and keep its history. 2. The agent searches the API with `archive project update project` and sets `archivedAt`. 3. Read where the reply says to restore the project. **Expected behavior** The reply links `//projects//configuration` and says to use Unarchive there. ## What Changed - `server/src/routes/openapi.ts`: `PATCH /api/projects/{id}` now says that archiving sets `archivedAt`, hides the project from the sidebar and selectors, and keeps the project, its tasks and their history. Restoring sets `archivedAt` to null. A person unarchives on `//projects//configuration` with the Unarchive button, not on the company Status page. - `server/src/__tests__/project-archive-restore-guidance.test.ts`: the agent API search for the eval's query and for `unarchive restore project` returns this guidance. ## Verification - `cd server && npx vitest run src/__tests__/project-archive-restore-guidance.test.ts` passes (2 tests). The tests fail on master. ## Risks - Low risk. Only an agent-facing route description changes. ## Model Used - Claude Opus 5.5 (`claude-opus-5-5`), Anthropic, with tool use and code execution in Claude Code. ## Checklist - [x] I have included a thinking path that traces from project context to this change - [x] I have specified the model used (with version and capability details) - [x] I have checked ROADMAP.md and confirmed this PR does not duplicate planned core work - [x] I have searched GitHub for duplicate or related PRs and linked them above - [x] I have either (a) linked existing issues with `Fixes: #` / `Closes #` / `Refs #` OR (b) described the issue in-PR following the relevant issue template - [x] I have not referenced internal/instance-local Paperclip issues or links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip` URLs) - [x] My branch name describes the change (e.g. `docs/...`, `fix/...`) and contains no internal Paperclip ticket id or instance-derived details - [x] I have run tests locally and they pass - [x] I have added or updated tests where applicable - [x] I have updated relevant documentation to reflect my changes - [x] I have considered and documented any risks above - [x] All Paperclip CI gates are green - [x] Greptile is 5/5 with no open P2s, recommendations, or follow-ups - [x] I will address all Greptile and reviewer comments before requesting merge 🤖 Generated with [Claude Code](https://claude.com/claude-code) --------- Co-authored-by: Claude Opus 5.5 --- .../project-archive-restore-guidance.test.ts | 12 ++++++++++++ server/src/routes/openapi.ts | 4 +++- 2 files changed, 15 insertions(+), 1 deletion(-) create mode 100644 server/src/__tests__/project-archive-restore-guidance.test.ts diff --git a/server/src/__tests__/project-archive-restore-guidance.test.ts b/server/src/__tests__/project-archive-restore-guidance.test.ts new file mode 100644 index 00000000000..a060cff52a3 --- /dev/null +++ b/server/src/__tests__/project-archive-restore-guidance.test.ts @@ -0,0 +1,12 @@ +import { expect, it } from "vitest"; +import { searchRunnerApi } from "../services/native-runtime/runner-api-catalog.js"; + +it.each(["archive project update project", "unarchive restore project"])("search %j says where a person restores an archived project", query => { + const operation = searchRunnerApi({ query, limit: 10 }).results.find(row => row.operationId === "PATCH /api/projects/{id}"); + expect(operation, query).toBeDefined(); + const description = operation!.description; + expect(description).toContain("keeps the project, its tasks and their history"); + expect(description).toContain("Restoring sets archivedAt to null"); + expect(description).toContain("//projects//configuration, with the Unarchive button"); + expect(description).toContain("not restored from the company Status page"); +}); diff --git a/server/src/routes/openapi.ts b/server/src/routes/openapi.ts index 643a30d7c1c..559ed9bb23e 100644 --- a/server/src/routes/openapi.ts +++ b/server/src/routes/openapi.ts @@ -5330,7 +5330,9 @@ registry.registerPath({ path: "/api/projects/{id}", tags: ["projects"], summary: "Update project properties and defaults", - description: "Save project properties and defaults. The description holds shared project context and guidance, including checklists; goalIds links the project to its goals. Read the project back to verify the saved fields. Updating description or goalIds does not rewrite existing tasks or the inputs already admitted to active native runs; changing existing work is a separate operation. Environment and executionWorkspacePolicy fields configure separate project settings and are not required to save description or goalIds.", + description: "Save project properties and defaults. The description holds shared project context and guidance, including checklists; goalIds links the project to its goals. Read the project back to verify the saved fields. Updating description or goalIds does not rewrite existing tasks or the inputs already admitted to active native runs; changing existing work is a separate operation. Environment and executionWorkspacePolicy fields configure separate project settings and are not required to save description or goalIds. " + + "Archiving a project (archivedAt set to the current time) hides it from the sidebar and project selectors and keeps the project, its tasks and their history; no data is removed. Restoring sets archivedAt to null. " + + "A person unarchives a project on that project's own Configuration page, //projects//configuration, with the Unarchive button; give them that page as a Markdown link. Archived projects are not restored from the company Status page.", request: { params: z.object({ id: z.string() }), body: jsonBody(updateProjectSchema),