Simplify codebase per audit of 8b89f14

api/openapi.yaml

@@ -298,19 +298,6 @@ paths:
               schema: { $ref: "#/components/schemas/Project" }
         "400": { $ref: "#/components/responses/Error" }
 
-  /api/projects/{projectId}:
-    parameters:
-      - { name: projectId, in: path, required: true, schema: { type: string } }
-    get:
-      operationId: getProject
-      responses:
-        "200":
-          description: The project.
-          content:
-            application/json:
-              schema: { $ref: "#/components/schemas/Project" }
-        "404": { $ref: "#/components/responses/Error" }
-
   /api/projects/{projectId}/review-workflow:
     parameters:
       - { name: projectId, in: path, required: true, schema: { type: string } }
@@ -573,22 +560,6 @@ paths:
               schema: { $ref: "#/components/schemas/Task" }
         "404": { $ref: "#/components/responses/Error" }
 
-  /api/tasks/{taskId}/workflow:
-    parameters:
-      - { name: taskId, in: path, required: true, schema: { type: string } }
-    get:
-      operationId: getTaskWorkflow
-      description: >
-        The workflow the task's run froze when it was created, as it was then, for a workflow run's task or one of
-        its stage tasks. Later edits and deletes of the workflow don't change it.
-      responses:
-        "200":
-          description: The frozen workflow.
-          content:
-            application/json:
-              schema: { $ref: "#/components/schemas/TaskWorkflow" }
-        "404": { $ref: "#/components/responses/Error" }
-
   /api/tasks/{taskId}/summary-read:
     parameters:
       - { name: taskId, in: path, required: true, schema: { type: string } }
@@ -993,40 +964,6 @@ paths:
                 items: { $ref: "#/components/schemas/Preview" }
         "404": { $ref: "#/components/responses/Error" }
 
-  /api/tasks/{taskId}/snapshots:
-    parameters:
-      - { name: taskId, in: path, required: true, schema: { type: string } }
-    get:
-      operationId: listSnapshots
-      description: >
-        The task's snapshots, oldest first. Each is a commit of the worktree as if everything were staged, kept at
-        refs/byre/tasks/{taskId}/snap/{n} until the task is merged or discarded; the rows remain after that.
-      responses:
-        "200":
-          description: The snapshots.
-          content:
-            application/json:
-              schema:
-                type: array
-                items: { $ref: "#/components/schemas/Snapshot" }
-        "404": { $ref: "#/components/responses/Error" }
-
-  /api/tasks/{taskId}/reviews:
-    parameters:
-      - { name: taskId, in: path, required: true, schema: { type: string } }
-    get:
-      operationId: listReviews
-      description: The task's reviews, one per snapshot, oldest first.
-      responses:
-        "200":
-          description: The reviews.
-          content:
-            application/json:
-              schema:
-                type: array
-                items: { $ref: "#/components/schemas/Review" }
-        "404": { $ref: "#/components/responses/Error" }
-
   /api/reviews/{reviewId}/findings/{index}:
     parameters:
       - { name: reviewId, in: path, required: true, schema: { type: string } }
@@ -1141,19 +1078,6 @@ paths:
         "404": { $ref: "#/components/responses/Error" }
         "409": { $ref: "#/components/responses/Error" }
 
-  /api/sessions/{sessionId}:
-    parameters:
-      - { name: sessionId, in: path, required: true, schema: { type: string } }
-    get:
-      operationId: getSession
-      responses:
-        "200":
-          description: The session.
-          content:
-            application/json:
-              schema: { $ref: "#/components/schemas/AgentSession" }
-        "404": { $ref: "#/components/responses/Error" }
-
   /api/sessions/{sessionId}/messages:
     parameters:
       - { name: sessionId, in: path, required: true, schema: { type: string } }
@@ -1283,35 +1207,16 @@ paths:
   /api/inbox:
     get:
       operationId: listInbox
-      description: >
-        Inbox items, oldest first.
-        Filters narrow the one query to a project's or a task's view.
-      parameters:
-        - { name: project_id, in: query, required: false, schema: { type: string } }
-        - { name: task_id, in: query, required: false, schema: { type: string } }
-        - { name: state, in: query, required: false, schema: { $ref: "#/components/schemas/InboxState" } }
+      description: Open inbox items with their responses, oldest first.
       responses:
         "200":
-          description: Matching items with their responses. Defaults to open items.
+          description: The open items.
           content:
             application/json:
               schema:
                 type: array
                 items: { $ref: "#/components/schemas/InboxItem" }
 
-  /api/inbox/{itemId}:
-    parameters:
-      - { name: itemId, in: path, required: true, schema: { type: string } }
-    get:
-      operationId: getInboxItem
-      responses:
-        "200":
-          description: The item with its responses.
-          content:
-            application/json:
-              schema: { $ref: "#/components/schemas/InboxItem" }
-        "404": { $ref: "#/components/responses/Error" }
-
   /api/inbox/{itemId}/dismiss:
     parameters:
       - { name: itemId, in: path, required: true, schema: { type: string } }
@@ -1706,7 +1611,7 @@ components:
         forked_from: { type: string, description: "The task this one was forked from; absent for other tasks." }
         forked_at: { type: integer, description: "With forked_from: the n of the snapshot it was forked at; absent when it continues a closed task from its end." }
         merge_queued_at: { type: string, format: date-time, description: "When Merge was requested while another task in the project was merging; absent once the merge starts or when none is held." }
-        workflow: { type: string, description: "For a workflow run's task: the name of the workflow it froze at creation (getTaskWorkflow has its copy). A run's task has no agent, worktree or branch (branch, worktree_path and base_ref are empty); its stage tasks are its subtasks, and it closes once they all have, as merged when any of them merged. Absent for other tasks." }
+        workflow: { type: string, description: "For a workflow run's task: the name of the workflow it froze at creation (getWorkflowRun has its copy). A run's task has no agent, worktree or branch (branch, worktree_path and base_ref are empty); its stage tasks are its subtasks, and it closes once they all have, as merged when any of them merged. Absent for other tasks." }
         workflow_stage: { type: string, description: "For a stage task of a workflow run: the name of the stage it runs; parent_task_id is the run's task. Absent for other tasks." }
         audit: { type: string, description: "The default branch commit an audit audits, on the task of a run of its project's audit workflow; absent for other tasks." }
         background: { type: boolean, description: "Whether the task is an audit's run or stage task that hasn't asked for attention yet: no question, ready_for_merge or error so far (for a run, from any of its stage tasks). The app keeps it out of the task switcher and shows it muted on the project's dashboard, and the lead gets no signals about it." }
@@ -1882,14 +1787,6 @@ components:
         effort: { type: string, x-go-type-skip-optional-pointer: true, description: "The agent's effort; empty means the vendor's default." }
         prompt: { type: string, description: "This agent's own instructions: its role in the team." }
 
-    TaskWorkflow:
-      type: object
-      description: The workflow a task froze when it was created, as it was then.
-      required: [name, definition]
-      properties:
-        name: { type: string }
-        definition: { $ref: "#/components/schemas/WorkflowDefinition" }
-
     WorkflowRun:
       type: object
       required: [name, title, brief, definition, finished, stages]